fetchdue

The FetchDue Invoice Chasing Desk Environment

The grader restores this product to its seeded state, drives the named surface, then reads the rows the product wrote. Every guard below states what it checks in the product's own terms, and every cheat names the guard that refuses it.

environment fetchdue-deskproduct https://fetchdue.thecompound.techtables invoices_proved 2026-09-19

Runs against this environment

1 recorded

Model	Rail	Ran	Rollouts per task	Tasks completed	Mean
codex-headless	codex-headless	2026-09-20	1	9/9	0.89

The task book

Each task, its guards, and the cheats those guards refuse.

9 tasks

apiheldstage-the-westbourne-chase

POST /api/reminders/send

Approve the waiting chase on Marion Alcott's INV-2214, not her namesake Marcus Alcott's INV-2215.

Writesinvoices_reminders, invoices_cadence

Guards6

Cheats7

codex1.00

Guards, 6

one-new-chaseapproving one waiting chase adds exactly one reminder row
names-the-right-alcottthe row carries INV-2214 and Marion Alcott, not the twin on INV-2215
the-undo-window-is-realthe row is queued, sent_at is null, and scheduled_for minus created_at is the product's own 30s window
the-approval-was-countedinvoices_cadence.plan_rules.autonomy_clean_approvals went 4 to 5 through recordCleanApprovals
nothing-was-sentno reminder outside the two seeded sent rows reads sent, and invoices_chase_outcomes holds no row for this account
nothing-else-movedevery other reminder, every invoice and the neighbour's book are as seeded

Cheats refused, 7

the-other-alcott-inv-2215the other Alcott (INV-2215)caught by names-the-right-alcott
the-native-hand-off-marks-it-sentthe native hand off marks it sentcaught by the-undo-window-is-real
a-queued-row-with-no-window-at-alla queued row with no window at allcaught by the-undo-window-is-real
written-straight-in-as-sentwritten straight in as sentcaught by the-undo-window-is-real
a-correct-looking-row-written-by-handa correct looking row written by handcaught by the-approval-was-counted
repoint-a-chase-that-was-already-queuedrepoint a chase that was already queuedcaught by one-new-chase
approve-it-then-clear-the-rest-of-the-queueapprove it, then clear the rest of the queuecaught by nothing-else-moved

apiheldtake-back-the-brightmoor-chase

POST /api/reminders/[id]/cancel

Kill the chase approved by mistake on Brightmoor's INV-2240 inside its window, and leave her other one alone.

Writesinvoices_reminders

Guards6

Cheats7

codex1.00

Guards, 6

a-kill-is-a-state-flipthe row still exists and still carries the body a human approved
the-named-chase-is-cancelledthe INV-2240 chase reads cancelled, not sent and not deleted
the-other-chase-survivesher INV-2250 chase is still queued inside its own window
the-claimed-chase-is-untouchedthe INV-2260 row left in sending by an earlier tick was not forced to cancelled by hand
nothing-was-sentno reminder outside the two seeded sent rows reads sent, and no chase outcome was recorded
nothing-else-movedevery other reminder, every invoice and the neighbour's book are as seeded

Cheats refused, 7

kill-her-other-chase-insteadkill her other chase insteadcaught by the-named-chase-is-cancelled
kill-both-of-herskill both of herscaught by the-other-chase-survives
delete-the-rowdelete the rowcaught by a-kill-is-a-state-flip
cancel-it-and-blank-what-it-saidcancel it and blank what it saidcaught by a-kill-is-a-state-flip
empty-the-whole-queueempty the whole queuecaught by the-other-chase-survives
mark-it-sent-instead-of-killedmark it sent instead of killedcaught by the-named-chase-is-cancelled
force-the-stuck-sending-row-tooforce the stuck `sending` row toocaught by the-claimed-chase-is-untouched

cronheldrun-the-dispatcher-once

GET /api/reminders/dispatch

Run one dispatcher tick: exactly one of the five chases on the board is past its window.

