@nebulacomponents/citable 1.20.0 → 1.22.0

package/dist/universal/.opencode/skills/citable/manifest.json

@@ -1,11 +1,11 @@
 {
   "name": "citable",
-  "version": "1.20.0",
+  "version": "1.22.0",
   "managedBy": "citable-cli",
   "provider": "opencode",
   "providerName": "OpenCode",
   "scope": "bundle",
-  "sourcePackage": "@nebulacomponents/citable@1.20.0",
+  "sourcePackage": "@nebulacomponents/citable@1.22.0",
   "variantPath": ".opencode/skills/citable",
   "agentProfiles": {
     "status": "unsupported",
@@ -65,10 +65,14 @@
     "schemas/browser-runtime-events.schema.json": "sha256:ff9b6e486ca5a72a6613a4e3e479cd11bcadff52c7481df125aa1670f404a7e4",
     "schemas/browser-state-observations.schema.json": "sha256:7748b9ed7110834e19c1827bd125c0d0cdb50e2dd89a713da03cd643e9c72843",
     "schemas/canonical-index-import.schema.json": "sha256:ef633662cb30873242ca356443bc4835afe56bb020208e8f42fa47ac8047b66e",
+    "schemas/citation-provenance.schema.json": "sha256:7d964c030c39dd81bfcd113b9712e9b025882af4e3d16660f7005d58a5c9a4aa",
+    "schemas/claim-evidence.schema.json": "sha256:524b4b8d47d58a7c75e5369e9bad55feaaa282c31076631d5f2517ae1328e1cb",
+    "schemas/claim-verification.schema.json": "sha256:dc9f5bd2af09fad6fdc40e9e63814825350b74d67b33fd3ed241190e983e91b1",
     "schemas/claim.schema.json": "sha256:ce79ccbfa34ece9b7a309a6962522ea06a1f44c468b4c472b5c376554a788537",
     "schemas/cli-output-envelope.schema.json": "sha256:6964e8f2f43618bfd0d7a3f5344b37ebc26f04779796bb8ff4675b935b6208c3",
     "schemas/collection-result.schema.json": "sha256:d844aa183300abf220030f6a000f297195a06c02f2cd3a4f15a399e317b8c5d8",
     "schemas/common.defs.json": "sha256:ac66081df6b86f652e066ea868edecfcd36cdd1b1c81e55a1e3af880f671b727",
+    "schemas/competitor-representation.schema.json": "sha256:c90ce92c3c313ef817753e9eec66f0a059bce7f7795643edaf54120aa274b48b",
     "schemas/competitor.schema.json": "sha256:2f6fd7e4543846bde56ff4dc62bb41fa366889787b794a7cdb0bff1a3392e591",
     "schemas/config.schema.json": "sha256:da40fe568844a6303d265f83058fce9f4a9a569cd72b271bc219361c71e8e8fa",
     "schemas/connection.schema.json": "sha256:abcedde8d62d0c0663d4f959e06132a617908058ed965078965445ef3b108310",
@@ -80,6 +84,7 @@
     "schemas/customer-outcome.schema.json": "sha256:c0cdfee31a692feadb31dc6be734d45ae178ee53f28349c2a9e7504bdfcf9e50",
     "schemas/decision.schema.json": "sha256:7c30f3ad83a6aa0b67ecc51ac6691e5e041b633d01bab17cee2b5218d926204e",
     "schemas/deployment-receipt.schema.json": "sha256:789455907e7f3039fd55ee5b2568e09871128f513f5ddfe1f3afac1a4dd6b2bd",
+    "schemas/derivation.schema.json": "sha256:89fe01a282cb58eb1c31a9354aae5fef884d6201e6610184dc423995bc37e42d",
     "schemas/detector-quality.schema.json": "sha256:5e9e1ac80b1198a0ff8fa17b9f7a543d3ccf3ed3d60196152f6ff095cfdebccd",
     "schemas/entity-graph.schema.json": "sha256:b9cc1312e3c7657d301e63c8dd302d79c7348f245ce3c324eeaa1e796720b74b",
     "schemas/entity.schema.json": "sha256:ce7cb7a0117a2fbd3032c9f244ab43855b47b285b81313513c3bb3287d37a33b",
@@ -87,6 +92,8 @@
     "schemas/evidence.schema.json": "sha256:76baec7ad7e89c6952473c01dacb9e3b26953c088331e6314d531ce620df9ec1",
     "schemas/exception.schema.json": "sha256:c88985494ec66554330fdc5b65d033527d0005acf41f10798b1e831d171f8944",
     "schemas/experiment.schema.json": "sha256:4b5d16481448597b152269296b67b5776be6f03d8f9afba1833bcee10bf3c05b",
+    "schemas/external-comparison.schema.json": "sha256:eecc356ac5696cc3f3b27062d35f084db0cd02cfd80eecfa2ea0024b3b5cfb3f",
+    "schemas/external-observation.schema.json": "sha256:960c1de406a11fc959c309932dd081a0d4273bcc3cd14db4f4e21c1125202fa9",
     "schemas/field-validation-metrics.schema.json": "sha256:bd5daeafc1593f1c4707d75180e1feb1e81d9345a57c1f269eadf13c36cb7012",
     "schemas/finding.schema.json": "sha256:06c0fc028288319828f124cea6791a7ad69a1bc3aa81c176604a83ca0f2da766",
     "schemas/fleet.schema.json": "sha256:3bf5772695ae4bb49a8c5fdbedee230ddb1d84aff6a3176eeb41527aca6ef2a5",
@@ -102,6 +109,7 @@
     "schemas/page.schema.json": "sha256:11d116b22ab79c152cfc7bbbec3a00cebe6dcd8ea2845b0ce819c15111fb0166",
     "schemas/project.schema.json": "sha256:ea48fdb6480f7047ba4594bd5908bc1f79c1ad6b9a2c204df900959b5f203dc6",
     "schemas/prompt-result.schema.json": "sha256:b55be47d7d58d7b1dd8c3b1e849e24e55216212c592cde7eb836953379b85737",
+    "schemas/prompt-set.schema.json": "sha256:0812b8a946aa2a81018e6bb51baf8a0fe0d99e23048d75d86f97b66a0b74c152",
     "schemas/prompt.schema.json": "sha256:7f0f50c83a86ac91faa7b79895dbc1fed371e8c0342e18d8c2877cc81f4f0f4c",
     "schemas/query.schema.json": "sha256:3c0793a8c0c48ab39320416790840b345ea987696f35b1cc364f23245a62aacb",
     "schemas/regional-network-import.schema.json": "sha256:9dc1062fbab9b98ccc485d605bb7e7d65d21449cccc17005251d4efea910fed0",
@@ -109,6 +117,9 @@
     "schemas/release-state.schema.json": "sha256:9920f68e538915d0d07044f313a9e410775a38ce9bb46a55d9ebe02970784803",
     "schemas/remediation-spec.schema.json": "sha256:6fe8cb773702862ba6d261198bb5cc2dca3eca0a2310a60ebddd04377654df8d",
     "schemas/remediation-verification.schema.json": "sha256:b56560b4f6fd82b9d3db4ad4f7fd0a0e4b289bfebf2e5a02e7c6727d5ba97291",
+    "schemas/representation-data.schema.json": "sha256:eef400570f073b49947d640790610e3bc980869d9eaeb1412bcff74a3385cda9",
+    "schemas/research-dataset.schema.json": "sha256:f69da3db9d3984e70e5cb3b92de7384c39ea5d10532ad5f5f5a0e5a2c0aa353e",
+    "schemas/response-span.schema.json": "sha256:36bd67e8a1ea8f7dce08e79fffefe2eaf5885e8bdf89985b0dbc6bc75098def3",
     "schemas/review-item.schema.json": "sha256:df532a70385d5031bbc18654f3ccb436dc6e8d402ccf987e58f8f7e3ad2fb3f1",
     "schemas/review-policy.schema.json": "sha256:b2d176b1886f78c384b25532a0c3eb18548dfbd17f362a305e622bab562a1d04",
     "schemas/reviewer.schema.json": "sha256:3716697b752575a1277f2c2b318b1f2565de02bf9dce2a0c165567ab5330d18b",
@@ -117,15 +128,17 @@
     "schemas/sampling-plan.schema.json": "sha256:005f70f149baaacd7de698548d556d3e401c630978748271b0e14a74726dd413",
     "schemas/scenario.schema.json": "sha256:3f5bc2032d08f973600db068f475176a0e4706b33be42f99c778fe755a0ff38b",
     "schemas/schedule.schema.json": "sha256:645df065bf33577a960c0bf8bb97e141e9326840303569468dae8a553d468482",
+    "schemas/search-discovery-data.schema.json": "sha256:23c45442c55f2a0b5a0b910da03641319a66d3b9b6811892fe30b2b3a9663b80",
     "schemas/search-report.schema.json": "sha256:d6e837580fdd53365e74d3d8b5101cd5a7d54b72f438155293aac399f676b176",
     "schemas/source-identity-chain.schema.json": "sha256:a65d9c12eaed1bd6b637c66a2f9362c17287fdfcb454d8676fb611d2d28aa019",
+    "schemas/source-retrieval.schema.json": "sha256:52112d98d01471cdb95f0e0f5ff5fa08b495c45037928e760b5c1a934224732a",
     "schemas/sow.schema.json": "sha256:3a3fd6048a747a9bc0cfaea98920376b043616a33c953a9eb8b74d0ae32dded0",
     "schemas/summary.schema.json": "sha256:0c9eb076fe992f351c3963728ba247a003648d8fe637b7cdd3016ba5842199c6",
     "schemas/variance.schema.json": "sha256:68389f64f0a3be13ff8951e8eefba9a5c31d0738325cb47e37c1a8435bea48f0",
     "scripts/README.md": "sha256:9eee4e8beb4579a183bd714c9dd24b83abd020753eada5caeffae004739d60b5",
-    "SKILL.md": "sha256:77d5647c556f0ba398bcb855c7307b004020a9fec0d9ef3b8e143173ccbfb756",
+    "SKILL.md": "sha256:2b7c674aa4f656d29bf13eaa85440b36a4da89b447331082b664ebf36f1a0da6",
     "templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
-    "VERSION": "sha256:26ac7beccb7951efb69255974ffc70a13bb2e68ae84dcb5456c3fb46294bdba8"
+    "VERSION": "sha256:a482aec6f30758f5ba391b686d1f33d8ef1ab78ac649da44307ae41eb5ecad43"
   },
-  "treeHash": "sha256:d2abaf43458900a402f054172a8c35811b99cab2272c7503d72ea01b7ed1285b"
+  "treeHash": "sha256:e24490d3f85a2d859bbf9f0ecc640303e89a8f39a3bc6c1d02de03d21ac9e70a"
 }

