@adminiumjs/engine 0.1.0-rc.1

package/dist/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,oEAAoE;AACpE,eAAO,MAAM,cAAc,0CAA2C,CAAC;AACvE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAkEvB,kEAAkE;AAClE,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,mBAAmB,CAAC,CAIxF,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,wBAAwB,EAAE,mBAA4B,CAAC;AAEpE,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,GAAG,mBAAmB,CAEnF;AAMD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,qLAaxB,CAAC;AACX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,gBAAgB,GAAG,kBAAkB,EAAE,CAiBvF;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,aAAa,GAAG,MAAM,CAAC;AAErE,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,gBAAgB,GAAG,kBAAkB,CAKxF"}

package/dist/capabilities.js

@@ -0,0 +1,131 @@
+/** Engines a live connection can use ('generic' is import-only). */
+export const SOURCE_ENGINES = ['postgres', 'mysql', 'sqlite'];
+/** Static dialect capabilities — 05 §4.1 (probe refines per-connection). */
+const POSTGRES = {
+    hasEnums: true,
+    hasFKs: true,
+    hasSchemas: true,
+    hasComments: true,
+    hasChecks: true,
+    hasRLS: true,
+    hasMaterializedViews: true,
+    hasRowEstimates: true,
+    supportsStatementTimeout: true,
+    supportsReturning: true,
+    maxIdentifierLength: 63,
+};
+/** 05 §4.2 — MySQL 8 / MariaDB 10.5+. */
+const MYSQL = {
+    hasEnums: true, // column enums: enum('a','b') — 05 §2.1
+    hasFKs: true, // false per-table for MyISAM (warning emitted)
+    hasSchemas: false,
+    hasComments: true,
+    hasChecks: true, // 8.0.16+/10.2+ — feature-detected, degrades with a warning
+    hasRLS: false,
+    hasMaterializedViews: false,
+    hasRowEstimates: true, // TABLE_ROWS — InnoDB estimates drift, display with ≈
+    supportsStatementTimeout: true,
+    supportsReturning: false, // MySQL mutate re-selects; MariaDB 10.5+ detected at runtime
+    maxIdentifierLength: 64,
+};
+/** 05 §4.3 — SQLite ≥ 3.35 (file-path connections; the Electron engine). */
+const SQLITE = {
+    hasEnums: false, // CHECK synthesis only — 05 §4.3
+    hasFKs: true,
+    hasSchemas: false,
+    hasComments: false, // no comment syntax — Studio remap is the labeling path
+    hasChecks: true,
+    hasRLS: false,
+    hasMaterializedViews: false,
+    hasRowEstimates: true, // sqlite_stat1 / small-file exact counts
+    supportsStatementTimeout: false, // worker termination is the timeout story
+    supportsReturning: true, // SQLite ≥ 3.35 (minimum supported — 05 §4.3)
+    maxIdentifierLength: 128,
+};
+/**
+ * Baseline for schema-file imports — 05 §5.2: parsers refine per-format
+ * (e.g. Prisma `///` comments), but no import ever has live row estimates,
+ * RLS, or health/drift signals.
+ */
+const IMPORT = {
+    hasEnums: true,
+    hasFKs: true,
+    hasSchemas: false,
+    hasComments: false,
+    hasChecks: false,
+    hasRLS: false,
+    hasMaterializedViews: false,
+    hasRowEstimates: false,
+    supportsStatementTimeout: false,
+    supportsReturning: false,
+    maxIdentifierLength: 128,
+};
+/** The matrix (gap-analysis §2.1): one column per live engine. */
+export const ENGINE_CAPABILITY_MATRIX = {
+    postgres: POSTGRES,
+    mysql: MYSQL,
+    sqlite: SQLITE,
+};
+/** Import baseline (see above) — exported for parsers and the wizard. */
+export const IMPORT_BASE_CAPABILITIES = IMPORT;
+/** Static capabilities for a source (live engine column or import baseline). */
+export function capabilitiesForSource(source) {
+    return source.kind === 'live' ? ENGINE_CAPABILITY_MATRIX[source.engine] : IMPORT_BASE_CAPABILITIES;
+}
+// ---------------------------------------------------------------------------
+// Degradation notes
+// ---------------------------------------------------------------------------
+/**
+ * Stable degradation-note codes. The dashboard maps each to translated copy;
+ * anything not listed for a source needs no caveat there.
+ */
+export const CAPABILITY_NOTE_CODES = [
+    /** TABLE_ROWS drifts up to ±40% on InnoDB — always display with ≈ (05 §4.2). */
+    'mysql-approximate-row-estimates',
+    /** MyISAM tables carry no FKs; enums are column-typed; CHECKs need 8.0.16+/10.2+ (05 §4.2). */
+    'mysql-weaker-fk-enum-metadata',
+    /** No native enum type — enums are synthesized from CHECK (col IN (…)) (05 §4.3). */
+    'sqlite-check-enum-synthesis',
+    /** No comment syntax — the remap editor is the labeling path (05 §4.3). */
+    'sqlite-no-comments',
+    /** Imports carry no row counts — placeholder seeding happens downstream (05 §5.2). */
+    'import-no-row-counts',
+    /** No live connection: health checks, drift detection and probes unavailable. */
+    'import-no-live-health',
+];
+/**
+ * Degradation notes for a source, derived from the matrix flags where the
+ * flags express the fact, with the per-engine specials (estimate drift,
+ * MyISAM) keyed explicitly. Order = display order.
+ */
+export function capabilityNotesForSource(source) {
+    const caps = capabilitiesForSource(source);
+    const notes = [];
+    if (source.kind === 'import') {
+        if (!caps.hasRowEstimates)
+            notes.push('import-no-row-counts');
+        notes.push('import-no-live-health');
+        return notes;
+    }
+    if (source.engine === 'mysql') {
+        if (caps.hasRowEstimates)
+            notes.push('mysql-approximate-row-estimates');
+        notes.push('mysql-weaker-fk-enum-metadata');
+    }
+    if (source.engine === 'sqlite') {
+        if (!caps.hasEnums && caps.hasChecks)
+            notes.push('sqlite-check-enum-synthesis');
+        if (!caps.hasComments)
+            notes.push('sqlite-no-comments');
+    }
+    return notes;
+}
+export function rowEstimateQualityForSource(source) {
+    const caps = capabilitiesForSource(source);
+    if (!caps.hasRowEstimates)
+        return 'none';
+    if (source.kind === 'live' && source.engine === 'mysql')
+        return 'approximate';
+    return 'estimate';
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/capabilities.js.map

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

package/dist/classify/columns.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Column semantic classification — 05-introspection-engine.md §7.
+ *
+ * Deterministic ordered rule pipeline: each column receives exactly ONE
+ * primary semantic (first matching rule wins, in the §7.1 precedence order)
+ * plus independent flags (`secret`, `pii`, `maskedByDefault`) from the §7.2
+ * layer (./pii.ts). Rule ids (`r01-secret` … `r30-plain`) mirror the §7.1
+ * row numbers — later docs and the LLM prompt reference them.
+ *
+ * The pipeline is pure and heuristic-only (`source: 'heuristic'`); LLM
+ * enrichment (06-llm-assist.md) and Studio overrides land on top with
+ * `source: 'llm' | 'override'` and always win downstream.
+ */
+import type { ColumnModel, ColumnSemantics, DatabaseModel, EnumDef, SemanticTag, TableModel } from '../schema-model.js';
+/** One classified column: the persisted semantics plus audit trail. */
+export interface ClassifiedColumn {
+    tableId: string;
+    column: string;
+    /** §7.1 row id that decided `semantics.primary`, e.g. 'r04-money'. */
+    ruleId: string;
+    /** Human-readable evidence for the Studio remap editor / golden tests. */
+    reasons: string[];
+    /** Exactly the shape persisted into `ColumnModel.semantics`. */
+    semantics: ColumnSemantics;
+}
+export interface PairAssignment {
+    semantic: Extract<SemanticTag, 'date-range' | 'geo-point'>;
+    role: 'start' | 'end' | 'lat' | 'lng';
+    partner: string;
+}
+export interface ColumnClassifyContext {
+    table: TableModel;
+    enumsById: ReadonlyMap<string, EnumDef>;
+    /** Columns resolved as FKs: declared mirror or accepted (≥ 0.8) relation. */
+    fkColumns: ReadonlySet<string>;
+    /** People-shaped table (§8 directory trigger) — gates rule 16 + PII. */
+    peopleish: boolean;
+    /** Start/end and lat/lng pair assignments (§7.1 rows 11 and 14). */
+    pairs: ReadonlyMap<string, PairAssignment>;
+}
+/** §7.1 row 7 — workflow value vocabulary (verbs/states → kanban trigger). */
+export declare const WORKFLOW_VALUE_RE: RegExp;
+/** §8 directory trigger vocabulary for "people-ish" tables (see tables.ts). */
+export declare const PEOPLE_TABLE_RE: RegExp;
+/** Min/max numeric literal in CHECK expressions mentioning the column. */
+export declare function checkBounds(table: TableModel, columnName: string): {
+    min: number;
+    max: number;
+} | null;
+export declare function buildColumnClassifyContext(model: DatabaseModel, table: TableModel): ColumnClassifyContext;
+/** Every §7.1 rule id, in precedence order (exported for tests/docs). */
+export declare const COLUMN_RULE_IDS: readonly string[];
+/** Classify one column within its table context. Pure and deterministic. */
+export declare function classifyColumn(column: ColumnModel, ctx: ColumnClassifyContext): ClassifiedColumn;
+/** Classify every column of a table (ordinal order preserved). */
+export declare function classifyTableColumns(model: DatabaseModel, table: TableModel): ClassifiedColumn[];
+//# sourceMappingURL=columns.d.ts.map

package/dist/classify/columns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"columns.d.ts","sourceRoot":"","sources":["../../src/classify/columns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,aAAa,EACb,OAAO,EACP,WAAW,EACX,UAAU,EACX,MAAM,oBAAoB,CAAC;AAQ5B,uEAAuE;AACvE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gEAAgE;IAChE,SAAS,EAAE,eAAe,CAAC;CAC5B;AAMD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,OAAO,CAAC,WAAW,EAAE,YAAY,GAAG,WAAW,CAAC,CAAC;IAC3D,IAAI,EAAE,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,6EAA6E;IAC7E,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC/B,wEAAwE;IACxE,SAAS,EAAE,OAAO,CAAC;IACnB,oEAAoE;IACpE,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC5C;AAgBD,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,QAC8O,CAAC;AAkC7Q,+EAA+E;AAC/E,eAAO,MAAM,eAAe,QAC2H,CAAC;AAMxJ,0EAA0E;AAC1E,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,EACjB,UAAU,EAAE,MAAM,GACjB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAgBrC;AAaD,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,UAAU,GAChB,qBAAqB,CA4BvB;AAkZD,yEAAyE;AACzE,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAA2B,CAAC;AAMzE,4EAA4E;AAC5E,wBAAgB,cAAc,CAC5B,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,qBAAqB,GACzB,gBAAgB,CAwClB;AAED,kEAAkE;AAClE,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,UAAU,GAChB,gBAAgB,EAAE,CAGpB"}