@nebulacomponents/citable 1.12.0 → 1.13.0

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

@@ -0,0 +1,185 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "citable://schemas/initiative.schema.json",
+  "title": "Initiative Registry",
+  "type": "object",
+  "required": [
+    "version",
+    "kind",
+    "entries"
+  ],
+  "properties": {
+    "version": {
+      "type": "integer"
+    },
+    "kind": {
+      "type": "string",
+      "const": "initiatives"
+    },
+    "updated": {
+      "type": "string"
+    },
+    "entries": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "initiative_id",
+          "title",
+          "customer_demand",
+          "revenue_potential",
+          "strategic_differentiation",
+          "evidence_strength",
+          "engineering_cost",
+          "reversibility",
+          "owner"
+        ],
+        "properties": {
+          "initiative_id": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "customer_demand": {
+            "type": "string",
+            "enum": [
+              "none",
+              "low",
+              "medium",
+              "high",
+              "validated"
+            ]
+          },
+          "revenue_potential": {
+            "type": "string",
+            "enum": [
+              "none",
+              "low",
+              "medium",
+              "high",
+              "transformative"
+            ]
+          },
+          "strategic_differentiation": {
+            "type": "string",
+            "enum": [
+              "none",
+              "low",
+              "medium",
+              "high",
+              "critical"
+            ]
+          },
+          "evidence_strength": {
+            "type": "string",
+            "enum": [
+              "assumption",
+              "anecdote",
+              "proxy",
+              "validated",
+              "verified"
+            ]
+          },
+          "engineering_cost": {
+            "type": "string",
+            "enum": [
+              "trivial",
+              "low",
+              "medium",
+              "high",
+              "very_high"
+            ]
+          },
+          "operating_cost": {
+            "type": "string",
+            "enum": [
+              "none",
+              "low",
+              "medium",
+              "high"
+            ]
+          },
+          "maintenance_cost": {
+            "type": "string",
+            "enum": [
+              "none",
+              "low",
+              "medium",
+              "high"
+            ]
+          },
+          "platform_dependency": {
+            "type": "string"
+          },
+          "legal_risk": {
+            "type": "string",
+            "enum": [
+              "none",
+              "low",
+              "medium",
+              "high"
+            ]
+          },
+          "reversibility": {
+            "type": "string",
+            "enum": [
+              "reversible",
+              "costly_to_reverse",
+              "effectively_one_way"
+            ]
+          },
+          "time_to_value": {
+            "type": "string"
+          },
+          "opportunity_cost": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "proposed",
+              "approved",
+              "in_progress",
+              "completed",
+              "deferred",
+              "cancelled"
+            ]
+          },
+          "owner": {
+            "type": "string"
+          },
+          "linked_kpis": {
+            "type": "array",
+            "items": { "type": "string" },
+            "uniqueItems": true
+          },
+          "linked_outcomes": {
+            "type": "array",
+            "items": { "type": "string" },
+            "uniqueItems": true
+          },
+          "linked_risks": {
+            "type": "array",
+            "items": { "type": "string" },
+            "uniqueItems": true
+          },
+          "linked_decisions": {
+            "type": "array",
+            "items": { "type": "string" },
+            "uniqueItems": true
+          },
+          "scoring_weights": {
+            "type": "object",
+            "description": "Explicit weights if weighted scoring is used — weights must be visible"
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}

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

