@treeseed/sdk 0.6.8 → 0.6.10

package/dist/workflow/operations.d.ts

@@ -1,10 +1,10 @@
 import { resolveTreeseedWorkflowState, type TreeseedWorkflowStatusOptions } from '../workflow-state.ts';
 import { type TreeseedWorkflowRunCommand, type TreeseedWorkflowRunJournal } from './runs.ts';
 import { type TreeseedWorkflowMode } from './session.ts';
-import type { TreeseedCloseInput, TreeseedConfigInput, TreeseedDestroyInput, TreeseedExportInput, TreeseedReleaseInput, TreeseedRecoverInput, TreeseedResumeInput, TreeseedSaveInput, TreeseedStageInput, TreeseedSwitchInput, TreeseedTaskBranchMetadata, TreeseedWorkflowContext, TreeseedWorkflowDevInput, TreeseedWorkflowOperationId, TreeseedWorkflowResult } from '../workflow.ts';
+import type { TreeseedCloseInput, TreeseedConfigInput, TreeseedDestroyInput, TreeseedExportInput, TreeseedReleaseInput, TreeseedRecoverInput, TreeseedResumeInput, TreeseedSaveInput, TreeseedStageInput, TreeseedSwitchInput, TreeseedTaskBranchMetadata, TreeseedWorkflowContext, TreeseedWorkflowDevInput, TreeseedWorkflowOperationId, TreeseedWorkflowResult, TreeseedWorkflowWorktreeMode } from '../workflow.ts';
 type WorkflowWrite = NonNullable<TreeseedWorkflowContext['write']>;
 type WorkflowStatePayload = ReturnType<typeof resolveTreeseedWorkflowState>;
