@iowarp/clio-coder 0.3.0 → 0.3.1

package/docs/glossary.md

@@ -8,39 +8,39 @@ This document defines core architectural concepts and terminology used throughou
 
 ### 1. Assignment
 - **Definition**: The logical unit of work dispatched to the fleet. An assignment encapsulates the requested task, briefing, authority boundaries, and retry history across one or more concrete run attempts.
-- **Owning Type**: `AssignmentRecord` in `src/domains/dispatch/types.ts`.
+- **Owning Type**: `DurableAssignmentRecord` in `src/domains/dispatch/assignment-store.ts`.
 
 ### 2. Run
 - **Definition**: A concrete execution attempt of an assignment. Every run possesses a unique UUIDv7 identifier, an isolated event stream, a designated execution node, and a final cryptographically sealed receipt.
-- **Owning Type**: `RunRecord` in `src/domains/dispatch/types.ts`.
+- **Owning Type**: `RunEnvelope` in `src/domains/dispatch/types.ts`.
 
 ### 3. Attempt
-- **Definition**: A 1-based sequential retry index of a logical assignment. When a run fails due to retriable infrastructure errors, a new attempt is created while preserving historical attempt records.
-- **Owning Type**: `AssignmentAttemptRecord` in `src/domains/dispatch/types.ts`.
+- **Definition**: A 0-based sequential retry index of a logical assignment. The first run of an assignment is attempt 0; a retry after a retriable infrastructure error increments it while preserving the earlier attempt's own run and receipt.
+- **Owning Type**: `RunLineage.attempt` in `src/domains/dispatch/types.ts`.
 
 ### 4. Batch
 - **Definition**: A durable collection of detached assignments created and tracked together under a single batch ID (`batches.json`).
-- **Owning Type**: `BatchRecord` in `src/domains/dispatch/types.ts`.
+- **Owning Type**: `DetachedBatchRecord` in `src/domains/dispatch/batch-store.ts`.
 
 ### 5. Plan
 - **Definition**: A multi-step directed acyclic graph (DAG) defining steps, dependencies, code validations, and budget ceilings approved by the operator before dispatch.
-- **Owning Type**: `ExecutionPlan` in `src/domains/dispatch/types.ts`.
+- **Owning Type**: `ExecutionPlan` in `src/domains/dispatch/execution-plan.ts`.
 
 ### 6. Receipt
 - **Definition**: An immutable, cryptographically sealed record of a completed run containing full execution facts, tool telemetry, token accounting, validation grounding, and outcome codes.
-- **Owning Type**: `RunReceiptV15` in `src/domains/dispatch/types.ts` (`RUN_RECEIPT_INTEGRITY_VERSION = 15`).
+- **Owning Type**: `RunReceipt` in `src/domains/dispatch/types.ts` (`RUN_RECEIPT_INTEGRITY_VERSION = 15`).
 
 ### 7. Envelope
-- **Definition**: A bounded container enforcing byte-length limits, truncation indicators, and SHA-256 provenance on dynamic payloads (e.g. parent briefings and tool outputs).
-- **Owning Type**: `ObservationEnvelope` in `src/tools/observation.ts`.
+- **Definition**: A bounded container enforcing byte-length limits and truncation indicators on a dynamic payload. Tool output carries shown and total byte counts plus a continuation fragment; a parent briefing carries byte count and SHA-256 content hash instead.
+- **Owning Type**: `Observation` in `src/tools/observation.ts` for tool output; `RunBriefingProvenance` in `src/domains/dispatch/types.ts` for briefings.
 
 ### 8. Phase
-- **Definition**: A designated execution interval within a run (such as `warmup`, `prompt`, `tool_execution`, or `finalize`) recorded in the trace store.
-- **Owning Type**: `PhaseRecord` in `src/domains/observability/trace-store.ts`.
+- **Definition**: A designated execution interval within a run. Every trace event and spend row is keyed to one `phaseId`, and the `phases` table is opened alongside `runs` for each operator turn.
+- **Owning Type**: `TraceEventInput.phaseId` and the `phases` table in `src/domains/observability/trace-store.ts`.
 
 ### 9. Gate
 - **Definition**: A validation or review barrier (such as a read-only reviewer verdict or a compete judge decision) determining whether candidate diffs are merged or revised.
