Skip to content

docs(server): drop redundant public-URL rationale comment (RIG-2717) - #692

Merged
mattwilkinsonn merged 2 commits into
mainfrom
compass-server/rig-2717-comment-cleanup
Aug 27, 2026
Merged

docs(server): drop redundant public-URL rationale comment (RIG-2717)#692
mattwilkinsonn merged 2 commits into
mainfrom
compass-server/rig-2717-comment-cleanup

Conversation

@rigel-mintaka

@rigel-mintaka rigel-mintaka commented Aug 27, 2026

Copy link
Copy Markdown
Contributor

This PR is part of a stack containing 2 PRs:

  1. main
  2. test(forge): fix matrixChecksRoller to current ChecksRoller signature (RIG-2848) #691
  3. "docs(server): drop redundant public-URL rationale comment (RIG-2717)" (this PR)

Remove the floating comment above errUsage that editorialized the no-default public-URL decision with deployment/business framing ("the managed-service host is a deployment concern that never lives in this repo"). It attaches to no declaration and every behavioral fact it stated is already documented at its proper home: the --public-url flag help (no default, must be set), requirePublicURL / errNoPublicURL (empty rejected at boot for a Linear-webhook deploy), and deepLinkFor (empty base yields a relative fragment). The rationale prose reads as out-of-place editorializing in the OSS product's source. Follow-up to #639 (merged at its pre-fix head).

Spec-impact: none. Refs RIG-2717

Co-authored-by: Matt Wilkinson matt@rigel.build

rigel-mintaka and others added 2 commits August 27, 2026 18:19
… (RIG-2848)

The RIG-2848 notification-matrix test double still returned the removed ingest.ChecksResult placeholder, which RIG-2732 (#677) collapsed into the real forge.ConditionalResult[forge.Checks] when it landed the conditional-read seam. The two PRs merged in an order that left main red — compass-go:vet/test fail-closed on `undefined: ingest.ChecksResult` in server/forge_notify_matrix_test.go, blocking every compass PR at the pre-push gate.

Update matrixChecksRoller's field and RollUp return to forge.ConditionalResult[forge.Checks] (the forge import already present), matching the ChecksRoller interface. Mechanical adapter fix; the signature dictates the exact change.

Spec-impact: none. Refs RIG-2848

Co-authored-by: Matt Wilkinson <matt@rigel.build>
Remove the floating comment above errUsage that editorialized the no-default public-URL decision with deployment/business framing ("the managed-service host is a deployment concern that never lives in this repo"). It attaches to no declaration and every behavioral fact it stated is already documented at its proper home: the --public-url flag help (no default, must be set), requirePublicURL / errNoPublicURL (empty rejected at boot for a Linear-webhook deploy), and deepLinkFor (empty base yields a relative fragment). The rationale prose reads as out-of-place editorializing in the OSS product's source. Follow-up to #639 (merged at its pre-fix head).

Spec-impact: none. Refs RIG-2717

Co-authored-by: Matt Wilkinson <matt@rigel.build>
@linear-code

linear-code Bot commented Aug 27, 2026

Copy link
Copy Markdown

RIG-2717

@github-actions

Copy link
Copy Markdown

Compass engineering docs preview: https://compass-server-rig-2717-comm-2hcj.compass-eng-docs.pages.dev

Deployed from compass-server/rig-2717-comment-cleanup at 6209924.

Base automatically changed from compass-server/rig-2848-checksroller-fix to main August 27, 2026 23:27
@mattwilkinsonn
mattwilkinsonn merged commit 6799bc0 into main Aug 27, 2026
25 checks passed
@mattwilkinsonn
mattwilkinsonn deleted the compass-server/rig-2717-comment-cleanup branch August 27, 2026 23:27
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