sdd-agent-platform 0.3.0 → 0.4.1

package/packages/core/dist/lifecycle/risk-signals.d.ts

@@ -0,0 +1,57 @@
+import { LIFECYCLE_RISK_GATE_CONTRACT_VERSION } from '../contracts.js';
+export type SignalClarity = 'high' | 'medium' | 'low';
+export type EstimatedChangeSize = 'tiny' | 'small' | 'medium' | 'large';
+export type ImpactConfidence = 'high' | 'medium' | 'low';
+export type ValidationClarity = 'clear' | 'partial' | 'unclear';
+export type OrchestrationUncertainty = 'low' | 'medium' | 'high';
+export type Reversibility = 'reversible' | 'irreversible' | 'unknown';
+export type LifecycleRiskCategory = 'state_machine' | 'concurrency' | 'database_data_loss' | 'security' | 'sql' | 'api_schema' | 'ci_build' | 'external_unknown';
+export type LifecycleRiskExtractionSource = 'from_text' | 'from_file' | 'none';
+export interface LifecycleRiskExtractionEvidence {
+    category: LifecycleRiskCategory;
+    matched: string;
+    riskTag: string;
+}
+export interface LifecycleDecisionSignals {
+    intent_clarity: SignalClarity;
+    acceptance_clarity: SignalClarity;
+    estimated_change_size: EstimatedChangeSize;
+    task_count_estimate: number;
+    file_count_estimate: number;
+    affected_layers: string[];
+    affected_contracts: string[];
+    dependency_fanout: 'none' | 'local' | 'multi_component' | 'unknown';
+    impact_confidence: ImpactConfidence;
+    risk_tags: string[];
+    reversibility: Reversibility;
+    validation_clarity: ValidationClarity;
+    validation_available: boolean;
+    validation_cost: 'cheap' | 'moderate' | 'expensive' | 'unknown';
+    policy_hits: string[];
+    permission_required: string[];
+    requires_agents: boolean;
+    handoff_count: number;
+    artifact_dependency: boolean;
+    runtime_recovery_need: boolean;
+    orchestration_uncertainty: OrchestrationUncertainty;
+    human_checkpoint_required: boolean;
+    approval_reason: string[];
+    source_artifacts: string[];
+    can_scout_impact: boolean;
+    architecture_decision_required: boolean;
+    external_unknown: boolean;
+}
+export interface LifecycleRiskGateExtraction {
+    contract: typeof LIFECYCLE_RISK_GATE_CONTRACT_VERSION;
+    source: LifecycleRiskExtractionSource;
+    riskTags: string[];
+    affectedContracts: string[];
+    externalUnknown: boolean;
+    architectureDecisionRequired: boolean;
+    reversibility?: Reversibility;
+    validationClarity?: ValidationClarity;
+    impactConfidence?: ImpactConfidence;
+    evidence: LifecycleRiskExtractionEvidence[];
+    signals: Partial<LifecycleDecisionSignals>;
+}
+export declare function extractLifecycleRiskSignalsFromText(text: string, source?: LifecycleRiskExtractionSource): LifecycleRiskGateExtraction;

package/packages/core/dist/lifecycle/risk-signals.js

