Skip to content

handoff: ramble phase 2 shipped, heart containers live on grackle - #340

Merged
kh0pper merged 1 commit into
mainfrom
docs/ramble-hearts-handoff
Sep 9, 2026
Merged

handoff: ramble phase 2 shipped, heart containers live on grackle#340
kh0pper merged 1 commit into
mainfrom
docs/ramble-hearts-handoff

Conversation

@kh0pper

@kh0pper kh0pper commented Sep 9, 2026

Copy link
Copy Markdown
Owner

Handoff doc for the reward-economy phase 2 arc, shipped in #339 (4a5c3215, ramble 0.10.0) and deployed to grackle.

Docs-only. Records what shipped, the deploy verification, what is open for Kevin, the follow-ups, and three lessons that cost real rework:

  • A wrong-but-checkable justification is worse than none. The asymmetric energy clamp was justified by an ordering claim about SYNCED_TABLES that is false — it is only ever a .includes() allowlist, and _applyEntry applies one entry at a time in arrival order. The design was right, the reason was not, and it had shipped in a code comment where a future reader would check it, find it false, and revert a clamp that prevents permanent energy loss.
  • Fixing review findings introduces new ones — three of round 2's four findings were in code written to fix round 1, including a "fresh" fixture cell that was an existing test's own cell.
  • Guarding one caller is not guarding the invariant — the first clamp fix protected a cold read while a hotter write path kept truncating.

Also records two operational facts worth not rediscovering: grackle's crow DB is ~/crow/data/crow.db, not ~/.crow/crow.db (which is 0 bytes), while bundles still install under ~/.crow/bundles/; and there is no CI gate for guide-doc i18n parity, contrary to what the plan claimed.

@kh0pper
kh0pper merged commit fa47264 into main Sep 9, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant