@nebulacomponents/citable 1.19.0 → 1.21.0

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

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

package/dist/universal/.trae-cn/skills/citable/schemas/run.schema.json

@@ -5,6 +5,7 @@
   "type": "object",
   "required": ["run_id", "command", "tool_version", "skill_version", "timestamp", "target", "status"],
   "properties": {
+    "schema_version": { "type": "integer", "enum": [1, 2] },
     "run_id": { "type": "string" },
     "command": { "type": "string" },
     "argv": { "type": "array", "items": { "type": "string" } },
@@ -31,6 +32,18 @@
     "incomplete_checks": { "type": "array", "items": { "type": "string" } },
     "errors": { "type": "array", "items": { "type": "string" } },
     "warnings": { "type": "array", "items": { "type": "string" } },
-    "status": { "type": "string", "enum": ["completed", "completed_with_warnings", "incomplete", "failed"] }
-  }
+    "status": { "type": "string", "enum": ["completed", "completed_with_warnings", "incomplete", "failed"] },
+    "execution_status": { "type": "string", "enum": ["completed", "completed_with_warnings", "failed"] },
+    "coverage_status": { "type": "string", "enum": ["complete", "truncated", "indeterminate", "not_applicable"] },
+    "determination_status": { "type": "string", "enum": ["supported", "qualified", "indeterminate", "not_applicable"] }
+  },
+  "allOf": [
+    {
+      "if": {
+        "required": ["schema_version"],
+        "properties": { "schema_version": { "const": 2 } }
+      },
+      "then": { "required": ["execution_status", "coverage_status", "determination_status"] }
+    }
+  ]
 }

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

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

package/dist/universal/.trae-cn/skills/citable/schemas/search-report.schema.json

@@ -90,7 +90,14 @@
         "source_identifier": { "type": ["string", "null"] },
         "source_findings_count": { "type": "integer", "minimum": 0 },
         "integrity_hash": { "type": ["string", "null"] },
-        "synthetic_evidence": { "type": "boolean" }
+        "synthetic_evidence": { "type": "boolean" },
+        "package_verified": { "type": "boolean" },
+        "integrity_mode": { "type": "string" },
+        "legacy": { "type": "boolean" },
+        "coverage_status": { "type": "string" },
+        "determination_status": { "type": "string" },
+        "evaluated": { "type": ["integer", "null"], "minimum": 0 },
+        "eligible": { "type": ["integer", "null"], "minimum": 0 }
       },
       "additionalProperties": false
     }

package/dist/universal/.trae-cn/skills/citable/schemas/summary.schema.json

@@ -0,0 +1,41 @@
+{
+  "$id": "citable://schemas/summary.schema.json",
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Run summary",
+  "type": "object",
+  "required": ["coverage", "posture"],
+  "properties": {
+    "coverage": {
+      "type": ["object", "null"],
+      "required": ["status", "populations", "stop_reason"],
+      "properties": {
+        "status": { "enum": ["complete", "truncated", "indeterminate", "not_applicable"] },
+        "populations": { "$ref": "citable://schemas/audit-coverage.schema.json#/properties/populations" },
+        "stop_reason": { "type": ["string", "null"] }
+      },
+      "additionalProperties": false
+    },
+    "posture": {
+      "type": "object",
+      "required": ["retrieval_eligibility", "source_extraction_and_support", "observed_citation_behavior"],
+      "properties": {
+        "retrieval_eligibility": { "$ref": "#/definitions/posture" },
+        "source_extraction_and_support": { "$ref": "#/definitions/posture" },
+        "observed_citation_behavior": { "$ref": "#/definitions/posture" }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": true,
+  "definitions": {
+    "posture": {
+      "type": "object",
+      "required": ["result"],
+      "properties": {
+        "result": { "type": "string" },
+        "coverage_status": { "enum": ["complete", "truncated", "indeterminate", "not_applicable"] }
+      },
+      "additionalProperties": true
+    }
+  }
+}