@pikku/cli 0.12.128 → 0.12.134

package/dist/.pikku/cli/pikku-cli-wirings-meta.gen.json

@@ -456,6 +456,91 @@
                             },
                             "renderName": "renderKnowledgeIndex",
                             "description": "Refresh every index.md so each section lists the notes actually in it"
+                        },
+                        "plan": {
+                            "pikkuFuncId": "",
+                            "positionals": [],
+                            "options": {},
+                            "description": "Read and write a milestone's technical plan — the shape of the work, checked before it is built rather than after",
+                            "subcommands": {
+                                "schema": {
+                                    "pikkuFuncId": "knowledgePlanSchema",
+                                    "positionals": [],
+                                    "options": {},
+                                    "renderName": "renderKnowledgePlanSchema",
+                                    "description": "Print the plan schema, so a plan is written against what is enforced rather than guessed at"
+                                },
+                                "show": {
+                                    "pikkuFuncId": "knowledgePlanShow",
+                                    "positionals": [
+                                        {
+                                            "name": "milestone",
+                                            "required": true
+                                        }
+                                    ],
+                                    "options": {
+                                        "forBuild": {
+                                            "description": "Render it as the ordered list of work a build follows, rather than as stored",
+                                            "default": false
+                                        }
+                                    },
+                                    "renderName": "renderKnowledgePlanShow",
+                                    "description": "Print a milestone's plan",
+                                    "parameters": "<milestone>"
+                                },
+                                "progress": {
+                                    "pikkuFuncId": "knowledgePlanProgress",
+                                    "positionals": [
+                                        {
+                                            "name": "milestone",
+                                            "required": true
+                                        }
+                                    ],
+                                    "options": {},
+                                    "renderName": "renderKnowledgePlanProgress",
+                                    "description": "Say what the milestone still owes its plan, read from the generated meta rather than from what was claimed",
+                                    "parameters": "<milestone>"
+                                },
+                                "set": {
+                                    "pikkuFuncId": "knowledgePlanSet",
+                                    "positionals": [
+                                        {
+                                            "name": "milestone",
+                                            "required": true
+                                        },
+                                        {
+                                            "name": "file",
+                                            "required": true
+                                        }
+                                    ],
+                                    "options": {},
+                                    "renderName": "renderKnowledgePlanSet",
+                                    "description": "Validate a plan against its milestone note and write it, or write nothing and say what is wrong",
+                                    "parameters": "<milestone> <file>"
+                                },
+                                "defer": {
+                                    "pikkuFuncId": "knowledgePlanDefer",
+                                    "positionals": [
+                                        {
+                                            "name": "milestone",
+                                            "required": true
+                                        },
+                                        {
+                                            "name": "item",
+                                            "required": true
+                                        }
+                                    ],
+                                    "options": {
+                                        "reason": {
+                                            "description": "Why this item cannot land in the first pass",
+                                            "short": "r"
+                                        }
+                                    },
+                                    "renderName": "renderKnowledgePlanDefer",
+                                    "description": "Move one first-pass item to the next pass, with the reason on the record",
+                                    "parameters": "<milestone> <item>"
+                                }
+                            }
                         }
                     }
                 },
