sdd-agent-platform 0.3.0 → 0.4.0

package/packages/core/dist/context-offload/runtime.d.ts

@@ -0,0 +1,36 @@
+import type { RuntimeProjectionEnvelope, RuntimeRef, RuntimeScope } from '../contracts.js';
+import { type RuntimeProjectionEnvelopeWriteResult } from '../storage/runtime-store.js';
+import type { ContextLoadLevel, ContextLoadSignal, ContextOffloadDecision } from './contracts.js';
+export declare const CONTEXT_OFFLOAD_RUNTIME_PRODUCER_VERSION = "phase8-context-offload-runtime-v1";
+export declare const CONTEXT_LOAD_SIGNAL_PROJECTION_TYPE = "phase8_context_load_signal";
+export declare const CONTEXT_OFFLOAD_DECISION_PROJECTION_TYPE = "phase8_context_offload_decision";
+export interface ContextLoadInput {
+    scope: RuntimeScope;
+    refs?: RuntimeRef[];
+    fileCount?: number;
+    artifactBytes?: number;
+    dependencyFanout?: number;
+    unknownImpact?: boolean;
+    staleEvidenceRefs?: number;
+    logBytes?: number;
+    generatedAt?: string;
+}
+export interface ContextRuntimeDiagnostic {
+    level: ContextLoadLevel | 'unknown';
+    action: ContextOffloadDecision['action'] | 'none';
+    loadSignals: number;
+    offloadDecisions: number;
+    dispatchRefs: number;
+    blockingReasons: string[];
+}
+export declare function evaluateContextLoadSignal(input: ContextLoadInput): ContextLoadSignal;
+export declare function decideContextOffload(signal: ContextLoadSignal, refs?: {
+    inlineRefs?: RuntimeRef[];
+    summarizeRefs?: RuntimeRef[];
+    dispatchRefs?: RuntimeRef[];
+}): ContextOffloadDecision;
+export declare function contextLoadSignalScopeKey(scope: RuntimeScope): string;
+export declare function recordContextLoadSignalProjection(projectRoot: string, signal: ContextLoadSignal): Promise<RuntimeProjectionEnvelopeWriteResult<ContextLoadSignal>>;
+export declare function readContextLoadSignalProjection(projectRoot: string, scope: RuntimeScope): Promise<RuntimeProjectionEnvelope<ContextLoadSignal> | null>;
+export declare function recordContextOffloadDecisionProjection(projectRoot: string, decision: ContextOffloadDecision): Promise<RuntimeProjectionEnvelopeWriteResult<ContextOffloadDecision>>;
+export declare function inspectContextOffloadRuntime(projectRoot: string, branch: string): Promise<ContextRuntimeDiagnostic>;

package/packages/core/dist/context-offload/runtime.js

