@saulwade/swl-ses 2.6.1 → 2.8.0

package/schemas/harness-ir.schema.json

@@ -0,0 +1,369 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://swl-ses.dev/schemas/harness-ir.schema.json",
+  "title": "SWL Harness IR v1",
+  "oneOf": [
+    { "$ref": "#/$defs/harnessIR" },
+    { "$ref": "#/$defs/diagnosticView" }
+  ],
+  "$defs": {
+    "sha256": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "nodeId": {
+      "type": "string",
+      "pattern": "^(agent|command|skill|rule|hook):[a-f0-9]{64}$"
+    },
+    "relativePath": {
+      "type": "string",
+      "pattern": "^(?!/)(?![A-Za-z]:)(?!.*(?:^|/)\\.\\.(?:/|$))[A-Za-z0-9._/-]+$"
+    },
+    "frontmatterLocator": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "keyHash", "startLine", "endLine"],
+      "properties": {
+        "kind": { "const": "frontmatter-key" },
+        "keyHash": { "$ref": "#/$defs/sha256" },
+        "startLine": { "type": "integer", "minimum": 1 },
+        "endLine": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "lineLocator": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "startLine", "endLine"],
+      "properties": {
+        "kind": { "const": "line-range" },
+        "startLine": { "type": "integer", "minimum": 1 },
+        "endLine": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "byteLocator": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "start", "end"],
+      "properties": {
+        "kind": { "const": "byte-range" },
+        "start": { "type": "integer", "minimum": 0 },
+        "end": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "locator": {
+      "oneOf": [
+        { "$ref": "#/$defs/frontmatterLocator" },
+        { "$ref": "#/$defs/lineLocator" },
+        { "$ref": "#/$defs/byteLocator" }
+      ]
+    },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "sha256", "locator"],
+      "properties": {
+        "path": { "$ref": "#/$defs/relativePath" },
+        "sha256": { "$ref": "#/$defs/sha256" },
+        "locator": { "$ref": "#/$defs/locator" }
+      }
+    },
+    "nullableTier": {
+      "oneOf": [
+        { "type": "null" },
+        { "enum": ["frontier", "critical", "standard", "light"] }
+      ]
+    },
+    "nullableRisk": {
+      "oneOf": [
+        { "type": "null" },
+        { "enum": ["low", "medium", "high"] }
+      ]
+    },
+    "capabilityId": {
+      "enum": [
+        "filesystem.read",
+        "filesystem.mutate",
+        "shell.exec",
+        "network.access",
+        "delegate",
+        "skill.invoke",
+        "memory.read",
+        "memory.write"
+      ]
+    },
+    "allToolsSelector": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind"],
+      "properties": {
+        "kind": { "const": "all_tools" }
+      }
+    },
+    "capabilitiesSelector": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "anyOf"],
+      "properties": {
+        "kind": { "const": "capabilities" },
+        "anyOf": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "#/$defs/capabilityId" }
+        }
+      }
+    },
+    "selector": {
+      "oneOf": [
+        { "type": "null" },
+        { "$ref": "#/$defs/allToolsSelector" },
+        { "$ref": "#/$defs/capabilitiesSelector" }
+      ]
+    },
+    "policyReference": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["refHash", "source"],
+      "properties": {
+        "refHash": { "$ref": "#/$defs/sha256" },
+        "source": { "$ref": "#/$defs/source" }
+      }
+    },
+    "precondition": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["field", "operator", "valueHash"],
+      "properties": {
+        "field": { "type": "string", "pattern": "^[a-z][a-zA-Z0-9.]*$" },
+        "operator": { "enum": ["eq", "neq", "in", "not_in"] },
+        "valueHash": { "$ref": "#/$defs/sha256" }
+      }
+    },
+    "gate": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["gateHash", "preconditions"],
+      "properties": {
+        "gateHash": { "$ref": "#/$defs/sha256" },
+        "preconditions": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/precondition" }
+        }
+      }
+    },
+    "node": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "nodeId",
+        "kind",
+        "consumable",
+        "legacyStatus",
+        "providerTainted",
+        "sourceDigest",
+        "source",
+        "selector",
+        "capabilities",
+        "events",
+        "tier",
+        "risk",
+        "references",
+        "policyReferences",
+        "gates"
+      ],
+      "properties": {
+        "nodeId": { "$ref": "#/$defs/nodeId" },
+        "kind": { "enum": ["agent", "command", "skill", "rule", "hook"] },
+        "consumable": { "const": false },
+        "legacyStatus": { "enum": ["tainted", "neutrality_unproven"] },
+        "providerTainted": { "type": "boolean" },
+        "sourceDigest": { "$ref": "#/$defs/sha256" },
+        "source": { "$ref": "#/$defs/source" },
+        "selector": { "$ref": "#/$defs/selector" },
+        "capabilities": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/capabilityId" }
+        },
+        "events": {
+          "type": "array",
+          "items": {
+            "enum": [
+              "session_start",
+              "before_tool",
+              "after_tool",
+              "before_agent",
+              "after_agent",
+              "stop"
+            ]
+          }
+        },
+        "tier": { "$ref": "#/$defs/nullableTier" },
+        "risk": { "$ref": "#/$defs/nullableRisk" },
+        "references": {
+          "type": "array",
+          "items": { "type": "string", "pattern": "^[a-z-]+:[a-f0-9]{64}$" }
+        },
+        "policyReferences": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/policyReference" }
+        },
+        "gates": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/gate" }
+        }
+      }
+    },
+    "capability": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "declaredBy"],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/capabilityId"
+        },
+        "declaredBy": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/nodeId" }
+        }
+      }
+    },
+    "event": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "declaredBy"],
+      "properties": {
+        "id": {
+          "enum": [
+            "session_start",
+            "before_tool",
+            "after_tool",
+            "before_agent",
+            "after_agent",
+            "stop"
+          ]
+        },
+        "declaredBy": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/nodeId" }
+        }
+      }
+    },
+    "requirement": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["key", "value"],
+      "properties": {
+        "key": { "type": "string", "pattern": "^[a-z][a-zA-Z0-9]*$" },
+        "value": { "type": "string", "pattern": "^[a-z][a-z0-9_]*$" }
+      }
+    },
+    "tier": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "requirements", "unresolvedDisposition"],
+      "properties": {
+        "id": { "enum": ["frontier", "critical", "standard", "light"] },
+        "requirements": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/requirement" }
+        },
+        "unresolvedDisposition": { "enum": ["stop", "unresolved_in_w1"] }
+      }
+    },
+    "harnessIR": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "schemaVersion", "nodes", "capabilities", "events", "tiers"],
+      "properties": {
+        "kind": { "const": "harness-ir" },
+        "schemaVersion": { "const": "1.0.0" },
+        "nodes": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/node" }
+        },
+        "capabilities": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/capability" },
+          "maxItems": 8
+        },
+        "events": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/event" },
+          "maxItems": 6
+        },
+        "tiers": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/tier" },
+          "maxItems": 4
+        }
+      }
+    },
+    "diagnostic": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "severity", "blocksConsumption", "nodeId", "source"],
+      "properties": {
+        "code": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]+$" },
+        "severity": { "enum": ["error", "warning"] },
+        "blocksConsumption": { "const": true },
+        "nodeId": { "$ref": "#/$defs/nodeId" },
+        "source": { "$ref": "#/$defs/source" }
+      }
+    },
+    "counts": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "agents",
+        "commands",
+        "skills",
+        "rules",
+        "hooks",
+        "total",
+        "errors",
+        "warnings",
+        "consumable"
+      ],
+      "properties": {
+        "agents": { "type": "integer", "minimum": 0 },
+        "commands": { "type": "integer", "minimum": 0 },
+        "skills": { "type": "integer", "minimum": 0 },
+        "rules": { "type": "integer", "minimum": 0 },
+        "hooks": { "type": "integer", "minimum": 0 },
+        "total": { "type": "integer", "minimum": 0, "maximum": 416 },
+        "errors": { "type": "integer", "minimum": 0 },
+        "warnings": { "type": "integer", "minimum": 0 },
+        "consumable": { "const": 0 }
+      }
+    },
+    "diagnosticView": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "kind",
+        "schemaVersion",
+        "shadowStatus",
+        "ir",
+        "counts",
+        "diagnostics",
+        "corpusDigest"
+      ],
+      "properties": {
+        "kind": { "const": "diagnostic-view" },
+        "schemaVersion": { "const": "1.0.0" },
+        "shadowStatus": { "const": "diagnostic_only" },
+        "ir": {
+          "oneOf": [
+            { "$ref": "#/$defs/harnessIR" },
+            { "type": "null" }
+          ]
+        },
+        "counts": { "$ref": "#/$defs/counts" },
+        "diagnostics": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/diagnostic" }
+        },
+        "corpusDigest": { "$ref": "#/$defs/sha256" }
+      }
+    }
+  }
+}

