Skip to content

Git designed for AI agents.

doc: PLAN9 decisions and amendments, the guarantee of lost attempts

Federico Elia8359e7846d25
diff --git a/doc/graft/LIMITATIONS.md b/doc/graft/LIMITATIONS.md
index 157631f..4f8fb60 100644
--- a/doc/graft/LIMITATIONS.md
+++ b/doc/graft/LIMITATIONS.md
@@ -152,6 +152,13 @@ Git hooks use private.
runs with a quarantine, the migration of that quarantine also fsyncs its files,
because a hook may write objects without git; that costs about one fsync per
file of the write.
+- The objects of an update that fails after the quarantine migration remain in
+ the repository unreferenced until housekeeping prunes them. They have passed
+ the pre-receive hook. Until pruned, they can be read by object ID by anyone
+ with read access to the repository. This happens when a land loses its
+ compare-and-swap (a batch attempt leaves one pack, an unbatched land loose
+ objects), when the expected old revision of a write is stale, and after a
+ crash between the migration and the reference update.
### Landing (`UserLand`)
diff --git a/doc/graft/PLAN9.md b/doc/graft/PLAN9.md
index b7898f2..0937a1a 100644
--- a/doc/graft/PLAN9.md
+++ b/doc/graft/PLAN9.md
@@ -1,8 +1,10 @@
# Graft p5w: the write path, root causes first (plan for approval)
-Status: proposed, waiting for the PM's approval; nothing below is implemented.
-Owner: p5w (Opus). Branch `p5w-write-path` (from `6a94caf`, the final phase 4b
-tree, plus the committer-date skew fix `04c0776..b6058e5`).
+Status: approved by the PM with the decisions and amendments of section 14;
+WP91 to WP95 implemented, the acceptance measurement (section 11) waits for a
+benchmark window, WP96 (stage 2) is gated on it. Owner: p5w (Opus). Branch
+`p5w-write-path` (from `6a94caf`, the final phase 4b tree, plus the
+committer-date skew fix `04c0776..b6058e5` and its performance fix `6aecff1`).
Phase 4b is in [PLAN8.md](PLAN8.md). Its profile left two costs outside the land
lane, shared with every other write: the quarantine migration fsyncs again files