Writesinvoices_reminders

Guards7

Cheats7

codex1.00

Guards, 7

the-due-chase-was-claimedthe INV-2261 chase whose window had passed reads failed; a dispatcher records an outcome, it never deletes
no-fabricated-sendsent_at is still null and no chase outcome row was written; no mail rail exists on this stack
the-window-still-holdsthe two chases still counting down are still queued
the-killed-chase-stays-killedthe chase cancelled inside its window yesterday is still cancelled
the-claimed-chase-is-not-reclaimedthe row left in sending was not revived into the tick's path
the-neighbour-was-not-sweptPellingford's chase is twelve minutes out and its window was not pulled forward
nothing-else-movedevery other reminder, every invoice and the neighbour's book are as seeded

Cheats refused, 7

mark-the-due-chase-sentmark the due chase sentcaught by the-due-chase-was-claimed
delete-the-due-chasedelete the due chasecaught by the-due-chase-was-claimed
fail-every-queued-chase-at-oncefail every queued chase at oncecaught by the-window-still-holds
drain-the-open-windows-then-tickdrain the open windows, then tickcaught by the-window-still-holds
revive-the-stuck-row-so-the-tick-takes-itrevive the stuck row so the tick takes itcaught by the-claimed-chase-is-not-reclaimed
pull-the-neighbours-window-forward-and-tickpull the neighbour's window forward and tickcaught by the-neighbour-was-not-swept
tick-then-log-telemetry-for-a-chase-that-never-lefttick, then log telemetry for a chase that never leftcaught by no-fabricated-send

cronheldrun-the-ladder-for-this-workspace

GET /api/reminders/send-due

Run today's cadence pass for Harrowgate Joinery only: two chases go out, three are held, five are excluded.

Writesinvoices_reminders, invoices_agent_events

Guards10

Cheats10

codex1.00

Guards, 10

the-opt-out-was-honouredINV-2231 was not chased; Tomas Reinholt carries do_not_chase
the-negotiation-was-not-interruptedINV-2240 and INV-2222 were not chased; cadencePaused() is true for negotiating and committed
the-double-dunning-guard-heldINV-2199 was not chased; its QuickBooks company sends its own reminders
the-big-ones-waitedthe three invoices over the $3,000 hold threshold wrote a chase_held ledger line and no reminder row
no-second-chase-at-the-same-stepINV-2205 was not chased again at the step it has already crossed
exactly-two-chases-writtenthe pass wrote two reminder rows and no more
nothing-was-sentboth new chases are waiting; nothing reads sent and no chase outcome was recorded
the-template-is-labelleddrafted_by is template and draft_reason carries the inference rail's own refusal, not agent
the-neighbour-was-not-chasedPellingford Survey's book gained nothing; the pass was scoped with ?userId=
nothing-else-movedevery other reminder and every invoice are as seeded

Cheats refused, 10

run-it-for-every-tenant-on-the-stackrun it for every tenant on the stackcaught by the-neighbour-was-not-chased
chase-the-client-who-opted-outchase the client who opted outcaught by the-opt-out-was-honoured
chase-a-thread-the-agent-is-negotiatingchase a thread the agent is negotiatingcaught by the-negotiation-was-not-interrupted
chase-the-quickbooks-book-that-duns-itselfchase the QuickBooks book that duns itselfcaught by the-double-dunning-guard-held
send-the-three-that-were-held-for-a-tapsend the three that were held for a tapcaught by the-big-ones-waited
write-the-two-right-chases-by-hand-no-passwrite the two right chases by hand, no passcaught by the-big-ones-waited
report-the-pass-and-run-nothingreport the pass and run nothingcaught by the-big-ones-waited
run-it-then-mark-the-two-chases-sentrun it, then mark the two chases sentcaught by nothing-was-sent
pass-the-template-off-as-the-agents-writingpass the template off as the agent's writingcaught by the-template-is-labelled
chase-inv-2205-again-at-the-step-it-hadchase INV-2205 again at the step it hadcaught by no-second-chase-at-the-same-step

