@pikku/cli 0.12.145 → 0.12.152

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.145
+ * This file was generated by @pikku/cli@0.12.152
  */
 /**
  * Channel-specific type definitions for tree-shaking optimization
@@ -34,7 +34,7 @@ type ChannelWiring<ChannelData, Channel extends string> = CoreChannel<ChannelDat
  *
  * @example snippet: channelLifecycle
  */
-export declare const pikkuChannelConnectionFunc: <Out = unknown>(func: PikkuFunctionSessionless<void, Out, "channel" | "session" | "rpc"> | PikkuFunctionConfig<void, Out, "channel" | "session" | "rpc">) => PikkuFunctionConfig<void, Out, "channel" | "rpc" | "session">;
+export declare const pikkuChannelConnectionFunc: <Out = unknown>(func: PikkuFunctionSessionless<void, Out, 'channel' | 'session' | 'rpc'> | PikkuFunctionConfig<void, Out, 'channel' | 'session' | 'rpc'>) => PikkuFunctionConfig<void, Out, "channel" | "rpc" | "session">;
 /**
  * Creates a function that handles WebSocket channel disconnections.
  * Called when a client disconnects from a channel.
@@ -44,7 +44,7 @@ export declare const pikkuChannelConnectionFunc: <Out = unknown>(func: PikkuFunc
  *
  * @example snippet: channelLifecycle
  */
-export declare const pikkuChannelDisconnectionFunc: (func: PikkuFunctionSessionless<void, void, "channel"> | PikkuFunctionConfig<void, void, "channel" | "session" | "rpc">) => PikkuFunctionConfig<void, void, "channel" | "rpc" | "session">;
+export declare const pikkuChannelDisconnectionFunc: (func: PikkuFunctionSessionless<void, void, 'channel'> | PikkuFunctionConfig<void, void, 'channel' | 'session' | 'rpc'>) => PikkuFunctionConfig<void, void, "channel" | "rpc" | "session">;
 /**
  * Configuration object for channel functions with Zod schema validation.
  */

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.145
+ * This file was generated by @pikku/cli@0.12.152
  */
 /**
  * Channel-specific type definitions for tree-shaking optimization

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

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

package/dist/.pikku/cli/index.js

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

package/dist/.pikku/cli/pikku-cli-channel.d.ts

@@ -3,15 +3,15 @@ export declare const cliHelp: import("../function/pikku-function-types.gen.js").
     args?: string[];
 }, {
     help: string;
-}, "rpc" | "session", import("../function/pikku-function-types.gen.js").PikkuFunctionSessionless<{
+}, "rpc" | "session", import("../function/pikku-function-types.gen.js").PikkuFunction<{
     args?: string[];
 }, {
     help: string;
-}, "rpc" | "session", import("../function/pikku-function-types.gen.js").WiredServices, unknown> | import("../function/pikku-function-types.gen.js").PikkuFunction<{
+}, "rpc" | "session", import("../function/pikku-function-types.gen.js").WiredServices> | import("../function/pikku-function-types.gen.js").PikkuFunctionSessionless<{
     args?: string[];
 }, {
     help: string;
-}, "rpc" | "session", import("../function/pikku-function-types.gen.js").WiredServices>, undefined, undefined>;
+}, "rpc" | "session", import("../function/pikku-function-types.gen.js").WiredServices, unknown>, undefined, undefined>;
 /**
  * Raw entry point: the client forwards argv untouched and this side owns
  * parsing, so a client binary never carries the command tree and its version
@@ -23,11 +23,11 @@ export declare const cliHelp: import("../function/pikku-function-types.gen.js").
  */
 export declare const cliRaw: import("../function/pikku-function-types.gen.js").PikkuFunctionConfig<{
     args: string[];
-}, RawCLIFrame, "rpc" | "session", import("../function/pikku-function-types.gen.js").PikkuFunctionSessionless<{
+}, RawCLIFrame, "rpc" | "session", import("../function/pikku-function-types.gen.js").PikkuFunction<{
     args: string[];
-}, RawCLIFrame, "rpc" | "session", import("../function/pikku-function-types.gen.js").WiredServices, unknown> | import("../function/pikku-function-types.gen.js").PikkuFunction<{
+}, RawCLIFrame, "rpc" | "session", import("../function/pikku-function-types.gen.js").WiredServices> | import("../function/pikku-function-types.gen.js").PikkuFunctionSessionless<{
     args: string[];
-}, RawCLIFrame, "rpc" | "session", import("../function/pikku-function-types.gen.js").WiredServices>, undefined, undefined>;
+}, RawCLIFrame, "rpc" | "session", import("../function/pikku-function-types.gen.js").WiredServices, unknown>, undefined, undefined>;
 /**
  * Refuses a connection that arrives without a session.
  *
@@ -36,4 +36,4 @@ export declare const cliRaw: import("../function/pikku-function-types.gen.js").P
  * run anything. Saying so immediately and hanging up gives the caller a
  * non-zero exit instead of a socket that silently refuses every command.
  */
