@nebulacomponents/citable 1.19.0 → 1.21.0

package/dist/universal/.gemini/skills/citable/schemas/action-plan.schema.json

@@ -4,11 +4,23 @@
   "title": "Finding action plan",
   "type": "object",
   "additionalProperties": false,
-  "required": ["source_run_id", "source_findings_hash", "generated_at", "summary", "actions"],
+  "required": ["source_run_id", "source_findings_hash", "generated_at", "summary", "actions", "source_coverage"],
   "properties": {
     "source_run_id": { "type": "string", "minLength": 1 },
     "source_findings_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
     "generated_at": { "type": "string" },
+    "source_coverage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["coverage_status", "determination_status", "evidence_scope", "limitations"],
+      "properties": {
+        "coverage_status": { "type": "string", "enum": ["complete", "truncated", "indeterminate", "not_applicable"] },
+        "determination_status": { "type": "string", "enum": ["supported", "qualified", "indeterminate", "not_applicable"] },
+        "artifact": { "type": ["string", "null"] },
+        "evidence_scope": { "$ref": "#/definitions/evidenceScope" },
+        "limitations": { "type": "array", "items": { "type": "string" } }
+      }
+    },
     "summary": {
       "type": "object",
       "additionalProperties": false,
@@ -40,6 +52,10 @@
           "owner": { "type": ["string", "null"] },
           "decision_owner": { "type": ["string", "null"] },
           "status": { "type": "string", "enum": ["ready", "blocked"] },
+          "coverage_status": { "type": "string", "enum": ["complete", "truncated", "indeterminate", "not_applicable"] },
+          "determination_status": { "type": "string", "enum": ["supported", "qualified", "indeterminate", "not_applicable"] },
+          "evidence_scope": { "$ref": "#/definitions/evidenceScope" },
+          "limitations": { "type": "array", "items": { "type": "string" } },
           "required_input": { "type": "array", "items": { "type": "string" } },
           "semantic_gates": { "type": "array", "items": { "type": "string" } },
           "unsafe_shortcuts": { "type": "array", "items": { "type": "string" } },
@@ -64,5 +80,26 @@
         }
       }
     }
+  },
+  "definitions": {
+    "evidenceScope": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["requirement", "satisfaction", "coverage_ref", "resource_ids"],
+      "properties": {
+        "requirement": { "type": "string", "minLength": 1 },
+        "satisfaction": { "type": "string", "enum": ["supported", "qualified", "indeterminate", "not_applicable"] },
+        "coverage_ref": { "type": ["string", "null"] },
+        "resource_ids": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+        "population": { "type": "string", "enum": ["evaluated_subset", "none_observed"] },
+        "evaluated": { "type": ["integer", "null"], "minimum": 0 },
+        "eligible": { "type": ["integer", "null"], "minimum": 0 },
+        "excluded": { "type": ["integer", "null"], "minimum": 0 },
+        "failed": { "type": ["integer", "null"], "minimum": 0 },
+        "indeterminate": { "type": ["integer", "null"], "minimum": 0 },
+        "unvisited": { "type": ["integer", "null"], "minimum": 0 },
+        "denominator": { "type": ["integer", "null"], "minimum": 0 }
+      }
+    }
   }
 }

package/dist/universal/.gemini/skills/citable/schemas/audit-coverage.schema.json

