Spellbook OS

`$ship --no-deploy` - archive Phase 1 and load Phase 2 after the manual Step 1.3 and Step 1.4 blockers are resolved because all six Phase 1 implementation steps in `tasks/todo.md` are checked, validation is recorded as green, and no `tasks/phases/` archive exists as of this scan.

Complete manual task: "Create the Neon project and provision `DATABASE_URL`, pooled connection URL, and migration credentials." _(blocks: Step 1.3)_ — resolve before `$run` can continue. Evidence: listed in `tasks/manual-todo.md` modified 2026-04-08 22:56:53 EDT; Phase 1 transition notes in `tasks/todo.md` modified 2026-04-12 22:52:36 EDT still name this as a blocker.

Complete manual task: "Create the Stripe product, monthly Creator price with lookup key `spellbook.creator.monthly`, free-trial settings, webhook secret, and billing portal configuration." _(blocks: Step 1.4)_ — resolve before `$run` can continue. Evidence: listed in `tasks/manual-todo.md` modified 2026-04-08 22:56:53 EDT; Phase 1 transition notes in `tasks/todo.md` modified 2026-04-12 22:52:36 EDT still name this as a blocker.

Complete manual task: "Populate local Stripe env vars for Step 1.4 in `.env.local`." _(blocks: Step 1.4)_ — resolve before `$run` can continue. Evidence: listed in `tasks/manual-todo.md` modified 2026-04-08 22:56:53 EDT; Phase 1 transition notes in `tasks/todo.md` modified 2026-04-12 22:52:36 EDT still name this as a blocker.

Step 1.1: Add failing unit and integration tests for workspace provisioning, subscription gating, auth session resolution, and job enqueue contracts in likely paths such as `apps/web/tests/integration/auth.test.ts`, `apps/web/tests/integration/billing.test.ts`, `packages/domain/src/*.test.ts`, and `packages/jobs/src/*.test.ts`. (**automated**)

Step 1.2: Create the real web application shell at `apps/web/` with App Router structure, shared layouts, route placeholders for `/sanctum`, `/foresight`, `/prism`, `/ritual`, `/portals`, and `/scry`, and update root workspace configuration in `package.json`, `pnpm-workspace.yaml`, `tsconfig.base.json`, and a new `turbo.json` if adopted. (**automated**)

Step 1.3: Introduce database and runtime packages such as `packages/db/`, `packages/auth/`, `packages/billing/`, and `packages/jobs/`, add Drizzle schema files for users, workspaces, subscriptions, and jobs, and add `drizzle.config.ts` plus `.env.example`. (**automated**)

Step 1.4: Implement Better Auth, Stripe checkout and customer-portal stubs, workspace bootstrap actions, and job-table backed worker contracts in paths such as `apps/web/app/api/*`, `packages/auth/src/*`, `packages/billing/src/*`, and `packages/jobs/src/*`. (**automated**)

Step 1.5: Add app-wide observability and error handling primitives for request IDs, structured job logging, and background job status transitions in `apps/web/src/lib/*` and `packages/jobs/src/*`. (**automated**)

Step 1.6: Make all new foundation tests pass, run the app-level test suite, and verify the route shell, auth bootstrap, billing gate, and worker contract smoke checks all succeed locally. (**automated**)