-- **Owning Type**: `GateDecision` in `src/domains/dispatch/types.ts`.
+- **Owning Type**: `GateDecisionArtifact` in `src/domains/dispatch/gate-decisions.ts`.
 
 ### 10. Recipe
 - **Definition**: A versioned Markdown document declaring an agent's static persona, tool profile, execution capability class, cost ceilings, and result contracts.
@@ -60,7 +60,7 @@ This document defines core architectural concepts and terminology used throughou
 
 ### 14. Route
 - **Definition**: An exact execution tuple composed of `{ agent, target, model, node }` evaluated by the active route planner for capability fit and cost readiness.
-- **Owning Type**: `RouteTuple` in `src/domains/dispatch/types.ts`.
+- **Owning Type**: `RouteCandidate` in `src/domains/dispatch/route-decision.ts`.
 
 ### 15. Posture (Autonomy Level)
 - **Definition**: The active safety permission level governing tool mutation authority (`read-only`, `suggest`, `auto-edit`, `full-auto`).
@@ -71,5 +71,97 @@ This document defines core architectural concepts and terminology used throughou
 - **Owning Type**: `AgentCapabilityClass` in `src/domains/agents/spec.ts`.
 
 ### 17. Topology
-- **Definition**: The multi-agent structural orchestration pattern governing workflow execution (`singular`, `parallel`, `sequential`, `pipeline`, `detached`, `review`, `compete`, `auto`).
-- **Owning Type**: `DispatchTopology` in `src/domains/dispatch/types.ts`.
+- **Definition**: The multi-agent structural orchestration pattern governing workflow execution. Three unions spell it for three different jobs and their value sets differ: `parallel`, `sequential`, `pipeline`, `review`, `compete`, and `fleet` in a compiled plan; the same set with `detached` and without `fleet` for a capacity reservation; both plus `detached` and `fleet` at the tool surface. The operator-facing argument is spelled `mode`, and `singular` (the one-task call shape) and `auto` are values of that argument, not topologies.
+- **Owning Types**: `ExecutionPlanTopology` in `src/domains/dispatch/execution-plan.ts`, `ReservationTopology` in `src/domains/dispatch/reservation-store.ts`, `DispatchPlanTopology` in `src/tools/dispatch-plan.ts`.
+
+### 18. Worker Block
+- **Definition**: The attributed transcript segment rendering a worker's streaming execution. It includes a header with origin glyph and route, a rail for worker prose, coalesced tool names, and a one-line receipt footer.
+- **Owning Type**: `WorkerEntryState` in `src/interactive/worker-stream.ts`.
+
+### 19. Origin Glyphs (`◇`/`◆`)
+- **Definition**: Transcript and fleet board indicators that identify who requested a run. The glyph `◇` marks operator-typed runs, `◆` marks model-requested dispatches, and a dim dot marks internal Clio runs.
+- **Owning Type**: `WorkerRunOrigin` in `src/domains/session/entries.ts`.
+
+### 20. Share Note
+- **Definition**: A bounded operator note formatted as `[worker result] <agent> · run <id> · <outcome> · shared by the operator` that delivers a finished worker answer into the main agent context over the user-turn path.
+- **Owning Type**: `WorkerShareFacts` in `src/interactive/worker-share.ts`.
+
+### 21. Fold
+- **Definition**: Collapsing an expanded tool call or worker block down to a single-line summary row. Toggled for the newest foldable item with `Alt+O` or for all items with `Ctrl+Alt+O` / `Alt+Shift+O`.
+- **Owning Type**: `WorkerEntryRenderOptions` in `src/interactive/renderers/worker-entry.ts`.
+
+### 22. Interop
+- **Definition**: The domain governing discovery, compatibility roots, and delegation wiring for other coding agents installed on the local machine and in the repository.
+- **Owning Type**: `InteropContract` in `src/domains/interop/contract.ts`.
+
+### 23. Consent Record
+- **Definition**: A persistent state entry recording the operator's decision to accept or decline an interop agent proposal, written atomically under `interop.json`.
+- **Owning Type**: `InteropAgentRecord` in `src/domains/interop/types.ts`.
+
+### 24. Fingerprint
+- **Definition**: A SHA-256 digest of stable agent facts (including binary path, version, and launch recipe) that keys consent records so standing decisions stay valid until facts change.
+- **Owning Type**: `InteropAgentFacts` in `src/domains/interop/types.ts`.
+
+### 25. noWritePaths
+- **Definition**: A damage-control path policy class that permits reads while blocking writes and deletes under every registered foreign agent directory across all autonomy levels.
+- **Owning Type**: `PathPolicyKind` in `src/domains/safety/path-policy.ts`.
+
+### 26. Foreign Prompt Root
+- **Definition**: An external prompt directory owned by another coding agent (such as `.claude/commands` or `.codex/prompts`) from which Clio loads prompt templates.
+- **Owning Type**: `PromptTemplateRoot` in `src/domains/resources/prompts/loader.ts`.
+
+### 27. Compat Root
+- **Definition**: A compatibility directory for prompts or skills discovered from foreign agent installations, ranked below native Clio resource roots.
+- **Owning Type**: `ResourceSourceInfo` in `src/domains/resources/collision.ts`.
+
+### 28. Trust Gate
+- **Definition**: A security boundary requiring explicit operator opt-in via `skills.trustProjectCompatRoots` before prompt templates or skills from project-scope foreign roots can execute or expand.
+- **Owning Type**: `PromptTemplate` in `src/domains/resources/prompts/loader.ts`.
+
+### 29. Fleet
+- **Definition**: The set of addressable nodes Clio may place work on, `local` plus every configured SSH host, together with their capacity accounting. `fleet` is also the topology of a plan compiled from a fleet contract.
+- **Owning Types**: `FleetNodeSnapshot` in `src/domains/scheduling/cluster.ts` for capacity; `FleetContract` in `src/domains/agents/fleet-contract.ts` for the declared multi-step workflow.
+
+### 30. Dispatch
+- **Definition**: Sending one unit of work to a worker: the domain that resolves recipe, target, model, and node, admits the request against authority, spawns the worker, and seals the receipt. It is the `dispatch` tool, the `/run` slash command, and `src/domains/dispatch/`.
+- **Owning Type**: `DispatchRequest` in `src/domains/dispatch/contract.ts`.
+
+### 31. Run Ledger
+- **Definition**: The durable dispatch run list at `runs.json` in the state directory, retention-capped by `guardrails.maxDispatchRuns`. It is what the fleet board, `clio-coder runs`, and eval linking read.
+- **Owning Type**: `RunEnvelope` in `src/domains/dispatch/types.ts`, persisted by `src/domains/dispatch/state.ts`.
+
+### 32. Agent Ledger
+- **Definition**: The append-only progress log a worker writes for itself through the `ledger` tool, mirrored to the orchestrator over the control lane and persisted in `agent-ledgers.json`. Live subscribers are tracked in memory by the ledger hub.
+- **Owning Type**: `AgentLedgerEntry` in `src/worker/protocol.ts`, stored by `src/domains/dispatch/agent-ledger-store.ts`.
+
+### 33. Session Ledger
+- **Definition**: The JSONL record of one session's turns, written per session and referenced by eval artifacts as `sessionLedgers`. It is what `/resume`, `/fork`, and replay read.
+- **Owning Type**: `SessionEntry` in `src/domains/session/entries.ts`.
+
+### 34. Task Ledger
+- **Definition**: The persisted form of the session task board: goals, subgoals, and the run ids in flight when the snapshot was folded. One session entry kind, distinct from the board that renders it.
+- **Owning Type**: `TaskLedgerEntry` in `src/domains/session/entries.ts`.
+
+### 35. Context Ledger
+- **Definition**: The accounting of how the model's context window is spent, bucketed into system, tools, agents, skills, memory, and the rest, and the input to compaction decisions.
+- **Owning Type**: `ContextLedgerCategory` in `src/domains/session/context-ledger.ts`.
+
+### 36. Dispatch Board
+- **Definition**: The live fleet view: one row per in-flight or recently finished run, carrying origin glyph, route, status, and the steer and cancel affordances.
+- **Owning Type**: `DispatchBoardRow` in `src/interactive/dispatch-board.ts`.
+
+### 37. Task Board
+- **Definition**: The operator-facing goal and subgoal checklist for the session. It renders from a snapshot and persists as a task ledger entry, so the UI noun and the wire format are deliberately named differently.
+- **Owning Type**: `TaskBoardSnapshot` in `src/domains/session/task-board.ts`.
+
+### 38. Dashboard
+- **Definition**: The startup and footer panels summarizing targets, session, and spend. Not a board in the dispatch or task sense; it holds no rows a run or a goal maps to.
+- **Owning Type**: `WelcomeDashboardStats` in `src/interactive/welcome-dashboard.ts`.
+
+### 39. Handbook
+- **Definition**: `CLIO-CODER.md`, the human-owned, version-controlled project context file at the repository root: project name, one-line description, conventions, hard invariants, and optional sections, closed by a fingerprint comment.
+- **Owning Type**: `ParsedClioMd` in `src/domains/context/clio-md.ts`.
+
+### 40. Delegate
+- **Definition**: Another coding agent Clio drives over ACP stdio as if it were a worker, configured under `delegation.agents` and invoked with `/delegate`. A delegate is a foreign harness, not a model target.
+- **Owning Type**: `DelegationAgentConfig` in `src/core/defaults.ts`.