@@ -0,0 +1,118 @@
+{
+  "$id": "citable://schemas/audit-coverage.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Audit coverage",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "normalization_version",
+    "requested_scope",
+    "discovery",
+    "populations",
+    "resources",
+    "stop_reason",
+    "coverage_status",
+    "reconciliation",
+    "limitations"
+  ],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "normalization_version": { "type": "string", "minLength": 1 },
+    "requested_scope": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["start_url", "origin", "max_pages", "time_budget_seconds"],
+      "properties": {
+        "start_url": { "type": "string", "format": "uri" },
+        "origin": { "type": "string", "format": "uri" },
+        "max_pages": { "type": "integer", "minimum": 1, "maximum": 10000 },
+        "time_budget_seconds": { "type": "integer", "minimum": 1, "maximum": 86400 }
+      }
+    },
+    "discovery": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "methods", "limitations"],
+      "properties": {
+        "status": { "type": "string", "enum": ["complete", "truncated", "indeterminate"] },
+        "methods": { "type": "array", "items": { "type": "string" } },
+        "limitations": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "populations": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "discovered",
+        "eligible",
+        "excluded",
+        "attempted",
+        "retrieved",
+        "valid_resource",
+        "evaluated",
+        "valid_but_unevaluated",
+        "failed",
+        "indeterminate",
+        "unvisited"
+      ],
+      "properties": {
+        "discovered": { "$ref": "#/definitions/populationCount" },
+        "eligible": { "$ref": "#/definitions/populationCount" },
+        "excluded": { "$ref": "#/definitions/populationCount" },
+        "attempted": { "$ref": "#/definitions/populationCount" },
+        "retrieved": { "$ref": "#/definitions/populationCount" },
+        "valid_resource": { "$ref": "#/definitions/populationCount" },
+        "evaluated": { "$ref": "#/definitions/populationCount" },
+        "valid_but_unevaluated": { "$ref": "#/definitions/populationCount" },
+        "failed": { "$ref": "#/definitions/populationCount" },
+        "indeterminate": { "$ref": "#/definitions/populationCount" },
+        "unvisited": { "$ref": "#/definitions/populationCount" }
+      }
+    },
+    "resources": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "resource_id": { "type": ["string", "null"] },
+          "requested_url": { "type": ["string", "null"] },
+          "effective_url": { "type": ["string", "null"] },
+          "canonical_url": { "type": ["string", "null"] },
+          "response_body_hash": { "type": ["string", "null"], "pattern": "^[a-f0-9]{64}$" },
+          "rendered_dom_hash": { "type": ["string", "null"], "pattern": "^[a-f0-9]{64}$" },
+          "extracted_text_hash": { "type": ["string", "null"], "pattern": "^[a-f0-9]{64}$" },
+          "structured_data_hash": { "type": ["string", "null"], "pattern": "^[a-f0-9]{64}$" },
+          "evidence_hash": { "type": ["string", "null"], "pattern": "^[a-f0-9]{64}$" },
+          "artifact_hash": { "type": ["string", "null"], "pattern": "^[a-f0-9]{64}$" }
+        }
+      }
+    },
+    "stop_reason": {
+      "type": "string",
+      "enum": [
+        "frontier_exhausted",
+        "page_budget_exhausted",
+        "time_budget_exhausted",
+        "fatal_collection_failure"
+      ]
+    },
+    "coverage_status": {
+      "type": "string",
+      "enum": ["complete", "truncated", "indeterminate", "not_applicable"]
+    },
+    "reconciliation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["valid", "errors"],
+      "properties": {
+        "valid": { "type": "boolean" },
+        "errors": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "limitations": { "type": "array", "items": { "type": "string" } }
+  },
+  "definitions": {
+    "populationCount": { "type": "integer", "minimum": 0 }
+  }
+}

package/dist/universal/.gemini/skills/citable/schemas/claim-evidence.schema.json

@@ -0,0 +1,21 @@
+{
+  "$id": "citable://schemas/claim-evidence.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Claim to evidence lineage",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["claim_id", "claim_version", "proposition", "declared_scope", "evidence_references", "observation_references", "dataset_references", "derivation_references", "assertion", "limitations", "claim_hash"],
+  "properties": {
+    "claim_id": { "type": "string", "minLength": 1 },
+    "claim_version": { "type": "integer", "minimum": 1 },
+    "proposition": { "type": "string", "minLength": 3 },
+    "declared_scope": { "type": "object", "additionalProperties": false, "required": ["type", "generalization"], "properties": { "type": { "type": "string", "enum": ["observation", "dataset", "declared_population"] }, "observation_reference": { "type": "string" }, "dataset_reference": { "type": "string" }, "generalization": { "type": "string", "enum": ["bounded", "universal"] } } },
+    "evidence_references": { "type": "array", "items": { "type": "string" } },
+    "observation_references": { "type": "array", "items": { "type": "string" } },
+    "dataset_references": { "type": "array", "items": { "type": "string" } },
+    "derivation_references": { "type": "array", "items": { "type": "string" } },
+    "assertion": { "type": "object" },
+    "limitations": { "type": "array", "items": { "type": "string" } },
+    "claim_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+  }
+}

package/dist/universal/.gemini/skills/citable/schemas/claim-verification.schema.json

@@ -0,0 +1,18 @@
+{
+  "$id": "citable://schemas/claim-verification.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Bounded claim verification result",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["claim_id", "claim_version", "overall", "proposition_support", "scope_support", "reasons", "lineage"],
+  "properties": {
+    "claim_id": { "type": "string" },
+    "claim_version": { "type": "integer", "minimum": 1 },
+    "overall": { "type": "string", "enum": ["SUPPORTED", "PARTIALLY_SUPPORTED", "UNSUPPORTED", "CONTRADICTED", "INDETERMINATE", "NOT_OBSERVED"] },
+    "proposition_support": { "type": "string", "enum": ["SUPPORTED", "PARTIALLY_SUPPORTED", "UNSUPPORTED", "CONTRADICTED", "INDETERMINATE", "NOT_OBSERVED"] },
+    "scope_support": { "type": "string", "enum": ["SUPPORTED", "PARTIALLY_SUPPORTED", "UNSUPPORTED", "INDETERMINATE", "NOT_OBSERVED"] },
+    "reasons": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" } } } },
+    "lineage": { "type": "object", "additionalProperties": false, "required": ["claim_reference", "observation_references", "dataset_references", "derivation_references"], "properties": { "claim_reference": { "type": "string" }, "observation_references": { "type": "array", "items": { "type": "string" } }, "dataset_references": { "type": "array", "items": { "type": "string" } }, "derivation_references": { "type": "array", "items": { "type": "string" } } } },
+    "limitations": { "type": "array", "items": { "type": "string" } }
+  }
+}

package/dist/universal/.gemini/skills/citable/schemas/collection-result.schema.json

@@ -0,0 +1,35 @@
+{
+  "$id": "citable://schemas/collection-result.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Collection result",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "items",
+    "pagination_state",
+    "provider_reported_total",
+    "retrieved_total",
+    "coverage_status",
+    "continuation_state",
+    "limitations",
+    "errors"
+  ],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "items": {
+      "type": "array",
+      "items": {}
+    },
+    "pagination_state": { "type": "object" },
+    "provider_reported_total": { "type": ["integer", "null"], "minimum": 0 },
+    "retrieved_total": { "type": "integer", "minimum": 0 },
+    "coverage_status": {
+      "type": "string",
+      "enum": ["complete", "truncated", "indeterminate", "provider_bounded"]
+    },
+    "continuation_state": { "type": ["object", "null"] },
+    "limitations": { "type": "array", "items": { "type": "string" } },
+    "errors": { "type": "array", "items": { "type": "string" } }
+  }
+}

package/dist/universal/.gemini/skills/citable/schemas/config.schema.json

@@ -30,6 +30,8 @@
       "type": "object",
       "properties": {
         "index_target_default": { "type": "boolean" },
+        "max_pages": { "type": "integer", "minimum": 1, "maximum": 10000 },
+        "time_budget_seconds": { "type": "integer", "minimum": 1, "maximum": 86400 },
         "max_crawl_depth": { "type": "integer", "minimum": 1 },
         "thin_content_words": { "type": "integer", "minimum": 1 },
         "fetch_external": { "type": "boolean" },

package/dist/universal/.gemini/skills/citable/schemas/cro-report.schema.json

@@ -103,7 +103,14 @@
         "source_identifier": { "type": ["string", "null"] },
         "source_findings_count": { "type": "integer", "minimum": 0 },
         "integrity_hash": { "type": ["string", "null"] },
-        "synthetic_evidence": { "type": "boolean" }
+        "synthetic_evidence": { "type": "boolean" },
+        "package_verified": { "type": "boolean" },
+        "integrity_mode": { "type": "string" },
+        "legacy": { "type": "boolean" },
+        "coverage_status": { "type": "string" },
+        "determination_status": { "type": "string" },
+        "evaluated": { "type": ["integer", "null"], "minimum": 0 },
+        "eligible": { "type": ["integer", "null"], "minimum": 0 }
       },
       "additionalProperties": false
     }

package/dist/universal/.gemini/skills/citable/schemas/derivation.schema.json

@@ -0,0 +1,18 @@
+{
+  "$id": "citable://schemas/derivation.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Evidence derivation",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["derivation_id", "derivation_version", "operation", "input_observation_references", "result", "implementation", "derivation_hash"],
+  "properties": {
+    "derivation_id": { "type": "string", "minLength": 1 },
+    "derivation_version": { "type": "integer", "minimum": 1 },
+    "operation": { "type": "string", "minLength": 1 },
+    "input_observation_references": { "type": "array", "minItems": 1, "items": { "type": "string" } },
+    "predicate": { "type": "object", "additionalProperties": false, "required": ["path", "operator", "value"], "properties": { "path": { "type": "string" }, "operator": { "type": "string", "enum": ["equals"] }, "value": {} } },
+    "result": { "type": "object" },
+    "implementation": { "type": "object", "additionalProperties": false, "required": ["id", "version"], "properties": { "id": { "type": "string" }, "version": { "type": "string" } } },
+    "derivation_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+  }
+}

package/dist/universal/.gemini/skills/citable/schemas/external-comparison.schema.json

@@ -0,0 +1,16 @@
+{
+  "$id": "citable://schemas/external-comparison.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "External evidence comparison",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["comparison_id", "left_reference", "right_reference", "status", "dimensions", "limitations"],
+  "properties": {
+    "comparison_id": { "type": "string", "minLength": 1 },
+    "left_reference": { "type": "string", "minLength": 1 },
+    "right_reference": { "type": "string", "minLength": 1 },
+    "status": { "type": "string", "enum": ["COMPARABLE", "PARTIALLY_COMPARABLE", "NOT_COMPARABLE", "INDETERMINATE"] },
+    "dimensions": { "type": "object", "additionalProperties": { "type": "string", "enum": ["match", "mismatch", "missing", "unknown"] } },
+    "limitations": { "type": "array", "items": { "type": "string" } }
+  }
+}

package/dist/universal/.gemini/skills/citable/schemas/external-observation.schema.json

@@ -0,0 +1,32 @@
+{
+  "$id": "citable://schemas/external-observation.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Provider-neutral external observation",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["observation_id", "observation_type", "subject", "source", "collector", "observed_at", "population", "observation_status", "retrieval_status", "data", "evidence_hash"],
+  "properties": {
+    "observation_id": { "type": "string", "minLength": 1 },
+    "observation_type": { "type": "string", "enum": ["PAGE_OBSERVATION", "EXTERNAL_OBSERVATION", "DERIVED_OBSERVATION"] },
+    "subject": { "type": "object", "additionalProperties": false, "required": ["type", "id"], "properties": { "type": { "type": "string", "minLength": 1 }, "id": { "type": "string", "minLength": 1 } } },
+    "source": { "type": "object", "additionalProperties": false, "required": ["provider", "method", "authority"], "properties": { "provider": { "type": "string", "minLength": 1 }, "method": { "type": "string", "minLength": 1 }, "authority": { "type": "string", "enum": ["first_party", "external_provider", "third_party", "synthetic", "inferred", "unknown"] }, "account_or_property": { "type": ["string", "null"] } } },
+    "collector": { "type": "object", "additionalProperties": false, "required": ["id", "version"], "properties": { "id": { "type": "string", "minLength": 1 }, "version": { "type": "string", "minLength": 1 } } },
+    "parser": { "type": ["object", "null"], "additionalProperties": false, "required": ["id", "version"], "properties": { "id": { "type": "string", "minLength": 1 }, "version": { "type": "string", "minLength": 1 } } },
+    "configuration": { "type": ["object", "null"], "additionalProperties": false, "required": ["id", "version"], "properties": { "id": { "type": "string", "minLength": 1 }, "version": { "type": "string", "minLength": 1 } } },
+    "observed_at": { "type": "string", "format": "date-time" },
+    "retrieved_at": { "type": ["string", "null"], "format": "date-time" },
+    "executed_at": { "type": ["string", "null"], "format": "date-time" },
+    "population": { "$ref": "#/definitions/population" },
+    "observation_status": { "type": "string", "enum": ["observed", "not_observed", "incomplete", "indeterminate", "failed"] },
+    "retrieval_status": { "type": "string", "enum": ["retrieved", "not_retrieved", "partial", "indeterminate", "failed"] },
+    "determination_status": { "type": ["string", "null"], "enum": ["pass", "fail", "warning", "indeterminate", "not_tested", "error", "not_applicable", null] },
+    "data": { "type": "object" },
+    "context": { "type": "object", "additionalProperties": false, "properties": { "observed": { "type": "object" }, "supplied": { "type": "object" } } },
+    "lineage": { "type": "object", "additionalProperties": false, "properties": { "source_evidence": { "type": "array", "items": { "type": "string" } }, "predecessor_references": { "type": "array", "items": { "type": "string" } }, "successor_references": { "type": "array", "items": { "type": "string" } }, "derivation_inputs": { "type": "array", "items": { "type": "string" } }, "package_reference": { "type": ["string", "null"] } } },
+    "limitations": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+    "evidence_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+  },
+  "definitions": {
+    "population": { "type": "object", "additionalProperties": false, "required": ["declared", "observed", "retrieved", "evaluated", "unavailable", "failed"], "properties": { "declared": { "type": ["object", "null"], "additionalProperties": false, "properties": { "id": { "type": "string" }, "size": { "type": "integer", "minimum": 0 } } }, "observed": { "type": "integer", "minimum": 0 }, "retrieved": { "type": "integer", "minimum": 0 }, "evaluated": { "type": "integer", "minimum": 0 }, "unavailable": { "type": "integer", "minimum": 0 }, "failed": { "type": "integer", "minimum": 0 } } }
+  }
+}

package/dist/universal/.gemini/skills/citable/schemas/finding.schema.json

@@ -17,12 +17,19 @@
     "status"
   ],
   "properties": {
+    "schema_version": {
+      "type": "integer",
+      "enum": [1, 2]
+    },
     "finding_id": {
       "$ref": "citable://schemas/common.defs.json#/definitions/id"
     },
     "detector_id": {
       "$ref": "citable://schemas/common.defs.json#/definitions/id"
     },
+    "detector_name": {
+      "type": "string"
+    },
     "run_id": {
       "type": "string"
     },
@@ -84,6 +91,15 @@
         },
         "rendered_selector": {
           "type": "string"
+        },
+        "resource_id": {
+          "type": "string"
+        },
+        "url_identity": {
+          "type": "object"
+        },
+        "evidence_identity": {
+          "$ref": "#/definitions/evidenceIdentity"
         }
       }
     },
@@ -106,7 +122,10 @@
           }
         },
         "captured_value": {},
-        "expected_value": {}
+        "expected_value": {},
+        "evidence_identity": {
+          "$ref": "#/definitions/evidenceIdentity"
+        }
       }
     },
     "classification": {
@@ -326,6 +345,42 @@
         }
       }
     },
+    "evidence_scope": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "requirement",
+        "satisfaction",
+        "resource_ids",
+        "coverage_ref"
+      ],
+      "properties": {
+        "requirement": {
+          "type": "string",
+          "minLength": 1
+        },
+        "satisfaction": {
+          "type": "string",
+          "enum": [
+            "supported",
+            "qualified",
+            "indeterminate",
+            "not_applicable"
+          ]
+        },
+        "resource_ids": {
+          "type": "array",
+          "uniqueItems": true,
+          "items": {
+            "type": "string"
+          }
+        },
+        "coverage_ref": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
     "status": {
       "type": "object",
       "required": [
@@ -358,7 +413,55 @@
       }
     }
   },
+  "allOf": [
+    {
+      "if": {
+        "required": ["schema_version"],
+        "properties": {
+          "schema_version": {
+            "const": 2
+          }
+        }
+      },
+      "then": {
+        "required": ["evidence_scope"],
+        "propertyNames": {
+          "enum": [
+            "schema_version",
+            "finding_id",
+            "detector_id",
+            "detector_name",
+            "run_id",
+            "timestamp",
+            "discipline",
+            "subject",
+            "observation",
+            "classification",
+            "reasoning",
+            "remediation",
+            "verification",
+            "provenance",
+            "evidence_scope",
+            "status"
+          ]
+        }
+      }
+    }
+  ],
   "definitions": {
+    "evidenceIdentity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["hash_schema_version", "representation", "hash"],
+      "properties": {
+        "hash_schema_version": { "type": "string", "minLength": 1 },
+        "representation": {
+          "type": "string",
+          "enum": ["response_body", "rendered_dom", "extracted_text", "structured_data", "evidence", "artifact"]
+        },
+        "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+      }
+    },
     "impactLevel": {
       "type": "string",
       "enum": [
@@ -370,4 +473,4 @@
       ]
     }
   }
