ekwo-os 0.24.0 → 0.25.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (60) hide show
  1. package/README.md +9 -1
  2. package/dist/assets/expected-objects.json +618 -4
  3. package/dist/assets/migrations/20261029010000_a_pack_names_the_words_of_its_invoices.sql +36 -0
  4. package/dist/assets/migrations/20261029010100_a_late_payment_mention_is_the_companys_choice.sql +104 -0
  5. package/dist/assets/migrations/20261029010200_a_company_is_counted_never_read.sql +175 -0
  6. package/dist/assets/migrations/20261029010300_a_contact_has_a_statement.sql +174 -0
  7. package/dist/assets/migrations/20261029010400_a_bank_account_is_created_by_its_function.sql +359 -0
  8. package/dist/assets/migrations/20261029010500_an_archive_is_read_in_pages.sql +471 -0
  9. package/dist/assets/migrations/20261029020000_schema_version_0_25_0.sql +47 -0
  10. package/dist/assets/migrations/20261101070518_a_statement_is_recognised_in_any_format.sql +467 -0
  11. package/dist/assets/migrations/20261103175933_duplicates_are_proposed_among_the_contacts_of_a_kind.sql +316 -0
  12. package/dist/assets/modules/consolidation/module.json +12 -0
  13. package/dist/assets/modules/consolidation/supabase/migrations/20261029030000_consolidation.sql +566 -0
  14. package/dist/assets/modules/consolidation/supabase/migrations/20261029071412_consolidation_intragroup.sql +231 -0
  15. package/dist/assets/modules/consolidation/supabase/migrations/20261030070000_consolidation_translation.sql +326 -0
  16. package/dist/assets/seed/10_pack_be.sql +15 -4
  17. package/dist/assets/seed/11_pack_fr.sql +11 -4
  18. package/dist/assets/seed/12_pack_lu.sql +9 -4
  19. package/dist/assets/seed/17_pack_nl.sql +11 -2
  20. package/dist/assets/seed/411_pack_mc.sql +9 -4
  21. package/dist/assets/seed/modules/corporate_tax/10_pack_be.sql +1 -1
  22. package/dist/assets/seed/modules/corporate_tax/11_pack_fr.sql +1 -1
  23. package/dist/assets/seed/modules/corporate_tax/17_pack_nl.sql +1 -1
  24. package/dist/assets/seed/modules/fixed_assets/10_pack_be.sql +1 -1
  25. package/dist/assets/seed/modules/fixed_assets/11_pack_fr.sql +1 -1
  26. package/dist/assets/seed/modules/fixed_assets/17_pack_nl.sql +1 -1
  27. package/dist/cli.d.ts +1 -1
  28. package/dist/cli.d.ts.map +1 -1
  29. package/dist/cli.js +53 -3
  30. package/dist/cli.js.map +1 -1
  31. package/dist/commands/contact.d.ts +6 -5
  32. package/dist/commands/contact.d.ts.map +1 -1
  33. package/dist/commands/contact.js +50 -8
  34. package/dist/commands/contact.js.map +1 -1
  35. package/dist/commands/declarations.d.ts +16 -0
  36. package/dist/commands/declarations.d.ts.map +1 -0
  37. package/dist/commands/declarations.js +98 -0
  38. package/dist/commands/declarations.js.map +1 -0
  39. package/dist/commands/document.js +2 -0
  40. package/dist/commands/document.js.map +1 -1
  41. package/dist/commands/reports.d.ts +17 -0
  42. package/dist/commands/reports.d.ts.map +1 -0
  43. package/dist/commands/reports.js +167 -0
  44. package/dist/commands/reports.js.map +1 -0
  45. package/dist/commands/statement.d.ts +17 -0
  46. package/dist/commands/statement.d.ts.map +1 -0
  47. package/dist/commands/statement.js +93 -0
  48. package/dist/commands/statement.js.map +1 -0
  49. package/dist/inventory.d.ts +11 -0
  50. package/dist/inventory.d.ts.map +1 -1
  51. package/dist/inventory.js +51 -2
  52. package/dist/inventory.js.map +1 -1
  53. package/dist/pack/compile.js +30 -0
  54. package/dist/pack/compile.js.map +1 -1
  55. package/dist/pack/read.d.ts +20 -0
  56. package/dist/pack/read.d.ts.map +1 -1
  57. package/dist/pack/read.js +24 -0
  58. package/dist/pack/read.js.map +1 -1
  59. package/package.json +2 -2
  60. package/schema/output.1.json +97 -0