package/docs/html/agents_blueprint.html

@@ -3,7 +3,7 @@
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Clio Coder Agent Fleet Blueprint (v0.3.0)</title>
+  <title>Clio Coder Agent Fleet Blueprint (v0.3.1)</title>
   
   <style>
     :root {
@@ -439,7 +439,7 @@
         </div>
       </div>
       <div class="header-right">
-        <span class="version-badge">Clio Coder v0.3.0</span>
+        <span class="version-badge">Clio Coder v0.3.1</span>
         <a href="index.html" class="back-btn">
           <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><title>Icon</title><line x1="19" y1="12" x2="5" y2="12"></line><polyline points="12 19 5 12 12 5"></polyline></svg>
           Dashboard Hub
@@ -701,7 +701,7 @@
     </main>
 
     <footer>
-      <p>Clio Coder Agent Catalog spec &bull; Version 0.3.0</p>
+      <p>Clio Coder Agent Catalog spec &bull; Version 0.3.1</p>
     </footer>
   </div>
 

package/docs/html/alcf_blueprint.html

@@ -3,7 +3,7 @@
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>ALCF Inference Provider Blueprint (v0.3.0)</title>
+  <title>ALCF Inference Provider Blueprint (v0.3.1)</title>
   <link rel="stylesheet" href="shared.css">
   <style>
     /* Flow diagram custom styles */
@@ -98,7 +98,7 @@
         </div>
       </div>
       <div class="header-right">
-        <span class="version-badge">Clio Coder v0.3.0</span>
+        <span class="version-badge">Clio Coder v0.3.1</span>
         <a href="index.html" class="back-btn">
           <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><title>Icon</title><line x1="19" y1="12" x2="5" y2="12"></line><polyline points="12 19 5 12 12 5"></polyline></svg>
           Dashboard Hub
@@ -256,7 +256,7 @@
     </div>
 
     <footer>
-      <p>Clio Coder ALCF Inference Blueprint &bull; Version 0.3.0 &bull; Gnosis Research Center</p>
+      <p>Clio Coder ALCF Inference Blueprint &bull; Version 0.3.1 &bull; Gnosis Research Center</p>
     </footer>
   </div>
 

package/docs/html/architecture_blueprint.html

@@ -3,7 +3,7 @@
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Clio Coder Architecture Blueprint (v0.3.0)</title>
+  <title>Clio Coder Architecture Blueprint (v0.3.1)</title>
   
   <style>
     :root {
@@ -440,7 +440,7 @@
         </div>
       </div>
       <div class="header-right">
-        <span class="version-badge">Clio Coder v0.3.0</span>
+        <span class="version-badge">Clio Coder v0.3.1</span>
         <a href="index.html" class="back-btn">
           <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><title>Icon</title><line x1="19" y1="12" x2="5" y2="12"></line><polyline points="12 19 5 12 12 5"></polyline></svg>
           Dashboard Hub
@@ -675,7 +675,7 @@ npm run build                # compile build package</code></pre>
     </main>
 
     <footer>
-      <p>Clio Coder Architecture Spec Dashboard &bull; Version 0.3.0</p>
+      <p>Clio Coder Architecture Spec Dashboard &bull; Version 0.3.1</p>
     </footer>
   </div>
 

package/docs/html/commands_blueprint.html

@@ -3,7 +3,7 @@
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Clio Coder Commands &amp; Modes Blueprint (v0.3.0)</title>
+  <title>Clio Coder Commands &amp; Modes Blueprint (v0.3.1)</title>
   
   <style>
     :root {
@@ -453,7 +453,7 @@
         </div>
       </div>
       <div class="header-right">
-        <span class="version-badge">Clio Coder v0.3.0</span>
+        <span class="version-badge">Clio Coder v0.3.1</span>
         <a href="index.html" class="back-btn">
           <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><title>Icon</title><line x1="19" y1="12" x2="5" y2="12"></line><polyline points="12 19 5 12 12 5"></polyline></svg>
           Dashboard Hub
@@ -540,6 +540,22 @@
         <p>Alt bindings represent the main navigation channel. In macOS terminals, ensure Meta is set to Option.</p>
         
         <div class="key-grid">
+          <div class="key-card">
+            <span>Send prompt / Steer active run</span>
+            <span class="kbd-tag">Enter</span>
+          </div>
+          <div class="key-card">
+            <span>Insert newline in draft</span>
+            <span class="kbd-tag">Shift+Enter / Ctrl+J</span>
+          </div>
+          <div class="key-card">
+            <span>Queue after-run follow-up</span>
+            <span class="kbd-tag">Alt+Enter</span>
+          </div>
+          <div class="key-card">
+            <span>Restore queued messages to editor</span>
+            <span class="kbd-tag">Alt+Up</span>
+          </div>
           <div class="key-card">
             <span>Cycle thinking levels</span>
             <span class="kbd-tag">Shift+Tab</span>
@@ -565,12 +581,32 @@
             <span class="kbd-tag">Alt+W</span>
           </div>
           <div class="key-card">
-            <span>Steer active stream from editor</span>
-            <span class="kbd-tag">Enter</span>
+            <span>Send dispatch to background</span>
+            <span class="kbd-tag">Alt+S / Ctrl+Alt+B</span>
           </div>
           <div class="key-card">
-            <span>Queue after-run follow-up</span>
-            <span class="kbd-tag">Alt+Enter</span>
+            <span>Toggle tool segment body</span>
+            <span class="kbd-tag">Alt+O / Ctrl+Alt+O</span>
+          </div>
+          <div class="key-card">
+            <span>Toggle live tool output</span>
+            <span class="kbd-tag">Alt+P</span>
+          </div>
+          <div class="key-card">
+            <span>Toggle thinking blocks</span>
+            <span class="kbd-tag">Alt+R / Ctrl+Alt+R</span>
+          </div>
+          <div class="key-card">
+            <span>Open external editor</span>
+            <span class="kbd-tag">Alt+G</span>
+          </div>
+          <div class="key-card">
+            <span>Dismiss footer notifications</span>
+            <span class="kbd-tag">Alt+X</span>
+          </div>
+          <div class="key-card">
+            <span>Leader key fallback for Alt</span>
+            <span class="kbd-tag">Ctrl+G</span>
           </div>
         </div>
 
@@ -578,6 +614,7 @@
         <table class="ref-table">
           <thead>
             <tr>
+              <th>Group</th>
               <th>Command</th>
               <th>Usage</th>
               <th>Purpose</th>
@@ -585,62 +622,168 @@
           </thead>
           <tbody>
             <tr>
-              <td><code>/quit</code></td>
-              <td><code>/quit</code></td>
-              <td>Exit Clio Coder</td>
+              <td><span class="badge">Run</span></td>
+              <td><code>/run</code></td>
+              <td><code>/run &lt;agent&gt; &lt;task&gt;</code></td>
+              <td>Run a fleet agent locally or on remote node</td>
             </tr>
             <tr>
-              <td><code>/help</code></td>
-              <td><code>/help [query]</code></td>
-              <td>Open interactive help center and key reference</td>
+              <td><span class="badge">Run</span></td>
+              <td><code>/delegate</code></td>
+              <td><code>/delegate &lt;agent-id&gt; &lt;task&gt;</code></td>
+              <td>Run an ACP delegation agent</td>
             </tr>
             <tr>
-              <td><code>/settings</code></td>
-              <td><code>/settings</code></td>
-              <td>Open interactive full-screen Settings Center</td>
+              <td><span class="badge">Run</span></td>
+              <td><code>/agents</code></td>
+              <td><code>/agents</code></td>
+              <td>List Clio agents and ACP delegation agents</td>
             </tr>
             <tr>
+              <td><span class="badge">Run</span></td>
               <td><code>/targets</code></td>
               <td><code>/targets</code></td>
-              <td>Manage target connections, health check, and live probes</td>
+              <td>Open Settings → Targets console: health, use, connect, probe, remove</td>
+            </tr>
+            <tr>
+              <td><span class="badge">Inspect</span></td>
+              <td><code>/cost</code></td>
+              <td><code>/cost</code></td>
+              <td>Show session token and cost totals</td>
             </tr>
             <tr>
+              <td><span class="badge">Inspect</span></td>
+              <td><code>/context</code></td>
+              <td><code>/context [compact|init|refresh|reset]</code></td>
+              <td>Context hub: window ledger overlay plus compact, init, refresh, reset</td>
+            </tr>
+            <tr>
+              <td><span class="badge">Inspect</span></td>
+              <td><code>/fleet</code></td>
+              <td><code>/fleet</code></td>
+              <td>Open Settings → Fleet workbench: defaults, profiles, agent routes, nodes</td>
+            </tr>
+            <tr>
+              <td><span class="badge">Inspect</span></td>
+              <td><code>/tasks</code></td>
+              <td><code>/tasks</code></td>
+              <td>Show session task board tracked with tasks tool</td>
+            </tr>
+            <tr>
+              <td><span class="badge">Inspect</span></td>
+              <td><code>/memory</code></td>
+              <td><code>/memory [seed]</code></td>
+              <td>Inspect task memory or seed from newest handoff</td>
+            </tr>
+            <tr>
+              <td><span class="badge">Inspect</span></td>
+              <td><code>/view</code></td>
+              <td><code>/view [filter] | /view verify &lt;runId&gt;</code></td>
+              <td>Browse artifacts and verify receipt integrity</td>
+            </tr>
+            <tr>
+              <td><span class="badge">Configure</span></td>
+              <td><code>/settings</code></td>
+              <td><code>/settings [section]</code></td>
+              <td>Open interactive transactional Settings Center</td>
+            </tr>
+            <tr>
+              <td><span class="badge">Configure</span></td>
+              <td><code>/thinking</code></td>
+              <td><code>/thinking [level]</code></td>
+              <td>Set chat thinking level or open Settings → Orchestrator</td>
+            </tr>
+            <tr>
+              <td><span class="badge">Configure</span></td>
+              <td><code>/output</code></td>
+              <td><code>/output [verbosity]</code></td>
+              <td>Set transcript detail (minimal, default, verbose) or open Settings → Terminal</td>
+            </tr>
+            <tr>
+              <td><span class="badge">Configure</span></td>
               <td><code>/model</code></td>
               <td><code>/model [pattern]</code></td>
-              <td>Open model selector or set a model from the live/catalog list</td>
+              <td>Open model selector or set model</td>
+            </tr>
+            <tr>
+              <td><span class="badge">Configure</span></td>
+              <td><code>/scoped-models</code></td>
+              <td><code>/scoped-models</code></td>
+              <td>Open Settings → Models: Alt+J / Alt+K cycle set checklist</td>
             </tr>
             <tr>
+              <td><span class="badge">Configure</span></td>
               <td><code>/skill</code></td>
               <td><code>/skill [name] [task]</code></td>
-              <td>Open the Skills Hub or invoke a skill</td>
+              <td>Open Skills Hub or invoke a skill</td>
             </tr>
             <tr>
-              <td><code>/view</code></td>
-              <td><code>/view [filter] | /view verify &lt;runId&gt;</code></td>
-              <td>Browse artifacts and verify receipts</td>
+              <td><span class="badge">Configure</span></td>
+              <td><code>/prompts</code></td>
+              <td><code>/prompts</code></td>
+              <td>List prompt templates</td>
             </tr>
             <tr>
-              <td><code>/run</code></td>
-              <td><code>/run &lt;agent&gt; &lt;task&gt;</code></td>
-              <td>Deploy worker agent locally</td>
+              <td><span class="badge">Configure</span></td>
+              <td><code>/extensions</code></td>
+              <td><code>/extensions</code></td>
+              <td>List installed extensions</td>
             </tr>
             <tr>
-              <td><code>/context</code></td>
-              <td><code>/context [compact|init|refresh|reset]</code></td>
-              <td>Context hub: window ledger overlay plus compact, init, refresh, and reset</td>
+              <td><span class="badge">Configure</span></td>
+              <td><code>/share</code></td>
+              <td><code>/share export | import &lt;path&gt;</code></td>
+              <td>Export or import Clio archives</td>
+            </tr>
+            <tr>
+              <td><span class="badge">Sessions</span></td>
+              <td><code>/quit</code></td>
+              <td><code>/quit</code></td>
+              <td>Exit Clio Coder</td>
             </tr>
             <tr>
+              <td><span class="badge">Sessions</span></td>
+              <td><code>/help</code></td>
+              <td><code>/help [query]</code></td>
+              <td>Open interactive help center and key reference</td>
+            </tr>
+            <tr>
+              <td><span class="badge">Sessions</span></td>
               <td><code>/resume</code></td>
               <td><code>/resume</code></td>
               <td>Resume a past session from history ledger</td>
             </tr>
+            <tr>
+              <td><span class="badge">Sessions</span></td>
+              <td><code>/new</code></td>
+              <td><code>/new</code></td>
+              <td>Start a fresh session</td>
+            </tr>
+            <tr>
+              <td><span class="badge">Sessions</span></td>
+              <td><code>/tree</code></td>
+              <td><code>/tree</code></td>
+              <td>Open session tree navigator</td>
+            </tr>
+            <tr>
+              <td><span class="badge">Sessions</span></td>
+              <td><code>/fork</code></td>
+              <td><code>/fork</code></td>
+              <td>Fork from an assistant turn</td>
+            </tr>
+            <tr>
+              <td><span class="badge">Sessions</span></td>
+              <td><code>/export</code></td>
+              <td><code>/export [path]</code></td>
+              <td>Export session transcript to Markdown</td>
+            </tr>
           </tbody>
         </table>
       </div>
     </main>
 
     <footer>
-      <p>Clio Coder UI Command specs &bull; Version 0.3.0</p>
+      <p>Clio Coder UI Command specs &bull; Version 0.3.1</p>
     </footer>
   </div>
 
@@ -661,34 +804,36 @@
 
     // Command registry
     const commandsList = [
-      { cmd: "/settings", usage: "/settings", desc: "Opens the TUI settings screen to modify autonomy level, worker permission modes, thinking levels, compaction thresholds, and retries." },
-      { cmd: "/targets", usage: "/targets", desc: "Inspects live target probes, switches the default orchestrator (key 'u'), connects credentials (key 'c'), or probes targets." },
+      { cmd: "/settings", usage: "/settings [section]", desc: "Opens the transactional Settings Center with CORE, ROUTING, RUNTIME, and EXPERIENCE sections." },
+      { cmd: "/targets", usage: "/targets", desc: "Opens Settings → Targets console table with in-place action drawer (Use, Connect, Probe, Remove)." },
+      { cmd: "/fleet", usage: "/fleet", desc: "Opens Settings → Fleet workbench for worker defaults, profile drilling, and agent route bindings." },
+      { cmd: "/scoped-models", usage: "/scoped-models", desc: "Opens Settings → Models provider-backed cycle set checklist with Space toggle." },
+      { cmd: "/thinking", usage: "/thinking [level]", desc: "Sets thinking level directly or opens Settings → Orchestrator." },
+      { cmd: "/output", usage: "/output [verbosity]", desc: "Sets transcript detail (minimal, default, verbose) or opens Settings → Terminal." },
       { cmd: "/run", usage: "/run <agent> <task>", desc: "Spawns a fleet agent locally to implement changes, verify code, debug unit errors, or update developer docs." },
+      { cmd: "/delegate", usage: "/delegate <agent-id> <task>", desc: "Run an ACP delegation agent." },
+      { cmd: "/agents", usage: "/agents", desc: "List Clio agents and ACP delegation agents." },
       { cmd: "/model", usage: "/model [pattern]", desc: "Opens the model selector or sets a model from live and configured catalog rows." },
       { cmd: "/skill", usage: "/skill [name] [task]", desc: "Opens the Skills Hub or invokes a selected skill." },
       { cmd: "/view", usage: "/view [filter] | /view verify <runId>", desc: "Browses receipts, dispatch outputs, durable tool output, and compaction summaries." },
       { cmd: "/context", usage: "/context", desc: "Visualizes token sliding window and compaction breakdown." },
-      { cmd: "/help", usage: "/help [query]", desc: "Searches available shortcuts and operating posture documentation." },
-      { cmd: "/quit", usage: "/quit", desc: "Exits clio-coder process cleanly." },
+      { cmd: "/context compact", usage: "/context compact [instructions]", desc: "Compact earlier context turns." },
       { cmd: "/context init", usage: "/context init [flags]", desc: "Explore the repo and bootstrap project context: CLIO-CODER.md and codewiki." },
       { cmd: "/context refresh", usage: "/context refresh", desc: "Re-index the codewiki and restamp the CLIO-CODER.md fingerprint footer." },
       { cmd: "/context reset", usage: "/context reset [--all]", desc: "Clear accumulated project context artifacts (CLIO-CODER.md preserved without --all)." },
+      { cmd: "/tasks", usage: "/tasks", desc: "Read-only overlay of the session task board with per-task receipts." },
+      { cmd: "/memory", usage: "/memory [seed]", desc: "Inspect task memory or seed from newest handoff." },
+      { cmd: "/cost", usage: "/cost", desc: "Show session token and cost totals." },
       { cmd: "/prompts", usage: "/prompts", desc: "List prompt templates." },
       { cmd: "/extensions", usage: "/extensions", desc: "List installed extensions." },
       { cmd: "/share", usage: "/share export <path> | /share import <path>", desc: "Export or import Clio archives." },
-      { cmd: "/delegate", usage: "/delegate <agent-id> <task>", desc: "Run an ACP delegation agent." },
-      { cmd: "/agents", usage: "/agents", desc: "List Clio agents and ACP delegation agents." },
-      { cmd: "/cost", usage: "/cost", desc: "Show session token and cost totals." },
-      { cmd: "/fleet", usage: "/fleet", desc: "Show in-process dispatch running/retry status." },
-      { cmd: "/thinking", usage: "/thinking", desc: "Open thinking-level selector." },
-      { cmd: "/scoped-models", usage: "/scoped-models", desc: "Edit the Alt+J / Alt+K model cycle set." },
-      { cmd: "/resume", usage: "/resume", desc: "Resume a past session." },
+      { cmd: "/help", usage: "/help [query]", desc: "Searches available shortcuts and operating posture documentation." },
+      { cmd: "/resume", usage: "/resume", desc: "Resume a past session from history ledger." },
       { cmd: "/new", usage: "/new", desc: "Start a fresh session." },
       { cmd: "/tree", usage: "/tree", desc: "Open session tree navigator." },
       { cmd: "/fork", usage: "/fork", desc: "Fork from an assistant turn." },
-      { cmd: "/context compact", usage: "/context compact [instructions]", desc: "Compact earlier context." },
-      { cmd: "/tasks", usage: "/tasks", desc: "Read-only overlay of the session task board with per-task receipts." },
-      { cmd: "/export", usage: "/export [path]", desc: "Write the session transcript to Markdown with tool segments expanded." }
+      { cmd: "/export", usage: "/export [path]", desc: "Export session transcript to Markdown." },
+      { cmd: "/quit", usage: "/quit", desc: "Exits clio-coder process cleanly." }
     ];
 
     let selectedIndex = 0;