sdd-agent-platform 0.3.0 → 0.4.1

package/packages/cli/dist/dispatch.js

@@ -0,0 +1,121 @@
+import { handleAiToolsCommand } from './commands/ai-tools.js';
+import { handleArtifactCommand } from './commands/artifact.js';
+import { handleContextCommand } from './commands/context.js';
+import { handleDoctorCommand } from './commands/doctor.js';
+import { handleExecutionCommand } from './commands/execution.js';
+import { handleGovernanceCommand } from './commands/governance.js';
+import { handleInitCommand } from './commands/init.js';
+import { handleInstructionsCommand } from './commands/instructions.js';
+import { handleLifecycleCommand } from './commands/lifecycle.js';
+import { handleRegistryCommand } from './commands/registry.js';
+import { handleRunCommand } from './commands/run.js';
+import { handleStatusCommand } from './commands/status.js';
+import { handleShipCommand } from './commands/ship.js';
+import { handleSyncBackCommand } from './commands/sync-back.js';
+import { handleTasksCommand } from './commands/tasks.js';
+import { handleTestCommand } from './commands/test.js';
+import { handleVerifyCommand } from './commands/verify.js';
+import { handleVerifiesCommand } from './commands/verifies.js';
+import { helpText } from './help.js';
+import { getCliIdentity } from './identity.js';
+import { jsonOutput, wantsJson } from './renderers/json.js';
+export async function dispatchCli(args, importMetaUrl = import.meta.url) {
+    const projectRoot = process.cwd();
+    const [command, subcommand, ...rest] = args;
+    if (!command || command === '--help' || command === '-h') {
+        return {
+            exitCode: 0,
+            output: helpText()
+        };
+    }
+    if (command === 'help') {
+        return {
+            exitCode: 0,
+            output: helpText(subcommand)
+        };
+    }
+    if (command === '--version' || command === '-v' || command === 'version') {
+        const identity = getCliIdentity(importMetaUrl);
+        return {
+            exitCode: 0,
+            output: wantsJson(args) ? jsonOutput(identity, args) : identity.version
+        };
+    }
+    const initResult = await handleInitCommand(projectRoot, command, subcommand, rest);
+    if (initResult) {
+        return initResult;
+    }
+    const aiToolsResult = await handleAiToolsCommand(projectRoot, command, subcommand, rest);
+    if (aiToolsResult) {
+        return aiToolsResult;
+    }
+    const instructionsResult = await handleInstructionsCommand(command, subcommand, rest);
+    if (instructionsResult) {
+        return instructionsResult;
+    }
+    const doctorResult = await handleDoctorCommand(projectRoot, command, subcommand, rest);
+    if (doctorResult) {
+        return doctorResult;
+    }
+    const statusResult = await handleStatusCommand(projectRoot, command, subcommand, rest);
+    if (statusResult) {
+        return statusResult;
+    }
+    const runResult = await handleRunCommand(projectRoot, command, subcommand, rest);
+    if (runResult) {
+        return runResult;
+    }
+    const artifactResult = await handleArtifactCommand(projectRoot, command, subcommand, rest);
+    if (artifactResult) {
+        return artifactResult;
+    }
+    const governanceResult = await handleGovernanceCommand(projectRoot, command, subcommand, rest);
+    if (governanceResult) {
+        return governanceResult;
+    }
+    const syncBackResult = await handleSyncBackCommand(projectRoot, command, subcommand, rest);
+    if (syncBackResult) {
+        return syncBackResult;
+    }
+    const shipResult = await handleShipCommand(projectRoot, command, subcommand, rest);
+    if (shipResult) {
+        return shipResult;
+    }
+    const contextResult = await handleContextCommand(projectRoot, command, subcommand, rest);
+    if (contextResult) {
+        return contextResult;
+    }
+    const tasksResult = await handleTasksCommand(projectRoot, command, subcommand, rest);
+    if (tasksResult) {
+        return tasksResult;
+    }
+    const lifecycleResult = await handleLifecycleCommand(projectRoot, command, subcommand, rest);
+    if (lifecycleResult) {
+        return lifecycleResult;
+    }
+    const verifiesResult = await handleVerifiesCommand(projectRoot, command, subcommand, rest);
+    if (verifiesResult) {
+        return verifiesResult;
+    }
+    const testResult = await handleTestCommand(projectRoot, command, subcommand, rest);
+    if (testResult) {
+        return testResult;
+    }
+    const verifyResult = await handleVerifyCommand(projectRoot, command, subcommand, rest);
+    if (verifyResult) {
+        return verifyResult;
+    }
+    const registryResult = await handleRegistryCommand(projectRoot, command, subcommand, rest);
+    if (registryResult) {
+        return registryResult;
+    }
+    const executionResult = await handleExecutionCommand(projectRoot, command, subcommand, rest);
+    if (executionResult) {
+        return executionResult;
+    }
+    return {
+        exitCode: 2,
+        error: `Unknown command: ${args.join(' ')}\n\n${helpText()}`
+    };
+}
+//# sourceMappingURL=dispatch.js.map

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

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

