@almadar/std 5.2.2 → 5.4.0

package/behaviors/exports/organisms/std-agent-reviewer.orb

@@ -1,20 +1,9 @@
 {
-  "name": "std-agent-reviewer",
+  "name": "Code Reviewer",
   "version": "1.0.0",
-  "description": "Schema/code reviewer organism. Composes RAG molecule + classifier atom to classify input, search for relevant patterns, recall best practices, and generate structured review output with tabbed views and an issues browse.",
   "orbitals": [
     {
       "name": "ReviewOrbital",
-      "uses": [
-        {
-          "from": "std/behaviors/std-browse",
-          "as": "Browse"
-        },
-        {
-          "from": "std/behaviors/std-tabs",
-          "as": "Tabs"
-        }
-      ],
       "entity": {
         "name": "Review",
         "persistence": "runtime",
@@ -1106,10 +1095,7 @@
                                   "type": "badge",
                                   "label": [
                                     "str/concat",
-                                    [
-                                      "str/concat",
-                                      "@entity.memoryHits"
-                                    ],
+                                    "@entity.memoryHits",
                                     " memories"
                                   ]
                                 },
@@ -1117,10 +1103,7 @@
                                   "type": "badge",
                                   "label": [
                                     "str/concat",
-                                    [
-                                      "str/concat",
-                                      "@entity.searchHits"
-                                    ],
+                                    "@entity.searchHits",
                                     " code hits"
                                   ]
                                 }
@@ -2670,6 +2653,10 @@
                         }
                       ]
                     }
+                  ],
+                  [
+                    "notify",
+                    "ReviewRag created successfully"
                   ]
                 ]
               }
@@ -3168,6 +3155,10 @@
                         }
                       ]
                     }
+                  ],
+                  [
+                    "notify",
+                    "Analysis created successfully"
                   ]
                 ]
               }
@@ -4140,6 +4131,10 @@
                         }
                       ]
                     }
+                  ],
+                  [
+                    "notify",
+                    "ReviewCompletion created successfully"
                   ]
                 ]
               }
