Release summaries
billingos-data-fetching-envelope-outputs
Envelope-shape the three BillingOS query contract outputs (billing.customers.search, billing.sellable-items.search, billing.tax.compute-breakdown) as QueryResultEnvelope ({ data, versionToken? }) so they are accepted by the canonical data-fetching read path (executeResult) instead of 422-ing on the previous inner-row shape.
maintainer
The output schemas of the three BillingOS query contracts now describe a QueryResultEnvelope ({ data, versionToken? }). The inner-row fields results/breakdowns are renamed and re-homed under data; the row models are unchanged. This is a static schema-shape change only — no new runtime dependency on the data-fetching packages.
integrator
Direct type consumers of SearchCustomersOutput, SearchSellableItemsOutput, and ComputeTaxBreakdownOutput must read `.data` instead of `.results`/`.breakdowns`. Handlers must return { data, versionToken? }. No in-repo source consumers reference the renamed fields.
billingos-france-invoicing-mvp
Ship the BillingOS France invoice-issuance MVP — additive issue/submit/creditNote contracts, persistence ports and redaction-aware observability, a France legal engine (TVA/rounding/gapless numbering/NF203), and a new EN16931/Factur-X provider integration with a fail-closed production PDP.
maintainer
France issuance is additive: the original eight billing contract keys are unchanged. New billing.invoice.issue/submit, billing.invoice.submitted, and billing.creditNote.issue contracts sit in billing-spec; persistence ports and a redaction-aware BillingObservabilityPort sit in billing-runtime; the France legal engine (TVA table, half-up per-rate-group rounding, mandatory mentions, Europe/Paris gapless numbering, NF203 hash-chain, avoir immutability guard, SirenSiretVatValidationPort) sits in billing-france. provider-einvoicing keeps the JVM Mustangproject conformance and the fail-closed production PDP out of the country-neutral core.
integrator
Adopt the issue/submit/creditNote handlers from module.billing-os, bind the new persistence and observability ports, and add the provider-einvoicing FacturXGeneratorPort/PdpSubmissionPort. Host DB/RLS wiring lives in api-application-monolith (dedicated billing Postgres schema, migrations, tenant-isolation RLS, createTenantScopedPool adapters, buildBillingOsPortBindings); production PDP submission stays fail-closed until a certified-PDP partner is wired, and live INSEE/VIES checks remain mocked until their adapters land.
customer
Operators can run the France invoice flow end to end — quote → issue → Factur-X (EN16931/CIUS-FR) → PDP submission → reconcile → credit-note/avoir — with gapless numbering, NF203 inalterability, and mandatory legal mentions. Go-live is EUR-only and production PDP submission is fail-closed until a certified-PDP partner is connected; the issuance workspace renders in fr/es.
billingos-production-ready
Promote BillingOS to first-class production-ready contracts, runtime projections, France readiness, CompanyOS module composition, responsive UI, and native-safe mobile proof.
maintainer
BillingOS production-ready surfaces remain additive, country-neutral in core, side-effect-free, and backed by mobile-width UI/native-proof evidence.
integrator
Integrators can compose BillingOS action plans through CompanyOS review and reuse mobile-first UI/proof guidance without provider credentials or production submission.
billingos-qtc-contract-spine
Add the contract spine for the BillingOS/FinanceOps quote-to-cash cockpit: role-aware BillingOS cockpit packets/action availability plus provider-neutral FinanceOps cashflow and accounting-export review hints.
maintainer
Add the contract spine for the BillingOS/FinanceOps quote-to-cash cockpit: role-aware BillingOS cockpit packets/action availability plus provider-neutral FinanceOps cashflow and accounting-export review hints.
integrator
Add the contract spine for the BillingOS/FinanceOps quote-to-cash cockpit: role-aware BillingOS cockpit packets/action availability plus provider-neutral FinanceOps cashflow and accounting-export review hints.
billingos-v0
Add BillingOS V0 country-neutral contracts, deterministic runtime helpers, France readiness pack, French SME replay proof, and aligned docs/release/LLM safety boundaries.
maintainer
BillingOS V0 is additive, keeps France readiness outside the country-neutral core/runtime packages, and documents the production-readiness safety boundaries.