@nebulacomponents/citable 1.12.0 → 1.13.0

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

@@ -0,0 +1,119 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "citable://schemas/assumption.schema.json",
+  "title": "Assumption Registry",
+  "type": "object",
+  "required": [
+    "version",
+    "kind",
+    "entries"
+  ],
+  "properties": {
+    "version": {
+      "type": "integer"
+    },
+    "kind": {
+      "type": "string",
+      "const": "assumptions"
+    },
+    "updated": {
+      "type": "string"
+    },
+    "entries": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "assumption_id",
+          "statement",
+          "category",
+          "owner",
+          "importance",
+          "current_status",
+          "confidence"
+        ],
+        "properties": {
+          "assumption_id": {
+            "type": "string"
+          },
+          "statement": {
+            "type": "string"
+          },
+          "category": {
+            "type": "string",
+            "enum": [
+              "commercial",
+              "product",
+              "customer",
+              "market",
+              "technical",
+              "regulatory",
+              "operational"
+            ]
+          },
+          "owner": {
+            "type": "string"
+          },
+          "importance": {
+            "type": "string",
+            "enum": [
+              "low",
+              "medium",
+              "high",
+              "critical"
+            ]
+          },
+          "evidence_for": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "evidence_against": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "validation_method": {
+            "type": "string"
+          },
+          "current_status": {
+            "type": "string",
+            "enum": [
+              "untested",
+              "weakly_supported",
+              "partially_validated",
+              "validated_within_scope",
+              "contradicted",
+              "invalidated",
+              "no_longer_material"
+            ]
+          },
+          "confidence": {
+            "type": "string",
+            "enum": [
+              "low",
+              "medium",
+              "high"
+            ]
+          },
+          "decision_dependency": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "next_test": {
+            "type": "string"
+          },
+          "expiry": {
+            "type": "string"
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}

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

@@ -0,0 +1,76 @@
+{
+  "$id": "citable://schemas/browser-evidence-plan.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Cross-browser and interaction-journey evidence plan",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "plan_id", "target", "profiles", "limitations"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "plan_id": { "type": "string", "pattern": "^BROWSER-PLAN-[A-Z0-9_-]+$" },
+    "target": { "type": "string", "format": "uri", "pattern": "^https?://" },
+    "profiles": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["profile_id", "browser", "device", "javascript_enabled", "locale", "consent_state", "authentication_state", "steps", "limitations"],
+        "properties": {
+          "profile_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" },
+          "browser": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["engine", "expected_version"],
+            "properties": {
+              "engine": { "enum": ["chromium", "firefox", "webkit"] },
+              "expected_version": { "type": ["string", "null"] }
+            }
+          },
+          "device": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["name", "viewport", "is_mobile"],
+            "properties": {
+              "name": { "type": "string", "minLength": 1 },
+              "viewport": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["width", "height"],
+                "properties": {
+                  "width": { "type": "integer", "minimum": 240, "maximum": 7680 },
+                  "height": { "type": "integer", "minimum": 240, "maximum": 7680 }
+                }
+              },
+              "is_mobile": { "type": "boolean" }
+            }
+          },
+          "javascript_enabled": { "type": "boolean" },
+          "locale": { "type": "string", "minLength": 2 },
+          "consent_state": { "enum": ["not_present", "denied", "granted", "unresolved", "unknown"] },
+          "authentication_state": { "enum": ["anonymous", "owner_authenticated", "unresolved", "unknown"] },
+          "steps": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["step_id", "action", "locator", "value_env", "key", "url", "required", "capture_screenshot"],
+              "properties": {
+                "step_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" },
+                "action": { "enum": ["navigate", "click", "fill", "select_option", "check", "press", "wait_for", "assert_visible", "scroll"] },
+                "locator": { "type": ["string", "null"] },
+                "value_env": { "type": ["string", "null"], "pattern": "^[A-Z][A-Z0-9_]*$" },
+                "key": { "type": ["string", "null"] },
+                "url": { "type": ["string", "null"], "format": "uri" },
+                "required": { "type": "boolean" },
+                "capture_screenshot": { "type": "boolean" }
+              }
+            }
+          },
+          "limitations": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } }
+        }
+      }
+    },
+    "limitations": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } }
+  }
+}

package/dist/universal/.pi/agent/skills/citable/schemas/corpus-publication-receipt.schema.json