package/README.md CHANGED
@@ -170,6 +170,7 @@ project reports what was already there and creates nothing a second time.
170
170
  | `ekwo contact add` / `list` | A customer or a supplier, and finding one again. |
171
171
  | `ekwo contact duplicates` | The contacts that are probably one party, strongest first, through `suggest_duplicate_contacts()`: one row per contact to absorb, the rows of one kept contact being one party, with a score, the evidence — the same VAT or registration number, the same bank account, the words of the name weighed by how few contacts carry them — and the simplest name the group carries, proposed for the kept contact. Writes nothing. |
172
172
  | `ekwo contact merge <keep> <absorb>` | One party created twice — two spellings, two imports — joined through `merge_contacts()`: everything that names the second, posted lines and issued documents included, names the first; the first takes the fields it left empty; the second is retired, never deleted, and named by nothing again. By name or id. |
173
+ | `ekwo contact statement` | What went through the accounts of one contact over a period, the balance it runs to, and what is still open. |
173
174
  | `ekwo doc new` / `doc line add` | A draft document — any kind, with `--type` — and one more line on it. A draft books nothing. `ekwo invoice` is the old name of `ekwo doc`, kept as an alias. |
174
175
  | `ekwo doc approve <document>` | Approves a draft, as it stands, for an agent to post where agents post in `review`, through `approve_document()`. Signed in as yourself, with `documents.post`; refused to a machine key. A change to the draft afterwards needs another approval. |
175
176
  | `ekwo company agent-posting [review\|autopilot\|review_only]` | The setting `agent_posting`: how an agent — a machine key, the MCP server — books a document of the company in use. `review`, the default, once a person approved it, unless the agent's session was started with `--autopilot`; `autopilot`, directly, within its rights, each posting on the audit trail; `review_only`, review with autopilot refused to every session. Without a value, says which. Signed in as yourself, with `company.write`; an agent may only make it stricter. |
@@ -184,9 +185,16 @@ project reports what was already there and creates nothing a second time.
184
185
  | `ekwo payment record` | Money in or out, booked and matched. With `--doc`, against that document. |
185
186
  | `ekwo match <transaction> <document>… [--amount <amount>]… [--extra "account=<code>,amount=<amount>,tax=<code>"]…` | A bank statement line pays documents, through `settle_from_statement()`: `--amount`, once per document, says how much settles each; `--extra` books the fee or the charges the line is net of in the same entry, and alone settles a bank charge. The line balances to the cent or is refused. |
186
187
  | `ekwo analytic axes`, `ekwo analytic report --axis <code> --from <date> --to <date>` | The analytic axes of the company and their values; and the income, expense, result and fixed-asset movement of each value of one axis over a period, read by `analytic_report()` from the posted ledger, a parent with the subtotal of the values below it, then the part no share of the axis reaches and the total of the period. |
