ekwo-os 0.4.1

package/dist/commands/payment.js

@@ -0,0 +1,97 @@
+/**
+ * `ekwo payment record` and `ekwo match`.
+ *
+ * `recordPayment()` of the core is the MCP server's `record_payment`: it
+ * inserts the payment, has `post_payment()` book it and `reconcile()` match
+ * it. `settleFromStatement()` is `settle_from_statement()` of the schema: the
+ * statement line is booked as the payment it is and matched to what is open
+ * on the document. Which way the money goes, who it is from and how much is
+ * still owed are read from the ledger, never worked out here.
+ */
+import { recordPayment, resolveContact, resolveDocument, settleFromStatement } from '@ekwo-ai/core';
+import { UsageError, boolFlag, rejectUnknownFlags, stringFlag } from '../args.js';
+import { BOOKS_FLAGS, CREATE_FLAGS, given, openBooks, required, stdinDocument, today, uuidArg } from '../books.js';
+import { setResult } from '../output.js';
+import { dim, heading, line, note, pairs, step } from '../ui.js';
+const RECORD_FLAGS = [
+    ...CREATE_FLAGS, 'doc', 'contact', 'direction', 'amount', 'date', 'bank-account', 'journal', 'reference', 'memo', 'currency', 'rate', 'no-match',
+];
+const RECORD_FIELDS = [
+    'document_id', 'document', 'contact_id', 'contact', 'direction', 'amount', 'payment_date', 'bank_account_id', 'journal_id',
+    'journal_code', 'reference', 'memo', 'currency_code', 'exchange_rate', 'match_open_items', 'client_ref',
+];
+const text = (value) => (value === null || value === undefined ? '' : String(value));
+export async function paymentCommand(args, deps = {}) {
+    if (args.positional[0] !== 'record') {
+        throw new UsageError('usage: ekwo payment record --doc <document> --amount <amount> [--date --bank-account <id> | --journal <code>] [--ref]');
+    }
+    rejectUnknownFlags(args, RECORD_FLAGS);
+    const input = await stdinDocument(args, deps, RECORD_FIELDS);
+    const { backend, company } = await openBooks(args, deps);
+    const doc = stringFlag(args, 'doc') ?? input['document_id'] ?? input['document'];
+    const who = stringFlag(args, 'contact') ?? input['contact_id'] ?? input['contact'];
+    const direction = stringFlag(args, 'direction') ?? input['direction'];
+    if (direction !== undefined && direction !== 'inbound' && direction !== 'outbound') {
+        throw new UsageError(`bad_value: --direction is inbound or outbound, got "${direction}".`);
+    }
+    const bankAccount = stringFlag(args, 'bank-account') ?? input['bank_account_id'];
+    const date = stringFlag(args, 'date') ?? input['payment_date'];
+    const paymentDate = date ?? today();
+    const fields = given({
+        company_id: company.id,
+        document_id: doc === undefined ? undefined : await resolveDocument(backend, company.id, doc),
+        contact_id: who === undefined ? undefined : (await resolveContact(backend, company.id, who)).id,
+        direction,
+        amount: required(stringFlag(args, 'amount') ?? input['amount'], 'the amount paid', '--amount'),
+        payment_date: paymentDate,
+        bank_account_id: bankAccount === undefined ? undefined : uuidArg(bankAccount, '--bank-account'),
+        journal_id: input['journal_id'],
+        journal_code: stringFlag(args, 'journal') ?? input['journal_code'],
+        reference: stringFlag(args, 'reference') ?? input['reference'],
+        memo: stringFlag(args, 'memo') ?? input['memo'],
+        currency_code: stringFlag(args, 'currency') ?? input['currency_code'],
+        exchange_rate: stringFlag(args, 'rate') ?? input['exchange_rate'],
+        match_open_items: boolFlag(args, 'no-match') ? false : input['match_open_items'],
+        client_ref: stringFlag(args, 'ref') ?? input['client_ref'],
+    });
+    const result = (await recordPayment(backend, fields));
+    setResult(result);
+    const payment = (result['payment'] ?? {});
+    const entry = (result['entry'] ?? {});
+    const matched = (result['matched'] ?? []);
+    heading(`Payment, in ${company.name}`);
+    if (result['replayed'] === true)
+        note(dim(`already recorded under the reference ${text(fields.client_ref)}; nothing was recorded twice`));
+    if (date === undefined)
+        note(dim(`dated today, ${paymentDate}: no --date was given`));
+    pairs([
+        ['payment', `${text(payment['direction'])} ${text(payment['amount'])} ${text(payment['currency_code'])}  ${dim(text(payment['id']))}`],
+        ['date', text(payment['payment_date'])],
+        ['entry', text(entry['number'])],
+    ]);
+    line();
+    if (matched.length === 0)
+        note(dim('Matched against nothing.'));
+    for (const matching of matched)
+        step(`matched ${text(matching?.['amount'])} under ${text(matching?.['matching_number'])}`);
+    line();
+    note(dim(text(result['note'])));
+    return 0;
+}
+export async function matchCommand(args, deps = {}) {
+    rejectUnknownFlags(args, BOOKS_FLAGS);
+    const { backend, company } = await openBooks(args, deps);
+    const transactionId = uuidArg(args.positional[0], 'the bank transaction');
+    const documentId = await resolveDocument(backend, company.id, required(args.positional[1], 'the document it pays', '<document>'));
+    const result = (await settleFromStatement(backend, { transaction_id: transactionId, document_id: documentId }));
+    setResult({ document_id: documentId, ...result });
+    const transaction = (result['transaction'] ?? {});
+    heading(`Statement line, in ${company.name}`);
+    pairs([
+        ['line', `${text(transaction['transaction_date'])}  ${text(transaction['amount'])} ${text(transaction['currency_code'])}  ${dim(text(transaction['id']))}`],
+        ['state', text(transaction['state'])],
+        ['entry', dim(text(transaction['entry_id']))],
+    ]);
+    return 0;
+}
+//# sourceMappingURL=payment.js.map

