manual_slop/conductor/tech-stack.md

Technology Stack: Manual Slop

Core Language

• Python 3.11+

GUI Frameworks

• Dear PyGui: For immediate/retained mode GUI rendering and node mapping.
• ImGui Bundle (imgui-bundle): To provide advanced multi-viewport and dockable panel capabilities on top of Dear ImGui.

Web & Service Frameworks

• FastAPI: High-performance REST API framework for providing the headless backend service.
• Uvicorn: ASGI server for serving the FastAPI application.

AI Integration SDKs

• google-genai: For Google Gemini API interaction and explicit context caching.
• anthropic: For Anthropic Claude API interaction, supporting ephemeral prompt caching.
• DeepSeek (Dedicated SDK): Integrated for high-performance codegen and reasoning (Phase 2).
• Gemini CLI: Integrated as a headless backend provider, utilizing a custom subprocess adapter and bridge script for tool execution control. Achieves full functional parity with direct SDK usage, including real-time token counting and detailed subprocess observability.
• Gemini 3.1 Pro Preview: Tier 1 Orchestrator model for complex reasoning.
• Gemini 2.5 Flash: High-performance, low-latency model for Tier 2 Tech Lead, Tier 3 Workers, and Tier 4 QA.
• DeepSeek-V3: Tier 3 Worker model optimized for code implementation.
• DeepSeek-R1: Specialized reasoning model for complex logical chains and "thinking" traces.

Configuration & Tooling

• 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.

• 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 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.

Architectural Patterns

• Event-Driven Metrics: Uses a custom EventEmitter to decouple API lifecycle events from UI rendering, improving performance and responsiveness.
• Asynchronous Event Bus: Employs an AsyncEventQueue based on asyncio.Queue to manage the communication between the UI and the backend multi-agent orchestrator without blocking.
• Synchronous IPC Approval Flow: A specialized bridge mechanism that allows headless AI providers (like Gemini CLI) to synchronously request and receive human approval for tool calls via the GUI's REST API hooks.
• Interface-Driven Development (IDD): Enforces a "Stub-and-Resolve" pattern where cross-module dependencies are resolved by generating signatures/contracts before implementation.