summaryrefslogtreecommitdiff
path: root/docs/next-plumber.md
diff options
context:
space:
mode:
authorGabriel Schneider <[email protected]>2026-11-17 03:51:15 -0300
committerGabriel Schneider <[email protected]>2026-11-17 12:15:01 -0300
commit79a1e816ceb13ef81b712007716c8add2de75434 (patch)
tree1714b1bf19da3a58be2623ffe29e3f8be1b21fe3 /docs/next-plumber.md
parenta22b579ad2df8d1811f0e194fa1bbc06e2282cf8 (diff)
parentf1af015f01e4e8d42f6224c4d4063f3aea218f5a (diff)
downloadpardes-79a1e816ceb13ef81b712007716c8add2de75434.tar.gz
pardes-79a1e816ceb13ef81b712007716c8add2de75434.zip
integration: the terminal a module of its own, with the plumber whole and the walker's cheaper compile
A merge of term-phase1a and pardes-next, no conflicts. core-test (the core with no terminal) 411 passed, 535 skipped of 946; shell-test (the same tests, the terminal compiled in) 989/989, on tui. Co-Authored-By: Claude Fable 5.2 <[email protected]> Claude-Session: https://claude.ai/code/session_016Y9MNBECMWcJD5pdS4SR6T
Diffstat (limited to 'docs/next-plumber.md')
-rw-r--r--docs/next-plumber.md29
1 files changed, 29 insertions, 0 deletions
diff --git a/docs/next-plumber.md b/docs/next-plumber.md
index 76a86bea..178814b3 100644
--- a/docs/next-plumber.md
+++ b/docs/next-plumber.md
@@ -867,6 +867,35 @@ The options as round 1 put them:
$0`, `9 page $file`), at the cost of a host effect generalising
`open_link`.
+## What phases 2-4 did otherwise (2026-11-17)
+
+- **Q4 is (b) now**, the coordinator's lean while the user was away: a
+ program a rule starts runs detached, as Plan 9's plumber starts one
+ (Effect.start, every host's host_io.startDetached: setsid, stdin, stdout
+ and stderr `/dev/null`, every other fd closed, argv exec'd in wdir with no
+ shell). Its output is not the session's log, as the lean said: that needs
+ an inbox message and an Event through the tui, window, macOS and daemon
+ hosts, which other agents are changing. A failure to start (the program
+ not found, its directory gone) is said and logged, the child's errno
+ carried back by a close-on-exec pipe. Its directory and words fit 256
+ bytes, an effect's inline payload.
+- **Only a diff paged is sent** (§5.4 had every page sent). Text paged is
+ `type text`, which the look rules do see, contrary to §5.4: their
+ `matches` would run over the whole output (up to a MiB, and the regular
+ expressions' 300 ms budget) at each page. A diff is `text/x-diff`, which
+ every look rule refuses at its first pattern.
+- **A port pardes reads itself (edit, web, a kind) asks nobody** whether a
+ program reads it: its readers' copies are the authority's own to hand
+ out, and pardes reads it anyway, so a URL's look still speculates whole.
+ Only another port's dispose asks `tape.authority`.
+- **The rules in force are read once** and kept until their text changes
+ (by its hash, derived state): per send the parse was 29k instructions
+ in a fast build, about half of a URL's send and 40% of a word's look.
+- **`showdata` from another sender** makes a clean pane of its `filename`
+ (acme's plumbshow); the pager's own message is shown already.
+- **plumb/rules' rest read at the close**, refused there, is an `err` in
+ the log (Plan 9 loses it); the T1 monkey models it as a line file's.
+
## Not verified
- **Nothing was built or run.** All sizes are estimates, and the test counts are