Operator Task HIL Request v1¶
Source schema: doc/schemas/operator-task-hil-request.v1.schema.json
Host-issued request for an operator decision on one step, requiring HIL, of one admitted run of a stored experiment plan. It carries the decision material: the stamped step with its derived effect class and source, the exact files and content digests of a patch, and the rollback that would apply. Model prose is never part of it. Its ref is the content address of the run ref and step id, so each step of each run has exactly one request and an approval never carries over to another run of the same plan; delivery passes the P085 attention gate, which may deliver, group, defer or deny it but never approves. The request expires; an expired request cannot be approved.
Governing Basis¶
Project Lineage¶
Fields¶
| Field | Required | Shape | Description |
|---|---|---|---|
schema |
yes |
const: operator-task-hil-request.v1 |
|
schema/v |
yes |
const: 1 |
|
request/ref |
yes |
ref: operator-task-common.v1.schema.json#/$defs/ref |
|
run/ref |
yes |
unspecified | |
plan/ref |
yes |
ref: operator-task-common.v1.schema.json#/$defs/ref |
|
binding/ref |
yes |
ref: operator-task-common.v1.schema.json#/$defs/ref |
|
task-profile/digest |
yes |
ref: operator-task-common.v1.schema.json#/$defs/digest |
|
local-binding/digest |
yes |
ref: operator-task-common.v1.schema.json#/$defs/digest |
|
activation/generation |
yes |
ref: operator-task-common.v1.schema.json#/$defs/counter |
|
step |
yes |
unspecified | The plan step exactly as the plan stamps it; only a step that requires HIL has a request. |
patch/files |
no |
array | For a patch step: every file of the patch, with the digest and size of the complete resulting content of each written file. |
rollback/mode |
yes |
enum: recreate-prepared-system, exact-rollback-profile |
|
requested-at |
yes |
ref: operator-task-common.v1.schema.json#/$defs/timestamp |
|
expires-at |
yes |
ref: operator-task-common.v1.schema.json#/$defs/timestamp |
Definitions¶
| Definition | Shape | Description |
|---|---|---|
patchFile |
object | |
| ## Field Semantics |
schema¶
- Required:
yes - Shape: const:
operator-task-hil-request.v1
schema/v¶
- Required:
yes - Shape: const:
1
request/ref¶
- Required:
yes - Shape: ref:
operator-task-common.v1.schema.json#/$defs/ref
run/ref¶
- Required:
yes - Shape: unspecified
plan/ref¶
- Required:
yes - Shape: ref:
operator-task-common.v1.schema.json#/$defs/ref
binding/ref¶
- Required:
yes - Shape: ref:
operator-task-common.v1.schema.json#/$defs/ref
task-profile/digest¶
- Required:
yes - Shape: ref:
operator-task-common.v1.schema.json#/$defs/digest
local-binding/digest¶
- Required:
yes - Shape: ref:
operator-task-common.v1.schema.json#/$defs/digest
activation/generation¶
- Required:
yes - Shape: ref:
operator-task-common.v1.schema.json#/$defs/counter
step¶
- Required:
yes - Shape: unspecified
The plan step exactly as the plan stamps it; only a step that requires HIL has a request.
patch/files¶
- Required:
no - Shape: array
For a patch step: every file of the patch, with the digest and size of the complete resulting content of each written file.
rollback/mode¶
- Required:
yes - Shape: enum:
recreate-prepared-system,exact-rollback-profile
requested-at¶
- Required:
yes - Shape: ref:
operator-task-common.v1.schema.json#/$defs/timestamp
expires-at¶
- Required:
yes - Shape: ref:
operator-task-common.v1.schema.json#/$defs/timestamp
Definition Semantics¶
$defs.patchFile¶
- Shape: object