@kontextmind/kxm 0.7.126 → 0.7.127

package/schemas/model.schema.json

@@ -1,42 +1,140 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://schemas.kxm.dev/model.schema.json",
-  "title": "KXM model profile",
-  "description": "The filename determines the profile identity.",
+  "title": "KXM model route",
+  "description": "Live kxm.model.v2 route. Admission status is recorded on the route. This schema does not dispatch.",
   "type": "object",
-  "required": ["schema", "provider", "model"],
+  "required": ["schema", "harness", "model", "vendor", "status", "permissions"],
+  "additionalProperties": false,
   "properties": {
-    "schema": { "const": "kxm.model.v1" },
-    "provider": { "$ref": "common.schema.json#/$defs/identifier" },
+    "schema": { "const": "kxm.model.v2" },
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$",
+      "minLength": 1,
+      "maxLength": 64
+    },
+    "harness": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$",
+      "minLength": 1,
+      "maxLength": 64
+    },
     "model": { "type": "string", "minLength": 1, "maxLength": 200 },
+    "vendor": { "type": "string", "minLength": 1, "maxLength": 64 },
+    "status": { "enum": ["admitted", "candidate", "retired"] },
+    "permissions": {
+      "type": "array",
+      "items": { "enum": ["edit", "read-only"] },
+      "minItems": 1,
+      "maxItems": 2,
+      "uniqueItems": true
+    },
+    "origin": {
+      "type": "object",
+      "required": ["source", "sha256"],
+      "additionalProperties": false,
+      "properties": {
+        "source": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+      }
+    },
     "thinking": { "type": "string", "minLength": 1, "maxLength": 64 },
     "tags": {
       "type": "array",
-      "items": { "$ref": "common.schema.json#/$defs/identifier" },
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$",
+        "minLength": 1,
+        "maxLength": 64
+      },
       "uniqueItems": true,
       "maxItems": 32
     },
     "capabilities": {
       "type": "array",
-      "items": { "$ref": "common.schema.json#/$defs/identifier" },
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$",
+        "minLength": 1,
+        "maxLength": 64
+      },
       "uniqueItems": true,
       "maxItems": 32
     },
     "priority": { "type": "integer", "minimum": -10000, "maximum": 10000 },
     "fallbacks": {
       "type": "array",
-      "items": { "$ref": "common.schema.json#/$defs/modelSelector" },
-      "maxItems": 8
+      "maxItems": 8,
+      "items": {
+        "oneOf": [
+          {
+            "type": "object",
+            "required": ["profile"],
+            "additionalProperties": false,
+            "properties": {
+              "profile": {
+                "type": "string",
+                "pattern": "^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$",
+                "minLength": 1,
+                "maxLength": 64
+              }
+            }
+          },
+          {
+            "type": "object",
+            "required": ["tag"],
+            "additionalProperties": false,
+            "properties": {
+              "tag": {
+                "type": "string",
+                "pattern": "^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$",
+                "minLength": 1,
+                "maxLength": 64
+              },
+              "capabilities": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "pattern": "^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$",
+                  "minLength": 1,
+                  "maxLength": 64
+                },
+                "uniqueItems": true,
+                "maxItems": 32
+              }
+            }
+          },
+          {
+            "type": "object",
+            "required": ["provider", "model"],
+            "additionalProperties": false,
+            "properties": {
+              "provider": {
+                "type": "string",
+                "pattern": "^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$",
+                "minLength": 1,
+                "maxLength": 64
+              },
+              "model": { "type": "string", "minLength": 1, "maxLength": 200 }
+            }
+          }
+        ]
+      }
     },
     "limits": {
       "type": "object",
+      "additionalProperties": false,
       "properties": {
         "contextTokens": { "type": "integer", "minimum": 1 },
         "outputTokens": { "type": "integer", "minimum": 1 },
-        "timeoutMs": { "$ref": "common.schema.json#/$defs/durationMs" }
-      },
-      "additionalProperties": false
+        "timeoutMs": { "type": "integer", "minimum": 0, "maximum": 31536000000 }
+      }
     }
   },
