feat: add normative reference quick demo

Author: M-Tokun

examples/README.md

@@ -4,6 +4,22 @@
 
 ---
 
+## Canonical Reference Quick Demo
+
+Run the current normative reference implementation from the repository root:
+
+```powershell
+python examples/nra_ide_reference_quick_demo.py
+```
+
+The demo calls [`nra-core/foundations/NRA-IDE_Architecture_public.py`](../nra-core/foundations/NRA-IDE_Architecture_public.py) directly and checks seven canonical outcomes: `PERMIT`, `BOUNDARY_WARNING`, `HANDOFF_REQUIRED`, `IRREVERSIBLE_TRANSITION`, `RUPTURE_BOUNDARY`, `CONFESSION`, and `OUT_OF_DESCRIPTION_DOMAIN`.
+
+Its thresholds are explicit demonstration values, not inferred defaults. The demo is not a separate canonical evaluator and must not be used for medical, autonomous-control, or other operational decisions.
+
+Other examples in this directory preserve research, explanatory, illustrative, domain-specific, or historical work and may use legacy state names.
+
+---
+
 ## What is NRA-IDE?
 
 **Nomological Ring Axioms — Intensional Dynamics Engine**
@@ -379,4 +395,3 @@ This project is provided under the **MIT License**. It may be used, modified, an
 For the latest information, see the official repository:
 
 - **GitHub:** https://github.com/M-Tokun/NRA-IDE
-

examples/README_JP.md

@@ -4,6 +4,22 @@
 
 ---
 
+## 正規参照 Quick Demo
+
+リポジトリルートで、現行の正規参照実装を実行します。
+
+```powershell
+python examples/nra_ide_reference_quick_demo.py
+```
+
+このデモは[`nra-core/foundations/NRA-IDE_Architecture_public.py`](../nra-core/foundations/NRA-IDE_Architecture_public.py)を直接呼び出し、`PERMIT`、`BOUNDARY_WARNING`、`HANDOFF_REQUIRED`、`IRREVERSIBLE_TRANSITION`、`RUPTURE_BOUNDARY`、`CONFESSION`、`OUT_OF_DESCRIPTION_DOMAIN`の7状態を確認します。
+
+閾値は説明用に明示した値であり、推論された既定値ではありません。このデモは独立した正規判定器ではなく、医療、自律制御、その他の運用判断には使用できません。
+
+このディレクトリのその他の例は、研究・説明・例示・ドメイン固有・履歴資料を保存しており、旧状態名を使用する場合があります。
+
+---
+
 ## NRA-IDE とは
 
 **律環公理 — 内包性動力学エンジン（Nomological Ring Axioms — Intensional Dynamics Engine）**
@@ -417,4 +433,3 @@ if (deliveryStatus === "STOP") {
 - **GitHub:** https://github.com/M-Tokun/NRA-IDE
 
 ---
-

examples/nra_ide_reference_quick_demo.py

@@ -0,0 +1,69 @@
+"""Run canonical NRA-IDE states through the normative reference implementation.
+
+This file is an executable example, not a separate canonical evaluator.
+The thresholds are explicit demonstration values, not inferred domain defaults.
+Do not use this demo for medical, autonomous-control, or other operational decisions.
+"""
+
+from __future__ import annotations
+
+import importlib.util
+import pathlib
+from typing import Any
+
+
+ROOT = pathlib.Path(__file__).resolve().parents[1]
+SOURCE = ROOT / "nra-core" / "foundations" / "NRA-IDE_Architecture_public.py"
+SPEC = importlib.util.spec_from_file_location("nra_ide_reference_quick_demo", SOURCE)
+NRA = importlib.util.module_from_spec(SPEC)
+assert SPEC.loader is not None
+SPEC.loader.exec_module(NRA)
+
+THRESHOLDS = {
+    "r_warn": 0.4,
+    "r_handoff": 0.6,
+    "r_irrev": 0.8,
+}
+
+SCENARIOS = (
+    ("below warning", 0.1, 1.0, "PERMIT"),
+    ("warning boundary", 0.4, 1.0, "BOUNDARY_WARNING"),
+    ("human handoff", 0.6, 1.0, "HANDOFF_REQUIRED"),
+    ("irreversible onset", 0.8, 1.0, "IRREVERSIBLE_TRANSITION"),
+    ("complete rupture", 1.0, 1.0, "RUPTURE_BOUNDARY"),
+    ("invalid structural input", "invalid", 1.0, "CONFESSION"),
+    ("undefined ratio domain", 0.1, 0.0, "OUT_OF_DESCRIPTION_DOMAIN"),
+)
+
+
+def display_value(value: Any) -> str:
+    return "NOT_AVAILABLE" if value is None else str(value)
+
+
+def main() -> int:
+    print("NRA-IDE normative reference quick demo")
+    print("Thresholds are explicit demonstration values:", THRESHOLDS)
+    print()
+
+    passed = 0
+    for name, delta, tau, expected in SCENARIOS:
+        result = NRA.nra_ide_core_evaluation(delta, tau, **THRESHOLDS)
+        actual = result["status"]
+        outcome = "PASS" if actual == expected else "FAIL"
+        passed += actual == expected
+        print(
+            f"{outcome:4} | {name:24} | delta={delta!r:9} | tau={tau!r:4} | "
+            f"R={display_value(result['R']):13} | status={actual} | expected={expected}"
+        )
+
+    print()
+    print(f"Scenarios passed: {passed}/{len(SCENARIOS)}")
+    if passed == len(SCENARIOS):
+        print("Quick demo result: OK")
+        return 0
+    print("Quick demo result: FAILED")
+    return 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())