sdd-agent-platform 0.3.0 → 0.4.0

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

@@ -0,0 +1,187 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { doctor } from '../doctor/doctor.js';
+import { getProjectStatus } from '../status/project-status.js';
+export async function runShip(projectRoot, options = {}) {
+    const checkedAt = new Date().toISOString();
+    const projectStatus = await getProjectStatus(projectRoot, { branch: options.branch ?? undefined, branchSource: options.branch ? 'cli_option' : undefined });
+    const doctorReport = await doctor(projectRoot, { latestOnly: true, branch: projectStatus.branch });
+    const checks = buildShipChecks(projectStatus, doctorReport);
+    const blocked = checks.some((check) => check.status === 'BLOCKED');
+    const status = blocked ? 'BLOCKED' : 'PASS';
+    const releasePath = path.join(projectStatus.context.specDir, 'release.md');
+    const nextActions = shipNextActions(projectStatus.branch, checks);
+    const releaseDocument = renderReleaseDocument({ checkedAt, projectStatus, doctorReport, checks, nextActions, status });
+    const dryRun = options.dryRun === true;
+    if (!dryRun) {
+        const absoluteReleasePath = path.join(projectRoot, releasePath);
+        await mkdir(path.dirname(absoluteReleasePath), { recursive: true });
+        await writeFile(absoluteReleasePath, releaseDocument, 'utf8');
+    }
+    return {
+        contract: 'sdd-ship-readiness-v1',
+        branch: projectStatus.branch,
+        status,
+        dryRun,
+        releasePath,
+        wroteRelease: !dryRun,
+        checkedAt,
+        checks,
+        nextActions,
+        projectStatus: {
+            workflowStatus: projectStatus.workflowStatus,
+            tasks: projectStatus.tasks,
+            taskRisk: projectStatus.taskRisk,
+            latestRun: projectStatus.latestRun,
+            latestRunEvidence: projectStatus.latestRunEvidence,
+            staleReasons: projectStatus.latestRunStaleReasons,
+            affectedFileConflicts: projectStatus.affectedFileConflicts.length,
+            dependencyBlockers: projectStatus.dependencyBlockers.length,
+            tokenProjection: projectStatus.tokenProjection,
+            lifecycleRisk: projectStatus.lifecycleRisk,
+        },
+        doctor: summarizeDoctor(doctorReport),
+        releaseDocument
+    };
+}
+function buildShipChecks(projectStatus, doctorReport) {
+    const checks = [];
+    checks.push({
+        name: 'documents',
+        status: projectStatus.documents.specExists && projectStatus.documents.planExists && projectStatus.documents.tasksExists && projectStatus.documents.verifyExists ? 'PASS' : 'BLOCKED',
+        message: `spec=${projectStatus.documents.specExists} plan=${projectStatus.documents.planExists} tasks=${projectStatus.documents.tasksExists} verify=${projectStatus.documents.verifyExists}`,
+        nextAction: 'sdd init --branch <branch> --scaffold-docs'
+    });
+    checks.push({
+        name: 'workflow_gaps',
+        status: projectStatus.gaps.some((gap) => gap.severity === 'blocking') ? 'BLOCKED' : 'PASS',
+        message: `blocking_gaps=${projectStatus.gaps.filter((gap) => gap.severity === 'blocking').length} total_gaps=${projectStatus.gaps.length}`,
+        nextAction: `sdd tasks list --branch ${projectStatus.branch}`
+    });
+    checks.push({
+        name: 'dependency_blockers',
+        status: projectStatus.dependencyBlockers.length === 0 ? 'PASS' : 'BLOCKED',
+        message: `dependency_blockers=${projectStatus.dependencyBlockers.length}`,
+        nextAction: projectStatus.dependencyBlockers[0] ? `sdd tasks inspect ${projectStatus.dependencyBlockers[0].dependencyId} --branch ${projectStatus.branch}` : undefined
+    });
+    checks.push({
+        name: 'doctor_fast',
+        status: doctorReport.status === 'PASS' ? 'PASS' : 'BLOCKED',
+        message: `doctor_status=${doctorReport.status}`,
+        nextAction: `sdd doctor fast --branch ${projectStatus.branch}`
+    });
+    checks.push({
+        name: 'latest_run',
+        status: latestRunReady(projectStatus) ? 'PASS' : 'BLOCKED',
+        message: projectStatus.latestRun
+            ? `run=${projectStatus.latestRun.runId} status=${projectStatus.latestRun.status} validation=${projectStatus.latestRun.validationStatus} sync_back=${projectStatus.latestRun.syncBackStatus}`
+            : 'run=none',
+        nextAction: projectStatus.latestRun ? `sdd run inspect ${projectStatus.latestRun.runId}` : `sdd do task <task_id> --branch ${projectStatus.branch}`
+    });
+    checks.push({
+        name: 'evidence_health',
+        status: projectStatus.latestRunStaleReasons.length === 0 && projectStatus.affectedFileConflicts.length === 0 ? 'PASS' : 'BLOCKED',
+        message: `stale_reasons=${projectStatus.latestRunStaleReasons.length} affected_file_conflicts=${projectStatus.affectedFileConflicts.length}`,
+        nextAction: `sdd status --branch ${projectStatus.branch}`
+    });
+    checks.push({
+        name: 'token_health',
+        status: 'PASS',
+        message: `token_health=${projectStatus.tokenProjection.health} estimated_tokens=${projectStatus.tokenProjection.estimatedTokens ?? 'unknown'} context_packages=${projectStatus.tokenProjection.contextPackages} team_runtime_decisions=${projectStatus.tokenProjection.teamRuntimeDecisions}`,
+        nextAction: `sdd statusline --branch ${projectStatus.branch} --json`
+    });
+    checks.push({
+        name: 'lifecycle_risk_decision',
+        status: lifecycleRiskReady(projectStatus) ? 'PASS' : 'BLOCKED',
+        message: `enforced status=${projectStatus.lifecycleRisk.status} profile=${projectStatus.lifecycleRisk.profile ?? 'none'} approval=${projectStatus.lifecycleRisk.approvalPolicy ?? 'none'}`,
+        nextAction: lifecycleRiskReady(projectStatus) ? undefined : `Resolve lifecycle risk gate for ${projectStatus.lifecycleRisk.scopeKey} before ship.`
+    });
+    checks.push({
+        name: 'workflow_handoff',
+        status: workflowHandoffReady(projectStatus) ? 'PASS' : 'BLOCKED',
+        message: `status=${projectStatus.workflowHandoff.status} latest=${projectStatus.workflowHandoff.latestHandoff ? `${projectStatus.workflowHandoff.latestHandoff.fromStage}->${projectStatus.workflowHandoff.latestHandoff.toStage}:${projectStatus.workflowHandoff.latestHandoff.status}` : 'none'}`,
+        nextAction: workflowHandoffReady(projectStatus) ? undefined : `Resolve workflow handoff state before ship for ${projectStatus.branch}.`
+    });
+    checks.push({
+        name: 'context_offload',
+        status: projectStatus.contextRuntime.action === 'block-for-curation' ? 'BLOCKED' : 'PASS',
+        message: `level=${projectStatus.contextRuntime.level} action=${projectStatus.contextRuntime.action}`,
+        nextAction: projectStatus.contextRuntime.action === 'block-for-curation' ? `Curate context before ship for ${projectStatus.branch}.` : undefined
+    });
+    checks.push({
+        name: 'subagent_dispatches',
+        status: subagentDispatchesReady(projectStatus) ? 'PASS' : 'BLOCKED',
+        message: `status=${projectStatus.subagentDispatches.status} blocking_open=${projectStatus.subagentDispatches.blockingOpen} failed=${projectStatus.subagentDispatches.failed} archived=${projectStatus.subagentDispatches.archived} superseded=${projectStatus.subagentDispatches.superseded}`,
+        nextAction: subagentDispatchesReady(projectStatus) ? undefined : projectStatus.subagentDispatches.reasons.join(' ')
+    });
+    return checks;
+}
+function latestRunReady(projectStatus) {
+    if (!projectStatus.latestRun) {
+        return false;
+    }
+    return projectStatus.latestRun.status === 'completed'
+        && projectStatus.latestRun.validationStatus === 'pass'
+        && projectStatus.latestRun.syncBackStatus === 'applied';
+}
+function lifecycleRiskReady(projectStatus) {
+    return projectStatus.lifecycleRisk.status === 'fresh'
+        && projectStatus.lifecycleRisk.approvalPolicy !== 'blocked'
+        && projectStatus.lifecycleRisk.approvalPolicy !== 'human-required';
+}
+function workflowHandoffReady(projectStatus) {
+    return projectStatus.workflowHandoff.status === 'fresh' || projectStatus.workflowHandoff.status === 'missing';
+}
+function subagentDispatchesReady(projectStatus) {
+    return projectStatus.subagentDispatches.status === 'fresh' || projectStatus.subagentDispatches.status === 'missing';
+}
+function summarizeDoctor(report) {
+    return {
+        status: report.status,
+        pass: report.checks.filter((check) => check.level === 'PASS').length,
+        warn: report.checks.filter((check) => check.level === 'WARN').length,
+        fail: report.checks.filter((check) => check.level === 'FAIL').length
+    };
+}
+function shipNextActions(branch, checks) {
+    const blocked = checks.filter((check) => check.status === 'BLOCKED');
+    if (blocked.length === 0) {
+        return [`Review specs/${branch}/release.md`, 'Do not publish, push, tag, or deploy without explicit separate approval.'];
+    }
+    return blocked.map((check) => check.nextAction ?? `Resolve ${check.name}`).filter((item, index, items) => items.indexOf(item) === index);
+}
+function renderReleaseDocument(input) {
+    const latestRun = input.projectStatus.latestRun;
+    const evidence = input.projectStatus.latestRunEvidence;
+    return [
+        `# Release — ${input.projectStatus.branch}`,
+        '',
+        '## Readiness',
+        '',
+        `- status: ${input.status}`,
+        `- checked_at: ${input.checkedAt}`,
+        '- boundary: local readiness and release summary only; no publish, push, tag, deploy, or external release state is performed.',
+        '',
+        '## Checks',
+        '',
+        ...input.checks.map((check) => `- ${check.status} ${check.name}: ${check.message}`),
+        '',
+        '## Workflow summary',
+        '',
+        `- workflow_status: ${input.projectStatus.workflowStatus}`,
+        `- tasks: total=${input.projectStatus.tasks.total} pending=${input.projectStatus.tasks.pending} in_progress=${input.projectStatus.tasks.inProgress} completed=${input.projectStatus.tasks.completed} blocked=${input.projectStatus.tasks.blocked} gaps=${input.projectStatus.tasks.gaps}`,
+        `- dependency_blockers: ${input.projectStatus.dependencyBlockers.map((blocker) => `${blocker.taskId}->${blocker.dependencyId}`).join(',') || 'none'}`,
+        `- task_risk: high=${input.projectStatus.taskRisk.highRiskTasks.join(',') || 'none'} medium=${input.projectStatus.taskRisk.mediumRiskTasks.join(',') || 'none'} source_boundary=${input.projectStatus.taskRisk.sourceBoundaryTasks.join(',') || 'none'} context=${input.projectStatus.taskRisk.contextRiskTasks.join(',') || 'none'} token=${input.projectStatus.taskRisk.tokenRiskTasks.join(',') || 'none'} performance=${input.projectStatus.taskRisk.performanceRiskTasks.join(',') || 'none'}`,
+        latestRun ? `- latest_run: ${latestRun.runId} status=${latestRun.status} validation=${latestRun.validationStatus} sync_back=${latestRun.syncBackStatus}` : '- latest_run: none',
+        evidence ? `- latest_run_evidence: route_preflight=${evidence.routePreflight} agent_executions=${evidence.agentExecutions} team_sessions=${evidence.teamSessions} worker_runtimes=${evidence.workerRuntimes} stale_worker_runtimes=${evidence.staleWorkerRuntimes} artifact_ingestions=${evidence.artifactIngestions}` : '- latest_run_evidence: none',
+        `- token_health: ${input.projectStatus.tokenProjection.health} estimated_tokens=${input.projectStatus.tokenProjection.estimatedTokens ?? 'unknown'} context_packages=${input.projectStatus.tokenProjection.contextPackages} team_runtime_decisions=${input.projectStatus.tokenProjection.teamRuntimeDecisions}`,
+        `- lifecycle_risk: status=${input.projectStatus.lifecycleRisk.status} profile=${input.projectStatus.lifecycleRisk.profile ?? 'none'} approval=${input.projectStatus.lifecycleRisk.approvalPolicy ?? 'none'} input=${input.projectStatus.lifecycleRisk.inputHash ?? 'none'} expected=${input.projectStatus.lifecycleRisk.expectedInputHash}`,
+        `- doctor_fast: status=${input.doctorReport.status} checks=${input.doctorReport.checks.length}`,
+        '',
+        '## Next actions',
+        '',
+        ...input.nextActions.map((action) => `- ${action}`),
+        ''
+    ].join('\n');
+}
+//# sourceMappingURL=ship.js.map

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

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

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

