stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
822e3b60373b101770aa75b2c582fb9e61368b5f
git.stella-ops.org/docs/dev/aoc-normalization-removal-notes.md
master dd217b4546
Some checks failed
Docs CI / lint-and-preview (push) Has been cancelled
Details
feat: Implement approvals workflow and notifications integration 
- Added approvals orchestration with persistence and workflow scaffolding.
- Integrated notifications insights and staged resume hooks.
- Introduced approval coordinator and policy notification bridge with unit tests.
- Added approval decision API with resume requeue and persisted plan snapshots.
- Documented the Excitor consensus API beta and provided JSON sample payload.
- Created analyzers to flag usage of deprecated merge service APIs.
- Implemented logging for artifact uploads and approval decision service.
- Added tests for PackRunApprovalDecisionService and related components.
2025-11-06 08:48:13 +02:00

2.1 KiB
Raw Blame History

AOC Normalization Removal Notes

Last updated: 2025-10-29

Goal

Document follow-up actions for CONCELIER-CORE-AOC-19-004 as we unwind the final pieces of normalization from the ingestion/runtime path.

Current Findings

  • AdvisoryRawService and MongoAdvisoryRawRepository already preserve upstream ordering and duplicate aliases (trim-only). No additional code changes required there.
  • Observation layers (AdvisoryObservationFactory, AdvisoryObservationQueryService) still canonicalise aliases, PURLs, CPEs, and references. These need to be relaxed so Policy/overlays receive raw linksets and can own dedupe logic.
  • Linkset mapper continues to emit deterministic hints. We will keep the mapper but ensure observation output can surface both raw and canonical views for downstream services.

Next Steps

  1. Introduce a raw linkset projection alongside the existing canonical mapper so Policy Engine can choose which flavour to consume. ✅ 2025-10-31: AdvisoryObservation now surfaces RawLinkset; Mongo documents store both canonical & raw shapes; tests/goldens updated.
  2. Update observation factory/query tests to assert duplicate handling and ordering with the relaxed projection. ✅ 2025-10-31.
  3. Refresh docs (docs/ingestion/aggregation-only-contract.md) once behaviour lands to explain the “raw vs canonical linkset” split. ✅ 2025-11-06: Added invariant notes and rollout guidance, linked to docs/migration/no-merge.md and docs/dev/raw-linkset-backfill-plan.md.
  4. Coordinate with Policy Guild to validate consumers against the new raw projection before flipping defaults. ↺ Ongoing — see action items in docs/dev/raw-linkset-backfill-plan.md (2025-10-31 handshake with POLICY-ENGINE-20-003 owners).
  • 2025-11-05: Catalogued residual normalization paths tied to the legacy Merge service and outlined noMergeEnabled feature-toggle work to keep AOC ingestion fully merge-free.
  • 2025-11-05 19:20Z: Observation factory/linkset now preserve upstream ordering and duplicates; canonicalisation shifts to downstream services.
  • 2025-11-06: Documented post-merge rollout plan and annotated sprint trackers with analyzer gating updates.