Skip to content
ContractSpec
Start here

Package manual · domains

·Billing, finance and economic evidence

lib.finance-ops-spec

Provider-neutral internal finance operations contracts beyond BillingOS quote-to-cash.

domainslibraryv2.0.4experimentalservernode
@lssm-tech/lib.finance-ops-spec
bun add @lssm-tech/lib.finance-ops-spec
Package source ↗Manifest ↗

Manifest declarations describe the current workspace; they do not verify registry publication or runtime execution.

Package guide

Provider-neutral internal finance operations contracts beyond BillingOS quote-to-cash.

This package closes the first canonical ContractSpec slice for internal finance operations. It defines reviewable contracts and handoff packets; it does not execute provider actions or provide financial advice.

Scope

Use this package to model:

  • budgets, spend policies, and financial commitments;
  • procurement requests and vendor compliance review;
  • expenses and reimbursement handoffs;
  • payroll, tax, and compliance handoffs;
  • cashflow/runway policies, non-advisory runway hints, and accounting export review gates;
  • CompanyOS authority, assurance evidence, and approval gates.

Boundary

BillingOS owns quote-to-cash artifacts such as quotes, orders, invoices, payments, refunds, write-offs, accounting exports, and reconciliation. Finance ops may reference those artifacts for cashflow/runway and review context but must not redefine or execute them. This package also avoids bank, accounting, payroll, and tax provider execution.

Public entrypoints

  • @lssm-tech/lib.finance-ops-spec — root barrel
  • @lssm-tech/lib.finance-ops-spec/types — contract schemas and types
  • @lssm-tech/lib.finance-ops-spec/validation — semantic validation helpers
  • @lssm-tech/lib.finance-ops-spec/fixtures — safe synthetic fixtures
  • @lssm-tech/lib.finance-ops-spec/finance-os — additive multi-entity ledger, planning, treasury, close, evidence, and governance schemas
  • @lssm-tech/lib.finance-ops-spec/docs — owner-module FinanceOS semantic-contract DocBlock

FinanceOS semantic surface

The additive finance-os entrypoint models holdings, legal entities, companies, tenants, ledgers, consolidation, chart and account references, planning scenarios, treasury, obligations, FX, unit economics, allocations, close and reconciliation. Stable references bind canonical LSSM goals and economic evidence without importing goal, billing, provider, or runtime packages.

Unknown or stale hard budgets fail closed to review. Intercompany transfers, shared-service allocation, ledger posting, and close effects remain governed handoffs with segregation-of-duties and ContractSpec Connect authorization references. Secrets and direct PII are prohibited; evidence must be redacted or tokenized.

Commands

  • bun run test
  • bun run typecheck
  • bun run lint:check
  • bun run build

Relationships

THIS PACKAGElib.finance-ops-spec15 import paths

Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.

2 declarations

Declared capabilities

Lib Finance Ops Spec

Provider-neutral internal finance operations contracts beyond BillingOS quote-to-cash.

Scripts

  • publish:pkgbun publish --tolerate-republish --ignore-scripts --verbose
  • publish:pkg:canarybun publish:pkg --tag canary
  • buildcontractspec-bun-build build
  • build:bundlecontractspec-bun-build transpile
  • build:typescontractspec-bun-build types
  • devcontractspec-bun-build dev
  • cleanrimraf dist .turbo
  • lintbun lint:fix
  • lint:fixnode ../../../../scripts/biome.cjs check --write .
  • lint:checknode ../../../../scripts/biome.cjs check .
  • testbun test
  • prebuildcontractspec-bun-build prebuild
  • typechecktsgo --noEmit