iclavue 10.4.13 → 10.4.15

package/docs/clavue-pager-content-doctrine.md

@@ -0,0 +1,131 @@
+# Clavue Pager Content Doctrine
+
+> How journal content is **seen** — not just which keys exist.  
+> Complements `clavue-pager-interaction-contract.md` (hands) with **eyes**.  
+> Clavue ≠ Grok clone: we keep **execution / verify / multi-route** advantages.
+
+---
+
+## 1. Visual priority (top → bottom attention)
+
+| Rank | Content | Why (Clavue) |
+|------|---------|----------------|
+| **1** | Outcome **FAILED** / blockers | Delivery truth — Grok is calmer; we stay loud on fail |
+| **2** | Edit/Write **red/green bands** | Code change is the product unit |
+| **3** | Permission modal · Needs Input | Safety / multi-worker unblock |
+| **4** | Tool heads `Edit path · −n +m` | Scan without expand |
+| **5** | Assistant final text | Answer, not process |
+| **6** | Bash/Task (collapsed) | Process — expand on demand |
+| **7** | Thought / explore groups | Noise by default |
+| **8** | Tokens/cost meta in Outcome | Secondary telemetry |
+
+**Rule:** If everything is bright, nothing is important. Dim by default; paint signal.
+
+---
+
+## 2. Line roles (already partially shipped)
+
+| Role | Paint |
+|------|--------|
+| Diff add / del | Full-line green / red **band** |
+| Diff context / `… more` | Dim gray |
+| Path-only | Bold tool color |
+| Outcome fail header | Red band + bold |
+| Outcome blockers fail | Red band |
+| tokens/cost/turns | Dim |
+| Thought | Think muted |
+
+---
+
+## 3. Clavue-native “perfect” upgrades (roadmap)
+
+### A. **Delivery ribbon** (unique — not Grok)
+
+After each turn, one sticky strip (battlefield, ≤3 lines):
+
+```
+■ Outcome · ok · −12 +8 across 3 files
+□ verify pass · next: continue
+```
+
+or fail:
+
+```
+■ Outcome · FAILED · blockers: typecheck
+□ Edit a.ts · −2 +5 · verify fail
+```
+
+**Advantage:** multi-file turn summary Grok often underplays; we already have Outcome — make it the **always-on scan target**.
+
+### B. **Route identity in journal, not only header**
+
+When model/provider changes mid-session:
+
+```
+◇ route · providerX · modelY · (session kept)
+```
+
+**Advantage:** multi-provider product; header flash alone is easy to miss.
+
+### C. **Parallel Needs Input as first-class card**
+
+Same visual weight as permission modal:
+
+```
+⚠ Needs Input · worker-2 · question…
+  [Enter panel]  [y/a/n if perm]
+```
+
+**Advantage:** multi-agent is our wedge; gray it and users miss it.
+
+### D. **Edit fold math always visible**
+
+Collapsed: `◆ Edit path · −3 +5`  
+Expanded: red/green body  
+
+Never collapse Edit to bare `ok`.
+
+### E. **Combo model line only when hybrid**
+
+Header: `primary · light · agent` when slots differ; else single model.  
+(Already partial — keep honest, no spam.)
+
+### F. **Optional later**
+
+| Item | ROI | Note |
+|------|-----|------|
+| Real file line numbers | Med | Needs disk read of file for Edit |
+| Full syntax theme | Low | Band + strings enough for scan |
+| Block fullscreen | Med | Grok Ctrl+F — nice, not daily |
+| Vim | Low | Ink by design |
+
+---
+
+## 4. What not to chase
+
+- Pixel clone of Grok chrome (we have dragon · Outcome · multi-route)
+- Ink-deep wizards in pager (capabilitySurface stubs)
+- Bright-every-line “pretty terminal” that kills density
+
+---
+
+## 5. Implementation map
+
+| Concern | Code |
+|---------|------|
+| Diff bands + string tint | `pager/src/render.rs` · `theme.rs` |
+| Edit body markers | `fromStreamJson.formatEditDiffBody` |
+| Edit head −n +m | `toolSummary` · `toolResultSummary` |
+| Outcome fields | `render.rs` Outcome branch · duplex `outcome.turn` |
+| Sticky delivery | `rebuild_battlefield_chrome` · last_outcome |
+| Interaction keys | `keys.rs` · interaction-contract |
+
+---
+
+## 6. Next three builds (recommended order)
+
+1. **Ship**: Edit −n+m on fold + red/green bands *(done / hardening)*  
+2. **Delivery ribbon**: battlefield always shows last Outcome in ≤2 lines with edit aggregate  
+3. **Needs Input card**: same visual tier as permission  
+
+Then stop painting and measure: time-to-spot “what changed / did it pass verify?”

