Skip to content

docs(server): forge self-origin notification suppression record (RIG-3326) - #913

Draft
rigel-mintaka wants to merge 1 commit into
compass-forge/rig-3299-self-delegate-designfrom
compass-forge/rig-3326-suppression-design
Draft

docs(server): forge self-origin notification suppression record (RIG-3326)#913
rigel-mintaka wants to merge 1 commit into
compass-forge/rig-3299-self-delegate-designfrom
compass-forge/rig-3326-suppression-design

Conversation

@rigel-mintaka

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

Copy link
Copy Markdown
Contributor

This PR is part of a stack containing 2 PRs:

  1. main
  2. docs(design): forge self-delegate write path record (Record A) (RIG-3299) #900
  3. "docs(server): forge self-origin notification suppression record (RIG-3326)" (this PR)

Design record for suppressing self-origin forge notifications at the
notify-router fan-out: an agent no longer wakes on its own COMMENT / REVIEW /
OPENED / STATE on a subscribed artifact, matched on owner-qualified Compass
handles, failing open on any ambiguity. CHECKS is never suppressed. A suppressed
notification advances delivered_revision only when the subscriber was already
caught up (CAS-guarded), so the reconcile sweep neither resurrects it nor masks
a prior undelivered real notification.

Sibling of the frozen Record A (forge self-delegate write path, PR #900);
depends on RIG-3331 (agent-driven state-transition write op) for the STATE arm
to suppress on the real transition actor rather than an author-row proxy.

Ledger-impact: adds DL-334 (self-origin notification suppression).

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

@linear-code

linear-code Bot commented Sep 6, 2026

Copy link
Copy Markdown

RIG-3326

@github-actions

github-actions Bot commented Sep 6, 2026

Copy link
Copy Markdown

Compass engineering docs preview: https://compass-forge-rig-3326-suppr.compass-eng-docs.pages.dev

Deployed from compass-forge/rig-3326-suppression-design at 7b868ee.

Changed pages:

@rigel-mintaka
rigel-mintaka force-pushed the compass-forge/rig-3326-suppression-design branch 5 times, most recently from 3097176 to 27728b7 Compare September 6, 2026 04:46
…3326)

Design record for suppressing self-origin forge notifications at the
notify-router fan-out: an agent no longer wakes on its own COMMENT / REVIEW /
OPENED / STATE on a subscribed artifact, matched on owner-qualified Compass
handles, failing open on any ambiguity. CHECKS is never suppressed. A suppressed
notification advances delivered_revision only when the subscriber was already
caught up (CAS-guarded, artifact-scope only), so the reconcile sweep neither
resurrects it nor masks a prior undelivered real notification.

The owner half of that identity is not on the wire today: AgentAttribution is
{agent_handle} only, so the parse discards the owner it already produces and the
COMMENT/REVIEW arm would be structurally inert. T0 restores owner_handle and
adds an internal ForgeEvent.Actor carrier for STATE (RIG-3331 populates it).

Sibling of Record A (forge self-delegate write path, PR #900); depends on
RIG-3331 (agent-driven state-transition write op) for the STATE arm to suppress
on the real transition actor rather than an author-row proxy.

Ledger-impact: adds DL-334 (self-origin notification suppression) and DL-335
(owner_handle carriage, amending the DL-094 clause DL-186 carried forward;
DL-186 stays Active).

Co-authored-by: Matt Wilkinson <matt@rigel.build>
@rigel-mintaka
rigel-mintaka force-pushed the compass-forge/rig-3326-suppression-design branch from 27728b7 to 7b868ee Compare September 6, 2026 05:13
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