# Project Context

## Definition

- [Product Definition](./product.md) — Vision, primary use cases, and key features
- [Product Guidelines](./product-guidelines.md) — Code style, process, and architectural patterns
- [Tech Stack](./tech-stack.md) — Python 3.11+, ImGui Bundle, FastAPI, all SDKs and modules
- [Human-Facing Documentation](../docs/Readme.md) — **23 deep-dive guides** (architecture, MMA, tools, simulations, testing, per-source-file references, RAG, Beads, hot reload, personas, NERV theme, workspace profiles, command palette, themes, context curation, and more)

## Workflow

- [Workflow](./workflow.md) — TDD protocol, task lifecycle, commit guidelines
- [Code Style Guides](./code_styleguides/) — AI-Optimized Python Style and language-specific guides
- [Architecture Fallback](./workflow.md#architecture-documentation-fallback) — When uncertain, consult these deep-dive docs

## Management

- [Tracks Registry](./tracks.md) — All tracks (active, planned, archived)
- [Tracks Directory](./tracks/) — Per-track spec.md, plan.md, metadata.json
- [Recently Shipped: Live-GUI Test Hardening v2](./tracks/live_gui_test_hardening_v2_20260605/) — All 4 originally-failing live_gui tests now pass. Root cause was bad indentation in `src/gui_2.py:607` (`_capture_workspace_profile` was being parsed as nested inside `_apply_snapshot`); user fixed the indent. The `test_prior_session_no_pop_imbalance` test was refactored to call narrow `render_prior_session_view` (50+ mocks -> 20, runtime 5.79s -> 0.08s).
- [Recently Shipped: Live-GUI Fragility Fixes v1](./tracks/regression_fixes_20260605/) — str/bytes sentinel fix (`ini=b""` -> `ini=""`) in `_capture_workspace_profile`; +1 new regression unit test (`tests/test_workspace_profile_serialization.py`). Did not unblock the live_gui tests due to deeper sync bug.
- [Recently Shipped: Multi-Theme TOML System](./tracks/multi_themes_20260604/) — 8 new theme files, public API (`load_themes_from_disk`, `get_syntax_palette_for_theme`, `apply_syntax_palette`), color-callable convention. See [../docs/guide_themes.md](../docs/guide_themes.md) for the authoring guide.
- [Recently Shipped: Test Regression Fixes (post multi-themes ship)](./tracks/regression_fixes_20260605/) — 11 of 21 failing tests fixed, root cause of remaining live_gui C-level crash identified (`_ini_capture_ready` defer-not-catch pattern).

Last comprehensive doc refresh: 2026-06-05 (24 guide_*.md files; the Guides table in [docs/Readme.md](../docs/Readme.md) lists 23 entries — `guide_docker_deployment` is unindexed pending theme for it). 8 new guides added in the 2026-06-02 docs layer refresh: testing + 7 per-source-file references. Latest addition: `guide_themes.md` (2026-06-04, multi_themes_20260604 ship). See [docs/Readme.md](../docs/Readme.md) for the full index.