NSE Hook Decision Proposal v1

Source schema: doc/schemas/nse-hook-decision.v1.schema.json

Raw producer proposal bound to one exact NSE offer. Admission remains host-owned.

Governing Basis

• doc/project/40-proposals/085-operator-sovereign-extensibility-and-experiment-packages.md

Project Lineage

Fields

Field	Required	Shape	Description
schema	yes	const: nse-hook-decision.v1
schema/v	yes	const: 1
invocation/ref	yes	string
hook/id	yes	ref: #/$defs/hook-id
hook/v	yes	const: 1
offer/digest	yes	ref: #/$defs/digest
producer/ref	yes	ref: #/$defs/ref
producer/digest	yes	ref: #/$defs/digest
outcome	yes	unspecified
annotations	no	ref: #/$defs/annotations

Definitions

Definition	Shape	Description
hook-id	enum: select-llm-model, assemble-prompt, select-output-schema, select-repair-profile, score-candidate, select-turn-order, weigh-bid, resolve-tie, admit-participant, choose-next-step, shape-fanout, classify-effect-risk
select-llm-decision	object
policy-hook-decision	object
select-outcome	object
order-outcome	object
narrow-outcome	object
restrict-outcome	object
raise-risk-outcome	object
select-profile-outcome	object
defer-outcome	object
refs	array
limits	object
digest	string
ref	string
text	string
reason	object
use-runtime	object
annotations	object

Conditional Rules

Rule 1

When:

{
  "properties": {
    "hook/id": {
      "const": "select-llm-model"
    }
  },
  "required": [
    "hook/id"
  ]
}

Then:

{
  "properties": {
    "outcome": {
      "$ref": "#/$defs/select-llm-decision"
    }
  }
}

Field Semantics

schema

• Required: yes
• Shape: const: nse-hook-decision.v1

schema/v

• Required: yes
• Shape: const: 1

invocation/ref

• Required: yes
• Shape: string

hook/id

• Required: yes
• Shape: ref: #/$defs/hook-id

hook/v

• Required: yes
• Shape: const: 1

offer/digest

• Required: yes
• Shape: ref: #/$defs/digest

producer/ref

• Required: yes
• Shape: ref: #/$defs/ref

producer/digest

• Required: yes
• Shape: ref: #/$defs/digest

outcome

• Required: yes
• Shape: unspecified

annotations

• Required: no
• Shape: ref: #/$defs/annotations

Definition Semantics

$defs.hook-id

• Shape: enum: select-llm-model, assemble-prompt, select-output-schema, select-repair-profile, score-candidate, select-turn-order, weigh-bid, resolve-tie, admit-participant, choose-next-step, shape-fanout, classify-effect-risk

$defs.select-llm-decision

• Shape: object

$defs.policy-hook-decision

• Shape: object

$defs.select-outcome

• Shape: object

$defs.order-outcome

• Shape: object

$defs.narrow-outcome

• Shape: object

$defs.restrict-outcome

• Shape: object

$defs.raise-risk-outcome

• Shape: object

$defs.select-profile-outcome

• Shape: object

$defs.defer-outcome

• Shape: object

$defs.refs

• Shape: array

$defs.limits

• Shape: object

$defs.digest

• Shape: string

$defs.ref

• Shape: string

$defs.text

• Shape: string

$defs.reason

• Shape: object

$defs.use-runtime

• Shape: object

$defs.annotations

• Shape: object