package/dist/commands/payment.js.map

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

package/dist/commands/register.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `ekwo register` and `ekwo unregister`.
+ *
+ * Registering is an opt-in and it is reversible, which is the only thing that
+ * makes it a choice. Neither command is ever required, and nothing in the
+ * schema or the CLI reads the result to decide what you may do.
+ *
+ * `register` also serves as the retry: the endpoint at Ekwo does not exist
+ * yet, so an installation that opted in during `ekwo init` may have recorded
+ * the intent locally and failed to announce it. Running this again sends it.
+ */
+import { type ParsedArgs } from '../args.js';
+import { type CommandDeps } from '../context.js';
+export declare const REGISTER_FLAGS: readonly ["db-url", "db-password", "db-region", "project-ref", "supabase-url", "service-role-key", "email", "org", "country", "registry-url", "admin-user-id", "yes"];
+export declare const UNREGISTER_FLAGS: readonly ["db-url", "db-password", "db-region", "project-ref", "supabase-url", "service-role-key", "admin-user-id", "yes"];
+export declare function registerCommand(args: ParsedArgs, deps?: CommandDeps & {
+    fetchImpl?: typeof globalThis.fetch | undefined;
+}): Promise<number>;
+export declare function unregisterCommand(args: ParsedArgs, deps?: CommandDeps): Promise<number>;
+//# sourceMappingURL=register.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/commands/register.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAA4C,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AACvF,OAAO,EAAkC,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAcjF,eAAO,MAAM,cAAc,uKAQjB,CAAC;AAEX,eAAO,MAAM,gBAAgB,4HAAyD,CAAC;AAEvF,wBAAsB,eAAe,CACnC,IAAI,EAAE,UAAU,EAChB,IAAI,GAAE,WAAW,GAAG;IAAE,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,GAAG,SAAS,CAAA;CAAO,GAC3E,OAAO,CAAC,MAAM,CAAC,CAyDjB;AA2BD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAwCjG"}

package/dist/commands/register.js

