Files
Agent-System-Dev/PROJECT.md
T
weichenandCursor b30f1dc39a Pin the SQLite activity guard and document its refusals
Why: Operators need the guard error text and the migrate command, and the integration pin has to carry the Backend change. This branch was cut before the identity CLI pin, so the gitlink moves from 8e50977 to 89acd16, which also contains the already merged public identity CLI.
Evidence: SELF go test of the U8 cases in the Backend commit 89acd16. PG durability readback remains NOT_RUN until Dev CI.
Impact: SQLite serve and migrate share one activity lock. docs/svc.md lists the refusal strings. PROJECT.md records the 2026-10-12 approval of the account r2 and recovery r3 additions.
Refs: docs/recovery/u8-sqlite-instance-guard.md
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-12 14:02:30 +00:00

6.1 KiB
Raw Blame History

Agent-System-Dev 项目事实

  • 用途:开发集成父仓(gitlink 权威);非分发单元。
  • 组合:modules/{core,backend,frontend,ui,documents} + deps/{development-guidelines,agent-native,agent-squad,agent-intent,agent-command,error-code-system,logging-system}。
  • 部署:非容器;Releases 仓从本仓固定提交导出版本。

方向与规划入口

长期方向、目标及跨任务规划从过程仓的 项目方向与规划索引 查找主记录、里程碑和关联任务;原始正文沿用 方案与规划目录。 确立或调整具体方向时,在本入口维护其主记录链接;正文、确认依据和进展仍以该主记录为准。 目录中的既有文档不因被收录而自动成为已批准规划。记录、任务关联及收尾建议按 交付规范的长期方向与任务衔接 执行。

  • 快慢通道展示与动态工作摘要方案 r1.1: 对话即时答复、后台动态发现与来源、四层阅读、真实状态、并发/恢复及 U1–U4; 2026-10-12 方案设计已批准(阶段 1–4),首批仅 U1; U1 实施计划 待阶段 5 批准后启动业务代码; 业务实施、模型实验、运行验收与部署 NOT_RUN。

新增方向:Generative UI 调研与插件方案 r2。 2026-10-11 用户裁定首试点(对话内分析页)、可信编译插件交付与试验参数;U1 受控试验当日完成 (结构分化 6/6、生成走工具参数通道、首期自研 renderer,详见方案「U1 结果与 r2 修订」); U2 起实施与部署分别评审。

  • 多人协作存储与分布式演进方案: 10–100 人、多项目、多会话并行;PostgreSQL 团队档、迁移恢复与多实例执行。方案 r1 已批准 (2026-10-11,用户指示「按方案开始改造」),实施自首选增量 U1+U2 启动。

  • RDM 两树一网集成、完善与追溯审计展示方案: 每项目一套笔记树、文档树与追溯网;项目绑定与读取授权闭环、原子事件历史、统一审计读服务 与四入口工作区。方案 r1 已获用户评审通过(2026-10-11,五阶段一并,KTD4 双层管理员裁定); U1–U5 全部实施合入(RDM PR #195/#197/#201/#213;Dev PR #368,2026-10-11;超管槽待基座能力 接线,申请见 RDM 仓 docs/proposals/2026-10-11-u1-base-extension-requests.md); U6 团队存储独立后续;运行验收属部署环境。

  • RDM 模板与两树一网对话文档生成方案 r1.1:69 类历史资产盘点、模板版本与章节实例化、持久提案、文档级审签及 DOCX;待用户评审,业务实施与运行验收 NOT_RUN。 首批项目建议书/竞品分析、随后扩展全部文档已确认(2026-10-11),其余方案与实施仍待评审。

  • RDM 最终目标核对与完整交付方案 r1:系统级项目、上限内权限覆盖、私域协作、全部文档三权与完整业务链;34 UR/68 SR/10 F 逐条映射;方案已随 #340 合入(2026-10-11),U1 需求基线核对经 RDM #199/#200 落地,U2 起未启动。

  • 服务重启与全量数据恢复方案 r2: svc 启停、异常进程/主机退出后的依赖、配置/数据身份、任务/HITL/副作用、文件与组合备份恢复; r1 经六角色自审、r2 吸收外部源码复核;2026-10-12 用户批准 r2(五阶段一并)。同日批准 r3 新增 (R11/R12、KTD13–15、U8):SQLite 活动服务锁与耐久核验进入实施,故障注入、部署与运行验收仍 NOT_RUN; 衔接协作存储案;U2 首切片已由 svc-autorecover 合入 main(PR #396/#401);U1 实例身份已合入(Dev #415);余量另立增量。

  • svc 统一部署与一次性登录 Key 方案 r1: 二进制/源码统一部署、环境准备、无初始密码开户与账户恢复;一次性 Key 仅兑换设密受限会话; 2026-10-12 已批准;U1/U4 已合入。同日批准 r2 新增(R13–R15、KTD11–14、U7),账户事务与审计随后实施;规格见 docs/svc-deploy/。

上述账户/恢复方案已有 U1/U4 与 recover/watchdog 基础源码。2026-10-12 用户批准账户 r2 新增与恢复 r3 新增,并授权连续推进到 PR 可合入(合入仍由用户执行)。U8 规格见 docs/recovery/u8-sqlite-instance-guard.md。方案正文的确认状态由 Documents 收口更新;本入口原链接仍指当前固定版。候选交接与核查见续审记录。

验证

make test 先核对子模块工作树与固定指针,再运行治理脚本、公开边界、跨仓指针、库及各模块 测试。实际目标以根 Makefile 为准。make test-governance 可独立检查开发门禁,使用临时 真实仓库,不访问生产数据;操作与证据要求见 开发门禁。

make build 在 backend 模块内编译,replace 指向该模块自己的 deps/; scripts/check-pins.sh 核对这些 gitlink 与 Dev 顶层指针,make test-worktree 另核对 真正被测的组件工作树。两者分别验证固定组合与实际检出,不能相互替代。

未加 go.work:工作区最小版本选择会抬高 backend 单独构建使用的部分 golang.org/x 版本。 发布消费方须从固定 Dev 提交递归物化后运行 make build,再核验制品与实际运行状态。