package/schemas/hook-profiles.schema.json

@@ -1,54 +1,54 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://swl-ses.dev/schemas/hook-profiles.json",
-  "$schemaVersion": "1.0.0",
-  "title": "SWL Hook Profiles",
-  "description": "Schema para hook-profiles.json del sistema SWL",
-  "type": "object",
-  "required": [
-    "descripcion",
-    "perfilActivo",
-    "perfiles"
-  ],
-  "properties": {
-    "descripcion": {
-      "type": "string"
-    },
-    "perfilActivo": {
-      "type": "string",
-      "enum": [
-        "minimal",
-        "standard",
-        "strict",
-        "custom"
-      ]
-    },
-    "perfiles": {
-      "type": "object",
-      "additionalProperties": {
-        "type": "object",
-        "required": [
-          "descripcion",
-          "hooks"
-        ],
-        "properties": {
-          "descripcion": {
-            "type": "string"
-          },
-          "hooks": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            }
-          },
-          "overrides": {
-            "type": "object"
-          }
-        }
-      }
-    },
-    "variablesEntorno": {
-      "type": "object"
-    }
-  }
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://swl-ses.dev/schemas/hook-profiles.json",
+  "$schemaVersion": "1.0.0",
+  "title": "SWL Hook Profiles",
+  "description": "Schema para hook-profiles.json del sistema SWL",
+  "type": "object",
+  "required": [
+    "descripcion",
+    "perfilActivo",
+    "perfiles"
+  ],
+  "properties": {
+    "descripcion": {
+      "type": "string"
+    },
+    "perfilActivo": {
+      "type": "string",
+      "enum": [
+        "minimal",
+        "standard",
+        "strict",
+        "custom"
+      ]
+    },
+    "perfiles": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "required": [
+          "descripcion",
+          "hooks"
+        ],
+        "properties": {
+          "descripcion": {
+            "type": "string"
+          },
+          "hooks": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "overrides": {
+            "type": "object"
+          }
+        }
+      }
+    },
+    "variablesEntorno": {
+      "type": "object"
+    }
+  }
+}

