@aotter/mantle 0.1.0-alpha.7 → 0.1.0-alpha.9

package/README.md

@@ -1,6 +1,8 @@
 # @aotter/mantle
 
-Umbrella entry for the Mantle SDK — a manifest-driven CMS for Cloudflare Workers, built around a 4-atom YAML model (Schema / View / Procedure / Trigger) where agents write config and the runtime carries the complexity.
+Umbrella entry for the embeddable Mantle SDK — a manifest-driven application
+engine built around a 4-atom YAML model (Schema / View / Procedure / Trigger)
+where agents write config and the runtime carries the complexity.
 
 > Mantle is prerelease software. Use this package's `package.json` as the exact
 > installed version; APIs may change between prereleases until v0.1.0.
@@ -15,25 +17,39 @@ pnpm add @aotter/mantle@alpha
 
 ## What's inside
 
-Adopters install this one package and import from subpaths. Sub-packages remain individually installable for tooling / alt-adapter authors.
+The umbrella provides Spec and Runtime by default. Install an optional package
+before importing its matching Web, Admin, Bun, Vercel, Cloudflare, or Admin UI
+subpath. Every sub-package also remains directly installable.
 
 | Subpath | Re-exports |
 |---|---|
 | `@aotter/mantle/spec` (or root) | Manifest grammar, validators, JSON-Schema→Zod, diagnostic catalog (no env / no IO) |
 | `@aotter/mantle/runtime` | Hexagonal runtime: domain ports, use cases, infrastructure helpers (no adapter deps) |
 | `@aotter/mantle/runtime/testing` | Node-only crowded SQLite planner and HTTP sampling helpers |
-| `@aotter/mantle/cloudflare` | Cloudflare Workers adapter — D1, Workers Cache, R2, Better Auth, MCP via `@cloudflare/workers-oauth-provider` |
+| `@aotter/mantle/codegen` | Pure linked manifests → typed runtime module emitter (no IO) |
+| `@aotter/mantle/web` | Optional HTML, Markdown, `llms.txt`, sitemap, SEO, and preview composition (no routes or platform deps) |
+| `@aotter/mantle/admin` | Optional Admin API, auth routes, and static-asset composition |
+| `@aotter/mantle/bun` | Bun adapter — caller-owned `bun:sqlite` and Web-standard View/Trigger transport |
+| `@aotter/mantle/vercel` | Vercel Functions adapter — injected durable storage and platform `waitUntil` |
+| `@aotter/mantle/vercel/libsql` | Optional application-owned Turso/libSQL driver |
+| `@aotter/mantle/cloudflare` | Cloudflare Workers adapter — D1, Workers Cache, R2, and Better Auth 1.7 MCP/CIMD |
 | `@aotter/mantle/admin-ui` | Pre-built React 19 admin SPA bundle |
 
 ```ts
-import { parseManifestsOrThrow } from "@aotter/mantle/spec";
-import { createCmsRuntime } from "@aotter/mantle/runtime";
-import { mountServerEndpoints } from "@aotter/mantle/cloudflare";
+import { linkManifestSet, parseManifestSources } from "@aotter/mantle/spec";
+import { bootMantleRuntime, compileRuntimePlan } from "@aotter/mantle/runtime";
+import { createMantleWeb } from "@aotter/mantle/web";
+import { mountRuntimeEndpoints } from "@aotter/mantle/cloudflare";
 ```
 
+The umbrella installs only Spec and Runtime. Web, Admin, Admin UI, Bun,
+Vercel, and Cloudflare are optional peers; install only the subpaths selected
+by the application.
+
 The package also installs `mantle` and `mantle-harness`:
 
 ```bash
+npx -y @aotter/mantle@alpha create <type> <directory>
 pnpm exec mantle generate
 pnpm exec mantle generate --check
 pnpm exec mantle skills
@@ -43,38 +59,56 @@ pnpm exec mantle-harness indexes --require-public
 pnpm exec mantle-harness http --base-url http://127.0.0.1:8787 --route page=/en/example
 ```
 