@@ -0,0 +1,80 @@
+import { LIFECYCLE_RISK_GATE_CONTRACT_VERSION } from '../contracts.js';
+export function extractLifecycleRiskSignalsFromText(text, source = 'from_text') {
+    const evidence = [];
+    const riskTags = [];
+    const affectedContracts = [];
+    let externalUnknown = false;
+    let architectureDecisionRequired = false;
+    let reversibility;
+    let validationClarity;
+    let impactConfidence;
+    function addEvidence(category, matched, riskTag) {
+        evidence.push({ category, matched, riskTag });
+        riskTags.push(riskTag);
+    }
+    function collect(category, terms, riskTag) {
+        for (const term of terms) {
+            if (text.toLowerCase().includes(term.toLowerCase())) {
+                addEvidence(category, term, riskTag);
+            }
+        }
+    }
+    collect('state_machine', ['state machine', 'state-machine', 'state_machine', '状态机', '状态流转', '状态转换', 'liveness', 'recovery'], 'state-machine');
+    collect('concurrency', ['concurrency', 'parallel', 'race', 'thread', 'multi-thread', '并发', '线程', '竞态', '锁'], 'concurrency');
+    collect('database_data_loss', ['database', 'migration', 'consistency', '数据一致性', '数据库', '迁移'], 'database');
+    collect('database_data_loss', ['data loss', 'data-loss', '数据丢失', '不可逆', 'irreversible'], 'data_loss');
+    collect('sql', ['sql', 'SQL', 'SQL 拼接', '拼接 SQL'], 'database');
+    collect('security', ['security', 'auth', 'permission', 'credential', 'token', 'secret', 'privacy', '安全', '认证', '授权', '凭证', '隐私'], 'security');
+    collect('security', ['SQL injection', 'sql injection', '注入'], 'security');
+    collect('api_schema', ['api', 'schema', 'contract', 'openapi', '接口', '契约', '协议', '字段', '兼容'], 'api');
+    collect('ci_build', ['ci', 'cd', 'build', 'release', 'publish', 'dependency', 'pipeline', '构建', '发布', '依赖', '流水线'], 'build');
+    collect('external_unknown', ['external', 'third-party', 'unknown', 'unscoutable', '外部', '第三方', '未知', '不确定'], 'external_unknown');
+    if (evidence.some((item) => item.category === 'api_schema')) {
+        affectedContracts.push('api_schema');
+    }
+    if (evidence.some((item) => item.category === 'external_unknown')) {
+        externalUnknown = true;
+        impactConfidence = 'low';
+    }
+    if (evidence.some((item) => item.category === 'database_data_loss' && (item.riskTag === 'data_loss' || item.matched.toLowerCase().includes('irreversible') || item.matched.includes('不可逆')))) {
+        reversibility = 'irreversible';
+    }
+    if (evidence.some((item) => item.category === 'ci_build')) {
+        validationClarity = 'partial';
+    }
+    if (text.includes('架构') || text.toLowerCase().includes('architecture decision')) {
+        architectureDecisionRequired = true;
+    }
+    const signals = {
+        risk_tags: uniqueStrings(riskTags),
+        affected_contracts: uniqueStrings(affectedContracts),
+        external_unknown: externalUnknown,
+        architecture_decision_required: architectureDecisionRequired
+    };
+    if (reversibility) {
+        signals.reversibility = reversibility;
+    }
+    if (validationClarity) {
+        signals.validation_clarity = validationClarity;
+    }
+    if (impactConfidence) {
+        signals.impact_confidence = impactConfidence;
+    }
+    return {
+        contract: LIFECYCLE_RISK_GATE_CONTRACT_VERSION,
+        source,
+        riskTags: uniqueStrings(riskTags),
+        affectedContracts: uniqueStrings(affectedContracts),
+        externalUnknown,
+        architectureDecisionRequired,
+        reversibility,
+        validationClarity,
+        impactConfidence,
+        evidence,
+        signals
+    };
+}
+function uniqueStrings(values) {
+    return Array.from(new Set(values.filter((value) => value.length > 0)));
+}
+//# sourceMappingURL=risk-signals.js.map

package/packages/core/dist/lifecycle/risk-signals.js.map

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

package/packages/core/dist/lifecycle/ship.d.ts

@@ -0,0 +1,44 @@
+import type { DoctorLevel } from '../doctor/model.js';
+import { type ProjectStatus } from '../status/project-status.js';
+export interface ShipReadinessCheck {
+    name: string;
+    status: 'PASS' | 'BLOCKED';
+    message: string;
+    nextAction?: string;
+}
+export interface ShipResult {
+    contract: 'sdd-ship-readiness-v1';
+    branch: string;
+    status: 'PASS' | 'BLOCKED';
+    dryRun: boolean;
+    releasePath: string;
+    wroteRelease: boolean;
+    checkedAt: string;
+    checks: ShipReadinessCheck[];
+    nextActions: string[];
+    projectStatus: {
+        workflowStatus: ProjectStatus['workflowStatus'];
+        tasks: ProjectStatus['tasks'];
+        taskRisk: ProjectStatus['taskRisk'];
+        latestRun: ProjectStatus['latestRun'];
+        latestRunEvidence: ProjectStatus['latestRunEvidence'];
+        staleReasons: string[];
+        affectedFileConflicts: number;
+        dependencyBlockers: number;
+        tokenProjection: ProjectStatus['tokenProjection'];
+        lifecycleRisk: ProjectStatus['lifecycleRisk'];
+        capabilityHealth: ProjectStatus['capabilityHealth'];
+        workflowGateHealth: ProjectStatus['workflowGateHealth'];
+    };
+    doctor: {
+        status: DoctorLevel;
+        pass: number;
+        warn: number;
+        fail: number;
+    };
+    releaseDocument: string;
+}
+export declare function runShip(projectRoot: string, options?: {
+    branch?: string | null;
+    dryRun?: boolean;
+}): Promise<ShipResult>;

package/packages/core/dist/lifecycle/ship.js

