Objection Oracle

A five-question, deterministic release-triage tool from Advokat Frida. It turns a review objection into one of four practical rulings: Ship It, Next Version, Fix It, Then Ship, or Hard Stop.

Use the live Objection Oracle

The ruling is explainable and deterministic. Randomness changes only the Oracle's phrasing, never the outcome. The tool accepts no free text, makes no network requests, stores nothing, and includes no analytics.

Live/source parity

The canonical live experience is embedded in Advokat Frida's Ship It Anyway field guide. This repository builds that exact iframe document from six byte-frozen parity files. The standalone version reuses the same Oracle stage and logic, then adds the current site header and footer from two standalone-only source files.

npm.cmd run verify:live fetches the public article and verifies both:

• the live source-bundle fingerprint matches dist/provenance.json; and
• the generated embed is byte-for-byte identical to the iframe document on the site.

GitHub Pages is intentionally not used. The article remains the one canonical public experience.

Build and verify

Requires Node.js 22 or newer.

npm.cmd ci
npm.cmd run browser:install
npm.cmd run qa
npm.cmd run verify:live

The build produces:

• dist/objection-oracle.html: the self-contained standalone tool;
• dist/objection-oracle-embed.html: the exact article embed; and
• dist/provenance.json: source and artifact SHA-256 fingerprints.

private: true in package.json prevents accidental publication to npm. It does not restrict this public GitHub repository.

Source map

• SPEC.md: product rules and deterministic decision tree
• src/core.js: questions, outcomes, response banks, and receipts
• src/app.js: interaction, animation, accessibility, and copy behavior
• src/page.css: responsive visual treatment
• src/standalone-shell.html and chrome/standalone.css: current public-site chrome for the standalone companion
• tools/build.mjs: standalone/embed build and provenance generation
• tools/verify-live.mjs: exact live/source parity check
• harness/checks.mjs: browser, outcome, accessibility, and privacy checks
• harness/capture.mjs: desktop, mobile, long-copy, and animation captures
• QA.md: reviewed release evidence

License

MIT