sdd-agent-platform 0.4.1 → 0.4.2

package/README.md

@@ -20,16 +20,16 @@ Sufficient SDD, not maximum SDD.
 
 ## 适合解决什么问题
 
-普通 agent 可以直接改代码，但在高风险任务里容易把需求边界、状态流转、并发、数据库、审查、验证和写回混在主会话里。SDD Agent Platform 在 Claude Code 外增加一层可检查的工程约束：
+普通 agent 可以直接改代码，但在高风险任务里容易把需求边界、状态流转、并发、数据库、审查、验证和出货门禁混在主会话里。SDD Agent Platform 在 Claude Code 外增加一层可检查的工程约束：
 
 | 维度 | 普通 agent 直接执行 | SDD Agent Platform |
 |---|---|---|
 | 路径选择 | 依赖 prompt 判断 | lifecycle decision 选择 direct / compact / full / research |
 | 任务边界 | 容易随实现扩大 | `sdd tasks inspect` 固定 Boundary / Acceptance / affected files |
-| agent 参与 | 证据混在主会话 | implementer / reviewer / validator 输出 run-relative artifacts |
-| 验收 | 自然语言总结 | `.sdd/runtime.sqlite` + branch evidence artifacts + acceptance coverage |
-| 写回 | 人工记得改状态 | 普通路径走 test/decision/ship；`sync-back inspect/apply` 仅作诊断、恢复、replay、兼容写回 |
-| 健康检查 | 临时脚本 | `sdd doctor` 检查配置、run evidence、generated entry drift |
+| agent 参与 | 证据混在主会话 | implementer / reviewer / validator 输出 `.sdd/runs/<branch>/<stage>/*.md` stage evidence |
+| 验收 | 自然语言总结 | `.sdd/runtime.sqlite` + stage evidence refs/hashes + acceptance coverage |
+| 状态推进 | 人工记得改状态 | runtime 更新 lifecycle/task/validation/gate/truthAlignment；Markdown 由 agent/stage-manager 编写 |
+| 健康检查 | 临时脚本 | `sdd doctor` 检查配置、runtime state、current evidence、generated entry drift |
 
 ## 5 分钟快速开始
 
@@ -70,7 +70,7 @@ sdd doctor
 
 ```text
 .sdd/project.yml
-.sdd/runs/
+.sdd/runtime.sqlite
 .claude/commands/...      # managed generated entries
 .claude/skills/sdd/...    # managed generated skill
 ```
@@ -85,11 +85,11 @@ sdd doctor
 /sdd
 ```
 
-`/sdd` 会先读取 `sdd status`，再根据 CLI/core 的 recommended next command 判断下一步是补 spec、写 plan、拆 tasks、继续顺序 `sdd do task`、按 task/batch/wave 边界运行 `/sdd:test`，还是进入 `sdd ship --dry-run` 出货前检查。当前 Claude Code 投影正常入口为 `spec`、`plan`、`tasks`、`do`、`test`、`ship`、`doctor`；`sync-back` 保留为诊断/恢复/replay/兼容入口，`verifies`、`verify`、`init`、`update`、`run-task`、`verify-task` 是 CLI / instruction action，不是当前默认 slash 用户入口。
+`/sdd` 会先读取 `sdd status`，再根据 CLI/core 的 recommended next command 判断下一步是补 spec、写 plan、拆 tasks、继续顺序 `sdd do task`、按 task/batch/wave 边界运行 `/sdd:test`，还是进入 `sdd ship --dry-run` 出货前检查。当前 Claude Code 投影正常入口为 `spec`、`plan`、`tasks`、`do`、`test`、`ship`、`doctor`；`verifies` 与 `goal-verify` 是 tasks/test bundle 内部 continuation，`verify`、`init`、`update`、`run-task`、`verify-task` 是 CLI / instruction action，不是当前默认 slash 用户入口。
 
 ## 主工作流
 
-常见主路径如下。`/sdd:do` 负责顺序实现证据，`/sdd:test` 按 tasks.md + verify.md 中声明的 task/batch/wave 验证边界执行；`sdd verify task` 和 `sdd sync-back inspect|apply` 只保留给兼容诊断、恢复和旧 run replay。
+常见主路径如下。`/sdd:do` 负责把 `T1` 或任务标题语义绑定到同一个 task boundary 并组织实现证据，`/sdd:test` 按 verify.md 中声明的 validation unit / batch / wave 验证边界执行；`sdd verify task` 仅保留为低级诊断入口，不是 happy path。
 
 ```bash
 # 读状态、任务边界和路由
@@ -97,22 +97,23 @@ sdd status --branch master
 sdd tasks inspect <task_id> --branch master
 sdd tasks route <task_id> --branch master
 
-# tasks 阶段应产出 tasks.md 与 verify.md；test 阶段只消费 verify contract
-sdd do task <task_id> --branch master --approved \
-  --review-artifact artifacts/review-<task_id>.md \
-  --validation-artifact artifacts/validation-<task_id>.md
+# tasks 阶段应产出 tasks.md 与 verify.md；do 阶段只消费已接受 task boundary
+sdd do task <task_id-or-task-text> --branch master
 
 # 执行验证命令、生成 test evidence、判断 acceptance coverage；batch_end/wave_end 任务按 verify.md 合并验证
 sdd test task <task_id> --branch master
 sdd test batch <batch_id> --branch master
 sdd test wave --branch master --wave 1
 
-# 验证通过后进入决策卡或出货前本地只读门禁
-sdd ship --branch master --dry-run
-# 可选：让前台 subagent 做观察/调研，主 agent 先消费 digest，需要时再 deep-read artifact
+# /sdd:test bundle 完成 test -> goal-verify 后，ship 消费 accepted evidence 与 aligned truth
+sdd test close --branch master
+sdd test close --branch master --target goal-verify
+sdd ship close --branch master
+
+# 可选：让前台 subagent 做观察/调研，主 agent 先消费 digest，需要时再 deep-read stage evidence
 sdd subagents run <task_id> --branch master --run <run_id> --agent observer --json
 
-# 仅显式诊断/恢复/replay 时才使用：sdd verifies inspect、sdd verify task、sdd sync-back inspect|apply
+# 低级诊断：sdd verifies write、sdd verify task
 ```
 
 subagent 输出的 `agents[].digest`、`summaryRefs` 和 `doNotReadUnlessNeededRefs` 用于主 agent 快速消费观察结果；它们始终是 non-authoritative guidance，不能替代 `/sdd:test`、decision card、ship 或最终风险判断。
@@ -123,25 +124,25 @@ subagent 输出的 `agents[].digest`、`summaryRefs` 和 `doNotReadUnlessNeededR
 |---|---|
 | `specs/<partition>/spec.md` | 需求、范围、验收标准 |
 | `specs/<partition>/plan.md` | 设计方案、风险控制、验证矩阵 |
-| `specs/<partition>/tasks.md` | 可执行 task、边界、artifact 要求 |
+| `specs/<partition>/tasks.md` | 可执行 task、边界、stage evidence 要求 |
 | `specs/<partition>/verify.md` | 验证设计契约；独立于 task planning / implementation authority |
-| `.sdd/runtime.sqlite` | runtime state、events、projections、evidence ledger、artifact logical-ref 到 physical payload 的事实源 |
+| `.sdd/runtime.sqlite` | runtime state、events、projections、evidence ledger、selection pointers、refs/hashes 的事实源 |
 | `.sdd/run-index.json` | 可重建的本地查询索引，不是权威事实源 |
-| `.sdd/runs/<branchSlug>/evidence/artifacts/*` | branch-scoped review / validation / test-validation / test / subagent payloads；物理文件可带 runId/hash 后缀 |
+| `.sdd/runs/<branch>/<stage>/*.md` | agent/stage-manager authored stage evidence；runtime 只注册 ref/hash/gate metadata |
 | `.claude/**` | managed AI entry projection，不是手写事实源 |
 
 ## 文档地图
 
 | 文档 | 面向对象 | 用途 |
 |---|---|---|
-| [用户指南](docs/user-guide.md) | 人类用户 | 安装、初始化、执行任务、test gate、sync-back、subagent digest、doctor、常见问题 |
-| [AI README](docs/ai-readme.md) | Claude Code / AI 操作者 | status-first、artifact、task boundary、sync-back 策略 |
+| [用户指南](docs/user-guide.md) | 人类用户 | 安装、初始化、执行任务、test gate、truthAlignment、subagent digest、doctor、常见问题 |
+| [AI README](docs/ai-readme.md) | Claude Code / AI 操作者 | status-first、stage evidence、task boundary、truthAlignment 策略 |
 | [文档信息架构](docs/documentation-information-architecture.md) | 维护者 | Markdown 分类、迁移风险、当前入口地图 |
 | [命令信息架构](docs/architecture/command-information-architecture.md) | 平台维护者 | CLI 命令分层、入口职责和用户路径 |
 | [架构设计](docs/architecture/sdd-agent-platform-architecture.md) | 平台维护者 | 平台架构和核心设计 |
 | [Lifecycle Decision Model](docs/architecture/lifecycle-decision-model.md) | 平台维护者 | direct / compact / full / research 的决策模型 |
 | [Phase artifacts index](specs/master/phases/README.md) | 平台维护者 | 本仓库 SDD phase 归档入口 |
-| [Phase status](specs/master/phases/PHASE_STATUS.md) | 平台维护者 | 当前阶段状态；截至 Phase 8 coding runtime convergence completed，Phase 9 code graph signals planned |
+| [Phase status](specs/master/phases/PHASE_STATUS.md) | 平台维护者 | 当前阶段状态；Phase 9 正在收敛 runtime control-plane、six-bundle 入口、truthAlignment 与旧 surface 清理 |
 
 研究与历史分析材料保留在 `docs/research/`；runtime contract assets 保留在 `commands/`、`agents/`、`templates/`、`workflows/` 等目录，不作为普通 Markdown 文档搬迁。
 
@@ -151,13 +152,14 @@ subagent 输出的 `agents[].digest`、`summaryRefs` 和 `doNotReadUnlessNeededR
 packages/          TypeScript runtime 与 CLI
 commands/          Claude Code 命令入口说明源材料
 agents/            SDD lifecycle agent contract
-templates/         spec / plan / tasks / project / sync-back 模板
+templates/         spec / plan / tasks / project 模板
 workflows/         阶段 workflow contract
 adapters/          项目适配模板
-schemas/           runtime、artifact 与 contract pack
+schemas/           runtime、stage evidence 与 contract pack
 docs/              用户、AI、架构、研究文档
 specs/             本项目自身的 SDD 文档
-.sdd/              本地运行状态和证据
+runs/              agent/stage-manager authored branch stage evidence
+.sdd/              本地 runtime 状态和索引
 context/           项目记忆与决策上下文
 ```
 
@@ -224,11 +226,11 @@ sdd doctor
 - 自动 commit / push / force push。
 - 自动创建 PR、issue、外部评论或修改共享系统。
 - 自动执行 destructive git、清理未提交变更或删除历史 run evidence。
-- 未经确认对复杂任务执行 `sync-back apply --approved`。
+- 绕过 runtime gate、truthAlignment、accepted evidence selection 或人工确认要求直接标记通过。
 - 把 `.claude/**`、`commands/**`、`agents/**`、`templates/**`、`workflows/**` 当作普通文档随意搬迁。
 
-已有未提交变更不应阻塞 SDD workflow；正确做法是通过 branch/partition、run evidence、artifact 和 sync-back 策略隔离风险，而不是要求工作树必须干净。
+已有未提交变更不应阻塞 SDD workflow；正确做法是通过 branch/partition、runtime state、stage evidence refs/hashes 和 accepted selection pointers 隔离风险，而不是要求工作树必须干净。
 
 ## 当前状态
 
-截至当前主线文档，Phase 1~7 已完成平台编排、入口投影、分发、harness engineering、agent/skill/team runtime、storage v2、verification/test、sync-back/ship 和 core modularization 等基础；Phase 8 已定稿为 Coding Runtime Convergence：围绕 verifies-centered lifecycle、`/sdd:tasks -> /sdd:do -> /sdd:test` 顺序实现与 batch/wave 验证、risk workflow gates、subagent 非授权边界、context offload、task-scoped sync-back readiness 和 ship diagnostics/readiness 语义收敛。代码知识图谱不再作为 Phase 8 当前目标，顺延为 Phase 9 Code Graph Signals，并只能作为可选风险、上下文、test-impact、status/doctor 信号源。
+截至当前主线文档，Phase 1~8 已完成平台编排、入口投影、分发、harness engineering、agent/skill/team runtime、storage v2、verification/test、ship 和 core modularization 等基础；Phase 9 正在落地 runtime control-plane：six-bundle 用户入口、八个内部 runtime stage、SQLite current state、stage evidence refs/hashes、truthAlignment、accepted evidence selection、advisory nextIntent，以及旧入口/旧 evidence surface 清理。

package/node_modules/@sdd-agent-platform/core/dist/ai-tools.js

