Skip to content

docs(quest): rewrite the queue watcher epic to its first flaky-test disable - #735

Merged
kixelated merged 2 commits into
mainfrom
quest/m0/queue-watcher/README
Nov 14, 2026
Merged

kixelated merged 2 commits into
mainfrom
quest/m0/queue-watcher/README

Conversation

@kixelated

@kixelated kixelated commented Nov 14, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

Rewrites the queue watcher epic to the one part of its end-to-end run that hasn't happened: a test flaking twice and its disable PR landing through moq-dev/moq's queue. The epic now waits on that flake.

The plan still holds. moq.pro moved onto the watcher's own queue (2026-11-12), quest land serve is retired (moq-dev/quest#707), and the README's landing section already describes the watcher in detail, so this repository needs no code or docs change.

Evidence for each part of the run, from the watcher's journal and state directory on the maintainer's host (quest-land-moq.service) and from moq-dev/moq's PR comments:

Part Evidence Status
Failing build fixed and re-enqueued moq-dev/moq#8672 (check biome), #8722 (cargo fmt): each merged at the exact head the watcher re-enqueued done
Conflict resolved and re-enqueued moq-dev/moq#8439: one merge-driver round and three fixer rounds, merged at the re-enqueued head done
Flaky failure re-enqueued unchanged moq-dev/moq#8468, #8551, #8694, all merged done
Test flaking twice disabled, landing with a passing quest/m0/flaky/ epic flaky.json holds 4 tests, each with one verdict. No quest-land/flaky-* PR exists, and moq has no quest/m0/flaky/ waiting
Design conflict handed back moq-dev/moq#8104: a modify/delete conflict on a quest file, handed back because it "requires a content decision" done

The watcher's state directory records 12 fixed, 7 merged, 3 flaky, 8 base, 1 environment and 38 handback rounds in the latest pick of each PR.

quest/m0/README.md's land bullet pointed at the epic as holding the full interview, and still listed "fixing picks GitHub refuses", which the 2026-11-02 pick-record decision dropped. It now says the epic's git history keeps the interview and links the remaining work.

Validation

  • Built dist/quest from this branch, wrote the disable path's fixed templates (FLAKY_EPIC and flakyQuest for two of the four recorded tests) into a clone of moq-dev/moq main at #8668, and ran quest check --no-stubs there: 507 documents ok. So the last step's quest tree should pass when the flake comes.
  • Checked the merged head of #8672, #8722 and #8439 against the journal's requeued <n> <sha> lines: each matches.
  • quest check --base origin/main, just check and just test pass.

Public API

None.

Choices made without asking

  • Kept the epic as a directory epic with no children rather than moving it to a plain quest file, so its branch and claim stay the same.
  • Dropped the epic's decision log, since everything it decided has shipped. Git history keeps it, and the m0 README now says so.
  • Left the missing-KVM handbacks below out of this epic. They are host or moq work, and the run's parts passed regardless.
  • Dropped the 10 watcher restarts in 3 days that crash in-flight fixers: they look like deploys, and the handback already says what to do.

Follow-ups

  • kixel-ai/dotfiles, for /quest-plan in its tree: give the land fixer /dev/kvm, so moq's just ci base runs its NixOS VM tests in the fixer container. Today the fixer hands back mechanical fixes because that container deliberately has no KVM (dotfiles' nixos/tests/quest-land-fixer.py asserts its absence). 19 of 132 fixer handback comments on moq cite it, most recently moq-dev/moq#8695. A few older handbacks cite swift: command not found (8 comments), the same class of gap.
    • Keep: ✅ keep (rejected: drop). Maintainer decision
    • Where: ✅ give the fixer KVM in kixel-ai/dotfiles (rejected: a moq-dev/moq gate mode without the VM tests). The plan there must keep the sandbox's other limits on untrusted PR code.

Models

Size: S
Implementer: Claude, claude-opus-5-5, unknown effort (arm A)

🤖 Generated with Claude Code

Review

