manual_slop/conductor/index.md

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 — 27 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_engine token+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). Unblocks qwen_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_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 — 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_ready defer-not-catch pattern).

Last comprehensive doc refresh: 2026-06-10 (27 guide_*.md files, all now indexed in docs/Readme.md). 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). The docs_sync_test_era_20260610 track (closed 2026-06-10) verified all 27 guides against the current src/ source; see docs/reports/docs_sync_test_era_20260610.md for the closing report. See docs/Readme.md for the full index.