Readiness and acceptance checklist
Status
Section titled “Status”The static documentation/dashboard build and mocked tests do not establish that a deployed coding task works end to end. This is a prototype. Do not expose it publicly or call it production-ready. spec/GOAL.md contains targets beyond the current implementation.
Remaining blockers
Section titled “Remaining blockers”- Live run (T10): no dated cloud run is recorded. Local tests do not prove deploy, Access, or container billing. See
VERIFICATION.md. - Authorization:
REQUIRE_ACCESSonly checks the Access email header — not JWT. Cover every hostname with Access; forge-header tests must still fail from outside Access. - Harness image: Dockerfile installs OpenCode only.
AGENT_HARNESS=claude-codeorcodexfails at exec until a matching image exists. - Private cloning: path-scoped
GITHUB_TOKENis for github.com traffic of the approved repo; it is not a clone-time credential store. - npm inside the sandbox:
registry.npmjs.orgis off the egress allowlist on purpose. - Lifecycle: cancellation destroys the sandbox; idle tail is
sleepAfter = 1m. Registry clear is not complete data erasure.
Local acceptance
Section titled “Local acceptance”pnpm installpnpm typecheckpnpm lintpnpm testpnpm docs:checkpnpm buildpnpm docs:verifynpx wrangler deploy --dry-runRecord actual failures, including missing container runtime/image support. Do not replace a dry run with a real deployment to get a green result. Review package audit findings separately; do not force dependency upgrades without compatibility review.
Account-owned integration acceptance (not executed by these docs)
Section titled “Account-owned integration acceptance (not executed by these docs)”After implementing the missing boundaries, use an isolated test installation and a repository you own:
- Verify unauthorized browser, run API, child-agent, and service requests are denied. Verify authorized browser WebSockets and server-side provider requests work.
- Submit a harmless README task without publishing; verify no container starts before approval. Reject it and verify no work occurs.
- Submit again, compare exact proposed input, approve, and observe clone/configure/code/collect phases.
- Compare actual changes to the transcript, including new files, diff, exit status, truncation, and redaction.
- Verify no-change and controlled failure tasks are reported honestly.
- Cancel during execution, verify the process stops, and confirm late output cannot revive a cancelled record.
- Exercise the three-run limit, reconnect, retained history, and clear-history partial failures.
- On a dedicated test repository, explicitly approve publishing and verify the intended branch and PR; do not use production repositories for this test.
- Check keyboard operation, narrow/desktop layouts, docs navigation/search, and missing-path 404 behavior.
Record date, revisions, versions, environment, results, and unresolved failures. Mocked tests alone are insufficient to mark the product complete.
