@kontextmind/kxm 0.6.0

package/schemas/vnext/context-packet.schema.json

@@ -0,0 +1,192 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.kxm.dev/vnext/context-packet.schema.json",
+  "title": "KXM formal context packet v2",
+  "type": "object",
+  "required": [
+    "schema",
+    "packetId",
+    "project",
+    "generatedAt",
+    "targetRole",
+    "task",
+    "acceptanceCriteria",
+    "plan",
+    "predecessors",
+    "environment",
+    "budget"
+  ],
+  "properties": {
+    "schema": {
+      "const": "kxm.context-packet.v2"
+    },
+    "packetId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128
+    },
+    "project": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128
+    },
+    "generatedAt": {
+      "$ref": "common.schema.json#/$defs/timestamp"
+    },
+    "targetRole": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 64
+    },
+    "task": {
+      "type": "object",
+      "required": [
+        "taskId",
+        "stepId",
+        "stepAttempt",
+        "objective",
+        "allowedOutcomes",
+        "permissionCeiling"
+      ],
+      "properties": {
+        "taskId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "stepId": { "type": "string", "minLength": 1, "maxLength": 64 },
+        "stepAttempt": { "type": "integer", "minimum": 1 },
+        "objective": { "type": "string", "minLength": 1, "maxLength": 4000 },
+        "allowedOutcomes": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1, "maxLength": 64 }
+        },
+        "permissionCeiling": {
+          "enum": ["read-only", "edit", "admin"]
+        }
+      },
+      "additionalProperties": false
+    },
+    "acceptanceCriteria": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "description", "verificationKind", "required"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1, "maxLength": 64 },
+          "description": { "type": "string", "minLength": 1, "maxLength": 1000 },
+          "verificationKind": {
+            "enum": ["gate", "witness", "critic", "human"]
+          },
+          "targetRef": { "type": "string", "maxLength": 256 },
+          "required": { "type": "boolean" }
+        },
+        "additionalProperties": false
+      }
+    },
+    "plan": {
+      "type": "object",
+      "required": ["planHash", "activeStepIndex", "totalSteps", "settledDecisions"],
+      "properties": {
+        "planHash": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "activeStepIndex": { "type": "integer", "minimum": 0 },
+        "totalSteps": { "type": "integer", "minimum": 1 },
+        "settledDecisions": {
+          "type": "array",
+          "items": { "type": "string", "maxLength": 500 }
+        }
+      },
+      "additionalProperties": false
+    },
+    "predecessors": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["stepId", "role", "status", "summary", "settledAt", "artifacts", "decisions"],
+        "properties": {
+          "stepId": { "type": "string", "minLength": 1, "maxLength": 64 },
+          "role": { "type": "string", "minLength": 1, "maxLength": 64 },
+          "status": {
+            "enum": ["passed", "warning", "failed", "settled"]
+          },
+          "summary": { "type": "string", "maxLength": 4000 },
+          "settledAt": { "$ref": "common.schema.json#/$defs/timestamp" },
+          "artifacts": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["name", "kind", "artifactRef"],
+              "properties": {
+                "name": { "type": "string", "maxLength": 256 },
+                "kind": { "enum": ["patch", "report", "log", "plan", "repro_script", "doc"] },
+                "artifactRef": { "type": "string", "maxLength": 256 },
+                "contentSnippet": { "type": "string", "maxLength": 8000 }
+              },
+              "additionalProperties": false
+            }
+          },
+          "decisions": {
+            "type": "array",
+            "items": { "type": "string", "maxLength": 500 }
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "environment": {
+      "type": "object",
+      "required": [
+        "sharedDefaults",
+        "projectKnowledge",
+        "currentState",
+        "contradictions",
+        "activeSkills"
+      ],
+      "properties": {
+        "sharedDefaults": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["id", "summary"],
+            "properties": {
+              "id": { "type": "string" },
+              "summary": { "type": "string" }
+            },
+            "additionalProperties": false
+          }
+        },
+        "projectKnowledge": {
+          "type": "array",
+          "items": { "type": "object" }
+        },
+        "currentState": {
+          "type": "array",
+          "items": { "type": "object" }
+        },
+        "contradictions": {
+          "type": "array",
+          "items": { "type": "object" }
+        },
+        "activeSkills": {
+          "type": "array",
+          "items": { "type": "object" }
+        }
+      },
+      "additionalProperties": false
+    },
+    "budget": {
+      "type": "object",
+      "required": ["allocatedTokens", "estimatedTokens", "unresolvedGaps", "provenanceSummary"],
+      "properties": {
+        "allocatedTokens": { "type": "integer", "minimum": 1 },
+        "estimatedTokens": { "type": "integer", "minimum": 0 },
+        "unresolvedGaps": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "provenanceSummary": {
+          "type": "object",
+          "additionalProperties": { "type": "integer" }
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

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

@@ -0,0 +1,159 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.kxm.dev/vnext/delivery-manifest.schema.json",
+  "title": "KXM non-atomic multi-repository delivery manifest",
+  "type": "object",
+  "required": [
+    "schema",
+    "projectId",
+    "runId",
+    "createdAt",
+    "configRevision",
+    "atomic",
+    "status",
+    "repositories"
+  ],
+  "properties": {
+    "schema": { "const": "kxm.delivery-manifest.v1" },
+    "projectId": { "$ref": "common.schema.json#/$defs/opaqueId" },
+    "runId": { "$ref": "common.schema.json#/$defs/opaqueId" },
+    "createdAt": { "$ref": "common.schema.json#/$defs/timestamp" },
+    "updatedAt": { "$ref": "common.schema.json#/$defs/timestamp" },
+    "configRevision": { "$ref": "common.schema.json#/$defs/sha256" },
+    "atomic": { "const": false },
+    "status": { "enum": ["planned", "preparing", "delivering", "completed", "partial", "blocked_uncertain", "failed", "cancelled"] },
+    "repositories": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 64,
+      "items": { "$ref": "#/$defs/repositoryDelivery" }
+    },
+    "dependencies": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["before", "after"],
+        "properties": {
+          "before": { "$ref": "common.schema.json#/$defs/identifier" },
+          "after": { "$ref": "common.schema.json#/$defs/identifier" },
+          "reason": { "type": "string", "minLength": 1, "maxLength": 1000 }
+        },
+        "additionalProperties": false
+      },
+      "maxItems": 128
+    },
+    "summary": { "type": "string", "maxLength": 4000 }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "status": { "const": "completed" } }, "required": ["status"] },
+      "then": {
+        "properties": {
+          "repositories": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": { "status": { "const": "delivered" } },
+              "required": ["status", "receipts"]
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": { "properties": { "status": { "const": "partial" } }, "required": ["status"] },
+      "then": {
+        "properties": {
+          "repositories": {
+            "type": "array",
+            "allOf": [
+              { "contains": { "type": "object", "properties": { "status": { "const": "delivered" } }, "required": ["status"] } },
+              { "contains": { "type": "object", "properties": { "status": { "enum": ["failed", "blocked_uncertain", "cancelled"] } }, "required": ["status"] } }
+            ]
+          }
+        }
+      }
+    },
+    {
+      "if": { "properties": { "status": { "const": "cancelled" } }, "required": ["status"] },
+      "then": {
+        "properties": {
+          "repositories": {
+            "type": "array",
+            "not": {
+              "contains": { "type": "object", "properties": { "status": { "const": "delivered" } }, "required": ["status"] }
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": { "properties": { "status": { "const": "failed" } }, "required": ["status"] },
+      "then": {
+        "properties": {
+          "repositories": {
+            "type": "array",
+            "contains": { "type": "object", "properties": { "status": { "const": "failed" } }, "required": ["status"] },
+            "not": {
+              "contains": { "type": "object", "properties": { "status": { "const": "delivered" } }, "required": ["status"] }
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": { "properties": { "status": { "const": "blocked_uncertain" } }, "required": ["status"] },
+      "then": {
+        "properties": {
+          "repositories": {
+            "type": "array",
+            "contains": { "type": "object", "properties": { "status": { "const": "blocked_uncertain" } }, "required": ["status"] },
+            "not": {
+              "contains": { "type": "object", "properties": { "status": { "const": "delivered" } }, "required": ["status"] }
+            }
+          }
+        }
+      }
+    }
+  ],
+  "additionalProperties": false,
+  "$defs": {
+    "repositoryDelivery": {
+      "type": "object",
+      "required": ["repositoryId", "baseCommit", "contentSnapshotHash", "status", "effect"],
+      "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" },
+        "status": { "enum": ["pending", "prepared", "delivering", "delivered", "failed", "blocked_uncertain", "cancelled"] },
+        "effect": { "$ref": "common.schema.json#/$defs/effectPolicy" },
+        "target": {
+          "type": "object",
+          "required": ["kind"],
+          "properties": {
+            "kind": { "enum": ["local-commit", "branch", "pull-request", "artifact", "deployment"] },
+            "ref": { "type": "string", "minLength": 1, "maxLength": 512 }
+          },
+          "additionalProperties": false
+        },
+        "receipts": {
+          "type": "array",
+          "items": { "$ref": "common.schema.json#/$defs/receipt" },
+          "maxItems": 32
+        },
+        "error": { "$ref": "common.schema.json#/$defs/errorSummary" }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "status": { "const": "delivered" } }, "required": ["status"] },
+          "then": {
+            "properties": { "receipts": { "type": "array", "minItems": 1 } },
+            "required": ["receipts"]
+          }
+        }
+      ],
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/vnext/environment.schema.json

@@ -0,0 +1,66 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.kxm.dev/vnext/environment.schema.json",
+  "title": "KXM portable environment overrides",
+  "type": "object",
+  "required": ["schema"],
+  "properties": {
+    "schema": { "const": "kxm.environment.v1" },
+    "values": {
+      "type": "object",
+      "propertyNames": {
+        "type": "string",
+        "pattern": "^[A-Z_][A-Z0-9_]*$",
+        "maxLength": 128,
+        "not": {
+          "pattern": "(?:SECRET|TOKEN|PASSWORD|PASSWD|PRIVATE_KEY|API_KEY|CREDENTIAL|DATABASE_URL|CONNECTION_STRING)"
+        }
+      },
+      "additionalProperties": {
+        "oneOf": [
+          { "type": "string", "maxLength": 4096 },
+          { "type": "number" },
+          { "type": "boolean" }
+        ]
+      },
+      "maxProperties": 256
+    },
+    "secrets": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["name", "ref"],
+        "properties": {
+          "name": {
+            "type": "string",
+            "pattern": "^[A-Z_][A-Z0-9_]*$",
+            "maxLength": 128
+          },
+          "ref": { "$ref": "common.schema.json#/$defs/identifier" },
+          "required": { "type": "boolean", "default": true }
+        },
+        "additionalProperties": false
+      },
+      "maxItems": 128
+    },
+    "path": {
+      "type": "object",
+      "properties": {
+        "prepend": {
+          "type": "array",
+          "items": { "$ref": "common.schema.json#/$defs/relativePath" },
+          "uniqueItems": true,
+          "maxItems": 32
+        },
+        "append": {
+          "type": "array",
+          "items": { "$ref": "common.schema.json#/$defs/relativePath" },
+          "uniqueItems": true,
+          "maxItems": 32
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/vnext/gate-registry.schema.json

@@ -0,0 +1,109 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.kxm.dev/vnext/gate-registry.schema.json",
+  "title": "KXM gate registry",
+  "type": "object",
+  "required": [
+    "schema",
+    "gates"
+  ],
+  "properties": {
+    "schema": {
+      "const": "kxm.gate-registry.v1"
+    },
+    "gates": {
+      "type": "object",
+      "minProperties": 1,
+      "maxProperties": 64,
+      "propertyNames": {
+        "$ref": "common.schema.json#/$defs/identifier"
+      },
+      "additionalProperties": {
+        "oneOf": [
+          {
+            "$ref": "#/$defs/command"
+          },
+          {
+            "$ref": "#/$defs/artifactsExist"
+          },
+          {
+            "$ref": "#/$defs/reserved"
+          }
+        ]
+      }
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "command": {
+      "type": "object",
+      "required": [
+        "kind",
+        "argv",
+        "timeoutMs"
+      ],
+      "properties": {
+        "kind": {
+          "const": "command"
+        },
+        "argv": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 64,
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 4096,
+            "pattern": "^[^\\u0000]+$"
+          }
+        },
+        "timeoutMs": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 2147483647
+        },
+        "cwd": {
+          "const": "control"
+        }
+      },
+      "additionalProperties": false
+    },
+    "artifactsExist": {
+      "type": "object",
+      "required": [
+        "kind",
+        "paths"
+      ],
+      "properties": {
+        "kind": {
+          "const": "artifacts-exist"
+        },
+        "paths": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 64,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "common.schema.json#/$defs/relativePath",
+            "not": {
+              "const": "."
+            }
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "reserved": {
+      "type": "object",
+      "required": [
+        "kind"
+      ],
+      "properties": {
+        "kind": {
+          "const": "reserved"
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

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

@@ -0,0 +1,146 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.kxm.dev/vnext/handoff-manifest.schema.json",
+  "title": "KXM structured handoff manifest v1",
+  "type": "object",
+  "required": [
+    "schema",
+    "handoffId",
+    "taskId",
+    "workflowRunId",
+    "source",
+    "target",
+    "intent",
+    "status",
+    "baseCommit",
+    "deliverables",
+    "verificationEvidence",
+    "createdAt"
+  ],
+  "properties": {
+    "schema": {
+      "const": "kxm.handoff-manifest.v1"
+    },
+    "handoffId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128
+    },
+    "taskId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128
+    },
+    "workflowRunId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128
+    },
+    "reworkOf": {
+      "type": ["string", "null"]
+    },
+    "source": {
+      "type": "object",
+      "required": ["role", "agentId", "harness", "stepId", "attemptId"],
+      "properties": {
+        "role": { "type": "string", "minLength": 1, "maxLength": 64 },
+        "agentId": { "type": "string", "minLength": 1, "maxLength": 64 },
+        "harness": { "type": "string", "minLength": 1, "maxLength": 64 },
+        "model": { "type": "string", "maxLength": 128 },
+        "stepId": { "type": "string", "minLength": 1, "maxLength": 64 },
+        "attemptId": { "type": "string", "minLength": 1, "maxLength": 128 }
+      },
+      "additionalProperties": false
+    },
+    "target": {
+      "type": "object",
+      "required": ["role", "permission"],
+      "properties": {
+        "role": { "type": "string", "minLength": 1, "maxLength": 64 },
+        "permission": {
+          "enum": ["read-only", "edit", "admin"]
+        }
+      },
+      "additionalProperties": false
+    },
+    "intent": {
+      "enum": ["request_review", "dispatch_fix", "request_approval", "complete_workflow"]
+    },
+    "status": {
+      "enum": ["pending", "accepted", "rejected", "superseded"]
+    },
+    "baseCommit": {
+      "type": "string",
+      "maxLength": 64
+    },
+    "candidateTreeHash": {
+      "type": "string",
+      "maxLength": 64
+    },
+    "deliverables": {
+      "type": "object",
+      "required": ["patches", "reports", "artifacts"],
+      "properties": {
+        "patches": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "reports": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "artifacts": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["name", "artifactRef"],
+            "properties": {
+              "name": { "type": "string" },
+              "artifactRef": { "type": "string" }
+            },
+            "additionalProperties": false
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "verificationEvidence": {
+      "type": "object",
+      "required": ["witnessExitCode", "witnessPassed", "criticVerdicts"],
+      "properties": {
+        "witnessExitCode": { "type": "integer" },
+        "witnessPassed": { "type": "boolean" },
+        "criticVerdicts": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["critic", "verdict"],
+            "properties": {
+              "critic": { "type": "string" },
+              "verdict": { "enum": ["PASS", "FAIL", "WARN", "UNKNOWN"] },
+              "summary": { "type": "string" }
+            },
+            "additionalProperties": false
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "openQuestions": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "suggestedNextStep": {
+      "type": "object",
+      "properties": {
+        "stepId": { "type": "string" },
+        "action": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "createdAt": {
+      "$ref": "common.schema.json#/$defs/timestamp"
+    }
+  },
+  "additionalProperties": false
+}