@pikku/cli 0.12.125 → 0.12.127

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.125
+ * This file was generated by @pikku/cli@0.12.127
  */
 /**
  * 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.125
+ * This file was generated by @pikku/cli@0.12.127
  */
 /**
  * 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.125
+ * This file was generated by @pikku/cli@0.12.127
  */
 /**
  * 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.125
+ * This file was generated by @pikku/cli@0.12.127
  */
 /**
  * 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.125
+ * This file was generated by @pikku/cli@0.12.127
  */
 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.125
+ * This file was generated by @pikku/cli@0.12.127
  */
 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.125
+ * This file was generated by @pikku/cli@0.12.127
  */
 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.125
+ * This file was generated by @pikku/cli@0.12.127
  */
 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.125
+ * This file was generated by @pikku/cli@0.12.127
  */
 /**
  * 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.125
+ * This file was generated by @pikku/cli@0.12.127
  */
 /**
  * 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.125
+ * This file was generated by @pikku/cli@0.12.127
  */
 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.125
+ * This file was generated by @pikku/cli@0.12.127
  */
 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.125
+ * This file was generated by @pikku/cli@0.12.127
  */
 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.125
+ * This file was generated by @pikku/cli@0.12.127
  */
 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.125') {
-      process.stderr.write(`\n  Update available  0.12.125 → ${latest}\n  brew upgrade pikku  or  npm install -g @pikku/cli\n\n`)
+    if (latest !== '0.12.127') {
+      process.stderr.write(`\n  Update available  0.12.127 → ${latest}\n  brew upgrade pikku  or  npm install -g @pikku/cli\n\n`)
     }
   } catch {}
 }

package/dist/src/cli.wiring.js

@@ -35,7 +35,7 @@ import { validate, renderValidate } from './functions/commands/validate.js';
 import { knowledgeValidate, renderKnowledgeValidate, } from './functions/commands/knowledge-validate.js';
 import { knowledgeIndex, renderKnowledgeIndex, } from './functions/commands/knowledge-index.js';
 import { scenarioRun, scenarioList } from './functions/commands/scenario.js';
-import { personaList, personaRun } from './functions/commands/persona.js';
+import { personaList, personaRun, personaSecret, } from './functions/commands/persona.js';
 import { personaSync } from './functions/commands/persona-sync.js';
 import { pikkuVersionsInit } from './functions/commands/versions-init.js';
 import { pikkuEmailsInit } from './functions/commands/emails-init.js';
@@ -642,6 +642,11 @@ wireCLI({
                     func: personaList,
                     description: 'List the declared personas — who each one is, what they may do, and what they are trying to get done',
                 }),
