manual_slop/conductor/archive/fix_indentation_1space_20260516/spec.md

Track Specification: Fix Indentation 1-Space Convention

Overview

Standardize all Python files in the project to use exactly 1-space indentation per the AI-Optimized Python Style Guide. This is a remediation track to correct any files that have drifted from the convention, ensuring consistent formatting across the entire codebase without using auto-formatters (which risk corrupting non-indentation formatting).

Current State Audit (as of 29244acc)

Already Implemented (DO NOT re-implement)

• src/imgui_scopes.py:1-259 — Uses 1-space indentation correctly
• src/cost_tracker.py:1-64 — Uses 1-space indentation correctly
• src/paths.py:1-220 — Uses 1-space indentation correctly
• conductor/code_styleguides/python.md — Documents the 1-space indentation requirement

Gaps to Fill (This Track's Scope)

• src/ directory — Need to audit all 51 Python files for compliance
• tests/ directory — Need to audit test files for compliance
• scripts/ directory — Need to audit utility scripts for compliance
• conductor/ directory — Need to audit conductor Python files for compliance

Goals

1. Identify all Python files not using 1-space indentation
2. Correct indentation to 1-space in all non-compliant files
3. Preserve all other formatting (comments, docstrings, alignment)
4. Never use auto-formatters (ruff --fix, black, etc.)

Functional Requirements

• Audit every .py file in src/, tests/, scripts/, and conductor/
• For each file, detect if it uses any indentation other than 1 space
• For non-compliant files, surgically correct only the indentation
• Preserve comment positioning, docstring formatting, and alignment
• Commit each file correction individually

Non-Functional Requirements

• No Auto-Formatters: User explicitly requested manual correction only
• Preservation Priority: Other formatting must not be disturbed
• Atomic Commits: Each file correction as a separate commit for safe rollback
• Syntax Safety: Verify syntax after each file correction

Architecture Reference

• conductor/code_styleguides/python.md#section-1 (Indentation and Whitespace)

Out of Scope

• Re-formatting code for any other style concerns
• Auto-correction of any kind
• Changes to .toml, .md, or non-Python files