ed
e5a8a84381
- product-guidelines.md: '10 aliases' -> core + extended per-aggregate dataclasses (Metadata, CommsLogEntry, ... PathInfo, FileItemsDiff, JsonPrimitive/JsonValue) reflecting the actual ~19 types in src/type_aliases.py. - tracks.md: marked rows 2 (qwen_llama_grok), 3 (data_oriented_error handling), 17 (code_path_audit) as Completed per chronology.md (they were stale 'in progress' / 'ready to start'). Added cleanup note. data_structure_strengthening already dropped. - index.md: '27 deep-dive guides' -> 41 (actual count in docs/); refreshed last doc-refresh date to 2026-07-02 with the drift-fix summary.
4.0 KiB
4.0 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 — 41 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, AI client, MCP client, app controller, GUI main, models, multi-agent conductor, state lifecycle, discussions, context aggregation, docker deployment, 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-07-02 (41 guide_*.md files in docs/, all indexed in docs/Readme.md). Earlier refreshes: 2026-06-10 (27 guides verified against src/), 2026-06-02 (8 per-source-file guides added). Latest drift-fix pass: 2026-07-02 (guide_models.md rewritten for src/models.py shim reality; provider count + file sizes + mcp_tool_specs split corrected in product.md + tech-stack.md; send_result claim corrected in product-guidelines.md; audit_optional_returns.py phantom-script reference fixed in python.md). See docs/Readme.md for the full index.