launch-verify-debug

Launch Verify Debug

Use this skill for /api/admin/launch-verify, pnpm smoke:remote, and vclaw create readiness failures.

Evidence First

Collect:

• Request mode: destructive or read-only, JSON or NDJSON.
• Full phase payload with secrets redacted.
• GET /api/admin/preflight and persisted GET /api/admin/launch-verify when available.
• GET /api/channels/summary for channel readiness.
• GET /api/admin/logs filtered for launch., preflight., sandbox., gateway., channels..

Phase Splits

Report each phase separately:

• preflight
• queuePing
• ensureRunning
• chatCompletions
• wakeFromSleep
• restorePrepared
• channelReadiness

Do not collapse ready:false into one root cause. failingChannelIds is the machine-readable channel failure list; warningChannelIds is deprecated.

Fix Boundaries

• Preflight: src/server/deploy-preflight.ts, src/app/api/admin/preflight/route.ts.
• Launch verify: src/app/api/admin/launch-verify/route.ts, src/app/api/queues/launch-verify/route.ts.
• Smoke: src/server/smoke/remote-smoke.ts, src/server/smoke/remote-phases.ts.
• Restore phase: src/server/sandbox/restore-oracle.ts and lifecycle callers.

Verification

node scripts/verify.mjs --steps=test,typecheck
pnpm smoke:remote --base-url <url> [--destructive] [--auth-cookie "session=..."]
lat check

For live launch fixes, include the terminal launch verification payload and the exact failed phase before/after.