@pikku/cli 0.12.126 → 0.12.128

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

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

package/dist/src/cli.wiring.js

@@ -12,6 +12,7 @@ import { pikkuCLICommand, wireCLI } from '../.pikku/cli/pikku-cli-types.gen.js';
 import { fabricCommands } from './fabric/fabric-commands.js';
 import { all } from './functions/commands/all.js';
 import { bootstrap } from './functions/commands/bootstrap.js';
+import { pikkuDist } from './functions/commands/dist.js';
 import { watch } from './functions/commands/watch.js';
 import { login, logout, whoami } from './functions/commands/login.js';
 import { dev } from './functions/commands/dev.js';
@@ -231,6 +232,16 @@ wireCLI({
             func: bootstrap,
             description: 'Generate only type files (setup phase only)',
         }),
+        dist: pikkuCLICommand({
+            func: pikkuDist,
+            description: "Copy the generated files tsc cannot emit — the .gen.json meta, and hand-authored .d.ts — into the build output. Run it after tsc, as a package's build script",
+            options: {
+                distDir: {
+                    description: "Where to copy to. Defaults to the tsconfig's compilerOptions.outDir",
+                    type: 'string',
+                },
+            },
+        }),
         audit: pikkuCLICommand({
             func: pikkuAudit,
             description: 'Audit dependencies for security advisories (always) and available updates (--outdated); writes .pikku/audit.json',
@@ -635,7 +646,7 @@ wireCLI({
                 }),
                 sync: pikkuCLICommand({
                     func: personaSync,
-                    description: "Report which personas an environment will provision, with which roles, and why any of them were skipped. The provisioning itself happens in the deployment — call provisionPersonas from '@pikku/better-auth' in your server lifecycle — because the CLI has no connection to a deployed environment's database.",
+                    description: "Report which personas an environment will provision, with which roles, and why any of them were skipped. The provisioning itself happens in the deployment — pass the generated personas to pikkuFabric from '@pikku/better-auth' — because the CLI has no connection to a deployed environment's database.",
                     parameters: '<environment>',
                 }),
                 list: pikkuCLICommand({
@@ -829,6 +840,10 @@ wireCLI({
                             description: 'Convert snake_case property names to camelCase in generated Zod schemas',
                             default: false,
                         },
+                        build: {
+                            description: 'Install and build the generated addon (an unbuilt addon exports a dist/ that does not exist yet, so every ref() into it is dead at runtime)',
+                            default: true,
+                        },
                     },
                 }),
             },

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

@@ -611,6 +611,31 @@ export declare const fabricCommands: {
                     updatedAt: 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>;
+            delete: import("@pikku/core/cli").CoreCLICommandConfig<import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionConfig<{
+                name: string;
+                branch?: string | undefined;
+                force?: boolean | undefined;
+            }, {
+                name: string;
+                runId: string | null;
+                deploymentId: string | null;
+            }, "rpc" | "session", import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionSessionless<{
+                name: string;
+                branch?: string | undefined;
+                force?: boolean | undefined;
+            }, {
+                name: string;
+                runId: string | null;
+                deploymentId: string | null;
+            }, "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 | undefined;
+                force?: boolean | undefined;
+            }, {
+                name: string;
+                runId: string | null;
+                deploymentId: 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>;
             rotate: import("@pikku/core/cli").CoreCLICommandConfig<import("../../.pikku/function/pikku-function-types.gen.js").PikkuFunctionConfig<{
                 branch?: string | undefined;
                 force?: boolean | undefined;
@@ -709,6 +734,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

@@ -32,6 +32,7 @@ import { FabricDbSchema, renderDbSchema, } from './functions/db-schema.function.
 import { FabricRollback } from './functions/rollback.function.js';
 import { FabricSecretsSet } from './functions/secrets-set.function.js';
 import { FabricSecretsList } from './functions/secrets-list.function.js';
+import { FabricSecretsDelete } from './functions/secrets-delete.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';
@@ -46,6 +47,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({
@@ -250,6 +255,18 @@ export const fabricCommands = defineCLICommands({
                     json: { description: 'Machine-readable output', default: false },
                 },
             }),
+            delete: pikkuCLICommand({
+                parameters: '<name>',
+                func: FabricSecretsDelete,
+                description: 'Delete a single stage-scoped secret',
+                options: {
+                    branch: { description: 'Target branch', short: 'b' },
+                    force: {
+                        description: 'Delete without confirmation',
+                        default: false,
+                    },
+                },
+            }),
             rotate: pikkuCLICommand({
                 func: FabricSecretsRotate,
                 description: "Retire a stage's sealing key (secrets must be set again)",
@@ -302,6 +319,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/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>;

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

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import { pikkuSessionlessFunc } from '../../../.pikku/function/index.js';
+import { resolveApiContext } from '../lib/config.js';
+import { flushSpool } from '../lib/finding-spool.js';
+export const FabricFindingsFlushInput = z.object({
+    apiUrl: z.string().optional(),
+});
+export const FabricFindingsFlushOutput = z.object({
+    sent: z.number(),
+    remaining: z.number(),
+    reason: z.string().optional(),
+});
+/**
+ * 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 const FabricFindingsFlush = pikkuSessionlessFunc({
+    description: 'Send every finding queued locally.',
+    input: FabricFindingsFlushInput,
+    output: FabricFindingsFlushOutput,
+    func: async (_services, { apiUrl: apiUrlOverride }) => {
+        const ctx = await resolveApiContext({ apiUrlOverride });
+        if (!ctx.token)
+            throw new Error('Not logged in. Run `pikku fabric login` first.');
+        const result = await flushSpool({
+            apiUrl: ctx.apiUrl,
+            token: ctx.token,
+            projectId: ctx.projectId,
+        });
+        console.log(result.remaining === 0
+            ? `[fabric] sent ${result.sent} finding(s)`
+            : `[fabric] sent ${result.sent}, ${result.remaining} still queued (${result.reason})`);
+        return result;
+    },
+});

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

@@ -0,0 +1,55 @@
+import { z } from 'zod';
+export declare const FabricFindingsListInput: z.ZodObject<{}, z.core.$strip>;
+export declare const FabricFindingsListOutput: z.ZodObject<{
+    findings: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        kind: z.ZodString;
+        reason: z.ZodString;
+        reportedAt: z.ZodString;
+        projectId: z.ZodNullable<z.ZodString>;
+        file: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * What is waiting to be sent. Without this the spool is invisible, and an
+ * agent has no way to tell a finding that reached fabric from one still
+ * sitting on the machine.
+ */
+export declare const FabricFindingsList: 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>;
+type QueuedFinding = {
+    title: string;
+    kind: string;
+    reason: string;
+    reportedAt: string;
+};
+export declare const renderFindingsList: (_s: unknown, { findings }: {
+    findings: QueuedFinding[];
+}) => void;
+export {};