Back to the archive

The Evidence Library / Working system

Financial facts with an evidence trail

A temporal knowledge layer that turns financial PDFs into inspectable claims, reconciles conflicting interpretations, and gates which facts downstream software may use.

PythonTypeScriptSQLiteFTS5LiteParseDocker
* CHECK
SUBJECT
Project SuperJoin
TYPE
Document intelligence
STATUS
Working system

* 4 outcomes allow, block, needs context, needs review.

PROOF SIGNAL

4 outcomesallow, block, needs context, needs review

The mission

What the system does

A temporal knowledge layer that turns financial PDFs into inspectable claims, reconciles conflicting interpretations, and gates which facts downstream software may use.

  • Exact PDF evidence anchors attached to immutable source claims
  • Versioned fact families that preserve conflicts, alternatives, and review history
  • Bounded extraction with checkpoints, caching, rate-limit handling, and cost telemetry
  • Hybrid lexical/vector retrieval with independently configurable model providers

Engineering log

Decisions behind the build

What the system handles, and why it works this way.

BOSS 01

A number without context

Normalization retains entity, period, unit, and modality. Similar-looking values are not merged when their meanings are incompatible.

BOSS 02

Conflicting sources

Source claims remain immutable while interpretations evolve. Review history and committed revisions let a downstream consumer inspect the decision.

BOSS 03

Safe consumption

The Trust Gate returns explicit decisions and reasons. Provisional, contested, or stale-reviewed values cannot silently become executable facts.

System map

How signals move

A plain technical view. The map still works without hovering.

01
DocumentsLiteParse / OCR

Text and page geometry

02
ClaimsExtraction roles

Grounded source statements

03
Fact familiesSQLite WAL

Versions and relationships

04
RetrievalFTS5 + vectors

Relevant evidence

05
Trust GatePolicy engine

Committed facts only

LOG ENTRY / WHAT I LEARNED

“The useful output is not just a value. It is a value, its context, its history, and a clear answer about whether another system should trust it.”

Source signal

Inspect the work.