@kontextmind/kxm 0.6.0

package/schemas/vnext/init-operation.schema.json

@@ -0,0 +1,61 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.kxm.dev/vnext/init-operation.schema.json",
+  "title": "KXM Runtime-local initialization operation v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "operationId",
+    "kind",
+    "phase",
+    "projectRoot",
+    "projectId",
+    "projectName",
+    "templateId",
+    "sourceTemplateRevision",
+    "targetTemplateRevision",
+    "planSha256",
+    "files"
+  ],
+  "properties": {
+    "schema": { "const": "kxm.init-operation.v1" },
+    "operationId": { "type": "string", "pattern": "^op_[a-f0-9]{32}$" },
+    "kind": { "enum": ["create", "repair"] },
+    "phase": { "enum": ["preparing", "prepared", "applying", "verified"] },
+    "projectRoot": { "type": "string", "minLength": 1, "maxLength": 32768, "pattern": "^(?:[A-Za-z]:[\\\\/]|\\\\\\\\|/)" },
+    "projectId": { "$ref": "common.schema.json#/$defs/opaqueId" },
+    "projectName": { "type": "string", "minLength": 1, "maxLength": 120, "pattern": "^[^\\u0000\\r\\n]+$" },
+    "templateId": { "const": "builtin-minimal" },
+    "sourceTemplateRevision": {
+      "oneOf": [
+        { "type": "null" },
+        { "$ref": "common.schema.json#/$defs/sha256" }
+      ]
+    },
+    "targetTemplateRevision": { "$ref": "common.schema.json#/$defs/sha256" },
+    "planSha256": { "$ref": "common.schema.json#/$defs/sha256" },
+    "files": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 128,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["path", "observedSha256", "targetSha256", "classification", "action"],
+        "properties": {
+          "path": { "$ref": "common.schema.json#/$defs/relativePath" },
+          "observedSha256": {
+            "oneOf": [
+              { "type": "null" },
+              { "$ref": "common.schema.json#/$defs/sha256" }
+            ]
+          },
+          "targetSha256": { "$ref": "common.schema.json#/$defs/sha256" },
+          "classification": { "enum": ["template-only", "converged"] },
+          "action": { "enum": ["create", "replace", "none"] }
+        }
+      }
+    }
+  }
+}

package/schemas/vnext/local-repository-bindings.schema.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.kxm.dev/vnext/local-repository-bindings.schema.json",
+  "title": "KXM Runtime-local repository bindings",
+  "type": "object",
+  "required": ["schema", "projectId", "projectRoot", "repositories"],
+  "properties": {
+    "schema": { "const": "kxm.local-repository-bindings.v1" },
+    "projectId": { "$ref": "common.schema.json#/$defs/opaqueId" },
+    "projectRoot": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 32768,
+      "pattern": "^(?:[A-Za-z]:[\\\\/]|\\\\\\\\|/)"
+    },
+    "repositories": {
+      "type": "object",
+      "minProperties": 1,
+      "maxProperties": 64,
+      "propertyNames": { "$ref": "common.schema.json#/$defs/identifier" },
+      "additionalProperties": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 32768,
+        "pattern": "^(?:[A-Za-z]:[\\\\/]|\\\\\\\\|/)"
+      }
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/vnext/memory-record.schema.json

