MAX-MSP_CC_Framework: Command for Claude Code

/max-test

Generate a manual test checklist for patches in the active project, then record test results after the user runs them in MAX.

Behavior

1. Load active project -- read patches/.active-project.json for the current project. If no active project, prompt the user.

2. Identify target patches:

   • If a patch name is provided, locate that specific .maxpat file in generated/
   • If no name provided, find all .maxpat files in the project's generated/ directory

3. Generate test checklist -- for each patch, call generate_test_checklist(patch_dict, patch_name, patch_path="") from src.maxpat.testing:

   • The checklist is based on detected objects: audio objects get signal flow tests, MIDI objects get note tests, UI objects get interaction tests
   • Each checklist item describes what to do in MAX and what to expect

4. Display checklist -- present the test checklist to the user in a clear, numbered format:

   Test Checklist for: {patch-name}
   ================================
   [ ] 1. Open patch in MAX -- verify it loads without errors
   [ ] 2. {test item based on detected objects}
   [ ] 3. {test item based on detected objects}
   ...
   

5. Record results -- after the user reports which tests passed/failed, call save_test_results(project_dir, test_name, results_md) from src.maxpat.testing to persist the results. It overwrites a same-named file, so name it v<version>-<slug>-checklist (version from get_version(project_dir)). Commit the results file by explicit path: auto_commit_patch(project_dir, base_dir, description="test results v<version> <slug>", files=[str(path)]); it raises RuntimeError on any git failure, so report that to the user (the results file is written but not committed).

6. Record confirmations -- whenever the user confirms in MAX that a feature works (a passing checklist item, or in conversation, including after a /max-iterate fix), record it:

   path = record_confirmation(project_dir, feature, evidence, version=version, max_version="9.2.0", files=["generated/<name>.maxpat"])
   

   • evidence is the user's own words; feature is one short line.
   • This writes test-results/v<version>-<slug>-confirmed.md (<date>-<slug>-confirmed.md for an unversioned project), never overwrites an earlier confirmation (-2, -3, ...), and commits only that path.
   • It refuses private paths (/Users/, /home/, ~/.claude, memory-note filenames) and files outside the project.