+- **agent 主动整理接口(issue #231):dryRun 比对报告 → 判断 → apply,全程留审计**:内聚块 `src/organize.js`,service 层只做依赖注入 + barrel 出口(`service.organize`,一个入口带 mode 参数——`{ mode: "dryRun" | "apply" }`)。按维护者口径只做功能本体:**不进工具列表、不加独立 opt-in 开关**,#249 到位时只差「注册工具 + 注入指引」一步。① `dryRun({ candidates, agent_scope?, workspace_scope?, sensitivity? })`:逐条与库内**同类型同 scope** 的行比对(精确层 = 标题归一后相等;向量层 = `MIN_SIM 0.92`,与 document 的 C2 档和 `findSessionDuplicate` 的 vector 档同源,不在第三个地方发明阈值),产出 `verdict: exact | near | new` 与命中行(含相似度),**不写记忆表**、只落一行 `dream_runs`(`run_type='organize'`);行扫描与向量读取按 type 缓存,候选硬上限 50 条(整理不是批量导入)。② `apply({ run_id, decisions })`:`save`(走 `saveWithDedupe`,复用常规写路径的镜像/通知/重嵌入语,不另起一套 epilogue)/ `discard`(只进回执)/ `archive`(**筛除 = 归档,绝不物理删除**),整批一个事务;apply 回执行经 `outcome.dry_run_id` 指回它所依据的那份报告,审计可还原「报告 → 判断 → 落地」三步,receipt 走 `buildReceipt`——与 dream 同一格式,`parseReceipt` 可解。三条硬规则都是「宁可什么都不做」形态:dryRun 不写库;apply 必须引用一次真实 dryRun(没有比对过的候选一律不落库,堵死「跳过报告直接写」的绕过路径);筛除只归档。宽容形态同仓库红线 4:单条非法候选/决策跳过 + 应用合法子集 + run 记 `degraded`(逐条明细进 `skipped` 列),基础设施级错误记 `failed` 并原样上抛——绝不虚报 ok。`document` 候选在 dryRun 即被拦(唯一铸造口是 `registerDocument`,#230)。`dream_runs.run_type` 的注释补第三档 `organize`(列本身无需迁移)。测试 1220 → **1228**。
0 commit comments