stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 16 Releases Wiki Activity
Files
cbdc05b24dd756786201635a0bfac960ac5d24d2
git.stella-ops.org/docs/modules/policy/prep/2025-11-20-policy-engine-30-003-prep.md
master d519782a8f
Some checks failed
Docs CI / lint-and-preview (push) Has been cancelled
Details
prep docs and service updates
2025-11-21 06:56:36 +00:00

1.4 KiB
Raw Blame History

Policy Engine · Change Events Prep (POLICY-ENGINE-30-003)

  • Date: 2025-11-20
  • Depends on: Overlay projection (30-001) and simulation bridge (30-002)
  • Working directory: src/Policy/StellaOps.Policy.Engine

Event envelope

  • Topic: policy.overlay.changed
  • Payload fields:
    • tenant (string)
    • ruleId (string)
    • version (int) — matches projection version
    • changeType (created|updated|deprecated|deleted)
    • projection (OverlayProjection) — single item; for deleted, include last-known projection with decision: "defer".
    • delta (object, optional) — produced when triggered from simulation whatif: baselineDecision, candidateDecision, diffReason.
    • artifacts — evidenceHash, treeDigest?, dsseEnvelopeHash?
    • emittedAt (ISO-8601 UTC)
    • correlationId (string) — propagate from incoming request or run id.

Delivery guarantees

  • At-least-once on the bus; projection storage is source of truth. Events carry idempotency key tenant:ruleId:version.
  • Ordering per ruleId is preserved by publishing after storage commit.

Consumers

  • Scheduler uses events to enqueue re-evaluation jobs keyed by tenant + ruleId.
  • UI/CLI preview listens for changeType ≠ created to refresh overlays without polling.

Acceptance for prep completion

  • Topic, payload, and idempotency key are fixed; downstream scheduler/UI/CLI can wire without further contract churn.