@almadar/std 16.144.0 → 16.146.0

package/behaviors/registry/ml/molecules/std-escalating-decision.orb

@@ -0,0 +1,1553 @@
+{
+  "description": "std-escalating-decision — the intelligence ladder itself, as one reusable composition. One request enters at DECIDE and falls through the rungs in order — R0 exact check, R1 table lookup, R3 retrieval, R4 learned inference, R5 generative classification — each rung handing off to the next by abstaining, until one proves the answer. Exits DECIDED, tagged with which rung answered (rung, confidence, matched, reasoning), or DECISION_FAILED if even the generative floor could not serve it. The escalation is a chain, not a hub: each rung listens directly to the rung above it and projects its own inputs out of the carried request, so the trait graph is a DAG and no event ever returns to a rung that already ran. Domain-agnostic: it knows about candidates and categories, not students or quizzes — grading, routing, matching, moderation, and duplicate detection are all this same molecule with different knobs. R2 (the Beta posterior) is deliberately not in this chain: it is the 'decide what to do next' half of a turn and already lives in std-knowledge-tracing.",
+  "ledger": {
+    "entries": {
+      "ent_01KYBV09899CDQKETN5JFBX4EX": {
+        "bakedName": "KeyLookup",
+        "curName": "KeyLookup",
+        "id": "ent_01KYBV09899CDQKETN5JFBX4EX",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "ent_01KYBV0989A4ZMRWM79R1DK3DB": {
+        "bakedName": "ExactCheck",
+        "curName": "ExactCheck",
+        "id": "ent_01KYBV0989A4ZMRWM79R1DK3DB",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "ent_01KYBV0989DW3WZDZ9G8HMXSJK": {
+        "bakedName": "SimilarityComparison",
+        "curName": "SimilarityComparison",
+        "id": "ent_01KYBV0989DW3WZDZ9G8HMXSJK",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "ent_01KYBV0989PA5SP6AT1B01P8PB": {
+        "bakedName": "ClassifierVerdict",
+        "curName": "ClassifierVerdict",
+        "id": "ent_01KYBV0989PA5SP6AT1B01P8PB",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "ent_01KYBV0989Q6EWCA1PPP4KTX75": {
+        "bakedName": "Inference",
+        "curName": "Inference",
+        "id": "ent_01KYBV0989Q6EWCA1PPP4KTX75",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "ent_01KYC06PWVCKCYJZ2WWNTJ2CE2": {
+        "bakedName": "LadderRequest",
+        "curName": "LadderRequest",
+        "id": "ent_01KYC06PWVCKCYJZ2WWNTJ2CE2",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "ent_01KYC06PWVTWYDVRXHHJ8H7MBN": {
+        "bakedName": "LadderVerdict",
+        "curName": "LadderVerdict",
+        "id": "ent_01KYC06PWVTWYDVRXHHJ8H7MBN",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01KYC06PWV0WNG8YXAXDCSGCMK": {
+        "bakedName": "RESET",
+        "curName": "RESET",
+        "id": "evt_01KYC06PWV0WNG8YXAXDCSGCMK",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYC06PWV0T9JDATJBR5NW7JX",
+        "renames": []
+      },
+      "evt_01KYC06PWV50NDP6J22QHK7PWE": {
+        "bakedName": "FROM_CLASSIFY",
+        "curName": "FROM_CLASSIFY",
+        "id": "evt_01KYC06PWV50NDP6J22QHK7PWE",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYC06PWV9AQNNJGE19F9R8M1",
+        "renames": []
+      },
+      "evt_01KYC06PWV8N74BABJ2QMA9TQR": {
+        "bakedName": "DECIDE",
+        "curName": "DECIDE",
+        "id": "evt_01KYC06PWV8N74BABJ2QMA9TQR",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYC06PWV0T9JDATJBR5NW7JX",
+        "renames": []
+      },
+      "evt_01KYC06PWVBDKHTBEK806HBAE8": {
+        "bakedName": "RUN_EXACT",
+        "curName": "RUN_EXACT",
+        "id": "evt_01KYC06PWVBDKHTBEK806HBAE8",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYC06PWV0T9JDATJBR5NW7JX",
+        "renames": []
+      },
+      "evt_01KYC06PWVBMW1ZPR7WRYECYHJ": {
+        "bakedName": "FROM_LOOKUP",
+        "curName": "FROM_LOOKUP",
+        "id": "evt_01KYC06PWVBMW1ZPR7WRYECYHJ",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYC06PWV9AQNNJGE19F9R8M1",
+        "renames": []
+      },
+      "evt_01KYC06PWVE8S93JMF0J74Y1B8": {
+        "bakedName": "FROM_CLASSIFY_FAILURE",
+        "curName": "FROM_CLASSIFY_FAILURE",
+        "id": "evt_01KYC06PWVE8S93JMF0J74Y1B8",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYC06PWV9AQNNJGE19F9R8M1",
+        "renames": []
+      },
+      "evt_01KYC06PWVFMCH8Q4XEN2FJGKY": {
+        "bakedName": "FROM_INFER",
+        "curName": "FROM_INFER",
+        "id": "evt_01KYC06PWVFMCH8Q4XEN2FJGKY",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYC06PWV9AQNNJGE19F9R8M1",
+        "renames": []
+      },
+      "evt_01KYC06PWVFVEJE5JCZ9QGBTQS": {
+        "bakedName": "DECIDED",
+        "curName": "DECIDED",
+        "id": "evt_01KYC06PWVFVEJE5JCZ9QGBTQS",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYC06PWV9AQNNJGE19F9R8M1",
+        "renames": []
+      },
+      "evt_01KYC06PWVGZ7AWD6PYD2DCZN9": {
+        "bakedName": "DECISION_FAILED",
+        "curName": "DECISION_FAILED",
+        "id": "evt_01KYC06PWVGZ7AWD6PYD2DCZN9",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYC06PWV9AQNNJGE19F9R8M1",
+        "renames": []
+      },
+      "evt_01KYC06PWVJR97P13P65CMY1XQ": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01KYC06PWVJR97P13P65CMY1XQ",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYC06PWV9AQNNJGE19F9R8M1",
+        "renames": []
+      },
+      "evt_01KYC06PWVKV2CQJ63FXJ6Z2VN": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01KYC06PWVKV2CQJ63FXJ6Z2VN",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYC06PWV0T9JDATJBR5NW7JX",
+        "renames": []
+      },
+      "evt_01KYC06PWVNY4RACZE4JF4Y2SB": {
+        "bakedName": "RESET",
+        "curName": "RESET",
+        "id": "evt_01KYC06PWVNY4RACZE4JF4Y2SB",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYC06PWV9AQNNJGE19F9R8M1",
+        "renames": []
+      },
+      "evt_01KYC06PWVSQC5XWD4TBQWMYHJ": {
+        "bakedName": "FROM_SIMILARITY",
+        "curName": "FROM_SIMILARITY",
+        "id": "evt_01KYC06PWVSQC5XWD4TBQWMYHJ",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYC06PWV9AQNNJGE19F9R8M1",
+        "renames": []
+      },
+      "evt_01KYC06PWVWPQZRX9XD2KYS0WX": {
+        "bakedName": "FROM_EXACT",
+        "curName": "FROM_EXACT",
+        "id": "evt_01KYC06PWVWPQZRX9XD2KYS0WX",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYC06PWV9AQNNJGE19F9R8M1",
+        "renames": []
+      },
+      "orb_01KYBV0989HAR303D054T6S7FQ": {
+        "bakedName": "EscalatingDecisionOrbital",
+        "curName": "EscalatingDecisionOrbital",
+        "id": "orb_01KYBV0989HAR303D054T6S7FQ",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01KYBV0989N4SHACK87Z0W7049": {
+        "bakedName": "LadderDecidePage",
+        "curName": "LadderDecidePage",
+        "id": "pag_01KYBV0989N4SHACK87Z0W7049",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01KYBV0989745177PBSGRQHX1D": {
+        "bakedName": "ClassifyRung",
+        "curName": "ClassifyRung",
+        "id": "trt_01KYBV0989745177PBSGRQHX1D",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01KYBV09897QSSA7A1QCBY7WD7": {
+        "bakedName": "ExactRung",
+        "curName": "ExactRung",
+        "id": "trt_01KYBV09897QSSA7A1QCBY7WD7",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01KYBV0989C4D1RVXG0F91NQEF": {
+        "bakedName": "LookupRung",
+        "curName": "LookupRung",
+        "id": "trt_01KYBV0989C4D1RVXG0F91NQEF",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01KYBV0989H8WKSR4F6VEMYBAV": {
+        "bakedName": "SimilarityRung",
+        "curName": "SimilarityRung",
+        "id": "trt_01KYBV0989H8WKSR4F6VEMYBAV",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01KYBV0989NRVM07RKY8T08950": {
+        "bakedName": "InferRung",
+        "curName": "InferRung",
+        "id": "trt_01KYBV0989NRVM07RKY8T08950",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01KYC06PWV0T9JDATJBR5NW7JX": {
+        "bakedName": "LadderEntry",
+        "curName": "LadderEntry",
+        "id": "trt_01KYC06PWV0T9JDATJBR5NW7JX",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01KYC06PWV9AQNNJGE19F9R8M1": {
+        "bakedName": "LadderVerdictSink",
+        "curName": "LadderVerdictSink",
+        "id": "trt_01KYC06PWV9AQNNJGE19F9R8M1",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "std-escalating-decision",
+  "orbitals": [
+    {
+      "auxiliaryEntities": [
+        {
+          "fields": [
+            {
+              "default": "",
+              "name": "rung",
+              "type": "string"
+            },
+            {
+              "default": 0.0,
+              "name": "confidence",
+              "type": "number"
+            },
+            {
+              "default": "",
+              "name": "reasoning",
+              "type": "string"
+            },
+            {
+              "default": "",
+              "name": "failReason",
+              "type": "string"
+            },
+            {
+              "default": "idle",
+              "name": "status",
+              "type": "string",
+              "values": [
+                "idle",
+                "decided",
+                "failed"
+              ]
+            }
+          ],
+          "id": "ent_01KYC06PWVTWYDVRXHHJ8H7MBN",
+          "name": "LadderVerdict",
+          "persistence": "runtime"
+        },
+        {
+          "fields": [
+            {
+              "default": false,
+              "name": "matched",
+              "type": "boolean"
+            },
+            {
+              "default": "idle",
+              "name": "status",
+              "type": "string",
+              "values": [
+                "idle",
+                "checked"
+              ]
+            }
+          ],
+          "id": "ent_01KYBV0989A4ZMRWM79R1DK3DB",
+          "name": "ExactCheck",
+          "persistence": "runtime"
+        },
+        {
+          "fields": [
+            {
+              "default": false,
+              "name": "matched",
+              "type": "boolean"
+            },
+            {
+              "default": "idle",
+              "name": "status",
+              "type": "string",
+              "values": [
+                "idle",
+                "checked"
+              ]
+            }
+          ],
+          "id": "ent_01KYBV09899CDQKETN5JFBX4EX",
+          "name": "KeyLookup",
+          "persistence": "runtime"
+        },
+        {
+          "fields": [
+            {
+              "default": "",
+              "name": "query",
+              "type": "string"
+            },
+            {
+              "default": [],
+              "items": {
+                "type": "string"
+              },
+              "name": "candidates",
+              "type": "array"
+            },
+            {
+              "default": [],
+              "items": {
+                "items": {
+                  "type": "number"
+                },
+                "type": "array"
+              },
+              "name": "embeddings",
+              "type": "array"
+            },
+            {
+              "default": [],
+              "items": {
+                "type": "number"
+              },
+              "name": "queryVector",
+              "type": "array"
+            },
+            {
+              "default": [],
+              "items": {
+                "items": {
+                  "type": "number"
+                },
+                "type": "array"
+              },
+              "name": "candidateVectors",
+              "type": "array"
+            },
+            {
+              "default": 0.0,
+              "name": "matchIndex",
+              "type": "number"
+            },
+            {
+              "default": 0.0,
+              "name": "matchScore",
+              "type": "number"
+            },
+            {
+              "default": 0.0,
+              "name": "matchMargin",
+              "type": "number"
+            },
+            {
+              "default": "",
+              "name": "reason",
+              "type": "string"
+            },
+            {
+              "default": {},
+              "name": "request",
+              "type": "object"
+            },
+            {
+              "default": "idle",
+              "name": "status",
+              "type": "string",
+              "values": [
+                "idle",
+                "embedding",
+                "resolved"
+              ]
+            }
+          ],
+          "id": "ent_01KYBV0989DW3WZDZ9G8HMXSJK",
+          "name": "SimilarityComparison",
+          "persistence": "runtime"
+        },
+        {
+          "fields": [
+            {
+              "default": {},
+              "name": "input",
+              "type": "object"
+            },
+            {
+              "default": [],
+              "items": {
+                "type": "number"
+              },
+              "name": "output",
+              "type": "array"
+            },
+            {
+              "default": 0.0,
+              "name": "confidence",
+              "type": "number"
+            },
+            {
+              "default": [],
+              "items": {
+                "type": "object"
+              },
+              "name": "violations",
+              "type": "array"
+            },
+            {
+              "default": "",
+              "name": "reason",
+              "type": "string"
+            },
+            {
+              "default": {},
+              "name": "request",
+              "type": "object"
+            },
+            {
+              "default": "idle",
+              "name": "status",
+              "type": "string",
+              "values": [
+                "idle",
+                "inferring",
+                "resolved"
+              ]
+            }
+          ],
+          "id": "ent_01KYBV0989Q6EWCA1PPP4KTX75",
+          "name": "Inference",
+          "persistence": "runtime"
+        },
+        {
+          "fields": [
+            {
+              "default": "",
+              "name": "text",
+              "type": "string"
+            },
+            {
+              "default": "",
+              "name": "category",
+              "type": "string"
+            },
+            {
+              "default": 0.0,
+              "name": "confidence",
+              "type": "number"
+            },
+            {
+              "default": "",
+              "name": "reasoning",
+              "type": "string"
+            },
+            {
+              "default": "",
+              "name": "errorMessage",
+              "type": "string"
+            },
+            {
+              "default": {},
+              "name": "request",
+              "type": "object"
+            },
+            {
+              "default": "idle",
+              "name": "status",
+              "type": "string",
+              "values": [
+                "idle",
+                "classifying",
+                "done"
+              ]
+            }
+          ],
+          "id": "ent_01KYBV0989PA5SP6AT1B01P8PB",
+          "name": "ClassifierVerdict",
+          "persistence": "runtime"
+        }
+      ],
+      "entity": {
+        "fields": [
+          {
+            "default": "idle",
+            "name": "status",
+            "type": "string",
+            "values": [
+              "idle",
+              "dispatched"
+            ]
+          }
+        ],
+        "id": "ent_01KYC06PWVCKCYJZ2WWNTJ2CE2",
+        "name": "LadderRequest",
+        "persistence": "runtime"
+      },
+      "id": "orb_01KYBV0989HAR303D054T6S7FQ",
+      "name": "EscalatingDecisionOrbital",
+      "pages": [
+        {
+          "id": "pag_01KYBV0989N4SHACK87Z0W7049",
+          "name": "LadderDecidePage",
+          "path": "/ladder/decide",
+          "traits": [
+            {
+              "ref": "LadderEntry",
+              "refId": "trt_01KYC06PWV0T9JDATJBR5NW7JX"
+            },
+            {
+              "ref": "ExactRung",
+              "refId": "trt_01KYBV09897QSSA7A1QCBY7WD7"
+            },
+            {
+              "ref": "LookupRung",
+              "refId": "trt_01KYBV0989C4D1RVXG0F91NQEF"
+            },
+            {
+              "ref": "SimilarityRung",
+              "refId": "trt_01KYBV0989H8WKSR4F6VEMYBAV"
+            },
+            {
+              "ref": "InferRung",
+              "refId": "trt_01KYBV0989NRVM07RKY8T08950"
+            },
+            {
+              "ref": "ClassifyRung",
+              "refId": "trt_01KYBV0989745177PBSGRQHX1D"
+            },
+            {
+              "ref": "LadderVerdictSink",
+              "refId": "trt_01KYC06PWV9AQNNJGE19F9R8M1"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "lifecycle",
+          "emits": [
+            {
+              "description": "Starts the ladder at the exact-check rung (R0). request is the whole DECIDE payload, carried down the chain so each rung can project its own inputs.",
+              "event": "RUN_EXACT",
+              "eventId": "evt_01KYC06PWVBDKHTBEK806HBAE8",
+              "payloadSchema": [
+                {
+                  "name": "candidate",
+                  "required": true,
+                  "type": "any"
+                },
+                {
+                  "name": "key",
+                  "required": true,
+                  "type": "any"
+                },
+                {
+                  "name": "request",
+                  "required": true,
+                  "type": "object"
+                }
+              ],
+              "tier": "secondary"
+            }
+          ],
+          "entityRefIds": {
+            "LadderRequest": "ent_01KYC06PWVCKCYJZ2WWNTJ2CE2"
+          },
+          "id": "trt_01KYC06PWV0T9JDATJBR5NW7JX",
+          "linkedEntity": "LadderRequest",
+          "linkedEntityId": "ent_01KYC06PWVCKCYJZ2WWNTJ2CE2",
+          "name": "LadderEntry",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01KYC06PWVKV2CQJ63FXJ6Z2VN",
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "description": "Public entry point — decide the candidate, falling through the ladder until a rung can prove the answer. accepted is R1's table; categories is R3's comparison set (R5's closed label set is the ClassifyRung categories knob, a design-time decision rather than a per-request one).",
+                "id": "evt_01KYC06PWV8N74BABJ2QMA9TQR",
+                "key": "DECIDE",
+                "name": "Decide",
+                "payloadSchema": [
+                  {
+                    "name": "candidate",
+                    "required": true,
+                    "type": "any"
+                  },
+                  {
+                    "name": "key",
+                    "required": true,
+                    "type": "any"
+                  },
+                  {
+                    "name": "accepted",
+                    "required": true,
+                    "type": "[any]"
+                  },
+                  {
+                    "name": "categories",
+                    "required": true,
+                    "type": "[string]"
+                  }
+                ],
+                "tier": "primary"
+              },
+              {
+                "id": "evt_01KYC06PWV0WNG8YXAXDCSGCMK",
+                "key": "RESET",
+                "name": "Reset"
+              },
+              {
+                "description": "Starts the ladder at the exact-check rung (R0). request is the whole DECIDE payload, carried down the chain so each rung can project its own inputs.",
+                "id": "evt_01KYC06PWVBDKHTBEK806HBAE8",
+                "key": "RUN_EXACT",
+                "name": "Run Exact",
+                "payloadSchema": [
+                  {
+                    "name": "candidate",
+                    "required": true,
+                    "type": "any"
+                  },
+                  {
+                    "name": "key",
+                    "required": true,
+                    "type": "any"
+                  },
+                  {
+                    "name": "request",
+                    "required": true,
+                    "type": "object"
+                  }
+                ],
+                "tier": "secondary"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              },
+              {
+                "name": "dispatched"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.status",
+                    "idle"
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01KYC06PWVKV2CQJ63FXJ6Z2VN",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.status",
+                    "dispatched"
+                  ],
+                  [
+                    "emit",
+                    "RUN_EXACT",
+                    {
+                      "candidate": "@payload.candidate",
+                      "key": "@payload.key",
+                      "request": "@payload"
+                    }
+                  ]
+                ],
+                "event": "DECIDE",
+                "eventId": "evt_01KYC06PWV8N74BABJ2QMA9TQR",
+                "from": "idle",
+                "to": "dispatched"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.status",
+                    "dispatched"
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01KYC06PWVKV2CQJ63FXJ6Z2VN",
+                "from": "dispatched",
+                "to": "dispatched"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.status",
+                    "idle"
+                  ]
+                ],
+                "event": "RESET",
+                "eventId": "evt_01KYC06PWV0WNG8YXAXDCSGCMK",
+                "from": "dispatched",
+                "to": "idle"
+              }
+            ]
+          }
+        },
+        {
+          "id": "trt_01KYBV09897QSSA7A1QCBY7WD7",
+          "linkedEntity": "ExactCheck",
+          "linkedEntityId": "ent_01KYBV0989A4ZMRWM79R1DK3DB",
+          "listens": [
+            {
+              "event": "RUN_EXACT",
+              "source": {
+                "kind": "trait",
+                "trait": "LadderEntry"
+              },
+              "triggers": "CHECK"
+            }
+          ],
+          "name": "ExactRung",
+          "ref": "Rung0.traits.ExactCheckRun"
+        },
+        {
+          "id": "trt_01KYBV0989C4D1RVXG0F91NQEF",
+          "linkedEntity": "KeyLookup",
+          "linkedEntityId": "ent_01KYBV09899CDQKETN5JFBX4EX",
+          "listens": [
+            {
+              "event": "EXACT_UNMATCHED",
+              "payloadMapping": {
+                "accepted": [
+                  "object/get",
+                  "@payload.request",
+                  "accepted"
+                ],
+                "candidate": "@payload.candidate",
+                "request": "@payload.request"
+              },
+              "source": {
+                "kind": "trait",
+                "trait": "ExactRung"
+              },
+              "triggers": "LOOKUP"
+            }
+          ],
+          "name": "LookupRung",
+          "ref": "Rung1.traits.LookupRun"
+        },
+        {
+          "id": "trt_01KYBV0989H8WKSR4F6VEMYBAV",
+          "linkedEntity": "SimilarityComparison",
+          "linkedEntityId": "ent_01KYBV0989DW3WZDZ9G8HMXSJK",
+          "listens": [
+            {
+              "event": "KEY_MISS",
+              "payloadMapping": {
+                "candidates": [
+                  "object/get",
+                  "@payload.request",
+                  "categories"
+                ],
+                "query": [
+                  "str/concat",
+                  "@payload.candidate"
+                ],
+                "request": "@payload.request"
+              },
+              "source": {
+                "kind": "trait",
+                "trait": "LookupRung"
+              },
+              "triggers": "COMPARE"
+            }
+          ],
+          "name": "SimilarityRung",
+          "ref": "Rung3.traits.SimilarityRun"
+        },
+        {
+          "id": "trt_01KYBV0989NRVM07RKY8T08950",
+          "linkedEntity": "Inference",
+          "linkedEntityId": "ent_01KYBV0989Q6EWCA1PPP4KTX75",
+          "listens": [
+            {
+              "event": "SIMILARITY_ABSTAINED",
+              "payloadMapping": {
+                "input": "@payload.request",
+                "request": "@payload.request"
+              },
+              "source": {
+                "kind": "trait",
+                "trait": "SimilarityRung"
+              },
+              "triggers": "INFER"
+            }
+          ],
+          "name": "InferRung",
+          "ref": "Rung4.traits.InferenceRun"
+        },
+        {
+          "id": "trt_01KYBV0989745177PBSGRQHX1D",
+          "linkedEntity": "ClassifierVerdict",
+          "linkedEntityId": "ent_01KYBV0989PA5SP6AT1B01P8PB",
+          "listens": [
+            {
+              "event": "INFER_ABSTAINED",
+              "payloadMapping": {
+                "request": "@payload.request",
+                "text": [
+                  "str/concat",
+                  [
+                    "object/get",
+                    "@payload.request",
+                    "candidate"
+                  ]
+                ]
+              },
+              "source": {
+                "kind": "trait",
+                "trait": "InferRung"
+              },
+              "triggers": "CLASSIFY"
+            }
+          ],
+          "name": "ClassifyRung",
+          "ref": "Rung5.traits.ClassifyRun"
+        },
+        {
+          "category": "lifecycle",
+          "emits": [
+            {
+              "description": "The ladder proved an answer. rung names which one served it: R0 exact, R1 table, R3 retrieved, R4 learned, R5 generative.",
+              "event": "DECIDED",
+              "eventId": "evt_01KYC06PWVFVEJE5JCZ9QGBTQS",
+              "payloadSchema": [
+                {
+                  "name": "rung",
+                  "required": true,
+                  "type": "string"
+                },
+                {
+                  "name": "confidence",
+                  "required": true,
+                  "type": "number"
+                },
+                {
+                  "name": "matched",
+                  "required": true,
+                  "type": "any"
+                },
+                {
+                  "name": "reasoning",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "tier": "primary"
+            },
+            {
+              "description": "Even the generative floor (R5) could not answer — the classify service call itself failed.",
+              "event": "DECISION_FAILED",
+              "eventId": "evt_01KYC06PWVGZ7AWD6PYD2DCZN9",
+              "payloadSchema": [
+                {
+                  "name": "reason",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "tier": "primary"
+            }
+          ],
+          "entityRefIds": {
+            "LadderVerdict": "ent_01KYC06PWVTWYDVRXHHJ8H7MBN"
+          },
+          "id": "trt_01KYC06PWV9AQNNJGE19F9R8M1",
+          "linkedEntity": "LadderVerdict",
+          "linkedEntityId": "ent_01KYC06PWVTWYDVRXHHJ8H7MBN",
+          "listens": [
+            {
+              "event": "EXACT_MATCHED",
+              "payloadMapping": {
+                "key": "@payload.key"
+              },
+              "source": {
+                "kind": "trait",
+                "trait": "ExactRung",
+                "traitId": "trt_01KYBV09897QSSA7A1QCBY7WD7"
+              },
+              "triggers": "FROM_EXACT",
+              "triggersId": "evt_01KYC06PWVWPQZRX9XD2KYS0WX"
+            },
+            {
+              "event": "KEY_HIT",
+              "payloadMapping": {
+                "entry": "@payload.entry"
+              },
+              "source": {
+                "kind": "trait",
+                "trait": "LookupRung",
+                "traitId": "trt_01KYBV0989C4D1RVXG0F91NQEF"
+              },
+              "triggers": "FROM_LOOKUP",
+              "triggersId": "evt_01KYC06PWVBMW1ZPR7WRYECYHJ"
+            },
+            {
+              "event": "SIMILARITY_MATCHED",
+              "payloadMapping": {
+                "index": "@payload.index",
+                "score": "@payload.score"
+              },
+              "source": {
+                "kind": "trait",
+                "trait": "SimilarityRung",
+                "traitId": "trt_01KYBV0989H8WKSR4F6VEMYBAV"
+              },
+              "triggers": "FROM_SIMILARITY",
+              "triggersId": "evt_01KYC06PWVSQC5XWD4TBQWMYHJ"
+            },
+            {
+              "event": "INFERRED",
+              "payloadMapping": {
+                "confidence": "@payload.confidence",
+                "output": "@payload.output"
+              },
+              "source": {
+                "kind": "trait",
+                "trait": "InferRung",
+                "traitId": "trt_01KYBV0989NRVM07RKY8T08950"
+              },
+              "triggers": "FROM_INFER",
+              "triggersId": "evt_01KYC06PWVFMCH8Q4XEN2FJGKY"
+            },
+            {
+              "event": "CLASSIFIED",
+              "payloadMapping": {
+                "category": "@payload.category",
+                "confidence": "@payload.confidence",
+                "reasoning": "@payload.reasoning"
+              },
+              "source": {
+                "kind": "trait",
+                "trait": "ClassifyRung",
+                "traitId": "trt_01KYBV0989745177PBSGRQHX1D"
+              },
+              "triggers": "FROM_CLASSIFY",
+              "triggersId": "evt_01KYC06PWV50NDP6J22QHK7PWE"
+            },
+            {
+              "event": "CLASSIFY_FAILED",
+              "payloadMapping": {
+                "error": "@payload.error"
+              },
+              "source": {
+                "kind": "trait",
+                "trait": "ClassifyRung",
+                "traitId": "trt_01KYBV0989745177PBSGRQHX1D"
+              },
+              "triggers": "FROM_CLASSIFY_FAILURE",
+              "triggersId": "evt_01KYC06PWVE8S93JMF0J74Y1B8"
+            }
+          ],
+          "name": "LadderVerdictSink",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01KYC06PWVJR97P13P65CMY1XQ",
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "id": "evt_01KYC06PWVWPQZRX9XD2KYS0WX",
+                "key": "FROM_EXACT",
+                "name": "From Exact",
+                "payloadSchema": [
+                  {
+                    "name": "key",
+                    "required": true,
+                    "type": "any"
+                  }
+                ]
+              },
+              {
+                "id": "evt_01KYC06PWVBMW1ZPR7WRYECYHJ",
+                "key": "FROM_LOOKUP",
+                "name": "From Lookup",
+                "payloadSchema": [
+                  {
+                    "name": "entry",
+                    "required": true,
+                    "type": "any"
+                  }
+                ]
+              },
+              {
+                "id": "evt_01KYC06PWVSQC5XWD4TBQWMYHJ",
+                "key": "FROM_SIMILARITY",
+                "name": "From Similarity",
+                "payloadSchema": [
+                  {
+                    "name": "index",
+                    "required": true,
+                    "type": "int"
+                  },
+                  {
+                    "name": "score",
+                    "required": true,
+                    "type": "float"
+                  }
+                ]
+              },
+              {
+                "id": "evt_01KYC06PWVFMCH8Q4XEN2FJGKY",
+                "key": "FROM_INFER",
+                "name": "From Infer",
+                "payloadSchema": [
+                  {
+                    "name": "output",
+                    "required": true,
+                    "type": "[float]"
+                  },
+                  {
+                    "name": "confidence",
+                    "required": true,
+                    "type": "float"
+                  }
+                ]
+              },
+              {
+                "id": "evt_01KYC06PWV50NDP6J22QHK7PWE",
+                "key": "FROM_CLASSIFY",
+                "name": "From Classify",
+                "payloadSchema": [
+                  {
+                    "name": "category",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "confidence",
+                    "required": true,
+                    "type": "float"
+                  },
+                  {
+                    "name": "reasoning",
+                    "required": true,
+                    "type": "string"
+                  }
+                ]
+              },
+              {
+                "id": "evt_01KYC06PWVE8S93JMF0J74Y1B8",
+                "key": "FROM_CLASSIFY_FAILURE",
+                "name": "From Classify Failure",
+                "payloadSchema": [
+                  {
+                    "name": "error",
+                    "required": true,
+                    "type": "string"
+                  }
+                ]
+              },
+              {
+                "id": "evt_01KYC06PWVNY4RACZE4JF4Y2SB",
+                "key": "RESET",
+                "name": "Reset"
+              },
+              {
+                "description": "The ladder proved an answer. rung names which one served it: R0 exact, R1 table, R3 retrieved, R4 learned, R5 generative.",
+                "id": "evt_01KYC06PWVFVEJE5JCZ9QGBTQS",
+                "key": "DECIDED",
+                "name": "Decided",
+                "payloadSchema": [
+                  {
+                    "name": "rung",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "confidence",
+                    "required": true,
+                    "type": "number"
+                  },
+                  {
+                    "name": "matched",
+                    "required": true,
+                    "type": "any"
+                  },
+                  {
+                    "name": "reasoning",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "primary"
+              },
+              {
+                "description": "Even the generative floor (R5) could not answer — the classify service call itself failed.",
+                "id": "evt_01KYC06PWVGZ7AWD6PYD2DCZN9",
+                "key": "DECISION_FAILED",
+                "name": "Decision Failed",
+                "payloadSchema": [
+                  {
+                    "name": "reason",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "primary"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              },
+              {
+                "name": "decided"
+              },
+              {
+                "name": "failed"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.rung",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.confidence",
+                    0.0
+                  ],
+                  [
+                    "set",
+                    "@entity.reasoning",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.failReason",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "idle"
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01KYC06PWVJR97P13P65CMY1XQ",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.rung",
+                    "R0"
+                  ],
+                  [
+                    "set",
+                    "@entity.confidence",
+                    1.0
+                  ],
+                  [
+                    "set",
+                    "@entity.reasoning",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "decided"
+                  ],
+                  [
+                    "emit",
+                    "DECIDED",
+                    {
+                      "confidence": 1.0,
+                      "matched": "@payload.key",
+                      "reasoning": "",
+                      "rung": "R0"
+                    }
+                  ]
+                ],
+                "event": "FROM_EXACT",
+                "eventId": "evt_01KYC06PWVWPQZRX9XD2KYS0WX",
+                "from": "idle",
+                "to": "decided"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.rung",
+                    "R1"
+                  ],
+                  [
+                    "set",
+                    "@entity.confidence",
+                    1.0
+                  ],
+                  [
+                    "set",
+                    "@entity.reasoning",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "decided"
+                  ],
+                  [
+                    "emit",
+                    "DECIDED",
+                    {
+                      "confidence": 1.0,
+                      "matched": "@payload.entry",
+                      "reasoning": "",
+                      "rung": "R1"
+                    }
+                  ]
+                ],
+                "event": "FROM_LOOKUP",
+                "eventId": "evt_01KYC06PWVBMW1ZPR7WRYECYHJ",
+                "from": "idle",
+                "to": "decided"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.rung",
+                    "R3"
+                  ],
+                  [
+                    "set",
+                    "@entity.confidence",
+                    "@payload.score"
+                  ],
+                  [
+                    "set",
+                    "@entity.reasoning",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "decided"
+                  ],
+                  [
+                    "emit",
+                    "DECIDED",
+                    {
+                      "confidence": "@payload.score",
+                      "matched": "@payload.index",
+                      "reasoning": "",
+                      "rung": "R3"
+                    }
+                  ]
+                ],
+                "event": "FROM_SIMILARITY",
+                "eventId": "evt_01KYC06PWVSQC5XWD4TBQWMYHJ",
+                "from": "idle",
+                "to": "decided"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.rung",
+                    "R4"
+                  ],
+                  [
+                    "set",
+                    "@entity.confidence",
+                    "@payload.confidence"
+                  ],
+                  [
+                    "set",
+                    "@entity.reasoning",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "decided"
+                  ],
+                  [
+                    "emit",
+                    "DECIDED",
+                    {
+                      "confidence": "@payload.confidence",
+                      "matched": "@payload.output",
+                      "reasoning": "",
+                      "rung": "R4"
+                    }
+                  ]
+                ],
+                "event": "FROM_INFER",
+                "eventId": "evt_01KYC06PWVFMCH8Q4XEN2FJGKY",
+                "from": "idle",
+                "to": "decided"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.rung",
+                    "R5"
+                  ],
+                  [
+                    "set",
+                    "@entity.confidence",
+                    "@payload.confidence"
+                  ],
+                  [
+                    "set",
+                    "@entity.reasoning",
+                    "@payload.reasoning"
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "decided"
+                  ],
+                  [
+                    "emit",
+                    "DECIDED",
+                    {
+                      "confidence": "@payload.confidence",
+                      "matched": "@payload.category",
+                      "reasoning": "@payload.reasoning",
+                      "rung": "R5"
+                    }
+                  ]
+                ],
+                "event": "FROM_CLASSIFY",
+                "eventId": "evt_01KYC06PWV50NDP6J22QHK7PWE",
+                "from": "idle",
+                "to": "decided"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.failReason",
+                    "@payload.error"
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "failed"
+                  ],
+                  [
+                    "emit",
+                    "DECISION_FAILED",
+                    {
+                      "reason": "@payload.error"
+                    }
+                  ]
+                ],
+                "event": "FROM_CLASSIFY_FAILURE",
+                "eventId": "evt_01KYC06PWVE8S93JMF0J74Y1B8",
+                "from": "idle",
+                "to": "failed"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.status",
+                    "decided"
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01KYC06PWVJR97P13P65CMY1XQ",
+                "from": "decided",
+                "to": "decided"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.rung",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.confidence",
+                    0.0
+                  ],
+                  [
+                    "set",
+                    "@entity.reasoning",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.failReason",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "idle"
+                  ]
+                ],
+                "event": "RESET",
+                "eventId": "evt_01KYC06PWVNY4RACZE4JF4Y2SB",
+                "from": "decided",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.status",
+                    "failed"
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01KYC06PWVJR97P13P65CMY1XQ",
+                "from": "failed",
+                "to": "failed"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.rung",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.confidence",
+                    0.0
+                  ],
+                  [
+                    "set",
+                    "@entity.reasoning",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.failReason",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "idle"
+                  ]
+                ],
+                "event": "RESET",
+                "eventId": "evt_01KYC06PWVNY4RACZE4JF4Y2SB",
+                "from": "failed",
+                "to": "idle"
+              }
+            ]
+          }
+        }
+      ],
+      "uses": [
+        {
+          "as": "Rung0",
+          "from": "std/behaviors/std-ml-exact-check"
+        },
+        {
+          "as": "Rung1",
+          "from": "std/behaviors/std-ml-lookup"
+        },
+        {
+          "as": "Rung3",
+          "from": "std/behaviors/std-ml-similarity"
+        },
+        {
+          "as": "Rung4",
+          "from": "std/behaviors/std-ml-infer"
+        },
+        {
+          "as": "Rung5",
+          "from": "std/behaviors/std-ml-classify"
+        }
+      ]
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}