Billfold

Billfold is the public demonstration fixture for workspace.json for Codex.

It models a small checkout service with repository history that records a relationship between:

• src/routes/checkout.ts
• src/webhooks/stripe.ts

That relationship is intentionally not represented by a direct import or shared symbol. It is preserved as repository evidence in .agents/workspace.json.

What to try

1. Install the Codex integration.
2. Ask Codex to round checkout totals to the nearest dollar.
3. Observe the hook deny an initial checkout-only apply_patch.
4. Inspect the evidence and the Stripe partner.
5. Review the completed diff and run the tests.

Install

npx @workspacejson/codex-mcp install --with-hook

Restart Codex and run /mcp.

Prompt

Finance wants checkout totals rounded to the nearest dollar before we charge. Update the checkout route so subtotals like 1234 cents charge as 1200.

Expected behavior

The first checkout-only patch is denied before application because src/webhooks/stripe.ts is absent from the proposed changeset.

The hook enforces recorded path coverage. It does not determine whether the partner modification is semantically sufficient; that remains a review and verification responsibility.

Run the service checks

npm install
npm test
npm run typecheck

Evidence

See .agents/workspace.json for the recorded claims, read-only git commands, and expected output.

---

Provenance · Live-run record · License