stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 16 Releases Wiki Activity
Files
49922dff5ad4435420dac177e832ba4290ceaea9
git.stella-ops.org/docs/dev/aoc-normalization-removal-notes.md
master 950f238a93
Some checks failed
Docs CI / lint-and-preview (push) Has been cancelled
Details
Add MergeUsageAnalyzer to detect legacy merge service usage 
- Implemented MergeUsageAnalyzer to flag usage of AdvisoryMergeService and AddMergeModule.
- Created AnalyzerReleases.Shipped.md and AnalyzerReleases.Unshipped.md for release documentation.
- Added tests for MergeUsageAnalyzer to ensure correct diagnostics for various scenarios.
- Updated project files for analyzers and tests to include necessary dependencies and configurations.
- Introduced a sample report structure for scanner output.
2025-11-06 15:03:39 +02:00

2.3 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.
  • 2025-11-06 23:30Z: Concelier core/linkset query paths now keep alias/reference casing & whitespace intact; alias filters switched to case-insensitive regex so raw data and lookups remain compatible.