run-app

Run and verify the apps

Run everything from the repository root. The smoke script discovers apps from apps/*/package.json (monorepo.role, monorepo.healthPath, monorepo.devPort), so a new app is covered without editing it.

Local loop

1. Start each dev server as its own background Bash task (never a bare &). Both scripts are cf dev, which runs Vite:

   • pnpm --filter=worker-api dev - ready when Vite prints Local: http://localhost:8700/
   • pnpm --filter=front-app dev - ready when Vite prints Local: http://localhost:5174/

   Wait with one capped until grep -q 'localhost:<port>' …; do sleep 0.5; done on each task's output file. If the SessionStart context reported a port as already listening, reuse that server instead of starting a second one.

2. node .github/actions/lib/smoke.mjs --traces - every line must read ok. --traces prints the latest requests the gateway captured, newest first.

3. Browser check (the SPA is only verified once it has rendered):

   pnpm exec playwright-cli open http://localhost:5174
   pnpm exec playwright-cli snapshot        # Stack check card: status, version, latency, request id
   pnpm exec playwright-cli console error   # expect no errors
   pnpm exec playwright-cli requests        # /api/v1/health returned 200; an earlier [FAILED] net::ERR_ABORTED is StrictMode cancelling the first signal-bound fetch
   pnpm exec playwright-cli close
   

   Always type the pnpm exec playwright-cli prefix. The binary is a repo devDependency and is not on PATH, and that exact prefix is what sandbox.excludedCommands lets out of the sandbox: Chrome cannot start inside it. Never cd, pipe, or redirect it, and chain steps with plain && only: any other form runs it sandboxed, where it fails with EPERM on ~/Library/Caches/ms-playwright/daemon or loses the session; read --raw / --json output from stdout instead. The upstream playwright-cli skill documents every other command - apply the same prefix to its examples. If the browser is missing on a new machine: pnpm exec playwright-cli install-browser chromium.

4. Stop both background tasks when done.