patchrail 0.1.0__py3-none-any.whl

patchrail/schemas/funded-issues-store-status.v1.schema.json

@@ -0,0 +1,96 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://patchrail.dev/schemas/funded-issues-store-status.v1.schema.json",
+  "title": "PatchRail Funded Issues Tracker Store Status",
+  "description": "Read-only summary of a funded-issues tracker store emitted by patchrail funded-issues track-status. Aggregates totals only; never triggers a third-party write.",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "source_schema_version",
+    "read_only",
+    "blocked_actions",
+    "requirements",
+    "now",
+    "total_entries",
+    "states",
+    "added_24h",
+    "total_usd",
+    "usd_entries"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "patchrail.funded_issues.store_status.v1"
+    },
+    "source_schema_version": {
+      "const": "patchrail.funded_issues.v1"
+    },
+    "read_only": {
+      "const": true
+    },
+    "blocked_actions": {
+      "$ref": "#/$defs/blocked_actions"
+    },
+    "requirements": {
+      "$ref": "#/$defs/safe_requirements"
+    },
+    "now": {
+      "type": ["string", "null"]
+    },
+    "total_entries": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "states": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "integer",
+        "minimum": 0
+      }
+    },
+    "added_24h": {
+      "type": ["integer", "null"],
+      "minimum": 0
+    },
+    "total_usd": {
+      "type": ["number", "null"],
+      "minimum": 0
+    },
+    "usd_entries": {
+      "type": "integer",
+      "minimum": 0
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "blocked_actions": {
+      "type": "array",
+      "contains": { "const": "automatic_claims" },
+      "items": {
+        "enum": [
+          "automatic_claims",
+          "automatic_pull_requests",
+          "automatic_issue_comments",
+          "mass_outreach",
+          "ranking_by_money_only"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "safe_requirements": {
+      "type": "object",
+      "required": [
+        "network_required",
+        "github_write_permission_required",
+        "external_model_required",
+        "billing_required"
+      ],
+      "properties": {
+        "network_required": { "const": false },
+        "github_write_permission_required": { "const": false },
+        "external_model_required": { "const": false },
+        "billing_required": { "const": false }
+      },
+      "additionalProperties": false
+    }
+  }
+}

patchrail/schemas/funded-issues-store.v1.schema.json

@@ -0,0 +1,117 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://patchrail.dev/schemas/funded-issues-store.v1.schema.json",
+  "title": "PatchRail Funded Issues Tracker Store",
+  "description": "Read-only local persistence file for the funded-issues opportunity tracker, written by patchrail funded-issues track. Entries are keyed by canonical issue URL and never trigger any third-party write.",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "source_schema_version",
+    "read_only",
+    "blocked_actions",
+    "requirements",
+    "entries"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "patchrail.funded_issues.store.v1"
+    },
+    "source_schema_version": {
+      "const": "patchrail.funded_issues.v1"
+    },
+    "read_only": {
+      "const": true
+    },
+    "blocked_actions": {
+      "$ref": "#/$defs/blocked_actions"
+    },
+    "requirements": {
+      "$ref": "#/$defs/safe_requirements"
+    },
+    "entries": {
+      "type": "object",
+      "additionalProperties": {
+        "$ref": "#/$defs/store_entry"
+      }
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "blocked_actions": {
+      "type": "array",
+      "contains": { "const": "automatic_claims" },
+      "items": {
+        "enum": [
+          "automatic_claims",
+          "automatic_pull_requests",
+          "automatic_issue_comments",
+          "mass_outreach",
+          "ranking_by_money_only"
+        ]
+      },
+      "uniqueItems": true
+    },
+    "safe_requirements": {
+      "type": "object",
+      "required": [
+        "network_required",
+        "github_write_permission_required",
+        "external_model_required",
+        "billing_required"
+      ],
+      "properties": {
+        "network_required": { "const": false },
+        "github_write_permission_required": { "const": false },
+        "external_model_required": { "const": false },
+        "billing_required": { "const": false }
+      },
+      "additionalProperties": false
+    },
+    "store_state": {
+      "enum": ["active", "closed", "stale", "unknown"]
+    },
+    "state_transition": {
+      "type": "object",
+      "required": ["state", "at", "from"],
+      "properties": {
+        "state": { "$ref": "#/$defs/store_state" },
+        "at": { "type": "string", "minLength": 1 },
+        "from": {
+          "anyOf": [
+            { "$ref": "#/$defs/store_state" },
+            { "type": "null" }
+          ]
+        }
+      },
+      "additionalProperties": false
+    },
+    "store_entry": {
+      "type": "object",
+      "required": [
+        "issue",
+        "first_seen",
+        "last_seen",
+        "last_checked",
+        "state",
+        "state_history"
+      ],
+      "properties": {
+        "issue": { "type": "object" },
+        "first_seen": { "type": "string", "minLength": 1 },
+        "last_seen": { "type": "string", "minLength": 1 },
+        "last_checked": { "type": "string", "minLength": 1 },
+        "state": { "$ref": "#/$defs/store_state" },
+        "state_history": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/state_transition" },
+          "minItems": 1
+        },
+        "score": {
+          "type": ["integer", "null"],
+          "minimum": 0
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

patchrail/schemas/queue-audit-event.v1.schema.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://patchrail.dev/schemas/queue-audit-event.v1.schema.json",
+  "title": "PatchRail Queue Audit Event",
+  "description": "Append-only local audit event emitted by PatchRail queue operations.",
+  "type": "object",
+  "required": [
+    "id",
+    "ts",
+    "event_type",
+    "work_item_id",
+    "payload"
+  ],
+  "properties": {
+    "id": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "ts": {
+      "type": "string",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}T"
+    },
+    "event_type": {
+      "type": "string",
+      "enum": [
+        "work_item_added",
+        "work_item_approved",
+        "work_item_rejected",
+        "work_items_exported",
+        "proposal_added",
+        "proposal_approved",
+        "proposal_rejected"
+      ]
+    },
+    "work_item_id": {
+      "type": ["string", "null"],
+      "pattern": "^prq_[0-9a-f]{12}$"
+    },
+    "payload": {
+      "type": "object"
+    }
+  },
+  "additionalProperties": false
+}

patchrail/schemas/queue-audit-summary.v1.schema.json

@@ -0,0 +1,169 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://patchrail.dev/schemas/queue-audit-summary.v1.schema.json",
+  "title": "PatchRail Queue Audit Summary",
+  "description": "Local audit summary emitted by patchrail queue audit-summary for Agent Control Plane gate evidence.",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "queue_schema_version",
+    "patchrail_version",
+    "db_path",
+    "local_first",
+    "status",
+    "counts",
+    "required_events",
+    "missing_required_events",
+    "gates",
+    "affected_work_item_ids",
+    "latest_audit_event",
+    "safety"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "patchrail.queue_audit_summary.v1"
+    },
+    "queue_schema_version": {
+      "const": "patchrail.queue.v1"
+    },
+    "patchrail_version": {
+      "type": "string",
+      "minLength": 1
+    },
+    "db_path": {
+      "type": "string",
+      "minLength": 1
+    },
+    "local_first": {
+      "const": true
+    },
+    "status": {
+      "type": "string",
+      "enum": ["human_gates_exercised", "needs_more_audit_evidence"]
+    },
+    "counts": {
+      "type": "object",
+      "required": [
+        "audit_events_total",
+        "event_types",
+        "work_items_total",
+        "proposals_total",
+        "affected_work_items"
+      ],
+      "properties": {
+        "audit_events_total": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "event_types": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "integer",
+            "minimum": 0
+          }
+        },
+        "work_items_total": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "proposals_total": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "affected_work_items": {
+          "type": "integer",
+          "minimum": 0
+        }
+      },
+      "additionalProperties": false
+    },
+    "required_events": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "missing_required_events": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "gates": {
+      "type": "object",
+      "required": [
+        "work_item_approval_gate_exercised",
+        "work_item_rejection_gate_exercised",
+        "proposal_approval_gate_exercised",
+        "proposal_rejection_gate_exercised",
+        "queue_export_recorded"
+      ],
+      "properties": {
+        "work_item_approval_gate_exercised": {
+          "type": "boolean"
+        },
+        "work_item_rejection_gate_exercised": {
+          "type": "boolean"
+        },
+        "proposal_approval_gate_exercised": {
+          "type": "boolean"
+        },
+        "proposal_rejection_gate_exercised": {
+          "type": "boolean"
+        },
+        "queue_export_recorded": {
+          "type": "boolean"
+        }
+      },
+      "additionalProperties": false
+    },
+    "affected_work_item_ids": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^prq_[0-9a-f]{12}$"
+      }
+    },
+    "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": false
+}

