@nebulacomponents/citable 1.13.0 → 1.14.0

package/dist/universal/.pi/agent/skills/citable/commands/observe-and-act.md

@@ -19,22 +19,69 @@ failure_behaviour: unavailable dependency, credential, source run, reviewer, exa
   browser version, device, JavaScript, locale, consent, authentication state,
   and ordered interaction steps. Fill/select values are referenced by
   environment-variable name and are never written to the plan or artifacts.
+  Targets, subresources, and navigation steps must remain on public network
+  destinations; unsupported schemes and configured non-public address ranges
+  are blocked. DNS validation does not pin the later browser connection, so
+  isolated execution with egress controls remains required for untrusted URLs.
+  Plans may include a strict semantic-impact policy covering text retention,
+  heading, link, and structured-data parity. Deterministic violations name a
+  review owner and always remain `review_required`; passing configured checks
+  does not establish semantic or retrieval equivalence.
 - `observe index --input <JSON>` imports owner exports. With `--target`,
   `--site-url`, and `GSC_ACCESS_TOKEN`, it calls Google URL Inspection, which
   reports the indexed version rather than performing a live indexability test.
 - `observe citations --input <JSON>` imports complete controlled observations.
   With `--endpoint`, the input is a versioned prompt corpus and each prompt runs
   1-20 times (default 3) through the disclosed adapter protocol. An API is not
-  presumed equivalent to a provider's consumer search experience.
+  presumed equivalent to a provider's consumer search experience. Adapter
+  endpoints require HTTPS, must resolve only to public destinations, and may
+  not redirect.
+  Citation objects may include a strict `source_profile` containing declared
+  format, word and heading counts, freshness date, and evidence features.
+  Competitive summaries group these profiles by cited domain. Imported profile
+  values are comparative metadata, not independently fetched or verified
+  qualities.
 - `observe logs --input <JSON>` imports server/CDN records. User-agent matches
   without IP verification remain low confidence.
+- `observe probes --target <URL> [--region <label>]` sends one bounded synthetic
+  request for every active identity in `crawlers.yaml`, preserving response
+  bodies, safe diagnostic headers, redirects, and coarse edge/challenge
+  classification. The request merely spoofs each declared user agent: it does
+  not establish crawler identity, production access, regional
+  representativeness, or alignment between declared policy and actual crawler
+  treatment.
+- `observe network --input <JSON>` accepts a strict regional runner export with
+  region, network, user agent, DNS answers, TLS authorization/fingerprint,
+  status, latency, and cache state for every probe. Citable validates and seals
+  these observations but does not operate the runner or infer global coverage.
 - `observe passages|consensus --target <dir|URL>` performs static extraction.
+  Passage observations include raw/extracted byte and visible-token ratios plus
+  exact repeated header, navigation, aside, and footer regions across the
+  audited page cohort. These classifications are descriptive and do not imply
+  content harm, retrieval effects, or ranking effects.
+  Versioned passage records also join declared page prompts, questions, and
+  expected answer components. This only creates review context:
+  question-to-passage suitability remains `review_required`.
+  Consensus normalizes parseable HTTP, sitemap, and visible/meta freshness
+  dates, preserves conflicts and invalid values, and compares the current
+  content hash with the latest immutable page snapshot. A detected hash change
+  establishes only an interval after the prior capture—not an exact change
+  time, cause, quality improvement, or ranking effect. Lifecycle review dates
+  remain a separate governance signal.
+  `observe consensus --input <canonical-index-import.json>` additionally joins
+  schema-validated engine-selected canonical observations while preserving
+  their collection authority and authenticity. Missing engine observations
+  remain `null`; they are never inferred from static declarations.
 - `observe performance` imports evidence or calls CrUX with `CRUX_API_KEY`.
   `--lighthouse` instead performs 1-5 local lab runs (default 3) using optional
   `lighthouse` and `chrome-launcher` peers, preserving each result and a median
   summary. Lab evidence remains separate from CrUX field evidence.
-- `observe corroboration --input <JSON>` records observable external mentions;
-  controlled or unverified sources do not become authority claims.
+- `observe corroboration --input <JSON>` accepts only the versioned
+  `corroboration-import` contract. Each mention must disclose source control,
+  relationship, collection authority, authenticity, and dataset coverage.
+  Legacy independence booleans and undisclosed control fail closed. An
+  observable mention does not establish source authority, claim support,
+  ranking impact, citation eligibility, or representative coverage.
 
 ## Guarded remediation
 

