# Specification: AppController Curation & Structural Alignment

## Context
Following the successful cleanup and refactoring of `gui_2.py`, the same organizational patterns and AI-optimized coding conventions must be applied to `src/app_controller.py`. This module is a critical part of the Manual Slop architecture, acting as the bridge between the GUI and the underlying AI/MCP systems.

## Goals
1. **Structural Parity:** Reorganize `src/app_controller.py` to match the structure and quality of `gui_2.py`.
2. **Standardization:** Enforce the AI-Optimized Python Style Guide (1-space indent, minimal blank lines, type hints, SDM tags).
3. **Refactoring:** Identify and extract logic that violates the 5-level nesting limit or is better suited as module-level functions.
4. **Validation:** Ensure full system integrity via the comprehensive test suite, run in batches of 4.

## Scope
- `src/app_controller.py`: Primary target for refactoring and curation.
- `conductor/code_styleguides/python.md`: Potential updates if new nuances are found.
- `conductor/product-guidelines.md`: Potential updates based on structural findings.

## Constraints
- **Indentation:** Must be exactly 1 space.
- **Scoping:** Use `imscope` for any ImGui-related calls if present (though `app_controller` should ideally be logic-focused, some status rendering might exist).
- **Anti-OOP:** Move state-independent methods to module level.
- **Type Safety:** 100% type hint coverage for all modified sections.