manual_slop/conductor/tracks/codebase_curation_20260507/spec.md

Specification: Comprehensive Codebase Curation & Style Alignment (codebase_curation_20260507)

Overview

Aggressive pruning, optimization, and standardization of the codebase. This track uses the findings from the Code Path Analysis to trim away non-essential logic, data, and processing while strictly enforcing the project's technical integrity standards.

Scope

• Target Files: All .py files in ./src and ./simulation.
• Primary Goal: Trimming the "slop" (redundancies, dead code, excessive complexity).

Functional Requirements

1. Redundancy Pruning: Eliminate duplicate logic across different data pipelines.
2. Dead Code Removal: Strip out legacy "just-in-case" code and unused processing paths.
3. Strict Style Enforcement:
   • Universal 1-space indentation.
   • CRLF line endings.
   • Standardized type hinting.
4. Guideline Alignment: Refactor any code that deviates from product-guidelines.md (e.g., ensuring explicit composition over complex inheritance).
5. Validation: Ensure no loss of functionality or performance degradation.

Acceptance Criteria

• Significant reduction in total codebase line count (where applicable).
• 100% pass on style audit (scripts/ai_style_formatter.py).
• All remaining code is mapped to a necessary functional requirement or performance goal.