Watch
0
0
Fork
You've already forked hyperhive
0

hive-forge: state the read-state contract in the guard docs

This commit is contained in:
atlas 2026-11-15 20:17:45 +01:00 • committed by mara
commit 4a109fa038

View file

@ -260,9 +260,10 @@ to discover valid label names before triaging or to audit the label set.
<!-- vale write-good.Passive = NO -->
- **Read-before-comment guard:** `comment` refuses to post when forge still
has an unread notification for the thread (that is, someone commented since
you last read it). This prevents accidentally replying to old activity without
seeing the new context. Read the thread with `hive-forge view <n>` or
has an unread notification for the thread. `hive-forge-notify` marks a
thread read when it delivers it as a todo, so the guard catches only
activity newer than the last delivery (one 30 s poll) and threads whose
delivery failed. Read the thread with `hive-forge view <n>` or
`hive-forge comments <n>` (which mark the notification read and clear the
block), or pass `--force` to skip the guard.
- `comment --body "..."` with backticks in the body: always use