package/packages/cli/dist/help.d.ts

@@ -0,0 +1,4 @@
+export declare function helpText(topic?: string): string;
+export declare function workflowHelpText(): string;
+export declare function advancedHelpText(): string;
+export declare function taskFormatText(): string;

package/packages/cli/dist/help.js

@@ -0,0 +1,177 @@
+export function helpText(topic) {
+    if (topic === 'advanced') {
+        return advancedHelpText();
+    }
+    if (topic === 'workflow') {
+        return workflowHelpText();
+    }
+    return `sdd Phase 2 platform CLI
+
+Common workflow:
+  sdd init [--force] [--ai <mode>] [--scaffold-docs] [--json]
+  sdd status [--branch <branch>] [--json|--compact-json]
+  sdd statusline [--branch <branch>] [--json|--compact-json]
+  sdd tasks inspect <task_id> [--branch <branch>] [--json|--compact-json]
+  sdd tasks route <task_id> [--branch <branch>] [--approved] [--json|--compact-json]
+  sdd do task <task_id> [--approved] [options]
+  sdd test task <task_id> [--branch <branch>] [--run <run_id>] [--command <command>] [--timeout-ms <ms>] [--json|--compact-json]
+  sdd test wave [--branch <branch>] [--wave <n>] [--task <task_id>]... [--approved] [--json|--compact-json]
+  sdd test batch <batch_id> [--branch <branch>] [--approved] [--json|--compact-json]
+  sdd subagents run <task_id> [--agent <agent>]... [--branch <branch>] [--run <run_id>] [--timeout-seconds <n>] [--approved] [--json|--compact-json]
+  sdd ship [--branch <branch>] [--dry-run] [--json|--compact-json]
+  sdd doctor [fast|deep] [--latest-only] [--all-runs] [--json|--compact-json]
+  sdd doctor recover [--branch <branch>] [--json|--compact-json]
+
+Diagnostic / recovery / compatibility:
+  sdd verifies write [--branch <branch>] [--force] [--json|--compact-json]
+  sdd verify task <task_id> [--branch <branch>] [--run <run_id>] [--json|--compact-json]
+  sdd sync-back inspect [<run_id>] [--task <task_id>] [--branch <branch>] [--json|--compact-json]
+  sdd sync-back apply [<run_id>] [--task <task_id>] [--branch <branch>] [--approved] [--json|--compact-json]
+
+Evidence helpers:
+  sdd run create
+  sdd run list [--json]
+  sdd run inspect <run_id> [--json|--compact-json]
+  sdd run index rebuild|inspect|query [options] [--json|--compact-json]
+  sdd artifact template <path> --task <task_id> --agent <agent> [--run <run_id> --write]
+  sdd artifact validate <run_id> <path> [--task <task_id>] [--agent <agent>] [--json|--compact-json]
+  sdd evidence summary <run_id> [--task <task_id>] [--json|--compact-json]
+  sdd context build --task <task_id> --mode do|verify|sync-back|doctor [--agent <agent>] [--branch <branch>] [--profile brief|normal|forensic] [--json|--compact-json]
+
+Generated AI entries:
+  sdd update [--check] [--force] [--ai <mode>]
+  sdd instructions [action] [--json|--compact-json]
+
+More help:
+  sdd help workflow     Show core workflow options.
+  sdd help advanced     Show platform/agent/runtime commands.
+
+Notes:
+  sdd init is project-level setup; workflow partition docs are created/refined by the spec/plan/tasks stages.
+  init --branch is legacy starter-doc scaffolding; prefer sdd status --branch and the current recommended next command for workflow partitions.
+`;
+}
+export function workflowHelpText() {
+    return `sdd workflow help
+
+Core path:
+  1. sdd spec --branch <branch>
+  2. sdd plan --branch <branch>
+  3. sdd tasks --branch <branch>  # owns tasks.md and verify.md contract authoring
+  4. sdd do task <task_id> [--branch <branch>]  # sequential implementation evidence
+  5. sdd test task <task_id> [--branch <branch>]  # strict/task_end or explicit override
+  6. sdd test batch <batch_id> [--branch <branch>]  # batch_end accumulated tasks
+  7. sdd test wave [--branch <branch>] [--wave <n>]  # wave_end or verify-selected wave
+  8. decision card if workflow policy requires human review
+  9. sdd ship --branch <branch> [--dry-run]
+
+Diagnostic/recovery only:
+  sdd verifies write --branch <branch> [--force]
+  sdd verify task <task_id> [--branch <branch>] [--run <run_id>]
+  sdd sync-back inspect|apply [<run_id>] --task <task_id> [--branch <branch>]
+
+JSON:
+  --json prints readable JSON; --compact-json prints one-line JSON for logs and scripts.
+`;
+}
+export function advancedHelpText() {
+    return `sdd advanced help
+
+Runtime/catalog:
+  sdd agent-runtime inspect|validate [--json]
+  sdd agent-capabilities list|validate [--json]
+  sdd command-team inspect|validate|decide [--json]
+  sdd skill-capabilities list|inspect [--json]
+  sdd capability-sources list|inspect [--json]
+  sdd external-packs inspect <source_id> [--json]
+  sdd team-mode inspect [--task <id>] [--team-mode [auto|force|off]] [--no-team-mode] [--json]
+  sdd progress [--branch <branch>] [--json|--compact-json]
+
+Harness/platform:
+  sdd workflow list|inspect|validate [--json]
+  sdd agents list|inspect|validate [--json]
+  sdd query-status inspect|validate [--json]
+  sdd eval inspect|validate [--json]
+  sdd learning inspect|validate [--json]
+  sdd context-pack inspect|validate [--json]
+  sdd capabilities list|inspect [--json]
+  sdd governance inspect|evaluate [options]
+  sdd plugins list|inspect [--json]
+  sdd queue list|inspect [options]
+  sdd state-machine inspect [--json]
+  sdd workers list|inspect [--json]
+
+Execution/isolation:
+  sdd background run|inspect [options]
+  sdd subagents run <task_id> [--agent <agent>]... [--branch <branch>] [--json|--compact-json]
+  sdd worker-runtime claim|heartbeat|status|inspect [options]
+  sdd isolation inspect <task_id> [options]
+  sdd graph inspect [--branch <branch>] [--json]
+  sdd wave inspect|run|executor [options]
+  sdd worktree create|inspect|keep|remove [options]
+
+Foreground subagents:
+  Runs synchronously and collects non-authoritative evidence artifacts only; it does not approve, sync-back, or ship.
+
+Legacy init partition option:
+  sdd init --branch <branch> creates starter docs for that branch, but normal workflow partitioning belongs to sdd status --branch plus the spec/plan/tasks stages.
+`;
+}
+export function taskFormatText() {
+    return `# Canonical sdd-task format
+
+\`\`\`sdd-task
+id: T1
+status: pending
+wave: 1
+depends_on: []
+acceptance_refs:
+  - AC-1
+plan_refs:
+  - "§4 Target Design Overview"
+affected_files:
+  - path/to/file
+change_surface: frontend_only | backend_only | full_stack | docs_only | config_only | unknown
+implementation_wave: wave-1
+validation_batch: validation-batch-1
+validation_timing: task_end | batch_end | wave_end
+requires_verify_before_next: true | false
+validation:
+  - command string
+risk:
+  - state-machine
+agent_fit:
+  - scout
+  - implementer
+  - reviewer
+  - validator
+verification_availability:
+  - unit:command string
+  - build:command string
+autonomy: full_sdd_with_checkpoint
+allowed_agents:
+  - scout
+  - implementer
+  - reviewer
+  - validator
+required_artifacts:
+  - artifacts/review-T1.md
+  - artifacts/validation-T1.md
+\`\`\`
+
+Put contract metadata inside the fenced block: acceptance_refs, plan_refs, affected_files, change_surface, implementation_wave, validation_batch, validation_timing, requires_verify_before_next, agent_fit, verification_availability, autonomy, allowed_agents, and required_artifacts. Companion sections such as #### Boundary, #### Acceptance, and #### Implementation Notes must stay outside the fenced sdd-task metadata block. Frontend-only tasks must not declare Maven/Gradle backend build validation; batch_end and wave_end validation require validation_batch.
+
+#### Boundary
+
+Allowed implementation scope. Explicitly list forbidden scope when relevant.
+
+#### Acceptance
+
+- Verifiable acceptance item.
+
+#### Implementation Notes
+
+Reserved for explicit diagnostic/recovery sync-back notes and artifact links.
+`;
+}
+//# sourceMappingURL=help.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;QACzB,OAAO,gBAAgB,EAAE,CAAC;IAC5B,CAAC;IACD,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;QACzB,OAAO,gBAAgB,EAAE,CAAC;IAC5B,CAAC;IACD,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4CR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO;;;;;;;;;;;;;;;;;;;;CAoBR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsDR,CAAC;AACF,CAAC"}

