-
之前几轮全量跑一直有 3 个失败，当时判断是环境耦合/pre-existing、跟本次改动无关就没细查， 这次逐个真查了一遍，三个都是真 bug： - system/agents/sdd-planning/SKILL.md：Evolve 训练产出从 train/evolve/SKILL.md 提升到 生产位置时，"训练依据"引用的相对路径没跟着调整（少了 train/ 前缀），指向了不存在的 system/agents/hunt/、system/agents/digest/；真实文件其实在同一个 agent 自己的 train/hunt/、train/digest/ 下，补前缀即可。 - graduation-criteria-reality.test.js：断言死等 code-planner 的状态回到 'active'，但 该本体的 config.json 早已从曾经踩坑的 "training" 改成了真正毕业态的 "enabled"—— seedAgents() 把 DB 同步成 'enabled' 是设计如此（同为毕业态，不是降级），不该被判失败。 改成用 isUngraduatedStatus() 判断"没被打回未毕业域"，不再钉死具体状态值；顺手把 graph-seed-service.js 里那句会随源码变化过期的注释也改成不点名具体值。 - graph-engine-extend-budget.test.js：一颗时间炸弹——用硬编码绝对时间戳 '2026-08-23T05:23:52.886Z' 模拟"卡住很久了"，但被测代码真的调 Date.now() 算经过时长， 写这条用例时"经过时长"确实超过 2h 上限、又低于追加后的 6h 上限；现在真实时间已经过去 178 小时，连追加后的上限都超了，测试注定要红，跟被测代码毫无关系。改成 Date.now() - 3小时 相对计算，不再随时间推移漂移。 全量 vitest 131/131 文件、1089/1089 用例通过。 Co-Authored-By: Claude Sonnet 5 <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>
-
设计见 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>
-
## 为什么加 「输入输出」tab 把产物的绝对路径摆出来了，但那是服务器本地路径 —— 浏览器里点不开， 走查时只能靠肉眼确认「路径长得对」，而真正要确认的是「这份 brd.md 里写了什么、 下游读到的是不是它」。 ## 前端 新增 web/src/components/graph-console/FilePreviewModal.vue，输入/输出两处路径 改成可点按钮。渲染三档：.md 走 marked（已是既有依赖，没新增包）、.json 重新缩进、 其它原文。两处刻意的选择： - .json 解析失败时**退回原文**并说明，不替它藏起来 —— 产物 json 写坏了本身就是要看的信息 - 超过 512KB 时后端回 truncated，界面如实说「不是完整内容」，不装作读全了 output_ref 那一行不做成可点：它是目录不是文件。 后端没有新造端点：复用现成的 GET /api/company/:cid/files/content，它的根目录正是 data/companies/<cid>，而 graph_files.rel_path 本来就是相对公司根的，正好对上。 ## 修掉六处路径越界（真漏洞） company.js 里 3 个 GET + 3 个 PUT（templates / company / workspace）用的是同一个写法： if (!absPath.startsWith(safeBoundary)) → 403 「一个目录名是另一个的前缀」时它会放行： cid = co-a，path = ../co-a-evil/company.json → abs = .../data/companies/co-a-evil/company.json → startsWith('.../data/companies/co-a') === true → 放行 于是公司 co-a 能读 co-a-evil 的文件；PUT 那三处是同一缝隙上的跨公司**写**。 抽 resolveInside() 用 path.relative 判断，六处共用一份（复制六份判据迟早会漂）。 新增 7 条用例走真 HTTP 验，PUT 那条断言的是**文件没被改**而不只是响应码。 ## 顺带修掉一个被你的实际使用触发的 bug 跑全套时 graph-seed-service 的对账用例红了，报 `org_graph_nodes WHERE company_id='mycompany' expected 10 / actual 9`。 不是并发偶发 —— 单跑也红。原因：seedCompanyAgents 对 type='meta-bootstrap' 的角色 是 continue（既不落 org_graph_nodes 也不落 system_agents），而 verifyCounts 复算期望值时把 agents[] 全算进去。mycompany 的 10 个角色里 orggraph-planning 正是 meta-bootstrap → 差 1。 也就是说：**界面上点一遍新建公司就会踩到**。这条缺陷上一轮就被预告过 （当时那个 agent 说「不在我的独占文件里」没修），今天被真实使用兑现了。 修法是让 verifyCounts 复用同一个 isMetaBootstrap 判据，不复制那个 type 判断。 新增独立测试文件（不并进 graph-seed-service.test.js —— 往它的 hermetic 夹具里 加角色会连带改既有断言），用 GRAPH_SEED_ROOT 自建最小夹具。 那个文件里第二条用例是刻意的：只断言「对账干净」时，seed 一个都没种也会“通过”， 两种原因症状相同。第一版就是这么错的 —— 我误以为 runStartupSeed 会种公司角色 （它只做 reconcile + 全局 agent + 模板），是第二条断言把「夹具没种」和 「过滤没生效」分开的。 ## 验证 871 全绿（87 文件）。3 处变异精确变红后逐字还原 （startsWith 回退 → 精确打红跨公司读/写两条；verifyCounts 去掉过滤 → 打红对账条）。 拿运行中的实例 + 用户真实公司 mycompany 走查过：读到真实 brd.md 内容， `../idearun/company.json` 与 `/etc/hosts` 均 403。web:build 通过。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
-
测试 736/736 全绿（68 文件，起点 719/66，净增 17 条，未改任何既有断言）。 W1 · seed 接进启动流程 + 悬空行回收 - server/index.js 与 agent-server.js 均在 listen() 前调 runStartupSeedSafely() （幂等、失败降级记日志、不挡服务启动） - seedTemplates() 此前**没有任何运行时调用方**，只有测试与手动脚本引用， 于是 system/templates/ 新增本体永远进不了 system_agents，而 work_graph_nodes.system_agent_id 是指向该表的外键 - 占位 id 回收：legacy_path 已失效的 company_hired 行改为可被 template 就地转正， 保留行 id 以保外键。此前 seedTemplates 遇占用即 skip，导致污染不可逆： lookupSharedAgentMd 恒 null → hire 静默退回全量拷贝 → 模板改动对已雇公司不生效 - 生产库实查：company_hired 0 行（原 10 条悬空全清）、template 45、 verifyCounts().ok=true、foreign_key_check 空 W2 · 项目根分配（四环闭合） - ensureProjectRoot 复用 path-resolver.allocateProjectRoot（sandbox 模式） - 分配 → 进 agent_call 与 planning 两处提示词 + callAgent metadata → 落 artifacts/project-root.json（wx 独占）→ readProjectRootRecord 读回 - 子 run 经 createRun 继承 root_run_id，跨层共享同一项目根 - 核实 data/companies/ 在 .gitignore 内，故项目根内的合法写入不会被 W3 守卫误报 W3 · 产出边界守卫（部分，文档如实标注） - 真 CLI 是子进程直接写盘，引擎拦不住，守卫只能拒收结果、不能回滚 - 7 条「拦不住」的情形逐条列明；文档自述「在 cwd 隔离做掉之前， 真跑仍应在可丢弃的工作副本里做」 W4 · 修验收 fail-open（性质严重） - benchmark-validator / testdata-validator 的 Step 表教 agent 写 verdict:"fail"， 而引擎 FAILING_VERDICTS={attributed,inconclusive} 不含它 → 契约非法的产物 被判 success 放行。失效方向是放行不是拦截 - org-validator 的审计字段 verdict → audit_verdict：它与 work 层判词写同一路径 （nodes/<nodeRunId>/attempt-<n>.json），此前只靠「该节点恰好是 subgraph」 才没被 readNodeProduct 当判词读，属隐患藏在巧合里 - 新增防线 template-verdicts.test.js，从 graph-engine.js 源码取 FAILING_VERDICTS / ATTRIBUTION_REASONS 扫全部模板；经三次变异验证有效 （改回 "fail" / 改回 verdict / 造 "ok" 均变红并报精确行号） 真 CLI 冒烟未执行，两条理由（终验 agent 自行判断，符合任务给的门槛）： ① W3 按其自身文档明确「不是沙箱」且要求真跑在可丢弃副本里做，而当前是主仓库、 持有未提交交付物、且有并行 agent 在写，W3 自述的误判项必然触发； ② 断点已零成本静态证明：getAgentConfig 解析裸名只查 system/agents/、 从不查 system/templates/，resolveAgentName 不做按需 hire，实测 prd-planning / sdd-planning / benchmark-validator / testdata-validator / validator-triager / org-validator 全部 throw「Agent not found」。花 $3-8 复现已知断点无意义。 故「做完这四件就能真跑」不成立，真跑挪到 W5/W6 之后。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
-
用 9 个并行 agent 按「文件独占」划分实现 P2 的 T1-T9（T0 已于 2255f09 完成）。 详见 docs/todo/system-design/27-p2-org-graph.md §五。 阶段 A · 数据层 - graph-db.js: org_graph_nodes 加 status/reports_to_node_id（PRAGMA 探测后 ALTER， 幂等）；全量唯一索引换成 WHERE status='active' 的部分索引，使「fire 后重新 hire 同角色」可行；org_graph_edges 重建为执行流边（condition/edge_kind/status） - graph-service.js: ensureOrgGraphNodeIndex 同步改建部分索引，且 upsertOrgGraphNode 的 ON CONFLICT 必须写成 ON CONFLICT(company_id, role_name) WHERE status='active' —— SQLite 的冲突目标要与部分索引谓词逐字对应，否则整条 INSERT 直接失效 - org-graph-service.js（新）: validateGraph 四项校验 + writeGraph/patchGraph/ getGraph/removeNode，事务化，节点软删除级联失效相关边 - routes/company.js: 四个端点 POST/PATCH/GET /org-graph + POST /org-graph/replan； /create 接入自动招聘 orggraph-planning + 异步触发（失败降级为空壳公司）； /fire 接入节点软删除 阶段 B · 自动生成 - system/org-graph-templates/{dev,content,ops}.json + README：三张三段式骨架 （规划→执行→验收，验收失败回退到执行节点），角色名遵循 {domain}-{职能} - system/templates/orggraph-planning/：新 system agent（type='meta-bootstrap'）， 含 §4.1 八步工作流 - company-service.js: 模板不存在时从 system/templates/base/ 元 agent 继承骨架 （自动带 RESEARCH→PLAN→EXECUTE→VERIFY 四段式）+ agent-creator 填充， 新建 agent scope='company'。这是 27-E2E §八bis 元 agent 继承的落地点 阶段 C · 展示 - CompanyDashboard.vue: 组织流程拓扑链渲染 + 空态降级 + 环深度保护 并行编排中发现并修复的三处（均不在原任务划分内）： - AppNav.vue 建公司表单缺 goal 输入框 —— T0 只改了后端，前端表单没同步， company-goal 实际传不进来。这是上一轮 T0 的遗漏 - graph-seed-service.js 会把 type='meta-bootstrap' 的 orggraph-planning 塞回 org graph，与 hire() 的 guard 不一致 - graph-agent-p1-acceptance.test.js: hire 未知角色的返回从 needs_training 改为 hired_from_base（T5b 的行为变更），断言同步 验证（独立复核，非 agent 自述）： - npm run test:unit 676 passed / 63 files（基线 652，+24 为新增的 org-graph 用例） - npm run web:build 通过 - 三个模板 JSON 实跑 validateGraph 全部通过；四类非法图各自被对应 rule 拒绝； writeGraph→getGraph→removeNode 级联验证通过（删中间节点后 3 条边全部失效） Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
-
Adds server/services/graph-db.js (new data/graph.sqlite: system_agents, org_graph_nodes, org_graph_edges) and graph-seed-service.js, which scans system/agents/, system/templates/, and data/companies/*/company.json into seed rows without touching company-service.js's existing hire/copy path. Real repo data diverged from the design doc's original estimates (8 not 10 global agents; 39 not 34 template dirs; system/agents/ and system/templates/ turn out to share 6 ids describing the "same" agent from two different files) — documented in docs/todo/system-design/27-graph-agent-architecture.md section 7 for P1/P2 to resolve. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>