Skip to content

docs(ui): anchor the captureRequest citation by its thrown string (RIG-2874) - #1105

Merged
trunk-io[bot] merged 1 commit into
compass-ui/rig-2874-comment-trimfrom
compass-ui/rig-2874-record-citation
Sep 11, 2026
Merged

trunk-io[bot] merged 1 commit into
compass-ui/rig-2874-comment-trimfrom
compass-ui/rig-2874-record-citation

Conversation

@rigel-mintaka

@rigel-mintaka rigel-mintaka commented Sep 11, 2026

Copy link
Copy Markdown
Contributor

Review fix for #1097, landed additively on top.

The finding

#1097's added prose cited index.test.ts:87 for captureRequest's
always-throwing fetch. That number is wrong: in
packages/compass-client/src/index.test.ts the unconditional throw is at
:93

throw new Error("captureRequest: short-circuit before response");

and the rejects.toThrow() gate at :95. The semantic claim was correct —
verified at source — only the line number was off.

Why anchor on the string instead of fixing the number

The drift is not local to #1097. The record carries index.test.ts: line
citations at six sites, and the same :87/:89 numbering already appears in
the base record (the non-Latin-1 case), so #1097 propagated a pre-existing
stale number rather than introducing a new one. Bumping :87:93 would
be correct today and stale again on the next edit to that test file.

So this cites the thrown string, which is unique in the repo and cannot
drift:

`captureRequest`'s capturing `fetch` always `throw`s
(`"captureRequest: short-circuit before response"`)

The symbol name plus the quoted string is a recoverable anchor without a line
number.

Scope

Only the citation this stack introduced. The record's other five drifted line
citations are pre-existing and left alone — sweeping them is a separate
concern and belongs in its own change, not smuggled into a review fix.

Gates

  • bun tools/design-ledger-gate/index.tsOK, 311 ledger rows, 132 record
    headers valid
    (rc=0)
  • moon run root:markdownlintrc=0

Diff is one file, 4 insertions / 4 deletions.

RIG-2874

…G-2874)

The record cited index.test.ts:87 for the always-throwing fetch, but the throw
is at :93 and the rejects.toThrow() gate at :95. Line numbers in this record
have drifted repo-wide, so this anchors on the thrown string instead, which
cannot drift.
@linear-code

linear-code Bot commented Sep 11, 2026

Copy link
Copy Markdown

RIG-2874

@rigel-mintaka
rigel-mintaka added this pull request to stack #1098 September 11, 2026 18:51
@github-actions

Copy link
Copy Markdown

Compass engineering docs preview: https://compass-ui-rig-2874-record-c.compass-eng-docs.pages.dev

Deployed from compass-ui/rig-2874-record-citation at 6c51137.

Changed pages:

@trunk-io

trunk-io Bot commented Sep 11, 2026

Copy link
Copy Markdown

😎 Stack merged successfully - details.

@trunk-io
trunk-io Bot merged commit defb607 into main Sep 11, 2026
17 checks passed
@trunk-io
trunk-io Bot deleted the compass-ui/rig-2874-record-citation branch September 11, 2026 19:37
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