@obh/forge 0.2.0

package/dist/generators/root.js

@@ -0,0 +1,249 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addProjectSkeleton = addProjectSkeleton;
+exports.envBase = envBase;
+exports.ciYaml = ciYaml;
+/**
+ * Adds the project-level skeleton shared by every recipe: workspace config,
+ * base tsconfig, migration runner, CI, and docs. Everything here is a safe
+ * "create" — re-running never clobbers edited files.
+ */
+function addProjectSkeleton(plan, opts) {
+    const { name } = opts;
+    plan.create("package.json", JSON.stringify({
+        name,
+        private: true,
+        version: "0.1.0",
+        packageManager: "pnpm@9.7.0",
+        engines: { node: ">=20" },
+        scripts: {
+            dev: "pnpm -r --parallel --filter './apps/*' dev",
+            build: "pnpm -r build",
+            typecheck: "pnpm -r typecheck",
+            test: "pnpm -r test",
+            migrate: "tsx scripts/migrate.ts",
+        },
+        devDependencies: {
+            "@types/node": "^20.14.0",
+            "@types/pg": "^8.11.6",
+            pg: "^8.12.0",
+            tsx: "^4.16.0",
+            typescript: "^5.5.4",
+        },
+    }, null, 2) + "\n", "root workspace package.json");
+    plan.create("pnpm-workspace.yaml", ["packages:", "  - apps/*", "  - packages/*", ""].join("\n"), "pnpm workspace definition");
+    plan.create("tsconfig.base.json", JSON.stringify({
+        compilerOptions: {
+            target: "ES2022",
+            module: "commonjs",
+            moduleResolution: "node",
+            lib: ["ES2022"],
+            declaration: true,
+            sourceMap: true,
+            strict: true,
+            esModuleInterop: true,
+            skipLibCheck: true,
+            forceConsistentCasingInFileNames: true,
+            resolveJsonModule: true,
+            types: ["node"],
+        },
+    }, null, 2) + "\n", "shared TypeScript base config (CommonJS, matches @obh/* packages)");
+    plan.create(".gitignore", ["node_modules/", "dist/", "coverage/", "*.log", ".env", ".env.local", ".DS_Store", ""].join("\n"), "gitignore");
+    plan.create(".env.example", envBase(name), "environment example");
+    plan.create("migrations/0001_init.sql", INIT_SQL, "initial product migration");
+    plan.create("scripts/migrate.ts", MIGRATE_RUNNER, "migration runner (SQL files + platform primitives)");
+    plan.create("scripts/migrations.d/.gitkeep", "", "platform migration wiring directory");
+    plan.create(".github/workflows/ci.yml", ciYaml(name), "GitHub Actions CI (build, typecheck, test, Postgres service)");
+    plan.create("README.md", readme(name), "project readme");
+    plan.create("AGENTS.md", agents(name), "conventions doc for humans and Claude skills");
+}
+const INIT_SQL = `-- 0001_init.sql — product schema baseline.
+-- Product tables live in the default (public) schema.
+-- OBH platform primitives own their own tables under the "platform" schema
+-- and are migrated by their packages via scripts/migrations.d/*.
+
+create table if not exists health_check (
+  id integer primary key default 1,
+  checked_at timestamptz not null default now()
+);
+
+insert into health_check (id) values (1) on conflict (id) do nothing;
+`;
+const MIGRATE_RUNNER = `#!/usr/bin/env tsx
+/**
+ * Migration runner. Applies:
+ *   1. Product SQL migrations in migrations/*.sql (tracked in _forge_migrations).
+ *   2. Platform primitive migrations registered in scripts/migrations.d/*.
+ *
+ * Each \`forge add <primitive>\` drops a file into scripts/migrations.d/ that
+ * exports \`migrate(pool)\`. This runner discovers them — nothing here is patched
+ * by hand.
+ */
+import { readdirSync, readFileSync } from "node:fs"
+import path from "node:path"
+import { Pool } from "pg"
+
+async function main(): Promise<void> {
+  const databaseUrl = process.env.DATABASE_URL
+  if (!databaseUrl) throw new Error("DATABASE_URL is not set")
+  const pool = new Pool({ connectionString: databaseUrl })
+
+  try {
+    await pool.query(
+      \`create table if not exists _forge_migrations (
+         name text primary key,
+         applied_at timestamptz not null default now()
+       )\`,
+    )
+
+    // 1. Product SQL migrations, in filename order.
+    const migrationsDir = path.join(__dirname, "..", "migrations")
+    const sqlFiles = readdirSync(migrationsDir).filter((f) => f.endsWith(".sql")).sort()
+    for (const file of sqlFiles) {
+      const done = await pool.query("select 1 from _forge_migrations where name = $1", [file])
+      if (done.rowCount) continue
+      const sql = readFileSync(path.join(migrationsDir, file), "utf8")
+      await pool.query(sql)
+      await pool.query("insert into _forge_migrations (name) values ($1)", [file])
+      console.log("applied", file)
+    }
+
+    // 2. Platform primitive migrations (each capability drops a module here).
+    const dir = path.join(__dirname, "migrations.d")
+    const modules = readdirSync(dir).filter((f) => /\\.(ts|js)$/.test(f) && !f.startsWith("."))
+    for (const file of modules.sort()) {
+      const mod = await import(path.join(dir, file))
+      if (typeof mod.migrate === "function") {
+        await mod.migrate(pool)
+        console.log("migrated platform:", file)
+      }
+    }
+  } finally {
+    await pool.end()
+  }
+}
+
+main().catch((err) => {
+  console.error(err)
+  process.exit(1)
+})
+`;
+function envBase(name) {
+    return `# ${name} environment
+# Copy to .env and fill in. Never commit real secrets.
+
+DATABASE_URL=postgres://postgres:postgres@localhost:5432/${name}
+`;
+}
+function ciYaml(name) {
+    return `name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  build-test:
+    runs-on: ubuntu-latest
+
+    services:
+      postgres:
+        image: postgres:16
+        env:
+          POSTGRES_USER: postgres
+          POSTGRES_PASSWORD: postgres
+          POSTGRES_DB: ${name}_test
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd "pg_isready -U postgres"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+
+    env:
+      DATABASE_URL: postgres://postgres:postgres@localhost:5432/${name}_test
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 9
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: pnpm
+      - run: pnpm install --no-frozen-lockfile
+      - run: pnpm build
+      - run: pnpm typecheck
+      - run: pnpm test
+`;
+}
+function readme(name) {
+    return `# ${name}
+
+Scaffolded with [OBH Forge](https://github.com/EObrien60/forge).
+
+## Layout
+
+\`\`\`
+apps/        deployable applications (api, admin, worker, …)
+packages/    shared internal packages (sdk, ui, config)
+deploy/      lwd deployment manifests
+docker/      Dockerfiles
+migrations/  product SQL migrations
+scripts/     migrate, seed, dev helpers
+forge.json   record of what Forge generated (see below)
+\`\`\`
+
+## Develop
+
+\`\`\`bash
+pnpm install
+pnpm migrate      # apply product + platform migrations (needs DATABASE_URL)
+pnpm dev          # run all apps
+\`\`\`
+
+## Platform primitives
+
+Add OBH platform capabilities incrementally — each is opt-in:
+
+\`\`\`bash
+forge add events
+forge add jobs
+forge add files
+forge add audit
+\`\`\`
+
+\`forge inspect\` reports the project shape; \`forge doctor\` checks it against
+OBH conventions. \`forge.json\` records what was generated.
+
+## Deploy
+
+Deployment manifests live in \`deploy/*.lwd.toml\` and target lwd. Set secret
+values out-of-band with \`lwd secret set <app> <KEY>\` — manifests contain secret
+names only.
+`;
+}
+function agents(name) {
+    return `# ${name} — conventions
+
+This project was scaffolded by OBH Forge. Conventions Claude skills and humans
+can rely on:
+
+- **Package manager:** pnpm workspace (\`apps/*\`, \`packages/*\`).
+- **Language:** TypeScript, \`strict\`, CommonJS (matches \`@obh/*\` packages).
+- **Database:** Postgres. Product tables in \`public\`; platform primitives own
+  the \`platform\` schema. No ORM auto-sync — migrations run via \`pnpm migrate\`.
+- **API:** routes in \`apps/api/src/routes/*.ts\`, each exporting \`register(app)\`;
+  the server auto-mounts them. Add routes by dropping files, not editing a router.
+- **Worker:** consumers in \`apps/worker/src/consumers.d/*.ts\`, auto-loaded.
+- **Migrations:** platform primitives register in \`scripts/migrations.d/*.ts\`.
+- **Deploy:** lwd manifests in \`deploy/*.lwd.toml\`; secret names only.
+- **Record:** \`forge.json\` tracks generated shape and installed primitives.
+
+Prefer boring, explicit code. Generated files are yours to edit or delete.
+`;
+}
+//# sourceMappingURL=root.js.map

