docs(02): capture phase context

.planning/phases/02-vault-core-and-rendering/02-CONTEXT.md

@@ -0,0 +1,73 @@
+# Phase 2: Vault Core and Rendering - Context
+
+**Gathered:** 2026-02-28
+**Status:** Ready for planning
+
+<domain>
+## Phase Boundary
+
+Markdown parsing pipeline and full content display. Users can read a markdown document with all standard constructs rendered correctly and content is scrollable. This phase delivers the vault engine (loading files from vault_path), pulldown-cmark based markdown-to-styled-lines conversion, ratatui rendering, scrolling, status bar, and error handling for missing files. Navigation between documents and link following are Phase 3.
+
+</domain>
+
+<decisions>
+## Implementation Decisions
+
+### Color palette & text styling
+- Classic CGA 16-color palette for accent elements (headers, code, links, emphasis markers)
+- Body text uses terminal default foreground/background — respects user's TERM color scheme
+- CGA accent colors only override for specific elements, not body text
+- Heading levels (H1-H6) distinguished by both color AND decorators (e.g. H1 = bright cyan + ══ underline, H2 = bright yellow, H3 = green, etc.)
+- Bold uses terminal bold attribute, italic uses terminal italic attribute, inline code uses terminal styling — modern terminals support these natively
+- No need to fall back to color-only for bold/italic since SSH users have modern terminal emulators
+
+### Screen layout & chrome
+- No content borders — content goes edge-to-edge, maximizing reading space
+- Single status bar at the bottom only (vim-style)
+- Status bar content: current filename on the left, keyboard hints (q:Quit j/k:Scroll) on the right
+- Status bar style: reverse video (inverted colors) — classic terminal status bar look
+- No top bar, no title bar, no breadcrumb bar (breadcrumb comes in Phase 3)
+
+### Code blocks & tables
+- Fenced code blocks get syntax highlighting using CGA palette colors (cyan keywords, green strings, etc.)
+- Code blocks framed with indent + colored background + rounded-corner box-drawing borders (╭─╮│╰─╯)
+- GFM tables rendered with full box-drawing grid (┌┬┐├┼┤└┴┘) — classic DOS table look
+- Table header row styled with bold + CGA accent color (e.g. bright cyan or yellow)
+
+### Scrolling
+- j/k and arrow keys scroll one line at a time
+- PgUp/PgDn scroll a full page height
+- No splash screen on startup — go straight to content
+
+### Claude's Discretion
+- Exact CGA color assignments per heading level (H1-H6)
+- Exact decorator style per heading level (═══ vs ─── vs none)
+- Syntax highlighting color mapping (which CGA color for keywords, strings, comments, etc.)
+- Blockquote visual style
+- Horizontal rule style
+- Image placeholder styling
+- List bullet/number styling
+- Scroll boundary behavior (stop or bounce)
+
+</decisions>
+
+<specifics>
+## Specific Ideas
+
+- index.md renders as a regular page — no special landing treatment in Phase 2 (ANSI art splash is Phase 4)
+- Missing index.md shows a retro BBS-style error screen with box-drawing border, "No index.md found" message, vault path shown, and hint to create one
+- No startup splash or loading indicator — fast and no-nonsense
+
+</specifics>
+
+<deferred>
+## Deferred Ideas
+
+None — discussion stayed within phase scope
+
+</deferred>
+
+---
+
+*Phase: 02-vault-core-and-rendering*
+*Context gathered: 2026-02-28*