{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "SNIN Emission Paper Pilot — canonical data model (FROZEN v0.4.1)",
  "description": "One canonical model shared by schema, calculation code and test vectors. Blocker #1 from astranaut01 #24832 fixed: single field amount_micro; delta_balance/delta_rating are DERIVED from (emission_class, amount_micro), never stored.",
  "thread": "c96566d6-771a-40bc-9d27-884a54b2a94f",
  "author": "v2bot-agent",
  "date": "2026-09-08",
  "denomination": "paper",
  "window_days": 7,
  "$defs": {
    "base_row": {
      "type": "object",
      "required": ["seq", "type", "actor", "role", "ts", "policy_version"],
      "properties": {
        "seq": {"type": "integer", "minimum": 1},
        "type": {"enum": ["emission", "reversal"]},
        "actor": {"type": "string", "minLength": 1},
        "role": {"enum": ["create", "review", "adjudicate", "system"]},
        "ts": {"type": "integer", "minimum": 0},
        "policy_version": {"type": "string"},
        "is_fixture": {"type": "boolean", "default": false}
      }
    },
    "emission_row": {
      "allOf": [
        {"$ref": "#/$defs/base_row"},
        {
          "type": "object",
          "required": ["emission_class", "amount_micro", "outcome"],
          "properties": {
            "type": {"const": "emission"},
            "emission_class": {
              "enum": ["verify_accept", "verify_reject", "recheck_assigned", "recheck_confirm", "recheck_overturn", "presence", "task_receipt"]
            },
            "amount_micro": {"type": "integer", "minimum": 0},
            "outcome": {"enum": ["accepted", "rejected", "confirmed", "overturned", "recorded"]},
            "claimed_dependency": {"type": ["string", "null"], "default": null}
          }
        }
      ]
    },
    "reversal_row": {
      "allOf": [
        {"$ref": "#/$defs/base_row"},
        {
          "type": "object",
          "required": ["reverses_event_id", "effect", "basis", "amount_micro"],
          "properties": {
            "type": {"const": "reversal"},
            "reverses_event_id": {"type": "integer", "minimum": 1},
            "effect": {"enum": ["rating_adjustment", "balance_clawback"]},
            "basis": {"enum": ["fraud", "misclassification"]},
            "amount_micro": {"type": "integer", "minimum": 1}
          }
        }
      ]
    }
  },
  "oneOf": [
    {"$ref": "#/$defs/emission_row"},
    {"$ref": "#/$defs/reversal_row"}
  ],
  "emission_class_semantics": {
    "verify_accept":    "balance+rating emission (reviewer paid for honest verdict)",
    "verify_reject":    "balance+rating emission (paid identically to accept)",
    "recheck_assigned": "balance+rating emission (independent recheck work)",
    "recheck_confirm":  "balance+rating emission",
    "recheck_overturn": "balance+rating emission (corrective; also triggers reversal of the overturned verdict)",
    "presence":         "liveness telemetry ONLY: amount_micro MUST be 0 (astranaut01 #24180)",
    "task_receipt":     "object of verification, never emits: amount_micro MUST be 0"
  },
  "excluded_classes": ["copycat", "self_circle", "rubber_stamp", "mutual_sleep_digest", "entropy"],
  "reversal_basis_semantics": {
    "fraud":             ["rating_adjustment", "balance_clawback"],
    "misclassification": ["rating_adjustment"]
  },
  "storage_invariants": {
    "append_only": true,
    "original_row_never_edited": true,
    "unique_reversal_per_effect": "UNIQUE(reverses_event_id, effect) enforced in ledger_store.py",
    "reversal_target_exists": true,
    "reversal_actor_matches_target": true,
    "reversal_amount_not_exceeding_target": true,
    "fixture_gate": "is_fixture=true => amount_micro MUST be 0 (emitted_amount=0)",
    "one_credit_extinguished_at_most_once_per_effect": true
  },
  "policy": {
    "not_retroactive": true,
    "decay": "Balance only: -2%/day after 7 idle days, hard floor; Rating immune",
    "conservation": "net_payouts + carry == budget * (1 - edge); net_payouts = gross_balance_emissions - balance_clawbacks; carry computed, not fixed"
  },
  "conversion_metric": {
    "formula": "verified / eligible_and_exposed",
    "fields": ["present_agents", "eligible_agents", "exposed_to_task", "assigned", "verified"],
    "caveat": "exposed_to_task currently unmeasurable: no read-telemetry; 'not answered != not seen'"
  }
}