docs consolidation

This commit is contained in:
master
2026-01-07 10:23:21 +02:00
parent 4789027317
commit 044cf0923c
515 changed files with 5460 additions and 5292 deletions

View File

@@ -67,7 +67,7 @@ Notes:
- For empty matches, the endpoint returns empty `observations` and `linksets` with `hasMore=false`.
Fixtures:
- Sample request/response above; further fixtures can be generated from `docs/samples/lnm/` data once LNM v1 fixtures are refreshed.
- Sample request/response above; further fixtures can be generated from `docs/modules/concelier/samples/` data once LNM v1 fixtures are refreshed.
Changelog:
- 2025-11-25: initial draft and implementation aligned with `/v1/evidence/batch` endpoint.

View File

@@ -69,7 +69,7 @@ Purpose: unblock PREP-CONCELIER-VULN-29-001 by defining the request/response con
- Optional: `fix_version` when present; keep absent otherwise (no empty strings).
## Test fixtures
- Location: `docs/samples/console/console-vex-30-001.json` already includes VEX sample keyed by advisory; add Concelier response sample to `docs/samples/console/concelier-vuln-29-001.json` (to be generated alongside implementation).
- Location: `docs/modules/platform/samples/console-vex-30-001.json` already includes VEX sample keyed by advisory; add Concelier response sample to `docs/modules/platform/samples/concelier-vuln-29-001.json` (to be generated alongside implementation).
## Owners
- Concelier WebService Guild (producer)

View File

@@ -166,7 +166,7 @@ When an advisory source publishes a revised version of an advisory:
- String normalization: lowercase `source`, trim/normalize PURLs, stable sort arrays.
## Sample documents
See `docs/samples/lnm/observation-ghsa.json` and `docs/samples/lnm/linkset-ghsa.json` (added with this draft) for concrete payloads.
See `docs/modules/concelier/samples/observation-ghsa.json` and `docs/modules/concelier/samples/linkset-ghsa.json` (added with this draft) for concrete payloads.
## Approval path
1) Architecture + Concelier Core review this document.

View File

@@ -42,8 +42,8 @@ Each conflict includes `field`, `reason`, and `values` (array of `source: value`
- `provenance.hashes`: sorted list of `observationHash` values; used by replay bundles.
## Fixtures
- `docs/samples/lnm/linkset-lnm-21-002-sample.json`: two-source agreement (high confidence, no conflicts).
- `docs/samples/lnm/linkset-lnm-21-002-conflict.json`: three-source disagreement showing conflict records and confidence < 0.7.
- `docs/modules/concelier/samples/linkset-lnm-21-002-sample.json`: two-source agreement (high confidence, no conflicts).
- `docs/modules/concelier/samples/linkset-lnm-21-002-conflict.json`: three-source disagreement showing conflict records and confidence < 0.7.
All fixtures use ASCII ordering and ISO-8601 UTC timestamps and may be used as golden outputs in tests.
## Implementation checklist