T1/Phase 1: scaffold Vite SPA + Hono API + Bun worker

- apps/web: Vite + React 19 + TanStack Router/Query + shadcn/ui
   - apps/api: Hono + Bun on :3001 with /api/health, /api/auth/*, /mcp stubs
   - apps/worker: Bun worker stub, DB connection, graceful SIGTERM
   - apps/web-legacy/: old Next.js code moved aside (preserved for T2-T8 reference)
   - Dockerfiles: api (Bun), worker (Bun), spa (multi-stage Caddy)
   - Caddyfile: serves dist + reverse-proxies /api/* + /mcp to api
   - docker-compose.yml: 4-service target (api, spa, db, worker)
   - packages/db/src/client.ts: shared Drizzle client for api + worker
   - db/client.ts: root-level alias for convenience

   Parent: t_e1cbd87d -> t_24c9c3fd (T0)

BASELINE.md

@@ -35,3 +35,28 @@
 5. Reference `.migration-baseline-schema.sql` for the DB schema the new API must preserve
 6. Use `bun` (v1.3.14) for all package management and runtime
 7. Keep `db` and `worker` containers running
+
+## T1 — Phase 1 Scaffold (completed)
+
+### Legacy code moved
+- Old Next.js `apps/web/` → `apps/web-legacy/` (preserved for T2-T8 reference)
+
+### New apps created
+| App | Path | Tech | Port |
+|-----|------|------|------|
+| SPA | `apps/web/` | Vite 5 + React 19 + TanStack Router/Query + shadcn/ui | :3000 (dev) |
+| API | `apps/api/` | Hono 4 + Bun | :3001 |
+| Worker | `apps/worker/` | Bun + Drizzle | — |
+
+### Shared infrastructure
+- `db/client.ts` — shared Drizzle client (postgres-js driver)
+- `db/` — root-level directory (shared by api + worker)
+- `bunfig.toml` — Bun package manager config
+- Root `package.json` — Bun workspaces monorepo (`apps/*`, `packages/*`)
+
+### Docker
+- `Dockerfile.api` — Bun base, copies apps/api + db + packages
+- `Dockerfile.worker` — Bun base, copies apps/worker + db + packages
+- `Dockerfile.spa` — Multi-stage: Bun build → Caddy serve
+- `Caddyfile` — Serves dist on :80, reverse-proxies /api/* and /mcp to api:3000
+- `docker-compose.yml` — 4 services: db, api, spa, worker (old web service removed)

Caddyfile

@@ -0,0 +1,11 @@
+:80 {
+    root * /usr/share/caddy
+    file_server
+
+    @api path /api/* /mcp*
+    reverse_proxy @api api:3000
+
+    handle_errors {
+        respond 404 "Not Found"
+    }
+}

Dockerfile.api

@@ -0,0 +1,19 @@
+FROM oven/bun:1.3 AS base
+WORKDIR /app
+
+# Copy workspace manifests
+COPY package.json bunfig.toml ./
+COPY apps/api/package.json apps/api/
+COPY packages/db/package.json packages/db/
+COPY packages/shared/package.json packages/shared/
+
+# Install dependencies (Bun workspace-aware)
+RUN bun install --production --frozen-lockfile 2>/dev/null || bun install --production
+
+# Copy source code
+COPY apps/api/src ./apps/api/src
+COPY db ./db
+COPY packages/db/src ./packages/db/src
+COPY packages/shared/src ./packages/shared/src
+
+CMD ["bun", "run", "apps/api/src/index.ts"]

Dockerfile.spa

@@ -0,0 +1,15 @@
+# Build stage
+FROM oven/bun:1.3 AS builder
+WORKDIR /app
+
+COPY package.json bunfig.toml ./
+COPY apps/web/package.json apps/web/
+RUN bun install --frozen-lockfile 2>/dev/null || bun install
+
+COPY apps/web ./apps/web
+RUN cd apps/web && bun run build
+
+# Serve stage
+FROM caddy:alpine
+COPY --from=builder /app/apps/web/dist /usr/share/caddy
+COPY Caddyfile /etc/caddy/Caddyfile

Dockerfile.worker

@@ -1,18 +1,19 @@
-FROM node:22-alpine
+FROM oven/bun:1.3 AS base
-
 WORKDIR /app
 
-COPY package.json package-lock.json ./
+# Copy workspace manifests
-COPY worker/package.json worker/package.json
+COPY package.json bunfig.toml ./
-COPY packages/shared/package.json packages/shared/package.json
+COPY apps/worker/package.json apps/worker/
-COPY packages/db/package.json packages/db/package.json
+COPY packages/db/package.json packages/db/
+COPY packages/shared/package.json packages/shared/
 
-RUN npm ci --omit=dev
+# Install dependencies
+RUN bun install --production --frozen-lockfile 2>/dev/null || bun install --production
 
-COPY worker/ ./worker/
+# Copy source code
-COPY packages/shared/ ./packages/shared/
+COPY apps/worker/src ./apps/worker/src
-COPY packages/db/ ./packages/db/
+COPY db ./db
+COPY packages/db/src ./packages/db/src
+COPY packages/shared/src ./packages/shared/src
 
-ENV NODE_ENV=production
+CMD ["bun", "run", "apps/worker/src/index.ts"]
-
-CMD ["npx", "tsx", "worker/index.ts"]

apps/api/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@project-e/api",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "bun run --watch src/index.ts",
+    "start": "bun run src/index.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@project-e/db": "^0.1.0",
+    "hono": "^4.6.0",
+    "drizzle-orm": "^0.45.2",
+    "postgres": "^3.4.9"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.0",
+    "typescript": "^5.9.3"
+  }
+}

apps/api/src/index.ts

@@ -0,0 +1,31 @@
+import { Hono } from "hono";
+import { cors } from "hono/cors";
+import { logger } from "hono/logger";
+import { authRoutes } from "./routes/auth";
+import { mcpRoutes } from "./routes/mcp";
+import { realtimeRoutes } from "./routes/realtime";
+
+const app = new Hono();
+
+// Middleware
+app.use("*", cors({ origin: "http://localhost:3000", credentials: true }));
+app.use("*", logger());
+
+// Health check
+app.get("/api/health", (c) => {
+  return c.json({ status: "ok", version: "0.1.0", runtime: "bun" });
+});
+
+// Routes
+app.route("/api/auth", authRoutes);
+app.route("/mcp", mcpRoutes);
+app.route("/api", realtimeRoutes);
+
+const port = parseInt(process.env.PORT || "3001", 10);
+
+export default {
+  port,
+  fetch: app.fetch,
+};
+
+console.log(`API server listening on :${port}`);

apps/api/src/routes/auth.ts

@@ -0,0 +1,22 @@
+import { Hono } from "hono";
+
+export const authRoutes = new Hono();
+
+// POST /api/auth/credentials — stub JWT placeholder
+authRoutes.post("/credentials", async (c) => {
+  const { email, password } = await c.req.json();
+  // Stub: accept any credentials for now
+  if (!email || !password) {
+    return c.json({ message: "Email and password required" }, 400);
+  }
+  // Return a stub JWT (real auth in T2)
+  return c.json({
+    token: "stub-jwt-token",
+    user: { email, name: email.split("@")[0] },
+  });
+});
+
+// GET /api/auth/session — placeholder
+authRoutes.get("/session", (c) => {
+  return c.json({ authenticated: false, user: null });
+});

apps/api/src/routes/mcp.ts

@@ -0,0 +1,14 @@
+import { Hono } from "hono";
+
+export const mcpRoutes = new Hono();
+
+// GET /mcp — placeholder returning JSON-RPC methods list
+mcpRoutes.get("/", (c) => {
+  return c.json({
+    jsonrpc: "2.0",
+    methods: [
+      { name: "ping", description: "Health check" },
+      { name: "list_tools", description: "List available tools" },
+    ],
+  });
+});

apps/api/src/routes/realtime.ts

@@ -0,0 +1,19 @@
+import { Hono } from "hono";
+import { stream } from "hono/streaming";
+
+export const realtimeRoutes = new Hono();
+
+// GET /api/realtime — SSE endpoint stub
+realtimeRoutes.get("/realtime", (c) => {
+  return stream(c, async (stream) => {
+    c.header("Content-Type", "text/event-stream");
+    c.header("Cache-Control", "no-cache");
+    c.header("Connection", "keep-alive");
+    await stream.write("data: {\"event\":\"connected\"}\n\n");
+    // Keep connection open
+    while (true) {
+      await stream.write(": heartbeat\n\n");
+      await stream.sleep(30000);
+    }
+  });
+});

apps/api/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2023"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "isolatedModules": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src"]
+}