package/dist/generators/root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"root.js","sourceRoot":"","sources":["../../src/generators/root.ts"],"names":[],"mappings":";;AAaA,gDAiFC;AA2ED,0BAMC;AAED,wBA4CC;AArND;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,IAAU,EAAE,IAAqB;IAClE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAA;IAErB,IAAI,CAAC,MAAM,CACT,cAAc,EACd,IAAI,CAAC,SAAS,CACZ;QACE,IAAI;QACJ,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,OAAO;QAChB,cAAc,EAAE,YAAY;QAC5B,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;QACzB,OAAO,EAAE;YACP,GAAG,EAAE,4CAA4C;YACjD,KAAK,EAAE,eAAe;YACtB,SAAS,EAAE,mBAAmB;YAC9B,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,wBAAwB;SAClC;QACD,eAAe,EAAE;YACf,aAAa,EAAE,UAAU;YACzB,WAAW,EAAE,SAAS;YACtB,EAAE,EAAE,SAAS;YACb,GAAG,EAAE,SAAS;YACd,UAAU,EAAE,QAAQ;SACrB;KACF,EACD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI,EACR,6BAA6B,CAC9B,CAAA;IAED,IAAI,CAAC,MAAM,CACT,qBAAqB,EACrB,CAAC,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAC5D,2BAA2B,CAC5B,CAAA;IAED,IAAI,CAAC,MAAM,CACT,oBAAoB,EACpB,IAAI,CAAC,SAAS,CACZ;QACE,eAAe,EAAE;YACf,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,UAAU;YAClB,gBAAgB,EAAE,MAAM;YACxB,GAAG,EAAE,CAAC,QAAQ,CAAC;YACf,WAAW,EAAE,IAAI;YACjB,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,IAAI;YACZ,eAAe,EAAE,IAAI;YACrB,YAAY,EAAE,IAAI;YAClB,gCAAgC,EAAE,IAAI;YACtC,iBAAiB,EAAE,IAAI;YACvB,KAAK,EAAE,CAAC,MAAM,CAAC;SAChB;KACF,EACD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI,EACR,mEAAmE,CACpE,CAAA;IAED,IAAI,CAAC,MAAM,CACT,YAAY,EACZ,CAAC,eAAe,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAClG,WAAW,CACZ,CAAA;IAED,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,qBAAqB,CAAC,CAAA;IAEjE,IAAI,CAAC,MAAM,CAAC,0BAA0B,EAAE,QAAQ,EAAE,2BAA2B,CAAC,CAAA;IAE9E,IAAI,CAAC,MAAM,CAAC,oBAAoB,EAAE,cAAc,EAAE,oDAAoD,CAAC,CAAA;IACvG,IAAI,CAAC,MAAM,CAAC,+BAA+B,EAAE,EAAE,EAAE,qCAAqC,CAAC,CAAA;IAEvF,IAAI,CAAC,MAAM,CAAC,0BAA0B,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,8DAA8D,CAAC,CAAA;IAErH,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC,CAAA;IACxD,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,8CAA8C,CAAC,CAAA;AACxF,CAAC;AAED,MAAM,QAAQ,GAAG;;;;;;;;;;;CAWhB,CAAA;AAED,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0DtB,CAAA;AAED,SAAgB,OAAO,CAAC,IAAY;IAClC,OAAO,KAAK,IAAI;;;2DAGyC,IAAI;CAC9D,CAAA;AACD,CAAC;AAED,SAAgB,MAAM,CAAC,IAAY;IACjC,OAAO;;;;;;;;;;;;;;;;;yBAiBgB,IAAI;;;;;;;;;;kEAUqC,IAAI;;;;;;;;;;;;;;;CAerE,CAAA;AACD,CAAC;AAED,SAAS,MAAM,CAAC,IAAY;IAC1B,OAAO,KAAK,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2CjB,CAAA;AACD,CAAC;AAED,SAAS,MAAM,CAAC,IAAY;IAC1B,OAAO,KAAK,IAAI;;;;;;;;;;;;;;;;;CAiBjB,CAAA;AACD,CAAC"}

