Repository navigation
Refract is now open source #1
Pinned
Mercury-OT
announced in
Announcements
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
Hi. I'm opening this repository to the public today.
What Refract is
Refract is a product-neutral testing infrastructure core for the AI era.
It provides three things:
A scenario declares what should be true, not how to click it. The same scenario is then run across multiple projections, so one declaration can validate frontend behavior, request shape, response contract, and backend evidence — in a single execution.
Why now
AI turns requirements into code faster than any prior tool. It does not, on its own, turn code into trustworthy software any faster. Without a matching quality infrastructure, faster generation also means faster drift, hidden deviation, and expensive rework.
Refract is my attempt to build the "matching quality infrastructure" — not as a script framework, but as a verification infrastructure that treats scenarios as the long-term asset and evidence as the basis for release decisions.
If any of that resonates, the Refract Manifesto is the fullest expression of the stance behind this project. It's short and worth reading before diving into the code.
What's in the repo today
backend,frontend,e2e,contractAuthenticator,ApiDriver,ResponseNormalizer,StateProbe,UiDriver,RecorderPASSED / FAILED / DEGRADED / EMPTY / NOT_SELECTED, plus step-levelSKIPPED / BLOCKED / ERROR. Nothing that did not actually run may read as a silent pass.refracto validateCLI for scenario validationWhat's not there yet
Refract is early and deliberately narrow. The following are on the roadmap but intentionally deferred until the current core proves out under real use:
If any of these matter to you, an issue or a discussion thread here is the best place to weigh in on priority.
How to try it
The demo scenarios under scenarios/ run against the FastAPI demo app in examples/demo-app/ and exercise all four projections against a real HTTP + OTel stack.
Where to talk
Related
Adversarial critique is welcome and expected. This is early work, put out early on purpose.
— Mercury-OT
All reactions