From 6cde9090c1139883d3a25fe80f2b151badd9fd2d Mon Sep 17 00:00:00 2001
From: Levi Neely <lkn@darkstar.example.net>
Date: Wed, 18 Mar 2026 23:57:49 +0100
Subject: [PATCH] Update 9P filesystem tree: complete beads API (ctl commands,
 query endpoints, per-bead properties)

---
 README.md | 22 +++++++++++++++++++---
 1 file changed, 19 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 52d28f7..7bdeb2a 100644
--- a/README.md
+++ b/README.md
@@ -191,15 +191,31 @@ anvillm/
 ├── list            # id, alias, state, pid, cwd
 ├── events          # Event stream (state changes, messages)
 ├── beads/          # Task tracking (persistent across namespaces)
-│   ├── ctl         # Commands: init, new, claim, complete, fail, dep
-│   ├── list        # All beads as JSON
+│   ├── ctl         # Commands: init, new, claim, unclaim, complete, fail,
+│   │               #   dep, undep, update, delete, comment, label, unlabel,
+│   │               #   set-capability, open, defer, reopen, mount, umount, sync
+│   ├── mtab        # Mounted projects
+│   ├── list        # All beads as JSON (optional limit arg)
 │   ├── ready       # Ready beads (no blockers) as JSON
+│   ├── deferred    # Deferred beads as JSON
+│   ├── blocked     # Blocked beads as JSON
+│   ├── stale       # Stale beads as JSON
+│   ├── search/     # search/<query> — full-text search
+│   ├── by-ref/     # by-ref/<ref> — lookup by external reference
+│   ├── batch/      # batch/<id1,id2,...> — fetch multiple beads
+│   ├── label/      # label/<name> — filter by label
+│   ├── children/   # children/<id> — subtasks of a bead
 │   └── <bead-id>/
 │       ├── status
 │       ├── title
 │       ├── description
 │       ├── assignee
-│       └── json
+│       ├── json
+│       ├── comments
+│       ├── labels
+│       ├── dependents
+│       ├── tree
+│       └── events
 └── <id>/
     ├── ctl         # "stop", "restart", "kill"
     ├── state       # starting, idle, running, stopped, error, exited