@@ -0,0 +1,24 @@
+{
+  "$id": "citable://schemas/corpus-publication-receipt.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Acceptance corpus publication receipt",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "receipt_id", "corpus_id", "corpus_version", "source_hash", "published_hash", "metrics_json_hash", "metrics_markdown_hash", "property_ids", "publication_levels", "generated_at", "authority", "limitations", "receipt_hash"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "receipt_id": { "type": "string", "pattern": "^CORPUS-PUBLICATION-[A-F0-9]{20}$" },
+    "corpus_id": { "type": "string", "pattern": "^CORPUS-" },
+    "corpus_version": { "type": "string" },
+    "source_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "published_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "metrics_json_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "metrics_markdown_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "property_ids": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string" } },
+    "publication_levels": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "enum": ["sanitized_artifacts", "public_artifacts"] } },
+    "generated_at": { "type": "string", "format": "date-time" },
+    "authority": { "const": "owner_authorized_publication_projection" },
+    "limitations": { "type": "array", "minItems": 1, "items": { "type": "string" } },
+    "receipt_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+  }
+}

package/dist/universal/.pi/agent/skills/citable/schemas/customer-outcome.schema.json

@@ -0,0 +1,119 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "citable://schemas/customer-outcome.schema.json",
+  "title": "Customer Outcomes Registry",
+  "type": "object",
+  "required": [
+    "version",
+    "kind",
+    "entries"
+  ],
+  "properties": {
+    "version": {
+      "type": "integer"
+    },
+    "kind": {
+      "type": "string",
+      "const": "customer-outcomes"
+    },
+    "updated": {
+      "type": "string"
+    },
+    "entries": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "outcome_id",
+          "customer",
+          "property",
+          "baseline",
+          "intervention",
+          "observed_change",
+          "measurement_window",
+          "evidence_package",
+          "customer_confirmed",
+          "causal_confidence"
+        ],
+        "properties": {
+          "outcome_id": {
+            "type": "string"
+          },
+          "customer": {
+            "type": "string"
+          },
+          "property": {
+            "type": "string"
+          },
+          "baseline": {
+            "type": "string"
+          },
+          "intervention": {
+            "type": "string"
+          },
+          "observed_change": {
+            "type": "string"
+          },
+          "measurement_window": {
+            "type": "string"
+          },
+          "confounders": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "evidence_package": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "customer_confirmed": {
+            "type": "boolean"
+          },
+          "independently_verified": {
+            "type": "boolean"
+          },
+          "causal_confidence": {
+            "type": "string",
+            "enum": [
+              "none",
+              "weak",
+              "partial",
+              "strong",
+              "verified"
+            ]
+          },
+          "outcome_stage": {
+            "type": "string",
+            "enum": [
+              "finding_produced",
+              "finding_accepted",
+              "finding_remediated",
+              "remediation_validated",
+              "search_result_changed",
+              "answer_engine_changed",
+              "commercial_outcome_changed",
+              "causal_relationship_established"
+            ]
+          },
+          "commercial_value": {
+            "type": "string"
+          },
+          "publication_permission": {
+            "type": "boolean"
+          },
+          "period": {
+            "type": "string"
+          },
+          "owner": {
+            "type": "string"
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}

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

@@ -0,0 +1,154 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "citable://schemas/decision.schema.json",
+  "title": "Decision Registry",
+  "type": "object",
+  "required": [
+    "version",
+    "kind",
+    "entries"
+  ],
+  "properties": {
+    "version": {
+      "type": "integer"
+    },
+    "kind": {
+      "type": "string",
+      "const": "decisions"
+    },
+    "updated": {
+      "type": "string"
+    },
+    "entries": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "decision_id",
+          "owner",
+          "deadline",
+          "reversibility",
+          "options",
+          "recommendation",
+          "supporting_evidence",
+          "assumptions"
+        ],
+        "properties": {
+          "decision_id": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          },
+          "owner": {
+            "type": "string"
+          },
+          "consulted": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "deadline": {
+            "type": "string"
+          },
+          "reversibility": {
+            "type": "string",
+            "enum": [
+              "reversible",
+              "costly_to_reverse",
+              "effectively_one_way"
+            ]
+          },
+          "options": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": [
+                "label",
+                "description",
+                "trade_offs"
+              ],
+              "properties": {
+                "label": {
+                  "type": "string"
+                },
+                "description": {
+                  "type": "string"
+                },
+                "trade_offs": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              }
+            }
+          },
+          "recommendation": {
+            "type": "string"
+          },
+          "supporting_evidence": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "contradicting_evidence": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "assumptions": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "what_would_change_recommendation": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "cost_of_delay": {
+            "type": "string"
+          },
+          "legal_review": {
+            "type": "string"
+          },
+          "security_review": {
+            "type": "string"
+          },
+          "financial_model": {
+            "type": "string"
+          },
+          "reopen_conditions": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "open",
+              "decided",
+              "deferred",
+              "superseded"
+            ]
+          },
+          "decided_at": {
+            "type": "string"
+          },
+          "outcome": {
+            "type": "string"
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}

package/dist/universal/.pi/agent/skills/citable/schemas/deployment-receipt.schema.json