package/dist/universal/.pi/agent/skills/citable/commands/plan-audit.md

@@ -0,0 +1,35 @@
+---
+command: /citable plan-audit --target <dir|url>
+purpose: Inspect observable target signals and propose an evidence-bounded audit and collector plan without creating a run or treating inferred business profiles as facts.
+preconditions: [readable built output directory or permitted public URL]
+artifacts_created: []
+failure_behaviour: missing or unreadable target -> fail; fewer than two supporting signals -> no profile established; unavailable optional prerequisite -> collector blocked
+---
+
+# Profile-aware audit planning
+
+1. Run `citable plan-audit --target <dir|url>` before choosing optional
+   collectors. The command builds the same bounded site model used by audit but
+   does not create an audit, observation, snapshot, or remediation artifact.
+2. Treat every returned profile as `probabilistic_inference`. Preserve its
+   confidence and evidence list. A profile changes semantic emphasis only; it
+   does not suppress detectors or establish the target's business model.
+3. Use the proposed full audit as the deterministic baseline. Do not translate
+   an inferred profile into a reduced audit that could hide cross-discipline
+   findings.
+4. Read collector states independently. `available` means the prerequisite is
+   present, not that browser launch, authorization, property access, quota, or
+   collection will succeed. `blocked` lists the missing input and remains
+   unresolved until the relevant collector produces evidence.
+5. Keep profile-specific emphasis bounded:
+   SaaS focuses review on pricing, capability claims, and product identity;
+   e-commerce on product/offer support; local on identity/NAP and review
+   evidence; publisher on authorship/freshness; multilingual on hreflang and
+   parity; API/docs on machine interfaces and authentication claims.
+
+# Refusal boundary
+
+Do not invent an industry, customer segment, locale strategy, product catalog,
+local presence, or API capability to complete the plan. If no profile reaches
+the two-signal threshold, report that none is established and run the full
+audit without profile-specific emphasis.

package/dist/universal/.pi/agent/skills/citable/manifest.json

@@ -1,14 +1,20 @@
 {
   "name": "citable",
-  "version": "1.13.0",
+  "version": "1.14.0",
   "managedBy": "citable-cli",
   "provider": "pi",
   "providerName": "Pi",
   "scope": "bundle",
-  "sourcePackage": "@nebulacomponents/citable@1.13.0",
+  "sourcePackage": "@nebulacomponents/citable@1.14.0",
   "variantPath": ".pi/agent/skills/citable",
+  "agentProfiles": {
+    "status": "unsupported",
+    "reason": "native agent profile discovery and permission contract not verified for this host"
+  },
   "files": {
-    "commands/action-findings.md": "sha256:510361461f24fcd4a550e0a8d960c383aefe23f9a65a54a3ffc44abd4c1293e7",
+    "agents/citable-auditor.md": "sha256:06fe8d84834b2c09b7e7083aa6f57e94e837e0643dbe4ead4bbecf651fb41cad",
+    "agents/citable-semantic-reviewer.md": "sha256:77582263a048ea41ae3f7ee326dbd036222fab81ed83bda98034ec83ee21ef2e",
+    "commands/action-findings.md": "sha256:b1d5c4d8d8b1092bc73b99430bea0a2e460031658e42bed33eb94da9a3c0e48f",
     "commands/artifact-interchange.md": "sha256:18d56fbfa6bb3f23f08593a9a8135e51c268618b049e53c793969b68000875c3",
     "commands/delivery.md": "sha256:3b29250f9e9f84442812e320a70d5d2784b4286e91af3866f99cb6062a85a10f",
     "commands/field-validation.md": "sha256:4f24b2758eef746d704b218364f1e45ee9e07418c8ae111081b1fd41f93dde2d",
@@ -16,9 +22,10 @@
     "commands/ingest.md": "sha256:cf35659aecd9d0e160909003efdbe056864fc5d824c71b4ef0ee801ce07ff598",
     "commands/measurement.md": "sha256:9cade6dfec23338e18aa67ede3335ac9e2888dc577a7d4d8e3ceac948bce403f",
     "commands/media-evidence.md": "sha256:f2218feabe3360a2c9d569a5fa9b70d4b33a83a270d657151635e6f404fb34e0",
-    "commands/observe-and-act.md": "sha256:3862708da9d787d61a9c7bc8639b2fb28bc021d5784e11f313b0e9ecdff261bc",
+    "commands/observe-and-act.md": "sha256:847d35aa6cd5b32dea4cd82fd4a5e84343676fd7e45c5e3a10393a00f6b288a7",
     "commands/optimize-page.md": "sha256:35866f3d7cdeef0376ea7a7d7036085a9b9cf95bbb300ecf4bd77610ebd74d85",
     "commands/page-work.md": "sha256:965a66e59bdf7b0da482d26fade53b3d265885ece5d463fe83b0789ebefaef3e",
+    "commands/plan-audit.md": "sha256:69875c9654e13b84566dafb16afe5afe08cffb9f3bded1f2d8d2261ae871c869",
     "commands/README.md": "sha256:c27f69e0e33712e00f780c0988c7b033650c17d3450baea33f2b14212be8438e",
     "commands/reviews.md": "sha256:902904aaa405fe5724cf0662c7a5a36eab9a4fe0eb81cbd95ffa2fff946e0ac8",
     "commands/validate-render.md": "sha256:a8e1d04d40b84d57c35039250d98c6a7302cd44a148a8c3b9d9cfb92678c4347",
@@ -43,24 +50,27 @@
     "schemas/acceptance-corpus.schema.json": "sha256:b703be371ee33747d83814e448d18cd01f103f1832480a95df4331b86982165d",
     "schemas/acceptance-run-context.schema.json": "sha256:56d75c7bcd166c3578a71699df1aa5466327c23c1e06e33773f2493f5caa1a50",
     "schemas/acceptance-run-receipt.schema.json": "sha256:6c6e66767cf3b9adb42ace087f7e9a428312f41b7ecbaf533fc8d7ba5953da44",
-    "schemas/action-plan.schema.json": "sha256:4b6c4c877840a065c7c0c0c7b52f696502bf3d4ca6d31179622fc364ea868d5e",
+    "schemas/action-plan.schema.json": "sha256:e2ca871c92595a55ac56248cd87df67d94449ac39ac216e60751baaec5b74f1e",
     "schemas/artifact-interchange.schema.json": "sha256:c6f628934c8a1b8ea2996e03c2c5abd46c2a0e74c680b0a43e44c2343dc9aa21",
     "schemas/assumption.schema.json": "sha256:31a0f44bbf1d207e013961ec4c39eea85c3ae9efde1485b5e26084562c816844",
     "schemas/bing-webmaster.schema.json": "sha256:8357c518a8cb4ccd1def2da38950fbba68270e2b1613ad522b50c568a3b8538f",
-    "schemas/browser-evidence-plan.schema.json": "sha256:f2c1a3fe05cdaf72a41c0a3d548ccf5bdf247dbe71b546759b15277df0e723ba",
+    "schemas/browser-evidence-plan.schema.json": "sha256:81ef14f665b4a00f01afb747576faeb06025722e5c15a36eff3d17e59e978851",
+    "schemas/canonical-index-import.schema.json": "sha256:ef633662cb30873242ca356443bc4835afe56bb020208e8f42fa47ac8047b66e",
     "schemas/claim.schema.json": "sha256:ce79ccbfa34ece9b7a309a6962522ea06a1f44c468b4c472b5c376554a788537",
-    "schemas/common.defs.json": "sha256:effdd812910d1c275c50520bb70d8aec085e53fa8cb68054dc58c04a5d4a66b3",
+    "schemas/common.defs.json": "sha256:ac66081df6b86f652e066ea868edecfcd36cdd1b1c81e55a1e3af880f671b727",
     "schemas/competitor.schema.json": "sha256:2f6fd7e4543846bde56ff4dc62bb41fa366889787b794a7cdb0bff1a3392e591",
     "schemas/config.schema.json": "sha256:a87f3bb0087de09035b9f2dafea66e32e4fcc2e3e329abcd0fd8a5ec33318f2a",
     "schemas/connection.schema.json": "sha256:abcedde8d62d0c0663d4f959e06132a617908058ed965078965445ef3b108310",
     "schemas/corpus-publication-receipt.schema.json": "sha256:a4d523fd1c1fa53762522891c06c06edb668cd15e1de3c7123d2b9948445ae32",
+    "schemas/corroboration-import.schema.json": "sha256:927983d0590f1ec569e86195d2031be0cd212f9436ff98acca468cbae108d85e",
     "schemas/crawler-identity.schema.json": "sha256:e1e3e6da203a8bc49fba8f9bbde525368891db022d542fc615b677401825351d",
     "schemas/crawler.schema.json": "sha256:1a113dfb80bc6cde904c3ea648c82ea1d88fe50f2c1a0e7175d44abba28ac64e",
     "schemas/customer-outcome.schema.json": "sha256:c0cdfee31a692feadb31dc6be734d45ae178ee53f28349c2a9e7504bdfcf9e50",
     "schemas/decision.schema.json": "sha256:7c30f3ad83a6aa0b67ecc51ac6691e5e041b633d01bab17cee2b5218d926204e",
     "schemas/deployment-receipt.schema.json": "sha256:789455907e7f3039fd55ee5b2568e09871128f513f5ddfe1f3afac1a4dd6b2bd",
     "schemas/detector-quality.schema.json": "sha256:5e9e1ac80b1198a0ff8fa17b9f7a543d3ccf3ed3d60196152f6ff095cfdebccd",
-    "schemas/entity.schema.json": "sha256:78a08c35c8f4eb7a804ab46b61a238502f59621ac5218991e783251fbde61c4f",
+    "schemas/entity-graph.schema.json": "sha256:b9cc1312e3c7657d301e63c8dd302d79c7348f245ce3c324eeaa1e796720b74b",
+    "schemas/entity.schema.json": "sha256:ce7cb7a0117a2fbd3032c9f244ab43855b47b285b81313513c3bb3287d37a33b",
     "schemas/evidence-authority.schema.json": "sha256:4f8165a37304ebab019e1c2dfec13f1168ecf89ce9bec88f7dca9c8554e39ac0",
     "schemas/evidence.schema.json": "sha256:76baec7ad7e89c6952473c01dacb9e3b26953c088331e6314d531ce620df9ec1",
     "schemas/exception.schema.json": "sha256:c88985494ec66554330fdc5b65d033527d0005acf41f10798b1e831d171f8944",
@@ -73,12 +83,13 @@
     "schemas/media-manifest.schema.json": "sha256:3f37301aab9e913fa7febb15c720ed6384b106f12cef8d26cdd12d93fd85b41f",
     "schemas/metric.schema.json": "sha256:2ada648e7274a8d78cc9d6e7ed616f91faa79cf9ed07613e2c1fc53b247aac8d",
     "schemas/objective.schema.json": "sha256:94404dc95d04a6641ea7b9654317d0222793251ad44d3dfd2875738622a36025",
-    "schemas/observation.schema.json": "sha256:b572ae8ba3d175509cc9fae914d8d054c0fb84ebcaf81de981532b527064538d",
-    "schemas/page.schema.json": "sha256:627613c35f461177fa946df08edf66fbf6f6bbdfc57eef812572b3af796d5e07",
+    "schemas/observation.schema.json": "sha256:bdf0c16230d3666e9dba8f9110d45944e5f7e94c37ac51e483a879628c30ce77",
+    "schemas/page.schema.json": "sha256:11d116b22ab79c152cfc7bbbec3a00cebe6dcd8ea2845b0ce819c15111fb0166",
     "schemas/project.schema.json": "sha256:ea48fdb6480f7047ba4594bd5908bc1f79c1ad6b9a2c204df900959b5f203dc6",
     "schemas/prompt-result.schema.json": "sha256:b55be47d7d58d7b1dd8c3b1e849e24e55216212c592cde7eb836953379b85737",
     "schemas/prompt.schema.json": "sha256:7f0f50c83a86ac91faa7b79895dbc1fed371e8c0342e18d8c2877cc81f4f0f4c",
     "schemas/query.schema.json": "sha256:3c0793a8c0c48ab39320416790840b345ea987696f35b1cc364f23245a62aacb",
+    "schemas/regional-network-import.schema.json": "sha256:9dc1062fbab9b98ccc485d605bb7e7d65d21449cccc17005251d4efea910fed0",
     "schemas/release-manifest.schema.json": "sha256:962be645e790b5f3dc6f6ea455e187492d727dcb91d00f91e4e25b40e2dbc360",
     "schemas/release-state.schema.json": "sha256:9920f68e538915d0d07044f313a9e410775a38ce9bb46a55d9ebe02970784803",
     "schemas/remediation-spec.schema.json": "sha256:6fe8cb773702862ba6d261198bb5cc2dca3eca0a2310a60ebddd04377654df8d",
@@ -90,11 +101,12 @@
     "schemas/sampling-plan.schema.json": "sha256:005f70f149baaacd7de698548d556d3e401c630978748271b0e14a74726dd413",
     "schemas/scenario.schema.json": "sha256:3f5bc2032d08f973600db068f475176a0e4706b33be42f99c778fe755a0ff38b",
     "schemas/schedule.schema.json": "sha256:0f02174ab0fc7bbbce9759fd358b18ed97cc683c76933fd3001cf053c499b157",
+    "schemas/source-identity-chain.schema.json": "sha256:a65d9c12eaed1bd6b637c66a2f9362c17287fdfcb454d8676fb611d2d28aa019",
     "schemas/variance.schema.json": "sha256:68389f64f0a3be13ff8951e8eefba9a5c31d0738325cb47e37c1a8435bea48f0",
-    "scripts/README.md": "sha256:1c3e952950ef353849621b07c5f615bf7cd20cc5654da4635492a7bd6384e747",
-    "SKILL.md": "sha256:ac5817aa956c0d845ab4cc3adcc07b8bd814f924883b9c1178cbe745333616d1",
+    "scripts/README.md": "sha256:9eee4e8beb4579a183bd714c9dd24b83abd020753eada5caeffae004739d60b5",
+    "SKILL.md": "sha256:8211b720ae293517fb1d23260ab3d0d39d7228f20f442f6f642513c708cf1954",
     "templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
-    "VERSION": "sha256:b4a9545a385e9701482be56a0efee678d467d9c586ec476f2c5986cfaa24e96c"
+    "VERSION": "sha256:bb0df1bd902faba507c15975eb9973e695f2732f760d851b4f9c7ba17068f5ff"
   },
-  "treeHash": "sha256:8c0cfbcf3b6ed8a20ec337f655a3ee299f3f7cfd837bad5f7beb8627f3954242"
+  "treeHash": "sha256:1045c67e6f937af236960d4c12fbc3f87c969b405b3559522dd6a1e7342cd924"
 }

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

