Skip to content

constitution: make Gatehouse advisory gate enforceable (v1.9.0)#9

Merged
fatherlinux merged 1 commit into
mainfrom
fix/gatehouse-advisory-enforceable
Jul 6, 2026
Merged

constitution: make Gatehouse advisory gate enforceable (v1.9.0)#9
fatherlinux merged 1 commit into
mainfrom
fix/gatehouse-advisory-enforceable

Conversation

@fatherlinux

Copy link
Copy Markdown
Member

Rationale

§XII already declared Gatehouse an advisory gate ("do not block merge"), but nothing in the doctrine stopped adopters from wiring the review job as a required status check. That happened: on crunchtools/mcp-trentina#56, the review — configured as required — blocked an otherwise-green PR on three separate runs, each producing a different set of all-false HIGH findings (see crunchtools/gatehouse#23). The PR had to be admin-merged.

Change

Strengthens §XII → Gatehouse to make "advisory" enforceable, not just aspirational:

  • The review job is advisory by construction — the reusable workflow exits 0 regardless of findings by default.
  • It MUST NOT be configured as a required status check.
  • Blocking is opt-in (blocking: true input) and, even when enabled, still MUST NOT be a required check.
  • Clarifies that the guard job is the one to mark required.

Bumps 1.8.0 → 1.9.0 (new governance constraint) with a ratification-history row.

Companion PR

The gatehouse implementation that makes the reusable workflow honor this: crunchtools/gatehouse#24.

🤖 Generated with Claude Code

§XII already declared Gatehouse advisory, but nothing stopped adopters
from wiring the review job as a required status check — which they did,
and a non-deterministic LLM finding blocked a green PR (gatehouse#23,
mcp-trentina#56).

Strengthen the rule: the review job is advisory by construction (exits 0
by default), MUST NOT be a required status check, and blocking is opt-in
via the `blocking: true` input and still never a required check. The
guard job is the one to mark required.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the CrunchTools Constitution to version 1.9.0, specifying that the Gatehouse AI review job is advisory and must not be configured as a required status check. The review feedback suggests minor improvements to formatting consistency, such as enclosing the review job in backticks and refining the phrasing to align with RFC-style standards.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread constitution.md
- CI workflow name: `Gatehouse`. Job names: `Protect workflows` (guard) and `Gatehouse review` (review).
- Gatehouse is an **advisory gate** — findings are posted as PR review comments for the maintainer to triage, but do not block merge.
- The `guard` job is a **blocking gate** — PRs from non-members that modify `.github/workflows/` MUST be rejected.
- **The review job is advisory by construction and MUST NOT be a required status check.** An LLM reviewer is non-deterministic and hallucinates findings; giving it merge authority forces maintainers to either bypass branch protection or "fix" non-bugs. The reusable workflow exits `0` regardless of findings by default. Blocking behavior is opt-in only (the workflow's `blocking: true` input), and even when enabled the review job MUST NOT be added to branch protection as a required check.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

For consistency with other job references (like guard), the review job should be enclosed in backticks. Additionally, adding a comma after 'enabled' improves readability.

Suggested change
- **The review job is advisory by construction and MUST NOT be a required status check.** An LLM reviewer is non-deterministic and hallucinates findings; giving it merge authority forces maintainers to either bypass branch protection or "fix" non-bugs. The reusable workflow exits `0` regardless of findings by default. Blocking behavior is opt-in only (the workflow's `blocking: true` input), and even when enabled the review job MUST NOT be added to branch protection as a required check.
- **The `review` job is advisory by construction and MUST NOT be a required status check.** An LLM reviewer is non-deterministic and hallucinates findings; giving it merge authority forces maintainers to either bypass branch protection or "fix" non-bugs. The reusable workflow exits `0` regardless of findings by default. Blocking behavior is opt-in only (the workflow's `blocking: true` input), and even when enabled, the `review` job MUST NOT be added to branch protection as a required check.

Comment thread constitution.md
- Gatehouse is an **advisory gate** — findings are posted as PR review comments for the maintainer to triage, but do not block merge.
- The `guard` job is a **blocking gate** — PRs from non-members that modify `.github/workflows/` MUST be rejected.
- **The review job is advisory by construction and MUST NOT be a required status check.** An LLM reviewer is non-deterministic and hallucinates findings; giving it merge authority forces maintainers to either bypass branch protection or "fix" non-bugs. The reusable workflow exits `0` regardless of findings by default. Blocking behavior is opt-in only (the workflow's `blocking: true` input), and even when enabled the review job MUST NOT be added to branch protection as a required check.
- The `guard` job is a **blocking gate** — PRs from non-members that modify `.github/workflows/` MUST be rejected. It, not the review job, is the one to mark required.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The phrase 'It, not the review job, is the one to mark required' is slightly awkward and lacks the RFC-style formatting used elsewhere in the constitution. Enclosing review in backticks also ensures consistency with guard.

Suggested change
- The `guard` job is a **blocking gate** — PRs from non-members that modify `.github/workflows/` MUST be rejected. It, not the review job, is the one to mark required.
- The `guard` job is a **blocking gate** — PRs from non-members that modify `.github/workflows/` MUST be rejected. It, not the `review` job, MUST be configured as a required status check.

@fatherlinux fatherlinux merged commit 91de770 into main Jul 6, 2026
2 checks passed
@fatherlinux fatherlinux deleted the fix/gatehouse-advisory-enforceable branch July 6, 2026 15:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant