ruohki/bbs-md
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(03-02): complete navigation, history, and breadcrumb status bar plan

Browse Source 
- Create 03-02-SUMMARY.md documenting HistoryEntry, navigate_to/back/forward, Tab-cycling, breadcrumb
- Update STATE.md: Phase 3 complete, plan 2/2 done, decisions added, session updated
- Update ROADMAP.md: Phase 3 marked complete, 2/2 plans checked
- Mark requirements NAV-03, NAV-04, NAV-11 complete in REQUIREMENTS.md
This commit is contained in:
ruohki
2026-02-28 23:12:39 +01:00
parent d705313aae
commit 2c9ad682da
4 changed files with 187 additions and 23 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.planning/STATE.md
+16 -12
View File
@@ -5,23 +5,23 @@
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 3 IN PROGRESS — Plan 01 done (LinkRecord, wiki-link resolver, path traversal guard)
**Current focus:** Phase 3 COMPLETE — Plans 01 and 02 done (navigation, history, Tab-cycling, breadcrumbs all wired)
## Current Position
Phase: 3 of 4 (Navigation and Links) — IN PROGRESS
Plan: 1 of 2 in current phase (03-01 done, 03-02 next)
Status: 03-01 complete — link metadata extraction and wiki-link resolution implemented
Last activity: 2026-02-28 — Plan 01 complete (LinkRecord, ENABLE_WIKILINKS, resolve_wiki_link, path traversal guard)
Phase: 3 of 4 (Navigation and Links) — COMPLETE
Plan: 2 of 2 in current phase (03-01 done, 03-02 done)
Status: 03-02 complete — navigation history, link cycling, breadcrumb status bar implemented
Last activity: 2026-02-28 — Plan 02 complete (HistoryEntry, navigate_to/back/forward, Tab-cycling, REVERSED highlight, breadcrumb)
Progress: [████████░░] 75%
Progress: [██████████] 100%
## Performance Metrics
**Velocity:**
- Total plans completed: 6
- Average duration: 2.7 min
- Total execution time: 0.27 hours
- Total plans completed: 7
- Average duration: 2.8 min
- Total execution time: 0.33 hours
**By Phase:**
@@ -29,7 +29,7 @@ Progress: [████████░░] 75%
|-------|-------|-------|----------|
| 01-safety-foundation | 3 | 7 min | 2.3 min |
| 02-vault-core-and-rendering | 3 | 9 min | 3.0 min |
| 03-navigation-and-links | 1 so far | 3.5 min | 3.5 min |
| 03-navigation-and-links | 2 | 7 min | 3.5 min |
**Recent Trend:**
- Last 5 plans: 3 min, 2 min, 2 min, 4 min, 3 min
@@ -68,6 +68,10 @@ Recent decisions affecting current work:
- [Phase 03-navigation-and-links]: vault_path added to render_markdown for render-time broken wiki-link detection
- [Phase 03-navigation-and-links]: Broken wiki-links checked at render time; standard links deferred to navigation time
- [Phase 03-navigation-and-links]: link_span_start_count field tracks span array position at Tag::Link Start for span_len computation
- [Phase 03-02]: navigate_to does NOT push to history on Missing/ReadError — user stays on current page conceptually
- [Phase 03-02]: navigate_back/forward re-loads from disk (no render cache) per research recommendation
- [Phase 03-02]: Draw-time REVERSED uses lines.clone() per frame — stored lines unchanged for resize re-render
- [Phase 03-02]: Span overlap detection extended beyond plan spec — catches spans starting before col_offset that extend into link range
### Pending Todos
@@ -82,5 +86,5 @@ None.
## Session Continuity
Last session: 2026-02-28
Stopped at: Completed 03-01-PLAN.md
Resume file: .planning/phases/03-navigation-and-links/03-02-PLAN.md
Stopped at: Completed 03-02-PLAN.md (Phase 3 complete)
Resume file: .planning/phases/04-live-reload/04-01-PLAN.md