Files
git.stella-ops.org/docs/dev/normalized_versions_rollout.md
master 5fd4032c7c
Some checks failed
Docs CI / lint-and-preview (push) Has been cancelled
Add channel test providers for Email, Slack, Teams, and Webhook
- Implemented EmailChannelTestProvider to generate email preview payloads.
- Implemented SlackChannelTestProvider to create Slack message previews.
- Implemented TeamsChannelTestProvider for generating Teams Adaptive Card previews.
- Implemented WebhookChannelTestProvider to create webhook payloads.
- Added INotifyChannelTestProvider interface for channel-specific preview generation.
- Created ChannelTestPreviewContracts for request and response models.
- Developed NotifyChannelTestService to handle test send requests and generate previews.
- Added rate limit policies for test sends and delivery history.
- Implemented unit tests for service registration and binding.
- Updated project files to include necessary dependencies and configurations.
2025-10-19 23:29:34 +03:00

5.9 KiB
Raw Blame History

Normalized Versions Rollout Dashboard (Sprint 2 Concelier)

Status date: 2025-10-12 17:05 UTC

This dashboard tracks connector readiness for emitting AffectedPackage.NormalizedVersions arrays and highlights upcoming coordination checkpoints. Use it alongside:

Key milestones

  • 2025-10-12 Normalization finalized SemVerRangeRuleBuilder API contract (multi-segment comparators + notes), connector review opens.
  • 2025-10-17 Connector owners to post fixture PRs showing NormalizedVersions arrays (even if feature-flagged).
  • 2025-10-18 Merge cross-connector review to validate consistent field usage before enabling union logic.

Connector readiness matrix

Connector Owner team Normalized versions status Last update Next action / link
Acsc BE-Conn-ACSC Not started mapper pending 2025-10-11 Design DTOs + mapper with normalized rule array; see src/StellaOps.Concelier.Connector.Acsc/TASKS.md.
Cccs BE-Conn-CCCS ⚠️ Scheduled helper ready, implementation due 2025-10-21 2025-10-19 Apply Merge-provided trailing-version helper to emit NormalizedVersions; update mapper/tests per src/StellaOps.Concelier.Connector.Cccs/TASKS.md.
CertBund BE-Conn-CERTBUND ⚠️ Follow-up translate versions strings to normalized rules 2025-10-19 Build bis/alle translator + fixtures before 2025-10-22 per src/StellaOps.Concelier.Connector.CertBund/TASKS.md.
CertCc BE-Conn-CERTCC ⚠️ In progress fetch pipeline DOING 2025-10-11 Implement VINCE mapper with SemVer/NEVRA rules; unblock snapshot regeneration; src/StellaOps.Concelier.Connector.CertCc/TASKS.md.
Kev BE-Conn-KEV Normalized catalog/due-date rules verified 2025-10-12 Fixtures reconfirmed via dotnet test src/StellaOps.Concelier.Connector.Kev.Tests; src/StellaOps.Concelier.Connector.Kev/TASKS.md.
Cve BE-Conn-CVE Normalized SemVer rules verified 2025-10-12 Snapshot parity green (dotnet test src/StellaOps.Concelier.Connector.Cve.Tests); src/StellaOps.Concelier.Connector.Cve/TASKS.md.
Ghsa BE-Conn-GHSA ⚠️ DOING normalized rollout task active 2025-10-11 18:45 UTC Wire SemVerRangeRuleBuilder + refresh fixtures; src/StellaOps.Concelier.Connector.Ghsa/TASKS.md.
Osv BE-Conn-OSV SemVer mapper & parity fixtures verified 2025-10-12 GHSA parity regression passing (dotnet test src/StellaOps.Concelier.Connector.Osv.Tests); src/StellaOps.Concelier.Connector.Osv/TASKS.md.
Ics.Cisa BE-Conn-ICS-CISA ⚠️ Decision pending normalize SemVer exacts or escalate scheme 2025-10-19 Promote SemVerPrimitive outputs into NormalizedVersions or file Models ticket by 2025-10-23 (src/StellaOps.Concelier.Connector.Ics.Cisa/TASKS.md).
Kisa BE-Conn-KISA ⚠️ Proposal required firmware scheme due 2025-10-24 2025-10-19 Draft kisa.build (or equivalent) scheme with Models, then emit normalized rules; track in src/StellaOps.Concelier.Connector.Kisa/TASKS.md.
Ru.Bdu BE-Conn-BDU Raw scheme emitted 2025-10-14 Mapper now writes ru-bdu.raw normalized rules with provenance + telemetry; src/StellaOps.Concelier.Connector.Ru.Bdu/TASKS.md.
Ru.Nkcki BE-Conn-Nkcki Not started mapper TODO 2025-10-11 Similar to BDU; ensure Cyrillic provenance preserved; src/StellaOps.Concelier.Connector.Ru.Nkcki/TASKS.md.
Vndr.Apple BE-Conn-Apple Shipped emitting normalized arrays 2025-10-11 Continue fixture/tooling work; src/StellaOps.Concelier.Connector.Vndr.Apple/TASKS.md.
Vndr.Cisco BE-Conn-Cisco ⚠️ Scheduled normalized rule emission due 2025-10-21 2025-10-19 Use Merge helper to persist NormalizedVersions alongside SemVer primitives; see src/StellaOps.Concelier.Connector.Vndr.Cisco/TASKS.md.
Vndr.Msrc BE-Conn-MSRC Map + normalized build rules landed 2025-10-15 MsrcMapper emits msrc.build normalized rules with CVRF references; see src/StellaOps.Concelier.Connector.Vndr.Msrc/TASKS.md.
Nvd BE-Conn-NVD ⚠️ Needs follow-up mapper complete but normalized array MR pending 2025-10-11 Align CVE notes + normalized payload flag; src/StellaOps.Concelier.Connector.Nvd/TASKS.md.

Legend: complete, ⚠️ in progress/partial, not started.

Monitoring

  • Merge now emits concelier.merge.normalized_rules (tags: package_type, scheme) and concelier.merge.normalized_rules_missing (tags: package_type). Track these counters to confirm normalized arrays land as connectors roll out.
  • Expect normalized_rules_missing to trend toward zero as each connector flips on normalized output. Investigate any sustained counts by checking the corresponding module TASKS.md.

Implementation tips

  • When a connector only needs to populate AffectedPackage.NormalizedVersions (without reusing range primitives), call SemVerRangeRuleBuilder.BuildNormalizedRules(rawRange, patchedVersion, note) to project the normalized rule list directly. This avoids re-wrapping SemVerRangeBuildResult instances and keeps provenance notes consistent with the shared builder.

How to use this dashboard

  1. Before opening a connector PR, update the module TASKS.md entry and drop a short bullet here (status + timestamp).
  2. When a connector lands normalized outputs, flip the status to and note any rollout toggles (feature flags, fixture regenerations).
  3. If a dependency or blocker emerges, add it both in the module TASKS.md and in this matrix so merge/storage can escalate quickly.