Operator Task Profile Change v1¶
Source schema: doc/schemas/operator-task-profile-change.v1.schema.json
Request to review, and optionally accept, the task profile an upgraded package now pins for one binding. The host admits the supplied profile only at the package's registered digest and diffs it against the binding's accepted profile; acceptance is one action and refuses when the binding's local choices would exceed the new ceilings. A review (accept: false) is a read and carries no authority. An acceptance names the operator binding and the expected revision, which the host verifies when it commits the change, not when it computed the diff.
Governing Basis¶
Project Lineage¶
Fields¶
| Field | Required | Shape | Description |
|---|---|---|---|
schema |
yes |
const: operator-task-profile-change.v1 |
|
schema/v |
yes |
const: 1 |
|
binding/ref |
yes |
ref: operator-task-common.v1.schema.json#/$defs/ref |
|
operator/binding-ref |
no |
ref: operator-task-common.v1.schema.json#/$defs/operatorBindingRef |
|
local-binding/expected-digest |
no |
ref: operator-task-common.v1.schema.json#/$defs/digest |
The local-binding/digest of the revision this change was prepared against, as readiness or a profile-change review reported it. The host compares it with the stored binding when it commits the change and refuses a mismatch with local-binding/revision-stale. |
task-profile |
yes |
ref: operator-task-profile.v1.schema.json |
|
accept |
yes |
boolean |
Conditional Rules¶
Rule 1¶
When:
{
"properties": {
"accept": {
"const": true
}
},
"required": [
"accept"
]
}
Then:
{
"required": [
"operator/binding-ref",
"local-binding/expected-digest"
]
}
Field Semantics¶
schema¶
- Required:
yes - Shape: const:
operator-task-profile-change.v1
schema/v¶
- Required:
yes - Shape: const:
1
binding/ref¶
- Required:
yes - Shape: ref:
operator-task-common.v1.schema.json#/$defs/ref
operator/binding-ref¶
- Required:
no - Shape: ref:
operator-task-common.v1.schema.json#/$defs/operatorBindingRef
local-binding/expected-digest¶
- Required:
no - Shape: ref:
operator-task-common.v1.schema.json#/$defs/digest
The local-binding/digest of the revision this change was prepared against, as readiness or a profile-change review reported it. The host compares it with the stored binding when it commits the change and refuses a mismatch with local-binding/revision-stale.
task-profile¶
- Required:
yes - Shape: ref:
operator-task-profile.v1.schema.json
accept¶
- Required:
yes - Shape: boolean