@pikku/cli 0.12.152 → 0.12.153

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.152
+ * 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.152
+ * 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.152
+ * 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.152
+ * 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.152
+ * 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.152
+ * 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.152
+ * 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.152
+ * 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.152
+ * 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.152
+ * 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.152
+ * 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.152
+ * 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.152
+ * 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.152
+ * 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.152
+ * 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.152
+ * 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.152
+ * 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.152
+ * 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.152
+ * 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.152
+ * 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.152
+ * 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.152
+ * 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.152
+ * 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.152
+ * 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.152
+ * 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.152
+ * 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.152
+ * 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.152
+ * 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.152
+ * 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.152
+ * 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.152
+ * 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.152
+ * 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.152
+ * 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.152') {
-      process.stderr.write(`\n  Update available  0.12.152 → ${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[];