fix identation track.

conductor/tracks/fix_indentation_1space_20260516/spec.md

@@ -0,0 +1,51 @@
+# 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