@pikku/cli 0.12.151 → 0.12.153

package/dist/.pikku/scenarios/pikku-scenario-types.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.151
+ * This file was generated by @pikku/cli@0.12.153
  */
 import type { PikkuScenarioWire, ScenarioStepOptions } from '@pikku/core/scenario';
 import type { PikkuWorkflowWire } from '@pikku/core/workflow';

package/dist/.pikku/scenarios/pikku-scenario-wirings-meta.gen.js

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

package/dist/.pikku/scenarios/pikku-scenario-wirings.gen.d.ts

@@ -1,4 +1,4 @@
 /**
- * This file was generated by @pikku/cli@0.12.151
+ * This file was generated by @pikku/cli@0.12.153
  */
 export {};

package/dist/.pikku/scenarios/schemas/register.gen.d.ts

@@ -1,4 +1,4 @@
 /**
- * This file was generated by @pikku/cli@0.12.151
+ * This file was generated by @pikku/cli@0.12.153
  */
 export declare const empty: null;

package/dist/.pikku/scenarios/schemas/register.gen.js

@@ -1,4 +1,4 @@
 /**
- * This file was generated by @pikku/cli@0.12.151
+ * This file was generated by @pikku/cli@0.12.153
  */
 export const empty = null;

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.151
+ * This file was generated by @pikku/cli@0.12.153
  */
 /**
  * Subpath entry — `#pikku/scheduler` resolves here.

package/dist/.pikku/scheduler/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.151
+ * This file was generated by @pikku/cli@0.12.153
  */
 /**
  * Subpath entry — `#pikku/scheduler` resolves here.

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.151
+ * This file was generated by @pikku/cli@0.12.153
  */
 /**
  * Scheduler-specific type definitions for tree-shaking optimization

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.151
+ * This file was generated by @pikku/cli@0.12.153
  */
 /**
  * Scheduler-specific type definitions for tree-shaking optimization

package/dist/.pikku/schemas/register.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.151
+ * This file was generated by @pikku/cli@0.12.153
  */
 import { addSchema } from '@pikku/core/schema';
 import * as BinaryInput from './schemas/BinaryInput.schema.json' with { type: 'json' };
@@ -30,6 +30,18 @@ import * as DocInput from './schemas/DocInput.schema.json' with { type: 'json' }
 addSchema('DocInput', DocInput);
 import * as DocOutput from './schemas/DocOutput.schema.json' with { type: 'json' };
 addSchema('DocOutput', DocOutput);
+import * as ExamplesAddInput from './schemas/ExamplesAddInput.schema.json' with { type: 'json' };
+addSchema('ExamplesAddInput', ExamplesAddInput);
+import * as ExamplesAddOutput from './schemas/ExamplesAddOutput.schema.json' with { type: 'json' };
+addSchema('ExamplesAddOutput', ExamplesAddOutput);
+import * as ExamplesListInput from './schemas/ExamplesListInput.schema.json' with { type: 'json' };
+addSchema('ExamplesListInput', ExamplesListInput);
+import * as ExamplesListOutput from './schemas/ExamplesListOutput.schema.json' with { type: 'json' };
+addSchema('ExamplesListOutput', ExamplesListOutput);
+import * as ExamplesShowInput from './schemas/ExamplesShowInput.schema.json' with { type: 'json' };
+addSchema('ExamplesShowInput', ExamplesShowInput);
+import * as ExamplesShowOutput from './schemas/ExamplesShowOutput.schema.json' with { type: 'json' };
+addSchema('ExamplesShowOutput', ExamplesShowOutput);
 import * as FabricAddInput from './schemas/FabricAddInput.schema.json' with { type: 'json' };
 addSchema('FabricAddInput', FabricAddInput);
 import * as FabricAddOutput from './schemas/FabricAddOutput.schema.json' with { type: 'json' };
