Spaces:
Sleeping
Sleeping
File size: 4,529 Bytes
03d531b e07820e | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 | # Interactive UX scope
## Scope model
Features are grouped by implementation risk and product leverage.
- **MVP**: should be built first; high value, technically feasible, foundational.
- **V2**: valuable after the core supervised editing loop exists.
- **Research/backlog**: plausible, but higher risk or dependent on stronger state/model infrastructure.
## MVP scope and status
### 1. Constraint-aware cluster editing
Status: **partial / foundation implemented**.
Implemented:
- Move hit/sample to cluster.
- Pull hit/sample out into a new cluster.
- Create `must-link`, `cannot-link`, and `force-cluster` constraints.
- Preserve explicit edits in `supervision_state.json` across reload.
- Generate basic suggestions after edits.
Remaining:
- True local neighborhood reclustering from cached feature vectors.
- Constraint violation detection.
- Edited artifact re-export.
### 2. Lock confirmed clusters
Status: **implemented**.
Implemented:
- Lock/unlock cluster.
- Persist lock state.
- Show lock state in the cluster board and target cluster control.
- Confidence scoring accounts for locked state.
Remaining:
- Prevent future batch reruns from violating locked cluster identity through deterministic replay.
### 3. Outlier-first review queue
Status: **implemented**.
Implemented:
- Confidence score per hit and cluster.
- Review list sorted by uncertainty priority.
- Quick actions: accept, favorite, move, pull out, suppress.
Remaining:
- Split/restore/batch actions.
- Expected-impact scoring using feature margin and reconstruction contribution.
### 4. Confidence-weighted UI
Status: **implemented**.
Implemented:
- Confidence per hit and cluster.
- Low-confidence row emphasis.
- Suppressed rows recede.
- State summary badges.
### 5. Click-to-add missed onset
Status: **not implemented**.
Current waveform clicks audition existing hits. Add-onset mode is the next direct correction primitive.
### 6. Bleed suppression examples
Status: **partial**.
Implemented:
- Mark selected hit as bleed/noise.
- Store `suppress-pattern`.
- Generate similar suppression suggestions.
Remaining:
- Region brush.
- Restore suppressed hits.
- Exclude suppressed hits from supervised export.
### 7. Explain this cluster
Status: **implemented**.
Implemented:
- Representative ID.
- Members/outliers.
- Confidence reasons.
- Label distribution.
- Relevant constraints.
- Locked/suppressed counts.
## V2 scope
### 1. Predictive batch questions
Status: **partial**.
Basic suggestions exist. Exact diff previews, grouped approval UX, and richer reasoning are not complete.
### 2. Live counterfactual previews
Status: **not implemented**.
### 3. Auto-clean this family
Status: **not implemented**.
### 4. Multi-resolution semantic clustering
Status: **not implemented**.
### 5. Run-to-run preference memory
Status: **not implemented**.
## Research/backlog scope
Unchanged from design intent:
- Reconstruction-error-driven correction.
- Drag clusters in semantic space.
- Cluster gravity / physics metaphor.
- Context-aware classification.
- Teach mode across songs.
## Explicitly out of scope for MVP
- Realtime Demucs.
- Training neural models from scratch.
- Cloud multi-user collaboration.
- DAW plugin integration.
- Full Ableton/Logic export format support.
- Automatic perfect drum transcription claims.
## MVP acceptance criteria status
Target loop:
```text
cached stem is analyzed
→ clusters appear
→ uncertain items are prioritized
→ user moves one wrong hit
→ system stores a constraint
→ affected state recomputes
→ related mistakes are suggested
→ locked clusters remain stable in state
→ semantic decisions reload reproducibly
```
Status: **mostly achieved for semantic state**.
Not achieved yet:
```text
→ edited state can be exported reproducibly as updated WAV/MIDI/ZIP artifacts
→ local feature reclustering updates related hits without manually accepting suggestions
```
## Pass 5 implementation status
Implemented after initial alignment:
- supervised edited-state export under `supervised/`,
- add-onset waveform mode backed by `POST /api/jobs/{job_id}/hits/force-onset`,
- suppressed-hit restore backed by `POST /api/jobs/{job_id}/hits/{hit_id}/restore`,
- exact suggestion diff previews in API state and UI,
- validation via `scripts/test_supervised_export_and_force_onset.py`.
Still open:
- cluster merge/relabel/split workflows,
- cached feature-vector local reclustering,
- edited-vs-original comparison,
- browser-level UI tests.
|