Commit Graph
20 Commits
Author SHA1 Message Date
weichen ca9b128f18 Document the storage-migrate tool and the switch/drill runbook (U4)
Why: U4 ships the managed migration entry; the runbook is the operator-facing contract for inventory/backup/migrate, migration identity and resume rules, verification semantics, and the authorized-window switch sequence.

Evidence: backend branch feature/collab-storage-u4-migrator - integration tests green against real PostgreSQL (idempotent rerun, resume, foreign-data refusal, wrong-snapshot refusal, unknown-owner block).

Impact: docs only.

Refs: proposals/2026-10-11-collaboration-storage-and-distribution.md U4 and section 6.
2026-10-11 08:29:38 +00:00
weichen 0be6c2d3ee Document the execution budget settings and the KTD13 action-authz compat plan
Why: U3 slice 2 ships admission budgets (runtime.* keys, lease semantics, yield/reacquire) and the host-side action matrix; the runbook is the single source for operators and records the versioned public-contract plan KTD13 requires.

Evidence: backend branch feature/collab-storage-u3-budget-authz (admission.go, action matrix in server.go) with admission/matrix tests green.

Impact: docs only.

Refs: proposals/2026-10-11-collaboration-storage-and-distribution.md KTD13/R8, section 5 U3.
2026-10-11 05:15:49 +00:00
weichen 4ca58c3d8a Add the team-storage runbook for U1 and cross-link usage
Why: the approved collaboration plan U1 requires a fixed deployment manifest, tier config contract, migration mapping, capacity contract, isolation test scheme and KTD14 copy-protection contract as the single source of truth for team-tier operations.

Evidence: contract keys match backend config.go tier/pool fields (U2, backend branch feature/collab-storage-pg-tier); local verification used svc.sh collabtest on 127.0.0.1:8897 and Redis on 6399.

Impact: docs only (new guide + usage.md cross-links); no code change.

Refs: proposals/2026-10-11-collaboration-storage-and-distribution.md sections 5 (U1/U2), KTD1/KTD8/KTD12/KTD14.
2026-10-11 03:10:45 +00:00
weichen 4ce8155161 Expand guides with worked examples for intents, runs, and squads
Why: 补充实例让导览可对照实操:意图打分/填槽/多意图裁决给出
intentctl explain 实测轨迹(含样例意图、歧义、优先级 tie-break、
能力目录),任务执行给出工具清单与典型回合走查(含 ClaimGate
三类拦截),小队给出 agent-squad demo 全流程实测与真实工作区
目录树/TASK.md 实拍;并修正事实:默认意图目录为空、插件 overlay
与 registry loader 两种文件形态不同。

Evidence: intentctl explain/catalog 与 agent-squad demo 为 2026-10-08
本地实测输出(命令见各节);锚点仍为 Dev R0 218fc4b1;git diff
--check 通过;五篇互链全部可解析。SRC=SELF。

Impact: 仅文档增补(02/03/04/05 四篇),无代码影响。

Refs: Dev 任务分支 feature/architecture-guides。
2026-10-08 09:33:13 +00:00
weichen 09d968cb2f Add architecture guide set for overview, intent, runs, and squads
Why: 系统缺少面向新人与新任务的现状导览;把结构/意图识别/任务执行/小队
四条主线的架构、模型与调用链整理成五篇参考文档,降低跨仓定位成本。

Evidence: 锚点核验于 Dev 组合 218fc4b1ba00b0a03b5bb79f292b3eba6c987a58
(2026-10-08,引用的函数入口行号逐一 grep 定位);git diff --check 通过;
五篇互链相对路径全部可解析。SRC=SELF(本地核验,任务卡有记录)。

Impact: 纯文档新增(docs/guides 五篇),无代码/契约/配置影响。

Refs: Dev 任务分支 feature/architecture-guides(R0 218fc4b1)。
2026-10-08 09:33:13 +00:00
weichen 5825cd35f2 Propose EXT-5 host document parse and tighten the surface snapshot
Why: downstream parsers are unreachable through the Host handle and the base lacks xlsx/pptx parsers; MS1 needs both. The snapshot also missed interface methods, so adding one was undetectable.

Evidence: request follows compat-policy sect.6 four elements; behavior contract and limits in the proposal body (documents has no CI; verified via git diff --check recorded on the Dev task card).

Impact: docs only; compat-policy sect.3 gains one sentence, usage.md format list gains xlsx/pptx.

