sdd-agent-platform 0.3.0 → 0.4.0

package/node_modules/@sdd-agent-platform/core/dist/execution/wave-executor.js.map

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

package/node_modules/@sdd-agent-platform/core/dist/execution.d.ts

@@ -0,0 +1,5 @@
+export * from './execution/agent-execution-records.js';
+export * from './execution/background-executor.js';
+export * from './execution/foreground-subagents.js';
+export * from './execution/resident-worker.js';
+export * from './execution/wave-executor.js';

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

@@ -0,0 +1,6 @@
+export * from './execution/agent-execution-records.js';
+export * from './execution/background-executor.js';
+export * from './execution/foreground-subagents.js';
+export * from './execution/resident-worker.js';
+export * from './execution/wave-executor.js';
+//# sourceMappingURL=execution.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execution.js","sourceRoot":"","sources":["../src/execution.ts"],"names":[],"mappings":"AAAA,cAAc,wCAAwC,CAAC;AACvD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC"}

package/node_modules/@sdd-agent-platform/core/dist/governance/policy.d.ts

@@ -0,0 +1,53 @@
+import { GOVERNANCE_POLICY_CONTRACT_VERSION } from '../contracts.js';
+export type GovernancePolicyOperation = 'background_executor' | 'wave_executor' | 'sync_back_apply' | 'destructive_git' | 'external_interaction' | 'cleanup';
+export type GovernancePolicyDecisionStatus = 'allow' | 'block' | 'confirm';
+export interface GovernancePolicy {
+    version: typeof GOVERNANCE_POLICY_CONTRACT_VERSION;
+    concurrency: {
+        maxBackgroundDelegations: number;
+        maxWaveExecutors: number;
+    };
+    manualConfirmation: {
+        operations: GovernancePolicyOperation[];
+        workerAdapters: string[];
+        riskTags: string[];
+    };
+    cleanup: {
+        archiveOnly: true;
+        deleteRunHistory: false;
+    };
+    retry: {
+        reopenTerminalDelegation: false;
+        maxAttemptsPerDelegation: number;
+    };
+    stopConditions: string[];
+    audit: {
+        requiredEvents: string[];
+        requiredEvidence: string[];
+    };
+}
+export interface GovernancePolicyDecisionInput {
+    operation: GovernancePolicyOperation;
+    runId?: string;
+    taskId?: string;
+    workerAdapterId?: string;
+    riskTags?: string[];
+    approved?: boolean;
+    excludeQueueItemId?: string;
+}
+export interface GovernancePolicyIssue {
+    field: string;
+    message: string;
+    recommendation: string;
+}
+export interface GovernancePolicyDecision {
+    version: typeof GOVERNANCE_POLICY_CONTRACT_VERSION;
+    operation: GovernancePolicyOperation;
+    status: GovernancePolicyDecisionStatus;
+    allowed: boolean;
+    reasons: string[];
+    issues: GovernancePolicyIssue[];
+    policy: GovernancePolicy;
+}
+export declare function inspectGovernancePolicy(projectRoot: string): Promise<GovernancePolicy>;
+export declare function evaluateGovernancePolicy(projectRoot: string, input: GovernancePolicyDecisionInput): Promise<GovernancePolicyDecision>;

package/node_modules/@sdd-agent-platform/core/dist/governance/policy.js

@@ -0,0 +1,111 @@
+import { GOVERNANCE_POLICY_CONTRACT_VERSION } from '../contracts.js';
+import { parseProjectConfig } from '../config/project-config.js';
+import { getProjectConfigPath } from '../runtime-paths.js';
+import { readFile } from 'node:fs/promises';
+import { listDelegationQueueItems } from '../delegation/queue.js';
+import { readAllRunStates } from '../run-state/run-state.js';
+const BUILT_IN_GOVERNANCE_POLICY = {
+    version: GOVERNANCE_POLICY_CONTRACT_VERSION,
+    concurrency: {
+        maxBackgroundDelegations: 4,
+        maxWaveExecutors: 1
+    },
+    manualConfirmation: {
+        operations: ['sync_back_apply', 'destructive_git', 'external_interaction', 'cleanup'],
+        workerAdapters: ['manual-handoff-worker'],
+        riskTags: ['database', 'security', 'permission', 'external', 'destructive-git', 'data-loss']
+    },
+    cleanup: {
+        archiveOnly: true,
+        deleteRunHistory: false
+    },
+    retry: {
+        reopenTerminalDelegation: false,
+        maxAttemptsPerDelegation: 1
+    },
+    stopConditions: ['manual_confirmation_required', 'concurrency_limit_reached', 'terminal_delegation_reopen', 'planner_manual_gate', 'invalid_artifact_evidence'],
+    audit: {
+        requiredEvents: ['governance_policy_blocked', 'governance_policy_confirmed'],
+        requiredEvidence: ['policy version', 'operation', 'decision status', 'reason']
+    }
+};
+export async function inspectGovernancePolicy(projectRoot) {
+    await assertProjectConfigReadable(projectRoot);
+    return {
+        ...BUILT_IN_GOVERNANCE_POLICY,
+        concurrency: { ...BUILT_IN_GOVERNANCE_POLICY.concurrency },
+        manualConfirmation: {
+            operations: [...BUILT_IN_GOVERNANCE_POLICY.manualConfirmation.operations],
+            workerAdapters: [...BUILT_IN_GOVERNANCE_POLICY.manualConfirmation.workerAdapters],
+            riskTags: [...BUILT_IN_GOVERNANCE_POLICY.manualConfirmation.riskTags]
+        },
+        cleanup: { ...BUILT_IN_GOVERNANCE_POLICY.cleanup },
+        retry: { ...BUILT_IN_GOVERNANCE_POLICY.retry },
+        stopConditions: [...BUILT_IN_GOVERNANCE_POLICY.stopConditions],
+        audit: {
+            requiredEvents: [...BUILT_IN_GOVERNANCE_POLICY.audit.requiredEvents],
+            requiredEvidence: [...BUILT_IN_GOVERNANCE_POLICY.audit.requiredEvidence]
+        }
+    };
+}
+export async function evaluateGovernancePolicy(projectRoot, input) {
+    const policy = await inspectGovernancePolicy(projectRoot);
+    const issues = [];
+    const reasons = [];
+    const queue = await listDelegationQueueItems(projectRoot);
+    const runningDelegations = queue.items.filter((item) => item.status === 'RUNNING' && item.id !== input.excludeQueueItemId).length;
+    const runningWaveExecutors = (await readAllRunStates(projectRoot)).filter((state) => state.status === 'running' && state.phase === 'wave').length;
+    if ((input.operation === 'background_executor' || input.operation === 'wave_executor') && runningDelegations >= policy.concurrency.maxBackgroundDelegations) {
+        const reason = `Running delegation count ${runningDelegations} reached governance limit ${policy.concurrency.maxBackgroundDelegations}.`;
+        reasons.push(reason);
+        issues.push(governanceIssue('governance.concurrency', reason, 'Wait for existing delegations to finish, archive stale exploratory runs, or inspect governance policy before starting more background work.'));
+    }
+    if (input.operation === 'wave_executor' && runningWaveExecutors >= policy.concurrency.maxWaveExecutors) {
+        const reason = `Running wave executor count ${runningWaveExecutors} reached governance limit ${policy.concurrency.maxWaveExecutors}.`;
+        reasons.push(reason);
+        issues.push(governanceIssue('governance.wave_concurrency', reason, 'Wait for the running wave executor to finish or archive the stale run before starting another wave.'));
+    }
+    const confirmationReasons = [];
+    if (policy.manualConfirmation.operations.includes(input.operation)) {
+        confirmationReasons.push(`Operation ${input.operation} requires explicit confirmation.`);
+    }
+    if (input.workerAdapterId && policy.manualConfirmation.workerAdapters.includes(input.workerAdapterId)) {
+        confirmationReasons.push(`Worker adapter ${input.workerAdapterId} requires manual confirmation.`);
+    }
+    const riskHits = (input.riskTags ?? []).filter((tag) => policy.manualConfirmation.riskTags.includes(tag));
+    if (riskHits.length > 0) {
+        confirmationReasons.push(`Risk tag(s) require confirmation: ${riskHits.join(', ')}.`);
+    }
+    if (confirmationReasons.length > 0 && !input.approved) {
+        reasons.push(...confirmationReasons);
+        for (const reason of confirmationReasons) {
+            issues.push(governanceIssue('governance.confirmation', reason, 'Get explicit user confirmation before continuing this governed operation.'));
+        }
+    }
+    if (confirmationReasons.length > 0 && input.approved) {
+        reasons.push(...confirmationReasons.map((reason) => `${reason} Approval recorded.`));
+    }
+    const status = issues.length > 0
+        ? confirmationReasons.length > 0 && issues.every((issue) => issue.field === 'governance.confirmation')
+            ? 'confirm'
+            : 'block'
+        : 'allow';
+    return {
+        version: GOVERNANCE_POLICY_CONTRACT_VERSION,
+        operation: input.operation,
+        status,
+        allowed: status === 'allow',
+        reasons: reasons.length > 0 ? reasons : [`Operation ${input.operation} is allowed by governance policy.`],
+        issues,
+        policy
+    };
+}
+function governanceIssue(field, message, recommendation) {
+    return { field, message, recommendation };
+}
+async function assertProjectConfigReadable(projectRoot) {
+    const configPath = getProjectConfigPath(projectRoot);
+    const raw = await readFile(configPath, 'utf8');
+    parseProjectConfig(raw, configPath);
+}
+//# sourceMappingURL=policy.js.map

