Skip to content

docs(quest): plan follow-ups from the 2026-10-21 merge wave - #179

Merged
kixelated merged 3 commits into
mainfrom
quest/plan-merge-followups-1021
Oct 21, 2026
Merged

kixelated merged 3 commits into
mainfrom
quest/plan-merge-followups-1021

Conversation

@kixelated

Copy link
Copy Markdown
Owner

Plans the follow-ups that merge agents reported while landing 20 PRs on 2026-10-21. Each was checked against the quest tree on main, and items an existing quest already covers were folded in there.

Changes

Dropped (each is recorded in its PR thread):

  • #161: required-workflow path matching, app-only required checks, and optional checks delaying checks:passed.
  • #170: the 3-round read cap.
  • #172: the decisions placeholder and footer order.
  • #165: the gap after a JavaScript-off sign-out, per-subscription VAPID keys, the testEnv cleanup, and the title-from-read test.
  • #164: refusing dirty documents in quest rm.
  • A merge-skill note about clean PRs: --auto already merges them at once.

Already covered:

  • The gate items from #128 are in local-gate.md, which is in flight.
  • The stub upgrade path from #156 is in headless-agents.md, also in flight.
  • The seed-based end-to-end test from #168 is in the kix epic.
  • quest unblocked colours are part of the theme epic's size colours.

Out of scope: switching CI in moq-dev/moq and moq.pro to ready PRs only needs /quest-plan in those repositories.

Done directly at the user's request, outside this PR:

  • Turned on "Automatically delete head branches" for kixelated/quest.
  • Deleted the 115 remote branches whose tip was a merged PR's head. These had made quest/m0/worktree.md and quest/m0/local-gate.md look claimed.

Decision paper trail

Round 1: scope

Goal: turn the merge wave's follow-ups into quests, keeping real defects and gaps and dropping minor ones whose PR threads keep the record.

  • ✅ Confirm
  • Bugs only
  • Keep everything

Triage:

  • ✅ As shown
  • Merge the helpers quests
  • Merge the kix quests

Kix ranks:

  • ✅ Before runner
  • After deploy only
  • Append at end

Round 2: details (user: "whatever you recommend")

Activity retention:

  • ✅ Page and prune closed entities after a period set from measured row counts
  • Page only and keep everything
  • Drop on close

Blocked fork branch:

  • ✅ A "Start over" option
  • Instructions only

Leftover branches that stop counting as claims:

  • ✅ Merged PR heads
  • Merged or closed

Stale claims (asked during the spawn):

  • ✅ Delete all merged-head branches and turn on auto-delete
  • Delete just the two
  • Leave them

just check and just test pass.

(Written by Claude Opus 5.5)

🤖 Generated with Claude Code

Six new quests (kix epic branches, inbox accuracy, job recovery; upstream
claims, wait gaps, guard in CI) and real-device and live-read checks in
operator setup.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 21, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-21T21:52:30.214013Z 6083b12 New commits
🔒 Security Review ✅ Completed 2026-10-21T21:52:16.964748Z 6083b12 New commits
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector 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.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 6083b12853

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +17 to +18
`cloudflare/src/github/state.ts` maps branches back to quests, and
`questHref` in `cloudflare/src/board/model.ts` builds board links. Git

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Preserve the existing epic page URL

The directory form is intentional for questHref: the board route resolves /board/quest/m0/foo to quest/m0/foo/README.md, while /board/quest/m0/foo/README resolves to neither an existing .md file nor an epic README. Applying the new branch rule to this function would therefore turn epic links into 404s; restrict the /README mapping to branch creation and branch-to-quest association.

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

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

Declining: /README page URLs do not 404. The board route (cloudflare/src/index.tsx:315) resolves pages through findDoc in cloudflare/src/board/model.ts, which tries ${page}.md first, so quest/m0/foo/README resolves to quest/m0/foo/README.md; its doc comment lists quest/m0/epic/README as a supported form. questHref is in scope because its comment defines a page as "its path without .md, like its branch name", so it should follow the same rule as the branch.

(Written by Claude Opus 5.5)

Comment thread quest/m0/kix/inbox-accuracy.md Outdated
Comment on lines +20 to +22
- **Unknown merge state.** GitHub reports `mergeStateStatus` `UNKNOWN` while it
computes mergeability. Treat it as not yet known: keep the item's previous
state and do not mark it unread until a definite state arrives.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Keep newly discovered UNKNOWN pull requests unread

When a pull request's first observation has mergeStateStatus: UNKNOWN, there is no previous item state to retain, and the newly opened PR itself is still something the maintainer must act on. Suppressing unread state until mergeability becomes definite can hide the PR indefinitely because GitHub need not send another event when that background computation finishes; limit this rule to transient UNKNOWN updates of an already-recorded PR while still surfacing new PRs.

Useful? React with 👍 / 👎.

@kixelated kixelated Oct 21, 2026 •

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

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

Agreed, fixed in f11e84b: the UNKNOWN rule now applies only to an already-recorded PR, and a newly seen PR still surfaces as unread, since GitHub may send no further event when mergeability is computed.

(Written by Claude Opus 5.5)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@kixelated

Copy link
Copy Markdown
Owner Author

Merge summary:

  • Merged main after kixelated/quest#175 landed; the helpers Required list auto-merged in rank order, with this PR's three entries after Headless agents. No overlap with docs(quest): plan /quest-afk and the rules agents kept needing #175's new quests. local-gate.md, cited above as in flight, has since landed.
  • Codex review of 6083b12 raised two findings:
    • UNKNOWN merge state on a newly seen PR: fixed in f11e84b (inbox-accuracy.md now limits the rule to already-recorded PRs).
    • questHref and /README page URLs: declined with a reply, since the board route resolves quest/<path>/README through findDoc.
  • The change since the review is that one wording fix, which I treat as trivial. CI passed on f11e84b; just check, just test, and the base-built quest check --base origin/main pass.

(Written by Claude Opus 5.5)

@kixelated
kixelated merged commit e39c918 into main Oct 21, 2026
5 checks passed
@kixelated
kixelated deleted the quest/plan-merge-followups-1021 branch October 21, 2026 22:02
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