Refs: docs/proposals/2026-10-06-ext-5-host-parse-document.md
2026-10-06 14:44:17 +00:00
weichenandCursor a0da588f90 Document the base extension roadmap and plugin contract v2
Why: The base must stay unmodified by downstream products, so the roadmap, compatibility window, and plugin contract need a written proposal before further forks.
Evidence: Three proposals under docs/proposals and a short pointer in the plugin development guide.
Impact: Downstream work follows extension-point requests and a published base version. Tag commands in the compat proposal are not executed.
Refs: .task/feature-base-extension-roadmap.md
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-01 10:34:30 +00:00
weichen 1b1489203d Document project inbox dual view and archive flow (CF3)
Why: D48-D51 add the project inbox (archive-to-project, aggregated
project view, project stream); guide needs the user-facing story.
Evidence: usage.md 4.2 gains project inbox bullet; badge note updated.
Impact: docs-only.
Refs: 2026-09-30-card-stream-artifact-unify-project-inbox.md (D48-D52).
2026-09-30 19:18:12 +00:00
weichen 96c8404c5e Document artifact facade cards and context backfill (CF-A)
Why: D46/D47 add inbox facade cards for truncated tool results and
artifact text backfill; guide needs the unified presentation story.
Evidence: usage.md 4.5 gains facade/backfill bullet.
Impact: docs-only.
Refs: 2026-09-30-card-stream-artifact-unify-project-inbox.md (D46/D47).
2026-09-30 18:40:50 +00:00
weichen 3d2da4eb0b Document card streaming three-tool flow in usage guide
Why: CF-S (D44/D45) adds card_begin/card_append/card_commit; users need
the streaming flow and crash-fallback behavior documented.
Evidence: usage.md cardflow bullet updated to v2 flow.
Impact: docs-only.
Refs: 2026-09-30-card-stream-artifact-unify-project-inbox.md (D44/D45).
2026-09-30 18:19:39 +00:00
weichen 4a55832e9d Add cardflow-and-process-split proposal (D39-D43) and update guides
Why: 卡流机制与中栏过程/回复分离的用户五项裁定(2026-09-30)入库:显式路由、卡片权威+引用回填、默认关、CF0 先行、完备性剧本修订;Cursor 式过程折叠决策(D41)。
Evidence: 提案 docs/proposals/2026-09-30-cardflow-and-process-split.md;usage.md 增过程折叠/长回复折叠/长结果进卡片三节;plugin-development.md 增通道外溢验收项(06 §2.7)。
Impact: 文档;决策编号 D39–D43(D34–D38 为认证提案预留段)。
Refs: Dev 任务卡 feature/cardflow-r1。
2026-09-30 16:39:47 +00:00
weichen b4546fee1b Move WebSearch to ported in the catalog disposition table
Why: the backend now registers tavily_search/web_search via
Agent-Native's TavilyProvider, so the guide's not-ported reason no
longer holds.

Evidence: backend PR records the registration and runtime checks.

Impact: table row updated, library count 44 -> 46.

Refs: feature/tavily-search-tool task card.
2026-09-30 11:00:11 +00:00
weichen fd4863899a Add the porting criterion and full catalog disposition table
Why: deciding what enters the library from an external prompt catalog
needs a stated rule (carrier mechanism or future slot) and an auditable
per-item disposition, otherwise coverage drifts by reviewer taste.

Evidence: table maps every Claude Code catalog entry to a library module
or an explicit not-ported reason.

Impact: guide gains section 9; no code change.

Refs: feature/prompt-catalog-coverage task card.
2026-09-30 10:45:15 +00:00
weichen 02198f1ceb Add the prompt library design and extension guide
Why: the prompt system's design rationale (layering, the eight module
patterns, trigger semantics, override chain) needs to live with the
docs so future prompt work follows it instead of re-deriving it.

Evidence: guide content distilled from the implemented library and the
Claude prompt catalog analysis recorded in the task card.

Impact: new docs/guides/prompt-library-design.md; no code change.

Refs: feature/prompt-library task card.
2026-09-30 10:36:40 +00:00
weichen 7da2b192d2 Update the usage guide for inbox, command bus, and workspaces; record T5 verification
Why: T2-T4 changed the interaction foundation (pure-inbox rail, four-entrance command bus, overlay workspaces) and the guide still described the classic tabs; T5 acceptance also requires the verification record with the zero-page walkthrough.
Evidence: zero-page walkthrough 12/12 PASS on a fresh real binary (fresh data dir: empty instance -> project/conversation -> slash commands -> #upload card lifecycle -> card action receipts -> tidy -> HITL block+resolve -> button-entrance dispatch -> plugin workspace declaration -> artifacts -> four-entrance audit); StatusLamp shape+color dual encoding asserted by ui suite; combo make test at pinned heads.
Impact: usage guide sections 4.2-4.7/5/6.2/7 rewritten; new T5 record; no code change.
Refs: docs/proposals/2026-09-30-ui-inbox-command-workspace.md T5; task card feature/polish-r1
2026-09-30 08:17:26 +00:00
weichen faeed84f01 Record the parallel-duplication lesson, follow-ups, and startup config usage
Why: boot-config 重复交付事故须按 documentation.md 经验闭环沉淀:根因与
检查动作入经验条目、处置与后续项入过程记录;使用指南启动节仍是纯 CLI
旧文案,需反映已上线配置面(PR#4/PR#12)。

Evidence: 经验条目按 lesson 模板(candidate 状态、事故时间线与完整 SHA
回链);usage §1.3 与已合入实现实测一致(config explain 逐字段来源与
DSN 脱敏、serve --config envs/dev.json 落 data-dev)。

Impact: docs/records/ 新增 lesson-parallel-session-duplication 与
boot-config-followups 两条;docs/guides/usage.md §1.3 重写为四源合并 +
多环境启动说明;无代码影响。

Refs: Agent-System-Backend PR#4(66b4bbf5)与 PR#5(8270acf5,已关闭留
差异清单);本仓 PR#6(配置面设计);Agent-System-Dev PR#12(a58f85e)。
2026-09-30 04:44:08 +00:00
weichen 13fd7b3a55 Document the dual-tier storage
Details (original message):
Document the dual-tier storage, multitenancy, and scaling delivery (proposal, implementation record, test report, usage guide)
2026-09-30 02:39:50 +00:00
weichen 1683e17b20 Final 0.1.0 test report
Details (original message):
Final 0.1.0 test report: all 15 acceptance items achieved (squad engine integration, model-routing override chain, context observation); 44 automated tests + 15 live checks; refresh usage and implementation records.
2026-09-29 18:30:46 +00:00
weichen d3a021391b Update reports for the agent-intent gate integration: 36 automated tests
Details (original message):
Update reports for the agent-intent gate integration: 36 automated tests, 13 live checks, release sha a3128fe1.
2026-09-29 18:12:57 +00:00
weichen 196baf7c8c Add the 0.1.0 usage report
Details (original message):
Add the 0.1.0 usage report, test report, plugin development guide, and P0-P5 implementation record; index the docs tree.
2026-09-29 18:07:44 +00:00