package/packages/cli/dist/identity.d.ts

@@ -0,0 +1,7 @@
+export interface CliIdentity {
+    version: string;
+    cliEntryPath: string;
+    packageRoot: string | null;
+    packageJsonPath: string | null;
+}
+export declare function getCliIdentity(importMetaUrl: string): CliIdentity;

package/packages/cli/dist/identity.js

@@ -0,0 +1,51 @@
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { SDD_VERSION } from '@sdd-agent-platform/core/ai-tools';
+export function getCliIdentity(importMetaUrl) {
+    const cliEntryPath = fileURLToPath(importMetaUrl);
+    const packageRoot = findPackageRoot(path.dirname(cliEntryPath));
+    const packageJsonPath = packageRoot ? path.join(packageRoot, 'package.json') : null;
+    return {
+        version: readPackageVersion(packageJsonPath) ?? SDD_VERSION,
+        cliEntryPath,
+        packageRoot,
+        packageJsonPath
+    };
+}
+function findPackageRoot(startDir) {
+    let current = startDir;
+    while (true) {
+        const packageJsonPath = path.join(current, 'package.json');
+        if (existsSync(packageJsonPath) && isCliPackageRoot(packageJsonPath)) {
+            return current;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            return null;
+        }
+        current = parent;
+    }
+}
+function isCliPackageRoot(packageJsonPath) {
+    try {
+        const parsed = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+        return parsed.name === '@sdd-agent-platform/cli' || parsed.name === 'sdd-agent-platform';
+    }
+    catch {
+        return false;
+    }
+}
+function readPackageVersion(packageJsonPath) {
+    if (!packageJsonPath) {
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+        return typeof parsed.version === 'string' ? parsed.version : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=identity.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAShE,MAAM,UAAU,cAAc,CAAC,aAAqB;IAClD,MAAM,YAAY,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;IAChE,MAAM,eAAe,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACpF,OAAO;QACL,OAAO,EAAE,kBAAkB,CAAC,eAAe,CAAC,IAAI,WAAW;QAC3D,YAAY;QACZ,WAAW;QACX,eAAe;KAChB,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,QAAgB;IACvC,IAAI,OAAO,GAAG,QAAQ,CAAC;IACvB,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAC3D,IAAI,UAAU,CAAC,eAAe,CAAC,IAAI,gBAAgB,CAAC,eAAe,CAAC,EAAE,CAAC;YACrE,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,eAAuB;IAC/C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAuB,CAAC;QACvF,OAAO,MAAM,CAAC,IAAI,KAAK,yBAAyB,IAAI,MAAM,CAAC,IAAI,KAAK,oBAAoB,CAAC;IAC3F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,eAA8B;IACxD,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAA0B,CAAC;QAC1F,OAAO,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/packages/cli/dist/main.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import { dispatchCli } from './dispatch.js';
+dispatchCli(process.argv.slice(2), import.meta.url)
+    .then((result) => {
+    if (result.output) {
+        console.log(result.output);
+    }
+    if (result.error) {
+        console.error(result.error);
+    }
+    process.exitCode = result.exitCode;
+})
+    .catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+});
+//# sourceMappingURL=main.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;KAChD,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;IACf,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;AACrC,CAAC,CAAC;KACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACxB,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/{dist/packages/cli/src → packages/cli/dist}/options.d.ts

