trueup

Star0
View all files

Activity

Contributors

README

Trueup Witness

Your dashboard said OK. Your agent crashed. Trueup Witness checks your AI agent's records against what really happened, warns you inside neatlogs when they disagree, and fixes the tracing code that got it wrong.

Why it matters

  • Proven live with real Claude calls: 2 wrong records before Trueup's fixes, 0 after, and 0 false alarms in 40 normal calls.
  • neatlogs' own daily email said 6.2% of our test runs failed; really 11.1% had crashed (test runs we crashed on purpose).
  • The fix we sent Arize was reviewed by their head of open source, and neatlogs runs that same code for agents, so one fix repairs both.
  • Built with all three tools: neatlogs recorded every run and caught our own agent's mistakes, Entire recorded how Trueup and its fixes were built, cfo.ai built the business plan from measured costs.

CI

For judges, start here

The result

Real breakneatlogs beforeAfter Trueup's fixes
Connection cut mid-replyAI step SUCCESSAI step ERROR, with the error
Agent run failsAgent workflow SUCCESSAgent workflow ERROR

DISAGREE light: 2 → 0. Details.

Install

Python 3.12 or newer.

Quick start

When the record is wrong, Witness adds a red TRACE DISAGREE step to that record. It never breaks your app. TRUEUP_WITNESS=0 turns it off.

From the project folder:

How it works

  1. Witness reads each AI call off the connection: did the call fail, did the reply finish.
  2. It compares that with the step neatlogs recorded and flags any mismatch with TRACE DISAGREE.
  3. Trueup's test lab finds the faulty tracing code, writes a fix and proves it.

Docs

Getting started · How it works · Built with · Before and after · Known limits

License

MIT