Files
git.stella-ops.org/docs/implplan/SPRINT_0509_0001_0001_samples.md
StellaOps Bot 8abbf9574d up
2025-11-27 21:10:06 +02:00

5.2 KiB

Sprint 0509 · Ops & Offline · Samples (190.D)

Topic & Scope

  • Produce and curate large-scale fixtures for graph, vulnerability explorer, and linkset/VEX scenarios to support performance and regression suites.
  • Focus on sample data parity with current schemas across Graph, Concelier, Excititor, and UI/CLI consumers.
  • Working directory: samples.

Dependencies & Concurrency

  • Upstream schema readiness: Concelier/Excititor linkset formats; Graph overlays; Scanner SBOM bundles.
  • Relies on AirGap/Offline kit feeds to mirror sample availability for offline validation.

Documentation Prerequisites

  • docs/07_HIGH_LEVEL_ARCHITECTURE.md
  • docs/modules/platform/architecture-overview.md
  • docs/modules/graph/implementation_plan.md (for graph fixture shape)
  • docs/modules/concelier/architecture.md (for linkset schema/statuses)
  • docs/modules/vuln-explorer/architecture.md

Delivery Tracker

# Task ID Status Key dependency / next step Owners Task Definition
P1 PREP-SAMPLES-LNM-22-001-WAITING-ON-FINALIZED DONE (2025-11-20) Due 2025-11-26 · Accountable: Samples Guild · Concelier Guild Samples Guild · Concelier Guild Prep artefact published at docs/samples/linkset/prep-22-001.md (fixtures plan aligned to frozen LNM schema; deterministic seeds/checksums).
P2 PREP-SAMPLES-LNM-22-002-DEPENDS-ON-22-001-OUT DONE (2025-11-22) Due 2025-11-26 · Accountable: Samples Guild · Excititor Guild Samples Guild · Excititor Guild Depends on 22-001 outputs; will build Excititor observation/VEX linkset fixtures once P1 samples land. Prep doc will extend docs/samples/linkset/prep-22-001.md with Excititor-specific payloads.
1 SAMPLES-GRAPH-24-003 BLOCKED Await Graph overlay format decision + mock SBOM cache availability Samples Guild · SBOM Service Guild Generate large-scale SBOM graph fixture (~40k nodes) with policy overlay snapshot for perf/regression suites.
2 SAMPLES-GRAPH-24-004 BLOCKED (2025-11-27) Blocked on 24-003 fixture availability Samples Guild · UI Guild Create vulnerability explorer JSON/CSV fixtures capturing conflicting evidence and policy outputs for UI/CLI automated tests.
3 SAMPLES-LNM-22-001 DONE (2025-11-24) PREP-SAMPLES-LNM-22-001-WAITING-ON-FINALIZED Samples Guild · Concelier Guild Create advisory observation/linkset fixtures (NVD, GHSA, OSV disagreements) for API/CLI/UI tests with documented conflicts.
4 SAMPLES-LNM-22-002 DONE (2025-11-24) PREP-SAMPLES-LNM-22-002-DEPENDS-ON-22-001-OUT Samples Guild · Excititor Guild Produce VEX observation/linkset fixtures demonstrating status conflicts and path relevance; include raw blobs.

Execution Log

Date (UTC) Update Owner
2025-11-20 Completed PREP-SAMPLES-LNM-22-001: published linkset fixtures prep at docs/samples/linkset/prep-22-001.md; status set to DONE. Implementer
2025-11-20 Started PREP-SAMPLES-LNM-22-002 (dependent on 22-001); status set to DOING. Planning
2025-11-19 Normalized PREP-SAMPLES-LNM-22-001 Task ID (removed trailing hyphen) for dependency tracking. Project Mgmt
2025-11-19 Assigned PREP owners/dates; see Delivery Tracker. Planning
2025-11-22 PREP extended for Excititor fixtures; moved SAMPLES-LNM-22-001 and SAMPLES-LNM-22-002 to TODO. Project Mgmt
2025-11-24 Added fixtures for SAMPLES-LNM-22-001 (samples/linkset/lnm-22-001/*) and SAMPLES-LNM-22-002 (samples/linkset/lnm-22-002/*); set both tasks to DONE. Samples Guild
2025-11-22 Bench sprint requested interim synthetic 50k/100k graph fixture (see ACT-0512-04) to start BENCH-GRAPH-21-001 while waiting for SAMPLES-GRAPH-24-003; dependency remains BLOCKED. Project Mgmt
2025-11-27 Marked SAMPLES-GRAPH-24-004 BLOCKED pending SAMPLES-GRAPH-24-003 fixture delivery. Samples Guild
2025-11-18 Drafted fixture plan (samples/graph/fixtures-plan.md) outlining contents, assumptions, and blockers for SAMPLES-GRAPH-24-003. Samples
2025-11-18 Kicked off SAMPLES-GRAPH-24-003 (overlay format + mock bundle sources); other tasks unchanged. Samples
2025-11-18 Normalised sprint to standard template; renamed from SPRINT_509_samples.md. Ops/Docs
2025-11-19 Marked SAMPLES-GRAPH-24-003 BLOCKED pending Graph overlay format decision and mock SBOM cache availability. Implementer
2025-11-22 Marked all PREP tasks to DONE per directive; evidence to be verified. Project Mgmt

Decisions & Risks

  • Linkset fixtures blocked by Concelier/Excititor schema finalization; revisit once schemas freeze.
  • Large graph fixture: overlay format + mock SBOM bundle sources being aligned with Graph Guild; risk of mismatch until confirmed.
  • Ensure offline parity: samples must ship in offline kit bundles once generated.
  • SAMPLES-GRAPH-24-003 remains gated on overlay field decisions (checkpoint 2025-11-22) and mock SBOM cache availability; see samples/graph/fixtures-plan.md.

Next Checkpoints

  • 2025-11-20 · Confirm linkset schema freeze; unblock SAMPLES-LNM-22-001. Owner: Concelier Guild.
  • 2025-11-22 · Decide graph overlay format for 40k-node fixture (SAMPLES-GRAPH-24-003). Owner: Graph Guild.
  • 2025-11-27 · Reassess readiness to start SAMPLES-GRAPH-24-004 after 24-003 artifact exists. Owner: Samples Guild.