-export declare const cliRequireSession: import("../function/pikku-function-types.gen.js").PikkuFunctionConfig<void, void | RawCLIFrame, "rpc" | "session", import("../function/pikku-function-types.gen.js").PikkuFunctionSessionless<void, void | RawCLIFrame, "rpc" | "session", import("../function/pikku-function-types.gen.js").WiredServices, unknown> | import("../function/pikku-function-types.gen.js").PikkuFunction<void, void | RawCLIFrame, "rpc" | "session", import("../function/pikku-function-types.gen.js").WiredServices>, undefined, undefined>;
+export declare const cliRequireSession: import("../function/pikku-function-types.gen.js").PikkuFunctionConfig<void, void | RawCLIFrame, "rpc" | "session", import("../function/pikku-function-types.gen.js").PikkuFunction<void, void | RawCLIFrame, "rpc" | "session", import("../function/pikku-function-types.gen.js").WiredServices> | import("../function/pikku-function-types.gen.js").PikkuFunctionSessionless<void, void | RawCLIFrame, "rpc" | "session", import("../function/pikku-function-types.gen.js").WiredServices, unknown>, undefined, undefined>;

package/dist/.pikku/cli/pikku-cli-channel.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.145
+ * This file was generated by @pikku/cli@0.12.152
  */
 /**
  * WebSocket channel backend for 'pikku' CLI commands
@@ -85,6 +85,13 @@ import { FabricDbSchema } from '../../src/fabric/functions/db-schema.function.js
 import { FabricDomainsList } from '../../src/fabric/functions/domains-list.function.js';
 import { FabricDomainsAdd } from '../../src/fabric/functions/domains-add.function.js';
 import { FabricDomainsRemove } from '../../src/fabric/functions/domains-remove.function.js';
+import { FabricChangesList } from '../../src/fabric/functions/changes-list.function.js';
+import { FabricChangesShow } from '../../src/fabric/functions/changes-show.function.js';
+import { FabricChangesFile } from '../../src/fabric/functions/changes-file.function.js';
+import { FabricChangesClaim } from '../../src/fabric/functions/changes-claim.function.js';
+import { FabricChangesAsk } from '../../src/fabric/functions/changes-ask.function.js';
+import { FabricChangesShot } from '../../src/fabric/functions/changes-shot.function.js';
+import { FabricChangesDone } from '../../src/fabric/functions/changes-done.function.js';
 import { FabricLLMKey } from '../../src/fabric/functions/llm-key.function.js';
 import { pikkuFetch } from '../../src/functions/runtimes/fetch/index.js';
 import { pikkuWebSocketTyped } from '../../src/functions/runtimes/websocket/pikku-command-websocket-typed.js';
@@ -558,6 +565,34 @@ wireChannel({
                 func: FabricDomainsRemove,
                 middleware: [cliCloseOnComplete],
             },
+            'fabric.changes.list': {
+                func: FabricChangesList,
+                middleware: [cliCloseOnComplete],
+            },
+            'fabric.changes.show': {
+                func: FabricChangesShow,
+                middleware: [cliCloseOnComplete],
+            },
+            'fabric.changes.file': {
+                func: FabricChangesFile,
+                middleware: [cliCloseOnComplete],
+            },
+            'fabric.changes.claim': {
+                func: FabricChangesClaim,
+                middleware: [cliCloseOnComplete],
+            },
+            'fabric.changes.ask': {
+                func: FabricChangesAsk,
+                middleware: [cliCloseOnComplete],
+            },
+            'fabric.changes.shot': {
+                func: FabricChangesShot,
+                middleware: [cliCloseOnComplete],
+            },
+            'fabric.changes.done': {
+                func: FabricChangesDone,
+                middleware: [cliCloseOnComplete],
+            },
             'fabric.llm.key': {
                 func: FabricLLMKey,
                 middleware: [cliCloseOnComplete],

package/dist/.pikku/cli/pikku-cli-client.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.145
+ * This file was generated by @pikku/cli@0.12.152
  */
 import type { Capabilities } from '@pikku/core/channel';
 /**

package/dist/.pikku/cli/pikku-cli-client.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.145
+ * This file was generated by @pikku/cli@0.12.152
  */
 import { executeRawCLIViaChannel } from '@pikku/core/cli/channel';
 import { CorePikkuWebsocket } from '@pikku/websocket';

