From 097db6d33cb97108d66eee82c1e43842dca765b0 Mon Sep 17 00:00:00 2001 From: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com> Date: Wed, 28 Oct 2026 22:36:14 -0400 Subject: [PATCH 1/2] =?UTF-8?q?=F0=9F=93=96=20docs:=20add=20capability-gap?= =?UTF-8?q?=20and=20human-merge=20rows=20to=20the=20decision=20glossary=20?= =?UTF-8?q?Rules=20table?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: scanner <280983584+hivecommons-hive[bot]@users.noreply.github.com> --- src/docs/labels-and-control-signals.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/src/docs/labels-and-control-signals.md b/src/docs/labels-and-control-signals.md index 71946a6cbd..b9f205846d 100644 --- a/src/docs/labels-and-control-signals.md +++ b/src/docs/labels-and-control-signals.md @@ -1456,6 +1456,7 @@ The plain-words comment the delegate posts has four lines — **Hive decided** ( | Token | Plain words | Detail | |---|---|---| +| `capability-gap` | the GitHub App lacks a permission; deciding cannot clear it | The blocker is a missing GitHub App permission (for example `workflows`). Approving a direction would only re-apply needs-human, so the park stays until the owner grants the permission or a person applies the change. | | `ci-ratchet` | a CI hygiene gate, landed as a ratchet | A new CI hygiene gate lands as a ratchet: it records today's baseline and fails only on increases, so existing work is never blocked. | | `contributor-offline` | the author's hive hasn't been connected since the nudge | The PR's author has been offline since the hive nudged them, so the hive takes the work over instead of waiting. | | `dedupe` | an older issue already tracks this | An older issue already tracks the same work; one thread keeps it moving. | @@ -1509,6 +1510,7 @@ The plain-words comment the delegate posts has four lines — **Hive decided** ( | `dco`, `dco-missing` | a commit is missing its sign-off | A commit on the branch is missing its Developer Certificate of Origin sign-off; the author must sign it off. | | `effect-unknown` | the hive did not say why | The hive could not tell from the lane reason why the decision has not taken effect. | | `hold` | on hold; the hive does nothing until it is released | The item is on hold. The hive does nothing with it until a person releases the hold. | +| `human-merge` | no merge lane vouches for this PR's author; a maintainer merges | The PR is ready, but its author is not a collaborator and holds no trusted or merger tier, so no merge lane vouches for them and the hive never merges it unattended. A maintainer merges it (Approve & merge as maintainer, or Approve — let hive merge), or trusts the author under 👥 Contributors. | | `label:needs-human`, `needs-human`, `requires_human` | marked needs-human; a person must remove the label | The item is marked needs-human: automated fixes ran out or a person flagged it. The hive waits until the label is removed. | | `no-effect` | the decision hasn't taken effect | The hive recorded this decision, but what it was supposed to cause has not happened within the expected time. | | `no-new-commit` | no new commit has been pushed | The hive gave direction, but no new commit has been pushed yet. | From 73ec9d06b0f640b405a9dd555163043d6358366e Mon Sep 17 00:00:00 2001 From: ci-maintainer <280983584+hivecommons-hive[bot]@users.noreply.github.com> Date: Wed, 28 Oct 2026 22:47:54 -0400 Subject: [PATCH 2/2] =?UTF-8?q?=F0=9F=93=96=20docs:=20list=20human-merge?= =?UTF-8?q?=20aliases=20and=20the=20#15206=20adoption=20reasons=20in=20the?= =?UTF-8?q?=20glossary=20tables?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Review follow-up for #15259: the human-merge Reasons row now carries its glossary aliases (author-association, contributor-lane:author-association, ready-for-human-merge, untrusted-author) like every other aliased row, and the three Reasons #15206 added to decision_glossary.go — workflow-path (with its aliases), adoption-executing and adoption-undone — get rows so the table matches the code on v5. Hive-Fix-Attempt: 1/6 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Signed-off-by: ci-maintainer <280983584+hivecommons-hive[bot]@users.noreply.github.com> --- src/docs/labels-and-control-signals.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/src/docs/labels-and-control-signals.md b/src/docs/labels-and-control-signals.md index b9f205846d..ea41c6cefb 100644 --- a/src/docs/labels-and-control-signals.md +++ b/src/docs/labels-and-control-signals.md @@ -1501,6 +1501,10 @@ The plain-words comment the delegate posts has four lines — **Hive decided** ( | Token | Plain words | Detail | |---|---|---| | `adoption-disabled` | adoption is switched off on this hive | Stage adoption is disabled on this hive (governor.labels.stage.adoption), so a request to take a PR over is never carried out. | +| `adoption-executing` | the adoption engine is carrying it out | The decision is recorded and the adoption engine picks it up on its next stage pass (a few minutes): it pushes the commits to a hive branch and opens the hive's copy. Nothing to do yet. | +| `adoption-stalled:contributor-lane:workflow-path`, `capability:workflows-permission`, `contributor-lane:workflow-path`, `workflow-path` | the PR edits .github/workflows; the hive's App lacks the `workflows` permission, so it cannot adopt it | The PR changes files under .github/workflows. The hive's GitHub App has no `workflows` permission, so the adoption fence refuses to publish those edits from the hive. Grant the App the `workflows` permission and re-run the decision, or have a person rebase and merge it on GitHub, or close it as superseded. | +| `adoption-undone` | the hive's copy was closed without merging and the adoption was undone | The hive opened its copy, but the copy was closed without merging and a fresh one could not be opened, so the adoption was undone and the PR is back in its normal flow. Re-run the decision to adopt it again, or act on GitHub. | +| `author-association`, `contributor-lane:author-association`, `human-merge`, `ready-for-human-merge`, `untrusted-author` | no merge lane vouches for this PR's author; a maintainer merges | The PR is ready, but its author is not a collaborator and holds no trusted or merger tier, so no merge lane vouches for them and the hive never merges it unattended. A maintainer merges it (Approve & merge as maintainer, or Approve — let hive merge), or trusts the author under 👥 Contributors. | | `author-online` | the author's hive is connected, so hive won't take the PR over | Adoption is for authors whose hive has gone offline; this author's hive is connected, so the hive leaves the PR with them. | | `behind` | the branch is behind the base branch | The branch is behind the base branch and must be updated before it can merge. | | `changes-requested`, `changes_requested`, `contributor-lane:changes-requested`, `human-changes-requested`, `request_changes`, `reviewer-verdict:request_changes` | a reviewer asked for changes; a new commit is needed | A reviewer asked for changes on this branch. Approving cannot override that: only a new commit, or a maintainer merging by hand, moves it. | @@ -1510,7 +1514,6 @@ The plain-words comment the delegate posts has four lines — **Hive decided** ( | `dco`, `dco-missing` | a commit is missing its sign-off | A commit on the branch is missing its Developer Certificate of Origin sign-off; the author must sign it off. | | `effect-unknown` | the hive did not say why | The hive could not tell from the lane reason why the decision has not taken effect. | | `hold` | on hold; the hive does nothing until it is released | The item is on hold. The hive does nothing with it until a person releases the hold. | -| `human-merge` | no merge lane vouches for this PR's author; a maintainer merges | The PR is ready, but its author is not a collaborator and holds no trusted or merger tier, so no merge lane vouches for them and the hive never merges it unattended. A maintainer merges it (Approve & merge as maintainer, or Approve — let hive merge), or trusts the author under 👥 Contributors. | | `label:needs-human`, `needs-human`, `requires_human` | marked needs-human; a person must remove the label | The item is marked needs-human: automated fixes ran out or a person flagged it. The hive waits until the label is removed. | | `no-effect` | the decision hasn't taken effect | The hive recorded this decision, but what it was supposed to cause has not happened within the expected time. | | `no-new-commit` | no new commit has been pushed | The hive gave direction, but no new commit has been pushed yet. |