chore: configure codex build environment

AGENTS.md

@@ -6,10 +6,14 @@
 
 ## Commands
 
-- Install dependencies: `npm install`
+- Install dependencies: `npm ci`
+- Codex setup: `npm run codex:setup`
 - Run local Vite dev server: `npm run dev`
+- Run app in Codex: `npm run dev:codex`
 - Build extension: `npm run build`
+- Build extension in Codex: `npm run build:codex`
 - Preview build output: `npm run preview`
+- Verify generated extension output: `npm run verify:dist`
 
 ## Environment
 
@@ -25,7 +29,9 @@ Use `.env.local` for local secrets. Keep `.env.local` and any real token-bearing
 ## Extension Build Notes
 
 - `vite.config.ts` emits `dist/manifest.json` during production builds.
+- `dist/` is the deployable output directory. Deployment or Chrome load-unpacked flows should point directly at `dist/`.
 - `dist/` is generated output and should not be edited directly.
+- `npm run build` runs `scripts/verify-dist.mjs` after Vite to ensure the generated output has the required extension files.
 - Host permissions are derived from `VITE_GITEA_BASE_URL`. Rebuild after changing the base URL.
 - Runtime API calls are centralized in `src/api.ts`.
 - Popup state is centralized in the vanilla Zustand store at `src/store.ts`.