@pikku/cli 0.12.156 → 0.12.160

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

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

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 import type { PikkuScenarioWire, ScenarioStepOptions } from '@pikku/core/scenario';
 import type { PikkuWorkflowWire } from '@pikku/core/workflow';
@@ -130,6 +130,12 @@ type PikkuFeatureConfig<Scenarios extends readonly unknown[]> = {
     name: string;
     description?: string;
     tags?: string[];
+    /**
+     * Whether this feature is guide material, defaulting to true. `pikku scenario
+     * guide` requires every documented feature to be cited by a page; a feature
+     * that is pure plumbing sets this false rather than being written about.
+     */
+    document?: boolean;
     scenarios: {
         [K in keyof Scenarios]: PikkuFeatureEntry<Scenarios[K]>;
     };

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 export {};

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

@@ -1,4 +1,4 @@
 /**
- * This file was generated by @pikku/cli@0.12.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 export const empty = null;

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 /**
  * 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 /**
  * 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 /**
  * 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 /**
  * 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 import { addSchema } from '@pikku/core/schema';
 import * as BinaryInput from './schemas/BinaryInput.schema.json' with { type: 'json' };
@@ -388,6 +388,8 @@ import * as RolesAuditInput from './schemas/RolesAuditInput.schema.json' with {
 addSchema('RolesAuditInput', RolesAuditInput);
 import * as RolesPruneInput from './schemas/RolesPruneInput.schema.json' with { type: 'json' };
 addSchema('RolesPruneInput', RolesPruneInput);
+import * as ScenarioGuideInput from './schemas/ScenarioGuideInput.schema.json' with { type: 'json' };
+addSchema('ScenarioGuideInput', ScenarioGuideInput);
 import * as ScenarioListInput from './schemas/ScenarioListInput.schema.json' with { type: 'json' };
 addSchema('ScenarioListInput', ScenarioListInput);
 import * as ScopesAuditInput from './schemas/ScopesAuditInput.schema.json' with { type: 'json' };

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

@@ -1 +1 @@
-{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "apiUrl": { "type": "string" }, "changeId": { "type": "string" }, "question": { "type": "string", "minLength": 1 }, "authorName": { "type": "string" } }, "required": ["changeId", "question"], "additionalProperties": false }
+{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "apiUrl": { "type": "string" }, "changeId": { "type": "string" }, "question": { "type": "string", "minLength": 1 }, "option": { "maxItems": 6, "type": "array", "items": { "type": "string", "minLength": 1 } }, "authorName": { "type": "string" } }, "required": ["changeId", "question"], "additionalProperties": false }

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

@@ -1 +1 @@
-{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "repo": { "type": "string" }, "name": { "type": "string" }, "branch": { "type": "string" }, "force": { "type": "boolean" }, "apiUrl": { "type": "string" } }, "required": ["repo"], "additionalProperties": false }
+{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "repo": { "type": "string" }, "name": { "type": "string" }, "branch": { "type": "string" }, "force": { "type": "boolean" }, "apiUrl": { "type": "string" }, "organization": { "type": "string" } }, "required": ["repo"], "additionalProperties": false }

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

@@ -1 +1 @@
-{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "apiUrl": { "type": "string" }, "github": { "type": "boolean" }, "gitea": { "type": "boolean" }, "repoName": { "type": "string" } }, "additionalProperties": false }
+{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "apiUrl": { "type": "string" }, "github": { "type": "boolean" }, "gitea": { "type": "boolean" }, "repoName": { "type": "string" }, "organization": { "type": "string" } }, "additionalProperties": false }

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

@@ -1 +1 @@
-{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false }
+{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "require": { "type": "string" } }, "additionalProperties": false }

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

@@ -1 +1 @@
-{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "kind": { "type": "string", "enum": ["idle", "repair-note", "write-plan", "ask-user", "dispatch", "hold"] }, "reason": { "type": "string" }, "note": { "type": "string" }, "hold": { "type": "string" }, "notes": { "type": "array", "items": { "type": "string" } }, "question": { "type": "object", "properties": { "header": { "type": "string" }, "question": { "type": "string" }, "options": { "default": [], "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string" }, "description": { "type": "string" } }, "required": ["label"], "additionalProperties": false } } }, "required": ["header", "question", "options"], "additionalProperties": false } }, "required": ["kind", "reason"], "additionalProperties": false }
+{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "kind": { "type": "string", "enum": ["idle", "repair-note", "write-plan", "ask-user", "dispatch", "hold"] }, "reason": { "type": "string" }, "note": { "type": "string" }, "hold": { "type": "string" }, "notes": { "type": "array", "items": { "type": "string" } }, "question": { "type": "object", "properties": { "header": { "type": "string" }, "question": { "type": "string" }, "options": { "default": [], "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string" }, "description": { "type": "string" } }, "required": ["label"], "additionalProperties": false } } }, "required": ["header", "question", "options"], "additionalProperties": false }, "satisfied": { "type": "boolean" }, "required": { "type": "array", "items": { "type": "string" } } }, "required": ["kind", "reason"], "additionalProperties": false }

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

@@ -1 +1 @@
-{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "agent": { "type": "string" }, "only": { "type": "string" }, "core": { "type": "boolean" }, "fabric": { "type": "boolean" }, "client": { "type": "boolean" }, "update": { "type": "boolean" } }, "additionalProperties": false, "definitions": {} }
+{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "agent": { "type": "string" }, "only": { "type": "string" }, "core": { "type": "boolean" }, "fabric": { "type": "boolean" }, "client": { "type": "boolean" }, "update": { "type": "boolean" }, "agentExtensions": { "type": "string" }, "agentDir": { "type": "string" }, "agentSkillDir": { "type": "string" } }, "additionalProperties": false, "definitions": {} }

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

@@ -0,0 +1 @@
+{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "docs": { "type": "string" }, "output": { "type": "string" }, "runId": { "type": "string" }, "allowUndocumented": { "type": "boolean" }, "artifactBase": { "type": "string" } }, "additionalProperties": false, "definitions": {} }

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 /**
  * 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 /**
  * 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 /**
  * 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 /**
  * 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 /**
  * 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 /**
  * 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 /**
  * 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 /**
  * 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 /**
  * 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 /**
  * 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 /**
  * 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 /**
  * 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 /**
  * 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 /**
  * 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 /**
  * 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 /**
  * 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 /**
  * 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 /**
  * 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 /**
  * 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 /**
  * 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 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.156
+ * This file was generated by @pikku/cli@0.12.160
  */
 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.156') {
-      process.stderr.write(`\n  Update available  0.12.156 → ${latest}\n  brew upgrade pikku  or  npm install -g @pikku/cli\n\n`)
+    if (latest !== '0.12.160') {
+      process.stderr.write(`\n  Update available  0.12.160 → ${latest}\n  brew upgrade pikku  or  npm install -g @pikku/cli\n\n`)
     }
   } catch {}
 }
