FINALTabWorkspace

Open source / Reproduce the rail

Inspect every boundary. Re-run every proof.

FINALTab is a pnpm monorepo. The money math is deterministic and tested; the AI layer only proposes; the KeeperHub layer is fail-closed. Safety-critical behavior is covered by unit, integration, contract, and Playwright checks you can run yourself.

6
Mapped monorepo surfaces
4
Test layers from unit to browser
V2
Active plan-bound contract path

01 / Map

Monorepo evidence map

Each surface owns a distinct part of the receipt-to-proof boundary. No package is presented as the whole system.

  1. packages/engine

    Deterministic money core — integer minor units, largest-remainder splits, debt netting, canonical V2 plan hashing, and EIP-3009 typed data.

    source
  2. packages/vision

    Groq receipt extraction + natural-language allocation. Model output is always a proposal; the engine reconciles.

    source
  3. packages/keeperhub

    Fail-closed KeeperHub client — simulate, execute, status. Refuses to report success it cannot prove.

    source
  4. packages/keeperhub-flight-recorder

    kh-proof CLI: replays the verification chain for any executionId — terminal state, onchain receipt, verified flag.

    source
  5. apps/web

    Next.js product, authenticated MCP boundary, hybrid voice safety, collaboration policies, KeeperHub discovery, V2 settlement preparation, and independent proof checks.

    source
  6. contracts

    FinalTabBatchSettlementV2 — plan-bound pulls and payouts, consent, replay resistance, atomicity, expiry, and exact conservation. V1 remains only as regression history.

    source

02 / Contribute

Upstream contribution ledger

Submitted work is labelled by its real review state. A pull request is not described as merged.

KeeperHub CLI / PR #95

A submitted onboarding improvement, with status stated exactly.

We contributed an onboarding improvement to the KeeperHub CLI: KeeperHub/cli PR #95. Status: open — it is a submitted pull request, not a merged one, and we label it exactly that.

03 / Reproduce

Clone, test, inspect

The repository exposes the deterministic, integration, contract, and production-browser checks used by this product.

pnpm workspace

Repository setup and test commands

git clone https://github.com/vaibhav4046/finaltab
cd finaltab
pnpm install --frozen-lockfile
pnpm test       # deterministic unit, integration, and contract checks
pnpm test:e2e   # production build + desktop and mobile browser journeys

The browser suite covers mobile, desktop, and 4K public journeys. Authenticated settlement behavior remains additionally bounded by server validation, Supabase ownership policies, wallet consent, and independent proof checks.

FINALTab — open source