@adminiumjs/llm 0.1.0-rc.1

package/dist/prompt/serializer.js

@@ -0,0 +1,178 @@
+/** Text columns with `distinctCount` at or below this are pseudo-enum candidates (§4.2). */
+export const PSEUDO_ENUM_MAX_DISTINCT = 24;
+/** Header line the opt-in sampling block leads with (§5.2 builder note). */
+export const SAMPLING_BLOCK_HEADER = '=== INPUT: SAMPLE VALUES (user opted in; PII columns excluded) ===';
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+/** Compact, deterministic JSON for injection into the prompt. */
+export function toPromptJson(value) {
+    return JSON.stringify(value);
+}
+/** `TableRef` → the model's qualified `"schema.table"` id (mysql/sqlite have a null schema). */
+export function qualifyTableRef(ref, defaultSchema) {
+    return `${ref.schema ?? defaultSchema}.${ref.name}`;
+}
+function statsKey(tableId, column) {
+    return `${tableId}\x00${column}`;
+}
+/** `(tableId, column) → distinctCount | null`, built from the stats. */
+function distinctCountLookup(stats, defaultSchema) {
+    const map = new Map();
+    for (const result of stats) {
+        const tableId = qualifyTableRef(result.table, defaultSchema);
+        for (const column of result.columns) {
+            map.set(statsKey(tableId, column.column), column.distinctCount);
+        }
+    }
+    return (tableId, column) => map.get(statsKey(tableId, column)) ?? null;
+}
+/** `(tableId, column) → true` for PII-suspected or secret columns (never sampled). */
+function sensitiveColumnLookup(model) {
+    const set = new Set();
+    for (const table of model.tables) {
+        for (const column of table.columns) {
+            if (isPiiSuspected(column) || isSecret(column)) {
+                set.add(statsKey(table.id, column.name));
+            }
+        }
+    }
+    return (tableId, column) => set.has(statsKey(tableId, column));
+}
+function isPiiSuspected(column) {
+    return (column.semantics?.flags.pii ?? null) !== null;
+}
+function isSecret(column) {
+    return column.semantics?.flags.secret ?? false;
+}
+export function serializeSchemaIr(model, options = {}) {
+    const stubs = options.stubTables ?? new Set();
+    const distinctCount = distinctCountLookup(options.stats ?? [], model.defaultSchema);
+    const enumValues = new Map(model.enums.map((def) => [def.id, def.values]));
+    const tables = model.tables.map((table) => {
+        if (stubs.has(table.id)) {
+            return { table: table.id, stub: true, columns: table.columns.map((c) => c.name) };
+        }
+        const role = table.semantics?.role;
+        return {
+            table: table.id,
+            ...(role !== undefined ? { role } : {}),
+            columns: table.columns.map((column) => serializeColumn(column, distinctCount(table.id, column.name))),
+        };
+    });
+    const enumColumns = [];
+    for (const table of model.tables) {
+        if (stubs.has(table.id))
+            continue;
+        for (const column of table.columns) {
+            if (column.enumRef === null)
+                continue;
+            const values = enumValues.get(column.enumRef);
+            if (values === undefined)
+                continue;
+            enumColumns.push({ table: table.id, column: column.name, values: [...values] });
+        }
+    }
+    const declaredRelations = model.relations
+        .filter((relation) => relation.kind === 'declared-fk')
+        .map((relation) => ({
+        fromTable: relation.from.tableId,
+        fromColumns: [...relation.from.columns],
+        toTable: relation.to.tableId,
+        toColumns: [...relation.to.columns],
+        cardinality: relation.cardinality,
+    }));
+    return {
+        database: { name: model.name, dialect: model.dialect, defaultSchema: model.defaultSchema },
+        tables,
+        enumColumns,
+        declaredRelations,
+    };
+}
+function serializeColumn(column, distinctCount) {
+    const pii = isPiiSuspected(column);
+    const secret = isSecret(column);
+    const isText = column.logicalType === 'text' || column.logicalType === 'varchar';
+    const pseudoEnum = isText &&
+        !pii &&
+        !secret &&
+        column.enumRef === null &&
+        distinctCount !== null &&
+        distinctCount <= PSEUDO_ENUM_MAX_DISTINCT;
+    return {
+        column: column.name,
+        type: column.logicalType,
+        nullable: column.nullable,
+        ...(column.isPrimaryKey ? { primaryKey: true } : {}),
+        ...(column.isUnique ? { unique: true } : {}),
+        ...(column.enumRef !== null ? { enum: column.enumRef } : {}),
+        ...(column.references !== null
+            ? { references: `${column.references.tableId}.${column.references.column}` }
+            : {}),
+        ...(pii ? { piiSuspected: true } : {}),
+        ...(secret ? { secret: true } : {}),
+        ...(pseudoEnum ? { pseudoEnumCandidate: true } : {}),
+    };
+}
+/**
+ * Format `StatsResult[]` into the aggregates-only stats block. Deliberately
+ * copies ONLY row counts, null fractions and distinct counts — never `min`,
+ * `max` or `sampleValues`, which are cell values and belong to the opt-in
+ * sampling block. This is what guarantees the sample-free default at the stats
+ * layer regardless of what the adapter happened to collect.
+ */
+export function serializeStats(stats, options = {}) {
+    const defaultSchema = options.defaultSchema ?? 'public';
+    return {
+        tables: stats.map((result) => ({
+            table: qualifyTableRef(result.table, defaultSchema),
+            rowCountEstimate: result.rowCountEstimate,
+            rowCountExact: result.rowCountExact,
+            columns: result.columns.map((column) => ({
+                column: column.column,
+                nullFraction: column.nullFraction,
+                distinctCount: column.distinctCount,
+            })),
+        })),
+    };
+}
+// ─── Sampling block (opt-in; the ONLY place cell values appear) ──────────────
+/**
+ * Build the `{{SAMPLING_BLOCK}}` text. Returns `''` when `sampling` is null
+ * (sample-free default). When opted in, renders the header plus a JSON object of
+ * per-column `min`/`max`/`sampleValues` — EXCLUDING every PII-suspected or
+ * secret column (looked up from the model), and truncating each column's value
+ * list to `sampling.maxValuesPerColumn`.
+ */
+export function serializeSampling(model, stats, sampling) {
+    if (sampling === null)
+        return '';
+    const payload = serializeSamplingPayload(model, stats, sampling.maxValuesPerColumn);
+    return `${SAMPLING_BLOCK_HEADER}\n${toPromptJson(payload)}`;
+}
+export function serializeSamplingPayload(model, stats, maxValuesPerColumn) {
+    const isSensitive = sensitiveColumnLookup(model);
+    const tables = [];
+    for (const result of stats) {
+        const tableId = qualifyTableRef(result.table, model.defaultSchema);
+        const columns = [];
+        for (const column of result.columns) {
+            if (isSensitive(tableId, column.column))
+                continue;
+            const hasMin = column.min !== undefined;
+            const hasMax = column.max !== undefined;
+            const values = column.sampleValues;
+            const hasValues = values !== undefined && values.length > 0;
+            if (!hasMin && !hasMax && !hasValues)
+                continue;
+            columns.push({
+                column: column.column,
+                ...(hasMin ? { min: column.min } : {}),
+                ...(hasMax ? { max: column.max } : {}),
+                ...(hasValues ? { sampleValues: values.slice(0, maxValuesPerColumn) } : {}),
+            });
+        }
+        if (columns.length > 0)
+            tables.push({ table: tableId, columns });
+    }
+    return { tables };
+}
+//# sourceMappingURL=serializer.js.map

