ekwo-os 0.4.1

package/dist/commands/company.js

@@ -0,0 +1,287 @@
+/**
+ * `ekwo company` — one company leaves an installation, and arrives in another.
+ *
+ *   ekwo company export <company> --out <dir>   write the archive of one company
+ *   ekwo company import <dir>                   take an archive into this installation
+ *
+ * The archive is a directory: `manifest.json`, and one `data/<schema>.<table>.jsonl`
+ * per table, one row per line. `docs/company-archive.md` is the format, and it
+ * is written to be read without this CLI.
+ *
+ * **Exporting runs as a person, under row level security.** The connection the
+ * CLI holds belongs to the owner of the database, for whom every company is
+ * readable at once — which is exactly what `export_company_table()` refuses.
+ * So the export happens inside one transaction that steps down to
+ * `authenticated` and carries the claim of the member it acts for, the way
+ * PostgREST would have: the schema judges that person, and the snapshot is one
+ * snapshot, so the manifest and the rows cannot disagree.
+ *
+ * **The rows are never parsed here.** They are written as the database wrote
+ * them and read back the same way, because a JSON parser that meets `1.50`
+ * inside a jsonb column hands back `1.5`, and the checksum of a table is the
+ * checksum of its bytes.
+ *
+ * **Importing is one call.** The files are checked against the manifest first —
+ * a file damaged on the way is a finding of this CLI, not a refusal of the
+ * books — then handed whole to `import_company()`, which takes all of it or
+ * none of it.
+ */
+import { createHash } from 'node:crypto';
+import { mkdir, readFile, readdir, writeFile } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { rejectUnknownFlags, stringFlag, UsageError } from '../args.js';
+import { CONNECTION_FLAGS, openDatabase } from '../context.js';
+import { setResult } from '../output.js';
+import { isInteractive } from '../prompt.js';
+import { asUser, first } from '../sql.js';
+import { bold, dim, heading, line, note, pairs, step, warn } from '../ui.js';
+export const COMPANY_FLAGS = [...CONNECTION_FLAGS, 'out', 'as-user', 'owner', 'yes'];
+/** `public.accounts`. What a table of an archive may be called, and nothing else. */
+const TABLE_NAME = /^[a-z_][a-z0-9_]*\.[a-z_][a-z0-9_]*$/;
+export async function companyCommand(args, deps = {}) {
+    rejectUnknownFlags(args, COMPANY_FLAGS);
+    const action = args.positional[0];
+    if (action === undefined)
+        throw new UsageError(`name a subcommand\n${usage()}`);
+    if (action === 'help') {
+        line(usage());
+        return 0;
+    }
+    if (action !== 'export' && action !== 'import') {
+        throw new UsageError(`unknown subcommand: company ${action}\n${usage()}`);
+    }
+    const { db } = await openDatabase(args, { interactive: isInteractive(), connect: deps.connect });
+    try {
+        return action === 'export' ? await exportCommand(db, args) : await importCommand(db, args);
+    }
+    finally {
+        await db.close();
+    }
+}
+// -------------------------------------------------------------------- export
+async function exportCommand(db, args) {
+    const given = args.positional[1];
+    const out = stringFlag(args, 'out');
+    if (out === undefined)
+        throw new UsageError(`--out <dir> is required: where the archive is written\n${usage()}`);
+    const company = await resolveCompany(db, given);
+    const actor = await resolveExporter(db, stringFlag(args, 'as-user'), company.id);
+    const dir = resolve(out);
+    const held = await readdir(dir).catch(() => []);
+    if (held.length > 0) {
+        throw new UsageError(`directory_not_empty: ${dir} holds ${held.length} entries. An archive is written into an empty directory.`);
+    }
+    await mkdir(join(dir, 'data'), { recursive: true });
+    heading(`Exporting ${company.name}`);
+    note(dim(`as ${actor}, under row level security`));
+    const written = await db.transaction(async (tx) => {
+        // One snapshot for the manifest and for every table.
+        await tx.exec('set transaction isolation level repeatable read');
+        await tx.query(`select set_config('request.jwt.claims', $1, true), set_config('ekwo.installing', '', true)`, [
+            JSON.stringify({ sub: actor, role: 'authenticated' }),
+        ]);
+        await tx.exec('set local role authenticated');
+        // The act goes on the trail of the company before anything is read, so the
+        // trail the archive carries says it too.
+        await tx.query(`select note_company_export($1)`, [company.id]);
+        const row = await first(tx, `select export_company_manifest($1)::text as manifest`, [company.id]);
+        if (row === undefined)
+            throw new Error('export_company_manifest() answered nothing');
+        const manifest = JSON.parse(row.manifest);
+        let rowCount = 0;
+        for (const table of manifest.tables) {
+            if (!TABLE_NAME.test(table.name))
+                throw new Error(`archive_corrupt: ${table.name} is not the name of a table`);
+            const rows = await tx.query(`select r::text as row from export_company_table($1, $2) as r`, [company.id, table.name]);
+            const body = rows.map((r) => `${r.row}\n`).join('');
+            // The database counted and hashed the same rows in the same snapshot. A
+            // difference is a bug of this CLI or of the driver, and the archive is
+            // not one to keep.
+            if (rows.length !== table.rows || sha256(body) !== table.sha256) {
+                throw new Error(`archive_corrupt: ${table.name} was read as ${rows.length} rows that do not match the manifest`);
+            }
+            await writeFile(join(dir, 'data', `${table.name}.jsonl`), body, 'utf8');
+            rowCount += rows.length;
+            if (rows.length > 0)
+                step(`${table.name} ${dim(`${rows.length} rows`)}`);
+        }
+        await writeFile(join(dir, 'manifest.json'), `${JSON.stringify(manifest, null, 2)}\n`, 'utf8');
+        return { manifest, total: rowCount };
+    });
+    const files = written.manifest.files?.list.length ?? 0;
+    line();
+    pairs([
+        ['archive', dir],
+        ['tables', String(written.manifest.tables.length)],
+        ['rows', String(written.total)],
+        ['files listed', `${files}, not carried`],
+    ]);
+    if (files > 0) {
+        warn(`${files} attachment file(s) are listed in manifest.json and are not in the archive: carry them from the storage bucket, by their path.`);
+    }
+    setResult({
+        company: { id: company.id, name: company.name },
+        actingAs: actor,
+        out: dir,
+        tables: written.manifest.tables.length,
+        rows: written.total,
+        files: { listed: files, transported: false },
+    });
+    line();
+    return 0;
+}
+// -------------------------------------------------------------------- import
+/** Reads an archive directory, checks it against its manifest, and returns it as one JSON text. */
+export async function readArchive(dir) {
+    let manifestText;
+    try {
+        manifestText = await readFile(join(dir, 'manifest.json'), 'utf8');
+    }
+    catch {
+        throw new UsageError(`not_an_archive: ${dir} holds no manifest.json`);
+    }
+    const manifest = JSON.parse(manifestText);
+    if (manifest.format !== 'ekwo.company-archive' || !Array.isArray(manifest.tables)) {
+        throw new UsageError(`not_an_archive: ${join(dir, 'manifest.json')} does not say it is an ekwo.company-archive`);
+    }
+    const parts = [];
+    let rowCount = 0;
+    for (const table of manifest.tables) {
+        // The name is what locates the file; `file` is there for a reader, and a
+        // path an archive chose is not one to open.
+        if (!TABLE_NAME.test(table.name))
+            throw new Error(`archive_corrupt: ${table.name} is not the name of a table`);
+        const body = await readFile(join(dir, 'data', `${table.name}.jsonl`), 'utf8').catch(() => undefined);
+        if (body === undefined)
+            throw new Error(`archive_corrupt: data/${table.name}.jsonl is listed in the manifest and missing`);
+        if (sha256(body) !== table.sha256) {
+            throw new Error(`archive_corrupt: data/${table.name}.jsonl does not have the checksum its manifest gives`);
+        }
+        const lines = body.split('\n').filter((l) => l.length > 0);
+        if (lines.length !== table.rows) {
+            throw new Error(`archive_corrupt: data/${table.name}.jsonl holds ${lines.length} rows and its manifest says ${table.rows}`);
+        }
+        rowCount += lines.length;
+        parts.push(`${JSON.stringify(table.name)}:[${lines.join(',')}]`);
+    }
+    return { manifest, text: `{"manifest":${manifestText},"tables":{${parts.join(',')}}}`, rows: rowCount };
+}
+async function importCommand(db, args) {
+    const given = args.positional[1];
+    if (given === undefined)
+        throw new UsageError(`name the directory of the archive\n${usage()}`);
+    const dir = resolve(given);
+    const actor = stringFlag(args, 'as-user');
+    const owner = stringFlag(args, 'owner') ?? actor;
+    const archive = await readArchive(dir);
+    heading(`Importing ${archive.manifest.company.name}`);
+    note(dim(`${archive.manifest.tables.length} tables, ${archive.rows} rows, checked against the manifest`));
+    const call = async () => {
+        const row = await first(db, `select import_company($1::jsonb, $2)::text as result`, [archive.text, owner ?? null]);
+        if (row === undefined)
+            throw new Error('import_company() answered nothing');
+        return JSON.parse(row.result);
+    };
+    // Without --as-user this connection is the installer, which is one of the
+    // two callers `import_company()` admits. With it, the schema judges that
+    // person: an administrator of the installation, or a refusal.
+    const result = actor === undefined ? await call() : await asUser(db, actor, call);
+    const files = count(result['files_to_carry']);
+    step(`${archive.manifest.company.name} is a company of this installation`);
+    line();
+    pairs([
+        ['company', String(result['company_id'])],
+        ['rows', String(result['rows'])],
+        ['owner', owner ?? 'nobody yet'],
+        ['files to carry', String(files)],
+    ]);
+    if (owner === undefined) {
+        warn('No owner was named (--owner <uuid>): the company has no member yet. An administrator of the installation invites the first one.');
+    }
+    if (files > 0) {
+        warn(`${files} attachment file(s) are listed in manifest.json and did not travel: copy them into the storage bucket under the same paths.`);
+    }
+    setResult({
+        company: { id: String(result['company_id']), name: archive.manifest.company.name },
+        rows: count(result['rows']),
+        owner: owner ?? null,
+        tables: result['tables'],
+        files: { toCarry: files },
+    });
+    line();
+    return 0;
+}
+// ------------------------------------------------------------------- helpers
+/**
+ * A count the database answered, as the JSON already carries it. Nothing is
+ * converted here: a count that did not arrive as a number is no count.
+ */
+function count(value) {
+    return typeof value === 'number' ? value : 0;
+}
+function sha256(text) {
+    return createHash('sha256').update(text, 'utf8').digest('hex');
+}
+async function resolveCompany(db, given) {
+    const companies = await db.query(`select id, name from companies order by name`);
+    if (given !== undefined) {
+        const match = companies.find((c) => c.id === given || c.name === given);
+        if (match === undefined) {
+            throw new UsageError(`unknown company: ${given}. This installation holds: ${companies.map((c) => c.name).join(', ') || 'none'}`);
+        }
+        return match;
+    }
+    const only = companies[0];
+    if (companies.length !== 1 || only === undefined) {
+        throw new UsageError(`name the company: this installation holds ${companies.length} — ` +
+            companies.map((c) => `${c.name} (${c.id})`).join(', '));
+    }
+    return only;
+}
+/**
+ * Who the export is signed by: whoever `--as-user` names, or a member who
+ * holds `company.export`, owners first. Nobody is invented — an archive says
+ * who took it, and the audit trail of the company says it too.
+ *
+ * Read from the tables: `member_capabilities()` answers about somebody else
+ * only to a member who manages the others, and this connection is nobody. It
+ * is a guess at whom to act for; the judgement is `has_capability()`'s, inside
+ * the export.
+ */
+async function resolveExporter(db, given, companyId) {
+    if (given !== undefined)
+        return given;
+    const member = await first(db, `select m.user_id
+       from company_members m
+      where m.company_id = $1
+        and not ('company.export' = any (m.capabilities_revoked))
+        and ('company.export' = any (m.capabilities_granted)
+             or exists (select 1 from role_capabilities rc
+                         where rc.role = m.role and rc.capability = 'company.export'))
+      order by (m.role = 'owner') desc, m.created_at
+      limit 1`, [companyId]);
+    if (member === undefined) {
+        throw new Error(`no_exporter: no member of company ${companyId} holds company.export. Pass --as-user <uuid>.`);
+    }
+    return member.user_id;
+}
+function usage() {
+    return `${bold('ekwo company')} — one company leaves an installation, and arrives in another.
+
+  ekwo company export <company> --out <dir>   Write the archive of one company: manifest.json
+                                              and one data/<table>.jsonl per table.
+  ekwo company import <dir>                   Take an archive into this installation, whole or
+                                              not at all. A company already here is refused.
+
+  --out <dir>        Where the archive is written. Empty, or not there yet.
+  --as-user <uuid>   export: the member the archive is read as, under row level security.
+                     Defaults to an owner of the company. Needs company.export.
+                     import: the administrator of the installation to act for. Defaults to
+                     the installer, which this connection is.
+  --owner <uuid>     import: who becomes the first owner. Members do not travel.
+                     Defaults to --as-user.
+
+  The files the attachments point at are listed in manifest.json and are not carried.
+`;
+}
+//# sourceMappingURL=company.js.map

