manual_slop/conductor/tracks/app_controller_curation_20260513/spec.md

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.