Skip to content

docs: Guide document maintenance update - #2979

Open
loom-fleet-dispatch[bot] wants to merge 3 commits into
mainfrom
docs/guide-update-20261009-164417
Open

loom-fleet-dispatch[bot] wants to merge 3 commits into
mainfrom
docs/guide-update-20261009-164417

Conversation

@loom-fleet-dispatch

Copy link
Copy Markdown
Contributor

Summary

Automated document maintenance by the Guide triage agent.

Changes

  • WORK_LOG.md: Appended entries for recently merged PRs and closed issues
  • WORK_PLAN.md: Regenerated roadmap from current GitHub label state
  • README.md: Updated if architectural changes were detected

Context

This PR is generated automatically by the Guide role as part of its triage cycle.
See rjwalters/loom#1784 for the feature specification (this template ships to every Loom-managed repo, so the reference must be fully qualified).

This PR only stages WORK_LOG.md/WORK_PLAN.md/README.md and qualifies for the docs-only fast path. Judge and Champion must re-derive the changed-file list.


Automated by Guide role - document maintenance phase

Automated document maintenance by Guide triage agent.
@loom-fleet-dispatch loom-fleet-dispatch Bot added loom:review-requested PR ready for Judge to review. Applied by: Builder when opening PR. loom:reviewing Judge is reviewing this PR. Applied by: Judge only. Stale after LOOM_STALE_REVIEWING_MINUTES (30m). and removed loom:reviewing Judge is reviewing this PR. Applied by: Judge only. Stale after LOOM_STALE_REVIEWING_MINUTES (30m). labels Oct 9, 2026
@loom-fleet-dispatch

Copy link
Copy Markdown
Contributor Author

Code review passed via the docs-only fast path: the paginated changed-file list is exactly WORK_LOG.md and WORK_PLAN.md, the diff is appropriate, all 23 checks shown by gh pr checks 2979 pass, merge state is clean, and review feedback is clear.

No approval verdict was posted because the mandatory exact-head CI gate could not read its sentinel: this checkout's installed loom-daemon does not recognize forge wait-checks. I released loom:reviewing and left loom:review-requested in place for a fresh Judge pass after the installed daemon is resynced; I did not bypass the gate.

@loom-fleet-dispatch loom-fleet-dispatch Bot added the loom:reviewing Judge is reviewing this PR. Applied by: Judge only. Stale after LOOM_STALE_REVIEWING_MINUTES (30m). label Oct 10, 2026
@loom-fleet-dispatch

Copy link
Copy Markdown
Contributor Author

✅ Approved (Docs-Only Fast Path)

The paginated files API returned exactly WORK_LOG.md and WORK_PLAN.md, qualifying for the docs-only fast path. Local tests and full code evaluation were skipped under that policy; the PR has no Test Plan or TDD claim.

Verification at head 770496d65b46701053c125d44b4d6d81be29bc68:

  • loom-daemon forge wait-checks 2979 --timeout 20 returned LOOM-CHECKS-GREEN for this head.
  • check-review-feedback.sh returned CLEAR: zero formal reviews and zero inline comments or unresolved threads.
  • The live verdict recheck confirmed CLEAN merge state, unchanged head, and the active reviewing claim with no competing verdict.

loom dashboard

@loom-fleet-dispatch loom-fleet-dispatch Bot added loom:pr PR approved by Judge, ready for Champion auto-merge. Applied by: Judge. and removed loom:review-requested PR ready for Judge to review. Applied by: Builder when opening PR. loom:reviewing Judge is reviewing this PR. Applied by: Judge only. Stale after LOOM_STALE_REVIEWING_MINUTES (30m). labels Oct 10, 2026
@loom-fleet-dispatch

Copy link
Copy Markdown
Contributor Author

Champion Auto-Merge

This PR meets all six safety criteria at head 770496d65b46701053c125d44b4d6d81be29bc68:

  • Judge approval is fresh for this head; loom:pr is present with no competing verdict or prior hold.
  • Docs-only fast path: the freshly paginated files API returns exactly WORK_LOG.md and WORK_PLAN.md; the diff records Guide maintenance.
  • PASS: No critical files modified (the exclusion loop ran over the complete file list).
  • Live mergeability is MERGEABLE; the PR is not a draft.
  • Last real activity was about two hours ago, within the 24-hour window.
  • All 24 live CI checks pass.

Proceeding with squash merge. The documentation change can be reverted with git revert <squash-sha>.


Automated by Champion role

…y #8508)

This commit intentionally changes NOTHING in the tree — it exists only to give every required check a fresh started_at, because the #8248 required-check-freshness guard blocked this merge on evidence that predates the base branch's current tip, and the merge token lacks actions:write to re-run the stale check directly.

Stale-Check: Lint (ruff)
Stale-Clause: this required check has no entry in the input-scope table and no declaration in `.loom/stale-check-inputs.json`, so which files it reads is unknown
Coupled-Base-Path: .agents/skills/loom-auditor/SKILL.md
Coupled-PR-Path: none
@loom-fleet-dispatch

Copy link
Copy Markdown
Contributor Author

Automated re-date of stale required checks (#8508), 1 of 3

The #8248 required-check-freshness guard blocked the merge of PR #2979: a required check's green result predates the current base-branch tip, and this repo's merge token has no actions:write to re-run that check directly. Pushed a tree-identical no-op commit (40429c1) instead — the diff is byte-for-byte unchanged, but every required check now re-runs against a current timestamp.

This moves the head SHA, which invalidates the standing Judge approval (#5686). Expect this PR to cycle back through loom:review-requested once CI on 40429c1 completes, then merge normally once re-approved.

The #8248 guard itself is unchanged and still applies to the next merge attempt. This is re-date 1 of a budget of 3 for this chain of tree-identical heads (#9590); once the budget is spent, a further block escalates to loom:operator.

loom dashboard

@loom-fleet-dispatch

Copy link
Copy Markdown
Contributor Author

Stale review verdict cleared — head SHA moved

This PR's loom:pr verdict was rendered against 770496d65b46701053c125d44b4d6d81be29bc68, but the current head is 40429c166a894fb6c40d83df1b4cf89e501c604d. A review verdict is a statement about a specific tree, so it does not survive a rebase, a force-push, or new commits.

  • Verdict cleared: loom:pr (recorded for 770496d65b46701053c125d44b4d6d81be29bc68)
  • Returned to the review queue: loom:review-requested (current head 40429c166a894fb6c40d83df1b4cf89e501c604d)

Judge will re-evaluate the tree that is actually here now. No judgment about the new tree is implied either way — the old verdict simply no longer describes it.


Automated by verdict-staleness-guard.sh (#5686)

@loom-fleet-dispatch loom-fleet-dispatch Bot added loom:review-requested PR ready for Judge to review. Applied by: Builder when opening PR. loom:reviewing Judge is reviewing this PR. Applied by: Judge only. Stale after LOOM_STALE_REVIEWING_MINUTES (30m). and removed loom:pr PR approved by Judge, ready for Champion auto-merge. Applied by: Judge. labels Oct 10, 2026
@loom-fleet-dispatch

Copy link
Copy Markdown
Contributor Author

Code evaluation passed via the docs-only fast path: the complete paginated changed-file list contains only WORK_LOG.md and WORK_PLAN.md, and formal reviews/inline threads are clear. CI remained pending after the bounded foreground wait (Analyze (rust) and Python 3.10–3.14 tests), so no verdict is being issued. Releasing loom:reviewing and leaving loom:review-requested in place for a fresh Judge pass once CI settles.

@loom-fleet-dispatch loom-fleet-dispatch Bot added loom:reviewing Judge is reviewing this PR. Applied by: Judge only. Stale after LOOM_STALE_REVIEWING_MINUTES (30m). and removed loom:reviewing Judge is reviewing this PR. Applied by: Judge only. Stale after LOOM_STALE_REVIEWING_MINUTES (30m). labels Oct 10, 2026
@loom-fleet-dispatch

Copy link
Copy Markdown
Contributor Author

✅ Approved (Docs-Only Fast Path)

The paginated files API (gh api repos/{owner}/{repo}/pulls/2979/files --paginate --jq '.[].filename') returned exactly:

  • WORK_LOG.md
  • WORK_PLAN.md

Both match the root-level docs fast-path allowlist. Local builds and tests were skipped under that policy.

loom-daemon forge wait-checks 2979 --timeout 20 returned LOOM-CHECKS-GREEN 40429c166a894fb6c40d83df1b4cf89e501c604d. The review-feedback gate returned CLEAR, with zero formal reviews and zero inline comments or unresolved threads. The live pre-verdict check confirmed CLEAN merge state, an intact reviewing claim, and the same head SHA.

loom dashboard

@loom-fleet-dispatch loom-fleet-dispatch Bot added loom:pr PR approved by Judge, ready for Champion auto-merge. Applied by: Judge. and removed loom:review-requested PR ready for Judge to review. Applied by: Builder when opening PR. loom:reviewing Judge is reviewing this PR. Applied by: Judge only. Stale after LOOM_STALE_REVIEWING_MINUTES (30m). labels Oct 10, 2026
@loom-fleet-dispatch

Copy link
Copy Markdown
Contributor Author

Champion Auto-Merge

This PR meets all safety criteria for automatic merging:

  • Judge approved (loom:pr label; verdict matches the current head)
  • Merge-risk judgment passed: docs-only fast path (#6134), with the paginated file list confined exactly to root-level WORK_LOG.md and WORK_PLAN.md
  • Diff size: 29 lines (+21/-8) — informational, not a gate
  • No critical files modified
  • No merge conflicts
  • Updated recently (0 hours ago)
  • All CI checks passing

Proceeding with squash merge... If this was merged in error, you can revert with:
git revert <commit-sha>


Automated by Champion role

@loom-fleet-dispatch

Copy link
Copy Markdown
Contributor Author

Champion: Merge Failed

The required worktree-safe merge command refused to merge because this host’s loom-daemon is version 0.19.623, which predates the mandatory merge-pr ci-result verifier (>= 0.19.763). The verifier failed closed; the PR was not merged, and loom:pr remains in place.

Remediation: update or point LOOM_DAEMON_BIN at a compatible daemon, confirm loom-daemon merge-pr --help exposes ci-result, then rerun Champion.


Automated by Champion role

@loom-fleet-dispatch

Copy link
Copy Markdown
Contributor Author

Champion Auto-Merge

All six safety criteria pass for head 40429c166a894fb6c40d83df1b4cf89e501c604d:

  • Fresh Judge approval and loom:pr, with no competing verdict labels or prior hold.
  • Docs-only fast path independently confirmed from the paginated files API: exactly root WORK_LOG.md and WORK_PLAN.md; the diff updates repository work records.
  • Critical-file check completed against both changed paths with no matches.
  • Live mergeability is MERGEABLE.
  • Last real activity is 2026-10-10T07:06:46Z, within 24 hours.
  • Live CI reports 24 passing checks.

Proceeding with squash merge. A normal git revert can undo these documentation changes.


Automated by Champion role

…y #8508)

This commit intentionally changes NOTHING in the tree — it exists only to give every required check a fresh started_at, because the #8248 required-check-freshness guard blocked this merge on evidence that predates the base branch's current tip, and the merge token lacks actions:write to re-run the stale check directly.

Stale-Check: Lint (ruff)
Stale-Clause: this required check has no entry in the input-scope table and no declaration in `.loom/stale-check-inputs.json`, so which files it reads is unknown
Coupled-Base-Path: .loom/docs/build-gate.md
Coupled-PR-Path: none
@loom-fleet-dispatch

Copy link
Copy Markdown
Contributor Author

Automated re-date of stale required checks (#8508), 2 of 3

The #8248 required-check-freshness guard blocked the merge of PR #2979: a required check's green result predates the current base-branch tip, and this repo's merge token has no actions:write to re-run that check directly. Pushed a tree-identical no-op commit (8bd4bc8) instead — the diff is byte-for-byte unchanged, but every required check now re-runs against a current timestamp.

This moves the head SHA, which invalidates the standing Judge approval (#5686). Expect this PR to cycle back through loom:review-requested once CI on 8bd4bc8 completes, then merge normally once re-approved.

The #8248 guard itself is unchanged and still applies to the next merge attempt. This is re-date 2 of a budget of 3 for this chain of tree-identical heads (#9590); once the budget is spent, a further block escalates to loom:operator.

loom dashboard

@loom-fleet-dispatch

Copy link
Copy Markdown
Contributor Author

Stale review verdict cleared — head SHA moved

This PR's loom:pr verdict was rendered against 40429c166a894fb6c40d83df1b4cf89e501c604d, but the current head is 8bd4bc8face0229ff05f8d91cafbadf802e1aff1. A review verdict is a statement about a specific tree, so it does not survive a rebase, a force-push, or new commits.

  • Verdict cleared: loom:pr (recorded for 40429c166a894fb6c40d83df1b4cf89e501c604d)
  • Returned to the review queue: loom:review-requested (current head 8bd4bc8face0229ff05f8d91cafbadf802e1aff1)

Judge will re-evaluate the tree that is actually here now. No judgment about the new tree is implied either way — the old verdict simply no longer describes it.


Automated by verdict-staleness-guard.sh (#5686)

@loom-fleet-dispatch loom-fleet-dispatch Bot added loom:review-requested PR ready for Judge to review. Applied by: Builder when opening PR. and removed loom:pr PR approved by Judge, ready for Champion auto-merge. Applied by: Judge. labels Oct 10, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

loom:review-requested PR ready for Judge to review. Applied by: Builder when opening PR.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants