Corpus Reasoning Instruction Overlay v1

Source schema: doc/schemas/corpus-reasoning-instruction-overlay.v1.schema.json

Governing Basis

• doc/project/40-proposals/069-corpus.md
• doc/project/40-proposals/064-inquirium-implementation-recommendations.md

Project Lineage

Requirements

• doc/project/50-requirements/requirements-010-middleware-executor.md

Stories

• doc/project/30-stories/story-005-whisper-rumor-intake.md
• doc/project/30-stories/story-006-voluntary-swarm-exchange.md
• doc/project/30-stories/story-009-bielik-blog-arca.md

Fields

Field	Required	Shape	Description
schema/v	yes	const: 1
overlay/id	yes	string
assignment/id	yes	string
query/id	yes	string
room/id	yes	string
participant	yes	ref: corpus-reasoning-room-policy.v1.schema.json#/$defs/room-subject
role	yes	enum: implementer, reviewer, adversarial-critic, summarizer
turn/no	yes	integer
kind	yes	enum: task-guidance, review-criteria, adversarial-check, summary-criteria
position	yes	enum: preamble, postamble
instruction/text	yes	string
instruction/rendered	no	string
class/key	yes	enum: Public, Community, Personal
status	yes	enum: proposed, accepted, declined
revision/no	yes	integer
proposed/by	yes	string
proposed-at	yes	string
decision/by	no	string
decided-at	no	string
policy/ref	no	string
expires-at	yes	string
idempotency/key	yes	string

Conditional Rules

Rule 1

When:

{
  "properties": {
    "status": {
      "const": "proposed"
    }
  }
}

Then:

{
  "not": {
    "anyOf": [
      {
        "required": [
          "decision/by"
        ]
      },
      {
        "required": [
          "decided-at"
        ]
      },
      {
        "required": [
          "policy/ref"
        ]
      },
      {
        "required": [
          "instruction/rendered"
        ]
      }
    ]
  }
}

Rule 2

When:

{
  "properties": {
    "status": {
      "const": "accepted"
    }
  }
}

Then:

{
  "required": [
    "instruction/rendered"
  ]
}

Field Semantics

schema/v

• Required: yes
• Shape: const: 1

overlay/id

• Required: yes
• Shape: string

assignment/id

• Required: yes
• Shape: string

query/id

• Required: yes
• Shape: string

room/id

• Required: yes
• Shape: string

participant

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

role

• Required: yes
• Shape: enum: implementer, reviewer, adversarial-critic, summarizer

turn/no

• Required: yes
• Shape: integer

kind

• Required: yes
• Shape: enum: task-guidance, review-criteria, adversarial-check, summary-criteria

position

• Required: yes
• Shape: enum: preamble, postamble

instruction/text

• Required: yes
• Shape: string

instruction/rendered

• Required: no
• Shape: string

class/key

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

status

• Required: yes
• Shape: enum: proposed, accepted, declined

revision/no

• Required: yes
• Shape: integer

proposed/by

• Required: yes
• Shape: string

proposed-at

• Required: yes
• Shape: string

decision/by

• Required: no
• Shape: string

decided-at

• Required: no
• Shape: string

policy/ref

• Required: no
• Shape: string

expires-at

• Required: yes
• Shape: string

idempotency/key

• Required: yes
• Shape: string