@nebulacomponents/citable 1.21.0 → 1.22.0

package/CHANGELOG.md

@@ -15,6 +15,31 @@ _No entries yet. See [`BOUNTY.md`](BOUNTY.md) to submit the first one._
 
 ## Unreleased
 
+## 1.22.0 — 2026-09-21
+
+### Added — Citation provenance and competitor representation evidence
+
+- Added immutable response-span and citation-provenance observations that
+  preserve raw provider citation markers, displayed and resolved source
+  identities, retrieval state, and proposition-level evidence lineage.
+- Added source-retrieval observations that distinguish citation presence,
+  source identity, retrieval, relevance, and proposition support rather than
+  treating citations as proof.
+- Extended bounded claim verification and longitudinal comparability to
+  citation-backed provider representations, including multi-proposition
+  responses and non-evaluable executions.
+- Added provider-neutral competitor and peer representation observations with
+  explicit entity ambiguity, representation type, prompt/provider/execution
+  lineage, and citation relationships.
+- Added deterministic adversarial coverage for citation ambiguity, partial and
+  contradictory support, tracking URLs, failed retrieval, execution
+  interstitials, entity ambiguity, tampered lineage, and bounded prevalence.
+
+These capabilities preserve evidence boundaries; they do not provide live
+provider collection, universal competitor intelligence, AI visibility scoring,
+autonomous content generation or publishing, strategic recommendations,
+backlink capabilities, a public agent API, or Nebula runtime integration.
+
 ## 1.21.0 — 2026-09-21
 
 ### Added — External evidence, discovery, and representation observations

package/dist/universal/.agents/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.21.0
+version: 1.22.0
 ---
 
 # Citable — evidence and change control for search and AI citation readiness

package/dist/universal/.agents/skills/citable/VERSION

@@ -1 +1 @@
-1.21.0
+1.22.0

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

@@ -1,11 +1,11 @@
 {
   "name": "citable",
-  "version": "1.21.0",
+  "version": "1.22.0",
   "managedBy": "citable-cli",
   "provider": "codex",
   "providerName": "OpenAI Codex",
   "scope": "bundle",
-  "sourcePackage": "@nebulacomponents/citable@1.21.0",
+  "sourcePackage": "@nebulacomponents/citable@1.22.0",
   "variantPath": ".agents/skills/citable",
   "agentProfiles": {
     "status": "unsupported",
@@ -65,12 +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",
@@ -117,6 +119,7 @@
     "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",
@@ -128,13 +131,14 @@
     "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:4a7e19382de8b39544c392defedb3eee189404f7ba79932c9b13bb0426743def",
+    "SKILL.md": "sha256:2b7c674aa4f656d29bf13eaa85440b36a4da89b447331082b664ebf36f1a0da6",
     "templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
-    "VERSION": "sha256:65a6bd97a4a6b72911ae6c3d45991f4326c95f792e196f8bf74857a557b27585"
+    "VERSION": "sha256:a482aec6f30758f5ba391b686d1f33d8ef1ab78ac649da44307ae41eb5ecad43"
   },
-  "treeHash": "sha256:ee414162970cefa47e9b417814c0611133618987449c16027607d679f451bdb9"
+  "treeHash": "sha256:e24490d3f85a2d859bbf9f0ecc640303e89a8f39a3bc6c1d02de03d21ac9e70a"
 }

package/dist/universal/.agents/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/.agents/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/.agents/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/.agents/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/.claude/agents/citable/manifest.json

@@ -1,9 +1,9 @@
 {
   "name": "citable-agent-profiles",
-  "version": "1.21.0",
+  "version": "1.22.0",
   "managedBy": "citable-cli",
   "provider": "claude",
-  "sourcePackage": "@nebulacomponents/citable@1.21.0",
+  "sourcePackage": "@nebulacomponents/citable@1.22.0",
   "files": {
     "citable-auditor.md": "sha256:06fe8d84834b2c09b7e7083aa6f57e94e837e0643dbe4ead4bbecf651fb41cad",
     "citable-remediator.md": "sha256:c990e929f411fc2f2de3aca759333502c956e96924b3a0f809ab0927062623dc",

package/dist/universal/.claude/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.21.0
+version: 1.22.0
 ---
 
 # Citable — evidence and change control for search and AI citation readiness

package/dist/universal/.claude/skills/citable/VERSION

@@ -1 +1 @@
-1.21.0
+1.22.0

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

@@ -1,11 +1,11 @@
 {
   "name": "citable",
-  "version": "1.21.0",
+  "version": "1.22.0",
   "managedBy": "citable-cli",
   "provider": "claude",
   "providerName": "Claude Code",
   "scope": "bundle",
-  "sourcePackage": "@nebulacomponents/citable@1.21.0",
+  "sourcePackage": "@nebulacomponents/citable@1.22.0",
   "variantPath": ".claude/skills/citable",
   "agentProfiles": {
     "status": "available",
@@ -72,12 +72,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",
@@ -124,6 +126,7 @@
     "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",
@@ -135,13 +138,14 @@
     "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:4a7e19382de8b39544c392defedb3eee189404f7ba79932c9b13bb0426743def",
+    "SKILL.md": "sha256:2b7c674aa4f656d29bf13eaa85440b36a4da89b447331082b664ebf36f1a0da6",
     "templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
-    "VERSION": "sha256:65a6bd97a4a6b72911ae6c3d45991f4326c95f792e196f8bf74857a557b27585"
+    "VERSION": "sha256:a482aec6f30758f5ba391b686d1f33d8ef1ab78ac649da44307ae41eb5ecad43"
   },
-  "treeHash": "sha256:ee414162970cefa47e9b417814c0611133618987449c16027607d679f451bdb9"
+  "treeHash": "sha256:e24490d3f85a2d859bbf9f0ecc640303e89a8f39a3bc6c1d02de03d21ac9e70a"
 }

package/dist/universal/.claude/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/.claude/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/.claude/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/.claude/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/.cursor/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.21.0
+version: 1.22.0
 ---
 
 # Citable — evidence and change control for search and AI citation readiness

package/dist/universal/.cursor/skills/citable/VERSION

@@ -1 +1 @@
-1.21.0
+1.22.0

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

@@ -1,11 +1,11 @@
 {
   "name": "citable",
-  "version": "1.21.0",
+  "version": "1.22.0",
   "managedBy": "citable-cli",
   "provider": "cursor",
   "providerName": "Cursor",
   "scope": "bundle",
-  "sourcePackage": "@nebulacomponents/citable@1.21.0",
+  "sourcePackage": "@nebulacomponents/citable@1.22.0",
   "variantPath": ".cursor/skills/citable",
   "agentProfiles": {
     "status": "unsupported",
@@ -65,12 +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",
@@ -117,6 +119,7 @@
     "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",
@@ -128,13 +131,14 @@
     "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:4a7e19382de8b39544c392defedb3eee189404f7ba79932c9b13bb0426743def",
+    "SKILL.md": "sha256:2b7c674aa4f656d29bf13eaa85440b36a4da89b447331082b664ebf36f1a0da6",
     "templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
-    "VERSION": "sha256:65a6bd97a4a6b72911ae6c3d45991f4326c95f792e196f8bf74857a557b27585"
+    "VERSION": "sha256:a482aec6f30758f5ba391b686d1f33d8ef1ab78ac649da44307ae41eb5ecad43"
   },
-  "treeHash": "sha256:ee414162970cefa47e9b417814c0611133618987449c16027607d679f451bdb9"
+  "treeHash": "sha256:e24490d3f85a2d859bbf9f0ecc640303e89a8f39a3bc6c1d02de03d21ac9e70a"
 }