package/dist/generators/sdk.d.ts

@@ -0,0 +1,14 @@
+import type { ExampleDomain } from "../types";
+import type { Plan } from "../project/plan";
+export interface SdkOptions {
+    scope: string;
+    example: ExampleDomain;
+}
+/**
+ * Generates the shared SDK package: the typed contract between backend and
+ * frontends. This is the piece whose absence produced qMechanic's 3,200-line
+ * defensive apiClient, so Forge makes it the one place request/response shapes
+ * are defined.
+ */
+export declare function addSdkPackage(plan: Plan, opts: SdkOptions): void;
+//# sourceMappingURL=sdk.d.ts.map

package/dist/generators/sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/generators/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAE3C,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,aAAa,CAAA;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAwDhE"}

package/dist/generators/sdk.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addSdkPackage = addSdkPackage;
+/**
+ * Generates the shared SDK package: the typed contract between backend and
+ * frontends. This is the piece whose absence produced qMechanic's 3,200-line
+ * defensive apiClient, so Forge makes it the one place request/response shapes
+ * are defined.
+ */
+function addSdkPackage(plan, opts) {
+    const dir = "packages/sdk";
+    const notes = opts.example === "notes";
+    plan.create(`${dir}/package.json`, JSON.stringify({
+        name: `${opts.scope}/sdk`,
+        version: "0.1.0",
+        private: true,
+        // ESM so Vite/Rollup can tree-shake the named exports (a CommonJS SDK
+        // breaks `vite build` in a consuming frontend).
+        type: "module",
+        main: "dist/index.js",
+        module: "dist/index.js",
+        types: "dist/index.d.ts",
+        files: ["dist"],
+        scripts: {
+            build: "tsc -p tsconfig.json",
+            typecheck: "tsc -p tsconfig.json --noEmit",
+            test: "vitest run --passWithNoTests",
+        },
+        devDependencies: { typescript: "^5.5.4", vitest: "^2.0.5" },
+    }, null, 2) + "\n", "SDK package.json");
+    plan.create(`${dir}/tsconfig.json`, JSON.stringify({
+        extends: "../../tsconfig.base.json",
+        compilerOptions: {
+            rootDir: "src",
+            outDir: "dist",
+            // Emit ESM (overrides the CommonJS base) so frontends bundle it cleanly.
+            module: "ESNext",
+            moduleResolution: "bundler",
+            lib: ["ES2022", "DOM"],
+        },
+        include: ["src"],
+        exclude: ["dist", "node_modules", "src/**/*.test.ts"],
+    }, null, 2) + "\n", "SDK tsconfig");
+    plan.create(`${dir}/src/index.ts`, INDEX, "SDK entrypoint");
+    plan.create(`${dir}/src/types.ts`, notes ? TYPES_NOTES : TYPES_BASE, "shared domain types");
+    plan.create(`${dir}/src/client.ts`, notes ? CLIENT_NOTES : CLIENT_BASE, "typed API client");
+}
+const INDEX = `// Public surface of the SDK — the one contract shared by API and frontends.
+export * from "./types"
+export { createClient } from "./client"
+export type { Client, ClientOptions } from "./client"
+`;
+const TYPES_BASE = `export interface HealthStatus {
+  status: "ok" | "degraded"
+}
+`;
+const TYPES_NOTES = `export interface HealthStatus {
+  status: "ok" | "degraded"
+}
+
+export interface Note {
+  id: string
+  title: string
+  body: string
+  createdAt: string
+  updatedAt: string
+}
+
+export interface CreateNoteInput {
+  title: string
+  body?: string
+}
+
+export interface UpdateNoteInput {
+  title?: string
+  body?: string
+}
+`;
+const CLIENT_HEAD = `import type { HealthStatus } from "./types"
+
+export interface ClientOptions {
+  baseUrl: string
+  /** Optional bearer token provider. */
+  token?: () => string | null
+}
+
+async function request<T>(opts: ClientOptions, path: string, init?: RequestInit): Promise<T> {
+  const headers = new Headers(init?.headers)
+  if (init?.body) headers.set("content-type", "application/json")
+  const token = opts.token?.()
+  if (token) headers.set("authorization", "Bearer " + token)
+  const res = await fetch(opts.baseUrl + path, { ...init, headers })
+  if (!res.ok) throw new Error(path + " failed: " + res.status)
+  if (res.status === 204) return undefined as T
+  return (await res.json()) as T
+}
+`;
+const CLIENT_BASE = `${CLIENT_HEAD}
+export interface Client {
+  health(): Promise<HealthStatus>
+}
+
+/** A thin typed fetch client. Add one method per API resource. */
+export function createClient(opts: ClientOptions): Client {
+  return {
+    health: () => request<HealthStatus>(opts, "/health"),
+  }
+}
+`;
+const CLIENT_NOTES = `import type { CreateNoteInput, Note, UpdateNoteInput } from "./types"
+${CLIENT_HEAD}
+export interface Client {
+  health(): Promise<HealthStatus>
+  notes: {
+    list(): Promise<Note[]>
+    get(id: string): Promise<Note>
+    create(input: CreateNoteInput): Promise<Note>
+    update(id: string, input: UpdateNoteInput): Promise<Note>
+    remove(id: string): Promise<void>
+  }
+}
+
+/** A thin typed fetch client — the single contract shared with every frontend. */
+export function createClient(opts: ClientOptions): Client {
+  return {
+    health: () => request<HealthStatus>(opts, "/health"),
+    notes: {
+      list: () => request<Note[]>(opts, "/notes"),
+      get: (id) => request<Note>(opts, "/notes/" + id),
+      create: (input) => request<Note>(opts, "/notes", { method: "POST", body: JSON.stringify(input) }),
+      update: (id, input) => request<Note>(opts, "/notes/" + id, { method: "PUT", body: JSON.stringify(input) }),
+      remove: (id) => request<void>(opts, "/notes/" + id, { method: "DELETE" }),
+    },
+  }
+}
+`;
+//# sourceMappingURL=sdk.js.map