@@ -20,20 +20,37 @@ Use the local or globally installed \`sdd\` CLI as the source of truth for this
 
 1. Accept the user's natural-language intent, then run \`sdd status\` first and report only workflow state, blocker/current task, and the recommended next command; do not paste or restate full status unless asked.
 2. Run \`sdd instructions overview --json\` only when the next action is unclear or you need the full dynamic command contract.
-3. Dynamic routing comes from CLI/core output, not this skill text; follow the recommended next command before choosing a projected command entry (\`spec\`, \`plan\`, \`tasks\`, \`do\`, \`test\`, \`ship\`, or \`doctor\`).
+3. Dynamic routing comes from CLI/core output, not this skill text; follow the recommended next command before choosing a projected command bundle (\`spec\`, \`plan\`, \`tasks\`, \`do\`, \`test\`, \`ship\`, or \`doctor\`). The \`tasks\` bundle covers \`tasks -> verifies\`; the \`test\` bundle covers \`test -> goal-verify\`.
 4. If the intent is still ambiguous after status, ask one clarifying question before spec/plan/do/test/ship work.
 5. For risky requests that mention state-machine, concurrency, database, SQL, security, API/schema, CI/build, or external unknowns, run \`sdd lifecycle decide --from-text <text>\` before spec/plan work.
 6. If status reports workflow_status=not_started, start the spec stage for the resolved Git branch partition; do not use \`sdd init\` as the workflow branch entry.
 7. If status points to gaps, drift, or doctor/update work, handle that maintenance action before do/test/ship.
 8. If status recommends a task, run \`sdd tasks inspect <task_id>\` and use the task Boundary and Acceptance before starting \`do\`.
-9. If status recommends do or test, follow the corresponding projected command entry or its canonical CLI command instead of inferring completion from chat.
-10. If status exposes legacy sync-back or projection drift, treat \`sdd sync-back inspect|apply\` as diagnostic/recovery/replay only; do not insert it into the ordinary happy path.
-11. If the user asks to release or go online, run \`sdd ship --branch <branch> --dry-run\` for local readiness first; do not publish, push, tag, or create external release state without explicit confirmation.
+9. If status recommends do, tasks, or test, follow the corresponding projected command bundle or its canonical CLI command instead of inferring completion from chat.
+10. If status exposes projection drift, run \`sdd doctor\` and follow diagnostic/recovery guidance before resuming the ordinary happy path.
+11. If the user asks to release or go online, run \`sdd ship close --branch <branch> --json\` for local readiness first; do not publish, push, tag, or create external release state without explicit confirmation.
 
 Refresh this managed skill with \`sdd update\` when drift is reported.
 `
             },
             commandEntry('sdd-doctor', '.claude/commands/sdd/doctor.md', 'doctor', 'Check project config, scoped run evidence, generated AI entry drift, and use sdd doctor fast|deep|recover for explicit diagnostic scope.'),