@@ -2,3 +2,5 @@ export declare function readOption(args: string[], name: string): string | null;
 export declare function readPositiveIntegerOption(args: string[], name: string): number | null;
 export declare function readRepeatedOption(args: string[], name: string): string[];
 export declare function readRepeatedOptions(args: string[], name: string): string[];
+export declare function hasHelpFlag(args: string[]): boolean;
+export declare function hasPreflightFlag(args: string[]): boolean;

package/{dist/packages/cli/src → packages/cli/dist}/options.js

@@ -32,4 +32,10 @@ export function readRepeatedOptions(args, name) {
     }
     return values;
 }
+export function hasHelpFlag(args) {
+    return args.includes('--help') || args.includes('-h');
+}
+export function hasPreflightFlag(args) {
+    return args.includes('--preflight');
+}
 //# sourceMappingURL=options.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,CAAC,IAAc,EAAE,IAAY;IACrD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,IAAc,EAAE,IAAY;IACpE,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAc,EAAE,IAAY;IAC7D,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;YAC5C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAc,EAAE,IAAY;IAC9D,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;YAC5C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;YAC7B,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAc;IACxC,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAc;IAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;AACtC,CAAC"}

package/packages/cli/dist/renderers/artifacts.d.ts

@@ -0,0 +1,5 @@
+import type { ArtifactResultIngestionInspection, ArtifactResultIngestionResult } from '@sdd-agent-platform/core/artifacts';
+import type { validateSddResultArtifact } from '@sdd-agent-platform/core/artifacts';
+export declare function renderArtifactIngestionResult(result: ArtifactResultIngestionResult): string;
+export declare function renderArtifactIngestionInspection(inspection: ArtifactResultIngestionInspection): string;
+export declare function renderArtifactValidationReport(artifactPath: string, report: Awaited<ReturnType<typeof validateSddResultArtifact>>, expectedTask?: string, expectedAgent?: string): string;