@@ -20,4 +20,4 @@ import { PikkuCLI } from '../.pikku/cli/pikku-cli.gen.js'
 const updateCheck = checkForUpdate()
 await PikkuCLI(process.argv.slice(2))
 await updateCheck
-process.exit(0)
+process.exit(process.exitCode ?? 0)

package/dist/src/cli.wiring.js

@@ -38,7 +38,7 @@ import { knowledgeValidate, renderKnowledgeValidate, } from './functions/command
 import { knowledgeIndex, renderKnowledgeIndex, } from './functions/commands/knowledge-index.js';
 import { knowledgeReconcile, renderKnowledgeReconcile, } from './functions/commands/knowledge-reconcile.js';
 import { knowledgePlanDefer, knowledgePlanProgress, knowledgePlanSchema, knowledgePlanSet, knowledgePlanShow, renderKnowledgePlanDefer, renderKnowledgePlanProgress, renderKnowledgePlanSchema, renderKnowledgePlanSet, renderKnowledgePlanShow, } from './functions/commands/knowledge-plan.js';
-import { scenarioRun, scenarioList } from './functions/commands/scenario.js';
+import { scenarioRun, scenarioList, scenarioGuide, } from './functions/commands/scenario.js';
 import { personaList, personaRun, personaSecret, } from './functions/commands/persona.js';
 import { personaSync } from './functions/commands/persona-sync.js';
 import { pikkuVersionsInit } from './functions/commands/versions-init.js';
@@ -581,6 +581,12 @@ wireCLI({
                     func: knowledgeReconcile,
                     render: renderKnowledgeReconcile,
                     description: 'Say the one thing to do next — repair a note, write a plan, ask the user, build, or nothing',
+                    options: {
+                        require: {
+                            description: 'Exit non-zero unless the next action is one of these (comma-separated: idle, repair-note, write-plan, ask-user, dispatch, hold) — what turns this command into a gate a stage can be held to',
+                            type: 'string',
+                        },
+                    },
                 }),
                 plan: {
                     description: "Read and write a milestone's technical plan — the shape of the work, checked before it is built rather than after",
@@ -666,7 +672,7 @@ wireCLI({
                             default: 'default',
                         },
                         strict: {
-                            description: 'Fail rather than pass a `then` that has no witness for --run, i.e. an assertion nobody checked on the surface its prose claims',
+                            description: 'Every step must run on --run: an action may not fall back to its default binding, and a `then` may not be witnessed anywhere else. No effect on --run default',
                             default: false,
                         },
                         spawn: {
@@ -702,6 +708,30 @@ wireCLI({
                     func: scenarioList,
                     description: 'List scenarios with names and descriptions',
                 }),
+                guide: pikkuCLICommand({
+                    func: scenarioGuide,
+                    description: "Write the user guide the suite already contains: each page's editorial prose merged with the steps and screenshots the latest run recorded. Markdown only — no HTML, no asset URLs, no model.",
+                    options: {
+                        docs: {
+                            description: 'Where the editorial sources live, relative to the project. A `<!-- pikku:guide feature=<id> -->` marker pair in a `<section>/<slug>.md` is both the citation and the place the block is written',
+                            default: 'docs',
+                        },
+                        output: {
+                            description: 'Where the merged markdown is written (default: <outDir>/guide)',
+                            short: 'o',
+                        },
+                        runId: {
+                            description: 'Build from this run rather than the most recent one',
+                        },
+                        allowUndocumented: {
+                            description: 'Report features no page documents instead of failing on them',
+                            default: false,
+                        },
+                        artifactBase: {
+                            description: "Prefix every figure with this instead of the path from the page to the run's artifacts — for a host that serves them at a fixed address. Route-relative (`/docs/_media/`) keeps the output portable; an origin pins it to one host",
+                        },
+                    },
+                }),
             },
         },
         persona: {
@@ -1100,6 +1130,18 @@ wireCLI({
                             description: 'Overwrite existing skills if already installed',
                             default: false,
                         },
+                        agentExtensions: {
+                            description: 'Comma-separated extension paths every projected agent loads — how a host that fences its writers or routes their model adds that to the agents it installs',
+                            type: 'string',
+                        },
+                        agentDir: {
+                            description: 'Where to write the projected agents, overriding the harness default — an absolute path for a host whose agents live outside the project',
+                            type: 'string',
+                        },
+                        agentSkillDir: {
+                            description: 'The skill directory a projected agent points at, for a host that relocates the installed skills afterwards',
+                            type: 'string',
+                        },
                     },
                 }),
             },