@@ -0,0 +1,51 @@
+{
+  "$id": "citable://schemas/deployment-receipt.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Publisher-controlled deployment receipt",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "receipt_id", "release_id", "manifest_hash", "surface_id", "url", "projection_id", "verification_method", "verification_header", "expected_projection_hash", "observed_projection_hash", "response_hash", "http", "collector", "collected_at", "expires_at", "authority", "verification_status", "limitations", "receipt_hash"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "receipt_id": { "type": "string", "pattern": "^RECEIPT-[A-F0-9]+$" },
+    "release_id": { "type": "string", "pattern": "^RELEASE-v" },
+    "manifest_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "surface_id": { "type": "string", "minLength": 1 },
+    "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-]+$" },
+    "expected_projection_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "observed_projection_hash": { "type": ["string", "null"], "pattern": "^[a-f0-9]{64}$" },
+    "response_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "http": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "final_url", "redirect_chain", "headers"],
+      "properties": {
+        "status": { "type": "integer", "minimum": 100, "maximum": 599 },
+        "final_url": { "type": "string", "format": "uri" },
+        "redirect_chain": { "type": "array", "items": { "type": "string", "format": "uri" } },
+        "headers": { "type": "object", "additionalProperties": { "type": "string" } }
+      }
+    },
+    "collector": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["identity", "version", "method", "request_identity", "region"],
+      "properties": {
+        "identity": { "type": "string", "minLength": 1 },
+        "version": { "type": "string", "minLength": 1 },
+        "method": { "type": "string", "minLength": 1 },
+        "request_identity": { "type": "string", "minLength": 1 },
+        "region": { "type": "string", "minLength": 1 }
+      }
+    },
+    "collected_at": { "type": "string", "format": "date-time" },
+    "expires_at": { "type": "string", "format": "date-time" },
+    "authority": { "$ref": "citable://schemas/evidence-authority.schema.json" },
+    "verification_status": { "enum": ["verified", "contradictory", "insufficient_evidence", "failed"] },
+    "limitations": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+    "receipt_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+  }
+}

package/dist/universal/.pi/agent/skills/citable/schemas/field-validation-metrics.schema.json

@@ -0,0 +1,15 @@
+{
+  "$id": "citable://schemas/field-validation-metrics.schema.json", "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Publishable field-validation metrics", "type": "object", "additionalProperties": false,
+  "required": ["schema_version", "corpus_id", "version", "provenance", "evaluation_design", "population", "detector_versions", "detector_accuracy", "reviewer_metrics", "execution_metrics", "remediation_metrics", "metric_definitions", "unknown_false_negatives", "false_negative_discovery_limitations", "causal_limitations", "limitations", "metrics_hash"],
+  "properties": {
+    "schema_version": { "const": 1 }, "corpus_id": { "type": "string" }, "version": { "type": "string" },
+    "provenance": { "type": "object", "additionalProperties": false, "required": ["corpus_hash", "corpus_created_at", "collection_started_at", "collection_ended_at"], "properties": { "corpus_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "corpus_created_at": { "type": "string", "format": "date-time" }, "collection_started_at": { "type": "string", "format": "date-time" }, "collection_ended_at": { "type": "string", "format": "date-time" } } },
+    "evaluation_design": { "type": "object" }, "population": { "type": "object" },
+    "detector_versions": { "type": "object", "additionalProperties": false, "required": ["versions", "mixed_versions", "cases_by_version"], "properties": { "versions": { "type": "array", "items": { "type": "string" } }, "mixed_versions": { "type": "boolean" }, "cases_by_version": { "type": "object" } } },
+    "detector_accuracy": { "type": "object" }, "reviewer_metrics": { "type": "object" }, "execution_metrics": { "type": "object" }, "remediation_metrics": { "type": "object" },
+    "metric_definitions": { "type": "object", "minProperties": 1, "additionalProperties": { "type": "object", "additionalProperties": false, "required": ["value", "numerator", "denominator", "population", "exclusions", "confidence_limitations"], "properties": { "value": { "type": ["number", "null"] }, "numerator": { "type": ["number", "null"] }, "denominator": { "type": ["number", "null"] }, "population": { "type": "string", "minLength": 1 }, "exclusions": { "type": "array", "items": { "type": "string" } }, "confidence_limitations": { "type": "array", "minItems": 1, "items": { "type": "string" } } } } },
+    "unknown_false_negatives": { "type": "object", "additionalProperties": false, "required": ["status", "reason"], "properties": { "status": { "const": "not_quantified" }, "reason": { "type": "string", "minLength": 1 } } },
+    "false_negative_discovery_limitations": { "type": "array" }, "causal_limitations": { "type": "array" }, "limitations": { "type": "array" }, "metrics_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+  }
+}