@@ -0,0 +1,108 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "citable://schemas/kpi.schema.json",
+  "title": "KPI Registry",
+  "type": "object",
+  "required": [
+    "version",
+    "kind",
+    "entries"
+  ],
+  "properties": {
+    "version": {
+      "type": "integer"
+    },
+    "kind": {
+      "type": "string",
+      "const": "kpis"
+    },
+    "updated": {
+      "type": "string"
+    },
+    "entries": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "metric_id",
+          "name",
+          "executive_definition",
+          "calculation",
+          "unit",
+          "source_system",
+          "owner",
+          "reporting_cadence"
+        ],
+        "properties": {
+          "metric_id": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "executive_definition": {
+            "type": "string"
+          },
+          "calculation": {
+            "type": "string"
+          },
+          "numerator": {
+            "type": "string"
+          },
+          "denominator": {
+            "type": "string"
+          },
+          "unit": {
+            "type": "string"
+          },
+          "source_system": {
+            "type": "string"
+          },
+          "source_query": {
+            "type": "string"
+          },
+          "owner": {
+            "type": "string"
+          },
+          "target": {},
+          "warning_threshold": {},
+          "critical_threshold": {},
+          "reporting_cadence": {
+            "type": "string",
+            "enum": [
+              "daily",
+              "weekly",
+              "monthly",
+              "quarterly",
+              "annual"
+            ]
+          },
+          "restatement_policy": {
+            "type": "string"
+          },
+          "known_limitations": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "comparison_required": {
+            "type": "boolean"
+          },
+          "comparison_basis": {
+            "type": "string",
+            "enum": [
+              "prior_period",
+              "prior_year",
+              "target",
+              "budget",
+              "forecast"
+            ]
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}

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", "index", "citation", "citation_review", "crawler_log", "bing_webmaster", "passage", "canonical_freshness", "performance", "corroboration", "metric", "media_pdf", "media_transcript", "media_image"] },
+    "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"] },
     "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/release-manifest.schema.json

@@ -0,0 +1,74 @@
+{
+  "$id": "citable://schemas/release-manifest.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Canonical release manifest",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "release_id", "version", "commit", "generated_at", "toolchain", "facts", "projections", "controlled_surfaces", "manifest_hash"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "release_id": { "type": "string", "pattern": "^RELEASE-v[0-9]+\\.[0-9]+\\.[0-9]+$" },
+    "version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$" },
+    "commit": { "type": "string", "pattern": "^[a-f0-9]{40}$" },
+    "generated_at": { "type": "string", "format": "date-time" },
+    "toolchain": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["node", "citable"],
+      "properties": {
+        "node": { "type": "string", "minLength": 1 },
+        "citable": { "type": "string", "minLength": 1 }
+      }
+    },
+    "facts": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["detectors", "namespaces", "registries", "providers", "distribution_files_per_provider"],
+      "properties": {
+        "detectors": { "type": "integer", "minimum": 0 },
+        "namespaces": { "type": "integer", "minimum": 0 },
+        "registries": { "type": "integer", "minimum": 0 },
+        "providers": { "type": "integer", "minimum": 0 },
+        "distribution_files_per_provider": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "projections": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["projection_id", "path", "sha256", "bytes", "authority"],
+        "properties": {
+          "projection_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" },
+          "path": { "type": "string", "minLength": 1 },
+          "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+          "bytes": { "type": "integer", "minimum": 0 },
+          "authority": { "enum": ["control_plane"] }
+        }
+      }
+    },
+    "controlled_surfaces": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["surface_id", "url", "projection_id", "verification_method", "verification_header", "required_for_finalization"],
+        "properties": {
+          "surface_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" },
+          "url": { "type": "string", "format": "uri", "pattern": "^https://" },
+          "projection_id": { "type": "string", "minLength": 1 },
+          "verification_method": { "enum": ["exact_response_body", "response_header"] },
+          "verification_header": { "type": ["string", "null"], "pattern": "^[a-z0-9-]+$" },
+          "required_for_finalization": { "type": "boolean" }
+        },
+        "allOf": [
+          { "if": { "properties": { "verification_method": { "const": "exact_response_body" } } }, "then": { "properties": { "verification_header": { "type": "null" } } } },
+          { "if": { "properties": { "verification_method": { "const": "response_header" } } }, "then": { "properties": { "verification_header": { "type": "string", "minLength": 1 } } } }
+        ]
+      }
+    },
+    "manifest_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+  }
+}

package/dist/universal/.pi/agent/skills/citable/schemas/release-state.schema.json

