f0b7c8b7d6
New entry at the top of the Recently Shipped list, linking to the archive/ folder. Includes: - 314/314 green across all 11 tier batches - FR1-FR5 summary - 3 lineage tracks also archived - The 4 unblocked tracks - Link to the closing batch-green report
3.7 KiB
3.7 KiB
Project Context
Definition
- Product Definition — Vision, primary use cases, and key features
- Product Guidelines — Code style, process, and architectural patterns
- Tech Stack — Python 3.11+, ImGui Bundle, FastAPI, all SDKs and modules
- Human-Facing Documentation — 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 — TDD protocol, task lifecycle, commit guidelines
- Code Style Guides — AI-Optimized Python Style and language-specific guides
- Architecture Fallback — When uncertain, consult these deep-dive docs
Management
- Tracks Registry — All tracks (active, planned, archived)
- Tracks Directory — Per-track spec.md, plan.md, metadata.json
- Recently Shipped: Test Infrastructure Hardening (2026-06-09/10) — 4-day test-hell saga closed. 8 phases, 60+ tasks, 314/314 tests green across all 11 tier batches. Fixes 3 root causes: FR1 subprocess health autouse, FR2 live_gui_workspace fixture (per-run timestamped under
tests/artifacts/), FR3_sync_rag_enginetoken+dirty coalescing. Plus FR4 set_value hook + FR5 clean_baseline marker. Lineage tracks also archived:mma_tier_usage_reset_fix_20260610(4 controller bug fixes),rag_phase4_sync_fix_20260610(4-part RAG dim-mismatch + rag_config reset),workspace_path_finalize_20260609(precursor). Unblocksqwen_llama_grok,data_oriented_error_handling,data_structure_strengthening,mcp_architecture_refactor. Closing report: ../docs/reports/test_infrastructure_hardening_batch_green_20260610.md. - Recently Shipped: Live-GUI Test Hardening v2 — All 4 originally-failing live_gui tests now pass. Root cause was bad indentation in
src/gui_2.py:607(_capture_workspace_profilewas being parsed as nested inside_apply_snapshot); user fixed the indent. Thetest_prior_session_no_pop_imbalancetest was refactored to call narrowrender_prior_session_view(50+ mocks -> 20, runtime 5.79s -> 0.08s). - Recently Shipped: Live-GUI Fragility Fixes v1 — 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 — 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 for the authoring guide. - Recently Shipped: Test Regression Fixes (post multi-themes ship) — 11 of 21 failing tests fixed, root cause of remaining live_gui C-level crash identified (
_ini_capture_readydefer-not-catch pattern).
Last comprehensive doc refresh: 2026-06-05 (24 guide_*.md files; the Guides table in 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 for the full index.