Component Trace Manifest V1¶
Source schema: doc/schemas/component-trace-manifest.v1.schema.json
Rebuildable bounded inventory and completeness projection for an offline trace session.
Governing Basis¶
Project Lineage¶
Fields¶
| Field | Required | Shape | Description |
|---|---|---|---|
schema |
yes |
const: component-trace-manifest.v1 |
|
schema/v |
yes |
const: 1 |
|
recording/ref |
yes |
ref: #/$defs/ref |
|
capture/session-ref |
yes |
ref: #/$defs/ref |
|
node/ref |
yes |
ref: #/$defs/ref |
|
observation/generation |
yes |
ref: #/$defs/ref |
|
start/cursor |
yes |
ref: #/$defs/cursor |
|
durable/cursor |
yes |
ref: #/$defs/cursor |
|
final/cursor |
no |
ref: #/$defs/cursor |
|
started/at |
yes |
ref: #/$defs/timestamp |
|
ended/at |
no |
ref: #/$defs/timestamp |
|
policy/ref |
yes |
ref: #/$defs/ref |
|
policy/digest |
yes |
ref: #/$defs/digest |
|
redaction/digests |
yes |
array | |
segments |
yes |
ref: #/$defs/inventory |
|
schemas |
yes |
ref: #/$defs/inventory |
|
contexts |
yes |
ref: #/$defs/inventory |
|
artifacts |
yes |
ref: #/$defs/inventory |
|
boundary/coverage |
yes |
array | |
boundary/exclusions |
yes |
array | |
counters |
yes |
ref: #/$defs/counters |
|
completeness |
yes |
enum: complete, incomplete, aborted |
|
reason/code |
yes |
string | |
recorder/version |
yes |
ref: #/$defs/ref |
|
format/profile |
yes |
ref: #/$defs/ref |
Definitions¶
| Definition | Shape | Description |
|---|---|---|
ref |
string | |
digest |
string | |
timestamp |
string | |
cursor |
integer | |
inventory-item |
object | |
inventory |
array | |
counters |
object |
Conditional Rules¶
Rule 1¶
When:
{
"properties": {
"completeness": {
"const": "complete"
}
},
"required": [
"completeness"
]
}
Then:
{
"required": [
"final/cursor",
"ended/at"
],
"properties": {
"counters": {
"properties": {
"drops": {
"const": 0
},
"gaps": {
"const": 0
}
}
}
}
}
Field Semantics¶
schema¶
- Required:
yes - Shape: const:
component-trace-manifest.v1
schema/v¶
- Required:
yes - Shape: const:
1
recording/ref¶
- Required:
yes - Shape: ref:
#/$defs/ref
capture/session-ref¶
- Required:
yes - Shape: ref:
#/$defs/ref
node/ref¶
- Required:
yes - Shape: ref:
#/$defs/ref
observation/generation¶
- Required:
yes - Shape: ref:
#/$defs/ref
start/cursor¶
- Required:
yes - Shape: ref:
#/$defs/cursor
durable/cursor¶
- Required:
yes - Shape: ref:
#/$defs/cursor
final/cursor¶
- Required:
no - Shape: ref:
#/$defs/cursor
started/at¶
- Required:
yes - Shape: ref:
#/$defs/timestamp
ended/at¶
- Required:
no - Shape: ref:
#/$defs/timestamp
policy/ref¶
- Required:
yes - Shape: ref:
#/$defs/ref
policy/digest¶
- Required:
yes - Shape: ref:
#/$defs/digest
redaction/digests¶
- Required:
yes - Shape: array
segments¶
- Required:
yes - Shape: ref:
#/$defs/inventory
schemas¶
- Required:
yes - Shape: ref:
#/$defs/inventory
contexts¶
- Required:
yes - Shape: ref:
#/$defs/inventory
artifacts¶
- Required:
yes - Shape: ref:
#/$defs/inventory
boundary/coverage¶
- Required:
yes - Shape: array
boundary/exclusions¶
- Required:
yes - Shape: array
counters¶
- Required:
yes - Shape: ref:
#/$defs/counters
completeness¶
- Required:
yes - Shape: enum:
complete,incomplete,aborted
reason/code¶
- Required:
yes - Shape: string
recorder/version¶
- Required:
yes - Shape: ref:
#/$defs/ref
format/profile¶
- Required:
yes - Shape: ref:
#/$defs/ref
Definition Semantics¶
$defs.ref¶
- Shape: string
$defs.digest¶
- Shape: string
$defs.timestamp¶
- Shape: string
$defs.cursor¶
- Shape: integer
$defs.inventory-item¶
- Shape: object
$defs.inventory¶
- Shape: array
$defs.counters¶
- Shape: object