#+TITLE: Passepartout TUI — View #+PROPERTY: header-args:lisp :tangle ../lisp/channel-tui-view.lisp * View |Pure render functions. Each takes the cl-tty backend and current state. |State is read via ~(st :key)~ — no mutation here. ** Contract 1. (view-status win): renders the status bar with connection info, msg count, scroll offset, rule counter, focus map (v0.4.0), and timestamp. Two lines: line 1 (status + rules), line 2 (focus + time). 2. (view-chat win h): renders the scrolled chat message list. Takes window and available height. Messages are color-coded: green (user), white (agent), yellow (system). 3. (view-input win): renders the input line with cursor and typing indicator. 4. (redraw sw cw ch iw): dispatches redraws based on ~(st :dirty)~ flags (status, chat, input). Minimizes terminal writes. 5. (char-width ch): returns the terminal column width of character CH. ASCII < 128 = 1. CJK, fullwidth, emoji = 2. Combining marks = 0. Tab = 8. Used by word-wrap for accurate line counting (v0.7.0). 6. (view-status win): v0.7.0 — timestamp right-aligned at (- w 12) on line 2, focus info at :x 1. No overlap. ** Status Bar The status bar, as of v0.4.0, renders Passepartout's three differentiator visualizations — data only available because of the deterministic gate architecture: - *Rule counter* (~Rules:N~): the number of pending HITL actions from the Dispatcher's ~*hitl-pending*~ hash table. The user watches this tick up as they teach the agent their preferences through approve/deny decisions. - *Focus map* (~[Focus: ]~): the foveal focus from the daemon's signal context. Shows the user what the agent is currently looking at. - *Gate trace* (not rendered in status bar — attached to individual messages via ~:gate-trace~ field for future collapsible rendering per message). All three enrichments cost 0 LLM tokens — they are daemon-state queries that the TUI actuator attaches to the response plist before transmission. #+BEGIN_SRC lisp :tangle ../lisp/channel-tui-view.lisp (in-package :passepartout.channel-tui) (defun word-wrap (text width) "Wrap TEXT to at most WIDTH columns. Splits on word boundaries. Returns a list of strings, one per line." (let ((lines nil)) (loop while (> (length text) width) do (let ((break (or (position #\Space text :end width :from-end t) width))) (push (subseq text 0 break) lines) (setf text (string-left-trim '(#\Space) (subseq text break))))) (push text lines) (nreverse lines))) (defun view-status (fb w) (let* ((degraded (and (find-package :passepartout) (boundp (find-symbol "*DEGRADED-COMPONENTS*" :passepartout)) (symbol-value (find-symbol "*DEGRADED-COMPONENTS*" :passepartout)))) (bg (if degraded (theme-color :degraded) nil))) ;; Line 1: Connection, mode, msgs, scroll, rules, streaming/busy (cl-tty.backend:draw-text fb 1 1 (format nil " Passepartout ~a [~a] msgs:~a scroll:~a Rules:~a~a" (if (st :connected) "● Connected" "○ Disconnected") (string-upcase (string (st :mode))) (length (st :messages)) (if (> (st :scroll-offset) 0) (format nil "~a↑" (st :scroll-offset)) "0") (or (st :rule-count) 0) (if (st :streaming-text) " [streaming]" (if (st :busy) " …thinking" ""))) (theme-color (if (st :connected) :connected :disconnected)) bg) ;; Line 2: Focus + Timestamp (let ((focus-info (or (st :foveal-id) ""))) (when (and focus-info (> (length focus-info) 0)) (cl-tty.backend:draw-text fb 1 2 (format nil " [Focus: ~a]" focus-info) (theme-color :timestamp) bg))) (cl-tty.backend:draw-text fb (max 1 (- w 12)) 2 (format nil " ~a" (now)) (theme-color :timestamp) bg) ;; Line 3: Directory, LSP, MCP, commands hint (v0.8.0) (let* ((cwd (or (uiop:getenv "PWD") (uiop:getcwd))) (dir (subseq cwd (max 0 (- (length cwd) (- w 45))))) (mcp-count (or (st :mcp-count) 0)) (hint " Ctrl+P: commands /help: help")) (cl-tty.backend:draw-text fb 1 3 (format nil " ~a" dir) (theme-color :dim) bg) (cl-tty.backend:draw-text fb (+ 2 (length dir)) 3 "●" (theme-color :accent) bg) (cl-tty.backend:draw-text fb (+ 5 (length dir)) 3 (format nil " MCP:~d" mcp-count) (theme-color :dim) bg) (cl-tty.backend:draw-text fb (- w (length hint) 2) 3 hint (theme-color :timestamp) bg)) ;; Line 4: Degraded mode warning (v0.8.0) (when degraded (cl-tty.backend:draw-text fb 1 4 " ⚠ Degraded mode — components unavailable" (theme-color :warning) (theme-color :degraded))))) ;; v0.7.2: search-highlight — wrap matching text in **bold** for markdown (defun search-highlight (content query) "Wrap occurrences of QUERY in CONTENT with **bold** markers." (let ((lower-content (string-downcase content)) (lower-query (string-downcase query)) (result "") (pos 0)) (when (and query (> (length query) 0)) (loop (let ((found (search lower-query lower-content :start2 pos))) (unless found (return)) (setf result (concatenate 'string result (subseq content pos found) "**" (subseq content found (+ found (length query))) "**")) (setf pos (+ found (length query))))) (setf result (concatenate 'string result (subseq content pos))) (if (string= result "") content result)))) (defun view-chat (fb w h) (let* ((msgs (st :messages)) (total (length msgs)) (max-lines (- h 2)) (is-search (st :search-mode)) (y 1)) ;; v0.8.0: search mode header (when is-search (let* ((matches (st :search-matches)) (idx (st :search-match-idx)) (query (st :search-query)) (header (format nil "Search: ~d matches for '~a' (~d/~d) — Esc to exit" (length matches) query (1+ idx) (length matches)))) (cl-tty.backend:draw-text fb 1 y header (theme-color :highlight) nil) (incf y) (decf max-lines))) ;; Pre-compute display lines for each message (let ((msg-lines (make-array total))) (dotimes (i total) (let* ((msg (aref msgs i)) (role (getf msg :role)) (content (getf msg :content)) (time (or (getf msg :time) "")) (content-show (if is-search (search-highlight content (st :search-query)) content)) (lines (case role (:user (cl-tty.box:word-wrap (format nil "│ [~a] ~a" time content-show) (- w 2))) (:agent (let* ((nodes (cl-tty.markdown:parse-blocks content-show)) (md-lines (and nodes (cl-tty.markdown:render-md nodes)))) (if md-lines (progn (setf (first md-lines) (format nil "[~a] ~a" time (first md-lines))) md-lines) (list (format nil "[~a] " time))))) (t (cl-tty.box:word-wrap (format nil " [~a] ~a" time content-show) (- w 2)))))) ;; v0.8.0: tool calls — collapsible (let ((tc (getf msg :tool-calls))) (when tc (if (st :expand-tool-calls) (dolist (call tc) (setf lines (append lines (list (format nil " ╎ Tool: ~a" (or (getf call :name) "unknown")))))) (setf lines (append lines (list (format nil " ╎ ~a tool call(s)" (length tc)))))))) ;; v0.8.0: gate trace — collapsible with left border (let ((gt (getf msg :gate-trace))) (when gt (if (member i (st :collapsed-gates)) (setf lines (append lines (list (format nil "╎ Gate trace: ~a gates — Ctrl+G toggle" (length gt))))) (dolist (entry (passepartout::gate-trace-lines gt)) (setf lines (append lines (list (concatenate 'string "╎ " (car entry))))))))) (setf (aref msg-lines i) lines))) ;; Count visible messages from end (let ((msg-count 0) (lines-remaining max-lines)) (loop for i from (1- total) downto 0 while (> lines-remaining 0) do (let ((nlines (length (aref msg-lines i)))) (if (<= nlines lines-remaining) (progn (decf lines-remaining nlines) (incf msg-count)) (setf lines-remaining 0)))) ;; Render from the correct starting message (let* ((scroll-skip (st :scroll-offset)) (start (max 0 (- total msg-count scroll-skip)))) (loop for i from start below total while (< y (1- h)) do (let* ((msg (aref msgs i)) (role (getf msg :role)) (lines (aref msg-lines i)) (color (theme-color (case role (:user :user) (:agent :agent) (:system :system) (t :agent)))) (is-panel (getf msg :panel)) (is-resolved (getf msg :panel-resolved))) ;; HITL panel coloring (when is-panel (setf color (if is-resolved (theme-color :dim) (theme-color :hitl)))) (dolist (line lines) (when (< y (1- h)) (cl-tty.backend:draw-text fb 1 y line color nil) (incf y)))))))))) #+END_SRC ** Input Line #+BEGIN_SRC lisp :tangle ../lisp/channel-tui-view.lisp (defun view-input (fb w) (let* ((text (input-string)) (pos (or (st :cursor-pos) 0)) (display-start (max 0 (- pos (1- w)))) (visible (subseq text display-start (min (length text) (+ display-start w))))) (cl-tty.backend:draw-text fb 0 0 (format nil "~a " visible) (theme-color :input) nil))) #+end_src ** Sidebar #+BEGIN_SRC lisp :tangle ../lisp/channel-tui-view.lisp (defun view-sidebar (fb w h) (let ((x (- w (st :sidebar-width)))) ;; Vertical separator (dotimes (row h) (cl-tty.backend:draw-rect fb (1- x) row 1 1 :bg :dim)) ;; Render panels (let ((y 1)) ;; Focus panel (when (st :foveal-id) (cl-tty.backend:draw-text fb (1+ x) y " Focus" (theme-color :highlight) nil) (incf y) (cl-tty.backend:draw-text fb (1+ x) y (format nil " ~a" (st :foveal-id)) (theme-color :agent) nil) (incf y 2)) ;; Rules panel (let ((rules (or (st :rule-count) 0))) (cl-tty.backend:draw-text fb (1+ x) y " Rules" (theme-color :highlight) nil) (incf y) (cl-tty.backend:draw-text fb (1+ x) y (format nil " ~d active" rules) (theme-color :agent) nil) (incf y 2)) ;; Context panel — token gauge (cl-tty.backend:draw-text fb (1+ x) y " Context" (theme-color :highlight) nil) (incf y) (let* ((msg-count (length (st :messages))) (est (* msg-count 60)) (limit 8192) (pct (min 100 (floor (* 100 est) limit))) (bar-len (floor pct 10)) (bar (make-string bar-len :initial-element #\#))) (cl-tty.backend:draw-text fb (1+ x) y (format nil " [~a~a]" bar (make-string (- 10 bar-len) :initial-element #\Space)) (theme-color :dim) nil) (incf y) (cl-tty.backend:draw-text fb (1+ x) y (format nil " ~d%" pct) (theme-color :timestamp) nil) (incf y 2)) ;; MCP count (let ((mcp (or (st :mcp-count) 0))) (cl-tty.backend:draw-text fb (1+ x) y " MCP" (theme-color :highlight) nil) (incf y) (cl-tty.backend:draw-text fb (1+ x) y (format nil " ~d server~:p" mcp) (theme-color :agent) nil))))) #+END_SRC ** Redraw (dirty-flag dispatch) #+begin_src lisp (defun redraw (fb w h) (destructuring-bind (sd cd id) (st :dirty) (let* ((degraded (and (find-package :passepartout) (boundp (find-symbol "*DEGRADED-COMPONENTS*" :passepartout)) (symbol-value (find-symbol "*DEGRADED-COMPONENTS*" :passepartout)))) (chat-h (- h (if degraded 6 5)))) (when sd (view-status fb w)) (when cd (view-chat fb w chat-h)) (when id (view-input fb w)) (when (and (st :sidebar-visible) (>= w 120)) (view-sidebar fb w h)) (setf (st :dirty) (list nil nil nil))))) #+END_SRC * Implementation — v0.7.0 additions #+BEGIN_SRC lisp :tangle ../lisp/channel-tui-view.lisp (in-package :passepartout) (defun char-width (ch) "Returns the terminal column width of character CH. ASCII < 128 = 1. CJK, fullwidth, emoji = 2. Combining marks = 0. Tab = 8." (let ((code (char-code ch))) (cond ((= code 9) 8) ((< code 32) 0) ((<= code 127) 1) ((<= #x4E00 code #x9FFF) 2) ((<= #x3400 code #x4DBF) 2) ((<= #x3040 code #x309F) 2) ((<= #x30A0 code #x30FF) 2) ((<= #xAC00 code #xD7AF) 2) ((<= #xFF01 code #xFF60) 2) ((<= #xFFE0 code #xFFE6) 2) ((<= #x1F300 code #x1F9FF) 2) ((<= #x2600 code #x27BF) 2) ((<= #x0300 code #x036F) 0) ((<= #x20D0 code #x20FF) 0) ((<= #xFE00 code #xFE0F) 0) (t 1)))) #+END_SRC * v0.7.1 — Markdown Rendering #+BEGIN_SRC lisp :tangle ../lisp/channel-tui-view.lisp (in-package :passepartout) (defun parse-markdown-spans (text) "Parse inline markdown. Returns list of (text . (:bold/:underline/:code/:url ...))." (let ((results nil) (pos 0) (len (length text))) (labels ((earliest (a b) (cond ((and a (or (null b) (< a b))) a) (b b)))) (loop (when (>= pos len) (return)) (let* ((bold (search "**" text :start2 pos)) (code (search "`" text :start2 pos)) (italic (search "*" text :start2 pos)) (http (search "http://" text :start2 pos)) (https (search "https://" text :start2 pos)) (url-s (or https http))) (flet ((pick (tag delim) (let ((end (search delim text :start2 (+ pos (length delim))))) (when end (push (cons (subseq text (+ pos (length delim)) end) (case tag (:bold '(:bold t)) (:code '(:code t :bgcolor :dim)) (:underline '(:underline t)) (:url '(:url t)))) results) (setf pos (+ end (length delim))) t))) (url-end (start) (or (position-if (lambda (c) (find c '(#\Space #\Newline #\Tab #\)))) text :start start) len))) (let ((next (earliest (earliest (earliest bold code) italic) url-s))) (cond ((and bold (eql bold next)) (unless (pick :bold "**") (incf pos 2))) ((and code (eql code next)) (unless (pick :code "`") (incf pos))) ((and italic (eql italic next)) (unless (pick :underline "*") (incf pos))) ((and url-s (eql url-s next)) (let ((ue (url-end url-s))) (push (cons (subseq text url-s ue) '(:url t)) results) (setf pos ue))) (t (push (cons (subseq text pos) nil) results) (return)))))))) (nreverse results))) (defun render-styled (fb segments y x w) "Render markdown segments to cl-tty backend. Returns next y." (dolist (seg segments) (let* ((text (or (car seg) "")) (attrs (cdr seg)) (bold (getf attrs :bold)) (code (getf attrs :code)) (url (getf attrs :url))) (declare (ignore code)) (cl-tty.backend:draw-text fb x y text (cond (url (theme-color :highlight)) (t (theme-color (or (getf attrs :role) :agent)))) nil :bold bold) (incf x (length text)))) y) (defun parse-markdown-blocks (text) "Split text at ``` code block boundaries." (let ((r nil) (p 0) (l (length text))) (loop (when (>= p l) (return)) (let ((bs (search "```" text :start2 p))) (unless bs (push (cons (subseq text p) nil) r) (return)) (when (> bs p) (push (cons (subseq text p bs) nil) r)) (let* ((ao (+ bs 3)) (le (or (position #\Newline text :start ao) l)) (lang (string-trim " \r\n\t" (if (< le l) (subseq text ao le) ""))) (cs (if (< le l) (1+ le) l)) (cp (search "```" text :start2 cs)) (ce (or cp l)) (content (string-trim "\r\n" (subseq text cs ce)))) (push (list :code-block t :lang lang :content content) r) (setf p (if cp (+ cp 3) l))))) (nreverse r))) (defun syntax-highlight (code lang) "Highlight Lisp code: strings, comments, keywords, function calls." (declare (ignore lang)) (let* ((r nil) (p 0) (l (length code)) (kw '("defun" "defvar" "defparameter" "let" "let*" "lambda" "if" "when" "unless" "cond" "loop" "dolist" "dotimes" "progn" "prog1" "return" "setf" "setq" "format" "and" "or" "not" "list" "cons" "quote" "function" "declare" "ignore" "t" "nil"))) (flet ((wordp (c) (or (alphanumericp c) (find c "-*+/?!_=<>")))) (loop (when (>= p l) (return)) (let* ((ss (position #\" code :start p)) (sc (position #\; code :start p)) (sp (position #\( code :start p)) (next (min (or ss l) (or sc l) (or sp l)))) (when (> next p) (push (cons (subseq code p next) nil) r) (setf p next)) (when (>= p l) (return)) (cond ((eql p ss) (let ((e (or (position #\" code :start (1+ p)) l))) (push (cons (subseq code p (min (1+ e) l)) '(:fgcolor :string)) r) (setf p (min (1+ e) l)))) ((eql p sc) (let ((e (or (position #\Newline code :start p) l))) (push (cons (subseq code p e) '(:fgcolor :comment)) r) (setf p e))) ((eql p sp) (push (cons "(" nil) r) (incf p) (let ((fe (loop for i from p below l for c = (char code i) while (wordp c) finally (return i)))) (when (> fe p) (let ((fs (subseq code p fe))) (push (cons fs (list :fgcolor (if (member fs kw :test #'string=) :keyword :function))) r) (setf p fe))))))))) (nreverse r))) #+END_SRC * v0.7.2 — Gate Trace #+BEGIN_SRC lisp :tangle ../lisp/channel-tui-view.lisp (in-package :passepartout) (defun gate-trace-lines (trace) "Convert gate-trace plist to display lines." (let ((lines nil)) (dolist (entry trace) (let* ((gate (getf entry :gate)) (result (getf entry :result)) (reason (getf entry :reason)) (name (or gate "unknown")) (color (case result (:passed :gate-passed) (:blocked :gate-blocked) (:approval :gate-approval) (t :dim))) (prefix (case result (:passed " \u2713 ") (:blocked " \u2717 ") (:approval " \u2192 ") (t " ? "))) (text (format nil "~a~a~@[~a~]~@[~a~]" prefix name (when reason (format nil ": ~a" reason)) (if (eq result :approval) " (HITL required)" "")))) (push (cons text (list :fgcolor color)) lines))) (nreverse lines))) #+END_SRC * Test Suite #+BEGIN_SRC lisp :tangle ../lisp/channel-tui-view.lisp (eval-when (:compile-toplevel :load-toplevel :execute) (ql:quickload :fiveam :silent t)) (defpackage :passepartout-tui-view-tests (:use :cl :fiveam :passepartout) (:export #:tui-view-suite)) (in-package :passepartout-tui-view-tests) (def-suite tui-view-suite :description "TUI view rendering helpers") (in-suite tui-view-suite) (test test-char-width-ascii "Contract 5: ASCII characters (< 128) have width 1." (is (= 1 (passepartout::char-width #\a))) (is (= 1 (passepartout::char-width #\Space))) (is (= 1 (passepartout::char-width #\@)))) (test test-char-width-tab "Contract 5: tab character has width 8." (is (= 8 (passepartout::char-width #\Tab)))) (test test-char-width-cjk "Contract 5: CJK characters have width 2." (is (= 2 (passepartout::char-width #\日)))) (test test-char-width-null "Contract 5: null has width 0." (is (= 0 (passepartout::char-width #\Nul)))) (test test-markdown-bold "Contract 7: parse-markdown-spans detects **bold**." (let ((segments (passepartout::parse-markdown-spans "hello **world**!"))) (is (= 3 (length segments))))) (test test-markdown-plain "Contract 7: plain text returns single segment." (let ((segments (passepartout::parse-markdown-spans "plain"))) (is (= 1 (length segments))) (is (string= "plain" (caar segments))))) (test test-markdown-url "Contract 7: parse-markdown-spans detects URLs." (let ((segments (passepartout::parse-markdown-spans "see https://example.com for more"))) (is (>= (length segments) 2)) (is (find t segments :key (lambda (s) (getf (cdr s) :url)))))) (test test-markdown-blocks "Contract 8: parse-markdown-blocks detects code blocks." (let* ((text (format nil "before~%```lisp~%(+ 1 2)~%```~%after")) (segs (passepartout::parse-markdown-blocks text))) (is (= 3 (length segs))) (let ((code (second segs))) (is (eq t (getf code :code-block))) (is (string= "lisp" (getf code :lang))) (is (string= "(+ 1 2)" (string-trim '(#\Space #\Newline) (getf code :content))))))) (test test-markdown-blocks-no-close "Contract 8: unclosed code block returns content." (let* ((text (format nil "```~%unclosed code")) (segs (passepartout::parse-markdown-blocks text))) (is (= 1 (length segs))) (is (eq t (getf (first segs) :code-block))))) (test test-syntax-highlight "Contract 9: syntax-highlight colors Lisp code." (let ((segs (passepartout::syntax-highlight "(defun foo (x) (+ x 1))" "lisp"))) (is (>= (length segs) 3)))) (test test-syntax-highlight-keyword "Contract 9: syntax-highlight colors keywords." (let ((segs (passepartout::syntax-highlight "(let ((x 1)) (+ x 2))" "lisp"))) (is (>= (length segs) 2)) (is (find :keyword segs :key (lambda (s) (getf (cdr s) :fgcolor)))))) (test test-syntax-highlight-function "Contract 9: syntax-highlight colors function calls." (let ((segs (passepartout::syntax-highlight "(+ 1 2)" "lisp"))) (is (>= (length segs) 2)) (is (find :function segs :key (lambda (s) (getf (cdr s) :fgcolor)))))) (test test-gate-trace-lines-passed "Contract 9: gate-trace-lines for passed gate." (let ((lines (passepartout::gate-trace-lines '((:gate "path" :result :passed))))) (is (= 1 (length lines))) (is (eq :gate-passed (getf (cdar lines) :fgcolor))))) (test test-gate-trace-lines-blocked "Contract 9: gate-trace-lines for blocked gate." (let ((lines (passepartout::gate-trace-lines '((:gate "shell" :result :blocked :reason "rm"))))) (is (= 1 (length lines))) (is (search "rm" (caar lines))))) (test test-gate-trace-lines-approval "Contract 9: gate-trace-lines for approval gate." (let ((lines (passepartout::gate-trace-lines '((:gate "network" :result :approval))))) (is (= 1 (length lines))) (is (search "HITL" (caar lines))))) (test test-init-state-has-collapsed-gates "Contract v0.7.2: init-state includes :collapsed-gates field." (passepartout.channel-tui::init-state) (let ((cg (passepartout.channel-tui::st :collapsed-gates))) (is (null cg)))) (test test-sidebar-state "Contract v0.8.0: init-state includes :sidebar-visible (nil) and :sidebar-width (30)." (passepartout.channel-tui::init-state) (is (null (passepartout.channel-tui::st :sidebar-visible))) (is (= 30 (passepartout.channel-tui::st :sidebar-width)))) (test test-sidebar-not-shown-narrow "Contract v0.8.0: sidebar is skipped in redraw when terminal width < 120." (passepartout.channel-tui::init-state) (setf (passepartout.channel-tui::st :sidebar-visible) t) ;; Simulating redraw logic: should not invoke view-sidebar when w < 120. ;; If view-sidebar were called with a nil fb it would error; this verifies ;; the guard in redraw protects the call. (let ((fb nil) (w 100) (h 24)) (is (not (and (passepartout.channel-tui::st :sidebar-visible) (>= w 120)))))) (test test-status-bar-tokens "v0.8.0: status bar uses :degraded and :warning theme tokens." (is (getf passepartout.channel-tui::*tui-theme* :degraded)) (is (getf passepartout.channel-tui::*tui-theme* :warning))) #+END_SRC