@@ -50,6 +62,10 @@ import * as FabricChangesDoneInput from './schemas/FabricChangesDoneInput.schema
 addSchema('FabricChangesDoneInput', FabricChangesDoneInput);
 import * as FabricChangesDoneOutput from './schemas/FabricChangesDoneOutput.schema.json' with { type: 'json' };
 addSchema('FabricChangesDoneOutput', FabricChangesDoneOutput);
+import * as FabricChangesFileInput from './schemas/FabricChangesFileInput.schema.json' with { type: 'json' };
+addSchema('FabricChangesFileInput', FabricChangesFileInput);
+import * as FabricChangesFileOutput from './schemas/FabricChangesFileOutput.schema.json' with { type: 'json' };
+addSchema('FabricChangesFileOutput', FabricChangesFileOutput);
 import * as FabricChangesListInput from './schemas/FabricChangesListInput.schema.json' with { type: 'json' };
 addSchema('FabricChangesListInput', FabricChangesListInput);
 import * as FabricChangesListOutput from './schemas/FabricChangesListOutput.schema.json' with { type: 'json' };

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

@@ -0,0 +1 @@
+{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "name": { "type": "string" }, "entity": { "description": "The domain symbol to rename the example's own onto", "type": "string" }, "app": { "description": "Which frontend a screen belongs to, for a project with more than one", "type": "string" } }, "required": ["name"], "additionalProperties": false }

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

@@ -0,0 +1 @@
+{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ok": { "type": "boolean" }, "name": { "type": "string" }, "entity": { "type": "string" }, "refusal": { "type": "string" }, "written": { "type": "array", "items": { "type": "string" } }, "kept": { "type": "array", "items": { "type": "string" } }, "failed": { "type": "array", "items": { "type": "string" } }, "deferred": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "tables": { "type": "array", "items": { "type": "string" } } }, "required": ["path", "tables"], "additionalProperties": false } }, "manual": { "type": "array", "items": { "type": "string" } }, "api": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "exports": { "type": "array", "items": { "type": "string" } }, "declarations": { "type": "array", "items": { "type": "string" } } }, "required": ["path", "exports", "declarations"], "additionalProperties": false } }, "when": { "type": "string" }, "steps": { "type": "string" }, "notes": { "type": "array", "items": { "type": "object", "properties": { "anchor": { "type": ["string", "null"] }, "lines": { "type": "array", "items": { "type": "string" } } }, "required": ["anchor", "lines"], "additionalProperties": false } } }, "required": ["ok", "name", "entity", "refusal", "written", "kept", "failed", "deferred", "manual", "api", "when", "steps", "notes"], "additionalProperties": false }

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

@@ -0,0 +1 @@
+{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "group": { "description": "Only the examples whose name starts with this, e.g. `scenario`", "type": "string" } }, "additionalProperties": false }

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

@@ -0,0 +1 @@
+{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "examples": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "title": { "type": "string" }, "when": { "type": "string" }, "lang": { "type": "string" }, "entity": { "type": "string" }, "deferUntil": { "type": "string" } }, "required": ["name", "title", "when", "lang", "entity", "deferUntil"], "additionalProperties": false } } }, "required": ["examples"], "additionalProperties": false }

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

@@ -0,0 +1 @@
+{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "name": { "type": "string" }, "entity": { "description": "Rewrite the example's domain symbol into this one before printing", "type": "string" } }, "required": ["name"], "additionalProperties": false }

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

@@ -0,0 +1 @@
+{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "found": { "type": "boolean" }, "name": { "type": "string" }, "title": { "type": "string" }, "when": { "type": "string" }, "source": { "type": "string" }, "steps": { "type": "string" }, "code": { "type": "string" }, "notes": { "type": "array", "items": { "type": "object", "properties": { "anchor": { "type": ["string", "null"] }, "lines": { "type": "array", "items": { "type": "string" } } }, "required": ["anchor", "lines"], "additionalProperties": false } }, "available": { "type": "array", "items": { "type": "string" } } }, "required": ["found", "name", "title", "when", "source", "steps", "code", "notes", "available"], "additionalProperties": false }

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

