@pikku/cli 0.12.115 → 0.12.117

package/dist/src/fabric/fabric-commands.d.ts

@@ -279,79 +279,195 @@ export declare const fabricCommands: {
     deploy: {
         description: string;
         subcommands: {
-            plan: import("@pikku/core/cli").CoreCLICommandConfig<import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionConfig<{
-                branch?: string | undefined;
-                production?: boolean | undefined;
-                ref?: string | undefined;
-                message?: string | undefined;
-                autoApply?: boolean | undefined;
-            }, {
-                projectId: string;
-                branch: string;
-                ref: string;
-                requestedRef?: string | undefined;
-            }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionSessionless<{
+            apply: import("@pikku/core/cli").CoreCLICommandConfig<import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionConfig<{
                 branch?: string | undefined;
                 production?: boolean | undefined;
                 ref?: string | undefined;
-                message?: string | undefined;
-                autoApply?: boolean | undefined;
+                deploymentId?: string | undefined;
+                sync?: boolean | undefined;
+                autoApprove?: boolean | undefined;
+                allowDestructive?: boolean | undefined;
+                timeout?: number | undefined;
+                json?: boolean | undefined;
             }, {
+                event: "result";
+                outcome: "queued" | "failed" | "timeout" | "succeeded" | "blocked";
                 projectId: string;
-                branch: string;
-                ref: string;
-                requestedRef?: string | undefined;
-            }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").WiredServices, unknown> | import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunction<{
+                deploymentId: string;
                 branch?: string | undefined;
-                production?: boolean | undefined;
                 ref?: string | undefined;
-                message?: string | undefined;
-                autoApply?: boolean | undefined;
-            }, {
-                projectId: string;
-                branch: string;
-                ref: string;
-                requestedRef?: string | undefined;
-            }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").WiredServices>, undefined, undefined>, import("../../.pikku/middleware/pikku-middleware-types.gen.js").PikkuMiddleware, (services: import("../../types/application-types.js").SingletonServices, data: any, session?: import("../../types/application-types.js").UserSession | undefined) => void | Promise<void>, string>;
-            apply: import("@pikku/core/cli").CoreCLICommandConfig<import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionConfig<{
+                status?: string | undefined;
+                statusReason?: string | null | undefined;
+                stageId?: string | undefined;
+                runId?: string | undefined;
+                blockedReason?: "unknown" | "awaiting_approval" | "needs_config" | "needs_attention" | undefined;
+                missingSecrets?: {
+                    name: string;
+                    displayName: string | null;
+                    description: string | null;
+                    docsUrl: string | null;
+                }[] | undefined;
+                missingVariables?: {
+                    name: string;
+                    displayName: string | null;
+                    description: string | null;
+                    docsUrl: string | null;
+                }[] | undefined;
+                approvalWithheld?: "destructive_migrations" | undefined;
+                changes?: {
+                    unitsAdded: string[];
+                    unitsRemoved: string[];
+                    handlersAdded: string[];
+                    handlersRemoved: string[];
+                    workflowsAdded: string[];
+                    workflowsRemoved: string[];
+                    workflowsChanged: string[];
+                    functionsAdded: string[];
+                    functionsRemoved: string[];
+                    secretsChanged: string[];
+                    variablesChanged: string[];
+                    pendingMigrations: string[];
+                    migrationRisks: {
+                        name: string;
+                        level: "destructive" | "safe";
+                        reasons: string[];
+                    }[];
+                } | undefined;
+                workers?: {
+                    name: string;
+                    role: string;
+                    status: string;
+                }[] | undefined;
+                url?: string | null | undefined;
+                approved?: boolean | undefined;
+                elapsedMs?: number | undefined;
+                timeoutSeconds?: number | undefined;
+            }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionSessionless<{
                 branch?: string | undefined;
                 production?: boolean | undefined;
                 ref?: string | undefined;
-                message?: string | undefined;
-                autoApply?: boolean | undefined;
+                deploymentId?: string | undefined;
+                sync?: boolean | undefined;
+                autoApprove?: boolean | undefined;
+                allowDestructive?: boolean | undefined;
+                timeout?: number | undefined;
+                json?: boolean | undefined;
             }, {
+                event: "result";
+                outcome: "queued" | "failed" | "timeout" | "succeeded" | "blocked";
                 projectId: string;
-                branch: string;
-                ref: string;
                 deploymentId: string;
-                stageId: string;
-                runId: string;
-            }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionSessionless<{
                 branch?: string | undefined;
-                production?: boolean | undefined;
                 ref?: string | undefined;
-                message?: string | undefined;
-                autoApply?: boolean | undefined;
-            }, {
-                projectId: string;
-                branch: string;
-                ref: string;
-                deploymentId: string;
-                stageId: string;
-                runId: string;
+                status?: string | undefined;
+                statusReason?: string | null | undefined;
+                stageId?: string | undefined;
+                runId?: string | undefined;
+                blockedReason?: "unknown" | "awaiting_approval" | "needs_config" | "needs_attention" | undefined;
+                missingSecrets?: {
+                    name: string;
+                    displayName: string | null;
+                    description: string | null;
+                    docsUrl: string | null;
+                }[] | undefined;
+                missingVariables?: {
+                    name: string;
+                    displayName: string | null;
+                    description: string | null;
+                    docsUrl: string | null;
+                }[] | undefined;
+                approvalWithheld?: "destructive_migrations" | undefined;
+                changes?: {
+                    unitsAdded: string[];
+                    unitsRemoved: string[];
+                    handlersAdded: string[];
+                    handlersRemoved: string[];
+                    workflowsAdded: string[];
+                    workflowsRemoved: string[];
+                    workflowsChanged: string[];
+                    functionsAdded: string[];
+                    functionsRemoved: string[];
+                    secretsChanged: string[];
+                    variablesChanged: string[];
+                    pendingMigrations: string[];
+                    migrationRisks: {
+                        name: string;
+                        level: "destructive" | "safe";
+                        reasons: string[];
+                    }[];
+                } | undefined;
+                workers?: {
+                    name: string;
+                    role: string;
+                    status: string;
+                }[] | undefined;
+                url?: string | null | undefined;
+                approved?: boolean | undefined;
+                elapsedMs?: number | undefined;
+                timeoutSeconds?: number | undefined;
             }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").WiredServices, unknown> | import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunction<{
                 branch?: string | undefined;
                 production?: boolean | undefined;
                 ref?: string | undefined;
-                message?: string | undefined;
-                autoApply?: boolean | undefined;
+                deploymentId?: string | undefined;
+                sync?: boolean | undefined;
+                autoApprove?: boolean | undefined;
+                allowDestructive?: boolean | undefined;
+                timeout?: number | undefined;
+                json?: boolean | undefined;
             }, {
+                event: "result";
+                outcome: "queued" | "failed" | "timeout" | "succeeded" | "blocked";
                 projectId: string;
-                branch: string;
-                ref: string;
                 deploymentId: string;
-                stageId: string;
-                runId: string;
+                branch?: string | undefined;
+                ref?: string | undefined;
+                status?: string | undefined;
+                statusReason?: string | null | undefined;
+                stageId?: string | undefined;
+                runId?: string | undefined;
+                blockedReason?: "unknown" | "awaiting_approval" | "needs_config" | "needs_attention" | undefined;
+                missingSecrets?: {
+                    name: string;
+                    displayName: string | null;
+                    description: string | null;
+                    docsUrl: string | null;
+                }[] | undefined;
+                missingVariables?: {
+                    name: string;
+                    displayName: string | null;
+                    description: string | null;
+                    docsUrl: string | null;
+                }[] | undefined;
+                approvalWithheld?: "destructive_migrations" | undefined;
+                changes?: {
+                    unitsAdded: string[];
+                    unitsRemoved: string[];
+                    handlersAdded: string[];
+                    handlersRemoved: string[];
+                    workflowsAdded: string[];
+                    workflowsRemoved: string[];
+                    workflowsChanged: string[];
+                    functionsAdded: string[];
+                    functionsRemoved: string[];
+                    secretsChanged: string[];
+                    variablesChanged: string[];
+                    pendingMigrations: string[];
+                    migrationRisks: {
+                        name: string;
+                        level: "destructive" | "safe";
+                        reasons: string[];
+                    }[];
+                } | undefined;
+                workers?: {
+                    name: string;
+                    role: string;
+                    status: string;
+                }[] | undefined;
+                url?: string | null | undefined;
+                approved?: boolean | undefined;
+                elapsedMs?: number | undefined;
+                timeoutSeconds?: number | undefined;
             }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").WiredServices>, undefined, undefined>, import("../../.pikku/middleware/pikku-middleware-types.gen.js").PikkuMiddleware, (services: import("../../types/application-types.js").SingletonServices, data: any, session?: import("../../types/application-types.js").UserSession | undefined) => void | Promise<void>, string>;
             list: import("@pikku/core/cli").CoreCLICommandConfig<import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionConfig<{
                 branch: string;
@@ -499,17 +615,17 @@ export declare const fabricCommands: {
                 branch: string;
                 force?: boolean | undefined;
             }, {
-                retiredKeyId: string;
+                retiredKeyId: string | null;
             }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionSessionless<{
                 branch: string;
                 force?: boolean | undefined;
             }, {
-                retiredKeyId: string;
+                retiredKeyId: string | null;
             }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").WiredServices, unknown> | import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunction<{
                 branch: string;
                 force?: boolean | undefined;
             }, {
-                retiredKeyId: string;
+                retiredKeyId: string | null;
             }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").WiredServices>, undefined, undefined>, import("../../.pikku/middleware/pikku-middleware-types.gen.js").PikkuMiddleware, (services: import("../../types/application-types.js").SingletonServices, data: any, session?: import("../../types/application-types.js").UserSession | undefined) => void | Promise<void>, string>;
         };
     };