package/dist/generators/sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../../src/generators/sdk.ts"],"names":[],"mappings":";;AAcA,sCAwDC;AA9DD;;;;;GAKG;AACH,SAAgB,aAAa,CAAC,IAAU,EAAE,IAAgB;IACxD,MAAM,GAAG,GAAG,cAAc,CAAA;IAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,KAAK,OAAO,CAAA;IAEtC,IAAI,CAAC,MAAM,CACT,GAAG,GAAG,eAAe,EACrB,IAAI,CAAC,SAAS,CACZ;QACE,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,MAAM;QACzB,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE,IAAI;QACb,sEAAsE;QACtE,gDAAgD;QAChD,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE,eAAe;QACvB,KAAK,EAAE,iBAAiB;QACxB,KAAK,EAAE,CAAC,MAAM,CAAC;QACf,OAAO,EAAE;YACP,KAAK,EAAE,sBAAsB;YAC7B,SAAS,EAAE,+BAA+B;YAC1C,IAAI,EAAE,8BAA8B;SACrC;QACD,eAAe,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE;KAC5D,EACD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI,EACR,kBAAkB,CACnB,CAAA;IAED,IAAI,CAAC,MAAM,CACT,GAAG,GAAG,gBAAgB,EACtB,IAAI,CAAC,SAAS,CACZ;QACE,OAAO,EAAE,0BAA0B;QACnC,eAAe,EAAE;YACf,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,MAAM;YACd,yEAAyE;YACzE,MAAM,EAAE,QAAQ;YAChB,gBAAgB,EAAE,SAAS;YAC3B,GAAG,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC;SACvB;QACD,OAAO,EAAE,CAAC,KAAK,CAAC;QAChB,OAAO,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,kBAAkB,CAAC;KACtD,EACD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI,EACR,cAAc,CACf,CAAA;IAED,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,eAAe,EAAE,KAAK,EAAE,gBAAgB,CAAC,CAAA;IAC3D,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,eAAe,EAAE,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAA;IAC3F,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,gBAAgB,EAAE,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAA;AAC7F,CAAC;AAED,MAAM,KAAK,GAAG;;;;CAIb,CAAA;AAED,MAAM,UAAU,GAAG;;;CAGlB,CAAA;AAED,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;CAqBnB,CAAA;AAED,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;CAkBnB,CAAA;AAED,MAAM,WAAW,GAAG,GAAG,WAAW;;;;;;;;;;;CAWjC,CAAA;AAED,MAAM,YAAY,GAAG;EACnB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;CAyBZ,CAAA"}