package/dist/.pikku/cli/pikku-cli-contracts-meta.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.145
+ * This file was generated by @pikku/cli@0.12.152
  */
 import contractsMeta from './pikku-cli-contracts-meta.gen.json';
 export default contractsMeta;

package/dist/.pikku/cli/pikku-cli-contracts-meta.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.145
+ * This file was generated by @pikku/cli@0.12.152
  */
 import contractsMeta from './pikku-cli-contracts-meta.gen.json' with { type: 'json' };
 export default contractsMeta;

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

@@ -675,6 +675,213 @@
                 }
             }
         },
+        "changes": {
+            "pikkuFuncId": "",
+            "positionals": [],
+            "options": {},
+            "description": "The todo list filed from inside a deployed stage: read what is open, file what was decided elsewhere, claim a batch, ask what you need to know, and tick items off",
+            "subcommands": {
+                "list": {
+                    "pikkuFuncId": "FabricChangesList",
+                    "positionals": [],
+                    "options": {
+                        "projectId": {
+                            "description": "Project to read (defaults to the linked checkout)",
+                            "short": "p"
+                        },
+                        "stageId": {
+                            "description": "Only changes filed on this stage"
+                        },
+                        "route": {
+                            "description": "Only changes filed on this route, e.g. /checkout"
+                        },
+                        "groupId": {
+                            "description": "Only changes in this group"
+                        },
+                        "pickupOnly": {
+                            "description": "Skip items still held for the person who just filed them",
+                            "default": false
+                        },
+                        "includeDone": {
+                            "description": "Also return done and dismissed items",
+                            "default": false
+                        },
+                        "limit": {
+                            "description": "How many to return (default 50, max 200)",
+                            "type": "number"
+                        },
+                        "apiUrl": {
+                            "description": "Override the fabric-api URL for this call"
+                        }
+                    },
+                    "renderName": "renderChangesList",
+                    "description": "Open changes for a project, grouped the way they will be worked"
+                },
+                "show": {
+                    "pikkuFuncId": "FabricChangesShow",
+                    "positionals": [],
+                    "options": {
+                        "changeId": {
+                            "description": "The change to read, from `pikku fabric changes list`"
+                        },
+                        "apiUrl": {
+                            "description": "Override the fabric-api URL for this call"
+                        }
+                    },
+                    "renderName": "renderChangesShow",
+                    "description": "One change with its thread, its circled elements and the build it was filed against"
+                },
+                "file": {
+                    "pikkuFuncId": "FabricChangesFile",
+                    "positionals": [],
+                    "options": {
+                        "projectId": {
+                            "description": "Project to file against (defaults to the linked checkout)",
+                            "short": "p"
+                        },
+                        "stageId": {
+                            "description": "Stage to file against (defaults to the only stage)"
+                        },
+                        "branch": {
+                            "description": "Resolve the stage from this branch instead"
+                        },
+                        "title": {
+                            "description": "The requirement, in one line",
+                            "short": "t"
+                        },
+                        "body": {
+                            "description": "The detail, if a line is not enough"
+                        },
+                        "bodyFile": {
+                            "description": "Read the body from a file — use this when it has newlines"
+                        },
+                        "route": {
+                            "description": "The route it is about, e.g. /admin/rota"
+                        },
+                        "locale": {
+                            "description": "Locale it was seen in, e.g. de"
+                        },
+                        "apiUrl": {
+                            "description": "Override the fabric-api URL for this call"
+                        }
+                    },
+                    "renderName": "renderChangesFile",
+                    "description": "File an item from outside the panel — the words, without the screenshot the panel would have attached"
+                },
+                "claim": {
+                    "pikkuFuncId": "FabricChangesClaim",
+                    "positionals": [],
+                    "options": {
+                        "projectId": {
+                            "description": "Project the items belong to",
+                            "short": "p"
+                        },
+                        "groupId": {
+                            "description": "Claim an existing group instead of forming one"
+                        },
+                        "changeIds": {
+                            "description": "The items to take, comma-separated or repeated",
+                            "type": "string[]"
+                        },
+                        "title": {
+                            "description": "What to call the group being formed"
+                        },
+                        "claimedBy": {
+                            "description": "Who is taking it — shown in the panel while the lease is held"
+                        },
+                        "leaseMinutes": {
+                            "description": "How long to hold it before it returns to the queue (default 30)",
+                            "type": "number"
+                        },
+                        "apiUrl": {
+                            "description": "Override the fabric-api URL for this call"
+                        }
+                    },
+                    "renderName": "renderChangesClaim",
+                    "description": "Take a batch of items as one job under a lease. Naming items without a group creates the group"
+                },
+                "ask": {
+                    "pikkuFuncId": "FabricChangesAsk",
+                    "positionals": [],
+                    "options": {
+                        "changeId": {
+                            "description": "The item the question is about"
+                        },
+                        "question": {
+                            "description": "One decision, in the filer’s vocabulary, with the options named",
+                            "short": "q"
+                        },
+                        "authorName": {
+                            "description": "Who is asking, e.g. claude-code"
+                        },
+                        "apiUrl": {
+                            "description": "Override the fabric-api URL for this call"
+                        }
+                    },
+                    "renderName": "renderChangesAsk",
+                    "description": "Ask the person who filed an item what you need to know. The question is parked, not blocking"
+                },
+                "shot": {
+                    "pikkuFuncId": "FabricChangesShot",
+                    "positionals": [],
+                    "options": {
+                        "changeId": {
+                            "description": "The item the options belong to"
+                        },
+                        "label": {
+                            "description": "What to call this variant in the picker, e.g. “Grouped totals”"
+                        },
+                        "image": {
+                            "description": "Path to the image file to attach"
+                        },
+                        "imageBase64": {
+                            "description": "The image itself, base64, instead of --image"
+                        },
+                        "contentType": {
+                            "description": "image/png, image/jpeg or image/webp (inferred from --image)"
+                        },
+                        "kind": {
+                            "description": "option (a variant to choose between) or evidence (something to look at)",
+                            "default": "option"
+                        },
+                        "authorName": {
+                            "description": "Who rendered it, e.g. claude-code"
+                        },
+                        "apiUrl": {
+                            "description": "Override the fabric-api URL for this call"
+                        }
+                    },
+                    "renderName": "renderChangesShot",
+                    "description": "Attach a rendered option to an item’s thread. The panel turns a set of them into a pick-one"
+                },
+                "done": {
+                    "pikkuFuncId": "FabricChangesDone",
+                    "positionals": [],
+                    "options": {
+                        "changeId": {
+                            "description": "The item that is done"
+                        },
+                        "branch": {
+                            "description": "Branch the fix landed on (defaults to this checkout)"
+                        },
+                        "headCommit": {
+                            "description": "Commit that closed it (defaults to this checkout)"
+                        },
+                        "note": {
+                            "description": "What was done, for whoever reads the thread later"
+                        },
+                        "authorName": {
+                            "description": "Who did it, e.g. claude-code"
+                        },
+                        "apiUrl": {
+                            "description": "Override the fabric-api URL for this call"
+                        }
+                    },
+                    "renderName": "renderChangesDone",
+                    "description": "Tick an item off, recording the branch and commit that closed it so the panel can strike it through"
+                }
+            }
+        },
         "llm": {
             "pikkuFuncId": "",
             "positionals": [],

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.145
+ * This file was generated by @pikku/cli@0.12.152
  */
 /**
 
@@ -65,7 +65,7 @@ export declare const wireCLI: <Commands extends Record<string, CoreCLICommandCon
  *
  * @example snippet: cliWiring
  */
-export declare const pikkuCLICommand: <FuncConfig extends PikkuFunctionConfig<any, any, "cli" | "rpc" | "session">, Params extends string>(config: CLICommandConfig<FuncConfig, any, any, Params>) => CoreCLICommandConfig<FuncConfig, PikkuMiddleware, PikkuCLIRender<any>, string>;
+export declare const pikkuCLICommand: <FuncConfig extends PikkuFunctionConfig<any, any, 'cli' | 'rpc' | 'session'>, Params extends string>(config: CLICommandConfig<FuncConfig, any, any, Params>) => CoreCLICommandConfig<FuncConfig, PikkuMiddleware, PikkuCLIRender<any>, string>;
 /**
  * Type-safe helper for defining CLI commands that can be composed and spread into wireCLI.
  *

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.145
+ * This file was generated by @pikku/cli@0.12.152
  */
 /**
 

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.145
+ * This file was generated by @pikku/cli@0.12.152
  */
 import { pikkuState } from '@pikku/core/state';
 import metaData from './pikku-cli-wirings-meta.gen.json' with { type: 'json' };

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

@@ -1418,6 +1418,213 @@
                                 }
                             }
                         },
