@weave-kit/engine 0.1.0

package/dist/runtime/git/guardrailSource.js

@@ -0,0 +1,140 @@
+import { readdir, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { SchemaError } from '../../core/index.js';
+import { commitPath } from './autoCommit.js';
+import { runGit } from './runner.js';
+import { readSource, sourceVersion, writeSourceAtomically } from './sourceFile.js';
+const POLICY_FILE_EXTENSIONS = ['.js', '.mjs', '.cjs'];
+const POLICY_NAME_PATTERN = /^[a-zA-Z0-9_-]+\.(js|mjs|cjs)$/;
+/** validate a single policy file name (reject traversal / nested / non-ext) */
+export function assertPolicyName(name, locale) {
+    if (!POLICY_NAME_PATTERN.test(name) || name.startsWith('.')) {
+        throw new SchemaError('http.param.invalid', { param: 'name', detail: name }, locale);
+    }
+}
+function isPolicyFile(name) {
+    return POLICY_FILE_EXTENSIONS.some((ext) => name.endsWith(ext));
+}
+function isValidPolicyName(name) {
+    return POLICY_NAME_PATTERN.test(name) && !name.startsWith('.');
+}
+function policyDir(projectDir, policiesDir) {
+    return join(projectDir, policiesDir);
+}
+/** list policy files in the policies dir (name + sha256 version), sorted */
+export async function listGuardrailPolicies(projectDir, policiesDir) {
+    const dir = policyDir(projectDir, policiesDir);
+    let isDir = false;
+    try {
+        isDir = (await stat(dir)).isDirectory();
+    }
+    catch {
+        isDir = false;
+    }
+    if (!isDir)
+        return [];
+    const entries = await readdir(dir, { withFileTypes: true });
+    const files = entries
+        .filter((entry) => entry.isFile() && isPolicyFile(entry.name) && isValidPolicyName(entry.name))
+        .map((entry) => entry.name)
+        .sort();
+    const out = [];
+    for (const name of files) {
+        const document = await readGuardrailPolicy(projectDir, policiesDir, name);
+        out.push({ name, version: document?.version ?? '' });
+    }
+    return out;
+}
+/** read one policy source (null when the file is missing) */
+export async function readGuardrailPolicy(projectDir, policiesDir, name) {
+    assertPolicyName(name);
+    const dir = policyDir(projectDir, policiesDir);
+    const document = await readSource(dir, name);
+    if (document === null)
+        return null;
+    return document;
+}
+/** validate a policy source parses as JS (esbuild transform) */
+async function validatePolicySource(source, locale) {
+    try {
+        const { transformSync } = await import('esbuild');
+        transformSync(source, { loader: 'js', format: 'esm' });
+    }
+    catch (error) {
+        throw new SchemaError('http.param.invalid', { param: 'source', detail: error instanceof Error ? error.message : String(error) }, locale);
+    }
+}
+/** write a policy source (atomic + git commit); no-op when unchanged */
+export async function writeGuardrailPolicy(projectDir, policiesDir, name, options) {
+    assertPolicyName(name);
+    const { source, identity, locale } = options;
+    await validatePolicySource(source, locale);
+    const dir = policyDir(projectDir, policiesDir);
+    const previous = await readSource(dir, name);
+    const version = sourceVersion(source);
+    if (previous?.version === version)
+        return { source, version, committed: false };
+    await writeSourceAtomically(dir, name, source);
+    try {
+        const commit = await commitPath({
+            dir: projectDir,
+            path: join(policiesDir, name),
+            message: `chore(policies): update ${name}`,
+            identity,
+            locale,
+        });
+        return { source, version, committed: commit.committed };
+    }
+    catch (error) {
+        if (previous === null) {
+            const { rm } = await import('node:fs/promises');
+            await rm(join(dir, name), { force: true });
+        }
+        else {
+            await writeSourceAtomically(dir, name, previous.source);
+        }
+        throw error;
+    }
+}
+const HISTORY_FIELD_SEP = '\x1f';
+const HISTORY_FORMAT = ['%H', '%an', '%ae', '%aI', '%s'].join(HISTORY_FIELD_SEP);
+/**
+ * Git history of a policy file: the commits that touched it (newest first) with
+ * the source blob at each commit. Used by the admin history/diff surface. Empty
+ * when the project is not a git work tree or the file has no history — never
+ * throws, so a missing-git project degrades to a blank history.
+ */
+export async function listGuardrailHistory(projectDir, policiesDir, name) {
+    assertPolicyName(name);
+    const rel = join(policiesDir, name).split('\\').join('/');
+    const inRepo = await runGit(['rev-parse', '--is-inside-work-tree'], { cwd: projectDir, allowFailure: true });
+    if (inRepo.stdout.trim() !== 'true')
+        return { name, commits: [] };
+    const log = await runGit(['log', '--follow', `--format=${HISTORY_FORMAT}`, '--', rel], {
+        cwd: projectDir,
+        allowFailure: true,
+    });
+    if (log.code !== 0)
+        return { name, commits: [] };
+    const commits = [];
+    for (const line of log.stdout.split('\n')) {
+        if (line === '')
+            continue;
+        const [sha, author, email, date, ...rest] = line.split(HISTORY_FIELD_SEP);
+        if (!sha)
+            continue;
+        const blob = await runGit(['show', `${sha}:${rel}`], { cwd: projectDir, allowFailure: true });
+        const source = blob.code === 0 ? blob.stdout : null;
+        commits.push({
+            sha,
+            author: author ?? '',
+            email: email ?? '',
+            date: date ?? '',
+            message: rest.join(HISTORY_FIELD_SEP),
+            source,
+            version: source === null ? null : sourceVersion(source),
+        });
+    }
+    return { name, commits };
+}
+//# sourceMappingURL=guardrailSource.js.map

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

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

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

@@ -0,0 +1,22 @@
+export { runGit } from './runner.js';
+export type { GitResult, RunGitOptions } from './runner.js';
+export { loadSchemaDir } from './loader.js';
+export type { SchemaFile, LoadResult } from './loader.js';
+export { syncSchema } from './sync.js';
+export type { SyncSchemaOptions, SyncResult } from './sync.js';
+export { autoCommit, commitPath, commitPaths } from './autoCommit.js';
+export type { AutoCommitOptions, AutoCommitResult, CommitPathOptions, CommitPathsOptions } from './autoCommit.js';
+export { runSourceTransaction, runSerialized, deleteSourceFile } from './sourceTransaction.js';
+export type { SourceFileCandidate, SourceTransactionOptions, SourceTransactionResult, DeleteSourceOptions, } from './sourceTransaction.js';
+export { sourceVersion, readSource, writeSourceAtomically } from './sourceFile.js';
+export { listGuardrailPolicies, readGuardrailPolicy, writeGuardrailPolicy, listGuardrailHistory, } from './guardrailSource.js';
+export type { GuardrailPolicySummary, GuardrailPolicyDocument, GuardrailPolicyCommit, GuardrailPolicyHistory, WriteGuardrailPolicyOptions, WriteGuardrailPolicyResult, } from './guardrailSource.js';
+export { readLayoutSource, writeLayoutSource, validateLayoutCandidate, layoutPathOf, throwLayoutIssues, listableFieldsOf, } from './layoutSource.js';
+export type { LayoutSourceDocument, WriteLayoutSourceOptions, WriteLayoutSourceResult } from './layoutSource.js';
+export { readSchemaSource, writeSchemaSource, validateSchemaCandidate, schemaPathOf } from './schemaSource.js';
+export type { SchemaSourceDocument, WriteSchemaSourceOptions, WriteSchemaSourceResult } from './schemaSource.js';
+export { listPages, createCustomPage, deleteCustomPage, renameCustomPage, findCustomPageRefs, emptyCustomLayout, } from './pageCatalog.js';
+export type { PageSummary, CreateCustomPageOptions, DeleteCustomPageOptions, RenameCustomPageOptions } from './pageCatalog.js';
+export { buildCommitMessage, diffMetadata, gitCommitAuthor, recordSchemaChanges } from './schemaChange.js';
+export type { SchemaAuditCommit, SchemaChange } from './schemaChange.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/git/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACtE,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAClH,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/F,YAAY,EACV,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACnF,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,EACvB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AACjH,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC/G,YAAY,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AACjH,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,WAAW,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC/H,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC3G,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/runtime/git/index.js

@@ -0,0 +1,12 @@
+export { runGit } from './runner.js';
+export { loadSchemaDir } from './loader.js';
+export { syncSchema } from './sync.js';
+export { autoCommit, commitPath, commitPaths } from './autoCommit.js';
+export { runSourceTransaction, runSerialized, deleteSourceFile } from './sourceTransaction.js';
+export { sourceVersion, readSource, writeSourceAtomically } from './sourceFile.js';
+export { listGuardrailPolicies, readGuardrailPolicy, writeGuardrailPolicy, listGuardrailHistory, } from './guardrailSource.js';
+export { readLayoutSource, writeLayoutSource, validateLayoutCandidate, layoutPathOf, throwLayoutIssues, listableFieldsOf, } from './layoutSource.js';
+export { readSchemaSource, writeSchemaSource, validateSchemaCandidate, schemaPathOf } from './schemaSource.js';
+export { listPages, createCustomPage, deleteCustomPage, renameCustomPage, findCustomPageRefs, emptyCustomLayout, } from './pageCatalog.js';
+export { buildCommitMessage, diffMetadata, gitCommitAuthor, recordSchemaChanges } from './schemaChange.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/git/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEtE,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAO/F,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACnF,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAS9B,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,EACvB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE/G,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}

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

@@ -0,0 +1,41 @@
+import { ObjectRegistry, type Locale } from '../../core/index.js';
+import { type LayoutAddress, type LayoutIssue } from '../../layout-format.js';
+import type { AutoCommitOptions } from './autoCommit.js';
+/**
+ * Layout source store (SU-7c): path-mirrored read/write of `pages/<path>.json`
+ * with profile-aware validation. Addressing is driven by {@link LayoutAddress}
+ * — the `/pages/<path>` shape mirrors the physical file (kind/view in the path).
+ */
+export interface LayoutSourceDocument {
+    source: string;
+    version: string;
+}
+export interface WriteLayoutSourceOptions {
+    projectDir: string;
+    addr: LayoutAddress;
+    source: string;
+    expectVersion?: string;
+    force?: boolean;
+    registry: ObjectRegistry;
+    identity?: AutoCommitOptions['identity'];
+    locale?: Locale;
+}
+export interface WriteLayoutSourceResult extends LayoutSourceDocument {
+    committed: boolean;
+}
+/** working-tree path under the project for a layout address */
+export declare function layoutPathOf(addr: LayoutAddress): string;
+export declare function readLayoutSource(projectDir: string, addr: LayoutAddress): Promise<LayoutSourceDocument | null>;
+/** throw the first layout validation issue as a localized SchemaError */
+export declare function throwLayoutIssues(issues: LayoutIssue[], locale?: Locale): void;
+/** listable (flat) field names per object — drives `columns` validation */
+export declare function listableFieldsOf(registry: ObjectRegistry): (object: string) => readonly string[] | undefined;
+/** validate a layout source for its address profile; throws the first issue */
+export declare function validateLayoutCandidate(options: {
+    addr: LayoutAddress;
+    source: string;
+    registry: ObjectRegistry;
+    locale?: Locale;
+}): void;
+export declare function writeLayoutSource(options: WriteLayoutSourceOptions): Promise<WriteLayoutSourceResult>;
+//# sourceMappingURL=layoutSource.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layoutSource.d.ts","sourceRoot":"","sources":["../../../src/runtime/git/layoutSource.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,cAAc,EAEd,KAAK,MAAM,EACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAKL,KAAK,aAAa,EAElB,KAAK,WAAW,EACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAIzD;;;;GAIG;AAEH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,CAAC,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAwB,SAAQ,oBAAoB;IACnE,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,+DAA+D;AAC/D,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAExD;AAED,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAEtC;AAED,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAI9E;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,cAAc,GACvB,CAAC,MAAM,EAAE,MAAM,KAAK,SAAS,MAAM,EAAE,GAAG,SAAS,CAQnD;AAED,+EAA+E;AAC/E,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAC/C,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,IAAI,CAsBP;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC,CAYlC"}

package/dist/runtime/git/layoutSource.js

@@ -0,0 +1,67 @@
+import { FIELD_TYPES, ObjectRegistry, SchemaError, } from '../../core/index.js';
+import { LAYOUT_PROFILES, layoutPagePath, layoutProfileFor, validateLayoutProfile, } from '../../layout-format.js';
+import { readSource, sourceVersion } from './sourceFile.js';
+import { runSourceTransaction } from './sourceTransaction.js';
+/** working-tree path under the project for a layout address */
+export function layoutPathOf(addr) {
+    return `pages/${layoutPagePath(addr)}.json`;
+}
+export async function readLayoutSource(projectDir, addr) {
+    return readSource(projectDir, layoutPathOf(addr));
+}
+/** throw the first layout validation issue as a localized SchemaError */
+export function throwLayoutIssues(issues, locale) {
+    if (issues.length === 0)
+        return;
+    const first = issues[0];
+    throw new SchemaError(first.key, { ...first.params, path: first.path }, locale);
+}
+/** listable (flat) field names per object — drives `columns` validation */
+export function listableFieldsOf(registry) {
+    return (object) => {
+        const def = registry.get(object);
+        if (def === undefined)
+            return undefined;
+        return def.fields
+            .filter((f) => f.type !== FIELD_TYPES.DETAILS && f.type !== FIELD_TYPES.MULTI_RELATION)
+            .map((f) => f.name);
+    };
+}
+/** validate a layout source for its address profile; throws the first issue */
+export function validateLayoutCandidate(options) {
+    const { addr, source, registry, locale } = options;
+    let parsed;
+    try {
+        parsed = JSON.parse(source);
+    }
+    catch {
+        throw new SchemaError('http.param.invalid', { param: 'layout' }, locale);
+    }
+    const profile = addr.kind === 'page-face'
+        ? addr.face === 'list'
+            ? LAYOUT_PROFILES.OBJECT_LIST
+            : addr.face === 'show'
+                ? LAYOUT_PROFILES.OBJECT_SHOW
+                : LAYOUT_PROFILES.CUSTOM
+        : layoutProfileFor(addr.kind, addr.kind === 'object' ? addr.view : undefined);
+    const objects = new Set(registry.list().map((o) => o.name));
+    const issues = validateLayoutProfile(parsed, profile, {
+        objects,
+        listableFields: listableFieldsOf(registry),
+    });
+    throwLayoutIssues(issues, locale);
+}
+export async function writeLayoutSource(options) {
+    const { projectDir, addr, source, expectVersion, force, registry, identity, locale } = options;
+    validateLayoutCandidate({ addr, source, registry, locale });
+    const result = await runSourceTransaction({
+        projectDir,
+        files: [{ path: layoutPathOf(addr), source, expectVersion }],
+        force,
+        identity,
+        locale,
+        message: `chore(layout): update ${layoutPagePath(addr)}`,
+    });
+    return { source, version: sourceVersion(source), committed: result.committed };
+}
+//# sourceMappingURL=layoutSource.js.map

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

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

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

@@ -0,0 +1,22 @@
+import { ObjectRegistry } from '../../core/index.js';
+import type { Locale, ObjectDefinition } from '../../core/index.js';
+export interface SchemaFile {
+    /** absolute path to the schema.json file */
+    path: string;
+    /** object name, derived from the parent directory name */
+    name: string;
+    /** sha256 hex digest of the raw file content */
+    contentHash: string;
+    /** validated object definition */
+    object: ObjectDefinition;
+}
+export interface LoadResult {
+    registry: ObjectRegistry;
+    files: SchemaFile[];
+}
+/** load and validate every `objects/<name>/schema.json` under a project root */
+export declare function loadSchemaDir(dir: string, options?: {
+    locale?: Locale;
+    allowedFieldTypes?: readonly string[];
+}): Promise<LoadResult>;
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/runtime/git/loader.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAA4B,MAAM,qBAAqB,CAAC;AAC/E,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEpE,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAuBD,gFAAgF;AAChF,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAO,GACvE,OAAO,CAAC,UAAU,CAAC,CA8BrB"}

package/dist/runtime/git/loader.js

@@ -0,0 +1,57 @@
+import { createHash } from 'node:crypto';
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { basename, dirname, join } from 'node:path';
+import { ObjectRegistry, SchemaError, parseSchema } from '../../core/index.js';
+function sha256(input) {
+    return createHash('sha256').update(input, 'utf8').digest('hex');
+}
+/**
+ * Directory layout: one object per directory — `objects/<name>/schema.json`.
+ * The parent directory name must equal the object name (`nameHint` check).
+ * Any other file under the tree (future workflow.json/script.ts) is ignored.
+ */
+async function collectSchemaFiles(dir, out) {
+    const entries = await readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const full = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            await collectSchemaFiles(full, out);
+        }
+        else if (entry.isFile() && entry.name === 'schema.json') {
+            out.push(full);
+        }
+    }
+}
+/** load and validate every `objects/<name>/schema.json` under a project root */
+export async function loadSchemaDir(dir, options = {}) {
+    const objectsDir = join(dir, 'objects');
+    let isDir = false;
+    try {
+        isDir = (await stat(objectsDir)).isDirectory();
+    }
+    catch {
+        isDir = false;
+    }
+    if (!isDir) {
+        throw new SchemaError('loader.dir.missing', { dir: objectsDir }, options.locale);
+    }
+    const paths = [];
+    await collectSchemaFiles(objectsDir, paths);
+    const registry = new ObjectRegistry();
+    const files = [];
+    for (const path of paths.sort()) {
+        const name = basename(dirname(path));
+        let raw;
+        try {
+            raw = await readFile(path, 'utf8');
+        }
+        catch {
+            throw new SchemaError('loader.file.read', { file: path }, options.locale);
+        }
+        const object = parseSchema(raw, { locale: options.locale, nameHint: name, allowedFieldTypes: options.allowedFieldTypes });
+        registry.register(object, { locale: options.locale, allowedFieldTypes: options.allowedFieldTypes });
+        files.push({ path, name, contentHash: sha256(raw), object });
+    }
+    return { registry, files };
+}
+//# sourceMappingURL=loader.js.map

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

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

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

