tidy

Tidy: Format, Lint, Typecheck

Run the project's code quality pipeline and fix issues where there is exactly one correct resolution. The goal is zero false moves — if you're not certain, report the error instead of fixing it.

Mode

Default: fix. Run the pipeline and fix what's safe, report the rest.

Report mode: If the user asks to just check or report (e.g. "just check", "what's broken", "--report"), run the same pipeline but don't edit any files — only report what would need fixing.

Pipeline

Run in order. Each step can produce fixes that affect later steps.

Step 1: Format

pnpm exec oxfmt .

Rewrites files in place. Deterministic and always correct.

Step 2: Lint fix

pnpm exec oxlint . --fix

Applies oxlint's built-in auto-fixes — mechanical transforms the linter guarantees preserve semantics.

After this step, run lint again without --fix to see what remains:

pnpm exec oxlint .

Remaining lint errors after --fix: report them. Don't attempt manual fixes for lint rules — if --fix didn't handle it, it's not mechanical.

Step 3: Typecheck

pnpm run typecheck

Parse the output. Identify each error by its TS error code and file location.

Step 4: Fix trivially correct type errors

Fix ONLY errors where the resolution is unambiguous — one possible action, no behavior change, no design decision.

Safe to fix:

Error	Fix
TS6133 — unused import	Remove the import specifier (or entire statement if it's the only one). Never remove side-effect imports (import "./foo.css", import "reflect-metadata") — those exist for their side effects.
TS1484 — type-only import needed	Add type to the import: import { type Foo }
TS6198 — unused destructured variable	Prefix with _ only if the destructuring itself is needed (e.g. rest pattern). Otherwise remove the binding.

Never do any of these to silence an error:

• as or as unknown as (cast)
• ! (non-null assertion)
• @ts-ignore or @ts-expect-error
• any
• Widening a type to make it fit

These are all banned by the codebase standards. If the fix requires one of them, it's not a trivial fix.

Report these — do not fix:

• Type mismatches (TS2322, TS2345)
• Missing properties (TS2339)
• Module not found (TS2307)
• Unused variables (TS6133 on non-imports) — these may be work-in-progress
• Anything requiring you to choose between multiple valid approaches

Step 5: Verify

Re-run the full pipeline:

pnpm exec oxfmt . && pnpm exec oxlint . && pnpm run typecheck

If your fixes introduced new errors, undo the offending fix and report it instead.

Output

Keep it brief:

1. What was fixed (e.g. "formatted 12 files, removed 3 unused imports, added type to 2 imports")
2. Remaining errors that need human judgment — file, line, error message

Don't explain what the tools do. The user knows.

Scoping

Default: workspace-wide, matching the justfile targets.

If the user names a specific package or path, scope to it:

• pnpm exec oxfmt <path>
• pnpm exec oxlint <path> --fix
• pnpm --filter=<package> run typecheck

If the project's justfile or AGENTS.md lists typecheck exclusions, apply them. Otherwise typecheck everything.