@@ -0,0 +1,4 @@
+export * from './lifecycle/decision-gate.js';
+export * from './lifecycle/rendering.js';
+export * from './lifecycle/risk-signals.js';
+export * from './lifecycle/ship.js';

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

@@ -0,0 +1,5 @@
+export * from './lifecycle/decision-gate.js';
+export * from './lifecycle/rendering.js';
+export * from './lifecycle/risk-signals.js';
+export * from './lifecycle/ship.js';
+//# sourceMappingURL=lifecycle.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC"}

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

@@ -0,0 +1,45 @@
+import type { RuntimeRef, RuntimeScope, SddStage } from '../contracts.js';
+import type { ContextLoadSignal, ContextOffloadDecision } from '../context-offload/contracts.js';
+import type { LifecycleRiskDecision } from '../risk/contracts.js';
+import type { StageRun, WorkflowHandoff } from '../stage-runtime/contracts.js';
+import type { SubagentDispatch, SubagentResult } from '../subagents/contracts.js';
+import type { WorkUnit } from '../work-units/contracts.js';
+export type OrchestrationGateStatus = 'PASS' | 'WARN' | 'BLOCKED';
+export type OrchestrationGateTarget = 'route' | 'execution' | 'handoff' | 'sync-back' | 'ship' | 'test';
+export interface OrchestrationGate {
+    status: OrchestrationGateStatus;
+    target: OrchestrationGateTarget;
+    scope: RuntimeScope;
+    blockingReasons: string[];
+    warnings: string[];
+    nextAction: string | null;
+    riskDecision: LifecycleRiskDecision | null;
+    stageRun: StageRun | null;
+    handoff: WorkflowHandoff | null;
+    contextLoadSignal: ContextLoadSignal | null;
+    contextOffloadDecision: ContextOffloadDecision | null;
+    blockingWorkUnits: WorkUnit[];
+    blockingSubagentDispatches: SubagentDispatch[];
+    subagentResults: SubagentResult[];
+}
+export interface EnsureTaskOrchestrationInput {
+    branch: string;
+    taskId: string;
+    runId?: string;
+    agent?: string;
+    stage?: SddStage;
+    status?: StageRun['status'];
+    outputRefs?: RuntimeRef[];
+    evidenceRefs?: RuntimeRef[];
+}
+export interface EnsureExecutionOrchestrationInput extends EnsureTaskOrchestrationInput {
+    workerKind?: string | null;
+    delegationId?: string;
+    expectedArtifact?: string;
+    dispatchBlocking?: boolean;
+}
+export interface CompleteExecutionOrchestrationInput extends EnsureExecutionOrchestrationInput {
+    artifactPath: string | null;
+    resultStatus: string | null;
+    completed: boolean;
+}

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

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

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

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

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