188
+ | `ekwo balance --from <date> [--to <date>]` | The trial balance: opening balance, debit, credit and closing balance of every account over the period, from posted entries only, read by `trial_balance()`, and the debit and credit totals. |
189
+ | `ekwo ledger [<account>] --from <date> [--to <date>]` | Every posted line of one account by its code, or of every account, with the balance carried forward to the first day and a running balance, read by `general_ledger()`. |
190
+ | `ekwo journal [<journal>] --from <date> [--to <date>]` | The book of one journal by its code, or of every journal: the totals of each, then every line of every posted entry in the order a book is read, from `journal_totals()` and `journal_book()`. |
191
+ | `ekwo aged [--receivable \| --payable] [--at <date>]` | What each customer still owes, or what is still owed to each supplier, at a day, by days overdue, read by `aged_balance()` from the lines no matching has settled. `--to` and `--at` are today when they are not given, and the output says so. |
192
+ | `ekwo vat --from <date> --to <date> [--form <code>]` | The VAT return of the period, read by `vat_return()`: every box with its name and amount, in the order the form of the country pack prints them, the boxes the form derives from the others marked computed. `--form` names the declaration where the country files several. A period the company does not file that form on is refused by the database, by name. It prepares figures; it files nothing. |
193
+ | `ekwo ecsl --from <date> --to <date> [--form <code>]` | The recapitulative statement of supplies to customers in other Member States, read by `ec_sales_list()`: one line per customer VAT number and nature, credit notes deducted, and a warning for each line that cannot be filed as it stands. With `--form`, the period is checked against the cadence the company files that statement on. |
194
+ | `ekwo statement [<code> --from <date> --to <date>]` | Without a code, the balance sheets and income statements the company can be presented on, read by `available_statements()` — the schemes of its country pack, the ones its chart reports on marked default, and the generic framework by account type. With a code, that statement for the period, read by `financial_statement()`: every line, nil included, in the order the scheme prints it, totals in bold, and every account no line catches, from `unmapped_accounts()`, so a statement that does not tie out says so. It prepares figures; it files nothing. |
187
195
  | `ekwo import <source> <file>…` | Books kept elsewhere — `trial-balance`, `fec`, `journal-items`, `journal-report`, `transaction-journal`, `xaf` — whole or not at all, through `import_books()`, with a correspondence of accounts and journals you save and give back; or a bank statement — `camt.053`, `coda`, `cfonb120` — as pending lines. `--dry-run` rehearses. See [taking over books](#taking-over-books-ekwo-import). |
188
196
  | `ekwo doc list` / `show` | What exists, and with `--unpaid` what is posted and still owed. See [keeping books](#keeping-books). |
189
- | `ekwo doc pdf <document>` | The PDF of a sale invoice or credit note, rendered from the books by [`@ekwo-ai/invoice-pdf`](../formats/invoice-pdf/README.md), with the logo the company names by URL (fetched by this command, from a public http(s) address only). Written to `--out`, or under its own name in the current directory. `--factur-x` embeds the CII of a posted sale and makes it a Factur-X PDF/A-3 (the rules it breaks end on exit 1); `--page-size Letter`; `--labels <file.json>` gives the words of the layout in the document's language. `ekwo document` is the whole word of `ekwo doc`. Records nothing. |
197
+ | `ekwo doc pdf <document>` | The PDF of a sale invoice or credit note, rendered from the books by [`@ekwo-ai/invoice-pdf`](../formats/invoice-pdf/README.md), with the logo the company names by URL (fetched by this command, from a public http(s) address only). Written to `--out`, or under its own name in the current directory. `--factur-x` embeds the CII of a posted sale and makes it a Factur-X PDF/A-3 (the rules it breaks end on exit 1); `--page-size Letter`; the words of the layout are in the document's language where a set exists for it (de, en, es, fr, nl), in English otherwise, and `--labels <file.json>` puts other words over them. `ekwo document` is the whole word of `ekwo doc`. Records nothing. |
190
198
  | `ekwo proof stamp` / `upgrade` / `verify` | The sha256 of a filed file — a declaration, the annual accounts of a financial year, a document — committed to Bitcoin through the public OpenTimestamps calendars; only the hash leaves. `upgrade` completes the pending proofs of the company and is made to run on a schedule; `verify` checks a file against its proof and the block it names, and `--out` writes the `.ots` file any verifier reads. See [`docs/filing-proofs.md`](../../docs/filing-proofs.md). |
191
199
  | `ekwo einvoice validate` / `issue` / `status` / `list` | The electronic invoice of a posted sale, in the format its country pack declares, through the `einvoicing` module: `validate` writes it and names the rules it breaks (exit 1 if any), `issue` keeps it and with `--send --to <directory>` writes it to that folder, `status --refresh` follows it. See [`modules/einvoicing`](../../modules/einvoicing/README.md). |
192
200
  | `ekwo einvoice fiscalise` / `fiscalisation` | The fiscal record a country's fiscalisation regime requires for every invoice — VERI*FACTU is one — written by the brick its pack names and chained after the last record of the invoicing system described by `--system <file>` (or `EKWO_FISCAL_SYSTEM`); `--dry-run` writes it and chains nothing, a record that breaks a rule is never chained (exit 1). `fiscalisation` walks each chain, and names the records still to send and the posted sales without a record. |