feat(website): Queen HUD says why free bees are idle, round popover no longer crashes

[gHashTag]

Description

The owner looked at https://t27.ai/#/queen, saw "BEES 0/4" and asked why the bees were broken. They were not broken. The swarm was healthy and idle, and the scheduler had nothing to choose: 449 of 488 candidate issues had no ## Boundary section. The HUD already fetched that reason from /queen/status and did not show it.

• The HUD says why free bees are idle. New pure readers in components/queenHud.ts (skipCounts, idleReason, idleLine) work from /queen/status alone and use the server clock.
  • A fresh round that refused with free slots: one line with the refusal and the largest skip reasons with their counts. Example: "4 idle: nothing to choose — checked: 488 · no ## Boundary: 449 · done but open: 27 · claimed: 12". Counts follow their labels, so no number has to agree with a word in Russian or English.
  • "nothing to choose" with missingBoundary > 0: a link to an issue written the way bees can take it.
  • Other refusals: the refusal text, verbatim.
  • A stale round: the line says the round is stale instead of explaining idleness.
  • No line at all when the round dispatched, there is no free slot, the tick is unreadable, the summary is malformed or does not add up, or the status is a copy kept after a failed fetch.
• The BEES tile reads active and capacity from /queen/status workers, and its sub-line carries the short reason.
• "N ready" becomes "N finished, no verdict" ("N без вердикта"), which is what dispatches.unreviewed counts.
• Bug fixed along the way. Opening the round popover with the real wire skipSummary crashed the whole page with React error ci: bump docker/build-push-action from 5 to 7 #31. Each entry is {count, issues, more}, and it was rendered as a child. The popover now lists counts.
• Layout.
  • Desktop: the line sits under the viewport head.
  • Phones up to 900 px: it is its own grid row, and the body gives up that height.
  • Landscape phones up to 500 px tall: it is hidden.
  • Embed and bare views: it is hidden.
  • It takes no tap from Queen controls.

Refs #1010

Related Issue

#1010. This is the follow-up to the Queen bees investigation (gHashTag/t27#3624 and the scheduler rules in gHashTag/BrowserOS trios/agent-server).

Changes Made

• apps/website/src/components/queenHud.ts: skipCounts, idleReason, idleLine.
• apps/website/src/pages/Queen.tsx: the BEES tile sub-line, the idle line, the popover counts, the COPY keys in en and ru.
• apps/website/src/pages/Queen.css: idle line placement on desktop, portrait phone, landscape phone and collapsed rail.
• apps/website/qa/queen-idle-reason-contract.mjs (71 checks, npm run check:queen-idle, in website-checks) with four real /queen/status snapshots in qa/fixtures/queen-status/; qa/queen-idle-layout-contract.mjs (26 checks, headless Chrome); qa/queen-honesty-contract.mjs updated for the new wording.

🔥 TOXIC VERDICT

What Works

