Verification

Do each step in order; do not skip a step unless all previous are passing except in debug mode. Run from repo root; use -w for a single package. After changes outside debug mode, restart from step 1.

1. npm run compile — references/compile.md (TS4023: ts4023-effect-errors, TS1261: ts1261-filename-casing)

2. npm run lint — fix new errors/warnings (defer in debug mode — see Debug mode)

3. Effect code: node_modules/.bin/effect-language-service diagnostics --project tsconfig.json (or --file <path>) — fix reported issues; read_lints does not surface Effect LS. Call the local bin directly, never bare npx (the unscoped registry name is a typosquat). If the bin is missing (fresh clone / pruned node_modules), note it and run npm install — do not skip silently or fall back to npx.

4. npm run test - See references/unit-tests.md

5. npm run bundle to ensure bundles still build

6. If working in packages that define test:web / test:desktop (e.g. packages/apex-ls): run from root npm run test:web -w <package-name> -- --retries 0 / npm run test:desktop -w <package-name> -- --retries 0 as needed. Skip if your changes are not in those packages.

7. node_modules/.bin/knip - check for dead code related to your changes (local bin, not npx). If the bin is missing, note it and run npm install — do not skip silently or fall back to npx.

• Fix ALL unused exports - if knip shows unused exports, remove them immediately unless they're used for tests. Exception for ts4023 reasons
• Don't leave any exports that are only used within the same file

8. check for dupes npm run check:dupes and then look in jscpd-report (and parser-ast report if using check:dupes:parser-ast) to make sure none of your changes are flagged.