sdd-agent-platform 0.4.2 → 0.5.1

package/node_modules/@sdd-agent-platform/core/src/worktree/worktree.test.ts

@@ -1,150 +1,150 @@
-import test from 'node:test';
-import assert from 'node:assert/strict';
-import { execFile } from 'node:child_process';
-import { mkdtemp, rm, writeFile } from 'node:fs/promises';
-import { tmpdir } from 'node:os';
-import path from 'node:path';
-import { promisify } from 'node:util';
-
-import { initProject } from '../config/init-project.js';
-import { doctor } from '../doctor/doctor.js';
-import { readRunEvents } from '../run-state/events.js';
-import { createRun, readRunState } from '../run-state/run-state.js';
-import { taskMarkdownWithFiles, writeBranchDocs } from '../test-support/fixtures.js';
-import { inspectWorktreeIsolation } from './isolation.js';
-import { createWorktreeLifecycle, inspectWorktreeLifecycle, keepWorktreeLifecycle, removeWorktreeLifecycle } from './lifecycle.js';
-
-const execFileAsync = promisify(execFile);
-
-test('worktree isolation blocks writable overlapping tasks and allows read-only', async () => {
-  const root = await mkdtemp(path.join(tmpdir(), 'sdd-isolation-overlap-'));
-  try {
-    await initProject(root);
-    await writeBranchDocs(root, 'master', `# Tasks\n\n${taskMarkdownWithFiles('T1', ['packages/core/src/index.ts'], [])}\n${taskMarkdownWithFiles('T2', ['./packages/core/src/index.ts'], [])}`);
-
-    const blocked = await inspectWorktreeIsolation(root, {
-      taskId: 'T1',
-      capabilityId: 'native-file-edit',
-      peerTaskIds: ['T2']
-    });
-    const readOnly = await inspectWorktreeIsolation(root, {
-      taskId: 'T1',
-      capabilityId: 'git-local',
-      peerTaskIds: ['T2']
-    });
-
-    assert.equal(blocked.mode, 'blocked');
-    assert.equal(blocked.safeConcurrency, false);
-    assert.deepEqual(blocked.overlaps, [{ peerTaskId: 'T2', files: ['packages/core/src/index.ts'] }]);
-    assert.equal(blocked.gates.find((gate) => gate.name === 'unsafe_concurrency')?.passed, false);
-    assert.equal(readOnly.mode, 'none');
-    assert.equal(readOnly.safeConcurrency, true);
-    assert.equal(readOnly.capabilitySideEffect, 'read_only');
-  } finally {
-    await rm(root, { recursive: true, force: true });
-  }
-});
-
-test('worktree isolation marks high-risk writable task as manual or required', async () => {
-  const root = await mkdtemp(path.join(tmpdir(), 'sdd-isolation-risk-'));
-  try {
-    await initProject(root);
-    await writeBranchDocs(root, 'master', `# Tasks\n\n${taskMarkdownWithFiles('T1', ['db/schema.sql'], ['database'])}\n${taskMarkdownWithFiles('T2', ['packages/core/src/index.ts'], ['state-machine'])}`);
-
-    const manual = await inspectWorktreeIsolation(root, { taskId: 'T1', capabilityId: 'native-file-edit' });
-    const required = await inspectWorktreeIsolation(root, { taskId: 'T2', capabilityId: 'native-file-edit' });
-
-    assert.equal(manual.mode, 'manual');
-    assert.equal(manual.reasons.some((reason) => reason.includes('manual isolation gate')), true);
-    assert.equal(required.mode, 'required');
-    assert.equal(required.reasons.some((reason) => reason.includes('High-risk writable task')), true);
-  } finally {
-    await rm(root, { recursive: true, force: true });
-  }
-});
-
-test('doctor reports worktree isolation contract visibility', async () => {
-  const root = await mkdtemp(path.join(tmpdir(), 'sdd-isolation-doctor-'));
-  try {
-    await initProject(root);
-
-    const report = await doctor(root, { latestOnly: true });
-    const check = report.checks.find((item) => item.check === 'worktree_isolation_contract');
-
-    assert.equal(check?.level, 'PASS');
-    assert.match(check?.message ?? '', /phase-3\.7-worktree-isolation-contract-v1/);
-  } finally {
-    await rm(root, { recursive: true, force: true });
-  }
-});
-
-test('worktree lifecycle creates and removes clean tracked worktree', async () => {
-  const root = await mkdtemp(path.join(tmpdir(), 'sdd-worktree-clean-'));
-  try {
-    await initProject(root);
-    await writeBranchDocs(root, 'master', `# Tasks\n\n${taskMarkdownWithFiles('T1', ['packages/core/src/index.ts'], [])}`);
-    await initializeGitRepository(root);
-    await createRun(root, { runId: 'run-1' });
-
-    const created = await createWorktreeLifecycle(root, 'run-1', { taskId: 'T1', worktreeId: 'wt-run-1-T1' });
-    const createdState = await readRunState(root, 'run-1');
-    const createdEvents = await readRunEvents(root, 'run-1');
-    const removed = await removeWorktreeLifecycle(root, 'run-1', 'wt-run-1-T1');
-    const inspection = await inspectWorktreeLifecycle(root, 'run-1');
-    const removedEvents = await readRunEvents(root, 'run-1');
-
-    assert.equal(created.status, 'created');
-    assert.equal(created.contract, 'phase-3.8-worktree-lifecycle-v1');
-    assert.equal(createdState.worktrees['wt-run-1-T1'].worktreePath, created.worktreePath);
-    assert.equal(createdEvents.some((event) => event.event === 'worktree_created'), true);
-    assert.equal(removed.status, 'removed');
-    assert.equal(inspection.valid, true);
-    assert.equal(removedEvents.some((event) => event.event === 'worktree_removed'), true);
-  } finally {
-    await rm(root, { recursive: true, force: true });
-  }
-});
-
-test('worktree lifecycle refuses dirty remove and can keep for inspection', async () => {
-  const root = await mkdtemp(path.join(tmpdir(), 'sdd-worktree-dirty-'));
-  try {
-    await initProject(root);
-    await writeBranchDocs(root, 'master', `# Tasks\n\n${taskMarkdownWithFiles('T1', ['packages/core/src/index.ts'], [])}`);
-    await initializeGitRepository(root);
-    await createRun(root, { runId: 'run-1' });
-
-    const created = await createWorktreeLifecycle(root, 'run-1', { taskId: 'T1', worktreeId: 'wt-run-1-T1' });
-    await writeFile(path.join(root, created.worktreePath, 'dirty.txt'), 'dirty', 'utf8');
-    await assert.rejects(removeWorktreeLifecycle(root, 'run-1', 'wt-run-1-T1'), /Refusing to remove dirty worktree/);
-    const kept = await keepWorktreeLifecycle(root, 'run-1', 'wt-run-1-T1', { reason: 'manual inspection' });
-    const inspection = await inspectWorktreeLifecycle(root, 'run-1');
-
-    assert.equal(kept.status, 'kept');
-    assert.equal(kept.dirty, true);
-    assert.equal(inspection.valid, false);
-    assert.equal(inspection.issues.some((issue) => issue.field === 'dirty'), true);
-  } finally {
-    await rm(root, { recursive: true, force: true });
-  }
-});
-
-test('doctor reports worktree lifecycle contract visibility', async () => {
-  const root = await mkdtemp(path.join(tmpdir(), 'sdd-worktree-doctor-'));
-  try {
-    await initProject(root);
-
-    const report = await doctor(root, { latestOnly: true });
-    const check = report.checks.find((item) => item.check === 'worktree_lifecycle_contract');
-
-    assert.equal(check?.level, 'PASS');
-    assert.match(check?.message ?? '', /phase-3\.8-worktree-lifecycle-v1/);
-  } finally {
-    await rm(root, { recursive: true, force: true });
-  }
-});
-
-async function initializeGitRepository(root: string): Promise<void> {
-  await execFileAsync('git', ['-C', root, 'init']);
-  await execFileAsync('git', ['-C', root, 'add', '.']);
-  await execFileAsync('git', ['-C', root, '-c', 'user.name=sdd-test', '-c', 'user.email=sdd-test@example.com', 'commit', '--allow-empty', '-m', 'init']);
-}
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { execFile } from 'node:child_process';
+import { mkdtemp, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { promisify } from 'node:util';
+
+import { initProject } from '../config/init-project.js';
+import { doctor } from '../doctor/doctor.js';
+import { readRunEvents } from '../run-state/events.js';
+import { createRun, readRunState } from '../run-state/run-state.js';
+import { taskMarkdownWithFiles, writeBranchDocs } from '../test-support/fixtures.js';
+import { inspectWorktreeIsolation } from './isolation.js';
+import { createWorktreeLifecycle, inspectWorktreeLifecycle, keepWorktreeLifecycle, removeWorktreeLifecycle } from './lifecycle.js';
+
+const execFileAsync = promisify(execFile);
+
+test('worktree isolation blocks writable overlapping tasks and allows read-only', async () => {
+  const root = await mkdtemp(path.join(tmpdir(), 'sdd-isolation-overlap-'));
+  try {
+    await initProject(root);
+    await writeBranchDocs(root, 'master', `# Tasks\n\n${taskMarkdownWithFiles('T1', ['packages/core/src/index.ts'], [])}\n${taskMarkdownWithFiles('T2', ['./packages/core/src/index.ts'], [])}`);
+
+    const blocked = await inspectWorktreeIsolation(root, {
+      taskId: 'T1',
+      capabilityId: 'native-file-edit',
+      peerTaskIds: ['T2']
+    });
+    const readOnly = await inspectWorktreeIsolation(root, {
+      taskId: 'T1',
+      capabilityId: 'git-local',
+      peerTaskIds: ['T2']
+    });
+
+    assert.equal(blocked.mode, 'blocked');
+    assert.equal(blocked.safeConcurrency, false);
+    assert.deepEqual(blocked.overlaps, [{ peerTaskId: 'T2', files: ['packages/core/src/index.ts'] }]);
+    assert.equal(blocked.gates.find((gate) => gate.name === 'unsafe_concurrency')?.passed, false);
+    assert.equal(readOnly.mode, 'none');
+    assert.equal(readOnly.safeConcurrency, true);
+    assert.equal(readOnly.capabilitySideEffect, 'read_only');
+  } finally {
+    await rm(root, { recursive: true, force: true });
+  }
+});
+
+test('worktree isolation marks high-risk writable task as manual or required', async () => {
+  const root = await mkdtemp(path.join(tmpdir(), 'sdd-isolation-risk-'));
+  try {
+    await initProject(root);
+    await writeBranchDocs(root, 'master', `# Tasks\n\n${taskMarkdownWithFiles('T1', ['db/schema.sql'], ['database'])}\n${taskMarkdownWithFiles('T2', ['packages/core/src/index.ts'], ['state-machine'])}`);
+
+    const manual = await inspectWorktreeIsolation(root, { taskId: 'T1', capabilityId: 'native-file-edit' });
+    const required = await inspectWorktreeIsolation(root, { taskId: 'T2', capabilityId: 'native-file-edit' });
+
+    assert.equal(manual.mode, 'manual');
+    assert.equal(manual.reasons.some((reason) => reason.includes('manual isolation gate')), true);
+    assert.equal(required.mode, 'required');
+    assert.equal(required.reasons.some((reason) => reason.includes('High-risk writable task')), true);
+  } finally {
+    await rm(root, { recursive: true, force: true });
+  }
+});
+
+test('doctor reports worktree isolation contract visibility', async () => {
+  const root = await mkdtemp(path.join(tmpdir(), 'sdd-isolation-doctor-'));
+  try {
+    await initProject(root);
+
+    const report = await doctor(root, { latestOnly: true });
+    const check = report.checks.find((item) => item.check === 'worktree_isolation_contract');
+
+    assert.equal(check?.level, 'PASS');
+    assert.match(check?.message ?? '', /phase-3\.7-worktree-isolation-contract-v1/);
+  } finally {
+    await rm(root, { recursive: true, force: true });
+  }
+});
+
+test('worktree lifecycle creates and removes clean tracked worktree', async () => {
+  const root = await mkdtemp(path.join(tmpdir(), 'sdd-worktree-clean-'));
+  try {
+    await initProject(root);
+    await writeBranchDocs(root, 'master', `# Tasks\n\n${taskMarkdownWithFiles('T1', ['packages/core/src/index.ts'], [])}`);
+    await initializeGitRepository(root);
+    await createRun(root, { runId: 'run-1' });
+
+    const created = await createWorktreeLifecycle(root, 'run-1', { taskId: 'T1', worktreeId: 'wt-run-1-T1' });
+    const createdState = await readRunState(root, 'run-1');
+    const createdEvents = await readRunEvents(root, 'run-1');
+    const removed = await removeWorktreeLifecycle(root, 'run-1', 'wt-run-1-T1');
+    const inspection = await inspectWorktreeLifecycle(root, 'run-1');
+    const removedEvents = await readRunEvents(root, 'run-1');
+
+    assert.equal(created.status, 'created');
+    assert.equal(created.contract, 'phase-3.8-worktree-lifecycle-v1');
+    assert.equal(createdState.worktrees['wt-run-1-T1'].worktreePath, created.worktreePath);
+    assert.equal(createdEvents.some((event) => event.event === 'worktree_created'), true);
+    assert.equal(removed.status, 'removed');
+    assert.equal(inspection.valid, true);
+    assert.equal(removedEvents.some((event) => event.event === 'worktree_removed'), true);
+  } finally {
+    await rm(root, { recursive: true, force: true });
+  }
+});
+
+test('worktree lifecycle refuses dirty remove and can keep for inspection', async () => {
+  const root = await mkdtemp(path.join(tmpdir(), 'sdd-worktree-dirty-'));
+  try {
+    await initProject(root);
+    await writeBranchDocs(root, 'master', `# Tasks\n\n${taskMarkdownWithFiles('T1', ['packages/core/src/index.ts'], [])}`);
+    await initializeGitRepository(root);
+    await createRun(root, { runId: 'run-1' });
+
+    const created = await createWorktreeLifecycle(root, 'run-1', { taskId: 'T1', worktreeId: 'wt-run-1-T1' });
+    await writeFile(path.join(root, created.worktreePath, 'dirty.txt'), 'dirty', 'utf8');
+    await assert.rejects(removeWorktreeLifecycle(root, 'run-1', 'wt-run-1-T1'), /Refusing to remove dirty worktree/);
+    const kept = await keepWorktreeLifecycle(root, 'run-1', 'wt-run-1-T1', { reason: 'manual inspection' });
+    const inspection = await inspectWorktreeLifecycle(root, 'run-1');
+
+    assert.equal(kept.status, 'kept');
+    assert.equal(kept.dirty, true);
+    assert.equal(inspection.valid, false);
+    assert.equal(inspection.issues.some((issue) => issue.field === 'dirty'), true);
+  } finally {
+    await rm(root, { recursive: true, force: true });
+  }
+});
+
+test('doctor reports worktree lifecycle contract visibility', async () => {
+  const root = await mkdtemp(path.join(tmpdir(), 'sdd-worktree-doctor-'));
+  try {
+    await initProject(root);
+
+    const report = await doctor(root, { latestOnly: true });
+    const check = report.checks.find((item) => item.check === 'worktree_lifecycle_contract');
+
+    assert.equal(check?.level, 'PASS');
+    assert.match(check?.message ?? '', /phase-3\.8-worktree-lifecycle-v1/);
+  } finally {
+    await rm(root, { recursive: true, force: true });
+  }
+});
+
+async function initializeGitRepository(root: string): Promise<void> {
+  await execFileAsync('git', ['-C', root, 'init']);
+  await execFileAsync('git', ['-C', root, 'add', '.']);
+  await execFileAsync('git', ['-C', root, '-c', 'user.name=sdd-test', '-c', 'user.email=sdd-test@example.com', 'commit', '--allow-empty', '-m', 'init']);
+}

package/node_modules/@sdd-agent-platform/core/src/worktree.ts

@@ -1,2 +1,2 @@
-export * from './worktree/isolation.js';
-export * from './worktree/lifecycle.js';
+export * from './worktree/isolation.js';
+export * from './worktree/lifecycle.js';

package/node_modules/@sdd-agent-platform/core/tsconfig.json

@@ -1,15 +1,15 @@
-{
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "composite": true,
-    "rootDir": "src",
-    "outDir": "dist",
-    "tsBuildInfoFile": "dist/tsconfig.tsbuildinfo"
-  },
-  "include": [
-    "src/**/*.ts"
-  ],
-  "exclude": [
-    "src/**/*.test.ts"
-  ]
-}
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "composite": true,
+    "rootDir": "src",
+    "outDir": "dist",
+    "tsBuildInfoFile": "dist/tsconfig.tsbuildinfo"
+  },
+  "include": [
+    "src/**/*.ts"
+  ],
+  "exclude": [
+    "src/**/*.test.ts"
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sdd-agent-platform",
-  "version": "0.4.2",
+  "version": "0.5.1",
   "type": "module",
   "description": "Local SDD + subagent workflow platform for Claude Code.",
   "license": "MIT",
@@ -53,7 +53,7 @@
   "devDependencies": {
     "@types/node": "^24.10.0",
     "tsx": "^4.20.6",
-    "typescript": "^5.9.0"
+    "typescript": "^5.9.3"
   },
   "bundleDependencies": [
     "@sdd-agent-platform/core"

package/packages/cli/dist/args.js

@@ -2,7 +2,7 @@ import { resolveSddContext } from '@sdd-agent-platform/core/sdd-docs';
 import { readOption } from './options.js';
 export function readContextBuildMode(args, name) {
     const value = readOption(args, name);
-    return value === 'do' || value === 'verify' || value === 'doctor' ? value : null;
+    return value === 'execute' || value === 'doctor' ? value : null;
 }
 export function readTeamModeActivation(args, fallback) {
     if (args.includes('--no-team-mode')) {
@@ -58,7 +58,7 @@ export function readRunStatus(args, name) {
     return value === 'created' || value === 'running' || value === 'completed' || value === 'blocked' || value === 'failed' || value === 'archived' ? value : null;
 }
 export function readGovernancePolicyOperation(value) {
-    return value === 'background_executor' || value === 'wave_executor' || value === 'destructive_git' || value === 'external_interaction' || value === 'cleanup' ? value : null;
+    return value === 'background_executor' || value === 'wave_executor' || value === 'sync_back_apply' || value === 'destructive_git' || value === 'external_interaction' || value === 'cleanup' ? value : null;
 }
 export function readTaskArtifactOptions(args) {
     const artifacts = {};

package/packages/cli/dist/args.js.map

@@ -1 +1 @@
-{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAA4B,MAAM,mCAAmC,CAAC;AAMhG,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,UAAU,oBAAoB,CAAC,IAAc,EAAE,IAAY;IAC/D,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACrC,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAc,EAAE,QAA6B;IAClF,IAAI,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACpC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC;IACpE,MAAM,WAAW,GAAG,MAAM,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,IAAI,WAAW,KAAK,MAAM,IAAI,WAAW,KAAK,OAAO,IAAI,WAAW,KAAK,KAAK,EAAE,CAAC;QAC/E,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1C,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACf,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC9B,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;YAC7D,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAc;IAC9C,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACtC,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAc;IAC7C,OAAO,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,SAAS,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,IAAc;IAC3D,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,eAAe,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,cAAc,CAAC,CAAC,CAAC;IAClP,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,SAAS;QACX,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACtF,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,WAAmB,EAAE,IAAc;IAC1E,OAAO,CAAC,MAAM,iBAAiB,CAAC,WAAW,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAAc,EAAE,IAAY;IACnE,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,WAAW,CAAC;IACpD,OAAO,KAAK,KAAK,WAAW,IAAI,KAAK,KAAK,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAc,EAAE,IAAY;IACxD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACrC,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,WAAW,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AACjK,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,KAAyB;IACrE,OAAO,KAAK,KAAK,qBAAqB,IAAI,KAAK,KAAK,eAAe,IAAI,KAAK,KAAK,iBAAiB,IAAI,KAAK,KAAK,sBAAsB,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/K,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAc;IACpD,MAAM,SAAS,GAA2B,EAAE,CAAC;IAC7C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,YAAY,EAAE,CAAC;YACjC,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC9B,MAAM,SAAS,GAAG,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;YAC7B,SAAS;QACX,CAAC;QACD,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAc,EAAE,IAAY;IAC9D,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACrC,OAAO,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,gBAAgB,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,WAAW,IAAI,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AACpK,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAc,EAAE,SAAkB;IACpE,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC;IACjD,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,aAAa,IAAI,CAAC,SAAS,IAAI,KAAK,KAAK,MAAM,CAAC,EAAE,CAAC;QACnF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;AACtD,CAAC"}
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"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"}

package/packages/cli/dist/commands/ai-tools.js

@@ -1,7 +1,5 @@
 import { applyAiToolEntries, summarizeAiProjectionStatus } from '@sdd-agent-platform/core/ai-tools';
-import { importRuntimeSkillCapability } from '@sdd-agent-platform/core/router';
 import { readAiToolSelection } from '../args.js';
-import { readRuntimeSkillImportArgs } from '../skill-import-args.js';
 export async function handleAiToolsCommand(projectRoot, command, subcommand, rest) {
     if (command !== 'update') {
         return null;
@@ -10,20 +8,11 @@ export async function handleAiToolsCommand(projectRoot, command, subcommand, res
     const check = updateArgs.includes('--check');
     const force = updateArgs.includes('--force');
     const aiTool = readAiToolSelection(updateArgs, false);
-    const skillImportArgs = readRuntimeSkillImportArgs(updateArgs, { dryRunFlag: '--check' });
-    if (skillImportArgs.error) {
-        return { exitCode: 2, error: skillImportArgs.error };
-    }
     const results = await applyAiToolEntries(projectRoot, { tool: aiTool, check, force });
-    const skillImports = [];
-    for (const request of skillImportArgs.requests) {
-        skillImports.push(await importRuntimeSkillCapability(projectRoot, { ...request, dryRun: check, force: request.force ?? force }));
-    }
     const status = summarizeAiProjectionStatus(results);
-    const skillImportBlocked = skillImports.some((result) => result.status === 'blocked');
     return {
-        exitCode: status === 'FAIL' || skillImportBlocked ? 1 : 0,
-        output: JSON.stringify({ command: 'update', check, force, status: skillImportBlocked ? 'FAIL' : status, aiTools: results, skillImports }, null, 2)
+        exitCode: status === 'FAIL' ? 1 : 0,
+        output: JSON.stringify({ command: 'update', check, force, status, aiTools: results }, null, 2)
     };
 }
 //# sourceMappingURL=ai-tools.js.map

package/packages/cli/dist/commands/ai-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai-tools.js","sourceRoot":"","sources":["../../src/commands/ai-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AACpG,OAAO,EAAE,4BAA4B,EAAiC,MAAM,iCAAiC,CAAC;AAC9G,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAQrE,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,WAAmB,EAAE,OAA2B,EAAE,UAA8B,EAAE,IAAc;IACzI,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,UAAU,GAAG,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACzF,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,mBAAmB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACtD,MAAM,eAAe,GAAG,0BAA0B,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;IAC1F,IAAI,eAAe,CAAC,KAAK,EAAE,CAAC;QAC1B,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,KAAK,EAAE,CAAC;IACvD,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACtF,MAAM,YAAY,GAA+B,EAAE,CAAC;IACpD,KAAK,MAAM,OAAO,IAAI,eAAe,CAAC,QAAQ,EAAE,CAAC;QAC/C,YAAY,CAAC,IAAI,CAAC,MAAM,4BAA4B,CAAC,WAAW,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC;IACnI,CAAC;IACD,MAAM,MAAM,GAAG,2BAA2B,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,kBAAkB,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;IACtF,OAAO;QACL,QAAQ,EAAE,MAAM,KAAK,MAAM,IAAI,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzD,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;KACnJ,CAAC;AACJ,CAAC"}
+{"version":3,"file":"ai-tools.js","sourceRoot":"","sources":["../../src/commands/ai-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AACpG,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAQjD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,WAAmB,EAAE,OAA2B,EAAE,UAA8B,EAAE,IAAc;IACzI,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,UAAU,GAAG,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACzF,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,mBAAmB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACtF,MAAM,MAAM,GAAG,2BAA2B,CAAC,OAAO,CAAC,CAAC;IACpD,OAAO;QACL,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;KAC/F,CAAC;AACJ,CAAC"}

package/packages/cli/dist/commands/{verifies.d.ts → artifact.d.ts}

@@ -3,4 +3,4 @@ export interface CliResult {
     output?: string;
     error?: string;
 }
-export declare function handleVerifiesCommand(projectRoot: string, command: string | undefined, subcommand: string | undefined, rest: string[]): Promise<CliResult | null>;
+export declare function handleArtifactCommand(projectRoot: string, command: string | undefined, subcommand: string | undefined, rest: string[]): Promise<CliResult | null>;

package/packages/cli/dist/commands/artifact.js

@@ -0,0 +1,168 @@
+import { ingestArtifactResult, inspectArtifactResultIngestions } from '@sdd-agent-platform/core/artifacts';
+import { validateSddResultArtifact } from '@sdd-agent-platform/core/artifacts';
+import { renderSddResultArtifactTemplate } from '@sdd-agent-platform/core/artifacts';
+import { readRunState, writeArtifact } from '@sdd-agent-platform/core/run-state';
+import { toArtifactRootRelativePath } from '@sdd-agent-platform/core/runtime-paths';
+import { readBranchOption, readSddResultStatus } from '../args.js';
+import { hasHelpFlag, hasPreflightFlag, readOption } from '../options.js';
+import { renderArtifactIngestionInspection, renderArtifactIngestionResult, renderArtifactValidationReport } from '../renderers/artifacts.js';
+import { renderTextOrJson } from '../renderers/json.js';
+export async function handleArtifactCommand(projectRoot, command, subcommand, rest) {
+    if (command !== 'artifact') {
+        return null;
+    }
+    if (hasHelpFlag([subcommand, ...rest].filter((item) => Boolean(item)))) {
+        return {
+            exitCode: 0,
+            output: artifactUsage(subcommand)
+        };
+    }
+    if (subcommand === 'template') {
+        const artifactPath = rest.find((item) => !item.startsWith('--'));
+        const taskId = readOption(rest, '--task');
+        const agent = readOption(rest, '--agent');
+        if (!artifactPath || !taskId || !agent) {
+            return {
+                exitCode: 2,
+                error: artifactUsage('template')
+            };
+        }
+        if (hasPreflightFlag(rest)) {
+            return {
+                exitCode: 0,
+                output: artifactPreflightOutput('artifact template', artifactPath, rest)
+            };
+        }
+        const runId = readOption(rest, '--run');
+        const branch = readBranchOption(rest);
+        if (runId) {
+            const scopeError = await artifactTemplateScopeError(projectRoot, runId, taskId, branch);
+            if (scopeError) {
+                return {
+                    exitCode: 2,
+                    error: scopeError
+                };
+            }
+        }
+        const template = await renderSddResultArtifactTemplate(projectRoot, {
+            artifactPath,
+            taskId,
+            agent,
+            branch,
+            runId: runId ?? undefined,
+            status: readSddResultStatus(rest, '--status') ?? 'PASS'
+        });
+        if (rest.includes('--write')) {
+            if (!runId) {
+                return {
+                    exitCode: 2,
+                    error: 'Usage: sdd artifact template <artifacts/path.md> --task <task_id> --agent <agent> --run <run_id> --write'
+                };
+            }
+            const written = await writeArtifact(projectRoot, runId, toArtifactRootRelativePath(artifactPath), template);
+            return {
+                exitCode: 0,
+                output: `Artifact template written: ${written.runRelativePath}\nphysical_path=${written.absolutePath}`
+            };
+        }
+        return {
+            exitCode: 0,
+            output: template
+        };
+    }
+    if (subcommand === 'validate') {
+        const runId = rest[0];
+        const artifactPath = rest[1];
+        if (!runId || !artifactPath) {
+            return {
+                exitCode: 2,
+                error: artifactUsage('validate')
+            };
+        }
+        const expectedTask = readOption(rest, '--task') ?? undefined;
+        const expectedAgent = readOption(rest, '--agent') ?? undefined;
+        const report = await validateSddResultArtifact(projectRoot, runId, artifactPath, {
+            expectedTask,
+            expectedAgent
+        });
+        return {
+            exitCode: report.valid ? 0 : 1,
+            output: renderTextOrJson(rest, report, (value) => renderArtifactValidationReport(artifactPath, value, expectedTask, expectedAgent))
+        };
+    }
+    if (subcommand === 'ingest') {
+        const runId = rest[0];
+        const delegationId = rest[1];
+        const artifactPath = rest[2];
+        if (!runId || !delegationId || !artifactPath) {
+            return {
+                exitCode: 2,
+                error: artifactUsage('ingest')
+            };
+        }
+        if (hasPreflightFlag(rest)) {
+            return {
+                exitCode: 0,
+                output: artifactPreflightOutput('artifact ingest', artifactPath, rest)
+            };
+        }
+        const result = await ingestArtifactResult(projectRoot, runId, { delegationId, artifactPath });
+        return {
+            exitCode: result.valid ? 0 : 1,
+            output: rest.includes('--json') ? JSON.stringify(result, null, 2) : renderArtifactIngestionResult(result)
+        };
+    }
+    if (subcommand === 'ingestions') {
+        const runId = rest[0];
+        if (!runId) {
+            return {
+                exitCode: 2,
+                error: artifactUsage('ingestions')
+            };
+        }
+        const inspection = await inspectArtifactResultIngestions(projectRoot, runId);
+        return {
+            exitCode: inspection.valid ? 0 : 1,
+            output: rest.includes('--json') ? JSON.stringify(inspection, null, 2) : renderArtifactIngestionInspection(inspection)
+        };
+    }
+    return null;
+}
+function artifactUsage(subcommand) {
+    if (subcommand === 'template') {
+        return 'Usage: sdd artifact template <artifacts/path.md> --task <task_id> --agent <agent> [--run <run_id> --write] [--branch <branch>] [--status <status>] [--preflight]';
+    }
+    if (subcommand === 'validate') {
+        return 'Usage: sdd artifact validate <run_id> <artifacts/path.md> [--task <task_id>] [--agent <agent>] [--json|--compact-json]';
+    }
+    if (subcommand === 'ingest') {
+        return 'Usage: sdd artifact ingest <run_id> <delegation_id> <artifacts/path.md> [--preflight] [--json]';
+    }
+    if (subcommand === 'ingestions') {
+        return 'Usage: sdd artifact ingestions <run_id> [--json]';
+    }
+    return 'Usage: sdd artifact template|validate|ingest|ingestions [options]';
+}
+async function artifactTemplateScopeError(projectRoot, runId, taskId, branch) {
+    const state = await readRunState(projectRoot, runId);
+    if (!state.partition && !state.gitBranch) {
+        return `Run ${runId} is unscoped; create it with sdd run create --branch <branch> --task <task_id> before writing artifacts.`;
+    }
+    if (!state.taskId) {
+        return `Run ${runId} has no scoped task; create it with sdd run create --branch <branch> --task <task_id> before writing artifacts.`;
+    }
+    if (state.taskId !== taskId) {
+        return `Run ${runId} is scoped to task ${state.taskId}, not ${taskId}.`;
+    }
+    if (branch && branch !== state.partition && branch !== state.gitBranch) {
+        return `Run ${runId} is scoped to branch ${state.gitBranch ?? state.partition}, not ${branch}.`;
+    }
+    return null;
+}
+function artifactPreflightOutput(commandName, artifactPath, args) {
+    if (args.includes('--json') || args.includes('--compact-json')) {
+        return renderTextOrJson(args, { contract: 'sdd-command-preflight-v1', command: commandName, artifactPath, sideEffects: 'none', status: 'PASS' }, (value) => JSON.stringify(value, null, 2));
+    }
+    return `SDD command preflight PASS\ncommand=${commandName}\nartifact=${artifactPath}\nside_effects=none`;
+}
+//# sourceMappingURL=artifact.js.map

package/packages/cli/dist/commands/artifact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.js","sourceRoot":"","sources":["../../src/commands/artifact.ts"],"names":[],"mappings":"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"}

package/packages/cli/dist/commands/context.js

@@ -30,7 +30,7 @@ export async function handleContextCommand(projectRoot, command, subcommand, res
         if (!taskId || !mode) {
             return {
                 exitCode: 2,
-                error: 'Usage: sdd context build --task <task_id> --mode do|verify|doctor [--agent <agent>] [--branch <branch>] [--profile brief|normal|forensic] [--json|--compact-json]'
+                error: 'Usage: sdd context build --task <task_id> --mode execute|doctor [--agent <agent>] [--branch <branch>] [--profile brief|normal|forensic] [--json|--compact-json]'
             };
         }
         const contextPackage = await buildContextBuildPackage(projectRoot, {