package/dist/commands/company.js.map

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

package/dist/commands/contact.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `ekwo contact add` and `ekwo contact list` — `createContact()` and
+ * `searchContacts()` of the core, which are the MCP server's `create_contact`
+ * and `search_contacts`.
+ */
+import { type ParsedArgs } from '../args.js';
+import { type BooksDeps } from '../books.js';
+export declare function contactCommand(args: ParsedArgs, deps?: BooksDeps): Promise<number>;
+//# sourceMappingURL=contact.d.ts.map

package/dist/commands/contact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contact.d.ts","sourceRoot":"","sources":["../../src/commands/contact.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAA0D,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AACrG,OAAO,EAA8D,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAoBzG,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,GAAE,SAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAK5F"}

package/dist/commands/contact.js

@@ -0,0 +1,82 @@
+/**
+ * `ekwo contact add` and `ekwo contact list` — `createContact()` and
+ * `searchContacts()` of the core, which are the MCP server's `create_contact`
+ * and `search_contacts`.
+ */
+import { CONTACT_TYPES, createContact, searchContacts } from '@ekwo-ai/core';
+import { UsageError, numberFlag, rejectUnknownFlags, stringFlag } from '../args.js';
+import { BOOKS_FLAGS, CREATE_FLAGS, given, openBooks, stdinDocument } from '../books.js';
+import { setResult } from '../output.js';
+import { dim, heading, note, step, table } from '../ui.js';
+const ADD_FLAGS = [...CREATE_FLAGS, 'type', 'vat', 'email', 'country', 'terms', 'aux', 'address', 'postal-code', 'city'];
+const LIST_FLAGS = [...BOOKS_FLAGS, 'query', 'type', 'vat', 'limit'];
+const ADD_FIELDS = [
+    'name', 'contact_type', 'vat_number', 'email', 'country', 'payment_terms_days', 'auxiliary_code',
+    'address_line1', 'postal_code', 'city', 'client_ref',
+];
+function contactType(value) {
+    if (value === undefined)
+        return undefined;
+    if (!CONTACT_TYPES.includes(value)) {
+        throw new UsageError(`bad_type: --type is one of ${CONTACT_TYPES.join(', ')}, got "${value}".`);
+    }
+    return value;
+}
+export async function contactCommand(args, deps = {}) {
+    const action = args.positional[0];
+    if (action === 'add')
+        return add(args, deps);
+    if (action === 'list')
+        return list(args, deps);
+    throw new UsageError('usage: ekwo contact add <name> [--type --vat --email --country --terms --ref] | ekwo contact list [--query --type --vat]');
+}
+async function add(args, deps) {
+    rejectUnknownFlags(args, ADD_FLAGS);
+    const input = await stdinDocument(args, deps, ADD_FIELDS);
+    const { backend, company } = await openBooks(args, deps);
+    const fields = given({
+        ...input,
+        name: args.positional[1] ?? input['name'],
+        contact_type: contactType(stringFlag(args, 'type')) ?? input['contact_type'],
+        vat_number: stringFlag(args, 'vat') ?? input['vat_number'],
+        email: stringFlag(args, 'email') ?? input['email'],
+        country: stringFlag(args, 'country') ?? input['country'],
+        payment_terms_days: numberFlag(args, 'terms') ?? input['payment_terms_days'],
+        auxiliary_code: stringFlag(args, 'aux') ?? input['auxiliary_code'],
+        address_line1: stringFlag(args, 'address') ?? input['address_line1'],
+        postal_code: stringFlag(args, 'postal-code') ?? input['postal_code'],
+        city: stringFlag(args, 'city') ?? input['city'],
+        client_ref: stringFlag(args, 'ref') ?? input['client_ref'],
+    });
+    if (typeof fields.name !== 'string' || fields.name.length === 0) {
+        throw new UsageError('missing_argument: the name of the contact. `ekwo contact add "<name>"`, or `name` under --stdin.');
+    }
+    const result = (await createContact(backend, { ...fields, company_id: company.id }));
+    setResult(result);
+    heading('Contact');
+    const contact = result.contact;
+    if (result.replayed === true)
+        note(dim(`already created under the reference ${String(contact['client_ref'])}; nothing was written`));
+    step(`${String(contact['name'])} ${dim(String(contact['id']))}, in ${company.name}`);
+    return 0;
+}
+async function list(args, deps) {
+    rejectUnknownFlags(args, LIST_FLAGS);
+    const { backend, company } = await openBooks(args, deps);
+    const result = (await searchContacts(backend, given({
+        company_id: company.id,
+        query: stringFlag(args, 'query'),
+        contact_type: contactType(stringFlag(args, 'type')),
+        vat_number: stringFlag(args, 'vat'),
+        limit: numberFlag(args, 'limit'),
+    })));
+    setResult(result);
+    heading(`Contacts of ${company.name}`);
+    if (result.contacts.length === 0)
+        note(dim('None.'));
+    else {
+        table([{ title: 'name' }, { title: 'type' }, { title: 'vat' }, { title: 'id' }], result.contacts.map((c) => [String(c['name']), String(c['contact_type']), String(c['vat_number'] ?? ''), dim(String(c['id']))]));
+    }
+    return 0;
+}
+//# sourceMappingURL=contact.js.map

package/dist/commands/contact.js.map

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

package/dist/commands/demo.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `ekwo demo` — the sample company, on explicit request only.
+ *
+ * `90_demo_company.sql` invents a Belgian consultancy with a quarter of
+ * invoices, a matched payment and a bank statement. It is the fastest way to
+ * see what the schema does, and it has no place on real books: besides the
+ * company it also writes a fictional row into `auth.users` and makes that
+ * fictional user an instance administrator, because the seed has to stand
+ * alone on an empty database.
+ *
+ * So the command asks first, and it acts on behalf of a real administrator so
+ * the database's own rule — only an administrator appoints another — is
+ * satisfied rather than bypassed.
+ */
+import { type ParsedArgs } from '../args.js';
+import { type CommandDeps } from '../context.js';
+export declare const DEMO_FLAGS: readonly ["db-url", "db-password", "db-region", "project-ref", "supabase-url", "service-role-key", "admin-user-id", "yes"];
+export declare function demoCommand(args: ParsedArgs, deps?: CommandDeps): Promise<number>;
+//# sourceMappingURL=demo.d.ts.map

package/dist/commands/demo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo.d.ts","sourceRoot":"","sources":["../../src/commands/demo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAA4C,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvF,OAAO,EAAkC,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAQjF,eAAO,MAAM,UAAU,4HAAyD,CAAC;AAEjF,wBAAsB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoD3F"}

