@obh/forge 0.2.0

package/dist/generators/worker.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addWorkerApp = addWorkerApp;
+/**
+ * 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.
+ */
+function addWorkerApp(plan, opts) {
+    const dir = "apps/worker";
+    plan.create(`${dir}/package.json`, JSON.stringify({
+        name: `${opts.scope}/worker`,
+        version: "0.1.0",
+        private: true,
+        scripts: {
+            dev: "tsx watch src/main.ts",
+            build: "tsc -p tsconfig.json",
+            typecheck: "tsc -p tsconfig.json --noEmit",
+            start: "node dist/main.js",
+            test: "vitest run --passWithNoTests",
+        },
+        dependencies: { pg: "^8.12.0" },
+        devDependencies: {
+            "@types/node": "^20.14.0",
+            "@types/pg": "^8.11.6",
+            tsx: "^4.16.0",
+            typescript: "^5.5.4",
+            vitest: "^2.0.5",
+        },
+    }, null, 2) + "\n", "worker app package.json");
+    plan.create(`${dir}/tsconfig.json`, JSON.stringify({
+        extends: "../../tsconfig.base.json",
+        compilerOptions: { rootDir: "src", outDir: "dist" },
+        include: ["src"],
+        exclude: ["dist", "node_modules", "src/**/*.test.ts"],
+    }, null, 2) + "\n", "worker tsconfig");
+    plan.create(`${dir}/src/context.ts`, CONTEXT, "worker context (pool + logger)");
+    plan.create(`${dir}/src/main.ts`, MAIN, "worker loop (auto-loads src/consumers.d/*)");
+    plan.create(`${dir}/src/consumers.d/.gitkeep`, "", "worker consumers directory");
+    plan.create(`${dir}/Dockerfile`, DOCKERFILE, "worker Dockerfile");
+}
+const CONTEXT = `import { Pool } from "pg"
+
+export interface WorkerContext {
+  pool: Pool
+  log: (msg: string, fields?: Record<string, unknown>) => void
+}
+
+export function createContext(): WorkerContext {
+  const databaseUrl = process.env.DATABASE_URL
+  if (!databaseUrl) throw new Error("DATABASE_URL is not set")
+  const pool = new Pool({ connectionString: databaseUrl })
+  return {
+    pool,
+    log: (msg, fields) => console.log(JSON.stringify({ msg, ...fields })),
+  }
+}
+`;
+const MAIN = `import { createServer } from "node:http"
+import { readdirSync } from "node:fs"
+import path from "node:path"
+import { createContext, type WorkerContext } from "./context"
+
+interface Consumer {
+  name: string
+  init?: (ctx: WorkerContext) => Promise<void> | void
+  tick: (ctx: WorkerContext) => Promise<void> | void
+}
+
+function loadConsumers(): Consumer[] {
+  const dir = path.join(__dirname, "consumers.d")
+  const out: Consumer[] = []
+  for (const file of readdirSync(dir).sort()) {
+    if (!/\\.(ts|js)$/.test(file) || file.endsWith(".d.ts")) continue
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const mod = require(path.join(dir, file))
+    if (typeof mod.tick === "function") {
+      out.push({ name: file.replace(/\\.(ts|js)$/, ""), init: mod.init, tick: mod.tick })
+    }
+  }
+  return out
+}
+
+async function main(): Promise<void> {
+  const ctx = createContext()
+  const consumers = loadConsumers()
+  const pollMs = Number(process.env.POLL_INTERVAL_MS) || 1000
+
+  for (const c of consumers) {
+    if (c.init) await c.init(ctx)
+    ctx.log("consumer registered", { consumer: c.name })
+  }
+
+  // lwd requires a health port even for a worker surface.
+  const port = Number(process.env.PORT) || 8080
+  createServer((_req, res) => {
+    res.writeHead(200, { "content-type": "application/json" })
+    res.end(JSON.stringify({ status: "ok" }))
+  }).listen(port, () => ctx.log("worker health listening", { port }))
+
+  let ticking = false
+  const timer = setInterval(async () => {
+    if (ticking) return
+    ticking = true
+    try {
+      for (const c of consumers) await c.tick(ctx)
+    } catch (err) {
+      ctx.log("tick failed", { error: err instanceof Error ? err.message : String(err) })
+    } finally {
+      ticking = false
+    }
+  }, pollMs)
+
+  const shutdown = async (): Promise<void> => {
+    clearInterval(timer)
+    await ctx.pool.end()
+    process.exit(0)
+  }
+  process.on("SIGTERM", () => void shutdown())
+  process.on("SIGINT", () => void shutdown())
+}
+
+main().catch((err) => {
+  console.error(err)
+  process.exit(1)
+})
+`;
+const DOCKERFILE = `# Built by lwd from apps/worker (git.path = "apps/worker").
+FROM node:20-alpine AS builder
+WORKDIR /app
+RUN npm install -g pnpm@9
+COPY package.json ./
+RUN pnpm install --no-frozen-lockfile
+COPY . .
+RUN pnpm build
+
+FROM node:20-alpine
+WORKDIR /app
+RUN npm install -g pnpm@9
+COPY package.json ./
+RUN pnpm install --prod --no-frozen-lockfile
+COPY --from=builder /app/dist ./dist
+EXPOSE 8080
+CMD ["node", "dist/main.js"]
+`;
+//# sourceMappingURL=worker.js.map