+                        "changes": {
+                            "pikkuFuncId": "",
+                            "positionals": [],
+                            "options": {},
+                            "description": "The todo list filed from inside a deployed stage: read what is open, file what was decided elsewhere, claim a batch, ask what you need to know, and tick items off",
+                            "subcommands": {
+                                "list": {
+                                    "pikkuFuncId": "FabricChangesList",
+                                    "positionals": [],
+                                    "options": {
+                                        "projectId": {
+                                            "description": "Project to read (defaults to the linked checkout)",
+                                            "short": "p"
+                                        },
+                                        "stageId": {
+                                            "description": "Only changes filed on this stage"
+                                        },
+                                        "route": {
+                                            "description": "Only changes filed on this route, e.g. /checkout"
+                                        },
+                                        "groupId": {
+                                            "description": "Only changes in this group"
+                                        },
+                                        "pickupOnly": {
+                                            "description": "Skip items still held for the person who just filed them",
+                                            "default": false
+                                        },
+                                        "includeDone": {
+                                            "description": "Also return done and dismissed items",
+                                            "default": false
+                                        },
+                                        "limit": {
+                                            "description": "How many to return (default 50, max 200)",
+                                            "type": "number"
+                                        },
+                                        "apiUrl": {
+                                            "description": "Override the fabric-api URL for this call"
+                                        }
+                                    },
+                                    "renderName": "renderChangesList",
+                                    "description": "Open changes for a project, grouped the way they will be worked"
+                                },
+                                "show": {
+                                    "pikkuFuncId": "FabricChangesShow",
+                                    "positionals": [],
+                                    "options": {
+                                        "changeId": {
+                                            "description": "The change to read, from `pikku fabric changes list`"
+                                        },
+                                        "apiUrl": {
+                                            "description": "Override the fabric-api URL for this call"
+                                        }
+                                    },
+                                    "renderName": "renderChangesShow",
+                                    "description": "One change with its thread, its circled elements and the build it was filed against"
+                                },
+                                "file": {
+                                    "pikkuFuncId": "FabricChangesFile",
+                                    "positionals": [],
+                                    "options": {
+                                        "projectId": {
+                                            "description": "Project to file against (defaults to the linked checkout)",
+                                            "short": "p"
+                                        },
+                                        "stageId": {
+                                            "description": "Stage to file against (defaults to the only stage)"
+                                        },
+                                        "branch": {
+                                            "description": "Resolve the stage from this branch instead"
+                                        },
+                                        "title": {
+                                            "description": "The requirement, in one line",
+                                            "short": "t"
+                                        },
+                                        "body": {
+                                            "description": "The detail, if a line is not enough"
+                                        },
+                                        "bodyFile": {
+                                            "description": "Read the body from a file — use this when it has newlines"
+                                        },
+                                        "route": {
+                                            "description": "The route it is about, e.g. /admin/rota"
+                                        },
+                                        "locale": {
+                                            "description": "Locale it was seen in, e.g. de"
+                                        },
+                                        "apiUrl": {
+                                            "description": "Override the fabric-api URL for this call"
+                                        }
+                                    },
+                                    "renderName": "renderChangesFile",
+                                    "description": "File an item from outside the panel — the words, without the screenshot the panel would have attached"
+                                },
+                                "claim": {
+                                    "pikkuFuncId": "FabricChangesClaim",
+                                    "positionals": [],
+                                    "options": {
+                                        "projectId": {
+                                            "description": "Project the items belong to",
+                                            "short": "p"
+                                        },
+                                        "groupId": {
+                                            "description": "Claim an existing group instead of forming one"
+                                        },
+                                        "changeIds": {
+                                            "description": "The items to take, comma-separated or repeated",
+                                            "type": "string[]"
+                                        },
+                                        "title": {
+                                            "description": "What to call the group being formed"
+                                        },
+                                        "claimedBy": {
+                                            "description": "Who is taking it — shown in the panel while the lease is held"
+                                        },
+                                        "leaseMinutes": {
+                                            "description": "How long to hold it before it returns to the queue (default 30)",
+                                            "type": "number"
+                                        },
+                                        "apiUrl": {
+                                            "description": "Override the fabric-api URL for this call"
+                                        }
+                                    },
+                                    "renderName": "renderChangesClaim",
+                                    "description": "Take a batch of items as one job under a lease. Naming items without a group creates the group"
+                                },
+                                "ask": {
+                                    "pikkuFuncId": "FabricChangesAsk",
+                                    "positionals": [],
+                                    "options": {
+                                        "changeId": {
+                                            "description": "The item the question is about"
+                                        },
+                                        "question": {
+                                            "description": "One decision, in the filer’s vocabulary, with the options named",
+                                            "short": "q"
+                                        },
+                                        "authorName": {
+                                            "description": "Who is asking, e.g. claude-code"
+                                        },
+                                        "apiUrl": {
+                                            "description": "Override the fabric-api URL for this call"
+                                        }
+                                    },
+                                    "renderName": "renderChangesAsk",
+                                    "description": "Ask the person who filed an item what you need to know. The question is parked, not blocking"
+                                },
+                                "shot": {
+                                    "pikkuFuncId": "FabricChangesShot",
+                                    "positionals": [],
+                                    "options": {
+                                        "changeId": {
+                                            "description": "The item the options belong to"
+                                        },
+                                        "label": {
+                                            "description": "What to call this variant in the picker, e.g. “Grouped totals”"
+                                        },
+                                        "image": {
+                                            "description": "Path to the image file to attach"
+                                        },
+                                        "imageBase64": {
+                                            "description": "The image itself, base64, instead of --image"
+                                        },
+                                        "contentType": {
+                                            "description": "image/png, image/jpeg or image/webp (inferred from --image)"
+                                        },
+                                        "kind": {
+                                            "description": "option (a variant to choose between) or evidence (something to look at)",
+                                            "default": "option"
+                                        },
+                                        "authorName": {
+                                            "description": "Who rendered it, e.g. claude-code"
+                                        },
+                                        "apiUrl": {
+                                            "description": "Override the fabric-api URL for this call"
+                                        }
+                                    },
+                                    "renderName": "renderChangesShot",
+                                    "description": "Attach a rendered option to an item’s thread. The panel turns a set of them into a pick-one"
+                                },
+                                "done": {
+                                    "pikkuFuncId": "FabricChangesDone",
+                                    "positionals": [],
+                                    "options": {
+                                        "changeId": {
+                                            "description": "The item that is done"
+                                        },
+                                        "branch": {
+                                            "description": "Branch the fix landed on (defaults to this checkout)"
+                                        },
+                                        "headCommit": {
+                                            "description": "Commit that closed it (defaults to this checkout)"
+                                        },
+                                        "note": {
+                                            "description": "What was done, for whoever reads the thread later"
+                                        },
+                                        "authorName": {
+                                            "description": "Who did it, e.g. claude-code"
+                                        },
+                                        "apiUrl": {
+                                            "description": "Override the fabric-api URL for this call"
+                                        }
+                                    },
+                                    "renderName": "renderChangesDone",
+                                    "description": "Tick an item off, recording the branch and commit that closed it so the panel can strike it through"
+                                }
+                            }
+                        },
                         "llm": {
                             "pikkuFuncId": "",
                             "positionals": [],