-`mantle generate` validates `./manifests/site.yaml`, writes the
-parsed manifest module and handler declarations to `.mantle/generated/`, and
-copies the version-matched Admin SPA to `public/_mantle/admin/` for the
-platform's static asset service. `--check` verifies both outputs.
-It does not sync skills, update packages, style, provision, or deploy.
-When manifests declare Views or Procedures, the generated `site.ts` also exports
-`bindMantleSite(runtime)`: its `views` and `procedures` keys, inputs, and outputs
-come from those manifests, while diagnostics still come from the runtime use
-cases.
-Dynamic `runtime.viewsByName` access remains available for low-level code.
+`mantle generate` validates and compiles `./manifests/`, then writes one typed
+`.mantle/generated/mantle.ts` module. It performs no Admin asset installation,
+skill sync, package update, styling, provisioning, or deployment.
+The same pure emitter is available from `@aotter/mantle/codegen` when a host
+wants to own parsing and filesystem IO.
 
 ```ts
-const site = bindMantleSite(runtime);
-const notes = await site.views["published-notes"]();
-const result = await site.procedures["expire-order"](
+import { createMantle } from "../.mantle/generated/mantle.js";
+
+const mantle = await createMantle({ storage, handlers, ports });
+const notes = await mantle.views.publishedNotes();
+const result = await mantle.procedures.expireOrder(
   { orderId },
   { user: null, staff: null, env },
 );
+await mantle.entries.orders.createDraft({ data, authorId: user.id });
+
+// The typed projection never hides the underlying Core runtime.
+await mantle.runtime.archive.execute({ id: noteId, ctx });
 ```
 
-`mantle skills` explicitly copies the installed package's `develop`, `plugin`,
-`theme`, and `update` skills to matching `.agent/skills/mantle-*` and
-`.claude/skills/mantle-*` paths. Both tool layouts receive identical bytes;
-`--check` detects drift without writing. Manifest generation never rewrites
-agent instructions.
+Generated property names are deterministic lower-camel identifiers; calls keep
+the authored wire names internally. `createMantle()` eagerly prepares once and
+does not cache or retry. Dynamic and platform hosts can keep their own lifecycle,
+use generated `bindMantle(runtime)`, or skip code generation and call
+`runtime.executeView({ view: "published-notes" })` directly.
+
+`mantle create` materializes one version-matched starter bundle into a new
+directory and stops: it installs nothing, initializes no repository, configures
+no auth, and deploys nothing. It resolves only the official immutable starter
+tag for the CLI's own version, and refuses to write into an existing path.
+
+`mantle skills` copies every skill the installed package marks
+`projection: project` in its front matter into matching
+`.agents/skills/mantle-*` and `.claude/skills/mantle-*` paths — no list of
+skill names is maintained anywhere else. Skills that act destructively or
+target one platform stay out of that set and are opt-in. Both tool layouts
+receive identical bytes; `--check` detects drift without writing. An older
+project may also carry `.agent/skills/`, which is left untouched. Manifest
+generation never rewrites agent instructions.
 
 `mantle update` compares the recorded source bundle, a target bundle, and the
 local project, then writes `.mantle/update-report.json`. It never applies the
 diff. Configure `.mantle/features.json` `registry.bundleBaseUrl` with a URL
 containing `{ref}`, or pass `--bundle-base-url` for the alpha.63 bridge. The
 report carries the only supported metadata migration; review and apply it
-after porting selected upstream changes.
+after porting selected upstream changes. Format-versioned bundles use the same
+strict renderer as `mantle create`; an invalid current launch state fails
+instead of producing a guessed diff. Older bundles without `formatVersion`
+retain a read-only compatibility renderer.
 
 ## Conventional Cloudflare Worker
 
@@ -82,9 +116,9 @@ The normal Worker entry delegates Core-owned assembly to the SDK:
 
 ```ts
 import { createMantleWorker } from "@aotter/mantle/cloudflare";
-import { manifest } from "../.mantle/generated/site.js";
+import { plan } from "../.mantle/generated/mantle.js";
 
-export default createMantleWorker({ manifest });
+export default createMantleWorker({ plan });
 ```
 
 `createMantleWorker` owns conventional D1/assets bindings, Auth, Admin,