@@ -0,0 +1,2 @@
+export * from './contracts.js';
+export * from './runtime.js';

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

@@ -0,0 +1,3 @@
+export * from './contracts.js';
+export * from './runtime.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/orchestration/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

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

@@ -0,0 +1,55 @@
+import type { ContextLoadSignal, ContextOffloadDecision } from '../context-offload/contracts.js';
+import type { ArtifactResultIngestionRecord } from '../artifacts/ingestion.js';
+import type { LifecycleRiskDecision } from '../risk/contracts.js';
+import type { SddTask, SddTaskModel } from '../sdd-docs/task-parser.js';
+import type { StageRun, WorkflowHandoff } from '../stage-runtime/contracts.js';
+import type { SubagentDispatch, SubagentResult } from '../subagents/contracts.js';
+import type { WorkUnit } from '../work-units/contracts.js';
+import type { CompleteExecutionOrchestrationInput, EnsureExecutionOrchestrationInput, EnsureTaskOrchestrationInput, OrchestrationGate, OrchestrationGateTarget } from './contracts.js';
+export declare function ensureLifecycleRiskDecision(projectRoot: string, model: SddTaskModel, input: {
+    branch: string;
+    task?: SddTask | null;
+    runId?: string;
+}): Promise<LifecycleRiskDecision>;
+export declare function ensureTaskOrchestration(projectRoot: string, model: SddTaskModel, task: SddTask | null, input: EnsureTaskOrchestrationInput): Promise<{
+    riskDecision: LifecycleRiskDecision;
+    stageRun: StageRun;
+    contextLoadSignal: ContextLoadSignal;
+    contextOffloadDecision: ContextOffloadDecision;
+}>;
+export declare function ensureExecutionOrchestration(projectRoot: string, model: SddTaskModel, task: SddTask | null, input: EnsureExecutionOrchestrationInput): Promise<{
+    riskDecision: LifecycleRiskDecision;
+    stageRun: StageRun;
+    workUnit: WorkUnit;
+    dispatch: SubagentDispatch | null;
+    contextLoadSignal: ContextLoadSignal;
+    contextOffloadDecision: ContextOffloadDecision;
+}>;
+export declare function completeExecutionOrchestration(projectRoot: string, model: SddTaskModel, task: SddTask | null, input: CompleteExecutionOrchestrationInput): Promise<{
+    riskDecision: LifecycleRiskDecision;
+    stageRun: StageRun;
+    workUnit: WorkUnit;
+    dispatch: SubagentDispatch | null;
+    result: SubagentResult | null;
+    handoff: WorkflowHandoff;
+}>;
+export declare function projectSubagentResultFromBackgroundExecution(projectRoot: string, input: {
+    branch: string;
+    taskId: string;
+    runId: string;
+    agent: string;
+    delegationId: string;
+    ingestion: ArtifactResultIngestionRecord;
+}): Promise<SubagentResult>;
+export declare function inspectOrchestrationGate(projectRoot: string, input: {
+    branch: string;
+    taskId?: string;
+    runId?: string;
+    target?: OrchestrationGateTarget;
+    riskDecision?: LifecycleRiskDecision | null;
+    contextOffloadDecision?: ContextOffloadDecision | null;
+    contextLoadSignal?: ContextLoadSignal | null;
+    stageRun?: StageRun | null;
+    handoff?: WorkflowHandoff | null;
+}): Promise<OrchestrationGate>;
+export declare function lifecycleAutonomyCeilingFromDecision(decision: LifecycleRiskDecision): 'direct_execution_allowed' | 'compact_boundary_only' | 'full_sdd_with_checkpoint' | 'research_before_implementation';