@almadar/std 16.243.0 → 16.244.0

package/behaviors/registry/ui/learning/atoms/std-learn-scatter-fit.orb

@@ -100,6 +100,15 @@
         "parent": "trt_01M0CGSNDKZW4BAAQ48B923K0C",
         "renames": []
       },
+      "evt_01M459WQQNEVCGWRAKJ3M6R067": {
+        "bakedName": "ROSTER_LOADED",
+        "curName": "ROSTER_LOADED",
+        "id": "evt_01M459WQQNEVCGWRAKJ3M6R067",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0CGSNDKZW4BAAQ48B923K0C",
+        "renames": []
+      },
       "orb_01M0CGSNDKXGJ1SK9X9MV7YKYG": {
         "bakedName": "LearnScatterFitOrbital",
         "curName": "LearnScatterFitOrbital",
@@ -146,6 +155,45 @@
             "name": "title",
             "type": "string"
           },
+          {
+            "items": {
+              "properties": {
+                "color": {
+                  "name": "color",
+                  "required": false,
+                  "type": "string"
+                },
+                "id": {
+                  "name": "id",
+                  "required": false,
+                  "type": "string"
+                },
+                "label": {
+                  "name": "label",
+                  "required": false,
+                  "type": "string"
+                },
+                "radius": {
+                  "name": "radius",
+                  "required": false,
+                  "type": "number"
+                },
+                "x": {
+                  "name": "x",
+                  "required": true,
+                  "type": "number"
+                },
+                "y": {
+                  "name": "y",
+                  "required": true,
+                  "type": "number"
+                }
+              },
+              "type": "object"
+            },
+            "name": "initialPoints",
+            "type": "array"
+          },
           {
             "items": {
               "properties": {
@@ -547,7 +595,7 @@
             },
             "matchMode": {
               "default": "",
-              "description": "When composed behind a lab router, the MODE_SELECTED mode value this instrument responds to. Empty string means standalone — render immediately on INIT.",
+              "description": "When composed behind a lab router, the MODE_SELECTED mode value this instrument responds to. Empty string means standalone — render immediately on INIT, or on ROSTER_LOADED when rosterSource is event.",
               "label": "Match Mode",
               "tier": "presentation",
               "type": "string"
@@ -669,6 +717,17 @@
               "tier": "presentation",
               "type": "string"
             },
+            "rosterSource": {
+              "default": "config",
+              "description": "Where the roster comes from: config reads initialPoints knob at INIT; event waits for ROSTER_LOADED and takes the roster from its payload.",
+              "label": "Roster Source",
+              "tier": "domain",
+              "type": "string",
+              "values": [
+                "config",
+                "event"
+              ]
+            },
             "runLabel": {
               "default": "Run",
               "label": "Run Button Label",
@@ -793,6 +852,10 @@
               "kind": "set",
               "resource": "@entity.guessSlope"
             },
+            {
+              "kind": "set",
+              "resource": "@entity.initialPoints"
+            },
             {
               "kind": "set",
               "resource": "@entity.intercept"
@@ -926,6 +989,7 @@
               "guessIntercept",
               "guessScore",
               "guessSlope",
+              "initialPoints",
               "intercept",
               "narration",
               "points",
@@ -965,128 +1029,1058 @@
                     "type": "string"
                   }
                 ],
-                "tier": "domain"
-              },
-              {
-                "id": "evt_01M0CGSNDNFVTB79M3560MKVB4",
-                "key": "ADD_POINT",
-                "name": "Add Point"
-              },
-              {
-                "description": "A scatter point was dragged — id names the point, x/y its new coordinates (clamped to the axis ranges); the fit recomputes live.",
-                "id": "evt_01M0CGSNDNYV2VV7N4281G3X6X",
-                "key": "DRAG_POINT",
-                "name": "Drag Point",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string"
-                  },
-                  {
-                    "name": "x",
-                    "type": "number"
-                  },
-                  {
-                    "name": "y",
-                    "type": "number"
-                  }
+                "tier": "domain"
+              },
+              {
+                "description": "Runtime content feed, honoured only when rosterSource is event — mode names the instrument it is for (the matchMode it carries, blank when standalone) and initialPoints is the starting point set; a matching instrument re-initialises from it exactly as INIT does from config, any other instrument hides.",
+                "id": "evt_01M459WQQNEVCGWRAKJ3M6R067",
+                "key": "ROSTER_LOADED",
+                "name": "Roster Loaded",
+                "payloadSchema": [
+                  {
+                    "name": "mode",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "initialPoints",
+                    "properties": [
+                      {
+                        "name": "id",
+                        "type": "string"
+                      },
+                      {
+                        "name": "x",
+                        "required": true,
+                        "type": "number"
+                      },
+                      {
+                        "name": "y",
+                        "required": true,
+                        "type": "number"
+                      },
+                      {
+                        "name": "label",
+                        "type": "string"
+                      },
+                      {
+                        "name": "color",
+                        "type": "string"
+                      },
+                      {
+                        "name": "radius",
+                        "type": "number"
+                      }
+                    ],
+                    "required": true,
+                    "type": "[object]"
+                  }
+                ],
+                "tier": "domain"
+              },
+              {
+                "id": "evt_01M0CGSNDNFVTB79M3560MKVB4",
+                "key": "ADD_POINT",
+                "name": "Add Point"
+              },
+              {
+                "description": "A scatter point was dragged — id names the point, x/y its new coordinates (clamped to the axis ranges); the fit recomputes live.",
+                "id": "evt_01M0CGSNDNYV2VV7N4281G3X6X",
+                "key": "DRAG_POINT",
+                "name": "Drag Point",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "type": "string"
+                  },
+                  {
+                    "name": "x",
+                    "type": "number"
+                  },
+                  {
+                    "name": "y",
+                    "type": "number"
+                  }
+                ],
+                "tier": "domain"
+              },
+              {
+                "description": "Learner dragged a guess-the-line slider — param is slope or intercept; the guess is scored against the least-squares fit.",
+                "id": "evt_01M0CGSNDNWS2K4R391QPXQYFG",
+                "key": "GUESS_LINE",
+                "name": "Guess Line",
+                "payloadSchema": [
+                  {
+                    "name": "param",
+                    "type": "string"
+                  },
+                  {
+                    "name": "value",
+                    "type": "number"
+                  }
+                ],
+                "tier": "domain"
+              },
+              {
+                "id": "evt_01M0CGSNDN7W9T6E8N52B3FT19",
+                "key": "REVEAL_FIT",
+                "name": "Reveal Fit"
+              },
+              {
+                "id": "evt_01M0CGSNDN9PCGWDRC046WE6AB",
+                "key": "TOGGLE_RUN",
+                "name": "Toggle Run"
+              },
+              {
+                "id": "evt_01M0CGSNDN1VCP026JN2M802CH",
+                "key": "RESET",
+                "name": "Reset"
+              },
+              {
+                "description": "The least-squares fit and narration after each learner action, auto-add tick, or reset — a composed listener (readout, grader) can subscribe; a harmless no-op when the atom runs standalone.",
+                "id": "evt_01M0CGSNDNRJ5SEN6M870GKYWG",
+                "key": "LEARN_SCATTER_FIT_UPDATED",
+                "name": "Learn Scatter Fit Updated",
+                "payloadSchema": [
+                  {
+                    "name": "slope",
+                    "type": "number"
+                  },
+                  {
+                    "name": "intercept",
+                    "type": "number"
+                  },
+                  {
+                    "name": "r",
+                    "type": "number"
+                  },
+                  {
+                    "name": "rSquared",
+                    "type": "number"
+                  },
+                  {
+                    "name": "pointCount",
+                    "type": "number"
+                  },
+                  {
+                    "name": "narration",
+                    "type": "string"
+                  }
+                ],
+                "synonyms": "fit update, line of best fit, slope, intercept, correlation, r squared",
+                "tier": "domain"
+              },
+              {
+                "description": "Fired once when the point that reaches maxPoints lands and the round latches done — the standard learning completion broadcast a celebration/progression sibling (fx cues, badges) rides.",
+                "id": "evt_01M0GTSZG6B8B6VFWSEN7M2AT4",
+                "key": "LEARN_ROUND_COMPLETE",
+                "name": "Learn Round Complete",
+                "payloadSchema": [
+                  {
+                    "name": "score",
+                    "type": "number"
+                  },
+                  {
+                    "name": "total",
+                    "type": "number"
+                  }
+                ],
+                "synonyms": "round complete, finished, done, completion, max points",
+                "tier": "domain"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.initialPoints",
+                    "@config.initialPoints"
+                  ],
+                  [
+                    "set",
+                    "@entity.active",
+                    true
+                  ],
+                  [
+                    "set",
+                    "@entity.title",
+                    "@config.title"
+                  ],
+                  [
+                    "set",
+                    "@entity.points",
+                    "@config.initialPoints"
+                  ],
+                  [
+                    "set",
+                    "@entity.guessSlope",
+                    0.0
+                  ],
+                  [
+                    "set",
+                    "@entity.guessIntercept",
+                    [
+                      "/",
+                      [
+                        "+",
+                        "@config.axisYMin",
+                        "@config.axisYMax"
+                      ],
+                      2.0
+                    ]
+                  ],
+                  [
+                    "set",
+                    "@entity.revealed",
+                    false
+                  ],
+                  [
+                    "set",
+                    "@entity.running",
+                    "@config.autoRun"
+                  ],
+                  [
+                    "let",
+                    [
+                      [
+                        "pts",
+                        "@config.initialPoints"
+                      ],
+                      [
+                        "n",
+                        [
+                          "array/len",
+                          "@pts"
+                        ]
+                      ],
+                      [
+                        "meanX",
+                        [
+                          "if",
+                          [
+                            ">",
+                            "@n",
+                            0.0
+                          ],
+                          [
+                            "/",
+                            [
+                              "array/reduce",
+                              "@pts",
+                              0.0,
+                              [
+                                "fn",
+                                [
+                                  "acc",
+                                  "p"
+                                ],
+                                [
+                                  "+",
+                                  "@acc",
+                                  [
+                                    "object/get",
+                                    "@p",
+                                    "x"
+                                  ]
+                                ]
+                              ]
+                            ],
+                            "@n"
+                          ],
+                          0.0
+                        ]
+                      ],
+                      [
+                        "meanY",
+                        [
+                          "if",
+                          [
+                            ">",
+                            "@n",
+                            0.0
+                          ],
+                          [
+                            "/",
+                            [
+                              "array/reduce",
+                              "@pts",
+                              0.0,
+                              [
+                                "fn",
+                                [
+                                  "acc",
+                                  "p"
+                                ],
+                                [
+                                  "+",
+                                  "@acc",
+                                  [
+                                    "object/get",
+                                    "@p",
+                                    "y"
+                                  ]
+                                ]
+                              ]
+                            ],
+                            "@n"
+                          ],
+                          0.0
+                        ]
+                      ],
+                      [
+                        "sxx",
+                        [
+                          "array/reduce",
+                          "@pts",
+                          0.0,
+                          [
+                            "fn",
+                            [
+                              "acc",
+                              "p"
+                            ],
+                            [
+                              "let",
+                              [
+                                [
+                                  "dx",
+                                  [
+                                    "-",
+                                    [
+                                      "object/get",
+                                      "@p",
+                                      "x"
+                                    ],
+                                    "@meanX"
+                                  ]
+                                ]
+                              ],
+                              [
+                                "+",
+                                "@acc",
+                                [
+                                  "*",
+                                  "@dx",
+                                  "@dx"
+                                ]
+                              ]
+                            ]
+                          ]
+                        ]
+                      ],
+                      [
+                        "syy",
+                        [
+                          "array/reduce",
+                          "@pts",
+                          0.0,
+                          [
+                            "fn",
+                            [
+                              "acc",
+                              "p"
+                            ],
+                            [
+                              "let",
+                              [
+                                [
+                                  "dy",
+                                  [
+                                    "-",
+                                    [
+                                      "object/get",
+                                      "@p",
+                                      "y"
+                                    ],
+                                    "@meanY"
+                                  ]
+                                ]
+                              ],
+                              [
+                                "+",
+                                "@acc",
+                                [
+                                  "*",
+                                  "@dy",
+                                  "@dy"
+                                ]
+                              ]
+                            ]
+                          ]
+                        ]
+                      ],
+                      [
+                        "sxy",
+                        [
+                          "array/reduce",
+                          "@pts",
+                          0.0,
+                          [
+                            "fn",
+                            [
+                              "acc",
+                              "p"
+                            ],
+                            [
+                              "+",
+                              "@acc",
+                              [
+                                "*",
+                                [
+                                  "-",
+                                  [
+                                    "object/get",
+                                    "@p",
+                                    "x"
+                                  ],
+                                  "@meanX"
+                                ],
+                                [
+                                  "-",
+                                  [
+                                    "object/get",
+                                    "@p",
+                                    "y"
+                                  ],
+                                  "@meanY"
+                                ]
+                              ]
+                            ]
+                          ]
+                        ]
+                      ],
+                      [
+                        "newSlope",
+                        [
+                          "if",
+                          [
+                            ">",
+                            "@sxx",
+                            0.0
+                          ],
+                          [
+                            "/",
+                            "@sxy",
+                            "@sxx"
+                          ],
+                          0.0
+                        ]
+                      ],
+                      [
+                        "newIntercept",
+                        [
+                          "-",
+                          "@meanY",
+                          [
+                            "*",
+                            "@newSlope",
+                            "@meanX"
+                          ]
+                        ]
+                      ],
+                      [
+                        "newR",
+                        [
+                          "if",
+                          [
+                            "and",
+                            [
+                              ">",
+                              "@sxx",
+                              0.0
+                            ],
+                            [
+                              ">",
+                              "@syy",
+                              0.0
+                            ]
+                          ],
+                          [
+                            "/",
+                            "@sxy",
+                            [
+                              "math/sqrt",
+                              [
+                                "*",
+                                "@sxx",
+                                "@syy"
+                              ]
+                            ]
+                          ],
+                          0.0
+                        ]
+                      ],
+                      [
+                        "fitCurve",
+                        {
+                          "color": "@config.fitColor",
+                          "label": "@config.fitLabel",
+                          "samples": [
+                            {
+                              "x": "@config.axisXMin",
+                              "y": [
+                                "math/clamp",
+                                "@newIntercept",
+                                "@config.axisYMin",
+                                "@config.axisYMax"
+                              ]
+                            },
+                            {
+                              "x": "@config.axisXMax",
+                              "y": [
+                                "math/clamp",
+                                [
+                                  "+",
+                                  [
+                                    "*",
+                                    "@newSlope",
+                                    "@config.axisXMax"
+                                  ],
+                                  "@newIntercept"
+                                ],
+                                "@config.axisYMin",
+                                "@config.axisYMax"
+                              ]
+                            }
+                          ]
+                        }
+                      ],
+                      [
+                        "residualCurves",
+                        [
+                          "if",
+                          "@config.showResiduals",
+                          [
+                            "array/map",
+                            "@pts",
+                            [
+                              "fn",
+                              "p",
+                              {
+                                "color": "@config.residualColor",
+                                "dash": "@config.residualDash",
+                                "label": "",
+                                "samples": [
+                                  {
+                                    "x": [
+                                      "object/get",
+                                      "@p",
+                                      "x"
+                                    ],
+                                    "y": [
+                                      "object/get",
+                                      "@p",
+                                      "y"
+                                    ]
+                                  },
+                                  {
+                                    "x": [
+                                      "object/get",
+                                      "@p",
+                                      "x"
+                                    ],
+                                    "y": [
+                                      "+",
+                                      [
+                                        "*",
+                                        "@newSlope",
+                                        [
+                                          "object/get",
+                                          "@p",
+                                          "x"
+                                        ]
+                                      ],
+                                      "@newIntercept"
+                                    ]
+                                  }
+                                ]
+                              }
+                            ]
+                          ],
+                          []
+                        ]
+                      ]
+                    ],
+                    [
+                      "do",
+                      [
+                        "set",
+                        "@entity.slope",
+                        "@newSlope"
+                      ],
+                      [
+                        "set",
+                        "@entity.intercept",
+                        "@newIntercept"
+                      ],
+                      [
+                        "set",
+                        "@entity.r",
+                        "@newR"
+                      ],
+                      [
+                        "set",
+                        "@entity.rSquared",
+                        [
+                          "*",
+                          "@newR",
+                          "@newR"
+                        ]
+                      ],
+                      [
+                        "set",
+                        "@entity.guessScore",
+                        0.0
+                      ],
+                      [
+                        "set",
+                        "@entity.curves",
+                        [
+                          "array/concat",
+                          [
+                            "array/append",
+                            [],
+                            "@fitCurve"
+                          ],
+                          "@residualCurves"
+                        ]
+                      ],
+                      [
+                        "set",
+                        "@entity.done",
+                        [
+                          ">=",
+                          "@n",
+                          "@config.maxPoints"
+                        ]
+                      ],
+                      [
+                        "set",
+                        "@entity.narration",
+                        [
+                          "str/concat",
+                          [
+                            "str/concat",
+                            "",
+                            "@n"
+                          ],
+                          " ",
+                          "@config.narrationLoadedTemplate",
+                          " — r = ",
+                          [
+                            "str/concat",
+                            "",
+                            [
+                              "math/round",
+                              "@newR",
+                              3.0
+                            ]
+                          ],
+                          ", R² = ",
+                          [
+                            "str/concat",
+                            "",
+                            [
+                              "math/round",
+                              [
+                                "*",
+                                "@newR",
+                                "@newR"
+                              ],
+                              3.0
+                            ]
+                          ]
+                        ]
+                      ]
+                    ]
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "children": [
+                        {
+                          "children": [
+                            {
+                              "align": "start",
+                              "children": [
+                                {
+                                  "children": [
+                                    {
+                                      "content": "@entity.title",
+                                      "type": "typography",
+                                      "variant": "h4"
+                                    },
+                                    [
+                                      "if",
+                                      [
+                                        "==",
+                                        "@config.summary",
+                                        ""
+                                      ],
+                                      null,
+                                      {
+                                        "color": "muted",
+                                        "content": "@config.summary",
+                                        "type": "typography",
+                                        "variant": "body2"
+                                      }
+                                    ]
+                                  ],
+                                  "direction": "vertical",
+                                  "gap": "xs",
+                                  "type": "stack"
+                                },
+                                {
+                                  "label": [
+                                    "if",
+                                    "@entity.revealed",
+                                    "Revealed",
+                                    [
+                                      "if",
+                                      "@entity.done",
+                                      "Max points",
+                                      [
+                                        "if",
+                                        "@entity.running",
+                                        "Adding points",
+                                        [
+                                          "if",
+                                          "@config.guessMode",
+                                          "Guessing",
+                                          "Fitted"
+                                        ]
+                                      ]
+                                    ]
+                                  ],
+                                  "type": "badge",
+                                  "variant": [
+                                    "if",
+                                    "@entity.revealed",
+                                    "success",
+                                    [
+                                      "if",
+                                      "@entity.done",
+                                      "neutral",
+                                      [
+                                        "if",
+                                        "@entity.running",
+                                        "primary",
+                                        "neutral"
+                                      ]
+                                    ]
+                                  ]
+                                }
+                              ],
+                              "direction": "horizontal",
+                              "gap": "md",
+                              "justify": "between",
+                              "type": "stack"
+                            },
+                            {
+                              "align": "center",
+                              "children": [
+                                {
+                                  "action": "ADD_POINT",
+                                  "disabled": "@entity.done",
+                                  "icon": "plus",
+                                  "label": "@config.addPointLabel",
+                                  "type": "button",
+                                  "variant": "primary"
+                                },
+                                {
+                                  "action": "REVEAL_FIT",
+                                  "icon": "eye",
+                                  "label": "@config.revealLabel",
+                                  "type": "button",
+                                  "variant": "secondary"
+                                },
+                                [
+                                  "if",
+                                  "@entity.running",
+                                  {
+                                    "action": "TOGGLE_RUN",
+                                    "aria-pressed": "true",
+                                    "icon": "pause",
+                                    "label": "@config.pauseLabel",
+                                    "type": "button",
+                                    "variant": "secondary"
+                                  },
+                                  {
+                                    "action": "TOGGLE_RUN",
+                                    "aria-pressed": "false",
+                                    "disabled": "@entity.done",
+                                    "icon": "play",
+                                    "label": "@config.runLabel",
+                                    "type": "button",
+                                    "variant": "secondary"
+                                  }
+                                ],
+                                {
+                                  "action": "RESET",
+                                  "icon": "rotate-ccw",
+                                  "label": "@config.resetLabel",
+                                  "type": "button",
+                                  "variant": "ghost"
+                                },
+                                {
+                                  "color": "muted",
+                                  "content": [
+                                    "str/concat",
+                                    [
+                                      "str/concat",
+                                      "",
+                                      [
+                                        "array/len",
+                                        "@entity.points"
+                                      ]
+                                    ],
+                                    [
+                                      "str/concat",
+                                      " of ",
+                                      [
+                                        "str/concat",
+                                        "",
+                                        "@config.maxPoints"
+                                      ]
+                                    ]
+                                  ],
+                                  "type": "typography",
+                                  "variant": "caption"
+                                }
+                              ],
+                              "direction": "horizontal",
+                              "gap": "sm",
+                              "type": "stack",
+                              "wrap": true
+                            },
+                            {
+                              "animate": "@config.animate",
+                              "curves": "@entity.curves",
+                              "gridStep": "@config.gridStep",
+                              "height": "@config.height",
+                              "interactive": "@config.interactive",
+                              "keyMap": {
+                                "ArrowRight": "ADD_POINT",
+                                "KeyR": "RESET",
+                                "Space": "TOGGLE_RUN"
+                              },
+                              "points": "@entity.points",
+                              "showAxes": "@config.showAxes",
+                              "showGrid": "@config.showGrid",
+                              "showTickLabels": "@config.showTickLabels",
+                              "type": "math-canvas",
+                              "vectors": [],
+                              "width": "@config.width",
+                              "xMax": "@config.axisXMax",
+                              "xMin": "@config.axisXMin",
+                              "yMax": "@config.axisYMax",
+                              "yMin": "@config.axisYMin"
+                            },
+                            {
+                              "children": [
+                                {
+                                  "children": [
+                                    {
+                                      "content": [
+                                        "str/concat",
+                                        "@config.guessSlopeCaption",
+                                        [
+                                          "math/round",
+                                          "@entity.guessSlope",
+                                          2.0
+                                        ]
+                                      ],
+                                      "type": "typography",
+                                      "variant": "caption"
+                                    },
+                                    {
+                                      "action": "GUESS_LINE",
+                                      "actionPayload": {
+                                        "param": "slope"
+                                      },
+                                      "max": "@config.guessSlopeMax",
+                                      "min": "@config.guessSlopeMin",
+                                      "showTooltip": true,
+                                      "step": "@config.guessSlopeStep",
+                                      "type": "range-slider",
+                                      "value": "@entity.guessSlope"
+                                    }
+                                  ],
+                                  "direction": "vertical",
+                                  "gap": "xs",
+                                  "type": "stack"
+                                },
+                                {
+                                  "children": [
+                                    {
+                                      "content": [
+                                        "str/concat",
+                                        "@config.guessInterceptCaption",
+                                        [
+                                          "math/round",
+                                          "@entity.guessIntercept",
+                                          1.0
+                                        ]
+                                      ],
+                                      "type": "typography",
+                                      "variant": "caption"
+                                    },
+                                    {
+                                      "action": "GUESS_LINE",
+                                      "actionPayload": {
+                                        "param": "intercept"
+                                      },
+                                      "max": "@config.guessInterceptMax",
+                                      "min": "@config.guessInterceptMin",
+                                      "showTooltip": true,
+                                      "step": "@config.guessInterceptStep",
+                                      "type": "range-slider",
+                                      "value": "@entity.guessIntercept"
+                                    }
+                                  ],
+                                  "direction": "vertical",
+                                  "gap": "xs",
+                                  "type": "stack"
+                                }
+                              ],
+                              "direction": "vertical",
+                              "gap": "sm",
+                              "type": "stack"
+                            },
+                            {
+                              "color": "muted",
+                              "content": [
+                                "if",
+                                "@config.showR",
+                                [
+                                  "str/concat",
+                                  "r = ",
+                                  [
+                                    "math/round",
+                                    "@entity.r",
+                                    3.0
+                                  ],
+                                  " — R² = ",
+                                  [
+                                    "math/round",
+                                    "@entity.rSquared",
+                                    3.0
+                                  ],
+                                  " — guess score ",
+                                  "@entity.guessScore",
+                                  "%"
+                                ],
+                                ""
+                              ],
+                              "type": "typography",
+                              "variant": "caption"
+                            },
+                            {
+                              "content": "@entity.narration",
+                              "type": "typography",
+                              "variant": "body"
+                            }
+                          ],
+                          "direction": "vertical",
+                          "gap": "md",
+                          "type": "stack"
+                        }
+                      ],
+                      "padding": "md",
+                      "type": "box"
+                    }
+                  ],
+                  [
+                    "emit",
+                    "LEARN_SCATTER_FIT_UPDATED",
+                    {
+                      "intercept": "@entity.intercept",
+                      "narration": "@entity.narration",
+                      "pointCount": [
+                        "array/len",
+                        "@entity.points"
+                      ],
+                      "r": "@entity.r",
+                      "rSquared": "@entity.rSquared",
+                      "slope": "@entity.slope"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01M0CGSNDKG9JYEDATK8M75C4N",
+                "from": "idle",
+                "guard": [
+                  "and",
+                  [
+                    "==",
+                    "@config.matchMode",
+                    ""
+                  ],
+                  [
+                    "==",
+                    "@config.rosterSource",
+                    "config"
+                  ]
                 ],
-                "tier": "domain"
+                "to": "idle"
               },
               {
-                "description": "Learner dragged a guess-the-line slider — param is slope or intercept; the guess is scored against the least-squares fit.",
-                "id": "evt_01M0CGSNDNWS2K4R391QPXQYFG",
-                "key": "GUESS_LINE",
-                "name": "Guess Line",
-                "payloadSchema": [
-                  {
-                    "name": "param",
-                    "type": "string"
-                  },
-                  {
-                    "name": "value",
-                    "type": "number"
-                  }
+                "effects": [
+                  [
+                    "set",
+                    "@entity.active",
+                    false
+                  ],
+                  [
+                    "set",
+                    "@entity.running",
+                    false
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    null
+                  ]
                 ],
-                "tier": "domain"
-              },
-              {
-                "id": "evt_01M0CGSNDN7W9T6E8N52B3FT19",
-                "key": "REVEAL_FIT",
-                "name": "Reveal Fit"
-              },
-              {
-                "id": "evt_01M0CGSNDN9PCGWDRC046WE6AB",
-                "key": "TOGGLE_RUN",
-                "name": "Toggle Run"
-              },
-              {
-                "id": "evt_01M0CGSNDN1VCP026JN2M802CH",
-                "key": "RESET",
-                "name": "Reset"
-              },
-              {
-                "description": "The least-squares fit and narration after each learner action, auto-add tick, or reset — a composed listener (readout, grader) can subscribe; a harmless no-op when the atom runs standalone.",
-                "id": "evt_01M0CGSNDNRJ5SEN6M870GKYWG",
-                "key": "LEARN_SCATTER_FIT_UPDATED",
-                "name": "Learn Scatter Fit Updated",
-                "payloadSchema": [
-                  {
-                    "name": "slope",
-                    "type": "number"
-                  },
-                  {
-                    "name": "intercept",
-                    "type": "number"
-                  },
-                  {
-                    "name": "r",
-                    "type": "number"
-                  },
-                  {
-                    "name": "rSquared",
-                    "type": "number"
-                  },
-                  {
-                    "name": "pointCount",
-                    "type": "number"
-                  },
-                  {
-                    "name": "narration",
-                    "type": "string"
-                  }
+                "event": "MODE_SELECTED",
+                "eventId": "evt_01M0CGSNDNBDW8469VPNX0HE2C",
+                "from": "idle",
+                "guard": [
+                  "and",
+                  [
+                    "not",
+                    [
+                      "==",
+                      "@config.matchMode",
+                      ""
+                    ]
+                  ],
+                  [
+                    "not",
+                    [
+                      "==",
+                      "@payload.mode",
+                      "@config.matchMode"
+                    ]
+                  ]
                 ],
-                "synonyms": "fit update, line of best fit, slope, intercept, correlation, r squared",
-                "tier": "domain"
+                "to": "idle"
               },
-              {
-                "description": "Fired once when the point that reaches maxPoints lands and the round latches done — the standard learning completion broadcast a celebration/progression sibling (fx cues, badges) rides.",
-                "id": "evt_01M0GTSZG6B8B6VFWSEN7M2AT4",
-                "key": "LEARN_ROUND_COMPLETE",
-                "name": "Learn Round Complete",
-                "payloadSchema": [
-                  {
-                    "name": "score",
-                    "type": "number"
-                  },
-                  {
-                    "name": "total",
-                    "type": "number"
-                  }
-                ],
-                "synonyms": "round complete, finished, done, completion, max points",
-                "tier": "domain"
-              }
-            ],
-            "states": [
-              {
-                "isInitial": true,
-                "name": "idle"
-              }
-            ],
-            "transitions": [
               {
                 "effects": [
+                  [
+                    "set",
+                    "@entity.initialPoints",
+                    "@config.initialPoints"
+                  ],
                   [
                     "set",
                     "@entity.active",
@@ -1898,60 +2892,31 @@
                     }
                   ]
                 ],
-                "event": "INIT",
-                "eventId": "evt_01M0CGSNDKG9JYEDATK8M75C4N",
-                "from": "idle",
-                "guard": [
-                  "==",
-                  "@config.matchMode",
-                  ""
-                ],
-                "to": "idle"
-              },
-              {
-                "effects": [
-                  [
-                    "set",
-                    "@entity.active",
-                    false
-                  ],
-                  [
-                    "set",
-                    "@entity.running",
-                    false
-                  ],
-                  [
-                    "render-ui",
-                    "main",
-                    null
-                  ]
-                ],
                 "event": "MODE_SELECTED",
                 "eventId": "evt_01M0CGSNDNBDW8469VPNX0HE2C",
                 "from": "idle",
                 "guard": [
                   "and",
                   [
-                    "not",
-                    [
-                      "==",
-                      "@config.matchMode",
-                      ""
-                    ]
+                    "==",
+                    "@payload.mode",
+                    "@config.matchMode"
                   ],
                   [
-                    "not",
-                    [
-                      "==",
-                      "@payload.mode",
-                      "@config.matchMode"
-                    ]
+                    "==",
+                    "@config.rosterSource",
+                    "config"
                   ]
                 ],
                 "to": "idle"
               },
               {
                 "effects": [
+                  [
+                    "set",
+                    "@entity.initialPoints",
+                    "@payload.initialPoints"
+                  ],
                   [
                     "set",
                     "@entity.active",
@@ -1965,7 +2930,7 @@
                   [
                     "set",
                     "@entity.points",
-                    "@config.initialPoints"
+                    "@payload.initialPoints"
                   ],
                   [
                     "set",
@@ -2000,7 +2965,7 @@
                     [
                       [
                         "pts",
-                        "@config.initialPoints"
+                        "@payload.initialPoints"
                       ],
                       [
                         "n",
@@ -2763,13 +3728,60 @@
                     }
                   ]
                 ],
-                "event": "MODE_SELECTED",
-                "eventId": "evt_01M0CGSNDNBDW8469VPNX0HE2C",
+                "event": "ROSTER_LOADED",
+                "eventId": "evt_01M459WQQNEVCGWRAKJ3M6R067",
                 "from": "idle",
                 "guard": [
-                  "==",
-                  "@payload.mode",
-                  "@config.matchMode"
+                  "and",
+                  [
+                    "==",
+                    "@config.rosterSource",
+                    "event"
+                  ],
+                  [
+                    "==",
+                    "@payload.mode",
+                    "@config.matchMode"
+                  ]
+                ],
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.active",
+                    false
+                  ],
+                  [
+                    "set",
+                    "@entity.running",
+                    false
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    null
+                  ]
+                ],
+                "event": "ROSTER_LOADED",
+                "eventId": "evt_01M459WQQNEVCGWRAKJ3M6R067",
+                "from": "idle",
+                "guard": [
+                  "and",
+                  [
+                    "==",
+                    "@config.rosterSource",
+                    "event"
+                  ],
+                  [
+                    "not",
+                    [
+                      "==",
+                      "@payload.mode",
+                      "@config.matchMode"
+                    ]
+                  ]
                 ],
                 "to": "idle"
               },
@@ -6252,7 +7264,7 @@
                   [
                     "set",
                     "@entity.points",
-                    "@config.initialPoints"
+                    "@entity.initialPoints"
                   ],
                   [
                     "set",
@@ -6287,7 +7299,7 @@
                     [
                       [
                         "pts",
-                        "@config.initialPoints"
+                        "@entity.initialPoints"
                       ],
                       [
                         "n",