patchrail/schemas/queue-gate-report.v1.schema.json

@@ -0,0 +1,158 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://patchrail.dev/schemas/queue-gate-report.v1.schema.json",
+  "title": "PatchRail Queue Gate Report",
+  "description": "Reviewer-facing readiness report emitted by patchrail queue gate-report without exporting full queue records.",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "queue_schema_version",
+    "patchrail_version",
+    "db_path",
+    "local_first",
+    "status",
+    "ready_for_reviewer_handoff",
+    "pending_decisions",
+    "missing_required_events",
+    "decision_counts",
+    "audit_counts",
+    "gates",
+    "reviewer_actions",
+    "safety"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "patchrail.queue_gate_report.v1"
+    },
+    "queue_schema_version": {
+      "const": "patchrail.queue.v1"
+    },
+    "patchrail_version": {
+      "type": "string",
+      "minLength": 1
+    },
+    "db_path": {
+      "type": "string",
+      "minLength": 1
+    },
+    "local_first": {
+      "const": true
+    },
+    "status": {
+      "type": "string",
+      "enum": ["ready_for_reviewer_handoff", "needs_reviewer_decisions"]
+    },
+    "ready_for_reviewer_handoff": {
+      "type": "boolean"
+    },
+    "pending_decisions": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "missing_required_events": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "decision_counts": {
+      "type": "object",
+      "required": [
+        "pending_work_items",
+        "pending_proposals",
+        "approved_work_items",
+        "rejected_work_items",
+        "approved_proposals",
+        "rejected_proposals"
+      ],
+      "properties": {
+        "pending_work_items": { "type": "integer", "minimum": 0 },
+        "pending_proposals": { "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 }
+      },
+      "additionalProperties": false
+    },
+    "audit_counts": {
+      "type": "object",
+      "required": [
+        "audit_events_total",
+        "event_types",
+        "work_items_total",
+        "proposals_total",
+        "affected_work_items"
+      ],
+      "properties": {
+        "audit_events_total": { "type": "integer", "minimum": 0 },
+        "event_types": {
+          "type": "object",
+          "additionalProperties": { "type": "integer", "minimum": 0 }
+        },
+        "work_items_total": { "type": "integer", "minimum": 0 },
+        "proposals_total": { "type": "integer", "minimum": 0 },
+        "affected_work_items": { "type": "integer", "minimum": 0 }
+      },
+      "additionalProperties": false
+    },
+    "gates": {
+      "type": "object",
+      "required": [
+        "work_item_approval_gate_exercised",
+        "work_item_rejection_gate_exercised",
+        "work_item_skip_gate_exercised",
+        "proposal_approval_gate_exercised",
+        "proposal_rejection_gate_exercised",
+        "queue_export_recorded"
+      ],
+      "properties": {
+        "work_item_approval_gate_exercised": { "type": "boolean" },
+        "work_item_rejection_gate_exercised": { "type": "boolean" },
+        "work_item_skip_gate_exercised": { "type": "boolean" },
+        "proposal_approval_gate_exercised": { "type": "boolean" },
+        "proposal_rejection_gate_exercised": { "type": "boolean" },
+        "queue_export_recorded": { "type": "boolean" }
+      },
+      "additionalProperties": false
+    },
+    "reviewer_actions": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "safety": {
+      "type": "object",
+      "required": [
+        "write_actions_allowed_by_default",
+        "github_write_permission_required",
+        "network_required",
+        "external_model_required",
+        "billing_required",
+        "approval_records_execute_actions",
+        "report_is_read_only",
+        "report_records_audit_event",
+        "local_paths_redacted",
+        "execution_allowed"
+      ],
+      "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 },
+        "report_is_read_only": { "const": true },
+        "report_records_audit_event": { "const": false },
+        "local_paths_redacted": { "const": true },
+        "execution_allowed": { "const": false }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}