feat: project scaffold, unified Pydantic schema, scope gating

2026-06-29 17:35:50 -04:00
commit 1f531e4948
9 changed files with 1239 additions and 0 deletions
@@ -0,0 +1,98 @@
+{
+  "$defs": {
+    "Severity": {
+      "enum": [
+        "info",
+        "low",
+        "medium",
+        "high",
+        "critical",
+        "unknown"
+      ],
+      "title": "Severity",
+      "type": "string"
+    },
+    "TriageItem": {
+      "additionalProperties": false,
+      "description": "One prioritized finding from the LLM stage. All references must point at ids\npresent in the ReconReport \u2014 see triage.llm for the acceptance gate.",
+      "properties": {
+        "summary": {
+          "title": "Summary",
+          "type": "string"
+        },
+        "rationale": {
+          "title": "Rationale",
+          "type": "string"
+        },
+        "severity": {
+          "$ref": "#/$defs/Severity",
+          "default": "unknown"
+        },
+        "evidence_refs": {
+          "description": "ids/keys present in the ReconReport (host:port, edb_id, template_id).",
+          "items": {
+            "type": "string"
+          },
+          "title": "Evidence Refs",
+          "type": "array"
+        },
+        "suggested_next_step": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Must reference a real edb_id / nuclei template / host:port from input.",
+          "title": "Suggested Next Step"
+        },
+        "confidence": {
+          "default": 0.0,
+          "maximum": 1.0,
+          "minimum": 0.0,
+          "title": "Confidence",
+          "type": "number"
+        }
+      },
+      "required": [
+        "summary",
+        "rationale"
+      ],
+      "title": "TriageItem",
+      "type": "object"
+    }
+  },
+  "additionalProperties": false,
+  "properties": {
+    "prioritized_findings": {
+      "items": {
+        "$ref": "#/$defs/TriageItem"
+      },
+      "title": "Prioritized Findings",
+      "type": "array"
+    },
+    "model": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Model"
+    },
+    "generated_by": {
+      "default": "deterministic",
+      "description": "'llm' or 'deterministic'.",
+      "title": "Generated By",
+      "type": "string"
+    }
+  },
+  "title": "TriageReport",
+  "type": "object"
+}