rdc-cli 0.4.4__tar.gz → 0.5.0__tar.gz

rdc_cli-0.5.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,65 @@
+name: Bug Report
+description: Something isn't working as expected
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting! Please fill in as much detail as you can.
+
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened?
+      description: Describe the bug. What did you do, what did you expect, and what happened instead?
+      placeholder: |
+        Steps to reproduce:
+        1. Run `rdc open capture.rdc`
+        2. Run `rdc draws`
+        3. ...
+
+        Expected: ...
+        Actual: ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: doctor-output
+    attributes:
+      label: "`rdc doctor` output"
+      description: Paste the output of `rdc doctor` (helps us understand your environment).
+      render: text
+    validations:
+      required: false
+
+  - type: input
+    id: os
+    attributes:
+      label: OS / Platform
+      placeholder: "e.g. Ubuntu 24.04, Windows 11, macOS 15, Android 12 (EMUI)"
+    validations:
+      required: true
+
+  - type: input
+    id: python
+    attributes:
+      label: Python version
+      placeholder: "e.g. 3.12.3"
+    validations:
+      required: false
+
+  - type: input
+    id: rdc-version
+    attributes:
+      label: rdc-cli version
+      placeholder: "e.g. 0.4.4 (from `rdc --version`)"
+    validations:
+      required: true
+
+  - type: textarea
+    id: capture
+    attributes:
+      label: Capture file
+      description: If possible, attach a minimal `.rdc` file that reproduces the issue, or describe the GPU API / hardware involved.
+    validations:
+      required: false

rdc_cli-0.5.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Documentation
+    url: https://bananasjim.github.io/rdc-cli/
+    about: Check the docs before opening an issue

rdc_cli-0.5.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,37 @@
+name: Feature Request
+description: Suggest a new feature or improvement
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Describe the use case first — what problem are you solving?
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem / Use case
+      description: What are you trying to do that isn't possible or is too difficult today?
+      placeholder: "I'm trying to ... but currently I have to ..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed solution
+      description: If you have ideas on the CLI interface, include example invocations.
+      placeholder: |
+        ```bash
+        rdc frobnicate --flag value
+        ```
+    validations:
+      required: false
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Have you tried any workarounds? Other tools that solve this?
+    validations:
+      required: false

