-
29-dream-design / 33-needs-gate-role-filter-bug / 35-validation-rigor-and-body-readiness-proposal / 39-boss-agent-task-supervision / 40-agent-chat-streaming-interrupt 逐份核实状态确认已完成 （后两份状态行本身滞后于代码，已在上一提交订正），按维护说明从 docs/todo/system-design/ 挪到 docs/done/system-design/，docs/README.md 的 todo/done 两张表同步更新。 顺带修复 4 处指向这 5 份文档的相对路径引用（28-followups / 31-work-graph-fail-fallback-coverage / 34-validator-scored-without-real-deliverable / 41-graph-vs-fde-reliability-discussion）， 文件搬家后原来的同目录相对链接会失效，改成 ../../done/system-design/ 的正确相对路径。 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
-
只做了这一件事，没有跟着做「dream 改成 org/work graph 来跑」——两者被 单独评估过：org/work graph 是单公司作用域（org graph=公司级 workflow， work graph=公司内某任务的节点图），dream 却是跨公司扫描，套进去要么破坏 作用域假设要么得新开图类型；且 graph 引擎自带的验收机制（goal-contract benchmark/test-script）判的是「产物过没过验收脚本」，对「经验提炼得对 不对」这种自由文本判断没有对应机制——不管套不套 graph 都得单独设计 rubric，是同一件事。用户明确只要 REST/控制台这一半。 ## REST（server/routes/dream.js，挂 /api/dream） 路由本身没有新业务逻辑，全部委托给已测过的 dream-service.js： GET /agents（总览）、GET /agents/:id（详情，含定义文件可写性 + 经验 审计）、POST /agents/:id/run（手动跑一次，dryRun 只看有没有新原料不 起 LLM）、POST /sweep + GET /sweep/status（全量扫描后台跑 + 轮询，内存 态并发锁防止连点两下）。 ## 控制台（web/src/views/DreamConsole.vue，路由 /dream） 一个表格 + 两个弹窗：本体列表（详情/跑一次/dry-run）+ 全量扫描按钮 （15 秒轮询状态）。导航栏加 🌙 Dream 入口。 ## 验证 server/tests/unit/dream-routes.test.js 4 例，monkeypatch 掉 dream-service 导出对象上的六个函数（不走真文件系统，不误扫真仓库 76 个本体），只验路由层自己的逻辑：端点接线、sweep 并发锁状态机。 真起服务器打了真数据：GET /agents/innovator-evolver 正确报 SKILL.md 因没进 git 历史而不可写、经验审计吐出上次真跑沉淀的 4 条 经验及原文；dry-run 正确报 no-new-material，没多花一次 LLM 调用。 浏览器里走了一遍列表→详情→dry-run，与直接打 API 结果一致。 955 个单测全绿。 文档：29-dream-design.md §5.7 记录实现与「为什么不做 graph 化」的 理由；28-followups.md / docs/README.md 同步更新 dream 现状。 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
-
## 决策 D：能自动查的自动查，不能自动查的把回查成本降到几秒 「这条结论对不对」机器判不了，需要理解内容 —— **不假装有自动判据**。 能自动做的只有两件，两件都做了： ① **引用真伪可以自动查**：提炼产物的 sources 必须都出自这一轮真喂进去的原料， 编一个出处直接拒（前置闸门，连去敏判定都不用调）。 编了出处的经验是「无法验证」最危险的形态 —— 人抽查时顺着一个不存在的指针放弃， 然后**默认它是真的**。 ② **auditDistilled()**：把每条结论与它引用的原料原文并排列出来， 指针悬空标 null（原料被清理过 / 出处是编的）。 真跑那 4 条实测：**8 条引用全部取得回原文**，模型没编出处。 ⚠️ auditDistilled 的输出**不是质量分**，别当成那个用。 ## 任务态清理（28 §5.6） 四道判据全过才删：① 公司在 company_agents 名册里；② 目录名在**任务态白名单**里； ③ mtime 早于 N 天（默认 14）；④ run_* 对应的 run 已到终态。默认 dry-run。 **第 ② 条是踩出来的**：第一版写成黑名单（「不在保护名单里的都算任务态」）， dry-run 直接选中了 trend-scout-global/idearun/venv 和 youtube-crawler/idearun/data —— 一个 Python 虚拟环境、一个数据目录，都在**真公司**底下，都不是任务态。 **删错不可逆，留着最多占磁盘 —— 判据必须是「认得出才删」，不是「不认识就删」。** 读不到名册时一家公司都不认（fail-closed），守卫里单独钉了这条。 公司态（memory/ conversations/）永远走「不许清」那条分支 —— 那是 dream 的唯一原料， 删掉不可再生（28 §5.6b）。 实跑 30 天窗口：待删 0，跳过 955（556 还新 / 74 不在名册 / 60 公司态 / 11 白名单外）。 全量：145 文件 / 1338 测试全绿。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
-
28-followups §3.1。**审计结论与那条待办原来的写法不一样，两列要分开处理。** ## source_kind：删 与 origin 一一映射（global_agent↔builtin / company_hired↔created）， 实查生产库 76 行零例外。全仓唯一读侧是 migrate() 里那条 origin 回填， 而那是给「origin 列出现之前写下的行」用的一次性迁移。 顺序：**先回填、再删列**，两步都用 hasColumn 守着（幂等）。反过来做不报错 —— 库能开、测试能过，只是那几行 origin 悄悄是错的。守卫 source-kind-drop-migration.test.js 走存量库重启那条路，专门钉这个顺序， 反向验过：弄反立刻红。 写侧散在 3 处生产 INSERT + 35 个测试文件。批量改的时候正则误伤了 4 处 （吃掉了 JS 默认参数、位置占位符、ON CONFLICT 的赋值行），逐个修回并复查了 diff —— **这种跨几十个文件的机械改动，靠「全量跑一遍」兜底比靠正则写得对更可靠**。 ## legacy_path：不能删，它还没死 原待办说「所有读取点都已改成从 id 推导」——那半句对新行成立，对存量行不成立： · 新行 legacy_path 恒等于 system/agents/{id}（确实冗余）； · **存量行里存着批次 4 之前的公司侧路径**，而 graph-seed-service 判「悬空行 / 孤儿行」 靠的正是这个路径指向的目录还在不在。从 id 推导出来的路径永远指向 system/agents/， 那条判据会整个失效。 实查生产库：76 行里还有 2 行是老路径（org-planner / org-coder 指着已不存在的 data/companies/mycompany/agents/）—— 正是这条判据要认出来的那种行。 退出条件写进了 graph-db.js 的建表注释（不只留在文档里）： 库里不再有 legacy_path <> 'system/agents/' || id 的行。 ## 顺带记一条：getDb() 会就地迁移生产库 删列那次，生产库的列是被一条**查状态用的**一行 node -e 删掉的 —— 服务当时没重启，人也没打算迁移。结果是对的（幂等；与备份逐行核对 76 行一致、 origin 全部按映射回填正确），但「读一下状态」不该顺手改 schema 这件事值得知道。 闸门只挡测试进程，故意不挡普通脚本（挡了服务自己也起不来）。 注释里给了只读的正确姿势。 全量：140 文件 / 1299 测试全绿。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> -
## 移进 done/ · 27-p3c-goal-task-model.md —— 五批实施完毕，§15.5 / §16.8 的后续项也全部收掉。 新增 **§十七**：欠账清单对账、边界守卫从「乱扣帽子」改成「留证据不判罚」、 测试污染生产图库（第四次踩同一族，但换了个方向进来）、那条卡了两天的 run， 以及 **§17.5 真跑验收** —— org-planner-sdd/benchmark/validator 全 success、 work run completed、父节点自动拉回、org-coder 起实现层子图、 org-coder-validator 判 fail 走回退边打回 impl（loopCount 1）。 **返工闭环第一次由真 agent（不是注入的假 executor）走通。** · 27-p3c-batch3-handover.md —— 四条复核结论全修完、§五 那条 run 已解开， §七 待办全部打勾。从待办转为**事故记录归档**：§六 那几条多会话协作规则是真踩出来的。 两份的相对链接都已重指（done/ ↔ todo/ 跨目录），no-dead-path-references 守卫通过。 ## 留在 todo/ 的，状态说清楚 · 27-graph-agent-architecture.md —— 状态行校准。那一行是别人判断「能不能搬 done」的依据。 · 27-p3b-real-run-runway.md —— 加状态行：验收 7 ⛔ 真跑不成立（readme-writer 混进 org graph，**未修**）、2/4/8/9 未在干净环境验。缺陷② 的**根因**今天修了， 但特意写明「**根因修了不等于验收点验了**」—— 不然下一个人会照着状态行当成验过。 · 27-p3-p4-work-graph-console.md —— 在索引里写明留 todo 的原因： §十 那笔「真实路径 smoke 进 CI」的欠账未还。 · 28-followups.md —— §3.3 标已修（含「GET /info 的 404 闸门仍没修，别当成修过」）； §五 守卫表加两行（graph-db-prod-guard / heartbeat-company-scoped）， 并补第七条的来历。 ## docs/README.md 索引补上新增的 done 条目与 P3B / 28-followups 行，主线说明改成 「当前未完成的是哪几件」——原来只说完成了什么，读的人得自己推。 全量：138 文件 / 1292 测试全绿。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
-
手工扫了两轮，扫出的是三类会持续复发的失真，不是零星笔误： ① package.json 里 12 处引用指向从未在 git 历史存在过的文件（server/src/cli/auto-dev.js 一族） ② CLAUDE.md 的 docs/ 那行列了 5 个文件名，文档移进 done/ 之后全成死链 ③ 数据存储整节把两个不同的 data 根当成一个写，server/conversations/ 这个路径根本不存在 共性是**不报错、不影响测试、git status 干净**，只有照着做的人（或 agent）撞墙才发现。 而 CLAUDE.md 是每个会话都会加载进上下文的文件 —— 写错等于把错误信息直接灌给每一个后来者。 四条扫描： - CLAUDE.md 里的仓库路径都存在 - CLAUDE.md 里出现的每条 npm run 都在 package.json 里（守反方向：删脚本忘改文档） - package.json 的 scripts / bin / main 指向的文件都存在 - docs/README.md 的相对链接都指向真实文件 判据刻意窄（本仓库有过「防线被整条注释掉」的教训）：路径只认「以仓库顶层目录开头 + 含 /」， 且跳过 gitignored 的 —— 那是运行态产物（web/dist/、data/companies/、skills/），在干净机器上 本来就不存在，缺席不是文档错误；这与 no-stale-templates-path.test.js 用的是同一条判据。 上下文里的相对片段（_base/、todo/future/）、glob、<repo>/… 示意写法一律不判。 四条各带「样本非空」下限断言（当前 26 路径 / 16 script 名 / 6 入口引用 / 22 链接）， 下限取当前值一半左右：正则一写错就会以「零违例」全绿，那和没有这条测试是一回事。 验证：把同一套判据跑在旧 revision 的文件内容上（只读 git，不碰工作区）—— 3e718aa：路径 ❌3 条、入口 ❌10 条 d6214f8：路径 ❌4 条、入口 ❌10 条 HEAD ：全绿 顺带修掉自己写的一处假路径占位符（`data/xxx` → 「以 `data/` 开头的路径」）， 文档里本来就不该出现假路径。 28-followups 守卫清单补到第六条，并写明后两条与前四条的形状差异。 npm run test:unit 1061/1061 绿。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
-
承接 310a2b2 的两个遗留： ① 四类被错标成心跳 company-heartbeat-service._sendAgentChat 给五类调用（心跳巡检 / Pipeline 步骤 / 日程 / 告警 / 日报）无差别打 isHeartbeat:true，于是对话列表里全都显示成 「⏱️ 自主心跳巡检」、meta.type 一律 'heartbeat'。改成显式传 kind，五类各自标注。 isHeartbeat 仍然发，但只对真心跳为真，老消费方行为不变。 ② 310a2b2 让 Pipeline 重试变成了冷启动 Pipeline 步骤的 convId 是 `pipeline-{runId}-step-{i}`，被驳回重做时**复用同一个**。 310a2b2 按 isHeartbeat 一刀切回收，等于每次重试都要走 buildPrompt 场景 C 重注入历史。 现在回收策略挂在 CALL_KINDS 表上，判据只有一条：**convId 会不会被下一轮复用** —— 会复用的（pipeline / 人类对话）留着走 TTL，不复用的（心跳 / 日程 / 告警 / 日报）跑完即回收。 不按「是不是后台调用」分：五类后台调用里 pipeline 就是要留的那一类。 守卫补到 12 条（原 3 + kind 标注 5 + 回收策略 4）。对 310a2b2 跑过：8 红 4 绿。 convId 一律用固定字面量而非拼时间戳 —— 撞上 test-id-stability 那道防线后按它的判据改的， 固定之后第二次跑还顺带走了「复用已有对话」那条分支。 文档： - CLAUDE.md 注意事项加一条（新增会话创建路径时必须同时定回收路径，附症状与守卫位置） - 28-followups 守卫清单补第五条，并把「前四条守单一持有者」与第五条「守资源生命周期」 的形状差异写明；顺手修掉表格已有 4 行、结尾却仍写「这三条」的失配 - .env.example 补 AGENT_SESSION_IDLE_MS 全量单测 667/667 绿。重启后 /api/health 正常，心跳照常挂载。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
-
27-P3C 批 1 沉淀的不变式测试，与前三条守的是同一件事：同一个事实 只能有一处持有者。断言的是「凡是把 process.env.GRAPH_RUNS_DIR 绑到 标识符上的模块，那个标识符必须在代码里真正被用到」。 来历一并记下：goal-contract.js 里曾有一行 RUNS_ROOT，注释写着 「与 graph-engine.RUNS_ROOT 是同一个变量（测试隔离在用）」，全文件 却零引用。声明了意图、代码不兑现的常量比没有更容易骗人 —— 读的人 会据此认为该模块认这个覆盖，然后写侧写进临时目录、读侧去仓库里找， 两个方向都静默错位。 四条共有的「样本非空」前置断言仍是重点：扫不到文件时这类测试会以 「零违例」的形式全绿，那正是它自己变成零调用方的方式。 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>