tests fixes and sprints work

src/Platform/StellaOps.Platform.Analytics/AGENTS.md

@@ -0,0 +1,42 @@
+# Platform Analytics Ingestion (StellaOps.Platform.Analytics)
+
+## Mission
+- Ingest SBOM, vulnerability, and attestation events into the analytics schema.
+- Normalize and store raw payloads for replayable audits.
+- Provide deterministic, tenant-scoped analytics data for downstream queries.
+
+## Roles
+- Backend engineer: ingestion services, normalization, persistence, idempotency.
+- QA automation engineer: deterministic fixtures and schema validation tests.
+- Docs maintainer: ingestion contracts, data flow, and runbooks.
+
+## Operating principles
+- Idempotent upserts; safe replay of the same input.
+- Deterministic ordering and UTC timestamps.
+- Offline-first: no hidden network calls; rely on local feeds.
+- Tenancy-aware: enforce tenant context on every ingest.
+- Auditability: store raw payloads and ingestion metadata.
+
+## Working directory
+- `src/Platform/StellaOps.Platform.Analytics/`
+
+## Testing expectations
+- Unit tests for normalization, deduplication, and contract parsing.
+- Integration tests using deterministic fixtures; avoid network.
+- Validate materialized view refresh outputs with frozen datasets.
+
+## Working agreements
+- Update sprint status in `docs/implplan/SPRINT_*.md` and local `TASKS.md` if added.
+- Record contract changes in sprint Decisions & Risks with doc links.
+- Keep ingestion schemas aligned with `docs/db/analytics_schema.sql`.
+
+## Required reading
+- `docs/modules/analytics/README.md`
+- `docs/modules/analytics/architecture.md`
+- `docs/modules/analytics/queries.md`
+- `docs/modules/scanner/architecture.md`
+- `docs/modules/concelier/architecture.md`
+- `docs/modules/excititor/architecture.md`
+- `docs/modules/attestor/architecture.md`
+- `docs/sboms/DETERMINISM.md`
+- `src/Platform/AGENTS.md`