@@ -0,0 +1,66 @@
+import { ObjectRegistry, type Locale } from '../../core/index.js';
+import { type LayoutFile, type ObjectLayoutView } from '../../layout-format.js';
+import type { AutoCommitOptions } from './autoCommit.js';
+/**
+ * Page catalog + custom-page lifecycle (SU-7c). Pages are first-class layout
+ * files; custom pages are menu pages living in **directories** (`pages/<id>/layout.json`
+ * — the whole page model is directory-based: object pages in `pages/<object>/show|list.layout.json`,
+ * custom pages in `pages/<id>/layout.json`, the shell stays flat `pages/app.layout.json`).
+ * References to a custom page live in the shell sidebar (`SidebarItem.page` PageRefs) —
+ * delete is blocked (409) while references exist; rename updates them atomically.
+ */
+export type PageSummary = {
+    kind: 'shell';
+    id: 'app';
+    path: string;
+} | {
+    kind: 'object';
+    id: string;
+    view: ObjectLayoutView;
+    path: string;
+} | {
+    kind: 'custom';
+    id: string;
+    path: string;
+};
+export declare function emptyCustomLayout(): LayoutFile;
+/** find sidebar references to a custom page (group label + item label) */
+export declare function findCustomPageRefs(shellSource: string | undefined, id: string): Array<{
+    group?: string;
+    item: string;
+}>;
+/** list every page (shell + object show/list + custom) — stable sort by path */
+export declare function listPages(projectDir: string, registry: ObjectRegistry): Promise<PageSummary[]>;
+export interface CreateCustomPageOptions {
+    projectDir: string;
+    registry: ObjectRegistry;
+    id: string;
+    source?: string;
+    identity?: AutoCommitOptions['identity'];
+    locale?: Locale;
+}
+export declare function createCustomPage(options: CreateCustomPageOptions): Promise<{
+    path: string;
+    version: string;
+}>;
+export interface DeleteCustomPageOptions {
+    projectDir: string;
+    id: string;
+    identity?: AutoCommitOptions['identity'];
+    locale?: Locale;
+}
+export declare function deleteCustomPage(options: DeleteCustomPageOptions): Promise<{
+    deleted: boolean;
+}>;
+export interface RenameCustomPageOptions {
+    projectDir: string;
+    id: string;
+    newId: string;
+    identity?: AutoCommitOptions['identity'];
+    locale?: Locale;
+}
+/** atomically rename a custom page: move the page directory + update shell PageRefs in one commit */
+export declare function renameCustomPage(options: RenameCustomPageOptions): Promise<{
+    path: string;
+}>;
+//# sourceMappingURL=pageCatalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pageCatalog.d.ts","sourceRoot":"","sources":["../../../src/runtime/git/pageCatalog.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAe,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,gBAAgB,EACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAUzD;;;;;;;GAOG;AAEH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACpE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,wBAAgB,iBAAiB,IAAI,UAAU,CAE9C;AAwBD,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,EAAE,EAAE,MAAM,GACT,KAAK,CAAC;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAYzC;AAUD,gFAAgF;AAChF,wBAAsB,SAAS,CAC7B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,EAAE,CAAC,CAgCxB;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,cAAc,CAAC;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAwB5C;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAgBtG;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qGAAqG;AACrG,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CA2C5F"}