-export type TreeseedWorkflowErrorCode = 'validation_failed' | 'merge_conflict' | 'missing_runtime_auth' | 'deployment_timeout' | 'confirmation_required' | 'unsupported_transport' | 'unsupported_state' | 'workflow_locked' | 'resume_unavailable' | 'workflow_contract_missing';
+export type TreeseedWorkflowErrorCode = 'validation_failed' | 'merge_conflict' | 'missing_runtime_auth' | 'deployment_timeout' | 'confirmation_required' | 'unsupported_transport' | 'unsupported_state' | 'workflow_locked' | 'resume_unavailable' | 'workflow_contract_missing' | 'github_workflow_failed' | 'github_auth_unavailable';
 export declare class TreeseedWorkflowError extends Error {
     code: TreeseedWorkflowErrorCode;
     operation: TreeseedWorkflowOperationId;
@@ -41,6 +41,7 @@ type WorkflowRepoReport = {
     commitSha: string | null;
     skippedReason: string | null;
     publishWait: Record<string, unknown> | null;
+    workflowGates: Array<Record<string, unknown>>;
 };
 export declare function workflowStatus(helpers: WorkflowOperationHelpers, input?: TreeseedWorkflowStatusOptions): Promise<TreeseedWorkflowResult<import("../workflow-state.ts").TreeseedWorkflowState>>;
 export declare function workflowTasks(helpers: WorkflowOperationHelpers): Promise<TreeseedWorkflowResult<{
@@ -246,44 +247,28 @@ export declare function workflowConfig(helpers: WorkflowOperationHelpers, input?
 } & {
     finalState?: WorkflowStatePayload;
 }>>;
-export declare function workflowExport(helpers: WorkflowOperationHelpers, input?: TreeseedExportInput): Promise<TreeseedWorkflowResult<import("../operations/services/export-runtime.ts").TreeseedExportResult & {
-    finalState?: WorkflowStatePayload;
-}>>;
-export declare function workflowSwitch(helpers: WorkflowOperationHelpers, input: TreeseedSwitchInput): Promise<TreeseedWorkflowResult<{
-    mode: TreeseedWorkflowMode;
-    branchName: string;
-    rootRepo: WorkflowRepoReport;
-    repos: WorkflowRepoReport[];
-    previewRequested: boolean;
-    blockers: string[];
-    plannedSteps: {
-        id: string;
-        description: string;
-    }[];
-} & {
-    finalState?: WorkflowStatePayload;
-}> | TreeseedWorkflowResult<{
-    mode: TreeseedWorkflowMode;
-    branchName: string;
-    created: boolean;
-    resumed: boolean;
-    repos: WorkflowRepoReport[];
-    rootRepo: WorkflowRepoReport;
-    previewRequested: boolean;
-    preview: {
-        enabled: boolean;
-        url: string | null;
-        lastDeploymentTimestamp: string | null;
-    };
-    previewResult: Record<string, unknown> | null;
-    workspaceLinks: import("../operations/services/workspace-dependency-mode.ts").WorkspaceDependencyModeReport;
-    preconditions: {
-        cleanWorktreeRequired: boolean;
-        baseBranch: string;
+export declare function workflowExport(helpers: WorkflowOperationHelpers, input?: TreeseedExportInput): Promise<TreeseedWorkflowResult<{
+    worktreeMode: TreeseedWorkflowWorktreeMode;
+    managedWorktree: import("./worktrees.ts").ManagedWorkflowWorktreeMetadata | null;
+    worktreePath: string | null;
+    primaryRoot: string | null;
+    directory: string;
+    tenantRoot: string;
+    outputPath: string;
+    branch: string;
+    timestamp: string;
+    includedBundlePaths: string[];
+    ignorePatterns: string[];
+    summary: {
+        totalFiles: number;
+        totalCharacters: number;
+        totalTokens: number;
+        outputFiles: string[];
     };
 } & {
     finalState?: WorkflowStatePayload;
 }>>;
+export declare function workflowSwitch(helpers: WorkflowOperationHelpers, input: TreeseedSwitchInput): any;
 export declare function workflowDev(helpers: WorkflowOperationHelpers, input?: TreeseedWorkflowDevInput): Promise<TreeseedWorkflowResult<{
     watch: boolean;
     background: boolean;
@@ -328,6 +313,17 @@ export declare function workflowDev(helpers: WorkflowOperationHelpers, input?: T
     finalState?: WorkflowStatePayload;
 }>>;
 export declare function workflowSave(helpers: WorkflowOperationHelpers, input: TreeseedSaveInput): Promise<TreeseedWorkflowResult<{
+    repositoryPlan: import("../operations/services/repository-save-orchestrator.ts").RepositorySavePlan;
+    waves: import("../operations/services/repository-save-orchestrator.ts").RepositorySavePlanWave[];
+    plannedVersions: Record<string, string>;
+    plannedSteps: {
+        id: string;
+        description: string;
+    }[];
+    worktreeMode: TreeseedWorkflowWorktreeMode;
+    managedWorktree: import("./worktrees.ts").ManagedWorkflowWorktreeMetadata | null;
+    worktreePath: string | null;
+    primaryRoot: string | null;
     mode: TreeseedWorkflowMode;
     branch: string;
     scope: string;
@@ -347,16 +343,15 @@ export declare function workflowSave(helpers: WorkflowOperationHelpers, input: T
         } | null;
     } | null;
     workspaceLinks: import("../operations/services/workspace-dependency-mode.ts").WorkspaceDependencyModeReport;
-    repositoryPlan: import("../operations/services/repository-save-orchestrator.ts").RepositorySavePlan;
-    waves: import("../operations/services/repository-save-orchestrator.ts").RepositorySavePlanWave[];
-    plannedVersions: Record<string, string>;
-    plannedSteps: {
-        id: string;
-        description: string;
-    }[];
+    ciMode: "hosted" | "off";
+    verifyMode: "action-first" | "local-only" | import("../workflow.ts").TreeseedWorkflowVerifyMode;
 } & {
     finalState?: WorkflowStatePayload;
 }> | TreeseedWorkflowResult<{
+    worktreeMode: TreeseedWorkflowWorktreeMode;
+    managedWorktree: import("./worktrees.ts").ManagedWorkflowWorktreeMetadata | null;
+    worktreePath: string | null;
+    primaryRoot: string | null;
     mode: "root-only" | "recursive-workspace";
     branch: string;
     scope: string;
@@ -404,13 +399,24 @@ export declare function workflowSave(helpers: WorkflowOperationHelpers, input: T
             lockfileValidation: import("../operations/services/repository-save-orchestrator.ts").RepositoryLockfileValidationResult | null;
         }[];
     };
+    ciMode: "hosted" | "off";
+    verifyMode: "action-first" | "local-only" | import("../workflow.ts").TreeseedWorkflowVerifyMode;
+    workflowGates: Record<string, unknown>[] | {
+        name: string;
+        repository: string | null;
+        workflow: string;
+        branch: string;
+        headSha: string;
+        status: string;
+        reason: string;
+        conclusion: null;
+        runId: null;
+        url: null;
+    }[];
 } & {
     finalState?: WorkflowStatePayload;
 }>>;
 export declare function workflowClose(helpers: WorkflowOperationHelpers, input: TreeseedCloseInput): Promise<TreeseedWorkflowResult<{
-    mode: TreeseedWorkflowMode;
-    branchName: string | null;
-    message: string;
     autoSaveRequired: boolean;
     repos: WorkflowRepoReport[];
     rootRepo: WorkflowRepoReport;
@@ -419,6 +425,23 @@ export declare function workflowClose(helpers: WorkflowOperationHelpers, input:
         id: string;
         description: string;
     }[];
+    worktreeMode: TreeseedWorkflowWorktreeMode;
+    managedWorktree: import("./worktrees.ts").ManagedWorkflowWorktreeMetadata | null;
+    worktreePath: string | null;
+    primaryRoot: string | null;
+    mode: TreeseedWorkflowMode;
+    branchName: string | null;
+    message: string;
+    autoResumeCandidate: {
+        runId: string;
+        branch: string | null;
+        failure: {
+            code: string;
+            message: string;
+            details: Record<string, unknown> | null;
+            at: string;
+        } | null;
+    } | null;
 } & {
     finalState?: WorkflowStatePayload;
 }> | TreeseedWorkflowResult<{
@@ -427,6 +450,17 @@ export declare function workflowClose(helpers: WorkflowOperationHelpers, input:
     message: string;
     autoSaved: boolean;
     autoSaveResult: ({
+        repositoryPlan: import("../operations/services/repository-save-orchestrator.ts").RepositorySavePlan;
+        waves: import("../operations/services/repository-save-orchestrator.ts").RepositorySavePlanWave[];
+        plannedVersions: Record<string, string>;
+        plannedSteps: {
+            id: string;
+            description: string;
+        }[];
+        worktreeMode: TreeseedWorkflowWorktreeMode;
+        managedWorktree: import("./worktrees.ts").ManagedWorkflowWorktreeMetadata | null;
+        worktreePath: string | null;
+        primaryRoot: string | null;
         mode: TreeseedWorkflowMode;
         branch: string;
         scope: string;
@@ -446,16 +480,15 @@ export declare function workflowClose(helpers: WorkflowOperationHelpers, input:
             } | null;
         } | null;
         workspaceLinks: import("../operations/services/workspace-dependency-mode.ts").WorkspaceDependencyModeReport;
-        repositoryPlan: import("../operations/services/repository-save-orchestrator.ts").RepositorySavePlan;
-        waves: import("../operations/services/repository-save-orchestrator.ts").RepositorySavePlanWave[];
-        plannedVersions: Record<string, string>;
-        plannedSteps: {
-            id: string;
-            description: string;
-        }[];
+        ciMode: "hosted" | "off";
+        verifyMode: "action-first" | "local-only" | import("../workflow.ts").TreeseedWorkflowVerifyMode;
     } & {
         finalState?: WorkflowStatePayload;
     }) | ({
+        worktreeMode: TreeseedWorkflowWorktreeMode;
+        managedWorktree: import("./worktrees.ts").ManagedWorkflowWorktreeMetadata | null;
+        worktreePath: string | null;
+        primaryRoot: string | null;
         mode: "root-only" | "recursive-workspace";
         branch: string;
         scope: string;
@@ -503,6 +536,20 @@ export declare function workflowClose(helpers: WorkflowOperationHelpers, input:
                 lockfileValidation: import("../operations/services/repository-save-orchestrator.ts").RepositoryLockfileValidationResult | null;
             }[];
         };
+        ciMode: "hosted" | "off";
+        verifyMode: "action-first" | "local-only" | import("../workflow.ts").TreeseedWorkflowVerifyMode;
+        workflowGates: Record<string, unknown>[] | {
+            name: string;
+            repository: string | null;
+            workflow: string;
+            branch: string;
+            headSha: string;
+            status: string;
+            reason: string;
+            conclusion: null;
+            runId: null;
+            url: null;
+        }[];
     } & {
         finalState?: WorkflowStatePayload;
     }) | null;
@@ -522,15 +569,27 @@ export declare function workflowClose(helpers: WorkflowOperationHelpers, input:
     localDeleted: boolean;
     finalBranch: string;
     workspaceLinks: import("../operations/services/workspace-dependency-mode.ts").WorkspaceDependencyModeReport;
+    worktreeCleanup: {
+        removed: boolean;
+        reason: string;
+        worktreePath?: undefined;
+        primaryRoot?: undefined;
+        branch?: undefined;
+    } | {
+        removed: boolean;
+        worktreePath: string;
+        primaryRoot: string;
+        branch: string;
+        reason?: undefined;
+    };
+    worktreeMode: TreeseedWorkflowWorktreeMode;
+    managedWorktree: import("./worktrees.ts").ManagedWorkflowWorktreeMetadata | null;
+    worktreePath: string | null;
+    primaryRoot: string | null;
 } & {
     finalState?: WorkflowStatePayload;
 }>>;
 export declare function workflowStage(helpers: WorkflowOperationHelpers, input: TreeseedStageInput): Promise<TreeseedWorkflowResult<{
-    mode: TreeseedWorkflowMode;
-    branchName: string | null;
-    mergeTarget: string;
-    mergeStrategy: string;
-    message: string;
     autoSaveRequired: boolean;
     blockers: string[];
     rootRepo: WorkflowRepoReport;
@@ -539,6 +598,26 @@ export declare function workflowStage(helpers: WorkflowOperationHelpers, input:
         id: string;
         description: string;
     }[];
+    worktreeMode: TreeseedWorkflowWorktreeMode;
+    managedWorktree: import("./worktrees.ts").ManagedWorkflowWorktreeMetadata | null;
+    worktreePath: string | null;
+    primaryRoot: string | null;
+    mode: TreeseedWorkflowMode;
+    branchName: string | null;
+    mergeTarget: string;
+    mergeStrategy: string;
+    message: string;
+    ciMode: "hosted" | "off";
+    autoResumeCandidate: {
+        runId: string;
+        branch: string | null;
+        failure: {
+            code: string;
+            message: string;
+            details: Record<string, unknown> | null;
+            at: string;
+        } | null;
+    } | null;
 } & {
     finalState?: WorkflowStatePayload;
 }> | TreeseedWorkflowResult<{
@@ -549,6 +628,17 @@ export declare function workflowStage(helpers: WorkflowOperationHelpers, input:
     message: string;
     autoSaved: boolean;
     autoSaveResult: ({
+        repositoryPlan: import("../operations/services/repository-save-orchestrator.ts").RepositorySavePlan;
+        waves: import("../operations/services/repository-save-orchestrator.ts").RepositorySavePlanWave[];
+        plannedVersions: Record<string, string>;
+        plannedSteps: {
+            id: string;
+            description: string;
+        }[];
+        worktreeMode: TreeseedWorkflowWorktreeMode;
+        managedWorktree: import("./worktrees.ts").ManagedWorkflowWorktreeMetadata | null;
+        worktreePath: string | null;
+        primaryRoot: string | null;
         mode: TreeseedWorkflowMode;
         branch: string;
         scope: string;
@@ -568,16 +658,15 @@ export declare function workflowStage(helpers: WorkflowOperationHelpers, input:
             } | null;
         } | null;
         workspaceLinks: import("../operations/services/workspace-dependency-mode.ts").WorkspaceDependencyModeReport;
-        repositoryPlan: import("../operations/services/repository-save-orchestrator.ts").RepositorySavePlan;
-        waves: import("../operations/services/repository-save-orchestrator.ts").RepositorySavePlanWave[];
-        plannedVersions: Record<string, string>;
-        plannedSteps: {
-            id: string;
-            description: string;
-        }[];
+        ciMode: "hosted" | "off";
+        verifyMode: "action-first" | "local-only" | import("../workflow.ts").TreeseedWorkflowVerifyMode;
     } & {
         finalState?: WorkflowStatePayload;
     }) | ({
+        worktreeMode: TreeseedWorkflowWorktreeMode;
+        managedWorktree: import("./worktrees.ts").ManagedWorkflowWorktreeMetadata | null;
+        worktreePath: string | null;
+        primaryRoot: string | null;
         mode: "root-only" | "recursive-workspace";
         branch: string;
         scope: string;
@@ -625,6 +714,20 @@ export declare function workflowStage(helpers: WorkflowOperationHelpers, input:
                 lockfileValidation: import("../operations/services/repository-save-orchestrator.ts").RepositoryLockfileValidationResult | null;
             }[];
         };
+        ciMode: "hosted" | "off";
+        verifyMode: "action-first" | "local-only" | import("../workflow.ts").TreeseedWorkflowVerifyMode;
+        workflowGates: Record<string, unknown>[] | {
+            name: string;
+            repository: string | null;
+            workflow: string;
+            branch: string;
+            headSha: string;
+            status: string;
+            reason: string;
+            conclusion: null;
+            runId: null;
+            url: null;
+        }[];
     } & {
         finalState?: WorkflowStatePayload;
     }) | null;
@@ -636,12 +739,7 @@ export declare function workflowStage(helpers: WorkflowOperationHelpers, input:
     rootRepo: WorkflowRepoReport;
     stagingWait: {
         status: string;
-        reason: string;
-        branch?: undefined;
-    } | {
-        status: string;
-        branch: string;
-        reason?: undefined;
+        workflowGates: any;
     };
     previewCleanup: {
         performed: boolean;
@@ -655,6 +753,25 @@ export declare function workflowStage(helpers: WorkflowOperationHelpers, input:
     localDeleted: boolean;
     finalBranch: string;
     workspaceLinks: import("../operations/services/workspace-dependency-mode.ts").WorkspaceDependencyModeReport;
+    ciMode: "hosted" | "off";
+    workflowGates: any;
+    worktreeCleanup: {
+        removed: boolean;
+        reason: string;
+        worktreePath?: undefined;
+        primaryRoot?: undefined;
+        branch?: undefined;
+    } | {
+        removed: boolean;
+        worktreePath: string;
+        primaryRoot: string;
+        branch: string;
+        reason?: undefined;
+    };
+    worktreeMode: TreeseedWorkflowWorktreeMode;
+    managedWorktree: import("./worktrees.ts").ManagedWorkflowWorktreeMetadata | null;
+    worktreePath: string | null;
+    primaryRoot: string | null;
 } & {
     finalState?: WorkflowStatePayload;
 }>>;
@@ -669,6 +786,11 @@ export declare function workflowRelease(helpers: WorkflowOperationHelpers, input
             at: string;
         } | null;
     } | null;
+    worktreeMode: TreeseedWorkflowWorktreeMode;
+    managedWorktree: import("./worktrees.ts").ManagedWorkflowWorktreeMetadata | null;
+    worktreePath: string | null;
+    primaryRoot: string | null;
+    ciMode: "hosted" | "off";
     mode: TreeseedWorkflowMode;
     mergeStrategy: string;
     level: string;
@@ -708,6 +830,10 @@ export declare function workflowRelease(helpers: WorkflowOperationHelpers, input
 } & {
     finalState?: WorkflowStatePayload;
 }> | TreeseedWorkflowResult<{
+    worktreeMode: TreeseedWorkflowWorktreeMode;
+    managedWorktree: import("./worktrees.ts").ManagedWorkflowWorktreeMetadata | null;
+    worktreePath: string | null;
+    primaryRoot: string | null;
     mode: "root-only";
     mergeStrategy: string;
     level: "patch" | "major" | "minor";
@@ -735,9 +861,26 @@ export declare function workflowRelease(helpers: WorkflowOperationHelpers, input
         tagPushed: boolean;
     };
     workspaceLinks: import("../operations/services/workspace-dependency-mode.ts").WorkspaceDependencyModeReport;
+    ciMode: "hosted" | "off";
+    workflowGates: Record<string, unknown>[] | {
+        name: string;
+        repository: string | null;
+        workflow: string;
+        branch: string;
+        headSha: string;
+        status: string;
+        reason: string;
+        conclusion: null;
+        runId: null;
+        url: null;
+    }[];
 } & {
     finalState?: WorkflowStatePayload;
 }> | TreeseedWorkflowResult<{
+    worktreeMode: TreeseedWorkflowWorktreeMode;
+    managedWorktree: import("./worktrees.ts").ManagedWorkflowWorktreeMetadata | null;
+    worktreePath: string | null;
+    primaryRoot: string | null;
     mode: "recursive-workspace";
     mergeStrategy: string;
     level: "patch" | "major" | "minor";
@@ -777,383 +920,70 @@ export declare function workflowRelease(helpers: WorkflowOperationHelpers, input
         tagPushed: boolean;
     };
     workspaceLinks: import("../operations/services/workspace-dependency-mode.ts").WorkspaceDependencyModeReport;
+    ciMode: "hosted" | "off";
+    workflowGates: (Record<string, unknown> | {
+        name: string;
+        repository: string | null;
+        workflow: string;
+        branch: string;
+        headSha: string;
+        status: string;
+        reason: string;
+        conclusion: null;
+        runId: null;
+        url: null;
+    })[];
 } & {
     finalState?: WorkflowStatePayload;
 }>>;
-export declare function workflowResume(helpers: WorkflowOperationHelpers, input: TreeseedResumeInput): Promise<TreeseedWorkflowResult<{
-    mode: TreeseedWorkflowMode;
-    branch: string;
-    scope: string;
-    hotfix: boolean;
-    message: string;
-    repos: import("../operations/services/repository-save-orchestrator.ts").RepositorySavePlanRepo[];
-    rootRepo: import("../operations/services/repository-save-orchestrator.ts").RepositorySavePlanRepo;
-    blockers: string[];
-    autoResumeCandidate: {
+export declare function workflowResume(helpers: WorkflowOperationHelpers, input: TreeseedResumeInput): Promise<any>;
+export declare function workflowRecover(helpers: WorkflowOperationHelpers, input?: TreeseedRecoverInput): Promise<TreeseedWorkflowResult<{
+    lock: import("./runs.ts").TreeseedWorkflowLockInspection;
+    interruptedRuns: {
         runId: string;
-        branch: string | null;
+        command: TreeseedWorkflowRunCommand;
+        status: import("./runs.ts").TreeseedWorkflowRunStatus;
+        createdAt: string;
+        updatedAt: string;
+        nextStep: string | null;
         failure: {
             code: string;
             message: string;
             details: Record<string, unknown> | null;
             at: string;
         } | null;
-    } | null;
-    workspaceLinks: import("../operations/services/workspace-dependency-mode.ts").WorkspaceDependencyModeReport;
-    repositoryPlan: import("../operations/services/repository-save-orchestrator.ts").RepositorySavePlan;
-    waves: import("../operations/services/repository-save-orchestrator.ts").RepositorySavePlanWave[];
-    plannedVersions: Record<string, string>;
-    plannedSteps: {
-        id: string;
-        description: string;
+        resumeCommand: string;
     }[];
-} & {
-    finalState?: WorkflowStatePayload;
-}> | TreeseedWorkflowResult<{
-    mode: "root-only" | "recursive-workspace";
-    branch: string;
-    scope: string;
-    hotfix: boolean;
-    message: string;
-    resumed: boolean;
-    resumedRunId: string | null;
-    autoResumed: boolean;
-    commitSha: string;
-    commitCreated: boolean;
-    noChanges: boolean;
-    branchSync: {
-        pushed: boolean;
-    };
-    repos: import("../operations/services/repository-save-orchestrator.ts").RepositorySaveReport[];
-    rootRepo: import("../operations/services/repository-save-orchestrator.ts").RepositorySaveReport;
-    waves: string[][];
-    plannedVersions: Record<string, string>;
-    partialFailure: null;
-    previewAction: Record<string, unknown>;
-    mergeConflict: null;
-    workspaceLinks: import("../operations/services/workspace-dependency-mode.ts").WorkspaceDependencyModeReport;
-    commandReadiness: {
-        status: string;
-        checks: {
-            exists: boolean;
-            id: string;
-            path: string;
-        }[];
-        missing: {
-            id: string;
-            path: string;
-        }[];
-    } | {
-        status: string;
-        reason: string;
-        checks: never[];
-        missing: never[];
-    };
-    lockfileValidation: {
-        root: import("../operations/services/repository-save-orchestrator.ts").RepositoryLockfileValidationResult | null;
-        repos: {
-            name: string;
-            path: string;
-            lockfileValidation: import("../operations/services/repository-save-orchestrator.ts").RepositoryLockfileValidationResult | null;
-        }[];
-    };
-} & {
-    finalState?: WorkflowStatePayload;
-}> | TreeseedWorkflowResult<{
-    mode: TreeseedWorkflowMode;
-    branchName: string;
-    rootRepo: WorkflowRepoReport;
-    repos: WorkflowRepoReport[];
-    previewRequested: boolean;
-    blockers: string[];
-    plannedSteps: {
-        id: string;
-        description: string;
+    staleRuns: {
+        runId: string;
+        command: TreeseedWorkflowRunCommand;
+        status: import("./runs.ts").TreeseedWorkflowRunStatus;
+        createdAt: string;
+        updatedAt: string;
+        nextStep: string | null;
+        failure: {
+            code: string;
+            message: string;
+            details: Record<string, unknown> | null;
+            at: string;
+        } | null;
+        classification: import("./runs.ts").TreeseedWorkflowRunClassification;
     }[];
-} & {
-    finalState?: WorkflowStatePayload;
-}> | TreeseedWorkflowResult<{
-    mode: TreeseedWorkflowMode;
-    branchName: string;
-    created: boolean;
-    resumed: boolean;
-    repos: WorkflowRepoReport[];
-    rootRepo: WorkflowRepoReport;
-    previewRequested: boolean;
-    preview: {
-        enabled: boolean;
-        url: string | null;
-        lastDeploymentTimestamp: string | null;
-    };
-    previewResult: Record<string, unknown> | null;
-    workspaceLinks: import("../operations/services/workspace-dependency-mode.ts").WorkspaceDependencyModeReport;
-    preconditions: {
-        cleanWorktreeRequired: boolean;
-        baseBranch: string;
-    };
-} & {
-    finalState?: WorkflowStatePayload;
-}> | TreeseedWorkflowResult<{
-    mode: TreeseedWorkflowMode;
-    branchName: string | null;
-    message: string;
-    autoSaveRequired: boolean;
-    repos: WorkflowRepoReport[];
-    rootRepo: WorkflowRepoReport;
-    blockers: string[];
-    plannedSteps: {
-        id: string;
-        description: string;
-    }[];
-} & {
-    finalState?: WorkflowStatePayload;
-}> | TreeseedWorkflowResult<{
-    mode: TreeseedWorkflowMode;
-    branchName: string;
-    message: string;
-    autoSaved: boolean;
-    autoSaveResult: ({
-        mode: TreeseedWorkflowMode;
-        branch: string;
-        scope: string;
-        hotfix: boolean;
-        message: string;
-        repos: import("../operations/services/repository-save-orchestrator.ts").RepositorySavePlanRepo[];
-        rootRepo: import("../operations/services/repository-save-orchestrator.ts").RepositorySavePlanRepo;
-        blockers: string[];
-        autoResumeCandidate: {
-            runId: string;
-            branch: string | null;
-            failure: {
-                code: string;
-                message: string;
-                details: Record<string, unknown> | null;
-                at: string;
-            } | null;
-        } | null;
-        workspaceLinks: import("../operations/services/workspace-dependency-mode.ts").WorkspaceDependencyModeReport;
-        repositoryPlan: import("../operations/services/repository-save-orchestrator.ts").RepositorySavePlan;
-        waves: import("../operations/services/repository-save-orchestrator.ts").RepositorySavePlanWave[];
-        plannedVersions: Record<string, string>;
-        plannedSteps: {
-            id: string;
-            description: string;
-        }[];
-    } & {
-        finalState?: WorkflowStatePayload;
-    }) | ({
-        mode: "root-only" | "recursive-workspace";
-        branch: string;
-        scope: string;
-        hotfix: boolean;
-        message: string;
-        resumed: boolean;
-        resumedRunId: string | null;
-        autoResumed: boolean;
-        commitSha: string;
-        commitCreated: boolean;
-        noChanges: boolean;
-        branchSync: {
-            pushed: boolean;
-        };
-        repos: import("../operations/services/repository-save-orchestrator.ts").RepositorySaveReport[];
-        rootRepo: import("../operations/services/repository-save-orchestrator.ts").RepositorySaveReport;
-        waves: string[][];
-        plannedVersions: Record<string, string>;
-        partialFailure: null;
-        previewAction: Record<string, unknown>;
-        mergeConflict: null;
-        workspaceLinks: import("../operations/services/workspace-dependency-mode.ts").WorkspaceDependencyModeReport;
-        commandReadiness: {
-            status: string;
-            checks: {
-                exists: boolean;
-                id: string;
-                path: string;
-            }[];
-            missing: {
-                id: string;
-                path: string;
-            }[];
-        } | {
-            status: string;
-            reason: string;
-            checks: never[];
-            missing: never[];
-        };
-        lockfileValidation: {
-            root: import("../operations/services/repository-save-orchestrator.ts").RepositoryLockfileValidationResult | null;
-            repos: {
-                name: string;
-                path: string;
-                lockfileValidation: import("../operations/services/repository-save-orchestrator.ts").RepositoryLockfileValidationResult | null;
-            }[];
-        };
-    } & {
-        finalState?: WorkflowStatePayload;
-    }) | null;
-    deprecatedTag: {
-        tagName: string;
-        head: string;
-    };
-    repos: WorkflowRepoReport[];
-    rootRepo: WorkflowRepoReport;
-    previewCleanup: {
-        performed: boolean;
-        state: any;
-    } | {
-        performed: boolean;
-    };
-    remoteDeleted: boolean;
-    localDeleted: boolean;
-    finalBranch: string;
-    workspaceLinks: import("../operations/services/workspace-dependency-mode.ts").WorkspaceDependencyModeReport;
-} & {
-    finalState?: WorkflowStatePayload;
-}> | TreeseedWorkflowResult<{
-    autoResumeCandidate: {
+    obsoleteRuns: {
         runId: string;
-        branch: string | null;
+        command: TreeseedWorkflowRunCommand;
+        status: import("./runs.ts").TreeseedWorkflowRunStatus;
+        createdAt: string;
+        updatedAt: string;
         failure: {
             code: string;
             message: string;
             details: Record<string, unknown> | null;
             at: string;
         } | null;
-    } | null;
-    mode: TreeseedWorkflowMode;
-    mergeStrategy: string;
-    level: string;
-    rootVersion: string;
-    releaseTag: string;
-    stagingBranch: string;
-    productionBranch: string;
-    packageSelection: {
-        changed: string[];
-        dependents: string[];
-        selected: string[];
-    };
-    plannedVersions: any;
-    plannedDevReferenceRewrites: {
-        repoName: string;
-        filePath: string;
-        field?: string;
-        dependencyName?: string;
-        spec: string;
-        reason: string;
-    }[];
-    plannedPublishWaits: {
-        name: string;
-        workflow: string;
-        branch: string;
-        status: string;
-    }[];
-    touchedPackages: string[];
-    repos: WorkflowRepoReport[];
-    rootRepo: WorkflowRepoReport;
-    finalBranch: string;
-    plannedSteps: {
-        id: string;
-        description: string;
-    }[];
-    blockers: string[];
-} & {
-    finalState?: WorkflowStatePayload;
-}> | TreeseedWorkflowResult<{
-    mode: "root-only";
-    mergeStrategy: string;
-    level: "patch" | "major" | "minor";
-    resumed: boolean;
-    resumedRunId: string | null;
-    autoResumed: boolean;
-    rootVersion: string;
-    releaseTag: string;
-    releasedCommit: string;
-    stagingBranch: string;
-    productionBranch: string;
-    touchedPackages: never[];
-    packageSelection: {
-        changed: never[];
-        dependents: never[];
-        selected: never[];
-    };
-    publishWait: never[];
-    repos: never[];
-    rootRepo: WorkflowRepoReport;
-    finalBranch: string;
-    pushStatus: {
-        stagingPushed: boolean;
-        productionPushed: boolean;
-        tagPushed: boolean;
-    };
-    workspaceLinks: import("../operations/services/workspace-dependency-mode.ts").WorkspaceDependencyModeReport;
-} & {
-    finalState?: WorkflowStatePayload;
-}> | TreeseedWorkflowResult<{
-    mode: "recursive-workspace";
-    mergeStrategy: string;
-    level: "patch" | "major" | "minor";
-    resumed: boolean;
-    resumedRunId: string | null;
-    autoResumed: boolean;
-    rootVersion: string;
-    releaseTag: string;
-    releasedCommit: string;
-    stagingBranch: string;
-    productionBranch: string;
-    touchedPackages: string[];
-    packageSelection: {
-        changed: string[];
-        dependents: string[];
-        selected: string[];
-    };
-    replacedDevReferences: (import("../operations/services/package-reference-policy.ts").RewrittenDevReference & {
-        repoName: string;
-        packageJsonPath: string;
-    })[];
-    releaseInstalls: Record<string, unknown>[];
-    devTagCleanup: {
-        status: string;
-        repos: Record<string, unknown>[];
-    } | {
-        status: string;
-        reason: string;
-    };
-    publishWait: Record<string, unknown>[];
-    repos: WorkflowRepoReport[];
-    rootRepo: WorkflowRepoReport;
-    finalBranch: string;
-    pushStatus: {
-        stagingPushed: boolean;
-        productionPushed: boolean;
-        tagPushed: boolean;
-    };
-    workspaceLinks: import("../operations/services/workspace-dependency-mode.ts").WorkspaceDependencyModeReport;
-} & {
-    finalState?: WorkflowStatePayload;
-}> | TreeseedWorkflowResult<{
-    dryRun: boolean;
-    remoteResult: Record<string, unknown> | null;
-    scope: string;
-    force: boolean;
-    destroyRemote: boolean;
-    destroyLocal: boolean;
-    removeBuildArtifacts: boolean;
-    expectedConfirmation: string;
-    stateSummary: {
-        workerName: any;
-        lastDeploymentTimestamp: any;
-    };
-    plannedSteps: {
-        id: string;
-        description: string;
+        classification: import("./runs.ts").TreeseedWorkflowRunClassification;
     }[];
-} & {
-    finalState?: WorkflowStatePayload;
-}>>;
-export declare function workflowRecover(helpers: WorkflowOperationHelpers, input?: TreeseedRecoverInput): Promise<TreeseedWorkflowResult<{
-    lock: import("./runs.ts").TreeseedWorkflowLockInspection;
-    interruptedRuns: {
+    prunedRuns: {
         runId: string;
         command: TreeseedWorkflowRunCommand;
         status: import("./runs.ts").TreeseedWorkflowRunStatus;
@@ -1166,7 +996,7 @@ export declare function workflowRecover(helpers: WorkflowOperationHelpers, input
             details: Record<string, unknown> | null;
             at: string;
         } | null;
-        resumeCommand: string;
+        classification: import("./runs.ts").TreeseedWorkflowRunClassification;
     }[];
     selectedRun: TreeseedWorkflowRunJournal | null;
     runCount: number;