@@ -0,0 +1,207 @@
+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';
+import { evaluateAndRecordWorkflowGateDecision } from '../workflow-gate/evidence-packet.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 gateDecision = projectStatus.latestRun?.taskId
+        ? (await evaluateAndRecordWorkflowGateDecision(projectRoot, { branch: projectStatus.branch, taskId: projectStatus.latestRun.taskId, runId: projectStatus.latestRun.runId, decisionKind: 'ship' })).decision
+        : null;
+    const projectStatusWithGate = gateDecision ? await getProjectStatus(projectRoot, { branch: options.branch ?? undefined, branchSource: options.branch ? 'cli_option' : undefined }) : projectStatus;
+    const checks = buildShipChecks(projectStatusWithGate, doctorReport, gateDecision);
+    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: projectStatusWithGate, 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: projectStatusWithGate.workflowStatus,
+            tasks: projectStatusWithGate.tasks,
+            taskRisk: projectStatusWithGate.taskRisk,
+            latestRun: projectStatusWithGate.latestRun,
+            latestRunEvidence: projectStatusWithGate.latestRunEvidence,
+            staleReasons: projectStatusWithGate.latestRunStaleReasons,
+            affectedFileConflicts: projectStatusWithGate.affectedFileConflicts.length,
+            dependencyBlockers: projectStatusWithGate.dependencyBlockers.length,
+            tokenProjection: projectStatusWithGate.tokenProjection,
+            lifecycleRisk: projectStatusWithGate.lifecycleRisk,
+            capabilityHealth: projectStatusWithGate.capabilityHealth,
+            workflowGateHealth: projectStatusWithGate.workflowGateHealth
+        },
+        doctor: summarizeDoctor(doctorReport),
+        releaseDocument
+    };
+}
+function buildShipChecks(projectStatus, doctorReport, gateDecision) {
+    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: `Run missing document stages for ${projectStatus.branch}: sdd spec, sdd plan, then sdd tasks so verify.md is regenerated from the frozen tasks contract.`
+    });
+    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 === 'FAIL' ? 'BLOCKED' : 'PASS',
+        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(' ')
+    });
+    checks.push({
+        name: 'capability_health',
+        status: projectStatus.capabilityHealth.status === 'blocked' ? 'BLOCKED' : 'PASS',
+        message: `status=${projectStatus.capabilityHealth.status} baseline=${projectStatus.capabilityHealth.baselineDomains.length}/${projectStatus.capabilityHealth.requiredProfessionalDomains.length} release_critical_gaps=${projectStatus.capabilityHealth.releaseCriticalGaps.join(',') || 'none'} evidence_candidate=${projectStatus.capabilityHealth.evidence.candidate} evidence_quarantined=${projectStatus.capabilityHealth.evidence.quarantined} evidence_blocked=${projectStatus.capabilityHealth.evidence.blocked}`,
+        nextAction: projectStatus.capabilityHealth.status === 'blocked' ? `Run sdd test task, sdd test batch, or sdd test wave for ${projectStatus.branch} to record accepted runtime evidence; capability output remains advisory.` : undefined
+    });
+    checks.push({
+        name: 'workflow_gate',
+        status: gateDecision && gateDecision.status !== 'PASS' ? 'BLOCKED' : 'PASS',
+        message: gateDecision ? `decision=${gateDecision.decisionId} status=${gateDecision.status} hard_blocks=${gateDecision.hardBlocks.length} warnings=${gateDecision.warnings.length} human_required=${gateDecision.humanRequired}` : 'decision=none',
+        nextAction: gateDecision && gateDecision.status !== 'PASS' ? gateDecision.allowedNextActions.join(', ') : undefined
+    });
+    return checks;
+}
+function latestRunReady(projectStatus) {
+    if (!projectStatus.latestRun) {
+        return false;
+    }
+    return projectStatus.latestRun.status === 'completed'
+        && projectStatus.latestRun.validationStatus === 'pass';
+}
+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}`,
+        `- capability_health: status=${input.projectStatus.capabilityHealth.status} baseline=${input.projectStatus.capabilityHealth.baselineDomains.length}/${input.projectStatus.capabilityHealth.requiredProfessionalDomains.length} active=${input.projectStatus.capabilityHealth.activeDomains.join(',') || 'none'} release_critical_gaps=${input.projectStatus.capabilityHealth.releaseCriticalGaps.join(',') || 'none'} evidence_candidate=${input.projectStatus.capabilityHealth.evidence.candidate} evidence_quarantined=${input.projectStatus.capabilityHealth.evidence.quarantined} evidence_blocked=${input.projectStatus.capabilityHealth.evidence.blocked}`,
+        `- workflow_gate: decisions=${input.projectStatus.workflowGateHealth.decisions} latest=${input.projectStatus.workflowGateHealth.latestDecision ? `${input.projectStatus.workflowGateHealth.latestDecision.decisionKind}:${input.projectStatus.workflowGateHealth.latestDecision.status}:${input.projectStatus.workflowGateHealth.latestDecision.decisionId}` : 'none'}`,
+        `- 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/packages/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/packages/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/packages/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/packages/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/packages/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/packages/core/dist/orchestration/contracts.js

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

package/packages/core/dist/orchestration/contracts.js.map

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

package/packages/core/dist/orchestration/index.d.ts

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

package/packages/core/dist/orchestration/index.js

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

package/packages/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/packages/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';