package/dist/src/fabric/fabric-commands.js

@@ -22,7 +22,7 @@ import { defineCLICommands, pikkuCLICommand, } from '../../.pikku/cli/pikku-cli-
 import { FabricLogin } from './functions/login.function.js';
 import { FabricInit } from './functions/init.function.js';
 import { FabricLink } from './functions/link.function.js';
-import { FabricDeployPlan, FabricDeployApply, renderDeployPlan, renderDeployApply, } from './functions/deploy.function.js';
+import { FabricDeployApply, renderDeployApply, } from './functions/deploy.function.js';
 import { FabricDeployList, renderDeployList, } from './functions/deploy-list.function.js';
 import { FabricDeployUnits, renderDeployUnits, } from './functions/deploy-units.function.js';
 import { FabricStatus, renderStatus } from './functions/status.function.js';
@@ -149,36 +149,41 @@ export const fabricCommands = defineCLICommands({
         },
     },
     deploy: {
-        description: 'Plan and apply deploys for a named branch or production',
+        description: 'Apply and inspect deploys for a named branch or production',
         subcommands: {
-            plan: pikkuCLICommand({
-                func: FabricDeployPlan,
-                render: renderDeployPlan,
-                description: 'Resolve the target ref and report what a deploy would do',
-                options: {
-                    branch: { description: 'Target branch to deploy', short: 'b' },
-                    production: {
-                        description: 'Plan production (always main)',
-                        default: false,
-                    },
-                },
-            }),
             apply: pikkuCLICommand({
                 func: FabricDeployApply,
                 render: renderDeployApply,
-                description: 'Build + deploy a named branch or production (main)',
+                description: 'Build + deploy a named branch or production (main), or attach to an existing deployment',
                 options: {
                     branch: { description: 'Target branch to deploy', short: 'b' },
                     production: {
                         description: 'Deploy production (always main)',
                         default: false,
                     },
-                    message: {
-                        description: 'Annotation stored on the deployment',
-                        short: 'm',
+                    ref: {
+                        description: 'Deploy a specific ref instead of the branch head',
+                    },
+                    deploymentId: {
+                        description: 'Attach to an existing deployment instead of creating one (not with --branch/--production)',
+                    },
+                    sync: {
+                        description: 'Wait for the deployment to finish and exit non-zero unless it went live',
+                        default: false,
+                    },
+                    autoApprove: {
+                        description: 'Answer the confirmation prompt and publish a plan parked at the approval gate',
+                        default: false,
+                    },
+                    allowDestructive: {
+                        description: 'Approve a plan whose migrations drop or rewrite data (--auto-approve alone will not)',
+                        default: false,
+                    },
+                    timeout: {
+                        description: 'Seconds to wait under --sync (default 900)',
                     },
-                    autoApply: {
-                        description: 'Deploy without the confirmation prompt',
+                    json: {
+                        description: 'Machine-readable output (NDJSON)',
                         default: false,
                     },
                 },