package/dist/commands/demo.js

@@ -0,0 +1,72 @@
+/**
+ * `ekwo demo` — the sample company, on explicit request only.
+ *
+ * `90_demo_company.sql` invents a Belgian consultancy with a quarter of
+ * invoices, a matched payment and a bank statement. It is the fastest way to
+ * see what the schema does, and it has no place on real books: besides the
+ * company it also writes a fictional row into `auth.users` and makes that
+ * fictional user an instance administrator, because the seed has to stand
+ * alone on an empty database.
+ *
+ * So the command asks first, and it acts on behalf of a real administrator so
+ * the database's own rule — only an administrator appoints another — is
+ * satisfied rather than bypassed.
+ */
+import { boolFlag, rejectUnknownFlags, stringFlag } from '../args.js';
+import { seedDir } from '../bundle.js';
+import { CONNECTION_FLAGS, openDatabase } from '../context.js';
+import { confirm, isInteractive } from '../prompt.js';
+import { anyAdminId } from '../registry.js';
+import { applyDemoSeed } from '../seeds.js';
+import { asUser, scalar } from '../sql.js';
+import { setResult } from '../output.js';
+import { dim, heading, line, note, skipped, step, warn } from '../ui.js';
+export const DEMO_FLAGS = [...CONNECTION_FLAGS, 'admin-user-id', 'yes'];
+export async function demoCommand(args, deps = {}) {
+    rejectUnknownFlags(args, DEMO_FLAGS);
+    const yes = boolFlag(args, 'yes');
+    const interactive = !yes && isInteractive();
+    const { db } = await openDatabase(args, { interactive, connect: deps.connect });
+    try {
+        heading('Demo company');
+        const already = await scalar(db, `select exists (select 1 from companies where vat_number = 'BE0123456749')`);
+        if (already === true) {
+            skipped('Exemple Conseil SRL is already here; the seed does nothing twice');
+            setResult({ applied: false, reason: 'already_there' });
+            line();
+            return 0;
+        }
+        const companies = await scalar(db, 'select count(*)::text from companies');
+        if (companies !== '0') {
+            warn(`this installation already holds ${companies ?? '0'} compan(y/ies).`);
+            note(dim('The demo adds a fictional company and a fictional administrator alongside them.'));
+            if (!yes) {
+                const go = interactive ? await confirm('Add the demo data anyway?', false) : false;
+                if (!go) {
+                    skipped('not applied');
+                    setResult({ applied: false, reason: 'not_confirmed' });
+                    note(dim('Pass --yes to apply it without being asked.'));
+                    line();
+                    return 0;
+                }
+            }
+        }
+        const adminUserId = stringFlag(args, 'admin-user-id') ?? (await anyAdminId(db));
+        if (adminUserId === undefined) {
+            // Nothing claimed yet: the seed can take the first seat itself.
+            await applyDemoSeed(db, seedDir());
+        }
+        else {
+            await asUser(db, adminUserId, () => applyDemoSeed(db, seedDir()));
+        }
+        setResult({ applied: true });
+        step('Exemple Conseil SRL: 6 contacts, 10 documents, a matched payment, a bank statement');
+        note(dim('Everything in it is invented. Drop the company when you are done looking.'));
+        line();
+        return 0;
+    }
+    finally {
+        await db.close();
+    }
+}
+//# sourceMappingURL=demo.js.map

