iclavue 10.5.0 → 10.5.2

package/docs/clavue-10.5.1-reliability-retro.md

@@ -0,0 +1,128 @@
+# Clavue 10.5.1 Reliability Retro — multi-agent audit
+
+> Date: 2026-07-11  
+> Agents: explore (plan-vs-applied), explore (binary wiring), general review, formal [reviewer]  
+> Artifacts: `/var/folders/.../grok-review-8fd406fe.md` + this doc
+
+## Verdict
+
+| Layer | Status |
+|-------|--------|
+| Core interaction code (viewport, sticky band, prompt_sel, Ctrl+J) | **Applied** |
+| Reliability blockers found by review | **Fixed in tree this session** |
+| npm **complete reliable ship** | **Not yet** — uncommitted; global shell still `iclavue@10.5.0`; multi-OS binary gap; release gate soft on pager |
+
+**Ship posture:** ship-with-fixes → blockers below fixed in working tree; still need commit + `check:release` + publish + optional multi-triple pack.
+
+---
+
+## Designed / configured but not fully applied (before this fix pass)
+
+### CRITICAL / HIGH (user-visible or ship risk)
+
+| ID | Finding | Status after fix pass |
+|----|---------|------------------------|
+| C1 | Hard `\n` drafts blocked ↑ history via `wants_prompt_history_keys` | **Fixed** — no blanket `\n` deny |
+| C2 | Soft-wrap width split-brain (`term_cols-6` vs `width-4`) | **Fixed** — `prompt_content_wrap_width` single source |
+| C3 | Prompt drag release outside dock left selection stuck / no copy | **Fixed** — `finalize_prompt_drag` |
+| C4 | Release gate does not hard-require staged native pager | **Open** (process) |
+| C5 | Global npm 10.5.0 + hot-replace binary only; tree 10.5.1 uncommitted | **Open** (publish) |
+| H1 | `keys.rs` / `/keys` missing Ctrl+J, soft-wrap ↑↓, prompt select | **Fixed** |
+| H2 | Contract “prompt selection not supported” contradicted code | **Fixed** |
+| H3 | Home/End buffer-wide vs plan “logical line” | **Open** (product decision) |
+| H4 | Permission modal can cover prompt | **Open** |
+| H5 | Node tests mostly source greps, not handle_key | **Open** (partial: more unit tests) |
+| H6 | Multi-OS: npm ships host triple only; other platforms → Ink | **Open** (packaging) |
+| H7 | Version matrix noise: cargo 0.1.0, p2a hello 0.2.1, pagerVersion 0.1.0 | **Open** |
+
+### MEDIUM / LOW
+
+- Sticky model budget 5 vs layout paint ≤3 (overflow can vanish)
+- Selected body `usize::MAX` paint risk on huge tools
+- Dead mouse-capture “native select” comments (cleaned)
+- No 10.5.1 release-notes / website pack
+- PTY/ANSI visual matrix still optional
+- Plan DoD checkboxes still claim open release items
+
+---
+
+## What **is** solidly applied
+
+- PromptViewport soft-wrap + above/below banners  
+- Bottom-first layout; sticky Tier-0 band outside journal scroll  
+- App-level prompt select + highlight + Ctrl+Y  
+- Soft-wrap ↑↓ + Ctrl+J newline  
+- TurnPhase / FlightSnapshot progress strip  
+- Tier-0 never hidden by compact  
+- Needs Input one-Enter → `/parallel needs`  
+- Ctrl+C / Esc ladders  
+- CJK/narrow caps; paste spill to file  
+- Binary resolution: package `dist/native` preferred over cwd  
+
+---
+
+## Runtime version matrix (this machine)
+
+| Surface | Value |
+|---------|-------|
+| Working tree `package.json` | **10.5.1** |
+| Published npm (global) | **10.5.0** (+ hot-replaced pager binary) |
+| `dist/native/manifest.json` | version 10.5.1, pagerVersion 0.1.0, darwin-arm64 |
+| Cargo crate | 0.1.0 |
+| Protocol | ui/v1 |
+
+Hot-replace works: overwrite `…/iclavue/dist/native/clavue-pager*`. No package↔binary version gate.
+
+---
+
+## Fix pass completed this session (post-review)
+
+1. `prompt_content_wrap_width` — layout / paint / hit / caret / ↑↓  
+2. Multi-line history fallthrough  
+3. Prompt drag finalize outside dock; clear prompt_sel on journal click  
+4. `keys.rs` + contract out-of-scope  
+5. `kill_to_end` / `kill_word_before` clear selection  
+6. Caret-loop simplified  
+7. Unit tests: wrap parity, multi-line history  
+8. `cargo test` **43/43**; staged + global binary updated  
+
+---
+
+## Remaining checklist for “完整可靠” 10.5.1
+
+### Must before publish
+
+- [ ] Commit all sources + staged `dist/native`  
+- [ ] Add `docs/clavue-v10.5.1-release-notes.md` (UI reliability bullet list)  
+- [ ] `npm run check:release` green (consider hard-adding `pager:stage` + `cargo test`)  
+- [ ] Explicit **确认发布** → `npm publish`  
+- [ ] Post: `npx -y iclavue@10.5.1 --version`  
+- [ ] Manual TTY smoke 80×24 + 60×20: sticky, multi-line, select/copy, Ctrl+J  
+
+### Should (10.5.1 or 10.5.2)
+
+- [ ] Logical-line Home/End (or document buffer-wide)  
+- [ ] Permission modal confined to journal band  
+- [ ] Selected body paint soft-cap  
+- [ ] Sticky overflow `+N more` when layout caps strip  
+- [ ] Multi-triple native binaries in npm (or documented Ink fallback)  
+- [ ] Align pagerVersion / cargo hello with package version  
+
+### Optional
+
+- [ ] PTY golden matrix  
+- [ ] Website VERSION deploy  
+- [ ] Extract pure key-dispatch for integration tests  
+
+---
+
+## Agent consensus
+
+| Agent | One-line |
+|-------|----------|
+| Explore plan-vs-applied | Core wired; history + release gate + help drift main gaps |
+| Explore binary wiring | Resolution OK; multi-OS + soft gate + version chaos block “complete” |
+| General review | No ship until wrap-width + multi-line history fixed |
+| Formal reviewer | **ship-with-fixes**; same top blockers |
+
+After this fix pass, code-level ship-with-fixes blockers are addressed; **process/publish** remains.

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

