@xoxoai/checkmate 0.6.6 → 0.7.0

package/plugin/contracts/plan.schema.json

@@ -0,0 +1,313 @@
+{
+	"$schema": "http://json-schema.org/draft-07/schema#",
+	"$id": "plan.schema.json",
+	"type": "object",
+	"properties": {
+		"contractVersion": {
+			"const": "toolkit-2"
+		},
+		"planId": {
+			"type": "string",
+			"pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,95}$"
+		},
+		"revision": {
+			"type": "integer",
+			"minimum": 1
+		},
+		"previousRevision": {
+			"anyOf": [
+				{
+					"type": "integer",
+					"minimum": 1
+				},
+				{
+					"type": "null"
+				}
+			]
+		},
+		"target": {
+			"type": "object",
+			"properties": {
+				"targetId": {
+					"type": "string",
+					"pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,95}$"
+				},
+				"revision": {
+					"type": "integer",
+					"minimum": 1
+				},
+				"sha256": {
+					"type": "string",
+					"pattern": "^[a-f0-9]{64}$"
+				}
+			},
+			"required": ["targetId", "revision", "sha256"],
+			"additionalProperties": false
+		},
+		"objective": {
+			"type": "string",
+			"minLength": 1
+		},
+		"requirements": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"properties": {
+					"id": {
+						"type": "string",
+						"pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,95}$"
+					},
+					"text": {
+						"type": "string",
+						"minLength": 1
+					},
+					"source": {
+						"type": "string",
+						"minLength": 1
+					}
+				},
+				"required": ["id", "text", "source"],
+				"additionalProperties": false
+			},
+			"minItems": 1,
+			"uniqueItems": true
+		},
+		"tests": {
+			"type": "array",
+			"items": {
+				"$ref": "#/definitions/test"
+			},
+			"minItems": 0,
+			"uniqueItems": true
+		},
+		"gaps": {
+			"type": "array",
+			"items": {
+				"$ref": "gap.schema.json"
+			},
+			"minItems": 0,
+			"uniqueItems": true
+		},
+		"assumptions": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"properties": {
+					"decisionId": {
+						"type": "string",
+						"pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,95}$"
+					},
+					"text": {
+						"type": "string",
+						"minLength": 1
+					}
+				},
+				"required": ["decisionId", "text"],
+				"additionalProperties": false
+			},
+			"minItems": 0,
+			"uniqueItems": true
+		},
+		"decisions": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"properties": {
+					"id": {
+						"type": "string",
+						"pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,95}$"
+					},
+					"gapId": {
+						"type": "string",
+						"pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,95}$"
+					},
+					"kind": {
+						"enum": ["clarify", "accept_assumption", "defer"]
+					},
+					"actor": {
+						"type": "string",
+						"minLength": 1
+					},
+					"rationale": {
+						"type": "string",
+						"minLength": 1
+					},
+					"value": {
+						"type": "string",
+						"minLength": 1
+					},
+					"source": {
+						"anyOf": [
+							{
+								"type": "string",
+								"minLength": 1
+							},
+							{
+								"type": "null"
+							}
+						]
+					}
+				},
+				"required": ["id", "gapId", "kind", "actor", "rationale", "value", "source"],
+				"additionalProperties": false
+			},
+			"minItems": 0,
+			"uniqueItems": true
+		},
+		"coverage": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"properties": {
+					"requirementId": {
+						"type": "string",
+						"pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,95}$"
+					},
+					"testIds": {
+						"type": "array",
+						"items": {
+							"type": "string",
+							"pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,95}$"
+						},
+						"minItems": 0,
+						"uniqueItems": true
+					},
+					"status": {
+						"enum": ["planned", "blocked", "deferred"]
+					}
+				},
+				"required": ["requirementId", "testIds", "status"],
+				"additionalProperties": false
+			},
+			"minItems": 1,
+			"uniqueItems": true
+		}
+	},
+	"required": [
+		"contractVersion",
+		"planId",
+		"revision",
+		"previousRevision",
+		"target",
+		"objective",
+		"requirements",
+		"tests",
+		"gaps",
+		"assumptions",
+		"decisions",
+		"coverage"
+	],
+	"additionalProperties": false,
+	"definitions": {
+		"test": {
+			"type": "object",
+			"properties": {
+				"id": {
+					"type": "string",
+					"pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,95}$"
+				},
+				"title": {
+					"type": "string",
+					"minLength": 1,
+					"maxLength": 200
+				},
+				"requirementIds": {
+					"type": "array",
+					"items": {
+						"type": "string",
+						"pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,95}$"
+					},
+					"minItems": 1,
+					"uniqueItems": true
+				},
+				"capability": {
+					"type": "string",
+					"pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,95}$"
+				},
+				"operations": {
+					"type": "array",
+					"items": {
+						"type": "string",
+						"pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,95}$"
+					},
+					"minItems": 1,
+					"uniqueItems": true
+				},
+				"readiness": {
+					"enum": ["ready", "blocked", "deferred"]
+				},
+				"gapIds": {
+					"type": "array",
+					"items": {
+						"type": "string",
+						"pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,95}$"
+					},
+					"minItems": 0,
+					"uniqueItems": true
+				},
+				"dependsOn": {
+					"type": "array",
+					"items": {
+						"type": "string",
+						"pattern": "^([A-Za-z0-9][A-Za-z0-9_-]{0,95}:)?[A-Za-z0-9][A-Za-z0-9_-]{0,95}$"
+					},
+					"minItems": 0,
+					"uniqueItems": true
+				},
+				"preconditions": {
+					"type": "array",
+					"items": {
+						"type": "string",
+						"minLength": 1
+					},
+					"minItems": 0,
+					"uniqueItems": true
+				},
+				"action": {
+					"type": "string",
+					"minLength": 1
+				},
+				"assertions": {
+					"type": "array",
+					"items": {
+						"$ref": "#/definitions/assertion"
+					},
+					"minItems": 0,
+					"uniqueItems": true
+				}
+			},
+			"required": [
+				"id",
+				"title",
+				"requirementIds",
+				"capability",
+				"operations",
+				"readiness",
+				"gapIds",
+				"dependsOn",
+				"preconditions",
+				"action",
+				"assertions"
+			],
+			"additionalProperties": false
+		},
+		"assertion": {
+			"type": "object",
+			"properties": {
+				"id": {
+					"type": "string",
+					"pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,95}$"
+				},
+				"check": {
+					"type": "string",
+					"minLength": 1
+				},
+				"checkKind": {
+					"enum": ["deterministic", "agent_observation"]
+				}
+			},
+			"required": ["id", "check", "checkKind"],
+			"additionalProperties": false
+		}
+	}
+}

