@weave-kit/engine 0.1.0

package/dist/runtime/git/pageCatalog.js

@@ -0,0 +1,183 @@
+import { readdir, rename, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { ObjectRegistry, SchemaError } from '../../core/index.js';
+import { OBJECT_LAYOUT_VIEWS, } from '../../layout-format.js';
+import { validateLayoutCandidate } from './layoutSource.js';
+import { readSource, sourceVersion, writeSourceAtomically } from './sourceFile.js';
+import { deleteSourceDir, runSerialized, runSourceTransaction, } from './sourceTransaction.js';
+import { commitPaths } from './autoCommit.js';
+export function emptyCustomLayout() {
+    return { viewports: { desktop: { mode: 'vertical', layout: [] } } };
+}
+const CUSTOM_ID_PATTERN = /^[a-z0-9][a-z0-9-]*$/;
+function assertCustomId(id, locale) {
+    if (id === 'app' || !CUSTOM_ID_PATTERN.test(id)) {
+        throw new SchemaError('http.param.invalid', { param: 'id' }, locale);
+    }
+}
+function walkSidebarItems(layout, visit) {
+    for (const viewportLayout of Object.values(layout.viewports)) {
+        if (viewportLayout === undefined)
+            continue;
+        for (const node of viewportLayout.layout) {
+            if (node.type !== 'sidebar')
+                continue;
+            for (const group of node.groups) {
+                for (const item of group.items) {
+                    visit({ group: group.label, item: { label: item.label, page: item.page } });
+                }
+            }
+        }
+    }
+}
+/** find sidebar references to a custom page (group label + item label) */
+export function findCustomPageRefs(shellSource, id) {
+    if (shellSource === undefined)
+        return [];
+    try {
+        const layout = JSON.parse(shellSource);
+        const refs = [];
+        walkSidebarItems(layout, ({ group, item }) => {
+            if (item.page?.kind === 'custom' && item.page.id === id)
+                refs.push({ group, item: item.label });
+        });
+        return refs;
+    }
+    catch {
+        return [];
+    }
+}
+function replaceCustomPageRefs(shellSource, id, newId) {
+    const layout = JSON.parse(shellSource);
+    walkSidebarItems(layout, ({ item }) => {
+        if (item.page?.kind === 'custom' && item.page.id === id)
+            item.page.id = newId;
+    });
+    return `${JSON.stringify(layout, null, 2)}\n`;
+}
+/** list every page (shell + object show/list + custom) — stable sort by path */
+export async function listPages(projectDir, registry) {
+    const result = [];
+    if ((await readSource(projectDir, 'pages/app.layout.json')) !== null) {
+        result.push({ kind: 'shell', id: 'app', path: 'app.layout' });
+    }
+    for (const def of registry.list()) {
+        if ((await readSource(projectDir, `pages/${def.name}/show.layout.json`)) !== null) {
+            result.push({ kind: 'object', id: def.name, view: OBJECT_LAYOUT_VIEWS.SHOW, path: `${def.name}/show.layout` });
+        }
+        if ((await readSource(projectDir, `pages/${def.name}/list.layout.json`)) !== null) {
+            result.push({ kind: 'object', id: def.name, view: OBJECT_LAYOUT_VIEWS.LIST, path: `${def.name}/list.layout` });
+        }
+    }
+    const pagesDir = join(projectDir, 'pages');
+    const objectDirs = new Set(registry.list().map((o) => o.name));
+    const customIds = [];
+    try {
+        for (const entry of await readdir(pagesDir, { withFileTypes: true })) {
+            if (!entry.isDirectory())
+                continue; // legacy flat `pages/<id>.layout.json` files are rejected
+            const name = entry.name;
+            if (name === 'app' || objectDirs.has(name))
+                continue; // object dirs win; 'app' is reserved (flat shell)
+            if ((await readSource(projectDir, `pages/${name}/layout.json`)) !== null)
+                customIds.push(name);
+        }
+    }
+    catch {
+        // no pages dir yet
+    }
+    customIds.sort();
+    for (const id of customIds) {
+        result.push({ kind: 'custom', id, path: `${id}/layout` });
+    }
+    result.sort((a, b) => a.path.localeCompare(b.path));
+    return result;
+}
+export async function createCustomPage(options) {
+    const { projectDir, registry, id, source, identity, locale } = options;
+    assertCustomId(id, locale);
+    if (registry.get(id) !== undefined) {
+        // the page dir `pages/<id>/` would collide with the object's page dir
+        throw new SchemaError('page.exists', { id }, locale);
+    }
+    const content = source ?? `${JSON.stringify(emptyCustomLayout(), null, 2)}\n`;
+    if (source !== undefined) {
+        validateLayoutCandidate({ addr: { kind: 'custom', id }, source, registry, locale });
+    }
+    const existing = await readSource(projectDir, `pages/${id}/layout.json`);
+    if (existing !== null) {
+        throw new SchemaError('page.exists', { id }, locale);
+    }
+    await runSourceTransaction({
+        projectDir,
+        files: [{ path: `pages/${id}/layout.json`, source: content }],
+        identity,
+        locale,
+        message: `chore(pages): create ${id}`,
+    });
+    return { path: `${id}/layout`, version: sourceVersion(content) };
+}
+export async function deleteCustomPage(options) {
+    const { projectDir, id, identity, locale } = options;
+    assertCustomId(id, locale);
+    const shell = await readSource(projectDir, 'pages/app.layout.json');
+    const refs = findCustomPageRefs(shell?.source, id);
+    if (refs.length > 0) {
+        throw new SchemaError('page.ref.inUse', { id, count: refs.length, refs: JSON.stringify(refs) }, locale);
+    }
+    const result = await deleteSourceDir({
+        projectDir,
+        dir: `pages/${id}`,
+        message: `chore(pages): delete ${id}`,
+        identity,
+        locale,
+    });
+    return { deleted: result.committed };
+}
+/** atomically rename a custom page: move the page directory + update shell PageRefs in one commit */
+export function renameCustomPage(options) {
+    const { projectDir, id, newId, identity, locale } = options;
+    assertCustomId(id, locale);
+    assertCustomId(newId, locale);
+    return runSerialized(projectDir, async () => {
+        const oldSource = await readSource(projectDir, `pages/${id}/layout.json`);
+        if (oldSource === null)
+            throw new SchemaError('http.notFound', {}, locale);
+        if ((await readSource(projectDir, `pages/${newId}/layout.json`)) !== null) {
+            throw new SchemaError('page.exists', { id: newId }, locale);
+        }
+        const shell = await readSource(projectDir, 'pages/app.layout.json');
+        let shellSource;
+        if (shell !== null) {
+            shellSource = replaceCustomPageRefs(shell.source, id, newId);
+        }
+        const oldDir = join(projectDir, 'pages', id);
+        const newDir = join(projectDir, 'pages', newId);
+        const shellPath = 'pages/app.layout.json';
+        const shellChanged = shellSource !== undefined && shell !== null && shellSource !== shell.source;
+        await rm(newDir, { recursive: true, force: true });
+        await rename(oldDir, newDir);
+        if (shellChanged)
+            await writeSourceAtomically(projectDir, shellPath, shellSource);
+        const paths = shellChanged ? [`pages/${id}`, `pages/${newId}`, shellPath] : [`pages/${id}`, `pages/${newId}`];
+        try {
+            await commitPaths({
+                dir: projectDir,
+                paths,
+                message: `chore(pages): rename ${id} to ${newId}`,
+                identity,
+                locale,
+            });
+            return { path: `${newId}/layout` };
+        }
+        catch (error) {
+            await rm(oldDir, { recursive: true, force: true });
+            await rename(newDir, oldDir);
+            if (shellChanged && shell !== null) {
+                await writeSourceAtomically(projectDir, shellPath, shell.source);
+            }
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=pageCatalog.js.map

package/dist/runtime/git/pageCatalog.js.map

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

package/dist/runtime/git/pageScripts.d.ts

@@ -0,0 +1,43 @@
+import type { Locale } from '../../core/index.js';
+import type { AutoCommitOptions } from './autoCommit.js';
+/**
+ * Page-scoped client scripts (千人千面). Only **client** scripts live here
+ * (`server.js` stays object-level in `objects/<X>/`). A page binding an object
+ * carries its own face scripts under `pages/<page>/objects/<object>/<kind>.client.js`
+ * (show.client / list.client); the runtime falls back to the object's canonical
+ * scripts at `pages/<object>/<kind>.client.js`. There are NO page-level or
+ * block-level script files anymore.
+ */
+export declare const PAGE_SCRIPT_KINDS: {
+    readonly SHOW_CLIENT: "show.client";
+    readonly LIST_CLIENT: "list.client";
+};
+export type PageScriptKind = (typeof PAGE_SCRIPT_KINDS)[keyof typeof PAGE_SCRIPT_KINDS];
+export declare function isPageScriptKind(value: string): value is PageScriptKind;
+export interface PageScriptDocument {
+    source: string;
+    version: string;
+}
+/** `pages/<page>/objects/<object>/<kind>.client.js` (page × object face script) */
+export declare function pageFaceScriptRelPath(page: string, object: string, kind: PageScriptKind): string;
+export declare function readPageScript(projectDir: string, relPath: string): Promise<PageScriptDocument | null>;
+export interface WritePageScriptOptions {
+    projectDir: string;
+    relPath: string;
+    source: string;
+    identity?: AutoCommitOptions['identity'];
+    locale?: Locale;
+}
+export interface WritePageScriptResult extends PageScriptDocument {
+    committed: boolean;
+}
+export declare function writePageScript(options: WritePageScriptOptions): Promise<WritePageScriptResult>;
+export declare function deletePageScript(projectDir: string, relPath: string, identity?: AutoCommitOptions['identity'], locale?: Locale): Promise<{
+    deleted: boolean;
+}>;
+/** parse a page-face script scope (`<page>/objects/<object>`) — the `/pages/<scope>/scripts/<kind>` form */
+export declare function parsePageFaceScope(scope: string): {
+    page: string;
+    object: string;
+} | undefined;
+//# sourceMappingURL=pageScripts.d.ts.map

package/dist/runtime/git/pageScripts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pageScripts.d.ts","sourceRoot":"","sources":["../../../src/runtime/git/pageScripts.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAKzD;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB;;;CAGpB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAExF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,cAAc,CAEvE;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,mFAAmF;AACnF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM,CAEhG;AAED,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAEpC;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC/D,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA2BrG;AAED,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,iBAAiB,CAAC,UAAU,CAAC,EACxC,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAiB/B;AAED,4GAA4G;AAC5G,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAO9F"}

package/dist/runtime/git/pageScripts.js

@@ -0,0 +1,89 @@
+import { mkdir, rm } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { commitPath } from './autoCommit.js';
+import { readSource, sourceVersion, writeSourceAtomically } from './sourceFile.js';
+import { validateScriptSource } from './scriptSource.js';
+/**
+ * Page-scoped client scripts (千人千面). Only **client** scripts live here
+ * (`server.js` stays object-level in `objects/<X>/`). A page binding an object
+ * carries its own face scripts under `pages/<page>/objects/<object>/<kind>.client.js`
+ * (show.client / list.client); the runtime falls back to the object's canonical
+ * scripts at `pages/<object>/<kind>.client.js`. There are NO page-level or
+ * block-level script files anymore.
+ */
+export const PAGE_SCRIPT_KINDS = {
+    SHOW_CLIENT: 'show.client',
+    LIST_CLIENT: 'list.client',
+};
+export function isPageScriptKind(value) {
+    return value === PAGE_SCRIPT_KINDS.SHOW_CLIENT || value === PAGE_SCRIPT_KINDS.LIST_CLIENT;
+}
+/** `pages/<page>/objects/<object>/<kind>.client.js` (page × object face script) */
+export function pageFaceScriptRelPath(page, object, kind) {
+    return `pages/${page}/objects/${object}/${kind}.js`;
+}
+export async function readPageScript(projectDir, relPath) {
+    return readSource(projectDir, relPath);
+}
+export async function writePageScript(options) {
+    const { projectDir, relPath, source, identity, locale } = options;
+    await validateScriptSource(source, PAGE_SCRIPT_KINDS.SHOW_CLIENT, locale);
+    const absolute = join(projectDir, relPath);
+    const previous = await readSource(projectDir, relPath);
+    const version = sourceVersion(source);
+    if (previous?.version === version)
+        return { source, version, committed: false };
+    await mkdir(dirname(absolute), { recursive: true });
+    await writeSourceAtomically(projectDir, relPath, source);
+    try {
+        const commit = await commitPath({
+            dir: projectDir,
+            path: relPath,
+            message: `chore(pages): update script ${relPath}`,
+            identity,
+            locale,
+        });
+        return { source, version, committed: commit.committed };
+    }
+    catch (error) {
+        if (previous === null) {
+            await rm(absolute, { force: true });
+        }
+        else {
+            await writeSourceAtomically(projectDir, relPath, previous.source);
+        }
+        throw error;
+    }
+}
+export async function deletePageScript(projectDir, relPath, identity, locale) {
+    const baseline = await readSource(projectDir, relPath);
+    if (baseline === null)
+        return { deleted: false };
+    await rm(join(projectDir, relPath), { force: true });
+    try {
+        const commit = await commitPath({
+            dir: projectDir,
+            path: relPath,
+            message: `chore(pages): delete script ${relPath}`,
+            identity,
+            locale,
+        });
+        return { deleted: commit.committed };
+    }
+    catch (error) {
+        await writeSourceAtomically(projectDir, relPath, baseline.source);
+        throw error;
+    }
+}
+/** parse a page-face script scope (`<page>/objects/<object>`) — the `/pages/<scope>/scripts/<kind>` form */
+export function parsePageFaceScope(scope) {
+    const match = /^([^/]+)\/objects\/([^/]+)$/.exec(scope);
+    if (match === null)
+        return undefined;
+    const page = match[1];
+    const object = match[2];
+    if (page === '' || page === 'app' || object === '')
+        return undefined;
+    return { page, object };
+}
+//# sourceMappingURL=pageScripts.js.map

package/dist/runtime/git/pageScripts.js.map

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

package/dist/runtime/git/runner.d.ts

@@ -0,0 +1,25 @@
+import type { Locale } from '../../core/index.js';
+export interface GitResult {
+    stdout: string;
+    stderr: string;
+    /** exit code; 0 on success */
+    code: number;
+}
+export interface RunGitOptions {
+    /** working directory for the git invocation */
+    cwd: string;
+    /** return the result instead of throwing on non-zero exit */
+    allowFailure?: boolean;
+    /** commit identity injected as `-c user.name=... -c user.email=...` */
+    identity?: {
+        name: string;
+        email: string;
+    };
+    locale?: Locale;
+}
+/**
+ * Run a git command. Cross-runtime (node:child_process works under Bun and
+ * Node — the compatibility escape path; Bun.spawn is intentionally avoided).
+ */
+export declare function runGit(args: string[], options: RunGitOptions): Promise<GitResult>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runtime/git/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/runtime/git/runner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,6DAA6D;IAC7D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,uEAAuE;IACvE,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAWD;;;GAGG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC,CAWvF"}

package/dist/runtime/git/runner.js

@@ -0,0 +1,26 @@
+import { execFile } from 'node:child_process';
+import { SchemaError } from '../../core/index.js';
+function execGit(args, cwd) {
+    return new Promise((resolve) => {
+        execFile('git', args, { cwd, maxBuffer: 1024 * 1024 }, (error, stdout, stderr) => {
+            const code = error === null ? 0 : typeof error.code === 'number' ? error.code : 1;
+            resolve({ stdout, stderr, code });
+        });
+    });
+}
+/**
+ * Run a git command. Cross-runtime (node:child_process works under Bun and
+ * Node — the compatibility escape path; Bun.spawn is intentionally avoided).
+ */
+export async function runGit(args, options) {
+    const identityArgs = options.identity === undefined
+        ? args
+        : ['-c', `user.name=${options.identity.name}`, '-c', `user.email=${options.identity.email}`, ...args];
+    const result = await execGit(identityArgs, options.cwd);
+    if (result.code !== 0 && !options.allowFailure) {
+        const detail = result.stderr.trim() || result.stdout.trim() || `exit code ${result.code}`;
+        throw new SchemaError('git.command.failed', { command: args.join(' '), detail }, options.locale);
+    }
+    return result;
+}
+//# sourceMappingURL=runner.js.map

package/dist/runtime/git/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../../src/runtime/git/runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAoBlD,SAAS,OAAO,CAAC,IAAc,EAAE,GAAW;IAC1C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,GAAG,IAAI,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YAC/E,MAAM,IAAI,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAClF,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAc,EAAE,OAAsB;IACjE,MAAM,YAAY,GAChB,OAAO,CAAC,QAAQ,KAAK,SAAS;QAC5B,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,CAAC,IAAI,EAAE,aAAa,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,cAAc,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAC1G,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACxD,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,aAAa,MAAM,CAAC,IAAI,EAAE,CAAC;QAC1F,MAAM,IAAI,WAAW,CAAC,oBAAoB,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACnG,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/runtime/git/schemaChange.d.ts

@@ -0,0 +1,70 @@
+import type { Pool } from 'pg';
+import { type Locale } from '../../core/index.js';
+import type { SchemaFile } from './loader.js';
+/**
+ * Schema-change diffing shared by the auto-commit message and the queryable
+ * `schema.changed` audit trail. The previous state is read from git HEAD (the
+ * committed `objects/<name>/schema.json`), the new state from the just-loaded
+ * definitions — the same diff feeds both the human-readable commit message and
+ * the structured `weavekit_audit` events (one per changed object).
+ */
+export type SchemaChange = {
+    kind: 'object.added';
+    object: string;
+    fieldCount: number;
+} | {
+    kind: 'object.removed';
+    object: string;
+} | {
+    kind: 'object.updated';
+    object: string;
+    attr: string;
+    before: unknown;
+    after: unknown;
+} | {
+    kind: 'field.added';
+    object: string;
+    field: string;
+    type: string;
+    default?: unknown;
+    required?: boolean;
+    options?: string[];
+} | {
+    kind: 'field.removed';
+    object: string;
+    field: string;
+    type: string;
+} | {
+    kind: 'field.updated';
+    object: string;
+    field: string;
+    attr: string;
+    before: unknown;
+    after: unknown;
+} | {
+    kind: 'permissions.changed';
+    object: string;
+    role: string;
+    before: unknown;
+    after: unknown;
+};
+/** compare the loaded schema files against git HEAD and return the change list */
+export declare function diffMetadata(dir: string, files: SchemaFile[], locale?: Locale): Promise<SchemaChange[]>;
+/** human-readable commit message: short subject + per-object field-level body */
+export declare function buildCommitMessage(changes: SchemaChange[]): string;
+/** git author of the last commit (used as the audit actor); 'system' when unavailable */
+export declare function gitCommitAuthor(dir: string): Promise<string>;
+export interface SchemaAuditCommit {
+    sha?: string;
+    author?: string;
+    /** objects whose DDL was applied by this sync */
+    applied?: string[];
+}
+/**
+ * Record schema changes as `schema.changed` audit events in `weavekit_audit`
+ * (one per changed object). Written directly (not through the audit subsystem)
+ * so schema history is kept regardless of the runtime-audit toggle; the full
+ * before/after stays authoritative in git, this is the queryable summary.
+ */
+export declare function recordSchemaChanges(pool: Pool, changes: SchemaChange[], files: SchemaFile[], commit: SchemaAuditCommit): Promise<void>;
+//# sourceMappingURL=schemaChange.d.ts.map

package/dist/runtime/git/schemaChange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaChange.d.ts","sourceRoot":"","sources":["../../../src/runtime/git/schemaChange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,EAIL,KAAK,MAAM,EAEZ,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C;;;;;;GAMG;AAEH,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACzF;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,GACD;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACvG;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AA8HnG,kFAAkF;AAClF,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CA0B7G;AASD,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CA0ClE;AAED,yFAAyF;AACzF,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGlE;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,YAAY,EAAE,EACvB,KAAK,EAAE,UAAU,EAAE,EACnB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,IAAI,CAAC,CA8Bf"}