@@ -808,12 +893,13 @@
                             "subcommands": {
                                 "apply": {
                                     "pikkuFuncId": "FabricDeployApply",
-                                    "positionals": [],
+                                    "positionals": [
+                                        {
+                                            "name": "branch",
+                                            "required": false
+                                        }
+                                    ],
                                     "options": {
-                                        "branch": {
-                                            "description": "Target branch to deploy",
-                                            "short": "b"
-                                        },
                                         "production": {
                                             "description": "Deploy production (always main)",
                                             "default": false
@@ -822,28 +908,30 @@
                                             "description": "Deploy a specific ref instead of the branch head"
                                         },
                                         "deploymentId": {
-                                            "description": "Attach to an existing deployment instead of creating one (not with --branch/--production)"
+                                            "description": "Attach to an existing deployment instead of creating one (not with a branch/--production)"
                                         },
-                                        "sync": {
-                                            "description": "Wait for the deployment to finish and exit non-zero unless it went live",
+                                        "detach": {
+                                            "description": "Queue the deployment and exit without waiting, reporting nothing about whether it landed",
                                             "default": false
                                         },
                                         "autoApprove": {
                                             "description": "Answer the confirmation prompt and publish a plan parked at the approval gate",
+                                            "short": "y",
                                             "default": false
                                         },
                                         "allowDestructive": {
-                                            "description": "Approve a plan whose migrations drop or rewrite data (--auto-approve alone will not)",
+                                            "description": "Approve a plan whose migrations drop or rewrite data (-y alone will not)",
                                             "default": false
                                         },
                                         "timeout": {
-                                            "description": "Seconds to wait under --sync (default 900)"
+                                            "description": "Seconds to wait for the deployment (default 900)"
                                         },
                                         "json": {
                                             "description": "Machine-readable output (NDJSON)",
                                             "default": false
                                         }
                                     },
+                                    "parameters": "[branch]",
                                     "renderName": "renderDeployApply",
                                     "description": "Build + deploy a named branch or production (main), or attach to an existing deployment"
                                 },

package/dist/.pikku/cli/pikku-cli-wirings.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 '../../src/cli.wiring.js';
 import '../../src/services.js';

package/dist/.pikku/cli/pikku-cli-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
  */
 /* The files with an wireCLI function call */
 import '../../src/cli.wiring.js';

package/dist/.pikku/cli/pikku-cli.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 '../pikku-bootstrap.gen.js';
 export declare function PikkuCLI(args: string[]): Promise<void>;

package/dist/.pikku/cli/pikku-cli.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 { executeCLI, CLIError } from '@pikku/core/cli';
 import { createConfig as createConfig } from '../../src/services.js';

package/dist/.pikku/error/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/error` resolves here.

package/dist/.pikku/error/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/error` resolves here.

package/dist/.pikku/error/pikku-error-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
  */
 /**
  * Error catalogue — `#pikku/error` resolves here.

package/dist/.pikku/error/pikku-error-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
  */
 /**
  * Error catalogue — `#pikku/error` resolves here.

package/dist/.pikku/function/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/function` resolves here.

package/dist/.pikku/function/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/function` resolves here.

package/dist/.pikku/function/pikku-function-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
  */
 /**
  * Core function types for all wirings

package/dist/.pikku/function/pikku-function-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
  */
 /**
  * Core function types for all wirings

package/dist/.pikku/function/pikku-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 metaData from './pikku-functions-meta.gen.json' with { type: 'json' };

package/dist/.pikku/function/pikku-functions-meta.gen.json

@@ -108,9 +108,9 @@
         "outputs": [
             "FabricDeployApplyOutput"
         ],
-        "implementationHash": "dd32ba7cab63a70b",
-        "contractHash": "c6880cdb39fc7786",
-        "inputHash": "06fcf5de",
+        "implementationHash": "1a768c83c5b4e1e6",
+        "contractHash": "1584af3c440e22e3",
+        "inputHash": "0ffa4faa",
         "outputHash": "8133c760"
     },
     "FabricDomainsAdd": {
@@ -1147,6 +1147,101 @@
         "inputHash": "aff763d8",
         "outputHash": "274b63c7"
     },
+    "knowledgePlanSchema": {
+        "pikkuFuncId": "knowledgePlanSchema",
+        "functionType": "user",
+        "funcWrapper": "pikkuSessionlessFunc",
+        "sessionless": true,
+        "name": "knowledgePlanSchema",
+        "inputSchemaName": "KnowledgePlanSchemaInput",
+        "outputSchemaName": "KnowledgePlanSchemaOutput",
+        "inputs": [
+            "KnowledgePlanSchemaInput"
+        ],
+        "outputs": [
+            "KnowledgePlanSchemaOutput"
+        ],
+        "implementationHash": "6f79bcc8ef1dc06e",
+        "contractHash": "f7afa84b5677429b",
+        "inputHash": "fad55fca",
+        "outputHash": "ee02b808"
+    },
+    "knowledgePlanShow": {
+        "pikkuFuncId": "knowledgePlanShow",
+        "functionType": "user",
+        "funcWrapper": "pikkuSessionlessFunc",
+        "sessionless": true,
+        "name": "knowledgePlanShow",
+        "inputSchemaName": "KnowledgePlanShowInput",
+        "outputSchemaName": "KnowledgePlanShowOutput",
+        "inputs": [
+            "KnowledgePlanShowInput"
+        ],
+        "outputs": [
+            "KnowledgePlanShowOutput"
+        ],
+        "implementationHash": "16b6796c5ddd94c9",
+        "contractHash": "4e95cd137bb3b2d3",
+        "inputHash": "ed2e83c5",
+        "outputHash": "bbfb46dd"
+    },
+    "knowledgePlanProgress": {
+        "pikkuFuncId": "knowledgePlanProgress",
+        "functionType": "user",
+        "funcWrapper": "pikkuSessionlessFunc",
+        "sessionless": true,
+        "name": "knowledgePlanProgress",
+        "inputSchemaName": "KnowledgePlanProgressInput",
+        "outputSchemaName": "KnowledgePlanProgressOutput",
+        "inputs": [
+            "KnowledgePlanProgressInput"
+        ],
+        "outputs": [
+            "KnowledgePlanProgressOutput"
+        ],
+        "implementationHash": "591577ee064ced06",
+        "contractHash": "5185d936739771e7",
+        "inputHash": "bac52d07",
+        "outputHash": "15effb07"
+    },
+    "knowledgePlanSet": {
+        "pikkuFuncId": "knowledgePlanSet",
+        "functionType": "user",
+        "funcWrapper": "pikkuSessionlessFunc",
+        "sessionless": true,
+        "name": "knowledgePlanSet",
+        "inputSchemaName": "KnowledgePlanSetInput",
+        "outputSchemaName": "KnowledgePlanSetOutput",
+        "inputs": [
+            "KnowledgePlanSetInput"
+        ],
+        "outputs": [
+            "KnowledgePlanSetOutput"
+        ],
+        "implementationHash": "16e55a6481e9af35",
+        "contractHash": "c07b74d7cde75a19",
+        "inputHash": "ae426d2f",
+        "outputHash": "21af1e19"
+    },
+    "knowledgePlanDefer": {
+        "pikkuFuncId": "knowledgePlanDefer",
+        "functionType": "user",
+        "funcWrapper": "pikkuSessionlessFunc",
+        "sessionless": true,
+        "name": "knowledgePlanDefer",
+        "inputSchemaName": "KnowledgePlanDeferInput",
+        "outputSchemaName": "KnowledgePlanDeferOutput",
+        "inputs": [
+            "KnowledgePlanDeferInput"
+        ],
+        "outputs": [
+            "KnowledgePlanDeferOutput"
+        ],
+        "implementationHash": "18d626beedf713b1",
+        "contractHash": "515d3e52dd2b02b8",
+        "inputHash": "045f74ea",
+        "outputHash": "a01038f8"
+    },
     "knowledgeValidate": {
         "pikkuFuncId": "knowledgeValidate",
         "functionType": "user",

package/dist/.pikku/function/pikku-functions.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 and register functions used by RPCs */
 import { addFunction } from '@pikku/core/function';

package/dist/.pikku/gateway/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/gateway` resolves here.

package/dist/.pikku/gateway/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/gateway` resolves here.

package/dist/.pikku/gateway/pikku-gateway-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
  */
 /**
  * Gateway-specific type definitions for tree-shaking optimization

package/dist/.pikku/gateway/pikku-gateway-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
  */
 /**
  * Gateway-specific type definitions for tree-shaking optimization

package/dist/.pikku/http/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/http` resolves here.

package/dist/.pikku/http/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/http` resolves here.

package/dist/.pikku/http/pikku-http-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
  */
 /**
  * HTTP-specific type definitions for tree-shaking optimization

package/dist/.pikku/http/pikku-http-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
  */
 /**
  * HTTP-specific type definitions for tree-shaking optimization

package/dist/.pikku/mcp/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/mcp` resolves here.

package/dist/.pikku/mcp/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/mcp` resolves here.

package/dist/.pikku/mcp/pikku-mcp-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
  */
 /**
  * MCP-specific type definitions for tree-shaking optimization

package/dist/.pikku/mcp/pikku-mcp-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
  */
 /**
  * MCP-specific type definitions for tree-shaking optimization

package/dist/.pikku/middleware/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/middleware` resolves here.

package/dist/.pikku/middleware/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/middleware` resolves here.

package/dist/.pikku/middleware/pikku-middleware-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
  */
 /**
  * Middleware type definitions and registration for all wirings

package/dist/.pikku/middleware/pikku-middleware-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
  */
 /**
  * Middleware type definitions and registration for all wirings

package/dist/.pikku/pikku-bootstrap-scenarios.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 './pikku-bootstrap.gen.js';
 import './scenarios/schemas/register.gen.js';

package/dist/.pikku/pikku-bootstrap-scenarios.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 './pikku-bootstrap.gen.js';
 import './scenarios/schemas/register.gen.js';

package/dist/.pikku/pikku-bootstrap.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 './rpc/pikku-rpc-wirings-meta.internal.gen.js';
 import './function/pikku-functions-meta.gen.js';

package/dist/.pikku/pikku-bootstrap.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 './rpc/pikku-rpc-wirings-meta.internal.gen.js';
 import './function/pikku-functions-meta.gen.js';

package/dist/.pikku/pikku-services.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 { SingletonServices } from '../types/application-types.d.js';
 import type { Services } from '../types/application-types.d.js';

package/dist/.pikku/queue/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/queue` resolves here.

package/dist/.pikku/queue/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/queue` resolves here.

package/dist/.pikku/queue/pikku-queue-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
  */
 /**
  * Queue-specific type definitions for tree-shaking optimization

package/dist/.pikku/queue/pikku-queue-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
  */
 /**
  * Queue-specific type definitions for tree-shaking optimization

package/dist/.pikku/queue/pikku-queue-workers-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 metaData from './pikku-queue-workers-wirings-meta.gen.json' with { type: 'json' };

package/dist/.pikku/queue/pikku-queue-workers-wirings.gen.d.ts

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

package/dist/.pikku/queue/pikku-queue-workers-wirings.gen.js

@@ -1,5 +1,5 @@
 export {};
 /**
- * This file was generated by @pikku/cli@0.12.128
+ * This file was generated by @pikku/cli@0.12.134
  */
 /* The files with an addQueueWorkers function call */ 

package/dist/.pikku/rpc/pikku-rpc-wirings-meta.internal.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 metaData from './pikku-rpc-wirings-meta.internal.gen.json' with { type: 'json' };

package/dist/.pikku/rpc/pikku-rpc-wirings-meta.internal.gen.json

@@ -65,6 +65,11 @@
     "pikkuInfoMiddleware": "pikkuInfoMiddleware",
     "pikkuInfoPermissions": "pikkuInfoPermissions",
     "knowledgeIndex": "knowledgeIndex",
+    "knowledgePlanSchema": "knowledgePlanSchema",
+    "knowledgePlanShow": "knowledgePlanShow",
+    "knowledgePlanProgress": "knowledgePlanProgress",
+    "knowledgePlanSet": "knowledgePlanSet",
+    "knowledgePlanDefer": "knowledgePlanDefer",
     "knowledgeValidate": "knowledgeValidate",
     "login": "login",
     "logout": "logout",

package/dist/.pikku/scenarios/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/scenarios` resolves here.