@treeseed/sdk 0.4.12 → 0.5.0

package/dist/workflow/operations.d.ts

@@ -1,9 +1,10 @@
-import { checkTreeseedProviderConnections } from '../operations/services/config-runtime.ts';
 import { resolveTreeseedWorkflowState } from '../workflow-state.ts';
-import type { TreeseedCloseInput, TreeseedConfigInput, TreeseedDestroyInput, TreeseedExportInput, TreeseedReleaseInput, TreeseedSaveInput, TreeseedStageInput, TreeseedSwitchInput, TreeseedTaskBranchMetadata, TreeseedWorkflowContext, TreeseedWorkflowDevInput, TreeseedWorkflowNextStep, TreeseedWorkflowOperationId, TreeseedWorkflowResult } from '../workflow.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';
 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';
+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 declare class TreeseedWorkflowError extends Error {
     code: TreeseedWorkflowErrorCode;
     operation: TreeseedWorkflowOperationId;
@@ -23,17 +24,52 @@ export type WorkflowOperationHelpers = {
         tasks: TreeseedTaskBranchMetadata[];
     }>>;
 };
+type WorkflowRepoReport = {
+    name: string;
+    path: string;
+    branch: string | null;
+    dirty: boolean;
+    created: boolean;
+    resumed: boolean;
+    merged: boolean;
+    verified: boolean;
+    committed: boolean;
+    pushed: boolean;
+    deletedLocal: boolean;
+    deletedRemote: boolean;
+    tagName: string | null;
+    commitSha: string | null;
+    skippedReason: string | null;
+    publishWait: Record<string, unknown> | null;
+};
 export declare function workflowStatus(helpers: WorkflowOperationHelpers): Promise<TreeseedWorkflowResult<import("../workflow-state.ts").TreeseedWorkflowState>>;
 export declare function workflowTasks(helpers: WorkflowOperationHelpers): Promise<TreeseedWorkflowResult<{
     tasks: TreeseedTaskBranchMetadata[];
+    workstreams: Array<{
+        id: string;
+        title: string;
+        linkedDirectRefs: Array<{
+            model: "objective" | "question" | "note";
+            id: string;
+        }>;
+        branch: string;
+        local: boolean;
+        remote: boolean;
+        current: boolean;
+        previewUrl: string | null;
+        lastSaveAt: string | null;
+        verificationResult: "ready" | "needs_attention" | "unknown";
+        stagingCandidate: boolean;
+        archived: boolean;
+    }>;
 }>>;
 export declare function workflowConfig(helpers: WorkflowOperationHelpers, input?: TreeseedConfigInput): Promise<TreeseedWorkflowResult<{
     mode: string;
     scopes: ("local" | "staging" | "prod")[];
-    sync: "none" | "cloudflare" | "railway" | "github" | "all";
+    sync: "none" | "cloudflare" | "railway" | "github" | "all" | undefined;
     configPath: string;
     keyPath: string;
-    repairs: import("../operations/services/config-runtime.ts").TreeseedRepairAction[];
+    repairs: unknown[];
     preflight: {
         ok: boolean;
         requireAuth: boolean;
@@ -65,37 +101,29 @@ export declare function workflowConfig(helpers: WorkflowOperationHelpers, input?
             available: any;
             detail: any;
         };
+        wranglerCli: {
+            name: any;
+            available: any;
+            detail: any;
+        };
+        railwayCli: {
+            name: any;
+            available: any;
+            detail: any;
+        };
         actVerificationReady: any;
         remediation: string[];
     };
-    context: import("../operations/services/config-runtime.ts").TreeseedCollectedConfigContext;
-    result: {
-        scopes: ("local" | "staging" | "prod")[];
-        synced: Record<string, unknown>;
-        initialized: Array<{
-            scope: import("../operations/services/config-runtime.ts").TreeseedConfigScope;
-            secrets: number;
-            target: string;
-        }>;
-        connectionChecks: ReturnType<typeof checkTreeseedProviderConnections>[];
-        validationByScope: Record<import("../operations/services/config-runtime.ts").TreeseedConfigScope, ReturnType<typeof import("../platform/environment.ts").validateTreeseedEnvironmentValues>>;
-        readinessByScope: Record<import("../operations/services/config-runtime.ts").TreeseedConfigScope, {
-            configured: boolean;
-            provisioned: boolean;
-            deployable: boolean;
-            checks: Record<string, unknown>;
-        }>;
-        updated: {
-            scope: import("../operations/services/config-runtime.ts").TreeseedConfigScope | "shared";
-            id: string;
-            reused: boolean;
-            cleared: boolean;
-        }[];
-        envFiles: {
-            envLocalPath: string;
-            devVarsPath: string;
-        } | null;
-    };
+    market: any;
+    connection: import("../sdk-types.ts").ProjectConnection | null;
+    runnerTokenIssued: boolean;
+} & {
+    finalState?: WorkflowStatePayload;
+}> | TreeseedWorkflowResult<{
+    mode: string;
+    scopes: ("local" | "staging" | "prod")[];
+    sync: "none" | "cloudflare" | "railway" | "github" | "all";
+    secretsRevealed: boolean;
     reports: {
         scope: "local" | "staging" | "prod";
         environment: {
@@ -111,146 +139,136 @@ export declare function workflowConfig(helpers: WorkflowOperationHelpers, input?
                 ready: any;
                 detail: any;
             }[];
+            issues: any[];
         };
     }[];
-    state: import("../workflow-state.ts").TreeseedWorkflowState;
-    readiness: {
-        local: {
-            ready: boolean;
-            blockers: string[];
-            warnings: string[];
+    repairs: import("../operations/services/config-runtime.ts").TreeseedRepairAction[];
+    preflight: {
+        ok: boolean;
+        requireAuth: boolean;
+        missingCommands: string[];
+        failingAuth: string[];
+        checks: {
+            commands: {
+                [k: string]: {
+                    installed: boolean;
+                    path: string | null;
+                };
+            };
+            auth: {};
         };
-        staging: {
-            ready: boolean;
-            blockers: string[];
-            warnings: string[];
+    };
+    toolHealth: {
+        githubCli: {
+            name: any;
+            available: any;
+            detail: any;
+        };
+        ghActExtension: {
+            name: any;
+            available: any;
+            detail: any;
         };
-        prod: {
-            ready: boolean;
-            blockers: string[];
-            warnings: string[];
+        dockerDaemon: {
+            name: any;
+            available: any;
+            detail: any;
         };
+        wranglerCli: {
+            name: any;
+            available: any;
+            detail: any;
+        };
+        railwayCli: {
+            name: any;
+            available: any;
+            detail: any;
+        };
+        actVerificationReady: any;
+        remediation: string[];
     };
+    context: import("../operations/services/config-runtime.ts").TreeseedCollectedConfigContext;
+    secretSession: import("../operations/services/config-runtime.ts").TreeseedConfigSecretSessionBootstrap;
 } & {
-    finalState: WorkflowStatePayload;
-}> | {
-    ok: true;
-    operation: "config";
-    payload: {
-        mode: string;
-        scopes: ("local" | "staging" | "prod")[];
-        sync: "none" | "cloudflare" | "railway" | "github" | "all";
-        secretsRevealed: boolean;
-        reports: {
-            scope: "local" | "staging" | "prod";
-            environment: {
-                scope: "local" | "staging" | "prod";
-                revealSecrets: boolean;
-                entries: any;
-            };
-            provider: {
-                scope: string;
-                ok: boolean;
-                checks: {
-                    provider: any;
-                    ready: any;
-                    detail: any;
-                }[];
-            };
-        }[];
-        repairs: import("../operations/services/config-runtime.ts").TreeseedRepairAction[];
-        preflight: {
-            ok: boolean;
-            requireAuth: boolean;
-            missingCommands: string[];
-            failingAuth: string[];
-            checks: {
-                commands: {
-                    [k: string]: {
-                        installed: boolean;
-                        path: string | null;
-                    };
+    finalState?: WorkflowStatePayload;
+}> | TreeseedWorkflowResult<{
+    mode: string;
+    scopes: ("local" | "staging" | "prod")[];
+    sync: "none" | "cloudflare" | "railway" | "github" | "all";
+    keyPath: string;
+    repairs: import("../operations/services/config-runtime.ts").TreeseedRepairAction[];
+    preflight: {
+        ok: boolean;
+        requireAuth: boolean;
+        missingCommands: string[];
+        failingAuth: string[];
+        checks: {
+            commands: {
+                [k: string]: {
+                    installed: boolean;
+                    path: string | null;
                 };
-                auth: {};
-            };
-        };
-        toolHealth: {
-            githubCli: {
-                name: any;
-                available: any;
-                detail: any;
-            };
-            ghActExtension: {
-                name: any;
-                available: any;
-                detail: any;
             };
-            dockerDaemon: {
-                name: any;
-                available: any;
-                detail: any;
-            };
-            actVerificationReady: any;
-            remediation: string[];
+            auth: {};
         };
-        keyPath?: undefined;
     };
-    nextSteps: TreeseedWorkflowNextStep[];
-} | {
-    ok: true;
-    operation: "config";
-    payload: {
-        mode: string;
-        scopes: ("local" | "staging" | "prod")[];
-        sync: "none" | "cloudflare" | "railway" | "github" | "all";
-        keyPath: string;
-        repairs: import("../operations/services/config-runtime.ts").TreeseedRepairAction[];
-        preflight: {
-            ok: boolean;
-            requireAuth: boolean;
-            missingCommands: string[];
-            failingAuth: string[];
-            checks: {
-                commands: {
-                    [k: string]: {
-                        installed: boolean;
-                        path: string | null;
-                    };
-                };
-                auth: {};
-            };
+    toolHealth: {
+        githubCli: {
+            name: any;
+            available: any;
+            detail: any;
         };
-        toolHealth: {
-            githubCli: {
-                name: any;
-                available: any;
-                detail: any;
-            };
-            ghActExtension: {
-                name: any;
-                available: any;
-                detail: any;
-            };
-            dockerDaemon: {
-                name: any;
-                available: any;
-                detail: any;
-            };
-            actVerificationReady: any;
-            remediation: string[];
+        ghActExtension: {
+            name: any;
+            available: any;
+            detail: any;
+        };
+        dockerDaemon: {
+            name: any;
+            available: any;
+            detail: any;
+        };
+        wranglerCli: {
+            name: any;
+            available: any;
+            detail: any;
         };
-        secretsRevealed?: undefined;
-        reports?: undefined;
+        railwayCli: {
+            name: any;
+            available: any;
+            detail: any;
+        };
+        actVerificationReady: any;
+        remediation: string[];
     };
-    nextSteps: TreeseedWorkflowNextStep[];
-}>;
+    context: import("../operations/services/config-runtime.ts").TreeseedCollectedConfigContext;
+    secretSession: import("../operations/services/config-runtime.ts").TreeseedConfigSecretSessionBootstrap;
+} & {
+    finalState?: WorkflowStatePayload;
+}>>;
 export declare function workflowExport(helpers: WorkflowOperationHelpers, input?: TreeseedExportInput): Promise<TreeseedWorkflowResult<import("../operations/services/export-runtime.ts").TreeseedExportResult & {
-    finalState: WorkflowStatePayload;
+    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;
@@ -263,7 +281,7 @@ export declare function workflowSwitch(helpers: WorkflowOperationHelpers, input:
         baseBranch: string;
     };
 } & {
-    finalState: WorkflowStatePayload;
+    finalState?: WorkflowStatePayload;
 }>>;
 export declare function workflowDev(helpers: WorkflowOperationHelpers, input?: TreeseedWorkflowDevInput): Promise<TreeseedWorkflowResult<{
     watch: boolean;
@@ -284,7 +302,7 @@ export declare function workflowDev(helpers: WorkflowOperationHelpers, input?: T
         warnings: string[];
     };
 } & {
-    finalState: WorkflowStatePayload;
+    finalState?: WorkflowStatePayload;
 }> | TreeseedWorkflowResult<{
     watch: boolean;
     background: boolean;
@@ -304,9 +322,25 @@ export declare function workflowDev(helpers: WorkflowOperationHelpers, input?: T
         warnings: string[];
     };
 } & {
-    finalState: WorkflowStatePayload;
+    finalState?: WorkflowStatePayload;
 }>>;
 export declare function workflowSave(helpers: WorkflowOperationHelpers, input: TreeseedSaveInput): Promise<TreeseedWorkflowResult<{
+    mode: TreeseedWorkflowMode;
+    branch: string;
+    scope: string;
+    hotfix: boolean;
+    message: string;
+    repos: WorkflowRepoReport[];
+    rootRepo: WorkflowRepoReport;
+    blockers: string[];
+    plannedSteps: {
+        id: string;
+        description: string;
+    }[];
+} & {
+    finalState?: WorkflowStatePayload;
+}> | TreeseedWorkflowResult<{
+    mode: TreeseedWorkflowMode;
     branch: string;
     scope: string;
     hotfix: boolean;
@@ -321,16 +355,50 @@ export declare function workflowSave(helpers: WorkflowOperationHelpers, input: T
         createdRemoteBranch: boolean;
         conflicts: boolean;
     };
+    repos: WorkflowRepoReport[];
+    rootRepo: WorkflowRepoReport;
+    partialFailure: null;
     previewAction: Record<string, unknown>;
     mergeConflict: null;
 } & {
-    finalState: WorkflowStatePayload;
+    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;
+    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: WorkflowRepoReport[];
+        rootRepo: WorkflowRepoReport;
+        blockers: string[];
+        plannedSteps: {
+            id: string;
+            description: string;
+        }[];
+    } & {
+        finalState?: WorkflowStatePayload;
+    }) | ({
+        mode: TreeseedWorkflowMode;
         branch: string;
         scope: string;
         hotfix: boolean;
@@ -345,15 +413,20 @@ export declare function workflowClose(helpers: WorkflowOperationHelpers, input:
             createdRemoteBranch: boolean;
             conflicts: boolean;
         };
+        repos: WorkflowRepoReport[];
+        rootRepo: WorkflowRepoReport;
+        partialFailure: null;
         previewAction: Record<string, unknown>;
         mergeConflict: null;
     } & {
-        finalState: WorkflowStatePayload;
+        finalState?: WorkflowStatePayload;
     }) | null;
     deprecatedTag: {
         tagName: string;
         head: string;
     };
+    repos: WorkflowRepoReport[];
+    rootRepo: WorkflowRepoReport;
     previewCleanup: {
         performed: boolean;
         state: any;
@@ -364,14 +437,48 @@ export declare function workflowClose(helpers: WorkflowOperationHelpers, input:
     localDeleted: boolean;
     finalBranch: string;
 } & {
-    finalState: WorkflowStatePayload;
+    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;
+    repos: WorkflowRepoReport[];
+    plannedSteps: {
+        id: string;
+        description: string;
+    }[];
+} & {
+    finalState?: WorkflowStatePayload;
+}> | TreeseedWorkflowResult<{
+    mode: TreeseedWorkflowMode;
     branchName: string;
     mergeTarget: string;
+    mergeStrategy: string;
     message: string;
     autoSaved: boolean;
     autoSaveResult: ({
+        mode: TreeseedWorkflowMode;
+        branch: string;
+        scope: string;
+        hotfix: boolean;
+        message: string;
+        repos: WorkflowRepoReport[];
+        rootRepo: WorkflowRepoReport;
+        blockers: string[];
+        plannedSteps: {
+            id: string;
+            description: string;
+        }[];
+    } & {
+        finalState?: WorkflowStatePayload;
+    }) | ({
+        mode: TreeseedWorkflowMode;
         branch: string;
         scope: string;
         hotfix: boolean;
@@ -386,15 +493,20 @@ export declare function workflowStage(helpers: WorkflowOperationHelpers, input:
             createdRemoteBranch: boolean;
             conflicts: boolean;
         };
+        repos: WorkflowRepoReport[];
+        rootRepo: WorkflowRepoReport;
+        partialFailure: null;
         previewAction: Record<string, unknown>;
         mergeConflict: null;
     } & {
-        finalState: WorkflowStatePayload;
+        finalState?: WorkflowStatePayload;
     }) | null;
     deprecatedTag: {
         tagName: string;
         head: string;
     };
+    repos: WorkflowRepoReport[];
+    rootRepo: WorkflowRepoReport;
     stagingWait: {
         status: string;
         reason: string;
@@ -414,9 +526,28 @@ export declare function workflowStage(helpers: WorkflowOperationHelpers, input:
     localDeleted: boolean;
     finalBranch: string;
 } & {
-    finalState: WorkflowStatePayload;
+    finalState?: WorkflowStatePayload;
 }>>;
 export declare function workflowRelease(helpers: WorkflowOperationHelpers, input: TreeseedReleaseInput): Promise<TreeseedWorkflowResult<{
+    mode: TreeseedWorkflowMode;
+    mergeStrategy: string;
+    level: "patch" | "major" | "minor";
+    stagingBranch: string;
+    productionBranch: string;
+    packageSelection: import("./session.ts").TreeseedWorkflowPackageSelection;
+    plannedVersions: any;
+    repos: WorkflowRepoReport[];
+    rootRepo: WorkflowRepoReport;
+    plannedSteps: {
+        id: string;
+        description: string;
+    }[];
+    blockers: string[];
+} & {
+    finalState?: WorkflowStatePayload;
+}> | TreeseedWorkflowResult<{
+    mode: "root-only";
+    mergeStrategy: string;
     level: "patch" | "major" | "minor";
     rootVersion: string;
     releaseTag: string;
@@ -424,6 +555,14 @@ export declare function workflowRelease(helpers: WorkflowOperationHelpers, input
     stagingBranch: string;
     productionBranch: string;
     touchedPackages: unknown[];
+    packageSelection: {
+        changed: never[];
+        dependents: never[];
+        selected: never[];
+    };
+    publishWait: never[];
+    repos: never[];
+    rootRepo: WorkflowRepoReport;
     finalBranch: string;
     pushStatus: {
         stagingPushed: boolean;
@@ -431,91 +570,301 @@ export declare function workflowRelease(helpers: WorkflowOperationHelpers, input
         tagPushed: boolean;
     };
 } & {
-    finalState: WorkflowStatePayload;
+    finalState?: WorkflowStatePayload;
+}> | TreeseedWorkflowResult<{
+    mode: "recursive-workspace";
+    mergeStrategy: string;
+    level: "patch" | "major" | "minor";
+    rootVersion: string;
+    releaseTag: string;
+    releasedCommit: string;
+    stagingBranch: string;
+    productionBranch: string;
+    touchedPackages: string[];
+    packageSelection: import("./session.ts").TreeseedWorkflowPackageSelection;
+    publishWait: Record<string, unknown>[];
+    repos: WorkflowRepoReport[];
+    rootRepo: WorkflowRepoReport;
+    finalBranch: string;
+    pushStatus: {
+        stagingPushed: boolean;
+        productionPushed: boolean;
+        tagPushed: boolean;
+    };
+} & {
+    finalState?: WorkflowStatePayload;
 }>>;
-export declare function workflowDestroy(helpers: WorkflowOperationHelpers, input: TreeseedDestroyInput): Promise<{
-    ok: boolean;
-    operation: string;
-    payload: {
+export declare function workflowResume(helpers: WorkflowOperationHelpers, input: TreeseedResumeInput): Promise<TreeseedWorkflowResult<{
+    mode: TreeseedWorkflowMode;
+    branch: string;
+    scope: string;
+    hotfix: boolean;
+    message: string;
+    repos: WorkflowRepoReport[];
+    rootRepo: WorkflowRepoReport;
+    blockers: string[];
+    plannedSteps: {
+        id: string;
+        description: string;
+    }[];
+} & {
+    finalState?: WorkflowStatePayload;
+}> | TreeseedWorkflowResult<{
+    mode: TreeseedWorkflowMode;
+    branch: string;
+    scope: string;
+    hotfix: boolean;
+    message: string;
+    commitSha: string;
+    commitCreated: boolean;
+    noChanges: boolean;
+    branchSync: {
+        remoteBranchExisted: boolean;
+        pulledRebase: boolean;
+        pushed: boolean;
+        createdRemoteBranch: boolean;
+        conflicts: boolean;
+    };
+    repos: WorkflowRepoReport[];
+    rootRepo: WorkflowRepoReport;
+    partialFailure: null;
+    previewAction: Record<string, unknown>;
+    mergeConflict: null;
+} & {
+    finalState?: WorkflowStatePayload;
+}> | 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;
+    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: WorkflowRepoReport[];
+        rootRepo: WorkflowRepoReport;
+        blockers: string[];
+        plannedSteps: {
+            id: string;
+            description: string;
+        }[];
+    } & {
+        finalState?: WorkflowStatePayload;
+    }) | ({
+        mode: TreeseedWorkflowMode;
+        branch: string;
         scope: string;
-        dryRun: boolean;
-        force: boolean;
-        destroyRemote: boolean;
-        destroyLocal: boolean;
-        removeBuildArtifacts: boolean;
-        expectedConfirmation: string;
-        stateSummary: {
-            workerName: any;
-            lastDeploymentTimestamp: any;
+        hotfix: boolean;
+        message: string;
+        commitSha: string;
+        commitCreated: boolean;
+        noChanges: boolean;
+        branchSync: {
+            remoteBranchExisted: boolean;
+            pulledRebase: boolean;
+            pushed: boolean;
+            createdRemoteBranch: boolean;
+            conflicts: boolean;
         };
-        remoteResult: {
-            target: {
-                kind: string;
-                scope: string;
-            } | {
-                kind: string;
-                branchName: string;
-            };
-            summary: {
-                target: any;
-                workerName: any;
-                siteUrl: any;
-                accountId: any;
-                pages: any;
-                formGuardKv: any;
-                sessionKv: any;
-                siteDataDb: any;
-                queue: any;
-                content: any;
-            };
-            operations: {
-                worker: {
-                    status: string;
-                    name: any;
-                };
-                formGuard: {
-                    status: string;
-                    id: any;
-                    preview?: undefined;
-                } | {
-                    status: string;
-                    id: any;
-                    preview: boolean;
-                };
-                formGuardPreview: {
-                    status: string;
-                    id: any;
-                    preview?: undefined;
-                } | {
-                    status: string;
-                    id: any;
-                    preview: boolean;
-                } | null;
-                session: {
-                    status: string;
-                    id: any;
-                    preview?: undefined;
-                } | {
-                    status: string;
-                    id: any;
-                    preview: boolean;
-                };
-                sessionPreview: {
-                    status: string;
-                    id: any;
-                    preview?: undefined;
-                } | {
-                    status: string;
-                    id: any;
-                    preview: boolean;
-                } | null;
-                database: {
-                    status: string;
-                    name: any;
-                };
-            };
+        repos: WorkflowRepoReport[];
+        rootRepo: WorkflowRepoReport;
+        partialFailure: null;
+        previewAction: Record<string, unknown>;
+        mergeConflict: 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;
+} & {
+    finalState?: WorkflowStatePayload;
+}> | TreeseedWorkflowResult<{
+    mode: TreeseedWorkflowMode;
+    mergeStrategy: string;
+    level: "patch" | "major" | "minor";
+    stagingBranch: string;
+    productionBranch: string;
+    packageSelection: import("./session.ts").TreeseedWorkflowPackageSelection;
+    plannedVersions: any;
+    repos: WorkflowRepoReport[];
+    rootRepo: WorkflowRepoReport;
+    plannedSteps: {
+        id: string;
+        description: string;
+    }[];
+    blockers: string[];
+} & {
+    finalState?: WorkflowStatePayload;
+}> | TreeseedWorkflowResult<{
+    mode: "root-only";
+    mergeStrategy: string;
+    level: "patch" | "major" | "minor";
+    rootVersion: string;
+    releaseTag: string;
+    releasedCommit: string;
+    stagingBranch: string;
+    productionBranch: string;
+    touchedPackages: unknown[];
+    packageSelection: {
+        changed: never[];
+        dependents: never[];
+        selected: never[];
+    };
+    publishWait: never[];
+    repos: never[];
+    rootRepo: WorkflowRepoReport;
+    finalBranch: string;
+    pushStatus: {
+        stagingPushed: boolean;
+        productionPushed: boolean;
+        tagPushed: boolean;
+    };
+} & {
+    finalState?: WorkflowStatePayload;
+}> | TreeseedWorkflowResult<{
+    mode: "recursive-workspace";
+    mergeStrategy: string;
+    level: "patch" | "major" | "minor";
+    rootVersion: string;
+    releaseTag: string;
+    releasedCommit: string;
+    stagingBranch: string;
+    productionBranch: string;
+    touchedPackages: string[];
+    packageSelection: import("./session.ts").TreeseedWorkflowPackageSelection;
+    publishWait: Record<string, unknown>[];
+    repos: WorkflowRepoReport[];
+    rootRepo: WorkflowRepoReport;
+    finalBranch: string;
+    pushStatus: {
+        stagingPushed: boolean;
+        productionPushed: boolean;
+        tagPushed: boolean;
+    };
+} & {
+    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;
+    }[];
+} & {
+    finalState?: WorkflowStatePayload;
+}>>;
+export declare function workflowRecover(helpers: WorkflowOperationHelpers, input?: TreeseedRecoverInput): Promise<TreeseedWorkflowResult<{
+    lock: import("./runs.ts").TreeseedWorkflowLockInspection;
+    interruptedRuns: {
+        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;
+        resumeCommand: string;
+    }[];
+    selectedRun: TreeseedWorkflowRunJournal | null;
+    runCount: number;
+} & {
+    finalState?: WorkflowStatePayload;
+}>>;
+export declare function workflowDestroy(helpers: WorkflowOperationHelpers, input: TreeseedDestroyInput): Promise<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;
     };
-    nextSteps: TreeseedWorkflowNextStep[];
-}>;
+    plannedSteps: {
+        id: string;
+        description: string;
+    }[];
+} & {
+    finalState?: WorkflowStatePayload;
+}>>;
 export {};