manual_slop/JOURNAL.md

Engineering Journal

2026-02-28 14:43

Documentation Framework Implementation

• What: Implemented Claude Conductor modular documentation system
• Why: Improve AI navigation and code maintainability
• How: Used npx claude-conductor to initialize framework
• Issues: None - clean implementation
• Result: Documentation framework successfully initialized

---

---

2026-03-02

Track: context_token_viz_20260301 — Completed |TASK:context_token_viz_20260301|

• What: Token budget visualization panel (all 3 phases)
• Why: Zero visibility into context window usage; get_history_bleed_stats existed but had no UI
• How: Extended get_history_bleed_stats with _add_bleed_derived helper (adds 8 derived fields); added _render_token_budget_panel with color-coded progress bar, breakdown table, trim warning, Gemini/Anthropic cache status; 3 auto-refresh triggers (_token_stats_dirty flag); /api/gui/token_stats endpoint; --timeout flag on claude_mma_exec.py
• Issues: set_file_slice dropped def _render_message_panel line — caught by outline check, fixed with 1-line insert. Tier 3 delegation via run_powershell hard-capped at 60s — implemented changes directly per user approval; added --timeout flag for future use.
• Result: 17 passing tests, all phases verified by user. Token panel visible in AI Settings under "Token Budget". Commits: 5bfb20f → d577457.

Next: mma_agent_focus_ux (planned, not yet tracked)

• What: Per-agent filtering for MMA observability panels (comms, tool calls, discussion, token budget)
• Why: All panels are global/session-scoped; in MMA mode with 4 tiers, data from all agents mixes. No way to isolate what a specific tier is doing.
• Gap: _comms_log and _tool_log have no tier/agent tag. mma_streams stream_id is the only per-agent key that exists.
• See: TASKS.md for full audit and implementation intent.

---

2026-03-02 (Session 2)

Tracks Initialized: feature_bleed_cleanup + mma_agent_focus_ux |TASK:feature_bleed_cleanup_20260302| |TASK:mma_agent_focus_ux_20260302|

• What: Audited codebase for feature bleed; initialized 2 new conductor tracks

• Why: Entropy from Tier 2 track implementations — redundant code, dead methods, layout regressions, no tier context in observability

• Bleed findings (gui_2.py): Dead duplicate _render_comms_history_panel (3041-3073, stale type key, wrong method ref); dead begin_main_menu_bar() block (1680-1705, Quit has never worked); 4 duplicate __init__ assignments; double "Token Budget" label with no collapsing header

• Agent focus findings (ai_client.py + conductors): No current_tier var; Tier 3 swaps callback but never stamps tier; Tier 2 doesn't swap at all; _tool_log is untagged tuple list

• Result: 2 tracks committed (4f11d1e, c1a86e2). Bleed cleanup is active; agent focus depends on it.

• More Tracks: Initialized 'tech_debt_and_test_cleanup_20260302' and 'conductor_workflow_improvements_20260302' to harden TDD discipline, resolve test tech debt (false-positives, dupes), and mandate AST-based codebase auditing.

• Final Track: Initialized 'architecture_boundary_hardening_20260302' to fix the GUI HITL bypass allowing direct AST mutations, patch token bloat in mma_exec.py, and implement cascading blockers in dag_engine.py.

• Testing Consolidation: Initialized 'testing_consolidation_20260302' track to standardize simulation testing workflows around the pytest live_gui fixture and eliminate redundant subprocess.Popen wrappers.

• Dependency Order: Added an explicit 'Track Dependency Order' execution guide to TASKS.md to ensure safe progression through the accumulated tech debt.

• Documentation: Added guide_meta_boundary.md to explicitly clarify the difference between the Application's strict-HITL environment and the autonomous Meta-Tooling environment, helping future Tiers avoid feature bleed.

• Heuristics & Backlog: Added Data-Oriented Design and Immediate Mode architectural heuristics (inspired by Muratori/Acton) to product-guidelines.md. Logged future decoupling and robust parsing tracks to a 'Future Backlog' in TASKS.md.

---

2026-03-02 (Session 3)

Track: feature_bleed_cleanup_20260302 — Completed |TASK:feature_bleed_cleanup_20260302|

• What: Removed all confirmed dead code and layout regressions from gui_2.py (3 phases)
• Why: Tier 3 workers had left behind dead duplicate methods, dead menu block, duplicate state vars, and a broken Token Budget layout that embedded the panel inside Provider & Model with double labels
• How:
  • Phase 1: Deleted dead _render_comms_history_panel duplicate (stale type key, nonexistent _cb_load_prior_log, scroll_area ID collision). Deleted 4 duplicate __init__ assignments (ui_new_track_name etc.)
  • Phase 2: Deleted dead begin_main_menu_bar() block (24 lines, always-False in HelloImGui). Added working Quit to _show_menus via runner_params.app_shall_exit = True
  • Phase 3: Removed 4 redundant Token Budget labels/call from _render_provider_panel. Added collapsing_header("Token Budget") to AI Settings with proper _render_token_budget_panel() call
• Issues: Full test suite hangs (pre-existing — test_suite_performance_and_flakiness backlog). Ran targeted GUI/MMA subset (32 passed) as regression proxy. Meta-Level Sanity Check: 52 ruff errors in gui_2.py before and after — zero new violations introduced
• Result: All 3 phases verified by user. Checkpoints: be7174c (Phase 1), 15fd786 (Phase 2), 0d081a2 (Phase 3)

---