@@ -65,15 +65,19 @@ Also: **Ctrl+U** clears draft anytime (kill line).
 |-----|--------|
 | Printable | Insert at caret |
 | Backspace / Delete | Delete before / after caret |
-| ← → Home End | Move caret |
-| Ctrl+A / Ctrl+E | Line start / end |
+| ← → | Move caret by char |
+| Home / End · Ctrl+A / Ctrl+E | **Logical line** start / end (`\n` delimited) |
 | 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) |
+| Ctrl+J / Ctrl+Enter / Shift+Enter / Alt+Enter | Newline (no send). **Ctrl+J** is the reliable path on macOS terminals |
 | Enter | Send (or run local `/`); **empty** + Needs Input open → `/parallel needs` panel |
-| ↑ ↓ | Prompt history (if not in `/` menu) |
+| ↑ ↓ | Move caret by **soft-wrap display row** when draft has >1 display row; else history (↑ from top) |
+| Ctrl+Y (prompt focus) | Copy **selection** if any, else entire draft |
+| Mouse drag on prompt | **App-level** select → release copies (native select cannot survive TUI redraw) |
+| Tab | Toggle prompt ↔ scrollback |
+| ↑ ↓ (history) | Prompt history only when caret cannot move within draft display rows |
 | Ctrl+P / Ctrl+N | Prompt history (always) |
 | Ctrl+R | Reverse history search (match draft · again = older) |
 | Ctrl+S | Resume session picker |
@@ -105,6 +109,7 @@ Also: **Ctrl+U** clears draft anytime (kill line).
 | Enter (other) | Return focus to prompt |
 | y | Copy selected block body |
 | Y | Copy selected block summary |
+| Ctrl+Y | Copy full retained transcript |
 | Type / Backspace | Return to prompt + edit |
 | Alt+↑↓ | From prompt: enter scrollback (one step) |
 | Shift+↑↓ (from prompt) | Enter scrollback + jump user turn |
@@ -195,7 +200,7 @@ Shell paints; engine executes. Switching shell does not change tools/models/rout
 |------|------|
 | Full vim mode in native pager | `/ink` → classic shell · or future opt-in |
 | Fullscreen block viewer | Later |
-| Multi-cursor / selection in prompt | Not supported |
+| Multi-cursor / non-contiguous selection in prompt | Not supported (single-range drag select + Ctrl+Y **is** supported) |
 | True binary image paste without path | OS/terminal limited; use file + `@path` |
 
 ---

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

@@ -38,3 +38,12 @@ date	version	clavue_measured_pct	clavue_total_pct	claim_ok	provider_matrix	eval_
 2026-07-11	10.5.0	96.7	94.3	1	-	-	-	-	-	clavue
 2026-07-11	10.5.0	96.7	94.3	1	-	-	-	-	-	clavue
 2026-07-11	10.5.0	96.7	94.3	1	-	-	-	-	-	clavue
+2026-07-11	10.5.0	96.7	94.3	1	-	-	-	-	-	clavue
+2026-07-11	10.5.0	96.7	94.3	1	-	-	-	-	-	clavue
+2026-07-11	10.5.0	96.7	94.3	1	-	-	-	-	-	clavue
+2026-07-11	10.5.1	96.7	94.3	1	-	-	-	-	-	clavue
+2026-07-11	10.5.1	96.7	94.3	1	-	-	-	-	-	clavue
+2026-07-11	10.5.1	96.7	94.3	1	-	-	-	-	-	clavue
+2026-07-11	10.5.2	96.7	94.3	1	-	-	-	-	-	clavue
+2026-07-11	10.5.2	96.7	94.3	1	-	-	-	-	-	clavue
+2026-07-11	10.5.2	96.7	94.3	1	-	-	-	-	-	clavue

package/package.json

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