@@ -28,15 +28,28 @@
         "properties": {
           "action_id": { "$ref": "citable://schemas/common.defs.json#/definitions/id" },
           "finding_ids": { "type": "array", "minItems": 1, "items": { "type": "string" } },
+          "depends_on_action_ids": {
+            "type": "array",
+            "uniqueItems": true,
+            "items": { "$ref": "citable://schemas/common.defs.json#/definitions/id" }
+          },
           "phase": { "type": "string", "enum": ["unblock", "governance", "content", "optimization"] },
           "priority": { "type": "string", "enum": ["critical", "high", "medium", "low"] },
           "subject": { "type": "string" },
           "action": { "type": "string", "minLength": 1 },
           "owner": { "type": ["string", "null"] },
+          "decision_owner": { "type": ["string", "null"] },
           "status": { "type": "string", "enum": ["ready", "blocked"] },
           "required_input": { "type": "array", "items": { "type": "string" } },
           "semantic_gates": { "type": "array", "items": { "type": "string" } },
           "unsafe_shortcuts": { "type": "array", "items": { "type": "string" } },
+          "failure_condition": { "type": "string", "minLength": 1 },
+          "leading_indicators": {
+            "type": "array",
+            "uniqueItems": true,
+            "items": { "type": "string", "minLength": 1 }
+          },
+          "monitoring_window": { "type": ["string", "null"], "minLength": 1 },
           "verification": {
             "type": "object",
             "additionalProperties": false,

package/dist/universal/.pi/agent/skills/citable/schemas/browser-evidence-plan.schema.json

@@ -9,6 +9,20 @@
     "schema_version": { "const": 1 },
     "plan_id": { "type": "string", "pattern": "^BROWSER-PLAN-[A-Z0-9_-]+$" },
     "target": { "type": "string", "format": "uri", "pattern": "^https?://" },
+    "semantic_impact_policy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["policy_id", "review_owner", "min_text_retention_ratio", "require_heading_parity", "require_link_parity", "require_structured_data_parity", "limitations"],
+      "properties": {
+        "policy_id": { "type": "string", "pattern": "^RENDER-POLICY-[A-Z0-9_-]+$" },
+        "review_owner": { "type": "string", "minLength": 1 },
+        "min_text_retention_ratio": { "type": "number", "minimum": 0, "maximum": 1 },
+        "require_heading_parity": { "type": "boolean" },
+        "require_link_parity": { "type": "boolean" },
+        "require_structured_data_parity": { "type": "boolean" },
+        "limitations": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } }
+      }
+    },
     "profiles": {
       "type": "array",
       "minItems": 1,

package/dist/universal/.pi/agent/skills/citable/schemas/canonical-index-import.schema.json

@@ -0,0 +1,30 @@
+{
+  "$id": "citable://schemas/canonical-index-import.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Engine-selected canonical import",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "collected_at", "collection_authority", "authenticity_status", "observations"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "collected_at": { "type": "string", "format": "date-time" },
+    "collection_authority": { "type": "string", "enum": ["owner_export", "third_party_export"] },
+    "authenticity_status": { "type": "string", "enum": ["cryptographically_authenticated", "owner_attested", "transport_authenticated", "checksum_protected_only", "unverified"] },
+    "observations": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["url", "engine", "selected_canonical", "indexed", "observed_at"],
+        "properties": {
+          "url": { "type": "string", "format": "uri", "pattern": "^https://" },
+          "engine": { "type": "string", "minLength": 1 },
+          "selected_canonical": { "type": ["string", "null"], "format": "uri" },
+          "indexed": { "type": ["boolean", "null"] },
+          "observed_at": { "type": "string", "format": "date-time" }
+        }
+      }
+    }
+  }
+}

