docs: create roadmap (4 phases)

2026-02-28 20:35:13 +01:00
parent 05a301ae63
commit 4f6c9bcdc9
3 changed files with 179 additions and 35 deletions
@@ -0,0 +1,65 @@
+# Project State
+
+## Project Reference
+
+See: .planning/PROJECT.md (updated 2026-02-28)
+
+**Core value:** Users can connect via SSH and seamlessly browse a vault of linked markdown documents with retro BBS aesthetics
+**Current focus:** Phase 1 - Safety Foundation
+
+## Current Position
+
+Phase: 1 of 4 (Safety Foundation)
+Plan: 0 of TBD in current phase
+Status: Ready to plan
+Last activity: 2026-02-28 — Roadmap created
+
+Progress: [░░░░░░░░░░] 0%
+
+## Performance Metrics
+
+**Velocity:**
+- Total plans completed: 0
+- Average duration: -
+- Total execution time: 0 hours
+
+**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:
+
+- Pre-Phase 1: Verify `edition = "2024"` compiles before changing to 2021 — leave it if `cargo build` succeeds
+- Pre-Phase 1: Use pulldown-cmark event-based approach for markdown parsing (not comrak)
+- Pre-Phase 1: No tokio/async runtime — synchronous event loop only
+- Pre-Phase 2: Choose wiki-link parsing strategy before implementation (regex pre-pass vs post-parse interception)
+
+### Pending Todos
+
+None yet.
+
+### Blockers/Concerns
+
+- **LIFE**: Panic hook and SIGHUP handling are highest priority — must land before any feature code
+- **REND**: Verify ratatui 0.30 custom Widget trait signature before building BBS widgets (changed between 0.28 and 0.29)
+- **NAV**: Path traversal via wiki-links must be addressed in Phase 3 link resolver — canonicalize and prefix-check every resolved path
+- **LIVE**: notify 8.x API must be verified at integration time; watch only current file (not full vault) to avoid inotify exhaustion
+
+## Session Continuity
+
+Last session: 2026-02-28
+Stopped at: Roadmap created, ready to plan Phase 1
+Resume file: None