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.mdindex 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 perfile 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.mdindex 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 landlane, shared with every other write: the quarantine migration fsyncs again files