docs: cover shipped CLI command groups and guard README drift

Merged
SI
5d ago
+66-0

The shipped CLI registers songs, emails, tasks and content, but its README omitted all four command groups. Add examples for the existing commands and explain the required audio/analysis mode, optional email subject, estimate-versus-create behavior and task run IDs. Keep installed-package availability separate from checkout documentation.

A focused guard compares compiled CLI help with README examples, so a newly registered group cannot silently disappear from the reference. It runs only --help with an empty environment. The test failed on current main with precisely those four omissions before the README repair.

Validation: build, TypeScript and all 84 tests pass; independent source review reports no actionable findings. pnpm lint cannot run because ESLint is absent from the repository dependencies (eslint: command not found). No runtime command behavior or package version changed. This guards group coverage, not every example's HTTP payload or npm installation.

Refs recoupable/mono#355 and recoupable/mono#360. The open full API parity PR #23 remains separate; no unreleased commands from that PR were copied. Npm publication/credentials and installed-host acceptance remain with their existing owners.

Summary by cubic

Documents the songs, emails, content, and tasks command groups that were missing from the README, and adds a test comparing the built CLI's --help output against the README examples so a newly registered group can't silently disappear from the reference.

Details

  • The examples cover the required audio/analysis mode, optional email subject, estimate-versus-create behavior, and task run IDs.
  • The guard runs only --help with an empty environment and failed on current main before the README repair.
  • No runtime command behavior or package version changed.