feat: Initialize Zastava Webhook service with TLS and Authority authentication

- Added Program.cs to set up the web application with Serilog for logging, health check endpoints, and a placeholder admission endpoint. - Configured Kestrel server to use TLS 1.3 and handle client certificates appropriately. - Created StellaOps.Zastava.Webhook.csproj with necessary dependencies including Serilog and Polly. - Documented tasks in TASKS.md for the Zastava Webhook project, outlining current work and exit criteria for each task.
2025-10-19 18:36:22 +03:00
parent 2062da7a8b
commit d099a90f9b
966 changed files with 91038 additions and 1850 deletions
--- a/samples/TASKS.md
+++ b/samples/TASKS.md
@@ -2,4 +2,5 @@

 | ID | Status | Owner(s) | Depends on | Description | Exit Criteria |
 |----|--------|----------|------------|-------------|---------------|
-| SAMPLES-10-001 | TODO | Samples Guild, Scanner Team | SCANNER-EMIT-10-605 | Curate sample images (nginx, alpine+busybox, distroless+go, .NET AOT, python venv, npm monorepo) with expected SBOM/BOM-Index sidecars. | Samples committed under `samples/`; golden SBOM/BOM-Index files present; documented usage. |
+| SAMPLES-10-001 | DONE | Samples Guild, Scanner Team | SCANNER-EMIT-10-605 | Curate sample images (nginx, alpine+busybox, distroless+go, .NET AOT, python venv, npm monorepo) with expected SBOM/BOM-Index sidecars. | Samples committed under `samples/`; golden SBOM/BOM-Index files present; documented usage. |
+| SAMPLES-13-004 | TODO | Samples Guild, Policy Guild | POLICY-CORE-09-006, UI-POLICY-13-007 | Add policy preview/report fixtures showing confidence bands and unknown-age tags. | Confidence sample (`samples/policy/policy-preview-unknown.json`) reviewed, documented usage in UI dev guide, ajv validation hook updated. |
--- a/samples/api/reports/report-sample.dsse.json
+++ b/samples/api/reports/report-sample.dsse.json
@@ -0,0 +1,52 @@
+{
+  "report": {
+    "reportId": "report-3def5f362aa475ef14b6",
+    "imageDigest": "sha256:deadbeef",
+    "generatedAt": "2025-10-19T08:28:09.3699267+00:00",
+    "verdict": "blocked",
+    "policy": {
+      "revisionId": "rev-1",
+      "digest": "27d2ec2b34feedc304fc564d252ecee1c8fa14ea581a5ff5c1ea8963313d5c8d"
+    },
+    "summary": {
+      "total": 1,
+      "blocked": 1,
+      "warned": 0,
+      "ignored": 0,
+      "quieted": 0
+    },
+    "verdicts": [
+      {
+        "findingId": "finding-1",
+        "status": "Blocked",
+        "ruleName": "Block Critical",
+        "ruleAction": "Block",
+        "score": 40.5,
+        "configVersion": "1.0",
+        "inputs": {
+          "reachabilityWeight": 0.45,
+          "baseScore": 40.5,
+          "severityWeight": 90,
+          "trustWeight": 1,
+          "trustWeight.NVD": 1,
+          "reachability.runtime": 0.45
+        },
+        "quiet": false,
+        "sourceTrust": "NVD",
+        "reachability": "runtime"
+      }
+    ],
+    "issues": []
+  },
+  "dsse": {
+    "payloadType": "application/vnd.stellaops.report+json",
+    "payload": "eyJyZXBvcnRJZCI6InJlcG9ydC0zZGVmNWYzNjJhYTQ3NWVmMTRiNiIsImltYWdlRGlnZXN0Ijoic2hhMjU2OmRlYWRiZWVmIiwiZ2VuZXJhdGVkQXQiOiIyMDI1LTEwLTE5VDA4OjI4OjA5LjM2OTkyNjcrMDA6MDAiLCJ2ZXJkaWN0IjoiYmxvY2tlZCIsInBvbGljeSI6eyJyZXZpc2lvbklkIjoicmV2LTEiLCJkaWdlc3QiOiIyN2QyZWMyYjM0ZmVlZGMzMDRmYzU2NGQyNTJlY2VlMWM4ZmExNGVhNTgxYTVmZjVjMWVhODk2MzMxM2Q1YzhkIn0sInN1bW1hcnkiOnsidG90YWwiOjEsImJsb2NrZWQiOjEsIndhcm5lZCI6MCwiaWdub3JlZCI6MCwicXVpZXRlZCI6MH0sInZlcmRpY3RzIjpbeyJmaW5kaW5nSWQiOiJmaW5kaW5nLTEiLCJzdGF0dXMiOiJCbG9ja2VkIiwicnVsZU5hbWUiOiJCbG9jayBDcml0aWNhbCIsInJ1bGVBY3Rpb24iOiJCbG9jayIsInNjb3JlIjo0MC41LCJjb25maWdWZXJzaW9uIjoiMS4wIiwiaW5wdXRzIjp7InJlYWNoYWJpbGl0eVdlaWdodCI6MC40NSwiYmFzZVNjb3JlIjo0MC41LCJzZXZlcml0eVdlaWdodCI6OTAsInRydXN0V2VpZ2h0IjoxLCJ0cnVzdFdlaWdodC5OVkQiOjEsInJlYWNoYWJpbGl0eS5ydW50aW1lIjowLjQ1fSwicXVpZXQiOmZhbHNlLCJzb3VyY2VUcnVzdCI6Ik5WRCIsInJlYWNoYWJpbGl0eSI6InJ1bnRpbWUifV0sImlzc3VlcyI6W119",
+    "signatures": [
+      {
+        "keyId": "scanner-report-signing",
+        "algorithm": "hs256",
+        "signature": "s3qnWeRsYs+QA/nO84Us8G2xjZcvphc2P7KnOdTVwQs="
+      }
+    ]
+  }
+}
--- a/samples/api/scheduler/audit.json
+++ b/samples/api/scheduler/audit.json
@@ -0,0 +1,19 @@
+{
+  "id": "audit_169754",
+  "tenantId": "tenant-alpha",
+  "category": "scheduler",
+  "action": "pause",
+  "occurredAt": "2025-10-18T22:10:00+00:00",
+  "actor": {
+    "actorId": "user_admin",
+    "displayName": "Cluster Admin",
+    "kind": "user"
+  },
+  "scheduleId": "sch_20251018a",
+  "correlationId": "corr-123",
+  "metadata": {
+    "details": "schedule paused",
+    "reason": "maintenance"
+  },
+  "message": "Paused via API"
+}
--- a/samples/api/scheduler/impact-set.json
+++ b/samples/api/scheduler/impact-set.json
@@ -0,0 +1,34 @@
+{
+  "schemaVersion": "scheduler.impact-set@1",
+  "selector": {
+    "scope": "all-images",
+    "tenantId": "tenant-alpha",
+    "namespaces": [],
+    "repositories": [],
+    "digests": [],
+    "includeTags": [],
+    "labels": [],
+    "resolvesTags": false
+  },
+  "images": [
+    {
+      "imageDigest": "sha256:f1e2d3",
+      "registry": "registry.internal",
+      "repository": "app/api",
+      "namespaces": [
+        "team-a"
+      ],
+      "tags": [
+        "prod"
+      ],
+      "usedByEntrypoint": true,
+      "labels": {
+        "env": "prod"
+      }
+    }
+  ],
+  "usageOnly": true,
+  "generatedAt": "2025-10-18T22:02:58+00:00",
+  "total": 412,
+  "snapshotId": "impact-20251018-1"
+}
--- a/samples/api/scheduler/run.json
+++ b/samples/api/scheduler/run.json
@@ -0,0 +1,50 @@
+{
+  "schemaVersion": "scheduler.run@1",
+  "id": "run_20251018_0001",
+  "tenantId": "tenant-alpha",
+  "scheduleId": "sch_20251018a",
+  "trigger": "feedser",
+  "state": "running",
+  "stats": {
+    "candidates": 1280,
+    "deduped": 910,
+    "queued": 624,
+    "completed": 310,
+    "deltas": 42,
+    "newCriticals": 7,
+    "newHigh": 11,
+    "newMedium": 18,
+    "newLow": 6
+  },
+  "reason": {
+    "feedserExportId": "exp-20251018-03"
+  },
+  "createdAt": "2025-10-18T22:03:14+00:00",
+  "startedAt": "2025-10-18T22:03:20+00:00",
+  "deltas": [
+    {
+      "imageDigest": "sha256:a1b2c3",
+      "newFindings": 3,
+      "newCriticals": 1,
+      "newHigh": 1,
+      "newMedium": 1,
+      "newLow": 0,
+      "kevHits": [
+        "CVE-2025-0002"
+      ],
+      "topFindings": [
+        {
+          "purl": "pkg:rpm/openssl@3.0.12-5.el9",
+          "vulnerabilityId": "CVE-2025-0002",
+          "severity": "critical",
+          "link": "https://ui.internal/scans/sha256:a1b2c3"
+        }
+      ],
+      "attestation": {
+        "uuid": "rekor-314",
+        "verified": true
+      },
+      "detectedAt": "2025-10-18T22:03:21+00:00"
+    }
+  ]
+}
--- a/samples/api/scheduler/schedule.json
+++ b/samples/api/scheduler/schedule.json
@@ -0,0 +1,57 @@
+{
+  "schemaVersion": "scheduler.schedule@1",
+  "id": "sch_20251018a",
+  "tenantId": "tenant-alpha",
+  "name": "Nightly Prod",
+  "enabled": true,
+  "cronExpression": "0 2 * * *",
+  "timezone": "UTC",
+  "mode": "analysis-only",
+  "selection": {
+    "scope": "by-namespace",
+    "tenantId": "tenant-alpha",
+    "namespaces": [
+      "team-a",
+      "team-b"
+    ],
+    "repositories": [
+      "app/service-api"
+    ],
+    "digests": [],
+    "includeTags": [
+      "canary",
+      "prod"
+    ],
+    "labels": [
+      {
+        "key": "env",
+        "values": [
+          "prod",
+          "staging"
+        ]
+      }
+    ],
+    "resolvesTags": true
+  },
+  "onlyIf": {
+    "lastReportOlderThanDays": 7,
+    "policyRevision": "policy@42"
+  },
+  "notify": {
+    "onNewFindings": true,
+    "minSeverity": "high",
+    "includeKev": true
+  },
+  "limits": {
+    "maxJobs": 1000,
+    "ratePerSecond": 25,
+    "parallelism": 4
+  },
+  "subscribers": [
+    "notify.ops"
+  ],
+  "createdAt": "2025-10-18T22:00:00+00:00",
+  "createdBy": "svc_scheduler",
+  "updatedAt": "2025-10-18T22:00:00+00:00",
+  "updatedBy": "svc_scheduler"
+}
--- a/samples/policy/policy-preview-unknown.json
+++ b/samples/policy/policy-preview-unknown.json
@@ -0,0 +1,98 @@
+{
+  "previewRequest": {
+    "imageDigest": "sha256:7dbe0c9a5d4f1c8184007e9d94dbe55928f8a2db5ab9c1c2d4a2f7bbcdfe1234",
+    "findings": [
+      {
+        "id": "library:pkg/openssl@1.1.1w",
+        "severity": "Unknown",
+        "source": "NVD",
+        "tags": [
+          "trust:vendor",
+          "reachability:unknown",
+          "unknown-age-days:5"
+        ]
+      },
+      {
+        "id": "library:pkg/zlib@1.3.1",
+        "severity": "High",
+        "source": "NVD",
+        "tags": [
+          "state:unknown",
+          "reachability:runtime",
+          "unknown-since:2025-10-10T00:00:00Z",
+          "observed-at:2025-10-19T12:00:00Z"
+        ]
+      }
+    ]
+  },
+  "previewResponse": {
+    "success": true,
+    "policyDigest": "8a0f72f8dc5c51c46991db3bba34e9b3c0c8e944a7a6d0a9c29a9aa6b8439876",
+    "revisionId": "rev-42",
+    "changed": 2,
+    "diffs": [
+      {
+        "findingId": "library:pkg/openssl@1.1.1w",
+        "baseline": {
+          "findingId": "library:pkg/openssl@1.1.1w",
+          "status": "Pass",
+          "score": 0,
+          "configVersion": "1.0"
+        },
+        "projected": {
+          "findingId": "library:pkg/openssl@1.1.1w",
+          "status": "Blocked",
+          "ruleName": "Block vendor unknowns",
+          "ruleAction": "block",
+          "score": 19.5,
+          "configVersion": "1.0",
+          "inputs": {
+            "severityWeight": 50,
+            "trustWeight": 0.65,
+            "reachabilityWeight": 0.6,
+            "baseScore": 19.5,
+            "trustWeight.vendor": 0.65,
+            "reachability.unknown": 0.6,
+            "unknownConfidence": 0.55,
+            "unknownAgeDays": 5
+          },
+          "unknownConfidence": 0.55,
+          "confidenceBand": "medium",
+          "unknownAgeDays": 5
+        },
+        "changed": true
+      },
+      {
+        "findingId": "library:pkg/zlib@1.3.1",
+        "baseline": {
+          "findingId": "library:pkg/zlib@1.3.1",
+          "status": "Pass",
+          "score": 0,
+          "configVersion": "1.0"
+        },
+        "projected": {
+          "findingId": "library:pkg/zlib@1.3.1",
+          "status": "Warned",
+          "ruleName": "Runtime mitigation required",
+          "ruleAction": "warn",
+          "score": 33.75,
+          "configVersion": "1.0",
+          "inputs": {
+            "severityWeight": 75,
+            "trustWeight": 1,
+            "reachabilityWeight": 0.45,
+            "baseScore": 33.75,
+            "reachability.runtime": 0.45,
+            "warnPenalty": 15,
+            "unknownConfidence": 0.35,
+            "unknownAgeDays": 9
+          },
+          "unknownConfidence": 0.35,
+          "confidenceBand": "medium",
+          "unknownAgeDays": 9
+        },
+        "changed": true
+      }
+    ]
+  }
+}
--- a/samples/runtime/README.md
+++ b/samples/runtime/README.md
@@ -0,0 +1,6 @@
+# Runtime Fixtures
+
+Supporting filesystem snippets consumed by analyzer microbenchmarks and integration tests. They are intentionally lightweight yet deterministic so they can be committed to the repository without bloating history.
+
+- `npm-monorepo/` – trimmed `node_modules/` tree for workspace-style Node.js projects.
+- `python-venv/` – selected `site-packages/` entries highlighting `*.dist-info` metadata.
--- a/samples/runtime/npm-monorepo/README.md
+++ b/samples/runtime/npm-monorepo/README.md
@@ -0,0 +1,9 @@
+# NPM Monorepo Fixture
+
+This fixture represents a trimmed monorepo layout used by the analyzer microbench. It contains four packages under `node_modules/` with realistic metadata and dependency edges.
+
+- `@stella/core` depends on `lodash`.
+- `@stella/web` depends on `@stella/core` and `rxjs`.
+- Third-party packages expose standard `name`, `version`, and `license` fields.
+
+The files are intentionally small so that the bench harness focuses on directory traversal and metadata parsing overhead.
--- a/samples/runtime/npm-monorepo/node_modules/@stella/core/package.json
+++ b/samples/runtime/npm-monorepo/node_modules/@stella/core/package.json
@@ -0,0 +1,9 @@
+{
+  "name": "@stella/core",
+  "version": "2.0.0",
+  "description": "Core services shared by the sample monorepo.",
+  "dependencies": {
+    "lodash": "4.17.21"
+  },
+  "license": "Apache-2.0"
+}
--- a/samples/runtime/npm-monorepo/node_modules/@stella/web/package.json
+++ b/samples/runtime/npm-monorepo/node_modules/@stella/web/package.json
@@ -0,0 +1,10 @@
+{
+  "name": "@stella/web",
+  "version": "1.5.3",
+  "description": "Web layer in the sample monorepo.",
+  "dependencies": {
+    "@stella/core": "2.0.0",
+    "rxjs": "7.8.1"
+  },
+  "license": "MIT"
+}
--- a/samples/runtime/npm-monorepo/node_modules/lodash/package.json
+++ b/samples/runtime/npm-monorepo/node_modules/lodash/package.json
@@ -0,0 +1,6 @@
+{
+  "name": "lodash",
+  "version": "4.17.21",
+  "description": "Lodash modular utilities.",
+  "license": "MIT"
+}
--- a/samples/runtime/npm-monorepo/node_modules/rxjs/package.json
+++ b/samples/runtime/npm-monorepo/node_modules/rxjs/package.json
@@ -0,0 +1,6 @@
+{
+  "name": "rxjs",
+  "version": "7.8.1",
+  "description": "Reactive Extensions for modern JavaScript.",
+  "license": "Apache-2.0"
+}
--- a/samples/runtime/python-venv/README.md
+++ b/samples/runtime/python-venv/README.md
@@ -0,0 +1,5 @@
+# Python Virtual Environment Fixture
+
+The fixture mimics a trimmed `site-packages/` layout with three common dependencies (`requests`, `urllib3`, `certifi`). Each package exposes a `*.dist-info/METADATA` file so the analyzer bench can validate parsing performance and header extraction.
+
+Files intentionally omit wheels and bytecode to keep the tree compact while still realistic.
--- a/samples/runtime/python-venv/lib/python3.11/site-packages/certifi-2024.6.2.dist-info/METADATA
+++ b/samples/runtime/python-venv/lib/python3.11/site-packages/certifi-2024.6.2.dist-info/METADATA
@@ -0,0 +1,5 @@
+Metadata-Version: 2.1
+Name: certifi
+Version: 2024.6.2
+Summary: Mozilla SSL Certificates.
+License: MPL-2.0
--- a/samples/runtime/python-venv/lib/python3.11/site-packages/requests-2.32.0.dist-info/METADATA
+++ b/samples/runtime/python-venv/lib/python3.11/site-packages/requests-2.32.0.dist-info/METADATA
@@ -0,0 +1,7 @@
+Metadata-Version: 2.1
+Name: requests
+Version: 2.32.0
+Summary: Python HTTP for Humans.
+License: Apache-2.0
+Requires-Dist: urllib3 (>=1.21.1,<3)
+Requires-Dist: certifi (>=2017.4.17)
--- a/samples/runtime/python-venv/lib/python3.11/site-packages/urllib3-2.2.1.dist-info/METADATA
+++ b/samples/runtime/python-venv/lib/python3.11/site-packages/urllib3-2.2.1.dist-info/METADATA
@@ -0,0 +1,5 @@
+Metadata-Version: 2.1
+Name: urllib3
+Version: 2.2.1
+Summary: HTTP library with thread-safe connection pooling.
+License: MIT
--- a/samples/scanner/README.md
+++ b/samples/scanner/README.md
@@ -0,0 +1,12 @@
+# Scanner Samples
+
+Curated SBOM and BOM Index fixtures covering representative container types referenced throughout Sprint 10. Each sample folder under `images/` corresponds to a container profile, while `../runtime` holds trimmed filesystem fixtures used by analyzer and perf tests.
+
+| Sample | Highlights |
+| ------ | ---------- |
+| `nginx` | Alpine packages with mixed inventory/runtime coverage. |
+| `alpine-busybox` | Minimal BusyBox rootfs with musl runtime linkage. |
+| `distroless-go` | Go binary with Distroless base and Go build-info evidence. |
+| `dotnet-aot` | Ahead-of-time compiled .NET worker exposing NuGet dependencies. |
+| `python-venv` | Python virtualenv with `*.dist-info` evidence. |
+| `npm-monorepo` | Node workspace packages resolved via `package.json`. |
--- a/samples/scanner/images/alpine-busybox/README.md
+++ b/samples/scanner/images/alpine-busybox/README.md
@@ -0,0 +1,3 @@
+# Alpine + BusyBox Sample
+
+Fixtures showcase the tiny Alpine image that powers many minimal containers. BusyBox and musl appear in usage because they back the entrypoint shell, while alpine-baselayout remains inventory-only.
--- a/samples/scanner/images/alpine-busybox/bom-index.json
+++ b/samples/scanner/images/alpine-busybox/bom-index.json
@@ -0,0 +1,42 @@
+{
+  "schema": "stellaops/bom-index@1",
+  "image": {
+    "repository": "docker.io/library/alpine",
+    "digest": "sha256:9a214327ec7df5bc8f1d3f12171873be7d778fdbf473d6f9a63d5de6c6bfb2d3",
+    "tag": "3.20"
+  },
+  "generatedAt": "2025-10-19T00:00:00Z",
+  "generator": "stellaops/scanner@10.0.0-preview1",
+  "components": [
+    {
+      "purl": "pkg:apk/alpine/busybox@1.36.1-r2?arch=x86_64",
+      "layerDigest": "sha256:5555555555555555555555555555555555555555555555555555555555555555",
+      "usage": ["inventory", "runtime"],
+      "licenses": ["GPL-2.0-only"],
+      "evidence": {
+        "kind": "apk-database",
+        "path": "/lib/apk/db/installed"
+      }
+    },
+    {
+      "purl": "pkg:apk/alpine/musl@1.2.5-r0?arch=x86_64",
+      "layerDigest": "sha256:6666666666666666666666666666666666666666666666666666666666666666",
+      "usage": ["inventory", "runtime"],
+      "licenses": ["MIT"],
+      "evidence": {
+        "kind": "apk-database",
+        "path": "/lib/apk/db/installed"
+      }
+    },
+    {
+      "purl": "pkg:apk/alpine/alpine-baselayout@3.4.3-r0?arch=x86_64",
+      "layerDigest": "sha256:7777777777777777777777777777777777777777777777777777777777777777",
+      "usage": ["inventory"],
+      "licenses": ["GPL-2.0-only"],
+      "evidence": {
+        "kind": "apk-database",
+        "path": "/lib/apk/db/installed"
+      }
+    }
+  ]
+}
--- a/samples/scanner/images/alpine-busybox/inventory.cdx.json
+++ b/samples/scanner/images/alpine-busybox/inventory.cdx.json
@@ -0,0 +1,34 @@
+{
+  "bomFormat": "CycloneDX",
+  "specVersion": "1.5",
+  "version": 1,
+  "metadata": {
+    "timestamp": "2025-10-19T00:00:00Z",
+    "component": {
+      "type": "container",
+      "name": "alpine-busybox",
+      "version": "3.20",
+      "bomRef": "pkg:docker/library/alpine@sha256:9a214327ec7df5bc8f1d3f12171873be7d778fdbf473d6f9a63d5de6c6bfb2d3"
+    }
+  },
+  "components": [
+    {
+      "type": "application",
+      "bomRef": "pkg:apk/alpine/busybox@1.36.1-r2?arch=x86_64",
+      "name": "busybox",
+      "version": "1.36.1-r2"
+    },
+    {
+      "type": "library",
+      "bomRef": "pkg:apk/alpine/musl@1.2.5-r0?arch=x86_64",
+      "name": "musl",
+      "version": "1.2.5-r0"
+    },
+    {
+      "type": "application",
+      "bomRef": "pkg:apk/alpine/alpine-baselayout@3.4.3-r0?arch=x86_64",
+      "name": "alpine-baselayout",
+      "version": "3.4.3-r0"
+    }
+  ]
+}
--- a/samples/scanner/images/alpine-busybox/usage.cdx.json
+++ b/samples/scanner/images/alpine-busybox/usage.cdx.json
@@ -0,0 +1,28 @@
+{
+  "bomFormat": "CycloneDX",
+  "specVersion": "1.5",
+  "version": 1,
+  "metadata": {
+    "timestamp": "2025-10-19T00:00:00Z",
+    "component": {
+      "type": "container",
+      "name": "alpine-busybox",
+      "version": "3.20",
+      "bomRef": "pkg:docker/library/alpine@sha256:9a214327ec7df5bc8f1d3f12171873be7d778fdbf473d6f9a63d5de6c6bfb2d3"
+    }
+  },
+  "components": [
+    {
+      "type": "application",
+      "bomRef": "pkg:apk/alpine/busybox@1.36.1-r2?arch=x86_64",
+      "name": "busybox",
+      "version": "1.36.1-r2"
+    },
+    {
+      "type": "library",
+      "bomRef": "pkg:apk/alpine/musl@1.2.5-r0?arch=x86_64",
+      "name": "musl",
+      "version": "1.2.5-r0"
+    }
+  ]
+}
--- a/samples/scanner/images/distroless-go/README.md
+++ b/samples/scanner/images/distroless-go/README.md
@@ -0,0 +1,3 @@
+# Distroless + Go Sample
+
+Demonstrates a Go binary shipped on top of Distroless. Only the compiled service appears in the usage SBOM, while the Go standard library remains inventory-only and still tracked in the BOM Index.
--- a/samples/scanner/images/distroless-go/bom-index.json
+++ b/samples/scanner/images/distroless-go/bom-index.json
@@ -0,0 +1,32 @@
+{
+  "schema": "stellaops/bom-index@1",
+  "image": {
+    "repository": "gcr.io/distroless/base",
+    "digest": "sha256:0dd2f0f15c9f8abfba6a0ce0d7d6a24e2e1071c977733f6e77cbe51b87f15ad9",
+    "tag": "nonroot"
+  },
+  "generatedAt": "2025-10-19T00:00:00Z",
+  "generator": "stellaops/scanner@10.0.0-preview1",
+  "components": [
+    {
+      "purl": "pkg:golang/github.com/stellaops/sample-service@v1.4.0",
+      "layerDigest": "sha256:8888888888888888888888888888888888888888888888888888888888888888",
+      "usage": ["inventory", "runtime"],
+      "licenses": ["Apache-2.0"],
+      "evidence": {
+        "kind": "go-buildinfo",
+        "path": "/workspace/service"
+      }
+    },
+    {
+      "purl": "pkg:golang/std@go1.22.5",
+      "layerDigest": "sha256:9999999999999999999999999999999999999999999999999999999999999999",
+      "usage": ["inventory"],
+      "licenses": ["BSD-3-Clause"],
+      "evidence": {
+        "kind": "go-buildinfo",
+        "path": "/workspace/service"
+      }
+    }
+  ]
+}
--- a/samples/scanner/images/distroless-go/inventory.cdx.json
+++ b/samples/scanner/images/distroless-go/inventory.cdx.json
@@ -0,0 +1,34 @@
+{
+  "bomFormat": "CycloneDX",
+  "specVersion": "1.5",
+  "version": 1,
+  "metadata": {
+    "timestamp": "2025-10-19T00:00:00Z",
+    "component": {
+      "type": "container",
+      "name": "distroless-go",
+      "version": "2025.10.0",
+      "bomRef": "pkg:docker/gcr.io/distroless/base@sha256:0dd2f0f15c9f8abfba6a0ce0d7d6a24e2e1071c977733f6e77cbe51b87f15ad9"
+    }
+  },
+  "components": [
+    {
+      "type": "application",
+      "bomRef": "pkg:golang/github.com/stellaops/sample-service@v1.4.0",
+      "name": "github.com/stellaops/sample-service",
+      "version": "v1.4.0",
+      "properties": [
+        {
+          "name": "stellaops.entrypoint",
+          "value": "/workspace/service"
+        }
+      ]
+    },
+    {
+      "type": "library",
+      "bomRef": "pkg:golang/std@go1.22.5",
+      "name": "golang-stdlib",
+      "version": "go1.22.5"
+    }
+  ]
+}
--- a/samples/scanner/images/distroless-go/usage.cdx.json
+++ b/samples/scanner/images/distroless-go/usage.cdx.json
@@ -0,0 +1,22 @@
+{
+  "bomFormat": "CycloneDX",
+  "specVersion": "1.5",
+  "version": 1,
+  "metadata": {
+    "timestamp": "2025-10-19T00:00:00Z",
+    "component": {
+      "type": "container",
+      "name": "distroless-go",
+      "version": "2025.10.0",
+      "bomRef": "pkg:docker/gcr.io/distroless/base@sha256:0dd2f0f15c9f8abfba6a0ce0d7d6a24e2e1071c977733f6e77cbe51b87f15ad9"
+    }
+  },
+  "components": [
+    {
+      "type": "application",
+      "bomRef": "pkg:golang/github.com/stellaops/sample-service@v1.4.0",
+      "name": "github.com/stellaops/sample-service",
+      "version": "v1.4.0"
+    }
+  ]
+}
--- a/samples/scanner/images/dotnet-aot/README.md
+++ b/samples/scanner/images/dotnet-aot/README.md
@@ -0,0 +1,3 @@
+# .NET AOT Sample
+
+An ahead-of-time compiled worker showcasing how native .NET deployments appear in SBOM outputs. The BOM Index ties NuGet packages back to the generated `deps.json` evidence.
--- a/samples/scanner/images/dotnet-aot/bom-index.json
+++ b/samples/scanner/images/dotnet-aot/bom-index.json
@@ -0,0 +1,52 @@
+{
+  "schema": "stellaops/bom-index@1",
+  "image": {
+    "repository": "registry.stella-ops.org/sample/dotnet-aot",
+    "digest": "sha256:5be6f3ad9d2b1e4fcb4c6f40d9c664fca97f5b4d9ccb8e1d8f970e8b2bce1123",
+    "tag": "1.0.0"
+  },
+  "generatedAt": "2025-10-19T00:00:00Z",
+  "generator": "stellaops/scanner@10.0.0-preview1",
+  "components": [
+    {
+      "purl": "pkg:nuget/Sample.Worker@1.0.0",
+      "layerDigest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+      "usage": ["inventory", "runtime"],
+      "licenses": ["MIT"],
+      "evidence": {
+        "kind": "deps-json",
+        "path": "/app/Sample.Worker.deps.json"
+      }
+    },
+    {
+      "purl": "pkg:nuget/Microsoft.Extensions.Hosting@8.0.0",
+      "layerDigest": "sha256:bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+      "usage": ["inventory"],
+      "licenses": ["MIT"],
+      "evidence": {
+        "kind": "deps-json",
+        "path": "/app/Sample.Worker.deps.json"
+      }
+    },
+    {
+      "purl": "pkg:nuget/System.Text.Json@8.0.0",
+      "layerDigest": "sha256:cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
+      "usage": ["inventory", "runtime"],
+      "licenses": ["MIT"],
+      "evidence": {
+        "kind": "deps-json",
+        "path": "/app/Sample.Worker.deps.json"
+      }
+    },
+    {
+      "purl": "pkg:nuget/Microsoft.NETCore.App.Runtime.AOT.win-x64.Cross@8.0.0",
+      "layerDigest": "sha256:dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd",
+      "usage": ["inventory"],
+      "licenses": ["MIT"],
+      "evidence": {
+        "kind": "deps-json",
+        "path": "/app/Sample.Worker.deps.json"
+      }
+    }
+  ]
+}
--- a/samples/scanner/images/dotnet-aot/inventory.cdx.json
+++ b/samples/scanner/images/dotnet-aot/inventory.cdx.json
@@ -0,0 +1,40 @@
+{
+  "bomFormat": "CycloneDX",
+  "specVersion": "1.5",
+  "version": 1,
+  "metadata": {
+    "timestamp": "2025-10-19T00:00:00Z",
+    "component": {
+      "type": "container",
+      "name": "dotnet-aot",
+      "version": "8.0.0",
+      "bomRef": "pkg:docker/stellaops/sample-dotnet-aot@sha256:5be6f3ad9d2b1e4fcb4c6f40d9c664fca97f5b4d9ccb8e1d8f970e8b2bce1123"
+    }
+  },
+  "components": [
+    {
+      "type": "application",
+      "bomRef": "pkg:nuget/Sample.Worker@1.0.0",
+      "name": "Sample.Worker",
+      "version": "1.0.0"
+    },
+    {
+      "type": "library",
+      "bomRef": "pkg:nuget/Microsoft.Extensions.Hosting@8.0.0",
+      "name": "Microsoft.Extensions.Hosting",
+      "version": "8.0.0"
+    },
+    {
+      "type": "library",
+      "bomRef": "pkg:nuget/System.Text.Json@8.0.0",
+      "name": "System.Text.Json",
+      "version": "8.0.0"
+    },
+    {
+      "type": "library",
+      "bomRef": "pkg:nuget/Microsoft.NETCore.App.Runtime.AOT.win-x64.Cross@8.0.0",
+      "name": "NativeAotRuntime",
+      "version": "8.0.0"
+    }
+  ]
+}
--- a/samples/scanner/images/dotnet-aot/usage.cdx.json
+++ b/samples/scanner/images/dotnet-aot/usage.cdx.json
@@ -0,0 +1,28 @@
+{
+  "bomFormat": "CycloneDX",
+  "specVersion": "1.5",
+  "version": 1,
+  "metadata": {
+    "timestamp": "2025-10-19T00:00:00Z",
+    "component": {
+      "type": "container",
+      "name": "dotnet-aot",
+      "version": "8.0.0",
+      "bomRef": "pkg:docker/stellaops/sample-dotnet-aot@sha256:5be6f3ad9d2b1e4fcb4c6f40d9c664fca97f5b4d9ccb8e1d8f970e8b2bce1123"
+    }
+  },
+  "components": [
+    {
+      "type": "application",
+      "bomRef": "pkg:nuget/Sample.Worker@1.0.0",
+      "name": "Sample.Worker",
+      "version": "1.0.0"
+    },
+    {
+      "type": "library",
+      "bomRef": "pkg:nuget/System.Text.Json@8.0.0",
+      "name": "System.Text.Json",
+      "version": "8.0.0"
+    }
+  ]
+}
--- a/samples/scanner/images/nginx/README.md
+++ b/samples/scanner/images/nginx/README.md
@@ -0,0 +1,3 @@
+# Nginx Inventory Sample
+
+CycloneDX inventory, usage, and BOM Index fixtures for the `docker.io/library/nginx:1.25.4` image. The SBOMs capture base Alpine packages and the BOM Index links each component to the layer that introduced it.
--- a/samples/scanner/images/nginx/bom-index.json
+++ b/samples/scanner/images/nginx/bom-index.json
@@ -0,0 +1,52 @@
+{
+  "schema": "stellaops/bom-index@1",
+  "image": {
+    "repository": "docker.io/library/nginx",
+    "digest": "sha256:8f47d7c6b538c0d9533b78913cba3d5e671e7c4b4e7c6a2bb9a1a1c4d4f8e123",
+    "tag": "1.25.4"
+  },
+  "generatedAt": "2025-10-19T00:00:00Z",
+  "generator": "stellaops/scanner@10.0.0-preview1",
+  "components": [
+    {
+      "purl": "pkg:apk/alpine/nginx@1.25.4-r1?arch=x86_64",
+      "layerDigest": "sha256:1111111111111111111111111111111111111111111111111111111111111111",
+      "usage": ["inventory", "runtime"],
+      "licenses": ["BSD-2-Clause"],
+      "evidence": {
+        "kind": "apk-database",
+        "path": "/lib/apk/db/installed"
+      }
+    },
+    {
+      "purl": "pkg:apk/alpine/openssl@3.2.2-r0?arch=x86_64",
+      "layerDigest": "sha256:2222222222222222222222222222222222222222222222222222222222222222",
+      "usage": ["inventory", "runtime"],
+      "licenses": ["Apache-2.0"],
+      "evidence": {
+        "kind": "apk-database",
+        "path": "/lib/apk/db/installed"
+      }
+    },
+    {
+      "purl": "pkg:apk/alpine/pcre2@10.42-r1?arch=x86_64",
+      "layerDigest": "sha256:3333333333333333333333333333333333333333333333333333333333333333",
+      "usage": ["inventory"],
+      "licenses": ["BSD-3-Clause"],
+      "evidence": {
+        "kind": "apk-database",
+        "path": "/lib/apk/db/installed"
+      }
+    },
+    {
+      "purl": "pkg:apk/alpine/zlib@1.3-r2?arch=x86_64",
+      "layerDigest": "sha256:4444444444444444444444444444444444444444444444444444444444444444",
+      "usage": ["inventory"],
+      "licenses": ["Zlib"],
+      "evidence": {
+        "kind": "apk-database",
+        "path": "/lib/apk/db/installed"
+      }
+    }
+  ]
+}
--- a/samples/scanner/images/nginx/inventory.cdx.json
+++ b/samples/scanner/images/nginx/inventory.cdx.json
@@ -0,0 +1,53 @@
+{
+  "bomFormat": "CycloneDX",
+  "specVersion": "1.5",
+  "version": 1,
+  "metadata": {
+    "timestamp": "2025-10-19T00:00:00Z",
+    "component": {
+      "type": "container",
+      "name": "nginx",
+      "version": "1.25.4",
+      "bomRef": "pkg:docker/library/nginx@sha256:8f47d7c6b538c0d9533b78913cba3d5e671e7c4b4e7c6a2bb9a1a1c4d4f8e123"
+    },
+    "tools": [
+      {
+        "name": "StellaOps Scanner",
+        "version": "10.0.0-preview1"
+      }
+    ]
+  },
+  "components": [
+    {
+      "type": "application",
+      "bomRef": "pkg:apk/alpine/nginx@1.25.4-r1?arch=x86_64",
+      "name": "nginx",
+      "version": "1.25.4-r1",
+      "licenses": [
+        {
+          "license": {
+            "id": "2BSD"
+          }
+        }
+      ]
+    },
+    {
+      "type": "library",
+      "bomRef": "pkg:apk/alpine/openssl@3.2.2-r0?arch=x86_64",
+      "name": "openssl",
+      "version": "3.2.2-r0"
+    },
+    {
+      "type": "library",
+      "bomRef": "pkg:apk/alpine/pcre2@10.42-r1?arch=x86_64",
+      "name": "pcre2",
+      "version": "10.42-r1"
+    },
+    {
+      "type": "library",
+      "bomRef": "pkg:apk/alpine/zlib@1.3-r2?arch=x86_64",
+      "name": "zlib",
+      "version": "1.3-r2"
+    }
+  ]
+}
--- a/samples/scanner/images/nginx/usage.cdx.json
+++ b/samples/scanner/images/nginx/usage.cdx.json
@@ -0,0 +1,28 @@
+{
+  "bomFormat": "CycloneDX",
+  "specVersion": "1.5",
+  "version": 1,
+  "metadata": {
+    "timestamp": "2025-10-19T00:00:00Z",
+    "component": {
+      "type": "container",
+      "name": "nginx",
+      "version": "1.25.4",
+      "bomRef": "pkg:docker/library/nginx@sha256:8f47d7c6b538c0d9533b78913cba3d5e671e7c4b4e7c6a2bb9a1a1c4d4f8e123"
+    }
+  },
+  "components": [
+    {
+      "type": "application",
+      "bomRef": "pkg:apk/alpine/nginx@1.25.4-r1?arch=x86_64",
+      "name": "nginx",
+      "version": "1.25.4-r1"
+    },
+    {
+      "type": "library",
+      "bomRef": "pkg:apk/alpine/openssl@3.2.2-r0?arch=x86_64",
+      "name": "openssl",
+      "version": "3.2.2-r0"
+    }
+  ]
+}
--- a/samples/scanner/images/npm-monorepo/README.md
+++ b/samples/scanner/images/npm-monorepo/README.md
@@ -0,0 +1,3 @@
+# NPM Monorepo Sample
+
+Mirrors the fixture under `samples/runtime/npm-monorepo`. The SBOMs highlight the workspace packages plus transitive dependencies, and the BOM Index pins evidence to individual `package.json` files.
--- a/samples/scanner/images/npm-monorepo/bom-index.json
+++ b/samples/scanner/images/npm-monorepo/bom-index.json
@@ -0,0 +1,52 @@
+{
+  "schema": "stellaops/bom-index@1",
+  "image": {
+    "repository": "registry.stella-ops.org/samples/npm-monorepo",
+    "digest": "sha256:1cf2ab9d373086ed5bd1a8f4aa6f491f8844bbb0d6be8df449c16ad6c8fa7c55",
+    "tag": "2025.10.0"
+  },
+  "generatedAt": "2025-10-19T00:00:00Z",
+  "generator": "stellaops/scanner@10.0.0-preview1",
+  "components": [
+    {
+      "purl": "pkg:npm/%40stella/web@1.5.3",
+      "layerDigest": "sha256:1212121212121212121212121212121212121212121212121212121212121212",
+      "usage": ["inventory", "runtime"],
+      "licenses": ["MIT"],
+      "evidence": {
+        "kind": "package-json",
+        "path": "node_modules/@stella/web/package.json"
+      }
+    },
+    {
+      "purl": "pkg:npm/%40stella/core@2.0.0",
+      "layerDigest": "sha256:1313131313131313131313131313131313131313131313131313131313131313",
+      "usage": ["inventory", "runtime"],
+      "licenses": ["Apache-2.0"],
+      "evidence": {
+        "kind": "package-json",
+        "path": "node_modules/@stella/core/package.json"
+      }
+    },
+    {
+      "purl": "pkg:npm/lodash@4.17.21",
+      "layerDigest": "sha256:1414141414141414141414141414141414141414141414141414141414141414",
+      "usage": ["inventory"],
+      "licenses": ["MIT"],
+      "evidence": {
+        "kind": "package-json",
+        "path": "node_modules/lodash/package.json"
+      }
+    },
+    {
+      "purl": "pkg:npm/rxjs@7.8.1",
+      "layerDigest": "sha256:1515151515151515151515151515151515151515151515151515151515151515",
+      "usage": ["inventory", "runtime"],
+      "licenses": ["Apache-2.0"],
+      "evidence": {
+        "kind": "package-json",
+        "path": "node_modules/rxjs/package.json"
+      }
+    }
+  ]
+}
--- a/samples/scanner/images/npm-monorepo/inventory.cdx.json
+++ b/samples/scanner/images/npm-monorepo/inventory.cdx.json
@@ -0,0 +1,40 @@
+{
+  "bomFormat": "CycloneDX",
+  "specVersion": "1.5",
+  "version": 1,
+  "metadata": {
+    "timestamp": "2025-10-19T00:00:00Z",
+    "component": {
+      "type": "container",
+      "name": "npm-monorepo",
+      "version": "2025.10.0",
+      "bomRef": "pkg:docker/registry.stella-ops.org/samples/npm-monorepo@sha256:1cf2ab9d373086ed5bd1a8f4aa6f491f8844bbb0d6be8df449c16ad6c8fa7c55"
+    }
+  },
+  "components": [
+    {
+      "type": "application",
+      "bomRef": "pkg:npm/%40stella/core@2.0.0",
+      "name": "@stella/core",
+      "version": "2.0.0"
+    },
+    {
+      "type": "application",
+      "bomRef": "pkg:npm/%40stella/web@1.5.3",
+      "name": "@stella/web",
+      "version": "1.5.3"
+    },
+    {
+      "type": "library",
+      "bomRef": "pkg:npm/lodash@4.17.21",
+      "name": "lodash",
+      "version": "4.17.21"
+    },
+    {
+      "type": "library",
+      "bomRef": "pkg:npm/rxjs@7.8.1",
+      "name": "rxjs",
+      "version": "7.8.1"
+    }
+  ]
+}
--- a/samples/scanner/images/npm-monorepo/usage.cdx.json
+++ b/samples/scanner/images/npm-monorepo/usage.cdx.json
@@ -0,0 +1,34 @@
+{
+  "bomFormat": "CycloneDX",
+  "specVersion": "1.5",
+  "version": 1,
+  "metadata": {
+    "timestamp": "2025-10-19T00:00:00Z",
+    "component": {
+      "type": "container",
+      "name": "npm-monorepo",
+      "version": "2025.10.0",
+      "bomRef": "pkg:docker/registry.stella-ops.org/samples/npm-monorepo@sha256:1cf2ab9d373086ed5bd1a8f4aa6f491f8844bbb0d6be8df449c16ad6c8fa7c55"
+    }
+  },
+  "components": [
+    {
+      "type": "application",
+      "bomRef": "pkg:npm/%40stella/web@1.5.3",
+      "name": "@stella/web",
+      "version": "1.5.3"
+    },
+    {
+      "type": "application",
+      "bomRef": "pkg:npm/%40stella/core@2.0.0",
+      "name": "@stella/core",
+      "version": "2.0.0"
+    },
+    {
+      "type": "library",
+      "bomRef": "pkg:npm/rxjs@7.8.1",
+      "name": "rxjs",
+      "version": "7.8.1"
+    }
+  ]
+}
--- a/samples/scanner/images/python-venv/README.md
+++ b/samples/scanner/images/python-venv/README.md
@@ -0,0 +1,3 @@
+# Python Virtualenv Sample
+
+Pairs with the runtime fixture under `samples/runtime/python-venv`. The SBOMs highlight how requests pulls in urllib3 and certifi, and the BOM Index records the `*.dist-info/METADATA` evidence paths used by the Python analyzer.
--- a/samples/scanner/images/python-venv/bom-index.json
+++ b/samples/scanner/images/python-venv/bom-index.json
@@ -0,0 +1,42 @@
+{
+  "schema": "stellaops/bom-index@1",
+  "image": {
+    "repository": "docker.io/library/python",
+    "digest": "sha256:dbed08b7d9675c2be627bbecac182a04c36d3f4ffd542c4fba7c7a850a6578dc",
+    "tag": "3.12-slim"
+  },
+  "generatedAt": "2025-10-19T00:00:00Z",
+  "generator": "stellaops/scanner@10.0.0-preview1",
+  "components": [
+    {
+      "purl": "pkg:pypi/requests@2.32.0",
+      "layerDigest": "sha256:eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
+      "usage": ["inventory", "runtime"],
+      "licenses": ["Apache-2.0"],
+      "evidence": {
+        "kind": "dist-info",
+        "path": "lib/python3.11/site-packages/requests-2.32.0.dist-info/METADATA"
+      }
+    },
+    {
+      "purl": "pkg:pypi/urllib3@2.2.1",
+      "layerDigest": "sha256:ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
+      "usage": ["inventory", "runtime"],
+      "licenses": ["MIT"],
+      "evidence": {
+        "kind": "dist-info",
+        "path": "lib/python3.11/site-packages/urllib3-2.2.1.dist-info/METADATA"
+      }
+    },
+    {
+      "purl": "pkg:pypi/certifi@2024.6.2",
+      "layerDigest": "sha256:0000000000000000000000000000000000000000000000000000000000000000",
+      "usage": ["inventory"],
+      "licenses": ["MPL-2.0"],
+      "evidence": {
+        "kind": "dist-info",
+        "path": "lib/python3.11/site-packages/certifi-2024.6.2.dist-info/METADATA"
+      }
+    }
+  ]
+}
--- a/samples/scanner/images/python-venv/inventory.cdx.json
+++ b/samples/scanner/images/python-venv/inventory.cdx.json
@@ -0,0 +1,34 @@
+{
+  "bomFormat": "CycloneDX",
+  "specVersion": "1.5",
+  "version": 1,
+  "metadata": {
+    "timestamp": "2025-10-19T00:00:00Z",
+    "component": {
+      "type": "container",
+      "name": "python-venv",
+      "version": "3.12-slim",
+      "bomRef": "pkg:docker/library/python@sha256:dbed08b7d9675c2be627bbecac182a04c36d3f4ffd542c4fba7c7a850a6578dc"
+    }
+  },
+  "components": [
+    {
+      "type": "application",
+      "bomRef": "pkg:pypi/requests@2.32.0",
+      "name": "requests",
+      "version": "2.32.0"
+    },
+    {
+      "type": "library",
+      "bomRef": "pkg:pypi/urllib3@2.2.1",
+      "name": "urllib3",
+      "version": "2.2.1"
+    },
+    {
+      "type": "library",
+      "bomRef": "pkg:pypi/certifi@2024.6.2",
+      "name": "certifi",
+      "version": "2024.6.2"
+    }
+  ]
+}
--- a/samples/scanner/images/python-venv/usage.cdx.json
+++ b/samples/scanner/images/python-venv/usage.cdx.json
@@ -0,0 +1,28 @@
+{
+  "bomFormat": "CycloneDX",
+  "specVersion": "1.5",
+  "version": 1,
+  "metadata": {
+    "timestamp": "2025-10-19T00:00:00Z",
+    "component": {
+      "type": "container",
+      "name": "python-venv",
+      "version": "3.12-slim",
+      "bomRef": "pkg:docker/library/python@sha256:dbed08b7d9675c2be627bbecac182a04c36d3f4ffd542c4fba7c7a850a6578dc"
+    }
+  },
+  "components": [
+    {
+      "type": "application",
+      "bomRef": "pkg:pypi/requests@2.32.0",
+      "name": "requests",
+      "version": "2.32.0"
+    },
+    {
+      "type": "library",
+      "bomRef": "pkg:pypi/urllib3@2.2.1",
+      "name": "urllib3",
+      "version": "2.2.1"
+    }
+  ]
+}