PyPI - patchrail - Versions diffs - 0.1.0__py3-none-any.whl - Mend

patchrail 0.1.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (47) hide show

patchrail/__init__.py +7 -0
patchrail/__main__.py +7 -0
patchrail/ci/__init__.py +7 -0
patchrail/ci/classify.py +888 -0
patchrail/cli.py +8566 -0
patchrail/funded_issues/__init__.py +138 -0
patchrail/funded_issues/algora_board.py +240 -0
patchrail/funded_issues/blocklist.py +112 -0
patchrail/funded_issues/discovery.py +4091 -0
patchrail/funded_issues/importers.py +316 -0
patchrail/funded_issues/source_noise.py +349 -0
patchrail/funded_issues/store.py +459 -0
patchrail/queue/__init__.py +75 -0
patchrail/queue/server.py +273 -0
patchrail/queue/status.py +756 -0
patchrail/queue/store.py +600 -0
patchrail/reviewer_quick_check.py +650 -0
patchrail/schemas/__init__.py +1 -0
patchrail/schemas/application-dossier.v1.schema.json +305 -0
patchrail/schemas/ci-benchmark.v1.schema.json +174 -0
patchrail/schemas/ci-fixture-check.v1.schema.json +122 -0
patchrail/schemas/ci-pilot-metrics.v1.schema.json +164 -0
patchrail/schemas/ci-pilot-summary.v1.schema.json +146 -0
patchrail/schemas/ci-result.v1.schema.json +133 -0
patchrail/schemas/funded-issues-client-report.v1.schema.json +524 -0
patchrail/schemas/funded-issues-recheck-queue.v1.schema.json +333 -0
patchrail/schemas/funded-issues-recheck-summary.v1.schema.json +136 -0
patchrail/schemas/funded-issues-report.v1.schema.json +836 -0
patchrail/schemas/funded-issues-shortlist.v1.schema.json +953 -0
patchrail/schemas/funded-issues-store-status.v1.schema.json +96 -0
patchrail/schemas/funded-issues-store.v1.schema.json +117 -0
patchrail/schemas/queue-audit-event.v1.schema.json +44 -0
patchrail/schemas/queue-audit-summary.v1.schema.json +169 -0
patchrail/schemas/queue-gate-report.v1.schema.json +158 -0
patchrail/schemas/queue-policy-resolution.v1.schema.json +188 -0
patchrail/schemas/queue-policy-scan.v1.schema.json +175 -0
patchrail/schemas/queue-proposal.v1.schema.json +61 -0
patchrail/schemas/queue-review.v1.schema.json +218 -0
patchrail/schemas/queue-status.v1.schema.json +179 -0
patchrail/schemas/queue-work-item.v1.schema.json +64 -0
patchrail/schemas/reviewer-quick-check-artifacts.v1.schema.json +104 -0
patchrail/web_metrics.py +649 -0
patchrail-0.1.0.dist-info/METADATA +279 -0
patchrail-0.1.0.dist-info/RECORD +47 -0
patchrail-0.1.0.dist-info/WHEEL +4 -0
patchrail-0.1.0.dist-info/entry_points.txt +2 -0
patchrail-0.1.0.dist-info/licenses/LICENSE +202 -0

patchrail/schemas/queue-policy-resolution.v1.schema.json ADDED Viewed

