Artifact Source v1¶
Source schema: doc/schemas/artifact-source.v1.schema.json
Immutable operator-owned declaration for one read-only artifact source generation. Locators contain references or public URLs, never credential values or executable paths.
Governing Basis¶
Project Lineage¶
Fields¶
| Field | Required | Shape | Description |
|---|---|---|---|
schema |
yes |
const: artifact-source.v1 |
|
schema/v |
yes |
const: 1 |
|
source/id |
yes |
string | |
source/generation |
yes |
integer | |
connector/id |
yes |
string | |
locator |
yes |
ref: #/$defs/locator |
|
credential/ref |
no |
ref: #/$defs/ref |
|
trigger/modes |
yes |
array | |
allow |
yes |
ref: #/$defs/allow |
|
extraction |
yes |
ref: #/$defs/extraction |
|
admission/mode |
yes |
enum: stage, admit-known |
|
admission/table-ref |
no |
ref: #/$defs/ref |
|
limits |
yes |
ref: #/$defs/limits |
|
freshness/max-staleness-seconds |
yes |
integer | |
consumption/mode |
yes |
const: read-only |
|
checkpoint/policy |
no |
enum: none, generation-bound |
|
operator/binding-ref |
yes |
ref: #/$defs/ref |
Definitions¶
| Definition | Shape | Description |
|---|---|---|
digest |
string | |
ref |
string | |
locator |
unspecified | |
allow |
object | |
nonEmptyStringSet |
array | |
extraction |
object | |
limits |
object |
Conditional Rules¶
Rule 1¶
When:
{
"properties": {
"admission/mode": {
"const": "admit-known"
}
}
}
Then:
{
"required": [
"admission/table-ref"
]
}
Field Semantics¶
schema¶
- Required:
yes - Shape: const:
artifact-source.v1
schema/v¶
- Required:
yes - Shape: const:
1
source/id¶
- Required:
yes - Shape: string
source/generation¶
- Required:
yes - Shape: integer
connector/id¶
- Required:
yes - Shape: string
locator¶
- Required:
yes - Shape: ref:
#/$defs/locator
credential/ref¶
- Required:
no - Shape: ref:
#/$defs/ref
trigger/modes¶
- Required:
yes - Shape: array
allow¶
- Required:
yes - Shape: ref:
#/$defs/allow
extraction¶
- Required:
yes - Shape: ref:
#/$defs/extraction
admission/mode¶
- Required:
yes - Shape: enum:
stage,admit-known
admission/table-ref¶
- Required:
no - Shape: ref:
#/$defs/ref
limits¶
- Required:
yes - Shape: ref:
#/$defs/limits
freshness/max-staleness-seconds¶
- Required:
yes - Shape: integer
consumption/mode¶
- Required:
yes - Shape: const:
read-only
checkpoint/policy¶
- Required:
no - Shape: enum:
none,generation-bound
operator/binding-ref¶
- Required:
yes - Shape: ref:
#/$defs/ref
Definition Semantics¶
$defs.digest¶
- Shape: string
$defs.ref¶
- Shape: string
$defs.locator¶
- Shape: unspecified
$defs.allow¶
- Shape: object
$defs.nonEmptyStringSet¶
- Shape: array
$defs.extraction¶
- Shape: object
$defs.limits¶
- Shape: object