@aotter/mantle 0.0.11-alpha.62 → 0.0.11-alpha.64

package/dist/runtime-testing.d.ts

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

package/dist/runtime-testing.d.ts.map

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

package/dist/runtime-testing.js

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

package/dist/runtime-testing.js.map

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

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"}

package/dist/update.js

@@ -0,0 +1,387 @@
+import { createHash } from "node:crypto";
+import { existsSync, lstatSync, readFileSync, readdirSync, writeFileSync, } from "node:fs";
+import { join, posix } from "node:path";
+import { cwd, stderr, stdout } from "node:process";
+import { parseArgs } from "node:util";
+const REPORT_PATH = ".mantle/update-report.json";
+const IGNORE_DIRS = new Set([".git", "node_modules", ".wrangler", ".wrangler-test", "dist"]);
+const IGNORE_FILES = new Set([".mantle/features.json", ".mantle/launch-state.json", REPORT_PATH]);
+export async function runUpdate(rawArgs) {
+    let values;
+    try {
+        ({ values } = parseArgs({
+            args: [...rawArgs],
+            options: {
+                ref: { type: "string" },
+                "bundle-base-url": { type: "string" },
+                help: { type: "boolean", short: "h" },
+            },
+        }));
+    }
+    catch (error) {
+        stderr.write(`${message(error)}\n`);
+        return 2;
+    }
+    if (values.help) {
+        printHelp();
+        return 0;
+    }
+    const root = cwd();
+    try {
+        const launchState = readJson(join(root, ".mantle", "launch-state.json"));
+        const features = readJson(join(root, ".mantle", "features.json"));
+        const registry = recordField(features, "registry");
+        const sourceRef = stringField(launchState, "starter_ref");
+        const targetRef = values.ref ?? stringField(registry, "version");
+        const bundleBaseUrl = values["bundle-base-url"] ?? stringField(registry, "bundleBaseUrl");
+        if (!sourceRef)
+            throw new UsageError(".mantle/launch-state.json is missing starter_ref");
+        if (!targetRef)
+            throw new UsageError("pass --ref or configure registry.version");
+        if (!bundleBaseUrl) {
+            throw new UsageError("pass --bundle-base-url or configure registry.bundleBaseUrl");
+        }
+        if (!bundleBaseUrl.includes("{ref}")) {
+            throw new UsageError("bundle base URL must contain {ref}");
+        }
+        const archetype = launchArchetype(launchState, features);
+        const sourceBundle = await fetchBundle(bundleBaseUrl, sourceRef, archetype);
+        const targetBundle = sourceRef === targetRef
+            ? sourceBundle
+            : await fetchBundle(bundleBaseUrl, targetRef, archetype);
+        const timestamp = new Date().toISOString();
+        const turnstileSiteKey = optionalStringField(launchState, "turnstile_site_key")
+            ?? readWranglerStringVar(root, "TURNSTILE_SITE_KEY")
+            ?? "";
+        const source = materializeBundle(sourceBundle, placeholders(launchState, archetype, sourceRef, timestamp, turnstileSiteKey));
+        const target = materializeBundle(targetBundle, placeholders(launchState, archetype, targetRef, timestamp, turnstileSiteKey));
+        const upstream = compareSnapshots(source, target);
+        const local = compareProject(root, source);
+        const report = {
+            schema_version: 3,
+            generated_at: timestamp,
+            source_ref: sourceRef,
+            target_ref: targetRef,
+            bundle_base_url: bundleBaseUrl,
+            bundle_version: targetBundle.version ?? null,
+            upstream,
+            local,
+            metadata_migration: metadataMigration(sourceRef, targetRef, bundleBaseUrl, registry),
+            next_step: "Port reviewed upstream changes only, then apply the reported metadata migration while preserving all other instance state.",
+        };
+        writeReport(root, `${JSON.stringify(report, null, 2)}\n`);
+        stdout.write(`mantle update report: ${REPORT_PATH}\n`);
+        stdout.write(`${sourceRef} → ${targetRef}: ${upstream.counts.differing} changed, `
+            + `${upstream.counts.missing_current} added, ${upstream.counts.removed_upstream} removed; `
+            + `local: ${local.counts.differing} modified, ${local.counts.missing_current} missing, `
+            + `${local.counts.removed_upstream} project-only\n`);
+        return 0;
+    }
+    catch (error) {
+        stderr.write(`mantle update: ${message(error)}\n`);
+        return error instanceof UsageError ? 2 : 1;
+    }
+}
+function printHelp() {
+    stdout.write(`mantle update — compare this site with another provision bundle
+
+Usage: mantle update [options]
+
+Options:
+  --ref <ref>              Target immutable starter ref; defaults to registry.version
+  --bundle-base-url <url>  Bundle root containing {ref}; defaults to registry.bundleBaseUrl
+  -h, --help               This help
+`);
+}
+async function fetchBundle(baseTemplate, ref, archetype) {
+    let lastUrl = "";
+    let lastStatus = 404;
+    for (const candidate of bundleRefCandidates(ref)) {
+        const base = baseTemplate.replaceAll("{ref}", encodeURIComponent(candidate)).replace(/\/+$/, "");
+        const url = new URL(`${base}/${encodeURIComponent(archetype)}.json`);
+        if (url.protocol !== "https:" && url.protocol !== "http:") {
+            throw new Error("bundle base URL must use http or https");
+        }
+        lastUrl = url.toString();
+        const response = await fetch(url, { headers: { accept: "application/json" } });
+        lastStatus = response.status;
+        if (!response.ok && response.status === 404)
+            continue;
+        if (!response.ok)
+            throw new Error(`failed to fetch ${url}: HTTP ${response.status}`);
+        const value = await response.json();
+        if (!isRecord(value) || !isStringRecord(value.files)) {
+            throw new Error(`invalid provision bundle at ${url}`);
+        }
+        if (typeof value.archetype === "string" && value.archetype !== archetype) {
+            throw new Error(`provision bundle at ${url} is ${value.archetype}, expected ${archetype}`);
+        }
+        return {
+            version: typeof value.version === "string" ? value.version : undefined,
+            files: value.files,
+        };
+    }
+    throw new Error(`failed to fetch ${lastUrl}: HTTP ${lastStatus}`);
+}
+function bundleRefCandidates(ref) {
+    return /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(ref) ? [ref, `v${ref}`] : [ref];
+}
+function materializeBundle(bundle, values) {
+    const files = new Map();
+    for (const [sourcePath, source] of Object.entries(bundle.files).sort(([a], [b]) => a.localeCompare(b))) {
+        const path = safeBundlePath(sourcePath);
+        if (files.has(path))
+            throw new Error(`duplicate provision bundle path: ${path}`);
+        let text = substitute(source, values);
+        if (path === "wrangler.toml")
+            text = materializeLegacyWranglerToml(text, values);
+        files.set(path, text);
+    }
+    return files;
+}
+function safeBundlePath(source) {
+    const slashPath = source.replaceAll("\\", "/");
+    if (/^(?:\/|[A-Za-z]:\/)/.test(slashPath) || slashPath.split("/").includes("..")) {
+        throw new Error(`bundle path escapes project root: ${source}`);
+    }
+    const path = posix.normalize(slashPath.replace(/\.template$/, ""));
+    if (path === "." || path.startsWith("../")) {
+        throw new Error(`bundle path escapes project root: ${source}`);
+    }
+    return path;
+}
+function substitute(source, values) {
+    return source.replace(/\{\{([A-Z_][A-Z0-9_]*)\}\}/g, (token, key) => {
+        const value = values[key];
+        if (value === undefined)
+            throw new Error(`unknown provision placeholder ${token}`);
+        return value;
+    });
+}
+function materializeLegacyWranglerToml(text, values) {
+    const envStart = text.search(/\n\[env\./);
+    const tail = envStart === -1 ? "" : text.slice(envStart);
+    let head = envStart === -1 ? text : text.slice(0, envStart);
+    head = head.replace(/^name = ".*"$/m, `name = ${JSON.stringify(values.PROJECT_NAME)}`);
+    head = head.replace(/^database_name = ".*"$/m, `database_name = ${JSON.stringify(`${values.PROJECT_NAME}-db`)}`);
+    head = upsertWranglerStringVar(head, "PUBLIC_ORIGIN", values.SITE_URL ?? "");
+    if (values.TURNSTILE_SITE_KEY?.trim()) {
+        head = upsertWranglerStringVar(head, "TURNSTILE_SITE_KEY", values.TURNSTILE_SITE_KEY.trim());
+    }
+    return `${head}${tail}`;
+}
+function upsertWranglerStringVar(text, name, value) {
+    const line = `${name} = ${JSON.stringify(value)}`;
+    const existing = new RegExp(`^\\s*#?\\s*${escapeRegExp(name)}\\s*=.*$`, "m");
+    if (existing.test(text))
+        return text.replace(existing, line);
+    const vars = text.match(/^\[vars\]\s*$/m);
+    if (!vars || vars.index === undefined)
+        return `${text.trimEnd()}\n\n[vars]\n${line}\n`;
+    const index = vars.index + vars[0].length;
+    return `${text.slice(0, index)}\n${line}${text.slice(index)}`;
+}
+function readWranglerStringVar(root, name) {
+    const path = join(root, "wrangler.toml");
+    if (!existsSync(path) || !lstatSync(path).isFile())
+        return null;
+    const source = readFileSync(path, "utf8");
+    const match = source.match(new RegExp(`^\\s*${escapeRegExp(name)}\\s*=\\s*("(?:[^"\\\\]|\\\\.)*")\\s*$`, "m"));
+    if (!match?.[1])
+        return null;
+    try {
+        const value = JSON.parse(match[1]);
+        return typeof value === "string" ? value.trim() : null;
+    }
+    catch {
+        return null;
+    }
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function placeholders(launchState, archetype, targetRef, timestamp, turnstileSiteKey) {
+    const github = recordField(launchState, "github");
+    const repo = recordField(launchState, "repo");
+    const siteOwner = recordField(launchState, "site_owner");
+    const locales = arrayField(launchState, "locales");
+    const owner = optionalStringField(repo, "owner")
+        ?? optionalStringField(github, "owner")
+        ?? "unknown-owner";
+    const projectName = stringField(launchState, "project_name")
+        ?? stringField(repo, "name")
+        ?? "mantle-site";
+    const siteUrl = stringField(launchState, "site_url") ?? "https://example.com";
+    const locale = stringField(launchState, "canonical_locale") ?? locales[0] ?? "en";
+    const description = stringField(launchState, "description")
+        ?? stringField(launchState, "purpose")
+        ?? `${projectName} site.`;
+    return {
+        PROJECT_NAME: projectName,
+        ARCHETYPE: archetype,
+        BRAND: stringField(launchState, "brand") ?? projectName,
+        DESCRIPTION: description,
+        INSTALL_SUMMARY: stringField(launchState, "summary") ?? description,
+        LOCALES: JSON.stringify(locales.length ? locales : ["en"]),
+        CANONICAL_LOCALE: locale,
+        STARTER_REF: targetRef,
+        GITHUB_OWNER: owner,
+        ADMIN_GITHUB_LOGIN: optionalStringField(github, "admin_login")
+            ?? optionalStringField(siteOwner, "github_login")
+            ?? owner,
+        SITE_OWNER_EMAIL: optionalStringField(siteOwner, "email") ?? "",
+        AUTH_MODE: stringField(launchState, "authMode") ?? "self-managed",
+        SITE_URL: siteUrl,
+        TURNSTILE_SITE_KEY: turnstileSiteKey,
+        AFTER_LAUNCH_SKILL_URL: stringField(launchState, "after_launch_skill_url") ?? "",
+        INSTALL_TIMESTAMP: timestamp,
+    };
+}
+function compareSnapshots(current, upstream) {
+    const differing = [];
+    const missingCurrent = [];
+    for (const [path, source] of [...upstream].sort(([a], [b]) => a.localeCompare(b))) {
+        if (IGNORE_FILES.has(path))
+            continue;
+        const existing = current.get(path);
+        if (existing === undefined)
+            missingCurrent.push({ path, upstream_sha256: sha256(source) });
+        else if (existing !== source) {
+            differing.push({ path, current_sha256: sha256(existing), upstream_sha256: sha256(source) });
+        }
+    }
+    const removedUpstream = [...current]
+        .filter(([path]) => !IGNORE_FILES.has(path) && !upstream.has(path))
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([path, source]) => ({ path, current_sha256: sha256(source) }));
+    return diffReport(differing, missingCurrent, removedUpstream);
+}
+function compareProject(root, upstream) {
+    const differing = [];
+    const missingCurrent = [];
+    for (const [path, source] of [...upstream].sort(([a], [b]) => a.localeCompare(b))) {
+        if (IGNORE_FILES.has(path))
+            continue;
+        const currentPath = join(root, path);
+        if (!existsSync(currentPath) || !lstatSync(currentPath).isFile()) {
+            missingCurrent.push({ path, upstream_sha256: sha256(source) });
+            continue;
+        }
+        const current = readFileSync(currentPath);
+        if (sha256(current) !== sha256(source)) {
+            differing.push({ path, current_sha256: sha256(current), upstream_sha256: sha256(source) });
+        }
+    }
+    const removedUpstream = listProjectFiles(root)
+        .filter((path) => !upstream.has(path))
+        .map((path) => ({ path, current_sha256: sha256(readFileSync(join(root, path))) }));
+    return diffReport(differing, missingCurrent, removedUpstream);
+}
+function listProjectFiles(root, prefix = "") {
+    const files = [];
+    for (const entry of readdirSync(join(root, prefix), { withFileTypes: true })) {
+        if (IGNORE_DIRS.has(entry.name))
+            continue;
+        const path = prefix ? `${prefix}/${entry.name}` : entry.name;
+        if (entry.isDirectory())
+            files.push(...listProjectFiles(root, path));
+        else if (entry.isFile() && !IGNORE_FILES.has(path))
+            files.push(path);
+    }
+    return files.sort();
+}
+function diffReport(differing, missingCurrent, removedUpstream) {
+    return {
+        counts: {
+            differing: differing.length,
+            missing_current: missingCurrent.length,
+            removed_upstream: removedUpstream.length,
+        },
+        differing,
+        missing_current: missingCurrent,
+        removed_upstream: removedUpstream,
+    };
+}
+function metadataMigration(sourceRef, targetRef, bundleBaseUrl, registry) {
+    return {
+        required: sourceRef !== targetRef
+            || stringField(registry, "version") !== targetRef
+            || stringField(registry, "bundleBaseUrl") !== bundleBaseUrl,
+        apply_after_reviewed_port: true,
+        files: [
+            {
+                path: ".mantle/launch-state.json",
+                set: { starter_ref: targetRef },
+            },
+            {
+                path: ".mantle/features.json",
+                set: {
+                    "registry.version": targetRef,
+                    "registry.bundleBaseUrl": bundleBaseUrl,
+                },
+            },
+        ],
+    };
+}
+function writeReport(root, source) {
+    const directory = join(root, ".mantle");
+    if (!existsSync(directory) || !lstatSync(directory).isDirectory()) {
+        throw new Error(".mantle must be a real directory");
+    }
+    const path = join(root, REPORT_PATH);
+    if (existsSync(path) && !lstatSync(path).isFile()) {
+        throw new Error(`${REPORT_PATH} must be a regular file`);
+    }
+    writeFileSync(path, source, "utf8");
+}
+function sha256(value) {
+    return createHash("sha256").update(value).digest("hex");
+}
+function readJson(path) {
+    if (!existsSync(path))
+        return {};
+    const value = JSON.parse(readFileSync(path, "utf8"));
+    return isRecord(value) ? value : {};
+}
+function launchArchetype(launchState, features) {
+    const archetype = stringField(launchState, "archetype")
+        ?? stringField(recordField(features, "archetype"), "name")
+        ?? "blank";
+    if (!/^[a-z0-9-]+$/.test(archetype))
+        throw new Error(`invalid archetype: ${archetype}`);
+    return archetype;
+}
+function recordField(value, key) {
+    if (!isRecord(value))
+        return {};
+    return isRecord(value[key]) ? value[key] : {};
+}
+function stringField(value, key) {
+    if (!isRecord(value))
+        return null;
+    const field = value[key];
+    return typeof field === "string" && field.trim() ? field.trim() : null;
+}
+function optionalStringField(value, key) {
+    if (!isRecord(value))
+        return null;
+    const field = value[key];
+    return typeof field === "string" ? field.trim() : null;
+}
+function arrayField(value, key) {
+    if (!isRecord(value) || !Array.isArray(value[key]))
+        return [];
+    return value[key].filter((item) => typeof item === "string");
+}
+function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function isStringRecord(value) {
+    return isRecord(value) && Object.values(value).every((item) => typeof item === "string");
+}
+function message(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+class UsageError extends Error {
+}
+//# sourceMappingURL=update.js.map

package/dist/update.js.map

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

package/docs/adapter-guide.md

@@ -61,6 +61,14 @@ await runtime.bootInit();
 
 `bootInit()` runs canonical migrations, seeds `siteDefaults`, and validates the manifest set. Call it once before serving CMS traffic. The Cloudflare adapter's reference pattern is `packages/adapters/cloudflare/src/mount/bootRuntimeOnce.ts`.
 
+Use purpose-shaped runtime surfaces for canonical data: `runtime.entryReader`
+applies Schema index declarations, locale semantics, and the public `Entry`
+projection; `runtime.siteConfig` owns site settings. `runtime.db` remains only
+for source compatibility and is deprecated. An adapter that owns additional
+tables should retain the `DatabaseDriver` it injected instead of reaching back
+through the assembled runtime. Authoring continues through the pre-wired
+content use cases.
+
 ## HTTP and MCP surfaces
 
 The runtime is a library, not an HTTP server. A new adapter must mount equivalent framework routes:

package/docs/adr/0001-four-atom-manifest-model.md

@@ -209,12 +209,11 @@ See § Authoring shape below for the full retirement rationale.
 
 ## Implementation status
 
-Names + PG-1:1 framing are documented in this ADR and the
-manifest grammar reference. Manifest TS types live in
-`packages/mantle-spec/`. Starter manifests under
-`starters/` declare instances of each. Runtime dispatcher /
-View executor / Procedure dispatcher are tracked under the
-v0.1.0 ship list in [aotter/mantle](https://github.com/aotter/mantle).
+Names + PG-1:1 framing are documented in this ADR and the manifest grammar
+reference. Manifest TS types live in `packages/mantle-spec/`. The external
+[`aotter/mantle-starters`](https://github.com/aotter/mantle-starters)
+repository declares consumer instances of each atom. Runtime dispatcher, View
+executor, and Procedure dispatcher live in this repository.
 
 ---
 
@@ -500,7 +499,7 @@ YAML's standard `---` separator allows multiple documents in
 one file. A "feature file" carries all atoms for that feature:
 
 ```yaml
-# starters/<starter>/manifests/contact.yaml
+# manifests/contact.yaml
 apiVersion: cms.mantle.aotter.net/v1
 kind: Schema
 metadata: { name: contact-messages }