sdd-agent-platform 0.4.1 → 0.4.2

package/packages/core/dist/storage/runtime-store.d.ts

@@ -4,8 +4,10 @@ import type { AgentExecutionRecord, TeamSessionRecord } from '../router/agent-ru
 import type { ResidentWorkerRuntimeRecord } from '../execution/resident-worker.js';
 import { type FanInEvidenceSetRecord, type LlmAdvisorAssessmentRecord, type StageRoleResultRecord, type StageTeamSessionRecord } from '../execution/stage-team-runtime.js';
 import type { WorkflowGateDecision, WorkflowGateDecisionKind } from '../workflow-gate/types.js';
-export declare const RUNTIME_STORE_SCHEMA_VERSION = 6;
-export declare const RUNTIME_STORE_CONTRACT_VERSION = "phase-8.17-validation-wave-runtime-v6";
+import type { RegisteredStageArtifact } from '../stage-artifacts.js';
+import type { RegisteredStageCollaborationContract } from '../stage-collaboration-contracts.js';
+export declare const RUNTIME_STORE_SCHEMA_VERSION = 12;
+export declare const RUNTIME_STORE_CONTRACT_VERSION = "phase-9.1-stage-collaboration-contracts-runtime-v12";
 export type RuntimeStoreIssueCode = 'STORE_UNAVAILABLE' | 'SCHEMA_MISMATCH' | 'LEGACY_IMPORT_FAILED';
 export type RuntimeStoreDatabase = {
     exec(sql: string): unknown;
@@ -33,7 +35,7 @@ export interface RuntimeStoreDoctorCheck {
     message: string;
     action?: string;
 }
-export type RuntimeArtifactPayloadStatus = 'active' | 'candidate' | 'rejected' | 'superseded';
+export type RuntimeArtifactPayloadStatus = 'active' | 'candidate' | 'partial' | 'active_attempt' | 'rejected' | 'superseded' | 'quarantined' | 'stale';
 export interface RuntimeArtifactPayloadRecord {
     payloadId: string;
     runId: string;
@@ -50,20 +52,44 @@ export interface RuntimeArtifactPayloadRecord {
     createdAt: string;
     payload: unknown;
 }
-export interface RuntimeSyncBackDecisionRecord {
-    decisionId: string;
-    runId: string;
-    branch: string;
-    taskId: string | null;
-    status: string;
-    proposalPath: string | null;
-    proposalDigest: string | null;
-    proposalPayloadId: string | null;
-    reasons: string[];
+export type RuntimeEvidenceSetScopeKind = 'task' | 'batch' | 'wave' | 'ship';
+export type RuntimeEvidenceSetStatus = 'candidate' | 'accepted' | 'partial' | 'rejected' | 'superseded' | 'quarantined' | 'stale';
+export interface RuntimeEvidenceSetItemRecord {
+    evidenceSetId: string;
+    payloadId: string;
+    logicalRef: string;
+    role: string;
+    required: boolean;
+    digestAtSelection: string;
+}
+export interface RuntimeEvidenceSetRecord {
+    evidenceSetId: string;
+    branchSlug: string;
+    scopeKind: RuntimeEvidenceSetScopeKind;
+    scopeId: string;
+    sourceRunId: string | null;
+    documentContractHashes: Record<string, string | null>;
+    gateDecisionId: string | null;
+    status: RuntimeEvidenceSetStatus;
     createdAt: string;
-    updatedAt: string;
+    items: RuntimeEvidenceSetItemRecord[];
     payload: unknown;
 }
+export interface RuntimeSelectionPointerRecord {
+    branchSlug: string;
+    scopeKind: RuntimeEvidenceSetScopeKind;
+    scopeId: string;
+    selectedEvidenceSetId: string;
+    selectedAt: string;
+    selectedByGateDecisionId: string | null;
+    reason: string;
+}
+export interface RuntimeResolvedEvidenceSelection {
+    source: 'selection_pointer' | 'candidate_payloads' | 'legacy_active_payloads' | 'none';
+    evidenceSet: RuntimeEvidenceSetRecord | null;
+    pointer: RuntimeSelectionPointerRecord | null;
+    payloads: RuntimeArtifactPayloadRecord[];
+}
 export type RuntimeDurableGapSeverity = 'info' | 'warning' | 'blocking';
 export type RuntimeDurableGapStatus = 'open' | 'acknowledged' | 'resolved' | 'waived' | 'superseded';
 export type RuntimeDurableGapSource = 'runtime' | 'gate_policy' | 'doctor' | 'validator' | 'agent' | 'team' | 'llm_advisor' | 'import';
@@ -126,6 +152,84 @@ export interface RuntimeAcceptanceEvidenceMapRecord {
     createdAt: string;
     payload: unknown;
 }
+export type RuntimeValidationCacheEntryStatus = 'valid' | 'stale' | 'superseded';
+export interface RuntimeValidationCacheEntryRecord {
+    cacheKey: string;
+    branchSlug: string;
+    command: string;
+    status: RuntimeValidationCacheEntryStatus;
+    sourceTestRunId: string;
+    sourceRunId: string;
+    sourceEvidenceSetId: string | null;
+    outputArtifact: string | null;
+    stdoutDigest: string;
+    stderrDigest: string;
+    createdAt: string;
+    lastUsedAt: string;
+    payload: unknown;
+}
+export interface RuntimeValidationCacheUseRecord {
+    useId: string;
+    cacheKey: string;
+    branchSlug: string;
+    testRunId: string;
+    runId: string;
+    taskId: string;
+    sourceTestRunId: string;
+    sourceEvidenceSetId: string | null;
+    reusedAt: string;
+    mappedTaskIds: string[];
+    reason: string;
+    payload: unknown;
+}
+export type RuntimeRepairType = 'contract_repair' | 'implementation_repair' | 'validation_command_repair' | 'artifact_repair' | 'environment_repair' | 'gate_policy_repair' | 'migration_repair';
+export type RuntimeRepairStatus = 'open' | 'in_progress' | 'resolved' | 'superseded';
+export interface RuntimeRepairRecord {
+    repairId: string;
+    branchSlug: string;
+    taskId: string | null;
+    repairType: RuntimeRepairType;
+    repairOfRunId: string | null;
+    repairOfGateDecisionId: string | null;
+    status: RuntimeRepairStatus;
+    affectedTasks: string[];
+    blockers: string[];
+    recommendedCommands: string[];
+    requiredEvidence: string[];
+    createdAt: string;
+    resolvedAt: string | null;
+    payload: unknown;
+}
+export type RuntimeCapabilityAdoptionStage = 'spec' | 'plan' | 'tasks' | 'verifies' | 'do' | 'test' | 'goal-verify' | 'ship';
+export type RuntimeCapabilityAdoptionStatus = 'adopted' | 'rejected' | 'unresolved';
+export type RuntimeCapabilityAdoptionAuthority = 'sdd_contract' | 'sdd_gate';
+export interface RuntimeCapabilityAdoptionRecord {
+    adoptionId: string;
+    branchSlug: string;
+    lifecycleStage: RuntimeCapabilityAdoptionStage;
+    capabilityDomain: string;
+    sourceId: string | null;
+    status: RuntimeCapabilityAdoptionStatus;
+    reason: string;
+    evidenceRefs: string[];
+    finalAuthority: RuntimeCapabilityAdoptionAuthority;
+    createdAt: string;
+    updatedAt: string;
+    payload: unknown;
+}
+export interface RuntimeStageArtifactFilter {
+    branchSlug?: string | null;
+    stage?: string | null;
+    artifactKind?: string | null;
+    producer?: string | null;
+    artifactRef?: string | null;
+}
+export interface RuntimeStageCollaborationContractFilter {
+    branchSlug?: string | null;
+    stage?: string | null;
+    status?: RegisteredStageCollaborationContract['status'] | null;
+    contractRef?: string | null;
+}
 export declare function withRuntimeStore<T>(projectRoot: string, fn: (store: RuntimeStoreHandle) => T | Promise<T>): Promise<T>;
 export declare function recordRuntimeEvent(projectRoot: string, event: RuntimeEvent, source?: string): Promise<void>;
 export declare function importLegacyRunEventsIfNeeded(projectRoot: string, runId: string, eventPath: string): Promise<void>;
@@ -185,6 +289,12 @@ export declare function recordRuntimeEvidenceAttachment(projectRoot: string, inp
     bytes: number;
     payload?: unknown;
 }): Promise<void>;
+export declare function recordRuntimeStageArtifact(projectRoot: string, record: RegisteredStageArtifact): Promise<RegisteredStageArtifact>;
+export declare function listRuntimeStageArtifacts(projectRoot: string, filter?: RuntimeStageArtifactFilter): Promise<RegisteredStageArtifact[]>;
+export declare function readRuntimeStageArtifact(projectRoot: string, artifactId: string): Promise<RegisteredStageArtifact | null>;
+export declare function recordRuntimeStageCollaborationContract(projectRoot: string, record: RegisteredStageCollaborationContract): Promise<RegisteredStageCollaborationContract>;
+export declare function listRuntimeStageCollaborationContracts(projectRoot: string, filter?: RuntimeStageCollaborationContractFilter): Promise<RegisteredStageCollaborationContract[]>;
+export declare function readRuntimeStageCollaborationContract(projectRoot: string, contractId: string): Promise<RegisteredStageCollaborationContract | null>;
 export declare function recordRuntimeArtifactPayload(projectRoot: string, input: Omit<RuntimeArtifactPayloadRecord, 'sequence' | 'supersedes' | 'createdAt'> & {
     sequence?: number;
     supersedes?: string | null;
@@ -198,9 +308,19 @@ export declare function listRuntimeArtifactPayloads(projectRoot: string, input?:
     logicalRef?: string | null;
     status?: RuntimeArtifactPayloadStatus | null;
 }): Promise<RuntimeArtifactPayloadRecord[]>;
-export declare function recordRuntimeSyncBackDecision(projectRoot: string, record: RuntimeSyncBackDecisionRecord): Promise<void>;
-export declare function readRuntimeSyncBackDecision(projectRoot: string, runId: string, taskId?: string | null): Promise<RuntimeSyncBackDecisionRecord | null>;
-export declare function listRuntimeSyncBackDecisions(projectRoot: string, runId: string): Promise<RuntimeSyncBackDecisionRecord[]>;
+export declare function createRuntimeEvidenceSet(projectRoot: string, input: Omit<RuntimeEvidenceSetRecord, 'createdAt'> & {
+    createdAt?: string;
+}): Promise<RuntimeEvidenceSetRecord>;
+export declare function updateRuntimeSelectionPointer(projectRoot: string, pointer: RuntimeSelectionPointerRecord): Promise<RuntimeSelectionPointerRecord>;
+export declare function resolveRuntimeSelectedEvidence(projectRoot: string, input: {
+    branchSlug: string;
+    scopeKind: RuntimeEvidenceSetScopeKind;
+    scopeId: string;
+    fallbackRunIds?: string[];
+    fallbackTaskIds?: string[];
+    fallbackLogicalRefPrefixes?: string[];
+    allowCandidateFallback?: boolean;
+}): Promise<RuntimeResolvedEvidenceSelection>;
 export declare function recordRuntimeDurableGap(projectRoot: string, input: Omit<RuntimeDurableGapRecord, 'createdAt' | 'updatedAt' | 'closedAt'> & {
     createdAt?: string;
     updatedAt?: string;
@@ -272,12 +392,44 @@ export interface RuntimeTestStepRecord {
     status: string;
     exitCode: number | null;
     durationMs: number;
-    outputArtifact: string;
+    outputArtifact: string | null;
     payload: unknown;
 }
 export declare function recordRuntimeTestRun(projectRoot: string, record: RuntimeTestRunRecord): Promise<void>;
 export declare function recordRuntimeTestStep(projectRoot: string, record: RuntimeTestStepRecord): Promise<void>;
+export declare function listRuntimeTestSteps(projectRoot: string, input?: {
+    runId?: string | null;
+    testRunId?: string | null;
+}): Promise<RuntimeTestStepRecord[]>;
 export declare function listRuntimeTestRuns(projectRoot: string, runId?: string | null): Promise<RuntimeTestRunRecord[]>;
+export declare function recordRuntimeValidationCacheEntry(projectRoot: string, record: RuntimeValidationCacheEntryRecord): Promise<void>;
+export declare function readRuntimeValidationCacheEntry(projectRoot: string, input: {
+    branchSlug: string;
+    cacheKey: string;
+}): Promise<RuntimeValidationCacheEntryRecord | null>;
+export declare function listRuntimeValidationCacheEntries(projectRoot: string, input?: {
+    branchSlug?: string | null;
+    status?: RuntimeValidationCacheEntryStatus | null;
+}): Promise<RuntimeValidationCacheEntryRecord[]>;
+export declare function recordRuntimeValidationCacheUse(projectRoot: string, record: RuntimeValidationCacheUseRecord): Promise<void>;
+export declare function listRuntimeValidationCacheUses(projectRoot: string, input?: {
+    branchSlug?: string | null;
+    runId?: string | null;
+    taskId?: string | null;
+}): Promise<RuntimeValidationCacheUseRecord[]>;
+export declare function recordRuntimeRepair(projectRoot: string, record: RuntimeRepairRecord): Promise<void>;
+export declare function listRuntimeRepairs(projectRoot: string, input?: {
+    branchSlug?: string | null;
+    taskId?: string | null;
+    status?: RuntimeRepairStatus | null;
+}): Promise<RuntimeRepairRecord[]>;
+export declare function recordRuntimeCapabilityAdoption(projectRoot: string, record: RuntimeCapabilityAdoptionRecord): Promise<void>;
+export declare function listRuntimeCapabilityAdoptions(projectRoot: string, input?: {
+    branchSlug?: string | null;
+    lifecycleStage?: RuntimeCapabilityAdoptionStage | null;
+    capabilityDomain?: string | null;
+    status?: RuntimeCapabilityAdoptionStatus | null;
+}): Promise<RuntimeCapabilityAdoptionRecord[]>;
 export declare function recordRuntimeValidationEnvironmentSession(projectRoot: string, record: RuntimeValidationEnvironmentSessionRecord): Promise<void>;
 export declare function listRuntimeValidationEnvironmentSessions(projectRoot: string, input?: {
     partition?: string | null;