From cfcfd33453da2735f4fc8261c0e80feb863e969a Mon Sep 17 00:00:00 2001 From: Ed_ Date: Sun, 1 Mar 2026 09:07:39 -0500 Subject: [PATCH] docs(conductor): Synchronize docs for track 'Consolidate Temp/Test Cruft & Log Taxonomy' --- conductor/product.md | 3 ++- conductor/tech-stack.md | 3 ++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/conductor/product.md b/conductor/product.md index 0b0dd92..1fce094 100644 --- a/conductor/product.md +++ b/conductor/product.md @@ -34,7 +34,8 @@ To serve as an expert-level utility for personal developer use on small projects - **In-Depth Toolset Access:** MCP-like file exploration, URL fetching, search, and dynamic context aggregation embedded within a multi-viewport Dear PyGui/ImGui interface. - **Integrated Workspace:** A consolidated Hub-based layout (Context, AI Settings, Discussion, Operations) designed for expert multi-monitor workflows. - **Session Analysis:** Ability to load and visualize historical session logs with a dedicated tinted "Prior Session" viewing mode. -- **Log Management & Pruning:** Automated session-based log organization with a dedicated GUI panel for monitoring and manual whitelisting. Features an intelligent heuristic-based pruner that automatically cleans up insignificant logs older than 24 hours while preserving valuable sessions (errors, high complexity). +- **Structured Log Taxonomy:** Automated session-based log organization into `logs/sessions/`, `logs/agents/`, and `logs/errors/`. Includes a dedicated GUI panel for monitoring and manual whitelisting. Features an intelligent heuristic-based pruner that automatically cleans up insignificant logs older than 24 hours while preserving valuable sessions. +- **Clean Project Root:** Enforces a "Cruft-Free Root" policy by redirecting all temporary test data, configurations, and AI-generated artifacts to `tests/artifacts/`. - **Performance Diagnostics:** Built-in telemetry for FPS, Frame Time, and CPU usage, with a dedicated Diagnostics Panel and AI API hooks for performance analysis. - **Automated UX Verification:** A robust IPC mechanism via API hooks and a modular simulation suite allows for human-like simulation walkthroughs and automated regression testing of the full GUI lifecycle across multiple specialized scenarios. - **Headless Backend Service:** Optional headless mode allowing the core AI and tool execution logic to run as a decoupled REST API service (FastAPI), optimized for Docker and server-side environments (e.g., Unraid). diff --git a/conductor/tech-stack.md b/conductor/tech-stack.md index 2f84b9b..de4584e 100644 --- a/conductor/tech-stack.md +++ b/conductor/tech-stack.md @@ -33,10 +33,11 @@ - **pydantic / dataclasses:** For defining strict state schemas (Tracks, Tickets) used in linear orchestration. - **tomli-w:** For writing TOML configuration files. - **tomllib:** For native TOML parsing (Python 3.11+). -- **LogRegistry & LogPruner:** Custom components for session metadata persistence and automated filesystem cleanup. +- **LogRegistry & LogPruner:** Custom components for session metadata persistence and automated filesystem cleanup within the `logs/sessions/` taxonomy. - **psutil:** For system and process monitoring (CPU/Memory telemetry). - **uv:** An extremely fast Python package and project manager. - **pytest:** For unit and integration testing, leveraging custom fixtures for live GUI verification. +- **Taxonomy & Artifacts:** Enforces a clean root by redirecting session logs to `logs/sessions/`, sub-agent logs to `logs/agents/`, and error logs to `logs/errors/`. Temporary test data is siloed in `tests/artifacts/`. - **ApiHookClient:** A dedicated IPC client for automated GUI interaction and state inspection. - **mma-exec / mma.ps1:** Python-based execution engine and PowerShell wrapper for managing the 4-Tier MMA hierarchy and automated documentation mapping. - **dag_engine.py:** A native Python utility implementing `TrackDAG` and `ExecutionEngine` for dependency resolution, cycle detection, and programmable task execution loops.