feat(dev): add project seed script with fixtures across stages

docs/DEV.md

@@ -91,9 +91,26 @@ real API ([CONTRIBUTING.md](https://github.com/corbitsdev/corbits-builder/blob/m
 | `bun run docker:sidecar`  | Builds the sidecar Docker image.                                                                                                 |
 | `bun run auth:bootstrap`  | Migrates and creates the `BOOTSTRAP_*` machine account and workspace.                                                            |
 | `bun run auth:emulate`    | Starts a loopback Google sign-in emulator (`GOOGLE_EMULATE_URL` in `.env.hub.example`).                                          |
+| `bun run dev:seed`        | Seeds dummy projects (`habit-tracker`, `field-service-dispatch`, `clinical-trial-intake`) at a chosen lifecycle stage.           |
 | `bun run vendor:verify`   | Checks `vendor/interchange` matches its pinned upstream commit.                                                                  |
 | `bun run skills:react-ui` | Regenerates the designer's `@corbits/react-ui` API reference.                                                                    |
 
+## Seeding dummy projects
+
+`bun run dev:seed` populates a workspace tenant (defaulting to the first
+workspace tenant in Postgres, or creating a local development workspace if the
+database is empty) with up to three realistic dummy projects across any stage
+(`idea`, `brief`, `planning`, `design_options`, `designed`, `ready_to_build`,
+`shipped`):
+
+```sh
+bun run dev:seed                                                      # all 3 fixtures at their default stages
+bun run dev:seed -- --fixture=habit-tracker --stage=planning          # single fixture with planning docs approved
+bun run dev:seed -- --fixture=field-service-dispatch --stage=planning --no-approve
+bun run dev:seed -- --fixture=clinical-trial-intake --stage=design_options
+bun run dev:seed -- --stage=ready_to_build --tenant=<workspaceTenantId>
+```
+
 ## Where things live
 
 - Product names and user-visible wording: `apps/hub/src/config/` and

package.json

@@ -28,6 +28,7 @@
     "docker:sidecar": "docker build -f deploy/Dockerfile --target sidecar -t corbits-builder-sidecar:local .",
     "auth:bootstrap": "bun --env-file=.env.hub --conditions=intx-src apps/hub/src/setup.ts",
     "auth:emulate": "bun --env-file=.env.hub scripts/google-emulate.ts",
+    "dev:seed": "bun --env-file=.env.hub --conditions=intx-src scripts/seed-projects.ts",
     "lint": "bun --bun run oxlint --deny-warnings",
     "format": "bun fmt --no-script",
     "format:check": "bun fmt --no-script --check",