sdd-agent-platform 0.4.1 → 0.4.2

package/packages/cli/dist/commands/stage-close.js

@@ -0,0 +1,295 @@
+import { evaluateLifecycleRiskDecisionForModel, inspectLifecycleRiskDecisionForModel, readLifecycleRiskDecisionProjection } from '@sdd-agent-platform/core/risk';
+import { getSddInstructions, renderSddInstructions } from '@sdd-agent-platform/core/instructions';
+import { parseSddBranch, resolveSddContext } from '@sdd-agent-platform/core/sdd-docs';
+import { resolveWorkflowState } from '@sdd-agent-platform/core/workflow-state';
+import { reconcileGoalVerifyCollaborationClosure, reconcilePlanCollaborationClosure, reconcileShipCollaborationClosure, reconcileSpecCollaborationClosure, reconcileTasksCollaborationClosure, reconcileTestCollaborationClosure, reconcileVerifiesCollaborationClosure } from '@sdd-agent-platform/core/stage-collaboration';
+import { readBranchContext, readResolvedBranch } from '../args.js';
+import { hasHelpFlag, readOption } from '../options.js';
+import { jsonOutput, renderTextOrJson, wantsJson } from '../renderers/json.js';
+const CLOSE_STAGES = ['spec', 'plan', 'tasks', 'verifies', 'test', 'goal-verify', 'ship'];
+const ENTRY_STAGES = ['spec', 'plan'];
+const LIFECYCLE_ENTRY_NEXT_ACTION = 'Run /sdd or /sdd:spec to create or refresh the lifecycle decision before using stage-local entries.';
+export async function handleStageCloseCommand(projectRoot, command, subcommand, rest) {
+    if (isStageEntry(command) && (subcommand === undefined || subcommand.startsWith('--'))) {
+        const entryArgs = [subcommand, ...rest].filter((item) => Boolean(item));
+        if (hasHelpFlag(entryArgs)) {
+            return { exitCode: 0, output: stageEntryUsage(command) };
+        }
+        const context = await resolveSddContext(projectRoot, readBranchContext(entryArgs));
+        const payload = stageEntryPayload(command, context);
+        return {
+            exitCode: 0,
+            output: renderTextOrJson(entryArgs, payload, renderStageEntryInstructions)
+        };
+    }
+    if (!isCloseStage(command)) {
+        return null;
+    }
+    if (subcommand !== 'close') {
+        return null;
+    }
+    if (hasHelpFlag(rest)) {
+        return { exitCode: 0, output: stageCloseUsage(command) };
+    }
+    const branch = await readResolvedBranch(projectRoot, rest);
+    const targetResolution = closeTargetStage(command, rest);
+    if (!targetResolution.valid) {
+        const payload = stageCloseBlockedPayload(command, branch, [targetResolution.reason]);
+        return {
+            exitCode: 1,
+            output: wantsJson(rest) ? jsonOutput(payload, rest) : renderBlockedStageClosePayload(payload)
+        };
+    }
+    const stage = targetResolution.stage;
+    const decision = await lifecycleDecisionForClose(projectRoot, stage, branch);
+    if (!decision.decision) {
+        const payload = stageCloseBlockedPayload(stage, branch, decision.reasons);
+        return {
+            exitCode: 1,
+            output: wantsJson(rest) ? jsonOutput(payload, rest) : renderBlockedStageClosePayload(payload)
+        };
+    }
+    const runId = readOption(rest, '--run') ?? undefined;
+    const result = await reconcileStageClose(projectRoot, stage, decision.decision, runId);
+    const payload = stageClosePayload(stage, result);
+    return {
+        exitCode: payload.stageDecision.status === 'completed' ? 0 : 1,
+        output: wantsJson(rest) ? jsonOutput(payload, rest) : renderStageClosePayload(payload)
+    };
+}
+function isCloseStage(value) {
+    return CLOSE_STAGES.includes(value);
+}
+function isStageEntry(value) {
+    return ENTRY_STAGES.includes(value);
+}
+function stageEntryPayload(stage, context) {
+    return {
+        ...getSddInstructions(stage),
+        context: {
+            branch: context.branch,
+            partition: context.partition,
+            rawBranch: context.rawBranch,
+            branchSource: context.branchSource,
+            currentGitBranch: context.currentGitBranch,
+            workingTreeMatched: context.workingTreeMatched,
+            specDir: context.specDir
+        }
+    };
+}
+function renderStageEntryInstructions(payload) {
+    return [
+        renderSddInstructions(payload),
+        '',
+        'Resolved partition:',
+        `- branch=${payload.context.branch}`,
+        `- raw_branch=${payload.context.rawBranch}`,
+        `- source=${payload.context.branchSource}`,
+        `- spec_dir=${payload.context.specDir}`,
+        `- current_git_branch=${payload.context.currentGitBranch ?? 'none'}`,
+        `- working_tree_matched=${payload.context.workingTreeMatched ?? 'unknown'}`
+    ].join('\n');
+}
+function stageEntryUsage(stage) {
+    return `Usage: sdd ${stage} [--branch <branch>] [--json|--compact-json]\n\nThis command prints the generated ${stage}-stage entry contract. Use sdd ${stage} close --branch <branch> after agent-authored Markdown evidence exists.`;
+}
+function closeTargetStage(command, rest) {
+    if (!rest.includes('--target')) {
+        return { valid: true, stage: command };
+    }
+    const target = readOption(rest, '--target');
+    if (!target || target.startsWith('--')) {
+        return { valid: false, reason: '--target requires an internal runtime stage.' };
+    }
+    if (target === command) {
+        return { valid: true, stage: command };
+    }
+    if (command === 'tasks' && target === 'verifies') {
+        return { valid: true, stage: 'verifies' };
+    }
+    if (command === 'test' && target === 'goal-verify') {
+        return { valid: true, stage: 'goal-verify' };
+    }
+    return { valid: false, reason: `Unsupported --target ${target} for sdd ${command} close.` };
+}
+async function reconcileStageClose(projectRoot, stage, decision, runId) {
+    const input = { decision, runId };
+    if (stage === 'spec')
+        return reconcileSpecCollaborationClosure(projectRoot, input);
+    if (stage === 'plan')
+        return reconcilePlanCollaborationClosure(projectRoot, input);
+    if (stage === 'tasks')
+        return reconcileTasksCollaborationClosure(projectRoot, input);
+    if (stage === 'verifies')
+        return reconcileVerifiesCollaborationClosure(projectRoot, input);
+    if (stage === 'test')
+        return reconcileTestCollaborationClosure(projectRoot, input);
+    if (stage === 'goal-verify')
+        return reconcileGoalVerifyCollaborationClosure(projectRoot, input);
+    return reconcileShipCollaborationClosure(projectRoot, input);
+}
+async function lifecycleDecisionForClose(projectRoot, stage, branch) {
+    const model = await parseSddBranch(projectRoot, branch);
+    const evaluated = evaluateLifecycleRiskDecisionForModel(branch, model);
+    const reconciliationReasons = await truthReconciliationCloseReasons(projectRoot, stage, branch);
+    if (reconciliationReasons) {
+        return { decision: truthReconciliationLifecycleDecision(evaluated, stage, reconciliationReasons), reasons: [] };
+    }
+    if (stage === 'spec') {
+        return { decision: evaluated, reasons: [] };
+    }
+    const diagnostic = await inspectLifecycleRiskDecisionForModel(projectRoot, branch, model);
+    const existing = await readLifecycleRiskDecisionProjection(projectRoot, { branch });
+    if (existing && diagnostic.status === 'fresh') {
+        return { decision: existing.payload, reasons: diagnostic.reasons };
+    }
+    const headline = diagnostic.status === 'missing'
+        ? 'Stage-local close requires an active lifecycle decision created by /sdd or /sdd:spec.'
+        : diagnostic.status === 'stale'
+            ? 'Stage-local close requires a refreshed lifecycle decision because the active projection is stale.'
+            : diagnostic.status === 'blocked'
+                ? 'Stage-local close is blocked by the active lifecycle decision.'
+                : 'Stage-local close requires a refreshed lifecycle decision because the active projection is incompatible.';
+    return { decision: null, reasons: uniqueStrings([headline, ...diagnostic.reasons, LIFECYCLE_ENTRY_NEXT_ACTION]) };
+}
+async function truthReconciliationCloseReasons(projectRoot, stage, branch) {
+    const workflow = await resolveWorkflowState(projectRoot, { branch, branchSource: 'cli_option' });
+    const reconciliation = workflow.truthReconciliation;
+    if (!reconciliation || reconciliation.nextIntent.intent !== 'reconcile_truth' || reconciliation.nextIntent.targetRuntimeStage !== stage) {
+        return null;
+    }
+    return reconciliation.reasons;
+}
+function truthReconciliationLifecycleDecision(decision, stage, reasons) {
+    return {
+        ...decision,
+        profile: 'full',
+        requiredStages: allSddStages(),
+        skippedStages: [],
+        blockedStages: [],
+        humanCheckpointRequired: false,
+        approvalPolicy: 'review-required',
+        reasons: uniqueStrings([`Truth reconciliation routes to ${stage} close; stale truth must not block owner-stage reconciliation.`, ...reasons, ...decision.reasons])
+    };
+}
+function allSddStages() {
+    return ['spec', 'plan', 'tasks', 'verifies', 'do', 'test', 'goal-verify', 'ship'];
+}
+function stageClosePayload(stage, result) {
+    const adjudication = result.adjudication;
+    const stageDecision = adjudication.stageDecision ?? { status: 'rejected', health: adjudication.health };
+    const closureRefs = adjudication.closureRefs ?? {};
+    const acceptedRef = acceptedRefForStage(stage, result);
+    return {
+        contract: 'sdd-stage-close-cli-result-v1',
+        stage,
+        runId: result.runId,
+        branch: result.branch,
+        health: adjudication.health,
+        stageDecision: {
+            status: stageDecision.status,
+            health: stageDecision.health
+        },
+        acceptedRef,
+        acceptedHash: acceptedRef?.hash ?? null,
+        registeredArtifactRefs: result.registeredArtifacts.map((artifact) => artifact.ref),
+        registeredCollaborationContracts: result.registeredCollaborationContracts.map((contract) => ({
+            ref: contract.ref,
+            hash: contract.hash,
+            status: contract.status,
+            validationErrors: contract.validationErrors
+        })),
+        handoff: adjudication.handoffPacket ? {
+            fromStage: adjudication.handoffPacket.fromStage,
+            toStage: adjudication.handoffPacket.toStage,
+            status: adjudication.handoffPacket.status,
+            requiredInputRefs: adjudication.handoffPacket.requiredInputRefs ?? []
+        } : null,
+        closureRefs: {
+            artifactRefs: closureRefs.artifactRefs ?? [],
+            collaborationContractRef: closureRefs.collaborationContractRef ?? null,
+            lifecycleRiskProjectionRef: closureRefs.lifecycleRiskProjectionRef ?? null,
+            adjudicationProjectionRef: closureRefs.adjudicationProjectionRef ?? null,
+            stageRunProjectionRef: closureRefs.stageRunProjectionRef ?? null,
+            workflowHandoffProjectionRef: closureRefs.workflowHandoffProjectionRef ?? null,
+            reasons: closureRefs.reasons ?? []
+        }
+    };
+}
+function acceptedRefForStage(stage, result) {
+    if (stage === 'spec')
+        return 'acceptedSpecRef' in result ? result.acceptedSpecRef : null;
+    if (stage === 'plan')
+        return 'acceptedPlanRef' in result ? result.acceptedPlanRef : null;
+    if (stage === 'tasks')
+        return 'acceptedTasksRef' in result ? result.acceptedTasksRef : null;
+    if (stage === 'verifies')
+        return 'acceptedVerifyRef' in result ? result.acceptedVerifyRef : null;
+    if (stage === 'test')
+        return 'acceptedTestEvidenceRef' in result ? result.acceptedTestEvidenceRef : null;
+    if (stage === 'goal-verify')
+        return 'acceptedGoalVerificationRef' in result ? result.acceptedGoalVerificationRef : null;
+    return 'acceptedShipReadinessRef' in result ? result.acceptedShipReadinessRef : null;
+}
+function stageCloseBlockedPayload(stage, branch, reasons) {
+    return {
+        contract: 'sdd-stage-close-cli-result-v1',
+        stage,
+        runId: null,
+        branch,
+        health: 'blocked',
+        stageDecision: {
+            status: 'rejected',
+            health: 'blocked'
+        },
+        acceptedRef: null,
+        acceptedHash: null,
+        registeredArtifactRefs: [],
+        registeredCollaborationContracts: [],
+        handoff: null,
+        closureRefs: {
+            artifactRefs: [],
+            collaborationContractRef: null,
+            lifecycleRiskProjectionRef: null,
+            adjudicationProjectionRef: null,
+            stageRunProjectionRef: null,
+            workflowHandoffProjectionRef: null,
+            reasons
+        }
+    };
+}
+function renderStageClosePayload(payload) {
+    const lines = [
+        `SDD ${payload.stage} close`,
+        `health=${payload.health}`,
+        `stageDecision.status=${payload.stageDecision.status}`,
+        `acceptedRef=${payload.acceptedRef?.ref ?? 'none'}`,
+        `acceptedHash=${payload.acceptedHash ?? 'none'}`,
+        `registeredArtifactRefs=${payload.registeredArtifactRefs.length}`,
+        `registeredCollaborationContracts=${payload.registeredCollaborationContracts.length}`
+    ];
+    if (payload.handoff) {
+        lines.push(`handoff=${payload.handoff.fromStage}->${payload.handoff.toStage}:${payload.handoff.status}`);
+    }
+    if (payload.closureRefs.reasons.length > 0) {
+        lines.push('reasons:');
+        lines.push(...payload.closureRefs.reasons.map((reason) => `- ${reason}`));
+    }
+    return lines.join('\n');
+}
+function renderBlockedStageClosePayload(payload) {
+    return renderStageClosePayload(payload);
+}
+function uniqueStrings(values) {
+    return Array.from(new Set(values.filter((value) => value.length > 0)));
+}
+function stageCloseUsage(stage) {
+    if (stage === 'tasks') {
+        return 'Usage: sdd tasks close [--target verifies] [--branch <branch>] [--run <run_id>] [--json|--compact-json]';
+    }
+    if (stage === 'test') {
+        return 'Usage: sdd test close [--target goal-verify] [--branch <branch>] [--run <run_id>] [--json|--compact-json]';
+    }
+    return `Usage: sdd ${stage} close [--branch <branch>] [--run <run_id>] [--json|--compact-json]`;
+}
+//# sourceMappingURL=stage-close.js.map

