Corpus Reasoning Experiment Review v2

Source schema: doc/schemas/corpus-reasoning-experiment-review.v2.schema.json

Governing Basis

• doc/project/30-stories/story-012-agents-share-chair-terminal.md
• doc/project/40-proposals/069-corpus.md
• doc/project/60-solutions/038-corpus/038-corpus.md
• doc/project/60-solutions/047-agent/047-agent.md

Project Lineage

Stories

• doc/project/30-stories/story-012-agents-share-chair-terminal.md

Fields

Field	Required	Shape	Description
schema/v	yes	const: 2
review/ref	yes	string
query/id	yes	string
room/id	yes	string
proposal/ref	yes	string
proposal/digest	yes	ref: #/$defs/digest
candidate-plan/ref	yes	string
candidate-plan/artifact-ref	yes	ref: #/$defs/artifact-ref
candidate-plan/digest	yes	ref: #/$defs/digest
reviewer	yes	ref: corpus-reasoning-room-policy.v1.schema.json#/$defs/room-subject
reviewer/node-id	yes	string
reviewer-turn/id	yes	string
terminal-state/digest	yes	ref: #/$defs/digest
correction-state/digest	yes	ref: #/$defs/digest
verdict	yes	enum: accept, revise, reject, request-regeneration
findings	yes	array
replacement	no	ref: #/$defs/candidate-plan-binding
correction	no	ref: #/$defs/correction
class/key	yes	enum: Public, Community, Personal
reviewed-at	yes	string
expires-at	yes	string
idempotency/key	yes	string
signature	yes	ref: #/$defs/signature

Definitions

Definition	Shape	Description
digest	string
artifact-ref	string
candidate-plan-binding	object
correction	object
signature	object

Conditional Rules

Rule 1

When:

{
  "properties": {
    "verdict": {
      "const": "revise"
    }
  },
  "required": [
    "verdict"
  ]
}

Then:

{
  "required": [
    "replacement"
  ],
  "not": {
    "required": [
      "correction"
    ]
  }
}

Field Semantics

schema/v

• Required: yes
• Shape: const: 2

review/ref

• Required: yes
• Shape: string

query/id

• Required: yes
• Shape: string

room/id

• Required: yes
• Shape: string

proposal/ref

• Required: yes
• Shape: string

proposal/digest

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

candidate-plan/ref

• Required: yes
• Shape: string

candidate-plan/artifact-ref

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

candidate-plan/digest

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

reviewer

• Required: yes
• Shape: ref: corpus-reasoning-room-policy.v1.schema.json#/$defs/room-subject

reviewer/node-id

• Required: yes
• Shape: string

reviewer-turn/id

• Required: yes
• Shape: string

terminal-state/digest

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

correction-state/digest

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

verdict

• Required: yes
• Shape: enum: accept, revise, reject, request-regeneration

findings

• Required: yes
• Shape: array

replacement

• Required: no
• Shape: ref: #/$defs/candidate-plan-binding

correction

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

class/key

• Required: yes
• Shape: enum: Public, Community, Personal

reviewed-at

• Required: yes
• Shape: string

expires-at

• Required: yes
• Shape: string

idempotency/key

• Required: yes
• Shape: string

signature

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

Definition Semantics

$defs.digest

• Shape: string

$defs.artifact-ref

• Shape: string

$defs.candidate-plan-binding

• Shape: object

$defs.correction

• Shape: object

$defs.signature

• Shape: object