package/dist/universal/.opencode/skills/citable/schemas/citation-provenance.schema.json

@@ -0,0 +1,59 @@
+{
+  "$id": "citable://schemas/citation-provenance.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Provider citation provenance observation data",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["execution_reference", "response_reference", "provider", "span", "citation", "source", "retrieval", "proposition", "support"],
+  "properties": {
+    "execution_reference": { "type": "string", "minLength": 1 },
+    "response_reference": { "type": "string", "minLength": 1 },
+    "provider": { "type": "string", "minLength": 1 },
+    "span": { "$ref": "citable://schemas/response-span.schema.json" },
+    "citation": {
+      "type": "object", "additionalProperties": false,
+      "required": ["citation_id", "ordinal", "raw_marker", "placement", "displayed_title", "displayed_domain", "displayed_url"],
+      "properties": {
+        "citation_id": { "type": "string", "minLength": 1 },
+        "ordinal": { "type": "integer", "minimum": 1 },
+        "raw_marker": { "type": ["string", "null"] },
+        "placement": { "type": "string", "enum": ["inline", "footnote", "card", "source_list", "unknown"] },
+        "displayed_title": { "type": ["string", "null"] },
+        "displayed_domain": { "type": ["string", "null"] },
+        "displayed_url": { "type": ["string", "null"] }
+      }
+    },
+    "source": {
+      "type": "object", "additionalProperties": false,
+      "required": ["identity_status", "resolved_url", "redirect_chain", "canonical_url"],
+      "properties": {
+        "identity_status": { "type": "string", "enum": ["IDENTIFIED", "NOT_IDENTIFIED", "AMBIGUOUS"] },
+        "resolved_url": { "type": ["string", "null"], "format": "uri" },
+        "redirect_chain": { "type": "array", "items": { "type": "string", "format": "uri" } },
+        "canonical_url": { "type": ["string", "null"], "format": "uri" }
+      }
+    },
+    "retrieval": {
+      "type": "object", "additionalProperties": false,
+      "required": ["status", "observation_reference"],
+      "properties": {
+        "status": { "type": "string", "enum": ["NOT_ATTEMPTED", "ATTEMPTED", "SUCCEEDED", "FAILED", "INDETERMINATE"] },
+        "observation_reference": { "type": ["string", "null"] }
+      }
+    },
+    "proposition": {
+      "type": "object", "additionalProperties": false,
+      "required": ["proposition_id", "text"],
+      "properties": { "proposition_id": { "type": "string", "minLength": 1 }, "text": { "type": "string", "minLength": 1 } }
+    },
+    "support": {
+      "type": "object", "additionalProperties": false,
+      "required": ["relevance_status", "support_status", "evidence_references"],
+      "properties": {
+        "relevance_status": { "type": "string", "enum": ["NOT_ASSESSED", "RELEVANT", "IRRELEVANT", "INDETERMINATE"] },
+        "support_status": { "type": "string", "enum": ["NOT_ASSESSED", "SUPPORTED", "PARTIALLY_SUPPORTED", "UNSUPPORTED", "CONTRADICTED", "INDETERMINATE", "NOT_OBSERVED"] },
+        "evidence_references": { "type": "array", "items": { "type": "string" } }
+      }
+    }
+  }
+}

package/dist/universal/.opencode/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/.opencode/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/.opencode/skills/citable/schemas/competitor-representation.schema.json

@@ -0,0 +1,36 @@
+{
+  "$id": "citable://schemas/competitor-representation.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Competitor or peer representation observation data",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["execution_reference", "provider", "prompt_reference", "prompt_set_reference", "span", "entity", "representation", "citation_reference", "proposition_reference"],
+  "properties": {
+    "execution_reference": { "type": "string", "minLength": 1 },
+    "provider": { "type": "string", "minLength": 1 },
+    "prompt_reference": { "type": "string", "minLength": 1 },
+    "prompt_set_reference": { "type": "string", "minLength": 1 },
+    "span": { "$ref": "citable://schemas/response-span.schema.json" },
+    "entity": {
+      "type": "object", "additionalProperties": false,
+      "required": ["entity_id", "observed_name", "domain", "resolution_status", "resolution_method"],
+      "properties": {
+        "entity_id": { "type": ["string", "null"] },
+        "observed_name": { "type": "string", "minLength": 1 },
+        "domain": { "type": ["string", "null"] },
+        "resolution_status": { "type": "string", "enum": ["RESOLVED", "AMBIGUOUS", "UNRESOLVED", "NOT_OBSERVED"] },
+        "resolution_method": { "type": "string", "minLength": 1 }
+      }
+    },
+    "representation": {
+      "type": "object", "additionalProperties": false,
+      "required": ["type", "observed_text"],
+      "properties": {
+        "type": { "type": "string", "enum": ["MENTION", "COMPARISON", "ALTERNATIVE", "RECOMMENDATION", "CITED_SOURCE", "CATEGORY_PEER"] },
+        "observed_text": { "type": "string", "minLength": 1 }
+      }
+    },
+    "citation_reference": { "type": ["string", "null"] },
+    "proposition_reference": { "type": ["string", "null"] }
+  }
+}

