Skip to content

Corpus Reasoning Answer v1

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

Signed final answer artifact for one Corpus reasoning query. This is the post-procurement result fact; live deliberation, if any, remains outside this artifact.

Governing Basis

Project Lineage

Fields

Field Required Shape Description
schema/v yes const: 1
answer/id yes string
query/id yes string
correlation/id yes string
responder/node-id yes string
selected/bid-id no string
supersedes no string Optional previous answer revision replaced by this answer in local latest read-models. Federated publication remains append-only: a superseding answer is a new fact, not an overwrite.
revision/no no integer Optional human-facing revision counter. Ordering authority remains append-only fact order plus supersedes links, not this advisory counter alone.
room/id no string
room-event/high-water no integer
created-at yes string
answer/text yes string
answer/digest yes ref: #/$defs/sha256_digest
policy/digest yes ref: #/$defs/sha256_digest
classification no enum: Public, Community, Personal Optional classification.v1 tier. If omitted by a legacy/admin producer, the AD answer envelope is treated as Public; production providers should set this explicitly.
contributor/weights no array
evidence/refs no array
signature yes ref: #/$defs/signature
extensions no ref: #/$defs/extensions

Definitions

Definition Shape Description
sha256_digest string
contributor_weight object
signature object
extensions object
## Field Semantics

schema/v

  • Required: yes
  • Shape: const: 1

answer/id

  • Required: yes
  • Shape: string

query/id

  • Required: yes
  • Shape: string

correlation/id

  • Required: yes
  • Shape: string

responder/node-id

  • Required: yes
  • Shape: string

selected/bid-id

  • Required: no
  • Shape: string

supersedes

  • Required: no
  • Shape: string

Optional previous answer revision replaced by this answer in local latest read-models. Federated publication remains append-only: a superseding answer is a new fact, not an overwrite.

revision/no

  • Required: no
  • Shape: integer

Optional human-facing revision counter. Ordering authority remains append-only fact order plus supersedes links, not this advisory counter alone.

room/id

  • Required: no
  • Shape: string

room-event/high-water

  • Required: no
  • Shape: integer

created-at

  • Required: yes
  • Shape: string

answer/text

  • Required: yes
  • Shape: string

answer/digest

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

policy/digest

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

classification

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

Optional classification.v1 tier. If omitted by a legacy/admin producer, the AD answer envelope is treated as Public; production providers should set this explicitly.

contributor/weights

  • Required: no
  • Shape: array

evidence/refs

  • Required: no
  • Shape: array

signature

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

extensions

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

Definition Semantics

$defs.sha256_digest

  • Shape: string

$defs.contributor_weight

  • Shape: object

$defs.signature

  • Shape: object

$defs.extensions

  • Shape: object