52 lines
3.9 KiB
Markdown
52 lines
3.9 KiB
Markdown
# 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.
|
|
---
|
|
|
|
|
|
|
|
|