sdd-agent-platform 0.3.0 → 0.4.0

package/{dist/packages/core/src → node_modules/@sdd-agent-platform/core/dist}/ai-tools.js

@@ -1,4 +1,4 @@
-import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { mkdir, readFile, readdir, unlink, writeFile } from 'node:fs/promises';
 import { createHash } from 'node:crypto';
 import path from 'node:path';
 export const SDD_VERSION = '0.3.0';
@@ -14,47 +14,45 @@ export const claudeCodeAdapter = {
                 kind: 'skill',
                 relativePath: '.claude/skills/sdd/SKILL.md',
                 title: 'SDD Platform',
-                body: `# SDD Platform\n\nUse the local or globally installed \`sdd\` CLI as the source of truth for this repository's SDD workflow.\n\nStart by running \`sdd status\`. Run \`sdd instructions overview --json\` only when the next action is unclear or you need the full dynamic command contract.\n\nUse \`sdd status\` for branch/source context and the recommended next command, but summarize only blockers, current task, and next action instead of replaying the full status output. For risky changes, run \`sdd lifecycle decide --from-text <text>\` before spec/plan work. Respect the returned boundaries. Do not treat this generated file as the workflow brain; refresh it with \`sdd update\` when drift is reported.\n`
-            },
-            {
-                id: 'sdd-root',
-                kind: 'command',
-                relativePath: '.claude/commands/sdd.md',
-                title: 'SDD',
-                body: `Use SDD as the natural-language intent router for this repository while keeping CLI/core output as the source of truth.
-
-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. Dynamic routing comes from CLI/core output, not this generated markdown; follow the recommended next command before choosing a dedicated \`/sdd:*\` entry.
-3. If the intent is still ambiguous after status, ask one clarifying question before spec/plan/do/verify/sync-back work.
-4. 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.
-5. If status reports workflow_status=not_started, use \`/sdd:spec\` to create the current Git branch partition; do not use \`sdd init\` as the workflow branch entry.
-6. If status points to gaps, drift, or doctor/update work, handle that maintenance action before do/verify.
-7. If status recommends a task, run \`sdd tasks inspect <task_id>\` and use the task Boundary and Acceptance before offering \`/sdd:do\`.
-8. If status recommends do, verify, or sync-back, follow the dedicated \`/sdd:do\`, \`/sdd:verify\`, or sync-back CLI path instead of inferring completion from chat.
-9. If status recommends sync-back, run \`sdd sync-back inspect --task <task_id>\` by default and follow apply_policy; pass an explicit run id only for replay/CI/old-run inspection. Direct-safe tasks may apply directly, confirm-required tasks need human confirmation and \`--approved\`.
+                body: `# SDD Platform
+
+Use the local or globally installed \`sdd\` CLI as the source of truth for this repository's SDD workflow. This skill is the manual \`/sdd\` root intent router; do not treat this generated file as the workflow brain.
+
+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 dedicated \`/sdd:*\` entry.
+4. If the intent is still ambiguous after status, ask one clarifying question before spec/plan/do/test/sync-back/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, use \`/sdd:spec\` to create the current 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 offering \`/sdd:do\`.
+9. If status recommends do, test, or sync-back, follow the dedicated \`/sdd:do\`, \`/sdd:test\`, or \`/sdd:sync-back\` entry instead of inferring completion from chat.
+10. If status recommends sync-back, use \`/sdd:sync-back\` to run \`sdd sync-back inspect --branch <branch> --task <task_id>\` first and follow apply_policy; pass an explicit run id only for replay/CI/old-run inspection. Direct-safe tasks may apply directly, confirm-required tasks need human confirmation and \`--approved\`.
+11. If the user asks to release or go online, use \`/sdd:ship\` / \`sdd ship --branch <branch> --dry-run\` 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 run archive <run_id> for failed exploratory runs.'),
-            commandEntry('sdd-update', '.claude/commands/sdd/update.md', 'update', 'Refresh managed generated AI entries 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-spec',
                 kind: 'command',
                 relativePath: '.claude/commands/sdd/spec.md',
                 title: 'SDD spec',
-                body: `Create or refine the SDD spec document as the workflow partition entry, not a technical design. Omit --branch to use the current Git branch partition; pass --branch <name> only when intentionally writing another partition. Agent visibility: scout may gather bounded context; spec-reviewer may review objective, scope, acceptance, and risk gates; evidence lands in spec review artifacts.
-
-Run:
-
-\`\`\`bash
-sdd status
-sdd instructions spec --json
-\`\`\`
-
-Then create or refine \`specs/<partition>/spec.md\` with objective/customer value, problem/intent, users/actors, user stories or scenarios, in-scope/out-of-scope boundaries, functional and non-functional requirements, acceptance criteria with stable IDs such as AC-1, assumptions/dependencies, risks/hard gates, open questions, and lifecycle decision reference.
-
-Repeated /sdd:spec calls represent requirement revisions. If plan/tasks/run evidence already exists, status must expose stale downstream hash state before plan/tasks/do continues.
-
-Do not design implementation in \`spec.md\`; stop before plan work when requirements, acceptance IDs, or risk gates are unclear.
+                body: `Create or refine the SDD spec document as the workflow partition entry, not a technical design. Omit --branch to use the current Git branch partition; pass --branch <name> only when intentionally writing another partition. Agent visibility: scout may gather bounded context; spec-reviewer may review objective, scope, acceptance, and risk gates; evidence lands in spec review artifacts.
+
+Run:
+
+\`\`\`bash
+sdd status
+sdd instructions spec --json
+\`\`\`
+
+Then create or refine \`specs/<partition>/spec.md\` with objective/customer value, problem/intent, users/actors, user stories or scenarios, in-scope/out-of-scope boundaries, functional and non-functional requirements, acceptance criteria with stable IDs such as AC-1, assumptions/dependencies, risks/hard gates, open questions, and lifecycle decision reference.
+
+Repeated /sdd:spec calls represent requirement revisions. If plan/tasks/run evidence already exists, status must expose stale downstream hash state before plan/tasks/do continues.
+
+Do not design implementation in \`spec.md\`; stop before plan work when requirements, acceptance IDs, or risk gates are unclear.
 `
             },
             {
@@ -62,19 +60,19 @@ 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 /sdd:spec revisions can mark this plan stale. Agent visibility: scout/planner/spec-reviewer may participate; evidence lands in plan or review artifacts.
-
-Run:
-
-\`\`\`bash
-sdd instructions plan --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.
-
-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.
-
-Stop before creating tasks when the technical solution is incomplete or has unresolved design gaps.
+                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 /sdd:spec revisions can mark this plan stale. Agent visibility: scout/planner/spec-reviewer may participate; evidence lands in plan or review artifacts.
+
+Run:
+
+\`\`\`bash
+sdd instructions plan --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.
+
+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.
+
+Stop before creating tasks when the technical solution is incomplete or has unresolved design gaps.
 `
             },
             {
@@ -82,18 +80,44 @@ Stop before creating tasks when the technical solution is incomplete or has unre
                 kind: 'command',
                 relativePath: '.claude/commands/sdd/tasks.md',
                 title: 'SDD tasks',
-                body: `Refine the existing SDD tasks document as an executable evidence contract, not a plain TODO list or project-management backlog. Include based_on_plan_hash from status so later plan/spec revisions can mark these tasks stale. Agent visibility: planner/reviewer may participate; execution evidence later lands in implement/review/validation artifacts.
-
-Run:
-
-\`\`\`bash
-sdd instructions tasks --json
-sdd tasks format
-\`\`\`
-
-Then write or refine \`specs/<branch>/tasks.md\` from the approved spec and plan. Include Delivery Map, Wave Plan, task blocks with acceptance_refs and plan_refs, affected_files, 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.
-
-Keep metadata inside the \`\`\`sdd-task fenced block and companion sections outside it. Stop before \`sdd do task\` when task boundary, acceptance refs, plan refs, or evidence requirements are unclear.
+                body: `Refine the existing SDD tasks document as an executable evidence contract, not a plain TODO list or project-management backlog. Include based_on_plan_hash from status so later plan/spec revisions can mark these tasks stale. Agent visibility: planner/reviewer may participate; execution evidence later lands in implement/review/validation artifacts.
+
+Run:
+
+\`\`\`bash
+sdd instructions tasks --json
+sdd tasks format
+\`\`\`
+
+Then write or refine \`specs/<branch>/tasks.md\` from the approved spec and plan. Include Delivery Map, Wave Plan, task blocks with acceptance_refs and plan_refs, affected_files, 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.
+
+Keep metadata inside the \`\`\`sdd-task fenced block and companion sections outside it. Stop before \`sdd do task\` when task boundary, acceptance refs, plan refs, or evidence requirements are unclear.
+`
+            },
+            {
+                id: 'sdd-test',
+                kind: 'command',
+                relativePath: '.claude/commands/sdd/test.md',
+                title: 'SDD test',
+                body: `Execute task validation commands, capture command output, evaluate acceptance evidence coverage, and return one unified test judgment for the task.
+
+Run:
+
+\`\`\`bash
+sdd status
+sdd instructions test --json
+sdd verifies inspect --branch <branch>
+sdd test task <task_id> --branch <branch>
+\`\`\`
+
+Workflow:
+
+1. Confirm \`verify.md\` exists and is current for the selected branch.
+2. Run \`sdd test task <task_id> --branch <branch>\` to execute task validation commands and evaluate mapped acceptance coverage; use \`--command\` only for a deliberate narrowed override.
+3. Treat generated command logs, test index, validator artifact, and unified evidence projection as runtime evidence references, not as workflow documents.
+4. If \`/sdd:test\` returns PASS, proceed to \`/sdd:sync-back\` / \`sdd sync-back inspect\`; if it returns FAIL or BLOCKED, fix the reported command or evidence gaps and rerun \`/sdd:test\`.
+
+Do not auto-fix failures, create sync-back proposals, commit, publish, or treat command success alone as semantic PASS.
 `
             },
             {
@@ -101,45 +125,84 @@ Keep metadata inside the \`\`\`sdd-task fenced block and companion sections outs
                 kind: 'command',
                 relativePath: '.claude/commands/sdd/do.md',
                 title: 'SDD do',
-                body: `Execute one approved SDD task boundary through the ingestion-aware task workflow.
-
-Run:
-
-\`\`\`bash
-sdd status
-sdd instructions do --json
-sdd tasks inspect <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 \`.sdd/runs/<run_id>/artifacts/\`. 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.
-3. Work only inside the selected task boundary; do not expand scope without a checkpoint.
-4. Before creating explicit result artifacts, use templates such as \`sdd artifact template artifacts/implement-<task_id>.md --task <task_id> --agent implementer\`, \`sdd artifact template artifacts/review-<task_id>.md --task <task_id> --agent reviewer\`, and \`sdd artifact template artifacts/validation-<task_id>.md --task <task_id> --agent validator\`; save the physical file under \`.sdd/runs/<run_id>/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, recommend \`sdd verify task <task_id> --branch <branch>\`; pass \`--run <run_id>\` only for explicit replay/CI/old-run inspection.
-
-Do not create worktrees, auto commit, or mark missing evidence as PASS.
+                body: `Execute one approved SDD task boundary through the ingestion-aware task workflow.
+
+Run:
+
+\`\`\`bash
+sdd status
+sdd instructions do --json
+sdd tasks inspect <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.
+
+
+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.
+3. Work only inside the selected task boundary; do not expand scope without a checkpoint.
+4. Before creating explicit result artifacts, use templates such as \`sdd artifact template artifacts/implement-<task_id>.md --task <task_id> --agent implementer\`, \`sdd artifact template artifacts/review-<task_id>.md --task <task_id> --agent reviewer\`, and \`sdd artifact template artifacts/validation-<task_id>.md --task <task_id> --agent validator\`; save the physical file under branch evidence \`.sdd/runs/<branchSlug>/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, recommend \`/sdd:test\` / \`sdd test task <task_id> --branch <branch>\` so command execution and acceptance coverage are judged together.
+
+Do not create worktrees, auto commit, or mark missing evidence as PASS.
 `
             },
             {
-                id: 'sdd-verify',
+                id: 'sdd-sync-back',
                 kind: 'command',
-                relativePath: '.claude/commands/sdd/verify.md',
-                title: 'SDD verify',
-                body: `Verify task acceptance coverage from review and validation evidence. By default, verify resolves the latest eligible run from the current/requested partition plus task id; pass \`--run <run_id>\` only for replay, CI, or old-run inspection.\n\nRun:\n\n\`\`\`bash\nsdd status\nsdd instructions verify --json\n\`\`\`\n\nWorkflow:\n\n1. Resolve exactly one task id and workflow partition from \`sdd status\`, the recommended command, or the user request. Stop and ask if either is ambiguous.\n2. Omit \`--run\` by default so CLI/core resolves the latest eligible partition/task run; inspect an explicit run only when the user or CI names one.\n3. Ensure the validator artifact includes exact task Acceptance text, preferably generated with \`sdd artifact template artifacts/validation-<task_id>.md --task <task_id> --agent validator\`; pass the run-relative artifact path while storing the physical file under \`.sdd/runs/<run_id>/artifacts/\`.\n4. Run \`sdd artifact validate <run_id> <artifact> --task <task_id> --agent validator\` before goal-level verify.\n5. Run \`sdd verify task <task_id> --branch <branch>\` for goal-level acceptance coverage, adding \`--run <run_id>\` only for explicit old-run replay.\n6. If verify PASS, run \`sdd sync-back inspect --branch <branch> --task <task_id>\` and follow apply_policy.\n7. Direct-safe tasks may run \`sdd sync-back apply --branch <branch> --task <task_id>\` directly; confirm-required tasks require human confirmation and \`--approved\` before writing \`tasks.md\`.\n\nDo not auto-fix failures, force push, or mark completed when blocking gaps remain.\n`
+                relativePath: '.claude/commands/sdd/sync-back.md',
+                title: 'SDD sync-back',
+                body: `Inspect and optionally apply the verified task completion proposal back into tasks.md. Sync-back is a document write-back gate, not another implementation step.
+
+Run:
+
+\`\`\`bash
+sdd status
+sdd instructions sync-back --json
+sdd sync-back inspect --branch <branch> --task <task_id>
+\`\`\`
+
+Workflow:
+
+1. Resolve exactly one task id and workflow partition from \`sdd status\`, the recommended command, or the user request. 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>\`.
+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 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.
+
+Do not apply without inspect, do not use \`--approved\` without human confirmation, and do not change source files during sync-back.
+`
             },
             {
-                id: 'sdd-instructions',
+                id: 'sdd-ship',
                 kind: 'command',
-                relativePath: '.claude/commands/sdd/instructions.md',
-                title: 'SDD instructions',
-                body: `Fetch dynamic SDD instructions and follow the status-first decision tree to the next actionable step.\n\nRun:\n\n\`\`\`bash\nsdd status\nsdd instructions overview --json\n\`\`\`\n\nThen apply this decision tree:\n\n- **If status reports gaps or drift**: run the recommended command. For generated entry drift, run \`sdd update\`, then \`sdd doctor\` again.\n- **If status recommends a task**: run \`sdd tasks inspect <task_id>\`, then offer \`/sdd:do\` inside the approved task boundary.\n- **If status recommends verify or sync-back**: use the task id and partition from status/recommended command; omit \`--run\` unless an explicit run is named for replay, CI, or old-run inspection.\n- **If the next change has state-machine, concurrency, database, SQL, security, API/schema, CI/build, or external unknown risk**: run \`sdd lifecycle decide --from-text <text>\` and respect hard gates before spec/plan work.\n- **After a task completes**: run \`sdd verify task <task_id> --branch <branch>\` for acceptance coverage; CLI/core resolves the latest eligible run.\n- **After verify PASS**: run \`sdd sync-back inspect --branch <branch> --task <task_id>\` and follow apply_policy: direct-safe tasks may apply directly, confirm-required tasks need human confirmation and \`--approved\`.\n\nReport only the selected next action, blockers, and commands you will run; do not paste full JSON/status output unless the user asks. Do not loop in maintenance checks when status already gives a next workflow action.\n`
+                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.
+
+Run:
+
+\`\`\`bash
+sdd ship --branch <branch> --dry-run
+sdd instructions ship --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.
+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.
+`
             }
         ];
     }