package/docs/clavue-pager-interaction-contract.md

@@ -0,0 +1,199 @@
+# Clavue Pager Interaction Contract
+
+> **Stable product contract** — not a patch log.  
+> All session key behavior is defined here. Code must match this table.  
+> Last updated: 2026-07-11 (line-edit + Ctrl+C ladder)
+
+## Design rules
+
+1. **One ladder per gesture** — Esc, Ctrl+C, Tab have ordered steps; never silent no-ops without status.
+2. **Draft before destroy** — clear input before cancel/quit when draft is non-empty.
+3. **Prompt is home** — typing always returns focus to prompt; scrollback is view-only until Tab.
+4. **Completions steal only when active** — `/…` or live `@token`; otherwise ↑↓ = history.
+5. **Stay in session** — empty Esc never opens home; use `/home` or `/exit`.
+6. **Journal visual hierarchy (Grok Edit card)** — full-line green/red bands for `+ `/`- ` diffs; dim context; bold path; noise folded.
+
+## Journal line roles (content display)
+
+| Role | Marker / cue | Style |
+|------|----------------|-------|
+| **Add** | `+ ` / `+ N\| code` | Full-line **green band** + string highlight |
+| **Del** | `- ` / `- N\| code` | Full-line **red band** + string highlight |
+| **Context** | `N\| code` · `… more` | **Dim gray** (skip when scanning) |
+| **Path** | `…/file.rs` alone | Bold tool color |
+| **Tool head** | `◆ Edit path · −n +m` | Tool green · fail red · counts on fold |
+| **Thought** | `Thought` | Think muted |
+| **Outcome fail** | Outcome failed | Highest contrast |
+
+Render: `pager/src/render.rs` · tokens: `theme.rs` `diff_*` · body: `formatEditDiffBody`.
+
+---
+
+## Session · Ctrl+C ladder
+
+| State | Effect |
+|-------|--------|
+| Draft non-empty (or history browse) | **Clear draft** · status tip · **do not** cancel/quit |
+| Running + empty draft | **Cancel turn** · tip: Ctrl+C again to quit |
+| Idle + empty draft · first press | Tip: Ctrl+C again to quit |
+| Idle + empty · second within 2s | **Quit** |
+
+Also: **Ctrl+U** clears draft anytime (kill line).
+
+---
+
+## Session · Esc ladder
+
+| Order | Condition | Effect |
+|-------|-----------|--------|
+| 1 | Running | Cancel turn |
+| 2 | Completions open | Close menu |
+| 3 | History browse | Restore live buffer |
+| 4 | Text selection | Clear selection |
+| 5 | Scrollback focus | Focus prompt |
+| 6 | Draft non-empty | Clear draft |
+| 7 | Idle empty | Stay · tip `/home` · `/exit` |
+
+---
+
+## Session · Prompt (draft editing)
+
+| Key | Effect |
+|-----|--------|
+| Printable | Insert at caret |
+| Backspace / Delete | Delete before / after caret |
+| ← → Home End | Move caret |
+| Ctrl+A / Ctrl+E | Line start / end |
+| Ctrl+U | Clear entire draft |
+| Ctrl+K | Kill caret → end |
+| Ctrl+W | Kill word before caret |
+| Ctrl+D | Delete forward |
+| Shift/Alt+Enter | Newline (no send) |
+| Enter | Send (or run local `/`) |
+| ↑ ↓ | Prompt history (if not in `/` menu) |
+| Ctrl+P / Ctrl+N | Prompt history (always) |
+| Ctrl+R | Reverse history search (match draft · again = older) |
+| Ctrl+S | Resume session picker |
+| Paste / drag path | Insert at caret · file/folder/image/doc path → `@path` (multi → `@a @b `) |
+| Paste image *data* | Honest notice: save file then `@path` (no binary upload in pager) |
+
+---
+
+## Session · Completions (`/` or `@`)
+
+| Key | Effect |
+|-----|--------|
+| ↑ ↓ Tab Shift+Tab | Move selection |
+| Enter | Apply · if `/cmd` open surface |
+| Esc | Close menu |
+| Type / Backspace | Refine filter |
+
+---
+
+## Session · Scrollback
+
+| Key | Effect |
+|-----|--------|
+| Tab | Toggle focus prompt ↔ scrollback |
+| ↑ ↓ j k PageUp/Down | Select entry |
+| ← → h l Space | Fold / expand |
+| Shift+↑ / Shift+↓ | Jump prev/next **user** turn |
+| y | Copy selected block body |
+| Y | Copy selected block summary |
+| Type / Backspace | Return to prompt + edit |
+| Alt+↑↓ | From prompt: enter scrollback (one step) |
+| Shift+↑↓ (from prompt) | Enter scrollback + jump user turn |
+
+---
+
+## Session · History search (Ctrl+R)
+
+| Key | Effect |
+|-----|--------|
+| Ctrl+R | Enter reverse search · needle = draft (empty = any) · again = older match |
+| Printable (in search) | Append to needle · re-search from newest |
+| Backspace (in search) | Pop needle · re-search |
+| Esc | Restore draft · leave search |
+| Enter | Accept match as prompt (send if non-empty) |
+| Ctrl+S | Resume session picker (lightweight await · not turn busy) |
+
+---
+
+## Session · Global chords
+
+| Key | Effect |
+|-----|--------|
+| Shift+Tab | Cycle permission mode |
+| y / a / n | Permission modal |
+| Ctrl+O | Verbose toggle |
+| Ctrl+, | Settings panel |
+| Alt+T | Thinking toggle |
+| Alt+O | Fast model toggle |
+| Ctrl+L | Collapse last tool group |
+| Mouse drag | Select → copy |
+
+---
+
+## Paste / drag-drop contract
+
+Terminals deliver **bracketed paste** (not true HTML drag events). Finder/Explorer
+drag into the terminal usually becomes a paste of path(s) or `file://` URIs.
+
+### Paths & files
+
+| Input | Result |
+|-------|--------|
+| Image path / `file://…png` | `@/abs/path ` |
+| Folder path | `@/abs/dir ` (agent Glob/Read) |
+| Doc `.md/.pdf/.docx/…` | `@/path ` |
+| Multi-line paths | `@a @b @c ` |
+| `data:image…` / binary clipboard | Status tip only — save to disk first |
+
+### Plain text / long content (tiered)
+
+| Size | Policy |
+|------|--------|
+| **Short** (≲4k chars and ≲60 lines) | Insert into draft at caret |
+| **Medium** (above short, below file floor) | Insert into draft; dock shows **last 8 lines** + `… +N lines above` |
+| **Long** (≥12k chars **or** ≥200 lines **or** draft+paste >24k) | Write `<cwd>/.clavue/pastes/paste-*.{txt,md}` → insert `@/abs/path ` · agent **Read** |
+| File save fails | Inline first 4k with truncation notice |
+
+Why file spill: keeps prompt scannable, avoids TUI jank, matches agent tools (`@path` → Read).
+
+Constants: `PASTE_INLINE_MAX_*` · `PASTE_FILE_MIN_*` · `PROMPT_TOTAL_MAX_CHARS` in `pager/src/main.rs`.
+
+Implementation: `handle_paste` · `should_spill_paste` · `spill_paste_to_file` · `extract_path_tokens`.
+
+## Two shells · one engine
+
+| Term | Meaning |
+|------|---------|
+| **Native pager** | Default UI (Rust/ratatui). Insert-mode line edit. Catalog kinds · local / → agent. |
+| **Ink** | Classic Clavue terminal UI built with React + npm package **ink**. Launch: `clavue --ui=ink`. |
+| **Vim** | Modal keybindings (Normal/Insert like the **vim editor**). **Not** “window”. Only in Ink shell. |
+| **◇ ink commands** | `/vim` · `/hooks` · `/skills` · `/agents` — multi-step wizards; pager shows honest deep-link only. |
+
+Shell paints; engine executes. Switching shell does not change tools/models/routes.
+
+## Out of scope (honest)
+
+| Item | Path |
+|------|------|
+| Full vim mode in native pager | `/ink` → classic shell · or future opt-in |
+| Fullscreen block viewer | Later |
+| Multi-cursor / selection in prompt | Not supported |
+| True binary image paste without path | OS/terminal limited; use file + `@path` |
+
+---
+
+## Implementation map
+
+| Concern | File |
+|---------|------|
+| Key ladders + chords | `pager/src/main.rs` `handle_key` |
+| Line buffer + caret | `pager/src/model.rs` `input` / `input_cursor` / `insert_*` / `kill_*` |
+| History | `history_prev` / `history_next` / `history_search_*` / `wants_prompt_history_keys` |
+| Footer tips | `grok_footer_spans` |
+| Local slash wait | `awaiting_slash` · `begin_awaiting_slash` (not `running`) |
+
+When adding a key: **update this doc first**, then code, then `/keys` help text.