+                secret: pikkuCLICommand({
+                    func: personaSecret,
+                    description: 'Mint the actor credential for a persona from SCENARIO_ACTOR_SECRET, bound to their address. Hand these to a run as PIKKU_PERSONA_SECRETS instead of the root, which is entitled to every persona. Names none, mints all.',
+                    parameters: '[personas...]',
+                }),
             },
         },
         fabric: {

package/dist/src/deploy/bundler/bun-bundler.js

@@ -96,11 +96,18 @@ export class BunBundler extends BaseBundler {
             entrypoints: [input.entryPath],
             target: input.platform === 'node' ? 'node' : 'browser',
             format: input.format === 'cjs' ? 'cjs' : 'esm',
-            // identifiers:true is safe — pikku's only name-based reflection
-            // (error→status mapping) compares a class against an instance of the SAME
-            // (consistently-renamed) class, and workflow exceptions hardcode their
-            // `.name` string. So full minification preserves correctness.
-            minify: { whitespace: true, syntax: true, identifiers: true },
+            // keepNames matches the esbuild bundler, which has always set it. The
+            // error→status mapping survives renaming either way — it compares a
+            // class against an instance of the SAME consistently-renamed class —
+            // but `Function.name` reaches further than that: it is the name every
+            // error answers with on the wire, the one an unregistered error is
+            // matched by, and what appears in a stack trace someone has to read.
+            minify: {
+                whitespace: true,
+                syntax: true,
+                identifiers: true,
+                keepNames: true,
+            },
             sourcemap: input.sourcemap ? 'external' : 'none',
             define: input.define,
             banner: input.bannerJs,

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

@@ -563,7 +563,7 @@ export declare const fabricCommands: {
         subcommands: {
             set: import("@pikku/core/cli").CoreCLICommandConfig<import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionConfig<{
                 name: string;
-                branch: string;
+                branch?: string | undefined;
                 value?: string | undefined;
                 force?: boolean | undefined;
             }, {
@@ -571,7 +571,7 @@ export declare const fabricCommands: {
                 keyId: string;
             }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionSessionless<{
                 name: string;
-                branch: string;
+                branch?: string | undefined;
                 value?: string | undefined;
                 force?: boolean | undefined;
             }, {
@@ -579,7 +579,7 @@ export declare const fabricCommands: {
                 keyId: string;
             }, "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;
+                branch?: string | undefined;
                 value?: string | undefined;
                 force?: boolean | undefined;
             }, {
@@ -587,7 +587,7 @@ export declare const fabricCommands: {
                 keyId: string;
             }, "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;
+                branch?: string | undefined;
                 json?: boolean | undefined;
             }, {
                 secrets: {
@@ -595,7 +595,7 @@ export declare const fabricCommands: {
                     updatedAt: string;
                 }[];
             }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionSessionless<{
-                branch: string;
+                branch?: string | undefined;
                 json?: boolean | undefined;
             }, {
                 secrets: {
@@ -603,7 +603,7 @@ export declare const fabricCommands: {
                     updatedAt: string;
                 }[];
             }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").WiredServices, unknown> | import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunction<{
-                branch: string;
+                branch?: string | undefined;
                 json?: boolean | undefined;
             }, {
                 secrets: {
@@ -612,17 +612,17 @@ 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>;
             rotate: import("@pikku/core/cli").CoreCLICommandConfig<import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionConfig<{
-                branch: string;
+                branch?: string | undefined;
                 force?: boolean | undefined;
             }, {
                 retiredKeyId: string | null;
             }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionSessionless<{
-                branch: string;
+                branch?: string | undefined;
                 force?: boolean | undefined;
             }, {
                 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;
+                branch?: string | undefined;
                 force?: boolean | undefined;
             }, {
                 retiredKeyId: string | null;
@@ -634,29 +634,29 @@ export declare const fabricCommands: {
         subcommands: {
             set: import("@pikku/core/cli").CoreCLICommandConfig<import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionConfig<{
                 name: string;
-                branch: string;
                 value: string;
+                branch?: string | undefined;
             }, {
                 name: string;
                 success: boolean;
             }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionSessionless<{
                 name: string;
-                branch: string;
                 value: string;
+                branch?: string | undefined;
             }, {
                 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;
+                branch?: string | undefined;
             }, {
                 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;
+                branch?: string | undefined;
                 json?: boolean | undefined;
             }, {
                 name: string;
@@ -664,7 +664,7 @@ export declare const fabricCommands: {
                 value: unknown;
             }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionSessionless<{
                 name: string;
-                branch: string;
+                branch?: string | undefined;
                 json?: boolean | undefined;
             }, {
                 name: string;
@@ -672,7 +672,7 @@ export declare const fabricCommands: {
                 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;
+                branch?: string | undefined;
                 json?: boolean | undefined;
             }, {
                 name: string;
@@ -709,6 +709,144 @@ export declare const fabricCommands: {
     }, {
         count: number;
     }, "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>;
+    report: import("@pikku/core/cli").CoreCLICommandConfig<import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionConfig<{
+        title?: string | undefined;
+        kind?: "product" | "harness" | undefined;
+        model?: string | undefined;
+        expected?: string | undefined;
+        actual?: string | undefined;
+        skill?: string | undefined;
+        passage?: string | undefined;
+        command?: string | undefined;
+        error?: string | undefined;
+        repro?: string | undefined;
+        workaround?: string | undefined;
+        proposal?: string | undefined;
+        tried?: string | undefined;
+        unresolved?: boolean | undefined;
+        area?: string | undefined;
+        surface?: "local" | "deployed" | "both" | undefined;
+        cost?: string | undefined;
+        run?: string | undefined;
+        deployTarget?: string | undefined;
+        stdin?: boolean | undefined;
+    }, {
+        sent: boolean;
+        spooled: boolean;
+        queued: number;
+        reason?: string | undefined;
+    }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionSessionless<{
+        title?: string | undefined;
+        kind?: "product" | "harness" | undefined;
+        model?: string | undefined;
+        expected?: string | undefined;
+        actual?: string | undefined;
+        skill?: string | undefined;
+        passage?: string | undefined;
+        command?: string | undefined;
+        error?: string | undefined;
+        repro?: string | undefined;
+        workaround?: string | undefined;
+        proposal?: string | undefined;
+        tried?: string | undefined;
+        unresolved?: boolean | undefined;
+        area?: string | undefined;
+        surface?: "local" | "deployed" | "both" | undefined;
+        cost?: string | undefined;
+        run?: string | undefined;
+        deployTarget?: string | undefined;
+        stdin?: boolean | undefined;
+    }, {
+        sent: boolean;
+        spooled: boolean;
+        queued: number;
+        reason?: string | undefined;
+    }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").WiredServices, unknown> | import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunction<{
+        title?: string | undefined;
+        kind?: "product" | "harness" | undefined;
+        model?: string | undefined;
+        expected?: string | undefined;
+        actual?: string | undefined;
+        skill?: string | undefined;
+        passage?: string | undefined;
+        command?: string | undefined;
+        error?: string | undefined;
+        repro?: string | undefined;
+        workaround?: string | undefined;
+        proposal?: string | undefined;
+        tried?: string | undefined;
+        unresolved?: boolean | undefined;
+        area?: string | undefined;
+        surface?: "local" | "deployed" | "both" | undefined;
+        cost?: string | undefined;
+        run?: string | undefined;
+        deployTarget?: string | undefined;
+        stdin?: boolean | undefined;
+    }, {
+        sent: boolean;
+        spooled: boolean;
+        queued: number;
+        reason?: 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>;
+    findings: {
+        description: string;
+        subcommands: {
+            list: import("@pikku/core/cli").CoreCLICommandConfig<import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionConfig<Record<string, never>, {
+                findings: {
+                    title: string;
+                    kind: string;
+                    reason: string;
+                    reportedAt: string;
+                    projectId: string | null;
+                    file: string;
+                }[];
+            }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionSessionless<Record<string, never>, {
+                findings: {
+                    title: string;
+                    kind: string;
+                    reason: string;
+                    reportedAt: string;
+                    projectId: string | null;
+                    file: string;
+                }[];
+            }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").WiredServices, unknown> | import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunction<Record<string, never>, {
+                findings: {
+                    title: string;
+                    kind: string;
+                    reason: string;
+                    reportedAt: string;
+                    projectId: string | null;
+                    file: string;
+                }[];
+            }, "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>;
+            flush: import("@pikku/core/cli").CoreCLICommandConfig<import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionConfig<{
+                apiUrl?: string | undefined;
+            }, {
+                sent: number;
+                remaining: number;
+                reason?: string | undefined;
+            }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionSessionless<{
+                apiUrl?: string | undefined;
+            }, {
+                sent: number;
+                remaining: number;
+                reason?: string | undefined;
+            }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").WiredServices, unknown> | import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunction<{
+                apiUrl?: string | undefined;
+            }, {
+                sent: number;
+                remaining: number;
+                reason?: 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>;
+            clear: import("@pikku/core/cli").CoreCLICommandConfig<import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionConfig<Record<string, never>, {
+                dropped: number;
+            }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionSessionless<Record<string, never>, {
+                dropped: number;
+            }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").WiredServices, unknown> | import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunction<Record<string, never>, {
+                dropped: number;
+            }, "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>;
+        };
+    };
     metrics: import("@pikku/core/cli").CoreCLICommandConfig<import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionConfig<{
         branch: string;
         hours?: number | undefined;

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

@@ -46,6 +46,10 @@ import { FabricValidate, renderValidate, } from './functions/validate.function.j
 import { FabricSmoke, renderSmoke } from './functions/smoke.function.js';
 import { FabricPublish } from './functions/publish.function.js';
 import { FabricAdd } from './functions/add.function.js';
+import { FabricReport } from './functions/report.function.js';
+import { FabricFindingsList, renderFindingsList, } from './functions/findings-list.function.js';
+import { FabricFindingsFlush } from './functions/findings-flush.function.js';
+import { FabricFindingsClear } from './functions/findings-clear.function.js';
 import { FabricAddonVerify, renderAddonVerify, } from './functions/addon-verify.function.js';
 export const fabricCommands = defineCLICommands({
     validate: pikkuCLICommand({
@@ -302,6 +306,67 @@ export const fabricCommands = defineCLICommands({
             json: { description: 'Machine-readable output', default: false },
         },
     }),
+    report: pikkuCLICommand({
+        parameters: '[title]',
+        func: FabricReport,
+        description: 'Report a finding — something about pikku that cost time — to fabric',
+        options: {
+            stdin: {
+                description: 'Read the whole finding as JSON on stdin instead of from flags (prose survives the shell intact)',
+                default: false,
+            },
+            kind: {
+                description: 'product (fix pikku) or harness (fix the skill that misled you)',
+            },
+            model: { description: 'The model that hit this' },
+            expected: { description: 'What you expected pikku to do' },
+            actual: { description: 'What it did instead' },
+            skill: {
+                description: 'For a harness finding, the skill that misled you',
+            },
+            passage: { description: 'The passage in that skill it contradicts' },
+            command: { description: 'The command you ran' },
+            error: { description: "The error's message line, verbatim" },
+            repro: { description: 'The shortest way to reach it again' },
+            workaround: { description: 'What you did instead, inside the app' },
+            proposal: {
+                description: 'What pikku should do — named file and function, mechanism, suggested change',
+            },
+            tried: {
+                description: 'For an unresolved finding, what you tried and how each attempt failed',
+            },
+            unresolved: {
+                description: 'No workaround was found — a blocker, not a tax',
+                default: false,
+            },
+            area: { description: 'The part of pikku this is about' },
+            surface: { description: 'Where it showed up: local, deployed or both' },
+            cost: { description: 'What it cost, measured or estimated' },
+            run: { description: 'Run id, to group findings from one build' },
+            deployTarget: { description: 'The deploy target in use' },
+        },
+    }),
+    findings: {
+        description: 'Inspect the findings held locally because they could not be sent',
+        subcommands: {
+            list: pikkuCLICommand({
+                func: FabricFindingsList,
+                render: renderFindingsList,
+                description: 'List the findings queued locally, waiting to be sent',
+            }),
+            flush: pikkuCLICommand({
+                func: FabricFindingsFlush,
+                description: 'Send every finding queued locally',
+                options: {
+                    apiUrl: { description: 'Override the fabric-api URL for this call' },
+                },
+            }),
+            clear: pikkuCLICommand({
+                func: FabricFindingsClear,
+                description: 'Discard every queued finding without sending it',
+            }),
+        },
+    },
     metrics: pikkuCLICommand({
         func: FabricMetrics,
         description: 'Show request rate / error rate / latency for a stage',

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, missingConfigHints, changesAreEmpty, classifyStatus, describeDeployment, destructiveMigrations, isApprovable, readDeploymentStatus, readWorkers, stateLabel, waitForDeployment, } from '../lib/deployment.js';
+import { blockedReason, blockedSummary, missingConfigHints, changesAreEmpty, classifyStatus, describeDeployment, destructiveMigrations, isApprovable, readDeploymentStatus, readWorkers, reconcileDeployedRef, stateLabel, waitForDeployment, } from '../lib/deployment.js';
 const DEFAULT_TIMEOUT_SECONDS = 900;
 export const FabricDeployInput = z.object({
     branch: z.string().optional(),
@@ -181,7 +181,17 @@ export const FabricDeployApply = pikkuSessionlessFunc({
             deploymentId = created.deploymentId;
             stageId = created.stageId;
             runId = created.runId;
-            emit({ event: 'created', deploymentId, branch, ref: resolved });
+            // Read the commit back off the deployment rather than repeating the one
+            // that was asked for: `deployByStageKind` attaches to an already-parked
+            // plan for the branch instead of cutting a new one, and that plan is
+            // pinned to whatever commit it was created at.
+            ref = reconcileDeployedRef({
+                requested: resolved,
+                actual: (await describeDeployment(rpc, projectId, deploymentId))?.gitSha ??
+                    null,
+                deploymentId,
+            });
+            emit({ event: 'created', deploymentId, branch, ref });
         }
         const base = {
             event: 'result',

package/dist/src/fabric/functions/findings-clear.function.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+export declare const FabricFindingsClearInput: z.ZodObject<{}, z.core.$strip>;
+export declare const FabricFindingsClearOutput: z.ZodObject<{
+    dropped: z.ZodNumber;
+}, z.core.$strip>;
+export declare const FabricFindingsClear: import("../../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionConfig<Record<string, never>, {
+    dropped: number;
+}, "rpc" | "session", import("../../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionSessionless<Record<string, never>, {
+    dropped: number;
+}, "rpc" | "session", import("../../../.pikku/function/pikku-function-types.gen.js").WiredServices, unknown> | import("../../../.pikku/function/pikku-function-types.gen.js").PikkuFunction<Record<string, never>, {
+    dropped: number;
+}, "rpc" | "session", import("../../../.pikku/function/pikku-function-types.gen.js").WiredServices>, undefined, undefined>;

package/dist/src/fabric/functions/findings-clear.function.js

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import { pikkuSessionlessFunc } from '../../../.pikku/function/index.js';
+import { clearSpool } from '../lib/finding-spool.js';
+export const FabricFindingsClearInput = z.object({});
+export const FabricFindingsClearOutput = z.object({
+    dropped: z.number(),
+});
+export const FabricFindingsClear = pikkuSessionlessFunc({
+    description: 'Discard every finding queued locally without sending it.',
+    input: FabricFindingsClearInput,
+    output: FabricFindingsClearOutput,
+    func: async () => {
+        const dropped = await clearSpool();
+        console.log(`[fabric] dropped ${dropped} queued finding(s)`);
+        return { dropped };
+    },
+});

package/dist/src/fabric/functions/findings-flush.function.d.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+export declare const FabricFindingsFlushInput: z.ZodObject<{
+    apiUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const FabricFindingsFlushOutput: z.ZodObject<{
+    sent: z.ZodNumber;
+    remaining: z.ZodNumber;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Explicitly asked for, so unlike `report` this one says plainly that it
+ * cannot run: someone who typed `flush` wants to know the login is missing,
+ * not to have the queue quietly stay put.
+ */
+export declare const FabricFindingsFlush: import("../../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionConfig<{
+    apiUrl?: string | undefined;
+}, {
+    sent: number;
+    remaining: number;
+    reason?: string | undefined;
+}, "rpc" | "session", import("../../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionSessionless<{
+    apiUrl?: string | undefined;
+}, {
+    sent: number;
+    remaining: number;
+    reason?: string | undefined;
+}, "rpc" | "session", import("../../../.pikku/function/pikku-function-types.gen.js").WiredServices, unknown> | import("../../../.pikku/function/pikku-function-types.gen.js").PikkuFunction<{
+    apiUrl?: string | undefined;
+}, {
+    sent: number;
+    remaining: number;
+    reason?: string | undefined;
+}, "rpc" | "session", import("../../../.pikku/function/pikku-function-types.gen.js").WiredServices>, undefined, undefined>;