Verify

---
name: verify
description: How to verify media.sh changes end-to-end on a real Mac — isolated data dir, real native build, and a controllable fake now-playing app (no dependency on the user's music apps).
---

# Verifying claude-media-control

Surface = the `scripts/media.sh` CLI + the statusline segment it prints.
`npx bats tests/media.bats` covers logic with stubs; real verification runs
the actual pipeline (perl loader → adapter.dylib → mediaremoted).

## Isolate from the user's live install

Always export a scratch data dir first — without it, `media.sh` falls back to
`~/.claude/plugins/data/media-*` and mutates the user's real config/cache:

```bash
export CLAUDE_PLUGIN_DATA=/tmp/media-verify-data
scripts/build-native.sh --rebuild   # real dylib for this checkout's version
```

## Publish a controllable now-playing track

Don't drive Music.app via AppleScript (`tell app "Music" to …` hangs on the
Automation-consent dialog in headless contexts, and you can't control track
titles). Instead compile a tiny publisher: MPNowPlayingInfoCenter +
MPRemoteCommandCenter handlers + a silent AVAudioEngine source node
(`clang -fobjc-arc -framework Foundation -framework MediaPlayer -framework
AVFoundation npub.m -o npub`). Publish any title/artist/duration you need
(long titles for marquee, CJK for width handling).

Two gotchas:

- `appName`/`bundleIdentifier` only appear when the publisher runs from a
  real `.app` bundle **launched via `open`** (LaunchServices registration);
  a bare executable publishes metadata but no app identity.
- Kill it with `pkill -f <name>`; `media.sh now` must return `null` after.

## What to drive

- `media.sh now` — JSON incl. `outputDevice`, `appName`
- `media.sh statusline` after `config display.statusline on` — run twice with
  `sleep 2` between to see the marquee advance; `NO_COLOR=1` and
  `statusline.multiline on` are cheap probes
- Statusline **wiring** (`statusline install/uninstall/status`, the
  auto-wire in `config display.statusline on`, and the wrapper's uninstall
  self-heal) writes to `$HOME/.claude/settings.json` — export a scratch
  `HOME` too before driving it, or you will rewire the user's real
  settings. Simulate "plugin uninstalled" for the self-heal by emptying
  `$HOME/.claude/plugins/installed_plugins.json` (`{"plugins":{}}`) and
  making the recorded dev root non-executable/absent; the wrapper must
  restore `settings.json` and delete itself + the backup.
- `media.sh output` / `output "<substring>"` / `output <n>` — switch to the
  CURRENT device for a safe no-op, or switch away and back; `output "LG"`
  style ambiguous names must exit 4 with candidates
- `media.sh history` / `history --json` — entries appear only on track
  change (dedup across statusline ticks); drive an artist-lag amend by
  changing the published title first, then the artist one read later —
  the transitional entry must be replaced, not kept
- **cmd+click round-trip** — `build-click-handler.sh` in the scratch data
  dir, then `open "claude-media-control://seek/50"` etc. and assert on the
  fake publisher's command log. (The legacy `claude-media://` scheme is also
  claimed and accepted, but the user's REAL install claims it too — `open`
  routing for it is ambiguous on this machine, so exercise legacy URLs by
  calling the scratch `click-handler.sh` directly instead of via `open`.) Two gotchas: LaunchServices launches the applet
  WITHOUT `CLAUDE_PLUGIN_DATA`, so rewrite the scratch `click-handler.sh`
  to export it (and to exec THIS checkout's `media.sh` — the resolution
  block prefers the marketplace cache, which may hold an older version
  without `open-url`). Always `build-click-handler.sh --remove` afterwards
  to unregister the scheme, and delete any npub entries that the user's
  REAL statusline (ticking every second against the real data dir) logged
  while the fake publisher held now-playing
- `media.sh doctor` — check the `Output dev` line and `verdict:`

`cat` may be aliased to `bat` in the user's shell — use `/bin/cat -v` to show
SGR codes.

## Restore

Volume, default output device, and any launched apps must match the
pre-test state; the statusline cache lives in the scratch dir and dies
with it.