@@ -120,8 +154,8 @@ the consumer build. Computed paths cannot be proven statically, so the facade
 checks Hono's assembled route table and fails closed before serving requests.
 There is no standard-route override option.
 
-Cloudflare projects expose that generated Admin bundle and the site's own
-frontend assets through one native binding:
+Cloudflare projects may expose an independently installed Admin bundle and the
+application's own frontend assets through one native binding:
 
 ```toml
 [assets]
@@ -205,9 +239,13 @@ Core-owned `mantle:plugin` skill and records it in `.mantle/plugins.json` plus
 
 | Adapter | Status |
 |---|---|
+| Bun | ✅ shipping |
+| Vercel Functions (Node.js) | ✅ shipping |
 | Cloudflare Workers | ✅ shipping |
 
-The `mantle-runtime` package never imports Cloudflare-specific types — adapters bind concrete drivers (D1 / R2) to the runtime's `domain/port/*` interfaces, so adding a new adapter is a port-implementation exercise, not a refactor.
+The `mantle-runtime` package never imports platform-specific types — adapters
+bind concrete storage and lifecycle primitives to Core ports, so adding a new
+adapter is a port-implementation exercise, not a runtime refactor.
 
 ## Documentation
 

package/dist/admin.d.ts

@@ -0,0 +1,2 @@
+export * from "@aotter/mantle-admin";
+//# sourceMappingURL=admin.d.ts.map

package/dist/admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../src/admin.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}

package/dist/admin.js

@@ -0,0 +1,2 @@
+export * from "@aotter/mantle-admin";
+//# sourceMappingURL=admin.js.map

package/dist/admin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.js","sourceRoot":"","sources":["../src/admin.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}

package/dist/bun.d.ts

@@ -0,0 +1,2 @@
+export * from "@aotter/mantle-bun";
+//# sourceMappingURL=bun.d.ts.map

package/dist/bun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bun.d.ts","sourceRoot":"","sources":["../src/bun.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/bun.js

@@ -0,0 +1,2 @@
+export * from "@aotter/mantle-bun";
+//# sourceMappingURL=bun.js.map

package/dist/bun.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bun.js","sourceRoot":"","sources":["../src/bun.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/cli/create.d.ts

@@ -0,0 +1,2 @@
+export declare function runCreate(rawArgs: readonly string[]): Promise<number>;
+//# sourceMappingURL=create.d.ts.map

package/dist/cli/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/cli/create.ts"],"names":[],"mappings":"AAwCA,wBAAsB,SAAS,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAoG3E"}

package/dist/cli/create.js

@@ -0,0 +1,243 @@
+/**
+ * `mantle create <type> <directory>` — materialize one version-matched starter
+ * bundle into a new local directory.
+ *
+ * It does not install dependencies, initialize git, configure auth, provision
+ * providers, or deploy. A coding agent reads the generated project
+ * instructions and continues from there.
+ *
+ * A bundle is remote input that can carry package.json, install scripts,
+ * executable source, and agent instructions, so it is treated as code: only
+ * the official immutable tag for this exact package version is accepted, the
+ * response is bounded, the whole tree is validated and rendered before any
+ * write, and the write lands in an exclusively-owned temporary directory that
+ * is renamed into place. There is no --force.
+ */
+import { mkdir, mkdtemp, rename, rm, stat, writeFile } from "node:fs/promises";
+import { basename, dirname, join, resolve } from "node:path";
+import { cwd, stderr, stdout } from "node:process";
+import { parseArgs } from "node:util";
+import packageJson from "../../package.json" with { type: "json" };
+import { DEFAULT_PROVISION_LIMITS, ProvisionRenderError, renderProvisionBundle, } from "../provision.js";
+const STARTERS_OWNER = "aotter";
+const STARTERS_REPO = "mantle-starters";
+/**
+ * Released starter types. Community and Membership are deliberately absent:
+ * they are not released yet, and the create catalog must not offer a type the
+ * launch flow cannot deliver.
+ */
+const CREATE_ARCHETYPES = ["blank", "presence", "intake", "publication", "transaction", "reservation"];
+const MAX_BUNDLE_BYTES = 32 * 1024 * 1024;
+const FILE_MODE = 0o644;
+const DIRECTORY_MODE = 0o755;
+export async function runCreate(rawArgs) {
+    let archetype;
+    let directory;
+    let brand;
+    let description;
+    let locales;
+    try {
+        const { values, positionals } = parseArgs({
+            args: [...rawArgs],
+            allowPositionals: true,
+            options: {
+                brand: { type: "string" },
+                description: { type: "string" },
+                locales: { type: "string" },
+                help: { type: "boolean", short: "h" },
+            },
+        });
+        if (values.help) {
+            printHelp();
+            return 0;
+        }
+        if (positionals.length !== 2) {
+            stderr.write("Usage: mantle create <type> <directory>\n");
+            return 2;
+        }
+        [archetype, directory] = positionals;
+        if (!CREATE_ARCHETYPES.includes(archetype)) {
+            stderr.write(`Unknown type: ${archetype}\nAvailable: ${CREATE_ARCHETYPES.join(", ")}\n`);
+            return 2;
+        }
+        brand = values.brand;
+        description = values.description;
+        locales = (values.locales ?? "en").split(",").map((locale) => locale.trim()).filter(Boolean);
+    }
+    catch (error) {
+        stderr.write(`${message(error)}\n`);
+        return 2;
+    }
+    const target = resolve(cwd(), directory);
+    const projectName = slugify(basename(target));
+    if (projectName.length === 0) {
+        stderr.write("The target directory name must contain a letter or digit.\n");
+        return 2;
+    }
+    if (await exists(target)) {
+        stderr.write(`Refusing to write into an existing path: ${target}\n`);
+        return 1;
+    }
+    // Creating the parent chain would be state a failure could not undo. Ask for
+    // an existing parent instead, so an aborted run leaves the disk untouched.
+    if (!(await exists(dirname(target)))) {
+        stderr.write(`Parent directory does not exist: ${dirname(target)}\n`);
+        return 1;
+    }
+    const version = packageJson.version;
+    const starterRef = `v${version}`;
+    const resolvedBrand = brand ?? titleCase(projectName);
+    const launch = {
+        archetype,
+        projectName,
+        brand: resolvedBrand,
+        description: description ?? `A Mantle ${archetype} site.`,
+        locales,
+        canonicalLocale: locales[0] ?? "en",
+        // create stops before auth; self-managed is the free default the
+        // generated handoff walks the owner through.
+        authMode: "self-managed",
+        starterRef,
+        installTimestamp: new Date().toISOString(),
+        siteUrl: "http://localhost:8787",
+        githubOwner: "",
+        adminGithubLogin: "",
+        afterLaunchSkillUrl: "",
+    };
+    let rendered;
+    try {
+        const bundle = await fetchOfficialBundle(starterRef, archetype, version);
+        rendered = renderProvisionBundle({ bundle, launch, limits: DEFAULT_PROVISION_LIMITS });
+    }
+    catch (error) {
+        stderr.write(`mantle create: ${error instanceof ProvisionRenderError ? `${error.code}: ${error.message}` : message(error)}\n`);
+        return 1;
+    }
+    try {
+        await writeAtomically(target, rendered);
+    }
+    catch (error) {
+        stderr.write(`mantle create: ${message(error)}\n`);
+        return 1;
+    }
+    stdout.write(`Created ${archetype} project in ${target}\n`
+        + `  Mantle ${version} - starter ${starterRef}\n\n`
+        + "Next: read AGENTS.md in the new directory. It carries the install and\n"
+        + "first-run steps for this project; nothing has been installed yet.\n");
+    return 0;
+}
+function printHelp() {
+    stdout.write(`mantle create - materialize a version-matched starter into a new directory
+
+Usage: mantle create <type> <directory> [options]
+
+Types:
+  ${CREATE_ARCHETYPES.join(", ")}
+
+Options:
+  --brand <name>          Display brand (default: derived from the directory name)
+  --description <text>    One sentence describing the site
+  --locales <list>        Comma-separated locales; the first is canonical (default: en)
+  -h, --help              This help
+
+Dependencies are not installed, git is not initialized, and nothing is
+deployed. The generated AGENTS.md carries the next steps.
+`);
+}
+/**
+ * Only the official immutable tag for this exact package version. A bundle
+ * URL or ref is never taken from user input in this path.
+ */
+async function fetchOfficialBundle(starterRef, archetype, version) {
+    const url = `https://raw.githubusercontent.com/${STARTERS_OWNER}/${STARTERS_REPO}/${encodeURIComponent(starterRef)}/provision-bundles/${encodeURIComponent(archetype)}.json`;
+    const response = await fetch(url, { headers: { accept: "application/json" }, redirect: "error" });
+    if (!response.ok) {
+        // A 404 on a version-pinned tag has one common cause worth naming: the
+        // package was published before its matching starter tag exists.
+        const hint = response.status === 404
+            ? ` The ${starterRef} starter tag does not exist yet — if this version was just published, wait for its starter release, or pin an earlier version.`
+            : "";
+        throw new Error(`could not fetch the ${archetype} starter for ${starterRef} (HTTP ${response.status}).${hint}`);
+    }
+    const declared = Number(response.headers.get("content-length"));
+    if (Number.isFinite(declared) && declared > MAX_BUNDLE_BYTES) {
+        throw new Error(`starter bundle exceeds ${MAX_BUNDLE_BYTES} bytes.`);
+    }
+    const text = await readBounded(response, MAX_BUNDLE_BYTES);
+    let bundle;
+    try {
+        bundle = JSON.parse(text);
+    }
+    catch {
+        throw new Error("starter bundle is not valid JSON.");
+    }
+    // The URL is version-pinned, but a mis-built bundle published under that tag
+    // would still render. Refuse a version the tag does not promise.
+    if (bundle.version !== version) {
+        throw new Error(`starter bundle at ${starterRef} declares version ${String(bundle.version)}, expected ${version}.`);
+    }
+    return bundle;
+}
+/** Stops reading at the limit; a chunked response never gets to allocate past it. */
+async function readBounded(response, max) {
+    const body = response.body;
+    if (!body)
+        return response.text();
+    const reader = body.getReader();
+    const chunks = [];
+    let total = 0;
+    for (;;) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        if (value === undefined)
+            continue;
+        total += value.byteLength;
+        if (total > max) {
+            await reader.cancel();
+            throw new Error(`starter bundle exceeds ${max} bytes.`);
+        }
+        chunks.push(value);
+    }
+    return new TextDecoder("utf-8", { fatal: false }).decode(Buffer.concat(chunks));
+}
+/**
+ * Writes into an exclusively-created sibling directory, then renames it onto a
+ * target that did not previously exist. A failure leaves nothing behind.
+ */
+async function writeAtomically(target, rendered) {
+    const staging = await mkdtemp(join(dirname(target), ".mantle-create-"));
+    try {
+        for (const [path, content] of rendered.files) {
+            await writeFileAt(staging, path, Buffer.from(content, "utf8"));
+        }
+        for (const [path, content] of rendered.binaryFiles) {
+            await writeFileAt(staging, path, Buffer.from(content, "base64"));
+        }
+        await rename(staging, target);
+    }
+    catch (error) {
+        await rm(staging, { recursive: true, force: true });
+        throw error;
+    }
+}
+async function writeFileAt(root, relativePath, data) {
+    const destination = join(root, relativePath);
+    await mkdir(dirname(destination), { recursive: true, mode: DIRECTORY_MODE });
+    // Regular file, fixed mode: a bundle cannot create a symlink or an
+    // executable.
+    await writeFile(destination, data, { mode: FILE_MODE, flag: "wx" });
+}
+function slugify(value) {
+    return value.toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 63).replace(/-+$/g, "");
+}
+function titleCase(slug) {
+    return slug.split("-").filter(Boolean).map((word) => word[0]?.toUpperCase() + word.slice(1)).join(" ");
+}
+async function exists(path) {
+    return stat(path).then(() => true, () => false);
+}
+function message(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=create.js.map

package/dist/cli/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/cli/create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,WAAW,MAAM,oBAAoB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACnE,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,GAGtB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,cAAc,GAAG,QAAQ,CAAC;AAChC,MAAM,aAAa,GAAG,iBAAiB,CAAC;AACxC;;;;GAIG;AACH,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,CAAU,CAAC;AAChH,MAAM,gBAAgB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAC1C,MAAM,SAAS,GAAG,KAAK,CAAC;AACxB,MAAM,cAAc,GAAG,KAAK,CAAC;AAE7B,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAA0B;IACxD,IAAI,SAAiB,CAAC;IACtB,IAAI,SAAiB,CAAC;IACtB,IAAI,KAAyB,CAAC;IAC9B,IAAI,WAA+B,CAAC;IACpC,IAAI,OAA0B,CAAC;IAE/B,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;YACxC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC;YAClB,gBAAgB,EAAE,IAAI;YACtB,OAAO,EAAE;gBACP,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC/B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC3B,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;aACtC;SACF,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,SAAS,EAAE,CAAC;YACZ,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;YAC1D,OAAO,CAAC,CAAC;QACX,CAAC;QACD,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,WAA+B,CAAC;QACzD,IAAI,CAAE,iBAAuC,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAClE,MAAM,CAAC,KAAK,CAAC,iBAAiB,SAAS,gBAAgB,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACzF,OAAO,CAAC,CAAC;QACX,CAAC;QACD,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QACrB,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACjC,OAAO,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/F,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpC,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;IACzC,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9C,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC;QAC5E,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,MAAM,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,MAAM,CAAC,KAAK,CAAC,4CAA4C,MAAM,IAAI,CAAC,CAAC;QACrE,OAAO,CAAC,CAAC;IACX,CAAC;IACD,6EAA6E;IAC7E,2EAA2E;IAC3E,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,MAAM,CAAC,KAAK,CAAC,oCAAoC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACtE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;IACpC,MAAM,UAAU,GAAG,IAAI,OAAO,EAAE,CAAC;IACjC,MAAM,aAAa,GAAG,KAAK,IAAI,SAAS,CAAC,WAAW,CAAC,CAAC;IACtD,MAAM,MAAM,GAAiB;QAC3B,SAAS;QACT,WAAW;QACX,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,WAAW,IAAI,YAAY,SAAS,QAAQ;QACzD,OAAO;QACP,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI;QACnC,iEAAiE;QACjE,6CAA6C;QAC7C,QAAQ,EAAE,cAAc;QACxB,UAAU;QACV,gBAAgB,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC1C,OAAO,EAAE,uBAAuB;QAChC,WAAW,EAAE,EAAE;QACf,gBAAgB,EAAE,EAAE;QACpB,mBAAmB,EAAE,EAAE;KACxB,CAAC;IAEF,IAAI,QAAQ,CAAC;IACb,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QACzE,QAAQ,GAAG,qBAAqB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC,CAAC;IACzF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,kBAAkB,KAAK,YAAY,oBAAoB,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/H,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,CAAC;QACH,MAAM,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,kBAAkB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,CAAC,KAAK,CACV,WAAW,SAAS,eAAe,MAAM,IAAI;UACzC,YAAY,OAAO,cAAc,UAAU,MAAM;UACjD,yEAAyE;UACzE,qEAAqE,CAC1E,CAAC;IACF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,SAAS;IAChB,MAAM,CAAC,KAAK,CAAC;;;;;IAKX,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;CAU/B,CAAC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,mBAAmB,CAAC,UAAkB,EAAE,SAAiB,EAAE,OAAe;IACvF,MAAM,GAAG,GAAG,qCAAqC,cAAc,IAAI,aAAa,IAAI,kBAAkB,CAAC,UAAU,CAAC,sBAAsB,kBAAkB,CAAC,SAAS,CAAC,OAAO,CAAC;IAC7K,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IAClG,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,uEAAuE;QACvE,gEAAgE;QAChE,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,KAAK,GAAG;YAClC,CAAC,CAAC,QAAQ,UAAU,gIAAgI;YACpJ,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,uBAAuB,SAAS,gBAAgB,UAAU,UAAU,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;IAClH,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAChE,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,gBAAgB,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,0BAA0B,gBAAgB,SAAS,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;IAC3D,IAAI,MAAuB,CAAC;IAC5B,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAoB,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IACD,6EAA6E;IAC7E,iEAAiE;IACjE,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,qBAAqB,UAAU,qBAAqB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,cAAc,OAAO,GAAG,CAAC,CAAC;IACtH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,qFAAqF;AACrF,KAAK,UAAU,WAAW,CAAC,QAAkB,EAAE,GAAW;IACxD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC3B,IAAI,CAAC,IAAI;QAAE,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAChC,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,SAAS,CAAC;QACR,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,IAAI;YAAE,MAAM;QAChB,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC;QAC1B,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;YAChB,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,SAAS,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;AAClF,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,eAAe,CAC5B,MAAc,EACd,QAA0F;IAE1F,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC;IACxE,IAAI,CAAC;QACH,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAC7C,MAAM,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QACjE,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;YACnD,MAAM,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QACnE,CAAC;QACD,MAAM,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,IAAY,EAAE,YAAoB,EAAE,IAAY;IACzE,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC7C,MAAM,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;IAC7E,mEAAmE;IACnE,cAAc;IACd,MAAM,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,OAAO,CAAC,KAAa;IAC5B,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACnH,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzG,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,IAAY;IAChC,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,OAAO,CAAC,KAAc;IAC7B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/cli/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/cli/generate.ts"],"names":[],"mappings":"AAeA,wBAAsB,WAAW,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAyC7E"}

package/dist/cli/generate.js

@@ -0,0 +1,101 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { cwd, stderr, stdout } from "node:process";
+import { parseArgs } from "node:util";
+import { ValidateManifestsUseCase } from "@aotter/mantle-spec";
+import { loadManifestsFromRoot } from "@aotter/mantle-spec/cli";
+import { assertMantleNamespace, emitMantleModule } from "../codegen/emitMantleModule.js";
+export async function runGenerate(rawArgs) {
+    let options;
+    try {
+        const parsed = parseGenerateArgs(rawArgs);
+        if (parsed === null) {
+            printHelp();
+            return 0;
+        }
+        options = parsed;
+    }
+    catch (error) {
+        stderr.write(`${message(error)}\n`);
+        return 2;
+    }
+    const loaded = await loadManifestsFromRoot(options.manifests);
+    const validation = loaded.parsed
+        ? ValidateManifestsUseCase.run({ parsed: loaded.parsed })
+        : { diagnostics: [], errorCount: 0, warningCount: 0 };
+    const validationErrors = [...loaded.parseErrors, ...validation.diagnostics]
+        .filter((diagnostic) => diagnostic.severity === "error");
+    if (validationErrors.length > 0 || !validation.linked) {
+        printDiagnostics(validationErrors);
+        return 1;
+    }
+    const emitted = emitMantleModule({
+        linked: validation.linked,
+        namespace: options.namespace,
+    });
+    if (!emitted.ok) {
+        printDiagnostics(emitted.diagnostics);
+        return 1;
+    }
+    const output = resolve(cwd(), options.output);
+    const stale = !(await syncText(join(output, "mantle.ts"), emitted.source, options.check));
+    if (stale && options.check) {
+        stderr.write("Mantle generated files are stale; run `mantle generate`.\n");
+        return 1;
+    }
+    return 0;
+}
+function parseGenerateArgs(rawArgs) {
+    const { values } = parseArgs({
+        args: [...rawArgs],
+        options: {
+            manifests: { type: "string" },
+            output: { type: "string", short: "o" },
+            namespace: { type: "string" },
+            check: { type: "boolean" },
+            help: { type: "boolean", short: "h" },
+        },
+    });
+    if (values.help)
+        return null;
+    const namespace = values.namespace ?? "Mantle";
+    assertMantleNamespace(namespace, "--namespace");
+    return {
+        manifests: values.manifests ?? "./manifests",
+        output: values.output ?? ".mantle/generated",
+        namespace,
+        check: values.check === true,
+    };
+}
+function printHelp() {
+    stdout.write(`mantle generate — compile manifests into a typed runtime binding
+
+Usage: mantle generate [options]
+
+Options:
+  --manifests <dir>   Manifest directory (default: ./manifests)
+  -o, --output <dir>  Generated root (default: .mantle/generated)
+  --namespace <name>  Generated type namespace (default: Mantle)
+  --check             Fail without writing when generated code is stale
+  -h, --help          This help
+`);
+}
+function printDiagnostics(diagnostics) {
+    for (const diagnostic of diagnostics) {
+        stderr.write(`${diagnostic.code} ${diagnostic.path}: ${diagnostic.message}\n`);
+    }
+}
+async function syncText(path, expected, check) {
+    const current = await readFile(path, "utf8").catch(() => null);
+    if (current === expected)
+        return true;
+    if (check)
+        return false;
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, expected, "utf8");
+    return true;
+}
+function message(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=generate.js.map

package/dist/cli/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../src/cli/generate.ts"],"names":[],"mappings":"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"}

package/dist/cli/harness.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=harness.d.ts.map

package/dist/cli/harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../src/cli/harness.ts"],"names":[],"mappings":""}

package/dist/{harness-cli.js → cli/harness.js}

@@ -2,6 +2,7 @@
 import { argv, stderr, stdout } from "node:process";
 import { parseArgs } from "node:util";
 import { ValidateManifestsUseCase, } from "@aotter/mantle-spec";
+import { compileRuntimePlan } from "@aotter/mantle-runtime";
 import { loadManifestsFromRoot } from "@aotter/mantle-spec/cli";
 import { benchmarkHttpRoutes, inspectIndexCoverage, } from "@aotter/mantle-runtime/testing";
 async function main() {
@@ -42,26 +43,30 @@ async function runIndexes(rawArgs) {
     }
     const format = outputFormat(values.format);
     const loaded = await loadManifestsFromRoot(values.manifests ?? "./manifests");
-    const validation = ValidateManifestsUseCase.run({
-        manifests: loaded.manifests,
-        filePaths: loaded.filePaths,
-    });
+    const validation = loaded.parsed
+        ? ValidateManifestsUseCase.run({ parsed: loaded.parsed })
+        : { diagnostics: [], errorCount: 0, warningCount: 0 };
     const errors = [...loaded.parseErrors, ...validation.diagnostics]
         .filter((diagnostic) => diagnostic.severity === "error");
     if (errors.length > 0) {
         emitErrors(errors, format);
         return 1;
     }
-    if (loaded.manifests.length === 0) {
+    if (!validation.linked || validation.linked.schemas.length === 0) {
         stderr.write(`No manifests found under ${values.manifests ?? "./manifests"}\n`);
         return 2;
     }
+    const compiled = compileRuntimePlan(validation.linked);
+    if (!compiled.ok) {
+        emitErrors(compiled.diagnostics, format);
+        return 1;
+    }
     const rows = values.rows === undefined ? undefined : Number(values.rows);
     if (rows !== undefined && (!Number.isFinite(rows) || rows <= 0)) {
         stderr.write("--rows must be a positive number\n");
         return 2;
     }
-    const report = await inspectIndexCoverage(loaded.manifests, {
+    const report = await inspectIndexCoverage(compiled.value, {
         rowsPerSchema: rows,
         requirePublic: values["require-public"] === true,
         requiredViews: values.require ?? [],
@@ -188,7 +193,7 @@ function printHelp() {
 }
 function printIndexesHelp() {
     stdout.write(`Usage: mantle-harness indexes [options]\n\n` +
-        `  --manifests <dir>  Directory containing site.yaml (default: ./manifests)\n` +
+        `  --manifests <dir>  Directory containing YAML manifests (default: ./manifests)\n` +
         `  --rows <n>         Deterministic rows per Schema (default: 2000)\n` +
         `  --require <view>   Fail when this View lacks its access path; repeatable\n` +
         `  --require-public   Apply the gate to public Views\n` +
@@ -206,4 +211,4 @@ main().then((code) => { process.exitCode = code; }, (error) => {
     stderr.write(`${message(error)}\n`);
     process.exitCode = 2;
 });
-//# sourceMappingURL=harness-cli.js.map
+//# sourceMappingURL=harness.js.map