@pikku/cli 0.12.121 → 0.12.123

package/dist/.pikku/schemas/schemas/FabricVariablesGetOutput.schema.json

@@ -0,0 +1 @@
+{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "name": { "type": "string" }, "exists": { "type": "boolean" }, "value": {} }, "required": ["name", "exists", "value"], "additionalProperties": false }

package/dist/.pikku/schemas/schemas/FabricVariablesSetInput.schema.json

@@ -0,0 +1 @@
+{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "name": { "type": "string" }, "branch": { "type": "string" }, "value": { "type": "string" } }, "required": ["name", "branch", "value"], "additionalProperties": false }

package/dist/.pikku/schemas/schemas/FabricVariablesSetOutput.schema.json

@@ -0,0 +1 @@
+{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "name": { "type": "string" }, "success": { "type": "boolean" } }, "required": ["name", "success"], "additionalProperties": false }

package/dist/.pikku/scopes/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 /**
  * Subpath entry — `#pikku/scopes` resolves here.

package/dist/.pikku/scopes/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 /**
  * Subpath entry — `#pikku/scopes` resolves here.

package/dist/.pikku/scopes/pikku-personas.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 /**
  * This file was generated by the @pikku/cli

package/dist/.pikku/scopes/pikku-roles.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 /**
  * This file was generated by the @pikku/cli

package/dist/.pikku/scopes/pikku-scope-types.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 export { defineScope } from '@pikku/core/scope';
 export { defineSystemRole } from '@pikku/core/role';

package/dist/.pikku/scopes/pikku-scope-types.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 export { defineScope } from '@pikku/core/scope';
 export { defineSystemRole } from '@pikku/core/role';

package/dist/.pikku/scopes/pikku-scopes.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 /**
  * This file was generated by the @pikku/cli

package/dist/.pikku/secrets/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 /**
  * Subpath entry — `#pikku/secrets` resolves here.

package/dist/.pikku/secrets/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 /**
  * Subpath entry — `#pikku/secrets` resolves here.

package/dist/.pikku/secrets/pikku-secret-types.gen.d.ts

@@ -1,4 +1,4 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 export { defineSecret } from '@pikku/core/secret';

package/dist/.pikku/secrets/pikku-secret-types.gen.js

@@ -1,4 +1,4 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 export { defineSecret } from '@pikku/core/secret';

package/dist/.pikku/secrets/pikku-secrets.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 import { TypedSecretService as CoreTypedSecretService } from '@pikku/core/services';
 import type { SecretService } from '@pikku/core/services';

package/dist/.pikku/secrets/pikku-secrets.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 import { TypedSecretService as CoreTypedSecretService } from '@pikku/core/services';
 /**

package/dist/.pikku/services/pikku-meta-service.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 import { LocalMetaService } from '@pikku/core/services/local-meta';
 export declare class PikkuMetaService extends LocalMetaService {

package/dist/.pikku/services/pikku-meta-service.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 import { LocalMetaService } from '@pikku/core/services/local-meta';
 export class PikkuMetaService extends LocalMetaService {

package/dist/.pikku/setup/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 /**
  * Subpath entry — `#pikku/setup` resolves here.

package/dist/.pikku/setup/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 /**
  * Subpath entry — `#pikku/setup` resolves here.

package/dist/.pikku/setup/pikku-setup-types.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 /**
  * Config and service factory definitions, declared once per application

package/dist/.pikku/setup/pikku-setup-types.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 /**
  * Config and service factory definitions, declared once per application

package/dist/.pikku/trigger/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 /**
  * Subpath entry — `#pikku/trigger` resolves here.

package/dist/.pikku/trigger/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 /**
  * Subpath entry — `#pikku/trigger` resolves here.

package/dist/.pikku/trigger/pikku-trigger-types.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 /**
  * Trigger-specific type definitions for tree-shaking optimization

package/dist/.pikku/trigger/pikku-trigger-types.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 /**
  * Trigger-specific type definitions for tree-shaking optimization

package/dist/.pikku/variables/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 /**
  * Subpath entry — `#pikku/variables` resolves here.

package/dist/.pikku/variables/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 /**
  * Subpath entry — `#pikku/variables` resolves here.

package/dist/.pikku/variables/pikku-variable-types.gen.d.ts

@@ -1,4 +1,4 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 export { defineVariable } from '@pikku/core/variable';

package/dist/.pikku/variables/pikku-variable-types.gen.js

@@ -1,4 +1,4 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 export { defineVariable } from '@pikku/core/variable';

package/dist/.pikku/variables/pikku-variables.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 import { TypedVariablesService as CoreTypedVariablesService } from '@pikku/core/services';
 import type { VariablesService } from '@pikku/core/services';

package/dist/.pikku/variables/pikku-variables.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 import { TypedVariablesService as CoreTypedVariablesService, } from '@pikku/core/services';
 /**

package/dist/.pikku/workflow/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 /**
  * Subpath entry — `#pikku/workflow` resolves here.

package/dist/.pikku/workflow/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 /**
  * Subpath entry — `#pikku/workflow` resolves here.

package/dist/.pikku/workflow/pikku-workflow-types.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 import { WorkflowCancelledException } from '@pikku/core/workflow';
 import type { PikkuWorkflowGraphConfig, PikkuWorkflowGraphResult } from '@pikku/core/workflow';

package/dist/.pikku/workflow/pikku-workflow-types.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 import { WorkflowCancelledException } from '@pikku/core/workflow';
 import { pikkuWorkflowGraph as corePikkuWorkflowGraph } from '@pikku/core/workflow';

package/dist/.pikku/workflow/pikku-workflow-wirings-meta.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 import { pikkuState } from '@pikku/core/state';
 import allWorkflowMeta from './meta/allWorkflow.gen.json' with { type: 'json' };

package/dist/.pikku/workflow/pikku-workflow-wirings.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.121
+ * This file was generated by @pikku/cli@0.12.123
  */
 import { addWorkflow } from '@pikku/core/workflow';
 import './pikku-workflow-wirings-meta.gen.js';

