From 7eb38fb10c7bea8d07889d2563fbc076307f8050 Mon Sep 17 00:00:00 2001 From: skal Date: Mon, 16 Feb 2026 17:25:57 +0100 Subject: docs: streamline and consolidate markdown documentation Remove 530 lines of redundant content, archive dated docs, compact CNN training sections, fix inconsistencies (effect count, test status). Improves maintainability and reduces context load for AI agents. Co-Authored-By: Claude Sonnet 4.5 --- TODO.md | 53 ++++------------------------------------------------- 1 file changed, 4 insertions(+), 49 deletions(-) (limited to 'TODO.md') diff --git a/TODO.md b/TODO.md index 41b7e7c..c55c4c3 100644 --- a/TODO.md +++ b/TODO.md @@ -1,8 +1,6 @@ # To-Do List -**High-level task tracker.** See individual design docs for implementation details. - -**Completed tasks:** `doc/COMPLETED.md` +**High-level task tracker.** See design docs for details. Completed: `doc/COMPLETED.md` --- @@ -14,36 +12,13 @@ Procedural spectrogram tool: 50-100× compression (5 KB .spec → ~100 bytes C++ --- -## ~~Priority 2: Workspace System (Task #77)~~ [COMPLETED] - -Self-contained workspaces for parallel demo development. - -**Design:** `doc/WORKSPACE_SYSTEM.md` - -**Usage:** `cmake -B build -DDEMO_WORKSPACE=main` - ---- - -## Priority 2: CNN v2 - Parametric Static Features (Task #85) [COMPLETE] +## Priority 2: CNN v2 8-bit Quantization -Enhanced CNN post-processing with multi-dimensional feature inputs. +Reduce weights from f16 (~3.2 KB) to i8 (~1.6 KB). +**Requirements:** Quantization-aware training (QAT) **Design:** `cnn_v2/docs/CNN_V2.md` -**Status:** -- ✅ Full implementation complete and validated -- ✅ Sigmoid activation (smooth gradients, fixes training collapse) -- ✅ Training pipeline: patch-based, stable convergence -- ✅ All tests passing (34/36, 2 unrelated script failures) - -**Specs:** -- 7D static features (RGBD + UV + sin + bias) -- Storage buffer weights (~3.2 KB, 8→4→4 channels) -- Sigmoid for layer 0 & final, ReLU for middle layers -- <10 KB target achieved - -**TODO:** 8-bit quantization (2× reduction, needs QAT). - --- ## Priority 3: Test Infrastructure Maintenance [ONGOING] @@ -65,26 +40,6 @@ Enhanced CNN post-processing with multi-dimensional feature inputs. 4. **test_fft.cc:87** - Investigate FFT-DCT algorithm discrepancy - May need different algorithm or fix existing one ---- - -## ~~Priority 3: Tracker Humanization & Sample Offset~~ [IMPLEMENTED] - -Enhance tracker with sample offset and humanization for realistic playback. - -**Status:** ✅ Both features implemented and tested (commit e9dde3c) - -**Features:** -1. **Sample Offset (compile-time):** Intrinsic offset per sample, zero runtime cost - - `.track` syntax: `SAMPLE OFFSET ` - - Applied during compilation, preserves beat sync - -2. **Humanization (runtime, deterministic):** Per-note timing/volume variation - - `.track` syntax: `HUMANIZE SEED TIMING VOLUME ` - - Deterministic RNG ensures identical playback and WAV export - -**Test:** `data/test_humanize.track` - ---- ## Priority 4: Audio System Enhancements [LOW PRIORITY] -- cgit v1.2.3