# Logic-Lens — Logic Fix All — Guide (Navigation)

This guide drives a full-repository logic-level semi-formal tracing pipeline, orchestrating **logic-health → logic-review → logic-locate → logic-explain → logic-diff** until the codebase is clean.

The only hard interaction point is **Phase 0 (consent gate)**. After approval, the pipeline runs hands-free unless Phase 8 hits the iteration cap.

This is a **logic** review, not a syntax/style/lint pass.

---

## Pipeline at a glance

```
  Phase 0 — Pre-flight notice & consent gate        ← hard stop, wait for user
  Phase 1 — Scope enumeration (role + risk tier)
  Phase 2 — Health pass (module Logic Score map)
  Phase 3 — Deep review (per-file semi-formal)
  Phase 4 — Fault location (conditional)
  Phase 5 — Path clarification (conditional)
  Phase 6 — Fix queue assembly (sorted, remedied)
  Phase 7 — Apply + verify (logic-diff)
  Phase 8 — Iteration loop (until clean or capped)
  Phase 9 — Final Fix Report
```

## Where to find each phase

| Phases | File |
|--------|------|
| **0, 1, 2** | `guide-phases-0-2-consent-scope-health.md` — Pre-flight consent; full-repo file walk by role and risk tier; module Logic Score map. |
| **3, 4, 5** | `guide-phases-3-5-review-locate-clarify.md` — Per-file Premises→Trace→Divergence (Phase 3); conditional fault localization (Phase 4); conditional path clarification (Phase 5). |
| **6, 7, 8, 9** | `guide-phases-6-9-fix-iterate-report.md` — Fix queue sorted by severity (Phase 6); apply + verify via logic-diff, revert on regression, retry ≤3× (Phase 7); iteration loop with state tracking (Phase 8); Final Fix Report (Phase 9). |

## Phase-Gated Reading

Do not read the whole pipeline before the user consents.

**Before Phase 0:**
- Read `../_shared/common.md` only for language, scope routing, fix-all header fields, config fields, and loading budget.
- Read this file through the phase map.
- Read `guide-phases-0-2-consent-scope-health.md` only through Phase 0 so the consent prompt is accurate.

**After consent:**
- Read the active phase section when entering that phase.
- Load shared files and other skill guides only when the current phase invokes that methodology.
- Keep a small state record with phase, scanned files, findings, fixes, and unresolved signatures so later phases do not require re-reading prior phase text.

## Running without git

Phase 1 uses `git ls-files` as the default enumerator. If `.git` is absent, fall back to a recursive file walk with the same ignore patterns. Report the fallback in the Scope table.

## When to hand control back to the user

1. **Phase 0** — always, before any scanning or editing.
2. **Phase 8 iteration cap** — when `fix_all.max_iterations` Warning/Suggestion rounds have run with remaining non-Critical findings. Three consecutive "continue"s hit a hard ceiling.
3. **Phase 6 constraint-vs-code tie** — when a finding could be fixed by editing either the code or a behavioral doc/config and neither side is clearly authoritative.

## Output format

Fix Report layout: header fields → Findings + Summary → fix-all extensions (Scope / Skill Invocations / Iteration History / Fix Log / Resolved by Clarification / Unresolved Findings) after Summary. Render per `common.md` §1 language rule.