-
泄漏被修过一次（310a2b2 / 3e718aa），修完照样漏。第二次排查发现原因不是修错了，而是： 系统里有两个互相独立的会话池，上一次只修了其中一个；而被修的那个，还漏了一条分支。 池 A routes/agent-chat.js 的 sessions ← /api/agent/:id/chat，含两路心跳 池 B src/core/session-pool.js 的 SessionPool ← AgentManager.callAgent，图执行 / DevLoop 两者没有任何共享代码，回收逻辑各写各的。这个结构性事实此前没有任何一处记着， 所以第二个人查到同一个症状时会重走一遍全程 —— 这份文档就是为了让第三个人不必再走。 正文八节，除了两个洞各自的成因与修法（b0b2b62 / 2092a2e），有三处是排查方法而非结论： §三 按 cwd 第三层判断孤儿归属的对照表。两个池子都把 cwd 下沉到运行态目录， `_global` / `_no-task` 是 agent-locator 的保留缺省值、两边都会出现，不能靠它区分。 §四 为什么上一版守卫是瞎的。dropSession 和 closeSession 都会让会话从池子里消失， 黑盒探针两种情况都返回 false —— 差别只在子进程死没死，而那是探针看不见的维度。 选探针要问的不是「能不能测出正确行为」，而是「能不能区分正确行为和这个具体的错误行为」。 §八 三步定位脚本，外加一条：先确认跑着的服务器进程是什么时候启动的，再去看代码。 本次排查中，正在跑的实例比修复 commit 早 18 秒启动，代码里有的修复它并没有。 线上验证（PID 63099，13 分钟窗口两轮心跳）：触发 5 / 完成 5 / 回收 5，峰值子进程 3、稳态 0。 17:13:32 那个 3 正是泄漏时代的签名（cto+coo+qa-judge 同秒触发），清理前那批孤儿一个都不回收， 现在 30 秒内全部释放。窗口内没有失败心跳，所以 2092a2e 那条 catch 路径是靠单测的变异检验 保证的、不是靠线上观察 —— 文档 §六 里写明了，没算成已验证。 docs/README.md 同步加索引条目（no-dead-path-references 守卫 4 条全绿）。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
-
主文档新增 §11.4b，记 dd319bb 那轮清掉的内容与「不清会怎样」： 四份本体提示词、三个 skill js、两份图模板 README 的 CI 防线规则、 DevLoop PRD 13 份 HTML（连带重生成的 52 份 _spec + manifest + search-index）。 其中两条值得单独记： - innovator-hunt/collect_seed.js 是真 bug 且已发作过 —— 裸相对路径相对 cwd 解析， 在 agent 自己目录下造出一棵野生嵌套树。 - DevLoop PRD 写的 system/templates/devloop-pm.md 根和形状都错 （实际是 system/agents/{agentName}/prompt.md），由此推出一条方法论： 批量替换字符串时，替换的正确性取决于替换后的整体是否成立， 而不是被替换的那一段是否过期。 同时订正两处早于本次改造就已过期的内容（「6 个命名冲突 id」清单里四个 id 根本不存在；orggraph-planning 被告知的真相源仍是 company.json.agents[]）， 并写明刻意不动的三类：历史说明 / 迁移完成的证明 / 运行态记录。 followups 新增 §五，登记本轮立起来的三条不变式测试 （agents-root-single-holder / no-stale-templates-path / repo-hygiene）， 写明它们共有的「样本非空」前置断言为什么不能省，以及改动它们前要想清楚的事。 §四 那条「脚本路径需要跟着更新」已在 cd2066a 完成，改成实跑结论。 交付状态从「未 commit、未 push」更新为已推送（ca468ab..dd319bb）。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
-
设计见 docs/done/system-design/28-agent-registry-unification.md。 改造前 Agent 本体散在三处（system/agents/ 11 个、system/templates/ 50 个、 data/companies/{id}/agents/ 17 个），同一个 AgentScaffold 被三个 baseDir 实例化。 后果是同一角色在 N 家公司下有 N 份互不相干的副本，模板更新不会同步； org-coder / org-planner 这类走 hireFromBaseMetaAgent 造出来的本体 legacy_path 指回自己公司目录，永远无法被第二家公司复用。 本次： - G1 单一注册表：system/templates/ 整体并入 system/agents/，base → _base。 7 个同名 id 逐个裁决，被丢弃的一份归档到 docs/_archive/ 而非删除。 source_kind(template/global_agent/company_hired) → origin(builtin/created)。 - G2 运行态下沉：CLI 的 cwd 从本体根改为 system/agents/{aid}/{cid}/{taskId}/。 memory / conversations 落公司态 {aid}/{cid}/，按公司隔离不串。 sessionPool 的 key 含 (companyId, taskId)，两家公司调同一 agent 不复用会话。 - G2b 产物不下沉：交付物仍落 data/companies/{cid}/，system/agents/ 只留运行痕迹。 写入边界按链路分叉——graph 节点走节点私有目录（被 indexNodeOutputs 索引）， chat 走公司 workspace，同一提示词里不再出现两条互斥指令。 - G3 公司只存引用：data/companies/{id}/agents/ 删除，新增 company_agents 关联表。 不复用 org_graph_nodes——后者是执行流图，work 层本体被雇时不写它，天生覆盖不全。 - G4 缺则创建：本体缺失时从 _base 复制骨架进 system/agents/{id}/， agent-creator 填 agent.md/soul.md 后才从 draft 转 active（哨兵判据， 骨架未填时哨兵仍在，不许被 hire）。产物即刻是全系统可复用的本体。 新增 server/services/agent-locator.js 收编原先散在 6 处的寻址逻辑。 边界守卫（graph-engine）的豁免从「本体根上五个文件名」放宽为整棵 system/agents/： 新本体的骨架本来就要进 git，gitignore 挡不住 ?? system/agents/{newId}/， 旧判据会把一个真正成功的招聘节点判成 boundary_escape fail。 存量迁移见 scripts/migrate-agent-registry.js（幂等，备份到 data/_migration-backup-*）。 真 Claude CLI E2E 已验证：新建公司 → orggraph-planning 自动规划 → 自动招聘 org-planner/org-coder/org-validator 三节点流水线； data/companies/{cid}/agents/ 不存在，company_agents 4 行， system_agents 56→56（零新建私有本体，纯复用），git status 零增量。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
-
按 docs/README.md 既有约定（done/ 放「已实现/当前有效」），把两份已落地的 阶段设计文档移入 done/system-design/： - 27-p1-virtual-reference.md P1 虚拟引用寻址，commit 226489d - 27-p2-org-graph.md P2 Org Graph，70a4727 + f20d0d8，真实建公司端到端验证过 用 git mv 保留历史（R098 / R087）。移动断掉的 33 处相对链接已全部修复： moved 文件内的出向链接改 ../../todo/system-design/，todo/ 下 6 个文件的入向链接 改 ../../done/system-design/。全 docs/ 扫描无断链。 README 此前严重过时——只列了 2 份 27 文档，实际已有 11 份。本次补全 todo/ 表格， 每份标注状态与作用（总纲 / 需求源头 / 命名规范 / 端到端 / 参考场景 / P3+P4 已实现 / 验收契约 / P4 设计中），并在 done/ 表格补上 P1、P2 两行。 ■ 刻意没有移动 27-p3-p4-work-graph-console.md 它虽然已实现（c3abf4a），但文档正被另一进程持续修改（工作区 M 状态）。 移动会打断它的编辑路径，等它收尾后再归档。 ■ 三份文件的链接修复留在工作区未提交 27-naming-conventions.md / 27-p3-p4-work-graph-console.md / 27-requirement.md 里，我的链接修复与另一进程的在途编辑混在同一文件中，单独拆分风险大于收益。 工作区内容是正确的（链接已指向新路径），会随它下次提交一并带上。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
-
- New docs/README.md indexes the tree: done/ (shipped features + reference manuals), todo/ (current focus — Graph Agent architecture), todo/future/ (deprioritized roadmaps: FDE pipeline todo list, stale v1.1 milestones, harness engineering proposal — orthogonal to the Graph Agent work, not blocking it) - Move completed/reference docs into docs/done/ (LEMONBOSS-SYSTEM-DESIGN, architecture-v5, claude-code-cron, open-api-manual, qa_judge_req, task_timeline_design, user-guides/, system-design/01-26 minus the three moved to todo/future/) — verified against actual code (qa-judge template, Task Timeline route/service/view) before filing as done - Fix the two TOC links in LEMONBOSS-SYSTEM-DESIGN.md that would otherwise point at the old paths after the move - docs/todo/system-design/27-graph-agent-architecture.md: add the P2 Org Graph doc link in the roadmap table and 关联文档 section - Add docs/todo/system-design/27-p2-org-graph.md (P2 requirements & design, drafted in parallel while P0/P1 landed) Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>