cpv-fix-validation

Fix Validation — Error-to-Fix Index

Overview

Central error-to-fix lookup. Maps validation errors to fix guides in references/.

Formatter canon — lint only, NEVER format (user directive)

NEVER run a FORMATTER on any file: no ruff format, no prettier, no mdformat, no markdown formatter. Formatters reflow content and corrupt the structured Markdown that skills, agents, TRDDs, wikimem, obsidian notes, and YAML frontmatter depend on.

• Markdown / mdz / docs / TRDD / wikimem: lint-only. Run markdownlint in REPORT mode, then fix each finding BY HAND with Edit. NEVER markdownlint --fix.
• Python / JS/TS: the LINTER's autofix is allowed — ruff check --fix, eslint --fix. NEVER the FORMATTER (ruff format / prettier).
• JSON / YAML / config: lint/report only, fix by hand. No prettier --write.

Why: a formatter (and markdown --fix) rewrites files opaquely and breaks the careful structure the author maintains. This is the same discipline as the fixer-agent scope guard ("never reformat a file you weren't sent to fix").

Prerequisites

• Report from /cpv-validate-*
• Access to references/

Instructions

The token-economical fix flow (validate → ledger → MECH → INTEL read-once → delta → terminate):

1. Validate → compact ledger, not the full report. remote_validation.py <mode> <root> --strict --json > <findings.json>, then cpv_fix_ledger.py build --json <findings.json> --text <ledger.txt>; read <ledger.txt> (by-file, MECH/INTEL split, BLOCKING pre-tagged) — never ingest the full .md report each iteration (cost ≈ turns × per-turn-context).
2. MECH first (zero-LLM). Auto-apply the mech bucket with cpv_codemod.py apply --json <findings.json> --apply before spending any model tokens.
3. INTEL fix-as-you-go, read-once. Per intel file: read ONLY the finding line ranges (tldr slice / Read offset+limit), apply ALL its fixes in the SAME turn, never re-read. The recipe is the ledger's inline suggestion; open plugin-error-index.md / marketplace-error-index.md ONCE per rule-TYPE (jump via TOC), not per finding. For category: architecture, use cpv-migrate-marketplace-architecture.
4. Delta re-validate → terminate. Re-validate, rebuild the delta ledger, feed cpv_fix_loop_state.py record (CONVERGED / CYCLE / STALLED). Full loop: iterative-fix-loop.