package/dist/prompt/serializer.js.map

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

package/dist/prompt/templates/v1.d.ts

@@ -0,0 +1,41 @@
+/**
+ * §5.1 — the system section. Fixed policy text (no tokens); it frames the task,
+ * the quality bar and the STRICT output rules. Reused verbatim by
+ * {@link PROMPT_MERGE_V1} (§4.5).
+ */
+export declare const PROMPT_V1_SYSTEM = "You are a senior data architect and admin-interface designer. You work for\nAdminium, an engine that introspects a relational database schema and\nauto-generates a complete admin dashboard from it. A heuristic pipeline has\nalready produced a baseline; your judgment refines it. Your output is machine-\napplied: it will be schema-validated, cross-checked against the real database\nschema, and reviewed by a human as a diff before anything is applied.\n\nTASK\nAnalyze the database schema and statistics provided in the user message and\nreturn enrichment decisions as a single JSON object, following the response\nschema and the decision instructions exactly.\n\nQUALITY BAR\n- Domain understanding first: infer what the business behind this schema does\n  from table/column names, types, relations and statistics, and make every\n  label, grouping and recommendation read like it was written by an expert in\n  that domain \u2014 not like it was mechanically derived from identifiers.\n- Labels are for non-technical staff: \"Purchase orders\", never \"tbl_po_hdr\".\n  Descriptions are one sentence, concrete, and state what a row represents.\n- Translations must be native-quality, using the domain's standard terminology\n  in each language, and consistent across the whole response (the same concept\n  gets the same term everywhere). Do not transliterate; translate.\n- Be decisive but honest: every suggestion carries a \"confidence\" between 0.0\n  and 1.0. Prefer a lower confidence over inventing detail. If the input gives\n  no basis for a decision, omit that suggestion entirely.\n- Ground every recommendation in evidence from the input (name patterns, types,\n  cardinalities, null ratios, relation shapes). \"reason\" fields must cite that\n  evidence in one short sentence.\n\nOUTPUT RULES \u2014 STRICT\n1. Respond with EXACTLY ONE JSON object and nothing else. No prose, no markdown,\n   no code fences, no comments, no trailing commas. The first character of your\n   response must be \"{\" and the last must be \"}\".\n2. The first key must be \"schema_version\" with the exact value\n   \"adminium.llm/v1\".\n3. Reference ONLY tables and columns that appear in the input schema. Never\n   invent, rename, pluralize or \"correct\" an identifier. Tables marked\n   \"stub\": true are context only \u2014 emit no suggestions for them.\n4. Use only the allowed page-template ids, widget ids, tone values and masking\n   values listed in the user message. Icon names must be kebab-case lucide\n   icon names (e.g. \"shopping-cart\", \"users\", \"package\").\n5. Localized text objects must contain exactly the requested locale keys \u2014\n   no more, no fewer. \"en_US\" is always required.\n6. Numbers for \"confidence\" use at most 2 decimal places. Keep all \"reason\"\n   fields under 200 characters.\n7. If you cannot comply with any rule, return\n   {\"schema_version\":\"adminium.llm/v1\",\"error\":\"<one-sentence reason>\"} and\n   nothing else.";
+/**
+ * §5.2 — the user section template. Carries the `{{DOUBLE_BRACE}}` tokens the
+ * builder fills: run id, chunk info, requested-sections list, the allowed
+ * vocabularies, target locales, and the serialized schema IR / statistics /
+ * (opt-in) sample-values blocks. The ten numbered decision blocks map 1:1 to
+ * {@link RequestedSection} ids; the builder deletes deselected blocks (§4.4).
+ */
+export declare const PROMPT_V1_USER = "=== CONTEXT ===\nAdminium generated an admin dashboard for the database described below. Your\ndecisions refine: naming, navigation, enum semantics, relations, key columns,\npage layouts, dashboard widgets, privacy flags, icons and micro-copy.\nrun_id: {{RUN_ID}} (echo it back as \"run_id\" if convenient; optional)\n{{CHUNK_INFO}}\n\n=== YOUR DECISIONS ===\nProduce the following, per the response schema at the end of this message.\n{{REQUESTED_SECTIONS_LIST}}\n\n1. LABELS & DESCRIPTIONS (response: tables[].label, tables[].description,\n   tables[].columns[].label, tables[].columns[].description)\n   For every non-stub table and every column: a short human label (Title Case\n   for tables, Sentence case for columns; \u2264 28 chars for tables, \u2264 24 for\n   columns) and a one-sentence description. Localize both into every requested\n   locale. Column descriptions are optional for self-explanatory columns\n   (id, created_at) \u2014 omit rather than pad.\n\n2. DOMAIN GROUPING (response: navGroups)\n   Group all tables into 3\u20137 navigation groups that reflect business domains\n   (e.g. \"Sales\", \"Catalog\", \"People\"), not technical layers. Every non-stub\n   table appears in exactly one group. Order groups by operational importance;\n   order tables within a group the same way. Give each group a localized label\n   and a lucide icon.\n\n3. ENUM SEMANTICS (response: enums) \u2014 for every column listed under\n   \"enumColumns\" in the input:\n   - kind: \"workflow\" if values are states a record moves through over time\n     (e.g. draft \u2192 active \u2192 closed); \"category\" if values are unordered\n     classifications (e.g. region, plan tier).\n   - order: for workflow enums, the full value list in lifecycle order\n     (must be a permutation of the given values). null for category enums.\n   - tones: map EVERY value to exactly one of:\n     \"pos\" (successfully completed / healthy), \"warn\" (needs attention /\n     pending / at risk), \"danger\" (failed / blocked / cancelled),\n     \"accent\" (actively in progress), \"muted\" (inactive / draft / neutral).\n   - terminal: for workflow enums, the values that end the lifecycle.\n\n4. RELATIONS (response: relations)\n   - confirmed: for each relation under \"declaredRelations\" in the input,\n     state whether it is semantically what it looks like, and name the\n     relationship (e.g. \"orders belong to customers\").\n   - inferred: relations that SHOULD exist but are not declared as foreign\n     keys. Use naming conventions (customer_id \u2192 customers.id), matching\n     types, and statistics (a column whose distinctCount \u2248 another table's\n     rowCountEstimate is a strong signal). Give kind\n     (\"many-to-one\" | \"one-to-one\" | \"many-to-many-via\"), evidence, and\n     confidence. Never re-state a declared relation as inferred.\n\n5. KEY COLUMNS (response: tables[].displayColumn, tables[].naturalKey)\n   - displayColumn: the single column whose value best represents a row to a\n     human (a name/title/number \u2014 never a UUID/serial id). null only if truly\n     nothing qualifies.\n   - naturalKey: minimal column set a human would use to uniquely identify a\n     row (e.g. [\"sku\"], [\"email\"], [\"order_number\"]). null if none.\n\n6. PAGE TEMPLATES (response: tables[].pageTemplates)\n   Recommend 1\u20133 page templates per table from ALLOWED PAGE TEMPLATES below,\n   ranked. \"page-crud\" is always generated and must not be recommended.\n   For each: cite which trigger(s) from the taxonomy fired (\"triggers\"), and\n   give a one-sentence reason grounded in this schema. Do not recommend a\n   template whose trigger conditions this table does not meet.\n\n7. DASHBOARD WIDGETS (response: dashboards)\n   Propose up to 6 dashboards, one per major domain (aligned with your nav\n   groups). For each, rank up to 8 widgets from ALLOWED WIDGETS below. Every\n   widget binds to real columns: metric column (numeric), dimension/group-by\n   column, time column where applicable, and an aggregation\n   (\"count\" | \"sum\" | \"avg\" | \"min\" | \"max\"). Spans on a 12-column grid:\n   KPI = 3, donut/funnel = 4, bar/table = 6, line/area = 8.\n\n8. PII & MASKING (response: tables[].columns[].pii)\n   Flag every column plausibly containing personal or sensitive data.\n   kind: one of \"email\" | \"phone\" | \"name\" | \"address\" | \"gov-id\" | \"dob\" |\n   \"financial\" | \"credentials\" | \"health\" | \"ip\" | \"location\" | \"other\".\n   masking: one of \"mask-email\" (j***@d***.com) | \"mask-partial\" (first/last\n   char visible) | \"last4\" | \"redact\" (fully hidden) | \"hash\" | \"none\"\n   (flag only). Columns already marked \"piiSuspected\": true in the input were\n   flagged by heuristics \u2014 confirm or reject them explicitly (pii: null means\n   explicitly not PII).\n\n9. ICONS (response: tables[].icon, navGroups[].icon)\n   One lucide icon per table and per nav group, kebab-case (e.g. \"users\",\n   \"shopping-cart\", \"package\", \"receipt\", \"calendar\", \"building-2\",\n   \"credit-card\", \"truck\", \"message-square\", \"file-text\"). Choose the most\n   domain-specific icon; avoid reusing one icon for multiple tables in the\n   same group.\n\n10. MICRO-COPY (response: tables[].microcopy)\n    Localized, per table:\n    - emptyState.headline (\u2264 40 chars) and emptyState.guidance (one sentence,\n      ends with what to do first) \u2014 shown when the table has no rows.\n    - pageSubtitle: \u2264 60 chars shown under the page title, describing what\n      the page manages (e.g. \"Track and fulfil customer orders\").\n    Tone: calm, concrete, no exclamation marks, no marketing language.\n\n=== TRIGGER TAXONOMY (for decision 6) ===\n| template id        | trigger conditions |\n|--------------------|--------------------|\n| page-dashboard     | numeric measure columns + a timestamp column exist in the domain |\n| page-master-detail | enum-heavy table with rich per-record detail (many columns / child conversation table) |\n| page-queue-inbox   | workflow enum with pending/approved-style states, or read/unread boolean, + assignee/requester FK |\n| page-board         | status enum classified \"workflow\"; optional second categorical column \u2192 swimlanes; period column \u2192 roadmap |\n| page-calendar      | date/datetime column + a title-like text column |\n| page-scheduler     | person FK \u00D7 date \u00D7 shift/type columns, or hours-per-project assignment shape |\n| page-directory     | people-shaped table: name + email (+ role/department enum, avatar) |\n| page-log-viewer    | append-only shape: timestamp + actor + action/level, high row count, few updates |\n| page-files         | file/attachment shape: filename/mime/size/url columns or parent-folder self-FK |\n| page-chat          | conversation + message table pair (thread FK, sender FK, body, timestamp) |\n(Templates not listed here \u2014 settings, wizard, builder, auth, billing, api,\nmarketing, system pages \u2014 are platform-owned; never recommend them for user\ntables.)\n\n=== ALLOWED PAGE TEMPLATES ===\n{{ALLOWED_PAGE_TEMPLATE_IDS_JSON}}\n\n=== ALLOWED WIDGETS ===\n{{ALLOWED_WIDGET_IDS_JSON}}\n\n=== TARGET LOCALES ===\n{{LOCALES_JSON}}\nEvery localized text object uses exactly these keys.\n\n=== RESPONSE SCHEMA (adminium.llm/v1) ===\nReturn one JSON object of this shape. TypeScript-style notation; \"?\" = may be\nomitted; L10n = { \"<locale>\": string } with exactly the target locales.\n\n{\n  schema_version: \"adminium.llm/v1\",        // REQUIRED, first key\n  run_id?: string,\n  tables: [{\n    table: string,                           // \"schema.table\", exactly as in input\n    confidence: number,                      // 0..1, overall for this table's suggestions\n    label: L10n, description: L10n,\n    icon: string,                            // lucide kebab-case\n    displayColumn: string | null,\n    naturalKey: string[] | null,\n    pageTemplates: [{ template: string, rank: number, triggers: string[],\n                      reason: string, confidence: number }],\n    microcopy: { emptyState: { headline: L10n, guidance: L10n },\n                 pageSubtitle: L10n },\n    columns: [{\n      column: string,\n      label: L10n, description?: L10n,\n      pii: null | { kind: string, masking: string, reason: string,\n                    confidence: number }\n    }]\n  }],\n  enums: [{ table: string, column: string, kind: \"workflow\" | \"category\",\n            order: string[] | null, terminal?: string[],\n            tones: { [value: string]: \"pos\"|\"warn\"|\"danger\"|\"accent\"|\"muted\" },\n            reason: string, confidence: number }],\n  relations: {\n    confirmed: [{ fromTable: string, fromColumns: string[], toTable: string,\n                  toColumns: string[], semantics: string, correct: boolean,\n                  confidence: number }],\n    inferred:  [{ fromTable: string, fromColumns: string[], toTable: string,\n                  toColumns: string[],\n                  kind: \"many-to-one\"|\"one-to-one\"|\"many-to-many-via\",\n                  viaTable?: string, evidence: string, confidence: number }]\n  },\n  navGroups: [{ id: string,                  // kebab-case slug\n                label: L10n, icon: string, order: number,\n                tables: string[], confidence: number }],\n  dashboards: [{ id: string, domain: string, label: L10n, order: number,\n                 tables: string[],\n                 widgets: [{ widget: string, rank: number, span: number,\n                             table: string, metricColumn?: string,\n                             dimensionColumn?: string, timeColumn?: string,\n                             agg?: \"count\"|\"sum\"|\"avg\"|\"min\"|\"max\",\n                             titleEn: string, reason: string,\n                             confidence: number }] }],\n  notes?: string[]                           // \u2264 5 short caveats about the schema\n}\n\n=== INPUT: DATABASE SCHEMA ===\n{{SCHEMA_IR_JSON}}\n\n=== INPUT: STATISTICS (aggregates only \u2014 no row data) ===\n{{STATS_JSON}}\n{{SAMPLING_BLOCK}}";
+/**
+ * The v1 prompt as a pair. The builder renders these into a
+ * {@link PromptArtifact}; nothing else should read the raw strings except the
+ * snapshot test.
+ */
+export declare const PROMPT_V1: {
+    readonly version: "adminium.prompt/v1.1";
+    readonly system: "You are a senior data architect and admin-interface designer. You work for\nAdminium, an engine that introspects a relational database schema and\nauto-generates a complete admin dashboard from it. A heuristic pipeline has\nalready produced a baseline; your judgment refines it. Your output is machine-\napplied: it will be schema-validated, cross-checked against the real database\nschema, and reviewed by a human as a diff before anything is applied.\n\nTASK\nAnalyze the database schema and statistics provided in the user message and\nreturn enrichment decisions as a single JSON object, following the response\nschema and the decision instructions exactly.\n\nQUALITY BAR\n- Domain understanding first: infer what the business behind this schema does\n  from table/column names, types, relations and statistics, and make every\n  label, grouping and recommendation read like it was written by an expert in\n  that domain — not like it was mechanically derived from identifiers.\n- Labels are for non-technical staff: \"Purchase orders\", never \"tbl_po_hdr\".\n  Descriptions are one sentence, concrete, and state what a row represents.\n- Translations must be native-quality, using the domain's standard terminology\n  in each language, and consistent across the whole response (the same concept\n  gets the same term everywhere). Do not transliterate; translate.\n- Be decisive but honest: every suggestion carries a \"confidence\" between 0.0\n  and 1.0. Prefer a lower confidence over inventing detail. If the input gives\n  no basis for a decision, omit that suggestion entirely.\n- Ground every recommendation in evidence from the input (name patterns, types,\n  cardinalities, null ratios, relation shapes). \"reason\" fields must cite that\n  evidence in one short sentence.\n\nOUTPUT RULES — STRICT\n1. Respond with EXACTLY ONE JSON object and nothing else. No prose, no markdown,\n   no code fences, no comments, no trailing commas. The first character of your\n   response must be \"{\" and the last must be \"}\".\n2. The first key must be \"schema_version\" with the exact value\n   \"adminium.llm/v1\".\n3. Reference ONLY tables and columns that appear in the input schema. Never\n   invent, rename, pluralize or \"correct\" an identifier. Tables marked\n   \"stub\": true are context only — emit no suggestions for them.\n4. Use only the allowed page-template ids, widget ids, tone values and masking\n   values listed in the user message. Icon names must be kebab-case lucide\n   icon names (e.g. \"shopping-cart\", \"users\", \"package\").\n5. Localized text objects must contain exactly the requested locale keys —\n   no more, no fewer. \"en_US\" is always required.\n6. Numbers for \"confidence\" use at most 2 decimal places. Keep all \"reason\"\n   fields under 200 characters.\n7. If you cannot comply with any rule, return\n   {\"schema_version\":\"adminium.llm/v1\",\"error\":\"<one-sentence reason>\"} and\n   nothing else.";
+    readonly user: "=== CONTEXT ===\nAdminium generated an admin dashboard for the database described below. Your\ndecisions refine: naming, navigation, enum semantics, relations, key columns,\npage layouts, dashboard widgets, privacy flags, icons and micro-copy.\nrun_id: {{RUN_ID}} (echo it back as \"run_id\" if convenient; optional)\n{{CHUNK_INFO}}\n\n=== YOUR DECISIONS ===\nProduce the following, per the response schema at the end of this message.\n{{REQUESTED_SECTIONS_LIST}}\n\n1. LABELS & DESCRIPTIONS (response: tables[].label, tables[].description,\n   tables[].columns[].label, tables[].columns[].description)\n   For every non-stub table and every column: a short human label (Title Case\n   for tables, Sentence case for columns; ≤ 28 chars for tables, ≤ 24 for\n   columns) and a one-sentence description. Localize both into every requested\n   locale. Column descriptions are optional for self-explanatory columns\n   (id, created_at) — omit rather than pad.\n\n2. DOMAIN GROUPING (response: navGroups)\n   Group all tables into 3–7 navigation groups that reflect business domains\n   (e.g. \"Sales\", \"Catalog\", \"People\"), not technical layers. Every non-stub\n   table appears in exactly one group. Order groups by operational importance;\n   order tables within a group the same way. Give each group a localized label\n   and a lucide icon.\n\n3. ENUM SEMANTICS (response: enums) — for every column listed under\n   \"enumColumns\" in the input:\n   - kind: \"workflow\" if values are states a record moves through over time\n     (e.g. draft → active → closed); \"category\" if values are unordered\n     classifications (e.g. region, plan tier).\n   - order: for workflow enums, the full value list in lifecycle order\n     (must be a permutation of the given values). null for category enums.\n   - tones: map EVERY value to exactly one of:\n     \"pos\" (successfully completed / healthy), \"warn\" (needs attention /\n     pending / at risk), \"danger\" (failed / blocked / cancelled),\n     \"accent\" (actively in progress), \"muted\" (inactive / draft / neutral).\n   - terminal: for workflow enums, the values that end the lifecycle.\n\n4. RELATIONS (response: relations)\n   - confirmed: for each relation under \"declaredRelations\" in the input,\n     state whether it is semantically what it looks like, and name the\n     relationship (e.g. \"orders belong to customers\").\n   - inferred: relations that SHOULD exist but are not declared as foreign\n     keys. Use naming conventions (customer_id → customers.id), matching\n     types, and statistics (a column whose distinctCount ≈ another table's\n     rowCountEstimate is a strong signal). Give kind\n     (\"many-to-one\" | \"one-to-one\" | \"many-to-many-via\"), evidence, and\n     confidence. Never re-state a declared relation as inferred.\n\n5. KEY COLUMNS (response: tables[].displayColumn, tables[].naturalKey)\n   - displayColumn: the single column whose value best represents a row to a\n     human (a name/title/number — never a UUID/serial id). null only if truly\n     nothing qualifies.\n   - naturalKey: minimal column set a human would use to uniquely identify a\n     row (e.g. [\"sku\"], [\"email\"], [\"order_number\"]). null if none.\n\n6. PAGE TEMPLATES (response: tables[].pageTemplates)\n   Recommend 1–3 page templates per table from ALLOWED PAGE TEMPLATES below,\n   ranked. \"page-crud\" is always generated and must not be recommended.\n   For each: cite which trigger(s) from the taxonomy fired (\"triggers\"), and\n   give a one-sentence reason grounded in this schema. Do not recommend a\n   template whose trigger conditions this table does not meet.\n\n7. DASHBOARD WIDGETS (response: dashboards)\n   Propose up to 6 dashboards, one per major domain (aligned with your nav\n   groups). For each, rank up to 8 widgets from ALLOWED WIDGETS below. Every\n   widget binds to real columns: metric column (numeric), dimension/group-by\n   column, time column where applicable, and an aggregation\n   (\"count\" | \"sum\" | \"avg\" | \"min\" | \"max\"). Spans on a 12-column grid:\n   KPI = 3, donut/funnel = 4, bar/table = 6, line/area = 8.\n\n8. PII & MASKING (response: tables[].columns[].pii)\n   Flag every column plausibly containing personal or sensitive data.\n   kind: one of \"email\" | \"phone\" | \"name\" | \"address\" | \"gov-id\" | \"dob\" |\n   \"financial\" | \"credentials\" | \"health\" | \"ip\" | \"location\" | \"other\".\n   masking: one of \"mask-email\" (j***@d***.com) | \"mask-partial\" (first/last\n   char visible) | \"last4\" | \"redact\" (fully hidden) | \"hash\" | \"none\"\n   (flag only). Columns already marked \"piiSuspected\": true in the input were\n   flagged by heuristics — confirm or reject them explicitly (pii: null means\n   explicitly not PII).\n\n9. ICONS (response: tables[].icon, navGroups[].icon)\n   One lucide icon per table and per nav group, kebab-case (e.g. \"users\",\n   \"shopping-cart\", \"package\", \"receipt\", \"calendar\", \"building-2\",\n   \"credit-card\", \"truck\", \"message-square\", \"file-text\"). Choose the most\n   domain-specific icon; avoid reusing one icon for multiple tables in the\n   same group.\n\n10. MICRO-COPY (response: tables[].microcopy)\n    Localized, per table:\n    - emptyState.headline (≤ 40 chars) and emptyState.guidance (one sentence,\n      ends with what to do first) — shown when the table has no rows.\n    - pageSubtitle: ≤ 60 chars shown under the page title, describing what\n      the page manages (e.g. \"Track and fulfil customer orders\").\n    Tone: calm, concrete, no exclamation marks, no marketing language.\n\n=== TRIGGER TAXONOMY (for decision 6) ===\n| template id        | trigger conditions |\n|--------------------|--------------------|\n| page-dashboard     | numeric measure columns + a timestamp column exist in the domain |\n| page-master-detail | enum-heavy table with rich per-record detail (many columns / child conversation table) |\n| page-queue-inbox   | workflow enum with pending/approved-style states, or read/unread boolean, + assignee/requester FK |\n| page-board         | status enum classified \"workflow\"; optional second categorical column → swimlanes; period column → roadmap |\n| page-calendar      | date/datetime column + a title-like text column |\n| page-scheduler     | person FK × date × shift/type columns, or hours-per-project assignment shape |\n| page-directory     | people-shaped table: name + email (+ role/department enum, avatar) |\n| page-log-viewer    | append-only shape: timestamp + actor + action/level, high row count, few updates |\n| page-files         | file/attachment shape: filename/mime/size/url columns or parent-folder self-FK |\n| page-chat          | conversation + message table pair (thread FK, sender FK, body, timestamp) |\n(Templates not listed here — settings, wizard, builder, auth, billing, api,\nmarketing, system pages — are platform-owned; never recommend them for user\ntables.)\n\n=== ALLOWED PAGE TEMPLATES ===\n{{ALLOWED_PAGE_TEMPLATE_IDS_JSON}}\n\n=== ALLOWED WIDGETS ===\n{{ALLOWED_WIDGET_IDS_JSON}}\n\n=== TARGET LOCALES ===\n{{LOCALES_JSON}}\nEvery localized text object uses exactly these keys.\n\n=== RESPONSE SCHEMA (adminium.llm/v1) ===\nReturn one JSON object of this shape. TypeScript-style notation; \"?\" = may be\nomitted; L10n = { \"<locale>\": string } with exactly the target locales.\n\n{\n  schema_version: \"adminium.llm/v1\",        // REQUIRED, first key\n  run_id?: string,\n  tables: [{\n    table: string,                           // \"schema.table\", exactly as in input\n    confidence: number,                      // 0..1, overall for this table's suggestions\n    label: L10n, description: L10n,\n    icon: string,                            // lucide kebab-case\n    displayColumn: string | null,\n    naturalKey: string[] | null,\n    pageTemplates: [{ template: string, rank: number, triggers: string[],\n                      reason: string, confidence: number }],\n    microcopy: { emptyState: { headline: L10n, guidance: L10n },\n                 pageSubtitle: L10n },\n    columns: [{\n      column: string,\n      label: L10n, description?: L10n,\n      pii: null | { kind: string, masking: string, reason: string,\n                    confidence: number }\n    }]\n  }],\n  enums: [{ table: string, column: string, kind: \"workflow\" | \"category\",\n            order: string[] | null, terminal?: string[],\n            tones: { [value: string]: \"pos\"|\"warn\"|\"danger\"|\"accent\"|\"muted\" },\n            reason: string, confidence: number }],\n  relations: {\n    confirmed: [{ fromTable: string, fromColumns: string[], toTable: string,\n                  toColumns: string[], semantics: string, correct: boolean,\n                  confidence: number }],\n    inferred:  [{ fromTable: string, fromColumns: string[], toTable: string,\n                  toColumns: string[],\n                  kind: \"many-to-one\"|\"one-to-one\"|\"many-to-many-via\",\n                  viaTable?: string, evidence: string, confidence: number }]\n  },\n  navGroups: [{ id: string,                  // kebab-case slug\n                label: L10n, icon: string, order: number,\n                tables: string[], confidence: number }],\n  dashboards: [{ id: string, domain: string, label: L10n, order: number,\n                 tables: string[],\n                 widgets: [{ widget: string, rank: number, span: number,\n                             table: string, metricColumn?: string,\n                             dimensionColumn?: string, timeColumn?: string,\n                             agg?: \"count\"|\"sum\"|\"avg\"|\"min\"|\"max\",\n                             titleEn: string, reason: string,\n                             confidence: number }] }],\n  notes?: string[]                           // ≤ 5 short caveats about the schema\n}\n\n=== INPUT: DATABASE SCHEMA ===\n{{SCHEMA_IR_JSON}}\n\n=== INPUT: STATISTICS (aggregates only — no row data) ===\n{{STATS_JSON}}\n{{SAMPLING_BLOCK}}";
+};
+/**
+ * §4.5 — the LLM reduce ("merge") user template, used only when a huge schema is
+ * chunked and the global sections (`groups`, `widgets`) need consolidating. It
+ * reuses {@link PROMPT_V1_SYSTEM} verbatim; the map/reduce orchestration itself
+ * lives in `response/merge.ts` (a separate track). This is the ship-verbatim
+ * template text it embeds.
+ */
+export declare const PROMPT_MERGE_V1_USER = "Below are partial navigation-group and dashboard proposals produced independently\nfor {{TOTAL}} chunks of the same database schema. Merge them into ONE coherent\nresult for the whole schema:\n- Merge groups that clearly describe the same domain; keep total groups between 3 and 7.\n- Every table in the full table list must appear in exactly one group.\n- Re-rank dashboards; keep at most 6; merge duplicates covering the same domain.\n- Keep the output schema identical to the partial inputs; same locale keys; same\n  output rules (single JSON object, no prose, schema_version first).\n\nFull table list: {{ALL_TABLE_NAMES_JSON}}\nPartial proposals: {{PARTIAL_GROUPS_AND_DASHBOARDS_JSON}}";
+/** The merge prompt as a pair (system reused verbatim from v1). */
+export declare const PROMPT_MERGE_V1: {
+    readonly version: "adminium.prompt/v1.1";
+    readonly system: "You are a senior data architect and admin-interface designer. You work for\nAdminium, an engine that introspects a relational database schema and\nauto-generates a complete admin dashboard from it. A heuristic pipeline has\nalready produced a baseline; your judgment refines it. Your output is machine-\napplied: it will be schema-validated, cross-checked against the real database\nschema, and reviewed by a human as a diff before anything is applied.\n\nTASK\nAnalyze the database schema and statistics provided in the user message and\nreturn enrichment decisions as a single JSON object, following the response\nschema and the decision instructions exactly.\n\nQUALITY BAR\n- Domain understanding first: infer what the business behind this schema does\n  from table/column names, types, relations and statistics, and make every\n  label, grouping and recommendation read like it was written by an expert in\n  that domain — not like it was mechanically derived from identifiers.\n- Labels are for non-technical staff: \"Purchase orders\", never \"tbl_po_hdr\".\n  Descriptions are one sentence, concrete, and state what a row represents.\n- Translations must be native-quality, using the domain's standard terminology\n  in each language, and consistent across the whole response (the same concept\n  gets the same term everywhere). Do not transliterate; translate.\n- Be decisive but honest: every suggestion carries a \"confidence\" between 0.0\n  and 1.0. Prefer a lower confidence over inventing detail. If the input gives\n  no basis for a decision, omit that suggestion entirely.\n- Ground every recommendation in evidence from the input (name patterns, types,\n  cardinalities, null ratios, relation shapes). \"reason\" fields must cite that\n  evidence in one short sentence.\n\nOUTPUT RULES — STRICT\n1. Respond with EXACTLY ONE JSON object and nothing else. No prose, no markdown,\n   no code fences, no comments, no trailing commas. The first character of your\n   response must be \"{\" and the last must be \"}\".\n2. The first key must be \"schema_version\" with the exact value\n   \"adminium.llm/v1\".\n3. Reference ONLY tables and columns that appear in the input schema. Never\n   invent, rename, pluralize or \"correct\" an identifier. Tables marked\n   \"stub\": true are context only — emit no suggestions for them.\n4. Use only the allowed page-template ids, widget ids, tone values and masking\n   values listed in the user message. Icon names must be kebab-case lucide\n   icon names (e.g. \"shopping-cart\", \"users\", \"package\").\n5. Localized text objects must contain exactly the requested locale keys —\n   no more, no fewer. \"en_US\" is always required.\n6. Numbers for \"confidence\" use at most 2 decimal places. Keep all \"reason\"\n   fields under 200 characters.\n7. If you cannot comply with any rule, return\n   {\"schema_version\":\"adminium.llm/v1\",\"error\":\"<one-sentence reason>\"} and\n   nothing else.";
+    readonly user: "Below are partial navigation-group and dashboard proposals produced independently\nfor {{TOTAL}} chunks of the same database schema. Merge them into ONE coherent\nresult for the whole schema:\n- Merge groups that clearly describe the same domain; keep total groups between 3 and 7.\n- Every table in the full table list must appear in exactly one group.\n- Re-rank dashboards; keep at most 6; merge duplicates covering the same domain.\n- Keep the output schema identical to the partial inputs; same locale keys; same\n  output rules (single JSON object, no prose, schema_version first).\n\nFull table list: {{ALL_TABLE_NAMES_JSON}}\nPartial proposals: {{PARTIAL_GROUPS_AND_DASHBOARDS_JSON}}";
+};
+/** Tokens the merge template exposes for `response/merge.ts` to fill. */
+export declare const PROMPT_MERGE_V1_TOKENS: readonly ["{{TOTAL}}", "{{ALL_TABLE_NAMES_JSON}}", "{{PARTIAL_GROUPS_AND_DASHBOARDS_JSON}}"];
+//# sourceMappingURL=v1.d.ts.map

