fix: wire add, quality-profile, search CLIs; progressive disclosure SKILL.md + test suite #58

Merged

jasper merged 1 commit from fix/arr-cli-gaps into main

2026-06-03 23:28:42 -04:00

jasper commented

2026-06-03 23:28:20 -04:00

Contributor

Summary

Fixes the critical gaps where documented features (add, quality-profile, episode-file) existed in client classes but had no CLI subcommands. Restructures SKILL.md for progressive disclosure with references/ directory.

Changes

CLI wiring (radarr-cli + sonarr-cli)

add — --tmdb-id/--tvdb-id, --root, --quality-profile, --unmonitored, --search, --availability (Radarr), --series-type/--no-season-folder (Sonarr)
quality-profile — nargs="?" style: list all or inspect by ID with tier checkmarks
search — triggers MoviesSearch/SeriesSearch via command endpoint
queue, history, root-folder — were in client but undocumented; now wired + documented
episode-file (Sonarr) — was in client but no CLI; now wired

Progressive disclosure SKILL.md

Thin index (~80 lines) with trigger-condition table, quick reference, reference file pointers
Expanded description with broader trigger keywords
--json + jq examples, --dry-run add example, root-folder guidance, when NOT to use

New reference files

references/radarr-commands.md — full command reference
references/sonarr-commands.md — full command reference
references/media-discovery.md — TMDb/Trakt cross-reference workflow (public-safe)
references/troubleshooting.md — pitfalls, FAQs, when NOT to use

Test suite

scripts/test-arr-cli.sh — 32 dry-run smoke tests, no credentials needed, all pass

Files changed

File	Lines
`arr-cli/SKILL.md`	222 rewritten (147 removed, new thin index)
`arr-cli/scripts/radarr-cli`	+112 (add, quality-profile, search, queue, history, root-folder)
`arr-cli/scripts/sonarr-cli`	+135 (same + episode-file)
`arr-cli/references/radarr-commands.md`	+124 (new)
`arr-cli/references/sonarr-commands.md`	+139 (new)
`arr-cli/references/media-discovery.md`	+84 (new)
`arr-cli/references/troubleshooting.md`	+71 (new)
`arr-cli/scripts/test-arr-cli.sh`	+153 (new)

## Summary Fixes the critical gaps where documented features (`add`, `quality-profile`, `episode-file`) existed in client classes but had no CLI subcommands. Restructures SKILL.md for progressive disclosure with references/ directory. ## Changes ### CLI wiring (radarr-cli + sonarr-cli) - **add** — `--tmdb-id`/`--tvdb-id`, `--root`, `--quality-profile`, `--unmonitored`, `--search`, `--availability` (Radarr), `--series-type`/`--no-season-folder` (Sonarr) - **quality-profile** — `nargs="?"` style: list all or inspect by ID with tier checkmarks - **search** — triggers `MoviesSearch`/`SeriesSearch` via command endpoint - **queue, history, root-folder** — were in client but undocumented; now wired + documented - **episode-file** (Sonarr) — was in client but no CLI; now wired ### Progressive disclosure SKILL.md - Thin index (~80 lines) with trigger-condition table, quick reference, reference file pointers - Expanded `description` with broader trigger keywords - `--json` + jq examples, `--dry-run` add example, root-folder guidance, `when NOT to use` ### New reference files - `references/radarr-commands.md` — full command reference - `references/sonarr-commands.md` — full command reference - `references/media-discovery.md` — TMDb/Trakt cross-reference workflow (public-safe) - `references/troubleshooting.md` — pitfalls, FAQs, when NOT to use ### Test suite - `scripts/test-arr-cli.sh` — 32 dry-run smoke tests, no credentials needed, all pass ## Files changed | File | Lines | |------|-------| | `arr-cli/SKILL.md` | 222 rewritten (147 removed, new thin index) | | `arr-cli/scripts/radarr-cli` | +112 (add, quality-profile, search, queue, history, root-folder) | | `arr-cli/scripts/sonarr-cli` | +135 (same + episode-file) | | `arr-cli/references/radarr-commands.md` | +124 (new) | | `arr-cli/references/sonarr-commands.md` | +139 (new) | | `arr-cli/references/media-discovery.md` | +84 (new) | | `arr-cli/references/troubleshooting.md` | +71 (new) | | `arr-cli/scripts/test-arr-cli.sh` | +153 (new) |

jasper added 1 commit

2026-06-03 23:28:20 -04:00

fix: wire add, quality-profile, search, queue, history, root-folder, episode-file CLIs; add progressive disclosure SKILL.md and test suite 6e12cb0d3f

Closes critical gaps where documented features (add, quality-profile, episode-file)
existed in client classes but had no CLI subcommands or handler wiring.

Phase 1 — CLI wiring:
- radarr-cli: add, quality-profile, search, queue, history, root-folder
- sonarr-cli: add (with series-type, season-folder), quality-profile,
  episode-file, search, queue, history, root-folder

Phase 2 — Progressive disclosure:
- SKILL.md rewritten as thin index (~80 lines) with trigger table, quick
  reference, and reference file pointers
- references/radarr-commands.md — full Radarr command reference
- references/sonarr-commands.md — full Sonarr command reference
- references/media-discovery.md — TMDb/Trakt cross-reference workflow
- references/troubleshooting.md — pitfalls, FAQs, when NOT to use
- Expanded description with broader agent trigger keywords

Phase 3 — Test suite:
- test-arr-cli.sh: 32 dry-run smoke tests, no credentials needed

Phase 4 — Final docs pass

jasper merged commit 8720bc7569 into main

2026-06-03 23:28:42 -04:00

jasper referenced this pull request from a commit

2026-06-03 23:28:45 -04:00

fix: wire add, quality-profile, search CLIs; progressive disclosure SKILL.md + test suite (#58)