Skip to content

docs: document the beats extra + fix stale module-path comment - #53

Merged
thorwhalen merged 1 commit into
mainfrom
doctor/document-beats-extra
Sep 22, 2026
Merged

thorwhalen merged 1 commit into
mainfrom
doctor/document-beats-extra

Conversation

@thorwhalen

Copy link
Copy Markdown
Collaborator

Summary

Found via a Priority E doctor-sweep pass (AI enablement / README-vs-code / wads-setup audit):

  • mixing[beats] (mixing.audio.beats: beat_grid/BeatGrid, beat/downbeat/onset analysis) is a shipped, tested feature (mixing/tests/test_beats.py) that was completely undocumented -- missing from README.md's extras list and "What's inside" table, missing from .claude/CLAUDE.md's architecture table and extras line, and missing from the mixing-audio skill. Added it to all four.
  • pyproject.toml's beats extra comment referenced a stale module path (mixing.audio.beat_grid) -- the module is actually mixing.audio.beats (which exports the beat_grid function and BeatGrid class). Fixed the comment.
  • [tool.wads.ci] project_name = "" was empty -- can break the CI job's --cov target/lint path. Set to "mixing".

Everything else checked clean: all 5 skills' and both agents' frontmatter names match their dirnames/descriptions; no broken symlinks; already on the modern wads reusable-CI stub.

Docs/config-only change; self-reviewed only.

Test plan

  • Confirmed beat_grid/BeatGrid are exported from mixing.audio.__init__ and the module is mixing/audio/beats.py
  • Local wads ci-local could not run the video-module test collection in this sandbox (missing system libGL.so.1 for opencv-python, unrelated to this change -- confirmed by reproducing the identical ImportError in a bare venv against unmodified main); hosted CI (which has the full Ubuntu image) is the real gate here.
  • Hosted CI green

🤖 Generated with Claude Code

https://claude.ai/code/session_011HSBVhDjRU4apSLcRkavv9

mixing[beats] (mixing.audio.beats: beat_grid/BeatGrid) shipped with
tests (test_beats.py) but was undocumented in README.md, CLAUDE.md,
and the mixing-audio skill -- added to all three. Also fixed
pyproject.toml's stale comment (mixing.audio.beat_grid -> the actual
module mixing.audio.beats) and the empty tool.wads.ci.project_name.
@thorwhalen
thorwhalen merged commit 56b2a4d into main Sep 22, 2026
12 checks passed
@thorwhalen
thorwhalen deleted the doctor/document-beats-extra branch September 22, 2026 13:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant