manual_slop/MMA_Support/Manual_Slop_Mapping.md

Mapping MMA to Manual Slop

This document maps the components of the manual_slop project to the 4-Tier Hierarchical Multi-Model Architecture.

Tier 1: User-Facing Model (Orchestrator)

• gui.py & gui_2.py: Provides the user interface for input and displays the synthesized output.
• ai_client.py: Acts as the primary orchestrator, managing the conversation loop and determining when to call specific tools or providers.

Tier 2: Specialized Models (Experts/Tools)

• mcp_client.py: Provides a suite of specialized "tools" (e.g., read_file, list_directory, search_files) that act as domain experts for file system manipulation.
• shell_runner.py: A specialist tool for executing PowerShell scripts to perform system-level changes.
• External AI Providers: Gemini and Anthropic models are used as the "engines" behind these specialized operations.

Tier 3: Data & Knowledge Base (Information)

• aggregate.py: The primary mechanism for building the context sent to the AI. It retrieves file contents and metadata to ground the AI's reasoning.
• manual_slop.toml: Stores project-specific configuration, tracked files, and discussion history.
• file_cache.py: Optimizes data retrieval from the local file system.

Tier 4: Monitoring & Feedback (Governance)

• session_logger.py: Handles timestamped logging of communication history (logs/comms_<ts>.log) and tool calls.
• performance_monitor.py: Tracks metrics related to execution time and resource usage.
• Script Archival: Generated .ps1 scripts are saved to scripts/generated/ for later review and auditing.