Jesse Moraga

Work with me

Done Isn’t a Checkbox. It’s Proof.




jesse@cvps : ~/blog — zsh
$ git log –oneline -1 && cat post.md
// TECHNICALLY SPEAKING

Done Isn’t a Checkbox. It’s Proof.

My system kept a list of finished jobs. Today I found out the list was lying.▌

13
jobs marked done
3
not actually done
1
flag that lied

## THE BUG

My system keeps a little list: “these jobs are handled, don’t touch them again.” It’s there for speed. But it was a one-way door — once a job landed on it, the system never looked back, even if the thing it was supposed to produce quietly vanished before it reached anyone. A job could wear a DONE sticker while the actual deliverable never existed. The system was sure. The system was wrong.

what_the_flag_said ↔ what_was_true.diff
– “Handled. Move on.”
+ Nothing was ever delivered.
– 10 of 13 were fine, so trust the list.
+ 3 were silently stuck for weeks. Trust the artifact.

## THE FIX — STOP TRUSTING THE STICKER

BEFOREjob→DONE flag→ skip forever ✗ (deliverable lost, nobody notices)
AFTER job→DONE?→does the real thing exist?→ yes: skip  /  no: redo
# the whole fix, in spirit
if marked_done and deliverable_still_exists(job):
    continue  # trust it
else:
    redo(job)  # the sticker lied — do the work

## LIVE — THE FIX CATCHING ITS OWN STUCK JOBS

[19:40:09] INFO  reality-check: deliverable missing → reprocess
[19:40:26] OK    regenerated the document ✓
[19:40:30] OK    client deliverable drafted ✓
[19:40:30] DONE  3 stuck jobs healed — no human chasing anything

Ten minutes after I shipped it, the system caught its own three stuck jobs and finished them. That’s the part I care about: not that I fixed three jobs, but that next time something slips, the system finds it instead of me.

“A process server learns this on day one. Showing up isn’t the job — the signed proof is the job. ‘I was there’ and ‘it’s done’ are two different sentences, and only one of them holds up.”

A flag that says “done” is just “I was there.” The only thing that counts is proof the work actually landed. So my rule, in code and in the field, is the same: don’t tell me it’s done — show me the proof.

$ whoami

I build the systems that run my own company — 700+ cases — and write about the build. A process server who codes.

github.com/JesseMoraga  ·  centralvalleyprocessservers.com  ·  more build logs

Jesse Moraga · Registered California Process Server PS-124 · Fresno, CA

Leave a comment