# Phase 1 — Baseline Scan & Planning

Goal: capture a **ground-truth snapshot** of technical debt (imports, ts-nochecks, any-usage, a11y hotspots) without changing app code.

## Deliverables

- `reports/phase1-*/` folder with raw findings and a concise `summary.md`.
- Package scripts: `scan:phase1`, `report:phase1`.

## What we scan

- **MUI v4 imports** (`@material-ui/*`) — should move to `@mui/material` & friends.
- **TS suppression** (`@ts-nocheck`, `@ts-ignore`) — create removal plan.
- **`any` usage** — count & top files.
- **A11y (img alt)** — naive grep for `<img` without `alt=`.
- **Hooks misuse** — list all `useDispatch|useSelector` occurrences for manual triage.
- **WebWorkers globals** — `self`, `XMLHttpRequest`, `fetch` in `src/webworkers/*`.

## How to run

```bash
# 1) patch scripts into package.json
scripts/dev/patch-phase1-scripts.sh

# 2) run scan
npm run scan:phase1

# 3) generate summary
npm run report:phase1

# 4) open the report
sed -n '1,200p' reports/phase1-*/summary.md
```