@@ -0,0 +1,134 @@
+/**
+ * `ekwo register` and `ekwo unregister`.
+ *
+ * Registering is an opt-in and it is reversible, which is the only thing that
+ * makes it a choice. Neither command is ever required, and nothing in the
+ * schema or the CLI reads the result to decide what you may do.
+ *
+ * `register` also serves as the retry: the endpoint at Ekwo does not exist
+ * yet, so an installation that opted in during `ekwo init` may have recorded
+ * the intent locally and failed to announce it. Running this again sends it.
+ */
+import { boolFlag, rejectUnknownFlags, stringFlag } from '../args.js';
+import { CONNECTION_FLAGS, openDatabase } from '../context.js';
+import { NotInteractiveError, askRequired, isInteractive } from '../prompt.js';
+import { anyAdminId, announce, payloadFor, readInstance, register, registryUrl, unregister, } from '../registry.js';
+import { dim, heading, line, note, skipped, step, warn } from '../ui.js';
+import { setResult } from '../output.js';
+export const REGISTER_FLAGS = [
+    ...CONNECTION_FLAGS,
+    'email',
+    'org',
+    'country',
+    'registry-url',
+    'admin-user-id',
+    'yes',
+];
+export const UNREGISTER_FLAGS = [...CONNECTION_FLAGS, 'admin-user-id', 'yes'];
+export async function registerCommand(args, deps = {}) {
+    rejectUnknownFlags(args, REGISTER_FLAGS);
+    const interactive = !boolFlag(args, 'yes') && isInteractive();
+    const { db } = await openDatabase(args, { interactive, connect: deps.connect });
+    try {
+        const instance = await readInstance(db);
+        if (instance === undefined) {
+            warn('this installation has no instance row yet. Run `ekwo init` first.');
+            return 1;
+        }
+        const adminUserId = stringFlag(args, 'admin-user-id') ?? (await anyAdminId(db));
+        if (adminUserId === undefined) {
+            warn('no instance administrator on this installation; there is nobody to register as.');
+            return 1;
+        }
+        const url = stringFlag(args, 'registry-url') ?? registryUrl();
+        // Already registered and only the announcement is missing: just send it.
+        const email = stringFlag(args, 'email') ??
+            instance.contact_email ??
+            (interactive ? await askRequired('Contact address?') : undefined);
+        if (email === undefined)
+            throw new NotInteractiveError('the contact address', '--email');
+        heading('Registration');
+        if (instance.registered_at !== null && stringFlag(args, 'email') === undefined) {
+            skipped(`already registered as ${instance.contact_email ?? email}; re-sending the announcement`);
+            const result = await announce(payloadFor(instance, email), {
+                url,
+                ...(deps.fetchImpl !== undefined ? { fetchImpl: deps.fetchImpl } : {}),
+            });
+            report(result.announced, url, result.reason);
+            setResult(registration(true, instance.contact_email ?? email, url, result));
+            return 0;
+        }
+        const result = await register(db, {
+            adminUserId,
+            email,
+            url,
+            ...(stringFlag(args, 'org') !== undefined ? { organization: stringFlag(args, 'org') } : {}),
+            ...(stringFlag(args, 'country') !== undefined
+                ? { country: stringFlag(args, 'country') }
+                : {}),
+            ...(deps.fetchImpl !== undefined ? { fetchImpl: deps.fetchImpl } : {}),
+        });
+        step(`recorded on the instance row: ${email}`);
+        note(dim(`Sent: ${JSON.stringify(result.payload)}`));
+        report(result.announced, url, result.reason);
+        setResult(registration(true, email, url, result));
+        return 0;
+    }
+    finally {
+        await db.close();
+    }
+}
+function registration(registered, email, url, result) {
+    return {
+        registered,
+        email,
+        registryUrl: url,
+        announced: result.announced,
+        ...(result.reason === undefined ? {} : { reason: result.reason }),
+    };
+}
+function report(announced, url, reason) {
+    if (announced) {
+        step(`announced to ${url}`);
+    }
+    else {
+        warn(`could not reach ${url} (${reason ?? 'unknown'}).`);
+        note(dim('The local registration stands. Run `ekwo register` again when you can.'));
+    }
+    line();
+}
+export async function unregisterCommand(args, deps = {}) {
+    rejectUnknownFlags(args, UNREGISTER_FLAGS);
+    const interactive = !boolFlag(args, 'yes') && isInteractive();
+    const { db } = await openDatabase(args, { interactive, connect: deps.connect });
+    try {
+        const instance = await readInstance(db);
+        if (instance === undefined) {
+            warn('this installation has no instance row. Nothing to undo.');
+            return 1;
+        }
+        heading('Registration');
+        if (instance.registered_at === null) {
+            skipped('this installation is not registered');
+            setResult({ registered: false, changed: false });
+            line();
+            return 0;
+        }
+        const adminUserId = stringFlag(args, 'admin-user-id') ?? (await anyAdminId(db));
+        if (adminUserId === undefined) {
+            warn('no instance administrator on this installation.');
+            return 1;
+        }
+        await unregister(db, adminUserId);
+        setResult({ registered: false, changed: true });
+        step('the address and the date are cleared on the instance row');
+        note(dim('Nothing is sent to Ekwo: the CLI only clears the local row. ' +
+            'Write to privacy@ekwo.ai to have a registration deleted at our end.'));
+        line();
+        return 0;
+    }
+    finally {
+        await db.close();
+    }
+}
+//# sourceMappingURL=register.js.map