package/docs/clavue-pager-parity-checklist.md

@@ -0,0 +1,68 @@
+# Clavue Pager Parity Checklist
+
+Living checklist vs Claude Code / Codex daily path · historic Clavue · Grok CLI.  
+**Not a marketing claim** — mark honesty. Update when keys/features change.
+
+Legend: ✅ full · ⚠️ partial · ❌ missing/by-design · 🔧 this wave
+
+---
+
+## P0 — daily path (must stay green)
+
+| Item | Status |
+|------|--------|
+| Send / multi-turn | ✅ |
+| Esc cancel turn | ✅ |
+| Ctrl+C clear → cancel → quit | ✅ |
+| Permission y/a/n + Shift+Tab mode | ✅ |
+| /model · session kept | ✅ |
+| /clear · /resume | ✅ |
+| /compact · /plan (agent) | ✅ |
+| /cost · /context · /diff | ✅ |
+| @path · paste file · long paste file | ✅ |
+| Ctrl+, settings | ✅ |
+| Provider batch form | ✅ |
+| Outcome / verify chrome | ✅ |
+
+## P2 — power UX (Grok/Claude muscle)
+
+| Item | Status |
+|------|--------|
+| ↑↓ · Ctrl+P/N history | ✅ |
+| Ctrl+R reverse history search | ✅ |
+| Ctrl+S resume | ✅ |
+| Scrollback y/Y copy block | ✅ |
+| Shift+↑↓ user-turn jump | ✅ |
+| Line edit caret · Ctrl+U/K/W | ✅ |
+| /keys single map | ✅ |
+| Ctrl+R type-while-search (refine needle) | ✅ |
+| Block fullscreen viewer | ❌ later |
+| Vim mode | ❌ ink by design |
+| Grok Esc≠cancel | ❌ Clavue keeps Esc=cancel |
+
+## Settings surface
+
+| Item | Status |
+|------|--------|
+| Compact / verbose / thinking / theme / locale | ✅ |
+| Always-allow list | ✅ |
+| Editor/vim (modal keys) | ❌ ink-only by design · `/vim` honest deep-link |
+| MCP list/toggle/add | ⚠️ list full · OAuth ink |
+| Hooks/skills/agents wizards | ❌ ink by design |
+
+## Engine (historic Clavue)
+
+| Item | Status |
+|------|--------|
+| Tools · routes · plan/verify · goal/loop · parallel | ✅ L2 unchanged |
+
+---
+
+## Definition of done
+
+- **Daily ship**: all P0 ✅  
+- **Power parity**: P2 daily keys ✅ · remaining ❌ are by-design / later  
+
+- **Deep wizard**: not required for pager GA  
+
+Keys source: `pager/src/keys.rs` · contract: `clavue-pager-interaction-contract.md`

