@adminiumjs/engine 0.1.0-rc.1

package/dist/config-schema/envelope.js

@@ -0,0 +1,87 @@
+import { layoutItemSchema, pageLayoutSchema, queryDescriptorSchema } from '@adminium/widgets/page-config';
+import { z } from 'zod';
+/**
+ * The config envelope every stored config document uses (01-architecture.md
+ * §6.1, 07-meta-store.md §3.17). The envelope persists verbatim into
+ * `adminium_pages.config`; the stored version path the config-migration
+ * runner keys on is `config.v`.
+ */
+export const CONFIG_KINDS = ['page', 'dashboard', 'view', 'nav', 'manifest-module'];
+export const configKindSchema = z.enum(CONFIG_KINDS);
+/**
+ * Prefixed document id: `page_`/`view_`/`nav_` + slug or ULID suffix.
+ * Engine-generated ids carry ULID suffixes (`page_01HZX…`); hand-authored and
+ * seeded documents may use readable slugs (`page_customers`, per the §3.17
+ * examples), so the suffix alphabet is not restricted to Crockford base32.
+ */
+export const configIdPattern = /^(page|view|nav)_[A-Za-z0-9][A-Za-z0-9_-]*$/;
+const kebabCasePattern = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
+/** Nav placement block (01-architecture.md §6.1). */
+export const navConfigSchema = z.object({
+    group: z.string().min(1),
+    icon: z.string().min(1), // lucide-react icon name
+    order: z.number().int(),
+    slug: z.string().regex(kebabCasePattern, 'must be kebab-case').optional(),
+    badge: z.string().min(1).optional(),
+});
+const envelopeShape = z.object({
+    v: z.literal(1), // config schema version (integer, 01-architecture.md §8.2)
+    kind: configKindSchema,
+    id: z
+        .string()
+        .regex(configIdPattern, 'must be a prefixed document id (page_* / view_* / nav_*)'),
+    template: z.string().regex(kebabCasePattern, 'must be a kebab-case Registry id'),
+    title: z.object({ key: z.string().min(1), fallback: z.string().min(1) }),
+    // Data-scope defaults for widgets/bindings on this page.
+    source: z.object({
+        connectionId: z.string().nullable(),
+        table: z.string().nullable(), // "public.orders" — primary table for record pages
+    }),
+    nav: navConfigSchema,
+    access: z.object({ minRole: z.string().min(1), permissions: z.array(z.string()) }),
+    // Per-template body. Unknown fields are preserved on round-trip
+    // (forward compatibility, 01-architecture.md §6.2); per-template schemas
+    // live in @adminium/widgets/page-config and are applied by kind below.
+    // `config.templateVersion` (stamped by composeTemplate from the manifest) is
+    // ADVISORY-ONLY until the 04-T15 per-template migrations/ mechanism lands:
+    // nothing validates or migrates on it — the migration chain keys solely on
+    // the envelope `v` above, and stored pre-stamp documents render fine because
+    // layouts are self-contained. 04 §10's "version bumps let H5 migrate old
+    // configs deliberately" gets its enforcement surface with 04-T15.
+    config: z.record(z.string(), z.unknown()),
+});
+export const pageEnvelopeSchema = envelopeShape.superRefine((doc, ctx) => {
+    if (doc.kind !== 'dashboard')
+        return;
+    const layout = pageLayoutSchema.safeParse(doc.config['layout']);
+    if (layout.success)
+        return;
+    for (const issue of layout.error.issues) {
+        ctx.addIssue({
+            code: 'custom',
+            message: issue.message,
+            path: ['config', 'layout', ...issue.path],
+        });
+    }
+});
+/**
+ * A validated dashboard widget instance (01-architecture.md §6.1): a grid
+ * layout item whose `config.binding`, when present, must be a declarative
+ * query descriptor (04-widget-registry.md §5.1).
+ */
+export const widgetConfigSchema = layoutItemSchema.superRefine((item, ctx) => {
+    const binding = item.config['binding'];
+    if (binding === undefined)
+        return;
+    const descriptor = queryDescriptorSchema.safeParse(binding);
+    if (descriptor.success)
+        return;
+    for (const issue of descriptor.error.issues) {
+        ctx.addIssue({
+            code: 'custom',
+            message: issue.message,
+            path: ['config', 'binding', ...issue.path],
+        });
+    }
+});
+//# sourceMappingURL=envelope.js.map

package/dist/config-schema/envelope.js.map

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

package/dist/config-schema/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @adminium/engine/config — browser-safe subpath.
+ *
+ * The single validation authority for stored config documents: the envelope
+ * schema, nav/widget schemas, and the config-migration runner. Also
+ * re-exports the `@adminium/widgets/page-config` pure-Zod leaf so consumers
+ * (dashboard, manifest, server routes) have one import surface
+ * (07-meta-store.md §3.17). No node: imports anywhere in this directory —
+ * enforced by test/browser-safe.test.ts and the dependency-cruiser gate.
+ */
+export { CONFIG_KINDS, configIdPattern, configKindSchema, navConfigSchema, pageEnvelopeSchema, widgetConfigSchema, type ConfigKind, type NavConfig, type PageConfig, type PageEnvelope, type WidgetConfig, } from './envelope.js';
+export { CONFIG_VERSION, ConfigMigrationError, configMigrations, latestConfigVersion, runConfigMigrations, type ConfigDocument, type ConfigMigration, } from './migrations.js';
+export { DATA_SHAPES, aggregationSchema, bucketUnitSchema, dataShapeSchema, filterSchema, layoutItemSchema, pageLayoutSchema, queryDescriptorSchema, type Aggregation, type BucketUnit, type DataShape, type LayoutItem, type PageLayout, type QueryDescriptor, type QueryFilter, } from '@adminium/widgets/page-config';
+//# sourceMappingURL=index.d.ts.map

package/dist/config-schema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config-schema/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EACL,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,WAAW,GACjB,MAAM,+BAA+B,CAAC"}

package/dist/config-schema/index.js

@@ -0,0 +1,15 @@
+/**
+ * @adminium/engine/config — browser-safe subpath.
+ *
+ * The single validation authority for stored config documents: the envelope
+ * schema, nav/widget schemas, and the config-migration runner. Also
+ * re-exports the `@adminium/widgets/page-config` pure-Zod leaf so consumers
+ * (dashboard, manifest, server routes) have one import surface
+ * (07-meta-store.md §3.17). No node: imports anywhere in this directory —
+ * enforced by test/browser-safe.test.ts and the dependency-cruiser gate.
+ */
+export { CONFIG_KINDS, configIdPattern, configKindSchema, navConfigSchema, pageEnvelopeSchema, widgetConfigSchema, } from './envelope.js';
+export { CONFIG_VERSION, ConfigMigrationError, configMigrations, latestConfigVersion, runConfigMigrations, } from './migrations.js';
+// Assembled surface: the per-template leaf schemas (04-widget-registry.md §5.1, §6.1).
+export { DATA_SHAPES, aggregationSchema, bucketUnitSchema, dataShapeSchema, filterSchema, layoutItemSchema, pageLayoutSchema, queryDescriptorSchema, } from '@adminium/widgets/page-config';
+//# sourceMappingURL=index.js.map

package/dist/config-schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config-schema/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EACL,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GAMnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,GAGpB,MAAM,iBAAiB,CAAC;AACzB,uFAAuF;AACvF,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,GAQtB,MAAM,+BAA+B,CAAC"}

package/dist/config-schema/migrations.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Config-migration runner (01-architecture.md §8.2).
+ *
+ * Each migration is a pure function `(doc) => doc` upgrading one version
+ * step. The server runs the chain at boot and lazily on read; zip import
+ * replays the same path so old exports always upgrade, never silently drop.
+ *
+ * Browser-safe: no node: imports (this module ships in
+ * `@adminium/engine/config`).
+ */
+/** A stored config document: the envelope with its integer version at `v`. */
+export interface ConfigDocument {
+    v: number;
+    [key: string]: unknown;
+}
+export interface ConfigMigration {
+    /** Version this migration upgrades from. */
+    readonly from: number;
+    /** Version this migration produces (`from + 1` by convention). */
+    readonly to: number;
+    /** Pure upgrade function; must not rely on mutating its input. */
+    migrate(doc: ConfigDocument): ConfigDocument;
+}
+/** The current (latest) config schema version shipped with this build. */
+export declare const CONFIG_VERSION = 1;
+/**
+ * Registered migrations, ordered by `from`. Empty while v1 is current; the
+ * first real entry arrives with the v1→v2 bump.
+ */
+export declare const configMigrations: readonly ConfigMigration[];
+export declare class ConfigMigrationError extends Error {
+    readonly name = "ConfigMigrationError";
+}
+/** Latest version reachable through `migrations` (>= CONFIG_VERSION). */
+export declare function latestConfigVersion(migrations?: readonly ConfigMigration[]): number;
+/**
+ * Upgrades `doc.v` to the latest version by running the migration chain.
+ * Returns a new document — the input is never mutated. Throws
+ * `ConfigMigrationError` when the document has no usable version, is newer
+ * than this build understands (the boot downgrade guard's condition,
+ * 01-architecture.md §8.1), or a step in the chain is missing.
+ */
+export declare function runConfigMigrations(doc: unknown, migrations?: readonly ConfigMigration[]): ConfigDocument;
+//# sourceMappingURL=migrations.d.ts.map

package/dist/config-schema/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/config-schema/migrations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,8EAA8E;AAC9E,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,cAAc,CAAC;CAC9C;AAED,0EAA0E;AAC1E,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,eAAe,EAAO,CAAC;AAE/D,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,SAAkB,IAAI,0BAA0B;CACjD;AAED,yEAAyE;AACzE,wBAAgB,mBAAmB,CACjC,UAAU,GAAE,SAAS,eAAe,EAAqB,GACxD,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,OAAO,EACZ,UAAU,GAAE,SAAS,eAAe,EAAqB,GACxD,cAAc,CAuChB"}

package/dist/config-schema/migrations.js

@@ -0,0 +1,62 @@
+/**
+ * Config-migration runner (01-architecture.md §8.2).
+ *
+ * Each migration is a pure function `(doc) => doc` upgrading one version
+ * step. The server runs the chain at boot and lazily on read; zip import
+ * replays the same path so old exports always upgrade, never silently drop.
+ *
+ * Browser-safe: no node: imports (this module ships in
+ * `@adminium/engine/config`).
+ */
+/** The current (latest) config schema version shipped with this build. */
+export const CONFIG_VERSION = 1;
+/**
+ * Registered migrations, ordered by `from`. Empty while v1 is current; the
+ * first real entry arrives with the v1→v2 bump.
+ */
+export const configMigrations = [];
+export class ConfigMigrationError extends Error {
+    name = 'ConfigMigrationError';
+}
+/** Latest version reachable through `migrations` (>= CONFIG_VERSION). */
+export function latestConfigVersion(migrations = configMigrations) {
+    return migrations.reduce((max, m) => Math.max(max, m.to), CONFIG_VERSION);
+}
+/**
+ * Upgrades `doc.v` to the latest version by running the migration chain.
+ * Returns a new document — the input is never mutated. Throws
+ * `ConfigMigrationError` when the document has no usable version, is newer
+ * than this build understands (the boot downgrade guard's condition,
+ * 01-architecture.md §8.1), or a step in the chain is missing.
+ */
+export function runConfigMigrations(doc, migrations = configMigrations) {
+    if (typeof doc !== 'object' || doc === null || Array.isArray(doc)) {
+        throw new ConfigMigrationError('config document must be an object');
+    }
+    const version = doc['v'];
+    if (typeof version !== 'number' || !Number.isInteger(version) || version < 1) {
+        throw new ConfigMigrationError(`config document has no valid version at "v" (got ${JSON.stringify(version)})`);
+    }
+    const target = latestConfigVersion(migrations);
+    if (version > target) {
+        throw new ConfigMigrationError(`config document version ${String(version)} is newer than the latest supported version ` +
+            `${String(target)} — upgrade Adminium to open it`);
+    }
+    let current = { ...doc, v: version };
+    while (current.v < target) {
+        const from = current.v;
+        const step = migrations.find((m) => m.from === from);
+        if (!step) {
+            throw new ConfigMigrationError(`no config migration registered from version ${String(from)}`);
+        }
+        if (!Number.isInteger(step.to) || step.to <= step.from) {
+            throw new ConfigMigrationError(`invalid migration step v${String(step.from)}→v${String(step.to)}`);
+        }
+        // Clone before handing to the migration so a misbehaving (mutating)
+        // migration can never corrupt the caller's document.
+        const upgraded = step.migrate(structuredClone(current));
+        current = { ...upgraded, v: step.to };
+    }
+    return current;
+}
+//# sourceMappingURL=migrations.js.map

package/dist/config-schema/migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.js","sourceRoot":"","sources":["../../src/config-schema/migrations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAiBH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAEhC;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA+B,EAAE,CAAC;AAE/D,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC3B,IAAI,GAAG,sBAAsB,CAAC;CACjD;AAED,yEAAyE;AACzE,MAAM,UAAU,mBAAmB,CACjC,aAAyC,gBAAgB;IAEzD,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,cAAc,CAAC,CAAC;AAC5E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAAY,EACZ,aAAyC,gBAAgB;IAEzD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAClE,MAAM,IAAI,oBAAoB,CAAC,mCAAmC,CAAC,CAAC;IACtE,CAAC;IACD,MAAM,OAAO,GAAI,GAA+B,CAAC,GAAG,CAAC,CAAC;IACtD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAC7E,MAAM,IAAI,oBAAoB,CAC5B,oDAAoD,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAC/E,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAC/C,IAAI,OAAO,GAAG,MAAM,EAAE,CAAC;QACrB,MAAM,IAAI,oBAAoB,CAC5B,2BAA2B,MAAM,CAAC,OAAO,CAAC,8CAA8C;YACtF,GAAG,MAAM,CAAC,MAAM,CAAC,gCAAgC,CACpD,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,GAAG,EAAE,GAAI,GAA+B,EAAE,CAAC,EAAE,OAAO,EAAoB,CAAC;IACpF,OAAO,OAAO,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC;QACvB,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,oBAAoB,CAC5B,+CAA+C,MAAM,CAAC,IAAI,CAAC,EAAE,CAC9D,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACvD,MAAM,IAAI,oBAAoB,CAC5B,2BAA2B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CACnE,CAAC;QACJ,CAAC;QACD,oEAAoE;QACpE,qDAAqD;QACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;QACxD,OAAO,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;IACxC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/generate/archetype.d.ts

@@ -0,0 +1,76 @@
+/**
+ * The §14 page-archetype step — hooks **H1/H2/H4** of the auto-instantiation
+ * pipeline as the Engine drives them (04-widget-registry.md §8):
+ *
+ *   H1/H2  `emitCandidates` + `selectArchetype`  (`@adminium/widgets/generate`)
+ *   H4     `composeTemplate(templateId, candidates, ctx)` → the in-memory
+ *          intermediate, which THIS module wraps into the 01-architecture.md
+ *          §6.1 page envelope that `generatePages()` persists.
+ *
+ * research/widget-registry.md §15 step 3 in full: "Per table emit: `page-crud`
+ * always; **plus the highest-scoring archetype from §14 triggers**; plus KPI
+ * candidates and 2–4 chart candidates". `./crud.ts` + `./dashboard.ts` deliver
+ * the first and last clauses through the same leaf (`composeCrudBody`,
+ * `emitDomainDashboardCandidates`), fed by this module's adapter; this module
+ * adds the middle clause. Archetype pages are **purely additive** — a table
+ * that earns one keeps its `page-crud` unchanged, and a table that earns none
+ * loses nothing.
+ *
+ * WHERE THE RULES LIVE: in `@adminium/widgets`, not here — 04 §8 assigns the
+ * catalog and its triggers to the Registry ("so the catalog and its trigger
+ * logic never drift apart") and only the pipeline to the Engine. That package
+ * cannot see `TableModel`/`ClassifiedTable` (01 §2.3 forbids widgets → engine
+ * beyond the config leaf), so it declares the fields its rules read as its own
+ * structural contract and this module is the **adapter**: `toCandidateModel`
+ * below is the single place the two vocabularies meet, and it is compile-time
+ * checked against both.
+ */
+import { type ArchetypeSelection, type CandidateTableInput, type ComposeWarning, type WidgetCandidate } from '@adminium/widgets/generate';
+import { type ClassifiedTable } from '../classify/index.js';
+import type { DatabaseModel, TableModel } from '../schema-model.js';
+/**
+ * Adapt a classified model into the rules' input. `tables` is the *included*
+ * set (`settings.includedTables` has already been applied upstream, and system
+ * / join tables have already been split out) — the cross-table §14 triggers only
+ * ever pair tables that will actually get pages.
+ */
+export declare function toCandidateModel(model: DatabaseModel, tables: readonly TableModel[], classified: ReadonlyMap<string, ClassifiedTable>): CandidateTableInput[];
+export interface ArchetypeBuildContext {
+    connectionId: string;
+    /** Unique, already-claimed slug for this page. */
+    slug: string;
+    /**
+     * Explicit page id — the 06 §8.3 materialization path targets an existing
+     * `page_<sha30>` row. Defaults to `pageIdFor(connectionId, slug)`.
+     */
+    id?: string | undefined;
+    navOrder: number;
+    /** Live registry membership test, threaded to H1 and H4 (04 §10). */
+    isRegistered?: ((widgetId: string) => boolean) | undefined;
+}
+export interface ArchetypeBuildResult {
+    /**
+     * Unhashed, unvalidated envelope — `generatePages` stamps + validates it.
+     * `null` ⇔ composition failed (a `required` slot had no accepted candidate),
+     * the `buildDashboardEnvelope` → null + caller-records-a-warning idiom. The
+     * table simply keeps just its `page-crud`.
+     */
+    envelope: Record<string, unknown> | null;
+    warnings: readonly ComposeWarning[];
+}
+/** Compose one archetype page for a table and wrap it into the §6.1 envelope. */
+export declare function buildArchetypeEnvelope(table: TableModel, selection: ArchetypeSelection, candidates: readonly WidgetCandidate[], ctx: ArchetypeBuildContext): ArchetypeBuildResult;
+/**
+ * Compose one REQUESTED §14 archetype page — the 06-llm-assist.md §8.3
+ * materialization path: an accepted LLM template suggestion seeds a page row
+ * carrying only `{type, table, source: 'llm'}`, and the regeneration hook
+ * expands it here from the active snapshot. Nothing is scored — the template
+ * id was chosen upstream — but the candidates, the manifest and the
+ * required-slot failure mode are exactly the §15 pass's. Returns a null
+ * envelope when the table is missing/system/join or composition fails; the
+ * caller records a warning and the seed row stays as it was.
+ */
+export declare function composeRequestedArchetype(model: DatabaseModel, tableId: string, template: string, ctx: ArchetypeBuildContext): ArchetypeBuildResult;
+/** Slug for a table's archetype page, inside the {@link ID_SLUG_BUDGET}. */
+export declare function archetypeSlug(tableSlug: string, template: string): string;
+//# sourceMappingURL=archetype.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"archetype.d.ts","sourceRoot":"","sources":["../../src/generate/archetype.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAIL,KAAK,kBAAkB,EAGvB,KAAK,mBAAmB,EAExB,KAAK,cAAc,EAEnB,KAAK,eAAe,EACrB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,KAAK,EAAmB,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAqIrF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,SAAS,UAAU,EAAE,EAC7B,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,GAC/C,mBAAmB,EAAE,CAWvB;AAkBD,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,YAAY,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;CAC5D;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzC,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;CACrC;AAED,iFAAiF;AACjF,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,kBAAkB,EAC7B,UAAU,EAAE,SAAS,eAAe,EAAE,EACtC,GAAG,EAAE,qBAAqB,GACzB,oBAAoB,CAyCtB;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,qBAAqB,GACzB,oBAAoB,CA0BtB;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIzE"}

package/dist/generate/archetype.js

@@ -0,0 +1,250 @@
+/**
+ * The §14 page-archetype step — hooks **H1/H2/H4** of the auto-instantiation
+ * pipeline as the Engine drives them (04-widget-registry.md §8):
+ *
+ *   H1/H2  `emitCandidates` + `selectArchetype`  (`@adminium/widgets/generate`)
+ *   H4     `composeTemplate(templateId, candidates, ctx)` → the in-memory
+ *          intermediate, which THIS module wraps into the 01-architecture.md
+ *          §6.1 page envelope that `generatePages()` persists.
+ *
+ * research/widget-registry.md §15 step 3 in full: "Per table emit: `page-crud`
+ * always; **plus the highest-scoring archetype from §14 triggers**; plus KPI
+ * candidates and 2–4 chart candidates". `./crud.ts` + `./dashboard.ts` deliver
+ * the first and last clauses through the same leaf (`composeCrudBody`,
+ * `emitDomainDashboardCandidates`), fed by this module's adapter; this module
+ * adds the middle clause. Archetype pages are **purely additive** — a table
+ * that earns one keeps its `page-crud` unchanged, and a table that earns none
+ * loses nothing.
+ *
+ * WHERE THE RULES LIVE: in `@adminium/widgets`, not here — 04 §8 assigns the
+ * catalog and its triggers to the Registry ("so the catalog and its trigger
+ * logic never drift apart") and only the pipeline to the Engine. That package
+ * cannot see `TableModel`/`ClassifiedTable` (01 §2.3 forbids widgets → engine
+ * beyond the config leaf), so it declares the fields its rules read as its own
+ * structural contract and this module is the **adapter**: `toCandidateModel`
+ * below is the single place the two vocabularies meet, and it is compile-time
+ * checked against both.
+ */
+import { composeTemplate, emitCandidates, isRegisteredWidgetId, } from '@adminium/widgets/generate';
+import { classifyModel } from '../classify/index.js';
+import { ID_SLUG_BUDGET, humanize, pageIdFor } from './util.js';
+const ARCHETYPE_NAV = {
+    'page-board': { group: 'planning', icon: 'kanban-square', slugSuffix: 'board' },
+    'page-calendar': { group: 'planning', icon: 'calendar', slugSuffix: 'calendar' },
+    'page-scheduler': { group: 'planning', icon: 'calendar-clock', slugSuffix: 'schedule' },
+    'page-directory': { group: 'people', icon: 'users', slugSuffix: 'directory' },
+    'page-chat': { group: 'people', icon: 'message-square', slugSuffix: 'chat' },
+    'page-queue-inbox': { group: 'workspace', icon: 'inbox', slugSuffix: 'queue' },
+    'page-log-viewer': { group: 'library', icon: 'scroll-text', slugSuffix: 'log' },
+    'page-files': { group: 'library', icon: 'folder', slugSuffix: 'files' },
+    'page-master-detail': { group: 'library', icon: 'layout-list', slugSuffix: 'detail' },
+};
+/** Human-readable page-title suffix per archetype. */
+const ARCHETYPE_TITLE = {
+    'page-board': 'Board',
+    'page-calendar': 'Calendar',
+    'page-scheduler': 'Schedule',
+    'page-directory': 'Directory',
+    'page-chat': 'Chat',
+    'page-queue-inbox': 'Queue',
+    'page-log-viewer': 'Log',
+    'page-files': 'Files',
+    'page-master-detail': 'Detail',
+};
+/**
+ * Archetype slugs are built inside `pageIdFor`'s slug budget (`./util.ts`) so the
+ * page id stays a readable 1:1 image of the (unique) slug rather than the
+ * digest-suffixed form an over-budget slug earns. Either way the id is unique —
+ * `pageIdFor` is injective — but a nav-visible archetype page reads better as
+ * `page_<scope>_orders-board` than `page_<scope>_orders-bo-1f4c9ab2`.
+ */
+/* ---------------------------------------------------------------- adapter */
+/** Resolve a column's enum values (the rules match on the value vocabulary). */
+function enumValuesFor(model, column) {
+    if (column.enumRef === null)
+        return undefined;
+    return model.enums.find((e) => e.id === column.enumRef)?.values;
+}
+/**
+ * `TableModel` → the rules' structural table contract. Beyond what the §14
+ * triggers read, the mirror carries the crud-body facts (`ordinal`,
+ * `defaultKind`, `isGenerated`, `maxLength`, `primaryKey`) — `composeCrudBody`
+ * reproduces the bespoke builder byte-for-byte only when these map exactly
+ * (undefined ⇔ the engine's null for `enumValues`; `default?.kind ?? null`).
+ */
+function toCandidateTable(model, table) {
+    const activity = table.activity;
+    return {
+        id: table.id,
+        schema: table.schema,
+        name: table.name,
+        label: table.label,
+        kind: table.kind,
+        rowCountEstimate: table.rowCountEstimate,
+        writeVelocity: activity === null ? null : activity.inserts + activity.updates + activity.deletes,
+        primaryKey: table.primaryKey,
+        columns: table.columns.map((column) => ({
+            name: column.name,
+            ordinal: column.ordinal,
+            logicalType: column.logicalType,
+            nullable: column.nullable,
+            isPrimaryKey: column.isPrimaryKey,
+            isUnique: column.isUnique,
+            isGenerated: column.isGenerated,
+            defaultKind: column.default?.kind ?? null,
+            maxLength: column.maxLength,
+            enumValues: enumValuesFor(model, column),
+            references: column.references,
+        })),
+    };
+}
+/**
+ * `ClassifiedTable` → the rules' structural classification contract.
+ *
+ * SEMANTIC SOURCE (05 §7 "overrides always win"): recomputed heuristics are
+ * authoritative for the model *as generated* — post `includedTables` filtering,
+ * a join table whose partner is excluded genuinely stops being a join table,
+ * and its columns reclassify on the filtered model (deliberate change from the
+ * bespoke dashboard builder, which read full-model stamps). But a column
+ * stamped `source: 'llm' | 'override'` is an explicit enrichment, not a
+ * heuristic, so it beats the recomputed tag — the same rule
+ * `applyClassification` uses when stamping the model. Table semantics carry no
+ * `source`, so roles stay recomputed-only.
+ */
+function toClassifiedInput(table, classified) {
+    const stampedByName = new Map(table.columns.map((c) => [c.name, c.semantics]));
+    const semanticsFor = (column, recomputed) => {
+        const stamped = stampedByName.get(column);
+        return stamped !== null && stamped !== undefined && stamped.source !== 'heuristic'
+            ? stamped
+            : recomputed;
+    };
+    return {
+        tableId: classified.tableId,
+        shape: classified.shape.kind,
+        role: classified.semantics.role,
+        displayColumn: classified.displayColumn,
+        naturalKey: classified.naturalKey,
+        hierarchyColumn: classified.semantics.hierarchy?.parentColumn ?? null,
+        columns: classified.columns.map((column) => {
+            const semantics = semanticsFor(column.column, column.semantics);
+            return {
+                column: column.column,
+                semantic: semantics.primary,
+                format: semantics.format,
+                secret: semantics.flags.secret,
+                pii: semantics.flags.pii,
+                maskedByDefault: semantics.flags.maskedByDefault,
+                pair: semantics.pair,
+            };
+        }),
+    };
+}
+/**
+ * Adapt a classified model into the rules' input. `tables` is the *included*
+ * set (`settings.includedTables` has already been applied upstream, and system
+ * / join tables have already been split out) — the cross-table §14 triggers only
+ * ever pair tables that will actually get pages.
+ */
+export function toCandidateModel(model, tables, classified) {
+    const out = [];
+    for (const table of tables) {
+        const info = classified.get(table.id);
+        if (info === undefined)
+            continue;
+        out.push({
+            table: toCandidateTable(model, table),
+            classified: toClassifiedInput(table, info),
+        });
+    }
+    return out;
+}
+/**
+ * A candidate as `composeTemplate` takes it: the binding moves inside `config`,
+ * which is where the stored layout item carries it (01 §6.1 / 04 §5.1 — exactly
+ * as `buildDashboardEnvelope` writes it today).
+ */
+function toTemplateCandidate(candidate) {
+    return {
+        widget: candidate.widget,
+        shape: candidate.shape,
+        score: candidate.score,
+        config: { ...candidate.config, binding: candidate.binding },
+    };
+}
+/** Compose one archetype page for a table and wrap it into the §6.1 envelope. */
+export function buildArchetypeEnvelope(table, selection, candidates, ctx) {
+    const nav = ARCHETYPE_NAV[selection.template];
+    if (nav === undefined) {
+        // Unreachable via `selectArchetype` (its ids are a subset of ARCHETYPE_NAV's,
+        // asserted by generate-archetypes.test.ts) — a marketplace template reaching
+        // here would have no nav placement, so it gets no page rather than a bad one.
+        return { envelope: null, warnings: [] };
+    }
+    const composed = composeTemplate(selection.template, candidates.map(toTemplateCandidate), ctx.isRegistered === undefined ? {} : { isRegistered: ctx.isRegistered });
+    if (composed.page === null)
+        return { envelope: null, warnings: composed.warnings };
+    const suffix = ARCHETYPE_TITLE[selection.template] ?? 'Page';
+    const title = `${table.label ?? humanize(table.name)} ${suffix}`;
+    return {
+        warnings: composed.warnings,
+        envelope: {
+            v: 1,
+            kind: composed.page.type,
+            id: ctx.id ?? pageIdFor(ctx.connectionId, ctx.slug),
+            template: composed.page.template,
+            title: { key: `nav.${ctx.slug}`, fallback: title },
+            source: { connectionId: ctx.connectionId, table: table.id },
+            nav: { group: nav.group, icon: nav.icon, order: ctx.navOrder, slug: ctx.slug },
+            access: { minRole: 'viewer', permissions: [`table:${table.id}:read`] },
+            config: {
+                templateVersion: composed.page.templateVersion,
+                toolbar: composed.page.toolbar,
+                overlays: composed.page.overlays,
+                // Why this table earned this template — the Studio "why this page?"
+                // panel and the H3 LLM prompt read it back off the stored document.
+                archetype: { score: selection.score, reasons: selection.reasons },
+                layout: composed.page.layout,
+            },
+        },
+    };
+}
+/**
+ * Compose one REQUESTED §14 archetype page — the 06-llm-assist.md §8.3
+ * materialization path: an accepted LLM template suggestion seeds a page row
+ * carrying only `{type, table, source: 'llm'}`, and the regeneration hook
+ * expands it here from the active snapshot. Nothing is scored — the template
+ * id was chosen upstream — but the candidates, the manifest and the
+ * required-slot failure mode are exactly the §15 pass's. Returns a null
+ * envelope when the table is missing/system/join or composition fails; the
+ * caller records a warning and the seed row stays as it was.
+ */
+export function composeRequestedArchetype(model, tableId, template, ctx) {
+    const classified = new Map(classifyModel(model).tables.map((t) => [t.tableId, t]));
+    // The same include rule as generatePages' splitTables: system and join
+    // tables never earn a page (05 §8.2).
+    const tables = [...model.tables]
+        .filter((table) => {
+        const role = classified.get(table.id)?.semantics.role ?? table.semantics?.role ?? 'entity';
+        return !table.system && role !== 'system' && role !== 'join-table';
+    })
+        .sort((a, b) => a.id.localeCompare(b.id));
+    const table = tables.find((t) => t.id === tableId);
+    if (table === undefined)
+        return { envelope: null, warnings: [] };
+    const isRegistered = ctx.isRegistered ?? isRegisteredWidgetId;
+    const candidateModel = toCandidateModel(model, tables, classified);
+    const entry = candidateModel.find((e) => e.table.id === tableId);
+    if (entry === undefined)
+        return { envelope: null, warnings: [] };
+    const candidateCtx = { connectionId: ctx.connectionId, model: candidateModel, isRegistered };
+    const candidates = emitCandidates(entry.table, entry.classified, candidateCtx);
+    return buildArchetypeEnvelope(table, { template, score: 0, reasons: ['accepted LLM suggestion (06 §8.3)'] }, candidates, { ...ctx, isRegistered });
+}
+/** Slug for a table's archetype page, inside the {@link ID_SLUG_BUDGET}. */
+export function archetypeSlug(tableSlug, template) {
+    const suffix = ARCHETYPE_NAV[template]?.slugSuffix ?? 'page';
+    const head = tableSlug.slice(0, Math.max(1, ID_SLUG_BUDGET - suffix.length - 1));
+    return `${head.replace(/-+$/, '')}-${suffix}`;
+}
+//# sourceMappingURL=archetype.js.map

package/dist/generate/archetype.js.map

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

package/dist/generate/crud.d.ts

@@ -0,0 +1,36 @@
+/**
+ * `page-crud` envelope generation — one per included table (research/
+ * widget-registry.md §14: "Every included table"; 01-architecture.md §6.1
+ * fixes the config body shape: `columns[]`, `defaultSort`, `pageSize`,
+ * `detail`).
+ *
+ * The body vocabulary — column selection, tones, form-field mapping — lives in
+ * `@adminium/widgets/generate` (`composeCrudBody`; 04 §8: the Registry owns
+ * what a generated page contains). This module keeps only what the leaf cannot
+ * know: slug/id allocation, nav placement, and the §6.1 envelope wrap. Inputs
+ * arrive pre-adapted through `./archetype.ts`'s `toCandidateModel` — the single
+ * place the engine and registry vocabularies meet.
+ */
+import { type CandidateRelation, type CandidateTableInput } from '@adminium/widgets/generate';
+/**
+ * The §7.1 rule-7 tone map moved into the leaf with the rest of the body
+ * vocabulary; re-exported because the generate surface is public API of the
+ * self-host package (`@adminium/engine` root re-exports this module).
+ */
+export { enumTones, type CrudEnumTone } from '@adminium/widgets/generate';
+export interface CrudBuildContext {
+    connectionId: string | null;
+    slug: string;
+    navGroup: 'workspace' | 'library' | 'planning' | 'people' | 'account';
+    navIcon: string;
+    navOrder: number;
+    /** read-only-analytics intent, no-PK tables, and views render read-only. */
+    readOnly: boolean;
+    /** Tables included in this generation run (detail tabs only link these). */
+    includedTableIds: ReadonlySet<string>;
+    /** Every model relation — the leaf derives detail tabs from the inbound ones. */
+    relations: readonly CandidateRelation[];
+}
+/** Build the (unhashed, unvalidated) `page-crud` envelope for one table. */
+export declare function buildCrudEnvelope(entry: CandidateTableInput, ctx: CrudBuildContext): Record<string, unknown>;
+//# sourceMappingURL=crud.d.ts.map