ekwo-os 0.4.1

package/dist/output.js

@@ -0,0 +1,173 @@
+/**
+ * The output contract: what a command answers, and with which exit code.
+ *
+ * Every command of this CLI is run through `execute()`, so the contract is
+ * written once and a command cannot opt out of it by forgetting.
+ *
+ *   0  done.
+ *   1  it did not end well and the books were not asked: the network, a
+ *      database that does not answer, a bug — and a check that found
+ *      something (`doctor`, `pack check`, a pending migration), which is how
+ *      a CI job goes red.
+ *   2  the command was called wrong: an unknown option, a missing argument,
+ *      a question that needed an answer and no terminal to ask it on.
+ *   3  the database refused. A locked period, a capability the caller does
+ *      not hold, a tax that does not apply here. The command was well formed
+ *      and everything worked; the accounting said no.
+ *
+ * A caller — an agent with a shell, a Makefile — has to tell 2 from 3 without
+ * reading a sentence, and that is the reason 3 exists.
+ *
+ * The refusal itself is printed as the database wrote it. Its name
+ * (`period_locked`) is the part a program matches on and its sentence is the
+ * part a person reads; neither is rephrased here, and nothing in this file
+ * knows what any of the names mean. Which SQLSTATEs count as a refusal and
+ * how a name is read out of a message are in `@ekwo-ai/core`, where the MCP
+ * server reads them too.
+ */
+import { BooksError, isRefusalState, socleCode } from '@ekwo-ai/core';
+import { UsageError } from './args.js';
+import { NotInteractiveError } from './prompt.js';
+import { collectedWarnings, dim, emit, fail, isJsonMode, line, setJsonMode } from './ui.js';
+export const EXIT_OK = 0;
+export const EXIT_ERROR = 1;
+export const EXIT_USAGE = 2;
+export const EXIT_REFUSED = 3;
+let result;
+let context;
+/** Called by a command that acts as a person, as soon as it knows for which company. */
+export function setContext(value) {
+    context = value;
+}
+/**
+ * What the command answers under `--json`.
+ *
+ * Called by the command with the same values it prints, never with values of
+ * its own: a figure that exists in one of the two forms only is a bug.
+ */
+export function setResult(data) {
+    result = data;
+}
+const TWO_WORDS = new Set(['module', 'pack', 'company', 'contact', 'invoice', 'payment', 'doc']);
+/** `module list`, `pack upgrade`, `status`: the words that named the command. */
+export function commandLabel(args) {
+    if (args.command === undefined && args.flags.get('version') === true)
+        return 'version';
+    const command = args.command ?? 'help';
+    const takesAction = TWO_WORDS.has(command);
+    const action = takesAction ? args.positional[0] : undefined;
+    if (action === undefined)
+        return command;
+    // `invoice line add`: the one verb of three words.
+    if (command === 'invoice' && action === 'line' && args.positional[1] !== undefined) {
+        return `invoice line ${args.positional[1]}`;
+    }
+    return `${command} ${action}`;
+}
+function field(error, name) {
+    if (typeof error !== 'object' || error === null)
+        return undefined;
+    const value = error[name];
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+/** Which of the three an error is, and with it the exit code. */
+export function classify(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    const name = socleCode(message);
+    const named = name === undefined ? {} : { name };
+    // An error of the core's bookkeeping layer was raised before the database
+    // was asked, or about something it did not return: an unknown account code,
+    // a document that is not a draft. The call has to change; the books did not
+    // refuse, so it is not 3.
+    if (error instanceof UsageError || error instanceof NotInteractiveError || error instanceof BooksError) {
+        return { exitCode: EXIT_USAGE, error: { kind: 'usage', ...named, message } };
+    }
+    // Both drivers this CLI meets — `postgres` on a real project, PGlite in the
+    // tests — put the SQLSTATE in `code`. A Node network error has a `code` too
+    // (`ECONNREFUSED`), which is not five characters of the SQL alphabet.
+    const code = field(error, 'code');
+    const sqlstate = code !== undefined && /^[0-9A-Z]{5}$/.test(code) ? code : undefined;
+    const detail = field(error, 'detail');
+    const hint = field(error, 'hint');
+    const fromDatabase = {
+        ...(sqlstate === undefined ? {} : { sqlstate }),
+        ...(detail === undefined ? {} : { detail }),
+        ...(hint === undefined ? {} : { hint }),
+    };
+    if (isRefusalState(sqlstate)) {
+        return { exitCode: EXIT_REFUSED, error: { kind: 'refusal', ...named, message, ...fromDatabase } };
+    }
+    return { exitCode: EXIT_ERROR, error: { kind: 'technical', ...named, message, ...fromDatabase } };
+}
+/** `--json` as it was typed, for the errors that happen before flags are read. */
+export function askedForJson(argv) {
+    for (const token of argv) {
+        if (token === '--')
+            return false;
+        if (token === '--json' || token === '--json=true' || token === '--json=yes')
+            return true;
+    }
+    return false;
+}
+function printError(error) {
+    fail(error.message);
+    if (error.detail !== undefined)
+        line(`  ${dim(error.detail)}`);
+    if (error.hint !== undefined)
+        line(`  ${dim(error.hint)}`);
+}
+/** An error met before any command ran: a bad option, an unknown command. */
+export function reportFailure(command, json, error) {
+    setJsonMode(json);
+    const outcome = classify(error);
+    printError(outcome.error);
+    if (json) {
+        emit({
+            ok: false,
+            command,
+            exitCode: outcome.exitCode,
+            warnings: collectedWarnings(),
+            error: outcome.error,
+        });
+    }
+    return outcome.exitCode;
+}
+/**
+ * Runs one command under the contract.
+ *
+ * The handler prints for a person as it goes and hands `setResult()` what a
+ * program should read. Here the two are kept apart: under `--json` the prose
+ * has already gone to the standard error, and the standard output receives
+ * exactly one document — on success, on a finding, and on a refusal alike, so
+ * a caller parses the same shape whatever happened.
+ */
+export async function execute(args, json, handler) {
+    const command = commandLabel(args);
+    setJsonMode(json);
+    result = undefined;
+    context = undefined;
+    let exitCode;
+    let error;
+    try {
+        exitCode = await handler();
+    }
+    catch (thrown) {
+        const outcome = classify(thrown);
+        exitCode = outcome.exitCode;
+        error = outcome.error;
+        printError(error);
+    }
+    if (isJsonMode()) {
+        emit({
+            ok: exitCode === EXIT_OK,
+            command,
+            exitCode,
+            ...(result === undefined ? {} : { data: result }),
+            ...(context === undefined ? {} : { context }),
+            warnings: collectedWarnings(),
+            ...(error === undefined ? {} : { error }),
+        });
+    }
+    return exitCode;
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

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

package/dist/pack/certification.d.ts

@@ -0,0 +1,27 @@
+/**
+ * How a pack describes what anyone has read.
+ *
+ * One sentence, written once, printed by `ekwo init`, by `ekwo status` and in
+ * the header of every generated seed — so the three cannot say three
+ * different things about the same pack.
+ *
+ * The scale is `community`, `maintained`, `reviewed`, and the distinction it
+ * carries is the whole point: Ekwo writes a pack and tests that it is
+ * internally coherent, which is not an accountant reading it against the law.
+ * *Certified* describes a review by a named professional, and nothing else.
+ * The value `ekwo` is deprecated; it is still translated here because a
+ * database installed before September 2026 may hold it until its seeds are
+ * re-applied.
+ */
+export type Certification = 'community' | 'maintained' | 'reviewed' | 'ekwo';
+export interface CertificationFacts {
+    status: string;
+    /** The professional who read it. Only ever set on a reviewed pack. */
+    by?: string | null | undefined;
+    on?: string | null | undefined;
+}
+/** One line, in plain words, about how much anyone has read this pack. */
+export declare function describeCertification(facts: CertificationFacts): string;
+/** Whether the operator should be warned rather than merely informed. */
+export declare function needsWarning(status: string): boolean;
+//# sourceMappingURL=certification.d.ts.map

package/dist/pack/certification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"certification.d.ts","sourceRoot":"","sources":["../../src/pack/certification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,YAAY,GAAG,UAAU,GAAG,MAAM,CAAC;AAE7E,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC/B,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CAChC;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAiBvE;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEpD"}

package/dist/pack/certification.js

@@ -0,0 +1,38 @@
+/**
+ * How a pack describes what anyone has read.
+ *
+ * One sentence, written once, printed by `ekwo init`, by `ekwo status` and in
+ * the header of every generated seed — so the three cannot say three
+ * different things about the same pack.
+ *
+ * The scale is `community`, `maintained`, `reviewed`, and the distinction it
+ * carries is the whole point: Ekwo writes a pack and tests that it is
+ * internally coherent, which is not an accountant reading it against the law.
+ * *Certified* describes a review by a named professional, and nothing else.
+ * The value `ekwo` is deprecated; it is still translated here because a
+ * database installed before September 2026 may hold it until its seeds are
+ * re-applied.
+ */
+/** One line, in plain words, about how much anyone has read this pack. */
+export function describeCertification(facts) {
+    const by = facts.by === null || facts.by === undefined || facts.by === '' ? undefined : facts.by;
+    const on = facts.on === null || facts.on === undefined || facts.on === '' ? undefined : facts.on;
+    switch (facts.status) {
+        case 'reviewed':
+            return by === undefined
+                ? 'reviewed by an accountant'
+                : `reviewed by ${by}${on === undefined ? '' : ` on ${on}`}`;
+        case 'maintained':
+        case 'ekwo':
+            return 'maintained by Ekwo — not yet reviewed by an accountant';
+        case 'community':
+            return 'community pack — not reviewed';
+        default:
+            return `certification ${facts.status}`;
+    }
+}
+/** Whether the operator should be warned rather than merely informed. */
+export function needsWarning(status) {
+    return status !== 'reviewed';
+}
+//# sourceMappingURL=certification.js.map

package/dist/pack/certification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"certification.js","sourceRoot":"","sources":["../../src/pack/certification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAWH,0EAA0E;AAC1E,MAAM,UAAU,qBAAqB,CAAC,KAAyB;IAC7D,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,KAAK,IAAI,IAAI,KAAK,CAAC,EAAE,KAAK,SAAS,IAAI,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;IACjG,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,KAAK,IAAI,IAAI,KAAK,CAAC,EAAE,KAAK,SAAS,IAAI,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;IAEjG,QAAQ,KAAK,CAAC,MAAM,EAAE,CAAC;QACrB,KAAK,UAAU;YACb,OAAO,EAAE,KAAK,SAAS;gBACrB,CAAC,CAAC,2BAA2B;gBAC7B,CAAC,CAAC,eAAe,EAAE,GAAG,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,EAAE,CAAC;QAChE,KAAK,YAAY,CAAC;QAClB,KAAK,MAAM;YACT,OAAO,wDAAwD,CAAC;QAClE,KAAK,WAAW;YACd,OAAO,+BAA+B,CAAC;QACzC;YACE,OAAO,iBAAiB,KAAK,CAAC,MAAM,EAAE,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,MAAM,KAAK,UAAU,CAAC;AAC/B,CAAC"}

package/dist/pack/compile.d.ts

@@ -0,0 +1,75 @@
+/**
+ * The compiler: a pack in, one seed file out.
+ *
+ * The SQL is a build artefact, like `docs/schema.md`. The source is the pack,
+ * the output is committed so that `supabase db push` and `psql -f` install a
+ * country without this CLI ever running, and `ekwo pack check` refuses an
+ * output that is no longer what its pack says. The order of every row is
+ * fixed here, so the same pack always compiles to the same bytes.
+ *
+ * Every insert **upserts on the template tables and on nothing else**. The
+ * seeds used to say `on conflict do nothing`, which meant an instance
+ * installed last month never received a single pack change — not even for a
+ * company created afterwards, since a company copies the templates at
+ * install. A template is reference data and a seed is allowed to re-state it;
+ * a row that belongs to a company is never touched here, and moving a company
+ * from one pack version to the next is `ekwo pack upgrade`, still to come, which
+ * shows the diff first.
+ *
+ * What an upsert cannot do is remove: a template dropped from a pack stays in
+ * the database. That is the rule anyway — nothing is ever deleted from a
+ * pack, an account is deprecated and a tax gets a `valid_to`.
+ */
+import { type FrameworkPack, type Pack } from './read.js';
+/**
+ * Which number each pack's compiled seed carries, by slug.
+ *
+ * **The number is the pack's own, and a number that has shipped never moves.**
+ * The seeds are applied in file-name order and are listed by name in
+ * `supabase/config.toml`, so a release that renamed one would rename a file an
+ * installation already holds — harmless, because the seeds upsert, and
+ * inexplicable to whoever reads the list a year later.
+ *
+ * It used to be the pack's rank in the alphabetical list of slugs, which is
+ * stable exactly until a country is added in the middle of it: inserting `ee`
+ * between `be` and `fr` moved France and Luxembourg one place each. So a pack
+ * **declares** its number, in `seed_sequence`, and nothing here sorts anything.
+ */
+export declare function seedFileNames(allSlugs: readonly string[], sequences: ReadonlyMap<string, number>): Map<string, string>;
+/** `packs/be` → `10_pack_be.sql`, `packs/ee` → `13_pack_ee.sql`. */
+export declare function seedFileName(slug: string, allSlugs: readonly string[], sequences: ReadonlyMap<string, number>): string;
+export declare function compilePack(pack: Pack): string;
+/**
+ * The country data of one module, for one pack:
+ * `supabase/seed/modules/assets/10_pack_be.sql`.
+ *
+ * It is a seed of its own, under the module's own folder, and deliberately not
+ * part of the pack seed. The pack seed is applied by every installation;
+ * `assets.category_templates` does not exist on one that does not carry the
+ * module, and a seed that half fails is a seed nobody can re-run. So the
+ * module migration runner applies these, and only for the modules it installed.
+ *
+ * The numbering is the pack's own — `10_pack_be`, `13_pack_ee` — so the file
+ * of a country is recognisable wherever it sits.
+ */
+export declare function moduleSeedFileName(slug: string, allSlugs: readonly string[], sequences: ReadonlyMap<string, number>): string;
+/**
+ * `packs/<cc>/assets.json` → the two reference tables of the `assets` module.
+ *
+ * Returns `undefined` when the pack says nothing about fixed assets, which is
+ * not a gap to fill: `assets.generate_schedule` refuses by name where it needs
+ * a prorata convention nobody has declared, rather than taking another
+ * country's.
+ */
+export declare function compileAssetsSeed(pack: Pack): string | undefined;
+/** Every module seed a pack compiles to, by module code. */
+export declare function compileModuleSeeds(pack: Pack): Map<string, string>;
+/** `packs/generic` → `05_framework_generic.sql`. It sorts before every pack. */
+export declare function frameworkSeedFileName(slug: string): string;
+/**
+ * The framework pack: statements with no country, and nothing else. They are
+ * seeded before the country packs because a chart may name one, and because a
+ * company whose country has no pack at all still gets a balance sheet.
+ */
+export declare function compileFrameworkPack(pack: FrameworkPack): string;
+//# sourceMappingURL=compile.d.ts.map

package/dist/pack/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/pack/compile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EAAa,KAAK,aAAa,EAAE,KAAK,IAAI,EAAuC,MAAM,WAAW,CAAC;AAE1G;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAoBrB;AAED,oEAAoE;AACpE,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,MAAM,CAIR;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAkB9C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,MAAM,CAER;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CA2EhE;AAED,4DAA4D;AAC5D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAKlE;AAED,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAuBhE"}