rdc-cli 0.3.9__tar.gz → 0.4.1__tar.gz

{rdc_cli-0.3.9 → rdc_cli-0.4.1}/.github/workflows/ci.yml

@@ -43,9 +43,6 @@ jobs:
       - name: Verify skill reference is fresh
         run: uv run python scripts/gen_and_check.py check scripts/gen-skill-ref.py src/rdc/_skills/references/commands-quick-ref.md
 
-      - name: Verify replay data is fresh
-        run: uv run python scripts/gen_and_check.py check scripts/gen-replay.py docs-astro/src/data/replay.json
-
       - name: Verify commands data is fresh
         run: uv run python scripts/gen_and_check.py check scripts/gen-commands.py docs-astro/src/data/commands.json
 

{rdc_cli-0.3.9 → rdc_cli-0.4.1}/.github/workflows/docs.yml

@@ -62,9 +62,6 @@ jobs:
             > docs-astro/src/data/stats.json
           cat docs-astro/src/data/stats.json
 
-      - name: Build mkdocs
-        run: uv run --with "mkdocs<2" --with mkdocs-material --with mkdocs-click mkdocs build -d _site
-
       - name: Set up Node.js
         uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
         with:
@@ -78,11 +75,6 @@ jobs:
           npm ci
           npm run build
 