@@ -0,0 +1 @@
+{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "apiUrl": { "type": "string" }, "projectId": { "type": "string" }, "stageId": { "type": "string" }, "branch": { "type": "string" }, "title": { "type": "string", "minLength": 1 }, "body": { "type": "string" }, "bodyFile": { "type": "string" }, "route": { "type": "string" }, "locale": { "type": "string" } }, "required": ["title"], "additionalProperties": false }

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

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

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.151
+ * This file was generated by @pikku/cli@0.12.153
  */
 /**
  * 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.151
+ * This file was generated by @pikku/cli@0.12.153
  */
 /**
  * Subpath entry — `#pikku/scopes` resolves here.

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

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

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

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

package/dist/src/cli.wiring.js

@@ -33,6 +33,7 @@ import { pikkuAudit } from './functions/commands/audit.js';
 import { pikkuSemver } from './functions/commands/semver.js';
 import { renderSemver } from './functions/commands/semver-render.js';
 import { validate, renderValidate } from './functions/commands/validate.js';
+import { examplesAdd, examplesList, examplesShow, renderExamplesAdd, renderExamplesList, renderExamplesShow, } from './functions/commands/examples.js';
 import { knowledgeValidate, renderKnowledgeValidate, } from './functions/commands/knowledge-validate.js';
 import { knowledgeIndex, renderKnowledgeIndex, } from './functions/commands/knowledge-index.js';
 import { knowledgeReconcile, renderKnowledgeReconcile, } from './functions/commands/knowledge-reconcile.js';
@@ -507,6 +508,56 @@ wireCLI({
                 }),
             },
         },
+        examples: {
+            description: 'Worked examples of the things that are easy to get wrong and hard to discover — read one, or write it into this project already named for your own entity',
+            subcommands: {
+                list: pikkuCLICommand({
+                    func: examplesList,
+                    render: renderExamplesList,
+                    description: 'List every example, with what each one is for',
+                    options: {
+                        group: {
+                            description: 'Only the examples whose name starts with this, e.g. `scenario`',
+                            short: 'g',
+                        },
+                    },
+                }),
+                show: pikkuCLICommand({
+                    func: examplesShow,
+                    render: renderExamplesShow,
+                    description: 'Print one example, renamed onto your own entity, with everything the recipe says about itself',
+                    options: {
+                        name: {
+                            description: 'Which example',
+                            short: 'n',
+                        },
+                        entity: {
+                            description: "The domain symbol to rewrite the example's own onto",
+                            short: 'e',
+                        },
+                    },
+                }),
+                add: pikkuCLICommand({
+                    func: examplesAdd,
+                    render: renderExamplesAdd,
+                    description: 'Write one example into this project, or say what is in the way and write nothing',
+                    options: {
+                        name: {
+                            description: 'Which example',
+                            short: 'n',
+                        },
+                        entity: {
+                            description: "The domain symbol to rename the example's own onto",
+                            short: 'e',
+                        },
+                        app: {
+                            description: 'Which frontend a screen belongs to, for a project with more than one',
+                            short: 'a',
+                        },
+                    },
+                }),
+            },
+        },
         knowledge: {
             description: 'Inspect and maintain the knowledge base — what this app is, in the language its users use',
             subcommands: {

package/dist/src/examples.gen.d.ts

@@ -0,0 +1,17 @@
+export interface PikkuExample {
+    name: string;
+    title: string;
+    when: string;
+    lang: string;
+    /** The example domain symbol this recipe spells, which `--entity` renames. */
+    entity: string;
+    /** A precondition the recipe declares, refusing `add` until it holds. */
+    deferUntil: string;
+    requires: string[];
+    /** The follow-up the recipe cannot perform itself, carried to the caller verbatim. */
+    steps: string;
+    /** Where the recipe lives, repo-relative. */
+    source: string;
+    content: string;
+}
+export declare const EXAMPLES: PikkuExample[];