package/dist/commands/demo.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `ekwo doctor` — the checks, printed.
+ *
+ * Exit code 1 when something is a problem, 0 otherwise. Warnings do not fail
+ * the command: an orphaned membership is worth knowing about and is not a
+ * reason for a CI job to go red.
+ */
+import { type ParsedArgs } from '../args.js';
+import { type CommandDeps } from '../context.js';
+export declare const DOCTOR_FLAGS: readonly ["db-url", "db-password", "db-region", "project-ref", "supabase-url", "service-role-key", "yes"];
+export declare function doctorCommand(args: ParsedArgs, deps?: CommandDeps): Promise<number>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAgC,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAE3E,OAAO,EAAkC,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AASjF,eAAO,MAAM,YAAY,2GAAwC,CAAC;AAsBlE,wBAAsB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmC7F"}

package/dist/commands/doctor.js

@@ -0,0 +1,68 @@
+/**
+ * `ekwo doctor` — the checks, printed.
+ *
+ * Exit code 1 when something is a problem, 0 otherwise. Warnings do not fail
+ * the command: an orphaned membership is worth knowing about and is not a
+ * reason for a CI job to go red.
+ */
+import { boolFlag, rejectUnknownFlags } from '../args.js';
+import { migrationsDir } from '../bundle.js';
+import { CONNECTION_FLAGS, openDatabase } from '../context.js';
+import { doctor } from '../doctor.js';
+import { listMigrations } from '../migrations.js';
+import { allModuleMigrations, listModules } from '../module/read.js';
+import { isInteractive } from '../prompt.js';
+import { schemaIsInstalled } from '../bootstrap.js';
+import { setResult } from '../output.js';
+import { dim, green, heading, line, red, warn, yellow } from '../ui.js';
+export const DOCTOR_FLAGS = [...CONNECTION_FLAGS, 'yes'];
+/**
+ * The migrations this release carries, the socle's and the modules'.
+ *
+ * `ekwo migrate` installs the modules by default — a module is a schema whose
+ * tables are empty until a company enables it — and records their versions in
+ * the same history table as the socle's. So a gap computed against the socle
+ * alone reads eight module versions as history this CLI has no file for, and
+ * an installation that was merely kept up to date is reported as "ahead of
+ * this CLI: upgrade the CLI before migrating" — advice to upgrade something
+ * that is already current. Found by the end-to-end run of 14 September 2026
+ * against a real project, where `ekwo migrate` and `ekwo doctor` disagreed
+ * about the same database one command apart.
+ */
+async function everything() {
+    const modules = await listModules();
+    return [...(await listMigrations(migrationsDir())), ...allModuleMigrations(modules)].sort((a, b) => a.version.localeCompare(b.version));
+}
+export async function doctorCommand(args, deps = {}) {
+    rejectUnknownFlags(args, DOCTOR_FLAGS);
+    const interactive = !boolFlag(args, 'yes') && isInteractive();
+    const { db } = await openDatabase(args, { interactive, connect: deps.connect });
+    try {
+        if (!(await schemaIsInstalled(db))) {
+            heading('Doctor');
+            warn('the schema is not installed on this project. Run `ekwo init`.');
+            return 1;
+        }
+        const migrations = await everything();
+        const report = await doctor(db, migrations);
+        setResult(report);
+        heading('Doctor');
+        for (const check of report.checks) {
+            const mark = check.severity === 'ok' ? green('ok') : check.severity === 'warning' ? yellow('warn') : red('fail');
+            line(`  ${mark.padEnd(check.severity === 'ok' ? 6 : 8)} ${check.name}: ${check.summary}`);
+            for (const detail of check.details ?? [])
+                line(`         ${dim(detail)}`);
+        }
+        line();
+        if (report.problems > 0) {
+            line(`  ${red(`${report.problems} problem(s)`)}, ${report.warnings} warning(s).`);
+            return 1;
+        }
+        line(`  ${green('No problems.')} ${report.warnings} warning(s).`);
+        return 0;
+    }
+    finally {
+        await db.close();
+    }
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/document.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The verbs on a document: `invoice new`, `invoice line add`, `post`,
+ * `doc list` and `doc show`.
+ *
+ * Each is one function of the core — `createDocument()`, `addDocumentLine()`,
+ * `postDocument()`, `listDocuments()`, `getDocument()` — which the MCP server
+ * calls for `create_document`, `post_document`, `list_documents` and
+ * `get_document`. What is printed is what came back: the totals are the
+ * database's, the entry is the one `post_document()` wrote, and a refusal is
+ * left to `output.ts` to repeat word for word.
+ */
+import { type ParsedArgs } from '../args.js';
+import { type BooksDeps } from '../books.js';
+export declare function invoiceCommand(args: ParsedArgs, deps?: BooksDeps): Promise<number>;
+export declare function postCommand(args: ParsedArgs, deps?: BooksDeps): Promise<number>;
+export declare function docCommand(args: ParsedArgs, deps?: BooksDeps): Promise<number>;
+//# sourceMappingURL=document.d.ts.map

package/dist/commands/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/commands/document.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAiBH,OAAO,EAAiF,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAC5H,OAAO,EAWL,KAAK,SAAS,EACf,MAAM,aAAa,CAAC;AA6ErB,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,GAAE,SAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAK5F;AA0ED,wBAAsB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,GAAE,SAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAczF;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,GAAE,SAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAKxF"}