-  "additionalProperties": false
+  "if": {
+    "properties": { "harness": { "const": "pi" } },
+    "required": ["harness"]
+  },
+  "then": { "required": ["origin"] }
 }

package/schemas/role.schema.json

@@ -1,14 +1,46 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://schemas.kxm.dev/role.schema.json",
-  "title": "KXM role definition",
-  "description": "The filename determines the role identity unless explicitly declared.",
+  "title": "KXM role",
+  "description": "Live kxm.role.v2 role. Specialty identity is separate from purpose. Roster order is configured preference, not a measured ranking.",
   "type": "object",
-  "required": ["schema", "description"],
+  "required": ["schema", "purpose", "permission", "description", "roster"],
+  "additionalProperties": false,
   "properties": {
-    "schema": { "const": "kxm.role.v1" },
-    "id": { "$ref": "common.schema.json#/$defs/identifier" },
+    "schema": { "const": "kxm.role.v2" },
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$",
+      "minLength": 1,
+      "maxLength": 64
+    },
+    "extends": { "$ref": "common.schema.json#/$defs/identifier" },
+    "purpose": {
+      "enum": ["writer", "planner", "reviewer-arch", "reviewer-cli", "experiment"]
+    },
+    "permission": { "enum": ["edit", "read-only"] },
     "description": { "type": "string", "minLength": 1, "maxLength": 2000 },
+    "roster": {
+      "type": "array",
+      "maxItems": 32,
+      "items": {
+        "type": "object",
+        "required": ["route"],
+        "additionalProperties": false,
+        "properties": {
+          "route": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$",
+            "minLength": 1,
+            "maxLength": 64
+          },
+          "effort": {
+            "enum": ["off", "minimal", "low", "medium", "high", "xhigh", "max"]
+          },
+          "mode": { "enum": ["headless", "interactive", "either"] }
+        }
+      }
+    },
     "skills": {
       "type": "array",
       "items": { "type": "string", "minLength": 1, "maxLength": 128 },
@@ -16,23 +48,23 @@
     },
     "tools": {
       "type": "object",
+      "additionalProperties": false,
       "properties": {
         "preset": { "type": "string" },
         "allow": { "type": "array", "items": { "type": "string" } },
         "deny": { "type": "array", "items": { "type": "string" } }
-      },
-      "additionalProperties": false
+      }
     },
     "produces": {
       "type": "array",
       "items": {
         "type": "object",
         "required": ["template"],
+        "additionalProperties": false,
         "properties": {
           "template": { "type": "string" },
           "schema": { "type": "string" }
-        },
-        "additionalProperties": false
+        }
       }
     },
     "consumes": {
@@ -40,37 +72,35 @@
       "items": {
         "type": "object",
         "required": ["template"],
+        "additionalProperties": false,
         "properties": {
           "template": { "type": "string" },
           "schema": { "type": "string" }
-        },
-        "additionalProperties": false
-      }
-    },
-    "roster": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["harness", "model"],
-        "properties": {
-          "harness": { "$ref": "common.schema.json#/$defs/identifier" },
-          "model": { "$ref": "common.schema.json#/$defs/modelSelector" },
-          "provider": { "type": "string" },
-          "effort": { "enum": ["low", "medium", "high", "xhigh"] },
-          "mode": { "enum": ["headless", "interactive", "either"] }
-        },
-        "additionalProperties": false
+        }
       }
     },
     "policy": {
       "type": "object",
+      "additionalProperties": false,
       "properties": {
         "vendorIndependenceRequired": { "type": "boolean" },
         "maxTransitions": { "type": "integer", "minimum": 1 },
-        "requiresGateVerification": { "type": "boolean" }
-      },
-      "additionalProperties": false
+        "requiresGateVerification": { "type": "boolean" },
+        "fallback": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "onError": {
+              "type": "array",
+              "items": { "enum": ["rate_limit", "transport", "provider_unavailable"] },
+              "uniqueItems": true,
+              "default": []
+            },
+            "maxSwitches": { "type": "integer", "minimum": 0 },
+            "revert": { "enum": ["next_run", "never"] }
+          }
+        }
+      }
     }
-  },
-  "additionalProperties": false
+  }
 }

package/schemas/policy-draft/README.md

@@ -1,17 +0,0 @@
-# Policy-draft schemas (non-authoritative)
-
-`kxm.model.v2` and `kxm.role.v2` here are **passive scaffolding**. They are not
-operator settings, live registry identities, or admission.
-
-- Live project models remain `kxm.model.v1` under `schemas/`.
-- Live CLI roles remain `kxm.role.v1`.
-- Runner admission remains `.kxm/roster.yaml` via the trusted control Git loader.
-- This directory is not discovered as a KXM project resource.
-
-Pure validation lives in `plugins/kxm/src/policy-draft.mjs`
-(`validatePolicyDraft`). Callers must supply draft documents, evidence bytes,
-and code-owned ceilings explicitly. The function does not read files, Git,
-credentials, or cwd, and it does not dispatch or admit a route.
-
-Roster `route` lists are configured preference order, not a measured ranking.
-`status: candidate` is stored as candidate data and is never treated as admitted.

package/schemas/policy-draft/model.v2.schema.json

@@ -1,140 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/policy-draft/model.v2.schema.json",
-  "title": "KXM policy-draft model route",
-  "description": "Passive kxm.model.v2 scaffolding. Not live registry selection, admission, or operator settings.",
-  "type": "object",
-  "required": ["schema", "harness", "model", "vendor", "status", "permissions"],
-  "additionalProperties": false,
-  "properties": {
-    "schema": { "const": "kxm.model.v2" },
-    "id": {
-      "type": "string",
-      "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$",
-      "minLength": 1,
-      "maxLength": 64
-    },
-    "harness": {
-      "type": "string",
-      "pattern": "^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$",
-      "minLength": 1,
-      "maxLength": 64
-    },
-    "model": { "type": "string", "minLength": 1, "maxLength": 200 },
-    "vendor": { "type": "string", "minLength": 1, "maxLength": 64 },
-    "status": { "enum": ["admitted", "candidate", "retired"] },
-    "permissions": {
-      "type": "array",
-      "items": { "enum": ["edit", "read-only"] },
-      "minItems": 1,
-      "maxItems": 2,
-      "uniqueItems": true
-    },
-    "origin": {
-      "type": "object",
-      "required": ["source", "sha256"],
-      "additionalProperties": false,
-      "properties": {
-        "source": { "type": "string", "minLength": 1, "maxLength": 512 },
-        "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
-      }
-    },
-    "thinking": { "type": "string", "minLength": 1, "maxLength": 64 },
-    "tags": {
-      "type": "array",
-      "items": {
-        "type": "string",
-        "pattern": "^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$",
-        "minLength": 1,
-        "maxLength": 64
-      },
-      "uniqueItems": true,
-      "maxItems": 32
-    },
-    "capabilities": {
-      "type": "array",
-      "items": {
-        "type": "string",
-        "pattern": "^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$",
-        "minLength": 1,
-        "maxLength": 64
-      },
-      "uniqueItems": true,
-      "maxItems": 32
-    },
-    "priority": { "type": "integer", "minimum": -10000, "maximum": 10000 },
-    "fallbacks": {
-      "type": "array",
-      "maxItems": 8,
-      "items": {
-        "oneOf": [
-          {
-            "type": "object",
-            "required": ["profile"],
-            "additionalProperties": false,
-            "properties": {
-              "profile": {
-                "type": "string",
-                "pattern": "^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$",
-                "minLength": 1,
-                "maxLength": 64
-              }
-            }
-          },
-          {
-            "type": "object",
-            "required": ["tag"],
-            "additionalProperties": false,
-            "properties": {
-              "tag": {
-                "type": "string",
-                "pattern": "^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$",
-                "minLength": 1,
-                "maxLength": 64
-              },
-              "capabilities": {
-                "type": "array",
-                "items": {
-                  "type": "string",
-                  "pattern": "^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$",
-                  "minLength": 1,
-                  "maxLength": 64
-                },
-                "uniqueItems": true,
-                "maxItems": 32
-              }
-            }
-          },
-          {
-            "type": "object",
-            "required": ["provider", "model"],
-            "additionalProperties": false,
-            "properties": {
-              "provider": {
-                "type": "string",
-                "pattern": "^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$",
-                "minLength": 1,
-                "maxLength": 64
-              },
-              "model": { "type": "string", "minLength": 1, "maxLength": 200 }
-            }
-          }
-        ]
-      }
-    },
-    "limits": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "contextTokens": { "type": "integer", "minimum": 1 },
-        "outputTokens": { "type": "integer", "minimum": 1 },
-        "timeoutMs": { "type": "integer", "minimum": 0, "maximum": 31536000000 }
-      }
-    }
-  },
-  "if": {
-    "properties": { "harness": { "const": "pi" } },
-    "required": ["harness"]
-  },
-  "then": { "required": ["origin"] }
-}

package/schemas/policy-draft/role.v2.schema.json

@@ -1,91 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://schemas.kxm.dev/policy-draft/role.v2.schema.json",
-  "title": "KXM policy-draft role",
-  "description": "Passive kxm.role.v2 scaffolding. Specialty identity is separate from purpose. Roster order is configured preference, not a measured ranking. Not live admission or operator settings.",
-  "type": "object",
-  "required": ["schema", "purpose", "permission", "description", "roster"],
-  "additionalProperties": false,
-  "properties": {
-    "schema": { "const": "kxm.role.v2" },
-    "id": {
-      "type": "string",
-      "pattern": "^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$",
-      "minLength": 1,
-      "maxLength": 64
-    },
-    "purpose": {
-      "enum": ["writer", "planner", "reviewer-arch", "reviewer-cli", "experiment"]
-    },
-    "permission": { "enum": ["edit", "read-only"] },
-    "description": { "type": "string", "minLength": 1, "maxLength": 2000 },
-    "roster": {
-      "type": "array",
-      "maxItems": 32,
-      "items": {
-        "type": "object",
-        "required": ["route"],
-        "additionalProperties": false,
-        "properties": {
-          "route": {
-            "type": "string",
-            "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$",
-            "minLength": 1,
-            "maxLength": 64
-          },
-          "effort": {
-            "enum": ["off", "minimal", "low", "medium", "high", "xhigh", "max"]
-          },
-          "mode": { "enum": ["headless", "interactive", "either"] }
-        }
-      }
-    },
-    "skills": {
-      "type": "array",
-      "items": { "type": "string", "minLength": 1, "maxLength": 128 },
-      "maxItems": 64
-    },
-    "tools": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "preset": { "type": "string" },
-        "allow": { "type": "array", "items": { "type": "string" } },
-        "deny": { "type": "array", "items": { "type": "string" } }
-      }
-    },
-    "produces": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["template"],
-        "additionalProperties": false,
-        "properties": {
-          "template": { "type": "string" },
-          "schema": { "type": "string" }
-        }
-      }
-    },
-    "consumes": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["template"],
-        "additionalProperties": false,
-        "properties": {
-          "template": { "type": "string" },
-          "schema": { "type": "string" }
-        }
-      }
-    },
-    "policy": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "vendorIndependenceRequired": { "type": "boolean" },
-        "maxTransitions": { "type": "integer", "minimum": 1 },
-        "requiresGateVerification": { "type": "boolean" }
-      }
-    }
-  }
-}