package/dist/generators/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../src/generators/worker.ts"],"names":[],"mappings":";;AAaA,oCAmDC;AA1DD;;;;;;GAMG;AACH,SAAgB,YAAY,CAAC,IAAU,EAAE,IAAmB;IAC1D,MAAM,GAAG,GAAG,aAAa,CAAA;IAEzB,IAAI,CAAC,MAAM,CACT,GAAG,GAAG,eAAe,EACrB,IAAI,CAAC,SAAS,CACZ;QACE,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,SAAS;QAC5B,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE;YACP,GAAG,EAAE,uBAAuB;YAC5B,KAAK,EAAE,sBAAsB;YAC7B,SAAS,EAAE,+BAA+B;YAC1C,KAAK,EAAE,mBAAmB;YAC1B,IAAI,EAAE,8BAA8B;SACrC;QACD,YAAY,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE;QAC/B,eAAe,EAAE;YACf,aAAa,EAAE,UAAU;YACzB,WAAW,EAAE,SAAS;YACtB,GAAG,EAAE,SAAS;YACd,UAAU,EAAE,QAAQ;YACpB,MAAM,EAAE,QAAQ;SACjB;KACF,EACD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI,EACR,yBAAyB,CAC1B,CAAA;IAED,IAAI,CAAC,MAAM,CACT,GAAG,GAAG,gBAAgB,EACtB,IAAI,CAAC,SAAS,CACZ;QACE,OAAO,EAAE,0BAA0B;QACnC,eAAe,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE;QACnD,OAAO,EAAE,CAAC,KAAK,CAAC;QAChB,OAAO,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,kBAAkB,CAAC;KACtD,EACD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI,EACR,iBAAiB,CAClB,CAAA;IAED,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,iBAAiB,EAAE,OAAO,EAAE,gCAAgC,CAAC,CAAA;IAC/E,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,cAAc,EAAE,IAAI,EAAE,4CAA4C,CAAC,CAAA;IACrF,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,2BAA2B,EAAE,EAAE,EAAE,4BAA4B,CAAC,CAAA;IAChF,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,aAAa,EAAE,UAAU,EAAE,mBAAmB,CAAC,CAAA;AACnE,CAAC;AAED,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;CAgBf,CAAA;AAED,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoEZ,CAAA;AAED,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;CAiBlB,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { FORGE_VERSION } from "./version";
+export * from "./types";
+export { Plan } from "./project/plan";
+export { ProjectContext } from "./project/context";
+export { loadManifest, saveManifest, newManifest, mergeManifest } from "./project/manifest";
+export { CAPABILITIES, getCapability, isImplemented, resolveOrder, missingPrerequisites } from "./capabilities";
+export type { Capability } from "./capabilities";
+export { RECIPES, getRecipe } from "./recipes";
+export { addLwdManifests, computeSecrets } from "./generators/lwd";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,cAAc,SAAS,CAAA;AAEvB,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAE3F,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAC/G,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAEhD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAC9C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/index.js

