docs: record combined Agent release scope and gates

2026-10-13 00:09:24 +08:00
1 parent 10da39341e
commit d8a55b1451
@@ -0,0 +1,71 @@
+# Task: Update combined Agent trial, merge and push, and retire delivered worktrees
+
+## Identity
+
+- Task ID: 20261012-agent-release-6f93e2b8
+- Mode: Feature
+- Branch: codex/20261012-agent-release-6f93e2b8-agent-release
+- Worktree: /Users/chillishark/Makelore 麦洛/.codex-worktrees/makelore/20261012-agent-release-6f93e2b8
+- Base commit: 10da39341ead9e3db17ea4395d66181f6fe4433d
+- Owner: codex
+- Status: Planning
+
+## Scope
+
+- Update the existing trial application with knowledge-source multi-selection and the latest explicit-deliverable attachment change from the referenced Agent conversation. Merge committed source histories, run combined verification, push main without force, and retire eligible related managed worktrees.
+
+## Intent And Constraints
+
+- The user explicitly authorizes application update, both conversation changes, repository merge/push and temporary-worktree cleanup. Do not activate windows or steal desktop focus. Preserve current Main PID/login where possible, runtime/profile/rollback artifacts, teacher consensus commits and occupied primary checkout. Source task records are read-only; no new canonical reconciliation, cloud deployment, paid model call or cloud upload. Retire only clean, committed, ready managed checkouts, preserving branches/commits.
+
+## Outcome
+
+- Not completed.
+
+## Verification
+
+- Not run.
+
+## Follow-ups
+
+- None recorded.
+
+## Promotion Candidates
+
+- None recorded.
+
+
+## Project Context Loaded
+
+Task context:
+- Task ID: 20261012-agent-release-6f93e2b8; Feature mode.
+- Branch/worktree/base: the matching Identity above; Git-common ownership and reservation verified.
+- Other active local tasks: 44 peer records assessed read-only, including the occupied teacher integration primary, knowledge picker, chat files, UI/card/avatar/sidebar/configuration ancestors, and runtime deployment tasks.
+- Overlap: source changes are approved and compatible. The current user authorizes deployment of the peer's latest local-only file filter. The primary's dirty teacher task record and local main ref remain protected. Unrelated dirty/unmerged task checkouts are retained.
+
+Read:
+- AGENTS.md and .project-docs/05-agent-entry/{read-before-planning,memory-index,concurrent-task-gate,planning-gate}.md.
+- Active record; positioning; integrated current-state; decision index; system overview; data flow; domain business rules and success criteria; personal-cloud-agent and authentication decisions.
+- Evidence, reflection, commitments and stale-memory indexes, relevant accepted teacher context, and the 44 peers' Scope, Intent And Constraints and Promotion Candidates.
+- Source knowledge-picker and chat-files records, referenced chat's latest user/final messages, runtime pointer/build manifests and updater/bootstrap code.
+
+Relevant understanding:
+- Project goal: Makelore gives users personal AI helpers and creative/work capabilities through a simple Chinese interface.
+- Current integrated focus: preserve teacher consensus documentation while delivering already-approved personal Agent improvements.
+- Active scope: deploy the union of source commits 3786a18b437720121bb15a000ca019728d04841c and e78459b3848e3f5fc17d7ba4f5a68a83d25901e2, then normal push and bounded cleanup.
+- Constraints: no desktop focus changes; Main owns credentials, uploads and runtime. Renderer update must preserve identical Main bytes and runtime dependencies. Readable shared knowledge is readonly; draft selections save/apply normally. Assistant files use verified explicit reply links, with old plain-path limitation.
+- Decisions: preserve accepted card colors, pixel avatars, manual sidebar, chat thinking presentation and attachment panel; cloud thinking patch/delivery schema are not silently deployed.
+- Evidence/reflections/commitments: prior focused unit/headless/type/build verification and actual old-runtime manifests are source evidence, not a claim that the new release is verified. Unrelated retention commitments are outside this explicit cleanup request.
+- Modules: src/pages/CloudAgents, src/components/CloudChat, attachment/link helpers, related tests, README, own record, ignored .trial-runtime stage.
+- Unknowns/stale context: shared snapshot predates live feature branches. Unpackaged credentials are in memory; an existing no-focus Renderer refresh mechanism needs proof. Bootstrap captures an old worktree path and requires a durable snapshot/compatibility link if retired. The drift checker compares the entire merged historical tree to the feature base, so imported peer/canonical records must be verified as source-preserving rather than treated as new task edits.
+
+Gate result:
+- Passed. Concurrent ownership, context and semantic overlap checks passed before this plan.
+
+## Plan
+
+1. Merge both committed source heads into the owned release branch, preserving approved primary/remote history and immutable source records.
+2. Verify the combined configuration, attachment, avatar/card and chat changes headlessly, plus typecheck/lint/build and exact Main compatibility.
+3. Stage a durable Renderer and rollback payload, refresh safely in the existing process without activation, and verify the loaded asset revision.
+4. Commit release evidence and push main normally; verify the remote contains both source commits and teacher consensus commits.
+5. Preserve required runtime files, retire eligible delivered managed checkouts and this completed release worktree, leaving dirty/unmerged/unrelated work intact.