package/schemas/hooks-config.schema.json

@@ -1,89 +1,89 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://swl-ses.dev/schemas/hooks-config.json",
-  "$schemaVersion": "1.0.0",
-  "title": "SWL Hooks Config",
-  "description": "Schema para hooks-config.json del sistema SWL",
-  "type": "object",
-  "required": [
-    "descripcion",
-    "hooks"
-  ],
-  "properties": {
-    "descripcion": {
-      "type": "string"
-    },
-    "riskThresholds": {
-      "type": "object",
-      "required": [
-        "allow",
-        "review",
-        "confirm"
-      ],
-      "properties": {
-        "allow": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 1
-        },
-        "review": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 1
-        },
-        "confirm": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 1
-        }
-      }
-    },
-    "costBudget": {
-      "type": "object",
-      "properties": {
-        "maxUsd": {
-          "type": "number",
-          "minimum": 0
-        },
-        "maxTokens": {
-          "type": "integer",
-          "minimum": 0
-        },
-        "alertAt": {
-          "type": "number",
-          "minimum": 0,
-          "maximum": 1
-        }
-      }
-    },
-    "hooks": {
-      "type": "object",
-      "additionalProperties": {
-        "type": "object",
-        "required": [
-          "event",
-          "description",
-          "blocking"
-        ],
-        "properties": {
-          "event": {
-            "type": "string",
-            "enum": [
-              "PreToolUse",
-              "PostToolUse"
-            ]
-          },
-          "matcher": {
-            "type": "string"
-          },
-          "description": {
-            "type": "string"
-          },
-          "blocking": {
-            "type": "boolean"
-          }
-        }
-      }
-    }
-  }
-}
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://swl-ses.dev/schemas/hooks-config.json",
+  "$schemaVersion": "1.0.0",
+  "title": "SWL Hooks Config",
+  "description": "Schema para hooks-config.json del sistema SWL",
+  "type": "object",
+  "required": [
+    "descripcion",
+    "hooks"
+  ],
+  "properties": {
+    "descripcion": {
+      "type": "string"
+    },
+    "riskThresholds": {
+      "type": "object",
+      "required": [
+        "allow",
+        "review",
+        "confirm"
+      ],
+      "properties": {
+        "allow": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        },
+        "review": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        },
+        "confirm": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        }
+      }
+    },
+    "costBudget": {
+      "type": "object",
+      "properties": {
+        "maxUsd": {
+          "type": "number",
+          "minimum": 0
+        },
+        "maxTokens": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "alertAt": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        }
+      }
+    },
+    "hooks": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "required": [
+          "event",
+          "description",
+          "blocking"
+        ],
+        "properties": {
+          "event": {
+            "type": "string",
+            "enum": [
+              "PreToolUse",
+              "PostToolUse"
+            ]
+          },
+          "matcher": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "blocking": {
+            "type": "boolean"
+          }
+        }
+      }
+    }
+  }
+}