package/docs/clavue-pager-ux-principles.md

@@ -23,7 +23,9 @@ See also: `docs/clavue-pager-visual-doctrine.md`, `pager/src/theme.rs`.
 | Browse journal | Tab or ↑ from empty prompt |
 | Fold tools | Scrollback focus · ←/→ |
 | Language | Home · Language · or `/language` |
-| Escape | Esc: cancel → clear → home |
+| Escape | Esc: cancel → menu → history → clear draft · **stay in session** (`/home` to leave) |
+| Clear draft | Ctrl+C (first) · Ctrl+U · Esc on empty menu |
+| History | ↑/↓ or Ctrl+P/N in prompt |
 
 ## Visual hierarchy (Clavue Night)
 

package/docs/clavue-vs-grokcli-architecture-alignment.md

@@ -0,0 +1,151 @@
+# Clavue vs Grok Build CLI — 架构差异与对齐路线
+
+> 2026-07-11 · 对照本机 Grok 0.2.93 文档/二进制 + Clavue native pager  
+> 目的：**解释为什么我们问题多**，以及**如何按 Grok 正确姿势对齐**（不是像素复刻）
+
+---
+
+## 0. 一句话结论
+
+| | **Grok Build** | **Clavue v10 pager** |
+|--|----------------|----------------------|
+| 形态 | **同栈共设计**：`xai-grok-pager` + `xai-grok-shell` 从第一天就分工清晰 | **引擎先成熟，壳后换**：Node 引擎 + 后装 Rust pager + NDJSON 桥 |
+| 会话真理 | **`updates.jsonl` 权威 UI 流** → resume = 回放 | 长期靠 **agent jsonl 反向 hydrate**（有损） |
+| Slash | **Pager builtins / Shell builtins** 两源，目录合一 | complete.rs 静态 + slashBridge + Ink 三源易漂移 |
+| 产品范围 | 单厂商 · 单 runtime 体验 | 多 provider · 组合模型 · plan/verify · 并行 |
+
+**问题多的根因不是「前端写得差」，而是：Grok 的 UI 事件流与会话存储是一等公民；我们曾用「引擎 transcript 反推 UI」补洞。**
+
+---
+
+## 1. Grok 如何实现（本机文档/二进制证据）
+
+### 1.1 双组件、同一产品契约
+
+Grok slash 文档原文：
+
+- **Shell builtins** → agent backend (`xai-grok-shell`)
+- **Pager builtins** → TUI frontend (`xai-grok-pager`)
+- 自动补全目录合并两套
+
+二进制侧可见：`xai_grok_shell::session::storage`、ACP `session/prompt`、`updates.jsonl` 回放逻辑。
+
+### 1.2 会话是权威存储，不是「事后猜」
+
+`~/.grok/sessions/<cwd>/<session-id>/`：
+
+| 文件 | 角色 |
+|------|------|
+| **`updates.jsonl`** | **UI/对话权威流**（resume 回放源） |
+| `chat_history.jsonl` | 发给模型的原始消息 |
+| `summary.json` | 索引元数据 |
+| `plan.json` / `signals.json` | 任务与计数 |
+
+**Resume = 回放 updates，不是从 chat_history 猜 UI 行。**
+
+### 1.3 键位语义产品化（稳定契约）
+
+- Esc：**不**取消 running turn（Ctrl+C 取消）— 2026-07 明确变更
+- Esc：清输入 / rewind 用 **双击** 防误触
+- Prompt 与 Scrollback 焦点分离，字母键回 prompt
+
+### 1.4 密度来自「块模型 + 折叠」，不是 React 树
+
+Scrollback 是 entry 选择/折叠模型；thinking / tool / user 都是块级操作。
+
+---
+
+## 2. Clavue 为何问题多（差异清单）
+
+```
+Grok:   [Pager] ←── updates.jsonl ──→ [Shell/Agent]     同栈、同事件方言
+Clavue: [Pager] ←── a2p NDJSON ──→ [duplex] ←── stream-json ──→ [Agent]
+                      ↑ 展示层                    ↑ 引擎层
+                 曾无权威落盘              Claude 兼容 jsonl
+```
+
+| # | 差异 | 症状 |
+|---|------|------|
+| 1 | **无权威 UI 事件日志**（直到 journal.a2p） | resume 丢 thinking/outcome；hydrate 永远追不上 live |
+| 2 | **双 session id**（pending + agent UUID） | 模型切换/重启丢对话 |
+| 3 | **Slash 三源**（complete.rs / slashBridge / Ink） | `/status` 本地 stub、catalog 撒谎 |
+| 4 | **模型显示多表面** | header 对了、面板/`/status` 读 profile |
+| 5 | **Ink 全量能力期望迁移** | MCP OAuth 等被当成 pager bug，实为深度边界 |
+| 6 | **Paint 未虚化** | 长会话 `entry_lines` 全量展开卡顿 |
+
+**后端（L2）成熟** → 换壳后暴露的是 **L0/L1 契约缺失**，不是 QueryEngine 坏了。
+
+---
+
+## 3. 对齐原则（最佳实践 · 禁止再犯）
+
+### 3.1 必须像 Grok 的
+
+1. **UI 事件流权威**  
+   Live a2p → 落盘 `journal.a2p.jsonl` → resume **优先回放**；agent jsonl hydrate 仅 fallback。
+
+2. **Slash 单源深度**  
+   `capabilitySurface.ts` = 唯一 `local|agent|ink`；`/wizard` 从此生成。
+
+3. **Session UUID 连续**  
+   换 model/mode → `--resume` 同 UUID；仅 `/clear` 新会话。
+
+4. **壳不重写引擎**  
+   Deep wizard 诚实 `ink`/`stub`，禁止假面板。
+
+5. **Paint 虚化**  
+   `MAX_JOURNAL_BLOCKS` + 近焦点 body 展开。
+
+### 3.2 不必抄 Grok 的
+
+| Grok | Clavue 保持差异（优势） |
+|------|-------------------------|
+| 单 provider 身份 | **Provider-as-route · 组合模型** |
+| Esc 不取消 turn | **Esc 取消 turn**（Clavue 肌肉记忆；Ctrl+C 二次退出） |
+| 单 monorepo Rust 二进制 | **Node 引擎 + 可选 native pager**（npm/-p/CI） |
+| 无 verify Outcome 产品形态 | **Outcome/verify Tier-0** |
+
+---
+
+## 4. 落地状态（本轮）
+
+| 项 | 状态 |
+|----|------|
+| `capabilitySurface.ts` 单源 | ✅ |
+| Hydrate 同 live 投影（thinking/outcome） | ✅ |
+| Paint 虚化 + block 预算 | ✅ |
+| **`journalEventLog.ts` 权威 a2p 日志** | ✅ 本轮 |
+| Resume 优先回放 a2p log | ✅ 本轮 |
+| agent jsonl hydrate fallback | ✅ |
+| complete.rs 由 SURFACE 生成 | 📋 下一步（构建时 codegen） |
+| Esc 与 Grok 完全同语义 | ❌ 故意保留 Clavue 取消语义 |
+
+### 存储布局（对齐 updates.jsonl 思想）
+
+```
+<project>/.clavue/journal/<sessionId>.a2p.jsonl
+  {"type":"user.message","payload":{...},"ts":...}
+  {"type":"tool.start",...}
+  {"type":"assistant.final",...}
+  {"type":"outcome.turn",...}
+```
+
+`/clear` → archive 旧 log；新 UUID 新文件。
+
+---
+
+## 5. 以后改 shell 的检查清单
+
+- [ ] 新 journal 行是否写入 **a2p 类型** 且进 `JOURNAL_LOG_TYPES`？  
+- [ ] 新 slash 是否先改 **capabilitySurface**？  
+- [ ] resume 路径是否 **log 优先**，jsonl 仅 fallback？  
+- [ ] 是否在 pager 里重做了 L2 逻辑？（禁止）  
+- [ ] 长会话是否只展开 **near-focus** body？
+
+---
+
+## 6. 对用户可说的诚实表述
+
+**对齐 Grok 的是：信息架构与会话事件真理（journal 块、回放、slash 深度、密度）。**  
+**不对齐的是：产品深度（多路由/验证/并行）与部分键位语义（Esc 取消）。**  
+**问题多是因为先有引擎后接壳；对齐后用「权威 UI 日志」消掉 hydrate 类复发。**