-}
+}

package/dist/universal/.gemini/skills/citable/schemas/prompt-set.schema.json

@@ -0,0 +1,47 @@
+{
+  "$id": "citable://schemas/prompt-set.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Immutable versioned prompt population",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["prompt_set_id", "prompt_set_version", "purpose", "generation_method", "generated_at", "population_size", "sampling_method", "included_prompts", "excluded_prompts", "intended_population", "limitations", "prompt_set_hash"],
+  "properties": {
+    "prompt_set_id": { "type": "string", "minLength": 1 },
+    "prompt_set_version": { "type": "integer", "minimum": 1 },
+    "purpose": { "type": "string", "minLength": 1 },
+    "generation_method": { "type": "string", "minLength": 1 },
+    "generation_method_version": { "type": ["string", "null"] },
+    "generation_input": {},
+    "generated_at": { "type": "string", "format": "date-time" },
+    "population_size": { "type": "integer", "minimum": 0 },
+    "sampling_method": { "type": "string", "minLength": 1 },
+    "included_prompts": { "type": "array", "items": { "$ref": "#/definitions/prompt" } },
+    "excluded_prompts": { "type": "array", "items": { "$ref": "#/definitions/excludedPrompt" } },
+    "intended_population": { "type": "string", "minLength": 1 },
+    "limitations": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+    "prompt_set_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+  },
+  "definitions": {
+    "prompt": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["prompt_id", "prompt_text"],
+      "properties": {
+        "prompt_id": { "type": "string", "minLength": 1 },
+        "prompt_text": { "type": "string", "minLength": 1 },
+        "context": { "type": ["object", "null"] },
+        "locale": { "type": ["string", "null"] }
+      }
+    },
+    "excludedPrompt": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["prompt_id", "exclusion_reason"],
+      "properties": {
+        "prompt_id": { "type": "string", "minLength": 1 },
+        "prompt_text": { "type": ["string", "null"] },
+        "exclusion_reason": { "type": "string", "minLength": 1 }
+      }
+    }
+  }
+}

package/dist/universal/.gemini/skills/citable/schemas/remediation-verification.schema.json

@@ -12,7 +12,7 @@
   "properties": {
     "verification_id": { "type": "string", "pattern": "^VR-[0-9]{14,20}-[a-z0-9]{2,8}$" },
     "timestamp": { "type": "string" },
-    "status": { "type": "string", "enum": ["verified", "not_resolved", "blocked", "patch_refused"] },
+    "status": { "type": "string", "enum": ["verified", "not_resolved", "not_reobserved", "not_comparable", "indeterminate", "blocked", "patch_refused"] },
     "tool_version": { "type": "string" },
     "repository_commit": { "type": ["string", "null"] },
     "source_run_id": { "type": ["string", "null"], "minLength": 1 },
@@ -30,6 +30,7 @@
       "required": ["resolved"],
       "properties": {
         "resolved": { "type": "boolean" },
+        "comparison_state": { "type": "string", "enum": ["persisted", "resolved", "new", "changed", "not_comparable", "not_reobserved", "indeterminate"] },
         "before_finding_ids": { "type": "array", "items": { "type": "string" } },
         "after_finding_ids": { "type": "array", "items": { "type": "string" } },
         "new_regressions": {
@@ -51,6 +52,16 @@
         }
       }
     },
