@treeseed/sdk 0.4.6 → 0.4.8

package/dist/workflow/operations.d.ts

@@ -1,6 +1,8 @@
+import { checkTreeseedProviderConnections } from '../operations/services/config-runtime.ts';
 import { resolveTreeseedWorkflowState } from '../workflow-state.ts';
-import type { TreeseedCloseInput, TreeseedConfigInput, TreeseedDestroyInput, TreeseedReleaseInput, TreeseedSaveInput, TreeseedStageInput, TreeseedSwitchInput, TreeseedTaskBranchMetadata, TreeseedWorkflowContext, TreeseedWorkflowDevInput, TreeseedWorkflowNextStep, TreeseedWorkflowOperationId, TreeseedWorkflowResult } from '../workflow.ts';
+import type { TreeseedCloseInput, TreeseedConfigInput, TreeseedDestroyInput, TreeseedExportInput, 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;
@@ -21,77 +23,136 @@ export type WorkflowOperationHelpers = {
         tasks: TreeseedTaskBranchMetadata[];
     }>>;
 };
-type TreeseedRepairAction = {
-    id: string;
-    detail: string;
-};
 export declare function workflowStatus(helpers: WorkflowOperationHelpers): Promise<TreeseedWorkflowResult<import("../workflow-state.ts").TreeseedWorkflowState>>;
 export declare function workflowTasks(helpers: WorkflowOperationHelpers): Promise<TreeseedWorkflowResult<{
     tasks: TreeseedTaskBranchMetadata[];
 }>>;
-export declare function workflowConfig(helpers: WorkflowOperationHelpers, input?: TreeseedConfigInput): Promise<{
-    ok: true;
-    operation: "config";
-    payload: {
-        mode: string;
+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: 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[];
+    };
+    context: import("../operations/services/config-runtime.ts").TreeseedCollectedConfigContext;
+    result: {
         scopes: ("local" | "staging" | "prod")[];
-        sync: "all" | "cloudflare" | "railway" | "none" | "github";
-        secretsRevealed: boolean;
-        reports: {
-            scope: "local" | "staging" | "prod";
-            environmentReport: string;
-            providerReport: string;
+        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>>;
+        updated: {
+            scope: import("../operations/services/config-runtime.ts").TreeseedConfigScope | "shared";
+            id: string;
+            reused: boolean;
+            cleared: boolean;
         }[];
-        repairs: TreeseedRepairAction[];
-        preflight: {
+        envFiles: {
+            envLocalPath: string;
+            devVarsPath: string;
+        } | null;
+    };
+    reports: {
+        scope: "local" | "staging" | "prod";
+        environment: {
+            scope: "local" | "staging" | "prod";
+            revealSecrets: boolean;
+            entries: any;
+        };
+        provider: {
+            scope: string;
             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;
+                provider: any;
+                ready: any;
                 detail: any;
-            };
-            actVerificationReady: any;
-            remediation: string[];
+            }[];
+        };
+    }[];
+    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[];
         };
-        keyPath?: undefined;
-        configPath?: undefined;
-        result?: undefined;
-        state?: undefined;
     };
-    nextSteps: TreeseedWorkflowNextStep[];
-} | {
+} & {
+    finalState: WorkflowStatePayload;
+}> | {
     ok: true;
     operation: "config";
     payload: {
         mode: string;
         scopes: ("local" | "staging" | "prod")[];
         sync: "all" | "cloudflare" | "railway" | "none" | "github";
-        keyPath: string;
-        repairs: TreeseedRepairAction[];
+        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;
@@ -126,11 +187,7 @@ export declare function workflowConfig(helpers: WorkflowOperationHelpers, input?
             actVerificationReady: any;
             remediation: string[];
         };
-        secretsRevealed?: undefined;
-        reports?: undefined;
-        configPath?: undefined;
-        result?: undefined;
-        state?: undefined;
+        keyPath?: undefined;
     };
     nextSteps: TreeseedWorkflowNextStep[];
 } | {
@@ -140,9 +197,8 @@ export declare function workflowConfig(helpers: WorkflowOperationHelpers, input?
         mode: string;
         scopes: ("local" | "staging" | "prod")[];
         sync: "all" | "cloudflare" | "railway" | "none" | "github";
-        configPath: string;
         keyPath: string;
-        repairs: TreeseedRepairAction[];
+        repairs: import("../operations/services/config-runtime.ts").TreeseedRepairAction[];
         preflight: {
             ok: boolean;
             requireAuth: boolean;
@@ -177,140 +233,200 @@ export declare function workflowConfig(helpers: WorkflowOperationHelpers, input?
             actVerificationReady: any;
             remediation: string[];
         };
-        result: {
-            scopes: string[];
-            updated: never[];
-            synced: {};
-            initialized: never[];
-            connectionChecks: never[];
-        };
-        state: import("../workflow-state.ts").TreeseedWorkflowState;
         secretsRevealed?: undefined;
         reports?: undefined;
     };
     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;
+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<{
+    branchName: string;
+    created: boolean;
+    resumed: boolean;
+    previewRequested: boolean;
+    preview: {
+        enabled: boolean;
+        url: string | null;
+        lastDeploymentTimestamp: string | null;
     };
-    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;
+    previewResult: Record<string, unknown> | null;
+    preconditions: {
+        cleanWorktreeRequired: boolean;
+        baseBranch: string;
     };
-} | {
-    ok: boolean;
-    operation: "dev";
-    payload: {
-        watch: boolean;
-        background: boolean;
-        command: string;
-        args: string[];
-        cwd: string;
-        pid: null;
-        exitCode: number;
+} & {
+    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;
+        apiBaseUrl: string;
+        webUrl: string;
     };
-}>;
-export declare function workflowSave(helpers: WorkflowOperationHelpers, input: TreeseedSaveInput): Promise<{
-    ok: boolean;
-    operation: string;
-    payload: {
+    readiness: {
+        ready: boolean;
+        blockers: string[];
+        warnings: string[];
+    };
+} & {
+    finalState: WorkflowStatePayload;
+}> | TreeseedWorkflowResult<{
+    watch: boolean;
+    background: boolean;
+    command: string;
+    args: string[];
+    cwd: string;
+    pid: null;
+    exitCode: number;
+    runtime: {
+        mode: string;
+        apiBaseUrl: string;
+        webUrl: string;
+    };
+    readiness: {
+        ready: boolean;
+        blockers: string[];
+        warnings: string[];
+    };
+} & {
+    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;