package/docs/evals/world-class/weekly-flywheel.tsv

@@ -26,3 +26,9 @@ date	version	clavue_measured_pct	clavue_total_pct	claim_ok	provider_matrix	eval_
 2026-07-10	10.4.13	96.7	94.3	1	-	-	-	-	-	clavue
 2026-07-10	10.4.13	96.7	94.3	1	-	-	-	-	-	clavue
 2026-07-10	10.4.13	96.7	94.3	1	-	-	-	-	-	clavue
+2026-07-10	10.4.14	96.7	94.3	1	-	-	-	-	-	clavue
+2026-07-10	10.4.14	96.7	94.3	1	-	-	-	-	-	clavue
+2026-07-10	10.4.14	96.7	94.3	1	-	-	-	-	-	clavue
+2026-07-11	10.4.15	96.7	94.3	1	-	-	-	-	-	clavue
+2026-07-11	10.4.15	96.7	94.3	1	-	-	-	-	-	clavue
+2026-07-11	10.4.15	96.7	94.3	1	-	-	-	-	-	clavue

package/docs/system-shell-engine-contract.md

@@ -45,7 +45,7 @@
 | `CLAVUE_UI=ink` | Classic shell |
 | `CLAVUE_LOCALE_PROMPT=1` | Force full locale model-adaptation block |
 | `CLAVUE_PAGER_PARTIALS=0` | Disable stream partials on duplex agent |
