From 616675d7ea7f12aababb5b1e11a947c8095f84e8 Mon Sep 17 00:00:00 2001 From: Ed_ Date: Fri, 6 Mar 2026 16:44:38 -0500 Subject: [PATCH] docs(conductor): Synchronize docs for track 'Conductor Path Configuration' --- conductor/product.md | 2 +- conductor/tech-stack.md | 7 +++++-- 2 files changed, 6 insertions(+), 3 deletions(-) diff --git a/conductor/product.md b/conductor/product.md index 77c88a5..164fa30 100644 --- a/conductor/product.md +++ b/conductor/product.md @@ -48,7 +48,7 @@ For deep implementation details when planning or implementing tracks, consult `d - **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. -- **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. +- **Structured Log Taxonomy:** Automated session-based log organization into configurable directories (defaulting to `logs/sessions/`). 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 organizing core implementation into a `src/` directory and 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. diff --git a/conductor/tech-stack.md b/conductor/tech-stack.md index ce0d36f..93f3068 100644 --- a/conductor/tech-stack.md +++ b/conductor/tech-stack.md @@ -29,7 +29,10 @@ - **ai_style_formatter.py:** Custom Python formatter specifically designed to enforce 1-space indentation and ultra-compact whitespace to minimize token consumption. -- **ast (Standard Library):** For deterministic AST parsing and automated generation of curated "Skeleton Views" (signatures and docstrings) to minimize context bloat for sub-agents. +- **src/paths.py:** Centralized module for path resolution, allowing directory paths (logs, conductor, scripts) to be configured via `config.toml` or environment variables, eliminating hardcoded filesystem dependencies. + +- **ast (Standard Library):** For deterministic AST parsing and automated generation of curated "Skeleton Views" + (signatures and docstrings) to minimize context bloat for sub-agents. - **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+). @@ -37,7 +40,7 @@ - **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 organizing core implementation into a `src/` directory, and redirecting session logs to `logs/sessions/`, sub-agent logs to `logs/agents/`, and error logs to `logs/errors/`. Temporary test data and test logs are siloed in `tests/artifacts/` and `tests/logs/`. +- **Taxonomy & Artifacts:** Enforces a clean root by organizing core implementation into a `src/` directory, and redirecting session logs and artifacts to configurable directories (defaulting to `logs/sessions/` and `scripts/generated/`). Temporary test data and test logs are siloed in `tests/artifacts/` and `tests/logs/`. - **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, transitive blocking propagation, and programmable task execution loops.