+            {
+                id: 'sdd-update',
+                kind: 'command',
+                relativePath: '.claude/commands/sdd/update.md',
+                title: 'SDD update',
+                body: `Refresh SDD-managed AI entries and re-import declared external/user-global/project skill capability metadata through the same idempotent update path used by init bootstrap. Use this for existing initialized projects when generated entries drift or a skill import needs dedupe/refresh.
+
+Run:
+
+\`\`\`bash
+sdd update
+sdd update --import-skill <capability_id> --source project|user-global|external --source-ref <path-or-reference> --domain <domain> --stage <stage>
+\`\`\`
+
+This command is maintenance only: it updates SDD-managed projections and non-authoritative skill capability metadata in .sdd/project.yml. It does not execute imported skills, grant lifecycle authority, close gates, or publish external state.
+`
+            },
             {
                 id: 'sdd-spec',
                 kind: 'command',
@@ -60,125 +77,106 @@ Do not design implementation in \`spec.md\`; stop before plan work when requirem
                 kind: 'command',
                 relativePath: '.claude/commands/sdd/plan.md',
                 title: 'SDD plan',
-                body: `Refine the existing SDD plan document as a deliverable technical solution, not a lightweight approach summary. Include based_on_spec_hash from status so later spec-stage revisions can mark this plan stale. Agent visibility: scout/planner/spec-reviewer may participate; evidence lands in plan or review artifacts.
+                body: `Refine specs/<branch>/plan.md and .sdd/runs/<branch>/plan/*.md as agent-authored plan-stage evidence. Runtime close validates refs, hashes, contracts, and handoff state into .sdd/runtime.sqlite; it must not create or modify Markdown.
 
 Run:
 
 \`\`\`bash
 sdd instructions plan --json
+sdd plan close --branch <branch> --json
 \`\`\`
 
-Then write or refine \`specs/<branch>/plan.md\` as the technical bridge from approved spec to task-ready execution. Include background, goals/non-goals, current state, target design, architecture/component impact, interaction/sequence design, state/data design, API/schema design, concurrency/transaction/consistency design, key decisions, alternatives, risk control, rollout/rollback, validation matrix, and task breakdown rationale.
+Then write or refine \`specs/<branch>/plan.md\` as the technical bridge from approved spec to task-ready execution. Have planner/reviewer/plan-manager author \`.sdd/runs/<branch>/plan/*.md\` evidence, including \`plan-collaboration-contract-vN.md\`, before close.
 
-Use PlantUML fences for diagrams when useful: component diagrams for impact surface, sequence/activity diagrams for workflows and concurrency, state diagrams for state-machine risk, and deployment/data diagrams when release or data topology matters. Apply risk-driven requirements before task writing: state-machine risk needs a state diagram; concurrency risk needs sequence/activity plus consistency design; database risk needs data/transaction/rollback design; api_schema risk needs interface/schema compatibility; security/sql risk needs explicit risk controls.
+Use PlantUML fences for diagrams when useful: component diagrams for impact surface, sequence/activity diagrams for workflows and concurrency, state diagrams for state-machine risk, and deployment/data diagrams when release or data topology matters. Stop before tasks when the technical solution is incomplete or has unresolved design gaps.
 
-Stop before creating tasks when the technical solution is incomplete or has unresolved design gaps.
-`
+Do not let runtime author, repair, normalize, or migrate Markdown.`
             },
             {
                 id: 'sdd-tasks',
                 kind: 'command',
                 relativePath: '.claude/commands/sdd/tasks.md',
                 title: 'SDD tasks',
-                body: `Refine the existing SDD tasks stage outputs as executable task and verification contracts, not a plain TODO list or project-management backlog. Include based_on_plan_hash from status so later plan/spec revisions can mark these contracts stale. Agent visibility: task-planner writes tasks.md; task-quality, dependency/parallelization, validation-strategy, verification-designer, and verification-reviewer roles may participate before contracts freeze.
+                body: `Use this generated command as the user-visible bundle for the \`tasks -> verifies\` runtime stages. First refine specs/<branch>/tasks.md and .sdd/runs/<branch>/tasks/*.md as agent-authored tasks-stage evidence, then continue to verifies through this bundle only after runtime/status targets that internal stage.
 
 Run:
 
 \`\`\`bash
+sdd status
 sdd instructions tasks --json
 sdd tasks format
+sdd tasks close --branch <branch> --json
+sdd tasks close --branch <branch> --target verifies --json
 \`\`\`
 
-Then write or refine \`specs/<branch>/tasks.md\` from the approved spec and plan, and ensure \`specs/<branch>/verify.md\` is created or refreshed by the verification-designer after the task contract is stable. Include Delivery Map, implementation waves, validation batches/waves, review gate declarations, task blocks with acceptance_refs and plan_refs, affected_files, change_surface, implementation_wave, validation_batch, validation_timing, requires_verify_before_next, validation, risk, agent_fit, allowed_agents, required_artifacts, verification_availability, autonomy, plus companion sections for Boundary, Acceptance, Definition of Done, Evidence Expectations, and Implementation Notes.
+Workflow:
 
-Keep metadata inside the \`\`\`sdd-task fenced block and companion sections outside it. Use \`validation_timing: task_end\` and \`requires_verify_before_next: true\` for strict/high-risk tasks; use \`batch_end\` or \`wave_end\` with \`validation_batch\` only when sequential accumulation is safe. Frontend-only tasks must not declare Maven/Gradle backend build validation. Stop before \`sdd do task\` when task boundary, acceptance refs, plan refs, evidence requirements, validation batches/waves, or verify contract expectations are unclear.
-`
+1. Write or refine \`specs/<branch>/tasks.md\` from the approved spec and plan. Include Delivery Map, implementation waves, validation batches/waves, review gate declarations, task blocks with acceptance_refs and plan_refs, affected_files, change_surface, implementation_wave, validation_batch, validation_timing, requires_verify_before_next, validation, risk, agent_fit, allowed_agents, required_artifacts, verification_availability, autonomy, plus companion sections for Boundary, Acceptance, Definition of Done, Evidence Expectations, and Implementation Notes.
+2. Have task-planner/reviewer/tasks-manager author \`.sdd/runs/<branch>/tasks/*.md\` evidence, including \`tasks-collaboration-contract-vN.md\`, before \`sdd tasks close\`. Keep metadata inside the \`\`\`sdd-task fenced block and companion sections outside it.
+3. Run \`sdd tasks close --branch <branch> --json\`; runtime validates refs/frontmatter/hashes/contracts and writes only SQLite.
+4. If the fresh runtime handoff targets \`verifies\` inside this same bundle, have verification-designer/reviewer/verifies-manager author \`specs/<branch>/verify.md\` plus \`.sdd/runs/<branch>/verifies/*.md\` evidence, including \`verifies-collaboration-contract-vN.md\`.
+5. Run \`sdd tasks close --branch <branch> --target verifies --json\`; runtime validates verifies-stage refs/contracts and returns the next legal route.
+
+Do not implement code, run validation commands, silently advance to do, or let runtime author Markdown.`
             },
             {
                 id: 'sdd-test',
                 kind: 'command',
                 relativePath: '.claude/commands/sdd/test.md',
                 title: 'SDD test',
-                body: `Execute validation from the frozen tasks.md + verify.md contract, capture command output, evaluate acceptance evidence coverage, and return one unified test or validation-wave judgment.
+                body: `Use this generated command as the user-visible bundle for the \`test -> goal-verify\` runtime stages. Bind validation intent to an accepted verify.md validation unit, execute that unit, keep command summaries in runtime read models, have test-stage agents author .sdd/runs/<branch>/test/*.md evidence, then continue to goal verification through this bundle only after runtime/status targets that internal stage.
 
 Run:
 
 \`\`\`bash
 sdd status
 sdd instructions test --json
-# sdd test consumes the current verify.md contract and blocks if it is missing or stale; do not generate verify.md here.
-sdd test task <task_id> --branch <branch>
-sdd test batch <batch_id> --branch <branch>
-sdd test wave --branch <branch> --wave <n>
+sdd test <validation_unit_id-or-validation_text> --branch <branch>
+sdd test close --branch <branch> --json
+sdd test close --branch <branch> --target goal-verify --json
 \`\`\`
 
 Workflow:
 
-1. Confirm \`verify.md\` exists and is current for the selected branch; if it is missing or stale, return to \`/sdd:tasks\` or use explicit \`sdd verifies write\` recovery before testing.
-2. Use \`sdd test task <task_id>\` for strict or task_end tasks, or for deliberate narrowed overrides with \`--command\`, \`--run\`, \`--command-json\`, \`--command-file\`, or passthrough argv.
-3. For batch_end or wave_end tasks, use the verify-declared \`sdd test batch <batch_id>\` or \`sdd test wave\` boundary so accumulated implementation evidence is judged together; default \`sdd test task\` routes batch_end tasks to their batch and wave_end tasks to their wave boundary.
-4. Treat generated command logs, test index, validator artifact, acceptance maps, and workflow gate decisions as runtime evidence references, not as workflow documents.
-5. If validation returns PASS, proceed to a decision card if policy requires one, otherwise run \`sdd ship --branch <branch> --dry-run\`; if it returns FAIL or BLOCKED, fix the reported command or evidence gaps and rerun the same test boundary.
+1. Confirm accepted \`verify.md\` exists for the selected branch; if missing or stale, return to verifies through the tasks bundle.
+2. Use \`sdd test <validation_unit_id-or-validation_text> --branch <branch>\` as the normal entry; task id, validation batch id, and accepted task title/text are equivalent only when they bind to one verify.md validation unit.
+3. Use \`sdd test task|batch|wave\` only for explicit low-level diagnostics, replay, or narrowed override flags such as \`--command\`, \`--run\`, \`--command-json\`, \`--command-file\`, or passthrough argv.
+4. Have test-runner/reviewer/test-manager author \`.sdd/runs/<branch>/test/*.md\` evidence, including \`test-collaboration-contract-vN.md\`; PASS command output should not create log artifacts unless the validation contract explicitly needs stdout/stderr as primary evidence.
+5. Run \`sdd test close --branch <branch> --json\`; runtime validates refs/frontmatter/hashes/contracts and writes only SQLite.
+6. If the fresh runtime handoff targets \`goal-verify\` inside this same bundle, have goal-verifier/reviewer author \`.sdd/runs/<branch>/goal-verify/*.md\` evidence, then run \`sdd test close --branch <branch> --target goal-verify --json\` so runtime records truthAlignment before ship readiness.
 
-Do not auto-fix failures, author or refresh \`verify.md\`, mutate \`tasks.md\`, apply sync-back, commit, publish, or treat command success alone as semantic PASS.
-`
+Do not auto-fix failures, author or refresh \`verify.md\`, mutate \`tasks.md\`, commit, publish, or treat command success alone as semantic PASS.`
             },
             {
                 id: 'sdd-do',
                 kind: 'command',
                 relativePath: '.claude/commands/sdd/do.md',
                 title: 'SDD do',
-                body: `Execute one approved SDD task boundary through the ingestion-aware task workflow.
+                body: `Semantically bind /sdd:do or sdd do task input to one accepted task boundary, then run do-stage collaboration: implementer/reviewer/do-manager write .sdd/runs/<branch>/do/*.md evidence and runtime reconciles gate truth into SQLite.
 
 Run:
 
 \`\`\`bash
 sdd status
 sdd instructions do --json
-sdd tasks inspect <task_id>
+sdd tasks inspect <bound_task_id>
 \`\`\`
 
 Workflow:
 
-Agent evidence flow: scout gathers bounded context only; implementer edits only inside the selected task boundary; reviewer records review evidence; debugger is optional after review failure; validator records validation and acceptance mapping. Artifact flags use run-relative paths such as \`artifacts/implement-<task_id>.md\`, \`artifacts/review-<task_id>.md\`, and \`artifacts/validation-<task_id>.md\`; physical files live under branch evidence \`.sdd/runs/<branchSlug>/evidence/artifacts/\`. This command entry does not authorize autonomous background execution.
+Use CLI/core output as the source of truth. Task id and accepted task title/text are equivalent when they bind to the same accepted task boundary. Agent evidence flow: implementer edits only inside the bound task boundary and writes \`.sdd/runs/<branch>/do/implementation-vN.md\`; code-reviewer writes \`.sdd/runs/<branch>/do/code-review-vN.md\`; do-manager writes \`.sdd/runs/<branch>/do/do-manager-vN.md\` as a closure request. Runtime reads these Markdown refs/hashes/frontmatter, validates the gate, and writes only SQLite projections/run state. This command entry does not authorize autonomous background execution.
 
 
-1. Resolve exactly one task id from the user request or from the \`sdd status\` recommended next command. Stop and ask if it is ambiguous.
-2. Read \`sdd tasks inspect <task_id>\` and restate the task Boundary, Acceptance, gaps, and validation commands.
+1. Run \`sdd status\`, then let CLI/core bind the user request or recommended next command to exactly one accepted task boundary. Stop if binding is ambiguous, missing, stale, or boundary-expanding.
+2. Run \`sdd instructions do --json\` and \`sdd tasks inspect <bound_task_id>\`; restate only the bound task Boundary, blocking gaps, and validation commands.
 3. Work only inside the selected task boundary; do not expand scope without a checkpoint.
-4. Before creating explicit result artifacts, create the task run first, then write templates through the CLI writer: \`sdd artifact template artifacts/implement-<task_id>.md --task <task_id> --agent implementer --run <run_id> --write\`, \`sdd artifact template artifacts/review-<task_id>.md --task <task_id> --agent reviewer --run <run_id> --write\`, and \`sdd artifact template artifacts/validation-<task_id>.md --task <task_id> --agent validator --run <run_id> --write\`; do not manually create copies under \`specs/<branch>/artifacts/\` or \`specs/<branch>/evidence/artifacts/\`. Pass the run-relative \`artifacts/<file>\` path to CLI flags, and keep source/test files in \`## Evidence\`, not in \`sdd-result.artifacts\`.
-5. Run \`sdd artifact validate <run_id> <artifact> --task <task_id> --agent <agent>\` before passing artifacts into \`sdd do task <task_id>\`.
-6. Run \`sdd do task <task_id>\` with explicit artifact paths when evidence is available; this path records Phase 3 artifact ingestion evidence for doctor.
-7. Report the run id, status, agent evidence artifacts, gaps, and next gate. If completed, follow the \`sdd status\` recommended next command: continue sequential \`sdd do task\` when safe, run \`sdd test task\` for strict/task_end work, or run \`sdd test batch\` / \`sdd test wave\` at the declared validation boundary.
+4. Implement within affected_files and capture changed file refs/hashes in \`.sdd/runs/<branch>/do/implementation-vN.md\` frontmatter.
+5. Have code-reviewer write \`.sdd/runs/<branch>/do/code-review-vN.md\` against the implementation evidence hash, whether approved or blocked.
+6. Have do-manager write \`.sdd/runs/<branch>/do/do-manager-vN.md\` as a closure request that references the reviewed implementation and review hash.
+7. Run \`sdd do task <task_id-or-task-text> --branch <branch>\`; runtime must read \`.sdd/runs/<branch>/do/*.md\`, validate frontmatter/hash/review/manager closure, and write only SQLite projections/run state.
+8. Report the run id, status, binding target, blocking gaps, accepted evidence refs, and next gate. If completed, proceed to \`sdd test <validation_unit_id-or-validation_text> --branch <branch>\` for verification.
 
-Do not create worktrees, auto commit, or mark missing evidence as PASS.
-`
-            },
-            {
-                id: 'sdd-sync-back',
-                kind: 'command',
-                relativePath: '.claude/commands/sdd/sync-back.md',
-                title: 'SDD sync-back',
-                body: `Inspect or replay legacy task completion write-back state for diagnostic, recovery, or compatibility use. Sync-back is a low-level projection repair command, not an ordinary happy-path workflow stage.
-
-Run:
-
-\`\`\`bash
-sdd status
-sdd instructions sync-back --json
-sdd sync-back inspect --branch <branch> --task <task_id>
-\`\`\`
-
-Diagnostic workflow:
-
-1. Resolve exactly one task id and workflow partition from an explicit recovery request, old run replay, CI inspection, or doctor/status diagnostic. Stop and ask if either is ambiguous.
-2. Run \`sdd sync-back inspect --branch <branch> --task <task_id>\` before any apply; pass \`<run_id>\` only for replay, CI, or old-run inspection.
-3. Report what apply would write: target tasks file, task id, markdown status transition, proposal path, evidence artifacts, apply_policy, and policy reasons.
-4. If inspect reports \`status=ready\` and \`apply_policy=direct\`, run \`sdd sync-back apply --branch <branch> --task <task_id>\` only for explicit recovery/replay.
-5. If inspect reports approval_required=true, ask for explicit human confirmation and only then run \`sdd sync-back apply --branch <branch> --task <task_id> --approved\`.
-6. Explain that default apply writes only tasks.md for the target task, appends the sync-back implementation note, marks run sync_back applied, and rebuilds the local run index; \`--refresh-verify\` is an explicit recovery option after reviewed task-contract changes.
-
-Do not apply without inspect, do not use \`--approved\` without human confirmation, do not change source files during sync-back, and do not recommend sync-back after normal \`/sdd:test\` PASS.
+Do not create worktrees, auto commit, mark missing evidence as PASS, or let runtime author Markdown artifacts.
 `
             },
             {
@@ -186,26 +184,26 @@ Do not apply without inspect, do not use \`--approved\` without human confirmati
                 kind: 'command',
                 relativePath: '.claude/commands/sdd/ship.md',
                 title: 'SDD ship',
-                body: `Run local release-readiness checks and optionally write \`specs/<branch>/release.md\`. This command is a preflight/release-summary gate; it does not authorize npm publish, git push, git tag, deploy, or external release creation.
+                body: `Close ship readiness through agent-authored .sdd/runs/<branch>/ship/*.md evidence. Optional specs/<branch>/release.md is ship-agent authored, not runtime-authored.
 
 Run:
 
 \`\`\`bash
-sdd ship --branch <branch> --dry-run
+sdd status
 sdd instructions ship --json
+sdd ship close --branch <branch> --json
 \`\`\`
 
 Workflow:
 
 1. Resolve the target branch/partition from \`sdd status\` or the user's explicit branch.
-2. Run \`sdd ship --branch <branch> --dry-run\` first; inspect PASS/BLOCKED readiness and next actions without writing \`release.md\`.
-3. If the readiness output is acceptable, run \`sdd ship --branch <branch>\` to write \`specs/<branch>/release.md\`.
-4. Use \`sdd statusline --branch <branch>\` for compact runtime/test/team/token/evidence health when reporting progress.
+2. Confirm goal-verify has recorded aligned truthAlignment or validated reconciliation truth.
+3. Have ship-manager/release agent author \`.sdd/runs/<branch>/ship/*.md\` evidence, including \`ship-collaboration-contract-vN.md\`; write \`specs/<branch>/release.md\` only as an explicit ship-agent artifact if needed.
+4. Run \`sdd ship close --branch <branch> --json\`; runtime validates readiness refs/contracts/truthAlignment and writes only \`.sdd/runtime.sqlite\`.
 5. Run generated-entry drift, current-run health, typecheck, test, build, and package dry-run gates when preparing a real package release.
 6. Stop before publish, push, tag, deploy, or external release creation unless the user explicitly approves that separate action.
 
-Do not skip failed gates, do not treat historical doctor debt as a release blocker unless it affects current evidence, and do not mutate external release state from this preflight command.
-`
+Do not skip failed gates, do not treat historical doctor debt as a release blocker unless it affects current evidence, and do not let runtime author release Markdown.`
             }
         ];
     }

package/node_modules/@sdd-agent-platform/core/dist/ai-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai-tools.js","sourceRoot":"","sources":["../src/ai-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AACnC,MAAM,CAAC,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;AACnD,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC;AAoEjD,MAAM,CAAC,MAAM,iBAAiB,GAAkB;IAC9C,EAAE,EAAE,mBAAmB;IACvB,WAAW,EAAE,aAAa;IAC1B,OAAO;QACL,OAAO;YACL;gBACE,EAAE,EAAE,KAAK;gBACT,IAAI,EAAE,OAAO;gBACb,YAAY,EAAE,6BAA6B;gBAC3C,KAAK,EAAE,cAAc;gBACrB,IAAI,EAAE;;;;;;;;;;;;;;;;;CAiBb;aACM;YAED,YAAY,CAAC,YAAY,EAAE,gCAAgC,EAAE,QAAQ,EAAE,0IAA0I,CAAC;YAClN;gBACE,EAAE,EAAE,UAAU;gBACd,IAAI,EAAE,SAAS;gBACf,YAAY,EAAE,8BAA8B;gBAC5C,KAAK,EAAE,UAAU;gBACjB,IAAI,EAAE;;;;;;;;;;;;;;CAcb;aACM;YACD;gBACE,EAAE,EAAE,UAAU;gBACd,IAAI,EAAE,SAAS;gBACf,YAAY,EAAE,8BAA8B;gBAC5C,KAAK,EAAE,UAAU;gBACjB,IAAI,EAAE;;;;;;;;;;;;;CAab;aACM;YACD;gBACE,EAAE,EAAE,WAAW;gBACf,IAAI,EAAE,SAAS;gBACf,YAAY,EAAE,+BAA+B;gBAC7C,KAAK,EAAE,WAAW;gBAClB,IAAI,EAAE;;;;;;;;;;;;CAYb;aACM;YACD;gBACE,EAAE,EAAE,UAAU;gBACd,IAAI,EAAE,SAAS;gBACf,YAAY,EAAE,8BAA8B;gBAC5C,KAAK,EAAE,UAAU;gBACjB,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;CAsBb;aACM;YACD;gBACE,EAAE,EAAE,QAAQ;gBACZ,IAAI,EAAE,SAAS;gBACf,YAAY,EAAE,4BAA4B;gBAC1C,KAAK,EAAE,QAAQ;gBACf,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;CAwBb;aACM;YACD;gBACE,EAAE,EAAE,eAAe;gBACnB,IAAI,EAAE,SAAS;gBACf,YAAY,EAAE,mCAAmC;gBACjD,KAAK,EAAE,eAAe;gBACtB,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;CAoBb;aACM;YACD;gBACE,EAAE,EAAE,UAAU;gBACd,IAAI,EAAE,SAAS;gBACf,YAAY,EAAE,8BAA8B;gBAC5C,KAAK,EAAE,UAAU;gBACjB,IAAI,EAAE;;;;;;;;;;;;;;;;;;;CAmBb;aACM;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,YAA6B,MAAM;IACnE,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;QACzB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,SAAS,KAAK,MAAM,IAAI,SAAS,KAAK,mBAAmB,EAAE,CAAC;QAC9D,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,UAA+B,EAAE;IACpE,OAAO,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CACzD,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,oBAAoB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CACvE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,WAAmB,EAAE,UAA+B,EAAE;IAC7F,MAAM,OAAO,GAAyB,EAAE,CAAC;IACzC,KAAK,MAAM,OAAO,IAAI,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACtD,MAAM,OAAO,GAA0B,EAAE,CAAC;QAC1C,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;QACpC,MAAM,gBAAgB,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,oBAAoB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC9F,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,qBAAqB,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAClH,KAAK,MAAM,SAAS,IAAI,gBAAgB,EAAE,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,MAAM,UAAU,CAAC,WAAW,EAAE,SAAS,EAAE,OAAO,CAAC,KAAK,KAAK,IAAI,EAAE,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC;QACzG,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,6BAA6B,CAAC,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,CAAC,KAAK,KAAK,IAAI,EAAE,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC;QACrJ,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,WAAmB,EAAE,UAA+B,EAAE;IAChG,OAAO,kBAAkB,CAAC,WAAW,EAAE,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,OAA6B;IACvE,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1F,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,eAAe,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,UAAU,CAAC,EAAE,CAAC;QACpL,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,SAAS,CAAC,EAAE,CAAC;QACpD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,YAAY,CAAC,EAAU,EAAE,YAAoB,EAAE,MAAc,EAAE,OAAe;IACrF,OAAO;QACL,EAAE;QACF,IAAI,EAAE,SAAS;QACf,YAAY;QACZ,KAAK,EAAE,OAAO,MAAM,EAAE;QACtB,IAAI,EAAE,GAAG,OAAO,4CAA4C,MAAM,6EAA6E;KAChJ,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,EAAU,EAAE,YAAoB,EAAE,MAAc,EAAE,OAAe,EAAE,aAAqB;IACpH,OAAO;QACL,EAAE;QACF,IAAI,EAAE,SAAS;QACf,YAAY;QACZ,KAAK,EAAE,OAAO,MAAM,EAAE;QACtB,IAAI,EAAE,GAAG,OAAO,4CAA4C,MAAM,YAAY,aAAa,0dAA0d;KACtjB,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,OAAsB,EAAE,KAA0B;IAC9E,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,WAAW,GAAG;QAClB,KAAK;QACL,mBAAmB;QACnB,iBAAiB,iBAAiB,EAAE;QACpC,iBAAiB,WAAW,GAAG;QAC/B,aAAa,OAAO,CAAC,EAAE,EAAE;QACzB,sBAAsB,KAAK,CAAC,IAAI,EAAE;QAClC,oBAAoB,KAAK,CAAC,EAAE,EAAE;QAC9B,gCAAgC;QAChC,oBAAoB,IAAI,EAAE;QAC1B,KAAK;KACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,EAAE;QAChB,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,OAAO,EAAE,GAAG,WAAW,OAAO,KAAK,CAAC,IAAI,EAAE;QAC1C,IAAI;QACJ,OAAO,EAAE,WAAW;QACpB,SAAS,EAAE,aAAa;QACxB,cAAc,EAAE,iBAAiB;KAClC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,WAAmB,EAAE,SAA2B,EAAE,SAAkB,EAAE,KAAc;IAC5G,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QAC7E,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAClD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7D,MAAM,SAAS,CAAC,YAAY,EAAE,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACzD,OAAO,YAAY,CAAC,SAAS,EAAE,SAAS,EAAE,2BAA2B,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,YAAY,CAAC,SAAS,EAAE,SAAS,EAAE,8BAA8B,EAAE,iBAAiB,CAAC,CAAC;IAC/F,CAAC;IAED,MAAM,OAAO,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC9C,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,OAAO,YAAY,CAAC,SAAS,EAAE,SAAS,EAAE,+CAA+C,EAAE,uEAAuE,CAAC,CAAC;IACtK,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,KAAK,iBAAiB,EAAE,CAAC;QAC3C,OAAO,YAAY,CAAC,SAAS,EAAE,UAAU,EAAE,uCAAuC,OAAO,CAAC,QAAQ,IAAI,SAAS,GAAG,EAAE,4CAA4C,CAAC,CAAC;IACpK,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;QAC9G,OAAO,YAAY,CAAC,SAAS,EAAE,WAAW,EAAE,8BAA8B,CAAC,CAAC;IAC9E,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/D,OAAO,YAAY,CAAC,SAAS,EAAE,eAAe,EAAE,oEAAoE,EAAE,kFAAkF,CAAC,CAAC;IAC5M,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,SAAS,CAAC,YAAY,EAAE,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACzD,OAAO,YAAY,CAAC,SAAS,EAAE,SAAS,EAAE,6BAA6B,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO,YAAY,CAAC,SAAS,EAAE,SAAS,EAAE,iEAAiE,EAAE,iBAAiB,CAAC,CAAC;AAClI,CAAC;AAED,KAAK,UAAU,6BAA6B,CAC1C,WAAmB,EACnB,OAAsB,EACtB,SAAgC,EAChC,aAA0B,EAC1B,SAAkB,EAClB,KAAc;IAEd,MAAM,OAAO,GAA0B,EAAE,CAAC;IAC1C,KAAK,MAAM,YAAY,IAAI,MAAM,8BAA8B,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,CAAC;QACxF,MAAM,YAAY,GAAG,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC;QACrF,IAAI,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YACpC,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QACtD,MAAM,OAAO,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,QAAQ,KAAK,iBAAiB,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,EAAE,EAAE,CAAC;YAC9F,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,sBAAsB,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;QACxE,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAChD,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,eAAe,EAAE,mDAAmD,EAAE,wFAAwF,CAAC,CAAC,CAAC;YACrM,SAAS;QACX,CAAC;QAED,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,UAAU,EAAE,0CAA0C,EAAE,8CAA8C,CAAC,CAAC,CAAC;YAC7I,SAAS;QACX,CAAC;QAED,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QAC3B,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,SAAS,EAAE,oCAAoC,CAAC,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,8BAA8B,CAAC,WAAmB,EAAE,SAAgC;IACjG,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;QAC7E,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3B,IAAI,SAAS,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC;YAC9C,WAAW,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,SAAS,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE,CAAC;YAC5C,WAAW,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,SAAS,IAAI,WAAW,EAAE,CAAC;QACpC,MAAM,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;AACpB,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,SAAiB,EAAE,KAAkB;IAC/D,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QACzF,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAClD,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;IACH,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACtD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,YAAY,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QAC1C,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1B,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB,CAC7B,OAAsB,EACtB,YAAoB,EACpB,OAAkG;IAElG,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,EAAE;QAChB,EAAE,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACjF,IAAI,EAAE,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;QACpD,YAAY;QACZ,OAAO,EAAE,EAAE;QACX,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,QAAQ;QACtC,OAAO,EAAE,WAAW;QACpB,SAAS,EAAE,aAAa;QACxB,cAAc,EAAE,iBAAiB;KAClC,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,YAAoB;IACjD,OAAO,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAe;IAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC;IAC7D,OAAO;QACL,OAAO,EAAE,2BAA2B,CAAC,IAAI,CAAC,OAAO,CAAC;QAClD,QAAQ,EAAE,qBAAqB,CAAC,OAAO,EAAE,cAAc,CAAC;QACxD,OAAO,EAAE,qBAAqB,CAAC,OAAO,EAAE,aAAa,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,IAAI;QACrF,IAAI,EAAE,qBAAqB,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,IAAI;QACjF,QAAQ,EAAE,eAAe,CAAC,IAAI,CAAC;QAC/B,IAAI,EAAE,qBAAqB,CAAC,OAAO,EAAE,UAAU,CAAC;QAChD,IAAI,EAAE,qBAAqB,CAAC,OAAO,EAAE,mBAAmB,CAAC;QACzD,UAAU,EAAE,qBAAqB,CAAC,OAAO,EAAE,iBAAiB,CAAC;KAC9D,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAe,EAAE,GAAW;IACzD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,GAAG,iCAAiC,EAAE,GAAG,CAAC,CAAC,CAAC;IACvF,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC;AACpC,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,YAAY,CAAC,SAA2B,EAAE,MAAqB,EAAE,OAAe,EAAE,MAAe;IACxG,OAAO;QACL,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,EAAE,EAAE,SAAS,CAAC,EAAE;QAChB,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,YAAY,EAAE,SAAS,CAAC,YAAY;QACpC,MAAM;QACN,OAAO;QACP,MAAM;QACN,QAAQ,EAAE,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC;QAC1C,WAAW,EAAE,cAAc,CAAC,MAAM,CAAC;KACpC,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,SAA2B,EAAE,MAAqB;IACvE,OAAO;QACL,IAAI,EAAE,SAAS,CAAC,YAAY;QAC5B,UAAU,EAAE,SAAS,CAAC,EAAE;QACxB,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,OAAO,EAAE,SAAS,CAAC,OAAO;QAC1B,IAAI,EAAE,UAAU,SAAS,CAAC,IAAI,EAAE;QAChC,SAAS,EAAE,SAAS,CAAC,SAAS;QAC9B,WAAW,EAAE,cAAc,CAAC,MAAM,CAAC;QACnC,cAAc,EAAE,SAAS,CAAC,cAAc;QACxC,eAAe,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KAC1C,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,MAAqB;IAC3C,IAAI,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACnG,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,CAAC;AACnD,CAAC"}
+{"version":3,"file":"ai-tools.js","sourceRoot":"","sources":["../src/ai-tools.ts"],"names":[],"mappings":"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"}

package/node_modules/@sdd-agent-platform/core/dist/artifacts/ingestion.js

@@ -1,6 +1,8 @@
+import { createHash } from 'node:crypto';
+import { readFile } from 'node:fs/promises';
 import { ARTIFACT_RESULT_INGESTION_CONTRACT_VERSION } from '../contracts.js';
-import { getRunRelativeArtifactPath, toArtifactRootRelativePath } from '../runtime-paths.js';
-import { artifactKind } from '../run-state/artifacts.js';
+import { getBranchStageEvidencePathFromRef, isBranchStageEvidenceRef, normalizeStageEvidenceOrLegacyArtifactRef, toArtifactRootRelativePath, toEvidencePayloadFileName } from '../runtime-paths.js';
+import { artifactKind, readArtifact } from '../run-state/artifacts.js';
 import { appendEvent } from '../run-state/events.js';
 import { readRunState, writeRunState } from '../run-state/run-state.js';
 import { runtimeScopedId, withRuntimeStore } from '../storage/runtime-store.js';
@@ -10,16 +12,33 @@ import { isDerivedEvidenceRef } from './sdd-evidence.js';
 import { validateSddResultArtifact } from './sdd-result.js';
 export async function ingestArtifactResult(projectRoot, runId, input) {
     const state = await readRunState(projectRoot, runId);
-    const delegation = state.delegations[input.delegationId];
-    if (!delegation) {
+    const originalDelegation = state.delegations[input.delegationId];
+    if (!originalDelegation) {
         throw new Error(`Unknown delegation ${input.delegationId} in run ${runId}.`);
     }
-    const artifactPath = getRunRelativeArtifactPath(toArtifactRootRelativePath(input.artifactPath));
-    const key = artifactIngestionKey(input.delegationId, artifactPath);
+    const artifactPath = normalizeStageEvidenceOrLegacyArtifactRef(input.artifactPath);
+    const contentDigest = await hashArtifact(projectRoot, runId, artifactPath);
+    let delegation = originalDelegation;
+    let key = artifactIngestionKey(delegation.delegationId, artifactPath);
     const existing = (state.artifactIngestions ?? {})[key];
-    if (existing) {
+    if (existing?.status === 'accepted' && (!existing.contentDigest || existing.contentDigest === contentDigest)) {
+        return { valid: true, duplicate: true, record: existing, delegation };
+    }
+    if (existing?.status === 'accepted' && existing.contentDigest !== contentDigest) {
+        delegation = allocateRetryDelegation(state, originalDelegation, 'artifact_reingest');
+        key = artifactIngestionKey(delegation.delegationId, artifactPath);
+        const retryExisting = (state.artifactIngestions ?? {})[key];
+        if (retryExisting?.status === 'accepted' && retryExisting.contentDigest === contentDigest) {
+            return { valid: true, duplicate: true, record: retryExisting, delegation };
+        }
+    }
+    else if (existing) {
         return { valid: existing.status === 'accepted', duplicate: true, record: existing, delegation };
     }
+    else if (isDelegationTerminal(delegation.status)) {
+        delegation = allocateRetryDelegation(state, originalDelegation, 'artifact_reingest');
+        key = artifactIngestionKey(delegation.delegationId, artifactPath);
+    }
     const report = await validateSddResultArtifact(projectRoot, runId, artifactPath, { expectedTask: delegation.task, expectedAgent: delegation.agent });
     const issues = [...report.issues];
     if (isDelegationTerminal(delegation.status)) {
@@ -44,7 +63,10 @@ export async function ingestArtifactResult(projectRoot, runId, input) {
         delegationStatus: accepted ? targetStatus : (report.valid ? null : 'RECOVERABLE'),
         ingestedAt: now,
         issues,
-        gaps: accepted ? gaps : []
+        gaps: accepted ? gaps : [],
+        contentDigest,
+        retryOf: delegation.retryOf ?? null,
+        replayReason: delegation.replayReason ?? null
     };
     const nextDelegation = accepted
         ? { ...delegation, status: targetStatus, expectedArtifact: artifactPath, terminalEventAt: now }
@@ -139,6 +161,39 @@ async function recordRuntimeEvidenceAdmission(projectRoot, state, ingestion, tru
         }
     });
 }
+async function hashArtifact(projectRoot, runId, evidenceRef) {
+    if (isBranchStageEvidenceRef(evidenceRef)) {
+        try {
+            return createHash('sha256').update(await readFile(getBranchStageEvidencePathFromRef(projectRoot, evidenceRef), 'utf8'), 'utf8').digest('hex');
+        }
+        catch {
+            return createHash('sha256').update(await readArtifact(projectRoot, runId, toEvidencePayloadFileName(evidenceRef)), 'utf8').digest('hex');
+        }
+    }
+    return createHash('sha256').update(await readArtifact(projectRoot, runId, toArtifactRootRelativePath(evidenceRef)), 'utf8').digest('hex');
+}
+function allocateRetryDelegation(state, delegation, replayReason) {
+    const attempt = nextDelegationAttempt(state, delegation.task, delegation.agent);
+    return {
+        ...delegation,
+        delegationId: `B-${delegation.task}-${delegation.agent}-${String(attempt).padStart(3, '0')}`,
+        status: 'RUNNING',
+        startedAt: new Date().toISOString(),
+        lastHeartbeatAt: null,
+        terminalEventAt: null,
+        attempt,
+        retryOf: delegation.delegationId,
+        replayReason
+    };
+}
+function nextDelegationAttempt(state, taskId, agent) {
+    const prefix = `B-${taskId}-${agent}-`;
+    const attempts = Object.keys(state.delegations)
+        .filter((delegationId) => delegationId.startsWith(prefix))
+        .map((delegationId) => Number.parseInt(delegationId.slice(prefix.length), 10))
+        .filter(Number.isFinite);
+    return Math.max(1, ...attempts) + 1;
+}
 function artifactIngestionKey(delegationId, artifactPath) {
     return `${delegationId}:${artifactPath}`;
 }
@@ -173,7 +228,7 @@ function artifactIngestionGaps(delegation, status) {
     if (status === 'PASS') {
         return [];
     }
-    return [taskGap(delegation.task, delegation.agent, `Artifact ingestion returned ${status} for ${delegation.delegationId}.`, 'Inspect the ingested artifact evidence before test or sync-back apply.')];
+    return [taskGap(delegation.task, delegation.agent, `Artifact ingestion returned ${status} for ${delegation.delegationId}.`, 'Inspect the ingested artifact evidence before continuing stage closure.')];
 }
 function contractIssue(field, message, recommendation) {
     return { field, message, recommendation };