stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 16 Releases Wiki Activity
Files
d519782a8f0b30f425c9b6ae0f316b19259972a2
git.stella-ops.org/docs/modules/excititor/prep/2025-11-20-linkset-extraction-prep.md
master d519782a8f
Some checks failed
Docs CI / lint-and-preview (push) Has been cancelled
Details
prep docs and service updates
2025-11-21 06:56:36 +00:00

1.3 KiB
Raw Blame History

Linkset Extraction Prep — PREP-EXCITITOR-CORE-AOC-19-002-LINKSET-EXTRAC

Status: Draft (2025-11-20) Owners: Excititor Core Guild Scope: Identify the extraction rules and ordering needed to produce linksets from VEX/advisory inputs before idempotent raw upsert work starts.

Required content to unblock

  • Canonical linkset schema version (pending Cartographer/Concelier alignment); need field list and conflict markers.
  • Source ranking/precedence table shared with Concelier LNM 21-002 fixtures.

Proposed extraction rules (draft)

  • Inputs: advisory documents (component PURLs, version ranges, references, severities, CVSS vectors); output: linkset entries with advisory_id, component_purl, version_range, references[], severity, cvss.
  • Ordering: sort entries by (component_purl, advisory_id, version_range); within references, sort lexicographically.
  • Conflict handling: if multiple sources disagree, emit conflicts[] with source, field, reason; never collapse values.
  • Determinism: no wall-clock; timestamps only from source payloads (UTC ISO-8601) and preserved as-is.

Handoff

Treat this as the prep artefact for PREP-EXCITITOR-CORE-AOC-19-002-LINKSET-EXTRAC. Once the shared linkset schema and precedence table land, finalize the rules and move the sprint task to DONE.