Merge branch 'main' of git.arirex.me:iris/ai-app

AGENTS.md

@@ -57,6 +57,20 @@ repo is in PLAN.md's "Backend layout" section.
   finishes between two polls reads as idle at both, and its own output
   gets replayed on top of itself. That bug was visible on screen as
   `donedone`.
+- `server/src/files.rs` — the file explorer's half of the backend:
+  listing a directory, reading a file, writing one, creating a file or a
+  directory, on whichever machine a setup names. Each is one small POSIX
+  script run through `Transport`, so the local and the ssh case are the
+  same code and a machine the backend cannot reach fails with ssh's own
+  message. The path is a **positional argument**, never text spliced into
+  the script; `PATH_PRELUDE` is the one line that gives a leading `~` its
+  meaning, since a shell expands a tilde in text and not in an argument.
+  A read has four answers — `text`, `binary`, `tooBig`, or the machine's
+  own error — because a binary file drawn as text and a big one cut off
+  silently are both wrong in ways the reader cannot see. A write carries
+  the sha256 the read reported and is refused (409) when the file has
+  moved on, which is the ordinary case when an agent is editing the same
+  file. `EXPLORER.md` is the design.
 - `server/src/usage.rs` — rate-limit windows, asked **of each machine that
   can run Claude**, not of the backend. Credentials are read through the
   session `Transport`, so a remote setup is an ssh round trip and the local