Release checklist for LivePilot — run before ANY push, publish, or "update everything" request. Covers every file, channel, and artifact that references version numbers, tool counts, or project state.

LivePilot Release Checklist

Run this checklist EVERY time the user says "update everything", "push", "release", "make sure everything is current", or similar.

1. Version Strings (must ALL match)

How to check: grep -rn "1\.[0-9]\.[0-9]" package.json server.json livepilot/.Codex-plugin/plugin.json livepilot/.claude-plugin/plugin.json .claude-plugin/marketplace.json mcp_server/__init__.py remote_script/LivePilot/__init__.py m4l_device/livepilot_bridge.js CHANGELOG.md CLAUDE.md livepilot/skills/livepilot-core/references/overview.md docs/social-banner.html docs/M4L_BRIDGE.md

2. Tool Count (must ALL match)

Current: 403 tools across 52 domains. Spectral/analyzer (bridge-only): 32. All others: 292 (work without bridge, some with graceful fallbacks). Backed by 30 bridge commands.

Verify: grep -rc "@mcp.tool" mcp_server/tools/ | grep -v ":0" | awk -F: '{sum+=$2} END{print sum}'

Files that reference tool count:

3. Domain Count

Current: 52 domains: transport, tracks, clips, notes, devices, scenes, mixing, browser, arrangement, memory, analyzer, automation, theory, generative, harmony, midi_io, perception, agent_os, composition, motif, research, planner, project_brain, runtime, evaluation, mix_engine, sound_design, transition_engine, reference_engine, translation_engine, performance_engine, song_brain, preview_studio, hook_hunter, stuckness_detector, wonder_mode, session_continuity, creative_constraints, device_forge, sample_engine, atlas, composer, experiment, musical_intelligence, semantic_moves, diagnostics, follow_actions, grooves, scales, take_lanes, miditool, synthesis_brain.

All files that mention domain count say "52 domains"
Domain lists include ALL 45 (especially newer domains — they're the most often omitted)

4. npm Registry

npm view livepilot version matches local version
If not: npm publish

5. GitHub

Repo description matches current tool count and features
Topics are current (should include: ai, mcp, ableton, livepilot, max-for-live, audio-analysis)
Latest release matches current version (gh release list)
Release notes are current

6. Plugin Cache

~/.claude/plugins/cache/dreamrec-LivePilot/livepilot/ has current version directory
Old version directories removed
~/.claude/plugins/installed_plugins.json → livepilot@dreamrec-LivePilot entry: update version, installPath, gitCommitSha, lastUpdated

7. Social/Promotional Assets

docs/social-banner.html — tool count, version, domain list
docs/social-banner.png — regenerated from HTML (must match)
GitHub repo social preview image (Settings > Social preview)

8. Documentation Content

README.md — features match current capabilities, "Coming" section is accurate
docs/manual/getting-started.md — install instructions current
docs/manual/tool-reference.md — all 52 domains listed, all 403 tools present
docs/TOOL_REFERENCE.md — all 52 domains present with correct counts
docs/M4L_BRIDGE.md — architecture accurate, core/bridge counts correct

9. Derived Artifacts

m4l_device/LivePilot_Analyzer.amxd — frozen JS matches source? All commands present?
If livepilot_bridge.js changed → amxd needs rebuilding in Max editor

10. Code Consistency

@mcp.tool() count matches documented tool count: grep -r "@mcp.tool" mcp_server/tools/ | wc -l
No dead imports or unused code in recently changed files
Remote script version matches MCP server version
All tests pass: python3 -m pytest tests/ -v

11. Automated Checks

python scripts/sync_metadata.py --check — all metadata in sync
python -m pytest tests/test_command_boundary_audit.py — no invalid TCP targets
python -m pytest tests/test_move_annotations.py — all moves annotated
python -m pytest tests/test_capability.py — capability contract works
python -m pytest tests/test_capability_probe.py — doctor probe works

12. Release Smoke Board

Run through docs/manual/release-smoke-board.md scenarios against real Ableton session
All preview modes correctly labeled (audible/metadata/analytical)
Persistence survives server restart

Quick Verify Command

echo "=== Versions ===" && grep -h '"version"' package.json server.json manifest.json livepilot/.Codex-plugin/plugin.json livepilot/.claude-plugin/plugin.json .claude-plugin/marketplace.json | head -8 && grep __version__ mcp_server/__init__.py remote_script/LivePilot/__init__.py && echo "=== Tool count ===" && grep -rc "@mcp.tool" mcp_server/ | grep -v ":0" | awk -F: '{sum+=$2} END{print "Total:", sum}' && echo "=== Tests ===" && python3 -m pytest tests/ -q 2>&1 | tail -1

livepilot-release