@@ -0,0 +1,45 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.kxm.dev/vnext/memory-record.schema.json",
+  "title": "KXM harness-agnostic memory record",
+  "type": "object",
+  "required": [
+    "schema",
+    "id",
+    "scope",
+    "kind",
+    "summary",
+    "provenance",
+    "authority",
+    "confidence",
+    "lifecycle",
+    "evidenceRefs"
+  ],
+  "properties": {
+    "schema": { "const": "kxm.memory.v1" },
+    "id": { "$ref": "common.schema.json#/$defs/identifier" },
+    "scope": { "enum": ["agent", "project", "run", "operator"] },
+    "kind": { "$ref": "common.schema.json#/$defs/identifier" },
+    "summary": { "type": "string", "minLength": 1, "maxLength": 2000 },
+    "provenance": {
+      "type": "object",
+      "required": ["sourceType"],
+      "properties": {
+        "sourceType": { "type": "string", "minLength": 1, "maxLength": 64 },
+        "sourceRef": { "type": "string", "maxLength": 256 },
+        "runId": { "$ref": "common.schema.json#/$defs/opaqueId" },
+        "timestamp": { "$ref": "common.schema.json#/$defs/timestamp" }
+      },
+      "additionalProperties": false
+    },
+    "authority": { "enum": ["instruction", "evidence", "promoted"] },
+    "confidence": { "enum": ["verified", "probable", "uncertain"] },
+    "lifecycle": { "enum": ["active", "deprecated", "superseded"] },
+    "evidenceRefs": {
+      "type": "array",
+      "items": { "$ref": "common.schema.json#/$defs/evidenceRef" },
+      "maxItems": 64
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/vnext/migration-decision.schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.kxm.dev/vnext/migration-decision.schema.json",
+  "title": "KXM reviewed legacy configuration migration decisions",
+  "type": "object",
+  "required": ["schema", "projectId", "projectName", "sourceDigest", "resolutions"],
+  "properties": {
+    "schema": { "const": "kxm.migration-decision.v1" },
+    "projectId": { "$ref": "common.schema.json#/$defs/opaqueId" },
+    "projectName": { "type": "string", "minLength": 1, "maxLength": 120 },
+    "sourceDigest": { "$ref": "common.schema.json#/$defs/sha256" },
+    "resolutions": {
+      "type": "object",
+      "propertyNames": { "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]{0,511}$" },
+      "additionalProperties": {
+        "oneOf": [
+          { "type": "string", "minLength": 1, "maxLength": 256 },
+          { "type": "integer", "minimum": 1, "maximum": 1000 },
+          { "type": "boolean" }
+        ]
+      },
+      "maxProperties": 1024
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/vnext/migration-plan.schema.json

@@ -0,0 +1,123 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.kxm.dev/vnext/migration-plan.schema.json",
+  "title": "KXM legacy configuration migration plan",
+  "type": "object",
+  "required": [
+    "schema",
+    "projectId",
+    "projectName",
+    "sourceDigest",
+    "sources",
+    "resources",
+    "ambiguities",
+    "unmapped",
+    "renames",
+    "permissionChanges",
+    "canApply"
+  ],
+  "properties": {
+    "schema": { "const": "kxm.migration-plan.v1" },
+    "projectId": { "$ref": "common.schema.json#/$defs/opaqueId" },
+    "projectName": { "type": "string", "minLength": 1, "maxLength": 120 },
+    "sourceDigest": { "$ref": "common.schema.json#/$defs/sha256" },
+    "sources": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/fileRecord" },
+      "minItems": 1,
+      "maxItems": 256
+    },
+    "resources": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/fileRecord" },
+      "minItems": 2,
+      "maxItems": 512
+    },
+    "ambiguities": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/ambiguity" },
+      "maxItems": 1024
+    },
+    "unmapped": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/unmapped" },
+      "maxItems": 2048
+    },
+    "renames": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/rename" },
+      "maxItems": 1024
+    },
+    "permissionChanges": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/permissionChange" },
+      "maxItems": 512
+    },
+    "canApply": { "type": "boolean" }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "fileRecord": {
+      "type": "object",
+      "required": ["path", "sha256", "bytes"],
+      "properties": {
+        "path": { "$ref": "common.schema.json#/$defs/relativePath" },
+        "sha256": { "$ref": "common.schema.json#/$defs/sha256" },
+        "bytes": { "type": "integer", "minimum": 0, "maximum": 268435456 }
+      },
+      "additionalProperties": false
+    },
+    "ambiguity": {
+      "type": "object",
+      "required": ["key", "category", "sourcePath", "message", "allowedValues"],
+      "properties": {
+        "key": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]{0,511}$" },
+        "category": {
+          "enum": ["unsupported", "identity", "step-kind", "terminal-status", "transition-budget", "evidence-policy", "permission", "secret-reference"]
+        },
+        "sourcePath": { "$ref": "common.schema.json#/$defs/relativePath" },
+        "message": { "type": "string", "minLength": 1, "maxLength": 2000 },
+        "allowedValues": {
+          "type": "array",
+          "items": { "oneOf": [{ "type": "string", "maxLength": 256 }, { "type": "integer", "minimum": 1, "maximum": 100 }] },
+          "minItems": 1,
+          "maxItems": 64
+        }
+      },
+      "additionalProperties": false
+    },
+    "unmapped": {
+      "type": "object",
+      "required": ["sourcePath", "jsonPointer", "valueSha256", "sensitive"],
+      "properties": {
+        "sourcePath": { "$ref": "common.schema.json#/$defs/relativePath" },
+        "jsonPointer": { "type": "string", "pattern": "^/", "maxLength": 1024 },
+        "valueSha256": { "$ref": "common.schema.json#/$defs/sha256" },
+        "sensitive": { "type": "boolean" }
+      },
+      "additionalProperties": false
+    },
+    "rename": {
+      "type": "object",
+      "required": ["from", "to", "kind"],
+      "properties": {
+        "from": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "to": { "$ref": "common.schema.json#/$defs/identifier" },
+        "kind": { "enum": ["agent", "model", "workflow", "step", "evidence", "outcome"] }
+      },
+      "additionalProperties": false
+    },
+    "permissionChange": {
+      "type": "object",
+      "required": ["sourcePath", "targetPath", "direction", "summary", "decisionKey"],
+      "properties": {
+        "sourcePath": { "$ref": "common.schema.json#/$defs/relativePath" },
+        "targetPath": { "$ref": "common.schema.json#/$defs/relativePath" },
+        "direction": { "enum": ["narrowing", "expansion", "unknown"] },
+        "summary": { "type": "string", "minLength": 1, "maxLength": 2000 },
+        "decisionKey": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._:/-]{0,511}$" }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/vnext/migration-receipt.schema.json

@@ -0,0 +1,52 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.kxm.dev/vnext/migration-receipt.schema.json",
+  "title": "KXM verified legacy configuration migration receipt",
+  "type": "object",
+  "required": [
+    "schema",
+    "migrationId",
+    "projectId",
+    "sourceDigest",
+    "decisionDigest",
+    "configRevision",
+    "sources",
+    "resources",
+    "receiptSha256"
+  ],
+  "properties": {
+    "schema": { "const": "kxm.migration-receipt.v1" },
+    "migrationId": { "$ref": "common.schema.json#/$defs/opaqueId" },
+    "projectId": { "$ref": "common.schema.json#/$defs/opaqueId" },
+    "sourceDigest": { "$ref": "common.schema.json#/$defs/sha256" },
+    "decisionDigest": { "$ref": "common.schema.json#/$defs/sha256" },
+    "configRevision": { "$ref": "common.schema.json#/$defs/sha256" },
+    "sources": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/fileRecord" },
+      "minItems": 1,
+      "maxItems": 256
+    },
+    "resources": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/fileRecord" },
+      "minItems": 2,
+      "maxItems": 512
+    },
+    "previousReceiptSha256": { "$ref": "common.schema.json#/$defs/sha256" },
+    "receiptSha256": { "$ref": "common.schema.json#/$defs/sha256" }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "fileRecord": {
+      "type": "object",
+      "required": ["path", "sha256", "bytes"],
+      "properties": {
+        "path": { "$ref": "common.schema.json#/$defs/relativePath" },
+        "sha256": { "$ref": "common.schema.json#/$defs/sha256" },
+        "bytes": { "type": "integer", "minimum": 0, "maximum": 268435456 }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/vnext/model.schema.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.kxm.dev/vnext/model.schema.json",
+  "title": "KXM model profile",
+  "description": "The filename determines the profile identity.",
+  "type": "object",
+  "required": ["schema", "provider", "model"],
+  "properties": {
+    "schema": { "const": "kxm.model.v1" },
+    "provider": { "$ref": "common.schema.json#/$defs/identifier" },
+    "model": { "type": "string", "minLength": 1, "maxLength": 200 },
+    "thinking": { "type": "string", "minLength": 1, "maxLength": 64 },
+    "tags": {
+      "type": "array",
+      "items": { "$ref": "common.schema.json#/$defs/identifier" },
+      "uniqueItems": true,
+      "maxItems": 32
+    },
+    "capabilities": {
+      "type": "array",
+      "items": { "$ref": "common.schema.json#/$defs/identifier" },
+      "uniqueItems": true,
+      "maxItems": 32
+    },
+    "priority": { "type": "integer", "minimum": -10000, "maximum": 10000 },
+    "fallbacks": {
+      "type": "array",
+      "items": { "$ref": "common.schema.json#/$defs/modelSelector" },
+      "maxItems": 8
+    },
+    "limits": {
+      "type": "object",
+      "properties": {
+        "contextTokens": { "type": "integer", "minimum": 1 },
+        "outputTokens": { "type": "integer", "minimum": 1 },
+        "timeoutMs": { "$ref": "common.schema.json#/$defs/durationMs" }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/vnext/permission-diff.schema.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.kxm.dev/vnext/permission-diff.schema.json",
+  "title": "KXM permission-diff trust report",
+  "description": "Structured, deterministic diff of authority-bearing fields between a trusted base bundle and a candidate bundle.",
+  "type": "object",
+  "required": ["schema", "baseRevision", "candidateRevision", "changes", "expansions", "narrowings", "neutralChanges", "requiresReview"],
+  "properties": {
+    "schema": { "const": "kxm.permission-diff.v1" },
+    "baseRevision": { "$ref": "common.schema.json#/$defs/sha256" },
+    "candidateRevision": { "$ref": "common.schema.json#/$defs/sha256" },
+    "changes": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/change" },
+      "maxItems": 4096
+    },
+    "expansions": { "type": "array", "items": { "$ref": "#/$defs/change" }, "maxItems": 4096 },
+    "narrowings": { "type": "array", "items": { "$ref": "#/$defs/change" }, "maxItems": 4096 },
+    "neutralChanges": { "type": "array", "items": { "$ref": "#/$defs/change" }, "maxItems": 4096 },
+    "requiresReview": { "type": "boolean" }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "change": {
+      "type": "object",
+      "required": ["resource", "path", "field", "direction", "summary"],
+      "properties": {
+        "resource": { "$ref": "common.schema.json#/$defs/relativePath" },
+        "path": { "type": "string", "pattern": "^/", "maxLength": 1024 },
+        "field": {
+          "enum": [
+            "repository-access",
+            "tools",
+            "secrets",
+            "executor",
+            "network",
+            "model",
+            "sync-policy",
+            "snapshot-policy",
+            "evidence-quorum",
+            "transition",
+            "budget",
+            "resource-shape",
+            "environment",
+            "gate",
+            "delivery"
+          ]
+        },
+        "direction": { "enum": ["expansion", "narrowing", "neutral"] },
+        "summary": { "type": "string", "minLength": 1, "maxLength": 2000 },
+        "baseValueSha256": { "$ref": "common.schema.json#/$defs/sha256" },
+        "candidateValueSha256": { "$ref": "common.schema.json#/$defs/sha256" }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/vnext/prices.schema.json

@@ -0,0 +1,115 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.kxm.dev/vnext/prices.schema.json",
+  "title": "KXM price catalog",
+  "type": "object",
+  "required": [
+    "schema",
+    "date",
+    "sha256",
+    "models"
+  ],
+  "properties": {
+    "schema": {
+      "const": "kxm.prices.v1"
+    },
+    "date": {
+      "type": "string",
+      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
+    },
+    "sha256": {
+      "type": "string",
+      "pattern": "^(?:sha256:)?[a-f0-9]{64}$"
+    },
+    "currency": {
+      "type": "string",
+      "pattern": "^[A-Z]{3}$"
+    },
+    "models": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 256,
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "provider",
+          "model",
+          "tiers"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128
+          },
+          "provider": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 64
+          },
+          "model": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128
+          },
+          "aliases": {
+            "type": "array",
+            "maxItems": 32,
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 128
+            }
+          },
+          "tiers": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 32,
+            "items": {
+              "type": "object",
+              "required": [
+                "inputPerMillion",
+                "outputPerMillion"
+              ],
+              "properties": {
+                "upToContextTokens": {
+                  "type": [
+                    "integer",
+                    "null"
+                  ],
+                  "minimum": 1
+                },
+                "inputPerMillion": {
+                  "type": "number",
+                  "minimum": 0
+                },
+                "outputPerMillion": {
+                  "type": "number",
+                  "minimum": 0
+                },
+                "cacheReadPerMillion": {
+                  "type": [
+                    "number",
+                    "null"
+                  ],
+                  "minimum": 0
+                },
+                "cacheWritePerMillion": {
+                  "type": [
+                    "number",
+                    "null"
+                  ],
+                  "minimum": 0
+                }
+              },
+              "additionalProperties": false
+            }
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/vnext/project.schema.json

@@ -0,0 +1,85 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.kxm.dev/vnext/project.schema.json",
+  "title": "KXM project definition",
+  "type": "object",
+  "required": ["schema", "id", "name", "repositories"],
+  "properties": {
+    "schema": { "const": "kxm.project.v1" },
+    "id": { "$ref": "common.schema.json#/$defs/opaqueId" },
+    "name": { "type": "string", "minLength": 1, "maxLength": 120 },
+    "description": { "type": "string", "maxLength": 2000 },
+    "defaultWorkflow": { "$ref": "common.schema.json#/$defs/identifier" },
+    "defaultExecutor": { "$ref": "common.schema.json#/$defs/identifier" },
+    "defaultHarness": { "$ref": "common.schema.json#/$defs/identifier" },
+    "repositories": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 64,
+      "items": {
+        "type": "object",
+        "required": ["id", "role"],
+        "properties": {
+          "id": { "$ref": "common.schema.json#/$defs/identifier" },
+          "role": { "enum": ["control", "member"] },
+          "required": { "type": "boolean", "default": true },
+          "remoteIdentity": { "type": "string", "minLength": 1, "maxLength": 2048 },
+          "defaultBranch": { "type": "string", "minLength": 1, "maxLength": 255 },
+          "pathHint": { "$ref": "common.schema.json#/$defs/relativePath" }
+        },
+        "additionalProperties": false
+      }
+    },
+    "workspace": {
+      "type": "object",
+      "properties": {
+        "dirtySnapshot": {
+          "type": "object",
+          "properties": {
+            "untracked": { "enum": ["bounded", "tracked-only", "ask"] },
+            "maxUntrackedFileBytes": { "type": "integer", "minimum": 1, "maximum": 1073741824 },
+            "maxUntrackedTotalBytes": { "type": "integer", "minimum": 1, "maximum": 10737418240 },
+            "dirtySubmodules": { "const": "fail" }
+          },
+          "allOf": [
+            {
+              "if": {
+                "properties": { "untracked": { "const": "bounded" } },
+                "required": ["untracked"]
+              },
+              "then": {
+                "required": ["maxUntrackedFileBytes", "maxUntrackedTotalBytes"]
+              }
+            }
+          ],
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "sync": {
+      "type": "object",
+      "properties": {
+        "prompts": { "const": "title-only" },
+        "results": { "const": "bounded-summary" },
+        "evidence": { "const": "references" },
+        "artifacts": { "const": "metadata" },
+        "fileChanges": { "const": "paths-only" },
+        "rawLogs": { "const": false },
+        "diffs": { "const": false },
+        "environmentValues": { "const": false }
+      },
+      "additionalProperties": false
+    },
+    "limits": {
+      "type": "object",
+      "properties": {
+        "maxConcurrentRuns": { "type": "integer", "minimum": 1, "maximum": 128 },
+        "maxRunDurationMs": { "$ref": "common.schema.json#/$defs/durationMs" },
+        "maxAgentTimeMs": { "$ref": "common.schema.json#/$defs/durationMs" }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}