package/packages/cli/dist/renderers/artifacts.js

@@ -0,0 +1,43 @@
+import { renderIssues } from './issues.js';
+export function renderArtifactIngestionResult(result) {
+    const lines = [`Artifact ingestion ${result.record.status}: ${result.record.artifactPath}`];
+    lines.push(`delegation=${result.record.delegationId} duplicate=${result.duplicate} result=${result.record.resultStatus ?? 'n/a'} terminal=${result.record.delegationStatus ?? 'n/a'}`);
+    if (result.record.issues.length > 0) {
+        lines.push('issues');
+        for (const issue of result.record.issues) {
+            lines.push(`- ${issue.field}: ${issue.message}`);
+            lines.push(`  recommendation: ${issue.recommendation}`);
+        }
+    }
+    if (result.record.gaps.length > 0) {
+        lines.push('gaps');
+        for (const gap of result.record.gaps) {
+            lines.push(`- [${gap.severity}] ${gap.type} ${gap.field}: ${gap.message}`);
+        }
+    }
+    return lines.join('\n');
+}
+export function renderArtifactIngestionInspection(inspection) {
+    const lines = [`Artifact ingestions ${inspection.valid ? 'valid' : 'invalid'} for ${inspection.runId}`];
+    lines.push(`records=${inspection.records.length}`);
+    for (const record of inspection.records) {
+        lines.push(`- ${record.delegationId} ${record.status} artifact=${record.artifactPath} result=${record.resultStatus ?? 'n/a'} delegation=${record.delegationStatus ?? 'n/a'}`);
+    }
+    renderIssues(lines, inspection.issues);
+    return lines.join('\n');
+}
+export function renderArtifactValidationReport(artifactPath, report, expectedTask, expectedAgent) {
+    if (report.valid) {
+        return `Artifact valid: ${artifactPath}`;
+    }
+    const lines = [`Artifact invalid: ${artifactPath}`];
+    for (const issue of report.issues) {
+        lines.push(`- ${issue.field}: ${issue.message}`);
+        lines.push(`  recommendation: ${issue.recommendation}`);
+    }
+    if (expectedTask && expectedAgent) {
+        lines.push(`next sdd artifact template ${artifactPath} --task ${expectedTask} --agent ${expectedAgent} --run <run_id> --write`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=artifacts.js.map

package/packages/cli/dist/renderers/artifacts.js.map

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

package/packages/cli/dist/renderers/context.d.ts

@@ -0,0 +1,4 @@
+import type { ContextBuildPackage } from '@sdd-agent-platform/core/context';
+import type { EvidenceSummaryProjection } from '@sdd-agent-platform/core/context';
+export declare function renderEvidenceSummaryProjection(summary: EvidenceSummaryProjection): string;
+export declare function renderContextBuildPackage(contextPackage: ContextBuildPackage): string;

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

@@ -0,0 +1,47 @@
+export function renderEvidenceSummaryProjection(summary) {
+    const lines = [`Evidence summary ${summary.runId}`];
+    lines.push(`task=${summary.taskId ?? 'none'} authoritative=${summary.authoritative} usable_for_pass=${summary.usableForPass}`);
+    lines.push(`pass=${summary.passCount} blocked=${summary.blockedCount} fail=${summary.failCount} issues=${summary.issueCodes.join(',') || 'none'}`);
+    lines.push('highlights');
+    for (const highlight of summary.highlights.slice(0, 8)) {
+        lines.push(`- ${highlight}`);
+    }
+    lines.push('sources');
+    for (const source of summary.sources.slice(0, 12)) {
+        lines.push(`- ${source.kind}:${source.path} hash=${source.hash.slice(0, 12)}`);
+    }
+    if (summary.sources.length > 12) {
+        lines.push(`- omitted_sources=${summary.sources.length - 12}`);
+    }
+    return lines.join('\n');
+}
+export function renderContextBuildPackage(contextPackage) {
+    const lines = [`Context package ${contextPackage.taskId}`];
+    lines.push(`mode=${contextPackage.mode} agent=${contextPackage.agent ?? 'none'} profile=${contextPackage.profile} branch=${contextPackage.branch}`);
+    lines.push(`authoritative=${contextPackage.authoritative} usable_for_pass=${contextPackage.usableForPass}`);
+    lines.push(`budget=${contextPackage.budget.estimatedBytes}/${contextPackage.budget.maxBytes} bytes estimated_tokens=${contextPackage.budget.estimatedTokens} included=${contextPackage.budget.includedRefs.length} deferred=${contextPackage.budget.deferredRefs.length} excluded=${contextPackage.budget.excludedRefs.length} truncated=${contextPackage.budget.truncatedSummaries.length}`);
+    renderContextRefs(lines, 'must_read', contextPackage.mustRead, 10);
+    renderContextRefs(lines, 'optional_read', contextPackage.optionalRead, 8);
+    renderContextRefs(lines, 'deferred', contextPackage.doNotReadUnlessNeeded, 6);
+    lines.push('next_commands');
+    for (const command of contextPackage.nextCommands) {
+        lines.push(`- ${command}`);
+    }
+    if (contextPackage.warnings.length > 0) {
+        lines.push('warnings');
+        for (const warning of contextPackage.warnings.slice(0, 6)) {
+            lines.push(`- ${warning}`);
+        }
+    }
+    return lines.join('\n');
+}
+function renderContextRefs(lines, label, refs, limit) {
+    lines.push(label);
+    for (const ref of refs.slice(0, limit)) {
+        lines.push(`- ${ref.kind}:${ref.path} hash=${ref.hash.slice(0, 12)}`);
+    }
+    if (refs.length > limit) {
+        lines.push(`- omitted_${label}=${refs.length - limit}`);
+    }
+}
+//# sourceMappingURL=context.js.map

package/packages/cli/dist/renderers/context.js.map

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

package/packages/cli/dist/renderers/doctor.d.ts

@@ -0,0 +1,5 @@
+import type { DoctorReport } from '@sdd-agent-platform/core/doctor';
+export declare function renderDoctorReport(report: DoctorReport, options?: {
+    mode?: 'fast' | 'deep';
+    recover?: boolean;
+}): string;

package/packages/cli/dist/renderers/doctor.js

@@ -0,0 +1,31 @@
+export function renderDoctorReport(report, options = {}) {
+    const failures = report.checks.filter((check) => check.level === 'FAIL');
+    const warnings = report.checks.filter((check) => check.level === 'WARN');
+    const primary = failures[0] ?? warnings[0] ?? null;
+    const lines = ['SDD doctor'];
+    lines.push('');
+    lines.push(report.status === 'PASS' ? 'Project diagnostics passed.' : report.status === 'WARN' ? 'Project diagnostics passed with warnings.' : 'Project diagnostics failed.');
+    lines.push('');
+    lines.push('Why:');
+    lines.push(`- ${primary?.message ?? `All ${report.checks.length} diagnostic checks passed.`}`);
+    lines.push('');
+    lines.push('Next:');
+    lines.push(`- ${doctorNextActions(failures, warnings, options)[0]}`);
+    return lines.join('\n');
+}
+function doctorNextActions(failures, warnings, options) {
+    const primary = failures[0]?.action ?? warnings[0]?.action;
+    if (options.recover) {
+        return [
+            primary ?? 'sdd status',
+            'sdd run index rebuild',
+            'sdd sync-back inspect --task <task_id> --branch <branch>',
+            'sdd doctor fast --branch <branch>'
+        ].filter((item, index, items) => items.indexOf(item) === index);
+    }
+    if (primary) {
+        return [primary, 'Use sdd doctor recover for deterministic repair/reconcile guidance.'];
+    }
+    return [options.mode === 'deep' ? 'sdd status' : 'sdd doctor deep --branch <branch>'];
+}
+//# sourceMappingURL=doctor.js.map

package/packages/cli/dist/renderers/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/renderers/doctor.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB,CAAC,MAAoB,EAAE,UAAyD,EAAE;IAClH,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC;IACzE,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC;IACzE,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IACnD,MAAM,KAAK,GAAG,CAAC,YAAY,CAAC,CAAC;IAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,2CAA2C,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC;IAC9K,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnB,KAAK,CAAC,IAAI,CAAC,KAAK,OAAO,EAAE,OAAO,IAAI,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,4BAA4B,EAAE,CAAC,CAAC;IAC/F,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpB,KAAK,CAAC,IAAI,CAAC,KAAK,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACrE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAgC,EAAE,QAAgC,EAAE,OAAsD;IACnJ,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IAC3D,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,OAAO,IAAI,YAAY;YACvB,uBAAuB;YACvB,0DAA0D;YAC1D,mCAAmC;SACpC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,OAAO,EAAE,qEAAqE,CAAC,CAAC;IAC1F,CAAC;IACD,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC;AACxF,CAAC"}

package/packages/cli/dist/renderers/execution.d.ts

@@ -0,0 +1,13 @@
+import type { BackgroundExecutorInspection, BackgroundExecutorResult } from '@sdd-agent-platform/core/execution';
+import type { ForegroundSubagentRunResult } from '@sdd-agent-platform/core/execution';
+import type { ResidentWorkerRuntimeClaimResult, ResidentWorkerRuntimeHeartbeatResult, ResidentWorkerRuntimeInspection, ResidentWorkerRuntimeList } from '@sdd-agent-platform/core/execution';
+import type { WaveExecutorInspection, WaveExecutorResult } from '@sdd-agent-platform/core/execution';
+export declare function renderBackgroundExecutorResult(result: BackgroundExecutorResult): string;
+export declare function renderForegroundSubagentRunResult(result: ForegroundSubagentRunResult): string;
+export declare function renderBackgroundExecutorInspection(inspection: BackgroundExecutorInspection): string;
+export declare function renderResidentWorkerRuntimeClaimResult(result: ResidentWorkerRuntimeClaimResult): string;
+export declare function renderResidentWorkerRuntimeHeartbeatResult(result: ResidentWorkerRuntimeHeartbeatResult): string;
+export declare function renderResidentWorkerRuntimeList(result: ResidentWorkerRuntimeList): string;
+export declare function renderResidentWorkerRuntimeInspection(inspection: ResidentWorkerRuntimeInspection): string;
+export declare function renderWaveExecutorResult(result: WaveExecutorResult): string;
+export declare function renderWaveExecutorInspection(inspection: WaveExecutorInspection): string;