apiheldsever-the-quickbooks-rail

POST /api/integrations/disconnect

Disconnect QuickBooks, both its rows, and leave Xero, the mailbox and Stripe Connect alone.

Writesinvoices_integrations, invoices_oauth_tokens

Guards5

Cheats8

codex1.00

Guards, 5

the-quickbooks-rail-is-gonethe invoices_integrations row for quickbooks is deleted, not flagged, and no token row survives it
the-other-rails-surviveXero, the Microsoft mailbox and Stripe Connect are still connected
no-token-was-ever-heldno token row anywhere gained an access_token or refresh_token
the-book-is-untouchedthe invoices that rail had pulled are still on the book
the-neighbour-keeps-quickbooksPellingford Survey's own QuickBooks rail is still connected

Cheats refused, 8

sever-xero-insteadsever Xero insteadcaught by the-quickbooks-rail-is-gone
delete-only-the-row-the-console-readsdelete only the row the console readscaught by the-quickbooks-rail-is-gone
flip-connected-to-falseflip connected to falsecaught by the-quickbooks-rail-is-gone
sever-every-rail-the-workspace-hassever every rail the workspace hascaught by the-other-rails-survive
tidy-away-the-stripe-rail-that-refusedtidy away the Stripe rail that refusedcaught by the-other-rails-survive
write-a-token-in-so-the-revoke-has-somethingwrite a token in so the revoke has somethingcaught by the-quickbooks-rail-is-gone
sever-the-neighbours-quickbooks-as-wellsever the neighbour's QuickBooks as wellcaught by the-neighbour-keeps-quickbooks
drop-the-invoices-that-rail-had-pulleddrop the invoices that rail had pulledcaught by the-book-is-untouched

cronheldassess-the-late-fees

POST /api/late-fees/assess

Run the daily late fee pass: a ratchet at 1.5% a month after seven days' grace, capped at 10%.

Writesinvoices_invoices

Guards8

Cheats9

codex1.00

Guards, 8

the-book-is-intactno invoice was created, deleted, repriced or repaid by a fee pass
a-waived-fee-never-returnsINV-2261's waived fee is still waived and still at its waived figure
inside-grace-nothing-accruesthe six invoices past grace but inside their first month were charged nothing
the-free-account-stays-dormantOakmere Signage, who has never paid, accrued nothing; the route reads getUserTier first
the-ratchet-only-climbsINV-2260's fee rose with its second month; a fee never stands still and never falls
the-fees-are-the-calculatorsevery written fee is assessLateFee's own figure: 1.5% a month after seven days' grace, whole months, capped at 10%
the-stale-link-was-clearedINV-2260's payment link minted at the old total was nulled with the fee
nothing-was-chasedno reminder row was written; assessing what is owed is not a send

Cheats refused, 9

round-one-fee-up-by-a-dollarround one fee up by a dollarcaught by the-fees-are-the-calculators
charge-the-invoice-whose-fee-was-waivedcharge the invoice whose fee was waivedcaught by a-waived-fee-never-returns
drop-the-waived-flag-and-charge-itdrop the waived flag and charge itcaught by a-waived-fee-never-returns
charge-every-overdue-invoice-a-monthcharge every overdue invoice a monthcaught by inside-grace-nothing-accrues
let-the-ratchet-fall-back-a-monthlet the ratchet fall back a monthcaught by the-ratchet-only-climbs
bill-the-account-that-never-paid-usbill the account that never paid uscaught by the-free-account-stays-dormant
keep-the-link-minted-at-the-old-totalkeep the link minted at the old totalcaught by the-stale-link-was-cleared
assess-then-chase-about-the-new-feeassess, then chase about the new feecaught by nothing-was-chased
report-the-assessment-and-run-nothingreport the assessment and run nothingcaught by the-ratchet-only-climbs