package/dist/bin/pikku-bin.mjs

@@ -11,8 +11,8 @@ async function checkForUpdate() {
     })
     if (!res.ok) return
     const { version: latest } = await res.json()
-    if (latest !== '0.12.121') {
-      process.stderr.write(`\n  Update available  0.12.121 → ${latest}\n  brew upgrade pikku  or  npm install -g @pikku/cli\n\n`)
+    if (latest !== '0.12.123') {
+      process.stderr.write(`\n  Update available  0.12.123 → ${latest}\n  brew upgrade pikku  or  npm install -g @pikku/cli\n\n`)
     }
   } catch {}
 }

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

@@ -629,6 +629,58 @@ export declare const fabricCommands: {
             }, "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>;
         };
     };
+    variables: {
+        description: string;
+        subcommands: {
+            set: import("@pikku/core/cli").CoreCLICommandConfig<import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionConfig<{
+                name: string;
+                branch: string;
+                value: string;
+            }, {
+                name: string;
+                success: boolean;
+            }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionSessionless<{
+                name: string;
+                branch: string;
+                value: string;
+            }, {
+                name: string;
+                success: boolean;
+            }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").WiredServices, unknown> | import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunction<{
+                name: string;
+                branch: string;
+                value: string;
+            }, {
+                name: string;
+                success: boolean;
+            }, "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>;
+            get: import("@pikku/core/cli").CoreCLICommandConfig<import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionConfig<{
+                name: string;
+                branch: string;
+                json?: boolean | undefined;
+            }, {
+                name: string;
+                exists: boolean;
+                value: unknown;
+            }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionSessionless<{
+                name: string;
+                branch: string;
+                json?: boolean | undefined;
+            }, {
+                name: string;
+                exists: boolean;
+                value: unknown;
+            }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").WiredServices, unknown> | import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunction<{
+                name: string;
+                branch: string;
+                json?: boolean | undefined;
+            }, {
+                name: string;
+                exists: boolean;
+                value: unknown;
+            }, "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>;
+        };
+    };
     logs: import("@pikku/core/cli").CoreCLICommandConfig<import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionConfig<{
         branch?: string | undefined;
         deployment?: string | undefined;

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

@@ -32,6 +32,8 @@ import { FabricRollback } from './functions/rollback.function.js';
 import { FabricSecretsSet } from './functions/secrets-set.function.js';
 import { FabricSecretsList } from './functions/secrets-list.function.js';
 import { FabricSecretsRotate } from './functions/secrets-rotate.function.js';
+import { FabricVariablesSet } from './functions/variables-set.function.js';
+import { FabricVariablesGet } from './functions/variables-get.function.js';
 import { FabricLogs } from './functions/logs.function.js';
 import { FabricMetrics } from './functions/metrics.function.js';
 import { FabricTrace } from './functions/trace.function.js';
@@ -260,6 +262,29 @@ export const fabricCommands = defineCLICommands({
             }),
         },
     },
