SuperNorma

Financial self-awareness: a small, deterministic personal-finance and pension-projection toolkit.

What this is

SuperNorma is an early-stage personal-finance helper. It gives you a clear, verifiable picture of income, expenses, savings, and pension outlook using deterministic calculations — no black boxes. The pieces:

• Calculation core (src/Mod.res, ReScript): net income, surplus detection, total savings, and compound-interest pension projection across pension types (DB, DC, SIPP, ISA, State)

• Web form (ui/webform.html): a static income/expenses entry form

• Power BI measures (dax/): TotalSavings, NetIncome, and IsSurplus DAX formulas mirroring the ReScript core

• Workbook templates (workbook/, data/sample_input/): CSV templates for income and pension modelling

• Advisor persona (advisor/system_prompt.txt): a system prompt that frames an LLM assistant through three lenses — Bookkeeper (accuracy and reconciliation), Forensic Analyst (cause and consequence), and Empowered Advocate (ethical clarity and action)

What this is not (yet)

The advisor persona is not wired to any model; the web form is not wired to the calculation core; there is no CLI, ETL framework, or web app. See TOPOLOGY.md for an honest component-by-component status.

Quick Start

# Install dependencies
bun install
# Build ReScript
bun run build
# Run tests
bun run test

Layout

src/Mod.res	Financial calculation kernels (the real core)
src/UI.res	Web-form DOM hook
src/bindings/	Thin ReScript bindings for Bun/Node runtime APIs
tests/	Unit and integration tests (bun:test over compiled ReScript)
dax/	Power BI DAX measures and columns
workbook/, data/	CSV templates and sample input
advisor/	LLM advisor system prompt (not yet wired)
ui/	Static HTML income form

Requirements

• Bun >= 1.3

• Git

License

Code is licensed MPL-2.0 (see LICENSE); documentation is CC-BY-SA-4.0.

Author

Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>