@@ -0,0 +1,142 @@
+import { createHash } from 'node:crypto';
+import { CONTEXT_LOAD_SIGNAL_CONTRACT_VERSION, CONTEXT_OFFLOAD_DECISION_CONTRACT_VERSION } from '../contracts.js';
+import { listRuntimeProjections, readRuntimeProjectionEnvelope, recordRuntimeProjectionEnvelope } from '../storage/runtime-store.js';
+export const CONTEXT_OFFLOAD_RUNTIME_PRODUCER_VERSION = 'phase8-context-offload-runtime-v1';
+export const CONTEXT_LOAD_SIGNAL_PROJECTION_TYPE = 'phase8_context_load_signal';
+export const CONTEXT_OFFLOAD_DECISION_PROJECTION_TYPE = 'phase8_context_offload_decision';
+export function evaluateContextLoadSignal(input) {
+    const fileCountScore = scoreByThreshold(input.fileCount ?? 0, [8, 20, 40]);
+    const artifactSizeScore = scoreByThreshold(input.artifactBytes ?? 0, [50_000, 200_000, 500_000]);
+    const dependencyFanoutScore = scoreByThreshold(input.dependencyFanout ?? 0, [5, 12, 25]);
+    const unknownImpactScore = input.unknownImpact ? 2 : 0;
+    const staleEvidenceScore = scoreByThreshold(input.staleEvidenceRefs ?? 0, [1, 3, 6]);
+    const logVolumeScore = scoreByThreshold(input.logBytes ?? 0, [30_000, 120_000, 300_000]);
+    const score = fileCountScore + artifactSizeScore + dependencyFanoutScore + unknownImpactScore + staleEvidenceScore + logVolumeScore;
+    return {
+        contract: CONTEXT_LOAD_SIGNAL_CONTRACT_VERSION,
+        scope: input.scope,
+        level: contextLevelForScore(score),
+        score,
+        fileCountScore,
+        artifactSizeScore,
+        dependencyFanoutScore,
+        unknownImpactScore,
+        staleEvidenceScore,
+        logVolumeScore,
+        confidence: input.unknownImpact ? 'medium' : 'high',
+        inputRefs: input.refs ?? [],
+        reasons: contextLoadReasons(fileCountScore, artifactSizeScore, dependencyFanoutScore, unknownImpactScore, staleEvidenceScore, logVolumeScore),
+        generatedAt: input.generatedAt ?? new Date().toISOString()
+    };
+}
+export function decideContextOffload(signal, refs = {}) {
+    const action = signal.level === 'overloaded'
+        ? 'block-for-curation'
+        : signal.level === 'high'
+            ? 'dispatch-subagent'
+            : signal.level === 'elevated'
+                ? 'summarize'
+                : 'inline';
+    return {
+        contract: CONTEXT_OFFLOAD_DECISION_CONTRACT_VERSION,
+        scope: signal.scope,
+        action,
+        loadSignalRef: { kind: 'projection', ref: `${CONTEXT_LOAD_SIGNAL_PROJECTION_TYPE}:${contextLoadSignalScopeKey(signal.scope)}` },
+        requiredBefore: action === 'block-for-curation' ? 'stage-output' : action === 'dispatch-subagent' ? 'handoff' : 'never',
+        inlineRefs: action === 'inline' ? refs.inlineRefs ?? signal.inputRefs : [],
+        summarizeRefs: action === 'summarize' ? refs.summarizeRefs ?? signal.inputRefs : [],
+        dispatchRefs: action === 'dispatch-subagent' ? refs.dispatchRefs ?? signal.inputRefs : [],
+        blockingReasons: action === 'block-for-curation' ? signal.reasons : [],
+        generatedAt: signal.generatedAt
+    };
+}
+export function contextLoadSignalScopeKey(scope) {
+    return [scope.branch, scope.taskId ?? 'all', scope.runId ?? 'none', scope.changeRef ?? 'none'].join(':');
+}
+export async function recordContextLoadSignalProjection(projectRoot, signal) {
+    return recordRuntimeProjectionEnvelope(projectRoot, {
+        projectionType: CONTEXT_LOAD_SIGNAL_PROJECTION_TYPE,
+        scopeKey: contextLoadSignalScopeKey(signal.scope),
+        inputHash: stableHash(JSON.stringify(signal)),
+        producer: 'phase8-context-offload-runtime',
+        producerVersion: CONTEXT_OFFLOAD_RUNTIME_PRODUCER_VERSION,
+        generatedAt: signal.generatedAt,
+        payload: signal
+    });
+}
+export async function readContextLoadSignalProjection(projectRoot, scope) {
+    return readRuntimeProjectionEnvelope(projectRoot, CONTEXT_LOAD_SIGNAL_PROJECTION_TYPE, contextLoadSignalScopeKey(scope));
+}
+export async function recordContextOffloadDecisionProjection(projectRoot, decision) {
+    return recordRuntimeProjectionEnvelope(projectRoot, {
+        projectionType: CONTEXT_OFFLOAD_DECISION_PROJECTION_TYPE,
+        scopeKey: contextLoadSignalScopeKey(decision.scope),
+        inputHash: stableHash(JSON.stringify(decision)),
+        producer: 'phase8-context-offload-runtime',
+        producerVersion: CONTEXT_OFFLOAD_RUNTIME_PRODUCER_VERSION,
+        generatedAt: decision.generatedAt,
+        payload: decision
+    });
+}
+export async function inspectContextOffloadRuntime(projectRoot, branch) {
+    const projections = await listRuntimeProjections(projectRoot, [CONTEXT_LOAD_SIGNAL_PROJECTION_TYPE, CONTEXT_OFFLOAD_DECISION_PROJECTION_TYPE]);
+    const signalEnvelopes = projections
+        .filter((projection) => projection.projectionType === CONTEXT_LOAD_SIGNAL_PROJECTION_TYPE)
+        .map((projection) => projection.payload)
+        .filter((envelope) => envelope?.payload?.scope?.branch === branch);
+    const decisionEnvelopes = projections
+        .filter((projection) => projection.projectionType === CONTEXT_OFFLOAD_DECISION_PROJECTION_TYPE)
+        .map((projection) => projection.payload)
+        .filter((envelope) => envelope?.payload?.scope?.branch === branch);
+    const latestSignal = latestEnvelope(signalEnvelopes)?.payload ?? null;
+    const latestDecision = latestEnvelope(decisionEnvelopes)?.payload ?? null;
+    return {
+        level: latestSignal?.level ?? 'unknown',
+        action: latestDecision?.action ?? 'none',
+        loadSignals: signalEnvelopes.length,
+        offloadDecisions: decisionEnvelopes.length,
+        dispatchRefs: latestDecision?.dispatchRefs.length ?? 0,
+        blockingReasons: latestDecision?.blockingReasons ?? []
+    };
+}
+function latestEnvelope(envelopes) {
+    return [...envelopes].sort((left, right) => right.generatedAt.localeCompare(left.generatedAt))[0] ?? null;
+}
+function contextLevelForScore(score) {
+    if (score >= 10) {
+        return 'overloaded';
+    }
+    if (score >= 7) {
+        return 'high';
+    }
+    if (score >= 3) {
+        return 'elevated';
+    }
+    return 'normal';
+}
+function scoreByThreshold(value, thresholds) {
+    if (value >= thresholds[2]) {
+        return 3;
+    }
+    if (value >= thresholds[1]) {
+        return 2;
+    }
+    if (value >= thresholds[0]) {
+        return 1;
+    }
+    return 0;
+}
+function contextLoadReasons(fileCountScore, artifactSizeScore, dependencyFanoutScore, unknownImpactScore, staleEvidenceScore, logVolumeScore) {
+    return [
+        fileCountScore > 0 ? `file-count score=${fileCountScore}` : null,
+        artifactSizeScore > 0 ? `artifact-size score=${artifactSizeScore}` : null,
+        dependencyFanoutScore > 0 ? `dependency-fanout score=${dependencyFanoutScore}` : null,
+        unknownImpactScore > 0 ? `unknown-impact score=${unknownImpactScore}` : null,
+        staleEvidenceScore > 0 ? `stale-evidence score=${staleEvidenceScore}` : null,
+        logVolumeScore > 0 ? `log-volume score=${logVolumeScore}` : null
+    ].filter((reason) => reason !== null);
+}
+function stableHash(value) {
+    return createHash('sha256').update(value, 'utf8').digest('hex');
+}
+//# sourceMappingURL=runtime.js.map

