contextos-agents 1.7.0 → 2.0.0-beta.2

package/.agents/schemas/attestation.review.v1.json

@@ -0,0 +1,111 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "ContextOS Review Attestation v1",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "status",
+    "subject",
+    "implementerExecutionId",
+    "reviewerExecutionId",
+    "provider",
+    "model",
+    "independenceLevel",
+    "rawOutputDigest",
+    "retries"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "schemaVersion": {
+      "type": "integer",
+      "const": 1
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "NOT_CONFIGURED",
+        "PENDING",
+        "RUNNING",
+        "PASS",
+        "FAIL",
+        "ERROR",
+        "TIMEOUT",
+        "UNAVAILABLE",
+        "MALFORMED",
+        "STALE"
+      ]
+    },
+    "subject": {
+      "type": "object",
+      "required": [
+        "repositoryFingerprint",
+        "baseSha",
+        "headSha",
+        "diffSha256",
+        "scopeSha256"
+      ],
+      "properties": {
+        "repositoryFingerprint": { "type": "string" },
+        "baseSha": { "type": "string" },
+        "headSha": { "type": "string" },
+        "diffSha256": { "type": "string" },
+        "scopeSha256": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "implementerExecutionId": { "type": "string" },
+    "reviewerExecutionId": { "type": "string" },
+    "provider": { "type": "string" },
+    "model": { "type": "string" },
+    "independenceLevel": {
+      "type": "string",
+      "enum": [
+        "same_process",
+        "separate_process",
+        "isolated_container",
+        "external_evaluator"
+      ]
+    },
+    "rawOutputDigest": { "type": "string" },
+    "staticFindings": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["ruleId", "severity", "message"],
+        "properties": {
+          "ruleId": { "type": "string" },
+          "severity": {
+            "type": "string",
+            "enum": ["low", "medium", "high", "critical"]
+          },
+          "message": { "type": "string" },
+          "file": { "type": "string" },
+          "line": { "type": "integer" }
+        },
+        "additionalProperties": false
+      }
+    },
+    "llmVerdict": {
+      "type": "object",
+      "required": ["specCompliance", "codeQuality", "summary"],
+      "properties": {
+        "specCompliance": {
+          "type": "string",
+          "enum": ["PASS", "FAIL", "UNCERTAIN"]
+        },
+        "codeQuality": {
+          "type": "string",
+          "enum": ["PASS", "FAIL", "NEEDS_WORK"]
+        },
+        "summary": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "retries": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "startedAt": { "type": "number" },
+    "completedAt": { "type": "number" }
+  }
+}

package/.agents/schemas/attestation.verification.v1.json

@@ -0,0 +1,85 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "ContextOS Verification Attestation v1",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "status",
+    "subject",
+    "runnerMode"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "schemaVersion": {
+      "type": "integer",
+      "const": 1
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "NOT_CONFIGURED",
+        "NOT_APPLICABLE",
+        "PENDING",
+        "RUNNING",
+        "PASS",
+        "FAIL",
+        "ERROR",
+        "TIMEOUT",
+        "STALE"
+      ]
+    },
+    "subject": {
+      "type": "object",
+      "required": [
+        "repositoryFingerprint",
+        "baseSha",
+        "headSha",
+        "diffSha256",
+        "scopeSha256"
+      ],
+      "properties": {
+        "repositoryFingerprint": { "type": "string" },
+        "baseSha": { "type": "string" },
+        "headSha": { "type": "string" },
+        "diffSha256": { "type": "string" },
+        "scopeSha256": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "command": {
+      "type": "object",
+      "required": ["executable", "args"],
+      "properties": {
+        "executable": { "type": "string" },
+        "args": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "cwd": { "type": "string" },
+        "timeoutMs": { "type": "number" }
+      },
+      "additionalProperties": false
+    },
+    "evidence": {
+      "type": "object",
+      "required": ["exitCode", "outputSha256"],
+      "properties": {
+        "exitCode": { "type": ["integer", "null"] },
+        "signal": { "type": ["string", "null"] },
+        "outputSha256": { "type": "string" },
+        "redactedPreview": { "type": "string" },
+        "totalTests": { "type": "integer" },
+        "passedTests": { "type": "integer" },
+        "failedTests": { "type": "integer" }
+      },
+      "additionalProperties": false
+    },
+    "runnerMode": {
+      "type": "string",
+      "enum": ["oci", "host-unsafe"]
+    },
+    "startedAt": { "type": "number" },
+    "completedAt": { "type": "number" },
+    "reasonCode": { "type": "string" }
+  }
+}

package/.agents/schemas/lockfile.v2.schema.json