@@ -0,0 +1,40 @@
+{
+  "$id": "citable://schemas/release-state.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Governed release state",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "release_id", "manifest_hash", "state", "max_dwell_hours", "created_at", "transitions", "receipt_refs", "state_hash"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "release_id": { "type": "string", "pattern": "^RELEASE-v" },
+    "manifest_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "state": { "enum": ["candidate", "published_unfinalized", "finalized", "superseded", "withdrawn"] },
+    "max_dwell_hours": { "type": "integer", "minimum": 1, "maximum": 168 },
+    "created_at": { "type": "string", "format": "date-time" },
+    "published_at": { "type": ["string", "null"], "format": "date-time" },
+    "finalized_at": { "type": ["string", "null"], "format": "date-time" },
+    "resolved_at": { "type": ["string", "null"], "format": "date-time" },
+    "resolution_reason": { "type": ["string", "null"] },
+    "superseding_release_id": { "type": ["string", "null"] },
+    "receipt_refs": { "type": "array", "uniqueItems": true, "items": { "type": "string", "pattern": "^RECEIPT-" } },
+    "state_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "transitions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["from", "to", "actor", "timestamp", "reason", "policy_version", "evidence_refs"],
+        "properties": {
+          "from": { "type": ["string", "null"], "enum": [null, "candidate", "published_unfinalized"] },
+          "to": { "enum": ["candidate", "published_unfinalized", "finalized", "superseded", "withdrawn"] },
+          "actor": { "type": "string", "minLength": 1 },
+          "timestamp": { "type": "string", "format": "date-time" },
+          "reason": { "type": "string", "minLength": 1 },
+          "policy_version": { "type": "string", "minLength": 1 },
+          "evidence_refs": { "type": "array", "items": { "type": "string", "minLength": 1 } }
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,172 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "citable://schemas/risk.schema.json",
+  "title": "Risk Register",
+  "type": "object",
+  "required": [
+    "version",
+    "kind",
+    "entries"
+  ],
+  "properties": {
+    "version": {
+      "type": "integer"
+    },
+    "kind": {
+      "type": "string",
+      "const": "risks"
+    },
+    "updated": {
+      "type": "string"
+    },
+    "entries": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "risk_id",
+          "title",
+          "category",
+          "cause",
+          "event",
+          "consequence",
+          "likelihood",
+          "impact",
+          "gross_exposure",
+          "controls",
+          "residual_exposure",
+          "response",
+          "response_owner",
+          "review_date",
+          "trend",
+          "board_visibility"
+        ],
+        "properties": {
+          "risk_id": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          },
+          "category": {
+            "type": "string",
+            "enum": [
+              "commercial",
+              "product",
+              "detector_quality",
+              "evidence_integrity",
+              "customer_reliance",
+              "platform_dependency",
+              "search_engine_policy",
+              "legal_advertising",
+              "data_rights",
+              "security",
+              "supply_chain",
+              "npm_distribution",
+              "reputational",
+              "operational_capacity"
+            ]
+          },
+          "cause": {
+            "type": "string"
+          },
+          "event": {
+            "type": "string"
+          },
+          "consequence": {
+            "type": "string"
+          },
+          "likelihood": {
+            "type": "string",
+            "enum": [
+              "rare",
+              "unlikely",
+              "possible",
+              "likely",
+              "almost_certain"
+            ]
+          },
+          "impact": {
+            "type": "string",
+            "enum": [
+              "negligible",
+              "minor",
+              "moderate",
+              "major",
+              "catastrophic"
+            ]
+          },
+          "gross_exposure": {
+            "type": "string",
+            "enum": [
+              "low",
+              "medium",
+              "high",
+              "critical"
+            ]
+          },
+          "controls": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "control_owner": {
+            "type": "string"
+          },
+          "control_effectiveness": {
+            "type": "string",
+            "enum": [
+              "none",
+              "weak",
+              "partial",
+              "adequate",
+              "strong"
+            ]
+          },
+          "residual_exposure": {
+            "type": "string",
+            "enum": [
+              "low",
+              "medium",
+              "high",
+              "critical"
+            ]
+          },
+          "key_risk_indicators": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "trigger_threshold": {
+            "type": "string"
+          },
+          "response": {
+            "type": "string"
+          },
+          "response_owner": {
+            "type": "string"
+          },
+          "review_date": {
+            "type": "string"
+          },
+          "trend": {
+            "type": "string",
+            "enum": [
+              "improving",
+              "stable",
+              "deteriorating",
+              "emerging"
+            ]
+          },
+          "board_visibility": {
+            "type": "boolean"
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}