Skip to content

docs(design): compass distribution & install surface (RIG-2477, RIG-2608) - #578

Open
rigel-mintaka wants to merge 1 commit into
mainfrom
compass-native/rig-1746-distribution-design
Open

docs(design): compass distribution & install surface (RIG-2477, RIG-2608)#578
rigel-mintaka wants to merge 1 commit into
mainfrom
compass-native/rig-1746-distribution-design

Conversation

@rigel-mintaka

Copy link
Copy Markdown
Contributor

Design record for how Compass reaches users' machines: the client app's
full per-OS matrix (Linux x86_64 tarball + macOS arm64 signed/notarized
.app-in-dmg), install channels (homebrew tap, nix flake, raw release
assets), the headless self-host stack's host-level KVM bring-up, and
postgres provisioned as a zero-config container (BYO-DSN opt-out).

Scope expansion of RIG-1746 ruled by Matt (2026-08-24). Composes with the
#460 release-bundling record as its publishing rail; does not redesign the
Release mechanism, only extends its Fork 2(i) asset boundary.

Status: Draft. Four load-bearing Open Questions carried for Matt at the
design-PR gate (Apple Developer account, postgres image mechanism,
DL-183 pgid-format-v2 for container teardown, darwin CI cadence). Ledger
rows DL-241..244 land in this PR at freeze once the OQs are ruled.

Ledger-impact: proposes DL-241..244 (client per-OS matrix, install
channels, host-KVM stack, postgres-as-container); rows land at freeze
after the load-bearing OQs are ruled. No status flips (DL-217 already
Superseded by DL-238).

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

@linear-code

linear-code Bot commented Aug 24, 2026

Copy link
Copy Markdown

RIG-2477

RIG-2608

RIG-1746

@github-actions

github-actions Bot commented Aug 24, 2026

Copy link
Copy Markdown

Compass engineering docs preview: https://compass-native-rig-1746-dist.compass-eng-docs.pages.dev

Deployed from compass-native/rig-1746-distribution-design at ee0a535.

Changed pages:

…608)

Design record for how Compass reaches users' machines: the client app's
full per-OS matrix (Linux x86_64 tarball + macOS arm64 signed/notarized
.app-in-dmg), install channels (homebrew tap, nix flake, raw release
assets), the headless self-host stack's host-level KVM bring-up, and
postgres provisioned as a zero-config container (BYO-DSN opt-out).

Scope expansion of RIG-1746 ruled by Matt (2026-08-24). Composes with the
#460 release-bundling record as its publishing rail; does not redesign the
Release mechanism, only extends its Fork 2(i) asset boundary.

Status: Draft. Four load-bearing Open Questions carried for Matt at the
design-PR gate (Apple Developer account, postgres image mechanism,
DL-183 pgid-format-v2 for container teardown, darwin CI cadence). Ledger
rows DL-241..244 land in this PR at freeze once the OQs are ruled.

Ledger-impact: proposes DL-241..244 (client per-OS matrix, install
channels, host-KVM stack, postgres-as-container); rows land at freeze
after the load-bearing OQs are ruled. No status flips (DL-217 already
Superseded by DL-238).

Co-authored-by: Matt Wilkinson <matt@rigel.build>
@rigel-mintaka
rigel-mintaka force-pushed the compass-native/rig-1746-distribution-design branch from 3b6dba2 to ee0a535 Compare August 24, 2026 04:26
@rigel-mintaka
rigel-mintaka marked this pull request as ready for review August 24, 2026 14: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.

1 participant