cohorte 2.10.0 → 3.0.0-dev.0

package/assets/schemas/project-status.schema.json

@@ -0,0 +1,217 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://cohorte.dev/schemas/3/project-status.schema.json",
+  "title": "Cohorte project status (status --json)",
+  "type": "object",
+  "required": [
+    "documentVersion",
+    "protocolVersion",
+    "project",
+    "runs",
+    "pendingApprovals"
+  ],
+  "properties": {
+    "documentVersion": {
+      "type": "number",
+      "const": 1
+    },
+    "protocolVersion": {
+      "type": "string",
+      "const": "1.0"
+    },
+    "project": {
+      "type": "object",
+      "required": [
+        "id",
+        "root"
+      ],
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "root": {
+          "type": "string"
+        }
+      }
+    },
+    "runs": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "runId",
+          "profile",
+          "title",
+          "state",
+          "status",
+          "since",
+          "startedAt"
+        ],
+        "properties": {
+          "runId": {
+            "type": "string",
+            "pattern": "^run_[0-9a-f]{32}$"
+          },
+          "profile": {
+            "type": "string",
+            "x-cohorte-known": [
+              "feature",
+              "bugfix",
+              "review"
+            ]
+          },
+          "title": {
+            "type": "string"
+          },
+          "state": {
+            "type": "string",
+            "enum": [
+              "IDLE",
+              "BRAINSTORM",
+              "SPEC",
+              "PREFLIGHT",
+              "BUILD",
+              "TEST",
+              "REVIEW",
+              "FIX",
+              "SHIP",
+              "PAUSED",
+              "WAITING_APPROVAL",
+              "AUTH_REQUIRED",
+              "QUOTA_EXCEEDED",
+              "FAILED",
+              "BLOCKED",
+              "COMPLETED",
+              "CANCELLED"
+            ]
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "pending",
+              "running",
+              "completed",
+              "failed",
+              "paused",
+              "waiting-approval",
+              "cancelled",
+              "skipped",
+              "blocked"
+            ]
+          },
+          "since": {
+            "type": "string",
+            "format": "date-time",
+            "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{3}Z$"
+          },
+          "stop": {
+            "type": "object",
+            "required": [
+              "reason",
+              "detail",
+              "resumable"
+            ],
+            "properties": {
+              "reason": {
+                "type": "string",
+                "enum": [
+                  "review-clean",
+                  "iteration-limit",
+                  "budget-exhausted",
+                  "timeout",
+                  "identical-failure",
+                  "no-progress",
+                  "policy-violation",
+                  "approval-required",
+                  "unexpected-repo-change",
+                  "runtime-incompatible",
+                  "auth-required",
+                  "quota-exceeded",
+                  "paused",
+                  "cancelled",
+                  "agent-dead",
+                  "unreviewed",
+                  "internal-error",
+                  "check-environment"
+                ]
+              },
+              "detail": {
+                "type": "string"
+              },
+              "resumable": {
+                "type": "boolean"
+              },
+              "resumeRequires": {
+                "type": "string",
+                "x-cohorte-known": [
+                  "approval",
+                  "auth-login",
+                  "quota-reset",
+                  "budget-raise",
+                  "human-ack",
+                  "repo-repair",
+                  "reinstall-pinned-version",
+                  "environment-repair"
+                ]
+              }
+            }
+          },
+          "startedAt": {
+            "type": "string",
+            "format": "date-time",
+            "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{3}Z$"
+          },
+          "endedAt": {
+            "type": "string",
+            "format": "date-time",
+            "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{3}Z$"
+          }
+        }
+      }
+    },
+    "pendingApprovals": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "approvalId",
+          "kind",
+          "what",
+          "since",
+          "cli"
+        ],
+        "properties": {
+          "approvalId": {
+            "type": "string",
+            "pattern": "^apr_[0-9a-f]{32}$"
+          },
+          "kind": {
+            "type": "string"
+          },
+          "agentId": {
+            "type": "string",
+            "maxLength": 128,
+            "pattern": "^agt_[A-Za-z0-9.-]+_[A-Za-z0-9_.-]+$"
+          },
+          "what": {
+            "type": "string",
+            "maxLength": 512
+          },
+          "since": {
+            "type": "string",
+            "format": "date-time",
+            "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{3}Z$"
+          },
+          "expiresAt": {
+            "type": "string",
+            "format": "date-time",
+            "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{3}Z$"
+          },
+          "cli": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  }
+}

package/assets/schemas/reconcile-plan.schema.json