+    "comparison": {
+      "type": "object",
+      "required": ["state", "reason", "coverage_status"],
+      "properties": {
+        "state": { "type": "string", "enum": ["resolved", "not_reobserved", "not_comparable", "indeterminate"] },
+        "reason": { "type": "string" },
+        "coverage_status": { "type": "string" },
+        "resource": { "type": ["string", "null"] }
+      }
+    },
     "patch": {
       "type": ["object", "null"],
       "properties": {

package/dist/universal/.gemini/skills/citable/schemas/representation-data.schema.json

@@ -0,0 +1,21 @@
+{
+  "$id": "citable://schemas/representation-data.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Provider-neutral AI representation observation data",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["provider", "product", "surface", "model", "prompt", "prompt_set", "execution", "response", "representation", "evidence_origin"],
+  "properties": {
+    "provider": { "type": "string", "minLength": 1 },
+    "product": { "type": "string", "minLength": 1 },
+    "surface": { "type": "string", "minLength": 1 },
+    "model": { "type": "object", "additionalProperties": false, "required": ["value", "status"], "properties": { "value": { "type": ["string", "null"] }, "status": { "type": "string", "enum": ["known", "UNKNOWN", "UNAVAILABLE", "NOT_DISCLOSED"] } } },
+    "prompt": { "type": "object", "additionalProperties": false, "required": ["prompt_id", "prompt_version", "prompt_text"], "properties": { "prompt_id": { "type": "string", "minLength": 1 }, "prompt_version": { "type": "integer", "minimum": 1 }, "prompt_text": { "type": "string", "minLength": 1 } } },
+    "prompt_set": { "type": "object", "additionalProperties": false, "required": ["prompt_set_id", "prompt_set_version"], "properties": { "prompt_set_id": { "type": "string", "minLength": 1 }, "prompt_set_version": { "type": "integer", "minimum": 1 } } },
+    "execution": { "type": "object", "additionalProperties": false, "required": ["executed_at", "configuration"], "properties": { "executed_at": { "type": "string", "format": "date-time" }, "configuration": { "type": "object", "additionalProperties": false, "required": ["id", "version"], "properties": { "id": { "type": "string", "minLength": 1 }, "version": { "type": "string", "minLength": 1 } } } } },
+    "response": { "type": "object", "additionalProperties": false, "required": ["status", "response_hash", "parser", "raw_response_retained"], "properties": { "status": { "type": "string", "enum": ["succeeded", "refused", "error", "timeout", "rate_limited", "malformed", "unavailable", "parser_failed"] }, "response_hash": { "type": ["string", "null"], "pattern": "^[a-f0-9]{64}$" }, "parser": { "type": "object", "additionalProperties": false, "required": ["id", "version"], "properties": { "id": { "type": "string", "minLength": 1 }, "version": { "type": "string", "minLength": 1 } } }, "raw_response_retained": { "type": "boolean" }, "provider_metadata": { "type": "object" } } },
+    "representation": { "type": "object", "additionalProperties": false, "required": ["brand_mentioned", "domain_mentioned", "domain_cited", "cited_urls", "mentioned_entities", "cited_domains"], "properties": { "brand_mentioned": { "type": ["boolean", "null"] }, "domain_mentioned": { "type": ["boolean", "null"] }, "domain_cited": { "type": ["boolean", "null"] }, "cited_urls": { "type": "array", "items": { "type": "string", "format": "uri" } }, "mentioned_entities": { "type": "array", "items": { "type": "string" } }, "cited_domains": { "type": "array", "items": { "type": "string" } } } },
+    "evidence_origin": { "type": "string", "enum": ["LIVE_PROVIDER", "RECORDED_FIXTURE", "SYNTHETIC_TEST"] },
+    "limitations": { "type": "array", "items": { "type": "string" } }
+  }
+}