Skip to content

Correct stale comments in the iframe proxy, browser hosts, relay and pairing tests, and docs parser - #1392

Merged
nedtwigg merged 2 commits into
mainfrom
nightly/stale-comments-oct27
Oct 27, 2026
Merged

nedtwigg merged 2 commits into
mainfrom
nightly/stale-comments-oct27

Conversation

@dormouse-bot

Copy link
Copy Markdown
Collaborator

Comment and test-name corrections from tonight's rolling survey. Behavior is unchanged: apart from one local variable renamed in a test helper, every edit is a comment or a test title.

  • lib/src/host/iframe-proxy.ts: the header and handleUpgrade compared the proxy to the "agent-browser stream relay". 1faca60 removed that relay, and its replacement, the viewer socket, is not a byte pipe. Those comparisons are gone, along with "notes vs the spec's sketch". Two pointers to spec → Target policy and spec → Security, headings dor-browser.md no longer has, now name the sections that hold the rules: "Iframe Renderer" (the https and link-local refusals) and "Iframe Host Capability And CSP" (the user's own target is trusted).
  • lib/src/host/browser-host.ts: own() is defined in lib/src/components/remote-control-shared.ts, not RemoteControlSection.tsx.
  • lib/src/host/agent-browser-host.ts: a capture-timeout comment sat above the stream-port retry constants. The doc comment on CAPTURE_TIMEOUT_MS in browser-capture.ts already covers the capture timeout, so this one is dropped.
  • Host→Burrow rename damage (77101e3), where "host" meant a network host name: pairing-invitation.test.mjs ("By burrow, never by suffix", and the burrow length variable in originOfLength), and the connect-src test title and comment in relay/test/static.test.mjs.
  • relay/test/static.test.mjs: the script-src comment pointed at a "built-output case below" that doesn't exist. lib/scripts/assert-pocket-worker.mjs makes that check at build time, as the file's closing comment already says.
  • scripts/github-state-check.test.mjs: "the two PRs' formats" now names the two formats, this script's fragment and security-audit-report.mjs's parser.
  • website/scripts/docs-parser.js: the "Slugger" banner moves from above the URL-scheme helpers to above slugify.
  • dor-tools-builtin/viewer/image/pixels.ts: dominantBorderColor said "ties go to the first in row order", but it updates the leader only on a strictly higher count, during the scan. For a ring of A, B, B, A, B wins. The comment now describes that. Changing the tie-break itself would change what eraseSelection fills, so it is not done here.

No regression test: there is no behavior change to pin. Locally, remote-lib-common (355) and relay (300) pass, as do docs-parser.test.js (47) and scripts/github-state-check.test.mjs.

…pairing tests, and docs parser

- iframe-proxy.ts: drop comparisons to the removed stream relay and point
  two spec references at the dor-browser.md headings that hold the rules.
- browser-host.ts: own() lives in remote-control-shared.ts.
- agent-browser-host.ts: drop a capture-timeout comment stranded above
  the stream-port constants.
- Undo Host->Burrow rename damage where "host" meant a network host.
- static.test.mjs: the built-shell script check is assert-pocket-worker.mjs.
- github-state-check.test.mjs: name the formats, not the PRs.
- docs-parser.js: move the Slugger banner onto slugify.
- pixels.ts: describe the tie-break dominantBorderColor actually makes.
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Oct 27, 2026 •

Copy link
Copy Markdown

Deploying mouseterm with  Cloudflare Pages  Cloudflare Pages

Latest commit: 622fda5
Status: ✅  Deploy successful!
Preview URL: https://dc5a0193.mouseterm.pages.dev
Branch Preview URL: https://nightly-stale-comments-oct27.mouseterm.pages.dev

View logs

@dormouse-bot

Copy link
Copy Markdown
Collaborator Author

The red Build & Test is not from this diff. The job ran on the new ubuntu-26.04 runner image, where systemd's bash OSC-context hook makes bash: E is the whole submitted line… report __systemd_osc_context_precmdline. #1391 fixes that in the bash integration and is green on the same image. Re-running this PR's CI after #1391 merges should clear it.

@dormouse-bot dormouse-bot left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

Build & Test is red on this head, but not because of this PR. It fails standalone/sidecar bash: E is the whole submitted line, and never a stale history entry with bash reported ["__systemd_osc_context_precmdline"] for "true" (job). This PR touches no shell-integration code. That's the ubuntu-26.04 runner's systemd PROMPT_COMMAND array that #1391 fixes. Once #1391 lands, a re-run should go green.

@nedtwigg
nedtwigg merged commit bcc1746 into main Oct 27, 2026
12 of 13 checks passed
@nedtwigg
nedtwigg deleted the nightly/stale-comments-oct27 branch October 27, 2026 18:16
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.

2 participants