docs: create roadmap (4 phases)

2026-03-24 22:43:51 +01:00
parent 4e4bc6ce0f
commit 012791cb6f
4 changed files with 290 additions and 19 deletions
@@ -0,0 +1,65 @@
+# Project State
+
+## Project Reference
+
+See: .planning/PROJECT.md (updated 2026-03-24)
+
+**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:** Phase 1 — Capture and Classification
+
+## Current Position
+
+Phase: 1 of 4 (Capture and Classification)
+Plan: 0 of ? in current phase
+Status: Ready to plan
+Last activity: 2026-03-24 — Roadmap created, ready to plan Phase 1
+
+Progress: [░░░░░░░░░░] 0%
+
+## Performance Metrics
+
+**Velocity:**
+- Total plans completed: 0
+- Average duration: —
+- Total execution time: —
+
+**By Phase:**
+
+| Phase | Plans | Total | Avg/Plan |
+|-------|-------|-------|----------|
+| - | - | - | - |
+
+**Recent Trend:**
+- Last 5 plans: —
+- Trend: —
+
+*Updated after each plan completion*
+
+## Accumulated Context
+
+### Decisions
+
+Decisions are logged in PROJECT.md Key Decisions table.
+Recent decisions affecting current work:
+
+- Use `github.com/gopacket/gopacket` v1.5.0 (community fork) — NOT `google/gopacket` which is unmaintained
+- Use `github.com/packetcap/go-pcap` for live capture (pure Go, no CGo for capture layer)
+- Use `github.com/sjzar/go-lame` v0.0.9 for MP3 encoding (embeds LAME C source, CGo required at build time only)
+- Audio synthesis: hand-rolled additive sine oscillators + EMA amplitude smoothing (no external audio library)
+- Frequency table: register-separated harmonics (low drones = bulk traffic, mid = control, high = interactive)
+
+### Pending Todos
+
+None yet.
+
+### Blockers/Concerns
+
+- Phase 2: Frequency mapping requires subjective listening validation — specific Hz values not determined by research; must test during Phase 2
+- Phase 3: Auto-clustering algorithm choice (hash-bucketing vs k-means) deferred until synthesis engine exists to evaluate perceptual results
+- macOS privilege model (BPF device vs CAP_NET_RAW) not verified by research — flag if macOS is a target during Phase 1
+
+## Session Continuity
+
+Last session: 2026-03-24
+Stopped at: Roadmap written, REQUIREMENTS.md traceability updated — next step is /gsd:plan-phase 1
+Resume file: None