@@ -0,0 +1,155 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://cohorte.dev/schemas/3/reconcile-plan.schema.json",
+  "title": "Cohorte reconcile plan (reconcile --plan --json)",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "cohorteVersion",
+    "generatedAt",
+    "drift",
+    "operations",
+    "conflicts",
+    "applyAvailable"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "type": "number",
+      "const": 1
+    },
+    "cohorteVersion": {
+      "type": "string",
+      "minLength": 1
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{3}Z$"
+    },
+    "drift": {
+      "type": "object",
+      "required": [
+        "schemaVersion",
+        "generatedAt",
+        "entries"
+      ],
+      "properties": {
+        "schemaVersion": {
+          "type": "number",
+          "const": 1
+        },
+        "generatedAt": {
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{3}Z$"
+        },
+        "entries": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "target",
+              "class",
+              "diff",
+              "detail"
+            ],
+            "properties": {
+              "target": {
+                "type": "string",
+                "minLength": 1
+              },
+              "class": {
+                "type": "string",
+                "enum": [
+                  "human",
+                  "generated",
+                  "derived",
+                  "observed",
+                  "mixed"
+                ]
+              },
+              "diff": {
+                "type": "string",
+                "enum": [
+                  "absent",
+                  "expected-change",
+                  "human-change",
+                  "conflict",
+                  "potential-deletion",
+                  "unknown"
+                ]
+              },
+              "desiredSha256": {
+                "type": "string",
+                "pattern": "^[0-9a-f]{64}$"
+              },
+              "actualSha256": {
+                "type": "string",
+                "pattern": "^[0-9a-f]{64}$"
+              },
+              "recordedSha256": {
+                "type": "string",
+                "pattern": "^[0-9a-f]{64}$"
+              },
+              "detail": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      }
+    },
+    "operations": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "op",
+          "target",
+          "diff",
+          "reason"
+        ],
+        "properties": {
+          "op": {
+            "type": "string",
+            "enum": [
+              "create",
+              "replace",
+              "delete",
+              "keep",
+              "ask"
+            ]
+          },
+          "target": {
+            "type": "string",
+            "minLength": 1
+          },
+          "diff": {
+            "type": "string",
+            "enum": [
+              "absent",
+              "expected-change",
+              "human-change",
+              "conflict",
+              "potential-deletion",
+              "unknown"
+            ]
+          },
+          "reason": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "conflicts": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "applyAvailable": {
+      "type": "boolean",
+      "const": false
+    }
+  }
+}

package/assets/schemas/run-diff.schema.json

@@ -0,0 +1,177 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://cohorte.dev/schemas/3/run-diff.schema.json",
+  "title": "Cohorte run diff (diff --json)",
+  "type": "object",
+  "required": [
+    "documentVersion",
+    "runId",
+    "base",
+    "head",
+    "surfaces"
+  ],
+  "properties": {
+    "documentVersion": {
+      "type": "number",
+      "const": 1
+    },
+    "runId": {
+      "type": "string",
+      "pattern": "^run_[0-9a-f]{32}$"
+    },
+    "base": {
+      "type": "object",
+      "required": [
+        "branch",
+        "sha"
+      ],
+      "properties": {
+        "branch": {
+          "type": "string"
+        },
+        "sha": {
+          "type": "string"
+        }
+      }
+    },
+    "head": {
+      "type": "object",
+      "required": [
+        "branch",
+        "sha",
+        "treeDigest"
+      ],
+      "properties": {
+        "branch": {
+          "type": "string"
+        },
+        "sha": {
+          "type": "string"
+        },
+        "treeDigest": {
+          "type": "string"
+        }
+      }
+    },
+    "surfaces": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "surface",
+          "files",
+          "stat",
+          "patch"
+        ],
+        "properties": {
+          "surface": {
+            "anyOf": [
+              {
+                "type": "string",
+                "const": "shared"
+              },
+              {
+                "type": "string",
+                "pattern": "^[A-Za-z0-9_][A-Za-z0-9_.-]{0,127}$"
+              }
+            ]
+          },
+          "files": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": [
+                "path",
+                "op"
+              ],
+              "properties": {
+                "path": {
+                  "type": "string"
+                },
+                "op": {
+                  "type": "string",
+                  "enum": [
+                    "read",
+                    "create",
+                    "modify",
+                    "delete"
+                  ]
+                },
+                "beforeSha256": {
+                  "type": "string",
+                  "pattern": "^[0-9a-f]{64}$"
+                },
+                "afterSha256": {
+                  "type": "string",
+                  "pattern": "^[0-9a-f]{64}$"
+                },
+                "bytes": {
+                  "type": "integer",
+                  "minimum": 0
+                }
+              }
+            }
+          },
+          "stat": {
+            "type": "object",
+            "required": [
+              "added",
+              "removed"
+            ],
+            "properties": {
+              "added": {
+                "type": "integer",
+                "minimum": 0
+              },
+              "removed": {
+                "type": "integer",
+                "minimum": 0
+              }
+            }
+          },
+          "patch": {
+            "type": "object",
+            "required": [
+              "artifactId",
+              "kind",
+              "path",
+              "sha256",
+              "bytes"
+            ],
+            "properties": {
+              "artifactId": {
+                "type": "string",
+                "pattern": "^art_[0-9a-f]{32}$"
+              },
+              "kind": {
+                "type": "string",
+                "x-cohorte-known": [
+                  "diff",
+                  "file",
+                  "log",
+                  "report",
+                  "agent-output",
+                  "transcript",
+                  "context",
+                  "prompt",
+                  "patch"
+                ]
+              },
+              "path": {
+                "type": "string"
+              },
+              "sha256": {
+                "type": "string",
+                "pattern": "^[0-9a-f]{64}$"
+              },
+              "bytes": {
+                "type": "integer",
+                "minimum": 0
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}