package/dist/generators/web.d.ts

@@ -0,0 +1,15 @@
+import type { ExampleDomain } from "../types";
+import type { Plan } from "../project/plan";
+export interface WebOptions {
+    scope: string;
+    /** App directory name, e.g. "admin". */
+    name: string;
+    example: ExampleDomain;
+}
+/**
+ * Generates a Vite + React admin frontend that consumes the shared SDK. Because
+ * it imports the workspace SDK, its Docker build runs from the repo root
+ * (lwd git.path = ".") and filters to this app — see the generated Dockerfile.
+ */
+export declare function addWebApp(plan: Plan, opts: WebOptions): void;
+//# sourceMappingURL=web.d.ts.map

package/dist/generators/web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/generators/web.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAE3C,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,aAAa,CAAA;CACvB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAwE5D"}

package/dist/generators/web.js

@@ -0,0 +1,203 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addWebApp = addWebApp;
+/**
+ * Generates a Vite + React admin frontend that consumes the shared SDK. Because
+ * it imports the workspace SDK, its Docker build runs from the repo root
+ * (lwd git.path = ".") and filters to this app — see the generated Dockerfile.
+ */
+function addWebApp(plan, opts) {
+    const dir = `apps/${opts.name}`;
+    const pkgName = `${opts.scope}/${opts.name}`;
+    plan.create(`${dir}/package.json`, JSON.stringify({
+        name: pkgName,
+        version: "0.1.0",
+        private: true,
+        type: "module",
+        scripts: {
+            dev: "vite",
+            build: "vite build",
+            preview: "vite preview",
+            typecheck: "tsc --noEmit",
+            test: "vitest run --passWithNoTests",
+        },
+        dependencies: {
+            [`${opts.scope}/sdk`]: "workspace:*",
+            react: "^18.3.1",
+            "react-dom": "^18.3.1",
+            "react-router-dom": "^7.9.3",
+        },
+        devDependencies: {
+            "@types/react": "^18.3.3",
+            "@types/react-dom": "^18.3.0",
+            "@vitejs/plugin-react": "^4.3.1",
+            typescript: "^5.5.4",
+            vite: "^5.4.0",
+            vitest: "^2.0.5",
+        },
+    }, null, 2) + "\n", "admin app package.json");
+    plan.create(`${dir}/tsconfig.json`, JSON.stringify({
+        compilerOptions: {
+            target: "ES2022",
+            lib: ["ES2022", "DOM", "DOM.Iterable"],
+            module: "ESNext",
+            moduleResolution: "bundler",
+            jsx: "react-jsx",
+            strict: true,
+            skipLibCheck: true,
+            esModuleInterop: true,
+            resolveJsonModule: true,
+            noEmit: true,
+        },
+        include: ["src"],
+    }, null, 2) + "\n", "admin tsconfig (ESM/bundler for Vite)");
+    plan.create(`${dir}/vite.config.ts`, VITE_CONFIG, "vite config");
+    plan.create(`${dir}/index.html`, indexHtml(opts.name), "admin index.html");
+    plan.create(`${dir}/src/main.tsx`, MAIN, "admin entry");
+    plan.create(`${dir}/src/vite-env.d.ts`, '/// <reference types="vite/client" />\n', "vite client types (import.meta.env)");
+    plan.create(`${dir}/src/api.ts`, apiTs(opts.scope, opts.example), "admin API client instance");
+    plan.create(`${dir}/src/App.tsx`, opts.example === "notes" ? APP_NOTES : APP_BASE, "admin App");
+    plan.create(`${dir}/nginx.conf`, NGINX, "nginx SPA config");
+    plan.create(`${dir}/Dockerfile`, dockerfile(pkgName, opts.name), "admin Dockerfile (root-context build)");
+}
+const VITE_CONFIG = `import { defineConfig } from "vite"
+import react from "@vitejs/plugin-react"
+
+export default defineConfig({
+  plugins: [react()],
+})
+`;
+function indexHtml(name) {
+    return `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>${name}</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>
+`;
+}
+const MAIN = `import React from "react"
+import { createRoot } from "react-dom/client"
+import { App } from "./App"
+
+createRoot(document.getElementById("root")!).render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>,
+)
+`;
+function apiTs(scope, example) {
+    const typeReexport = example === "notes"
+        ? `export type { HealthStatus, Note, CreateNoteInput, UpdateNoteInput } from "${scope}/sdk"`
+        : `export type { HealthStatus } from "${scope}/sdk"`;
+    return `import { createClient } from "${scope}/sdk"
+${typeReexport}
+
+export const api = createClient({
+  baseUrl: import.meta.env.VITE_API_BASE_URL ?? "http://localhost:8080",
+  token: () => localStorage.getItem("token"),
+})
+`;
+}
+const APP_BASE = `import { useEffect, useState } from "react"
+import { api, type HealthStatus } from "./api"
+
+export function App(): JSX.Element {
+  const [health, setHealth] = useState<HealthStatus | null>(null)
+  useEffect(() => {
+    api.health().then(setHealth).catch(() => setHealth({ status: "degraded" }))
+  }, [])
+  return (
+    <main style={{ fontFamily: "system-ui", padding: 32, maxWidth: 720, margin: "0 auto" }}>
+      <h1>Admin</h1>
+      <p>API health: {health?.status ?? "…"}</p>
+    </main>
+  )
+}
+`;
+const APP_NOTES = `import { useEffect, useState } from "react"
+import { api, type Note } from "./api"
+
+export function App(): JSX.Element {
+  const [notes, setNotes] = useState<Note[]>([])
+  const [title, setTitle] = useState("")
+  const [body, setBody] = useState("")
+  const [error, setError] = useState<string | null>(null)
+
+  const reload = () => api.notes.list().then(setNotes).catch((e) => setError(String(e)))
+  useEffect(() => {
+    reload()
+  }, [])
+
+  const submit = async (e: React.FormEvent) => {
+    e.preventDefault()
+    if (!title.trim()) return
+    await api.notes.create({ title, body })
+    setTitle("")
+    setBody("")
+    await reload()
+  }
+
+  const remove = async (id: string) => {
+    await api.notes.remove(id)
+    await reload()
+  }
+
+  return (
+    <main style={{ fontFamily: "system-ui", padding: 32, maxWidth: 720, margin: "0 auto" }}>
+      <h1>Notes</h1>
+      {error && <p style={{ color: "crimson" }}>{error}</p>}
+
+      <form onSubmit={submit} style={{ display: "grid", gap: 8, marginBottom: 24 }}>
+        <input value={title} onChange={(e) => setTitle(e.target.value)} placeholder="Title" />
+        <textarea value={body} onChange={(e) => setBody(e.target.value)} placeholder="Body" rows={3} />
+        <button type="submit">Add note</button>
+      </form>
+
+      <ul style={{ display: "grid", gap: 12, listStyle: "none", padding: 0 }}>
+        {notes.map((n) => (
+          <li key={n.id} style={{ border: "1px solid #ddd", borderRadius: 8, padding: 12 }}>
+            <strong>{n.title}</strong>
+            <p style={{ margin: "4px 0", whiteSpace: "pre-wrap" }}>{n.body}</p>
+            <button onClick={() => remove(n.id)}>Delete</button>
+          </li>
+        ))}
+      </ul>
+    </main>
+  )
+}
+`;
+const NGINX = `server {
+  listen 80;
+  root /usr/share/nginx/html;
+  index index.html;
+  location / {
+    try_files $uri $uri/ /index.html;
+  }
+}
+`;
+function dockerfile(pkgName, name) {
+    return `# Deployed by lwd with git.path = "." and build.dockerfile = "apps/${name}/Dockerfile"
+# (root context so the workspace SDK is available to the build).
+FROM node:20-alpine AS builder
+WORKDIR /repo
+RUN npm install -g pnpm@9
+COPY . .
+RUN pnpm install --no-frozen-lockfile
+ARG VITE_API_BASE_URL
+ENV VITE_API_BASE_URL=$VITE_API_BASE_URL
+RUN pnpm --filter "${pkgName}" build
+
+FROM nginx:1.27-alpine
+COPY --from=builder /repo/apps/${name}/dist /usr/share/nginx/html
+COPY apps/${name}/nginx.conf /etc/nginx/conf.d/default.conf
+EXPOSE 80
+`;
+}
+//# sourceMappingURL=web.js.map

