sdd-agent-platform 0.4.0 → 0.4.2

package/packages/core/dist/workflow-state/resolve.d.ts

@@ -1,9 +1,12 @@
-import { WORKFLOW_STATE_RESOLVER_CONTRACT_VERSION } from '../contracts.js';
-import type { RunState, RunSummary } from '../run-state/model.js';
+import { WORKFLOW_STATE_RESOLVER_CONTRACT_VERSION, type SddStage } from '../contracts.js';
+import { type RuntimeRepairRecord } from '../storage/runtime-store.js';
+import type { RunState, RunStateTaskRuntime, RunSummary } from '../run-state/model.js';
 import { type WorkflowAffectedFileConflict } from './affected-file-conflicts.js';
 import { type ContextBranchSource, type ContextResolverContract } from '../sdd-docs/context.js';
 import { type SddTaskGap, type SddTaskModel } from '../sdd-docs/task-parser.js';
 import { type WorkflowDependencyBlocker } from './dependencies.js';
+import { type DocumentCompatibilityClass, type LatestEligibleRunSelection } from './latest-eligible-run.js';
+import { type TruthReconciliationDecision } from '../truth-reconciliation.js';
 export interface WorkflowTaskCounts {
     total: number;
     pending: number;
@@ -21,9 +24,65 @@ export interface WorkflowLatestTaskRun {
     runId: string;
     runStatus: RunState['status'];
     validationStatus: RunState['validation']['status'];
-    syncBackStatus: RunState['syncBack']['status'];
     affectedFiles: string[];
     updatedAt: string;
+    compatibility: DocumentCompatibilityClass;
+    eligibleForDefaultApply: boolean;
+    reasons: string[];
+}
+export type WorkflowCommandSemantics = 'inspection_navigation' | 'gate_execution';
+export type WorkflowHostProjectionStatus = 'active' | 'future' | 'unsupported';
+export type SddCommandBundle = 'spec' | 'plan' | 'tasks' | 'do' | 'test' | 'ship';
+export type BundleResumeMode = 'start' | 'resume' | 'repair' | 'reconcile';
+export type WorkflowNextStage = SddCommandBundle;
+export type WorkflowNextIntentKind = 'start_spec' | 'resolve_task_gaps' | 'inspect_dependency' | 'workflow_complete' | 'ship_readiness' | 'inspect_task' | 'list_tasks' | 'continue_do' | 'run_task_validation' | 'run_batch_validation' | 'run_wave_validation' | 'run_verifies' | 'run_goal_verify' | 'repair_failure' | 'reconcile_truth';
+export declare const COMMAND_BUNDLES: Record<SddCommandBundle, readonly SddStage[]>;
+export interface CommandBundlePlan {
+    contract: 'sdd-command-bundle-plan-v1';
+    branch: string;
+    bundle: SddCommandBundle;
+    stages: SddStage[];
+    targetRuntimeStage: SddStage;
+    resumeMode: BundleResumeMode;
+    canonicalCommand: string;
+    displayCommand: string;
+    canAutoAdvanceWithinBundle: boolean;
+    autoAdvanceTo: SddStage | null;
+    stopReasons: string[];
+    evidenceSurface: string[];
+}
+export interface WorkflowReadinessSummary {
+    requiredTaskIds: string[];
+    acceptedTaskIds: string[];
+    missingTaskIds: string[];
+    readyForShip: boolean;
+    whyNotShip: string[];
+}
+export interface WorkflowHostCommandProjection {
+    host: 'claude_code' | 'codex' | 'opencode';
+    status: WorkflowHostProjectionStatus;
+    entry: string | null;
+    projectionSurfaces: string[];
+    permissionProjection: string;
+    reason: string;
+}
+export interface WorkflowNextIntent {
+    stage: WorkflowNextStage;
+    bundle: SddCommandBundle;
+    targetRuntimeStage: SddStage;
+    resumeMode: BundleResumeMode;
+    intent: WorkflowNextIntentKind;
+    canonicalCommand: string;
+    displayCommand: string;
+    commandSemantics: WorkflowCommandSemantics;
+    evidenceRequirement: string;
+    blockingReason: string | null;
+    canAutoAdvanceWithinBundle: boolean;
+    autoAdvanceTo: SddStage | null;
+    stopReasons: string[];
+    evidenceSurface: string[];
+    commandBundle: CommandBundlePlan;
+    hostProjections: WorkflowHostCommandProjection[];
 }
 export interface WorkflowStateResolution {
     contract: typeof WORKFLOW_STATE_RESOLVER_CONTRACT_VERSION;
@@ -38,13 +97,31 @@ export interface WorkflowStateResolution {
     latestRun: RunSummary | null;
     latestRunState: RunState | null;
     latestRunsByTask: WorkflowLatestTaskRun[];
+    latestEligibleRunsByTask: LatestEligibleRunSelection[];
     affectedFileConflicts: WorkflowAffectedFileConflict[];
     blockingReasons: string[];
     dependencyBlockers: WorkflowDependencyBlocker[];
+    openRepairs: RuntimeRepairRecord[];
+    workflowReadiness: WorkflowReadinessSummary;
+    whyNotShip: string[];
     recommendedNextCommand: string;
+    nextIntent: WorkflowNextIntent;
+    truthReconciliation: TruthReconciliationDecision | null;
 }
 export declare function resolveWorkflowState(projectRoot: string, options?: {
     branch?: string | null;
     branchSource?: ContextBranchSource;
     taskId?: string | null;
 }): Promise<WorkflowStateResolution>;
+export declare function latestRuntimeTaskStates(selections: LatestEligibleRunSelection[], states: RunState[]): Map<string, RunStateTaskRuntime>;
+export interface WorkflowNextIntentOptions {
+    targetRuntimeStage?: SddStage;
+    resumeMode?: BundleResumeMode;
+    displayCommand?: string;
+    canAutoAdvanceWithinBundle?: boolean;
+    autoAdvanceTo?: SddStage | null;
+    stopReasons?: string[];
+    evidenceSurface?: string[];
+}
+export declare function workflowNextIntent(stage: WorkflowNextStage, intent: WorkflowNextIntentKind, canonicalCommand: string, evidenceRequirement: string, blockingReason: string | null, options?: WorkflowNextIntentOptions): WorkflowNextIntent;
+export declare function commandBundleForRuntimeStage(stage: SddStage): SddCommandBundle;