From 3d5af03c1e5c367b0574f5b9983f2b21e106f8dd Mon Sep 17 00:00:00 2001
From: BANANASJIM <bananasjim1@gmail.com>
Date: Sun, 1 Mar 2026 03:33:25 -0800
Subject: [PATCH] docs: update README, commands.json, VFS docs for v0.3.8

- Add callstacks command to commands.json and README
- Update section usage with --write flag
- Update passes usage with --deps/--dot/--graph flags
- Add pixel/, attachments/, used-by VFS routes to vfs.astro
- Add Capture file category to README command table
---
 README.md                           |  1 +
 docs-astro/src/data/commands.json   | 12 +++++++++---
 docs-astro/src/pages/docs/vfs.astro | 16 +++++++++++++---
 3 files changed, 23 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index ecb6863..200c480 100644
--- a/README.md
+++ b/README.md
@@ -188,6 +188,7 @@ Run `rdc --help` for the full list, or `rdc <command> --help` for details.  See
 | Diff | `diff` (with `--draws`, `--stats`, `--framebuffer`, `--pipeline`, etc.) |
 | VFS | `ls`, `cat`, `tree` |
 | Remote | `remote connect`, `remote list`, `remote capture` |
+| Capture file | `sections`, `section`, `callstacks`, `gpus`, `thumbnail` |
 | Utility | `doctor`, `completion`, `capture`, `count`, `script`, `install-skill` |
 
 All list commands output TSV. All commands support `--json`. Footer/summary goes to stderr — stdout is always clean data.
diff --git a/docs-astro/src/data/commands.json b/docs-astro/src/data/commands.json
index 91eaedb..832e6ad 100644
--- a/docs-astro/src/data/commands.json
+++ b/docs-astro/src/data/commands.json
@@ -168,7 +168,7 @@
           "name": "passes",
           "id": "passes",
           "help": "List render passes.",
-          "usage": "rdc passes [--json] [--no-header] [--jsonl] [-q]"
+          "usage": "rdc passes [--deps] [--dot] [--graph] [--json] [--no-header] [--jsonl] [-q]"
         },
         {
           "name": "pass",
@@ -402,8 +402,14 @@
         {
           "name": "section",
           "id": "section",
-          "help": "Extract named section contents.",
-          "usage": "rdc section <NAME> [--json]"
+          "help": "Read or write named section contents.",
+          "usage": "rdc section <NAME> [--write <FILE>] [--json]"
+        },
+        {
+          "name": "callstacks",
+          "id": "callstacks",
+          "help": "Resolve CPU callstack for an event.",
+          "usage": "rdc callstacks [--eid INTEGER] [--json]"
         }
       ]
     },
diff --git a/docs-astro/src/pages/docs/vfs.astro b/docs-astro/src/pages/docs/vfs.astro
index 148d06d..4294e51 100644
--- a/docs-astro/src/pages/docs/vfs.astro
+++ b/docs-astro/src/pages/docs/vfs.astro
@@ -30,19 +30,29 @@ import Docs from '../../layouts/Docs.astro';
 │       ├── bindings/
 │       │   └── &lt;set&gt;/
 │       │       └── &lt;binding&gt;
-│       └── descriptors/
+│       ├── descriptors/
+│       └── pixel/
+│           └── &lt;x&gt;/
+│               └── &lt;y&gt;         # pixel history at (x,y)
 ├── resources/                   # all resources
 │   └── &lt;id&gt;/
 │       ├── info
 │       ├── usage
 │       └── data                 # binary content
 ├── passes/                      # render passes
-│   └── &lt;id&gt;/
+│   └── &lt;name&gt;/
+│       └── attachments/
+│           ├── color0, color1…  # color output targets
+│           └── depth            # depth target
 ├── textures/                    # texture resources
 │   └── &lt;id&gt;/
 ├── buffers/                     # buffer resources
 │   └── &lt;id&gt;/
-└── shaders/                     # shader resources</code></pre>
+└── shaders/                     # shader resources
+    └── &lt;id&gt;/
+        ├── info
+        ├── disasm
+        └── used-by              # EIDs that use this shader</code></pre>
 
   <h2>Browsing</h2>