package/dist/universal/.pi/agent/skills/citable/schemas/common.defs.json

@@ -17,7 +17,18 @@
         "created": { "$ref": "#/definitions/isoDate" },
         "updated": { "$ref": "#/definitions/isoDate" },
         "created_by": { "type": "string" },
-        "source": { "type": "string" }
+        "source": { "type": "string" },
+        "seededFrom": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["seedName", "seedVersion", "importedAt"],
+          "properties": {
+            "seedName": { "type": "string", "minLength": 1 },
+            "seedVersion": { "type": "string", "minLength": 1 },
+            "importedAt": { "$ref": "#/definitions/isoDate" },
+            "contentFingerprint": { "type": "string", "minLength": 1 }
+          }
+        }
       }
     },
     "registryFile": {

package/dist/universal/.pi/agent/skills/citable/schemas/corroboration-import.schema.json

@@ -0,0 +1,48 @@
+{
+  "$id": "citable://schemas/corroboration-import.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "External corroboration import",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "provider", "dataset", "collected_at", "collection_authority", "authenticity_status", "representativeness", "coverage", "mentions"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "provider": { "type": "string", "minLength": 1 },
+    "dataset": { "const": "external_mentions" },
+    "collected_at": { "type": "string", "format": "date-time" },
+    "collection_authority": { "type": "string", "enum": ["owner_export", "third_party_export", "manual_entry"] },
+    "authenticity_status": { "type": "string", "enum": ["cryptographically_authenticated", "provider_range_verified", "owner_attested", "transport_authenticated", "checksum_protected_only", "unverified"] },
+    "representativeness": { "type": "string", "enum": ["production_population", "complete_export", "statistically_sampled", "convenience_sample", "single_observation", "unknown"] },
+    "coverage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["population", "sampled", "exclusions"],
+      "properties": {
+        "population": { "type": "string", "minLength": 1 },
+        "sampled": { "type": "integer", "minimum": 1 },
+        "exclusions": { "type": "array", "items": { "type": "string", "minLength": 1 } }
+      }
+    },
+    "mentions": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["source_url", "publisher", "entity", "source_control", "relationship_disclosure", "source_type", "observed_at"],
+        "properties": {
+          "source_url": { "type": "string", "format": "uri", "pattern": "^https://" },
+          "canonical_url": { "type": "string", "format": "uri", "pattern": "^https://" },
+          "publisher": { "type": "string", "minLength": 1 },
+          "entity": { "type": "string", "minLength": 1 },
+          "source_control": { "type": "string", "enum": ["independent", "owner_controlled", "affiliated", "unknown"] },
+          "relationship_disclosure": { "type": "string", "enum": ["none_disclosed", "affiliated", "sponsored", "unknown"] },
+          "source_type": { "type": "string", "enum": ["editorial", "standards", "academic", "review", "directory", "social", "forum", "backlink", "other"] },
+          "observed_at": { "type": "string", "format": "date-time" },
+          "context_excerpt": { "type": "string" },
+          "claim_ids": { "type": "array", "items": { "type": "string", "minLength": 1 }, "uniqueItems": true }
+        }
+      }
+    }
+  }
+}

package/dist/universal/.pi/agent/skills/citable/schemas/entity-graph.schema.json

@@ -0,0 +1,75 @@
+{
+  "$id": "citable://schemas/entity-graph.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Normalized JSON-LD entity graph",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["version", "nodes", "edges", "unresolved_references", "parse_failures", "limitations"],
+  "properties": {
+    "version": { "const": 1 },
+    "nodes": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["node_id", "types", "names", "source_blocks", "visible_support"],
+        "properties": {
+          "node_id": { "type": "string", "minLength": 1 },
+          "types": { "type": "array", "items": { "type": "string", "minLength": 1 }, "uniqueItems": true },
+          "names": { "type": "array", "items": { "type": "string", "minLength": 1 }, "uniqueItems": true },
+          "source_blocks": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["url", "block_hash"],
+              "properties": {
+                "url": { "type": "string", "minLength": 1 },
+                "block_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+              }
+            }
+          },
+          "visible_support": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["status", "matched_fields"],
+            "properties": {
+              "status": { "type": "string", "enum": ["supported", "not_observed", "not_testable"] },
+              "matched_fields": { "type": "array", "items": { "type": "string", "minLength": 1 }, "uniqueItems": true }
+            }
+          }
+        }
+      }
+    },
+    "edges": { "type": "array", "items": { "$ref": "#/definitions/edge" } },
+    "unresolved_references": { "type": "array", "items": { "$ref": "#/definitions/edge" } },
+    "parse_failures": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["url", "error", "raw_hash"],
+        "properties": {
+          "url": { "type": "string", "minLength": 1 },
+          "error": { "type": "string", "minLength": 1 },
+          "raw_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+        }
+      }
+    },
+    "limitations": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } }
+  },
+  "definitions": {
+    "edge": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["source_id", "relation", "target_id", "source_url", "target_declared"],
+      "properties": {
+        "source_id": { "type": "string", "minLength": 1 },
+        "relation": { "type": "string", "minLength": 1 },
+        "target_id": { "type": "string", "minLength": 1 },
+        "source_url": { "type": "string", "minLength": 1 },
+        "target_declared": { "type": "boolean" }
+      }
+    }
+  }
+}