-      - name: Merge mkdocs CLI reference into Astro output
-        run: |
-          mkdir -p docs-astro/dist/docs/cli-reference
-          cp -r _site/cli-reference/* docs-astro/dist/docs/cli-reference/
-
       - name: Generate badge endpoint JSONs
         run: |
           mkdir -p docs-astro/dist/badges

{rdc_cli-0.3.9 → rdc_cli-0.4.1}/.gitignore

@@ -4,6 +4,7 @@ __pycache__/
 *.pyo
 *.pyd
 .pytest_cache/
+.pytest_tmp*
 .mypy_cache/
 .ruff_cache/
 .coverage

{rdc_cli-0.3.9 → rdc_cli-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rdc-cli
-Version: 0.3.9
+Version: 0.4.1
 Summary: CLI for RenderDoc .rdc captures
 Author: Jim
 License-Expression: MIT
@@ -64,7 +64,7 @@ python scripts/build_renderdoc.py     # one-time build (needs cmake + ninja)
 rdc doctor                            # verify everything works
 ```
 
-**PyPI — Windows** (experimental)
+**PyPI — Windows**
 
 ```bash
 uv tool install rdc-cli               # or: pipx install rdc-cli
@@ -107,7 +107,7 @@ pixi run setup-renderdoc              # build renderdoc (pixi installs toolchain
 |----------|----------------------|--------------|
 | Linux | ✅ | ✅ |
 | macOS | ❌ (not supported yet) | ✅ (recommended) |
-| Windows | ✅ (experimental) | ✅ (experimental) |
+| Windows | ✅ | ✅ |
 
 ### RenderDoc bootstrap (all platforms)
 
@@ -210,7 +210,7 @@ rdc-cli bridges that gap:
 
 ## Commands
 
-Run `rdc --help` for the full list, or `rdc <command> --help` for details.  See the [full command reference](https://bananasjim.github.io/rdc-cli/docs/cli-reference/rdc/) for every option.
+Run `rdc --help` for the full list, or `rdc <command> --help` for details.  See the [full command reference](https://bananasjim.github.io/rdc-cli/docs/commands/) for every option.
 
 | Category | Commands |
 |----------|----------|

{rdc_cli-0.3.9 → rdc_cli-0.4.1}/README.md

@@ -37,7 +37,7 @@ python scripts/build_renderdoc.py     # one-time build (needs cmake + ninja)
 rdc doctor                            # verify everything works
 ```
 
-**PyPI — Windows** (experimental)
+**PyPI — Windows**
 
 ```bash
 uv tool install rdc-cli               # or: pipx install rdc-cli
@@ -80,7 +80,7 @@ pixi run setup-renderdoc              # build renderdoc (pixi installs toolchain
 |----------|----------------------|--------------|
 | Linux | ✅ | ✅ |
 | macOS | ❌ (not supported yet) | ✅ (recommended) |
-| Windows | ✅ (experimental) | ✅ (experimental) |
+| Windows | ✅ | ✅ |
 
 ### RenderDoc bootstrap (all platforms)
 
@@ -183,7 +183,7 @@ rdc-cli bridges that gap:
 
 ## Commands
 
-Run `rdc --help` for the full list, or `rdc <command> --help` for details.  See the [full command reference](https://bananasjim.github.io/rdc-cli/docs/cli-reference/rdc/) for every option.
+Run `rdc --help` for the full list, or `rdc <command> --help` for details.  See the [full command reference](https://bananasjim.github.io/rdc-cli/docs/commands/) for every option.
 
 | Category | Commands |
 |----------|----------|

{rdc_cli-0.3.9 → rdc_cli-0.4.1}/docs-astro/src/components/Commands.astro

@@ -7,11 +7,14 @@ const categories = [
   { name: 'Session', color: 'from-gpu-accent/20', accent: 'text-gpu-accent', commands: ['open', 'close', 'status', 'goto', 'capture', 'doctor'] },
   { name: 'Inspection', color: 'from-gpu-green/20', accent: 'text-gpu-green', commands: ['info', 'stats', 'events', 'draws', 'event', 'draw', 'log'] },
   { name: 'GPU State', color: 'from-gpu-purple/20', accent: 'text-gpu-purple', commands: ['pipeline', 'bindings', 'shader', 'shaders', 'shader-map'] },
-  { name: 'Debug', color: 'from-red-500/20', accent: 'text-red-400', commands: ['debug', 'pixel', 'pick-pixel', 'tex-stats'] },
+  { name: 'Debug', color: 'from-red-500/20', accent: 'text-red-400', commands: ['debug pixel', 'debug thread', 'debug vertex', 'pixel', 'pick-pixel', 'tex-stats'] },
   { name: 'Shader Edit', color: 'from-yellow-500/20', accent: 'text-yellow-400', commands: ['shader-build', 'shader-replace', 'shader-restore', 'shader-restore-all', 'shader-encodings'] },
   { name: 'Resources', color: 'from-gpu-orange/20', accent: 'text-gpu-orange', commands: ['resources', 'resource', 'passes', 'pass', 'usage'] },
   { name: 'Export', color: 'from-gpu-pink/20', accent: 'text-gpu-pink', commands: ['texture', 'rt', 'buffer', 'mesh', 'snapshot'] },
   { name: 'Assertions', color: 'from-emerald-500/20', accent: 'text-emerald-400', commands: ['assert-pixel', 'assert-image', 'assert-clean', 'assert-count', 'assert-state'] },
+  { name: 'Capture Control', color: 'from-indigo-500/20', accent: 'text-indigo-400', commands: ['attach', 'capture-trigger', 'capture-list', 'capture-copy'] },
+  { name: 'Remote', color: 'from-teal-500/20', accent: 'text-teal-400', commands: ['remote connect', 'remote list', 'remote capture', 'serve'] },
+  { name: 'Capture File', color: 'from-rose-500/20', accent: 'text-rose-400', commands: ['thumbnail', 'gpus', 'sections', 'section', 'callstacks'] },
   { name: 'Diff', color: 'from-sky-500/20', accent: 'text-sky-400', commands: ['diff'] },
   { name: 'Search', color: 'from-amber-500/20', accent: 'text-amber-400', commands: ['search', 'counters'] },
   { name: 'VFS', color: 'from-gpu-cyan/20', accent: 'text-gpu-cyan', commands: ['ls', 'cat', 'tree'] },
@@ -35,7 +38,7 @@ const categories = [
           <div class="flex flex-wrap gap-1.5 mt-auto">
             {cat.commands.map((cmd) => (
               <a
-                href={`${base}docs/commands/#${cmd}`}
+                href={`${base}docs/commands/#${cmd.replace(/ /g, '-')}`}
                 class="px-2.5 py-1 bg-gpu-deeper/80 rounded-md text-xs font-mono text-gray-400 hover:text-gpu-accent hover:bg-gpu-accent/10 transition-all duration-200"
               >
                 {cmd}

{rdc_cli-0.3.9 → rdc_cli-0.4.1}/docs-astro/src/components/Install.astro

@@ -14,9 +14,28 @@
     <div class="space-y-5">
       <div class="install-block opacity-0">
         <div class="flex items-center gap-2 mb-2">
-          <span class="text-[10px] font-bold text-gpu-accent uppercase tracking-[0.2em]">PyPI</span>
+          <span class="text-[10px] font-bold text-gpu-green uppercase tracking-[0.2em]">Pixi</span>
           <span class="text-[10px] text-gray-500 tracking-wider">recommended</span>
         </div>
+        <div class="group relative terminal-window">
+          <div class="px-5 py-4 font-mono text-sm text-gray-200 space-y-1">
+            <div><span class="text-gpu-green select-none font-bold">$ </span>curl -fsSL https://pixi.sh/install.sh | bash</div>
+            <div class="text-gray-500"># restart your shell, then:</div>
+            <div><span class="text-gpu-green select-none font-bold">$ </span>pixi global install rdc-cli</div>
+          </div>
+          <button
+            class="copy-btn absolute top-3 right-3 px-2.5 py-1 text-[10px] text-gray-500 bg-gpu-card rounded-md opacity-100 md:opacity-0 md:group-hover:opacity-100 transition-all duration-200 hover:text-gpu-accent hover:bg-gpu-accent/10 uppercase tracking-wider font-bold"
+            data-copy="pixi global install rdc-cli"
+          >
+            Copy
+          </button>
+        </div>
+      </div>
+
+      <div class="install-block opacity-0">
+        <div class="flex items-center gap-2 mb-2">
+          <span class="text-[10px] font-bold text-gpu-accent uppercase tracking-[0.2em]">PyPI</span>
+        </div>
         <div class="group relative terminal-window">
           <div class="px-5 py-4 font-mono text-sm text-gray-200 space-y-1">
             <div><span class="text-gpu-green select-none font-bold">$ </span>pipx install rdc-cli</div>

rdc_cli-0.4.1/docs-astro/src/data/replay.json

@@ -0,0 +1,116 @@
+[
+  [
+    {
+      "cmd": "rdc open hello_triangle.rdc",
+      "output": "opened: hello_triangle.rdc"
+    },
+    {
+      "cmd": "rdc info",
+      "output": "capture:      hello_triangle.rdc\napi:          Vulkan\nevent_count:  14\ndriver:       NVIDIA 565.57.01"
+    },
+    {
+      "cmd": "rdc draws",
+      "output": "EID\tMARKER\tTRIANGLES\n11\tDrawIndexed\t1"
+    },
+    {
+      "cmd": "rdc pipeline 11",
+      "output": "type:       Graphics\ngfx_pipe:   51\ntopology:   TriangleList\nvs_shader:  111\nps_shader:  112"
+    },
+    {
+      "cmd": "rdc search \"main\"",
+      "output": "SHADER\tSTAGE\tLINE\tCONTENT\n111\tvs\t3\tvoid main() {\n112\tps\t4\tvoid main() {"
+    },
+    {
+      "cmd": "rdc close",
+      "output": "session closed"
+    }
+  ],
+  [
+    {
+      "cmd": "rdc open hello_triangle.rdc",
+      "output": "opened: hello_triangle.rdc"
+    },
+    {
+      "cmd": "rdc tree / --depth 1",
+      "output": "/\n  draws/\n  passes/\n  resources/\n  shaders/\n  info\n  log\n  stats"
+    },
+    {
+      "cmd": "rdc ls /draws/11",
+      "output": "NAME\tKIND\npipeline/\tdir\nshader/\tdir\ncbuffer/\tdir\nvbuffer\tleaf\nibuffer\tleaf\ndescriptors\tleaf"
+    },
+    {
+      "cmd": "rdc cat /draws/11/pipeline/topology",
+      "output": "TriangleList"
+    },
+    {
+      "cmd": "rdc resources -q | wc -l",
+      "output": "6"
+    },
+    {
+      "cmd": "rdc draws --json | jq \".[0].triangles\"",
+      "output": "1"
+    },
+    {
+      "cmd": "rdc close",
+      "output": "session closed"
+    }
+  ],
+  [
+    {
+      "cmd": "rdc open hello_triangle.rdc",
+      "output": "opened: hello_triangle.rdc"
+    },
+    {
+      "cmd": "rdc pick-pixel 300 300 11",
+      "output": "r=0.0000  g=0.5000  b=0.0000  a=1.0000"
+    },
+    {
+      "cmd": "rdc pixel 300 300 11",
+      "output": "EID\tTEST\tR\tG\tB\tA\n11\tPassed\t0.0000\t0.5000\t0.0000\t1.0000"
+    },
+    {
+      "cmd": "rdc debug pixel 11 300 300",
+      "output": "result: r=0.0000 g=0.5000 b=0.0000 a=1.0000\nshader: 112 (ps)"
+    },
+    {
+      "cmd": "rdc debug pixel 11 300 300 --trace",
+      "output": "STEP\tLINE\tINST\tVAR\tVALUE\n0\t4\t0\tcolor\t(0.0, 1.0, 0.0, 1.0)\n1\t5\t1\toutColor\t(0.0, 0.5, 0.0, 1.0)"
+    },
+    {
+      "cmd": "rdc close",
+      "output": "session closed"
+    }
+  ],
+  [
+    {
+      "cmd": "rdc open hello_triangle.rdc",
+      "output": "opened: hello_triangle.rdc"
+    },
+    {
+      "cmd": "rdc draws --json",
+      "output": "[{\"eid\": 11, \"marker\": \"DrawIndexed\", \"triangles\": 1}]"
+    },
+    {
+      "cmd": "rdc assert-count draws --expect 1 --op eq",
+      "output": "PASS: draws == 1"
+    },
+    {
+      "cmd": "rdc assert-count events --expect 5 --op ge",
+      "output": "PASS: events >= 5 (actual: 14)"
+    },
+    {
+      "cmd": "rdc close",
+      "output": "session closed"
+    }
+  ],
+  [
+    {
+      "cmd": "rdc diff before.rdc after.rdc --draws",
+      "output": "--- before.rdc draws\n+++ after.rdc draws\n  DrawIndexed(11): 1 tri\n+ DrawIndexed(14): 256 tri"
+    },
+    {
+      "cmd": "rdc diff before.rdc after.rdc --stats",
+      "output": "METRIC\tBEFORE\tAFTER\tDELTA\ndraws\t1\t2\t+1\ntriangles\t1\t257\t+256\nresources\t6\t8\t+2"
+    }
+  ]
+]

rdc_cli-0.4.1/docs-astro/src/data/stats.json

@@ -0,0 +1,7 @@
+{
+  "command_count": 67,
+  "version": "0.3.9",
+  "description": "CLI for RenderDoc .rdc captures",
+  "test_count": 2542,
+  "coverage": "94%"
+}

{rdc_cli-0.3.9 → rdc_cli-0.4.1}/docs-astro/src/pages/docs/ai-integration.astro

@@ -33,6 +33,16 @@ const base = import.meta.env.BASE_URL;
     <li><em>"GPU state"</em>, <em>"draw calls"</em>, <em>"pipeline"</em></li>
   </ul>
 
+  <h2 id="why-skill-not-mcp">Why Skill, Not MCP?</h2>
+  <p>rdc-cli deliberately uses a Claude Code <strong>skill</strong> (a prompt file that teaches the agent CLI usage) rather than an MCP server. Here's why:</p>
+  <ul>
+    <li><strong>Not universal</strong> -- MCP is tied to specific AI clients that implement the protocol. A CLI skill works with any agent that can execute shell commands.</li>
+    <li><strong>Cannot run in CI</strong> -- MCP requires a persistent server process and a compatible client. CI pipelines need plain CLI commands, not RPC connections.</li>
+    <li><strong>Context window bloat</strong> -- MCP returns full tool schemas and large structured payloads that fill the agent's context window. CLI output is compact text -- pipe through <code>grep</code> or <code>jq</code> to extract only what matters.</li>
+    <li><strong>No Unix pipe composability</strong> -- MCP is an RPC protocol; results don't flow through stdout. You cannot <code>rdc draws | grep Triangle | wc -l</code> with MCP. The entire Unix tool ecosystem is lost.</li>
+    <li><strong>Skill = thin CLI wrapper</strong> -- A skill is just a prompt that teaches the agent to use the CLI. Zero infrastructure, zero dependencies, full pipe composability, works in CI, works with any AI that has shell access.</li>
+  </ul>
+
   <h2 id="agent-friendly-design">Agent-Friendly Design</h2>
 
   <h3>VFS Path Navigation</h3>

{rdc_cli-0.3.9 → rdc_cli-0.4.1}/docs-astro/src/pages/docs/design.astro

@@ -142,7 +142,7 @@ rdc log | grep -i error &amp;&amp; exit 1  # fail on errors</code></pre>
     <li><strong>Deterministic paths</strong> &mdash; <code>/draws/142/shader/ps</code> always means the same thing</li>
     <li><strong>Machine-parseable output</strong> &mdash; TSV and JSON, never mixed formats on stdout</li>
     <li><strong>Iterative exploration</strong> &mdash; <code>ls</code> to discover structure, <code>cat</code> to read data, just like a real filesystem</li>
-    <li><strong>Escape hatch</strong> &mdash; <code>rdc script</code> executes arbitrary Python inside the daemon when the 60 built-in commands aren't enough</li>
+    <li><strong>Escape hatch</strong> &mdash; <code>rdc script</code> executes arbitrary Python inside the daemon when the 67 built-in commands aren't enough</li>
   </ul>
 
   <p>

{rdc_cli-0.3.9 → rdc_cli-0.4.1}/docs-astro/src/pages/docs/examples.astro

@@ -275,10 +275,10 @@ rdc passes --json | jq '.[] | select(.draw_count > 50)'</code></pre>
   <h2 id="pixel-ladder">Pixel Investigation Ladder</h2>
 
   <pre><code>{"# Step 1: Read pixel color at (400, 300)"}
-rdc pick-pixel 142 400 300
+rdc pick-pixel 400 300 142
 
 {"# Step 2: Full pixel history — who modified this pixel?"}
-rdc pixel 142 400 300
+rdc pixel 400 300 142
 
 {"# Step 3: Debug the pixel shader that drew it"}
 rdc debug pixel 142 400 300
@@ -289,6 +289,9 @@ rdc debug pixel 142 400 300 --trace
 {"# Step 5: Dump variables at a specific line"}
 rdc debug pixel 142 400 300 --dump-at 15</code></pre>
 
+  <!-- Argument order note: debug pixel and assert-pixel take EID X Y;
+       pick-pixel and pixel take X Y [EID] -->
+
   <h2 id="buffer-decode">Buffer Decode via VFS</h2>
 
   <pre><code>{"# Read decoded constant buffer values"}
@@ -371,10 +374,10 @@ rdc shader 142 ps --constants</code></pre>
 rdc log
 
 {"# Filter by severity"}
-rdc log --level error
+rdc log --level HIGH
 
 {"# Assert no errors in CI"}
-rdc assert-clean --min-severity error
+rdc assert-clean --min-severity HIGH
 
 {"# Check pipeline state for issues"}
 rdc pipeline 142

{rdc_cli-0.3.9 → rdc_cli-0.4.1}/docs-astro/src/pages/docs/install.astro

@@ -3,7 +3,15 @@ import Docs from '../../layouts/Docs.astro';
 ---
 
 <Docs title="Installation">
-  <h2>PyPI (Recommended)</h2>
+  <h2>Pixi (Recommended)</h2>
+  <p>
+    Pixi handles the Python environment and all dependencies automatically.
+    No manual virtualenv or renderdoc module setup needed.
+  </p>
+  <pre><code>curl -fsSL https://pixi.sh/install.sh | bash
+pixi global install rdc-cli</code></pre>
+
+  <h2>PyPI</h2>
   <pre><code>pipx install rdc-cli</code></pre>
   <p>
     This installs the <code>rdc</code> command. You still need the renderdoc
@@ -48,9 +56,9 @@ pixi run setup-renderdoc</code></pre>
         <td>Supported (recommended)</td>
       </tr>
       <tr>
-        <td>Windows (experimental)</td>
-        <td>Experimental</td>
-        <td>Experimental</td>
+        <td>Windows</td>
+        <td>Supported</td>
+        <td>Supported</td>
       </tr>
     </tbody>
   </table>

{rdc_cli-0.3.9 → rdc_cli-0.4.1}/docs-astro/src/pages/docs/vfs.astro

@@ -84,7 +84,6 @@ import Docs from '../../layouts/Docs.astro';
 │       ├── info
 │       ├── disasm
 │       └── used-by
-├── by-marker/
 ├── counters/
 │   └── list
 └── current                      # alias for current event</code></pre>
@@ -93,7 +92,7 @@ import Docs from '../../layouts/Docs.astro';
 
   <pre><code># List top level
 rdc ls /
-# → capabilities  info  stats  log  events/  draws/  by-marker/
+# → capabilities  info  stats  log  events/  draws/
 #   passes/  resources/  textures/  buffers/  shaders/  counters/  current
 
 # Drill into a draw call

{rdc_cli-0.3.9 → rdc_cli-0.4.1}/docs-astro/tests/validate.mjs

@@ -154,8 +154,8 @@ test('landing page has dynamic command count from stats.json', () => {
   assert(indexHtml.includes(count), `Missing "${count}" commands count (from stats.json)`);
 });
 
-test('landing page has all 12 command categories', () => {
-  const categories = ['Session', 'Inspection', 'GPU State', 'Debug', 'Shader Edit', 'Resources', 'Export', 'Assertions', 'Diff', 'Search', 'VFS', 'Utility'];
+test('landing page has all 15 command categories', () => {
+  const categories = ['Session', 'Inspection', 'GPU State', 'Debug', 'Shader Edit', 'Resources', 'Export', 'Assertions', 'Capture Control', 'Remote', 'Capture File', 'Diff', 'Search', 'VFS', 'Utility'];
   for (const cat of categories) {
     assert(indexHtml.includes(cat), `Missing command category: ${cat}`);
   }

rdc_cli-0.4.1/openspec/changes/2026-03-03-bugfix-p2-batch/proposal.md

@@ -0,0 +1,72 @@
+# OpenSpec Proposal: P2 Bug Fix Batch (B75 + Remote Export + Daemon Survival)
+
+## Motivation
+
+Three P2 bugs affect correctness and reliability of core workflows:
+
+1. **B75 — `rdc event` parameter values missing**: The event detail command returns empty strings for all numeric and boolean parameter values, making it useless for debugging draw calls. Root cause is that `SDObject.AsString()` in RenderDoc's SWIG binding only works for `String`/`Enum` basetypes; all other basetypes (UnsignedInteger, SignedInteger, Float, Boolean, Resource) return an empty string. The raw POD fields on `SDObjectPODData` must be read directly based on `basetype`.
+
+2. **Remote Export silent failure**: `rdc tex export`, `rdc rt export`, `rdc rt depth`, and `rdc pick pixel` silently succeed (returning empty or zero data) when the daemon is running in remote/proxy mode, even though `SaveTexture()` and `PickPixel()` require a GPU-side replay controller that is not available in that mode. Users get no error, just garbage output.
+
+3. **Daemon Survival on Windows SSH**: When a user connects via SSH on Windows and launches the daemon in background, the daemon process is killed when the SSH session disconnects. The `CREATE_NO_WINDOW` flag alone is not sufficient; the process must also be detached from the controlling terminal via `CREATE_NEW_PROCESS_GROUP | DETACHED_PROCESS`.
+
+## Design
+
+### B75: `_extract_sd_value()` helper in `query.py`
+
+Replace the `child.AsString()` call inside `_handle_event()` with a new private helper `_extract_sd_value(child)` that switches on `child.type.basetype`:
+
+| basetype value | SDObject field | Python expression |
+|---|---|---|
+| 7 (UnsignedInteger) | `data.basic.u` | `str(child.data.basic.u)` |
+| 8 (SignedInteger) | `data.basic.i` | `str(child.data.basic.i)` |
+| 9 (Float) | `data.basic.d` | `str(child.data.basic.d)` |
+| 10 (Boolean) | `data.basic.b` | `str(bool(child.data.basic.b))` |
+| 12 (Resource) | `data.basic.id` | `str(int(child.data.basic.id))` |
+| 5, 6 (String, Enum) | `AsString()` or `data.str` | `child.AsString()` |
+| default | — | `child.AsString()` (last-resort fallback) |
+
+The helper remains private (`_extract_sd_value`) and is only called from `_handle_event()`.
+
+`SDBasicData` on the mock (`tests/mocks/mock_renderdoc.py`) must gain the fields `u`, `i`, `d`, `b`, `id` so unit tests can exercise all branches. `SDObject` in the mock must expose a `type` attribute with a `basetype` field matching the integer constants above.
+
+### Remote Export: `is_remote` guard
+
+Four handlers in `texture.py` and `pixel.py` that call GPU-only API must return an error before touching the replay controller when `state.is_remote` is true. The error message mirrors the existing pattern from `_handle_rt_overlay`:
+
+```
+"not supported in remote mode"
+```
+
+Affected handlers — guard goes as first statement in function body (before `rd is None` check), matching `_handle_rt_overlay` pattern:
+- `_handle_tex_export` (texture.py ~line 65)
+- `_handle_rt_export` (texture.py ~line 117)
+- `_handle_rt_depth` (texture.py ~line 147)
+- `_handle_pick_pixel` (pixel.py ~line 131)
+
+No logic changes beyond the early return; existing `_handle_rt_overlay` guard is the canonical reference.
+
+### Daemon Survival: Windows creation flags
+
+In `src/rdc/_platform.py`, the `popen_flags()` function's Windows branch currently returns:
+
+```python
+{"creationflags": 0x08000000}  # CREATE_NO_WINDOW
+```
+
+Change to:
+
+```python
+{"creationflags": 0x00000200 | 0x00000008}
+# CREATE_NEW_PROCESS_GROUP | DETACHED_PROCESS
+```
+
+**Note**: `DETACHED_PROCESS` (0x8) and `CREATE_NO_WINDOW` (0x08000000) are mutually exclusive per Win32 docs — they cannot be ORed together. `DETACHED_PROCESS` is the stronger option: it completely detaches from the parent's console, ensuring the daemon survives SSH session teardown. `CREATE_NEW_PROCESS_GROUP` (0x200) provides signal isolation. The previous `CREATE_NO_WINDOW` is **replaced**, not added to. Unix behavior is unchanged.
+
+## Risk Assessment
+
+| Bug | Risk | Mitigation |
+|---|---|---|
+| B75 | Medium | `basetype` integer constants are part of RenderDoc's stable public API and have not changed across v1.x. The `AsString()` fallback ensures no regression for unknown future basetypes. Mock update keeps unit tests accurate. |
+| Remote Export | Low | Pure early-return guards, no existing logic is altered. The pattern is already proven by `_handle_rt_overlay`. |
+| Daemon Survival | Low | Only changes Windows `creationflags` bit mask. Existing Unix path is untouched. The three flags are stable Win32 constants that have existed since Windows XP. |

rdc_cli-0.4.1/openspec/changes/2026-03-03-bugfix-p2-batch/tasks.md

@@ -0,0 +1,29 @@
+# Tasks: P2 Bugfix Batch
+
+## Agent A: B75 — SDObject value extraction
+
+- [ ] A1: Update `tests/mocks/mock_renderdoc.py` — Add `SDType` class with `basetype` field, update `SDBasic` to have `u`, `i`, `d`, `b`, `id` fields alongside `value`, add `type` attribute to `SDObject`
+- [ ] A2: Add `_extract_sd_value(child: Any) -> str` helper to `src/rdc/handlers/query.py` — maps basetype enum to correct data field
+- [ ] A3: Update `_handle_event()` in `src/rdc/handlers/query.py` — replace `child.AsString()` with `_extract_sd_value(child)` call
+- [ ] A4: Update `tests/unit/test_draws_events_daemon.py` — add `TestB75SDValueExtraction` class with 8 test cases
+- [ ] A5: Update `tests/unit/test_daemon_crash_regression.py` — update SD mock construction if needed to work with new `SDBasic` fields
+
+## Agent B: Remote Export — `is_remote` guard
+
+- [ ] B1: Add `is_remote` guard to `_handle_tex_export()` in `src/rdc/handlers/texture.py`
+- [ ] B2: Add `is_remote` guard to `_handle_rt_export()` in `src/rdc/handlers/texture.py`
+- [ ] B3: Add `is_remote` guard to `_handle_rt_depth()` in `src/rdc/handlers/texture.py`
+- [ ] B4: Add `is_remote` guard to `_handle_pick_pixel()` in `src/rdc/handlers/pixel.py`
+- [ ] B5: Add `test_pick_pixel_remote_rejected()` to `tests/unit/test_pick_pixel_daemon.py`
+- [ ] B6: Add remote mode tests for `tex_export`, `rt_export`, `rt_depth` in existing texture test file or new file alongside existing tests
+
+## Agent C: Daemon Survival — Windows creation flags
+
+- [ ] C1: Update `popen_flags()` in `src/rdc/_platform.py` — add `CREATE_NEW_PROCESS_GROUP | DETACHED_PROCESS` flags
+- [ ] C2: Add `TestPopenFlagsWindows` to `tests/unit/test_platform.py` — verify all three flag bits present
+
+## Verification (main agent)
+
+- [ ] V1: `pixi run lint` passes
+- [ ] V2: `pixi run test` passes with zero failures
+- [ ] V3: Windows VM: pull branch, run `rdc event 11` to verify B75 parameter values

rdc_cli-0.4.1/openspec/changes/2026-03-03-bugfix-p2-batch/test-plan.md

@@ -0,0 +1,109 @@
+# Test Plan: P2 Bugfix Batch
+
+## B75 — `_extract_sd_value()` SDObject type dispatch
+
+Test class: `TestExtractSDValue` in `tests/unit/test_draws_events_daemon.py`.
+
+All cases call `_handle_request(rpc_request("event", {"eid": 42}), state)` with a
+structured file whose chunk child has the SDObject under test. Assert that the
+`Parameters` field in `resp["result"]` contains the expected string for each basetype.
+The state is built with `make_daemon_state(structured_file=..., actions=...)` where
+the action at EID 42 has `events=[APIEvent(eventId=42, chunkIndex=0)]`.
+
+### B75-01 — UnsignedInteger (basetype=7)
+- Build `SDObject` with `type.basetype=7`, `data.basic.u=255`
+- Assert `Parameters` contains `"255"`
+
+### B75-02 — SignedInteger (basetype=8)
+- Build `SDObject` with `type.basetype=8`, `data.basic.i=-42`
+- Assert `Parameters` contains `"-42"`
+
+### B75-03 — Float (basetype=9)
+- Build `SDObject` with `type.basetype=9`, `data.basic.d=3.14`
+- Assert `Parameters` contains `"3.14"` (or a float-formatted representation of 3.14)
+
+### B75-04 — Boolean (basetype=10)
+- Build `SDObject` with `type.basetype=10`, `data.basic.b=True`
+- Assert `Parameters` contains `"True"`
+
+### B75-05 — Resource (basetype=12)
+- Build `SDObject` with `type.basetype=12`, `data.basic.id=42`
+- Assert `Parameters` contains `"42"`
+
+### B75-06 — String (basetype=5)
+- Build `SDObject` with `type.basetype=5`, `data.str="hello"`
+- Assert `Parameters` contains `"hello"`
+
+### B75-07 — Enum (basetype=6)
+- Build `SDObject` with `type.basetype=6`, `data.str="VK_FORMAT_R8G8B8A8_UNORM"`
+- Assert `Parameters` contains `"VK_FORMAT_R8G8B8A8_UNORM"`
+
+### B75-08 — No `type` attribute (legacy fallback)
+- Build `SDObject` that has no `type` attribute (standard mock default)
+- Assert `Parameters` contains the result of `AsString()` on the object (falls back gracefully, no exception)
+
+### B75-09 — Unknown basetype (99)
+- Build `SDObject` with `type.basetype=99`, `data.basic.value=0`
+- Assert no exception is raised and `Parameters` contains the `AsString()` fallback value
+
+---
+
+## Remote Export (RE) — `is_remote` guard for export handlers
+
+Add one test per handler in the relevant test file. Each test calls
+`_handle_request(rpc_request("<method>", params), state)` where `state` is built
+with `make_daemon_state(is_remote=True, rd=mock_renderdoc)`. The `rd` param must be
+set so the test doesn't hit the `rd is None` error before reaching the remote guard.
+Assert `resp["error"]["code"] == -32002` and the message contains `"not supported in remote mode"`.
+
+### RE-01 — `pick_pixel` remote guard
+- File: `tests/unit/test_pick_pixel_daemon.py`
+- State: `make_daemon_state(is_remote=True)`
+- Call: `rpc_request("pick_pixel", {"x": 0, "y": 0})`
+- Assert: `resp["error"]["code"] == -32002`, message contains `"not supported in remote mode"`
+
+### RE-02 — `tex_export` remote guard
+- File: `tests/unit/test_tex_stats_handler.py` or a new class in the texture handler test file
+- State: `make_daemon_state(is_remote=True)`
+- Call: `rpc_request("tex_export", {"id": 1})`
+- Assert: `resp["error"]["code"] == -32002`, message contains `"not supported in remote mode"`
+
+### RE-03 — `rt_export` remote guard
+- Same file as RE-02
+- State: `make_daemon_state(is_remote=True)`
+- Call: `rpc_request("rt_export", {"eid": 10, "target": 0})`
+- Assert: `resp["error"]["code"] == -32002`, message contains `"not supported in remote mode"`
+
+### RE-04 — `rt_depth` remote guard
+- Same file as RE-02
+- State: `make_daemon_state(is_remote=True)`
+- Call: `rpc_request("rt_depth", {"eid": 10})`
+- Assert: `resp["error"]["code"] == -32002`, message contains `"not supported in remote mode"`
+
+---
+
+## Daemon Survival (DS) — `popen_flags()` platform dispatch
+
+Test class: `TestPopenFlagsPlatform` in `tests/unit/test_platform.py`.
+Use `monkeypatch.setattr("rdc._platform._WIN", ...)` to control the platform branch
+without running on a real Windows system.
+
+### DS-01 — Windows flags
+- Monkeypatch `_WIN=True`
+- Call `popen_flags()`
+- Assert result is a dict with key `"creationflags"`
+- Assert `CREATE_NEW_PROCESS_GROUP` (0x200) bit is set
+- Assert `DETACHED_PROCESS` (0x8) bit is set
+- Assert `CREATE_NO_WINDOW` (0x08000000) is NOT set (mutually exclusive with DETACHED_PROCESS)
+
+### DS-02 — Unix returns empty dict
+- Monkeypatch `_WIN=False`
+- Call `popen_flags()`
+- Assert result `== {}`
+
+---
+
+## Regression
+
+- All existing tests must continue to pass after the changes.
+- `pixi run lint` produces zero warnings or errors.