@pikku/cli 0.12.128 → 0.12.134

package/dist/.pikku/scenarios/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.128
+ * This file was generated by @pikku/cli@0.12.134
  */
 /**
  * Subpath entry — `#pikku/scenarios` resolves here.

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.128
+ * This file was generated by @pikku/cli@0.12.134
  */
 /** Personas declared with definePersonas() */
 import { createHttpPersonas } from '@pikku/core/persona';

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.128
+ * This file was generated by @pikku/cli@0.12.134
  */
 import { pikkuState } from '@pikku/core/state';
 import '../function/pikku-functions-meta.gen.js';

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

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

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

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

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

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

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.128
+ * This file was generated by @pikku/cli@0.12.134
  */
 /**
  * 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.128
+ * This file was generated by @pikku/cli@0.12.134
  */
 /**
  * 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.128
+ * This file was generated by @pikku/cli@0.12.134
  */
 /**
  * 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.128
+ * This file was generated by @pikku/cli@0.12.134
  */
 /**
  * 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.128
+ * This file was generated by @pikku/cli@0.12.134
  */
 import { addSchema } from '@pikku/core/schema';
 import * as BinaryInput from './schemas/BinaryInput.schema.json' with { type: 'json' };
@@ -166,6 +166,26 @@ import * as KnowledgeIndexInput from './schemas/KnowledgeIndexInput.schema.json'
 addSchema('KnowledgeIndexInput', KnowledgeIndexInput);
 import * as KnowledgeIndexOutput from './schemas/KnowledgeIndexOutput.schema.json' with { type: 'json' };
 addSchema('KnowledgeIndexOutput', KnowledgeIndexOutput);
+import * as KnowledgePlanDeferInput from './schemas/KnowledgePlanDeferInput.schema.json' with { type: 'json' };
+addSchema('KnowledgePlanDeferInput', KnowledgePlanDeferInput);
+import * as KnowledgePlanDeferOutput from './schemas/KnowledgePlanDeferOutput.schema.json' with { type: 'json' };
+addSchema('KnowledgePlanDeferOutput', KnowledgePlanDeferOutput);
+import * as KnowledgePlanProgressInput from './schemas/KnowledgePlanProgressInput.schema.json' with { type: 'json' };
+addSchema('KnowledgePlanProgressInput', KnowledgePlanProgressInput);
+import * as KnowledgePlanProgressOutput from './schemas/KnowledgePlanProgressOutput.schema.json' with { type: 'json' };
+addSchema('KnowledgePlanProgressOutput', KnowledgePlanProgressOutput);
+import * as KnowledgePlanSchemaInput from './schemas/KnowledgePlanSchemaInput.schema.json' with { type: 'json' };
+addSchema('KnowledgePlanSchemaInput', KnowledgePlanSchemaInput);
+import * as KnowledgePlanSchemaOutput from './schemas/KnowledgePlanSchemaOutput.schema.json' with { type: 'json' };
+addSchema('KnowledgePlanSchemaOutput', KnowledgePlanSchemaOutput);
+import * as KnowledgePlanSetInput from './schemas/KnowledgePlanSetInput.schema.json' with { type: 'json' };
+addSchema('KnowledgePlanSetInput', KnowledgePlanSetInput);
+import * as KnowledgePlanSetOutput from './schemas/KnowledgePlanSetOutput.schema.json' with { type: 'json' };
+addSchema('KnowledgePlanSetOutput', KnowledgePlanSetOutput);
+import * as KnowledgePlanShowInput from './schemas/KnowledgePlanShowInput.schema.json' with { type: 'json' };
+addSchema('KnowledgePlanShowInput', KnowledgePlanShowInput);
+import * as KnowledgePlanShowOutput from './schemas/KnowledgePlanShowOutput.schema.json' with { type: 'json' };
+addSchema('KnowledgePlanShowOutput', KnowledgePlanShowOutput);
 import * as KnowledgeValidateInput from './schemas/KnowledgeValidateInput.schema.json' with { type: 'json' };
 addSchema('KnowledgeValidateInput', KnowledgeValidateInput);
 import * as KnowledgeValidateOutput from './schemas/KnowledgeValidateOutput.schema.json' with { type: 'json' };

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

