Files

Amr Gharbeia b9a4318ef8 reorg: tangle to XDG, remove stale lisp files, fix tui input

- Changed all 50 org file :tangle targets from ../lisp/ to
  ~/.local/share/passepartout/lisp/ (XDG data dir)
- Removed 49 generated .lisp files from project lisp/ directory
- Removed tests/system-integration-tests.lisp (generated)
- Removed lisp/*.fasl (compiled, stale)
- Updated core-manifest.org to tangle .asd to XDG root
- Remapped quicklisp symlink: local-projects/passepartout → XDG

TUI fixes in channel-tui-main.org:
- Removed with-raw-terminal (stty raw breaks fd 0 reads in this SBCL)
- Use cat subprocess + pipe for keyboard input (via :input :interactive)
- Blocking read-char on pipe with with-timeout 0.1s for daemon processing
- Key events queued via drain-queue alongside daemon messages
- Full dialog key routing (Escape, Up/Down, Enter, filters, Backspace)
- SIGWINCH resize handling
- Post-handshake backend-size re-query
- Daemon version in status bar (was v0.5.0 hardcoded)
- Handshake version stored in state, no add-msg
- :daemon-version and :size-queried in state plist
- view-status uses draw-rect for background
- Test section gated with #+passepartout-tests

2026-05-14 12:34:06 -04:00

2.3 KiB

Raw Blame History

SKILL: CLI Gateway (org-skill-cli-gateway.org)

Overview
- Contract
Implementation
Test Suite
- Load-Time Sanity Check

Overview

The CLI Gateway is the simplest interface to Passepartout — raw stdin/stdout over TCP. It connects to the daemon's framed protocol and translates between terminal input/output and the plist-based communication format. No TUI, no ncurses, no dependencies beyond a TCP socket. Every other gateway (TUI, Emacs, Telegram) builds on this same protocol.

Contract

(channel-cli-input text): wraps text in a :user-input envelope with :source :CLI and injects into the pipeline via stimulus-inject.

Implementation

Package Context

(in-package :passepartout)

CLI Command Handling

;; REPL-VERIFIED: 2026-05-03T13:00:00

(defun channel-cli-input (text)
  "Processes raw text from the command line."
  (stimulus-inject (list :type :EVENT 
                         :payload (list :sensor :user-input :text text) 
                         :meta (list :source :CLI))))

Skill Registration

(defskill :passepartout-channel-cli
  :priority 100
  :trigger (lambda (ctx) (eq (getf (getf ctx :meta) :source) :CLI))
  :deterministic (lambda (action ctx) (declare (ignore ctx)) action))

Test Suite

(eval-when (:compile-toplevel :load-toplevel :execute)
  (ql:quickload :fiveam :silent t))

(defpackage :passepartout-channel-cli-tests
  (:use :cl :passepartout)
  (:export #:cli-suite))

(in-package :passepartout-channel-cli-tests)

(fiveam:def-suite cli-suite :description "Verification of the CLI Gateway")
(fiveam:in-suite cli-suite)

(fiveam:test test-channel-cli-input-format
  "Contract 1: channel-cli-input injects a properly formed signal without error."
  (handler-case
      (progn (channel-cli-input "hello") (fiveam:pass))
    (error (c)
      (fiveam:fail "channel-cli-input crashed: ~a" c))))

Load-Time Sanity Check

Verifies the function exists and can be called at load time without depending on FiveAM macro resolution in the jailed package.

(handler-case
    (progn (channel-cli-input "test-load") (log-message "CLI: Load-time test OK"))
  (error (c) (log-message "CLI: Load-time test FAILED: ~a" c)))

2.3 KiB Raw Blame History