@@ -0,0 +1,188 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://patchrail.dev/schemas/queue-policy-resolution.v1.schema.json",
+  "title": "PatchRail Queue Policy Resolution",
+  "description": "Local policy resolution for skipped work items and rejected proposals before reviewer handoff.",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "queue_schema_version",
+    "patchrail_version",
+    "db_path",
+    "local_first",
+    "status",
+    "reason",
+    "resolved_records_count",
+    "resolved_counts",
+    "resolved_records",
+    "before_policy_status",
+    "after_policy_status",
+    "remaining_blocked_records_count",
+    "reviewer_actions",
+    "safety"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "patchrail.queue_policy_resolution.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": ["resolved_blocked_records", "no_blocked_records"]
+    },
+    "reason": {
+      "type": "string",
+      "minLength": 1
+    },
+    "resolved_records_count": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "resolved_counts": {
+      "type": "object",
+      "required": ["work_items_skipped", "proposals_rejected", "audit_events_added"],
+      "properties": {
+        "work_items_skipped": { "type": "integer", "minimum": 0 },
+        "proposals_rejected": { "type": "integer", "minimum": 0 },
+        "audit_events_added": { "type": "integer", "minimum": 0 }
+      },
+      "additionalProperties": false
+    },
+    "resolved_records": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/resolved_record" }
+    },
+    "before_policy_status": {
+      "type": "string",
+      "enum": ["policy_clear", "blocked_records_present"]
+    },
+    "after_policy_status": {
+      "type": "string",
+      "enum": ["policy_clear", "blocked_records_present"]
+    },
+    "remaining_blocked_records_count": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "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",
+        "resolution_is_local_only",
+        "resolution_records_audit_event",
+        "local_paths_redacted",
+        "execution_allowed",
+        "github_write_performed",
+        "network_performed",
+        "proposals_executed",
+        "work_items_deleted"
+      ],
+      "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 },
+        "resolution_is_local_only": { "const": true },
+        "resolution_records_audit_event": { "const": true },
+        "local_paths_redacted": { "const": true },
+        "execution_allowed": { "const": false },
+        "github_write_performed": { "const": false },
+        "network_performed": { "const": false },
+        "proposals_executed": { "const": false },
+        "work_items_deleted": { "const": false }
+      },
+      "additionalProperties": false
+    }
+  },
+  "$defs": {
+    "resolved_record": {
+      "type": "object",
+      "required": [
+        "record_type",
+        "id",
+        "title",
+        "action",
+        "approval_state_after",
+        "status_after",
+        "matched_categories",
+        "matched_terms"
+      ],
+      "properties": {
+        "record_type": {
+          "type": "string",
+          "enum": ["work_item", "proposal"]
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "work_item_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "action": {
+          "type": "string",
+          "enum": ["skipped", "rejected"]
+        },
+        "approval_state_after": {
+          "type": "string",
+          "enum": ["rejected"]
+        },
+        "status_after": {
+          "type": "string",
+          "enum": ["skipped", "rejected"]
+        },
+        "matched_categories": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "matched_terms": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

patchrail/schemas/queue-policy-scan.v1.schema.json ADDED Viewed

@@ -0,0 +1,175 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://patchrail.dev/schemas/queue-policy-scan.v1.schema.json",
+  "title": "PatchRail Queue Policy Scan",
+  "description": "Read-only policy scan for local queue records before reviewer handoff.",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "queue_schema_version",
+    "patchrail_version",
+    "db_path",
+    "local_first",
+    "status",
+    "blocked_records_count",
+    "scanned_counts",
+    "policy_categories",
+    "matches",
+    "reviewer_actions",
+    "safety"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "patchrail.queue_policy_scan.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": ["policy_clear", "blocked_records_present"]
+    },
+    "blocked_records_count": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "scanned_counts": {
+      "type": "object",
+      "required": ["work_items_total", "proposals_total", "audit_events_total"],
+      "properties": {
+        "work_items_total": { "type": "integer", "minimum": 0 },
+        "proposals_total": { "type": "integer", "minimum": 0 },
+        "audit_events_total": { "type": "integer", "minimum": 0 }
+      },
+      "additionalProperties": false
+    },
+    "policy_categories": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "matches": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/policy_match" }
+    },
+    "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",
+        "scan_is_read_only",
+        "scan_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 },
+        "scan_is_read_only": { "const": true },
+        "scan_records_audit_event": { "const": false },
+        "local_paths_redacted": { "const": true },
+        "execution_allowed": { "const": false }
+      },
+      "additionalProperties": false
+    }
+  },
+  "$defs": {
+    "policy_match": {
+      "type": "object",
+      "required": [
+        "record_type",
+        "id",
+        "title",
+        "approval_state",
+        "matched_categories",
+        "matched_terms",
+        "recommended_action"
+      ],
+      "properties": {
+        "record_type": {
+          "type": "string",
+          "enum": ["work_item", "proposal"]
+        },
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "work_item_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "status": {
+          "type": "string",
+          "minLength": 1
+        },
+        "risk_level": {
+          "type": "string",
+          "minLength": 1
+        },
+        "approval_state": {
+          "type": "string",
+          "enum": ["pending", "approved", "rejected"]
+        },
+        "source": {
+          "type": "string"
+        },
+        "matched_categories": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "matched_terms": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "recommended_action": {
+          "type": "string",
+          "enum": ["reject_or_skip_before_handoff", "reject_before_handoff"]
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

patchrail/schemas/queue-proposal.v1.schema.json ADDED Viewed

@@ -0,0 +1,61 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://patchrail.dev/schemas/queue-proposal.v1.schema.json",
+  "title": "PatchRail Queue Proposal",
+  "description": "Local patch-plan proposal attached to a PatchRail work item for maintainer review.",
+  "type": "object",
+  "required": [
+    "id",
+    "work_item_id",
+    "title",
+    "summary",
+    "patch_plan",
+    "risk_level",
+    "approval_state",
+    "created_at",
+    "updated_at",
+    "decision_note"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^prp_[0-9a-f]{12}$"
+    },
+    "work_item_id": {
+      "type": "string",
+      "pattern": "^prq_[0-9a-f]{12}$"
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1
+    },
+    "summary": {
+      "type": "string",
+      "minLength": 1
+    },
+    "patch_plan": {
+      "type": "string",
+      "minLength": 1
+    },
+    "risk_level": {
+      "type": "string",
+      "enum": ["low", "medium", "high"]
+    },
+    "approval_state": {
+      "type": "string",
+      "enum": ["pending", "approved", "rejected"]
+    },
+    "created_at": {
+      "type": "string",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}T"
+    },
+    "updated_at": {
+      "type": "string",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}T"
+    },
+    "decision_note": {
+      "type": ["string", "null"]
+    }
+  },
+  "additionalProperties": false
+}