package/plugin/contracts/profile.schema.json

@@ -0,0 +1,154 @@
+{
+	"$schema": "http://json-schema.org/draft-07/schema#",
+	"$id": "profile.schema.json",
+	"type": "object",
+	"properties": {
+		"contractVersion": {
+			"const": "toolkit-2"
+		},
+		"targetId": {
+			"type": "string",
+			"pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,95}$"
+		},
+		"revision": {
+			"type": "integer",
+			"minimum": 1
+		},
+		"baseUrl": {
+			"type": "string",
+			"format": "uri"
+		},
+		"environment": {
+			"type": "string",
+			"minLength": 1
+		},
+		"capabilities": {
+			"type": "array",
+			"items": {
+				"type": "string",
+				"pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,95}$"
+			},
+			"minItems": 1,
+			"uniqueItems": true
+		},
+		"tools": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"properties": {
+					"name": {
+						"type": "string",
+						"minLength": 1
+					},
+					"kind": {
+						"enum": ["cli", "mcp", "skill"]
+					},
+					"purpose": {
+						"type": "string",
+						"minLength": 1
+					},
+					"version": {
+						"type": "string",
+						"minLength": 1
+					},
+					"reachable": {
+						"type": "boolean"
+					}
+				},
+				"required": ["name", "kind", "purpose", "reachable"],
+				"additionalProperties": false
+			},
+			"minItems": 0,
+			"uniqueItems": true
+		},
+		"authentication": {
+			"type": "object",
+			"properties": {
+				"kind": {
+					"enum": ["none", "environment", "browser_session"]
+				},
+				"references": {
+					"type": "array",
+					"items": {
+						"type": "string",
+						"minLength": 1
+					},
+					"minItems": 0,
+					"uniqueItems": true
+				}
+			},
+			"required": ["kind", "references"],
+			"additionalProperties": false
+		},
+		"allowedOperations": {
+			"type": "array",
+			"items": {
+				"type": "string",
+				"pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,95}$"
+			},
+			"minItems": 1,
+			"uniqueItems": true
+		},
+		"startup": {
+			"type": "object",
+			"properties": {
+				"owner": {
+					"enum": ["factory", "checkmate"]
+				},
+				"command": {
+					"anyOf": [
+						{
+							"type": "array",
+							"items": {
+								"type": "string",
+								"minLength": 1
+							},
+							"minItems": 1,
+							"uniqueItems": true
+						},
+						{
+							"type": "null"
+						}
+					]
+				}
+			},
+			"required": ["owner", "command"],
+			"additionalProperties": false
+		},
+		"cleanup": {
+			"type": "string",
+			"minLength": 1
+		},
+		"readyForLiveExecution": {
+			"type": "boolean"
+		},
+		"approvals": {
+			"type": "object",
+			"properties": {
+				"plan": {
+					"enum": ["required", "none"]
+				},
+				"result": {
+					"enum": ["required", "none"]
+				}
+			},
+			"required": ["plan", "result"],
+			"additionalProperties": false
+		}
+	},
+	"required": [
+		"contractVersion",
+		"targetId",
+		"revision",
+		"baseUrl",
+		"environment",
+		"capabilities",
+		"tools",
+		"authentication",
+		"allowedOperations",
+		"startup",
+		"cleanup",
+		"readyForLiveExecution"
+	],
+	"additionalProperties": false
+}

package/plugin/contracts/response.schema.json

@@ -0,0 +1,25 @@
+{
+	"$schema": "http://json-schema.org/draft-07/schema#",
+	"$id": "response.schema.json",
+	"type": "object",
+	"properties": {
+		"status": {
+			"enum": ["completed", "needs_decision", "interrupted", "operational_error", "rejected"]
+		},
+		"subject": {
+			"type": "string",
+			"minLength": 1
+		},
+		"reasons": {
+			"type": "array",
+			"items": {
+				"type": "string",
+				"minLength": 1
+			},
+			"minItems": 0,
+			"uniqueItems": true
+		}
+	},
+	"required": ["status", "subject", "reasons"],
+	"additionalProperties": false
+}