@@ -160,10 +223,13 @@ export async function applyAiToolEntries(projectRoot, options = {}) {
     const results = [];
     for (const adapter of getAiToolAdapters(options.tool)) {
         const entries = [];
-        for (const template of adapter.entries()) {
-            const projected = renderProjectedEntry(adapter, template);
-            entries.push(await applyEntry(projectRoot, projected, options.check === true));
+        const templates = adapter.entries();
+        const projectedEntries = templates.map((template) => renderProjectedEntry(adapter, template));
+        const expectedPaths = new Set(projectedEntries.map((projected) => normalizeRelativePath(projected.relativePath)));
+        for (const projected of projectedEntries) {
+            entries.push(await applyEntry(projectRoot, projected, options.check === true, options.force === true));
         }
+        entries.push(...await inspectObsoleteManagedEntries(projectRoot, adapter, templates, expectedPaths, options.check === true, options.force === true));
         results.push({ tool: adapter.id, entries });
     }
     return results;
@@ -173,7 +239,7 @@ export async function checkAiToolEntryDrift(projectRoot, options = {}) {
 }
 export function summarizeAiProjectionStatus(results) {
     const statuses = results.flatMap((result) => result.entries.map((entry) => entry.status));
-    if (statuses.some((status) => status === 'foreign' || status === 'conflict' || status === 'drifted' || status === 'user-modified' || status === 'missing')) {
+    if (statuses.some((status) => status === 'foreign' || status === 'conflict' || status === 'drifted' || status === 'user-modified' || status === 'missing' || status === 'obsolete')) {
         return 'FAIL';
     }
     if (statuses.some((status) => status === 'skipped')) {
@@ -225,7 +291,7 @@ function renderProjectedEntry(adapter, entry) {
         sourceContract: AI_ENTRY_CONTRACT
     };
 }
-async function applyEntry(projectRoot, projected, checkOnly) {
+async function applyEntry(projectRoot, projected, checkOnly, force) {
     const absolutePath = path.join(projectRoot, projected.relativePath);
     const existing = await readFile(absolutePath, 'utf8').catch((error) => {
         if (isNodeError(error) && error.code === 'ENOENT') {
@@ -251,7 +317,7 @@ async function applyEntry(projectRoot, projected, checkOnly) {
     if (current.version === SDD_VERSION && current.hash === projected.hash && current.bodyHash === projected.hash) {
         return statusReport(projected, 'unchanged', 'Managed AI entry is current.');
     }
-    if (current.bodyHash !== current.hash) {
+    if (current.bodyHash !== current.hash && (checkOnly || !force)) {
         return statusReport(projected, 'user-modified', 'Managed AI entry has user modifications outside the recorded hash.', 'Review manually; sdd update will not overwrite user-modified entries by default.');
     }
     if (!checkOnly) {
@@ -260,6 +326,83 @@ async function applyEntry(projectRoot, projected, checkOnly) {
     }
     return statusReport(projected, 'drifted', 'Managed AI entry template drifted from the platform projection.', 'Run sdd update.');
 }
+async function inspectObsoleteManagedEntries(projectRoot, adapter, templates, expectedPaths, checkOnly, force) {
+    const reports = [];
+    for (const absolutePath of await listManagedEntryCandidatePaths(projectRoot, templates)) {
+        const relativePath = normalizeRelativePath(path.relative(projectRoot, absolutePath));
+        if (expectedPaths.has(relativePath)) {
+            continue;
+        }
+        const existing = await readFile(absolutePath, 'utf8');
+        const current = inspectManagedEntry(existing);
+        if (!current.managed || current.contract !== AI_ENTRY_CONTRACT || current.tool !== adapter.id) {
+            continue;
+        }
+        const obsolete = obsoleteProjectedEntry(adapter, relativePath, current);
+        if (current.bodyHash !== current.hash && !force) {
+            reports.push(statusReport(obsolete, 'user-modified', 'Obsolete managed AI entry has user modifications.', 'Review manually; sdd update will not remove user-modified obsolete entries by default.'));
+            continue;
+        }
+        if (checkOnly) {
+            reports.push(statusReport(obsolete, 'obsolete', 'Managed AI entry is no longer projected.', 'Run sdd update to remove the obsolete entry.'));
+            continue;
+        }
+        await unlink(absolutePath);
+        reports.push(statusReport(obsolete, 'removed', 'Obsolete managed AI entry removed.'));
+    }
+    return reports;
+}
+async function listManagedEntryCandidatePaths(projectRoot, templates) {
+    const directories = new Set();
+    for (const template of templates) {
+        const directory = normalizeRelativePath(path.dirname(template.relativePath));
+        directories.add(directory);
+        if (directory.startsWith('.claude/commands/')) {
+            directories.add('.claude/commands');
+        }
+        if (directory.startsWith('.claude/skills/')) {
+            directories.add('.claude/skills');
+        }
+    }
+    const files = new Set();
+    for (const directory of directories) {
+        await collectFiles(path.join(projectRoot, directory), files);
+    }
+    return [...files];
+}
+async function collectFiles(directory, files) {
+    const entries = await readdir(directory, { withFileTypes: true }).catch((error) => {
+        if (isNodeError(error) && error.code === 'ENOENT') {
+            return [];
+        }
+        throw error;
+    });
+    for (const entry of entries) {
+        const absolutePath = path.join(directory, entry.name);
+        if (entry.isDirectory()) {
+            await collectFiles(absolutePath, files);
+        }
+        else if (entry.isFile()) {
+            files.add(absolutePath);
+        }
+    }
+}
+function obsoleteProjectedEntry(adapter, relativePath, current) {
+    return {
+        tool: adapter.id,
+        id: current.artifactId ?? path.basename(relativePath, path.extname(relativePath)),
+        kind: current.kind === 'skill' ? 'skill' : 'command',
+        relativePath,
+        content: '',
+        hash: current.hash ?? current.bodyHash,
+        version: SDD_VERSION,
+        ownership: 'sdd-managed',
+        sourceContract: AI_ENTRY_CONTRACT
+    };
+}
+function normalizeRelativePath(relativePath) {
+    return relativePath.replace(/\\/g, '/');
+}
 function inspectManagedEntry(content) {
     const body = content.replace(/^---\n[\s\S]*?\n---\n\n?/, '');
     return {
@@ -267,7 +410,10 @@ function inspectManagedEntry(content) {
         contract: readFrontmatterScalar(content, 'sdd_contract'),
         version: readFrontmatterScalar(content, 'sdd_version')?.replace(/^"|"$/g, '') ?? null,
         hash: readFrontmatterScalar(content, 'sdd_hash')?.replace(/^sha256:/, '') ?? null,
-        bodyHash: hashManagedBody(body)
+        bodyHash: hashManagedBody(body),
+        tool: readFrontmatterScalar(content, 'sdd_tool'),
+        kind: readFrontmatterScalar(content, 'sdd_artifact_kind'),
+        artifactId: readFrontmatterScalar(content, 'sdd_artifact_id')
     };
 }
 function readFrontmatterScalar(content, key) {
@@ -304,7 +450,7 @@ function manifestEntry(projected, status) {
     };
 }
 function driftStatusFor(status) {
-    if (status === 'unchanged' || status === 'created' || status === 'updated') {
+    if (status === 'unchanged' || status === 'created' || status === 'updated' || status === 'removed') {
         return 'current';
     }
     return status;

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

@@ -0,0 +1 @@
+{"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.d.ts

@@ -0,0 +1,24 @@
+import { ARTIFACT_RESULT_INGESTION_CONTRACT_VERSION } from '../contracts.js';
+import type { RunStateArtifactIngestionRecord, RunStateContractValidationIssue, RunStateDelegationRecord } from '../run-state/model.js';
+export type ArtifactResultIngestionStatus = 'accepted' | 'rejected';
+export interface ArtifactResultIngestionRecord extends RunStateArtifactIngestionRecord {
+    status: ArtifactResultIngestionStatus;
+}
+export interface ArtifactResultIngestionResult {
+    valid: boolean;
+    duplicate: boolean;
+    record: ArtifactResultIngestionRecord;
+    delegation: RunStateDelegationRecord | null;
+}
+export interface ArtifactResultIngestionInspection {
+    runId: string;
+    contract: typeof ARTIFACT_RESULT_INGESTION_CONTRACT_VERSION;
+    records: ArtifactResultIngestionRecord[];
+    valid: boolean;
+    issues: RunStateContractValidationIssue[];
+}
+export declare function ingestArtifactResult(projectRoot: string, runId: string, input: {
+    delegationId: string;
+    artifactPath: string;
+}): Promise<ArtifactResultIngestionResult>;
+export declare function inspectArtifactResultIngestions(projectRoot: string, runId: string): Promise<ArtifactResultIngestionInspection>;