@@ -0,0 +1,134 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "LockfileV2",
+  "description": "ContextOS Lockfile Schema v2 tracking managed generated files, exact and semantic text hashes, and generator provenance.",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "revision",
+    "package",
+    "profile",
+    "sourceGraphHash",
+    "enabledAdapters",
+    "managedFiles"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "schemaVersion": {
+      "type": "integer",
+      "const": 2,
+      "description": "Lockfile schema version (always 2 for v2)"
+    },
+    "revision": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Monotonically increasing revision counter for optimistic concurrency and compare-and-swap (CAS)"
+    },
+    "package": {
+      "type": "object",
+      "required": ["name", "version", "compilerVersion"],
+      "additionalProperties": false,
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1
+        },
+        "compilerVersion": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "profile": {
+      "type": "object",
+      "required": ["id", "hash"],
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z0-9-]+$"
+        },
+        "hash": {
+          "type": "string",
+          "pattern": "^sha256:[a-f0-9]{64}$"
+        }
+      }
+    },
+    "sourceGraphHash": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$",
+      "description": "Cryptographic hash of the authoring sources (skills + manifests) at compile time"
+    },
+    "enabledAdapters": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "uniqueItems": true,
+      "description": "List of active target AI tool adapters"
+    },
+    "managedFiles": {
+      "type": "object",
+      "description": "Map of relative POSIX file paths to file metadata and provenance",
+      "additionalProperties": false,
+      "patternProperties": {
+        "^[^\\0]+$": {
+          "type": "object",
+          "required": [
+            "exactSha256",
+            "semanticTextSha256",
+            "kind",
+            "generator",
+            "inputsHash"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "exactSha256": {
+              "type": "string",
+              "pattern": "^sha256:[a-f0-9]{64}$",
+              "description": "Byte-exact SHA-256 hash of the generated file content"
+            },
+            "semanticTextSha256": {
+              "type": "string",
+              "pattern": "^sha256:[a-f0-9]{64}$",
+              "description": "CRLF-normalized text SHA-256 hash to prevent false dirty states across Git checkouts"
+            },
+            "kind": {
+              "type": "string",
+              "enum": [
+                "generated-adapter",
+                "vendor-skill",
+                "template",
+                "schema",
+                "reference",
+                "custom"
+              ]
+            },
+            "generator": {
+              "type": "string",
+              "minLength": 1,
+              "description": "Generator identifier and version, e.g. cursor@2, claude@1"
+            },
+            "inputsHash": {
+              "type": "string",
+              "pattern": "^sha256:[a-f0-9]{64}$",
+              "description": "Hash of input context and profile that produced this artifact"
+            },
+            "mode": {
+              "type": "integer",
+              "description": "POSIX file mode permissions (e.g. 420 for 0644)"
+            },
+            "lastTransaction": {
+              "type": "string",
+              "description": "Transaction identifier that last modified this file"
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/.agents/schemas/profile.v2.schema.json

@@ -0,0 +1,114 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "ProfileV2",
+  "description": "ContextOS Profile Schema v2",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "id",
+    "name",
+    "description",
+    "skills",
+    "policy",
+    "generation",
+    "technologyDefaults"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "schemaVersion": {
+      "type": "integer",
+      "const": 2
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z0-9-]+$",
+      "description": "Unique profile identifier slug"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Human-readable profile title"
+    },
+    "description": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Short explanation of the profile intent and constraints"
+    },
+    "skills": {
+      "type": "object",
+      "required": ["required", "preferred", "excluded"],
+      "additionalProperties": false,
+      "properties": {
+        "required": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Mandatory skill IDs enforced for tasks under this profile"
+        },
+        "preferred": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Priority skill IDs favored by this profile"
+        },
+        "excluded": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Skill IDs strictly disabled or suppressed under this profile"
+        }
+      }
+    },
+    "policy": {
+      "type": "object",
+      "required": ["verification", "review", "security"],
+      "additionalProperties": false,
+      "properties": {
+        "verification": {
+          "type": "string",
+          "enum": ["required", "recommended", "off"],
+          "description": "Quality gate policy for automated test execution"
+        },
+        "review": {
+          "type": "string",
+          "enum": ["required", "recommended", "off"],
+          "description": "Quality gate policy for code review before merge"
+        },
+        "security": {
+          "type": "string",
+          "enum": ["required", "recommended", "off"],
+          "description": "Quality gate policy for security vulnerability checks"
+        },
+        "adr": {
+          "type": "string",
+          "enum": ["required", "recommended", "off"],
+          "description": "Policy for Architecture Decision Record enforcement"
+        },
+        "testing": {
+          "type": "string",
+          "enum": ["required", "recommended", "off"],
+          "description": "Policy for test suite presence requirement"
+        },
+        "accessibility": {
+          "type": "string",
+          "enum": ["required", "recommended", "off"],
+          "description": "Policy for accessibility compliance checks"
+        }
+      }
+    },
+    "generation": {
+      "type": "object",
+      "required": ["documents"],
+      "additionalProperties": false,
+      "properties": {
+        "documents": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "List of document templates to generate for this profile"
+        }
+      }
+    },
+    "technologyDefaults": {
+      "type": "object",
+      "additionalProperties": { "type": "string" },
+      "description": "Default technology and framework choices (database, cache, auth, etc.)"
+    }
+  }
+}

