aboutsummaryrefslogtreecommitdiffstats
path: root/docs/superpowers
diff options
context:
space:
mode:
Diffstat (limited to 'docs/superpowers')
-rw-r--r--docs/superpowers/specs/2026-10-16-notes-design.md4
1 files changed, 4 insertions, 0 deletions
diff --git a/docs/superpowers/specs/2026-10-16-notes-design.md b/docs/superpowers/specs/2026-10-16-notes-design.md
index a9f5420..53b9d2e 100644
--- a/docs/superpowers/specs/2026-10-16-notes-design.md
+++ b/docs/superpowers/specs/2026-10-16-notes-design.md
@@ -120,6 +120,10 @@ and writing it back would delete every title, so the write instead reports
git to resolve. `Notes.valid` is the check; `Notes.parse` stays tolerant for
display, returning an empty store for the same input.
+A write that fails is reported, not assumed to have landed: both writes block
+(`blockWrites`), because `setText` is asynchronous otherwise, and a failure
+that nobody observes reports a save that never happened.
+
- **Create**: the first click pulls first (see Git), then re-reads `db.json`
so the append is based on what the pull brought in, not on what was read
before it; `notes.sh` reads the id after its own pull for the same reason.