ekwo-os 0.4.1

package/dist/inventory.d.ts

@@ -0,0 +1,155 @@
+/**
+ * What this release defines, and what a database actually holds.
+ *
+ * `packages/cli/assets/expected-objects.json` is generated from the migrations
+ * by `scripts/generate-expected-objects.mjs` and travels inside the published
+ * package. It is an inventory, not a list kept by hand: a doctor whose
+ * expectations are typed out by a human drifts from the schema the first time
+ * somebody adds a table and forgets the list, and then it lies in both
+ * directions at once.
+ *
+ * Comparing it to a live catalogue answers two different questions. Something
+ * **missing** means the installation is behind or has been damaged — a
+ * migration that did not land, an object dropped by hand. Something **extra**
+ * means an operator added it: their table, their function, their business, and
+ * this reports it as information rather than as a fault.
+ *
+ * A policy is the exception. Row level security is the whole security model
+ * here, so a policy that is gone and a policy that was added to a table of
+ * this schema are both faults: the first opens nothing and closes everything,
+ * the second is a grant nobody reviewed.
+ */
+import { type GrantsSection } from './grants.js';
+import type { SqlClient } from './sql.js';
+export interface ExpectedColumn {
+    name: string;
+    type: string;
+}
+export interface ExpectedTable {
+    name: string;
+    columns: ExpectedColumn[];
+}
+export interface ExpectedFunction {
+    name: string;
+    /** `pg_get_function_identity_arguments`, so an overload is its own entry. */
+    arguments: string;
+}
+export interface ExpectedPolicy {
+    table: string;
+    name: string;
+    command: string;
+}
+export interface ExpectedTrigger {
+    table: string;
+    name: string;
+}
+export interface ExpectedType {
+    name: string;
+    kind: string;
+    labels?: string[];
+}
+export interface ExpectedSchema {
+    schema: string;
+    tables: ExpectedTable[];
+    views: string[];
+    functions: ExpectedFunction[];
+    policies: ExpectedPolicy[];
+    triggers: ExpectedTrigger[];
+    types: ExpectedType[];
+    /**
+     * Which of `anon`, `authenticated` and `service_role` may reach each of
+     * those objects, and with which verbs.
+     *
+     * Part of the inventory rather than a file of its own, because a privilege
+     * and the object it is on ship in the same migration: since
+     * `20260914151207` the schema grants its own rights by name instead of
+     * taking whatever a Supabase project's default privileges hand out, and a
+     * table added without its grants is exactly as broken as a table added
+     * without its policy.
+     *
+     * `doctor.ts` compares it separately from the categories above, because the
+     * rule is not the same: a missing grant is a fault, an extra one to `anon`
+     * is a fault, and an extra one to a signed-in user is worth saying out loud
+     * without failing a build.
+     */
+    grants: GrantsSection;
+}
+export interface ExpectedModule extends ExpectedSchema {
+    code: string;
+    version: string;
+}
+export interface ExpectedObjects {
+    /** The schema version this inventory describes. */
+    schemaVersion: string | null;
+    /** The last migration it was generated from. */
+    migration: string | null;
+    socle: ExpectedSchema;
+    modules: ExpectedModule[];
+}
+/** One category, compared. Every entry is a printable key. */
+export interface CategoryDiff {
+    missing: string[];
+    extra: string[];
+    /** Present on both sides and not the same: a column whose type moved. */
+    changed: string[];
+}
+export interface SectionComparison {
+    /** `socle`, or the module's code. */
+    code: string;
+    schema: string;
+    /**
+     * Whether this database carries the section at all. A module the operator
+     * never installed is not a fault, and nothing of it is required.
+     */
+    installed: boolean;
+    tables: CategoryDiff;
+    columns: CategoryDiff;
+    views: CategoryDiff;
+    functions: CategoryDiff;
+    policies: CategoryDiff;
+    triggers: CategoryDiff;
+    types: CategoryDiff;
+}
+export interface CatalogueComparison {
+    /** Version the inventory describes. */
+    expectedVersion: string | null;
+    /** Version the database reports, which may be older or newer. */
+    databaseVersion: string | null;
+    sections: SectionComparison[];
+    missing: number;
+    extra: number;
+    changed: number;
+    /** Missing or extra policies on a table of this schema. Always a fault. */
+    policyFaults: number;
+}
+export declare class InventoryError extends Error {
+}
+/**
+ * Where the inventory is.
+ *
+ * Published package: `dist/assets/expected-objects.json`, put there at build
+ * time by `scripts/copy-assets.mjs`. Checkout: `packages/cli/assets/`, which
+ * is the file the generator writes and the repository commits. The two
+ * candidates mirror `resolveBundleDir()`.
+ */
+export declare function resolveInventoryPath(): string | undefined;
+/** The inventory this CLI ships, or `undefined` if it ships none. */
+export declare function readExpectedObjects(path?: string | undefined): Promise<ExpectedObjects | undefined>;
+/** The live grants of one schema, for the doctor's own check. */
+export declare function readGrants(db: SqlClient, schema: string): Promise<GrantsSection>;
+/** The schemas of an inventory this database actually carries. */
+export declare function installedSections(db: SqlClient, expected: ExpectedObjects): Promise<ExpectedSchema[]>;
+/**
+ * The inventory against the live catalogue.
+ *
+ * The database's own schema version is read and reported but never gates the
+ * comparison: an installation older than the CLI is exactly when this is worth
+ * running, and refusing to look would be refusing the case.
+ */
+export declare function compareCatalogue(db: SqlClient, expected: ExpectedObjects): Promise<CatalogueComparison>;
+/** Every difference of one section, as printable lines. */
+export declare function describeDifferences(section: SectionComparison): {
+    faults: string[];
+    information: string[];
+};
+//# sourceMappingURL=inventory.d.ts.map

package/dist/inventory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inventory.d.ts","sourceRoot":"","sources":["../src/inventory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAKH,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAG1C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB;;;;;;;;;;;;;;;OAeG;IACH,MAAM,EAAE,aAAa,CAAC;CACvB;AAED,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gDAAgD;IAChD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,cAAc,CAAC;IACtB,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,8DAA8D;AAC9D,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,yEAAyE;IACzE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;IACpB,SAAS,EAAE,YAAY,CAAC;IACxB,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,uCAAuC;IACvC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,iEAAiE;IACjE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,cAAe,SAAQ,KAAK;CAAG;AAI5C;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,SAAS,CAUzD;AAED,qEAAqE;AACrE,wBAAsB,mBAAmB,CAAC,IAAI,qBAAyB,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAa7G;AAiGD,iEAAiE;AACjE,wBAAsB,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAEtF;AAED,kEAAkE;AAClE,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,SAAS,EACb,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,cAAc,EAAE,CAAC,CAG3B;AAmID;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,SAAS,EACb,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAqC9B;AAED,2DAA2D;AAC3D,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,GAAG;IAC/D,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAgBA"}

package/dist/inventory.js

@@ -0,0 +1,303 @@
+/**
+ * What this release defines, and what a database actually holds.
+ *
+ * `packages/cli/assets/expected-objects.json` is generated from the migrations
+ * by `scripts/generate-expected-objects.mjs` and travels inside the published
+ * package. It is an inventory, not a list kept by hand: a doctor whose
+ * expectations are typed out by a human drifts from the schema the first time
+ * somebody adds a table and forgets the list, and then it lies in both
+ * directions at once.
+ *
+ * Comparing it to a live catalogue answers two different questions. Something
+ * **missing** means the installation is behind or has been damaged — a
+ * migration that did not land, an object dropped by hand. Something **extra**
+ * means an operator added it: their table, their function, their business, and
+ * this reports it as information rather than as a fault.
+ *
+ * A policy is the exception. Row level security is the whole security model
+ * here, so a policy that is gone and a policy that was added to a table of
+ * this schema are both faults: the first opens nothing and closes everything,
+ * the second is a grant nobody reviewed.
+ */
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { fileURLToPath } from 'node:url';
+import { describeGrants } from './grants.js';
+import { scalar } from './sql.js';
+export class InventoryError extends Error {
+}
+const CATEGORIES = ['tables', 'columns', 'views', 'functions', 'policies', 'triggers', 'types'];
+/**
+ * Where the inventory is.
+ *
+ * Published package: `dist/assets/expected-objects.json`, put there at build
+ * time by `scripts/copy-assets.mjs`. Checkout: `packages/cli/assets/`, which
+ * is the file the generator writes and the repository commits. The two
+ * candidates mirror `resolveBundleDir()`.
+ */
+export function resolveInventoryPath() {
+    const candidates = [
+        new URL('./assets/expected-objects.json', import.meta.url),
+        new URL('../assets/expected-objects.json', import.meta.url),
+    ];
+    for (const candidate of candidates) {
+        const path = fileURLToPath(candidate);
+        if (existsSync(path))
+            return path;
+    }
+    return undefined;
+}
+/** The inventory this CLI ships, or `undefined` if it ships none. */
+export async function readExpectedObjects(path = resolveInventoryPath()) {
+    if (path === undefined)
+        return undefined;
+    const raw = await readFile(path, 'utf8');
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        throw new InventoryError(`inventory_invalid: ${path} — ${error.message}`);
+    }
+    if (parsed.socle === undefined || !Array.isArray(parsed.modules)) {
+        throw new InventoryError(`inventory_invalid: ${path} — no socle or no modules`);
+    }
+    return parsed;
+}
+// ------------------------------------------------------------------ reading
+/** The same categories, read from a live catalogue. */
+async function readSchema(db, schema) {
+    const tables = await db.query(`select c.relname as name
+       from pg_class c join pg_namespace n on n.oid = c.relnamespace
+      where n.nspname = $1 and c.relkind in ('r', 'p')
+      order by c.relname`, [schema]);
+    const columns = await db.query(`select c.relname as table_name, a.attname as name,
+            format_type(a.atttypid, a.atttypmod) as type
+       from pg_attribute a
+       join pg_class c on c.oid = a.attrelid
+       join pg_namespace n on n.oid = c.relnamespace
+      where n.nspname = $1 and c.relkind in ('r', 'p')
+        and a.attnum > 0 and not a.attisdropped
+      order by c.relname, a.attname`, [schema]);
+    const views = await db.query(`select c.relname as name
+       from pg_class c join pg_namespace n on n.oid = c.relnamespace
+      where n.nspname = $1 and c.relkind in ('v', 'm')
+      order by c.relname`, [schema]);
+    const functions = await db.query(`select p.proname as name, pg_get_function_identity_arguments(p.oid) as arguments
+       from pg_proc p join pg_namespace n on n.oid = p.pronamespace
+      where n.nspname = $1
+      order by p.proname, pg_get_function_identity_arguments(p.oid)`, [schema]);
+    const policies = await db.query(`select c.relname as table_name, p.polname as name,
+            case p.polcmd when 'r' then 'select' when 'a' then 'insert'
+                          when 'w' then 'update' when 'd' then 'delete'
+                          else 'all' end as command
+       from pg_policy p
+       join pg_class c on c.oid = p.polrelid
+       join pg_namespace n on n.oid = c.relnamespace
+      where n.nspname = $1
+      order by c.relname, p.polname`, [schema]);
+    const triggers = await db.query(`select c.relname as table_name, t.tgname as name
+       from pg_trigger t
+       join pg_class c on c.oid = t.tgrelid
+       join pg_namespace n on n.oid = c.relnamespace
+      where n.nspname = $1 and not t.tgisinternal
+      order by c.relname, t.tgname`, [schema]);
+    const types = await db.query(`select t.typname as name,
+            case t.typtype when 'e' then 'enum' when 'd' then 'domain' else 'composite' end as kind,
+            case when t.typtype = 'e' then (
+              select array_agg(e.enumlabel order by e.enumsortorder)
+                from pg_enum e where e.enumtypid = t.oid
+            ) end as labels
+       from pg_type t join pg_namespace n on n.oid = t.typnamespace
+      where n.nspname = $1 and t.typtype in ('e', 'd', 'c')
+        and (t.typtype <> 'c'
+             or exists (select 1 from pg_class c where c.oid = t.typrelid and c.relkind = 'c'))
+      order by t.typname`, [schema]);
+    const grants = await describeGrants((sql, params) => db.query(sql, params), schema);
+    return {
+        schema,
+        tables: tables.map((t) => ({
+            name: t.name,
+            columns: columns
+                .filter((c) => c.table_name === t.name)
+                .map((c) => ({ name: c.name, type: c.type })),
+        })),
+        views: views.map((v) => v.name),
+        functions: functions.map((f) => ({ name: f.name, arguments: f.arguments })),
+        policies: policies.map((p) => ({ table: p.table_name, name: p.name, command: p.command })),
+        triggers: triggers.map((t) => ({ table: t.table_name, name: t.name })),
+        types: types.map((t) => ({
+            name: t.name,
+            kind: t.kind,
+            ...(t.labels === null ? {} : { labels: t.labels }),
+        })),
+        grants,
+    };
+}
+/** The live grants of one schema, for the doctor's own check. */
+export async function readGrants(db, schema) {
+    return describeGrants((sql, params) => db.query(sql, params), schema);
+}
+/** The schemas of an inventory this database actually carries. */
+export async function installedSections(db, expected) {
+    const carried = await installedModules(db);
+    return [expected.socle, ...expected.modules.filter((m) => carried.has(m.code))];
+}
+// ---------------------------------------------------------------- comparing
+function emptyDiff() {
+    return { missing: [], extra: [], changed: [] };
+}
+/**
+ * Two keyed sets, compared.
+ *
+ * `key` is what identifies the object — a name, or a name and a signature —
+ * and `same` says whether two objects that share a key are still the same
+ * thing. Both sides are already sorted, and the keys are what is printed.
+ */
+function diff(expected, actual, key, same = () => undefined) {
+    const out = emptyDiff();
+    const here = new Map(actual.map((item) => [key(item), item]));
+    const there = new Set(expected.map(key));
+    for (const item of expected) {
+        const found = here.get(key(item));
+        if (found === undefined) {
+            out.missing.push(key(item));
+            continue;
+        }
+        const difference = same(item, found);
+        if (difference !== undefined)
+            out.changed.push(difference);
+    }
+    for (const item of actual) {
+        if (!there.has(key(item)))
+            out.extra.push(key(item));
+    }
+    return out;
+}
+const functionKey = (f) => `${f.name}(${f.arguments})`;
+const policyKey = (p) => `${p.table}.${p.name}`;
+const triggerKey = (t) => `${t.table}.${t.name}`;
+/** One section of the inventory against one schema of the database. */
+function compareSchema(code, expected, actual) {
+    const tables = diff(expected.tables, actual.tables, (t) => t.name);
+    // Columns, triggers and policies are compared on the tables this schema
+    // defines. On a table the operator added, they are the operator's business,
+    // and the table itself is already reported as extra.
+    const known = new Set(expected.tables.map((t) => t.name));
+    const expectedColumns = expected.tables.flatMap((t) => t.columns.map((c) => ({ key: `${t.name}.${c.name}`, type: c.type })));
+    const actualColumns = actual.tables
+        .filter((t) => known.has(t.name))
+        .flatMap((t) => t.columns.map((c) => ({ key: `${t.name}.${c.name}`, type: c.type })));
+    const columns = diff(expectedColumns, actualColumns, (c) => c.key, (a, b) => (a.type === b.type ? undefined : `${a.key} is ${b.type}, expected ${a.type}`));
+    // A column missing because its whole table is missing is already said once.
+    columns.missing = columns.missing.filter((c) => !tables.missing.includes(c.split('.')[0] ?? ''));
+    const policies = diff(expected.policies, actual.policies.filter((p) => known.has(p.table)), policyKey, (a, b) => (a.command === b.command ? undefined : `${policyKey(a)} is ${b.command}, expected ${a.command}`));
+    policies.missing = policies.missing.filter((p) => !tables.missing.includes(p.split('.')[0] ?? ''));
+    const triggers = diff(expected.triggers, actual.triggers.filter((t) => known.has(t.table)), triggerKey);
+    triggers.missing = triggers.missing.filter((t) => !tables.missing.includes(t.split('.')[0] ?? ''));
+    return {
+        code,
+        schema: expected.schema,
+        installed: true,
+        tables,
+        columns,
+        views: diff(expected.views, actual.views, (v) => v),
+        functions: diff(expected.functions, actual.functions, functionKey),
+        policies,
+        triggers,
+        types: diff(expected.types, actual.types, (t) => t.name, (a, b) => {
+            if (a.kind !== b.kind)
+                return `${a.name} is a ${b.kind}, expected a ${a.kind}`;
+            const expectedLabels = (a.labels ?? []).join(', ');
+            const actualLabels = (b.labels ?? []).join(', ');
+            if (expectedLabels === actualLabels)
+                return undefined;
+            return `${a.name} holds (${actualLabels}), expected (${expectedLabels})`;
+        }),
+    };
+}
+/** A section this database does not carry: nothing of it is required. */
+function notInstalled(code, schema) {
+    return {
+        code,
+        schema,
+        installed: false,
+        tables: emptyDiff(),
+        columns: emptyDiff(),
+        views: emptyDiff(),
+        functions: emptyDiff(),
+        policies: emptyDiff(),
+        triggers: emptyDiff(),
+        types: emptyDiff(),
+    };
+}
+/** The module codes this database carries, whatever this CLI ships. */
+async function installedModules(db) {
+    const present = await scalar(db, `select to_regclass('public.modules') is not null`);
+    if (present !== true)
+        return new Set();
+    const rows = await db.query('select code from modules');
+    return new Set(rows.map((r) => r.code));
+}
+/**
+ * The inventory against the live catalogue.
+ *
+ * The database's own schema version is read and reported but never gates the
+ * comparison: an installation older than the CLI is exactly when this is worth
+ * running, and refusing to look would be refusing the case.
+ */
+export async function compareCatalogue(db, expected) {
+    // Asked in two steps on purpose: naming the function in a `case` still
+    // resolves it, so a database that does not have it would raise rather than
+    // answer, and that database is one this is meant to report on.
+    const hasVersion = await scalar(db, `select to_regprocedure('public.ekwo_schema_version()') is not null`);
+    const databaseVersion = hasVersion === true ? ((await scalar(db, 'select ekwo_schema_version()')) ?? null) : null;
+    const sections = [compareSchema('socle', expected.socle, await readSchema(db, 'public'))];
+    const carried = await installedModules(db);
+    for (const module of expected.modules) {
+        if (!carried.has(module.code)) {
+            sections.push(notInstalled(module.code, module.schema));
+            continue;
+        }
+        sections.push(compareSchema(module.code, module, await readSchema(db, module.schema)));
+    }
+    let missing = 0;
+    let extra = 0;
+    let changed = 0;
+    let policyFaults = 0;
+    for (const section of sections) {
+        for (const category of CATEGORIES) {
+            missing += section[category].missing.length;
+            extra += section[category].extra.length;
+            changed += section[category].changed.length;
+        }
+        policyFaults +=
+            section.policies.missing.length + section.policies.extra.length + section.policies.changed.length;
+    }
+    return { expectedVersion: expected.schemaVersion, databaseVersion, sections, missing, extra, changed, policyFaults };
+}
+/** Every difference of one section, as printable lines. */
+export function describeDifferences(section) {
+    const faults = [];
+    const information = [];
+    const where = section.code === 'socle' ? '' : `${section.code}: `;
+    for (const category of CATEGORIES) {
+        const { missing, extra, changed } = section[category];
+        for (const item of missing)
+            faults.push(`${where}missing ${singular(category)} ${item}`);
+        for (const item of changed)
+            faults.push(`${where}${item}`);
+        for (const item of extra) {
+            const line = `${where}extra ${singular(category)} ${item}`;
+            if (category === 'policies')
+                faults.push(line);
+            else
+                information.push(line);
+        }
+    }
+    return { faults, information };
+}
+function singular(category) {
+    return category === 'policies' ? 'policy' : category.replace(/s$/, '');
+}
+//# sourceMappingURL=inventory.js.map

