iclavue 10.4.6 → 10.4.7

package/docs/clavue-pager-parity-audit-2026-07-09.md

@@ -0,0 +1,187 @@
+# Clavue Pager ↔ Ink parity audit (2026-07-09)
+
+Multi-agent audit of the **native Journal Shell** (default UI) vs Ink REPL.  
+Goal: catch up on product-critical surfaces; innovate on interaction, not invent a second product.
+
+**Status of this session’s code (local, not published):**
+
+| Item | Status |
+|------|--------|
+| Compact ↔ tool fold (real `AppModel.compact`) | ✅ Done |
+| Ctrl+, open `/settings` | ✅ Done |
+| Always-allow list in `/settings` (list + revoke + clear) | ✅ Done |
+| `session.prefs` a2p for compact/verbose | ✅ Done |
+| streamlined tool start/end id bug | ✅ Fixed |
+| tool.end `detail` for expand body | ✅ Partial (up to 4k) |
+| **Ctrl+C cancel-then-quit (2s double)** | ✅ Done |
+| **`/doctor` local diagnostics** | ✅ Done |
+| **`/mcp` list + enable/disable** | ✅ Done |
+| **`/memory` paths list** | ✅ Done |
+| **`/team` list/check status** | ✅ Done |
+| **`/permissions` expanded status** | ✅ Done |
+| **`/login` `/logout` clear paths** | ✅ Done |
+| **`/parallel` status + how-to** | ✅ Done |
+| **`/plugin` list** | ✅ Done |
+| **`/model` Grok panel picker** | ✅ Done |
+| **`/copy` clipboard** | ✅ Done |
+| **Shift+Enter multiline** | ✅ Done |
+| **Permission cycle + trustedOps** | ✅ Done |
+| **assistant.delta / thinking stream fidelity** | ✅ Improved |
+| **complete.rs catalog honesty** | ✅ Aligned local |
+| Full interactive wizards (mcp UI, plugin market, team dialog, parallel firepower UI) | 📋 Still ink / CLI deep |
+
+---
+
+## What already works well (do not regress)
+
+| Area | Notes |
+|------|--------|
+| Prompt / Esc cancel | Works |
+| ↑ history + locked input box | 10.4.6+ local |
+| Shift+Tab mode (3-way) + y/a/n | Works |
+| `/provider` Grok panel | Profile activate + doctor/validate |
+| `/settings` Grok panel | Compact/verbose/mode/locale/always-allow |
+| `/resume` picker | Works |
+| `/goal` `/loop` `/compact` (agent NI) | Agent-forward |
+| Parallel strip, outcome card, ctx header | Works |
+| Locale-aware `/` catalog | Works |
+
+---
+
+## P0 — default product path broken in pager
+
+| # | Gap | Severity | Direction |
+|---|-----|----------|-----------|
+| 1 | `/login` `/logout` | P0 | Text bridge or mini panel; cannot onboard in default UI |
+| 2 | `/mcp` manage | P0 | List/enable/disable text or panel rows |
+| 3 | `/plugin` marketplace | P0 | At least list + enable; full UI → ink honest |
+| 4 | `/memory` editor | P0 | Open path + list files; edit may stay ink |
+| 5 | `/team` dialog | P0 | Status text + list; dialog later |
+| 6 | `/parallel` firepower | P0 | Status/ledger first; full orchestration ink-ok if honest |
+| 7 | `/permissions` rules editor | P0 | Mode+always-allow done; rules summary + link |
+| 8 | `/model` interactive picker | P0 | Panel of recent/models; meta+p |
+| 9 | `/doctor` | P0 | Headless doctor text into journal/panel |
+| 10 | Ctrl+C = hard quit | P0 | First Ctrl+C cancel turn; second quit |
+| 11 | No image paste | P0 | Optional later; document gap |
+| 12 | Real `assistant.delta` stream | P0 | Emitter in fromStreamJson / stream events |
+| 13 | Thinking stream + real duration | P0 | No 500 hard cap only |
+| 14 | Static `complete.rs` lies (`agent` for ink-only) | P0 | Align kinds with `buildSlashCatalog` |
+
+---
+
+## P1 — important workflows thin or wrong
+
+| # | Gap | Direction |
+|---|-----|-----------|
+| 1 | Permission cycle missing bypass/trusted | Expand cycle or label “advanced via /mode” |
+| 2 | Multiline prompt (Shift+Enter) | Input mode |
+| 3 | `/copy` `/export` clipboard | OSC52 / pbcopy |
+| 4 | Markdown tables | markdown.rs |
+| 5 | Ctrl+O semantic ≠ Ink (transcript vs verbose) | Keep verbose; document; optional transcript mode |
+| 6 | meta+o fast / meta+t thinking | Bridge toggles |
+| 7 | `/cost` `/usage` `/context` deep | Richer snapshots |
+| 8 | `/diff` beyond --stat | File list + open |
+| 9 | Provider create/edit in-pager | Subset or deep-link CLI |
+| 10 | Theme/editorMode affect pager | Wire or mark Ink-only in panel |
+| 11 | Hydrate thinking/outcome denser | sessionHydrate |
+| 12 | Multi-pending permission queue UI | model + duplex |
+| 13 | External editor Ctrl+G | optional |
+| 14 | Protocol doc drift | Update clavue-ui-v1.md |
+
+---
+
+## P2 — secondary
+
+Stickers, install wizards, remote QR, voice, message actions, bash mode, statusline setup, etc. Honest ink stubs OK if catalog kind is `ink`.
+
+---
+
+## Implementation priority (suggested sprints)
+
+### Sprint A — Trust & density
+- [x] Compact real fold
+- [x] Ctrl+, settings
+- [x] Always-allow management
+- [x] tool detail + streamlined id fix
+- [x] Ctrl+C interrupt-then-quit
+- [x] complete.rs kind honesty
+
+### Sprint B — Auth & tools surface
+- [x] `/doctor` text bridge
+- [x] `/mcp` list + enable/disable
+- [x] `/login` / `/logout` clear paths
+- [x] `/model` panel picker
+- [x] `/memory` paths · `/team` status · `/plugin` list · `/parallel` status
+
+### Sprint C — Stream fidelity
+- [x] assistant.delta (+ content_block_delta)
+- [x] thinking larger cap + duration ms
+- [x] Multiline Shift/Alt+Enter + `/copy`
+
+### Sprint D — Remaining deep UIs
+- [x] MCP panel (list/toggle enable)
+- [x] Permissions panel (mode + always-allow + rule counts)
+- [x] Markdown GFM tables in journal
+- [x] Theme light/dark → pager palette (`ui.theme`)
+- [x] Parallel/team richer status text
+- [x] Multi-pending permission queue (FIFO modal)
+- [x] Richer `/cost` `/usage` `/context` (session rollup + bar)
+- [x] Richer `/diff` (name-status + untracked + patch preview)
+- [x] Alt+T thinking · Alt+O fast model · bracketed paste
+- [x] Image path paste → `@path` token (binary paste still terminal-limited)
+- [x] Provider create/edit CLI deep-link rows in panel
+- [ ] Full MCP/plugin/team/parallel **wizards** (still CLI/Ink for create/edit UI)
+- [ ] Raw image binary paste / screenshot buffer (OS/terminal dependent)
+
+### Sprint E — polish (this wave)
+- [x] Permission queue UI (+N waiting)
+- [x] sessionStats → slash bridges
+- [x] silent panel.action for hotkeys
+
+### Sprint F — review fixes (migration smoothness)
+- [x] `/cost` delta from cumulative `total_cost_usd` / usage (no triangular double-count)
+- [x] `--include-partial-messages` on duplex + live attach
+- [x] Stable `assistant.delta`/`final` blockId (live stream pin)
+- [x] Thinking / auto-compact toggle restarts agent
+- [x] Panel open no longer clears `running`
+- [x] Editor mode honest (Ink-only notice)
+- [x] Cancel clears tools/permissions ledger
+- [x] Alt+O no cross-provider model invent
+
+### Sprint G — migrate onboarding
+- [x] Rich `/help` `/keys` `/help migrate` `/whats-new`
+- [x] `/theme` local · `/export` to `.clavue/exports` or clipboard
+- [x] Session migrate tip notice + changelog lines
+- [x] Settings: duration toggle · keys/migrate/classic Ink rows
+- [x] Catalog honesty for theme/export/keybindings/release-notes
+
+---
+
+## Design rules (from Grok settings + Clavue)
+
+1. **Panels for switch/list**, not full wizards (provider create stays CLI).
+2. **Three-way sync**: header · panel · slash/key.
+3. **Catalog honesty**: never mark ink-only as `agent`.
+4. **Compact** = fold noise; **verbose** = expand detail; independent.
+5. **No publish without explicit user confirm.**
+
+---
+
+## File anchors
+
+- Pager: `pager/src/main.rs`, `pager/src/model.rs`, `pager/src/complete.rs`
+- Bridge: `src/uiProtocol/slashBridge.ts`, `duplexSession.ts`, `settingsPanel.ts`, `fromStreamJson.ts`
+- Registry: `src/commands.ts`
+- Ink keys: `src/keybindings/defaultBindings.ts`
+
+---
+
+## How to try current local work (no npm publish)
+
+```bash
+npm install -g /Users/lu/codebase/claude-code-source
+clavue
+# Ctrl+,  or  /settings
+# Compact on/off → tool grouping changes
+# Permission a → then /settings → Always-allow list → revoke
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iclavue",
-  "version": "10.4.6",
+  "version": "10.4.7",
   "description": "Clavue: execution-first AI coding CLI with direct repo tools, provider routing, native workflows, MCP integration, and long-session recovery",
   "keywords": [
     "iclavue",