package/dist/universal/.pi/agent/skills/citable/schemas/entity.schema.json

@@ -23,6 +23,19 @@
         "canonical_url": { "type": "string" },
         "external_identifiers": { "type": "array", "items": { "type": ["string", "object"] } },
         "authoritative_profiles": { "type": "array", "items": { "type": "string" } },
+        "affiliations": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["entity_id", "relationship", "disclosure_status"],
+            "properties": {
+              "entity_id": { "$ref": "citable://schemas/common.defs.json#/definitions/id" },
+              "relationship": { "type": "string", "enum": ["employee", "contractor", "member", "owner", "partner", "other"] },
+              "disclosure_status": { "type": "string", "enum": ["disclosed", "not_disclosed", "unknown"] }
+            }
+          }
+        },
         "category": { "type": "string" },
         "secondary_categories": { "type": "array", "items": { "type": "string" } },
         "definition": { "type": "string" },

package/dist/universal/.pi/agent/skills/citable/schemas/observation.schema.json

@@ -7,7 +7,7 @@
   "required": ["observation_id", "kind", "state", "collected_at", "collection_method", "confidence", "source", "evidence_hash", "data"],
   "properties": {
     "observation_id": { "type": "string", "minLength": 1 },
-    "kind": { "type": "string", "enum": ["render", "browser_journey", "index", "citation", "citation_review", "crawler_log", "bing_webmaster", "passage", "canonical_freshness", "performance", "corroboration", "metric", "media_pdf", "media_transcript", "media_image", "representation_drift"] },
+    "kind": { "type": "string", "enum": ["render", "browser_journey", "index", "citation", "citation_review", "crawler_log", "crawler_probe", "regional_network", "bing_webmaster", "passage", "canonical_freshness", "performance", "corroboration", "metric", "media_pdf", "media_transcript", "media_image", "representation_drift"] },
     "state": { "type": "string", "enum": ["observed", "not_observed", "not_evidenced", "incomplete", "review_required", "failed"] },
     "collected_at": { "type": "string", "format": "date-time" },
     "collection_method": { "type": "string", "enum": ["live_api", "browser", "owner_import", "synthetic_fetch", "static_analysis", "human_review"] },

package/dist/universal/.pi/agent/skills/citable/schemas/page.schema.json

@@ -27,6 +27,9 @@
         "evidence_references": { "type": "array", "items": { "type": "string" } },
         "content_owner": { "type": "string" },
         "factual_reviewer": { "type": "string" },
+        "author_entities": { "type": "array", "items": { "$ref": "citable://schemas/common.defs.json#/definitions/id" }, "uniqueItems": true },
+        "publisher_entity": { "$ref": "citable://schemas/common.defs.json#/definitions/id" },
+        "correction_path": { "type": "string", "minLength": 1 },
         "lifecycle_class": { "type": "string", "enum": ["foundational", "product_capability", "regulatory", "pricing", "market_statistics", "technical_implementation", "competitive_comparison", "security_claim", "evergreen", "news", "unclassified"] },
         "review_cadence": { "type": "string" },
         "next_review_date": { "$ref": "citable://schemas/common.defs.json#/definitions/isoDate" },

package/dist/universal/.pi/agent/skills/citable/schemas/regional-network-import.schema.json

@@ -0,0 +1,55 @@
+{
+  "$id": "citable://schemas/regional-network-import.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Regional network probe import",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "provider", "collected_at", "collection_authority", "authenticity_status", "representativeness", "probes"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "provider": { "type": "string", "minLength": 1 },
+    "collected_at": { "type": "string", "format": "date-time" },
+    "collection_authority": { "type": "string", "enum": ["owner_export", "third_party_export"] },
+    "authenticity_status": { "type": "string", "enum": ["cryptographically_authenticated", "owner_attested", "transport_authenticated", "checksum_protected_only", "unverified"] },
+    "representativeness": { "type": "string", "enum": ["complete_export", "statistically_sampled", "controlled_experiment", "convenience_sample", "unknown"] },
+    "probes": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["probe_id", "target", "region", "network", "user_agent", "observed_at", "dns_addresses", "tls", "status", "latency_ms", "cache"],
+        "properties": {
+          "probe_id": { "type": "string", "pattern": "^PROBE-[A-Z0-9_-]+$" },
+          "target": { "type": "string", "format": "uri", "pattern": "^https://" },
+          "region": { "type": "string", "minLength": 1 },
+          "network": { "type": "string", "minLength": 1 },
+          "user_agent": { "type": "string", "minLength": 1 },
+          "observed_at": { "type": "string", "format": "date-time" },
+          "dns_addresses": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 2 }, "uniqueItems": true },
+          "tls": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["protocol", "authorized", "certificate_fingerprint"],
+            "properties": {
+              "protocol": { "type": "string", "minLength": 1 },
+              "authorized": { "type": "boolean" },
+              "certificate_fingerprint": { "type": "string", "minLength": 1 }
+            }
+          },
+          "status": { "type": "integer", "minimum": 100, "maximum": 599 },
+          "latency_ms": { "type": "number", "minimum": 0 },
+          "cache": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["status", "age_seconds"],
+            "properties": {
+              "status": { "type": "string", "enum": ["HIT", "MISS", "BYPASS", "STALE", "UNKNOWN"] },
+              "age_seconds": { "type": ["number", "null"], "minimum": 0 }
+            }
+          }
+        }
+      }
+    }
+  }
+}