package/dist/inventory.js.map

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

package/dist/migrations.d.ts

@@ -0,0 +1,76 @@
+/**
+ * The migration runner.
+ *
+ * It applies `supabase/migrations/*.sql` in filename order and records what
+ * it did in `supabase_migrations.schema_migrations`, **in the format the
+ * Supabase CLI uses** — same schema, same table, same three columns, version
+ * being the timestamp prefix of the filename. That is the whole point: an
+ * installation set up with `ekwo init` can later be pushed to with
+ * `supabase db push`, and one set up with `supabase db push` can be brought
+ * forward with `ekwo migrate`. The two are interchangeable because they read
+ * and write the same history.
+ *
+ * Each file is applied inside one transaction together with its history row,
+ * so a migration that fails halfway leaves neither half-applied schema nor a
+ * history row that lies. Re-running resumes at the file that failed.
+ */
+import type { SqlClient } from './sql.js';
+export interface Migration {
+    /** `20260911120000` — the timestamp prefix, and the primary key of the history. */
+    version: string;
+    /** `core_companies` — what the Supabase CLI stores as `name`. */
+    name: string;
+    /** `20260911120000_core_companies.sql` */
+    file: string;
+    /** Absolute path on disk. */
+    path: string;
+}
+/** Parses a migration filename, or returns `undefined` if it is not one. */
+export declare function parseMigrationFile(file: string): Omit<Migration, 'path'> | undefined;
+/** Every migration in `dir`, in the order they must be applied. */
+export declare function listMigrations(dir: string): Promise<Migration[]>;
+/**
+ * The history table, created exactly as the Supabase CLI creates it.
+ *
+ * The columns are added one by one with `if not exists`, so this is safe on a
+ * project the Supabase CLI has already touched, whichever version of it.
+ */
+export declare function ensureHistory(db: SqlClient): Promise<void>;
+/** Versions already recorded, oldest first. */
+export declare function appliedVersions(db: SqlClient): Promise<string[]>;
+export interface Gap {
+    applied: string[];
+    pending: Migration[];
+    /** Versions in the database that this release does not ship — a newer installation. */
+    unknown: string[];
+}
+/** What separates the database from the migrations this CLI carries. */
+export declare function migrationGap(db: SqlClient, all: Migration[]): Promise<Gap>;
+/**
+ * Applies one migration and records it, atomically.
+ *
+ * The file is sent as a single command string, so Postgres runs it as one
+ * unit inside the transaction we opened. No file in this repository opens a
+ * transaction of its own, and none may: the runner owns that.
+ */
+export declare function applyMigration(db: SqlClient, migration: Migration): Promise<void>;
+export interface ApplyResult {
+    applied: Migration[];
+    alreadyApplied: number;
+}
+/** Applies every pending migration, in order, reporting each one as it lands. */
+export declare function applyMigrations(db: SqlClient, all: Migration[], onApplied?: (migration: Migration) => void): Promise<ApplyResult>;
+/**
+ * Splits a SQL file into statements, for the `statements` column only.
+ *
+ * Execution never goes through this: the file is handed to Postgres whole.
+ * The column is what `supabase migration repair` and `supabase db diff` read
+ * back, so it should hold statements rather than one blob — but a mistake
+ * here can only make that column less pretty, never break an installation.
+ *
+ * Handles line and block comments, single- and double-quoted literals,
+ * `E''` backslash escapes and dollar quoting with tags, which is what the
+ * function bodies in this schema are made of.
+ */
+export declare function splitStatements(sql: string): string[];
+//# sourceMappingURL=migrations.d.ts.map

package/dist/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../src/migrations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,MAAM,WAAW,SAAS;IACxB,mFAAmF;IACnF,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd;AAID,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,SAAS,CAMpF;AAED,mEAAmE;AACnE,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAWtE;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAWhE;AAED,+CAA+C;AAC/C,wBAAsB,eAAe,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAKtE;AAED,MAAM,WAAW,GAAG;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,uFAAuF;IACvF,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wEAAwE;AACxE,wBAAsB,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAUhF;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAavF;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,iFAAiF;AACjF,wBAAsB,eAAe,CACnC,EAAE,EAAE,SAAS,EACb,GAAG,EAAE,SAAS,EAAE,EAChB,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,GACzC,OAAO,CAAC,WAAW,CAAC,CAOtB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAiHrD"}