package/dist/commands/register.js.map

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

package/dist/commands/status.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `ekwo status` — what is on the other end of the connection string.
+ */
+import { type ParsedArgs } from '../args.js';
+import { type CommandDeps } from '../context.js';
+export declare const STATUS_FLAGS: readonly ["db-url", "db-password", "db-region", "project-ref", "supabase-url", "service-role-key", "yes"];
+export declare function statusCommand(args: ParsedArgs, deps?: CommandDeps): Promise<number>;
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAgC,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAG3E,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,CAiH7F"}

package/dist/commands/status.js

@@ -0,0 +1,134 @@
+/**
+ * `ekwo status` — what is on the other end of the connection string.
+ */
+import { boolFlag, rejectUnknownFlags } from '../args.js';
+import { migrationsDir } from '../bundle.js';
+import { describeCertification } from '../pack/certification.js';
+import { CONNECTION_FLAGS, openDatabase } from '../context.js';
+import { listMigrations } from '../migrations.js';
+import { allModuleMigrations, listModules } from '../module/read.js';
+import { isInteractive } from '../prompt.js';
+import { SCHEMA_MIN } from '../schema.js';
+import { status } from '../status.js';
+import { setResult } from '../output.js';
+import { dim, heading, line, note, pairs, warn, yellow } from '../ui.js';
+export const STATUS_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 statusCommand(args, deps = {}) {
+    rejectUnknownFlags(args, STATUS_FLAGS);
+    const interactive = !boolFlag(args, 'yes') && isInteractive();
+    const { db, connection } = await openDatabase(args, { interactive, connect: deps.connect });
+    try {
+        const migrations = await everything();
+        const report = await status(db, migrations);
+        setResult(report);
+        if (!report.schemaInstalled) {
+            heading('Schema');
+            warn('not installed on this project. Run `ekwo init`.');
+            return 1;
+        }
+        heading('Schema');
+        pairs([
+            ['project', connection.supabaseUrl ?? connection.projectRef ?? '(from --db-url)'],
+            ['installed version', report.installedVersion ?? 'unknown'],
+            ['available version', report.availableVersion ?? 'unknown'],
+            ['this CLI needs', `${SCHEMA_MIN} or newer`],
+            ['migrations', `${report.appliedCount} applied, ${report.pending.length} pending`],
+        ]);
+        if (report.pending.length > 0) {
+            line();
+            for (const migration of report.pending)
+                note(yellow(`pending  ${migration.file}`));
+            note(dim('Run `ekwo migrate` to apply them.'));
+        }
+        if (report.unknown.length > 0) {
+            line();
+            warn(`${report.unknown.length} migration(s) applied here are not in this release.`);
+        }
+        heading('Instance');
+        if (report.instance === undefined) {
+            note(dim('the schema is there but init_instance() has not run — `ekwo init` finishes it'));
+        }
+        else {
+            pairs([
+                ['organisation', report.instance.organization_name],
+                ['country', report.instance.country],
+                ['edition', report.instance.edition],
+                ['instance id', report.instance.instance_id],
+                ['administrators', String(report.admins)],
+                [
+                    'registered',
+                    report.instance.registered_at === null
+                        ? 'no'
+                        : `${report.instance.contact_email ?? ''} since ${report.instance.registered_at}`,
+                ],
+            ]);
+        }
+        heading(`Country packs (${report.packs.length})`);
+        if (report.packs.length === 0) {
+            note(dim('none recorded — this installation was seeded before packs, or the seeds have not run'));
+        }
+        else {
+            pairs(report.packs.map((p) => [
+                `${p.country} ${p.name}`,
+                `${p.version} · ${describeCertification({
+                    status: p.certificationStatus,
+                    by: p.certifiedBy,
+                    on: p.certifiedAt,
+                })} · charts: ${p.charts.length === 0
+                    ? 'none recorded'
+                    : p.charts.map((c) => `${c.code}${c.isDefault ? ' (default)' : ''}`).join(', ')}${p.einvoiceProfile === null ? '' : ` · e-invoicing: ${p.einvoiceProfile}`}`,
+            ]));
+        }
+        heading(`Companies (${report.companies.length})`);
+        if (report.companies.length === 0) {
+            note(dim('none yet'));
+        }
+        else {
+            pairs(report.companies.map((c) => [
+                c.name,
+                `${c.country} · pack ${c.packVersion ?? 'unknown'} · chart ${c.chartCode ?? 'unknown'} · ` +
+                    `files ${c.filingPeriods.length === 0
+                        ? 'nothing on a recorded cadence'
+                        : c.filingPeriods
+                            .map((f) => `${f.reportName ?? f.reportCode} every ${f.period}`)
+                            .join(', ')} · ` +
+                    `${c.accounts} accounts · ${c.entries} entries · ` +
+                    `${c.fiscalYears} financial year(s), ${c.fiscalYears - c.closedFiscalYears} open` +
+                    (c.liveShares === 0 ? '' : ` · ${c.liveShares} document(s) published behind a link`),
+            ]));
+            const behind = report.companies.filter((c) => {
+                const loaded = report.packs.find((p) => p.country === c.country);
+                return loaded !== undefined && c.packVersion !== null && c.packVersion !== loaded.version;
+            });
+            for (const company of behind) {
+                const loaded = report.packs.find((p) => p.country === company.country);
+                line();
+                warn(`${company.name} copied ${company.country} pack ${company.packVersion}, this installation holds ` +
+                    `${loaded?.version}. \`ekwo pack upgrade\` will show the difference.`);
+            }
+        }
+        line();
+        return report.pending.length > 0 ? 1 : 0;
+    }
+    finally {
+        await db.close();
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

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

package/dist/commands/whoami.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `ekwo whoami` and `ekwo use`.
+ *
+ * `whoami` answers the four questions a caller has before it touches a
+ * ledger: who am I here, on which instance and at which schema version, which
+ * companies can I see, and what may I do on the one in use. Every part of the
+ * answer is asked of the instance as the person — the companies are the rows
+ * the policies let through, and the capabilities are `member_capabilities()`,
+ * the function the MCP server calls for `your_capabilities`. Nothing is
+ * worked out here.
+ *
+ * `use` records the company the next commands run on. It is checked against
+ * the instance first, as the person: a company they cannot see is unknown.
+ */
+import { type ParsedArgs } from '../args.js';
+import { type UserDeps } from '../identity.js';
+export declare const WHOAMI_FLAGS: readonly ["profile", "company", "supabase-url", "anon-key"];
+export declare const USE_FLAGS: readonly ["profile"];
+export declare function whoamiCommand(args: ParsedArgs, deps?: UserDeps): Promise<number>;
+export declare function useCommand(args: ParsedArgs, deps?: UserDeps): Promise<number>;
+//# sourceMappingURL=whoami.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"whoami.d.ts","sourceRoot":"","sources":["../../src/commands/whoami.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAA8C,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzF,OAAO,EAA8D,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAM3G,eAAO,MAAM,YAAY,6DAA+B,CAAC;AACzD,eAAO,MAAM,SAAS,sBAAuB,CAAC;AAwB9C,wBAAsB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,GAAE,QAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CA6E1F;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,GAAE,QAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CA8BvF"}

package/dist/commands/whoami.js

@@ -0,0 +1,133 @@
+/**
+ * `ekwo whoami` and `ekwo use`.
+ *
+ * `whoami` answers the four questions a caller has before it touches a
+ * ledger: who am I here, on which instance and at which schema version, which
+ * companies can I see, and what may I do on the one in use. Every part of the
+ * answer is asked of the instance as the person — the companies are the rows
+ * the policies let through, and the capabilities are `member_capabilities()`,
+ * the function the MCP server calls for `your_capabilities`. Nothing is
+ * worked out here.
+ *
+ * `use` records the company the next commands run on. It is checked against
+ * the instance first, as the person: a company they cannot see is unknown.
+ */
+import { schemaIsAtLeast } from '@ekwo-ai/core';
+import { UsageError, rejectUnknownFlags, stringFlag } from '../args.js';
+import { matchCompany } from '../company.js';
+import { IDENTITY_FLAGS, actAsUser, refuseInstallerKey } from '../identity.js';
+import { setContext, setResult } from '../output.js';
+import { readProfiles, writeProfiles } from '../profiles.js';
+import { SCHEMA_MIN } from '../schema.js';
+import { bold, dim, heading, line, note, pairs, step, table, warn } from '../ui.js';
+export const WHOAMI_FLAGS = [...IDENTITY_FLAGS];
+export const USE_FLAGS = ['profile'];
+const COMPANY_COLUMNS = ['id', 'name', 'country', 'currency_code'];
+function visibleCompanies(acting) {
+    return acting.client.select('companies', { columns: COMPANY_COLUMNS, order: 'name.asc' });
+}
+/** `setof text` arrives as strings over PostgREST, and as one-column rows from some gateways. */
+function capabilityCodes(rows) {
+    return rows
+        .map((row) => typeof row === 'string' ? row : row?.['member_capabilities'])
+        .filter((code) => typeof code === 'string');
+}
+export async function whoamiCommand(args, deps = {}) {
+    refuseInstallerKey(args);
+    rejectUnknownFlags(args, WHOAMI_FLAGS);
+    const acting = await actAsUser(args, deps);
+    const instance = acting.client.instance.supabaseUrl;
+    const user = await acting.client.user();
+    const companies = await visibleCompanies(acting);
+    // `--company` for this one answer, else the one in use. A company in use
+    // that is no longer visible — a membership that ended — is said, not hidden.
+    const asked = stringFlag(args, 'company');
+    let company;
+    if (asked !== undefined)
+        company = matchCompany(companies, asked);
+    else if (acting.storedCompany !== undefined) {
+        const stored = acting.storedCompany;
+        company = companies.find((c) => c.id === stored.id);
+        if (company === undefined) {
+            warn(`the company in use, ${stored.name}, is no longer visible to you. \`ekwo use <company>\` picks another.`);
+        }
+    }
+    setContext({
+        profile: acting.profile ?? null,
+        instance,
+        company: company === undefined ? null : { id: company.id, name: company.name },
+    });
+    const versions = await acting.client.rpc('ekwo_schema_version');
+    const schemaVersion = typeof versions[0] === 'string' ? versions[0] : null;
+    if (schemaVersion !== null && !schemaIsAtLeast(schemaVersion, SCHEMA_MIN)) {
+        warn(`this instance is at schema ${schemaVersion} and this CLI is written against ${SCHEMA_MIN}. Its operator runs \`ekwo migrate\`.`);
+    }
+    const capabilities = company === undefined
+        ? null
+        : capabilityCodes(await acting.client.rpc('member_capabilities', { p_company_id: company.id }));
+    const profiles = acting.source === 'profile' ? Object.keys((await readProfiles(acting.configDir)).profiles).sort() : [];
+    setResult({
+        source: acting.source,
+        profile: acting.profile ?? null,
+        profiles,
+        instance: { url: instance, schemaVersion },
+        user: { id: user.id, email: user.email ?? null },
+        company: company ?? null,
+        capabilities,
+        companies: companies.map((c) => ({ ...c, inUse: c.id === company?.id })),
+    });
+    heading('Who');
+    pairs([
+        ['user', `${user.email ?? dim('no address')}  ${dim(user.id)}`],
+        ['instance', instance],
+        ['schema', schemaVersion ?? dim('unknown')],
+        ['from', acting.source === 'environment' ? 'the environment' : `the profile ${acting.profile}`],
+    ]);
+    heading('Companies you can see');
+    if (companies.length === 0)
+        note(dim('None. Somebody has to invite you to one.'));
+    else {
+        table([{ title: '' }, { title: 'name' }, { title: 'country' }, { title: 'currency' }, { title: 'id' }], companies.map((c) => [c.id === company?.id ? '*' : '', c.name, c.country, c.currency_code, dim(c.id)]));
+    }
+    if (company !== undefined && capabilities !== null) {
+        heading(`What you may do on ${company.name}`);
+        if (capabilities.length === 0)
+            note(dim('Nothing: you are not a member of it.'));
+        else
+            for (const code of capabilities)
+                line(`  ${code}`);
+    }
+    else {
+        line();
+        note(dim(`No company in use. ${bold('ekwo use <company>')} picks one; --company names one for a single command.`));
+    }
+    return 0;
+}
+export async function useCommand(args, deps = {}) {
+    refuseInstallerKey(args);
+    rejectUnknownFlags(args, USE_FLAGS);
+    const wanted = args.positional[0];
+    if (wanted === undefined || args.positional.length > 1) {
+        throw new UsageError('usage: ekwo use <company> — its name, in quotes when it has a space, or its id');
+    }
+    const acting = await actAsUser(args, deps);
+    if (acting.profile === undefined) {
+        throw new UsageError('no_profile: the environment says who you are, and the environment has nowhere to keep a company. Pass --company to each command instead.');
+    }
+    const company = matchCompany(await visibleCompanies(acting), wanted);
+    const ref = { id: company.id, name: company.name };
+    const file = await readProfiles(acting.configDir);
+    const profile = file.profiles[acting.profile];
+    if (profile === undefined)
+        throw new UsageError(`unknown_profile: there is no profile called ${acting.profile}.`);
+    await writeProfiles(acting.configDir, {
+        ...file,
+        profiles: { ...file.profiles, [acting.profile]: { ...profile, company: ref } },
+    });
+    setContext({ profile: acting.profile, instance: acting.client.instance.supabaseUrl, company: ref });
+    setResult({ profile: acting.profile, company });
+    heading('Company in use');
+    step(`${company.name} ${dim(company.id)}, for the profile ${acting.profile}`);
+    return 0;
+}
+//# sourceMappingURL=whoami.js.map

package/dist/commands/whoami.js.map

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

package/dist/company.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The company a name or an id refers to, among those a caller can see.
+ *
+ * A name is what a person types and a uuid is what a script passes, so both
+ * are accepted; an ambiguous name is refused rather than resolved to the first
+ * match, because working on the wrong company is not a mistake anybody
+ * notices the same day. The list is whatever the caller was allowed to read —
+ * every company for the installer's connection, the ones row level security
+ * lets through for a person — so a company somebody was never invited to is
+ * simply unknown, which is also all they should learn about it.
+ */
+export declare function matchCompany<C extends {
+    id: string;
+    name: string;
+}>(companies: readonly C[], wanted: string): C;
+//# sourceMappingURL=company.d.ts.map

package/dist/company.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"company.d.ts","sourceRoot":"","sources":["../src/company.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,wBAAgB,YAAY,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,CAkB/G"}