Update native operations, consumer migration, and version checks
This commit is contained in:
@@ -9,9 +9,8 @@ logical-file discovery is owned by [Published JSON Output](json-output.md).
|
||||
|
||||
## Identity And Discovery
|
||||
|
||||
When enabled, the JSON bundle contains `evidence-context.json` and an
|
||||
`index.json` `evidence_context` descriptor with the same six fields as other
|
||||
pipeline-wide artifact descriptors.
|
||||
When enabled and available, the JSON bundle contains `evidence-context.json`
|
||||
at that documented logical path; no index descriptor is required.
|
||||
|
||||
| Property | Value |
|
||||
| --- | --- |
|
||||
@@ -22,16 +21,16 @@ pipeline-wide artifact descriptors.
|
||||
| Schema version | `v1` |
|
||||
| Logical file | `evidence-context.json` |
|
||||
|
||||
Consumers must discover the file from the descriptor, verify all six descriptor
|
||||
fields, and decode only a supported schema version. The descriptor is optional:
|
||||
its absence means evidence publication was not enabled for that bundle.
|
||||
Consumers select this path from the configured output policy and decode the
|
||||
supported payload contract below. Disabled or unavailable evidence is not
|
||||
published. The identity and JSON shape above remain unchanged.
|
||||
|
||||
## Payload
|
||||
|
||||
The v1 payload is a top-level JSON array of generic source units. There is no
|
||||
wrapper, source-level metadata, context grouping, lane identifier, or evidence
|
||||
reference in the payload. An enabled configuration with no contributing
|
||||
accepted evidence publishes `[]`.
|
||||
evidence publishes `[]`.
|
||||
|
||||
```json
|
||||
[
|
||||
@@ -73,14 +72,16 @@ annotations or reshape source-owned metadata.
|
||||
## Selection And Citations
|
||||
|
||||
The framework obtains direct source references only through typed evidence
|
||||
projections of accepted normalized artifacts in the configured lane allowlist.
|
||||
projections of published normalized artifacts in the configured lane allowlist,
|
||||
including supported fallbacks and reused results.
|
||||
It validates each reference against the current source document, expands its
|
||||
range by `window_units` source-unit positions on each side, clamps at document
|
||||
boundaries, and takes the union of all expanded ranges. The output contains
|
||||
each selected source unit once in source-document position order, regardless
|
||||
of numeric unit IDs. Repeated references, overlapping windows, and citations
|
||||
from multiple lanes do not duplicate a unit. Rejected, failed, absent,
|
||||
inactive, and unselected lanes contribute nothing.
|
||||
from multiple lanes do not duplicate a unit. Failed, absent, inactive, and
|
||||
unselected lane results contribute nothing. Evidence from a supported fallback
|
||||
does not imply ordinary semantic approval; the completion report qualifies the run.
|
||||
|
||||
Normalized lane artifacts remain authoritative for citations and for which lane
|
||||
cited a range. The excerpt has no lane attribution and must not be used to
|
||||
@@ -94,10 +95,10 @@ the framework does not truncate the excerpt to meet an arbitrary size limit.
|
||||
|
||||
## Consumer Responsibilities And Data Handling
|
||||
|
||||
The artifact is additive to the JSON bundle and is not a lane payload,
|
||||
normalized-output count, checkpoint, or generated reference. Consumers that
|
||||
do not need it must tolerate an absent descriptor. Consumers that do use it
|
||||
should validate the descriptor and payload before use, retain the artifact with
|
||||
The artifact is additive to the JSON bundle and is not a lane payload or
|
||||
generated reference. It counts as a deliverable when published, not as a lane.
|
||||
Consumers that do not need it can ignore it. Consumers that do use it should
|
||||
validate the payload before use, retain the artifact with
|
||||
its schema identity when needed for a run record, and read citations from the
|
||||
corresponding normalized lane artifacts.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user