@@ -4786,112 +4781,142 @@
       },
       "traits": [
         {
-          "ref": "Tabs.traits.TabContentTabs",
           "name": "ReviewerTabs",
           "linkedEntity": "Review",
-          "effects": {
-            "INIT": [
-              [
-                "fetch",
-                "Review"
-              ],
-              [
-                "render-ui",
-                "main",
-                {
-                  "type": "dashboard-layout",
-                  "appName": "Code Reviewer",
-                  "navItems": [
-                    {
-                      "label": "Review",
-                      "href": "/review",
-                      "icon": "file-search"
-                    },
-                    {
-                      "label": "Analysis",
-                      "href": "/analysis",
-                      "icon": "tag"
-                    },
-                    {
-                      "label": "Issues",
-                      "href": "/issues",
-                      "icon": "alert-triangle"
-                    }
+          "category": "interaction",
+          "stateMachine": {
+            "states": [
+              {
+                "name": "idle",
+                "isInitial": true
+              }
+            ],
+            "events": [
+              {
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "key": "SELECT_TAB",
+                "name": "Select Tab",
+                "payload": [
+                  {
+                    "name": "tab",
+                    "type": "string",
+                    "required": true
+                  }
+                ]
+              }
+            ],
+            "transitions": [
+              {
+                "from": "idle",
+                "to": "idle",
+                "event": "INIT",
+                "effects": [
+                  [
+                    "fetch",
+                    "Review"
                   ],
-                  "children": [
+                  [
+                    "render-ui",
+                    "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
-                      "gap": "lg",
-                      "children": [
-                        {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "sm",
-                          "align": "center",
-                          "children": [
-                            {
-                              "type": "icon",
-                              "name": "file-search",
-                              "size": "lg"
-                            },
-                            {
-                              "type": "typography",
-                              "content": "Code Reviewer",
-                              "variant": "h2"
-                            }
-                          ]
-                        },
+                      "type": "dashboard-layout",
+                      "appName": "Code Reviewer",
+                      "navItems": [
                         {
-                          "type": "divider"
+                          "label": "Review",
+                          "href": "/review",
+                          "icon": "file-search"
                         },
                         {
-                          "type": "tabs",
-                          "tabs": [
-                            {
-                              "label": "Input",
-                              "value": "input"
-                            },
-                            {
-                              "label": "Analysis",
-                              "value": "analysis"
-                            },
-                            {
-                              "label": "Review",
-                              "value": "review"
-                            }
-                          ],
-                          "defaultActiveTab": "input",
-                          "onTabChange": "SELECT_TAB"
+                          "label": "Analysis",
+                          "href": "/analysis",
+                          "icon": "tag"
                         },
                         {
-                          "type": "divider"
-                        },
+                          "label": "Issues",
+                          "href": "/issues",
+                          "icon": "alert-triangle"
+                        }
+                      ],
+                      "children": [
                         {
-                          "type": "data-grid",
-                          "entity": "Review",
-                          "emptyIcon": "inbox",
-                          "emptyTitle": "No reviews yet",
-                          "emptyDescription": "Add reviews to see them here.",
-                          "className": "transition-shadow hover:shadow-md cursor-pointer",
-                          "renderItem": [
-                            "fn",
-                            "item",
+                          "type": "stack",
+                          "direction": "vertical",
+                          "gap": "lg",
+                          "children": [
                             {
                               "type": "stack",
-                              "direction": "vertical",
+                              "direction": "horizontal",
                               "gap": "sm",
+                              "align": "center",
                               "children": [
                                 {
-                                  "type": "typography",
-                                  "variant": "h4",
-                                  "content": "@item.target"
+                                  "type": "icon",
+                                  "name": "file-search",
+                                  "size": "lg"
                                 },
                                 {
                                   "type": "typography",
-                                  "variant": "caption",
-                                  "color": "muted",
-                                  "content": "@item.input"
+                                  "content": "Code Reviewer",
+                                  "variant": "h2"
+                                }
+                              ]
+                            },
+                            {
+                              "type": "divider"
+                            },
+                            {
+                              "type": "tabs",
+                              "tabs": [
+                                {
+                                  "label": "Input",
+                                  "value": "input"
+                                },
+                                {
+                                  "label": "Analysis",
+                                  "value": "analysis"
+                                },
+                                {
+                                  "label": "Review",
+                                  "value": "review"
+                                }
+                              ],
+                              "defaultActiveTab": "input",
+                              "onTabChange": "SELECT_TAB"
+                            },
+                            {
+                              "type": "divider"
+                            },
+                            {
+                              "type": "data-grid",
+                              "entity": "Review",
+                              "emptyIcon": "inbox",
+                              "emptyTitle": "No reviews yet",
+                              "emptyDescription": "Add reviews to see them here.",
+                              "className": "transition-shadow hover:shadow-md cursor-pointer",
+                              "renderItem": [
+                                "fn",
+                                "item",
+                                {
+                                  "type": "stack",
+                                  "direction": "vertical",
+                                  "gap": "sm",
+                                  "children": [
+                                    {
+                                      "type": "typography",
+                                      "variant": "h4",
+                                      "content": "@item.target"
+                                    },
+                                    {
+                                      "type": "typography",
+                                      "variant": "caption",
+                                      "color": "muted",
+                                      "content": "@item.input"
+                                    }
+                                  ]
                                 }
                               ]
                             }
@@ -4900,112 +4925,117 @@
                       ]
                     }
                   ]
-                }
-              ]
-            ],
-            "SELECT_TAB": [
-              [
-                "fetch",
-                "Review"
-              ],
-              [
-                "render-ui",
-                "main",
-                {
-                  "type": "dashboard-layout",
-                  "appName": "Code Reviewer",
-                  "navItems": [
-                    {
-                      "label": "Review",
-                      "href": "/review",
-                      "icon": "file-search"
-                    },
-                    {
-                      "label": "Analysis",
-                      "href": "/analysis",
-                      "icon": "tag"
-                    },
-                    {
-                      "label": "Issues",
-                      "href": "/issues",
-                      "icon": "alert-triangle"
-                    }
+                ]
+              },
+              {
+                "from": "idle",
+                "to": "idle",
+                "event": "SELECT_TAB",
+                "effects": [
+                  [
+                    "fetch",
+                    "Review"
                   ],
-                  "children": [
+                  [
+                    "render-ui",
+                    "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
-                      "gap": "lg",
-                      "children": [
-                        {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "sm",
-                          "align": "center",
-                          "children": [
-                            {
-                              "type": "icon",
-                              "name": "file-search",
-                              "size": "lg"
-                            },
-                            {
-                              "type": "typography",
-                              "content": "Code Reviewer",
-                              "variant": "h2"
-                            }
-                          ]
-                        },
+                      "type": "dashboard-layout",
+                      "appName": "Code Reviewer",
+                      "navItems": [
                         {
-                          "type": "divider"
+                          "label": "Review",
+                          "href": "/review",
+                          "icon": "file-search"
                         },
                         {
-                          "type": "tabs",
-                          "tabs": [
-                            {
-                              "label": "Input",
-                              "value": "input"
-                            },
-                            {
-                              "label": "Analysis",
-                              "value": "analysis"
-                            },
-                            {
-                              "label": "Review",
-                              "value": "review"
-                            }
-                          ],
-                          "defaultActiveTab": "input",
-                          "activeTab": "@payload.tab",
-                          "onTabChange": "SELECT_TAB"
+                          "label": "Analysis",
+                          "href": "/analysis",
+                          "icon": "tag"
                         },
                         {
-                          "type": "divider"
-                        },
+                          "label": "Issues",
+                          "href": "/issues",
+                          "icon": "alert-triangle"
+                        }
+                      ],
+                      "children": [
                         {
-                          "type": "data-grid",
-                          "entity": "Review",
-                          "emptyIcon": "inbox",
-                          "emptyTitle": "No reviews yet",
-                          "emptyDescription": "Add reviews to see them here.",
-                          "className": "transition-shadow hover:shadow-md cursor-pointer",
-                          "renderItem": [
-                            "fn",
-                            "item",
+                          "type": "stack",
+                          "direction": "vertical",
+                          "gap": "lg",
+                          "children": [
                             {
                               "type": "stack",
-                              "direction": "vertical",
+                              "direction": "horizontal",
                               "gap": "sm",
+                              "align": "center",
                               "children": [
                                 {
-                                  "type": "typography",
-                                  "variant": "h4",
-                                  "content": "@item.target"
+                                  "type": "icon",
+                                  "name": "file-search",
+                                  "size": "lg"
                                 },
                                 {
                                   "type": "typography",
-                                  "variant": "caption",
-                                  "color": "muted",
-                                  "content": "@item.input"
+                                  "content": "Code Reviewer",
+                                  "variant": "h2"
+                                }
+                              ]
+                            },
+                            {
+                              "type": "divider"
+                            },
+                            {
+                              "type": "tabs",
+                              "tabs": [
+                                {
+                                  "label": "Input",
+                                  "value": "input"
+                                },
+                                {
+                                  "label": "Analysis",
+                                  "value": "analysis"
+                                },
+                                {
+                                  "label": "Review",
+                                  "value": "review"
+                                }
+                              ],
+                              "defaultActiveTab": "input",
+                              "activeTab": "@payload.tab",
+                              "onTabChange": "SELECT_TAB"
+                            },
+                            {
+                              "type": "divider"
+                            },
+                            {
+                              "type": "data-grid",
+                              "entity": "Review",
+                              "emptyIcon": "inbox",
+                              "emptyTitle": "No reviews yet",
+                              "emptyDescription": "Add reviews to see them here.",
+                              "className": "transition-shadow hover:shadow-md cursor-pointer",
+                              "renderItem": [
+                                "fn",
+                                "item",
+                                {
+                                  "type": "stack",
+                                  "direction": "vertical",
+                                  "gap": "sm",
+                                  "children": [
+                                    {
+                                      "type": "typography",
+                                      "variant": "h4",
+                                      "content": "@item.target"
+                                    },
+                                    {
+                                      "type": "typography",
+                                      "variant": "caption",
+                                      "color": "muted",
+                                      "content": "@item.input"
+                                    }
+                                  ]
                                 }
                               ]
                             }
@@ -5014,8 +5044,8 @@
                       ]
                     }
                   ]
-                }
-              ]
+                ]
+              }
             ]
           }
         }
@@ -5062,131 +5092,172 @@
       },
       "traits": [
         {
-          "ref": "Browse.traits.BrowseItemBrowse",
           "name": "IssuesBrowse",
           "linkedEntity": "ReviewIssue",
-          "effects": {
-            "INIT": [
-              [
-                "ref",
-                "ReviewIssue"
-              ],
-              [
-                "render-ui",
-                "main",
-                {
-                  "type": "dashboard-layout",
-                  "appName": "Code Reviewer",
-                  "navItems": [
-                    {
-                      "label": "Review",
-                      "href": "/review",
-                      "icon": "file-search"
-                    },
-                    {
-                      "label": "Analysis",
-                      "href": "/analysis",
-                      "icon": "tag"
-                    },
-                    {
-                      "label": "Issues",
-                      "href": "/issues",
-                      "icon": "alert-triangle"
-                    }
+          "category": "interaction",
+          "stateMachine": {
+            "states": [
+              {
+                "name": "browsing",
+                "isInitial": true
+              }
+            ],
+            "events": [
+              {
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "key": "VIEW",
+                "name": "VIEW",
+                "payload": [
+                  {
+                    "name": "id",
+                    "type": "string",
+                    "required": true
+                  },
+                  {
+                    "name": "row",
+                    "type": "object"
+                  }
+                ]
+              }
+            ],
+            "transitions": [
+              {
+                "from": "browsing",
+                "to": "browsing",
+                "event": "INIT",
+                "effects": [
+                  [
+                    "ref",
+                    "ReviewIssue"
                   ],
-                  "children": [
+                  [
+                    "render-ui",
+                    "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
-                      "gap": "lg",
-                      "className": "max-w-5xl mx-auto w-full",
+                      "type": "dashboard-layout",
+                      "appName": "Code Reviewer",
+                      "navItems": [
+                        {
+                          "label": "Review",
+                          "href": "/review",
+                          "icon": "file-search"
+                        },
+                        {
+                          "label": "Analysis",
+                          "href": "/analysis",
+                          "icon": "tag"
+                        },
+                        {
+                          "label": "Issues",
+                          "href": "/issues",
+                          "icon": "alert-triangle"
+                        }
+                      ],
                       "children": [
                         {
                           "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "md",
-                          "justify": "space-between",
-                          "align": "center",
+                          "direction": "vertical",
+                          "gap": "lg",
+                          "className": "max-w-5xl mx-auto w-full",
                           "children": [
                             {
                               "type": "stack",
                               "direction": "horizontal",
-                              "gap": "sm",
+                              "gap": "md",
+                              "justify": "space-between",
                               "align": "center",
                               "children": [
                                 {
-                                  "type": "icon",
-                                  "name": "alert-triangle",
-                                  "size": "lg"
-                                },
-                                {
-                                  "type": "typography",
-                                  "content": "Issues",
-                                  "variant": "h2"
+                                  "type": "stack",
+                                  "direction": "horizontal",
+                                  "gap": "sm",
+                                  "align": "center",
+                                  "children": [
+                                    {
+                                      "type": "icon",
+                                      "name": "alert-triangle",
+                                      "size": "lg"
+                                    },
+                                    {
+                                      "type": "typography",
+                                      "content": "Issues",
+                                      "variant": "h2"
+                                    }
+                                  ]
                                 }
                               ]
-                            }
-                          ]
-                        },
-                        {
-                          "type": "divider"
-                        },
-                        {
-                          "type": "data-grid",
-                          "entity": "ReviewIssue",
-                          "emptyIcon": "inbox",
-                          "emptyTitle": "No issues found",
-                          "emptyDescription": "The review found no issues.",
-                          "itemActions": [
+                            },
                             {
-                              "label": "View",
-                              "event": "VIEW",
-                              "variant": "ghost",
-                              "size": "sm"
-                            }
-                          ],
-                          "columns": [
+                              "type": "divider"
+                            },
                             {
-                              "name": "description",
-                              "label": "Description",
-                              "variant": "h4",
-                              "icon": "alert-triangle"
+                              "type": "data-grid",
+                              "entity": "ReviewIssue",
+                              "emptyIcon": "inbox",
+                              "emptyTitle": "No issues found",
+                              "emptyDescription": "The review found no issues.",
+                              "itemActions": [
+                                {
+                                  "label": "View",
+                                  "event": "VIEW",
+                                  "variant": "ghost",
+                                  "size": "sm"
+                                }
+                              ],
+                              "columns": [
+                                {
+                                  "name": "description",
+                                  "label": "Description",
+                                  "variant": "h4",
+                                  "icon": "alert-triangle"
+                                },
+                                {
+                                  "name": "severity",
+                                  "label": "Severity",
+                                  "variant": "badge",
+                                  "colorMap": {
+                                    "active": "success",
+                                    "completed": "success",
+                                    "done": "success",
+                                    "pending": "warning",
+                                    "draft": "warning",
+                                    "scheduled": "warning",
+                                    "inactive": "neutral",
+                                    "archived": "neutral",
+                                    "disabled": "neutral",
+                                    "error": "destructive",
+                                    "cancelled": "destructive",
+                                    "failed": "destructive"
+                                  }
+                                }
+                              ]
                             },
                             {
-                              "name": "severity",
-                              "label": "Severity",
-                              "variant": "badge",
-                              "colorMap": {
-                                "active": "success",
-                                "completed": "success",
-                                "done": "success",
-                                "pending": "warning",
-                                "draft": "warning",
-                                "scheduled": "warning",
-                                "inactive": "neutral",
-                                "archived": "neutral",
-                                "disabled": "neutral",
-                                "error": "destructive",
-                                "cancelled": "destructive",
-                                "failed": "destructive"
-                              }
+                              "type": "floating-action-button",
+                              "icon": "plus",
+                              "event": "INIT",
+                              "label": "Create",
+                              "tooltip": "Create"
                             }
                           ]
-                        },
-                        {
-                          "type": "floating-action-button",
-                          "icon": "plus",
-                          "event": "INIT",
-                          "label": "Create",
-                          "tooltip": "Create"
                         }
                       ]
                     }
                   ]
-                }
-              ]
+                ]
+              }
             ]
-          }
+          },
+          "listens": [
+            {
+              "event": "REVIEW_COMPLETE",
+              "triggers": "INIT",
+              "scope": "external"
+            }
+          ]
         }
       ],
       "pages": [
@@ -5201,5 +5272,6 @@
         }
       ]
     }
-  ]
-}
+  ],
+  "description": "Schema/code reviewer organism. Composes RAG molecule + classifier atom to classify input, search for relevant patterns, recall best practices, and generate structured review output with tabbed views and an issues browse. Composed from: - stdAgentRag (molecule): retrieval-augmented generation pipeline - stdAgentClassifier: classifies input type (schema, component, trait, etc.) - stdAgentCompletion: generates review with scoring - stdTabs: Input / Analysis / Review tab navigation - stdBrowse: browsable issues list Cross-trait events: - CLASSIFIED (Classifier -> Reviewer): input classified, begin review - REVIEW_COMPLETE (Reviewer -> Memory): reinforce recalled best practices Pages: /review (initial), /analysis, /issues (2026-04-08). The canonical source for std behaviors is now the registry `.orb` file at `packages/almadar-std/behaviors/registry/<level>/<name>.orb`, which is generated from this TS source by `tools/almadar-behavior-ts-to-orb/` and consumed by the compiler's embedded loader. Consumers should import behaviors via `.lolo`/`.orb` `uses` declarations and reference them as `Alias.entity` / `Alias.traits.X` / `Alias.pages.X`, applying overrides at the call site (`linkedEntity`, `name`, `events`, `effects`, `listens`, `emitsScope`). The TS `*Params` interface and the exported factory functions remain ONLY as the authoring path for the converter; they are NOT a stable public API and may change without notice. See `docs/Almadar_Orb_Behaviors.md` for the orbital-as-function model and `docs/LOLO_Gaps.md` for the migration plan."
+}