@aotter/mantle 0.0.11-alpha.63 → 0.0.11-alpha.65

package/README.md

@@ -2,7 +2,8 @@
 
 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.
 
-> v0.1.x is in development. APIs may change between minor versions.
+> Mantle is prerelease software. Use this package's `package.json` as the exact
+> installed version; APIs may change between prereleases until v0.1.0.
 
 ## Install
 
@@ -30,13 +31,84 @@ import { createCmsRuntime } from "@aotter/mantle/runtime";
 import { mountServerEndpoints } from "@aotter/mantle/cloudflare";
 ```
 
-The package also installs `mantle-harness`:
+The package also installs `mantle` and `mantle-harness`:
 
 ```bash
+pnpm exec mantle generate
+pnpm exec mantle generate --check
+pnpm exec mantle skills
+pnpm exec mantle skills --check
+pnpm exec mantle update --ref <immutable-starter-ref>
 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 the YAML under `./manifests`, then writes the
+parsed manifest module and handler declarations to `.mantle/generated/`.
+It does not sync skills, update packages, style, provision, or deploy.
+When manifests declare Views, the generated `site.ts` also exports
+`bindMantleSite(runtime)`: its `views` keys, params and returned rows come from
+those manifests, while diagnostics still come directly from `executeView`.
+Dynamic `runtime.viewsByName` access remains available for low-level code.
+
+```ts
+const site = bindMantleSite(runtime);
+const notes = await site.views["published-notes"]();
+```
+
+`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.
+
+`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.
+
+## Conventional Cloudflare Worker
+
+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";
+
+export default createMantleWorker({ manifest });
+```
+
+`createMantleWorker` owns conventional D1/KV/assets bindings, Auth, Admin,
+manifest REST/HTTP routes, OAuth, MCP, cache safety, and rejection-safe
+per-isolate boot. Use its single `extend` seam for application handlers and
+new Hono routes; use the public low-level exports when the deployment does not
+fit the conventional binding or lifecycle contract.
+
+Extensions may add routes but may not replace Core surfaces. These paths are
+reserved:
+
+- `/admin` and `/admin/*`
+- `/api/auth` and `/api/auth/*`
+- `/api/views` and `/api/views/*`
+- `/oauth` and `/oauth/*`
+- `/mcp` and `/mcp/*`
+- `/.well-known/oauth*`
+- `/favicon.svg`
+- global `*` and `/*` handlers
+
+A custom Auth factory's `basePath` and exact manifest-owned method/path pairs
+are also reserved at assembly. Static literal conflicts fail TypeScript during
+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.
+
+For an uncommon deployment that must own the top-level assembly, use the
+embedded [`docs/cloudflare-low-level-composition.md`](docs/cloudflare-low-level-composition.md)
+fixture. It composes the same public primitives without importing package
+internals or rebuilding Mantle's adapters.
+
 ## Getting started
 
 Give the [Mantle repo](https://github.com/aotter/mantle) to a coding agent or
@@ -47,20 +119,23 @@ materializes a local project, and verifies it before any provider work.
 
 [Mantle landing](https://mantle.tools) uses the same bundles and continues
 through private GitHub repo creation, Cloudflare deployment, and optional paid
-hosted auth. Generated repos vendor Core-owned `mantle:*` skills from this
-package for repo-local use.
+hosted auth. Generated repos project Core-owned `mantle:*` skills from their
+installed package for repo-local use.
 
 ## Agent marketplace install
 
 Install the Mantle Core skill bundle before working on generated repos:
 
+Replace `<installed-version>` with the exact version from this package's
+`package.json`. Do not point a versioned consumer at a mutable branch.
+
 ```bash
 # Claude Code
-/plugin marketplace add aotter/mantle
+/plugin marketplace add aotter/mantle@v<installed-version>
 /plugin install mantle@mantle
 
 # Codex
-codex plugin marketplace add aotter/mantle --ref develop
+codex plugin marketplace add aotter/mantle --ref v<installed-version>
 codex plugin add mantle@mantle
 ```
 
@@ -114,12 +189,12 @@ The `mantle-runtime` package never imports Cloudflare-specific types — adapter
   - `node_modules/@aotter/mantle/skills/update/SKILL.md`
   - `node_modules/@aotter/mantle/skills/install/SKILL.md`
   - `node_modules/@aotter/mantle/skills/provision/SKILL.md`
-- [Repo](https://github.com/aotter/mantle)
-- [4-atom manifest model (ADR-0001)](https://github.com/aotter/mantle/blob/develop/docs/adr/0001-four-atom-manifest-model.md)
-- [API and MCP authorization](https://github.com/aotter/mantle/blob/develop/docs/api-mcp-authorization.md)
-- [Deferred lifecycle Queues](https://github.com/aotter/mantle/blob/develop/docs/deferred-lifecycle-queues.md)
-- [Schema indexes on D1](https://github.com/aotter/mantle/blob/develop/docs/schema-indexes.md)
-- [Release process](https://github.com/aotter/mantle/blob/develop/docs/release-process.md)
+- [4-atom manifest model (ADR-0001)](docs/adr/0001-four-atom-manifest-model.md)
+- [API and MCP authorization](docs/api-mcp-authorization.md)
+- [Deferred lifecycle Queues](docs/deferred-lifecycle-queues.md)
+- [Schema indexes on D1](docs/schema-indexes.md)
+- [Release process](docs/release-process.md)
+- [Source repository](https://github.com/aotter/mantle)
 - [Issues](https://github.com/aotter/mantle/issues)
 
 ## License

package/dist/cli.d.ts

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

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+import { argv, stderr, stdout } from "node:process";
+import { runEmitOpenapi, runEmitTypes, runIntrospect, runValidate, } from "@aotter/mantle-spec/cli";
+import { runGenerate } from "./generate.js";
+import { runSkills } from "./skills.js";
+import { runUpdate } from "./update.js";
+async function main() {
+    const command = argv[2];
+    if (!command || command === "--help" || command === "-h") {
+        stdout.write(`mantle - SDK authoring CLI
+
+Usage: mantle <subcommand> [options]
+
+Subcommands:
+  generate       Compile manifests and handler types
+  skills         Project version-matched Core skills
+  update         Compare local work with provision bundles
+  validate       Static manifest + handler-source validation
+  introspect     Dump parsed manifest tree as JSON
+  emit-openapi   Emit OpenAPI 3.1 from Triggers + Views
+  emit-types     Emit TypeScript declarations from manifests
+`);
+        return command ? 0 : 2;
+    }
+    const rest = argv.slice(3);
+    switch (command) {
+        case "generate":
+            return runGenerate(rest);
+        case "skills":
+            return runSkills(rest);
+        case "update":
+            return runUpdate(rest);
+        case "validate":
+            return runValidate(rest);
+        case "introspect":
+            return runIntrospect(rest);
+        case "emit-openapi":
+            return runEmitOpenapi(rest);
+        case "emit-types":
+            return runEmitTypes(rest);
+        default:
+            stderr.write(`Unknown subcommand: ${command}\n`);
+            return 2;
+    }
+}
+main().then((code) => {
+    process.exitCode = code;
+}, (error) => {
+    stderr.write(`internal error: ${error instanceof Error ? error.stack ?? error.message : String(error)}\n`);
+    process.exitCode = 2;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EACL,cAAc,EACd,YAAY,EACZ,aAAa,EACb,WAAW,GACZ,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACzD,MAAM,CAAC,KAAK,CAAC;;;;;;;;;;;;CAYhB,CAAC,CAAC;QACC,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3B,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,UAAU;YACb,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;QAC3B,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;QACzB,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;QACzB,KAAK,UAAU;YACb,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;QAC3B,KAAK,YAAY;YACf,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;QAC7B,KAAK,cAAc;YACjB,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;QAC9B,KAAK,YAAY;YACf,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;QAC5B;YACE,MAAM,CAAC,KAAK,CAAC,uBAAuB,OAAO,IAAI,CAAC,CAAC;YACjD,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,IAAI,CACT,CAAC,IAAI,EAAE,EAAE;IACP,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;AAC1B,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;IACR,MAAM,CAAC,KAAK,CAAC,mBAAmB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3G,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CACF,CAAC"}

package/dist/generate.d.ts

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

package/dist/generate.d.ts.map

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

package/dist/generate.js

@@ -0,0 +1,181 @@
+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 { EmitTypesUseCase, ValidateManifestsUseCase, } from "@aotter/mantle-spec";
+import { loadManifestsFromRoot } from "@aotter/mantle-spec/cli";
+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 = ValidateManifestsUseCase.run({
+        manifests: loaded.manifests,
+        filePaths: loaded.filePaths,
+    });
+    const errors = [...loaded.parseErrors, ...validation.diagnostics]
+        .filter((diagnostic) => diagnostic.severity === "error");
+    if (errors.length > 0) {
+        for (const error of errors) {
+            stderr.write(`${error.code} ${error.path}: ${error.message}\n`);
+        }
+        return 1;
+    }
+    const output = resolve(cwd(), options.output);
+    const files = new Map([
+        [join(output, "site.ts"), emitManifestModule(loaded.manifests, options.namespace)],
+        [join(output, "types.d.ts"), emitTypes(loaded.manifests, options.namespace)],
+    ]);
+    let stale = false;
+    for (const [path, source] of files) {
+        stale = !(await syncText(path, source, options.check)) || stale;
+    }
+    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 ?? "MantleSite";
+    if (!/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(namespace)) {
+        throw new Error(`--namespace must be a TypeScript identifier; got ${JSON.stringify(namespace)}`);
+    }
+    return {
+        manifests: values.manifests ?? "./manifests",
+        output: values.output ?? ".mantle/generated",
+        namespace,
+        check: values.check === true,
+    };
+}
+function printHelp() {
+    stdout.write(`mantle generate — compile manifests and handler types
+
+Usage: mantle generate [options]
+
+Options:
+  --manifests <dir>   Manifest root (default: ./manifests)
+  -o, --output <dir>  Generated root (default: .mantle/generated)
+  --namespace <name>  Generated type namespace (default: MantleSite)
+  --check             Fail without writing when output is stale
+  -h, --help          This help
+`);
+}
+function emitManifestModule(manifests, namespace) {
+    const views = [];
+    manifests.forEach((manifest, index) => {
+        if (manifest.kind === "View")
+            views.push({ manifest, index });
+    });
+    const notice = "// Generated by `mantle generate`. Do not edit by hand.";
+    const specImport = 'import type { Manifest } from "@aotter/mantle/spec";';
+    const declaration = `export const manifest = ${JSON.stringify(manifests, null, 2)} as const satisfies readonly Manifest[];`;
+    if (views.length === 0)
+        return [notice, specImport, "", declaration, ""].join("\n");
+    return [
+        notice,
+        'import type { CmsRuntime, HandlerContext } from "@aotter/mantle/runtime";',
+        specImport,
+        'import type * as MantleGenerated from "./types.js";',
+        "",
+        declaration,
+        "",
+        "export interface MantleViewOptions {",
+        "  readonly page?: number;",
+        "  readonly show?: number;",
+        "  readonly ctx?: HandlerContext;",
+        "}",
+        "",
+        "export function bindMantleSite(runtime: CmsRuntime) {",
+        "  return {",
+        "    views: {",
+        ...views.flatMap(({ manifest: view, index }) => {
+            const id = tsId(view.metadata.name);
+            const requiredParams = (view.spec.params?.required?.length ?? 0) > 0;
+            const requestType = view.spec.params
+                ? `MantleViewOptions & { readonly params${requiredParams ? "" : "?"}: MantleGenerated.${namespace}.ViewParams_${id} }`
+                : "MantleViewOptions";
+            return [
+                `      ${JSON.stringify(view.metadata.name)}: (request: ${requestType}${requiredParams ? "" : " = {}"}) =>`,
+                `        runtime.executeView.execute<MantleGenerated.${namespace}.ViewRow_${id}>({`,
+                `          view: manifest[${index}],`,
+                "          ctx: request.ctx,",
+                "          options: {",
+                ...(view.spec.params ? ["            params: request.params,"] : []),
+                "            page: request.page,",
+                "            show: request.show,",
+                "          },",
+                "        }),",
+            ];
+        }),
+        "    },",
+        "  } as const;",
+        "}",
+        "",
+    ].join("\n");
+}
+function emitTypes(manifests, namespace) {
+    const generated = EmitTypesUseCase.run({ manifests, namespace }).source
+        .replace("Generated by `mantle emit-types`", "Generated by `mantle generate`");
+    const procedures = manifests.filter((manifest) => manifest.kind === "Procedure" && manifest.spec.handler.kind === "ref");
+    if (procedures.length === 0)
+        return generated;
+    const handlers = new Map();
+    for (const procedure of procedures) {
+        const name = tsId(procedure.metadata.name);
+        const ref = procedure.spec.handler.kind === "ref" ? procedure.spec.handler.ref : "";
+        const types = handlers.get(ref) ?? { inputs: [], outputs: [] };
+        types.inputs.push(`${namespace}.ProcInput_${name}`);
+        types.outputs.push(`${namespace}.ProcOutput_${name}`);
+        handlers.set(ref, types);
+    }
+    return [
+        'import type { HandlerFn } from "@aotter/mantle/runtime";',
+        "",
+        generated.trimEnd(),
+        "",
+        "export type MantleHandlers<Env = unknown> = {",
+        ...[...handlers].map(([ref, types]) => `  readonly ${JSON.stringify(ref)}: HandlerFn<${types.inputs.join(" | ")}, ${types.outputs.join(" | ")}, Env>;`),
+        "};",
+        "",
+    ].join("\n");
+}
+function tsId(name) {
+    return name.replace(/[^a-zA-Z0-9_$]+/g, "_");
+}
+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/generate.js.map

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

package/dist/skills.d.ts

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

package/dist/skills.d.ts.map

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

package/dist/skills.js

@@ -0,0 +1,80 @@
+import { mkdir, readFile, stat, writeFile } from "node:fs/promises";
+import { dirname, join, relative, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { cwd, stderr, stdout } from "node:process";
+import { parseArgs } from "node:util";
+const PROJECT_SKILLS = ["develop", "plugin", "theme", "update"];
+export async function runSkills(rawArgs) {
+    let check;
+    try {
+        const { values } = parseArgs({
+            args: [...rawArgs],
+            options: {
+                check: { type: "boolean" },
+                help: { type: "boolean", short: "h" },
+            },
+        });
+        if (values.help) {
+            printHelp();
+            return 0;
+        }
+        check = values.check === true;
+    }
+    catch (error) {
+        stderr.write(`${message(error)}\n`);
+        return 2;
+    }
+    try {
+        const sourceRoot = await skillSourceRoot();
+        let stale = false;
+        for (const skill of PROJECT_SKILLS) {
+            const expected = await readFile(join(sourceRoot, skill, "SKILL.md"), "utf8");
+            for (const tool of [".agent", ".claude"]) {
+                const target = resolve(cwd(), tool, "skills", `mantle-${skill}`, "SKILL.md");
+                const current = await readFile(target, "utf8").catch(() => null);
+                if (current === expected)
+                    continue;
+                stale = true;
+                if (check) {
+                    stderr.write(`Mantle skill is stale: ${relative(cwd(), target)}\n`);
+                    continue;
+                }
+                await mkdir(dirname(target), { recursive: true });
+                await writeFile(target, expected, "utf8");
+            }
+        }
+        if (stale && check) {
+            stderr.write("Mantle skills are stale; run `mantle skills`.\n");
+            return 1;
+        }
+        if (!check)
+            stdout.write("Mantle skills projected.\n");
+        return 0;
+    }
+    catch (error) {
+        stderr.write(`mantle skills: ${message(error)}\n`);
+        return 2;
+    }
+}
+function printHelp() {
+    stdout.write(`mantle skills — project version-matched Core skills
+
+Usage: mantle skills [--check]
+
+Options:
+  --check     Fail without writing when projected skills are stale
+  -h, --help  This help
+`);
+}
+async function skillSourceRoot() {
+    const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+    for (const candidate of [join(packageRoot, "skills"), resolve(packageRoot, "../../skills")]) {
+        if ((await stat(candidate).catch(() => null))?.isDirectory())
+            return candidate;
+    }
+    throw new Error("Core skills are missing from the installed package");
+}
+function message(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=skills.js.map

package/dist/skills.js.map

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

package/dist/update.d.ts

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

package/dist/update.d.ts.map

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