patchrail/schemas/queue-review.v1.schema.json ADDED Viewed

@@ -0,0 +1,218 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://patchrail.dev/schemas/queue-review.v1.schema.json",
+  "title": "PatchRail Queue Review Inbox",
+  "description": "Compact human-review inbox emitted by patchrail queue review 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",
+    "counts",
+    "review_groups",
+    "reviewer_actions",
+    "handoff_checklist",
+    "safety"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "patchrail.queue_review.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": ["awaiting_human_review", "clear_for_handoff"]
+    },
+    "ready_for_reviewer_handoff": {
+      "type": "boolean"
+    },
+    "pending_decisions": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "counts": {
+      "type": "object"
+    },
+    "review_groups": {
+      "type": "object",
+      "required": [
+        "pending_work_items",
+        "pending_proposals",
+        "approved_work_items",
+        "approved_proposals",
+        "rejected_work_items",
+        "rejected_proposals"
+      ],
+      "properties": {
+        "pending_work_items": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/work_item_review" }
+        },
+        "pending_proposals": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/proposal_review" }
+        },
+        "approved_work_items": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/work_item_review" }
+        },
+        "approved_proposals": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/proposal_review" }
+        },
+        "rejected_work_items": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/work_item_review" }
+        },
+        "rejected_proposals": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/proposal_review" }
+        }
+      },
+      "additionalProperties": false
+    },
+    "reviewer_actions": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "handoff_checklist": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/handoff_step" }
+    },
+    "safety": {
+      "type": "object",
+      "required": [
+        "write_actions_allowed_by_default",
+        "github_write_permission_required",
+        "network_required",
+        "external_model_required",
+        "billing_required",
+        "approval_records_execute_actions",
+        "review_is_read_only",
+        "review_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 },
+        "review_is_read_only": { "const": true },
+        "review_records_audit_event": { "const": false },
+        "local_paths_redacted": { "const": true },
+        "execution_allowed": { "const": false }
+      },
+      "additionalProperties": false
+    }
+  },
+  "$defs": {
+    "work_item_review": {
+      "type": "object",
+      "required": [
+        "id",
+        "kind",
+        "title",
+        "source",
+        "status",
+        "approval_state",
+        "write_actions_allowed",
+        "decision_note",
+        "payload_keys"
+      ],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "kind": { "type": "string", "minLength": 1 },
+        "title": { "type": "string", "minLength": 1 },
+        "source": { "type": "string", "minLength": 1 },
+        "status": { "type": "string", "minLength": 1 },
+        "approval_state": {
+          "type": "string",
+          "enum": ["pending", "approved", "rejected"]
+        },
+        "write_actions_allowed": { "const": false },
+        "decision_note": {
+          "type": ["string", "null"]
+        },
+        "payload_keys": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      },
+      "additionalProperties": false
+    },
+    "proposal_review": {
+      "type": "object",
+      "required": [
+        "id",
+        "work_item_id",
+        "title",
+        "risk_level",
+        "approval_state",
+        "decision_note"
+      ],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "work_item_id": { "type": "string", "minLength": 1 },
+        "title": { "type": "string", "minLength": 1 },
+        "risk_level": {
+          "type": "string",
+          "enum": ["low", "medium", "high"]
+        },
+        "approval_state": {
+          "type": "string",
+          "enum": ["pending", "approved", "rejected"]
+        },
+        "decision_note": {
+          "type": ["string", "null"]
+        }
+      },
+      "additionalProperties": false
+    },
+    "handoff_step": {
+      "type": "object",
+      "required": ["state", "command", "purpose"],
+      "properties": {
+        "state": {
+          "type": "string",
+          "enum": ["pending_work_items", "pending_proposals", "clear_for_handoff"]
+        },
+        "command": {
+          "type": "string",
+          "minLength": 1
+        },
+        "purpose": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}