package/packages/cli/dist/commands/stage-close.js.map

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

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

@@ -1,6 +1,6 @@
 import { getProjectStatus, getStatuslineProjection } from '@sdd-agent-platform/core/status';
 import { readBranchContext } from '../args.js';
-import { jsonOutput, wantsJson } from '../renderers/json.js';
+import { isCompactJson, jsonOutput, wantsJson } from '../renderers/json.js';
 import { renderProjectStatus, renderStatuslineProjection } from '../renderers/workflow.js';
 export async function handleStatusCommand(projectRoot, command, subcommand, rest) {
     if (command !== 'status' && command !== 'statusline' && command !== 'progress') {
@@ -19,7 +19,73 @@ export async function handleStatusCommand(projectRoot, command, subcommand, rest
     const json = wantsJson(statusArgs);
     return {
         exitCode: 0,
-        output: json ? jsonOutput(result, statusArgs) : renderProjectStatus(result)
+        output: json ? jsonOutput(isCompactJson(statusArgs) ? summarizeProjectStatus(result) : result, statusArgs) : renderProjectStatus(result)
+    };
+}
+function summarizeProjectStatus(status) {
+    return {
+        contract: 'sdd-project-status-summary-v1',
+        branch: status.branch,
+        workflowStatus: status.workflowStatus,
+        nextIntent: status.nextIntent,
+        recommendedNextCommand: status.recommendedNextCommand,
+        context: {
+            rawBranch: status.context.rawBranch,
+            partition: status.context.partition,
+            branchSource: status.context.branchSource,
+            specDir: status.context.specDir,
+            currentGitBranch: status.context.currentGitBranch,
+            workingTreeMatched: status.context.workingTreeMatched
+        },
+        documents: {
+            spec: status.documents.specExists,
+            plan: status.documents.planExists,
+            tasks: status.documents.tasksExists,
+            verify: status.documents.verifyExists,
+            planStale: status.documents.planStale,
+            tasksStale: status.documents.tasksStale,
+            verifyStale: status.documents.verifyStale
+        },
+        tasks: status.tasks,
+        taskRisk: status.taskRisk,
+        latestRun: status.latestRun,
+        latestRunEvidence: status.latestRunEvidence,
+        latestRunStaleReasons: status.latestRunStaleReasons,
+        counts: {
+            latestRunsByTask: status.latestRunsByTask.length,
+            latestEligibleRunsByTask: status.latestEligibleRunsByTask.length,
+            latestEligibleSelected: status.latestEligibleRunsByTask.filter((selection) => selection.selected).length,
+            latestEligibleRejected: status.latestEligibleRunsByTask.reduce((sum, selection) => sum + selection.rejected.length, 0),
+            affectedFileConflicts: status.affectedFileConflicts.length,
+            dependencyBlockers: status.dependencyBlockers.length,
+            gaps: status.gaps.length,
+            durableGaps: status.durableGaps.length
+        },
+        latestEligibleRunsByTask: status.latestEligibleRunsByTask.slice(0, 20).map((selection) => ({
+            taskId: selection.taskId,
+            selected: selection.selected ? {
+                runId: selection.selected.runId,
+                runStatus: selection.selected.runStatus,
+                compatibility: selection.selected.compatibility
+            } : null,
+            candidates: selection.candidates.length,
+            rejected: selection.rejected.length
+        })),
+        affectedFileConflicts: status.affectedFileConflicts.slice(0, 20),
+        dependencyBlockers: status.dependencyBlockers.slice(0, 20),
+        capabilityHealth: status.capabilityHealth,
+        workflowHandoff: status.workflowHandoff,
+        fullStageChain: status.fullStageChain,
+        runtimeProjectionP0: status.runtimeProjectionP0,
+        workflowGateHealth: {
+            decisions: status.workflowGateHealth.decisions,
+            blocked: status.workflowGateHealth.blocked,
+            warnings: status.workflowGateHealth.warnings,
+            humanRequired: status.workflowGateHealth.humanRequired,
+            statusesByKind: status.workflowGateHealth.statusesByKind,
+            evidenceSelection: status.workflowGateHealth.evidenceSelection
+        },
+        truthReconciliation: status.truthReconciliation
     };
 }
 //# sourceMappingURL=status.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAQ3F,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,WAAmB,EAAE,OAA2B,EAAE,UAA8B,EAAE,IAAc;IACxI,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,YAAY,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAC/E,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,IAAI,OAAO,KAAK,YAAY,IAAI,OAAO,KAAK,UAAU,IAAI,UAAU,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;QAC9F,MAAM,UAAU,GAAG,MAAM,uBAAuB,CAAC,WAAW,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC,CAAC;QAC7F,MAAM,IAAI,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;QACnC,OAAO;YACL,QAAQ,EAAE,CAAC;YACX,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,0BAA0B,CAAC,UAAU,CAAC;SAC3F,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,WAAW,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC,CAAC;IAClF,MAAM,IAAI,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IACnC,OAAO;QACL,QAAQ,EAAE,CAAC;QACX,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC;KAC5E,CAAC;AACJ,CAAC"}
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"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"}

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

@@ -1,6 +1,6 @@
 import { readFile } from 'node:fs/promises';
 import path from 'node:path';
-import { renderSddTestResult, renderValidationWaveResult, runSddTest, runValidationWave } from '@sdd-agent-platform/core/verification';
+import { listVerifyValidationUnits, renderSddTestResult, renderValidationWaveResult, runSddTest, runValidationWave } from '@sdd-agent-platform/core/verification';
 import { parseSddBranch } from '@sdd-agent-platform/core/sdd-docs';
 import { readBranchOption, readOptionalPositionalArgument, readResolvedBranch } from '../args.js';
 import { hasHelpFlag, hasPreflightFlag, readOption, readPositiveIntegerOption, readRepeatedOptions } from '../options.js';
@@ -22,6 +22,9 @@ export async function handleTestCommand(projectRoot, command, subcommand, rest)
         return handleTestBatchCommand(projectRoot, rest);
     }
     if (subcommand !== 'task') {
+        if (subcommand && !subcommand.startsWith('--')) {
+            return handleTestValidationUnitCommand(projectRoot, subcommand, rest);
+        }
         return {
             exitCode: 2,
             error: testUsage()
@@ -130,6 +133,178 @@ async function handleTestBatchCommand(projectRoot, rest) {
         output: wantsJson(rest) ? jsonOutput(result, rest) : renderValidationWaveResult(result)
     };
 }
+async function handleTestValidationUnitCommand(projectRoot, validationInput, rest) {
+    const validationInputs = splitCommaSeparatedInputs(validationInput);
+    if (validationInputs.length === 0) {
+        return {
+            exitCode: 2,
+            error: testValidationUnitUsage()
+        };
+    }
+    if (validationInputs.length > 1) {
+        return handleTestValidationUnitBatchCommand(projectRoot, validationInputs, rest);
+    }
+    const binding = await resolveTestValidationUnitBinding(projectRoot, validationInputs[0], rest);
+    const preflight = testValidationUnitPreflight(binding);
+    if (hasPreflightFlag(rest) || binding.blockers.length > 0) {
+        return {
+            exitCode: preflight.status === 'PASS' ? 0 : 1,
+            output: wantsJson(rest) ? jsonOutput(preflight, rest) : renderTestValidationUnitPreflight(preflight)
+        };
+    }
+    const unit = binding.unit;
+    if (!unit) {
+        return {
+            exitCode: 1,
+            output: wantsJson(rest) ? jsonOutput(preflight, rest) : renderTestValidationUnitPreflight(preflight)
+        };
+    }
+    const result = await runValidationWave(projectRoot, {
+        branch: readBranchOption(rest),
+        batchId: unit.validationUnitId,
+        timeoutMs: readPositiveIntegerOption(rest, '--timeout-ms') ?? undefined,
+        approved: rest.includes('--approved')
+    });
+    return {
+        exitCode: result.status === 'PASS' ? 0 : 1,
+        output: wantsJson(rest) ? jsonOutput(result, rest) : renderValidationWaveResult(result)
+    };
+}
+async function handleTestValidationUnitBatchCommand(projectRoot, validationInputs, rest) {
+    const bindings = await Promise.all(validationInputs.map((validationInput) => resolveTestValidationUnitBinding(projectRoot, validationInput, rest)));
+    const blockers = bindings.flatMap((binding) => binding.blockers.map((blocker) => `${binding.requestedTarget}: ${blocker}`));
+    const preflight = testValidationUnitBatchPreflight(validationInputs, bindings, blockers);
+    if (hasPreflightFlag(rest) || blockers.length > 0) {
+        return {
+            exitCode: preflight.status === 'PASS' ? 0 : 1,
+            output: wantsJson(rest) ? jsonOutput(preflight, rest) : renderTestValidationUnitBatchPreflight(preflight)
+        };
+    }
+    const results = [];
+    for (const binding of bindings) {
+        results.push(await runValidationWave(projectRoot, {
+            branch: readBranchOption(rest),
+            batchId: binding.unit?.validationUnitId,
+            timeoutMs: readPositiveIntegerOption(rest, '--timeout-ms') ?? undefined,
+            approved: rest.includes('--approved')
+        }));
+    }
+    const payload = testValidationUnitBatchJsonPayload(validationInputs, bindings, results);
+    return {
+        exitCode: payload.status === 'PASS' ? 0 : 1,
+        output: wantsJson(rest) ? jsonOutput(payload, rest) : results.map(renderValidationWaveResult).join('\n\n---\n\n')
+    };
+}
+function testValidationUnitBatchPreflight(validationInputs, bindings, blockers) {
+    return {
+        contract: 'sdd-command-preflight-v1',
+        command: 'test validation-unit',
+        requestedTargets: validationInputs,
+        validationUnitIds: bindings.map((binding) => binding.validationUnitId),
+        bindings: bindings.flatMap((binding) => binding.source && binding.unit ? [{
+                requestedTarget: binding.requestedTarget,
+                validationUnitId: binding.validationUnitId,
+                source: binding.source,
+                taskIds: binding.unit.taskIds
+            }] : []),
+        sideEffects: 'none',
+        status: blockers.length > 0 ? 'BLOCKED' : 'PASS',
+        blockers
+    };
+}
+function testValidationUnitBatchJsonPayload(validationInputs, bindings, results) {
+    return {
+        contract: 'sdd-test-validation-unit-batch-cli-result-v1',
+        requestedTargets: validationInputs,
+        validationUnitIds: bindings.map((binding) => binding.validationUnitId),
+        status: results.every((result) => result.status === 'PASS') ? 'PASS' : 'FAIL',
+        results
+    };
+}
+function renderTestValidationUnitBatchPreflight(preflight) {
+    const bindings = preflight.bindings.length > 0 ? `\nbindings:\n${preflight.bindings.map((binding) => `- ${binding.source}:${binding.requestedTarget}->${binding.validationUnitId} tasks=${binding.taskIds.join(',')}`).join('\n')}` : '';
+    const blockers = preflight.blockers.length > 0 ? `\nblockers=${preflight.blockers.length}\n${preflight.blockers.map((blocker) => `- ${blocker}`).join('\n')}` : '';
+    return `SDD command preflight ${preflight.status}\ncommand=${preflight.command}\nvalidation_units=${preflight.validationUnitIds.join(',')}${bindings}\nside_effects=${preflight.sideEffects}${blockers}`;
+}
+async function resolveTestValidationUnitBinding(projectRoot, validationInput, args) {
+    const branch = await readResolvedBranch(projectRoot, args);
+    const model = await parseSddBranch(projectRoot, branch);
+    const verifyUnits = await listVerifyValidationUnits(projectRoot, { branch });
+    const verifyBlockers = verifyUnits.verifyContract.status === 'PASS' ? [] : [`verify.md contract is ${verifyUnits.verifyContract.status}; run /sdd:tasks before /sdd:test.`];
+    const taskById = new Map(model.tasks.map((task) => [task.id, task]));
+    const units = verifyUnits.units.map((unit) => ({
+        ...unit,
+        tasks: unit.taskIds.map((taskId) => taskById.get(taskId)).filter((task) => Boolean(task))
+    }));
+    const normalizedInput = normalizeBindingText(validationInput);
+    const byUnitId = units.filter((unit) => normalizeBindingText(unit.validationUnitId) === normalizedInput);
+    if (byUnitId.length === 1) {
+        return boundTestValidationUnit(validationInput, byUnitId[0], 'unit_id', verifyBlockers);
+    }
+    if (byUnitId.length > 1) {
+        return ambiguousTestValidationUnit(validationInput, byUnitId, verifyBlockers);
+    }
+    const byTaskId = units.filter((unit) => unit.taskIds.some((taskId) => normalizeBindingText(taskId) === normalizedInput));
+    if (byTaskId.length === 1) {
+        return boundTestValidationUnit(validationInput, byTaskId[0], 'task_id', verifyBlockers);
+    }
+    if (byTaskId.length > 1) {
+        return ambiguousTestValidationUnit(validationInput, byTaskId, verifyBlockers);
+    }
+    const byTaskTitle = units.filter((unit) => unit.tasks.some((task) => task.title && normalizeBindingText(task.title) === normalizedInput));
+    if (byTaskTitle.length === 1) {
+        return boundTestValidationUnit(validationInput, byTaskTitle[0], 'task_title', verifyBlockers);
+    }
+    if (byTaskTitle.length > 1) {
+        return ambiguousTestValidationUnit(validationInput, byTaskTitle, verifyBlockers);
+    }
+    const partialMatches = units.filter((unit) => validationUnitSearchText(unit).includes(normalizedInput));
+    if (partialMatches.length === 1) {
+        return boundTestValidationUnit(validationInput, partialMatches[0], 'partial', verifyBlockers);
+    }
+    if (partialMatches.length > 1) {
+        return ambiguousTestValidationUnit(validationInput, partialMatches, verifyBlockers);
+    }
+    return { requestedTarget: validationInput, validationUnitId: validationInput, unit: null, source: null, blockers: [...verifyBlockers, `Validation unit ${validationInput} was not found.`] };
+}
+function validationUnitSearchText(unit) {
+    return normalizeBindingText([unit.validationUnitId, ...unit.tasks.flatMap((task) => [task.id, task.title ?? ''])].join(' '));
+}
+function boundTestValidationUnit(requestedTarget, unit, source, blockers = []) {
+    return { requestedTarget, validationUnitId: unit.validationUnitId, unit, source, blockers };
+}
+function ambiguousTestValidationUnit(requestedTarget, units, blockers = []) {
+    return {
+        requestedTarget,
+        validationUnitId: requestedTarget,
+        unit: null,
+        source: null,
+        blockers: [...blockers, `Validation unit ${requestedTarget} is ambiguous: ${units.map((unit) => unit.validationUnitId).join(', ')}.`]
+    };
+}
+function testValidationUnitPreflight(binding) {
+    return {
+        contract: 'sdd-command-preflight-v1',
+        command: 'test validation-unit',
+        requestedTarget: binding.requestedTarget,
+        validationUnitId: binding.validationUnitId,
+        binding: binding.source && binding.unit ? { source: binding.source, taskIds: binding.unit.taskIds } : null,
+        sideEffects: 'none',
+        status: binding.blockers.length > 0 ? 'BLOCKED' : 'PASS',
+        blockers: binding.blockers
+    };
+}
+function splitCommaSeparatedInputs(value) {
+    return [...new Set(value.split(',').map((item) => item.trim()).filter((item) => item.length > 0))];
+}
+function renderTestValidationUnitPreflight(preflight) {
+    const binding = preflight.binding ? `\nbinding=${preflight.binding.source}:${preflight.requestedTarget}->${preflight.validationUnitId}\ntasks=${preflight.binding.taskIds.join(',')}` : '';
+    const blockers = preflight.blockers.length > 0 ? `\nblockers=${preflight.blockers.length}\n${preflight.blockers.map((blocker) => `- ${blocker}`).join('\n')}` : '';
+    return `SDD command preflight ${preflight.status}\ncommand=${preflight.command}\nvalidation_unit=${preflight.validationUnitId}${binding}\nside_effects=${preflight.sideEffects}${blockers}`;
+}
+function normalizeBindingText(value) {
+    return value.trim().replace(/\s+/g, ' ').toLowerCase();
+}
 function hasSingleTaskOverride(cliArgs, passthroughArgv) {
     return Boolean(readOption(cliArgs, '--run')
         || readRepeatedOptions(cliArgs, '--command').length > 0
@@ -181,7 +356,10 @@ function parseCommandInputValue(value) {
     throw new Error('Command JSON object must include command or argv.');
 }
 function testUsage() {
-    return `${testTaskUsage()}\n${testWaveUsage()}\n${testBatchUsage()}`;
+    return `${testValidationUnitUsage()}\n${testTaskUsage()}\n${testWaveUsage()}\n${testBatchUsage()}`;
+}
+function testValidationUnitUsage() {
+    return 'Usage: sdd test <validation_unit_id-or-validation_text>[,<validation_unit_id-or-validation_text>...] [--branch <branch>] [--approved] [--timeout-ms <ms>] [--preflight] [--json]';
 }
 function testTaskUsage() {
     return 'Usage: sdd test task <task_id> [--branch <branch>] [--run <run_id>] [--approved] [--command <command>] [--command-json <json>] [--command-file <path>] [--timeout-ms <ms>] [--preflight] [--json] [-- <executable> [...args]]';