@kontextmind/kxm 0.6.0

package/schemas/vnext/README.md

@@ -0,0 +1,46 @@
+# KXM vNext schemas
+
+These draft 2020-12 JSON Schemas validate parsed YAML configuration, bounded
+Runtime-local records, and JSON events/results for the planned vNext contract.
+
+| Schema | Identity |
+|---|---|
+| `project.schema.json` | `kxm.project.v1` |
+| `repository.schema.json` | `kxm.repository.v1` |
+| `agent.schema.json` | `kxm.agent.v1` |
+| `model.schema.json` | `kxm.model.v1` |
+| `environment.schema.json` | `kxm.environment.v1` |
+| `workflow.schema.json` | `kxm.workflow.v1` |
+| `template-provenance.schema.json` | `kxm.template-provenance.v1` |
+| `local-repository-bindings.schema.json` | `kxm.local-repository-bindings.v1` |
+| `init-operation.schema.json` | `kxm.init-operation.v1` |
+| `migration-plan.schema.json` | `kxm.migration-plan.v1` |
+| `migration-decision.schema.json` | `kxm.migration-decision.v1` |
+| `migration-receipt.schema.json` | `kxm.migration-receipt.v1` |
+| `permission-diff.schema.json` | `kxm.permission-diff.v1` |
+| `run-event.schema.json` | `kxm.run-event.v1` |
+| `sync-event.schema.json` | `kxm.sync-event.v1` |
+| `assignment-result.schema.json` | `kxm.assignment-result.v1` |
+| `delivery-manifest.schema.json` | `kxm.delivery-manifest.v1` |
+| `context-candidate.schema.json` | `kxm.context-candidate.v1` |
+| `candidate.schema.json` | `kxm.candidate.v1` |
+
+`common.schema.json` supplies bounded shared definitions. JSON Schema is only
+one validation layer; cross-file references, state-machine semantics,
+permission diffs, model diversity, path portability, and snapshot reproduction
+are deterministic semantic checks described in
+[`docs/vnext/validation.md`](../../docs/vnext/validation.md).
+
+Unknown fields fail closed. A new field requires a reviewed schema revision;
+do not add generic metadata escape hatches to event or synchronization payloads.
+
+`kxm.run-event.v1` `run.created` records declared inventory as `repositoryIds`
+and `executorIds` (empty executor inventory is valid). `repositories` /
+`executors` object arrays remain optional prepared snapshots/resolutions and
+are not emitted by the D2 engine. `memoryRevision` is required;
+`ctxrev_absent` is the explicit none value until E5. D2 event types have
+closed payload contracts for the identity, status, and result fields the
+engine emits. `assignment.result_recorded` requires `assignmentId` and
+`resultClass`; class `outcome` requires `outcome`, and the non-outcome
+classes forbid it. Shared future event types stay in the enum; this slice
+does not emit `waiting` or `blocked_uncertain` run transitions.

package/schemas/vnext/agent.schema.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.kxm.dev/vnext/agent.schema.json",
+  "title": "KXM agent definition",
+  "description": "The filename determines the agent identity.",
+  "type": "object",
+  "required": ["schema", "purpose"],
+  "properties": {
+    "schema": { "const": "kxm.agent.v1" },
+    "purpose": { "type": "string", "minLength": 1, "maxLength": 2000 },
+    "instructions": { "type": "string", "maxLength": 16000 },
+    "model": { "$ref": "common.schema.json#/$defs/modelSelector" },
+    "executor": { "$ref": "common.schema.json#/$defs/identifier" },
+    "harness": { "$ref": "common.schema.json#/$defs/identifier" },
+    "tools": { "$ref": "common.schema.json#/$defs/toolPolicy" },
+    "defaultRepositoryAccess": { "$ref": "common.schema.json#/$defs/repositoryAccess" },
+    "repositories": {
+      "type": "object",
+      "propertyNames": { "$ref": "common.schema.json#/$defs/identifier" },
+      "additionalProperties": { "$ref": "common.schema.json#/$defs/repositoryAccess" },
+      "maxProperties": 64
+    },
+    "secrets": {
+      "type": "array",
+      "items": { "$ref": "common.schema.json#/$defs/secretGrant" },
+      "maxItems": 64
+    },
+    "network": { "enum": ["none", "provider-only", "restricted", "host"] },
+    "resultSchema": { "type": "string", "minLength": 1, "maxLength": 512 },
+    "session": {
+      "type": "object",
+      "properties": {
+        "reuse": { "const": "compatible-run-scope" },
+        "maxIdleMs": { "$ref": "common.schema.json#/$defs/durationMs" }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/vnext/assignment-result.schema.json

@@ -0,0 +1,66 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.kxm.dev/vnext/assignment-result.schema.json",
+  "title": "KXM structured assignment result",
+  "type": "object",
+  "required": [
+    "schema",
+    "projectId",
+    "runId",
+    "stepId",
+    "stepAttempt",
+    "assignmentId",
+    "attemptId",
+    "status",
+    "outcome",
+    "summary",
+    "timing"
+  ],
+  "properties": {
+    "schema": { "const": "kxm.assignment-result.v1" },
+    "projectId": { "$ref": "common.schema.json#/$defs/opaqueId" },
+    "runId": { "$ref": "common.schema.json#/$defs/opaqueId" },
+    "stepId": { "$ref": "common.schema.json#/$defs/identifier" },
+    "stepAttempt": { "type": "integer", "minimum": 1 },
+    "assignmentId": { "$ref": "common.schema.json#/$defs/opaqueId" },
+    "attemptId": { "$ref": "common.schema.json#/$defs/opaqueId" },
+    "status": { "enum": ["passed", "failed", "blocked_uncertain", "cancelled"] },
+    "outcome": { "$ref": "common.schema.json#/$defs/identifier" },
+    "summary": { "type": "string", "minLength": 1, "maxLength": 4000 },
+    "evidenceRefs": {
+      "type": "array",
+      "items": { "$ref": "common.schema.json#/$defs/evidenceRef" },
+      "maxItems": 64
+    },
+    "artifacts": {
+      "type": "array",
+      "items": { "$ref": "common.schema.json#/$defs/artifactRef" },
+      "maxItems": 64
+    },
+    "repositoryOutputs": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["repositoryId", "baseCommit", "contentSnapshotHash"],
+        "properties": {
+          "repositoryId": { "$ref": "common.schema.json#/$defs/identifier" },
+          "baseCommit": { "$ref": "common.schema.json#/$defs/gitCommit" },
+          "contentSnapshotHash": { "$ref": "common.schema.json#/$defs/sha256" },
+          "outputCommit": { "$ref": "common.schema.json#/$defs/gitCommit" },
+          "changes": { "$ref": "common.schema.json#/$defs/fileChanges" }
+        },
+        "additionalProperties": false
+      },
+      "maxItems": 64
+    },
+    "receipts": {
+      "type": "array",
+      "items": { "$ref": "common.schema.json#/$defs/receipt" },
+      "maxItems": 64
+    },
+    "timing": { "$ref": "common.schema.json#/$defs/timing" },
+    "usage": { "$ref": "common.schema.json#/$defs/usage" },
+    "error": { "$ref": "common.schema.json#/$defs/errorSummary" }
+  },
+  "additionalProperties": false
+}

