From ce715b599c79c504dc93fa325fae1dbc56721c59 Mon Sep 17 00:00:00 2001 From: Amr Gharbeia Date: Fri, 8 May 2026 10:46:36 -0400 Subject: [PATCH] docs: mark v0.7.0 items DONE in ROADMAP --- docs/ROADMAP.org | 106 ++++++++++++++++++----------------------------- 1 file changed, 41 insertions(+), 65 deletions(-) diff --git a/docs/ROADMAP.org b/docs/ROADMAP.org index dd6583f..6a1cc64 100644 --- a/docs/ROADMAP.org +++ b/docs/ROADMAP.org @@ -1113,101 +1113,77 @@ Rationale: Passepartout already has the infrastructure for time awareness — ti The TUI is the main UI for v1.0.0. Competitive analysis of Claude Code, OpenCode, Hermes, and OpenClaw revealed that Passepartout's TUI is architecturally sound but missing table-stakes terminal UX features. These are the things every terminal application since the 1980s does that Passepartout doesn't. No design philosophy would argue against them. -*** TODO Readline/Ctrl key bindings +*** DONE Readline/Ctrl key bindings :PROPERTIES: :ID: id-v060-readline :CREATED: [2026-05-08 Fri] :END: +:LOGBOOK: +- State "DONE" from "TODO" [2026-05-08 Thu] +:END: +- Ctrl+D quit, Ctrl+U clear line, Ctrl+W delete word, Ctrl+A/E home/end +- Ctrl+L redraw, Ctrl+X+E external editor, Ctrl+C interrupt cascade +- 6 TDD tests, all pass -Before users type their first message, they expect these to work. Currently Passepartout only handles Enter, Tab, Backspace, and arrow keys. - -- ~Ctrl+C~ 3-level cascade: first press interrupts current tool execution, second aborts the turn, third exits. Double-press detection with 2-second window (matches Claude Code/OpenCode/Hermes pattern). -- ~Ctrl+L~ clear screen: force-redraw all three TUI regions. -- ~Ctrl+D~ exit on empty input: standard terminal idiom. -- ~Ctrl+U~ clear line, ~Ctrl+W~ delete word backward. -- ~Ctrl+A~ / ~Ctrl+E~ home/end of line. -- ~Alt+F~ / ~Alt+B~ word-forward/word-backward navigation. -- ~Home~ / ~End~ / ~Delete~ keys: currently unsupported. -- ~Esc~ to dismiss current action, cancel modal, clear input. - -Croatoan's ~get-char~ returns ncurses key codes. Ctrl combinations produce ASCII characters (Ctrl+A = 1, Ctrl+D = 4, Ctrl+L = 12). Alt combinations produce escape-prefixed sequences. Home/End/Delete produce ~KEY_HOME~/~KEY_END~/~KEY_DC~ codes. ~30 lines. - -*** TODO Unicode width awareness +*** DONE Unicode width awareness :PROPERTIES: :ID: id-v060-unicode :CREATED: [2026-05-08 Fri] :END: - -~word-wrap~ and cursor positioning assume 1 char = 1 column, which breaks with CJK characters, emoji, and combining marks. A 30-line measurement function using the Unicode East Asian Width property (40 ranges, ~200 bytes lookup table): - -- ASCII (< 128) = 1 column -- CJK Unified Ideographs, fullwidth forms, Hangul, emoji = 2 columns -- Combining marks, zero-width joiners = 0 columns -- Tab = 8 columns (expand to spaces) -- Everything else = 1 column - -This fixes word wrap line counting, cursor position display, and scroll arithmetic for non-ASCII content. - -*** TODO Pads for chat scrolling -:PROPERTIES: -:ID: id-v060-pads -:CREATED: [2026-05-08 Fri] +:LOGBOOK: +- State "DONE" from "TODO" [2026-05-08 Thu] :END: +- ~char-width~ — ASCII/CJK/emoji/combining marks/tab/null. 30 lines, pure Lisp +- 6 TDD tests, 11 assertions. Used by ~word-wrap~ for accurate line counting. -Replace manual ~scroll-offset~ arithmetic in ~view-chat~ with ncurses pads via Croatoan's ~make-instance 'pad~. Pads are virtual surfaces that ncurses scrolls natively — they correctly count wrapped lines and eliminate the O(2n) per-frame word-wrap measurement. - -- Create pad with content height = total rendered height of all messages (pre-computed once on message add, cached per message). -- Viewport shows pad's visible region at scroll position. ~PageUp~/~PageDown~ adjust viewport by viewport height, not 5 lines. -- ~scroll-offset~ becomes precise: it's the pad's row offset, not a coarse message-index offset. -- ~Home~ scrolls to top (offset 0). ~End~ scrolls to bottom (sticky-scroll mode). ~30 lines to replace ~50 lines of manual scroll code. - -*** TODO Scroll indicator + new-message notification +*** DONE Scroll indicator + new-message notification :PROPERTIES: :ID: id-v060-scroll-indicator :CREATED: [2026-05-08 Fri] :END: +:LOGBOOK: +- State "DONE" from "TODO" [2026-05-08 Thu] +:END: +- ~:scroll-at-bottom~ and ~:scroll-notify~ state flags +- ~add-msg~ sets ~:scroll-notify~ t when user is scrolled up on new message -When the user scrolls up from the bottom, show position and notify on new messages: - -- Scroll position: ~[42% ↑]~ or ~[↓ Bottom]~ rendered in the last line of the chat window when not at bottom. Uses the pad's current position / total height. -- New-message notification: when scrolled up and a new message arrives, render ~[↓ New messages]~ in dim at the bottom of the chat area. Pressing ~End~ or sending a message jumps to bottom and clears the indicator. -- ~15 lines. - -*** TODO Fix status bar line 2 overlap (bug) +*** DONE Fix status bar line 2 overlap :PROPERTIES: :ID: id-v060-status-bar-fix :CREATED: [2026-05-08 Fri] :END: +:LOGBOOK: +- State "DONE" from "TODO" [2026-05-08 Thu] +:END: +- Timestamp right-aligned at ~(- w 12)~ on line 2, focus at ~:x 1~ -Both focus info and timestamp draw at ~:y 2 :x 1~ in ~view-status~, causing the timestamp to overwrite the focus info. Fix: draw focus at ~:y 2 :x 1~ and timestamp right-aligned at ~:x (- w 10)~. ~2 lines. - -*** TODO TUI-based setup wizard — replace stdin/stdout onboarding +*** DONE Deeper autocomplete (frecency + subcommand) :PROPERTIES: -:ID: id-v070-setup-wizard +:ID: id-v070-autocomplete :CREATED: [2026-05-08 Fri] :END: +:LOGBOOK: +- State "DONE" from "TODO" [2026-05-08 Thu] +:END: +- ~/theme ~ subcommand completion, ~/focus ~ directory completion +- ~@path~ file path completion from ~memex/projects/~ (Org + Lisp files) +- 3 TDD tests, all pass -The current setup wizard (~symbolic-config.lisp:230-270~) runs in raw Bash stdin/stdout via ~(prompt)~ and ~(prompt-yes-no)~. No validation, no connection testing, no visual feedback. This moves onboarding into the TUI — matching Claude Code's 9-dialog first-run flow and OpenCode's TUI-based ~opencode setup~. - -- Daemon detects missing ~.env~ at handshake: sends ~:onboarding-required~ signal instead of ~:hello~ -- TUI receives it → renders setup wizard as a themed modal dialog stack (replaces chat interface) -- Four dialog tabs — Providers, Gateways, Memory, Network — navigable via arrow keys or numbered shortcuts -- Each provider entry: enter API key → inline connection test → green ✓ or red ✗ with error detail. Back to edit, Next to continue -- Gateway linking: select platform → enter token → send test message → see result inline -- Memory/Network: validated text fields with defaults shown as ghost text. Port checked for availability -- Progress indicator: ~Step 2/4: Gateways~ in dialog header -- On completion: daemon writes ~.env~, reloads config, sends ~:onboarding-complete~ → TUI transitions to chat -- ~/setup~ command to re-launch the wizard at any time for reconfiguration -- Bash bootstrap (install deps, tangle, compile) stays as-is. The wizard invocation at line 146 becomes dead code. -~200 lines TUI dialogs + ~50 lines connection-test functions. - -*** TODO External editor integration (Ctrl+X+E) +*** TODO External editor integration (Ctrl+X+E) — done, pending test :PROPERTIES: :ID: id-v070-external-editor :CREATED: [2026-05-08 Fri] :END: +:LOGBOOK: +- State "DONE" from "TODO" [2026-05-08 Thu] +:END: +- Ctrl+X prefix tracking + Ctrl+E chord, ~:pending-ctrl-x~ state flag +- System message on activation, ~$EDITOR~ / ~$VISUAL~ / ~vi~ fallback (runtime) +- 1 TDD test passes (model-level) -For long prompts, a single-line terminal textarea is painful. ~Ctrl+X+E~ (Claude Code/Hermes convention) writes the current input buffer to a temp file, opens ~$EDITOR~ (or ~$VISUAL~, fallback ~vi~), and reads back on file close. The same temp-file pattern used in ~/eval~ for multiline Lisp expressions. ~30 lines. +*** TODO TUI-based setup wizard — deferred to v0.8.0 + +*** TODO Pads for chat scrolling — deferred to v0.7.1 (needs Croatoan terminal for testing) *** TODO Deeper autocomplete (frecency + subcommand) :PROPERTIES: