C.W.K.
Stream
Lesson 04 of 04 · published

Never Rewrite the Past

~11 min · append-only, no-rewrite, integrity, correction

Level 0Unmarked Path
0 XP0/35 lessons0/12 achievements
0/100 XP to next level100 XP to go0% complete
"You can correct the record going forward. You can never reach back and change what you knew then."

The Hardest Rule

Everything in this track converges on one rule that is easy to state and hard to hold: a retrospective must never rewrite what was known at the time. When you look back at a trip and want to tidy it — fix a place name, move a note to the right day, correct a plan that didn't survive the weather — the temptation is to edit history so it reads cleanly. Waystone forbids the edit and offers a different move: append a correction, never overwrite the original. The past stays exactly as it was; the correction is a new fact layered on top, stamped with when it was made.

Append, Don't Overwrite

This shows up concretely in how breadcrumbs are corrected. A breadcrumb's original capture record — when and where it was submitted — is immutable. Want to fix its text or its place? That is an edit revision that folds into the live view while leaving the capture-time record intact. Want to move it to a different day because you filed it under the wrong date? That is an append-only revision of its schedule date; its identity, capture time, media, and locations all stay unchanged. And a tombstoned breadcrumb cannot be revised back into existence — deletion is honest and final, not quietly undone. Correction is always additive, never destructive.

Why This Protects the Whole Engine

The reason is the one this track has circled the whole way: the engine's value is that it remembers what you knew at the time, including the wrong guesses, the abandoned plans, and the notes you filed on the wrong day. A retrospective that rewrites those away leaves a record that is neater and less true — and less true is exactly the failure a memory engine cannot afford. The clean-looking history is a liability if it was purchased by deleting what actually happened. Append-only correction is how Waystone stays both accurate and honest: accurate now, honest about then.

This is the same instinct as cwkPippa's ground truth: the append-only log is never edited in place; derived views are rebuilt from it. Correcting a trip and correcting a conversation follow the identical rule — the past is evidence, and you do not edit evidence.

Code

Correcting a breadcrumb: append, never overwrite·text
add:    crumb#42  text="lunch at Bort"  date=D14  captured=D14 10:31

# Fix the text  -> edit revision folds into the view:
edit:   crumb#42  text="lunch at Bort (great rosti)"
        # captured time, id, media: UNCHANGED

# Filed under the wrong day -> append a schedule-date revision:
edit:   crumb#42  local_date=D13
        # ULID, captured_local_date, capture time, media: UNCHANGED

# Delete it -> tombstone, and it CANNOT be revised back:
delete: crumb#42

# The original add record is never rewritten. Corrections stack.
# The record is accurate now AND honest about then.

External links

Exercise

Find a record you 'cleaned up' after the fact — an edited journal entry, a rewritten plan, a corrected log. Did the cleanup preserve what you originally wrote, or did it overwrite it? Now imagine the original mess was itself a clue about what you were thinking then. What did the tidy version quietly delete — and would you want it back?
Hint
The append-only test: after a correction, can you still see the original? If a fix overwrites, you optimized for a clean record and threw away evidence of your own past state. Corrections that stack keep both the accurate 'now' and the honest 'then'.

Progress

Progress is local-only — sign in to sync across devices.
Spotted a bug or have feedback on this page?Report an Issue

Comments 0

🔔 Reply notifications (sign in)
Sign inPlease sign in to comment.

No comments yet — be the first.