summaryrefslogtreecommitdiff
path: root/docs/typ/command-line.txt
Commit message (Collapse)AuthorAge
* integration: the command line as commands that describe themselves, with the ↵Gabriel Schneider14 hours
| | | | | | | | | editor library, the GPU move, the terminal, the plumber and the diff work A merge of pardes-next (nsyzqrms) and pardes-cli (xurkunwk). One conflict, the changelog (both sides' entries kept); docs/typ/command-line.txt written again by builtins-json on the merge (the tree's README and words gained the plumber's files and a pane's rows). pardes builds beside a cloud9 at c9-cli (by path, until that cloud9 is published). Gated against the integration line's baseline (.scratch/sketch/gpu/mbase): frame corpus 77/77 identical in Debug and in ReleaseFast, the gated window +0.160% instructions (spread 0.39%, threshold 0.5%), unit-test on gui 1587/1595 with no failure the baseline has not; on tui core-test 811/950 (139 skipped), shell-test 993/996, behaviour-test 269/273 and unit-test 1528/1536 (the four addon ABI tests the base fails, and the perf baseline's harness mismatch), process-test 2 of 144 failed (lspcomplete and lspcompletemoved, the base's; ttytaken failed once under load and passed its retry), lib-test, hxdiff 658, parity 738 and hxlib 538 with 0 mismatches, replicas pass. Co-Authored-By: Claude Fable 5.2 <[email protected]> Claude-Session: https://claude.ai/code/session_016Y9MNBECMWcJD5pdS4SR6T
* main: the command line is commands that describe themselves, over the tree ↵Gabriel Schneider14 hours
that does The user: "the cli should be like a living documentation, similar to 9p and maybe even share the source code but with different sinks", rex's CLI the model. pardes [flags] [FILE] opens, starts or pages as it did; a first word naming a command is that command (a file named so is ./ps, or after --): ps, attach [NAME], kill NAME|--all, new [flags] [FILE] for sessions; do WORD [ARG] and words [GROUP] for the builtins; fs VERB [PATH] for the tree; help [CMD|WORD|PATH], completion SHELL, skill, version. One definition, several sinks. main.zig's `cmds` (an EnumArray over the Cmd enum: group, args, first-screen line, doc, examples, see-also) is both what args[1] is matched against and every command's help; `flags` (over the Flag enum: what it takes, its doc, session/open/old) is both the flag loop's parser and `help new`. The 70-line help_text and the flag enum kept apart from it are gone; every flag behaves as before, and --ps, --attach[=NAME], --kill=NAME, --kill-all, -h/--help and --version are the commands' old spellings for a release (EDITOR='pardes --wait' unchanged). What a word or a file does is the tree's to say: words, help WORD, help PATH, fs and the completions read /commands and /README over cloud9's Fsys, from the session (-s NAME, else $PARDES_9P, else the only one whose socket answers) or, with none, from a core this process makes (Pardes.create, never stepped: no shell, file or socket) and serves on one end of a socket pair to an Fsys on the other (`Here`: cloud9's engine, one thread), so both are the same client over the same tree. With no session, fs ls/stat/help/complete and a read of README, commands or ctl answer; a read of anything else, or a write, says it is a running session's and how to start one. do picks the ctl by /commands' scope (a pane's word needs $PARDES_PANE or -p N) and prints a refusal in the session's words. completion prints a bash, fish or zsh script that asks `pardes completion -- WORDS` back. skill prints src/skill.txt, the recipes and traps, which leaves the inventory to pardes help. version adds the 9P the tree speaks. The reference's "The pardes command" includes docs/typ/command-line.txt, `pardes help --all` (never a session's), which the builtins-json step (-Dplatform=tui) now writes too; a main.zig test fails when it is stale. test/process/cli.zig: five cases through the binary, with and without a session; flags' eight pass unchanged. Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_016Y9MNBECMWcJD5pdS4SR6T