@@ -0,0 +1,44 @@
+"use strict";
+// Programmatic surface of @obh/forge. The CLI (src/cli.ts) is the primary entry;
+// these exports let scripts and Claude skills drive Forge in-process.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeSecrets = exports.addLwdManifests = exports.getRecipe = exports.RECIPES = exports.missingPrerequisites = exports.resolveOrder = exports.isImplemented = exports.getCapability = exports.CAPABILITIES = exports.mergeManifest = exports.newManifest = exports.saveManifest = exports.loadManifest = exports.ProjectContext = exports.Plan = exports.FORGE_VERSION = void 0;
+var version_1 = require("./version");
+Object.defineProperty(exports, "FORGE_VERSION", { enumerable: true, get: function () { return version_1.FORGE_VERSION; } });
+__exportStar(require("./types"), exports);
+var plan_1 = require("./project/plan");
+Object.defineProperty(exports, "Plan", { enumerable: true, get: function () { return plan_1.Plan; } });
+var context_1 = require("./project/context");
+Object.defineProperty(exports, "ProjectContext", { enumerable: true, get: function () { return context_1.ProjectContext; } });
+var manifest_1 = require("./project/manifest");
+Object.defineProperty(exports, "loadManifest", { enumerable: true, get: function () { return manifest_1.loadManifest; } });
+Object.defineProperty(exports, "saveManifest", { enumerable: true, get: function () { return manifest_1.saveManifest; } });
+Object.defineProperty(exports, "newManifest", { enumerable: true, get: function () { return manifest_1.newManifest; } });
+Object.defineProperty(exports, "mergeManifest", { enumerable: true, get: function () { return manifest_1.mergeManifest; } });
+var capabilities_1 = require("./capabilities");
+Object.defineProperty(exports, "CAPABILITIES", { enumerable: true, get: function () { return capabilities_1.CAPABILITIES; } });
+Object.defineProperty(exports, "getCapability", { enumerable: true, get: function () { return capabilities_1.getCapability; } });
+Object.defineProperty(exports, "isImplemented", { enumerable: true, get: function () { return capabilities_1.isImplemented; } });
+Object.defineProperty(exports, "resolveOrder", { enumerable: true, get: function () { return capabilities_1.resolveOrder; } });
+Object.defineProperty(exports, "missingPrerequisites", { enumerable: true, get: function () { return capabilities_1.missingPrerequisites; } });
+var recipes_1 = require("./recipes");
+Object.defineProperty(exports, "RECIPES", { enumerable: true, get: function () { return recipes_1.RECIPES; } });
+Object.defineProperty(exports, "getRecipe", { enumerable: true, get: function () { return recipes_1.getRecipe; } });
+var lwd_1 = require("./generators/lwd");
+Object.defineProperty(exports, "addLwdManifests", { enumerable: true, get: function () { return lwd_1.addLwdManifests; } });
+Object.defineProperty(exports, "computeSecrets", { enumerable: true, get: function () { return lwd_1.computeSecrets; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,iFAAiF;AACjF,sEAAsE;;;;;;;;;;;;;;;;;AAEtE,qCAAyC;AAAhC,wGAAA,aAAa,OAAA;AACtB,0CAAuB;AAEvB,uCAAqC;AAA5B,4FAAA,IAAI,OAAA;AACb,6CAAkD;AAAzC,yGAAA,cAAc,OAAA;AACvB,+CAA2F;AAAlF,wGAAA,YAAY,OAAA;AAAE,wGAAA,YAAY,OAAA;AAAE,uGAAA,WAAW,OAAA;AAAE,yGAAA,aAAa,OAAA;AAE/D,+CAA+G;AAAtG,4GAAA,YAAY,OAAA;AAAE,6GAAA,aAAa,OAAA;AAAE,6GAAA,aAAa,OAAA;AAAE,4GAAA,YAAY,OAAA;AAAE,oHAAA,oBAAoB,OAAA;AAGvF,qCAA8C;AAArC,kGAAA,OAAO,OAAA;AAAE,oGAAA,SAAS,OAAA;AAC3B,wCAAkE;AAAzD,sGAAA,eAAe,OAAA;AAAE,qGAAA,cAAc,OAAA"}

package/dist/project/context.d.ts

@@ -0,0 +1,24 @@
+import type { AppRecord, CapabilityName, ForgeManifest } from "../types";
+/**
+ * A read model of the project Forge is operating on. Commands load one of these,
+ * build a Plan against it, and apply. It never mutates anything itself.
+ */
+export declare class ProjectContext {
+    readonly root: string;
+    readonly manifest: ForgeManifest | undefined;
+    readonly rootPkg: Record<string, any> | undefined;
+    readonly appDirs: string[];
+    readonly packageDirs: string[];
+    constructor(root: string, manifest: ForgeManifest | undefined, rootPkg: Record<string, any> | undefined, appDirs: string[], packageDirs: string[]);
+    static load(cwd: string): Promise<ProjectContext>;
+    hasManifest(): boolean;
+    requireManifest(): ForgeManifest;
+    hasCapability(name: CapabilityName): boolean;
+    /** True if an app directory of this name exists on disk. */
+    hasApp(name: string): boolean;
+    /** The first app with the given role recorded in the manifest, if any. */
+    appByRole(role: AppRecord["role"]): AppRecord | undefined;
+    /** True if a worker app exists (on disk or in the manifest). */
+    hasWorker(): boolean;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/project/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/project/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAKxE;;;GAGG;AACH,qBAAa,cAAc;IAEvB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,QAAQ,EAAE,aAAa,GAAG,SAAS;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE;gBAJrB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,aAAa,GAAG,SAAS,EACnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,EACxC,OAAO,EAAE,MAAM,EAAE,EACjB,WAAW,EAAE,MAAM,EAAE;WAGnB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IASvD,WAAW,IAAI,OAAO;IAItB,eAAe,IAAI,aAAa;IAShC,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO;IAI5C,4DAA4D;IAC5D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI7B,0EAA0E;IAC1E,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,GAAG,SAAS;IAKzD,gEAAgE;IAChE,SAAS,IAAI,OAAO;CAGrB"}

package/dist/project/context.js

@@ -0,0 +1,63 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProjectContext = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+const fs_1 = require("../utils/fs");
+const manifest_1 = require("./manifest");
+const paths_1 = require("./paths");
+/**
+ * A read model of the project Forge is operating on. Commands load one of these,
+ * build a Plan against it, and apply. It never mutates anything itself.
+ */
+class ProjectContext {
+    root;
+    manifest;
+    rootPkg;
+    appDirs;
+    packageDirs;
+    constructor(root, manifest, rootPkg, appDirs, packageDirs) {
+        this.root = root;
+        this.manifest = manifest;
+        this.rootPkg = rootPkg;
+        this.appDirs = appDirs;
+        this.packageDirs = packageDirs;
+    }
+    static async load(cwd) {
+        const root = await (0, paths_1.findProjectRoot)(cwd);
+        const manifest = await (0, manifest_1.loadManifest)(root);
+        const rootPkg = await (0, fs_1.readJson)(node_path_1.default.join(root, "package.json"));
+        const appDirs = await (0, fs_1.listDirs)(node_path_1.default.join(root, "apps"));
+        const packageDirs = await (0, fs_1.listDirs)(node_path_1.default.join(root, "packages"));
+        return new ProjectContext(root, manifest, rootPkg, appDirs, packageDirs);
+    }
+    hasManifest() {
+        return this.manifest !== undefined;
+    }
+    requireManifest() {
+        if (!this.manifest) {
+            throw new Error("No forge.json found. Run this inside a Forge project, or create one with `forge new app <name>`.");
+        }
+        return this.manifest;
+    }
+    hasCapability(name) {
+        return this.manifest?.platform?.[name] === true;
+    }
+    /** True if an app directory of this name exists on disk. */
+    hasApp(name) {
+        return this.appDirs.includes(name);
+    }
+    /** The first app with the given role recorded in the manifest, if any. */
+    appByRole(role) {
+        const apps = this.manifest?.apps ?? {};
+        return Object.values(apps).find((a) => a.role === role);
+    }
+    /** True if a worker app exists (on disk or in the manifest). */
+    hasWorker() {
+        return this.hasApp("worker") || this.appByRole("worker") !== undefined;
+    }
+}
+exports.ProjectContext = ProjectContext;
+//# sourceMappingURL=context.js.map

package/dist/project/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/project/context.ts"],"names":[],"mappings":";;;;;;AAAA,0DAA4B;AAE5B,oCAAgD;AAChD,yCAAyC;AACzC,mCAAyC;AAEzC;;;GAGG;AACH,MAAa,cAAc;IAEd;IACA;IACA;IACA;IACA;IALX,YACW,IAAY,EACZ,QAAmC,EACnC,OAAwC,EACxC,OAAiB,EACjB,WAAqB;QAJrB,SAAI,GAAJ,IAAI,CAAQ;QACZ,aAAQ,GAAR,QAAQ,CAA2B;QACnC,YAAO,GAAP,OAAO,CAAiC;QACxC,YAAO,GAAP,OAAO,CAAU;QACjB,gBAAW,GAAX,WAAW,CAAU;IAC7B,CAAC;IAEJ,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAW;QAC3B,MAAM,IAAI,GAAG,MAAM,IAAA,uBAAe,EAAC,GAAG,CAAC,CAAA;QACvC,MAAM,QAAQ,GAAG,MAAM,IAAA,uBAAY,EAAC,IAAI,CAAC,CAAA;QACzC,MAAM,OAAO,GAAG,MAAM,IAAA,aAAQ,EAAsB,mBAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAA;QACpF,MAAM,OAAO,GAAG,MAAM,IAAA,aAAQ,EAAC,mBAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAA;QACvD,MAAM,WAAW,GAAG,MAAM,IAAA,aAAQ,EAAC,mBAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAA;QAC/D,OAAO,IAAI,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,CAAA;IAC1E,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAA;IACpC,CAAC;IAED,eAAe;QACb,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CACb,kGAAkG,CACnG,CAAA;QACH,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAA;IACtB,CAAC;IAED,aAAa,CAAC,IAAoB;QAChC,OAAO,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI,CAAA;IACjD,CAAC;IAED,4DAA4D;IAC5D,MAAM,CAAC,IAAY;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IACpC,CAAC;IAED,0EAA0E;IAC1E,SAAS,CAAC,IAAuB;QAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAA;QACtC,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;IACzD,CAAC;IAED,gEAAgE;IAChE,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,SAAS,CAAA;IACxE,CAAC;CACF;AAlDD,wCAkDC"}

package/dist/project/manifest.d.ts

@@ -0,0 +1,26 @@
+import type { ApiFramework, ExampleDomain, ForgeConfig, ForgeManifest, Topology } from "../types";
+/** Default convention directories generated apps auto-load from. */
+export declare function defaultConventions(): ForgeConfig["conventions"];
+export interface NewManifestOptions {
+    topology: Topology;
+    apiFramework?: ApiFramework;
+    sdk?: boolean;
+    example?: ExampleDomain;
+    repo?: string;
+}
+/** Build a fresh manifest for a brand-new project. */
+export declare function newManifest(name: string, createdAt: string, opts: NewManifestOptions): ForgeManifest;
+/** Load forge.json from a project root, or undefined if absent/invalid. */
+export declare function loadManifest(root: string): Promise<ForgeManifest | undefined>;
+/** Persist forge.json. */
+export declare function saveManifest(root: string, manifest: ForgeManifest): Promise<void>;
+/**
+ * Merge a partial manifest patch into a base manifest. Shallow-merges the
+ * top-level records (apps/packages/platform) so capabilities can add entries
+ * without clobbering existing ones.
+ */
+export declare function mergeManifest(base: ForgeManifest, patch: DeepPartial<ForgeManifest>): ForgeManifest;
+export type DeepPartial<T> = {
+    [K in keyof T]?: T[K] extends object ? DeepPartial<T[K]> : T[K];
+};
+//# sourceMappingURL=manifest.d.ts.map

package/dist/project/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/project/manifest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAKjG,oEAAoE;AACpE,wBAAgB,kBAAkB,IAAI,WAAW,CAAC,aAAa,CAAC,CAO/D;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,QAAQ,CAAA;IAClB,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,OAAO,CAAC,EAAE,aAAa,CAAA;IACvB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,sDAAsD;AACtD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,aAAa,CAmBpG;AAED,2EAA2E;AAC3E,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAEnF;AAED,0BAA0B;AAC1B,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,CAAC,aAAa,CAAC,GAAG,aAAa,CAUnG;AAOD,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;KAC1B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAChE,CAAA"}

package/dist/project/manifest.js

@@ -0,0 +1,73 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultConventions = defaultConventions;
+exports.newManifest = newManifest;
+exports.loadManifest = loadManifest;
+exports.saveManifest = saveManifest;
+exports.mergeManifest = mergeManifest;
+const node_path_1 = __importDefault(require("node:path"));
+const version_1 = require("../version");
+const fs_1 = require("../utils/fs");
+const paths_1 = require("./paths");
+/** Default convention directories generated apps auto-load from. */
+function defaultConventions() {
+    return {
+        routesDir: "src/routes",
+        consumersDir: "src/consumers.d",
+        busDir: "src/bus.d",
+        migrationsDir: "scripts/migrations.d",
+    };
+}
+/** Build a fresh manifest for a brand-new project. */
+function newManifest(name, createdAt, opts) {
+    return {
+        name,
+        forgeVersion: version_1.FORGE_VERSION,
+        createdAt,
+        packageManager: "pnpm",
+        runtime: "node20",
+        apps: {},
+        packages: {},
+        platform: {},
+        config: {
+            apiFramework: opts.apiFramework ?? "hono",
+            sdk: opts.sdk ?? true,
+            // example can be legitimately null (--no-example), so don't use ??.
+            example: opts.example === undefined ? "notes" : opts.example,
+            conventions: defaultConventions(),
+        },
+        deploy: { target: "lwd", topology: opts.topology, repo: opts.repo },
+    };
+}
+/** Load forge.json from a project root, or undefined if absent/invalid. */
+async function loadManifest(root) {
+    return (0, fs_1.readJson)(node_path_1.default.join(root, paths_1.paths.forgeManifest));
+}
+/** Persist forge.json. */
+async function saveManifest(root, manifest) {
+    await (0, fs_1.writeJson)(node_path_1.default.join(root, paths_1.paths.forgeManifest), manifest);
+}
+/**
+ * Merge a partial manifest patch into a base manifest. Shallow-merges the
+ * top-level records (apps/packages/platform) so capabilities can add entries
+ * without clobbering existing ones.
+ */
+function mergeManifest(base, patch) {
+    return {
+        ...base,
+        ...stripRecords(patch),
+        apps: { ...base.apps, ...patch.apps },
+        packages: { ...base.packages, ...patch.packages },
+        platform: { ...base.platform, ...patch.platform },
+        config: { ...base.config, ...patch.config },
+        deploy: { ...base.deploy, ...patch.deploy },
+    };
+}
+function stripRecords(patch) {
+    const { apps, packages, platform, config, deploy, ...rest } = patch;
+    return rest;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/project/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/project/manifest.ts"],"names":[],"mappings":";;;;;AAOA,gDAOC;AAWD,kCAmBC;AAGD,oCAEC;AAGD,oCAEC;AAOD,sCAUC;AAvED,0DAA4B;AAE5B,wCAA0C;AAC1C,oCAAiD;AACjD,mCAA+B;AAE/B,oEAAoE;AACpE,SAAgB,kBAAkB;IAChC,OAAO;QACL,SAAS,EAAE,YAAY;QACvB,YAAY,EAAE,iBAAiB;QAC/B,MAAM,EAAE,WAAW;QACnB,aAAa,EAAE,sBAAsB;KACtC,CAAA;AACH,CAAC;AAUD,sDAAsD;AACtD,SAAgB,WAAW,CAAC,IAAY,EAAE,SAAiB,EAAE,IAAwB;IACnF,OAAO;QACL,IAAI;QACJ,YAAY,EAAE,uBAAa;QAC3B,SAAS;QACT,cAAc,EAAE,MAAM;QACtB,OAAO,EAAE,QAAQ;QACjB,IAAI,EAAE,EAAE;QACR,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE;YACN,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,MAAM;YACzC,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,IAAI;YACrB,oEAAoE;YACpE,OAAO,EAAE,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO;YAC5D,WAAW,EAAE,kBAAkB,EAAE;SAClC;QACD,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;KACpE,CAAA;AACH,CAAC;AAED,2EAA2E;AACpE,KAAK,UAAU,YAAY,CAAC,IAAY;IAC7C,OAAO,IAAA,aAAQ,EAAgB,mBAAI,CAAC,IAAI,CAAC,IAAI,EAAE,aAAK,CAAC,aAAa,CAAC,CAAC,CAAA;AACtE,CAAC;AAED,0BAA0B;AACnB,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,QAAuB;IACtE,MAAM,IAAA,cAAS,EAAC,mBAAI,CAAC,IAAI,CAAC,IAAI,EAAE,aAAK,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,CAAA;AACjE,CAAC;AAED;;;;GAIG;AACH,SAAgB,aAAa,CAAC,IAAmB,EAAE,KAAiC;IAClF,OAAO;QACL,GAAG,IAAI;QACP,GAAG,YAAY,CAAC,KAAK,CAAC;QACtB,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,GAAI,KAAK,CAAC,IAA8B,EAAE;QAChE,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAI,KAAK,CAAC,QAAsC,EAAE;QAChF,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAI,KAAK,CAAC,QAAsC,EAAE;QAChF,MAAM,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAI,KAAK,CAAC,MAAkC,EAAE;QACxE,MAAM,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAI,KAAK,CAAC,MAAkC,EAAE;KACzE,CAAA;AACH,CAAC;AAED,SAAS,YAAY,CAAC,KAAiC;IACrD,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAA;IACnE,OAAO,IAA8B,CAAA;AACvC,CAAC"}

package/dist/project/paths.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Resolve the project root by walking up from `start` looking for forge.json,
+ * then pnpm-workspace.yaml, then package.json. Falls back to `start`.
+ */
+export declare function findProjectRoot(start: string): Promise<string>;
+/** Absolute path for a repo-relative path within the project. */
+export declare function abs(root: string, relative: string): string;
+export declare const paths: {
+    readonly forgeManifest: "forge.json";
+    readonly stackManifest: "deploy/stack.json";
+    readonly rootPackageJson: "package.json";
+    readonly pnpmWorkspace: "pnpm-workspace.yaml";
+    readonly tsconfigBase: "tsconfig.base.json";
+    readonly envExample: ".env.example";
+    readonly ci: ".github/workflows/ci.yml";
+    readonly readme: "README.md";
+    readonly agents: "AGENTS.md";
+    readonly migrationsDir: "migrations";
+    readonly migrateScript: "scripts/migrate.ts";
+    readonly app: (name: string) => string;
+    readonly pkg: (name: string) => string;
+    readonly deploy: (name: string) => string;
+    readonly dockerfile: (name: string) => string;
+};
+//# sourceMappingURL=paths.d.ts.map

package/dist/project/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/project/paths.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAWpE;AAED,iEAAiE;AACjE,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,eAAO,MAAM,KAAK;;;;;;;;;;;;yBAYJ,MAAM;yBACN,MAAM;4BACH,MAAM;gCACF,MAAM;CACjB,CAAA"}

package/dist/project/paths.js

@@ -0,0 +1,51 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.paths = void 0;
+exports.findProjectRoot = findProjectRoot;
+exports.abs = abs;
+const node_path_1 = __importDefault(require("node:path"));
+const fs_1 = require("../utils/fs");
+/**
+ * Resolve the project root by walking up from `start` looking for forge.json,
+ * then pnpm-workspace.yaml, then package.json. Falls back to `start`.
+ */
+async function findProjectRoot(start) {
+    let dir = node_path_1.default.resolve(start);
+    // Walk upward a bounded number of levels.
+    for (let i = 0; i < 20; i++) {
+        if (await (0, fs_1.exists)(node_path_1.default.join(dir, "forge.json")))
+            return dir;
+        if (await (0, fs_1.exists)(node_path_1.default.join(dir, "pnpm-workspace.yaml")))
+            return dir;
+        const parent = node_path_1.default.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return node_path_1.default.resolve(start);
+}
+/** Absolute path for a repo-relative path within the project. */
+function abs(root, relative) {
+    return node_path_1.default.join(root, relative);
+}
+exports.paths = {
+    forgeManifest: "forge.json",
+    stackManifest: "deploy/stack.json",
+    rootPackageJson: "package.json",
+    pnpmWorkspace: "pnpm-workspace.yaml",
+    tsconfigBase: "tsconfig.base.json",
+    envExample: ".env.example",
+    ci: ".github/workflows/ci.yml",
+    readme: "README.md",
+    agents: "AGENTS.md",
+    migrationsDir: "migrations",
+    migrateScript: "scripts/migrate.ts",
+    app: (name) => `apps/${name}`,
+    pkg: (name) => `packages/${name}`,
+    deploy: (name) => `deploy/${name}.lwd.toml`,
+    dockerfile: (name) => `docker/${name}.Dockerfile`,
+};
+//# sourceMappingURL=paths.js.map

package/dist/project/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/project/paths.ts"],"names":[],"mappings":";;;;;;AAOA,0CAWC;AAGD,kBAEC;AAvBD,0DAA4B;AAC5B,oCAAoC;AAEpC;;;GAGG;AACI,KAAK,UAAU,eAAe,CAAC,KAAa;IACjD,IAAI,GAAG,GAAG,mBAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAC7B,0CAA0C;IAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,IAAI,MAAM,IAAA,WAAM,EAAC,mBAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;YAAE,OAAO,GAAG,CAAA;QAC1D,IAAI,MAAM,IAAA,WAAM,EAAC,mBAAI,CAAC,IAAI,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;YAAE,OAAO,GAAG,CAAA;QACnE,MAAM,MAAM,GAAG,mBAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAChC,IAAI,MAAM,KAAK,GAAG;YAAE,MAAK;QACzB,GAAG,GAAG,MAAM,CAAA;IACd,CAAC;IACD,OAAO,mBAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAC5B,CAAC;AAED,iEAAiE;AACjE,SAAgB,GAAG,CAAC,IAAY,EAAE,QAAgB;IAChD,OAAO,mBAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;AAClC,CAAC;AAEY,QAAA,KAAK,GAAG;IACnB,aAAa,EAAE,YAAY;IAC3B,aAAa,EAAE,mBAAmB;IAClC,eAAe,EAAE,cAAc;IAC/B,aAAa,EAAE,qBAAqB;IACpC,YAAY,EAAE,oBAAoB;IAClC,UAAU,EAAE,cAAc;IAC1B,EAAE,EAAE,0BAA0B;IAC9B,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,WAAW;IACnB,aAAa,EAAE,YAAY;IAC3B,aAAa,EAAE,oBAAoB;IACnC,GAAG,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,IAAI,EAAE;IACrC,GAAG,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,YAAY,IAAI,EAAE;IACzC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,UAAU,IAAI,WAAW;IACnD,UAAU,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,UAAU,IAAI,aAAa;CACjD,CAAA"}

package/dist/project/plan.d.ts

@@ -0,0 +1,42 @@
+import type { EnvVar, ForgeManifest } from "../types";
+import { type DeepPartial } from "./manifest";
+export interface ApplyOptions {
+    dryRun: boolean;
+    /** Allow overwriting existing files whose contents differ. */
+    force: boolean;
+}
+/**
+ * A Plan accumulates every change a command wants to make, then applies them in
+ * one pass. This is what gives every Forge command uniform dry-run, idempotency,
+ * and safety (see spec §21). Commands never touch the filesystem directly.
+ */
+export declare class Plan {
+    private fileOps;
+    private deps;
+    private envVars;
+    private scripts;
+    private manifestPatch;
+    private nextSteps;
+    /** Create a file only if it does not already exist. */
+    create(p: string, content: string, describe: string): this;
+    /** Replace a file's contents (needs --force / confirmation if it differs). */
+    overwrite(p: string, content: string, describe: string): this;
+    /** Insert a clearly-marked, idempotent section into a file (creating it if absent). */
+    append(p: string, marker: string, section: string, describe: string): this;
+    addDependency(target: string, name: string, version: string, dev?: boolean): this;
+    addEnvVar(v: EnvVar): this;
+    addScript(name: string, command: string): this;
+    patchManifest(patch: DeepPartial<ForgeManifest>): this;
+    nextStep(msg: string): this;
+    isEmpty(): boolean;
+    /** Human-readable preview of everything this plan would do. */
+    render(root: string): Promise<string>;
+    /** Apply the plan. Returns whether anything was written. */
+    apply(root: string, opts: ApplyOptions): Promise<boolean>;
+    private classify;
+    private applyAppend;
+    private applyDeps;
+    private applyScripts;
+    private applyEnv;
+}
+//# sourceMappingURL=plan.d.ts.map

package/dist/project/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/project/plan.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,MAAM,EAEN,aAAa,EAEd,MAAM,UAAU,CAAA;AAGjB,OAAO,EAA6C,KAAK,WAAW,EAAE,MAAM,YAAY,CAAA;AAExF,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,CAAA;IACf,8DAA8D;IAC9D,KAAK,EAAE,OAAO,CAAA;CACf;AAOD;;;;GAIG;AACH,qBAAa,IAAI;IACf,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,IAAI,CAAe;IAC3B,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,aAAa,CAAiC;IACtD,OAAO,CAAC,SAAS,CAAe;IAEhC,uDAAuD;IACvD,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAK1D,8EAA8E;IAC9E,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAK7D,uFAAuF;IACvF,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAK1E,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,UAAQ,GAAG,IAAI;IAK/E,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAK1B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAK9C,aAAa,CAAC,KAAK,EAAE,WAAW,CAAC,aAAa,CAAC,GAAG,IAAI;IAKtD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK3B,OAAO,IAAI,OAAO;IAUlB,+DAA+D;IACzD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqB3C,4DAA4D;IACtD,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;YA0DjD,QAAQ;YAYR,WAAW;YAQX,SAAS;YAoBT,YAAY;YAWZ,QAAQ;CAevB"}