package/packages/core/dist/context-offload/runtime.js.map

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

package/packages/core/dist/context-offload.d.ts

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

package/packages/core/dist/context-offload.js

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

package/packages/core/dist/context-offload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-offload.js","sourceRoot":"","sources":["../src/context-offload.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC"}

package/packages/core/dist/context.d.ts

@@ -0,0 +1,6 @@
+export * from './context/budget.js';
+export * from './context/build-package.js';
+export * from './context/command-summary.js';
+export * from './context/evidence-summary.js';
+export * from './context/log-worker.js';
+export * from './context/source-refs.js';

package/packages/core/dist/context.js

@@ -0,0 +1,7 @@
+export * from './context/budget.js';
+export * from './context/build-package.js';
+export * from './context/command-summary.js';
+export * from './context/evidence-summary.js';
+export * from './context/log-worker.js';
+export * from './context/source-refs.js';
+//# sourceMappingURL=context.js.map

package/packages/core/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC"}

package/packages/core/dist/contracts/issues.d.ts

@@ -0,0 +1,7 @@
+export interface ContractValidationIssue {
+    field: string;
+    message: string;
+    recommendation: string;
+}
+export declare function contractIssue(field: string, message: string, recommendation: string): ContractValidationIssue;
+export declare function messageFromError(error: unknown): string;

package/packages/core/dist/contracts/issues.js

@@ -0,0 +1,7 @@
+export function contractIssue(field, message, recommendation) {
+    return { field, message, recommendation };
+}
+export function messageFromError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=issues.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"issues.js","sourceRoot":"","sources":["../../src/contracts/issues.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,OAAe,EAAE,cAAsB;IAClF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/packages/core/dist/contracts.d.ts

@@ -0,0 +1,108 @@
+export declare const RUNTIME_VERSION = "phase-1.2-runtime-skeleton";
+export declare const PROJECT_CONFIG_CONTRACT = "phase-1.2-project-contract";
+export declare const RUN_STATE_CONTRACT = "phase-1.2-run-state-contract";
+export declare const EVENT_LOG_CONTRACT = "phase-1.2-event-log-contract";
+export declare const ARTIFACT_PATH_CONTRACT = "phase-1.2-artifact-path-contract";
+export declare const LEGACY_LIFECYCLE_DECISION_CONTRACT = "phase-1.2-lifecycle-decision-contract";
+export declare const LIFECYCLE_DECISION_CONTRACT = "sdd-lifecycle-decision-v1";
+export declare const LIFECYCLE_DECISION_VERSION = "1.3.0";
+export declare const SDD_RESULT_CONTRACT = "sdd-result-v1";
+export declare const SDD_RESULT_VERSION = "1.3.0";
+export declare const DELEGATION_LIVENESS_CONTRACT = "sdd-delegation-liveness-v1";
+export declare const DELEGATION_LIVENESS_VERSION = "1.3.0";
+export declare const ARTIFACT_RESULT_INGESTION_CONTRACT_VERSION = "phase-3.6-artifact-result-ingestion-v1";
+export declare const TASK_GRAPH_PLANNER_CONTRACT_VERSION = "phase-3.9-task-graph-planner-v1";
+export declare const WAVE_PLANNER_CONTRACT_VERSION = "phase-3.10-wave-planner-v1";
+export declare const BACKGROUND_EXECUTOR_CONTRACT_VERSION = "phase-3.11-background-executor-v1";
+export declare const WAVE_EXECUTOR_CONTRACT_VERSION = "phase-3.12-wave-executor-v1";
+export declare const LOCAL_RUN_INDEX_CONTRACT_VERSION = "phase-3.13-local-run-index-v1";
+export declare const GOVERNANCE_POLICY_CONTRACT_VERSION = "phase-3.14-governance-policy-v1";
+export declare const CONTEXT_RESOLVER_CONTRACT_VERSION = "phase-5.1-context-resolver-v1";
+export declare const LIFECYCLE_RISK_GATE_CONTRACT_VERSION = "phase-5.1-lifecycle-risk-gate-v1";
+export declare const OUTPUT_QUALITY_CONTRACT_VERSION = "phase-5.1-output-quality-v1";
+export declare const WORKFLOW_GATE_CONTRACT_VERSION = "phase-5.2-workflow-gate-v1";
+export declare const AGENT_REGISTRY_CONTRACT_VERSION = "phase-5.2-agent-registry-v1";
+export declare const TASK_GRAPH_CONTRACT_VERSION = "phase-5.3-task-graph-v1";
+export declare const TASK_RUN_EVIDENCE_CONTRACT_VERSION = "phase-5.3-task-run-evidence-v1";
+export declare const QUERY_STATUS_CONTRACT_VERSION = "phase-5.4-query-status-v1";
+export declare const SKILL_AGENT_EVAL_CONTRACT_VERSION = "phase-5.5-skill-agent-eval-v1";
+export declare const HARNESS_LEARNING_CONTRACT_VERSION = "phase-5.5-harness-learning-v1";
+export declare const PROJECT_CONTEXT_PACK_CONTRACT_VERSION = "phase-5.5-project-context-pack-v1";
+export declare const AGENT_SKILL_TEAM_RUNTIME_CONTRACT_VERSION = "phase-6.0-agent-skill-team-runtime-v1";
+export declare const CAPABILITY_SOURCE_CATALOG_VERSION = "phase-6.0-capability-source-catalog-v1";
+export declare const EXTERNAL_AGENT_PACK_IMPORT_POLICY_VERSION = "phase-6.0-external-agent-pack-import-policy-v1";
+export declare const TOOL_PERMISSION_SPEC_VERSION = "phase-6.0-tool-permission-spec-v1";
+export declare const HOST_ADAPTER_CONTRACT_VERSION = "phase-6.0-host-adapter-contract-v1";
+export declare const AGENT_ROUTER_CONTRACT_VERSION = "phase-6.0-agent-router-v1";
+export declare const TEAM_MODE_POLICY_VERSION = "phase-6.0-team-mode-policy-v1";
+export declare const EVIDENCE_INGESTION_CONTRACT_VERSION = "phase-6.0-evidence-ingestion-v1";
+export declare const AGENT_EXECUTION_RECORD_CONTRACT_VERSION = "phase-6.0-agent-execution-record-v1";
+export declare const TEAM_SESSION_RECORD_CONTRACT_VERSION = "phase-6.0-team-session-record-v1";
+export declare const RESIDENT_WORKER_RUNTIME_CONTRACT_VERSION = "phase-6.1-resident-worker-runtime-v1";
+export declare const SDD_EVIDENCE_CONTRACT = "sdd-evidence-v1";
+export declare const SDD_EVIDENCE_VERSION = "1.0.0";
+export declare const ACCEPTANCE_POLICY_RULESET_VERSION = "acceptance-policy-v1";
+export declare const INVOCATION_LEDGER_CONTRACT_VERSION = "phase-6.9-invocation-ledger-v1";
+export declare const ROUTE_CACHE_CONTRACT_VERSION = "phase-6.9-route-cache-v1";
+export declare const RUNTIME_PROFILE_CONTRACT_VERSION = "phase-6.9-runtime-profile-v1";
+export declare const CONTEXT_BUDGET_CONTRACT_VERSION = "phase-6.10-context-budget-v1";
+export declare const COMMAND_OUTPUT_SUMMARY_CONTRACT_VERSION = "sdd-command-output-summary-v1";
+export declare const EVIDENCE_SUMMARY_CONTRACT_VERSION = "sdd-evidence-summary-v1";
+export declare const CONTEXT_PACKAGE_CONTRACT_VERSION = "sdd-context-package-v1";
+export declare const LOG_WORKER_SUMMARY_CONTRACT_VERSION = "sdd-log-worker-summary-v1";
+export declare const RUNTIME_ANALYSIS_CONTRACT_VERSION = "phase-7-runtime-analysis-v1";
+export declare const WORKFLOW_STATE_RESOLVER_CONTRACT_VERSION = "phase-7.3-workflow-state-resolver-v1";
+export declare const VERIFY_DOCUMENT_CONTRACT_VERSION = "sdd-verify-doc-v1";
+export declare const AGENT_CAPABILITY_CATALOG_CONTRACT_VERSION = "phase-7.6-agent-capability-catalog-v1";
+export declare const COMMAND_TEAM_RUNTIME_CONTRACT_VERSION = "phase-7.7-command-team-runtime-v1";
+export declare const RUNTIME_PROJECTION_ENVELOPE_CONTRACT_VERSION = "sdd-runtime-projection-envelope-v1";
+export declare const CODING_FACT_SET_CONTRACT_VERSION = "sdd-coding-fact-set-v1";
+export declare const CODING_RISK_PROFILE_CONTRACT_VERSION = "sdd-coding-risk-profile-v1";
+export declare const LIFECYCLE_RISK_DECISION_CONTRACT_VERSION = "sdd-lifecycle-risk-decision-v1";
+export declare const STAGE_RUN_CONTRACT_VERSION = "sdd-stage-run-v1";
+export declare const WORKFLOW_HANDOFF_CONTRACT_VERSION = "sdd-workflow-handoff-v1";
+export declare const WORK_UNIT_CONTRACT_VERSION = "sdd-work-unit-v1";
+export declare const SUBAGENT_DEFINITION_CONTRACT_VERSION = "sdd-subagent-definition-v1";
+export declare const SUBAGENT_DISPATCH_CONTRACT_VERSION = "sdd-subagent-dispatch-v1";
+export declare const SUBAGENT_RESULT_CONTRACT_VERSION = "sdd-subagent-result-v1";
+export declare const CONTEXT_LOAD_SIGNAL_CONTRACT_VERSION = "sdd-context-load-signal-v1";
+export declare const CONTEXT_OFFLOAD_DECISION_CONTRACT_VERSION = "sdd-context-offload-decision-v1";
+export declare const SCOPED_CONTEXT_HANDOFF_CONTRACT_VERSION = "sdd-scoped-context-handoff-v1";
+export declare const TEST_EVIDENCE_RUN_CONTRACT_VERSION = "sdd-test-evidence-run-v1";
+export declare const MODEL_PRODUCED_ARTIFACT_CONTRACT_VERSION = "sdd-model-produced-artifact-v1";
+export type RuntimeConfidence = 'high' | 'medium' | 'low';
+export type RuntimeProjectionStaleness = 'fresh' | 'stale' | 'incompatible' | 'unknown';
+export type SddStage = 'spec' | 'plan' | 'tasks' | 'verifies' | 'do' | 'test' | 'goal-verify' | 'sync-back' | 'ship';
+export type RuntimeRefKind = 'document' | 'task' | 'run' | 'artifact' | 'projection' | 'evidence' | 'command' | 'external';
+export interface RuntimeScope {
+    branch: string;
+    taskId?: string;
+    runId?: string;
+    changeRef?: string;
+}
+export interface RuntimeRef {
+    kind: RuntimeRefKind;
+    ref: string;
+    hash?: string;
+}
+export interface RuntimeProjectionEnvelope<TPayload> {
+    contract: typeof RUNTIME_PROJECTION_ENVELOPE_CONTRACT_VERSION;
+    projectionType: string;
+    scopeKey: string;
+    id: string;
+    inputHash: string;
+    producer: string;
+    producerVersion: string;
+    generatedAt: string;
+    staleReason?: string;
+    payload: TPayload;
+}
+export interface ModelProducedArtifact {
+    contract: typeof MODEL_PRODUCED_ARTIFACT_CONTRACT_VERSION;
+    producer: 'main-agent' | 'co-main-agent' | 'subagent';
+    authority: 'stage-owned' | 'candidate' | 'non-authoritative';
+    allowedUse: Array<'summary' | 'diagnostic' | 'test-suggestion' | 'evidence-candidate'>;
+    forbiddenUse: Array<'final-risk-decision' | 'stage-completion' | 'ship-gate-pass'>;
+    artifactRefs: string[];
+    reviewedByRuntime: boolean;
+}

package/packages/core/dist/contracts.js

@@ -0,0 +1,73 @@
+export const RUNTIME_VERSION = 'phase-1.2-runtime-skeleton';
+export const PROJECT_CONFIG_CONTRACT = 'phase-1.2-project-contract';
+export const RUN_STATE_CONTRACT = 'phase-1.2-run-state-contract';
+export const EVENT_LOG_CONTRACT = 'phase-1.2-event-log-contract';
+export const ARTIFACT_PATH_CONTRACT = 'phase-1.2-artifact-path-contract';
+export const LEGACY_LIFECYCLE_DECISION_CONTRACT = 'phase-1.2-lifecycle-decision-contract';
+export const LIFECYCLE_DECISION_CONTRACT = 'sdd-lifecycle-decision-v1';
+export const LIFECYCLE_DECISION_VERSION = '1.3.0';
+export const SDD_RESULT_CONTRACT = 'sdd-result-v1';
+export const SDD_RESULT_VERSION = '1.3.0';
+export const DELEGATION_LIVENESS_CONTRACT = 'sdd-delegation-liveness-v1';
+export const DELEGATION_LIVENESS_VERSION = '1.3.0';
+export const ARTIFACT_RESULT_INGESTION_CONTRACT_VERSION = 'phase-3.6-artifact-result-ingestion-v1';
+export const TASK_GRAPH_PLANNER_CONTRACT_VERSION = 'phase-3.9-task-graph-planner-v1';
+export const WAVE_PLANNER_CONTRACT_VERSION = 'phase-3.10-wave-planner-v1';
+export const BACKGROUND_EXECUTOR_CONTRACT_VERSION = 'phase-3.11-background-executor-v1';
+export const WAVE_EXECUTOR_CONTRACT_VERSION = 'phase-3.12-wave-executor-v1';
+export const LOCAL_RUN_INDEX_CONTRACT_VERSION = 'phase-3.13-local-run-index-v1';
+export const GOVERNANCE_POLICY_CONTRACT_VERSION = 'phase-3.14-governance-policy-v1';
+export const CONTEXT_RESOLVER_CONTRACT_VERSION = 'phase-5.1-context-resolver-v1';
+export const LIFECYCLE_RISK_GATE_CONTRACT_VERSION = 'phase-5.1-lifecycle-risk-gate-v1';
+export const OUTPUT_QUALITY_CONTRACT_VERSION = 'phase-5.1-output-quality-v1';
+export const WORKFLOW_GATE_CONTRACT_VERSION = 'phase-5.2-workflow-gate-v1';
+export const AGENT_REGISTRY_CONTRACT_VERSION = 'phase-5.2-agent-registry-v1';
+export const TASK_GRAPH_CONTRACT_VERSION = 'phase-5.3-task-graph-v1';
+export const TASK_RUN_EVIDENCE_CONTRACT_VERSION = 'phase-5.3-task-run-evidence-v1';
+export const QUERY_STATUS_CONTRACT_VERSION = 'phase-5.4-query-status-v1';
+export const SKILL_AGENT_EVAL_CONTRACT_VERSION = 'phase-5.5-skill-agent-eval-v1';
+export const HARNESS_LEARNING_CONTRACT_VERSION = 'phase-5.5-harness-learning-v1';
+export const PROJECT_CONTEXT_PACK_CONTRACT_VERSION = 'phase-5.5-project-context-pack-v1';
+export const AGENT_SKILL_TEAM_RUNTIME_CONTRACT_VERSION = 'phase-6.0-agent-skill-team-runtime-v1';
+export const CAPABILITY_SOURCE_CATALOG_VERSION = 'phase-6.0-capability-source-catalog-v1';
+export const EXTERNAL_AGENT_PACK_IMPORT_POLICY_VERSION = 'phase-6.0-external-agent-pack-import-policy-v1';
+export const TOOL_PERMISSION_SPEC_VERSION = 'phase-6.0-tool-permission-spec-v1';
+export const HOST_ADAPTER_CONTRACT_VERSION = 'phase-6.0-host-adapter-contract-v1';
+export const AGENT_ROUTER_CONTRACT_VERSION = 'phase-6.0-agent-router-v1';
+export const TEAM_MODE_POLICY_VERSION = 'phase-6.0-team-mode-policy-v1';
+export const EVIDENCE_INGESTION_CONTRACT_VERSION = 'phase-6.0-evidence-ingestion-v1';
+export const AGENT_EXECUTION_RECORD_CONTRACT_VERSION = 'phase-6.0-agent-execution-record-v1';
+export const TEAM_SESSION_RECORD_CONTRACT_VERSION = 'phase-6.0-team-session-record-v1';
+export const RESIDENT_WORKER_RUNTIME_CONTRACT_VERSION = 'phase-6.1-resident-worker-runtime-v1';
+export const SDD_EVIDENCE_CONTRACT = 'sdd-evidence-v1';
+export const SDD_EVIDENCE_VERSION = '1.0.0';
+export const ACCEPTANCE_POLICY_RULESET_VERSION = 'acceptance-policy-v1';
+export const INVOCATION_LEDGER_CONTRACT_VERSION = 'phase-6.9-invocation-ledger-v1';
+export const ROUTE_CACHE_CONTRACT_VERSION = 'phase-6.9-route-cache-v1';
+export const RUNTIME_PROFILE_CONTRACT_VERSION = 'phase-6.9-runtime-profile-v1';
+export const CONTEXT_BUDGET_CONTRACT_VERSION = 'phase-6.10-context-budget-v1';
+export const COMMAND_OUTPUT_SUMMARY_CONTRACT_VERSION = 'sdd-command-output-summary-v1';
+export const EVIDENCE_SUMMARY_CONTRACT_VERSION = 'sdd-evidence-summary-v1';
+export const CONTEXT_PACKAGE_CONTRACT_VERSION = 'sdd-context-package-v1';
+export const LOG_WORKER_SUMMARY_CONTRACT_VERSION = 'sdd-log-worker-summary-v1';
+export const RUNTIME_ANALYSIS_CONTRACT_VERSION = 'phase-7-runtime-analysis-v1';
+export const WORKFLOW_STATE_RESOLVER_CONTRACT_VERSION = 'phase-7.3-workflow-state-resolver-v1';
+export const VERIFY_DOCUMENT_CONTRACT_VERSION = 'sdd-verify-doc-v1';
+export const AGENT_CAPABILITY_CATALOG_CONTRACT_VERSION = 'phase-7.6-agent-capability-catalog-v1';
+export const COMMAND_TEAM_RUNTIME_CONTRACT_VERSION = 'phase-7.7-command-team-runtime-v1';
+export const RUNTIME_PROJECTION_ENVELOPE_CONTRACT_VERSION = 'sdd-runtime-projection-envelope-v1';
+export const CODING_FACT_SET_CONTRACT_VERSION = 'sdd-coding-fact-set-v1';
+export const CODING_RISK_PROFILE_CONTRACT_VERSION = 'sdd-coding-risk-profile-v1';
+export const LIFECYCLE_RISK_DECISION_CONTRACT_VERSION = 'sdd-lifecycle-risk-decision-v1';
+export const STAGE_RUN_CONTRACT_VERSION = 'sdd-stage-run-v1';
+export const WORKFLOW_HANDOFF_CONTRACT_VERSION = 'sdd-workflow-handoff-v1';
+export const WORK_UNIT_CONTRACT_VERSION = 'sdd-work-unit-v1';
+export const SUBAGENT_DEFINITION_CONTRACT_VERSION = 'sdd-subagent-definition-v1';
+export const SUBAGENT_DISPATCH_CONTRACT_VERSION = 'sdd-subagent-dispatch-v1';
+export const SUBAGENT_RESULT_CONTRACT_VERSION = 'sdd-subagent-result-v1';
+export const CONTEXT_LOAD_SIGNAL_CONTRACT_VERSION = 'sdd-context-load-signal-v1';
+export const CONTEXT_OFFLOAD_DECISION_CONTRACT_VERSION = 'sdd-context-offload-decision-v1';
+export const SCOPED_CONTEXT_HANDOFF_CONTRACT_VERSION = 'sdd-scoped-context-handoff-v1';
+export const TEST_EVIDENCE_RUN_CONTRACT_VERSION = 'sdd-test-evidence-run-v1';
+export const MODEL_PRODUCED_ARTIFACT_CONTRACT_VERSION = 'sdd-model-produced-artifact-v1';
+//# sourceMappingURL=contracts.js.map

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

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

package/packages/core/dist/delegation/model.d.ts

@@ -0,0 +1,21 @@
+import { DELEGATION_LIVENESS_CONTRACT, DELEGATION_LIVENESS_VERSION } from '../contracts.js';
+import type { DelegationStatus } from './state-machine.js';
+export type { DelegationStatus } from './state-machine.js';
+export type DelegationRunMode = 'foreground' | 'background';
+export interface DelegationRecord {
+    contract: typeof DELEGATION_LIVENESS_CONTRACT;
+    version: typeof DELEGATION_LIVENESS_VERSION;
+    delegationId: string;
+    task: string;
+    agent: string;
+    runMode: DelegationRunMode;
+    blocking: boolean;
+    requiredForPhaseExit: boolean;
+    status: DelegationStatus;
+    startedAt: string;
+    lastHeartbeatAt: string | null;
+    timeoutSeconds: number;
+    expectedArtifact: string;
+    terminalEventRequired: boolean;
+    terminalEventAt?: string | null;
+}

package/packages/core/dist/delegation/model.js

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

package/packages/core/dist/delegation/model.js.map

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

package/packages/core/dist/delegation/queue.d.ts

@@ -0,0 +1,10 @@
+import type { DelegationQueueItem } from '../run-state/run-index.js';
+export declare const DELEGATION_QUEUE_CONTRACT_VERSION = "phase-3.3-delegation-queue-contract-v1";
+export interface DelegationQueueSnapshot {
+    version: string;
+    items: DelegationQueueItem[];
+}
+export declare function listDelegationQueueItems(projectRoot: string, options?: {
+    runId?: string;
+}): Promise<DelegationQueueSnapshot>;
+export declare function inspectDelegationQueueItem(projectRoot: string, queueItemId: string): Promise<DelegationQueueItem | null>;

package/packages/core/dist/delegation/queue.js

@@ -0,0 +1,47 @@
+import { readFile } from 'node:fs/promises';
+import { parseProjectConfig } from '../config/project-config.js';
+import { getProjectConfigPath } from '../runtime-paths.js';
+import { readAllRunStates, readRunState } from '../run-state/run-state.js';
+export const DELEGATION_QUEUE_CONTRACT_VERSION = 'phase-3.3-delegation-queue-contract-v1';
+export async function listDelegationQueueItems(projectRoot, options = {}) {
+    await assertProjectConfigReadable(projectRoot);
+    const states = options.runId
+        ? [await readRunState(projectRoot, options.runId)]
+        : await readAllRunStates(projectRoot);
+    const items = states
+        .filter((state) => state.status !== 'archived')
+        .flatMap((state) => Object.values(state.delegations).map((delegation) => delegationQueueItemFromRunState(state, delegation)))
+        .sort((left, right) => left.id.localeCompare(right.id));
+    return {
+        version: DELEGATION_QUEUE_CONTRACT_VERSION,
+        items
+    };
+}
+export async function inspectDelegationQueueItem(projectRoot, queueItemId) {
+    const snapshot = await listDelegationQueueItems(projectRoot);
+    return snapshot.items.find((item) => item.id === queueItemId) ?? null;
+}
+function delegationQueueItemFromRunState(state, delegation) {
+    return {
+        id: `${state.runId}:${delegation.delegationId}`,
+        runId: state.runId,
+        delegationId: delegation.delegationId,
+        taskId: delegation.task,
+        agent: delegation.agent,
+        requestedCapabilityId: 'sdd-cli',
+        dedupeKey: `${state.runId}:${delegation.task}:${delegation.agent}`,
+        status: delegation.status,
+        statusSource: 'run_state_delegation',
+        runMode: delegation.runMode,
+        expectedArtifact: delegation.expectedArtifact,
+        requiredEvidence: [delegation.expectedArtifact, state.eventLogPath],
+        createdAt: delegation.startedAt,
+        updatedAt: delegation.terminalEventAt ?? delegation.lastHeartbeatAt ?? state.updatedAt
+    };
+}
+async function assertProjectConfigReadable(projectRoot) {
+    const configPath = getProjectConfigPath(projectRoot);
+    const raw = await readFile(configPath, 'utf8');
+    parseProjectConfig(raw, configPath);
+}
+//# sourceMappingURL=queue.js.map

package/packages/core/dist/delegation/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../src/delegation/queue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAI3E,MAAM,CAAC,MAAM,iCAAiC,GAAG,wCAAwC,CAAC;AAO1F,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,WAAmB,EAAE,UAA8B,EAAE;IAClG,MAAM,2BAA2B,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK;QAC1B,CAAC,CAAC,CAAC,MAAM,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAClD,CAAC,CAAC,MAAM,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,MAAM;SACjB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,UAAU,CAAC;SAC9C,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,+BAA+B,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;SAC5H,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1D,OAAO;QACL,OAAO,EAAE,iCAAiC;QAC1C,KAAK;KACN,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,WAAmB,EAAE,WAAmB;IACvF,MAAM,QAAQ,GAAG,MAAM,wBAAwB,CAAC,WAAW,CAAC,CAAC;IAC7D,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,WAAW,CAAC,IAAI,IAAI,CAAC;AACxE,CAAC;AAED,SAAS,+BAA+B,CAAC,KAAe,EAAE,UAAoC;IAC5F,OAAO;QACL,EAAE,EAAE,GAAG,KAAK,CAAC,KAAK,IAAI,UAAU,CAAC,YAAY,EAAE;QAC/C,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,YAAY,EAAE,UAAU,CAAC,YAAY;QACrC,MAAM,EAAE,UAAU,CAAC,IAAI;QACvB,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,qBAAqB,EAAE,SAAS;QAChC,SAAS,EAAE,GAAG,KAAK,CAAC,KAAK,IAAI,UAAU,CAAC,IAAI,IAAI,UAAU,CAAC,KAAK,EAAE;QAClE,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,YAAY,EAAE,sBAAsB;QACpC,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,gBAAgB,EAAE,UAAU,CAAC,gBAAgB;QAC7C,gBAAgB,EAAE,CAAC,UAAU,CAAC,gBAAgB,EAAE,KAAK,CAAC,YAAY,CAAC;QACnE,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,SAAS,EAAE,UAAU,CAAC,eAAe,IAAI,UAAU,CAAC,eAAe,IAAI,KAAK,CAAC,SAAS;KACvF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,2BAA2B,CAAC,WAAmB;IAC5D,MAAM,UAAU,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC/C,kBAAkB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;AACtC,CAAC"}

package/packages/core/dist/delegation/run-state.d.ts

@@ -0,0 +1,2 @@
+import type { DelegationRecord } from './model.js';
+export declare function persistDelegation(projectRoot: string, runId: string, delegation: DelegationRecord): Promise<void>;

package/packages/core/dist/delegation/run-state.js

@@ -0,0 +1,13 @@
+import { readRunState, writeRunState } from '../run-state/run-state.js';
+export async function persistDelegation(projectRoot, runId, delegation) {
+    const state = await readRunState(projectRoot, runId);
+    await writeRunState(projectRoot, {
+        ...state,
+        status: delegation.status === 'RUNNING' ? 'running' : state.status,
+        delegations: {
+            ...state.delegations,
+            [delegation.delegationId]: delegation
+        }
+    });
+}
+//# sourceMappingURL=run-state.js.map

package/packages/core/dist/delegation/run-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-state.js","sourceRoot":"","sources":["../../src/delegation/run-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAGxE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,WAAmB,EAAE,KAAa,EAAE,UAA4B;IACtG,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACrD,MAAM,aAAa,CAAC,WAAW,EAAE;QAC/B,GAAG,KAAK;QACR,MAAM,EAAE,UAAU,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM;QAClE,WAAW,EAAE;YACX,GAAG,KAAK,CAAC,WAAW;YACpB,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,UAAU;SACtC;KACF,CAAC,CAAC;AACL,CAAC"}

package/packages/core/dist/delegation/state-machine.d.ts

@@ -0,0 +1,30 @@
+export declare const DELEGATION_STATE_MACHINE_VERSION = "phase-3.4-delegation-state-machine-v1";
+export type DelegationStatus = 'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'TIMED_OUT' | 'CANCELLED' | 'RECOVERABLE' | 'STALE';
+export interface ContractValidationIssue {
+    field: string;
+    message: string;
+    recommendation: string;
+}
+export interface DelegationStateTransition {
+    from: DelegationStatus;
+    to: DelegationStatus;
+    event: string;
+    terminal: boolean;
+}
+export interface DelegationStateMachine {
+    version: string;
+    statuses: DelegationStatus[];
+    terminalStatuses: DelegationStatus[];
+    transitions: DelegationStateTransition[];
+}
+export interface DelegationStateTransitionValidation {
+    valid: boolean;
+    from: DelegationStatus;
+    to: DelegationStatus;
+    event: string | null;
+    issues: ContractValidationIssue[];
+}
+export declare const DELEGATION_STATUSES: DelegationStatus[];
+export declare const TERMINAL_DELEGATION_STATUSES: DelegationStatus[];
+export declare function getDelegationStateMachine(): DelegationStateMachine;
+export declare function validateDelegationStateTransition(from: DelegationStatus, to: DelegationStatus, event?: string | null): DelegationStateTransitionValidation;