total-recall-brain 3.45.0 → 3.46.1

package/scaffold/.agent/skills/total-recall/plugins/composable-cli/package-lock.json

@@ -1,18 +1,18 @@
 {
   "name": "tr-plugin-composable-cli",
-  "version": "0.2.6",
+  "version": "0.3.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "tr-plugin-composable-cli",
-      "version": "0.2.6",
+      "version": "0.3.0",
       "license": "MIT",
       "dependencies": {
         "@gregiteen/ssss-cli": "0.14.5"
       },
       "devDependencies": {
-        "total-recall-brain": "3.44.0"
+        "total-recall-brain": "3.45.0"
       }
     },
     "node_modules/@alcalzone/ansi-tokenize": {
@@ -5543,9 +5543,9 @@
       }
     },
     "node_modules/total-recall-brain": {
-      "version": "3.44.0",
-      "resolved": "https://registry.npmjs.org/total-recall-brain/-/total-recall-brain-3.44.0.tgz",
-      "integrity": "sha512-VNPaIO9zsSwoxAsJ5ByIQBP9zPpLq4RiQO7Vrex4rBOHFQJT50P7utcZiLMSZTyZJU4C/m5uB8qTCSBMp6+l6Q==",
+      "version": "3.45.0",
+      "resolved": "https://registry.npmjs.org/total-recall-brain/-/total-recall-brain-3.45.0.tgz",
+      "integrity": "sha512-HDYfROazZbsLHQsFPnlBcSpe1HL1QEi7JG8x/eNRUI06RxVQsZWl8LwBo2lTWjWRDrKmCy7BUmSXQDuWF3lrEw==",
       "dev": true,
       "license": "MIT",
       "workspaces": [

package/scaffold/.agent/skills/total-recall/plugins/composable-cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tr-plugin-composable-cli",
-  "version": "0.2.6",
+  "version": "0.3.0",
   "type": "module",
   "description": "Total Recall composable CLI plugin: create, compose, register, test and safely run custom verbs; every command listed in the instruction surfaces.",
   "scripts": {
@@ -16,6 +16,7 @@
   "files": [
     "cli.mjs",
     "plugin.json",
+    "DESIGN.md",
     "README.md",
     "LICENSE",
     "examples/",

package/scaffold/.agent/skills/total-recall/plugins/composable-cli/plugin.json

@@ -2,7 +2,7 @@
   "$schema": "https://github.com/gregiteen/total-recall/blob/main/metadata.plugin.schema.json",
   "id": "composable-cli",
   "name": "Composable CLI",
-  "version": "0.2.6",
+  "version": "0.3.0",
   "description": "Dynamic agent command composition engine with pipeline registration, versioning, and execution.",
   "author": "Total Recall contributors",
   "license": "MIT",
@@ -117,42 +117,59 @@
       "description": "Total Recall composable CLI plugin: create, compose, register, test and safely run custom verbs; every command listed in the instruction surfaces."
     }
   ],
-  "card_face": {
-    "skin": "cyber-forge",
-    "theme": "vibrant",
-    "headline": "Dynamic Agent Command Composition",
-    "primary_color": "#0891b2",
-    "secondary_color": "#083344",
-    "accent_color": "#06b6d4",
-    "touch_layout": "comfortable",
-    "interactive": true,
-    "quick_actions": [
-      {
-        "subcommand": "library",
-        "label": "LIBRARY"
-      },
-      {
-        "subcommand": "list",
-        "label": "LIST"
-      },
-      {
-        "subcommand": "show",
-        "label": "SHOW"
-      },
-      {
-        "subcommand": "history",
-        "label": "HISTORY"
-      }
-    ]
-  },
   "ui": {
+    "home": "home",
+    "design_tokens": "DESIGN.md",
     "elements": [
       {
-        "id": "card",
-        "kind": "card",
-        "tag": "tr-composable-cli-card",
-        "module": "ui/card.js",
-        "description": "Pipeline Card Face"
+        "id": "home",
+        "kind": "panel",
+        "tag": "tr-composable-cli-home",
+        "module": "ui/home.js",
+        "description": "CmdSmith Home: composed commands, their records and history, with on-demand test, rollback and remove",
+        "tokens": [
+          "color-background",
+          "color-secondary",
+          "color-surface",
+          "color-surface-raised",
+          "color-line",
+          "color-text",
+          "color-muted",
+          "color-primary",
+          "color-primary-strong",
+          "color-primary-soft",
+          "color-on-primary",
+          "color-ok",
+          "color-ok-soft",
+          "color-warn",
+          "color-warn-soft",
+          "color-danger",
+          "color-danger-soft",
+          "color-info",
+          "color-info-soft",
+          "spacing-xs",
+          "spacing-sm",
+          "spacing-md",
+          "spacing-lg",
+          "spacing-touch",
+          "radius-sm",
+          "radius-md",
+          "radius-lg",
+          "typography-title-font-family",
+          "typography-title-font-size",
+          "typography-title-font-weight",
+          "typography-title-line-height",
+          "typography-body-font-family",
+          "typography-body-font-size",
+          "typography-body-line-height",
+          "typography-label-font-family",
+          "typography-label-font-size",
+          "typography-label-font-weight",
+          "typography-label-letter-spacing",
+          "typography-code-font-family",
+          "typography-code-font-size",
+          "typography-code-line-height"
+        ]
       }
     ]
   },

package/scaffold/.agent/skills/total-recall/plugins/composable-cli/src/command.mjs

@@ -295,7 +295,7 @@ export function commandList(targets = []) {
   const results = [];
   for (const t of targets) {
     if (fs.existsSync(t.dir)) {
-      const files = fs.readdirSync(t.dir).filter((f) => f.endsWith('.mjs'));
+      const files = fs.readdirSync(t.dir).filter((f) => f.endsWith('.mjs') && !f.endsWith('.test.mjs'));
       for (const f of files) {
         const fullPath = path.join(t.dir, f);
         const name = f.replace(/\.mjs$/, '');

package/scaffold/.agent/skills/total-recall/plugins/composable-cli/ui/chunks/create.md

@@ -0,0 +1,35 @@
+---
+type: ui-chunk:chunk
+plugin: composable-cli
+id: create
+title: Create a command
+description: Turns a repeated sequence into a new named composed command with a declared risk class and a registry record.
+timestamp: '2026-11-08T08:12:00Z'
+intents:
+  - Turn a repeated sequence into a reusable command
+surfaces: [page]
+operations: [create]
+---
+<section data-design-component="op-sheet">
+<style>
+[data-design-component="op-sheet"]{background:var(--color-surface);color:var(--color-text);font-family:var(--typography-body-font-family);font-size:var(--typography-body-font-size);line-height:var(--typography-body-line-height);border-radius:var(--radius-lg);padding:var(--spacing-lg)}
+[data-design-component="op-sheet"] h2{font-family:var(--typography-title-font-family);font-size:var(--typography-title-font-size);font-weight:var(--typography-title-font-weight);margin:0 0 var(--spacing-sm)}
+[data-design-component="op-sheet"] p{margin:0 0 var(--spacing-md)}
+[data-design-component="risk-badge"]{font-family:var(--typography-label-font-family);font-size:var(--typography-label-font-size);font-weight:var(--typography-label-font-weight);letter-spacing:var(--typography-label-letter-spacing);text-transform:uppercase;border-radius:var(--radius-sm);padding:2px var(--spacing-xs);color:var(--color-warn);background:var(--color-warn-soft)}
+[data-design-component="field-list"]{color:var(--color-muted);font-family:var(--typography-code-font-family);font-size:var(--typography-code-font-size);margin:0}
+[data-design-component="field-list"] dt{color:var(--color-text)}
+[data-design-component="field-list"] dd{margin:0 0 var(--spacing-sm);font-family:var(--typography-body-font-family)}
+code{font-family:var(--typography-code-font-family)}
+</style>
+<h2>Create a command</h2>
+<p><span data-design-component="risk-badge">write</span> Writes a new command file and its registry record, then refreshes the command inventories in the instruction files.</p>
+<p>Run <code>total-recall composable-cli create &lt;name&gt; "&lt;code&gt;" --description "…" --risk read</code>. It confirms in plain text.</p>
+<dl data-design-component="field-list">
+<dt>&lt;name&gt;</dt><dd>Lowercase kebab case, 1 to 64 characters. Built-in Total Recall names are refused.</dd>
+<dt>--risk</dt><dd><code>read</code>, <code>write</code>, <code>money</code>, <code>dns-cert</code>, <code>production-deploy</code> or <code>secret-revoke</code>. Defaults to <code>write</code>.</dd>
+<dt>--global, --group &lt;id&gt;</dt><dd>Store it machine-wide or for one project group instead of this project.</dd>
+<dt>--from-plugin &lt;dir&gt;</dt><dd>Wrap a command declared in a plugin's manifest instead of inline code.</dd>
+<dt>--config-for-skill &lt;id&gt;</dt><dd>Create a repository config command for a layered skill.</dd>
+</dl>
+<p>Creating a name that already exists in the same scope fails; use <code>update</code> instead.</p>
+</section>

package/scaffold/.agent/skills/total-recall/plugins/composable-cli/ui/chunks/history.md

@@ -0,0 +1,35 @@
+---
+type: ui-chunk:chunk
+plugin: composable-cli
+id: history
+title: Version history
+description: Lists the saved earlier versions of a composed command that a rollback can restore.
+timestamp: '2026-11-08T08:12:00Z'
+intents:
+  - See which earlier versions of a command can be restored
+surfaces: [page]
+operations: [history]
+data:
+  - history:/name
+  - history:/versions
+panel: home
+---
+<section data-design-component="op-sheet">
+<style>
+[data-design-component="op-sheet"]{background:var(--color-surface);color:var(--color-text);font-family:var(--typography-body-font-family);font-size:var(--typography-body-font-size);line-height:var(--typography-body-line-height);border-radius:var(--radius-lg);padding:var(--spacing-lg)}
+[data-design-component="op-sheet"] h2{font-family:var(--typography-title-font-family);font-size:var(--typography-title-font-size);font-weight:var(--typography-title-font-weight);margin:0 0 var(--spacing-sm)}
+[data-design-component="op-sheet"] p{margin:0 0 var(--spacing-md)}
+[data-design-component="risk-badge"]{font-family:var(--typography-label-font-family);font-size:var(--typography-label-font-size);font-weight:var(--typography-label-font-weight);letter-spacing:var(--typography-label-letter-spacing);text-transform:uppercase;border-radius:var(--radius-sm);padding:2px var(--spacing-xs);color:var(--color-ok);background:var(--color-ok-soft)}
+[data-design-component="field-list"]{color:var(--color-muted);font-family:var(--typography-code-font-family);font-size:var(--typography-code-font-size);margin:0}
+[data-design-component="field-list"] dt{color:var(--color-text)}
+[data-design-component="field-list"] dd{margin:0 0 var(--spacing-sm);font-family:var(--typography-body-font-family)}
+code{font-family:var(--typography-code-font-family)}
+</style>
+<h2>Version history</h2>
+<p><span data-design-component="risk-badge">read</span> Each update and rollback first saves the current version as a snapshot. This lists those snapshots.</p>
+<p>Run <code>total-recall composable-cli history &lt;name&gt; --json</code>, adding <code>--global</code> or <code>--group &lt;id&gt;</code> for those scopes. The CmdSmith Home shows it in the command inspector, with a rollback button per version.</p>
+<dl data-design-component="field-list">
+<dt>name</dt><dd>The command the history belongs to.</dd>
+<dt>versions</dt><dd>Saved version numbers in ascending order. Empty until the command is first updated.</dd>
+</dl>
+</section>

package/scaffold/.agent/skills/total-recall/plugins/composable-cli/ui/chunks/library.md

@@ -0,0 +1,49 @@
+---
+type: ui-chunk:chunk
+plugin: composable-cli
+id: library
+title: Command library
+description: Lists every installed plugin operation and every composed command in scope, read from declarations without running any of them.
+timestamp: '2026-11-08T08:12:00Z'
+intents:
+  - Discover which commands and plugin operations are available
+  - Find an existing command before composing a new one
+surfaces: [page]
+operations: [library]
+data:
+  - library:/plugins
+  - library:/plugins/*/id
+  - library:/commands
+  - library:/commands/*/command
+  - library:/commands/*/effect
+  - library:/commands/*/description
+  - library:/commands/*/plugin
+  - library:/composedCommands
+  - library:/composedCommands/*/name
+  - library:/composedCommands/*/scope
+  - library:/composedCommands/*/description
+  - library:/composedCommands/*/risk
+  - library:/composedCommands/*/command
+  - library:/evidence
+---
+<section data-design-component="op-sheet">
+<style>
+[data-design-component="op-sheet"]{background:var(--color-surface);color:var(--color-text);font-family:var(--typography-body-font-family);font-size:var(--typography-body-font-size);line-height:var(--typography-body-line-height);border-radius:var(--radius-lg);padding:var(--spacing-lg)}
+[data-design-component="op-sheet"] h2{font-family:var(--typography-title-font-family);font-size:var(--typography-title-font-size);font-weight:var(--typography-title-font-weight);margin:0 0 var(--spacing-sm)}
+[data-design-component="op-sheet"] p{margin:0 0 var(--spacing-md)}
+[data-design-component="risk-badge"]{font-family:var(--typography-label-font-family);font-size:var(--typography-label-font-size);font-weight:var(--typography-label-font-weight);letter-spacing:var(--typography-label-letter-spacing);text-transform:uppercase;border-radius:var(--radius-sm);padding:2px var(--spacing-xs);color:var(--color-ok);background:var(--color-ok-soft)}
+[data-design-component="field-list"]{color:var(--color-muted);font-family:var(--typography-code-font-family);font-size:var(--typography-code-font-size);margin:0}
+[data-design-component="field-list"] dt{color:var(--color-text)}
+[data-design-component="field-list"] dd{margin:0 0 var(--spacing-sm);font-family:var(--typography-body-font-family)}
+code{font-family:var(--typography-code-font-family)}
+</style>
+<h2>Command library</h2>
+<p><span data-design-component="risk-badge">read</span> One view of what you can call: installed plugin operations and your composed commands. Nothing is executed and no command code is imported.</p>
+<p>Run <code>total-recall composable-cli library --json</code>. Add <code>--plugin &lt;id&gt;</code> to see one installed plugin's operations only; composed commands are then left out.</p>
+<dl data-design-component="field-list">
+<dt>plugins[].id</dt><dd>Each installed plugin.</dd>
+<dt>commands[]</dt><dd>Each plugin operation: the full <code>command</code> to type, its declared <code>effect</code>, its <code>description</code> and owning <code>plugin</code>.</dd>
+<dt>composedCommands[]</dt><dd>Each composed command in scope: <code>name</code>, <code>scope</code> (project, group or global), <code>description</code>, declared <code>risk</code> and the <code>command</code> to type.</dd>
+<dt>evidence</dt><dd>A reminder that these are declarations. A provider is ready only after a real run succeeds.</dd>
+</dl>
+</section>

package/scaffold/.agent/skills/total-recall/plugins/composable-cli/ui/chunks/list.md

@@ -0,0 +1,42 @@
+---
+type: ui-chunk:chunk
+plugin: composable-cli
+id: list
+title: Composed commands
+description: Lists the composed commands in the project, group and global scopes with their declared risk and description.
+timestamp: '2026-11-08T08:12:00Z'
+intents:
+  - See which composed commands exist
+  - Check a composed command's scope and risk
+surfaces: [page]
+operations: [list]
+data:
+  - list:/*/name
+  - list:/*/scope
+  - list:/*/path
+  - list:/*/description
+  - list:/*/risk
+panel: home
+---
+<section data-design-component="op-sheet">
+<style>
+[data-design-component="op-sheet"]{background:var(--color-surface);color:var(--color-text);font-family:var(--typography-body-font-family);font-size:var(--typography-body-font-size);line-height:var(--typography-body-line-height);border-radius:var(--radius-lg);padding:var(--spacing-lg)}
+[data-design-component="op-sheet"] h2{font-family:var(--typography-title-font-family);font-size:var(--typography-title-font-size);font-weight:var(--typography-title-font-weight);margin:0 0 var(--spacing-sm)}
+[data-design-component="op-sheet"] p{margin:0 0 var(--spacing-md)}
+[data-design-component="risk-badge"]{font-family:var(--typography-label-font-family);font-size:var(--typography-label-font-size);font-weight:var(--typography-label-font-weight);letter-spacing:var(--typography-label-letter-spacing);text-transform:uppercase;border-radius:var(--radius-sm);padding:2px var(--spacing-xs);color:var(--color-ok);background:var(--color-ok-soft)}
+[data-design-component="field-list"]{color:var(--color-muted);font-family:var(--typography-code-font-family);font-size:var(--typography-code-font-size);margin:0}
+[data-design-component="field-list"] dt{color:var(--color-text)}
+[data-design-component="field-list"] dd{margin:0 0 var(--spacing-sm);font-family:var(--typography-body-font-family)}
+code{font-family:var(--typography-code-font-family)}
+</style>
+<h2>Composed commands</h2>
+<p><span data-design-component="risk-badge">read</span> Every composed command you can run here, nearest scope first: project, then each group this project belongs to, then global.</p>
+<p>Run <code>total-recall composable-cli list --json</code>. The CmdSmith Home shows this list with a scope filter.</p>
+<dl data-design-component="field-list">
+<dt>name</dt><dd>The verb you type after <code>total-recall</code>.</dd>
+<dt>scope</dt><dd><code>project</code>, <code>group</code> or <code>global</code>.</dd>
+<dt>path</dt><dd>The command's source file.</dd>
+<dt>description</dt><dd>The command's one-line purpose, or null when none was given.</dd>
+<dt>risk</dt><dd>The declared risk class: <code>read</code>, <code>write</code>, <code>money</code>, <code>dns-cert</code>, <code>production-deploy</code> or <code>secret-revoke</code>. Null when undeclared.</dd>
+</dl>
+</section>

package/scaffold/.agent/skills/total-recall/plugins/composable-cli/ui/chunks/promote.md

@@ -0,0 +1,40 @@
+---
+type: ui-chunk:chunk
+plugin: composable-cli
+id: promote
+title: Promote into a plugin
+description: Moves a registered inline composed command into a plugin's manifest and commands folder after verifying its digest and risk class.
+timestamp: '2026-11-08T08:12:00Z'
+intents:
+  - Make a composed command part of a plugin
+surfaces: [page]
+operations: [promote]
+data:
+  - promote:/ok
+  - promote:/name
+  - promote:/plugin
+  - promote:/handler
+  - promote:/risk
+---
+<section data-design-component="op-sheet">
+<style>
+[data-design-component="op-sheet"]{background:var(--color-surface);color:var(--color-text);font-family:var(--typography-body-font-family);font-size:var(--typography-body-font-size);line-height:var(--typography-body-line-height);border-radius:var(--radius-lg);padding:var(--spacing-lg)}
+[data-design-component="op-sheet"] h2{font-family:var(--typography-title-font-family);font-size:var(--typography-title-font-size);font-weight:var(--typography-title-font-weight);margin:0 0 var(--spacing-sm)}
+[data-design-component="op-sheet"] p{margin:0 0 var(--spacing-md)}
+[data-design-component="risk-badge"]{font-family:var(--typography-label-font-family);font-size:var(--typography-label-font-size);font-weight:var(--typography-label-font-weight);letter-spacing:var(--typography-label-letter-spacing);text-transform:uppercase;border-radius:var(--radius-sm);padding:2px var(--spacing-xs);color:var(--color-warn);background:var(--color-warn-soft)}
+[data-design-component="field-list"]{color:var(--color-muted);font-family:var(--typography-code-font-family);font-size:var(--typography-code-font-size);margin:0}
+[data-design-component="field-list"] dt{color:var(--color-text)}
+[data-design-component="field-list"] dd{margin:0 0 var(--spacing-sm);font-family:var(--typography-body-font-family)}
+code{font-family:var(--typography-code-font-family)}
+</style>
+<h2>Promote into a plugin</h2>
+<p><span data-design-component="risk-badge">write</span> Copies the command, and its test when present, into the plugin's <code>commands/</code> folder and adds it to that plugin's <code>plugin.json</code>. The manifest is validated before and after the change, and every copied file is removed again if any step fails.</p>
+<p>Run <code>total-recall composable-cli promote &lt;name&gt; --to-plugin &lt;dir&gt; --json</code>.</p>
+<dl data-design-component="field-list">
+<dt>ok</dt><dd>True when the plugin manifest now declares the command.</dd>
+<dt>name, plugin</dt><dd>The promoted command and the receiving plugin's id.</dd>
+<dt>handler</dt><dd>The new handler path inside the plugin, <code>commands/&lt;name&gt;.mjs</code>.</dd>
+<dt>risk</dt><dd>The carried risk class.</dd>
+</dl>
+<p>Only registered inline commands whose source still matches the recorded digest, with risk <code>read</code> or <code>write</code>, can be promoted. A name the plugin already declares is refused.</p>
+</section>

package/scaffold/.agent/skills/total-recall/plugins/composable-cli/ui/chunks/read.md

@@ -0,0 +1,25 @@
+---
+type: ui-chunk:chunk
+plugin: composable-cli
+id: read
+title: Command source
+description: Prints the source of one composed command as plain text.
+timestamp: '2026-11-08T08:12:00Z'
+intents:
+  - Read a composed command's source code
+surfaces: [page]
+operations: [read]
+---
+<section data-design-component="op-sheet">
+<style>
+[data-design-component="op-sheet"]{background:var(--color-surface);color:var(--color-text);font-family:var(--typography-body-font-family);font-size:var(--typography-body-font-size);line-height:var(--typography-body-line-height);border-radius:var(--radius-lg);padding:var(--spacing-lg)}
+[data-design-component="op-sheet"] h2{font-family:var(--typography-title-font-family);font-size:var(--typography-title-font-size);font-weight:var(--typography-title-font-weight);margin:0 0 var(--spacing-sm)}
+[data-design-component="op-sheet"] p{margin:0 0 var(--spacing-md)}
+[data-design-component="risk-badge"]{font-family:var(--typography-label-font-family);font-size:var(--typography-label-font-size);font-weight:var(--typography-label-font-weight);letter-spacing:var(--typography-label-letter-spacing);text-transform:uppercase;border-radius:var(--radius-sm);padding:2px var(--spacing-xs);color:var(--color-ok);background:var(--color-ok-soft)}
+code{font-family:var(--typography-code-font-family)}
+</style>
+<h2>Command source</h2>
+<p><span data-design-component="risk-badge">read</span> Prints one composed command's source file exactly as stored. It has no JSON form.</p>
+<p>Run <code>total-recall composable-cli read &lt;name&gt;</code>, adding <code>--global</code> or <code>--group &lt;id&gt;</code> for those scopes. It fails with a clear message when the command does not exist in that scope.</p>
+<p>For the source together with its registry record, use <code>show</code>.</p>
+</section>

package/scaffold/.agent/skills/total-recall/plugins/composable-cli/ui/chunks/remove.md

@@ -0,0 +1,26 @@
+---
+type: ui-chunk:chunk
+plugin: composable-cli
+id: remove
+title: Remove a command
+description: Deletes a composed command's source file and its registry record from one scope.
+timestamp: '2026-11-08T08:12:00Z'
+intents:
+  - Delete a composed command that is no longer needed
+surfaces: [page]
+operations: [remove]
+panel: home
+---
+<section data-design-component="op-sheet">
+<style>
+[data-design-component="op-sheet"]{background:var(--color-surface);color:var(--color-text);font-family:var(--typography-body-font-family);font-size:var(--typography-body-font-size);line-height:var(--typography-body-line-height);border-radius:var(--radius-lg);padding:var(--spacing-lg)}
+[data-design-component="op-sheet"] h2{font-family:var(--typography-title-font-family);font-size:var(--typography-title-font-size);font-weight:var(--typography-title-font-weight);margin:0 0 var(--spacing-sm)}
+[data-design-component="op-sheet"] p{margin:0 0 var(--spacing-md)}
+[data-design-component="risk-badge"]{font-family:var(--typography-label-font-family);font-size:var(--typography-label-font-size);font-weight:var(--typography-label-font-weight);letter-spacing:var(--typography-label-letter-spacing);text-transform:uppercase;border-radius:var(--radius-sm);padding:2px var(--spacing-xs);color:var(--color-danger);background:var(--color-danger-soft)}
+code{font-family:var(--typography-code-font-family)}
+</style>
+<h2>Remove a command</h2>
+<p><span data-design-component="risk-badge">destructive</span> Deletes the command's source and its registry record from the selected scope, then refreshes the command inventories. Saved history snapshots stay on disk.</p>
+<p>Run <code>total-recall composable-cli remove &lt;name&gt;</code>, adding <code>--global</code> or <code>--group &lt;id&gt;</code> for those scopes. It confirms in plain text and fails when the command does not exist there.</p>
+<p>In the CmdSmith Home, Remove asks for a second, confirming click before anything is deleted.</p>
+</section>

package/scaffold/.agent/skills/total-recall/plugins/composable-cli/ui/chunks/rollback.md

@@ -0,0 +1,26 @@
+---
+type: ui-chunk:chunk
+plugin: composable-cli
+id: rollback
+title: Roll back a command
+description: Restores a saved earlier version of a composed command, snapshotting the current one first and raising the registry version.
+timestamp: '2026-11-08T08:12:00Z'
+intents:
+  - Roll back a composed command to an earlier version
+surfaces: [page]
+operations: [rollback]
+panel: home
+---
+<section data-design-component="op-sheet">
+<style>
+[data-design-component="op-sheet"]{background:var(--color-surface);color:var(--color-text);font-family:var(--typography-body-font-family);font-size:var(--typography-body-font-size);line-height:var(--typography-body-line-height);border-radius:var(--radius-lg);padding:var(--spacing-lg)}
+[data-design-component="op-sheet"] h2{font-family:var(--typography-title-font-family);font-size:var(--typography-title-font-size);font-weight:var(--typography-title-font-weight);margin:0 0 var(--spacing-sm)}
+[data-design-component="op-sheet"] p{margin:0 0 var(--spacing-md)}
+[data-design-component="risk-badge"]{font-family:var(--typography-label-font-family);font-size:var(--typography-label-font-size);font-weight:var(--typography-label-font-weight);letter-spacing:var(--typography-label-letter-spacing);text-transform:uppercase;border-radius:var(--radius-sm);padding:2px var(--spacing-xs);color:var(--color-warn);background:var(--color-warn-soft)}
+code{font-family:var(--typography-code-font-family)}
+</style>
+<h2>Roll back a command</h2>
+<p><span data-design-component="risk-badge">write</span> Copies a saved version back over the command's source. The version being replaced is saved first, so a rollback can itself be undone. The registry version goes up by one and its code digest is recomputed.</p>
+<p>Run <code>total-recall composable-cli rollback &lt;name&gt; &lt;version&gt;</code>, with the version as a plain number from <code>history</code>, adding <code>--global</code> or <code>--group &lt;id&gt;</code> for those scopes. It confirms in plain text and fails when that version was never saved.</p>
+<p>In the CmdSmith Home, each saved version in the inspector has its own rollback button. Nothing is rolled back until you select one.</p>
+</section>

package/scaffold/.agent/skills/total-recall/plugins/composable-cli/ui/chunks/show.md

@@ -0,0 +1,53 @@
+---
+type: ui-chunk:chunk
+plugin: composable-cli
+id: show
+title: Command record
+description: Shows a composed command's registry record (version, risk, scope, author, dates, digest) together with its source.
+timestamp: '2026-11-08T08:12:00Z'
+intents:
+  - Inspect a composed command before running it
+  - Confirm a command's version, risk and code digest
+surfaces: [page]
+operations: [show]
+data:
+  - show:/registry
+  - show:/registry/name
+  - show:/registry/scope
+  - show:/registry/risk
+  - show:/registry/version
+  - show:/registry/author
+  - show:/registry/created
+  - show:/registry/updated
+  - show:/registry/description
+  - show:/registry/background_allowed
+  - show:/registry/code_sha256
+  - show:/registry/source
+  - show:/code
+panel: home
+---
+<section data-design-component="op-sheet">
+<style>
+[data-design-component="op-sheet"]{background:var(--color-surface);color:var(--color-text);font-family:var(--typography-body-font-family);font-size:var(--typography-body-font-size);line-height:var(--typography-body-line-height);border-radius:var(--radius-lg);padding:var(--spacing-lg)}
+[data-design-component="op-sheet"] h2{font-family:var(--typography-title-font-family);font-size:var(--typography-title-font-size);font-weight:var(--typography-title-font-weight);margin:0 0 var(--spacing-sm)}
+[data-design-component="op-sheet"] p{margin:0 0 var(--spacing-md)}
+[data-design-component="risk-badge"]{font-family:var(--typography-label-font-family);font-size:var(--typography-label-font-size);font-weight:var(--typography-label-font-weight);letter-spacing:var(--typography-label-letter-spacing);text-transform:uppercase;border-radius:var(--radius-sm);padding:2px var(--spacing-xs);color:var(--color-ok);background:var(--color-ok-soft)}
+[data-design-component="field-list"]{color:var(--color-muted);font-family:var(--typography-code-font-family);font-size:var(--typography-code-font-size);margin:0}
+[data-design-component="field-list"] dt{color:var(--color-text)}
+[data-design-component="field-list"] dd{margin:0 0 var(--spacing-sm);font-family:var(--typography-body-font-family)}
+code{font-family:var(--typography-code-font-family)}
+</style>
+<h2>Command record</h2>
+<p><span data-design-component="risk-badge">read</span> The registry record and source of one composed command. Nothing runs.</p>
+<p>Run <code>total-recall composable-cli show &lt;name&gt; --json</code>, adding <code>--global</code> or <code>--group &lt;id&gt;</code> for those scopes. The CmdSmith Home opens this when you select a command.</p>
+<dl data-design-component="field-list">
+<dt>registry</dt><dd>The command's <code>cli_command</code> record, or null when the source file has no record beside it.</dd>
+<dt>registry.version</dt><dd>Starts at 1 and goes up by one on every update or rollback.</dd>
+<dt>registry.risk, registry.scope</dt><dd>The declared risk class and the scope the record was written for.</dd>
+<dt>registry.author, registry.created, registry.updated</dt><dd>Who registered it and when it was first and last written.</dd>
+<dt>registry.source</dt><dd><code>inline</code>, <code>from-plugin</code> or <code>config-for-skill</code>.</dd>
+<dt>registry.background_allowed</dt><dd>Whether the command may run in the background.</dd>
+<dt>registry.code_sha256</dt><dd>SHA-256 of the source at the last registry write; compare it with the code to spot hand edits.</dd>
+<dt>code</dt><dd>The command's full source.</dd>
+</dl>
+</section>

package/scaffold/.agent/skills/total-recall/plugins/composable-cli/ui/chunks/status.md

@@ -0,0 +1,40 @@
+---
+type: ui-chunk:chunk
+plugin: composable-cli
+id: status
+title: Plugin status
+description: Shows which Composable CLI operations are implemented and where project and global composed commands are stored.
+timestamp: '2026-11-08T08:12:00Z'
+intents:
+  - Check which Composable CLI operations are implemented
+  - Find where composed commands are stored
+surfaces: [page]
+operations: [status]
+data:
+  - status:/plugin
+  - status:/implemented
+  - status:/scope/project
+  - status:/scope/global
+panel: home
+---
+<section data-design-component="op-sheet">
+<style>
+[data-design-component="op-sheet"]{background:var(--color-surface);color:var(--color-text);font-family:var(--typography-body-font-family);font-size:var(--typography-body-font-size);line-height:var(--typography-body-line-height);border-radius:var(--radius-lg);padding:var(--spacing-lg)}
+[data-design-component="op-sheet"] h2{font-family:var(--typography-title-font-family);font-size:var(--typography-title-font-size);font-weight:var(--typography-title-font-weight);margin:0 0 var(--spacing-sm)}
+[data-design-component="op-sheet"] p{margin:0 0 var(--spacing-md)}
+[data-design-component="risk-badge"]{font-family:var(--typography-label-font-family);font-size:var(--typography-label-font-size);font-weight:var(--typography-label-font-weight);letter-spacing:var(--typography-label-letter-spacing);text-transform:uppercase;border-radius:var(--radius-sm);padding:2px var(--spacing-xs);color:var(--color-ok);background:var(--color-ok-soft)}
+[data-design-component="field-list"]{color:var(--color-muted);font-family:var(--typography-code-font-family);font-size:var(--typography-code-font-size);margin:0}
+[data-design-component="field-list"] dt{color:var(--color-text)}
+[data-design-component="field-list"] dd{margin:0 0 var(--spacing-sm);font-family:var(--typography-body-font-family)}
+code{font-family:var(--typography-code-font-family)}
+</style>
+<h2>Plugin status</h2>
+<p><span data-design-component="risk-badge">read</span> Reports what this plugin can do on this machine. It changes nothing.</p>
+<p>Run <code>total-recall composable-cli status --json</code>. The CmdSmith Home reads it on open.</p>
+<dl data-design-component="field-list">
+<dt>plugin</dt><dd>The plugin id, <code>composable-cli</code>.</dd>
+<dt>implemented</dt><dd>Every operation this build answers, including <code>status</code>.</dd>
+<dt>scope.project</dt><dd>The project folder for composed commands: <code>.agent/commands</code> under the current repository.</dd>
+<dt>scope.global</dt><dd>The machine-wide folder, <code>~/.agent/commands</code>. Absent when no home folder is set.</dd>
+</dl>
+</section>

package/scaffold/.agent/skills/total-recall/plugins/composable-cli/ui/chunks/test-path.md

@@ -0,0 +1,38 @@
+---
+type: ui-chunk:chunk
+plugin: composable-cli
+id: test-path
+title: Find a command's test
+description: Locates a composed command's test file in its scope without running it.
+timestamp: '2026-11-08T08:12:00Z'
+intents:
+  - Check whether a composed command has a test before running it
+surfaces: [page]
+operations: [test-path]
+data:
+  - test-path:/ok
+  - test-path:/name
+  - test-path:/scope
+  - test-path:/testFile
+---
+<section data-design-component="op-sheet">
+<style>
+[data-design-component="op-sheet"]{background:var(--color-surface);color:var(--color-text);font-family:var(--typography-body-font-family);font-size:var(--typography-body-font-size);line-height:var(--typography-body-line-height);border-radius:var(--radius-lg);padding:var(--spacing-lg)}
+[data-design-component="op-sheet"] h2{font-family:var(--typography-title-font-family);font-size:var(--typography-title-font-size);font-weight:var(--typography-title-font-weight);margin:0 0 var(--spacing-sm)}
+[data-design-component="op-sheet"] p{margin:0 0 var(--spacing-md)}
+[data-design-component="risk-badge"]{font-family:var(--typography-label-font-family);font-size:var(--typography-label-font-size);font-weight:var(--typography-label-font-weight);letter-spacing:var(--typography-label-letter-spacing);text-transform:uppercase;border-radius:var(--radius-sm);padding:2px var(--spacing-xs);color:var(--color-ok);background:var(--color-ok-soft)}
+[data-design-component="field-list"]{color:var(--color-muted);font-family:var(--typography-code-font-family);font-size:var(--typography-code-font-size);margin:0}
+[data-design-component="field-list"] dt{color:var(--color-text)}
+[data-design-component="field-list"] dd{margin:0 0 var(--spacing-sm);font-family:var(--typography-body-font-family)}
+code{font-family:var(--typography-code-font-family)}
+</style>
+<h2>Find a command's test</h2>
+<p><span data-design-component="risk-badge">read</span> Confirms that <code>&lt;name&gt;.test.mjs</code> is a regular file inside the command's own scope folder. It does not run the test.</p>
+<p>Run <code>total-recall composable-cli test-path &lt;name&gt; --json</code>, adding <code>--global</code> or <code>--group &lt;id&gt;</code> for those scopes.</p>
+<dl data-design-component="field-list">
+<dt>ok</dt><dd>True when the test file was found.</dd>
+<dt>name, scope</dt><dd>The command and scope that were checked.</dd>
+<dt>testFile</dt><dd>The test file's full path.</dd>
+</dl>
+<p>A missing file, a link or a file outside the scope folder returns <code>{ ok: false, error }</code>.</p>
+</section>