rdc_cli-0.5.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,17 @@
+## What
+
+<!-- One-sentence summary of what this PR does. -->
+
+## Why
+
+<!-- The problem or motivation. Link to the issue if there is one (Fixes #123). -->
+
+## How
+
+<!-- Brief description of the approach. Call out any non-obvious decisions. -->
+
+## Test plan
+
+- [ ] `pixi run check` passes (lint + typecheck + tests)
+- [ ] Added/updated unit tests
+- [ ] Manual testing with a real `.rdc` capture (if applicable)

{rdc_cli-0.4.4 → rdc_cli-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rdc-cli
-Version: 0.4.4
+Version: 0.5.0
 Summary: CLI for RenderDoc .rdc captures
 Author: Jim
 License-Expression: MIT
@@ -40,6 +40,7 @@ Dynamic: license-file
 [![Commands](https://img.shields.io/endpoint?url=https://bananasjim.github.io/rdc-cli/badges/commands.json)](https://bananasjim.github.io/rdc-cli/)
 [![Tests](https://img.shields.io/endpoint?url=https://bananasjim.github.io/rdc-cli/badges/tests.json)](https://bananasjim.github.io/rdc-cli/)
 [![Coverage](https://img.shields.io/endpoint?url=https://bananasjim.github.io/rdc-cli/badges/coverage.json)](https://bananasjim.github.io/rdc-cli/)
+[![Discord](https://img.shields.io/discord/1485003415687008296?logo=discord&label=Discord)](https://discord.gg/h3zwUadp4k)
 
 **Turn RenderDoc captures into Unix text streams.** rdc-cli does not replace RenderDoc — it makes `.rdc` file contents accessible to `grep`, `awk`, `sort`, `diff`, `jq`, and AI agents.
 
@@ -236,7 +237,7 @@ Run `rdc --help` for the full list, or `rdc <command> --help` for details.  See
 | GPU state | `pipeline`, `bindings`, `shader`, `shaders`, `shader-map` |
 | Debug | `debug pixel`, `debug vertex`, `debug thread`, `pixel`, `pick-pixel`, `tex-stats` |
 | Shader edit | `shader-build`, `shader-replace`, `shader-restore`, `shader-restore-all`, `shader-encodings` |
-| Resources | `resources`, `resource`, `passes`, `pass`, `usage` |
+| Resources | `resources`, `resource`, `passes`, `pass`, `usage`, `unused-targets` |
 | Export | `texture`, `rt`, `buffer`, `mesh`, `snapshot` |
 | Search | `search`, `counters` |
 | Assertions | `assert-pixel`, `assert-state`, `assert-image`, `assert-count`, `assert-clean` |

{rdc_cli-0.4.4 → rdc_cli-0.5.0}/README.md

@@ -13,6 +13,7 @@
 [![Commands](https://img.shields.io/endpoint?url=https://bananasjim.github.io/rdc-cli/badges/commands.json)](https://bananasjim.github.io/rdc-cli/)
 [![Tests](https://img.shields.io/endpoint?url=https://bananasjim.github.io/rdc-cli/badges/tests.json)](https://bananasjim.github.io/rdc-cli/)
 [![Coverage](https://img.shields.io/endpoint?url=https://bananasjim.github.io/rdc-cli/badges/coverage.json)](https://bananasjim.github.io/rdc-cli/)
+[![Discord](https://img.shields.io/discord/1485003415687008296?logo=discord&label=Discord)](https://discord.gg/h3zwUadp4k)
 
 **Turn RenderDoc captures into Unix text streams.** rdc-cli does not replace RenderDoc — it makes `.rdc` file contents accessible to `grep`, `awk`, `sort`, `diff`, `jq`, and AI agents.
 
@@ -209,7 +210,7 @@ Run `rdc --help` for the full list, or `rdc <command> --help` for details.  See
 | GPU state | `pipeline`, `bindings`, `shader`, `shaders`, `shader-map` |
 | Debug | `debug pixel`, `debug vertex`, `debug thread`, `pixel`, `pick-pixel`, `tex-stats` |
 | Shader edit | `shader-build`, `shader-replace`, `shader-restore`, `shader-restore-all`, `shader-encodings` |
-| Resources | `resources`, `resource`, `passes`, `pass`, `usage` |
+| Resources | `resources`, `resource`, `passes`, `pass`, `usage`, `unused-targets` |
 | Export | `texture`, `rt`, `buffer`, `mesh`, `snapshot` |
 | Search | `search`, `counters` |
 | Assertions | `assert-pixel`, `assert-state`, `assert-image`, `assert-count`, `assert-clean` |

{rdc_cli-0.4.4 → rdc_cli-0.5.0}/docs-astro/src/data/commands.json

@@ -168,13 +168,19 @@
           "name": "passes",
           "id": "passes",
           "help": "List render passes.",
-          "usage": "rdc passes [--json] [--deps] [--dot] [--graph] [--no-header] [--jsonl] [-q]"
+          "usage": "rdc passes [--json] [--deps] [--dot] [--graph] [--table] [--switches] [--no-header] [--jsonl] [-q]"
         },
         {
           "name": "pass",
           "id": "pass",
           "help": "Show detail for a single render pass by 0-based index or name.",
           "usage": "rdc pass <IDENTIFIER> [--json]"
+        },
+        {
+          "name": "unused-targets",
+          "id": "unused-targets",
+          "help": "Detect render targets produced but never consumed by visible output.",
+          "usage": "rdc unused-targets [--json] [-q] [--no-header]"
         }
       ]
     },

{rdc_cli-0.4.4 → rdc_cli-0.5.0}/docs-astro/src/pages/docs/examples.astro

@@ -260,17 +260,51 @@ rdc --session after close</code></pre>
 
   <h2 id="render-pass">Render Pass Analysis</h2>
 
-  <pre><code>{"# List all render passes"}
+  <pre><code>{"# List all render passes (NAME, DRAWS, DISPATCHES, TRIANGLES, BEGIN_EID, END_EID)"}
 rdc passes
 
-{"# Inspect a specific pass"}
+{"# Inspect attachments, load/store ops, and dimensions for a pass"}
 rdc pass GBuffer
 
 {"# List draws in a pass"}
 rdc draws --pass GBuffer
 
 {"# Find passes with many draws"}
-rdc passes --json | jq '.[] | select(.draw_count > 50)'</code></pre>
+rdc passes --json | jq '.[] | select(.draw_count > 50)'
+
+{"# Largest triangle passes"}
+rdc passes --json | jq 'sort_by(.triangles) | reverse | .[0:5] | .[] | {name, triangles}'
+
+{"# Passes that clear then discard (load=Clear, store=Discard — wasted work)"}
+rdc passes --json | jq '.[] | select(.load_ops[]? == "Clear" and .store_ops[]? == "Discard")'</code></pre>
+
+  <h2 id="pass-deps">Pass Dependency Analysis</h2>
+
+  <pre><code>{"# Per-pass reads/writes/load/store table"}
+rdc passes --deps --table
+
+{"# TBR/mobile: identify passes that switch render targets frequently"}
+rdc passes --switches
+
+{"# Passes with RT_SWITCHES > 2 (high bandwidth pressure on tile-based GPUs)"}
+rdc passes --switches --json | jq '.[] | select(.rt_switches > 2) | {name, rt_switches}'
+
+{"# Full dependency graph as DOT (render with Graphviz)"}
+rdc passes --deps --dot | dot -Tsvg -o passes.svg</code></pre>
+
+  <h2 id="unused-targets">Dead Render Target Detection</h2>
+
+  <pre><code>{"# Find render targets that are written but never read"}
+rdc unused-targets
+
+{"# Names only — quick scan"}
+rdc unused-targets -q
+
+{"# JSON — get name + writer + wave for each dead target"}
+rdc unused-targets --json | jq '.unused[] | {name, written_by, wave}'
+
+{"# Count dead targets (useful as a CI assert)"}
+rdc unused-targets -q | wc -l</code></pre>
 
   <h2 id="pixel-ladder">Pixel Investigation Ladder</h2>
 

{rdc_cli-0.4.4 → rdc_cli-0.5.0}/docs-astro/src/pages/docs/usage.astro

@@ -95,4 +95,31 @@ rdc usage 5
 
 # Show all resource usage
 rdc usage --all</code></pre>
+
+  <h2>Pass Analysis</h2>
+  <p>
+    <code>rdc passes</code> shows 6 columns: NAME, DRAWS, DISPATCHES, TRIANGLES, BEGIN_EID, END_EID.
+    GL/GLES/D3D11 captures get synthetic pass inference automatically.
+  </p>
+  <pre><code># Tabular pass summary
+rdc passes
+
+# Per-pass dependency graph (reads/writes/load/store)
+rdc passes --deps --table
+
+# Add RT_SWITCHES column for TBR/mobile bandwidth analysis
+rdc passes --switches
+
+# Inspect attachments, load/store ops, and dimensions for a pass
+rdc pass GBuffer
+
+# JSON output — includes load_ops/store_ops per pass
+rdc passes --json | jq '.[] | {name: .name, load: .load_ops, store: .store_ops}'</code></pre>
+
+  <h2>Dead Render Target Detection</h2>
+  <pre><code># List render targets written but never sampled/read
+rdc unused-targets
+
+# JSON output for scripted analysis
+rdc unused-targets --json | jq '.[].name'</code></pre>
 </Docs>

{rdc_cli-0.4.4 → rdc_cli-0.5.0}/scripts/gen-commands.py

@@ -32,7 +32,7 @@ CATEGORIES: list[tuple[str, str, str | None, list[str]]] = [
     ]),
     ("Resources", "resources-section", None, [
         "resources", "resource", "usage", "shader", "shaders", "shader-map",
-        "search", "passes", "pass",
+        "search", "passes", "pass", "unused-targets",
     ]),
     ("Export", "export", None, [
         "texture", "buffer", "rt", "mesh", "snapshot",

{rdc_cli-0.4.4 → rdc_cli-0.5.0}/src/rdc/_skills/SKILL.md

@@ -59,6 +59,50 @@ Example -- JSON pipeline with jq:
 rdc events --json | jq '.[] | select(.type == "DrawIndexed")'
 ```
 
+## Render Pass Analysis
+
+### List passes (Phase 8 columns)
+
+`rdc passes` outputs 6 columns: NAME, DRAWS, DISPATCHES, TRIANGLES, BEGIN_EID, END_EID.
+
+```bash
+rdc passes                          # TSV table
+rdc passes --json                   # includes load_ops/store_ops per pass
+rdc passes --switches               # adds RT_SWITCHES column (TBR optimization)
+rdc passes --deps --table           # per-pass READS/WRITES/LOAD/STORE
+```
+
+### Inspect a single pass
+
+`rdc pass <name>` shows enriched attachments: resource name, format, dimensions, and load/store ops.
+
+```bash
+rdc pass GBuffer
+rdc pass GBuffer --json
+rdc pass 0                          # by 0-based index
+```
+
+### Detect dead render targets
+
+`rdc unused-targets` finds render targets written but never consumed by visible output. Columns: ID, NAME, WRITTEN_BY, WAVE.
+
+```bash
+rdc unused-targets                  # TSV
+rdc unused-targets --json           # structured
+rdc unused-targets -q               # one resource ID per line (for scripting)
+```
+
+### Frame statistics
+
+`rdc stats` outputs three sections: Per-Pass Breakdown, Top Draws by Triangle Count, and Largest Resources.
+
+```bash
+rdc stats                           # all three sections
+rdc stats --json                    # includes largest_resources array
+```
+
+GL/GLES/D3D11 captures without native BeginPass/EndPass markers get synthetic pass inference automatically — no extra flags needed.
+
 ## Common Tasks
 
 ### Find all draw calls

{rdc_cli-0.4.4 → rdc_cli-0.5.0}/src/rdc/_skills/references/commands-quick-ref.md

@@ -651,6 +651,8 @@ List render passes.
 | `--deps` | Show pass dependency DAG. | flag |  |
 | `--dot` | Graphviz DOT output (requires --deps). | flag |  |
 | `--graph` | Human-readable graph (requires --deps). | flag |  |
+| `--table` | Per-pass I/O table (requires --deps). | flag |  |
+| `--switches` | Show RT switch count per pass (TBR flush risk). | flag |  |
 | `--no-header` | Omit TSV header | flag |  |
 | `--jsonl` | JSONL output | flag |  |
 | `-q, --quiet` | Print primary key column only | flag |  |
@@ -1149,6 +1151,18 @@ Display VFS subtree structure.
 | `--depth` |  | integer range | 2 |
 | `--json` | JSON output | flag |  |
 
+## `rdc unused-targets`
+
+Detect render targets produced but never consumed by visible output.
+
+**Options:**
+
+| Flag | Help | Type | Default |
+|------|------|------|---------|
+| `--json` | JSON output | flag |  |
+| `-q, --quiet` | One resource ID per line | flag |  |
+| `--no-header` | Omit TSV header | flag |  |
+
 ## `rdc usage`
 
 Show resource usage (which events read/write a resource).

{rdc_cli-0.4.4 → rdc_cli-0.5.0}/src/rdc/cli.py

@@ -58,6 +58,7 @@ from rdc.commands.shader_edit import (
 from rdc.commands.snapshot import snapshot_cmd
 from rdc.commands.tex_stats import tex_stats_cmd
 from rdc.commands.unix_helpers import count_cmd, shader_map_cmd
+from rdc.commands.unused_targets import unused_targets_cmd
 from rdc.commands.usage import usage_cmd
 from rdc.commands.vfs import cat_cmd, complete_cmd, ls_cmd, tree_cmd
 from rdc.session_state import SESSION_NAME_RE
@@ -171,6 +172,7 @@ main.add_command(android_group, name="android")
 main.add_command(serve_cmd, name="serve")
 main.add_command(callstacks_cmd, name="callstacks")
 main.add_command(setup_renderdoc_cmd, name="setup-renderdoc")
+main.add_command(unused_targets_cmd, name="unused-targets")
 
 
 if __name__ == "__main__":

{rdc_cli-0.4.4 → rdc_cli-0.5.0}/src/rdc/commands/info.py

@@ -37,12 +37,15 @@ def stats_cmd(use_json: bool, no_header: bool, use_jsonl: bool, quiet: bool) ->
 
     per_pass = result.get("per_pass", [])
     top_draws = result.get("top_draws", [])
+    largest_resources = result.get("largest_resources", [])
 
     if use_jsonl:
         for p in per_pass:
             write_jsonl([p])
         for d in top_draws:
             write_jsonl([d])
+        for r in largest_resources:
+            write_jsonl([r])
         return
 
     if quiet:
@@ -73,6 +76,15 @@ def stats_cmd(use_json: bool, no_header: bool, use_jsonl: bool, quiet: bool) ->
         header_d = ["EID", "MARKER", "TRIANGLES"]
         rows_d = [[d["eid"], d.get("marker", "-"), d["triangles"]] for d in top_draws]
         write_tsv(rows_d, header=header_d, no_header=no_header)
+    if largest_resources:
+        if not no_header:
+            sys.stderr.write(chr(10) + "Largest Resources:" + chr(10))
+        header_r = ["ID", "NAME", "TYPE", "SIZE", "FORMAT"]
+        rows_r = [
+            [r["id"], r["name"], r["type"], r["size"], r.get("format", "-")]
+            for r in largest_resources
+        ]
+        write_tsv(rows_r, header=header_r, no_header=no_header)
 
 
 @click.command("log")

{rdc_cli-0.4.4 → rdc_cli-0.5.0}/src/rdc/commands/resources.py

@@ -167,26 +167,47 @@ def resource_cmd(resid: int, use_json: bool) -> None:
 @click.option(
     "--graph", is_flag=True, default=False, help="Human-readable graph (requires --deps)."
 )
+@click.option(
+    "--table",
+    is_flag=True,
+    default=False,
+    help="Per-pass I/O table (requires --deps).",
+)
+@click.option(
+    "--switches",
+    is_flag=True,
+    default=False,
+    help="Show RT switch count per pass (TBR flush risk).",
+)
 @list_output_options
-def passes_cmd(
+def passes_cmd(  # noqa: PLR0913
     use_json: bool,
     deps: bool,
     dot: bool,
     graph: bool,
+    table: bool,
+    switches: bool,
     no_header: bool,
     use_jsonl: bool,
     quiet: bool,
 ) -> None:
     """List render passes."""
-    if (dot or graph) and not deps:
-        raise click.UsageError("--dot/--graph requires --deps")
+    if (dot or graph or table) and not deps:
+        raise click.UsageError("--dot/--graph/--table requires --deps")
+    if table and dot:
+        raise click.UsageError("--table and --dot are mutually exclusive")
+    if table and graph:
+        raise click.UsageError("--table and --graph are mutually exclusive")
     if deps and (no_header or use_jsonl or quiet):
-        raise click.UsageError("--deps only supports --json, --dot, and --graph")
+        raise click.UsageError("--deps only supports --json, --dot, --graph, and --table")
     if deps:
-        _passes_deps(use_json, dot, graph)
+        _passes_deps(use_json, dot, graph, table)
         return
 
-    result = call("passes", {})
+    params: dict[str, Any] = {}
+    if switches:
+        params["switches"] = True
+    result = call("passes", params)
     tree: dict[str, Any] = result.get("tree", {})
     if use_json:
         write_json(tree)
@@ -199,11 +220,25 @@ def passes_cmd(
         for p in passes:
             sys.stdout.write(str(p.get("name", "")) + "\n")
     else:
-        tsv_rows = [[p.get("name", "-"), p.get("draws", 0)] for p in passes]
-        write_tsv(tsv_rows, header=["NAME", "DRAWS"], no_header=no_header)
-
-
-def _passes_deps(use_json: bool, dot: bool, graph: bool) -> None:
+        header = ["NAME", "DRAWS", "DISPATCHES", "TRIANGLES", "BEGIN_EID", "END_EID"]
+        if switches:
+            header.append("RT_SWITCHES")
+        tsv_rows = [
+            [
+                p.get("name", "-"),
+                p.get("draws", 0),
+                p.get("dispatches", 0),
+                p.get("triangles", 0),
+                p.get("begin_eid", "-"),
+                p.get("end_eid", "-"),
+            ]
+            + ([p.get("rt_switches", {}).get("count", 0)] if switches else [])
+            for p in passes
+        ]
+        write_tsv(tsv_rows, header=header, no_header=no_header)
+
+
+def _passes_deps(use_json: bool, dot: bool, graph: bool, table: bool) -> None:
     result = call("pass_deps", {})
     edges: list[dict[str, Any]] = result.get("edges", [])
     if use_json:
@@ -215,6 +250,9 @@ def _passes_deps(use_json: bool, dot: bool, graph: bool) -> None:
     if graph:
         _format_graph(edges)
         return
+    if table:
+        _format_io_table(result.get("per_pass", []))
+        return
     click.echo(format_row(["SRC", "DST", "RESOURCES"]))
     for e in edges:
         rids = ",".join(str(r) for r in e["resources"])
@@ -280,6 +318,29 @@ def _format_graph(edges: list[dict[str, Any]]) -> None:
             click.echo(f"  {lbl[node]}  (sink){from_part}")
 
 
+def _format_ops(ops: list[Any]) -> str:
+    """Format load/store ops list to a compact string."""
+    if not ops:
+        return "-"
+    return ",".join(f"{t}={o}" for t, o in ops)
+
+
+def _format_io_table(per_pass: list[dict[str, Any]]) -> None:
+    write_tsv(
+        [
+            [
+                p.get("name", "-"),
+                ",".join(str(r) for r in p.get("reads", [])) or "-",
+                ",".join(str(r) for r in p.get("writes", [])) or "-",
+                _format_ops(p.get("load_ops", [])),
+                _format_ops(p.get("store_ops", [])),
+            ]
+            for p in per_pass
+        ],
+        header=["PASS", "READS", "WRITES", "LOAD", "STORE"],
+    )
+
+
 @click.command("pass")
 @click.argument("identifier", shell_complete=complete_pass_identifier)
 @click.option("--json", "use_json", is_flag=True, default=False, help="Output JSON.")
@@ -298,16 +359,46 @@ def pass_cmd(identifier: str, use_json: bool) -> None:
 
 
 def _format_pass_detail(data: dict[str, Any]) -> None:
-    color_ids = [str(t["id"]) for t in data.get("color_targets", [])]
+    color_targets = data.get("color_targets", [])
     depth = data.get("depth_target")
-    kv = {
+    kv: dict[str, Any] = {
         "Pass": data.get("name", "-"),
         "Begin EID": data.get("begin_eid", "-"),
         "End EID": data.get("end_eid", "-"),
         "Draw Calls": data.get("draws", 0),
         "Dispatches": data.get("dispatches", 0),
         "Triangles": data.get("triangles", 0),
-        "Color Targets": ", ".join(color_ids) if color_ids else "-",
-        "Depth Target": depth if depth else "-",
+        "Color Targets": ", ".join(_format_target(t) for t in color_targets)
+        if color_targets
+        else "-",
+        "Depth Target": _format_target(depth) if depth else "-",
     }
+    load_ops = data.get("load_ops", [])
+    store_ops = data.get("store_ops", [])
+    if load_ops:
+        kv["Load Ops"] = _format_ops(load_ops)
+    if store_ops:
+        kv["Store Ops"] = _format_ops(store_ops)
     click.echo(format_kv(kv))
+
+
+def _format_target(target: Any) -> str:
+    """Format an enriched attachment target dict for display."""
+    if isinstance(target, int):
+        return str(target)
+    if not isinstance(target, dict):
+        return str(target)
+    rid = str(target.get("id", "-"))
+    parts: list[str] = []
+    name = target.get("name")
+    if name:
+        parts.append(name)
+    fmt = target.get("format")
+    if fmt:
+        parts.append(fmt)
+    w, h = target.get("width"), target.get("height")
+    if w is not None and h is not None:
+        parts.append(f"{w}x{h}")
+    if parts:
+        return f"{rid} ({', '.join(parts)})"
+    return rid

rdc_cli-0.5.0/src/rdc/commands/unused_targets.py

@@ -0,0 +1,43 @@
+"""rdc unused-targets command -- detect render targets never consumed by output."""
+
+from __future__ import annotations
+
+import sys
+from typing import Any
+
+import click
+
+from rdc.commands._helpers import call
+from rdc.formatters.json_fmt import write_json
+from rdc.formatters.tsv import write_tsv
+
+
+@click.command("unused-targets")
+@click.option("--json", "use_json", is_flag=True, help="JSON output")
+@click.option("-q", "--quiet", is_flag=True, help="One resource ID per line")
+@click.option("--no-header", is_flag=True, help="Omit TSV header")
+def unused_targets_cmd(
+    use_json: bool,
+    quiet: bool,
+    no_header: bool,
+) -> None:
+    """Detect render targets produced but never consumed by visible output."""
+    result: dict[str, Any] = call("unused_targets", {})
+    if use_json:
+        write_json(result)
+        return
+    unused = result.get("unused", [])
+    if quiet:
+        for entry in unused:
+            sys.stdout.write(str(entry["id"]) + "\n")
+        return
+    rows = [
+        [
+            entry["id"],
+            entry["name"],
+            ",".join(entry["written_by"]) if entry["written_by"] else "-",
+            entry["wave"],
+        ]
+        for entry in unused
+    ]
+    write_tsv(rows, header=["ID", "NAME", "WRITTEN_BY", "WAVE"], no_header=no_header)

{rdc_cli-0.4.4 → rdc_cli-0.5.0}/src/rdc/daemon_server.py

@@ -43,6 +43,7 @@ from rdc.handlers.script import HANDLERS as _SCRIPT_HANDLERS
 from rdc.handlers.shader import HANDLERS as _SHADER_HANDLERS
 from rdc.handlers.shader_edit import HANDLERS as _SHADER_EDIT_HANDLERS
 from rdc.handlers.texture import HANDLERS as _TEXTURE_HANDLERS
+from rdc.handlers.unused import HANDLERS as _UNUSED_HANDLERS
 from rdc.handlers.vfs import HANDLERS as _VFS_HANDLERS
 
 if TYPE_CHECKING:
@@ -90,6 +91,7 @@ _DISPATCH: dict[str, Handler] = {
     **_SHADER_EDIT_HANDLERS,
     **_CAPTURE_HANDLERS,
     **_CAPTUREFILE_HANDLERS,
+    **_UNUSED_HANDLERS,
 }
 
 _NO_REPLAY_METHODS: frozenset[str] = frozenset(