docs: start milestone v1.1 Custom Sound Mappings

This commit is contained in:
2026-03-26 16:44:15 +01:00
parent 41e22788fc
commit 8651c47b0f
2 changed files with 40 additions and 16 deletions
+28 -4
View File
@@ -34,14 +34,14 @@ All 16 v1 requirements validated. Full pipeline working: capture -> classify ->
### Active ### Active
(None — next milestone requirements TBD) (See REQUIREMENTS.md for v1.1 requirements)
### Out of Scope ### Out of Scope
- Real-time audio playback — v1 is file output only - Real-time audio playback — file output only
- GUI or web interface — CLI only - GUI or web interface — CLI only
- Custom sound mapping configuration — predefined + auto-cluster only
- Rhythmic/percussive output — ambient/drone style only - Rhythmic/percussive output — ambient/drone style only
- Stereo position configuration — v1.1 focuses on frequency, waveform, and custom rules
## Context ## Context
@@ -73,9 +73,33 @@ All 16 v1 requirements validated. Full pipeline working: capture -> classify ->
| Ordered []Rule classifier over switch | Configurable, extensible, first-match-wins semantics | Good | | Ordered []Rule classifier over switch | Configurable, extensible, first-match-wins semantics | Good |
| 500ms window duration | Balances temporal resolution against snapshot frequency for synthesis | Good | | 500ms window duration | Balances temporal resolution against snapshot frequency for synthesis | Good |
## Current Milestone: v1.1 Custom Sound Mappings
**Goal:** Users can customize how traffic sounds via a TOML config file
**Target features:**
- Custom frequency per traffic class (override built-in Hz values)
- Custom waveform per class (sine, square, sawtooth, triangle)
- User-defined classification rules with custom sounds
- Auto-discover config from ./netsynth.toml or ~/.config/netsynth/config.toml
- --config flag for explicit config path
## Evolution ## Evolution
This document evolves at phase transitions and milestone boundaries. This document evolves at phase transitions and milestone boundaries.
**After each phase transition:**
1. Requirements invalidated? -> Move to Out of Scope with reason
2. Requirements validated? -> Move to Validated with phase reference
3. New requirements emerged? -> Add to Active
4. Decisions to log? -> Add to Key Decisions
5. "What This Is" still accurate? -> Update if drifted
**After each milestone:**
1. Full review of all sections
2. Core Value check — still the right priority?
3. Audit Out of Scope — reasons still valid?
4. Update Context with current state
--- ---
*Last updated: 2026-03-26 after v1.0 milestone* *Last updated: 2026-03-26 after v1.1 milestone start*
+12 -12
View File
@@ -1,15 +1,15 @@
--- ---
gsd_state_version: 1.0 gsd_state_version: 1.0
milestone: v1.0 milestone: v1.1
milestone_name: MVP milestone_name: Custom Sound Mappings
status: v1.0 milestone complete status: Defining requirements
stopped_at: Milestone v1.0 archived stopped_at: Milestone v1.1 started
last_updated: "2026-03-26T14:50:00.000Z" last_updated: "2026-03-26T15:00:00.000Z"
progress: progress:
total_phases: 4 total_phases: 0
completed_phases: 4 completed_phases: 0
total_plans: 11 total_plans: 0
completed_plans: 11 completed_plans: 0
--- ---
# Project State # Project State
@@ -19,12 +19,12 @@ progress:
See: .planning/PROJECT.md (updated 2026-03-26) See: .planning/PROJECT.md (updated 2026-03-26)
**Core value:** Network traffic patterns are instantly recognizable as distinct sounds — a ping sounds different from HTTPS noise, which sounds different from a port scan. **Core value:** Network traffic patterns are instantly recognizable as distinct sounds — a ping sounds different from HTTPS noise, which sounds different from a port scan.
**Current focus:** Planning next milestone **Current focus:** Milestone v1.1 — Custom Sound Mappings
## Current Position ## Current Position
Phase: All v1.0 phases complete Phase: Not started (defining requirements)
Plan: N/A Plan:
## Performance Metrics ## Performance Metrics