package/dist/prompt/templates/v1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v1.d.ts","sourceRoot":"","sources":["../../../src/prompt/templates/v1.ts"],"names":[],"mappings":"AA8BA;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,m6FA+CZ,CAAC;AAElB;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,u5TAqLR,CAAC;AAEpB;;;;GAIG;AACH,eAAO,MAAM,SAAS;;;;CAIZ,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,wrBAUyB,CAAC;AAE3D,mEAAmE;AACnE,eAAO,MAAM,eAAe;;;;CAIlB,CAAC;AAEX,yEAAyE;AACzE,eAAO,MAAM,sBAAsB,8FAIzB,CAAC"}

package/dist/prompt/templates/v1.js

@@ -0,0 +1,312 @@
+/**
+ * `PROMPT_V1` — the production schema-enrichment prompt (06-llm-assist.md §5).
+ *
+ * SHIP VERBATIM. The two exported template strings reproduce §5.1 (system) and
+ * §5.2 (user); `{{DOUBLE_BRACE}}` tokens are replaced by the builder, everything
+ * else is literal. One deliberate divergence from the spec text (v1.1): §5.2's
+ * trigger taxonomy lists a `page-builder` row, but `page-builder` is a
+ * non-recommendable tool surface (registry `recommendable: false` — no
+ * `composeRequestedArchetype` materialization path) and is therefore absent from
+ * `LLM_ALLOWED_TEMPLATES`; the row is omitted so the taxonomy is exactly the
+ * injected allowed list and the "not listed here" disclaimer names `builder`
+ * among the platform-owned surfaces. The spec table predates that registry
+ * decision and awaits a sync (workplan/ is being revised on a separate track).
+ * Both paths (direct-API and BYO) send the identical text (§1 invariant 1) —
+ * the BYO flattening joins them as `=== SYSTEM ===\n…\n\n=== USER ===\n…`
+ * (see builder.ts / `flattenByo`).
+ *
+ * A snapshot test (`templates.test.ts`) pins these strings together with
+ * {@link PROMPT_VERSION}: any edit to the template text fails the snapshot,
+ * forcing a conscious `PROMPT_VERSION` bump (acceptance criterion 2).
+ *
+ * `PROMPT_VERSION` is imported from the response contract rather than redefined
+ * here: §4.3 designates this module as the authoritative home, but T01 already
+ * shipped the constant in `response/schema.ts`; importing the single existing
+ * definition guarantees the prompt and response contracts can never drift. It is
+ * NOT re-exported from this subdir — `response/` already owns the public export,
+ * and re-exporting it here would collide at the assembled top-level barrel.
+ */
+import { PROMPT_VERSION } from '../../response/schema.js';
+/**
+ * §5.1 — the system section. Fixed policy text (no tokens); it frames the task,
+ * the quality bar and the STRICT output rules. Reused verbatim by
+ * {@link PROMPT_MERGE_V1} (§4.5).
+ */
+export const PROMPT_V1_SYSTEM = `You are a senior data architect and admin-interface designer. You work for
+Adminium, an engine that introspects a relational database schema and
+auto-generates a complete admin dashboard from it. A heuristic pipeline has
+already produced a baseline; your judgment refines it. Your output is machine-
+applied: it will be schema-validated, cross-checked against the real database
+schema, and reviewed by a human as a diff before anything is applied.
+
+TASK
+Analyze the database schema and statistics provided in the user message and
+return enrichment decisions as a single JSON object, following the response
+schema and the decision instructions exactly.
+
+QUALITY BAR
+- Domain understanding first: infer what the business behind this schema does
+  from table/column names, types, relations and statistics, and make every
+  label, grouping and recommendation read like it was written by an expert in
+  that domain — not like it was mechanically derived from identifiers.
+- Labels are for non-technical staff: "Purchase orders", never "tbl_po_hdr".
+  Descriptions are one sentence, concrete, and state what a row represents.
+- Translations must be native-quality, using the domain's standard terminology
+  in each language, and consistent across the whole response (the same concept
+  gets the same term everywhere). Do not transliterate; translate.
+- Be decisive but honest: every suggestion carries a "confidence" between 0.0
+  and 1.0. Prefer a lower confidence over inventing detail. If the input gives
+  no basis for a decision, omit that suggestion entirely.
+- Ground every recommendation in evidence from the input (name patterns, types,
+  cardinalities, null ratios, relation shapes). "reason" fields must cite that
+  evidence in one short sentence.
+
+OUTPUT RULES — STRICT
+1. Respond with EXACTLY ONE JSON object and nothing else. No prose, no markdown,
+   no code fences, no comments, no trailing commas. The first character of your
+   response must be "{" and the last must be "}".
+2. The first key must be "schema_version" with the exact value
+   "adminium.llm/v1".
+3. Reference ONLY tables and columns that appear in the input schema. Never
+   invent, rename, pluralize or "correct" an identifier. Tables marked
+   "stub": true are context only — emit no suggestions for them.
+4. Use only the allowed page-template ids, widget ids, tone values and masking
+   values listed in the user message. Icon names must be kebab-case lucide
+   icon names (e.g. "shopping-cart", "users", "package").
+5. Localized text objects must contain exactly the requested locale keys —
+   no more, no fewer. "en_US" is always required.
+6. Numbers for "confidence" use at most 2 decimal places. Keep all "reason"
+   fields under 200 characters.
+7. If you cannot comply with any rule, return
+   {"schema_version":"adminium.llm/v1","error":"<one-sentence reason>"} and
+   nothing else.`;
+/**
+ * §5.2 — the user section template. Carries the `{{DOUBLE_BRACE}}` tokens the
+ * builder fills: run id, chunk info, requested-sections list, the allowed
+ * vocabularies, target locales, and the serialized schema IR / statistics /
+ * (opt-in) sample-values blocks. The ten numbered decision blocks map 1:1 to
+ * {@link RequestedSection} ids; the builder deletes deselected blocks (§4.4).
+ */
+export const PROMPT_V1_USER = `=== CONTEXT ===
+Adminium generated an admin dashboard for the database described below. Your
+decisions refine: naming, navigation, enum semantics, relations, key columns,
+page layouts, dashboard widgets, privacy flags, icons and micro-copy.
+run_id: {{RUN_ID}} (echo it back as "run_id" if convenient; optional)
+{{CHUNK_INFO}}
+
+=== YOUR DECISIONS ===
+Produce the following, per the response schema at the end of this message.
+{{REQUESTED_SECTIONS_LIST}}
+
+1. LABELS & DESCRIPTIONS (response: tables[].label, tables[].description,
+   tables[].columns[].label, tables[].columns[].description)
+   For every non-stub table and every column: a short human label (Title Case
+   for tables, Sentence case for columns; ≤ 28 chars for tables, ≤ 24 for
+   columns) and a one-sentence description. Localize both into every requested
+   locale. Column descriptions are optional for self-explanatory columns
+   (id, created_at) — omit rather than pad.
+
+2. DOMAIN GROUPING (response: navGroups)
+   Group all tables into 3–7 navigation groups that reflect business domains
+   (e.g. "Sales", "Catalog", "People"), not technical layers. Every non-stub
+   table appears in exactly one group. Order groups by operational importance;
+   order tables within a group the same way. Give each group a localized label
+   and a lucide icon.
+
+3. ENUM SEMANTICS (response: enums) — for every column listed under
+   "enumColumns" in the input:
+   - kind: "workflow" if values are states a record moves through over time
+     (e.g. draft → active → closed); "category" if values are unordered
+     classifications (e.g. region, plan tier).
+   - order: for workflow enums, the full value list in lifecycle order
+     (must be a permutation of the given values). null for category enums.
+   - tones: map EVERY value to exactly one of:
+     "pos" (successfully completed / healthy), "warn" (needs attention /
+     pending / at risk), "danger" (failed / blocked / cancelled),
+     "accent" (actively in progress), "muted" (inactive / draft / neutral).
+   - terminal: for workflow enums, the values that end the lifecycle.
+
+4. RELATIONS (response: relations)
+   - confirmed: for each relation under "declaredRelations" in the input,
+     state whether it is semantically what it looks like, and name the
+     relationship (e.g. "orders belong to customers").
+   - inferred: relations that SHOULD exist but are not declared as foreign
+     keys. Use naming conventions (customer_id → customers.id), matching
+     types, and statistics (a column whose distinctCount ≈ another table's
+     rowCountEstimate is a strong signal). Give kind
+     ("many-to-one" | "one-to-one" | "many-to-many-via"), evidence, and
+     confidence. Never re-state a declared relation as inferred.
+
+5. KEY COLUMNS (response: tables[].displayColumn, tables[].naturalKey)
+   - displayColumn: the single column whose value best represents a row to a
+     human (a name/title/number — never a UUID/serial id). null only if truly
+     nothing qualifies.
+   - naturalKey: minimal column set a human would use to uniquely identify a
+     row (e.g. ["sku"], ["email"], ["order_number"]). null if none.
+
+6. PAGE TEMPLATES (response: tables[].pageTemplates)
+   Recommend 1–3 page templates per table from ALLOWED PAGE TEMPLATES below,
+   ranked. "page-crud" is always generated and must not be recommended.
+   For each: cite which trigger(s) from the taxonomy fired ("triggers"), and
+   give a one-sentence reason grounded in this schema. Do not recommend a
+   template whose trigger conditions this table does not meet.
+
+7. DASHBOARD WIDGETS (response: dashboards)
+   Propose up to 6 dashboards, one per major domain (aligned with your nav
+   groups). For each, rank up to 8 widgets from ALLOWED WIDGETS below. Every
+   widget binds to real columns: metric column (numeric), dimension/group-by
+   column, time column where applicable, and an aggregation
+   ("count" | "sum" | "avg" | "min" | "max"). Spans on a 12-column grid:
+   KPI = 3, donut/funnel = 4, bar/table = 6, line/area = 8.
+
+8. PII & MASKING (response: tables[].columns[].pii)
+   Flag every column plausibly containing personal or sensitive data.
+   kind: one of "email" | "phone" | "name" | "address" | "gov-id" | "dob" |
+   "financial" | "credentials" | "health" | "ip" | "location" | "other".
+   masking: one of "mask-email" (j***@d***.com) | "mask-partial" (first/last
+   char visible) | "last4" | "redact" (fully hidden) | "hash" | "none"
+   (flag only). Columns already marked "piiSuspected": true in the input were
+   flagged by heuristics — confirm or reject them explicitly (pii: null means
+   explicitly not PII).
+
+9. ICONS (response: tables[].icon, navGroups[].icon)
+   One lucide icon per table and per nav group, kebab-case (e.g. "users",
+   "shopping-cart", "package", "receipt", "calendar", "building-2",
+   "credit-card", "truck", "message-square", "file-text"). Choose the most
+   domain-specific icon; avoid reusing one icon for multiple tables in the
+   same group.
+
+10. MICRO-COPY (response: tables[].microcopy)
+    Localized, per table:
+    - emptyState.headline (≤ 40 chars) and emptyState.guidance (one sentence,
+      ends with what to do first) — shown when the table has no rows.
+    - pageSubtitle: ≤ 60 chars shown under the page title, describing what
+      the page manages (e.g. "Track and fulfil customer orders").
+    Tone: calm, concrete, no exclamation marks, no marketing language.
+
+=== TRIGGER TAXONOMY (for decision 6) ===
+| template id        | trigger conditions |
+|--------------------|--------------------|
+| page-dashboard     | numeric measure columns + a timestamp column exist in the domain |
+| page-master-detail | enum-heavy table with rich per-record detail (many columns / child conversation table) |
+| page-queue-inbox   | workflow enum with pending/approved-style states, or read/unread boolean, + assignee/requester FK |
+| page-board         | status enum classified "workflow"; optional second categorical column → swimlanes; period column → roadmap |
+| page-calendar      | date/datetime column + a title-like text column |
+| page-scheduler     | person FK × date × shift/type columns, or hours-per-project assignment shape |
+| page-directory     | people-shaped table: name + email (+ role/department enum, avatar) |
+| page-log-viewer    | append-only shape: timestamp + actor + action/level, high row count, few updates |
+| page-files         | file/attachment shape: filename/mime/size/url columns or parent-folder self-FK |
+| page-chat          | conversation + message table pair (thread FK, sender FK, body, timestamp) |
+(Templates not listed here — settings, wizard, builder, auth, billing, api,
+marketing, system pages — are platform-owned; never recommend them for user
+tables.)
+
+=== ALLOWED PAGE TEMPLATES ===
+{{ALLOWED_PAGE_TEMPLATE_IDS_JSON}}
+
+=== ALLOWED WIDGETS ===
+{{ALLOWED_WIDGET_IDS_JSON}}
+
+=== TARGET LOCALES ===
+{{LOCALES_JSON}}
+Every localized text object uses exactly these keys.
+
+=== RESPONSE SCHEMA (adminium.llm/v1) ===
+Return one JSON object of this shape. TypeScript-style notation; "?" = may be
+omitted; L10n = { "<locale>": string } with exactly the target locales.
+
+{
+  schema_version: "adminium.llm/v1",        // REQUIRED, first key
+  run_id?: string,
+  tables: [{
+    table: string,                           // "schema.table", exactly as in input
+    confidence: number,                      // 0..1, overall for this table's suggestions
+    label: L10n, description: L10n,
+    icon: string,                            // lucide kebab-case
+    displayColumn: string | null,
+    naturalKey: string[] | null,
+    pageTemplates: [{ template: string, rank: number, triggers: string[],
+                      reason: string, confidence: number }],
+    microcopy: { emptyState: { headline: L10n, guidance: L10n },
+                 pageSubtitle: L10n },
+    columns: [{
+      column: string,
+      label: L10n, description?: L10n,
+      pii: null | { kind: string, masking: string, reason: string,
+                    confidence: number }
+    }]
+  }],
+  enums: [{ table: string, column: string, kind: "workflow" | "category",
+            order: string[] | null, terminal?: string[],
+            tones: { [value: string]: "pos"|"warn"|"danger"|"accent"|"muted" },
+            reason: string, confidence: number }],
+  relations: {
+    confirmed: [{ fromTable: string, fromColumns: string[], toTable: string,
+                  toColumns: string[], semantics: string, correct: boolean,
+                  confidence: number }],
+    inferred:  [{ fromTable: string, fromColumns: string[], toTable: string,
+                  toColumns: string[],
+                  kind: "many-to-one"|"one-to-one"|"many-to-many-via",
+                  viaTable?: string, evidence: string, confidence: number }]
+  },
+  navGroups: [{ id: string,                  // kebab-case slug
+                label: L10n, icon: string, order: number,
+                tables: string[], confidence: number }],
+  dashboards: [{ id: string, domain: string, label: L10n, order: number,
+                 tables: string[],
+                 widgets: [{ widget: string, rank: number, span: number,
+                             table: string, metricColumn?: string,
+                             dimensionColumn?: string, timeColumn?: string,
+                             agg?: "count"|"sum"|"avg"|"min"|"max",
+                             titleEn: string, reason: string,
+                             confidence: number }] }],
+  notes?: string[]                           // ≤ 5 short caveats about the schema
+}
+
+=== INPUT: DATABASE SCHEMA ===
+{{SCHEMA_IR_JSON}}
+
+=== INPUT: STATISTICS (aggregates only — no row data) ===
+{{STATS_JSON}}
+{{SAMPLING_BLOCK}}`;
+/**
+ * The v1 prompt as a pair. The builder renders these into a
+ * {@link PromptArtifact}; nothing else should read the raw strings except the
+ * snapshot test.
+ */
+export const PROMPT_V1 = {
+    version: PROMPT_VERSION,
+    system: PROMPT_V1_SYSTEM,
+    user: PROMPT_V1_USER,
+};
+/**
+ * §4.5 — the LLM reduce ("merge") user template, used only when a huge schema is
+ * chunked and the global sections (`groups`, `widgets`) need consolidating. It
+ * reuses {@link PROMPT_V1_SYSTEM} verbatim; the map/reduce orchestration itself
+ * lives in `response/merge.ts` (a separate track). This is the ship-verbatim
+ * template text it embeds.
+ */
+export const PROMPT_MERGE_V1_USER = `Below are partial navigation-group and dashboard proposals produced independently
+for {{TOTAL}} chunks of the same database schema. Merge them into ONE coherent
+result for the whole schema:
+- Merge groups that clearly describe the same domain; keep total groups between 3 and 7.
+- Every table in the full table list must appear in exactly one group.
+- Re-rank dashboards; keep at most 6; merge duplicates covering the same domain.
+- Keep the output schema identical to the partial inputs; same locale keys; same
+  output rules (single JSON object, no prose, schema_version first).
+
+Full table list: {{ALL_TABLE_NAMES_JSON}}
+Partial proposals: {{PARTIAL_GROUPS_AND_DASHBOARDS_JSON}}`;
+/** The merge prompt as a pair (system reused verbatim from v1). */
+export const PROMPT_MERGE_V1 = {
+    version: PROMPT_VERSION,
+    system: PROMPT_V1_SYSTEM,
+    user: PROMPT_MERGE_V1_USER,
+};
+/** Tokens the merge template exposes for `response/merge.ts` to fill. */
+export const PROMPT_MERGE_V1_TOKENS = [
+    '{{TOTAL}}',
+    '{{ALL_TABLE_NAMES_JSON}}',
+    '{{PARTIAL_GROUPS_AND_DASHBOARDS_JSON}}',
+];
+//# sourceMappingURL=v1.js.map

package/dist/prompt/templates/v1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v1.js","sourceRoot":"","sources":["../../../src/prompt/templates/v1.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA+Cf,CAAC;AAElB;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAqLX,CAAC;AAEpB;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,OAAO,EAAE,cAAc;IACvB,MAAM,EAAE,gBAAgB;IACxB,IAAI,EAAE,cAAc;CACZ,CAAC;AAEX;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;0DAUsB,CAAC;AAE3D,mEAAmE;AACnE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,OAAO,EAAE,cAAc;IACvB,MAAM,EAAE,gBAAgB;IACxB,IAAI,EAAE,oBAAoB;CAClB,CAAC;AAEX,yEAAyE;AACzE,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,WAAW;IACX,0BAA0B;IAC1B,wCAAwC;CAChC,CAAC"}

package/dist/prompt/token-estimate.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The `chars / 3.6` heuristic token estimator (06-llm-assist.md §2, §4.5).
+ *
+ * Deliberately provider-agnostic and conservative: it slightly over-counts for
+ * typical English + JSON so a prompt that "fits" the budget fits every supported
+ * provider's real tokenizer with headroom. Pure and deterministic — no model
+ * download, no network, no `Date.now`/`Math.random`.
+ */
+/** Characters-per-token divisor (§4.5: `tokens ≈ ceil(chars / 3.6)`). */
+export declare const CHARS_PER_TOKEN = 3.6;
+/**
+ * Estimate the input-token count of `text` as `ceil(text.length / 3.6)`.
+ * Empty input is 0 tokens.
+ */
+export declare function estimateTokens(text: string): number;
+//# sourceMappingURL=token-estimate.d.ts.map

package/dist/prompt/token-estimate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimate.d.ts","sourceRoot":"","sources":["../../src/prompt/token-estimate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,yEAAyE;AACzE,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnD"}