+    variables: {
+        description: 'Manage stage-scoped variables',
+        subcommands: {
+            set: pikkuCLICommand({
+                parameters: '<name>',
+                func: FabricVariablesSet,
+                description: 'Set a stage-scoped variable',
+                options: {
+                    branch: { description: 'Target branch', short: 'b' },
+                    value: { description: 'Variable value, read as JSON when it parses' },
+                },
+            }),
+            get: pikkuCLICommand({
+                parameters: '<name>',
+                func: FabricVariablesGet,
+                description: 'Read a stage-scoped variable back',
+                options: {
+                    branch: { description: 'Target branch', short: 'b' },
+                    json: { description: 'Machine-readable output', default: false },
+                },
+            }),
+        },
+    },
     logs: pikkuCLICommand({
         func: FabricLogs,
         description: 'Stream or fetch logs',

package/dist/src/fabric/functions/deploy.function.js

@@ -5,7 +5,7 @@ import { getFabricRPC } from '../lib/http.js';
 import { assertNamedBranchDeploySafety, resolveRef } from '../lib/git.js';
 import { promptConfirm } from '../lib/prompt.js';
 import { added, changed, removed, dim, table } from '../lib/output.js';
-import { blockedReason, blockedSummary, changesAreEmpty, classifyStatus, describeDeployment, destructiveMigrations, isApprovable, readDeploymentStatus, readWorkers, stateLabel, waitForDeployment, } from '../lib/deployment.js';
+import { blockedReason, blockedSummary, missingConfigHints, changesAreEmpty, classifyStatus, describeDeployment, destructiveMigrations, isApprovable, readDeploymentStatus, readWorkers, stateLabel, waitForDeployment, } from '../lib/deployment.js';
 const DEFAULT_TIMEOUT_SECONDS = 900;
 export const FabricDeployInput = z.object({
     branch: z.string().optional(),
@@ -359,7 +359,9 @@ export const renderDeployApply = (_s, result) => {
             console.log(dim(`Approve it with \`pikku fabric deploy apply --deployment-id ${deploymentId} --sync --auto-approve\`.`));
         }
         else if (reason === 'needs_config') {
-            console.log(dim('Set the values with `pikku fabric secrets set <name>`.'));
+            for (const hint of missingConfigHints(result.missingSecrets, result.missingVariables)) {
+                console.log(dim(hint));
+            }
         }
         return;
     }

package/dist/src/fabric/functions/variables-get.function.d.ts

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+export declare const FabricVariablesGetInput: z.ZodObject<{
+    name: z.ZodString;
+    branch: z.ZodString;
+    json: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const FabricVariablesGetOutput: z.ZodObject<{
+    name: z.ZodString;
+    exists: z.ZodBoolean;
+    value: z.ZodUnknown;
+}, z.core.$strip>;
+export declare const FabricVariablesGet: import("../../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionConfig<{
+    name: string;
+    branch: string;
+    json?: boolean | undefined;
+}, {
+    name: string;
+    exists: boolean;
+    value: unknown;
+}, "rpc" | "session", import("../../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionSessionless<{
+    name: string;
+    branch: string;
+    json?: boolean | undefined;
+}, {
+    name: string;
+    exists: boolean;
+    value: unknown;
+}, "rpc" | "session", import("../../../.pikku/function/pikku-function-types.gen.js").WiredServices, unknown> | import("../../../.pikku/function/pikku-function-types.gen.js").PikkuFunction<{
+    name: string;
+    branch: string;
+    json?: boolean | undefined;
+}, {
+    name: string;
+    exists: boolean;
+    value: unknown;
+}, "rpc" | "session", import("../../../.pikku/function/pikku-function-types.gen.js").WiredServices>, undefined, undefined>;

package/dist/src/fabric/functions/variables-get.function.js

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+import { pikkuSessionlessFunc } from '../../../.pikku/function/index.js';
+import { resolveApiContext } from '../lib/config.js';
+import { getFabricRPC } from '../lib/http.js';
+import { resolveStageId } from '../lib/stage.js';
+export const FabricVariablesGetInput = z.object({
+    name: z.string(),
+    branch: z.string(),
+    json: z.boolean().optional(),
+});
+export const FabricVariablesGetOutput = z.object({
+    name: z.string(),
+    exists: z.boolean(),
+    value: z.unknown(),
+});
+export const FabricVariablesGet = pikkuSessionlessFunc({
+    description: 'Read a stage-scoped variable back, so you can see the shape it was stored in rather than the shape you meant.',
+    input: FabricVariablesGetInput,
+    output: FabricVariablesGetOutput,
+    func: async (_services, { name, branch, json }) => {
+        const ctx = await resolveApiContext();
+        if (!ctx.token)
+            throw new Error('Not logged in. Run `pikku fabric login` first.');
+        if (!ctx.projectId)
+            throw new Error('No fabric project linked. Run `pikku fabric link` first.');
+        const rpc = getFabricRPC({ apiUrl: ctx.apiUrl, token: ctx.token });
+        const stageId = await resolveStageId(rpc, ctx.projectId, branch);
+        const { exists, value } = await rpc.invoke('getStageConsoleVariable', {
+            stageId,
+            variableId: name,
+        });
+        if (json) {
+            console.log(JSON.stringify({ branch, name, exists, value }, null, 2));
+        }
+        else if (!exists) {
+            console.log(`[fabric] ${name} is not set on ${branch}`);
+        }
+        else {
+            // `JSON.stringify` rather than the bare value, because the shape is the
+            // thing worth seeing: `true` and `"true"` print identically otherwise, and
+            // telling them apart is usually why you are looking.
+            console.log(JSON.stringify(value));
+        }
+        return { name, exists, value };
+    },
+});

package/dist/src/fabric/functions/variables-set.function.d.ts

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+export declare const FabricVariablesSetInput: z.ZodObject<{
+    name: z.ZodString;
+    branch: z.ZodString;
+    value: z.ZodString;
+}, z.core.$strip>;
+export declare const FabricVariablesSetOutput: z.ZodObject<{
+    name: z.ZodString;
+    success: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const FabricVariablesSet: import("../../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionConfig<{
+    name: string;
+    branch: string;
+    value: string;
+}, {
+    name: string;
+    success: boolean;
+}, "rpc" | "session", import("../../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionSessionless<{
+    name: string;
+    branch: string;
+    value: string;
+}, {
+    name: string;
+    success: boolean;
+}, "rpc" | "session", import("../../../.pikku/function/pikku-function-types.gen.js").WiredServices, unknown> | import("../../../.pikku/function/pikku-function-types.gen.js").PikkuFunction<{
+    name: string;
+    branch: string;
+    value: string;
+}, {
+    name: string;
+    success: boolean;
+}, "rpc" | "session", import("../../../.pikku/function/pikku-function-types.gen.js").WiredServices>, undefined, undefined>;

package/dist/src/fabric/functions/variables-set.function.js

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import { pikkuSessionlessFunc } from '../../../.pikku/function/index.js';
+import { resolveApiContext } from '../lib/config.js';
+import { getFabricRPC } from '../lib/http.js';
+import { resolveStageId } from '../lib/stage.js';
+import { parseVariableValue } from '../lib/variable-value.js';
+export const FabricVariablesSetInput = z.object({
+    name: z.string(),
+    branch: z.string(),
+    value: z.string(),
+});
+export const FabricVariablesSetOutput = z.object({
+    name: z.string(),
+    success: z.boolean(),
+});
+export const FabricVariablesSet = pikkuSessionlessFunc({
+    description: 'Set a stage-scoped variable — the deployed counterpart of a line in .env. Not a secret: the value is stored in plain form and is readable back.',
+    input: FabricVariablesSetInput,
+    output: FabricVariablesSetOutput,
+    func: async (_services, { name, branch, value }) => {
+        const ctx = await resolveApiContext();
+        if (!ctx.token)
+            throw new Error('Not logged in. Run `pikku fabric login` first.');
+        if (!ctx.projectId)
+            throw new Error('No fabric project linked. Run `pikku fabric link` first.');
+        const rpc = getFabricRPC({ apiUrl: ctx.apiUrl, token: ctx.token });
+        const stageId = await resolveStageId(rpc, ctx.projectId, branch);
+        // Deliberately not sealed, and deliberately not prompted for. A variable is
+        // configuration — a port, a URL, a feature switch — and treating it like a
+        // secret would mean it could not be read back, which is most of the value of
+        // having it separate from `secrets` in the first place. Anything that would
+        // hurt to print belongs in `pikku fabric secrets set`.
+        const { success } = await rpc.invoke('setStageConsoleVariable', {
+            stageId,
+            variableId: name,
+            value: parseVariableValue(value),
+        });
+        console.log(`[fabric] ${name} set on ${branch}.`);
+        return { name, success };
+    },
+});

package/dist/src/fabric/lib/deployment.d.ts

@@ -8,6 +8,20 @@ export declare function blockedReason(statusReason: string | null): BlockedReaso
 export declare function isApprovable(reason: BlockedReason): boolean;
 export declare function stateLabel(status: string, statusReason: string | null): string;
 export declare function blockedSummary(reason: BlockedReason): string;
+/**
+ * What to tell someone whose deploy is blocked on config they have not set.
+ *
+ * Secrets and variables go missing in the same way and are set by two different
+ * commands: `pikku fabric secrets set` seals a value the stage can never read
+ * back, `pikku fabric variables set` writes one it can. Naming one command for
+ * both sends anyone blocked on the other kind to a command that refuses their
+ * value, which reads as the command being broken rather than as the wrong one.
+ */
+export declare function missingConfigHints(missingSecrets: readonly {
+    name: string;
+}[] | undefined, missingVariables: readonly {
+    name: string;
+}[] | undefined): string[];
 export interface DeploymentStatus {
     status: string;
     statusReason: string | null;