diff options
| author | Gabriel Schneider <[email protected]> | 2026-11-17 01:15:28 -0300 |
|---|---|---|
| committer | Gabriel Schneider <[email protected]> | 2026-11-17 12:15:01 -0300 |
| commit | 2e6777e06e3f3e9d59ec847b98e0cb676d04296a (patch) | |
| tree | de4f2cecfe92706ca7033527d326042f6e90e8a5 /src/CHANGELOG.md | |
| parent | 91360c20923c8ce30829f19bcd192bb78a4c3918 (diff) | |
| download | pardes-2e6777e06e3f3e9d59ec847b98e0cb676d04296a.tar.gz pardes-2e6777e06e3f3e9d59ec847b98e0cb676d04296a.zip | |
main: the command line is commands that describe themselves, over the tree 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
Diffstat (limited to 'src/CHANGELOG.md')
| -rw-r--r-- | src/CHANGELOG.md | 16 |
1 files changed, 16 insertions, 0 deletions
diff --git a/src/CHANGELOG.md b/src/CHANGELOG.md index da489b82..17bd01a5 100644 --- a/src/CHANGELOG.md +++ b/src/CHANGELOG.md @@ -2,6 +2,22 @@ ## Unreleased +- `pardes` has commands, and they describe themselves: `ps`, `attach`, + `kill` and `new` for sessions, `do WORD` and `words` for the builtins, + `fs ls|read|write|ask|follow|stat|help|complete PATH` for the tree (a + refusal in the session's own words, where a mount says EINVAL), and + `help`, `completion bash|fish|zsh`, `skill` and `version`. `pardes help` + is a map of them; `help CMD` ends in examples; `help WORD` and `help + PATH` print what the session's /commands and /README say, and with no + session running, what a core made in the command's own process says. + A command acts on `-s NAME`, else `$PARDES_9P`, else the only session. + `pardes FILE` and every flag work as before; `--ps`, `--attach`, + `--kill`, `--kill-all`, `--help` and `--version` are the commands' old + spellings, for a release. A file named like a command opens as `./ps`. + The reference's "The pardes command" is `pardes help --all`, written by + `zig build builtins-json -Dplatform=tui`, and a test says when it is + stale. + - A drag draws no guide lines: no dashes where a pane or column would land, no rail for a carried column, no dashed seam under a pane rule held. The line between two columns no longer resizes them (nor, at a |