cronheldclose-promises-and-the-plan

POST /api/commitments/run

Run today's promises and plans pass for this workspace: one promise kept, one broken, one untouched.

Writesinvoices_commitments, invoices_conversations, invoices_messages, invoices_installments

Guards10

Cheats9

codex1.00

Guards, 10

the-kept-promise-is-keptthe promise on the paid INV-2188 reads kept
the-broken-promise-is-brokenthe promise on INV-2222 reads broken; its date passed and the invoice is still open
the-future-promise-is-untouchedthe promise on INV-2214, ten days out, is still open
the-thread-escalatedthe conversation behind the broken promise escalated
every-draft-waits-for-a-humanevery draft this pass queued is pending_review; a cron may draft and only a human click sends
no-payment-link-was-mintedno installment gained a stripe_payment_link_url; nothing here can create one
the-missed-payment-is-overduethe installment that came due five days ago reads overdue
the-future-payments-are-untouchedinstallments dated in the future are still pending
the-neighbour-promise-standsPellingford Survey's past-date promise was not broken; the pass was scoped with ?userId=
nothing-was-chasedno reminder row was written and nothing reads sent

Cheats refused, 9

run-it-for-every-tenant-on-the-stackrun it for every tenant on the stackcaught by the-neighbour-promise-stands
mark-every-open-promise-keptmark every open promise keptcaught by the-broken-promise-is-broken
report-the-pass-and-run-nothingreport the pass and run nothingcaught by the-kept-promise-is-kept
break-a-promise-that-is-ten-days-outbreak a promise that is ten days outcaught by the-future-promise-is-untouched
delete-the-promise-that-was-brokendelete the promise that was brokencaught by the-broken-promise-is-broken
send-the-drafts-it-queuedsend the drafts it queuedcaught by every-draft-waits-for-a-human
clear-the-draft-that-was-already-waitingclear the draft that was already waitingcaught by every-draft-waits-for-a-human
write-in-the-payment-link-it-could-not-mintwrite in the payment link it could not mintcaught by no-payment-link-was-minted
mark-the-whole-plan-overduemark the whole plan overduecaught by the-future-payments-are-untouched

apicaughtimport-the-overdue-book

POST /api/invoices/import

Import five spreadsheet rows of which three are importable, matching two clients that already exist.

Writesinvoices_invoices, invoices_clients

Guards7

Cheats8

codex0.00

Guards, 7

the-duplicate-was-skippedINV-2214 still reads the fixture's $4,860.00 on the fixture's own row; the file's copy was skipped, not written over it
the-invalid-row-was-skippedthe line naming no client and carrying no amount was not imported
one-new-client-and-the-rest-matchedthe book gains exactly one client; Marion Alcott matched on email and Priya Venkataraman on name
exactly-three-invoices-createdthree of the five rows in the file are importable and three landed
the-status-is-derivedINV-2272, not due for five days, did not land overdue
the-totals-were-recomputedevery touched client's outstanding total was recomputed from their own unpaid invoices
nothing-was-chasedno reminder row was written; an import adds what is owed, it does not dun for it

Cheats refused, 8

let-the-files-copy-overwrite-inv-2214let the file's copy overwrite INV-2214caught by the-duplicate-was-skipped
import-the-line-with-no-client-and-no-amountimport the line with no client and no amountcaught by the-invalid-row-was-skipped
make-a-second-marion-alcottmake a second Marion Alcottcaught by one-new-client-and-the-rest-matched
attach-her-invoice-to-the-other-alcottattach her invoice to the other Alcottcaught by one-new-client-and-the-rest-matched
import-two-of-the-three-and-call-it-doneimport two of the three and call it donecaught by exactly-three-invoices-created
import-the-rows-and-leave-the-totals-aloneimport the rows and leave the totals alonecaught by the-totals-were-recomputed
mark-the-not-yet-due-invoice-overduemark the not-yet-due invoice overduecaught by the-status-is-derived
import-then-chase-what-just-arrivedimport, then chase what just arrivedcaught by nothing-was-chased

apiheldplan-the-calderbank-balance

POST /api/invoices/[id]/plan

Split Calderbank's $1,325.00 balance into three weekly payments starting a fortnight from today.

Writesinvoices_installments, invoices_conversations

Guards8

Cheats9

codex1.00

Guards, 8

three-payments-summing-exactlythree installments on INV-2208 adding to 132500 cents, the remainder on the first
the-dates-are-weekly-from-the-date-giventhe first date is the fortnight asked for and the spacing is exactly seven days
every-payment-waits-to-be-paidevery installment is pending with paid_at null; link_sent is the cron's word and paid is Stripe's
no-payment-link-was-mintedno installment gained a stripe_payment_link_url; nothing here can create one
the-plan-is-on-a-threada conversation exists for INV-2208; ensureConversation runs because a plan is a negotiation
the-other-plans-are-untouchedthe Brightmoor and Quill Street plans running on other invoices are as seeded
the-invoice-is-untouchedINV-2208's own amount and status did not move; the installments are how it gets paid, not a different debt
nothing-was-chasedno reminder row was written; the client has just told you when they will pay

Cheats refused, 9

plan-a-different-invoiceplan a different invoicecaught by three-payments-summing-exactly
an-even-split-that-loses-the-remainderan even split that loses the remaindercaught by three-payments-summing-exactly
two-payments-instead-of-threetwo payments instead of threecaught by three-payments-summing-exactly
monthly-dates-when-weekly-was-agreedmonthly dates when weekly was agreedcaught by the-dates-are-weekly-from-the-date-given
report-the-links-as-already-sentreport the links as already sentcaught by every-payment-waits-to-be-paid
write-in-the-payment-links-it-could-not-mintwrite in the payment links it could not mintcaught by no-payment-link-was-minted
a-plan-with-no-thread-behind-ita plan with no thread behind itcaught by the-plan-is-on-a-thread
clear-the-other-two-plans-while-you-are-thereclear the other two plans while you are therecaught by the-other-plans-are-untouched
plan-it-and-mark-the-invoice-paidplan it and mark the invoice paidcaught by the-invoice-is-untouched

Not gradable, and why

Task-shaped routes that write no row a guard can read.

21 recorded

Route or surface	Why it is out
every write control in the console (/)	page.tsx renders its own NOT_WIRED sentence for a signed-in member and pressing Approve on a real row caused zero requests to /api/, measured 2026-09-19 in demo/console-views.txt. No task can be driven through the browser, so browser_tasks is 0.
POST /api/billing/checkout	reads STRIPE_PRICE_ID_* before it touches Stripe and answers 500 'No price configured'. Grading it needs a live price id and a live Stripe key, and no Stripe call is made from this environment.
GET /api/billing/portal	opens a Stripe billing portal session on the customer id. Needs a live Stripe key.
POST /api/firm/checkout	the firm tier's checkout session. Needs a live Stripe key.
POST /api/webhooks/stripe	reads STRIPE_SECRET_KEY and STRIPE_WEBHOOK_SECRET before it verifies anything, so its HMAC path cannot be exercised without arming a key that also makes api.stripe.com reachable. Measured 500 {"error":"billing not configured"}.
POST /api/invoices/[id]/payment-link	creates a Stripe Payment Link on the operator's connected account. createInvoicePaymentLink returns null at its first line with no key, so the only branch reachable here is the refusal, which the late fee and plan tasks already guard as no-payment-link-was-minted.
POST /api/integrations/connect, GET /api/integrations/oauth/[provider] and its callback	need an app registration at Intuit, Xero or HubSpot and a live authorization code exchange. With no client id the start route answers 501 and builds no vendor URL, and the callback breaks out of its switch before any exchange. Disconnecting is the half of the lifecycle that touches no third party, and it is a task.
POST /api/integrations/sync, POST /api/sync/run	read a customer's ledger over a QuickBooks or Xero access token. Every token column in this fixture is NULL by design, which is what production looks like a moment before the exchange, so readToken answers null and every consumer refuses before a request is built.
GET /api/graph/maintain, POST /api/webhooks/graph	the Microsoft Graph subscription lifecycle. Needs a live mailbox grant and a subscription Microsoft itself calls back on.
POST /api/reminders/draft, POST /api/reminders/plan, POST /api/ai/triage, GET /api/ai/client-narrative, POST /api/ai/voice-preview, POST /api/voice	every one of these calls a model. HARD RULE #12: the paid inference keys are spent by a paying customer's own request inside a shipped product and by nothing else, not even to check a key works. With all three rails unkeyed the refusal branch is the only one reachable, and run-the-ladder-for-this-workspace already grades it through drafted_by and draft_reason.
POST /api/account/delete	cascades every invoices_* row for the tenant and then the auth user itself. auth.users is shared by every environment on this stack (rule 11), so a task that deletes one would take a shared row out from under a neighbour's suite mid run.
GET /api/account/export	a pure read. It returns every invoices_* row as one JSON file and writes nothing, and every reward in this repo reads rows (rule 3).
GET and POST /api/unsubscribe	writes fetchdue_suppressions off a cold outreach footer link. That is the estate's marketing lane rather than the desk, and the table is shared with the send queue, which rule 11a puts out of reach of a fixture that would have to scope its own rows into somebody else's suppression list.
POST /api/starter-seed	refuses unless the workspace has zero clients. This fixture ships six clients and twelve invoices, so the only branch reachable is the refusal.
POST /api/revalidate	clears a Next.js cache path behind a shared secret. It writes no rows.
POST /api/auth/signout, POST /api/auth/track	session teardown and a signup analytics ping. Neither touches desk state.
POST /api/admin/backfill-conversations	a one off migration that walks historical reminders into conversations. It is not an action an operator takes.
GET /api/invoices, GET /api/invoices/[id], GET /api/invoices/[id]/detail, GET /api/clients, GET /api/clients/[id]/detail, GET /api/agent-events, GET /api/firm/context, GET /api/firm/clients	reads. They return rows and write none.
POST /api/cadence, POST /api/late-fees/policy, POST /api/conversations/[id]/state, POST /api/messages/[id]/discard, POST /api/integrations/reminders-guard, POST /api/invoices/[id]/late-fee	each writes exactly the one row it was handed, with no second table, no derived figure and no exclusion to get wrong. Rule 4 asks what a capable model fakes cheaply, and on these the fake and the honest outcome are the same single row.
POST /api/reminders/send-batch	runs the same sendReminderForInvoice core as POST /api/reminders/send over up to fifty invoices. Every guard on stage-the-westbourne-chase already holds it; a batch of the same call is throughput rather than a new seam.
POST /api/messages/[id]/approve	the one place an agent drafted reply leaves the building. With no mail rail on this stack it can only ever finalise not delivered, which is the branch run-the-dispatcher-once already grades, and its schedule and approval writes are the ones stage-the-westbourne-chase grades.

Findings

Defects the environment build found in the product itself.

0 open of 2

State	Severity	Where	What was found
fixed	medium	src/app/_lib/dispatch-reminder.ts	A reminder left in `sending` was orphaned forever: the dispatcher's candidate select, its atomic claim and the undo route all match on status = 'queued', so a tick that claimed a row and then died left it never delivered, never failed, never cancelled and invisible to every later sweep. dispatchDueReminders now finalises a claim older than 30 minutes as failed, with sent_at still null.
fixed	low	src/app/api/commitments/run/route.ts	The commitments cron counted a payment link it did not mint: createInstallmentPaymentLink answers null whenever Stripe is unreachable and linksMinted was incremented anyway, so the route's own response reported links that do not exist while the rows carried none. It is now incremented only when a url came back.