Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
176 changes: 0 additions & 176 deletions docs/control-plane/governed-ops-design.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@

Every caller writes through GitCrud, which commits under the commit policy for Argo CD to reconcile.

```mermaid

Check warning on line 10 in docs/control-plane/governed-ops-design.md

View workflow job for this annotation

GitHub Actions / ci / Quality

hyperi-ci diagram-check: R9

frontmatter configuration
---
config:
theme: base
Expand Down Expand Up @@ -117,50 +117,6 @@
A Tier 1 var write is checked for the grant and the protected-var policy, then committed, against its `If-Match` base when the caller sends one.

```mermaid
---
config:
theme: base
fontFamily: Inter, -apple-system, Segoe UI, Roboto, Helvetica, Arial, sans-serif
themeVariables:
fontSize: 15px
lineColor: "#64748B"
primaryTextColor: "#0F172A"
clusterBorder: "#0072B2"
edgeLabelBackground: "#FFFFFF"
primaryColor: "#FFFFFF"
primaryBorderColor: "#334155"
secondaryColor: "#F8FAFC"
tertiaryColor: "#FFFFFF"
textColor: "#0F172A"
actorBkg: "#FFFFFF"
actorBorder: "#334155"
actorTextColor: "#0F172A"
actorLineColor: "#94A3B8"
signalColor: "#64748B"
signalTextColor: "#0F172A"
sequenceNumberColor: "#FFFFFF"
labelBoxBkgColor: "#FFFFFF"
labelBoxBorderColor: "#64748B"
labelTextColor: "#0F172A"
loopTextColor: "#0F172A"
noteBkgColor: "#FFFFFF"
noteBorderColor: "#94A3B8"
noteTextColor: "#0F172A"
transitionColor: "#64748B"
transitionLabelColor: "#0F172A"
stateLabelColor: "#0F172A"
stateBkg: "#FFFFFF"
labelBackgroundColor: "#FFFFFF"
compositeBackground: "#FFFFFF"
attributeBackgroundColorOdd: "#FFFFFF"
attributeBackgroundColorEven: "#F8FAFC"
themeCSS: >-
p{margin:0}
.node rect,.node polygon,.outer-path{filter:drop-shadow(0 1px 2px rgba(15,23,42,.10)) drop-shadow(0 6px 14px rgba(15,23,42,.10))!important}
.messageText,.loopText,.loopText tspan,.labelText,.labelText tspan{stroke:#FFFFFF!important;stroke-width:3px!important;paint-order:stroke;stroke-linejoin:round}
.edgeLabel,.edgeLabel p,.labelBkg{background:#FFFFFF!important}
.edgeLabel span{background:#FFFFFF!important;color:#1E293B}
---
sequenceDiagram
accTitle: L4 Detail -- Writing a helm var
accDescr: The Helm vars router checks the caller's grant, validates the write and the protected-var policy, then GitCrud sets the key against the If-Match base and GitopsRepo commits. Argo CD reconciles the commit.
Expand Down Expand Up @@ -193,50 +149,6 @@
An action invoke checks the caller's grant and every change, then writes them all in one commit.

```mermaid
---
config:
theme: base
fontFamily: Inter, -apple-system, Segoe UI, Roboto, Helvetica, Arial, sans-serif
themeVariables:
fontSize: 15px
lineColor: "#64748B"
primaryTextColor: "#0F172A"
clusterBorder: "#0072B2"
edgeLabelBackground: "#FFFFFF"
primaryColor: "#FFFFFF"
primaryBorderColor: "#334155"
secondaryColor: "#F8FAFC"
tertiaryColor: "#FFFFFF"
textColor: "#0F172A"
actorBkg: "#FFFFFF"
actorBorder: "#334155"
actorTextColor: "#0F172A"
actorLineColor: "#94A3B8"
signalColor: "#64748B"
signalTextColor: "#0F172A"
sequenceNumberColor: "#FFFFFF"
labelBoxBkgColor: "#FFFFFF"
labelBoxBorderColor: "#64748B"
labelTextColor: "#0F172A"
loopTextColor: "#0F172A"
noteBkgColor: "#FFFFFF"
noteBorderColor: "#94A3B8"
noteTextColor: "#0F172A"
transitionColor: "#64748B"
transitionLabelColor: "#0F172A"
stateLabelColor: "#0F172A"
stateBkg: "#FFFFFF"
labelBackgroundColor: "#FFFFFF"
compositeBackground: "#FFFFFF"
attributeBackgroundColorOdd: "#FFFFFF"
attributeBackgroundColorEven: "#F8FAFC"
themeCSS: >-
p{margin:0}
.node rect,.node polygon,.outer-path{filter:drop-shadow(0 1px 2px rgba(15,23,42,.10)) drop-shadow(0 6px 14px rgba(15,23,42,.10))!important}
.messageText,.loopText,.loopText tspan,.labelText,.labelText tspan{stroke:#FFFFFF!important;stroke-width:3px!important;paint-order:stroke;stroke-linejoin:round}
.edgeLabel,.edgeLabel p,.labelBkg{background:#FFFFFF!important}
.edgeLabel span{background:#FFFFFF!important;color:#1E293B}
---
sequenceDiagram
accTitle: L4 Detail -- Invoking an action
accDescr: The governance router loads the action and checks the caller holds that action's required_action. ActionStore checks every change against the protected-var policy and writes them all in one commit through GitCrud.
Expand Down Expand Up @@ -277,7 +189,7 @@

Each RBAC group binds to one ClickHouse user holding a tier role, the tenant role and, for an org, a pinned tenant setting.

```mermaid

Check warning on line 192 in docs/control-plane/governed-ops-design.md

View workflow job for this annotation

GitHub Actions / ci / Quality

hyperi-ci diagram-check: R9

frontmatter configuration
---
config:
theme: base
Expand Down Expand Up @@ -464,50 +376,6 @@
A fire goes from due to running to done, and an expired lease sends it back to due.

```mermaid
---
config:
theme: base
fontFamily: Inter, -apple-system, Segoe UI, Roboto, Helvetica, Arial, sans-serif
themeVariables:
fontSize: 15px
lineColor: "#64748B"
primaryTextColor: "#0F172A"
clusterBorder: "#0072B2"
edgeLabelBackground: "#FFFFFF"
primaryColor: "#FFFFFF"
primaryBorderColor: "#334155"
secondaryColor: "#F8FAFC"
tertiaryColor: "#FFFFFF"
textColor: "#0F172A"
actorBkg: "#FFFFFF"
actorBorder: "#334155"
actorTextColor: "#0F172A"
actorLineColor: "#94A3B8"
signalColor: "#64748B"
signalTextColor: "#0F172A"
sequenceNumberColor: "#FFFFFF"
labelBoxBkgColor: "#FFFFFF"
labelBoxBorderColor: "#64748B"
labelTextColor: "#0F172A"
loopTextColor: "#0F172A"
noteBkgColor: "#FFFFFF"
noteBorderColor: "#94A3B8"
noteTextColor: "#0F172A"
transitionColor: "#64748B"
transitionLabelColor: "#0F172A"
stateLabelColor: "#0F172A"
stateBkg: "#FFFFFF"
labelBackgroundColor: "#FFFFFF"
compositeBackground: "#FFFFFF"
attributeBackgroundColorOdd: "#FFFFFF"
attributeBackgroundColorEven: "#F8FAFC"
themeCSS: >-
p{margin:0}
.node rect,.node polygon,.outer-path{filter:drop-shadow(0 1px 2px rgba(15,23,42,.10)) drop-shadow(0 6px 14px rgba(15,23,42,.10))!important}
.messageText,.loopText,.loopText tspan,.labelText,.labelText tspan{stroke:#FFFFFF!important;stroke-width:3px!important;paint-order:stroke;stroke-linejoin:round}
.edgeLabel,.edgeLabel p,.labelBkg{background:#FFFFFF!important}
.edgeLabel span{background:#FFFFFF!important;color:#1E293B}
---
stateDiagram-v2
direction LR
accTitle: L4 Detail -- Hunt fire lifecycle
Expand All @@ -528,50 +396,6 @@
Three ReplacingMergeTree tables in the effective data database, keyed by `hunt_id`, coordinate the runners. `hunt_run` (one row per fire) and `hunt_runner_heartbeat` (one row per runner) sit beside them.

```mermaid
---
config:
theme: base
fontFamily: Inter, -apple-system, Segoe UI, Roboto, Helvetica, Arial, sans-serif
themeVariables:
fontSize: 15px
lineColor: "#64748B"
primaryTextColor: "#0F172A"
clusterBorder: "#0072B2"
edgeLabelBackground: "#FFFFFF"
primaryColor: "#FFFFFF"
primaryBorderColor: "#334155"
secondaryColor: "#F8FAFC"
tertiaryColor: "#FFFFFF"
textColor: "#0F172A"
actorBkg: "#FFFFFF"
actorBorder: "#334155"
actorTextColor: "#0F172A"
actorLineColor: "#94A3B8"
signalColor: "#64748B"
signalTextColor: "#0F172A"
sequenceNumberColor: "#FFFFFF"
labelBoxBkgColor: "#FFFFFF"
labelBoxBorderColor: "#64748B"
labelTextColor: "#0F172A"
loopTextColor: "#0F172A"
noteBkgColor: "#FFFFFF"
noteBorderColor: "#94A3B8"
noteTextColor: "#0F172A"
transitionColor: "#64748B"
transitionLabelColor: "#0F172A"
stateLabelColor: "#0F172A"
stateBkg: "#FFFFFF"
labelBackgroundColor: "#FFFFFF"
compositeBackground: "#FFFFFF"
attributeBackgroundColorOdd: "#FFFFFF"
attributeBackgroundColorEven: "#F8FAFC"
themeCSS: >-
p{margin:0}
.node rect,.node polygon,.outer-path{filter:drop-shadow(0 1px 2px rgba(15,23,42,.10)) drop-shadow(0 6px 14px rgba(15,23,42,.10))!important}
.messageText,.loopText,.loopText tspan,.labelText,.labelText tspan{stroke:#FFFFFF!important;stroke-width:3px!important;paint-order:stroke;stroke-linejoin:round}
.edgeLabel,.edgeLabel p,.labelBkg{background:#FFFFFF!important}
.edgeLabel span{background:#FFFFFF!important;color:#1E293B}
---
erDiagram
accTitle: L4 Detail -- Hunt coordination tables
accDescr: hunt_lease holds the owner and lease expiry of each hunt's current fire, hunt_watermark how far each hunt has run, and hunt_state its overrun count and too_aggressive flag. All three are keyed by hunt_id.
Expand Down
44 changes: 0 additions & 44 deletions docs/control-plane/idp-setup/entra.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,50 +17,6 @@ Once you turn on the groups claim, Entra puts each user's group object ids in th
DFE signs in with Entra ID by code exchange, and reads the groups of a user in more than 200 from Microsoft Graph.

```mermaid
---
config:
theme: base
fontFamily: Inter, -apple-system, Segoe UI, Roboto, Helvetica, Arial, sans-serif
themeVariables:
fontSize: 15px
lineColor: "#64748B"
primaryTextColor: "#0F172A"
clusterBorder: "#0072B2"
edgeLabelBackground: "#FFFFFF"
primaryColor: "#FFFFFF"
primaryBorderColor: "#334155"
secondaryColor: "#F8FAFC"
tertiaryColor: "#FFFFFF"
textColor: "#0F172A"
actorBkg: "#FFFFFF"
actorBorder: "#334155"
actorTextColor: "#0F172A"
actorLineColor: "#94A3B8"
signalColor: "#64748B"
signalTextColor: "#0F172A"
sequenceNumberColor: "#FFFFFF"
labelBoxBkgColor: "#FFFFFF"
labelBoxBorderColor: "#64748B"
labelTextColor: "#0F172A"
loopTextColor: "#0F172A"
noteBkgColor: "#FFFFFF"
noteBorderColor: "#94A3B8"
noteTextColor: "#0F172A"
transitionColor: "#64748B"
transitionLabelColor: "#0F172A"
stateLabelColor: "#0F172A"
stateBkg: "#FFFFFF"
labelBackgroundColor: "#FFFFFF"
compositeBackground: "#FFFFFF"
attributeBackgroundColorOdd: "#FFFFFF"
attributeBackgroundColorEven: "#F8FAFC"
themeCSS: >-
p{margin:0}
.node rect,.node polygon,.outer-path{filter:drop-shadow(0 1px 2px rgba(15,23,42,.10)) drop-shadow(0 6px 14px rgba(15,23,42,.10))!important}
.messageText,.loopText,.loopText tspan,.labelText,.labelText tspan{stroke:#FFFFFF!important;stroke-width:3px!important;paint-order:stroke;stroke-linejoin:round}
.edgeLabel,.edgeLabel p,.labelBkg{background:#FFFFFF!important}
.edgeLabel span{background:#FFFFFF!important;color:#1E293B}
---
sequenceDiagram
accTitle: L4 Detail -- Entra sign-in
accDescr: The browser opens DFE sign-in and DFE redirects to Entra ID. Entra returns a code, which DFE exchanges for an ID token with the groups claim. For a user in more than 200 groups DFE reads the groups from Microsoft Graph with the user's token.
Expand Down
44 changes: 0 additions & 44 deletions docs/control-plane/idp-setup/google.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,50 +17,6 @@ Google puts no groups in its sign-in token. So DFE asks for a read-only groups s
DFE signs in with Google by code exchange, then reads the user's groups from the Cloud Identity API with the user's token.

```mermaid
---
config:
theme: base
fontFamily: Inter, -apple-system, Segoe UI, Roboto, Helvetica, Arial, sans-serif
themeVariables:
fontSize: 15px
lineColor: "#64748B"
primaryTextColor: "#0F172A"
clusterBorder: "#0072B2"
edgeLabelBackground: "#FFFFFF"
primaryColor: "#FFFFFF"
primaryBorderColor: "#334155"
secondaryColor: "#F8FAFC"
tertiaryColor: "#FFFFFF"
textColor: "#0F172A"
actorBkg: "#FFFFFF"
actorBorder: "#334155"
actorTextColor: "#0F172A"
actorLineColor: "#94A3B8"
signalColor: "#64748B"
signalTextColor: "#0F172A"
sequenceNumberColor: "#FFFFFF"
labelBoxBkgColor: "#FFFFFF"
labelBoxBorderColor: "#64748B"
labelTextColor: "#0F172A"
loopTextColor: "#0F172A"
noteBkgColor: "#FFFFFF"
noteBorderColor: "#94A3B8"
noteTextColor: "#0F172A"
transitionColor: "#64748B"
transitionLabelColor: "#0F172A"
stateLabelColor: "#0F172A"
stateBkg: "#FFFFFF"
labelBackgroundColor: "#FFFFFF"
compositeBackground: "#FFFFFF"
attributeBackgroundColorOdd: "#FFFFFF"
attributeBackgroundColorEven: "#F8FAFC"
themeCSS: >-
p{margin:0}
.node rect,.node polygon,.outer-path{filter:drop-shadow(0 1px 2px rgba(15,23,42,.10)) drop-shadow(0 6px 14px rgba(15,23,42,.10))!important}
.messageText,.loopText,.loopText tspan,.labelText,.labelText tspan{stroke:#FFFFFF!important;stroke-width:3px!important;paint-order:stroke;stroke-linejoin:round}
.edgeLabel,.edgeLabel p,.labelBkg{background:#FFFFFF!important}
.edgeLabel span{background:#FFFFFF!important;color:#1E293B}
---
sequenceDiagram
accTitle: L4 Detail -- Google sign-in
accDescr: The browser opens DFE sign-in and DFE redirects to Google with the Cloud Identity groups scope. DFE exchanges the code for an ID token and the user's access token, then searches the user's groups in the Cloud Identity API with that token.
Expand Down
44 changes: 0 additions & 44 deletions docs/control-plane/rbac-groups.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,50 +7,6 @@ This page is section 4.4 of [rbac.md](rbac.md), kept under that number so sectio
A sync run for an api-mode provider lists every remote group and updates, creates or skips each one (`src/dfe_engine/auth/oidc/sync.py`).

```mermaid
---
config:
theme: base
fontFamily: Inter, -apple-system, Segoe UI, Roboto, Helvetica, Arial, sans-serif
themeVariables:
fontSize: 15px
lineColor: "#64748B"
primaryTextColor: "#0F172A"
clusterBorder: "#0072B2"
edgeLabelBackground: "#FFFFFF"
primaryColor: "#FFFFFF"
primaryBorderColor: "#334155"
secondaryColor: "#F8FAFC"
tertiaryColor: "#FFFFFF"
textColor: "#0F172A"
actorBkg: "#FFFFFF"
actorBorder: "#334155"
actorTextColor: "#0F172A"
actorLineColor: "#94A3B8"
signalColor: "#64748B"
signalTextColor: "#0F172A"
sequenceNumberColor: "#FFFFFF"
labelBoxBkgColor: "#FFFFFF"
labelBoxBorderColor: "#64748B"
labelTextColor: "#0F172A"
loopTextColor: "#0F172A"
noteBkgColor: "#FFFFFF"
noteBorderColor: "#94A3B8"
noteTextColor: "#0F172A"
transitionColor: "#64748B"
transitionLabelColor: "#0F172A"
stateLabelColor: "#0F172A"
stateBkg: "#FFFFFF"
labelBackgroundColor: "#FFFFFF"
compositeBackground: "#FFFFFF"
attributeBackgroundColorOdd: "#FFFFFF"
attributeBackgroundColorEven: "#F8FAFC"
themeCSS: >-
p{margin:0}
.node rect,.node polygon,.outer-path{filter:drop-shadow(0 1px 2px rgba(15,23,42,.10)) drop-shadow(0 6px 14px rgba(15,23,42,.10))!important}
.messageText,.loopText,.loopText tspan,.labelText,.labelText tspan{stroke:#FFFFFF!important;stroke-width:3px!important;paint-order:stroke;stroke-linejoin:round}
.edgeLabel,.edgeLabel p,.labelBkg{background:#FFFFFF!important}
.edgeLabel span{background:#FFFFFF!important;color:#1E293B}
---
sequenceDiagram
accTitle: L4 Detail -- OIDC group sync
accDescr: The sync reads the provider from the registry, lists every group through the provider's adapter, and reads the stored groups. Each remote group then updates, creates or is skipped, and the sync writes the run's time and status back to the registry.
Expand Down
Loading
Loading