Skip to content

docs: drop frozen-contract framing from records, comments and protos (RIG-2677) - #1359

Open
rigel-mintaka wants to merge 3 commits into
mainfrom
compass-server/rig-2677-frozen-framing-purge
Open

rigel-mintaka wants to merge 3 commits into
mainfrom
compass-server/rig-2677-frozen-framing-purge

Conversation

@rigel-mintaka

@rigel-mintaka rigel-mintaka commented Sep 26, 2026 •

Copy link
Copy Markdown
Contributor

Refs RIG-2677.

Pre-GA, nothing is frozen (see the AGENTS.md section "Pre-GA posture: nothing is frozen"). This sweep removes wording that cited frozenness, or a merged half's existence, as the reason for a design choice. Each passage now states the design on its own terms. No decision changes.

Scope

  • Design records under docs/designs/{agent,server,ui,infra,meta,platform,repo,observability} and docs/concepts.
  • Go, TS, and proto comments; test titles and failure messages. No code behaviour, identifier, or assertion changes.
  • Generated Go/TS (compass-proto:gen) and sqlc output regenerated from the edited .proto and query comments.

Kept on purpose

  • Record change-control: a merged record is amended by a new record.
  • Ledger and history entries. DECISIONS.md is not touched.
  • Non-framing senses of the word: fixtures, lockfile, stuck process, quotes.

Excluded

Follow-up

Decisions that rested only on a freeze are listed in RIG-4041 for their own design pass.

Checks

  • rumdl check: 115 files, clean.
  • go vet (default + pgtest), go build, golangci-lint ./...: 0 issues.
  • go test ./... passes.
  • compass-agent: bun test 726 pass.
  • apps/ui: bun test --conditions browser src/ gives 1134 pass / 4 fail, the same as main. The 4 are env-secrecy gate cases that need a .git dir.
  • compass-proto:drift, compass-go:sqlc-drift, TS typechecks, and the design-ledger gate all pass.

Notes for review

  • Every edited file keeps main's line count, so inbound path:line cites still resolve.
  • DL mirrors inside records keep the DECISIONS.md wording verbatim, including "frozen" where the ledger row says it.
  • Two merged records quote the old runner.proto header and RPC comments verbatim. The records are change-controlled, so those quotes now differ from the source on purpose.

…(RIG-2677)

Pre-GA nothing is frozen, so records and code comments no longer cite
frozenness, or a merged half's existence, as the reason for a design choice.
Each now states the design on its own terms. Decisions are unchanged.
Record change-control, ledger history, and non-framing senses of the word are
kept. Generated Go/TS and sqlc output are regenerated from the edited
.proto and query comments. Decisions that rested only on a freeze are listed
in RIG-4041 for their own design pass.

Refs RIG-2677

Co-authored-by: Matt Wilkinson <matt@rigel.build>
@trunk-io

trunk-io Bot commented Sep 26, 2026

Copy link
Copy Markdown

Merging to main in this repository is managed by Trunk.

  • To merge this pull request, check the box to the left or comment /trunk merge below.

After your PR is submitted to the merge queue, this comment will be automatically updated with its status. If the PR fails, failure details will also be posted here

@linear-code

linear-code Bot commented Sep 26, 2026

Copy link
Copy Markdown

RIG-2677

@github-actions

github-actions Bot commented Sep 26, 2026 •

Copy link
Copy Markdown

Compass engineering docs preview: https://compass-server-rig-2677-froz-gw2g.compass-eng-docs.pages.dev

Deployed from compass-server/rig-2677-frozen-framing-purge at 4969204.

Changed pages:

rigel-mintaka and others added 2 commits September 26, 2026 17:27
…e (RIG-2677)

Review found spots where removing 'frozen' also dropped a real rule. Those rules
are now stated on their own terms: arm numbers are not renumbered, Resize means
C3 needs no interface change, and HMAC amends the SHA-256 choice. DL mirrors
and change-control wording now match DECISIONS.md again. Every edited file keeps
main's line count, so inbound path:line cites still resolve. Missed framing in
proto/moon.yml, fabric, tests, and the brand vocabulary is also fixed.

Refs RIG-2677

Co-authored-by: Matt Wilkinson <matt@rigel.build>
Repair the notification-delivery header grammar, and rewrap the restored lines
to their file's column. Cite only OQ-1b for the no-renumber rule, since DL-186
renumbered densely.

Refs RIG-2677

Co-authored-by: Matt Wilkinson <matt@rigel.build>
@rigel-mintaka
rigel-mintaka marked this pull request as ready for review September 26, 2026 22:06
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