-| `CLAVUE_PAGER_COMPACT=1` | Default compact journal fold |
+| `CLAVUE_PAGER_COMPACT=0` | Disable compact journal fold (default is ON) |
 | `CLAVUE_PAGER_BIN` | Pin pager binary path |
 | `CLAVUE_PAGER_OSC8=1` | Opt-in OSC 8 path hyperlinks (default off — layout purity) |
 | `CLAVUE_PAGER_MOUSE=0` | Disable pager mouse capture |
@@ -61,6 +61,10 @@
 7. **Free-form `overview.snapshot` is ephemeral** — never durable wipe of goal / last outcome / workers; use for resume tips only.  
 8. **Fail > decoration** — FAILED / Needs Input / route error paint before marketing or empty ready lines.  
 9. **Header = identity; sticky = execution** — no model/mode parade duplicated into journal sticky.
+10. **Hydrate = live projection** — resume journal uses the same a2p kinds as live (`user.message` · `assistant.final` · `tool.*` · `thinking.*` · `outcome.turn`). Never a second transcript dialect.
+11. **Paint virtualization** — pager may retain many blocks but must not fully expand off-screen bodies every frame; bound with `MAX_JOURNAL_BLOCKS` + near-focus body expand.
+12. **Capability surface single source** — catalog kinds (`local|agent|ink`) and `/wizard` map come from `capabilitySurface.ts` only. Do not hand-edit parallel lists in slashBridge/complete.rs.
+13. **Authoritative UI event log (Grok updates.jsonl pattern)** — live a2p journal events append to `<cwd>/.clavue/journal/<sessionId>.a2p.jsonl`. Resume **replays this log first**; reverse-parse of agent jsonl is fallback only. See `docs/clavue-vs-grokcli-architecture-alignment.md`.
 
 ## Tests
 

package/package.json

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