@almadar/std 3.2.2 → 3.3.4

package/dist/exports/atoms/std-validate-on-save.orb

@@ -0,0 +1,623 @@
+{
+  "name": "ValidateOnSave",
+  "orbitals": [
+    {
+      "name": "ValidateOnSave",
+      "entity": {
+        "name": "ValidateOnSave",
+        "persistence": "runtime",
+        "fields": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "path",
+            "type": "string"
+          },
+          {
+            "name": "valid",
+            "type": "boolean",
+            "default": false
+          },
+          {
+            "name": "errors",
+            "type": "array",
+            "default": []
+          },
+          {
+            "name": "warnings",
+            "type": "array",
+            "default": []
+          },
+          {
+            "name": "timestamp",
+            "type": "number",
+            "default": 0
+          },
+          {
+            "name": "status",
+            "type": "string",
+            "default": "idle"
+          }
+        ]
+      },
+      "traits": [
+        {
+          "name": "OrbFileWatcher",
+          "linkedEntity": "ValidateOnSave",
+          "category": "interaction",
+          "listens": [
+            {
+              "event": "OS_FILE_MODIFIED",
+              "scope": "external",
+              "guard": [
+                "str/endsWith",
+                "@payload.path",
+                ".orb"
+              ]
+            }
+          ],
+          "emits": [
+            {
+              "event": "AGENT_INTERRUPT",
+              "scope": "external",
+              "payload": [
+                {
+                  "name": "type",
+                  "type": "string"
+                },
+                {
+                  "name": "status",
+                  "type": "string"
+                },
+                {
+                  "name": "path",
+                  "type": "string"
+                },
+                {
+                  "name": "errors",
+                  "type": "array"
+                },
+                {
+                  "name": "blocking",
+                  "type": "boolean"
+                }
+              ]
+            }
+          ],
+          "stateMachine": {
+            "states": [
+              {
+                "name": "idle",
+                "isInitial": true
+              },
+              {
+                "name": "validating"
+              },
+              {
+                "name": "valid"
+              },
+              {
+                "name": "invalid"
+              }
+            ],
+            "events": [
+              {
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "key": "OS_FILE_MODIFIED",
+                "name": "File Modified",
+                "payload": [
+                  {
+                    "name": "path",
+                    "type": "string"
+                  },
+                  {
+                    "name": "name",
+                    "type": "string"
+                  },
+                  {
+                    "name": "dir",
+                    "type": "string"
+                  },
+                  {
+                    "name": "ext",
+                    "type": "string"
+                  },
+                  {
+                    "name": "timestamp",
+                    "type": "number"
+                  }
+                ]
+              },
+              {
+                "key": "REFRESH",
+                "name": "Validate Now"
+              },
+              {
+                "key": "VALIDATION_PASSED",
+                "name": "Validation Passed",
+                "payload": [
+                  {
+                    "name": "warnings",
+                    "type": "array"
+                  }
+                ]
+              },
+              {
+                "key": "VALIDATION_FAILED",
+                "name": "Validation Failed",
+                "payload": [
+                  {
+                    "name": "errors",
+                    "type": "array"
+                  },
+                  {
+                    "name": "warnings",
+                    "type": "array"
+                  }
+                ]
+              },
+              {
+                "key": "NAVIGATE",
+                "name": "NAVIGATE"
+              }
+            ],
+            "transitions": [
+              {
+                "from": "idle",
+                "event": "INIT",
+                "to": "idle",
+                "effects": [
+                  [
+                    "os/watch-files",
+                    "**/*.orb"
+                  ],
+                  [
+                    "os/debounce",
+                    500,
+                    "OS_FILE_MODIFIED"
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "idle"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "page-header",
+                      "title": "Orb File Validator",
+                      "subtitle": "Watching **/*.orb for changes"
+                    }
+                  ],
+                  [
+                    "render-ui",
+                    "center",
+                    {
+                      "type": "empty-state",
+                      "title": "Waiting for file changes",
+                      "description": "Watching **/*.orb. Save an .orb file to trigger validation."
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "idle",
+                "event": "OS_FILE_MODIFIED",
+                "to": "validating",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.path",
+                    "@payload.path"
+                  ],
+                  [
+                    "set",
+                    "@entity.timestamp",
+                    "@now"
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "validating"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "page-header",
+                      "title": "Orb File Validator",
+                      "subtitle": "Validating..."
+                    }
+                  ],
+                  [
+                    "render-ui",
+                    "center",
+                    {
+                      "type": "loading-state",
+                      "title": "Running orbital validate..."
+                    }
+                  ],
+                  [
+                    "call-service",
+                    "orbital-cli",
+                    "validate",
+                    {
+                      "path": "@payload.path",
+                      "onSuccess": "VALIDATION_PASSED",
+                      "onError": "VALIDATION_FAILED"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "validating",
+                "event": "VALIDATION_PASSED",
+                "to": "valid",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.valid",
+                    true
+                  ],
+                  [
+                    "set",
+                    "@entity.errors",
+                    []
+                  ],
+                  [
+                    "set",
+                    "@entity.warnings",
+                    "@payload.warnings"
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "valid"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "page-header",
+                      "title": "Orb File Validator",
+                      "subtitle": "Validation passed",
+                      "actions": [
+                        {
+                          "event": "REFRESH",
+                          "label": "Validate Now",
+                          "variant": "primary"
+                        }
+                      ]
+                    }
+                  ],
+                  [
+                    "render-ui",
+                    "center",
+                    {
+                      "type": "entity-detail",
+                      "entity": "ValidateOnSave",
+                      "fields": [
+                        "path",
+                        "valid",
+                        "status",
+                        "timestamp"
+                      ]
+                    }
+                  ],
+                  [
+                    "notify",
+                    "success",
+                    "Schema is valid"
+                  ],
+                  [
+                    "emit",
+                    "AGENT_INTERRUPT",
+                    {
+                      "type": "validation",
+                      "status": "passed",
+                      "path": "@entity.path",
+                      "blocking": false
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "validating",
+                "event": "VALIDATION_FAILED",
+                "to": "invalid",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.valid",
+                    false
+                  ],
+                  [
+                    "set",
+                    "@entity.errors",
+                    "@payload.errors"
+                  ],
+                  [
+                    "set",
+                    "@entity.warnings",
+                    "@payload.warnings"
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "invalid"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "page-header",
+                      "title": "Orb File Validator",
+                      "subtitle": "Validation failed",
+                      "actions": [
+                        {
+                          "event": "REFRESH",
+                          "label": "Validate Now",
+                          "variant": "primary"
+                        }
+                      ]
+                    }
+                  ],
+                  [
+                    "render-ui",
+                    "center",
+                    {
+                      "type": "entity-detail",
+                      "entity": "ValidateOnSave",
+                      "fields": [
+                        "path",
+                        "valid",
+                        "errors",
+                        "warnings",
+                        "status"
+                      ]
+                    }
+                  ],
+                  [
+                    "notify",
+                    "error",
+                    "Schema has errors"
+                  ],
+                  [
+                    "emit",
+                    "AGENT_INTERRUPT",
+                    {
+                      "type": "validation",
+                      "status": "failed",
+                      "path": "@entity.path",
+                      "errors": "@payload.errors",
+                      "blocking": true
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "valid",
+                "event": "OS_FILE_MODIFIED",
+                "to": "validating",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.path",
+                    "@payload.path"
+                  ],
+                  [
+                    "set",
+                    "@entity.timestamp",
+                    "@now"
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "validating"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "page-header",
+                      "title": "Orb File Validator",
+                      "subtitle": "Re-validating..."
+                    }
+                  ],
+                  [
+                    "render-ui",
+                    "center",
+                    {
+                      "type": "loading-state",
+                      "title": "Running orbital validate..."
+                    }
+                  ],
+                  [
+                    "call-service",
+                    "orbital-cli",
+                    "validate",
+                    {
+                      "path": "@payload.path",
+                      "onSuccess": "VALIDATION_PASSED",
+                      "onError": "VALIDATION_FAILED"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "invalid",
+                "event": "OS_FILE_MODIFIED",
+                "to": "validating",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.path",
+                    "@payload.path"
+                  ],
+                  [
+                    "set",
+                    "@entity.timestamp",
+                    "@now"
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "validating"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "page-header",
+                      "title": "Orb File Validator",
+                      "subtitle": "Re-validating..."
+                    }
+                  ],
+                  [
+                    "render-ui",
+                    "center",
+                    {
+                      "type": "loading-state",
+                      "title": "Running orbital validate..."
+                    }
+                  ],
+                  [
+                    "call-service",
+                    "orbital-cli",
+                    "validate",
+                    {
+                      "path": "@payload.path",
+                      "onSuccess": "VALIDATION_PASSED",
+                      "onError": "VALIDATION_FAILED"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "valid",
+                "event": "REFRESH",
+                "to": "validating",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.status",
+                    "validating"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "page-header",
+                      "title": "Orb File Validator",
+                      "subtitle": "Re-validating..."
+                    }
+                  ],
+                  [
+                    "render-ui",
+                    "center",
+                    {
+                      "type": "loading-state",
+                      "title": "Running orbital validate..."
+                    }
+                  ],
+                  [
+                    "call-service",
+                    "orbital-cli",
+                    "validate",
+                    {
+                      "path": "@entity.path",
+                      "onSuccess": "VALIDATION_PASSED",
+                      "onError": "VALIDATION_FAILED"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "invalid",
+                "event": "REFRESH",
+                "to": "validating",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.status",
+                    "validating"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "page-header",
+                      "title": "Orb File Validator",
+                      "subtitle": "Re-validating..."
+                    }
+                  ],
+                  [
+                    "render-ui",
+                    "center",
+                    {
+                      "type": "loading-state",
+                      "title": "Running orbital validate..."
+                    }
+                  ],
+                  [
+                    "call-service",
+                    "orbital-cli",
+                    "validate",
+                    {
+                      "path": "@entity.path",
+                      "onSuccess": "VALIDATION_PASSED",
+                      "onError": "VALIDATION_FAILED"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "idle",
+                "to": "idle",
+                "event": "NAVIGATE",
+                "effects": []
+              },
+              {
+                "from": "validating",
+                "to": "validating",
+                "event": "NAVIGATE",
+                "effects": []
+              },
+              {
+                "from": "valid",
+                "to": "valid",
+                "event": "NAVIGATE",
+                "effects": []
+              },
+              {
+                "from": "invalid",
+                "to": "invalid",
+                "event": "NAVIGATE",
+                "effects": []
+              }
+            ]
+          }
+        }
+      ],
+      "pages": [
+        {
+          "name": "ValidatorPage",
+          "path": "/validator",
+          "traits": [
+            {
+              "ref": "OrbFileWatcher"
+            }
+          ]
+        }
+      ]
+    }
+  ],
+  "description": "OS trigger that watches .orb files and validates them on save. Shows a status dashboard with validation results. Emits AGENT_INTERRUPT with validation results to interrupt autonomous agents with ground truth."
+}