package/node_modules/@sdd-agent-platform/core/dist/governance/policy.js.map

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

package/node_modules/@sdd-agent-platform/core/dist/governance.d.ts

@@ -0,0 +1 @@
+export * from './governance/policy.js';

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

@@ -0,0 +1,2 @@
+export * from './governance/policy.js';
+//# sourceMappingURL=governance.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"governance.js","sourceRoot":"","sources":["../src/governance.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC"}

package/node_modules/@sdd-agent-platform/core/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/{dist/packages/core/src → node_modules/@sdd-agent-platform/core/dist}/instructions.d.ts

@@ -1,5 +1,5 @@
 export declare const SDD_INSTRUCTIONS_CONTRACT = "sdd-instructions-v1";
-export type InstructionAction = 'overview' | 'init' | 'doctor' | 'update' | 'spec' | 'plan' | 'tasks' | 'do' | 'verify' | 'run-task' | 'verify-task';
+export type InstructionAction = 'overview' | 'init' | 'doctor' | 'update' | 'spec' | 'plan' | 'tasks' | 'verifies' | 'test' | 'do' | 'verify' | 'sync-back' | 'ship' | 'run-task' | 'verify-task';
 export interface SddInstructionPayload {
     contract: typeof SDD_INSTRUCTIONS_CONTRACT;
     version: string;

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

@@ -2,18 +2,19 @@ import { SDD_VERSION } from './ai-tools.js';
 export const SDD_INSTRUCTIONS_CONTRACT = 'sdd-instructions-v1';
 const INSTRUCTION_PAYLOADS = {
     overview: {
-        summary: 'Route natural-language SDD intent from branch/source status to task execution, agent evidence, partition-aware verification, and explicit sync-back while keeping CLI/core output as source of truth.',
-        requiredCommands: ['sdd status', 'sdd lifecycle decide --from-text <text>', 'sdd doctor', 'sdd tasks inspect <task_id>', 'sdd do task <task_id>', 'sdd verify task <task_id> [--branch <branch>] [--run <run_id>]', 'sdd sync-back inspect [<run_id>] --task <task_id>'],
+        summary: 'Route natural-language SDD intent from branch/source status to task execution, agent evidence, partition-aware verification, explicit sync-back, and release readiness while keeping CLI/core output as source of truth.',
+        requiredCommands: ['sdd status', 'sdd lifecycle decide --from-text <text>', 'sdd doctor', 'sdd tasks inspect <task_id>', 'sdd do task <task_id>', 'sdd test task <task_id> --branch <branch>', 'sdd sync-back inspect [<run_id>] --branch <branch> --task <task_id>', 'sdd sync-back apply [<run_id>] --branch <branch> --task <task_id> [--approved]', 'sdd instructions ship --json'],
         allowedSideEffects: ['read .sdd state', 'read specs documents', 'read generated AI entries'],
-        forbiddenSideEffects: ['background write', 'worktree creation', 'auto commit', 'force push', 'unapproved complex sync-back apply'],
+        forbiddenSideEffects: ['background write', 'worktree creation', 'auto commit', 'force push', 'unapproved complex sync-back apply', 'publish or push release artifacts without explicit human confirmation'],
         nextSteps: [
             'Treat /sdd as a natural-language intent router, then run sdd status first to see branch/source context and the recommended next command; report only workflow state, blocker/current task, and next action unless the user asks for full detail.',
             'Dynamic routing comes from CLI/core output; follow the recommended next command and do not infer dynamic state from generated markdown.',
-            'If intent remains ambiguous after status, ask one clarifying question before spec/plan/do/verify/sync-back work.',
-            'If status reports generated entry drift or missing config, run sdd doctor and sdd update before do/verify.',
+            'If intent remains ambiguous after status, ask one clarifying question before spec/plan/do/test/sync-back/ship work.',
+            'If status reports generated entry drift or missing config, run sdd doctor and sdd update before do/test/ship.',
             'If status recommends a pending task, run sdd tasks inspect <task_id> and execute only the approved task boundary; scout/implementer/reviewer/validator participation should be recorded as artifacts rather than hidden in the main chat.',
-            'For verify and sync-back, omit --run by default so CLI resolves the latest eligible run from partition + task id; pass --run only for replay, CI, or old-run inspection.',
-            'After verify PASS, run sdd sync-back inspect --task <task_id>; direct-safe tasks may apply directly, while confirm-required tasks need sdd sync-back apply --approved after human confirmation.'
+            'For test and sync-back, omit --run by default so CLI resolves the latest eligible run from partition + task id; pass --run only for replay, CI, or old-run inspection.',
+            'After /sdd:test PASS, use /sdd:sync-back or run sdd sync-back inspect --branch <branch> --task <task_id>; inspect must explain the target tasks.md update before direct apply or before asking for human approval.',
+            'For release readiness, use /sdd:ship or sdd ship --branch <branch> --dry-run; do not publish, push, tag, or create external release state without explicit human confirmation.'
         ]
     },
     init: {
@@ -24,11 +25,11 @@ const INSTRUCTION_PAYLOADS = {
         nextSteps: ['Run sdd init --ai claude-code.', 'Run sdd status to inspect current Git branch partition state and the recommended next command.', 'Use /sdd:spec to create or refine specs/<partition>/spec.md; omitted --branch uses the current Git branch, explicit --branch uses the requested partition.', 'Run sdd doctor after initialization.']
     },
     doctor: {
-        summary: 'Check project config, scoped runtime evidence, and generated AI entry drift.',
-        requiredCommands: ['sdd doctor', 'sdd doctor --latest-only', 'sdd doctor --all-runs', 'sdd run archive <run_id> --reason <text>'],
+        summary: 'Check project config, scoped runtime evidence, generated AI entry drift, and deterministic recover/reconcile guidance.',
+        requiredCommands: ['sdd doctor fast --branch <branch>', 'sdd doctor deep --branch <branch>', 'sdd doctor recover --branch <branch>', 'sdd run archive <run_id> --reason <text>'],
         allowedSideEffects: ['read .sdd state', 'read specs documents', 'read generated AI entries', 'archive failed exploratory run state when explicitly requested'],
-        forbiddenSideEffects: ['delete run evidence', 'write project source files', 'background write', 'worktree creation'],
-        nextSteps: ['Run sdd doctor for normal health checks.', 'Use sdd doctor --latest-only to ignore older non-archived exploratory evidence during current-run checks.', 'Use sdd doctor --all-runs for historical audit.', 'Use sdd run archive <run_id> --reason <text> for failed exploratory runs instead of deleting evidence.', 'Run sdd update if generated entry drift is reported.']
+        forbiddenSideEffects: ['delete run evidence', 'write project source files', 'background write', 'worktree creation', 'run deep historical scans unless explicitly requested'],
+        nextSteps: ['Run sdd doctor fast for normal current-run health checks.', 'Use sdd doctor deep for explicit historical audit.', 'Use sdd doctor recover for deterministic rebuild/reinspect/reconcile guidance without automatic destructive cleanup.', 'Use sdd run archive <run_id> --reason <text> for failed exploratory runs instead of deleting evidence.', 'Run sdd update if generated entry drift is reported.']
     },
     update: {
         summary: 'Refresh missing or drifted managed AI tool entries.',
@@ -58,24 +59,52 @@ const INSTRUCTION_PAYLOADS = {
         forbiddenSideEffects: ['implement code', 'execute dependency waves', 'silently advance to do', 'turn tasks.md into project-management backlog'],
         nextSteps: ['Read approved spec acceptance IDs, approved plan design sections, and the current plan hash from sdd status.', 'Record based_on_plan_hash in tasks.md so later plan/spec revisions can mark these tasks stale.', 'Run sdd tasks format to get the canonical block format.', 'Map every task to acceptance_refs and plan_refs where applicable.', 'Keep #### Boundary, #### Acceptance, #### Definition of Done, #### Evidence Expectations, and #### Implementation Notes as companion sections outside the ```sdd-task fenced block; keep only metadata inside the fence.', 'For risky tasks, include allowed_agents, required_artifacts, verification_availability, and autonomy.', 'Run sdd tasks list and sdd tasks gaps.', 'Stop before do task when task boundary, acceptance refs, plan refs, or evidence requirements are unclear.']
     },
+    verifies: {
+        summary: 'Create or inspect specs/<partition>/verify.md as the task-derived verification contract before runtime evidence execution.',
+        requiredCommands: ['sdd status', 'sdd tasks list --branch <branch>', 'sdd verifies inspect --branch <branch>', 'sdd verifies write --branch <branch>'],
+        allowedSideEffects: ['read spec, plan, and tasks documents', 'write specs/<partition>/verify.md when explicitly using write'],
+        forbiddenSideEffects: ['run validation commands', 'update runtime.sqlite run state', 'create sync-back proposal', 'modify source files', 'auto commit'],
+        nextSteps: ['Run sdd status and confirm tasks.md is current.', 'Run sdd verifies inspect --branch <branch> to check whether verify.md exists and matches the current tasks hash.', 'Run sdd verifies write --branch <branch> to create verify.md, or add --force after reviewing task contract changes.', 'Use verify.md to guide validator evidence expectations; do not treat it as runtime evidence or as a replacement for /sdd:test.']
+    },
+    test: {
+        summary: 'Execute task validation commands from the verification contract boundary, capture command output, evaluate acceptance evidence coverage, and return one unified test judgment for the task.',
+        requiredCommands: ['sdd status', 'sdd verifies inspect --branch <branch>', 'sdd test task <task_id> --branch <branch>'],
+        allowedSideEffects: ['run declared validation commands', 'write branch-scoped test evidence artifacts', 'update runtime.sqlite test run and step records', 'write validator evidence artifact'],
+        forbiddenSideEffects: ['modify source files outside the validation command effects', 'create sync-back proposal', 'auto commit', 'publish or push', 'treat command success alone as semantic PASS'],
+        nextSteps: ['Run sdd status and resolve exactly one task id plus branch.', 'Run sdd verifies inspect --branch <branch> and refresh verify.md if stale before executing tests.', 'Run sdd test task <task_id> --branch <branch>; use --command only to override or narrow task validation commands deliberately.', 'Inspect the generated test index, validator artifact paths, and acceptance coverage summary.', 'If /sdd:test returns PASS, proceed to /sdd:sync-back or sdd sync-back inspect; if it returns FAIL or BLOCKED, fix the reported command/evidence gaps and rerun /sdd:test.']
+    },
     do: {
         summary: 'Execute one approved task boundary through the ingestion-aware SDD task workflow with explicit scout/implementer/reviewer/validator evidence handoff.',
         requiredCommands: ['sdd status', 'sdd instructions do --json', 'sdd tasks inspect <task_id>', 'sdd artifact template artifacts/<agent>-<task_id>.md --task <task_id> --agent <agent>', 'sdd artifact validate <run_id> <artifact> --task <task_id> --agent <agent>', 'sdd do task <task_id>'],
-        allowedSideEffects: ['write .sdd/runs artifacts', 'update .sdd run state', 'modify files within selected task boundary'],
+        allowedSideEffects: ['write branch-scoped .sdd/runs evidence artifacts', 'update runtime.sqlite run state', 'modify files within selected task boundary'],
         forbiddenSideEffects: ['background write', 'worktree creation', 'auto commit', 'expand beyond selected task boundary without checkpoint', 'mark missing evidence as PASS'],
-        nextSteps: ['Run sdd status and resolve exactly one task id from the user request or recommended next command.', 'Run sdd instructions do --json and sdd tasks inspect <task_id>.', 'Restate only the task Boundary, blocking gaps, and validation commands before implementation.', 'Use scout for bounded context only, implementer for selected-boundary edits, reviewer for review evidence, and validator for validation plus acceptance mapping.', 'Use sdd artifact template examples for artifacts/implement-<task_id>.md, artifacts/review-<task_id>.md, and artifacts/validation-<task_id>.md before creating evidence; save physical files under .sdd/runs/<run_id>/artifacts/, pass run-relative artifacts/<file> paths to CLI flags, and keep source/test files in ## Evidence, not in sdd-result.artifacts.', 'Run sdd artifact validate before passing artifacts into sdd do task <task_id>.', 'Run or coordinate implementation only within the selected task boundary.', 'Run sdd do task <task_id> with explicit artifact paths when evidence is available.', 'Report run id, final status, blocking gaps, and next gate; avoid replaying full agent evidence unless the user asks.']
+        nextSteps: ['Run sdd status and resolve exactly one task id from the user request or recommended next command.', 'Run sdd instructions do --json and sdd tasks inspect <task_id>.', 'Restate only the task Boundary, blocking gaps, and validation commands before implementation.', 'Use scout for bounded context only, implementer for selected-boundary edits, reviewer for review evidence, and validator for validation plus acceptance mapping.', 'Use sdd artifact template examples for artifacts/implement-<task_id>.md, artifacts/review-<task_id>.md, and artifacts/validation-<task_id>.md before creating evidence; save physical files under branch evidence .sdd/runs/<branchSlug>/evidence/artifacts/, pass run-relative artifacts/<file> paths to CLI flags, and keep source/test files in ## Evidence, not in sdd-result.artifacts.', 'Run sdd artifact validate before passing artifacts into sdd do task <task_id>.', 'Run or coordinate implementation only within the selected task boundary.', 'Run sdd do task <task_id> with explicit artifact paths when evidence is available.', 'Report run id, final status, blocking gaps, and next gate; if completed, recommend /sdd:test / sdd test task <task_id> --branch <branch>.']
     },
     verify: {
-        summary: 'Verify task acceptance coverage from reviewer/validator artifacts, resolving the latest eligible run from partition + task id unless --run is explicit.',
-        requiredCommands: ['sdd status', 'sdd instructions verify --json', 'sdd artifact template artifacts/validation-<task_id>.md --task <task_id> --agent validator', 'sdd artifact validate <run_id> <artifact> --task <task_id> --agent validator', 'sdd verify task <task_id> [--branch <branch>] [--run <run_id>]', 'sdd sync-back inspect [<run_id>] --task <task_id>'],
-        allowedSideEffects: ['write acceptance coverage artifact', 'update .sdd run state', 'create sync-back proposal'],
+        summary: 'Run compatibility/diagnostic task acceptance coverage from reviewer/validator artifacts, resolving the latest eligible run from partition + task id unless --run is explicit; /sdd:test is the primary runtime gate.',
+        requiredCommands: ['sdd status', 'sdd instructions verify --json', 'sdd artifact template artifacts/validation-<task_id>.md --task <task_id> --agent validator', 'sdd artifact validate <run_id> <artifact> --task <task_id> --agent validator', 'sdd verify task <task_id> [--branch <branch>] [--run <run_id>]', 'sdd sync-back inspect [<run_id>] --branch <branch> --task <task_id>'],
+        allowedSideEffects: ['write acceptance coverage artifact', 'update runtime.sqlite run state', 'create sync-back proposal'],
         forbiddenSideEffects: ['auto commit', 'force push', 'auto-fix failures', 'unapproved complex sync-back apply', 'mark completed with blocking validation gaps'],
-        nextSteps: ['Run sdd status and resolve exactly one task id plus workflow partition from the recommended command or user request.', 'Omit --run by default so CLI resolves the latest eligible run for partition + task id; pass --run only for explicit replay, CI, or old-run inspection.', 'Ensure the validator artifact includes exact Acceptance text, preferably under ## Acceptance Mapping from sdd artifact template.', 'Store artifacts physically under .sdd/runs/<run_id>/artifacts/ but pass run-relative artifacts/<file> paths to validate/verify CLI flags.', 'Run sdd artifact validate before goal-level verify.', 'Run sdd instructions verify --json and sdd verify task <task_id> --branch <branch>.', 'If PASS, run sdd sync-back inspect --branch <branch> --task <task_id> and follow its apply_policy.', 'Report PASS/BLOCKED status, unresolved blockers, and next apply command only; avoid pasting full acceptance coverage unless requested.', 'Direct-safe tasks may run sdd sync-back apply directly; confirm-required tasks require human confirmation and --approved before writing tasks.md.']
+        nextSteps: ['Run sdd status and resolve exactly one task id plus workflow partition from the recommended command or user request.', 'Omit --run by default so CLI resolves the latest eligible run for partition + task id; pass --run only for explicit replay, CI, or old-run inspection.', 'Ensure the validator artifact includes exact Acceptance text, preferably under ## Acceptance Mapping from sdd artifact template.', 'Store artifacts physically under branch evidence .sdd/runs/<branchSlug>/evidence/artifacts/ but pass run-relative artifacts/<file> paths to validate/verify CLI flags.', 'Run sdd artifact validate before compatibility verify.', 'Run sdd instructions verify --json and sdd verify task <task_id> --branch <branch> only for explicit low-level diagnostics.', 'For the primary slash lifecycle, use /sdd:test; after /sdd:test PASS, use /sdd:sync-back or run sdd sync-back inspect --branch <branch> --task <task_id> before apply.', 'Report PASS/BLOCKED status, unresolved blockers, and next sync-back gate only; avoid pasting full acceptance coverage unless requested.']
+    },
+    'sync-back': {
+        summary: 'Inspect and optionally apply the verified task completion proposal back into specs/<partition>/tasks.md with an explicit target change summary.',
+        requiredCommands: ['sdd status', 'sdd instructions sync-back --json', 'sdd sync-back inspect [<run_id>] --branch <branch> --task <task_id>', 'sdd sync-back apply [<run_id>] --branch <branch> --task <task_id> [--approved]'],
+        allowedSideEffects: ['read runtime.sqlite run state', 'read sync-back proposal artifact', 'read specs/<partition>/tasks.md', 'write specs/<partition>/tasks.md only during apply', 'update run sync_back state only during apply'],
+        forbiddenSideEffects: ['auto commit', 'force push', 'apply without inspect', 'apply confirm-required proposals without human approval', 'change source files outside tasks.md'],
+        nextSteps: ['Run sdd status and resolve exactly one task id plus workflow partition from the recommended command or user request.', 'Run sdd sync-back inspect --branch <branch> --task <task_id> first; pass an explicit run id only for replay, CI, or old-run inspection.', 'Report the inspect target update before asking for approval: target tasks file, task id, markdown status transition, proposal path, evidence artifacts, apply_policy, and policy reasons.', 'If apply_policy=direct and status=ready, run sdd sync-back apply --branch <branch> --task <task_id>; if approval_required=true, ask for explicit confirmation and then add --approved.', 'Explain that apply writes the task block status to completed, appends the sync-back implementation note from the proposal/evidence, marks the run sync_back state applied, and rebuilds the local run index.', 'After apply, report the updated task id, tasks.md path, applied flag, and sync_back state.']
+    },
+    ship: {
+        summary: 'Run local release readiness and optionally write specs/<branch>/release.md without publishing, pushing, tagging, or changing external release state.',
+        requiredCommands: ['sdd ship --branch <branch> --dry-run', 'sdd ship --branch <branch>', 'sdd statusline --branch <branch>', 'sdd doctor fast --branch <branch>', 'sdd update --check', 'npm run typecheck', 'npm test', 'npm run build', 'npm pack --dry-run --json', 'git status'],
+        allowedSideEffects: ['read project status', 'read SDD documents and run evidence', 'write specs/<branch>/release.md when not using --dry-run', 'run local validation commands'],
+        forbiddenSideEffects: ['npm publish', 'git push', 'git tag', 'create GitHub release', 'force push', 'auto commit', 'skip failed gates', 'treat historical doctor debt as a release blocker unless it affects current run evidence'],
+        nextSteps: ['Run sdd ship --branch <branch> --dry-run to inspect PASS/BLOCKED readiness without writing release docs.', 'If readiness output is acceptable, run sdd ship --branch <branch> to write specs/<branch>/release.md.', 'Use sdd statusline --branch <branch> for compact runtime/test/team/token/evidence health.', 'Run current-run health checks with sdd doctor fast --branch <branch>; use sdd doctor deep only for explicit historical audit.', 'Run npm run typecheck, npm test, npm run build, and npm pack --dry-run --json when preparing a real package release.', 'Report PASS/BLOCKED by readiness check, including exact failed commands and unresolved manual confirmations.', 'Stop before npm publish, git push, git tag, or external release creation unless the user explicitly approves that separate action.']
     },
     'run-task': {
         summary: 'Run the ingestion-aware task workflow using CLI/core runtime state and artifacts.',
         requiredCommands: ['sdd tasks inspect <task_id>', 'sdd do task <task_id>'],
-        allowedSideEffects: ['write .sdd/runs artifacts', 'update .sdd run state'],
+        allowedSideEffects: ['write branch-scoped .sdd/runs evidence artifacts', 'update runtime.sqlite run state'],
         forbiddenSideEffects: ['background write', 'worktree creation', 'auto commit'],
         nextSteps: ['Inspect the task.', 'Run the task loop with explicit artifacts and validation evidence.']
     },
@@ -113,6 +142,6 @@ export function renderSddInstructions(payload) {
     ].join('\n');
 }
 function isInstructionAction(action) {
-    return action === 'overview' || action === 'init' || action === 'doctor' || action === 'update' || action === 'spec' || action === 'plan' || action === 'tasks' || action === 'do' || action === 'verify' || action === 'run-task' || action === 'verify-task';
+    return action === 'overview' || action === 'init' || action === 'doctor' || action === 'update' || action === 'spec' || action === 'plan' || action === 'tasks' || action === 'verifies' || action === 'test' || action === 'do' || action === 'verify' || action === 'sync-back' || action === 'ship' || action === 'run-task' || action === 'verify-task';
 }
 //# sourceMappingURL=instructions.js.map

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

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

package/node_modules/@sdd-agent-platform/core/dist/lifecycle/decision-gate.d.ts

@@ -0,0 +1,39 @@
+import { LEGACY_LIFECYCLE_DECISION_CONTRACT, LIFECYCLE_DECISION_CONTRACT, LIFECYCLE_DECISION_VERSION } from '../contracts.js';
+import type { RunState } from '../run-state/model.js';
+import type { LifecycleDecisionSignals } from './risk-signals.js';
+export type LifecycleProfile = 'direct' | 'compact' | 'full' | 'research';
+export type LifecycleConfidence = 'high' | 'medium' | 'low';
+export type LifecycleAutonomyCeiling = 'direct_execution_allowed' | 'compact_boundary_only' | 'full_sdd_with_checkpoint' | 'research_before_implementation';
+export interface LifecycleDecisionRecord {
+    contract: typeof LIFECYCLE_DECISION_CONTRACT | typeof LEGACY_LIFECYCLE_DECISION_CONTRACT;
+    version?: typeof LIFECYCLE_DECISION_VERSION;
+    model_version: string;
+    input_summary: Record<string, unknown>;
+    decision: {
+        profile: LifecycleProfile | null;
+        confidence: LifecycleConfidence | null;
+        hard_gate_hits: string[];
+        required_stages: string[];
+        skipped_stages: string[];
+        human_checkpoint_required: boolean;
+    };
+    reasons: string[];
+    escalation_triggers: string[];
+    downgrade_reason: string | null;
+    audit: {
+        decided_at: string | null;
+        decided_by: 'command' | 'runtime' | 'user_override' | null;
+        policy_version: string;
+        source_artifacts: string[];
+    };
+}
+export interface LifecycleDecisionGateResult {
+    record: LifecycleDecisionRecord;
+    checkpointRequired: boolean;
+    boundaries: string[];
+    autonomyCeiling: LifecycleAutonomyCeiling;
+}
+export declare function evaluateLifecycleDecisionGate(input?: Partial<LifecycleDecisionSignals>, decidedAt?: Date): LifecycleDecisionGateResult;
+export declare function recordLifecycleDecision(projectRoot: string, runId: string, record: LifecycleDecisionRecord): Promise<RunState>;
+export declare function emptyLifecycleDecisionRecord(): LifecycleDecisionRecord;
+export declare function lifecycleAutonomyCeiling(record: LifecycleDecisionRecord): LifecycleAutonomyCeiling;