@treeseed/sdk 0.4.5 → 0.4.7

package/dist/workflow/operations.d.ts

@@ -1,6 +1,7 @@
 import { resolveTreeseedWorkflowState } from '../workflow-state.ts';
 import type { TreeseedCloseInput, TreeseedConfigInput, TreeseedDestroyInput, TreeseedReleaseInput, TreeseedSaveInput, TreeseedStageInput, TreeseedSwitchInput, TreeseedTaskBranchMetadata, TreeseedWorkflowContext, TreeseedWorkflowDevInput, TreeseedWorkflowNextStep, 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 declare class TreeseedWorkflowError extends Error {
     code: TreeseedWorkflowErrorCode;
@@ -29,7 +30,75 @@ export declare function workflowStatus(helpers: WorkflowOperationHelpers): Promi
 export declare function workflowTasks(helpers: WorkflowOperationHelpers): Promise<TreeseedWorkflowResult<{
     tasks: TreeseedTaskBranchMetadata[];
 }>>;
-export declare function workflowConfig(helpers: WorkflowOperationHelpers, input?: TreeseedConfigInput): Promise<{
+export declare function workflowConfig(helpers: WorkflowOperationHelpers, input?: TreeseedConfigInput): Promise<TreeseedWorkflowResult<{
+    mode: string;
+    scopes: ("local" | "staging" | "prod")[];
+    sync: "all" | "cloudflare" | "railway" | "none" | "github";
+    configPath: string;
+    keyPath: string;
+    repairs: 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[];
+    };
+    result: {
+        scopes: string[];
+        updated: never[];
+        synced: {};
+        initialized: never[];
+        connectionChecks: never[];
+    };
+    state: import("../workflow-state.ts").TreeseedWorkflowState;
+    readiness: {
+        local: {
+            ready: boolean;
+            blockers: string[];
+            warnings: string[];
+        };
+        staging: {
+            ready: boolean;
+            blockers: string[];
+            warnings: string[];
+        };
+        prod: {
+            ready: boolean;
+            blockers: string[];
+            warnings: string[];
+        };
+    };
+} & {
+    finalState: WorkflowStatePayload;
+}> | {
     ok: true;
     operation: "config";
     payload: {
@@ -78,9 +147,6 @@ export declare function workflowConfig(helpers: WorkflowOperationHelpers, input?
             remediation: string[];
         };
         keyPath?: undefined;
-        configPath?: undefined;
-        result?: undefined;
-        state?: undefined;
     };
     nextSteps: TreeseedWorkflowNextStep[];
 } | {
@@ -128,189 +194,195 @@ export declare function workflowConfig(helpers: WorkflowOperationHelpers, input?
         };
         secretsRevealed?: undefined;
         reports?: undefined;
-        configPath?: undefined;
-        result?: undefined;
-        state?: undefined;
     };
     nextSteps: TreeseedWorkflowNextStep[];
-} | {
-    ok: true;
-    operation: "config";
-    payload: {
+}>;
+export declare function workflowSwitch(helpers: WorkflowOperationHelpers, input: TreeseedSwitchInput): Promise<TreeseedWorkflowResult<{
+    branchName: string;
+    created: boolean;
+    resumed: boolean;
+    previewRequested: boolean;
+    preview: {
+        enabled: boolean;
+        url: string | null;
+        lastDeploymentTimestamp: string | null;
+    };
+    previewResult: Record<string, unknown> | null;
+    preconditions: {
+        cleanWorktreeRequired: boolean;
+        baseBranch: string;
+    };
+} & {
+    finalState: WorkflowStatePayload;
+}>>;
+export declare function workflowDev(helpers: WorkflowOperationHelpers, input?: TreeseedWorkflowDevInput): Promise<TreeseedWorkflowResult<{
+    watch: boolean;
+    background: boolean;
+    command: string;
+    args: string[];
+    cwd: string;
+    pid: number | null;
+    exitCode: null;
+    runtime: {
         mode: string;
-        scopes: ("local" | "staging" | "prod")[];
-        sync: "all" | "cloudflare" | "railway" | "none" | "github";
-        configPath: string;
-        keyPath: string;
-        repairs: 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[];
-        };
-        result: {
-            scopes: string[];
-            updated: never[];
-            synced: {};
-            initialized: never[];
-            connectionChecks: never[];
-        };
-        state: import("../workflow-state.ts").TreeseedWorkflowState;
-        secretsRevealed?: undefined;
-        reports?: undefined;
+        apiBaseUrl: string;
+        webUrl: string;
     };
-    nextSteps: TreeseedWorkflowNextStep[];
-}>;
-export declare function workflowSwitch(helpers: WorkflowOperationHelpers, input: TreeseedSwitchInput): Promise<{
-    ok: boolean;
-    operation: string;
-    payload: {
-        branchName: string;
-        created: boolean;
-        resumed: boolean;
-        previewRequested: boolean;
-        preview: {
-            enabled: boolean;
-            url: string | null;
-            lastDeploymentTimestamp: string | null;
-        };
-        previewResult: Record<string, unknown> | null;
-        state: import("../workflow-state.ts").TreeseedWorkflowState;
+    readiness: {
+        ready: boolean;
+        blockers: string[];
+        warnings: string[];
     };
-    nextSteps: TreeseedWorkflowNextStep[];
-}>;
-export declare function workflowDev(helpers: WorkflowOperationHelpers, input?: TreeseedWorkflowDevInput): Promise<{
-    ok: true;
-    operation: "dev";
-    payload: {
-        watch: boolean;
-        background: boolean;
-        command: string;
-        args: string[];
-        cwd: string;
-        pid: number | null;
-        exitCode: null;
+} & {
+    finalState: WorkflowStatePayload;
+}> | TreeseedWorkflowResult<{
+    watch: boolean;
+    background: boolean;
+    command: string;
+    args: string[];
+    cwd: string;
+    pid: null;
+    exitCode: number;
+    runtime: {
+        mode: string;
+        apiBaseUrl: string;
+        webUrl: string;
     };
-} | {
-    ok: boolean;
-    operation: "dev";
-    payload: {
-        watch: boolean;
-        background: boolean;
-        command: string;
-        args: string[];
-        cwd: string;
-        pid: null;
-        exitCode: number;
+    readiness: {
+        ready: boolean;
+        blockers: string[];
+        warnings: string[];
     };
-}>;
-export declare function workflowSave(helpers: WorkflowOperationHelpers, input: TreeseedSaveInput): Promise<{
-    ok: boolean;
-    operation: string;
-    payload: {
+} & {
+    finalState: WorkflowStatePayload;
+}>>;
+export declare function workflowSave(helpers: WorkflowOperationHelpers, input: TreeseedSaveInput): Promise<TreeseedWorkflowResult<{
+    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;
+    };
+    previewAction: Record<string, unknown>;
+    mergeConflict: null;
+} & {
+    finalState: WorkflowStatePayload;
+}>>;
+export declare function workflowClose(helpers: WorkflowOperationHelpers, input: TreeseedCloseInput): Promise<TreeseedWorkflowResult<{
+    branchName: string;
+    message: string;
+    autoSaved: boolean;
+    autoSaveResult: ({
         branch: string;
         scope: string;
         hotfix: boolean;
         message: string;
         commitSha: string;
-        previewRefresh: Record<string, unknown> | null;
-    };
-    nextSteps: TreeseedWorkflowNextStep[];
-}>;
-export declare function workflowClose(helpers: WorkflowOperationHelpers, input: TreeseedCloseInput): Promise<{
-    ok: boolean;
-    operation: string;
-    payload: {
-        branchName: string;
-        message: string;
-        deprecatedTag: {
-            tagName: string;
-            head: string;
-        };
-        previewCleanup: {
-            performed: boolean;
-            state: any;
-        } | {
-            performed: boolean;
+        commitCreated: boolean;
+        noChanges: boolean;
+        branchSync: {
+            remoteBranchExisted: boolean;
+            pulledRebase: boolean;
+            pushed: boolean;
+            createdRemoteBranch: boolean;
+            conflicts: boolean;
         };
-        remoteDeleted: boolean;
-        localDeleted: boolean;
+        previewAction: Record<string, unknown>;
+        mergeConflict: null;
+    } & {
+        finalState: WorkflowStatePayload;
+    }) | null;
+    deprecatedTag: {
+        tagName: string;
+        head: string;
     };
-    nextSteps: TreeseedWorkflowNextStep[];
-}>;
-export declare function workflowStage(helpers: WorkflowOperationHelpers, input: TreeseedStageInput): Promise<{
-    ok: boolean;
-    operation: string;
-    payload: {
-        branchName: string;
-        mergeTarget: string;
+    previewCleanup: {
+        performed: boolean;
+        state: any;
+    } | {
+        performed: boolean;
+    };
+    remoteDeleted: boolean;
+    localDeleted: boolean;
+    finalBranch: string;
+} & {
+    finalState: WorkflowStatePayload;
+}>>;
+export declare function workflowStage(helpers: WorkflowOperationHelpers, input: TreeseedStageInput): Promise<TreeseedWorkflowResult<{
+    branchName: string;
+    mergeTarget: string;
+    message: string;
+    autoSaved: boolean;
+    autoSaveResult: ({
+        branch: string;
+        scope: string;
+        hotfix: boolean;
         message: string;
-        deprecatedTag: {
-            tagName: string;
-            head: string;
-        };
-        stagingWait: {
-            status: string;
-            reason: string;
-            branch?: undefined;
-        } | {
-            status: string;
-            branch: string;
-            reason?: undefined;
-        };
-        previewCleanup: {
-            performed: boolean;
-            state: any;
-        } | {
-            performed: boolean;
+        commitSha: string;
+        commitCreated: boolean;
+        noChanges: boolean;
+        branchSync: {
+            remoteBranchExisted: boolean;
+            pulledRebase: boolean;
+            pushed: boolean;
+            createdRemoteBranch: boolean;
+            conflicts: boolean;
         };
-        remoteDeleted: boolean;
-        localDeleted: boolean;
+        previewAction: Record<string, unknown>;
+        mergeConflict: null;
+    } & {
+        finalState: WorkflowStatePayload;
+    }) | null;
+    deprecatedTag: {
+        tagName: string;
+        head: string;
     };
-    nextSteps: TreeseedWorkflowNextStep[];
-}>;
-export declare function workflowRelease(helpers: WorkflowOperationHelpers, input: TreeseedReleaseInput): Promise<{
-    ok: boolean;
-    operation: string;
-    payload: {
-        level: "patch" | "major" | "minor";
-        rootVersion: string;
-        releaseTag: string;
-        stagingBranch: string;
-        productionBranch: string;
-        touchedPackages: unknown[];
+    stagingWait: {
+        status: string;
+        reason: string;
+        branch?: undefined;
+    } | {
+        status: string;
+        branch: string;
+        reason?: undefined;
     };
-    nextSteps: TreeseedWorkflowNextStep[];
-}>;
+    previewCleanup: {
+        performed: boolean;
+        state: any;
+    } | {
+        performed: boolean;
+    };
+    remoteDeleted: boolean;
+    localDeleted: boolean;
+    finalBranch: string;
+} & {
+    finalState: WorkflowStatePayload;
+}>>;
+export declare function workflowRelease(helpers: WorkflowOperationHelpers, input: TreeseedReleaseInput): Promise<TreeseedWorkflowResult<{
+    level: "patch" | "major" | "minor";
+    rootVersion: string;
+    releaseTag: string;
+    releasedCommit: string;
+    stagingBranch: string;
+    productionBranch: string;
+    touchedPackages: unknown[];
+    finalBranch: string;
+    pushStatus: {
+        stagingPushed: boolean;
+        productionPushed: boolean;
+        tagPushed: boolean;
+    };
+} & {
+    finalState: WorkflowStatePayload;
+}>>;
 export declare function workflowDestroy(helpers: WorkflowOperationHelpers, input: TreeseedDestroyInput): Promise<{
     ok: boolean;
     operation: string;