Rewritten by quest review after each round.

  • Head: 4a1d079

  • Base: origin/main at ee98a03

  • Risk: low, Only quest plans and documentation change, so no behavior relied on by users or other repositories can break, and a revert fully restores the prior text.

  • Classified: low by Codex, gpt-6.1-sol, low effort, session 01a1db76-dd9d-7833-b606-c62949dd14fc

  • Reviewer: Codex, gpt-6.1-sol, high effort

  • Session: 01a1db76-f3dd-70b1-8fc1-1458d869a211, round 1

  • Score: 10/10, The documentation-only change consistently narrows the remaining quest to the first flaky-test disable, with no actionable defects found; builds, tests, and quest commands were not run.

  • Rounds: 1; first round 0; findings 0: fixed 0, refuted 0, open 0

  • Findings: none

  • Reviewer: Codex, gpt-6.1-sol, medium effort, shadow

  • Session: 01a1db76-f3de-77f1-9e9b-11b05020ac0e, round 1

  • Score: 10/10, The documentation-only change narrows the epic to its remaining end-to-end validation and matches the existing flaky-test disable workflow, with no actionable defects found.

  • Rounds: 1; first round 0; findings 0: fixed 0, refuted 0, open 0

  • Findings: none

kixelated and others added 2 commits November 14, 2026 11:07
…isable

Every part of the end-to-end run on moq-dev/moq is done except a test
flaking twice and its disable PR landing; the README already describes the
watcher. The epic now records the evidence and waits on that flake.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@kixelated kixelated changed the title Land through a serial merge queue with an async fixer docs(quest): rewrite the queue watcher epic to its first flaky-test disable Nov 14, 2026
@kixelated
kixelated marked this pull request as ready for review November 14, 2026 19:10
@coderabbitai

coderabbitai Bot commented Nov 14, 2026

Copy link
Copy Markdown

Warning

Review limit reached

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Next included review available in 52 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

Learn how review limits work.

Review configuration:

Run configuration

  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: Organization UI
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 17099ed6-b524-4c41-b64d-a2a3bfa07308
Commits

Reviewing files that changed from the base of the PR and between ee98a03 and 4a1d079.

Files selected for processing: 2

  • quest/m0/README.md
  • quest/m0/queue-watcher/README.md
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

@pullfrog pullfrog 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.

✅ No new issues found.

Reviewed changes: the full diff of two quest documents.

  • Queue watcher epic rewrite (quest/m0/queue-watcher/README.md): the epic shrinks from the full interview log to the one remaining step, a quest-land/flaky-<sha> disable PR landing through moq's queue. It carries evidence links for the finished parts and a ## Waiting entry with a concrete gh pr list check.
  • m0 README land bullet (quest/m0/README.md): the bullet no longer says the epic holds the interview, and it drops the stale "fixing picks GitHub refuses" item. It points to the git history and the remaining work.

Pullfrog  | View workflow run | Using claude-sonnet-5-5 | 𝕏

@kixelated

Copy link
Copy Markdown
Collaborator Author

Maintainer decision (via /quest-run, 2026-11-14):

  • Pick: ✅ /quest-merge (rejected: skip, /quest-delete).
  • Follow-up, the land fixer's missing /dev/kvm handbacks: ✅ keep (rejected: drop).
  • Where to fix it: ✅ give the fixer KVM, planned in kixel-ai/dotfiles' tree (rejected: a moq-dev/moq gate mode without the VM tests).

(Written by Claude Opus 5.5)

@kixelated

Copy link
Copy Markdown
Collaborator Author

Recorded the maintainer decision in the PR body's ## Follow-ups; the follow-up stays there for /quest-plan in kixel-ai/dotfiles.

(Written by Claude Opus 5.5)

@kixelated
kixelated added this pull request to the merge queue Nov 14, 2026
Merged via the queue into main with commit 076a8c7 Nov 14, 2026
26 checks passed
@kixelated
kixelated deleted the quest/m0/queue-watcher/README branch November 14, 2026 19:35
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