• Idle-reason contract. It fails before the change: the module has no idleLine export. After the change it passes 71 checks on four real snapshots, plus malformed, mismatched, stale and gated cases, with counts of 1, 21 and 3 in en and ru.
• Layout contract. It passes 26 checks against the rebased build. The line does not overlap the head, it takes no taps from controls at 1440x900 or 390x844, and it is hidden on a landscape phone.
• Before render: clicking the round tile with the real snapshot crashed the page (React ci: bump docker/build-push-action from 5 to 7 #31). After: the popover lists 12 claimed, 27 completed and 449 missing boundary, and there are no exceptions.
• Adversarial review. An honesty lens and a layout lens found 10 issues, all real and all fixed:
  • skip lines counted as issues;
  • a reason drawn from stale data;
  • the phone row covering controls;
  • the landscape overlap;
  • wrong Russian plurals.

What Doesn't Work / Limits

• On landscape phones up to 500 px tall the sentence is hidden, because no place under the spilling tools row was free.
• The example link points to t27#3587, because /queen/status does not expose the configured repository.
• queen-honesty-contract has one check that fails identically on the base, and queen-round-contract has one timing check that also fails on the base build. Neither is touched here.
• The layout contract is not wired into CI, like the other Queen browser contracts.

Overall Assessment: APPROVE. Self-Score: 8/10.

🌳 TECH TREE Options

1. Expose the configured repository in /queen/status so the example link comes from the wire. ★★★☆☆
2. Filter the board by repository (158 trios cards shown under t27) in trios/agent-server. ★★★★☆
3. Wire the Queen browser contracts into CI with a stubbed status. ★★★☆☆

{
  "version": 1,
  "head_sha": "f741b2f943e53f87756f58da0eec752e65a8f03a",
  "summary": "The Queen HUD now explains why free bees are idle from /queen/status, relabels the unreviewed count as finished without a verdict, and no longer crashes when the round popover opens with the real skip summary.",
  "changes": [
    "apps/website/src/components/queenHud.ts: skipCounts, idleReason and idleLine read the refusal, skip counts and staleness from /queen/status with the server clock.",
    "apps/website/src/pages/Queen.tsx: the BEES tile sub-line and an idle line with the reason and an example link, the round popover lists counts instead of rendering objects, and new en and ru copy.",
    "apps/website/src/pages/Queen.css: idle line placement for desktop, portrait phones, landscape phones and the collapsed rail without covering controls.",
    "apps/website/qa/queen-idle-reason-contract.mjs, qa/queen-idle-layout-contract.mjs, qa/fixtures/queen-status and qa/queen-honesty-contract.mjs: contracts over real status snapshots and layout."
  ],
  "tests": [
    {
      "command": "node --experimental-strip-types qa/queen-idle-reason-contract.mjs before the implementation",
      "status": "failed",
      "result": "Control, expected to fail: queenHud.ts provides no idleLine export.",
      "evidence": "Session scratchpad idle-shots/contract-before.log"
    },
    {
      "command": "npm run check:queen-idle; node qa/queen-idle-layout-contract.mjs --dist dist",
      "status": "passed",
      "result": "71 idle-reason checks over four real status snapshots and edge cases, and 26 layout checks at desktop, phone and landscape sizes, pass on the build rebased onto main.",
      "evidence": "Local runs in the feat/queen-idle-explained worktree after the rebase"
    },
    {
      "command": "Headless Chrome render of the base and the branch build with the real healthy-idle status stubbed, clicking the round tile",
      "status": "passed",
      "result": "The base build crashes with React error 31 when the round popover opens; the branch build lists the skip counts with no exceptions and shows the idle line unclipped in en and ru.",
      "evidence": "Session scratchpad idle-shots before and after screenshots"
    },
    {
      "command": "npm run typecheck:ratchet; eslint on changed files; check:tri; check:tri-identity; check:queen-languages; check:explorer-languages; npx vite build",
      "status": "passed",
      "result": "Type errors stay at the baseline and every contract and the production build pass.",
      "evidence": "Local runs in the feat/queen-idle-explained worktree after the rebase"
    }
  ],
  "limitations": [
    "On landscape phones 500 px tall or less the idle sentence is hidden.",
    "The example link is a fixed format example, because /queen/status does not expose the configured repository.",
    "The layout contract is not wired into continuous integration."
  ],
  "tags": ["Website", "Queen", "Honesty"],
  "blog": {
    "title": "Zero bees is not broken bees",
    "summary": "A HUD that showed 0 of 4 bees made the swarm look broken, and now it says why the bees are idle, using the scheduler's own counts.",
    "outline": [
      "The question: the owner saw 0 of 4 bees on the Queen and asked why they were broken.",
      "The answer on the wire: a healthy idle swarm whose scheduler found nothing to choose, because 449 of 488 issues lacked a Boundary section.",
      "The change: the HUD reads the refusal and skip counts and prints them, with an example of an issue bees can take.",
      "The honesty rules: no reason from stale data, counts that must add up, and labels that never need grammatical agreement.",
      "The bug found on the way: the round popover crashed the page on the real skip summary."
    ]
  }
}

🤖 Generated with Claude Code

[gHashTag]

Verified live on https://t27.ai after the publisher run ("Publish assets/index-BzlYtmgd.js from trinity fe4d5ed"; merge tree equals the reviewed branch tree, 672405a2).

Round popover. The probe is headless Chrome with a trusted CDP click on the round tile. The button is display: contents, so the probe clicks its visible child after a hit test.

build	click	result
before, index-xFghQn6i.js	round tile	the whole page blank, Minified React error #31 … object with keys {count, issues, more}
after, index-BzlYtmgd.js, status loaded	round tile	aria-expanded="true", popover open with the live counts 89 claimed, 70 completed, 238 missing boundary, 9 file conflict, 41 incomplete spec, 32 not first, page alive, 0 exceptions
after, clicked before status loaded	round tile	page alive, 0 exceptions (popover empty-state timing only)

HUD on the live swarm. The swarm is working, 10 of 10 busy:

• the BEES tile reads "BEES 10/10 · 0 idle";
• VERDICTS reads "… 4 finished, no verdict";
• no idle line is shown, which is correct, because the last round dispatched.

Probes on the same bundle, trusted input: TRI tab 21 of 21, Queen tabs 61 of 61.

CI note. The red checks job is the pre-existing "Explorer viewport contract" at 390x844 specs, which fails identically on main since eab253b. The new "Queen idle reason" step passed.

Not verified live: the idle line itself, because the swarm is not idle right now. It is covered by the contract on four real status snapshots and by the layout contract.