Phase 22-23: Synthesis Engine, Extended Steps, Demo Sessions

.claude/commands/post-fix.md

@@ -0,0 +1,49 @@
+# Post-Fix Analysis Command
+
+A bug has been fixed. Now perform a comprehensive post-fix analysis to find similar issues across the codebase.
+
+## Instructions
+
+1. **Understand the fix**: Ask the user (or infer from recent conversation) what the bug was and what pattern caused it.
+
+2. **Extract the pattern**: Identify:
+   - The code pattern that caused the bug (e.g., `getInstance()`, `setTimeout without cleanup`)
+   - Any risky context that makes the pattern dangerous (e.g., `Tone.`, `audioContext`)
+   - The file that was fixed
+
+3. **Run the post-fix analysis tool**:
+   ```bash
+   cd /Users/ade/Documents/projects/tunejs_implementation/keyboardia/app && npx tsx scripts/post-fix-analysis.ts \
+     --pattern "PATTERN_HERE" \
+     --risky-context "CONTEXT_HERE" \
+     --file "FIXED_FILE" \
+     --symptom "SYMPTOM"
+   ```
+
+4. **Review high-risk matches**: For any matches marked as HIGH RISK:
+   - Read the affected files
+   - Determine if they have the same bug
+   - Report findings to the user
+
+5. **Update documentation if warranted**: If this is a new bug pattern:
+   - Consider adding to `src/utils/bug-patterns.ts`
+   - Consider adding to `docs/DEBUGGING-LESSONS-LEARNED.md`
+   - Use `npx tsx scripts/bug-capture.ts --interactive` if detailed capture needed
+
+6. **Report to user**:
+   - How many similar patterns were found
+   - Which are high risk and need review
+   - Recommendations for prevention
+
+## Example Usage
+
+User: "I fixed a singleton bug in engine.ts where getInstance() was caching Tone.js nodes"
+
+Response:
+1. Run post-fix analysis with pattern `getInstance\(\)` and risky context `Tone\.`
+2. Review matches in audio/ directory
+3. Report findings
+
+## Arguments
+
+$ARGUMENTS - Optional: Description of the bug that was fixed (pattern, file, symptom)

CHANGELOG.md

@@ -10,6 +10,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Planned
 - Phase 16: Authentication & session ownership
 - Phase 17: Advanced synthesis engine
+- Phase 26: Performance optimization
+  - Named Tone.js imports (tree-shaking)
+  - Code splitting for audio modules
+  - Lazy audio engine loading with feature flag
 - Future: Euclidean rhythms, per-track swing, conditional triggers
 
 ## [0.2.0] - 2025-12-11
@@ -92,7 +96,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 
 #### Audio Engine
-- Step sequencer with 16 tracks × 64 steps
+- Step sequencer with 16 tracks × 128 steps
 - 16 synthesized samples (drums, bass, synth, FX)
 - 5 real-time synth presets (bass, lead, pad, pluck, acid)
 - Lookahead scheduling (25ms timer, 100ms ahead)
@@ -142,10 +146,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - SPA routing support
 
 ### Technical Details
-- `MAX_STEPS = 64` (4 bars of 16th notes)
+- `MAX_STEPS = 128` (8 bars of 16th notes)
 - `STEPS_PER_PAGE = 16` (1 bar)
 - `MAX_TRACKS = 16`
-- Global step counter (0-63) with per-track modulo for polyrhythms
+- Global step counter (0-127) with per-track modulo for polyrhythms
 
 ---
 

app/.gitignore

@@ -22,3 +22,4 @@ dist-ssr
 *.njsproj
 *.sln
 *.sw?
+debug-reports/