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 — 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: 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-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.