Skip to content

Quality evidence ​

What a buyer can check for themselves, with where to look. Figures taken from the repository on 2026-10-09 (main at e95495b plus the launch docs). Re-run pnpm test and read the CI history on GitHub (FEAW-Serv/getmy-books, ADR 0046) to refresh them.

Size ​

MeasureValue
Production TypeScript (src/)about 22,000 lines
Test TypeScript (tests/)about 32,000 lines
Test files156
Tests1,989 (1,894 run without a database; the other 95 are Postgres tests that CI runs and requires)
Spec scenarios named in test titles (SPEC-NNN Sn)148 distinct
Feature specs14 (docs/features/)
Architecture decisions36 (docs/decisions/)
Commits on mainabout 700

What every change must pass ​

Every pull request, and every push to main, runs .github/workflows/ci.yml:

GateCommand or toolFails on
Lintpnpm lint (eslint . --max-warnings 0, with eslint-plugin-security)Any warning
Typespnpm typecheck (strict, noUncheckedIndexedAccess, no any)Any error
Migration rulespnpm lint:migrationsA migration that breaks the append-only, expand-then-contract rules
Testspnpm test (vitest with coverage) against a real Postgres built as production builds it (pnpm db:setup)Any failure; a skipped database test (REQUIRE_DATABASE_TESTS=true)
CoveragePer-file floors in vitest.config.ts: 80% lines, branches, functions and statements on reconciliation, deadlines, receipts, money and presenters; 100% on src/platform/crypto.tsAny measured file below its floor
Buildpnpm buildAny error
Docspnpm docs:build (VitePress, with a credential scan of every page)A broken link, or credential-shaped text
Secretsgitleaks over the full history (scripts/security/gitleaks.sh)Any finding
Dependenciespnpm audit with reviewed exceptions (security/audit-exceptions.json)A new known vulnerability
Code rulessemgrep, 5 project rules in security/semgrep/, each with a fixtureA violation
Configurationtrivy configA misconfiguration
Imagestrivy image (report only until #75), CycloneDX SBOM uploaded per commitReported

A red or flaky main stops feature work until the cause is fixed; retrigger commits are not allowed (ADR 0009, CLAUDE.md rule 7).

Project rules enforced in code ​

RuleEnforcement
The company comes only from the signed-in sessionsemgrep mcp-entity-from-session
No credentials in logssemgrep no-logging-credentials
No statement text in logssemgrep no-logging-statement-text
Money in integer pence, arithmetic only through the money helperssemgrep pence-arithmetic; ADR 0025
src/rules/ and src/vat/ do no I/Osemgrep pure-modules-no-io; ESLint import bans
Owner-visible wording changes only on purposeGolden snapshots of every presenter string (tests/present/golden.ts) and of every tool and prompt description

Data isolation ​

  • Row-level security on entity_id on every table but principal (src/platform/policies.sql).
  • tests/platform/rls.test.ts and tests/platform/policies.test.ts connect as the app role and prove one company cannot read or write another's rows; tests/platform/rls-indexes.test.ts checks the policy columns are indexed. CI fails if they skip.

Xero call budgets ​

tests/performance/budgets.ts fixes the exact number of Xero requests each of about 20 entry points makes for a stated amount of synthetic data (for example, a month of 2,000 bank records takes 22 requests). Xero allows 60 calls a minute per organisation; a budget that rises or falls fails until the number is changed with the reason in the commit. tests/performance/scale.test.ts and matcher-equivalence.test.ts cover large inputs.

Safety checklist ​

AUDIT.md records each standing rule (money, Xero, MCP, deadlines, code) with PASS, FIXED or N/A and the evidence: file, line, test and CI run. The approval path for writes (AUDIT C5) has its own injection tests.

Governance ​

Spec first, then a failing test, then the code (CLAUDE.md rule 2). Every commit carries a Spec: SPEC-NNN trailer or a logged SGE-Override, checked by .githooks/commit-msg. See the SGE governance guide.

Not yet evidenced ​

  • No external penetration test.
  • No load test against the production host; budgets bound Xero calls only.
  • Retention periods (ADR 0026) are not yet enforced by scheduled jobs.