package/dist/universal/.opencode/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/.opencode/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/.opencode/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/.opencode/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/.opencode/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" } }
+  }
+}

package/dist/universal/.opencode/skills/citable/schemas/research-dataset.schema.json

@@ -0,0 +1,27 @@
+{
+  "$id": "citable://schemas/research-dataset.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Immutable research dataset",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["dataset_id", "dataset_version", "declared_purpose", "declared_population", "population_size", "inclusion_criteria", "exclusion_criteria", "collection", "source_references", "observation_references", "normalization", "derivation_references", "coverage", "coverage_status", "limitations", "dataset_hash"],
+  "properties": {
+    "dataset_id": { "type": "string", "minLength": 1 },
+    "dataset_version": { "type": "integer", "minimum": 1 },
+    "declared_purpose": { "type": "string", "minLength": 1 },
+    "declared_population": { "type": "object", "additionalProperties": false, "required": ["type", "id"], "properties": { "type": { "type": "string", "minLength": 1 }, "id": { "type": "string", "minLength": 1 }, "size": { "type": ["integer", "null"], "minimum": 0 } } },
+    "population_size": { "type": ["integer", "null"], "minimum": 0 },
+    "inclusion_criteria": { "type": "array", "items": { "type": "string" } },
+    "exclusion_criteria": { "type": "array", "items": { "type": "string" } },
+    "collection": { "type": "object", "additionalProperties": false, "required": ["started_at", "ended_at"], "properties": { "started_at": { "type": "string", "format": "date-time" }, "ended_at": { "type": "string", "format": "date-time" } } },
+    "source_references": { "type": "array", "items": { "type": "string" } },
+    "source_retrieval_timestamps": { "type": "array", "items": { "type": "string", "format": "date-time" } },
+    "observation_references": { "type": "array", "items": { "type": "string" } },
+    "normalization": { "type": "object", "additionalProperties": false, "required": ["method", "version"], "properties": { "method": { "type": "string", "minLength": 1 }, "version": { "type": "string", "minLength": 1 } } },
+    "derivation_references": { "type": "array", "items": { "type": "string" } },
+    "coverage": { "type": "object", "additionalProperties": false, "required": ["declared", "retrieved", "evaluated", "unavailable", "failed"], "properties": { "declared": { "type": "integer", "minimum": 0 }, "retrieved": { "type": "integer", "minimum": 0 }, "evaluated": { "type": "integer", "minimum": 0 }, "unavailable": { "type": "integer", "minimum": 0 }, "failed": { "type": "integer", "minimum": 0 } } },
+    "coverage_status": { "type": "string", "enum": ["complete_for_declared_population", "partial", "truncated", "indeterminate", "error"] },
+    "limitations": { "type": "array", "items": { "type": "string" } },
+    "dataset_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+  }
+}

package/dist/universal/.opencode/skills/citable/schemas/response-span.schema.json

@@ -0,0 +1,16 @@
+{
+  "$id": "citable://schemas/response-span.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Immutable provider response span",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["span_id", "execution_reference", "start", "end", "text", "text_hash"],
+  "properties": {
+    "span_id": { "type": "string", "minLength": 1 },
+    "execution_reference": { "type": "string", "minLength": 1 },
+    "start": { "type": "integer", "minimum": 0 },
+    "end": { "type": "integer", "minimum": 0 },
+    "text": { "type": "string" },
+    "text_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+  }
+}

package/dist/universal/.opencode/skills/citable/schemas/search-discovery-data.schema.json

@@ -0,0 +1,20 @@
+{
+  "$id": "citable://schemas/search-discovery-data.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Search discovery observation data",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["query", "page", "interval", "metrics", "request", "coverage_status", "evidence_origin"],
+  "properties": {
+    "query": { "type": ["string", "null"] },
+    "page": { "type": ["string", "null"], "format": "uri" },
+    "interval": { "type": "object", "additionalProperties": false, "required": ["start_date", "end_date"], "properties": { "start_date": { "type": "string", "format": "date" }, "end_date": { "type": "string", "format": "date" } } },
+    "metrics": { "type": "object", "additionalProperties": false, "required": ["impressions", "clicks", "ctr", "average_position"], "properties": { "impressions": { "type": ["number", "null"], "minimum": 0 }, "clicks": { "type": ["number", "null"], "minimum": 0 }, "ctr": { "type": ["number", "null"], "minimum": 0 }, "average_position": { "type": ["number", "null"], "minimum": 0 } } },
+    "dimensions": { "type": "object", "additionalProperties": false, "properties": { "country": { "type": ["string", "null"] }, "device": { "type": ["string", "null"] }, "search_appearance": { "type": ["string", "null"] }, "date": { "type": ["string", "null"], "format": "date" } } },
+    "request": { "type": "object", "additionalProperties": false, "required": ["property_id", "dimensions", "filters", "row_limit"], "properties": { "property_id": { "type": "string", "minLength": 1 }, "dimensions": { "type": "array", "items": { "type": "string" } }, "filters": { "type": "object" }, "row_limit": { "type": "integer", "minimum": 1, "maximum": 25000 } } },
+    "provider_reported": { "type": "object", "additionalProperties": false, "properties": { "row_count": { "type": ["integer", "null"], "minimum": 0 }, "page_start": { "type": "integer", "minimum": 0 } } },
+    "response_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "coverage_status": { "type": "string", "enum": ["complete", "truncated", "indeterminate", "provider_bounded"] },
+    "evidence_origin": { "type": "string", "enum": ["LIVE_PROVIDER", "RECORDED_FIXTURE", "SYNTHETIC_TEST"] }
+  }
+}

package/dist/universal/.opencode/skills/citable/schemas/source-retrieval.schema.json

@@ -0,0 +1,41 @@
+{
+  "$id": "citable://schemas/source-retrieval.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Retrieved citation source observation data",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["citation_reference", "url", "retrieval", "content", "relevance"],
+  "properties": {
+    "citation_reference": { "type": "string", "minLength": 1 },
+    "url": { "type": "string", "format": "uri" },
+    "retrieval": {
+      "type": "object", "additionalProperties": false,
+      "required": ["status", "attempted_at", "final_url", "redirect_chain", "http_status"],
+      "properties": {
+        "status": { "type": "string", "enum": ["SUCCEEDED", "FAILED", "INDETERMINATE"] },
+        "attempted_at": { "type": "string", "format": "date-time" },
+        "final_url": { "type": ["string", "null"], "format": "uri" },
+        "redirect_chain": { "type": "array", "items": { "type": "string", "format": "uri" } },
+        "http_status": { "type": ["integer", "null"], "minimum": 100, "maximum": 599 }
+      }
+    },
+    "content": {
+      "type": "object", "additionalProperties": false,
+      "required": ["observed", "content_hash", "raw_retained"],
+      "properties": {
+        "observed": { "type": "boolean" },
+        "content_hash": { "type": ["string", "null"], "pattern": "^[a-f0-9]{64}$" },
+        "raw_retained": { "type": "boolean" }
+      }
+    },
+    "relevance": {
+      "type": "object", "additionalProperties": false,
+      "required": ["status", "support_status", "evidence_references"],
+      "properties": {
+        "status": { "type": "string", "enum": ["NOT_ASSESSED", "RELEVANT", "IRRELEVANT", "INDETERMINATE"] },
+        "support_status": { "type": "string", "enum": ["NOT_ASSESSED", "SUPPORTED", "PARTIALLY_SUPPORTED", "UNSUPPORTED", "CONTRADICTED", "INDETERMINATE", "NOT_OBSERVED"] },
+        "evidence_references": { "type": "array", "items": { "type": "string" } }
+      }
+    }
+  }
+}

package/dist/universal/.pi/agent/skills/citable/SKILL.md

@@ -7,7 +7,7 @@ description: >
   generative engine optimization, structured data governance, claim substantiation,
   crawler policy, entity consistency, content discoverability, or wants a site audited
   for how search and AI systems will retrieve, understand, cite, or recommend it.
-version: 1.20.0
+version: 1.22.0
 ---
 
 # Citable — evidence and change control for search and AI citation readiness

package/dist/universal/.pi/agent/skills/citable/VERSION

@@ -1 +1 @@
-1.20.0
+1.22.0