package/.agents/schemas/runtime.thread.v1.json

@@ -0,0 +1,192 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "ContextOS Runtime Thread State v1",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "id",
+    "revision",
+    "execution",
+    "verification",
+    "review",
+    "merge",
+    "createdAt",
+    "updatedAt"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "schemaVersion": {
+      "type": "integer",
+      "const": 1
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[a-zA-Z0-9_-]+$"
+    },
+    "revision": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "config": {
+      "type": "object",
+      "required": ["task"],
+      "properties": {
+        "task": { "type": "string" },
+        "objective": { "type": "string" },
+        "writeScope": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "testCommand": { "type": "string" },
+        "agent": { "type": "string" },
+        "model": { "type": "string" },
+        "targetBase": { "type": "string" },
+        "requiredSandbox": {
+          "type": "string",
+          "enum": ["none", "host-unsafe", "oci", "strict-sandbox"]
+        }
+      },
+      "additionalProperties": true
+    },
+    "execution": {
+      "type": "object",
+      "required": ["status"],
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": [
+            "QUEUED",
+            "PREPARING",
+            "RUNNING",
+            "SUCCEEDED",
+            "FAILED",
+            "TIMED_OUT",
+            "CANCELLED",
+            "INTERRUPTED"
+          ]
+        },
+        "startedAt": { "type": "number" },
+        "completedAt": { "type": "number" },
+        "attempt": { "type": "integer", "minimum": 1 },
+        "maxAttempts": { "type": "integer", "minimum": 1 },
+        "error": { "type": "string" },
+        "executionId": { "type": "string" },
+        "worktreePath": { "type": "string" },
+        "branchName": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "verification": {
+      "type": "object",
+      "required": ["status"],
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": [
+            "NOT_CONFIGURED",
+            "NOT_APPLICABLE",
+            "PENDING",
+            "RUNNING",
+            "PASS",
+            "FAIL",
+            "ERROR",
+            "TIMEOUT",
+            "STALE"
+          ]
+        },
+        "attestation": { "$ref": "attestation.verification.v1.json" },
+        "reason": { "type": "string" },
+        "updatedAt": { "type": "number" }
+      },
+      "additionalProperties": false
+    },
+    "review": {
+      "type": "object",
+      "required": ["status"],
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": [
+            "NOT_CONFIGURED",
+            "PENDING",
+            "RUNNING",
+            "PASS",
+            "FAIL",
+            "ERROR",
+            "TIMEOUT",
+            "UNAVAILABLE",
+            "MALFORMED",
+            "STALE"
+          ]
+        },
+        "attestation": { "$ref": "attestation.review.v1.json" },
+        "reason": { "type": "string" },
+        "updatedAt": { "type": "number" }
+      },
+      "additionalProperties": false
+    },
+    "merge": {
+      "type": "object",
+      "required": ["status"],
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": [
+            "NOT_READY",
+            "READY",
+            "MERGING",
+            "MERGED",
+            "BLOCKED",
+            "CONFLICT",
+            "STALE_BASE",
+            "ERROR"
+          ]
+        },
+        "readiness": {
+          "type": "object",
+          "required": ["isReady", "checks", "evaluatedAt"],
+          "properties": {
+            "isReady": { "type": "boolean" },
+            "checks": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": ["name", "passed", "message"],
+                "properties": {
+                  "name": { "type": "string" },
+                  "passed": { "type": "boolean" },
+                  "message": { "type": "string" },
+                  "code": { "type": "string" }
+                }
+              }
+            },
+            "evaluatedAt": { "type": "number" }
+          }
+        },
+        "mergedAt": { "type": "number" },
+        "targetBranch": { "type": "string" },
+        "mergeCommitSha": { "type": "string" },
+        "error": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "subject": {
+      "type": "object",
+      "required": ["repositoryFingerprint", "baseSha"],
+      "properties": {
+        "repositoryFingerprint": { "type": "string" },
+        "baseSha": { "type": "string" },
+        "headSha": { "type": "string" },
+        "diffSha256": { "type": "string" },
+        "scopeSha256": { "type": "string" },
+        "filesChanged": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      },
+      "additionalProperties": false
+    },
+    "createdAt": { "type": "number" },
+    "updatedAt": { "type": "number" }
+  }
+}