docs(state): drop stale convergence-branch claim, fix dead issue citation - #36
Merged
Merged
Conversation
…tion current_state.toml still said the v1 invocation/supervisor contract was implemented on a convergence branch awaiting hosted gate evidence. That branch never existed on this repo -- only main does -- and the contract shipped as a breaking change in v0.3.0 with real hosted gate evidence on main since (green on the two most recent merged PRs). The stale claim was the only instance of this false premise in the tree. hybrid-gate-adapter.yml's timeout comment cited an issue number that does not exist in the kanon repo (which tops out far below it). The real justification is a merged first-party PR that raised the fleet reusable's timeout input default to 90 -- this file hand-copies that reusable rather than calling it, so it never inherited the new default and had to hardcode it. Documented the hand-copy relationship explicitly, since that is the reason this timeout needs manual upkeep at all, and flagged why the copy cannot simply become a direct reusable call: the fleet reusable's aggregation job is named differently than this file's local one, so switching would rename this repo's required status check and break branch protection until that rename is coordinated separately.
forkwright
pushed a commit
that referenced
this pull request
Sep 3, 2026
🤖 I have created a release *beep* *boop* --- ## [0.4.1](v0.4.0...v0.4.1) (2026-09-03) ### Documentation * **state:** drop stale convergence-branch claim, fix dead issue citation ([#36](#36)) ([d6133f7](d6133f7)) --- This PR was generated with [Release Please](https://github.com/googleapis/release-please). See [documentation](https://github.com/googleapis/release-please#release-please). Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Finding
Two false assertions in this repo's own documentation:
_llm/current_state.toml'scontract_statusclaims the breaking v1 invocation/supervisor contract is "implemented on the convergence branch and awaits exact-head hosted compilation and gate evidence." No convergence branch exists (gh api repos/forkwright/epitelesis/brancheslists onlymain), and the contract has been shipped and enforced since v0.3.0.hybrid-gate-adapter.yml'stimeout-minutes: 90comment cites a kanon issue number that does not exist in that repo today. The number it actually meant isforkwright/.github#45, a merged PR that raised the fleet reusable'sfull_gate_timeout_minutesdefault to 90.Evidence
gh api repos/forkwright/epitelesis/branches --jq '.[].name'→mainonly.CHANGELOG.mdv0.3.0 entry (2026-07-28): "⚠ BREAKING CHANGES: enforce the v1 invocation lifecycle contract (feat!: enforce the v1 invocation lifecycle contract #17)".gh pr view 34 --repo forkwright/epitelesis --json statusCheckRollupand the same for PR ci: adopt the fleet release-PR healer #35: both showgate / full-gate-buildandgate / gate-attestationgreen, merged ontomainon 2026-08-25/26.gh issue list --repo forkwright/kanon --state all --limit 1→ kanon's highest issue number is far below the one cited in the adapter comment; the cited number does not resolve (gh issue viewon it 404s).gh pr view 45 --repo forkwright/.github --json title,state,mergedAt→ merged, "ci(gate): raise the default full-gate timeout to 90m fleet-wide" — this is what the comment actually meant to cite.Why this matters
current_state.tomlis declared as this repo's canonical machine-readable state doc (_llm/current_state.toml, listed in its ownsource_docs). An agent or tool reading it for the contract's real status is told to look for a branch that doesn't exist and to wait for evidence that already landed five weeks ago — the opposite of what the file exists to prevent.The dead issue citation in the workflow comment sends the next reader chasing a number that resolves to nothing, right at the point where the comment is explaining why a value needs manual upkeep at all (this job is a hand-copy of the fleet reusable, not a
workflow_callconsumer of it, so it never inherits the reusable's own default and must be kept in sync by hand -- that fact was missing from the original comment too).Desired correction
current_state.toml: state that the contract is implemented and enforced onmain, verified by the hosted full gate, and refreshupdated. Done in this PR.hybrid-gate-adapter.yml: point the citation at the PR that actually raised the default (forkwright/.github#45), and state plainly that this file hand-copies the fleet reusable rather than calling it. Done in this PR.Not done in this PR, reported separately: the deeper substrate-drift this hand-copy represents -- replacing the ~185-line duplicate with a direct
uses: forkwright/.github/.github/workflows/hybrid-gate.yml@maincall, matchingforkwright/zetesis's pattern -- is out of scope here. Verified viaforkwright/zetesis's live branch protection (gh api repos/forkwright/zetesis/branches/main/protection), the fleet reusable's own aggregation job is namedgate, so a direct call would produce required-check contextgate / gate, not this repo's currentgate / gate-attestation(confirmed via this repo's own branch protection). That rename would break branch protection until coordinated with a protection update, which is out of this lane's authority. Flagged inline in the workflow comment and reported to the orchestrator.Done when:
current_state.tomland the workflow comment both state only claims that are true today, and neither cites a resource that doesn't exist.