A write of an Edit block reaches Edit whole, on a pane's ctl, the root's and exec

Every write was split into lines, so a { group or an a/c/i text block written to ctl or exec became lines of their own: i/.../ and } ran as shell command panes that exited 127. An Edit line now takes the lines after it while its group is open or its text block waits for its . line (sam_edit.needsMore, asking sam's parser), on all three; the root ctl takes Edit at the active pane. s/re/text/N counts as sN/re/text/ does. The docs and the skill show a block written by heredoc or env printf, since bash's printf writes line by line, and take round 5's doc list: get refusing once, the (xN) on a repeated err, limit bounding only a forward search's end, line:col's clamping, and $NINE_MOUNT under 9ns --unix.

Co-Authored-By: Claude Opus 5.5 <[email protected]>

1 files changed, 24 insertions, 6 deletions

diff --git a/.agents/skills/pardes-9p/SKILL.md b/.agents/skills/pardes-9p/SKILL.md
index 57ebd6cf..d34fa8b3 100644
--- a/.agents/skills/pardes-9p/SKILL.md
+++ b/.agents/skills/pardes-9p/SKILL.md
@@ -40,8 +40,9 @@ the `pid`, `version` and `panes` of a session new enough to serve it.
 machine. It is not the per-pane kernel mount the `Tty9p` builtin makes, which
 gives one pane's shell `$PARDES_MOUNT`; see [docs/v9fs.md](../../../docs/v9fs.md)
 for that. Either mountpoint serves the same tree. A `9ns --unix SOCKET -- cmd`
-mount exists only inside `cmd`'s private namespace; to share one, use the
-registry (`9ns --mntgen`).
+mount exists only inside `cmd`'s private namespace, and there `$NINE_MOUNT` is
+the session's own root (`$NINE_MOUNT/index`), not a registry; to share one,
+use the registry (`9ns --mntgen`).
 
 A running session serves whatever binary started it. If a listing does not
 match this document, that session predates the change; restart it.
@@ -155,7 +156,21 @@ Rename everywhere, or any sam edit, is one write: `echo 'Edit ,x/foo/c/bar/'
 v c a i d s p = m t u` and `{ }` (commands in braces one to a line, so from
 exec or a tag, not a one-line ctl write). Its changes are one undo step, and
 one that fails changes nothing and fails the write with acme's words (`Edit:
-no substitution`), logged as `err`. `p` and `=` print to the directory's
+no substitution`), logged as `err`. A block goes in one write to the pane's
+`ctl`, the root `ctl` (the active pane) or `exec`: an `Edit` line takes the
+lines after it until its `{` closes or its `a`/`c`/`i` text ends with `.`.
+bash's builtin `printf` writes line by line, so use a heredoc or `env printf`:
+
+```sh
+cat > $pane/ctl <<'END'
+Edit ,x/area_of/{
+i/[/
+a/]/
+}
+END
+env printf 'Edit ,x/foo/{\ni/</\na/>/\n}\n' > $pane/ctl
+```
+ `p` and `=` print to the directory's
 `+Errors`. Not there: `b B D e r w f X Y`, `< | >`, and `\1`-`\9` in `s`.
 
 | Operation | Shell | Python client |
@@ -172,7 +187,7 @@ inserts after the first: write `addr` again before each replacement.
 Truncating `data` is pardes's own (acme ignores OTRUNC and always inserts).
 | Read the selection | `cat $pane/dot` (offsets), `cat $pane/sel` (text) | the same two reads |
 | Select the addressed range | `cp $pane/addr $pane/dot` | `client.write(pane + '/dot', client.read(pane + '/addr'))` |
-| Reload from disk | `echo get > $pane/ctl` | `client.write(pane + '/ctl', b'get\n')` |
+| Reload from disk | `echo get > $pane/ctl` (refused once while there are unsaved edits; again discards) | `client.write(pane + '/ctl', b'get\n')` |
 | Close it | `rmdir $pane` | `client.remove(pane)` |
 
 `addr`, `dot` and `limit` each read the pair of offsets they also accept, which
@@ -194,8 +209,11 @@ past a step budget (about 300 ms) fails with `regular expression search
 gave up, ...`. A failed address says
 why (`no match for regexp`, `address out of range`) and leaves no address:
 `data` refuses until the next good one, so a missed target is never
-written at the old one. Moving `dot` scrolls the pane to it. `limit` bounds a
-search and reads empty until set; truncate it to lift it.
+written at the old one. Moving `dot` scrolls the pane to it. `limit` bounds
+only the end of a forward search, as in acme, and reads empty until set;
+truncate it to lift it. In `12:5` the column counts bytes from 1 and clamps
+past the end of the line; a line past the end is `address out of range`.
+A refused write repeated the same way is one `err` line counted, `(x4)`.
 
 `dirty`, `mark` and `scroll` read `0` or `1` and take `0` or `1`: whether the
 buffer differs from its file, whether a write pushes an undo point, and whether