Files
git.stella-ops.org/docs/modules/policy/prep/2025-11-22-policy-engine-30-001-prep.md
StellaOps Bot f43e828b4e
Some checks failed
Docs CI / lint-and-preview (push) Has been cancelled
feat: Implement MongoDB orchestrator storage with registry, commands, and heartbeats
- Added NullAdvisoryObservationEventTransport for handling advisory observation events.
- Created IOrchestratorRegistryStore interface for orchestrator registry operations.
- Implemented MongoOrchestratorRegistryStore for MongoDB interactions with orchestrator data.
- Defined OrchestratorCommandDocument and OrchestratorCommandRecord for command handling.
- Added OrchestratorHeartbeatDocument and OrchestratorHeartbeatRecord for heartbeat tracking.
- Created OrchestratorRegistryDocument and OrchestratorRegistryRecord for registry management.
- Developed tests for orchestrator collections migration and MongoOrchestratorRegistryStore functionality.
- Introduced AirgapImportRequest and AirgapImportValidator for air-gapped VEX bundle imports.
- Added incident mode rules sample JSON for notifier configuration.
2025-11-22 12:35:38 +02:00

1.3 KiB

Policy Engine 30-001 Prep — Overlay Projection

Status: Ready for implementation (2025-11-22) Owners: Policy Guild · Cartographer Guild Scope: Freeze overlay projection contract needed for Policy Engine phase III.

Inputs

  • Path/scope schema: docs/modules/policy/prep/2025-11-20-policy-engine-29-002-prep.md.
  • Metrics/log schema: docs/modules/policy/prep/2025-11-20-policy-engine-29-004-prep.md.

Overlay Projection Contract

  • Input: evaluation records {tenantId, policyId, pathScope[], evidenceDigest, decision, reasons[]}.
  • Output overlay entry:
    • overlayId (deterministic hash of tenantId+policyId+pathScope+evidenceDigest)
    • subject (purl or pkg tuple), pathScope, decision, rationale, inputs (evidence digests), policyVersion, createdAt.
  • Determinism: pathScope sorted; reasons sorted by code; timestamps set to evaluation clock.
  • Export shape for downstream components via /overlays/{overlayId} and /overlays/search with paging.

Acceptance Criteria

  • Overlay schema above referenced in Sprint 125 and 0125 trackers; downstream simulation/bridge tasks can consume it without further schema.
  • Any future field additions require version bump overlaySchemaVersion.

Notes

  • Completes PREP-POLICY-ENGINE-30-001-WAITING-ON-29-004-M.