patchrail 0.1.0__py3-none-any.whl

patchrail/schemas/queue-status.v1.schema.json

@@ -0,0 +1,179 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://patchrail.dev/schemas/queue-status.v1.schema.json",
+  "title": "PatchRail Queue Status",
+  "description": "Local status summary emitted by patchrail queue status and the local queue API /status endpoint.",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "queue_schema_version",
+    "patchrail_version",
+    "db_path",
+    "local_first",
+    "host_boundary",
+    "counts",
+    "human_gate_summary",
+    "latest_audit_event",
+    "safety"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "patchrail.queue_status.v1"
+    },
+    "queue_schema_version": {
+      "const": "patchrail.queue.v1"
+    },
+    "patchrail_version": {
+      "type": "string",
+      "minLength": 1
+    },
+    "db_path": {
+      "type": "string",
+      "minLength": 1
+    },
+    "local_first": {
+      "const": true
+    },
+    "host_boundary": {
+      "type": "string",
+      "minLength": 1
+    },
+    "counts": {
+      "type": "object",
+      "required": [
+        "work_items_total",
+        "work_items_by_status",
+        "work_items_by_approval_state",
+        "proposals_total",
+        "proposals_by_approval_state",
+        "audit_events_total"
+      ],
+      "properties": {
+        "work_items_total": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "work_items_by_status": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "integer",
+            "minimum": 0
+          }
+        },
+        "work_items_by_approval_state": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "integer",
+            "minimum": 0
+          }
+        },
+        "proposals_total": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "proposals_by_approval_state": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "integer",
+            "minimum": 0
+          }
+        },
+        "audit_events_total": {
+          "type": "integer",
+          "minimum": 0
+        }
+      },
+      "additionalProperties": false
+    },
+    "human_gate_summary": {
+      "type": "object",
+      "required": [
+        "status",
+        "pending_work_items",
+        "pending_proposals",
+        "total_pending_decisions",
+        "approved_work_items",
+        "rejected_work_items",
+        "approved_proposals",
+        "rejected_proposals",
+        "write_actions_unlocked"
+      ],
+      "properties": {
+        "status": {
+          "enum": ["awaiting_human_review", "no_pending_decisions"]
+        },
+        "pending_work_items": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "pending_proposals": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "total_pending_decisions": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "approved_work_items": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "rejected_work_items": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "approved_proposals": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "rejected_proposals": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "write_actions_unlocked": {
+          "const": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "latest_audit_event": {
+      "oneOf": [
+        { "type": "null" },
+        { "$ref": "queue-audit-event.v1.schema.json" }
+      ]
+    },
+    "safety": {
+      "type": "object",
+      "required": [
+        "write_actions_allowed_by_default",
+        "github_write_permission_required",
+        "network_required",
+        "external_model_required",
+        "billing_required",
+        "approval_records_execute_actions"
+      ],
+      "properties": {
+        "write_actions_allowed_by_default": {
+          "const": false
+        },
+        "github_write_permission_required": {
+          "const": false
+        },
+        "network_required": {
+          "const": false
+        },
+        "external_model_required": {
+          "const": false
+        },
+        "billing_required": {
+          "const": false
+        },
+        "approval_records_execute_actions": {
+          "const": false
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": true
+}

patchrail/schemas/queue-work-item.v1.schema.json

@@ -0,0 +1,64 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://patchrail.dev/schemas/queue-work-item.v1.schema.json",
+  "title": "PatchRail Queue Work Item",
+  "description": "Local, human-gated work item emitted by patchrail queue commands and the local queue API.",
+  "type": "object",
+  "required": [
+    "id",
+    "kind",
+    "title",
+    "source",
+    "status",
+    "approval_state",
+    "write_actions_allowed",
+    "created_at",
+    "updated_at",
+    "payload",
+    "decision_note"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^prq_[0-9a-f]{12}$"
+    },
+    "kind": {
+      "type": "string",
+      "minLength": 1
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1
+    },
+    "source": {
+      "type": "string",
+      "minLength": 1
+    },
+    "status": {
+      "type": "string",
+      "enum": ["open", "pending", "approved", "rejected", "skipped"]
+    },
+    "approval_state": {
+      "type": "string",
+      "enum": ["pending", "approved", "rejected"]
+    },
+    "write_actions_allowed": {
+      "const": false
+    },
+    "created_at": {
+      "type": "string",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}T"
+    },
+    "updated_at": {
+      "type": "string",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}T"
+    },
+    "payload": {
+      "type": "object"
+    },
+    "decision_note": {
+      "type": ["string", "null"]
+    }
+  },
+  "additionalProperties": false
+}

patchrail/schemas/reviewer-quick-check-artifacts.v1.schema.json

@@ -0,0 +1,104 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://patchrail.dev/schemas/reviewer-quick-check-artifacts.v1.schema.json",
+  "title": "PatchRail Reviewer Quick Check Artifact Manifest",
+  "description": "Local manifest emitted by patchrail evidence reviewer-packet --out-dir, with scripts/reviewer_quick_check.py --out-dir as a compatibility wrapper. The packet is a reviewer-facing local evidence bundle and never performs network, write, publish, or application-submission actions.",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "generated_from",
+    "network_required",
+    "write_action_required",
+    "application_form_submission_performed",
+    "artifacts",
+    "artifact_details"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "patchrail.reviewer_quick_check_artifacts.v1"
+    },
+    "generated_from": {
+      "const": "local_checkout"
+    },
+    "network_required": {
+      "const": false
+    },
+    "write_action_required": {
+      "const": false
+    },
+    "application_form_submission_performed": {
+      "const": false
+    },
+    "artifacts": {
+      "type": "array",
+      "minItems": 15,
+      "uniqueItems": true,
+      "contains": {
+        "const": "reviewer-quick-check.md"
+      },
+      "items": {
+        "enum": [
+          "README.md",
+          "artifact-index.md",
+          "reviewer-quick-check.md",
+          "application-dossier.json",
+          "application-dossier.schema.json",
+          "application-dossier.txt",
+          "application-gate.txt",
+          "ci-triage-demo.md",
+          "control-plane-evidence.json",
+          "control-plane-evidence.md",
+          "http-api-evidence.json",
+          "http-api-evidence.md",
+          "release-readiness.json",
+          "release-readiness.md",
+          "reviewer-quick-check-artifacts.schema.json"
+        ]
+      }
+    },
+    "artifact_details": {
+      "type": "array",
+      "minItems": 15,
+      "description": "Offline integrity details for each reviewer packet artifact. Each path must also appear in artifacts.",
+      "items": {
+        "type": "object",
+        "required": [
+          "path",
+          "size_bytes",
+          "sha256"
+        ],
+        "properties": {
+          "path": {
+            "enum": [
+              "README.md",
+              "artifact-index.md",
+              "reviewer-quick-check.md",
+              "application-dossier.json",
+              "application-dossier.schema.json",
+              "application-dossier.txt",
+              "application-gate.txt",
+              "ci-triage-demo.md",
+              "control-plane-evidence.json",
+              "control-plane-evidence.md",
+              "http-api-evidence.json",
+              "http-api-evidence.md",
+              "release-readiness.json",
+              "release-readiness.md",
+              "reviewer-quick-check-artifacts.schema.json"
+            ]
+          },
+          "size_bytes": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "sha256": {
+            "type": "string",
+            "pattern": "^[0-9a-f]{64}$"
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}