[twwwy]

• What was wrong or hard: npm run module:doctor decided whether an Octatrack module has a card form from its USB package's C sources only. The card build, the source importer and the native comparison test use moduleCardless in src/catalog/usb-only.ts, which also counts usbOnly: true. So a module marked usbOnly, as docs/OCTATRACK_RECONSTRUCTION.md describes, was asked for card packages, a native comparison and card pairs that it can never have, and the doctor test (--all) failed on it. Two tests encoded the same old rule: src/catalog/usb-only.test.ts expected every package without requires or sources to have a card form, and scripts/module-release-scope.test.mjs built its USB-only set from sources only, so a usbOnly module looked like an unreviewed card module and the scope check refused it. scripts/build-module-packages.py already uses sources or usbOnly. No module on main uses usbOnly yet. Track Solo (Track Solo 0.2.4-experimental: hold a track to solo it while editing #1383) is the first, after the owner asked for it there.
• What this changes: the doctor imports moduleCardless and uses it, so there is one rule for card form. A usbOnly module now gets the same lines as a C runtime module: its USB package version is checked, and the native comparison and card pair lines become informational. The packages line says which kind it is. Both tests now use the same rule as build-module-packages.py and moduleCardless. Changelog: changelog/2026-11-10-doctor-usb-only.md.
• How I checked it: I temporarily marked Bar LED usbOnly in a scratch worktree. Main's doctor still said "compiled into the committed packages" and checked its native comparison; with this change it says "USB package … (a USB-only module, no card form)" and skips the card-only lines. Tiempos (C sources) and Tuner (card only) report exactly as before. On the Track Solo branch (Track Solo 0.2.4-experimental: hold a track to solo it while editing #1383), the first usbOnly module, usb-only.test.ts and module-release-scope.test.mjs fail without this change and pass with it (8 tests). On main, npx vitest run scripts/module-doctor.test.mjs scripts/module-release-scope.test.mjs src/catalog/usb-only.test.ts passes (12 tests). npm run pr:ready: every stage passes except sdk:check, where only the two composition tests fail, because m68k-elf-gcc is not installed on my Mac; CI has it.
• What the guides lacked or got wrong, and where I fixed it: nothing in the guides. docs/OCTATRACK_RECONSTRUCTION.md already describes usbOnly correctly; the doctor had not caught up with it.

🤖 Generated with Claude Code