package/schemas/vnext/backup-manifest.schema.json

@@ -0,0 +1,89 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.kxm.dev/vnext/backup-manifest.schema.json",
+  "title": "KXM SQLite stores backup manifest",
+  "type": "object",
+  "required": [
+    "schema",
+    "backupId",
+    "createdAt",
+    "stores"
+  ],
+  "properties": {
+    "schema": {
+      "const": "kxm.backup-manifest.v1"
+    },
+    "backupId": {
+      "$ref": "common.schema.json#/$defs/opaqueId"
+    },
+    "createdAt": {
+      "$ref": "common.schema.json#/$defs/timestamp"
+    },
+    "projectRoot": {
+      "type": "string",
+      "maxLength": 1024
+    },
+    "stores": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/backupStoreRecord"
+      },
+      "minItems": 1,
+      "maxItems": 64
+    },
+    "manifestSha256": {
+      "$ref": "common.schema.json#/$defs/sha256"
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "backupStoreRecord": {
+      "type": "object",
+      "required": [
+        "storeId",
+        "sourcePath",
+        "backupFile",
+        "schemaVersion",
+        "sha256",
+        "bytes",
+        "integrity"
+      ],
+      "properties": {
+        "storeId": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 128,
+          "pattern": "^[a-zA-Z0-9_.:-]+$"
+        },
+        "sourcePath": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 1024
+        },
+        "backupFile": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256,
+          "pattern": "^[a-zA-Z0-9_.-]+$"
+        },
+        "schemaVersion": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 1000000
+        },
+        "sha256": {
+          "$ref": "common.schema.json#/$defs/sha256"
+        },
+        "bytes": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 107374182400
+        },
+        "integrity": {
+          "const": "ok"
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/vnext/candidate.schema.json

@@ -0,0 +1,109 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.kxm.dev/vnext/candidate.schema.json",
+  "title": "KXM coded-repeat improvement candidate",
+  "type": "object",
+  "required": [
+    "schema",
+    "id",
+    "kind",
+    "summary",
+    "evidenceRefs",
+    "baselineMetrics",
+    "declaredOutcome",
+    "measure",
+    "proposedDiffPath",
+    "status",
+    "createdAt"
+  ],
+  "properties": {
+    "schema": {
+      "const": "kxm.candidate.v1"
+    },
+    "id": {
+      "$ref": "common.schema.json#/$defs/opaqueId"
+    },
+    "kind": {
+      "enum": [
+        "gate",
+        "skill",
+        "workflow-step"
+      ]
+    },
+    "summary": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 2000
+    },
+    "evidenceRefs": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 256
+      },
+      "minItems": 1,
+      "maxItems": 64
+    },
+    "baselineMetrics": {
+      "type": "object",
+      "required": [
+        "recurrence",
+        "meanCost",
+        "meanLatency",
+        "verifyPassRate",
+        "rework"
+      ],
+      "properties": {
+        "recurrence": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "meanCost": {
+          "type": "number",
+          "minimum": 0
+        },
+        "meanLatency": {
+          "type": "number",
+          "minimum": 0
+        },
+        "verifyPassRate": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        },
+        "rework": {
+          "type": "integer",
+          "minimum": 0
+        }
+      },
+      "additionalProperties": false
+    },
+    "declaredOutcome": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 2000
+    },
+    "measure": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 2000
+    },
+    "proposedDiffPath": {
+      "$ref": "common.schema.json#/$defs/relativePath"
+    },
+    "status": {
+      "enum": [
+        "proposed",
+        "evaluating",
+        "review-required",
+        "promoted",
+        "rejected"
+      ]
+    },
+    "createdAt": {
+      "$ref": "common.schema.json#/$defs/timestamp"
+    }
+  },
+  "additionalProperties": false
+}