@almadar/std 16.144.0 → 16.145.0

package/dist/behaviors/registry/ml/molecules/std-knowledge-tracing.orb

@@ -0,0 +1,577 @@
+{
+  "description": "std-knowledge-tracing — turns one true/false observation ('did the learner get this right?') into a tracked belief about mastery, and captures the same observation as a labeled training example in the same motion. Composes std-ml-posterior (the R2 statistical rung — a Beta-Bernoulli belief over an unknown success rate) with std-ml-label-capture: every posterior verdict — MASTERY_REACHED, REMEDIATION_NEEDED, or the abstain EVIDENCE_INSUFFICIENT — becomes a persisted labeled example (the input skill, the posterior's own verdict, and the ground-truth outcome that produced it), so a cheaper rung can later be trained to reproduce the same call without running the statistics. Domain-agnostic: it knows about skills and observations, not students, quizzes, or courses. One instance tracks one belief (e.g. one learner × one skill); the host composes as many instances as it has beliefs to hold.",
+  "ledger": {
+    "entries": {
+      "ent_01KYBPCRSCQ4W4H3RKZKNA8GE3": {
+        "bakedName": "KnowledgeState",
+        "curName": "KnowledgeState",
+        "id": "ent_01KYBPCRSCQ4W4H3RKZKNA8GE3",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01KYBPCRSC5KF14SRWR89Z1G7V": {
+        "bakedName": "OBSERVE_SKILL",
+        "curName": "OBSERVE_SKILL",
+        "id": "evt_01KYBPCRSC5KF14SRWR89Z1G7V",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYBPCRSCJHYN6SRGV3FFTF9B",
+        "renames": []
+      },
+      "evt_01KYBPCRSCG3Q7AZ9J37R13ZMD": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01KYBPCRSCG3Q7AZ9J37R13ZMD",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYBPCRSCJHYN6SRGV3FFTF9B",
+        "renames": []
+      },
+      "evt_01KYBPNGX06S803X783YQBBMKK": {
+        "bakedName": "CAPTURE_LABEL",
+        "curName": "CAPTURE_LABEL",
+        "id": "evt_01KYBPNGX06S803X783YQBBMKK",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYBPCRSCJHYN6SRGV3FFTF9B",
+        "renames": []
+      },
+      "evt_01KYBPNGX0R5B88XX3RC2CVAH9": {
+        "bakedName": "OBSERVATION_MADE",
+        "curName": "OBSERVATION_MADE",
+        "id": "evt_01KYBPNGX0R5B88XX3RC2CVAH9",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYBPCRSCJHYN6SRGV3FFTF9B",
+        "renames": []
+      },
+      "evt_01KYBPNGX0VJ2TZ37PRV9S8N1J": {
+        "bakedName": "VERDICT_REACHED",
+        "curName": "VERDICT_REACHED",
+        "id": "evt_01KYBPNGX0VJ2TZ37PRV9S8N1J",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYBPCRSCJHYN6SRGV3FFTF9B",
+        "renames": []
+      },
+      "orb_01KYBPCRSCMEMPXWZJ1GAJW4NK": {
+        "bakedName": "KnowledgeTracingOrbital",
+        "curName": "KnowledgeTracingOrbital",
+        "id": "orb_01KYBPCRSCMEMPXWZJ1GAJW4NK",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01KYBPCRSC8M9W90V5F6KT16DC": {
+        "bakedName": "KnowledgeTracingPage",
+        "curName": "KnowledgeTracingPage",
+        "id": "pag_01KYBPCRSC8M9W90V5F6KT16DC",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01KYBPCRSCEJWQAM1J6CMXCJRP": {
+        "bakedName": "PosteriorTracker",
+        "curName": "PosteriorTracker",
+        "id": "trt_01KYBPCRSCEJWQAM1J6CMXCJRP",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01KYBPCRSCJHYN6SRGV3FFTF9B": {
+        "bakedName": "ObservationRelay",
+        "curName": "ObservationRelay",
+        "id": "trt_01KYBPCRSCJHYN6SRGV3FFTF9B",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01KYBPCRSCZ0PK3PM8V8H47V2Y": {
+        "bakedName": "Labels",
+        "curName": "Labels",
+        "id": "trt_01KYBPCRSCZ0PK3PM8V8H47V2Y",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "std-knowledge-tracing",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "default": "",
+            "name": "skillId",
+            "type": "string"
+          },
+          {
+            "default": false,
+            "name": "lastOutcome",
+            "type": "boolean"
+          },
+          {
+            "default": 1.0,
+            "name": "alpha",
+            "type": "number"
+          },
+          {
+            "default": 1.0,
+            "name": "beta",
+            "type": "number"
+          },
+          {
+            "default": 0.0,
+            "name": "mean",
+            "type": "number"
+          },
+          {
+            "default": 0.0,
+            "name": "intervalLow",
+            "type": "number"
+          },
+          {
+            "default": 0.0,
+            "name": "intervalHigh",
+            "type": "number"
+          },
+          {
+            "default": 0.0,
+            "name": "observations",
+            "type": "number"
+          },
+          {
+            "default": "idle",
+            "name": "status",
+            "type": "string",
+            "values": [
+              "idle",
+              "insufficient",
+              "mastered",
+              "remediate"
+            ]
+          },
+          {
+            "name": "input",
+            "type": "string"
+          },
+          {
+            "name": "verdict",
+            "type": "string"
+          },
+          {
+            "default": "",
+            "name": "source",
+            "type": "string"
+          },
+          {
+            "name": "outcome",
+            "type": "string"
+          },
+          {
+            "default": "",
+            "name": "sink",
+            "type": "string"
+          },
+          {
+            "default": 0.0,
+            "name": "recordedAt",
+            "type": "number"
+          }
+        ],
+        "id": "ent_01KYBPCRSCQ4W4H3RKZKNA8GE3",
+        "name": "KnowledgeState",
+        "persistence": "runtime",
+        "shared": true
+      },
+      "id": "orb_01KYBPCRSCMEMPXWZJ1GAJW4NK",
+      "name": "KnowledgeTracingOrbital",
+      "pages": [
+        {
+          "id": "pag_01KYBPCRSC8M9W90V5F6KT16DC",
+          "name": "KnowledgeTracingPage",
+          "path": "/knowledge-tracing",
+          "traits": [
+            {
+              "ref": "ObservationRelay",
+              "refId": "trt_01KYBPCRSCJHYN6SRGV3FFTF9B"
+            },
+            {
+              "ref": "PosteriorTracker",
+              "refId": "trt_01KYBPCRSCEJWQAM1J6CMXCJRP"
+            },
+            {
+              "ref": "Labels",
+              "refId": "trt_01KYBPCRSCZ0PK3PM8V8H47V2Y"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "lifecycle",
+          "emits": [
+            {
+              "description": "Forwards the raw outcome to PosteriorTracker once skillId is recorded on the shared entity.",
+              "event": "OBSERVATION_MADE",
+              "eventId": "evt_01KYBPNGX0R5B88XX3RC2CVAH9",
+              "payloadSchema": [
+                {
+                  "name": "outcome",
+                  "required": true,
+                  "type": "boolean"
+                }
+              ],
+              "tier": "secondary"
+            },
+            {
+              "description": "The posterior's verdict reshaped into a labeled example for LabelCaptureListener.",
+              "event": "CAPTURE_LABEL",
+              "eventId": "evt_01KYBPNGX06S803X783YQBBMKK",
+              "payloadSchema": [
+                {
+                  "name": "input",
+                  "required": true,
+                  "type": "any"
+                },
+                {
+                  "name": "verdict",
+                  "required": true,
+                  "type": "any"
+                },
+                {
+                  "name": "source",
+                  "required": true,
+                  "type": "string"
+                },
+                {
+                  "name": "outcome",
+                  "type": "any"
+                }
+              ],
+              "tier": "secondary"
+            }
+          ],
+          "entityRefIds": {
+            "KnowledgeState": "ent_01KYBPCRSCQ4W4H3RKZKNA8GE3"
+          },
+          "id": "trt_01KYBPCRSCJHYN6SRGV3FFTF9B",
+          "linkedEntity": "KnowledgeState",
+          "linkedEntityId": "ent_01KYBPCRSCQ4W4H3RKZKNA8GE3",
+          "listens": [
+            {
+              "event": "MASTERY_REACHED",
+              "payloadMapping": {
+                "intervalHigh": "@payload.intervalHigh",
+                "intervalLow": "@payload.intervalLow",
+                "mean": "@payload.mean",
+                "status": "mastered"
+              },
+              "source": {
+                "kind": "trait",
+                "trait": "PosteriorTracker",
+                "traitId": "trt_01KYBPCRSCEJWQAM1J6CMXCJRP"
+              },
+              "triggers": "VERDICT_REACHED",
+              "triggersId": "evt_01KYBPNGX0VJ2TZ37PRV9S8N1J"
+            },
+            {
+              "event": "REMEDIATION_NEEDED",
+              "payloadMapping": {
+                "intervalHigh": "@payload.intervalHigh",
+                "intervalLow": "@payload.intervalLow",
+                "mean": "@payload.mean",
+                "status": "remediate"
+              },
+              "source": {
+                "kind": "trait",
+                "trait": "PosteriorTracker",
+                "traitId": "trt_01KYBPCRSCEJWQAM1J6CMXCJRP"
+              },
+              "triggers": "VERDICT_REACHED",
+              "triggersId": "evt_01KYBPNGX0VJ2TZ37PRV9S8N1J"
+            },
+            {
+              "event": "EVIDENCE_INSUFFICIENT",
+              "payloadMapping": {
+                "intervalHigh": "@payload.intervalHigh",
+                "intervalLow": "@payload.intervalLow",
+                "mean": "@payload.mean",
+                "status": "insufficient"
+              },
+              "source": {
+                "kind": "trait",
+                "trait": "PosteriorTracker",
+                "traitId": "trt_01KYBPCRSCEJWQAM1J6CMXCJRP"
+              },
+              "triggers": "VERDICT_REACHED",
+              "triggersId": "evt_01KYBPNGX0VJ2TZ37PRV9S8N1J"
+            }
+          ],
+          "name": "ObservationRelay",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01KYBPCRSCG3Q7AZ9J37R13ZMD",
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "description": "Public entry point — one true/false observation of a learner against one skill.",
+                "id": "evt_01KYBPCRSC5KF14SRWR89Z1G7V",
+                "key": "OBSERVE_SKILL",
+                "name": "Observe Skill",
+                "payloadSchema": [
+                  {
+                    "name": "skillId",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "outcome",
+                    "required": true,
+                    "type": "boolean"
+                  }
+                ],
+                "tier": "primary"
+              },
+              {
+                "description": "Any posterior verdict, tagged with which one it was.",
+                "id": "evt_01KYBPNGX0VJ2TZ37PRV9S8N1J",
+                "key": "VERDICT_REACHED",
+                "name": "Verdict Reached",
+                "payloadSchema": [
+                  {
+                    "name": "status",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "mean",
+                    "required": true,
+                    "type": "float"
+                  },
+                  {
+                    "name": "intervalLow",
+                    "required": true,
+                    "type": "float"
+                  },
+                  {
+                    "name": "intervalHigh",
+                    "required": true,
+                    "type": "float"
+                  }
+                ],
+                "tier": "secondary"
+              },
+              {
+                "description": "Forwards the raw outcome to PosteriorTracker once skillId is recorded on the shared entity.",
+                "id": "evt_01KYBPNGX0R5B88XX3RC2CVAH9",
+                "key": "OBSERVATION_MADE",
+                "name": "Observation Made",
+                "payloadSchema": [
+                  {
+                    "name": "outcome",
+                    "required": true,
+                    "type": "boolean"
+                  }
+                ],
+                "tier": "secondary"
+              },
+              {
+                "description": "The posterior's verdict reshaped into a labeled example for LabelCaptureListener.",
+                "id": "evt_01KYBPNGX06S803X783YQBBMKK",
+                "key": "CAPTURE_LABEL",
+                "name": "Capture Label",
+                "payloadSchema": [
+                  {
+                    "name": "input",
+                    "required": true,
+                    "type": "any"
+                  },
+                  {
+                    "name": "verdict",
+                    "required": true,
+                    "type": "any"
+                  },
+                  {
+                    "name": "source",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "outcome",
+                    "type": "any"
+                  }
+                ],
+                "tier": "secondary"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.skillId",
+                    ""
+                  ],
+                  [
+                    "set",
+                    "@entity.lastOutcome",
+                    false
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01KYBPCRSCG3Q7AZ9J37R13ZMD",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.skillId",
+                    "@payload.skillId"
+                  ],
+                  [
+                    "set",
+                    "@entity.lastOutcome",
+                    "@payload.outcome"
+                  ],
+                  [
+                    "emit",
+                    "OBSERVATION_MADE",
+                    {
+                      "outcome": "@payload.outcome"
+                    }
+                  ]
+                ],
+                "event": "OBSERVE_SKILL",
+                "eventId": "evt_01KYBPCRSC5KF14SRWR89Z1G7V",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "emit",
+                    "CAPTURE_LABEL",
+                    {
+                      "input": {
+                        "skillId": "@entity.skillId"
+                      },
+                      "outcome": "@entity.lastOutcome",
+                      "source": "posterior",
+                      "verdict": {
+                        "intervalHigh": "@payload.intervalHigh",
+                        "intervalLow": "@payload.intervalLow",
+                        "mean": "@payload.mean",
+                        "status": "@payload.status"
+                      }
+                    }
+                  ]
+                ],
+                "event": "VERDICT_REACHED",
+                "eventId": "evt_01KYBPNGX0VJ2TZ37PRV9S8N1J",
+                "from": "idle",
+                "to": "idle"
+              }
+            ]
+          }
+        },
+        {
+          "config": {
+            "intervalWidthMax": {
+              "default": 0.25,
+              "type": "unknown"
+            },
+            "masteryFloor": {
+              "default": 0.85,
+              "type": "unknown"
+            },
+            "priorAlpha": {
+              "default": 1.0,
+              "type": "unknown"
+            },
+            "priorBeta": {
+              "default": 1.0,
+              "type": "unknown"
+            },
+            "remediationCeiling": {
+              "default": 0.35,
+              "type": "unknown"
+            },
+            "sampleCount": {
+              "default": 200.0,
+              "type": "unknown"
+            }
+          },
+          "id": "trt_01KYBPCRSCEJWQAM1J6CMXCJRP",
+          "linkedEntity": "KnowledgeState",
+          "linkedEntityId": "ent_01KYBPCRSCQ4W4H3RKZKNA8GE3",
+          "listens": [
+            {
+              "event": "OBSERVATION_MADE",
+              "source": {
+                "kind": "trait",
+                "trait": "ObservationRelay"
+              },
+              "triggers": "OBSERVE"
+            }
+          ],
+          "name": "PosteriorTracker",
+          "ref": "Posterior.traits.PosteriorBelief"
+        },
+        {
+          "config": {
+            "sampleRate": {
+              "default": 1.0,
+              "type": "unknown"
+            },
+            "sink": {
+              "default": "knowledge-tracing",
+              "type": "unknown"
+            }
+          },
+          "id": "trt_01KYBPCRSCZ0PK3PM8V8H47V2Y",
+          "linkedEntity": "KnowledgeState",
+          "linkedEntityId": "ent_01KYBPCRSCQ4W4H3RKZKNA8GE3",
+          "listens": [
+            {
+              "event": "CAPTURE_LABEL",
+              "source": {
+                "kind": "trait",
+                "trait": "ObservationRelay"
+              },
+              "triggers": "CAPTURE"
+            }
+          ],
+          "name": "Labels",
+          "ref": "LabelCap.traits.LabelCaptureListener"
+        }
+      ],
+      "uses": [
+        {
+          "as": "Posterior",
+          "from": "std/behaviors/std-ml-posterior"
+        },
+        {
+          "as": "LabelCap",
+          "from": "std/behaviors/std-ml-label-capture"
+        }
+      ]
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}