@@ -1 +1 @@
-{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "branch": { "type": "string" }, "production": { "type": "boolean" }, "ref": { "type": "string" }, "deploymentId": { "type": "string" }, "sync": { "type": "boolean" }, "autoApprove": { "type": "boolean" }, "allowDestructive": { "type": "boolean" }, "timeout": { "type": "number" }, "json": { "type": "boolean" } }, "additionalProperties": false }
+{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "branch": { "type": "string" }, "production": { "type": "boolean" }, "ref": { "type": "string" }, "deploymentId": { "type": "string" }, "detach": { "type": "boolean" }, "autoApprove": { "type": "boolean" }, "allowDestructive": { "type": "boolean" }, "timeout": { "type": "number" }, "json": { "type": "boolean" } }, "additionalProperties": false }

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

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

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

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

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

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

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

@@ -0,0 +1 @@
+{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ok": { "type": "boolean" }, "path": { "type": "string" }, "message": { "type": "string" }, "done": { "type": "array", "items": { "type": "string" } }, "missing": { "type": "array", "items": { "type": "string" } }, "deferred": { "type": "array", "items": { "type": "string" } }, "problems": { "type": "array", "items": { "type": "string" } } }, "required": ["ok", "path", "message", "done", "missing", "deferred", "problems"], "additionalProperties": false }

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

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

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

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

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

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

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

@@ -0,0 +1 @@
+{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "ok": { "type": "boolean" }, "path": { "type": "string" }, "problems": { "type": "array", "items": { "type": "string" } }, "schema": { "type": "string" } }, "required": ["ok", "path", "problems"], "additionalProperties": false }

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

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

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

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

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

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

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

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

package/dist/src/cli.wiring.js

@@ -35,6 +35,7 @@ import { renderSemver } from './functions/commands/semver-render.js';
 import { validate, renderValidate } from './functions/commands/validate.js';
 import { knowledgeValidate, renderKnowledgeValidate, } from './functions/commands/knowledge-validate.js';
 import { knowledgeIndex, renderKnowledgeIndex, } from './functions/commands/knowledge-index.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 { personaList, personaRun, personaSecret, } from './functions/commands/persona.js';
 import { personaSync } from './functions/commands/persona-sync.js';
@@ -524,6 +525,52 @@ wireCLI({
                         },
                     },
                 }),
+                plan: {
+                    description: "Read and write a milestone's technical plan — the shape of the work, checked before it is built rather than after",
+                    subcommands: {
+                        schema: pikkuCLICommand({
+                            func: knowledgePlanSchema,
+                            render: renderKnowledgePlanSchema,
+                            description: 'Print the plan schema, so a plan is written against what is enforced rather than guessed at',
+                        }),
+                        show: pikkuCLICommand({
+                            func: knowledgePlanShow,
+                            render: renderKnowledgePlanShow,
+                            description: "Print a milestone's plan",
+                            parameters: '<milestone>',
+                            options: {
+                                forBuild: {
+                                    description: 'Render it as the ordered list of work a build follows, rather than as stored',
+                                    default: false,
+                                },
+                            },
+                        }),
+                        progress: pikkuCLICommand({
+                            func: knowledgePlanProgress,
+                            render: renderKnowledgePlanProgress,
+                            description: 'Say what the milestone still owes its plan, read from the generated meta rather than from what was claimed',
+                            parameters: '<milestone>',
+                        }),
+                        set: pikkuCLICommand({
+                            func: knowledgePlanSet,
+                            render: renderKnowledgePlanSet,
+                            description: 'Validate a plan against its milestone note and write it, or write nothing and say what is wrong',
+                            parameters: '<milestone> <file>',
+                        }),
+                        defer: pikkuCLICommand({
+                            func: knowledgePlanDefer,
+                            render: renderKnowledgePlanDefer,
+                            description: 'Move one first-pass item to the next pass, with the reason on the record',
+                            parameters: '<milestone> <item>',
+                            options: {
+                                reason: {
+                                    description: 'Why this item cannot land in the first pass',
+                                    short: 'r',
+                                },
+                            },
+                        }),
+                    },
+                },
             },
         },
         validate: pikkuCLICommand({