Files
manual_slop/conductor/tech-stack.md

3.3 KiB

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

  • tree-sitter & tree-sitter-python: 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.
  • 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.
  • 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.