package/dist/generators/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/generators/web.ts"],"names":[],"mappings":";;AAeA,8BAwEC;AA7ED;;;;GAIG;AACH,SAAgB,SAAS,CAAC,IAAU,EAAE,IAAgB;IACpD,MAAM,GAAG,GAAG,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAA;IAC/B,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,EAAE,CAAA;IAE5C,IAAI,CAAC,MAAM,CACT,GAAG,GAAG,eAAe,EACrB,IAAI,CAAC,SAAS,CACZ;QACE,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE;YACP,GAAG,EAAE,MAAM;YACX,KAAK,EAAE,YAAY;YACnB,OAAO,EAAE,cAAc;YACvB,SAAS,EAAE,cAAc;YACzB,IAAI,EAAE,8BAA8B;SACrC;QACD,YAAY,EAAE;YACZ,CAAC,GAAG,IAAI,CAAC,KAAK,MAAM,CAAC,EAAE,aAAa;YACpC,KAAK,EAAE,SAAS;YAChB,WAAW,EAAE,SAAS;YACtB,kBAAkB,EAAE,QAAQ;SAC7B;QACD,eAAe,EAAE;YACf,cAAc,EAAE,SAAS;YACzB,kBAAkB,EAAE,SAAS;YAC7B,sBAAsB,EAAE,QAAQ;YAChC,UAAU,EAAE,QAAQ;YACpB,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,QAAQ;SACjB;KACF,EACD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI,EACR,wBAAwB,CACzB,CAAA;IAED,IAAI,CAAC,MAAM,CACT,GAAG,GAAG,gBAAgB,EACtB,IAAI,CAAC,SAAS,CACZ;QACE,eAAe,EAAE;YACf,MAAM,EAAE,QAAQ;YAChB,GAAG,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,cAAc,CAAC;YACtC,MAAM,EAAE,QAAQ;YAChB,gBAAgB,EAAE,SAAS;YAC3B,GAAG,EAAE,WAAW;YAChB,MAAM,EAAE,IAAI;YACZ,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,IAAI;YACrB,iBAAiB,EAAE,IAAI;YACvB,MAAM,EAAE,IAAI;SACb;QACD,OAAO,EAAE,CAAC,KAAK,CAAC;KACjB,EACD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI,EACR,uCAAuC,CACxC,CAAA;IAED,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,iBAAiB,EAAE,WAAW,EAAE,aAAa,CAAC,CAAA;IAChE,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,aAAa,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,kBAAkB,CAAC,CAAA;IAC1E,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,eAAe,EAAE,IAAI,EAAE,aAAa,CAAC,CAAA;IACvD,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,oBAAoB,EAAE,yCAAyC,EAAE,qCAAqC,CAAC,CAAA;IACzH,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,2BAA2B,CAAC,CAAA;IAC9F,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,cAAc,EAAE,IAAI,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAA;IAC/F,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,aAAa,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAAA;IAC3D,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,aAAa,EAAE,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,uCAAuC,CAAC,CAAA;AAC3G,CAAC;AAED,MAAM,WAAW,GAAG;;;;;;CAMnB,CAAA;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO;;;;;aAKI,IAAI;;;;;;;CAOhB,CAAA;AACD,CAAC;AAED,MAAM,IAAI,GAAG;;;;;;;;;CASZ,CAAA;AAED,SAAS,KAAK,CAAC,KAAa,EAAE,OAAsB;IAClD,MAAM,YAAY,GAChB,OAAO,KAAK,OAAO;QACjB,CAAC,CAAC,8EAA8E,KAAK,OAAO;QAC5F,CAAC,CAAC,sCAAsC,KAAK,OAAO,CAAA;IACxD,OAAO,iCAAiC,KAAK;EAC7C,YAAY;;;;;;CAMb,CAAA;AACD,CAAC;AAED,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;CAehB,CAAA;AAED,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDjB,CAAA;AAED,MAAM,KAAK,GAAG;;;;;;;;CAQb,CAAA;AAED,SAAS,UAAU,CAAC,OAAe,EAAE,IAAY;IAC/C,OAAO,sEAAsE,IAAI;;;;;;;;;qBAS9D,OAAO;;;iCAGK,IAAI;YACzB,IAAI;;CAEf,CAAA;AACD,CAAC"}

package/dist/generators/worker.d.ts

@@ -0,0 +1,13 @@
+import type { Plan } from "../project/plan";
+export interface WorkerOptions {
+    scope: string;
+}
+/**
+ * Generates a worker app. Consumers live in src/consumers.d/*.ts, each exporting
+ * an optional `init(ctx)` and a `tick(ctx)`. The worker loads them by convention
+ * and drives them on an interval — capabilities add background work by dropping
+ * a file, never by editing the loop. Includes a plain-HTTP health port because
+ * lwd surfaces (including workers) require one.
+ */
+export declare function addWorkerApp(plan: Plan, opts: WorkerOptions): void;
+//# sourceMappingURL=worker.d.ts.map

package/dist/generators/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/generators/worker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAE3C,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAmDlE"}