This is an automated email from the ASF dual-hosted git repository.

spmallette pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/tinkerpop.git

commit 367bca2ba2b8f0e913356463ecf79ef833547fda
Author: Stephen Mallette <[email protected]>
AuthorDate: Sat Aug 22 14:04:42 2026 -0400

    Note that an epic root needs --force to close
    
    The commit record written at merge is a pinned child, and bd's epic gate
    counts only closed children, so the record blocks the close it precedes.
    
    Assisted-by: Claude Code:claude-opus-5
---
 .beads/PRIME.md | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/.beads/PRIME.md b/.beads/PRIME.md
index 633894e06a..43d443d578 100644
--- a/.beads/PRIME.md
+++ b/.beads/PRIME.md
@@ -189,7 +189,7 @@ Tasks closed as they finished (section 3), decisions as 
they were written (secti
 bd children <root>               # the whole subtree; nothing should still be 
in_progress
 bin/beads-commits.py --root <root> --branch 3.7-dev --suggest   # propose; 
operator confirms
 bin/beads-commits.py --root <root> --branch 3.7-dev --commits <sha>...
-bd close <root>
+bd close <root>                  # an epic root needs --force; see below
 bd update <id1> <id2> ... -s pinned
 bd dolt pull && bd dolt push
 ```
@@ -204,6 +204,12 @@ records, lists what else landed in the same window, and 
writes nothing. Show wha
 run the recording form. It refuses any sha not reachable from 
`origin/<branch>`, so a refusal
 means the work has not actually landed — say so and leave the root open.
 
+**An `epic` root needs `bd close <root> --force`.** The commit record just 
written is a
+child and is pinned, and the gate counts only `closed` children as done, so 
the record is
+what blocks the close. Do not reorder the two steps to dodge it: the record 
write is what
+refuses a sha unreachable from `origin/<branch>`, and closing first would 
resolve the root
+before that check runs. `task` and `feature` roots do not gate.
+
 **Pin every bead in the subtree** — root, decisions, records, tasks. No 
judgment about
 which ones matter: the work shipped, so all of it is the project's history. 
Show the
 operator the list first if they want a review gate.

Reply via email to