@pikku/cli 0.12.122 → 0.12.124

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

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

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

@@ -16,6 +16,7 @@ import { writeFile, mkdir, stat, readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { createHash } from 'node:crypto';
 import { resolveExternalVersions, generateMinimalPackageJson, } from './dep-extractor.js';
+import { SERVICE_MODULE_MAP } from './service-module-map.js';
 /**
  * Mapping of service name -> gen file pattern that should be stubbed
  * when the service is not required by a deployment unit.
@@ -23,21 +24,6 @@ import { resolveExternalVersions, generateMinimalPackageJson, } from './dep-extr
 const SERVICE_GEN_FILE_MAP = {
     metaService: /pikku-meta-service\.gen/,
 };
-/**
- * Mapping of service name -> npm module patterns to stub when the service is
- * NOT required by a deployment unit. Unlike SERVICE_GEN_FILE_MAP these are
- * external packages, not gen files: a unit that doesn't wire the service never
- * executes the code path that imports them, so replacing them with `export {}`
- * keeps their (often large) trees out of the bundle.
- *
- * The AI SDKs (@pikku/ai-vercel + @ai-sdk/* + `ai`, ~3MB) are only constructed
- * when `agentRunner` is wired (agent units). Every non-agent unit stubs them.
- * The shared services factory must guard the runner construction behind a
- * defined-check on the dynamic import so a stubbed unit simply skips it.
- */
-const SERVICE_MODULE_MAP = {
-    agentRunner: [/^@pikku\/ai-vercel/, /^@ai-sdk\//, /^ai$/],
-};
 /**
  * Read the per-unit pikku-services.gen.ts and return the set of gen file
  * patterns that should be stubbed (because their service is not required).

package/dist/src/deploy/bundler/service-module-map.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Mapping of service name -> npm module patterns to stub when the service is
+ * NOT required by a deployment unit. These are external packages, not gen
+ * files: a unit that doesn't wire the service never executes the code path
+ * that imports them, so replacing them with `export {}` keeps their (often
+ * large) trees out of the bundle.
+ *
+ * The AI SDKs (@pikku/ai-vercel + @ai-sdk/* + `ai`, ~3MB) are only constructed
+ * when `agentRunner` is wired (agent units). Every non-agent unit stubs them.
+ * The shared services factory must guard the runner construction behind a
+ * defined-check on the dynamic import so a stubbed unit simply skips it.
+ *
+ * It lives in its own module so `pikku validate` can warn about a static import
+ * of a stubbed package without pulling the bundler in — a check that reads a
+ * second copy of this list would go stale the first time the list changed.
+ */
+export declare const SERVICE_MODULE_MAP: Record<string, RegExp[]>;

package/dist/src/deploy/bundler/service-module-map.js

@@ -0,0 +1,19 @@
+/**
+ * Mapping of service name -> npm module patterns to stub when the service is
+ * NOT required by a deployment unit. These are external packages, not gen
+ * files: a unit that doesn't wire the service never executes the code path
+ * that imports them, so replacing them with `export {}` keeps their (often
+ * large) trees out of the bundle.
+ *
+ * The AI SDKs (@pikku/ai-vercel + @ai-sdk/* + `ai`, ~3MB) are only constructed
+ * when `agentRunner` is wired (agent units). Every non-agent unit stubs them.
+ * The shared services factory must guard the runner construction behind a
+ * defined-check on the dynamic import so a stubbed unit simply skips it.
+ *
+ * It lives in its own module so `pikku validate` can warn about a static import
+ * of a stubbed package without pulling the bundler in — a check that reads a
+ * second copy of this list would go stale the first time the list changed.
+ */
+export const SERVICE_MODULE_MAP = {
+    agentRunner: [/^@pikku\/ai-vercel/, /^@ai-sdk\//, /^ai$/],
+};

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/validate.function.js

@@ -66,6 +66,15 @@ async function listSourceFiles(dir) {
         return [];
     }
 }
+/**
+ * Blanks comment bodies so a raw-text scan cannot read prose as code. Prose in a
+ * scenario description ("Converted from the Gherkin scenario...") otherwise
+ * matches the import scanner's `from "..."` and reports a package that is really
+ * a sentence.
+ */
+const stripCommentText = (text) => text
+    .replace(/\/\*[\s\S]*?\*\//g, (m) => m.replace(/[^\n]/g, ' '))
+    .replace(/(^|[^:'"`\\])\/\/[^\n]*/g, (_m, p1) => p1);
 // Heavy/generated dirs pruned during a source walk.
 const SKIP_WALK_DIRS = new Set([
     'node_modules',
@@ -487,11 +496,14 @@ export async function runValidate(startDir = process.cwd(), opts = {}) {
                 const txt = await readTextSafe(file);
                 if (!txt)
                     continue;
+                const src = stripCommentText(txt);
                 const re = /(?:from|import|require)\s*\(?\s*['"]([^'".#][^'"]*)['"]/g;
                 let m;
-                while ((m = re.exec(txt))) {
+                while ((m = re.exec(src))) {
                     const spec = m[1];
-                    if (spec.startsWith('node:') ||
+                    if (/\s/.test(spec) ||
+                        spec.startsWith('node:') ||
+                        spec.startsWith('bun:') ||
                         spec.startsWith('@/') ||
                         spec.startsWith('~') ||
                         spec.startsWith('virtual:') ||
@@ -1180,23 +1192,74 @@ export async function runValidate(startDir = process.cwd(), opts = {}) {
         }
         if (keysByValue.size > 0) {
             const STRING_LITERAL = /(?<![A-Za-z0-9_$])(['"])((?:[^\\\n]|\\.){2,200}?)\1/g;
+            // A literal in `someKey: '...'` position is only copy when the key names
+            // something the browser renders. `unit: 'kg'` is an RPC payload field that
+            // happens to read like the catalogue's `unit_kg` label for a form suffix —
+            // rewriting it to a message lookup would bind a stored value to UI copy.
+            const PROPERTY_KEY = /([A-Za-z_$][A-Za-z0-9_$]*)\s*:\s*$/;
+            // The innermost call whose argument list `index` sits in. Walks back
+            // balancing brackets, so in `expect(await page.getByText('Save'), ...)`
+            // the literal belongs to `getByText`, which is a locator and is still
+            // scanned.
+            const enclosingCall = (code, index) => {
+                let depth = 0;
+                for (let i = index - 1; i >= 0; i--) {
+                    const ch = code[i];
+                    if (ch === ')' || ch === ']' || ch === '}')
+                        depth++;
+                    else if (ch === '(' || ch === '[' || ch === '{') {
+                        if (depth > 0) {
+                            depth--;
+                            continue;
+                        }
+                        if (ch !== '(')
+                            return null;
+                        return (/([A-Za-z_$][A-Za-z0-9_$]*)\s*$/.exec(code.slice(0, i))?.[1] ??
+                            null);
+                    }
+                }
+                return null;
+            };
+            const UI_TEXT_KEYS = new Set([
+                'alt',
+                'button',
+                'caption',
+                'heading',
+                'label',
+                'link',
+                'name',
+                'option',
+                'placeholder',
+                'tab',
+                'text',
+                'title',
+                'value',
+            ]);
             for (const file of await walkSourceFiles(root)) {
                 if (!/\.(steps|scenario)\.tsx?$/.test(file))
                     continue;
                 const text = await readTextSafe(file);
                 if (!text)
                     continue;
-                const code = text
-                    .replace(/\/\*[\s\S]*?\*\//g, '')
-                    .replace(/(^|[^:'"`\\])\/\/[^\n]*/g, '$1');
+                const code = stripCommentText(text);
                 const hits = [];
                 for (const match of code.matchAll(STRING_LITERAL)) {
                     const literal = match[2];
                     if (!literal)
                         continue;
                     const keys = keysByValue.get(literal);
-                    if (keys)
-                        hits.push(`"${literal}" → ${keys.join(' | ')}`);
+                    if (!keys)
+                        continue;
+                    // `expect(item.unit, 'kg')` asserts on a value the RPC returned,
+                    // not on anything the browser rendered. Reading it from the
+                    // catalogue would bind a stored value to UI copy, and the assertion
+                    // would then pass against whatever the label happened to say.
+                    if (enclosingCall(code, match.index) === 'expect')
+                        continue;
+                    const property = PROPERTY_KEY.exec(code.slice(0, match.index));
+                    if (property && !UI_TEXT_KEYS.has(property[1]))
+                        continue;
+                    hits.push(`"${literal}" → ${keys.join(' | ')}`);
                 }
                 if (hits.length === 0)
                     continue;

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;

package/dist/src/fabric/lib/deployment.js

@@ -59,6 +59,30 @@ export function blockedSummary(reason) {
             return 'Deployment is suspended';
     }
 }
+/**
+ * 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 function missingConfigHints(missingSecrets, missingVariables) {
+    const secrets = missingSecrets ?? [];
+    const variables = missingVariables ?? [];
+    const hints = [];
+    if (secrets.length > 0) {
+        hints.push(`Set the secret${secrets.length > 1 ? 's' : ''} with \`pikku fabric secrets set <name>\`: ${secrets.map((s) => s.name).join(', ')}.`);
+    }
+    if (variables.length > 0) {
+        hints.push(`Set the variable${variables.length > 1 ? 's' : ''} with \`pikku fabric variables set <name> <value>\`: ${variables.map((v) => v.name).join(', ')}.`);
+    }
+    if (hints.length === 0) {
+        hints.push('Set the missing values with `pikku fabric secrets set <name>` or `pikku fabric variables set <name> <value>`.');
+    }
+    return hints;
+}
 export async function readDeploymentStatus(rpc, deploymentId) {
     const s = await rpc.invoke('getDeploymentStatus', { deploymentId });
     return {

package/dist/src/functions/commands/scenario-formatter.js

@@ -38,15 +38,18 @@ export const formatScenarioReport = (report, options = {}) => {
     return lines;
 };
 export const buildStepLadder = (steps) => {
-    const width = Math.max(0, ...steps.map(({ sentence }) => sentence.length));
-    return steps.map((step) => {
+    const sentences = steps.map(ladderSentence);
+    const width = Math.max(0, ...sentences.map((sentence) => sentence.length));
+    return steps.map((step, index) => {
         const glyph = step.status === 'succeeded' ? '✓' : '✗';
         const detail = step.status === 'succeeded' || !step.error
             ? formatDuration(step.durationMs)
             : firstLine(step.error);
-        return `  ${step.sentence.padEnd(width)}  ${glyph}  ${detail}`;
+        return `  ${sentences[index].padEnd(width)}  ${glyph}  ${detail}`;
     });
 };
+/** The ladder introduces an actor where the row offers an introduction. */
+const ladderSentence = (step) => step.sentenceWithRole ?? step.sentence;
 /**
  * The one line a summary gets. A browser timeout's message carries its whole
  * call log; the failure block below prints all of it, so the row above only

package/dist/src/functions/commands/scenario-ladder.d.ts

@@ -1,6 +1,7 @@
 import type { ScenarioSurface, ScenarioStepPhase } from '@pikku/core/scenario';
 import type { WorkflowStepMeta } from '@pikku/core/workflow';
 import type { FunctionsMeta } from '@pikku/core/services';
+import type { PersonaDefinitions } from '@pikku/core/persona';
 import type { ScenarioFailureDetail, ScenarioStepRow } from '@pikku/core/scenario';
 export interface ScenarioStepProse {
     phase: ScenarioStepPhase;
@@ -41,6 +42,12 @@ export interface ScenarioProse {
      * which is what it did before this index existed.
      */
     byStepFunc: Map<string, ScenarioStepProse>;
+    /**
+     * What each actor is, keyed by the persona key a step records. A persona's
+     * job title is what a reader wants — "the founder" — and its first role is
+     * the fallback for a persona that declares no title.
+     */
+    roleByActor: Map<string, string>;
 }
 /**
  * Build `durable step name → prose parts` for one scenario.
@@ -52,7 +59,7 @@ export interface ScenarioProse {
  */
 export declare const collectScenarioStepProse: (workflowMeta: {
     steps?: WorkflowStepMeta[];
-} | undefined, functionsMeta: FunctionsMeta) => ScenarioProse;
+} | undefined, functionsMeta: FunctionsMeta, personas?: PersonaDefinitions) => ScenarioProse;
 /** The step functions in this scenario that declare a `browser` binding. */
 export declare const scenarioBrowserSteps: (workflowMeta: {
     steps?: WorkflowStepMeta[];

package/dist/src/functions/commands/scenario-ladder.js

@@ -42,7 +42,7 @@ function* walkScenarioSteps(steps) {
  * name. A step's `template` is carried alongside and, when it exists, is what
  * actually gets rendered — filled from the input recorded on the run.
  */
-export const collectScenarioStepProse = (workflowMeta, functionsMeta) => {
+export const collectScenarioStepProse = (workflowMeta, functionsMeta, personas = []) => {
     const byStepName = new Map();
     const byStepFunc = new Map();
     const ambiguous = new Set();
@@ -70,7 +70,21 @@ export const collectScenarioStepProse = (workflowMeta, functionsMeta) => {
     for (const stepFunc of ambiguous) {
         byStepFunc.delete(stepFunc);
     }
-    return { byStepName, byStepFunc };
+    return { byStepName, byStepFunc, roleByActor: rolesByActor(personas) };
+};
+/**
+ * Only a job title introduces an actor. `roles` is authorisation — "reviewer"
+ * is a grant, not a description of who someone is — so a persona that declares
+ * no title gets no introduction rather than one assembled out of its grants.
+ */
+const rolesByActor = (personas) => {
+    const roles = new Map();
+    for (const persona of personas) {
+        if (persona.jobTitle) {
+            roles.set(persona.id, persona.jobTitle);
+        }
+    }
+    return roles;
 };
 const sameProse = (a, b) => a.phase === b.phase &&
     a.description === b.description &&
@@ -143,25 +157,55 @@ export const scenarioSurfaceCoverage = (workflowMeta, functionsMeta, runSurface)
  * recorded under the name it was declared with is never re-resolved by a
  * function shared with another call site.
  */
-const stepSentence = (step, prose) => {
-    const parts = prose.byStepName.get(step.stepName) ??
-        prose.byStepName.get(baseName(step.stepName)) ??
-        (step.stepFunc ? prose.byStepFunc.get(step.stepFunc) : undefined);
+const stepProse = (step, prose) => prose.byStepName.get(step.stepName) ??
+    prose.byStepName.get(baseName(step.stepName)) ??
+    (step.stepFunc ? prose.byStepFunc.get(step.stepFunc) : undefined);
+const stepSentence = (step, prose, continuation = {}) => {
+    const parts = stepProse(step, prose);
     return parts
         ? composeStepProse({
             ...parts,
+            ...continuation,
             input: step.input,
             keywordWidth: KEYWORD_WIDTH,
         })
         : `${''.padEnd(KEYWORD_WIDTH)} ${step.stepName}`;
 };
 /** The run's steps as renderable rows, in the order they were recorded. */
-export const scenarioStepRows = (steps, prose) => steps.map((step) => ({
-    sentence: stepSentence(step, prose),
-    status: step.status,
-    durationMs: step.durationMs,
-    error: step.error,
-}));
+export const scenarioStepRows = (steps, prose) => {
+    const introduced = new Set();
+    let previous;
+    return steps.map((step) => {
+        const parts = stepProse(step, prose);
+        const actor = parts?.actor;
+        const role = actor ? prose.roleByActor.get(actor) : undefined;
+        // Only the step that first names an actor carries their role, so a run
+        // that is one person doing eight things says who they are once.
+        const firstMention = actor !== undefined && role !== undefined && !introduced.has(actor);
+        const continuation = {
+            continuesPhase: previous !== undefined && previous.phase === parts?.phase,
+            continuesActor: previous !== undefined && previous.actor === actor,
+        };
+        if (actor) {
+            introduced.add(actor);
+        }
+        previous = parts;
+        return {
+            sentence: stepSentence(step, prose, continuation),
+            ...(firstMention
+                ? {
+                    sentenceWithRole: stepSentence(step, prose, {
+                        ...continuation,
+                        actorRole: role,
+                    }),
+                }
+                : {}),
+            status: step.status,
+            durationMs: step.durationMs,
+            error: step.error,
+        };
+    });
+};
 const baseName = (stepName) => stepName.replace(/#\d+$/, '');
 /**
  * Find the step a run died on and join it back to its declared prose, so a

package/dist/src/functions/commands/scenario.js

@@ -331,7 +331,7 @@ export const scenarioRun = pikkuSessionlessFunc({
          * is the formatter's job.
          */
         const readRunSteps = async (service, runId, flowName) => {
-            const prose = collectScenarioStepProse(state.workflows?.meta?.[flowName], functionsMeta);
+            const prose = collectScenarioStepProse(state.workflows?.meta?.[flowName], functionsMeta, state.personas?.definitions ?? []);
             const steps = (await service.getRunSteps(runId)).map((step) => ({
                 stepName: step.stepName,
                 status: step.status,

package/dist/src/functions/validate/shared-checks.d.ts

@@ -55,6 +55,31 @@ export declare function readTextSafe(path: string): Promise<string | null>;
  * optional schema qualifier, since `main.audit` is the same table.
  */
 export declare function migrationCreatesTable(sql: string, tableName: string): boolean;
+/**
+ * Every table name one better-auth model can be sitting under.
+ *
+ * `modelName` renames a model's table — `user: { modelName: 'authUser' }` is
+ * how an app keeps better-auth's rows out of a `user` table it already owns —
+ * and the adapter's CamelCasePlugin then writes that as `auth_user`. An app
+ * that renames all four models has none of the default names in its
+ * migrations, so a default-names-only check reported it as having no auth
+ * schema at all. Accept the default, the override, and the override's
+ * snake_case form.
+ */
+export declare const betterAuthTableAliases: (model: string, configText: string) => string[];
+/**
+ * Static value imports of a package the deploy bundler stubs.
+ *
+ * A unit that does not require the service gets the package rewritten to
+ * `export {}`, so a static named import fails to bundle — once per unit, with
+ * an esbuild message that names the stub rather than the mistake. Type-only
+ * imports are erased before bundling and a side-effect import binds nothing,
+ * so neither is reported.
+ */
+export declare const staticStubbedImports: (code: string) => Array<{
+    module: string;
+    service: string;
+}>;
 /**
  * Every check that is true of any pikku project, regardless of where it deploys.
  *