@nebulacomponents/citable 1.15.1 → 1.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (211) hide show
  1. package/CHANGELOG.md +25 -0
  2. package/README.md +3 -3
  3. package/dist/universal/.agents/skills/citable/SKILL.md +5 -1
  4. package/dist/universal/.agents/skills/citable/VERSION +1 -1
  5. package/dist/universal/.agents/skills/citable/commands/README.md +3 -1
  6. package/dist/universal/.agents/skills/citable/commands/governance.md +12 -0
  7. package/dist/universal/.agents/skills/citable/commands/measurement.md +20 -0
  8. package/dist/universal/.agents/skills/citable/commands/reporting.md +16 -0
  9. package/dist/universal/.agents/skills/citable/manifest.json +14 -11
  10. package/dist/universal/.agents/skills/citable/schemas/experiment.schema.json +1 -1
  11. package/dist/universal/.agents/skills/citable/schemas/fleet.schema.json +93 -0
  12. package/dist/universal/.agents/skills/citable/schemas/funnel.schema.json +116 -0
  13. package/dist/universal/.agents/skills/citable/schemas/mcp-transport-envelope.schema.json +244 -0
  14. package/dist/universal/.agents/skills/citable/schemas/observation.schema.json +1 -1
  15. package/dist/universal/.claude/agents/citable/manifest.json +2 -2
  16. package/dist/universal/.claude/skills/citable/SKILL.md +5 -1
  17. package/dist/universal/.claude/skills/citable/VERSION +1 -1
  18. package/dist/universal/.claude/skills/citable/commands/README.md +3 -1
  19. package/dist/universal/.claude/skills/citable/commands/governance.md +12 -0
  20. package/dist/universal/.claude/skills/citable/commands/measurement.md +20 -0
  21. package/dist/universal/.claude/skills/citable/commands/reporting.md +16 -0
  22. package/dist/universal/.claude/skills/citable/manifest.json +14 -11
  23. package/dist/universal/.claude/skills/citable/schemas/experiment.schema.json +1 -1
  24. package/dist/universal/.claude/skills/citable/schemas/fleet.schema.json +93 -0
  25. package/dist/universal/.claude/skills/citable/schemas/funnel.schema.json +116 -0
  26. package/dist/universal/.claude/skills/citable/schemas/mcp-transport-envelope.schema.json +244 -0
  27. package/dist/universal/.claude/skills/citable/schemas/observation.schema.json +1 -1
  28. package/dist/universal/.cursor/skills/citable/SKILL.md +5 -1
  29. package/dist/universal/.cursor/skills/citable/VERSION +1 -1
  30. package/dist/universal/.cursor/skills/citable/commands/README.md +3 -1
  31. package/dist/universal/.cursor/skills/citable/commands/governance.md +12 -0
  32. package/dist/universal/.cursor/skills/citable/commands/measurement.md +20 -0
  33. package/dist/universal/.cursor/skills/citable/commands/reporting.md +16 -0
  34. package/dist/universal/.cursor/skills/citable/manifest.json +14 -11
  35. package/dist/universal/.cursor/skills/citable/schemas/experiment.schema.json +1 -1
  36. package/dist/universal/.cursor/skills/citable/schemas/fleet.schema.json +93 -0
  37. package/dist/universal/.cursor/skills/citable/schemas/funnel.schema.json +116 -0
  38. package/dist/universal/.cursor/skills/citable/schemas/mcp-transport-envelope.schema.json +244 -0
  39. package/dist/universal/.cursor/skills/citable/schemas/observation.schema.json +1 -1
  40. package/dist/universal/.gemini/skills/citable/SKILL.md +5 -1
  41. package/dist/universal/.gemini/skills/citable/VERSION +1 -1
  42. package/dist/universal/.gemini/skills/citable/commands/README.md +3 -1
  43. package/dist/universal/.gemini/skills/citable/commands/governance.md +12 -0
  44. package/dist/universal/.gemini/skills/citable/commands/measurement.md +20 -0
  45. package/dist/universal/.gemini/skills/citable/commands/reporting.md +16 -0
  46. package/dist/universal/.gemini/skills/citable/manifest.json +14 -11
  47. package/dist/universal/.gemini/skills/citable/schemas/experiment.schema.json +1 -1
  48. package/dist/universal/.gemini/skills/citable/schemas/fleet.schema.json +93 -0
  49. package/dist/universal/.gemini/skills/citable/schemas/funnel.schema.json +116 -0
  50. package/dist/universal/.gemini/skills/citable/schemas/mcp-transport-envelope.schema.json +244 -0
  51. package/dist/universal/.gemini/skills/citable/schemas/observation.schema.json +1 -1
  52. package/dist/universal/.github/skills/citable/SKILL.md +5 -1
  53. package/dist/universal/.github/skills/citable/VERSION +1 -1
  54. package/dist/universal/.github/skills/citable/commands/README.md +3 -1
  55. package/dist/universal/.github/skills/citable/commands/governance.md +12 -0
  56. package/dist/universal/.github/skills/citable/commands/measurement.md +20 -0
  57. package/dist/universal/.github/skills/citable/commands/reporting.md +16 -0
  58. package/dist/universal/.github/skills/citable/manifest.json +14 -11
  59. package/dist/universal/.github/skills/citable/schemas/experiment.schema.json +1 -1
  60. package/dist/universal/.github/skills/citable/schemas/fleet.schema.json +93 -0
  61. package/dist/universal/.github/skills/citable/schemas/funnel.schema.json +116 -0
  62. package/dist/universal/.github/skills/citable/schemas/mcp-transport-envelope.schema.json +244 -0
  63. package/dist/universal/.github/skills/citable/schemas/observation.schema.json +1 -1
  64. package/dist/universal/.kiro/skills/citable/SKILL.md +5 -1
  65. package/dist/universal/.kiro/skills/citable/VERSION +1 -1
  66. package/dist/universal/.kiro/skills/citable/commands/README.md +3 -1
  67. package/dist/universal/.kiro/skills/citable/commands/governance.md +12 -0
  68. package/dist/universal/.kiro/skills/citable/commands/measurement.md +20 -0
  69. package/dist/universal/.kiro/skills/citable/commands/reporting.md +16 -0
  70. package/dist/universal/.kiro/skills/citable/manifest.json +14 -11
  71. package/dist/universal/.kiro/skills/citable/schemas/experiment.schema.json +1 -1
  72. package/dist/universal/.kiro/skills/citable/schemas/fleet.schema.json +93 -0
  73. package/dist/universal/.kiro/skills/citable/schemas/funnel.schema.json +116 -0
  74. package/dist/universal/.kiro/skills/citable/schemas/mcp-transport-envelope.schema.json +244 -0
  75. package/dist/universal/.kiro/skills/citable/schemas/observation.schema.json +1 -1
  76. package/dist/universal/.opencode/skills/citable/SKILL.md +5 -1
  77. package/dist/universal/.opencode/skills/citable/VERSION +1 -1
  78. package/dist/universal/.opencode/skills/citable/commands/README.md +3 -1
  79. package/dist/universal/.opencode/skills/citable/commands/governance.md +12 -0
  80. package/dist/universal/.opencode/skills/citable/commands/measurement.md +20 -0
  81. package/dist/universal/.opencode/skills/citable/commands/reporting.md +16 -0
  82. package/dist/universal/.opencode/skills/citable/manifest.json +14 -11
  83. package/dist/universal/.opencode/skills/citable/schemas/experiment.schema.json +1 -1
  84. package/dist/universal/.opencode/skills/citable/schemas/fleet.schema.json +93 -0
  85. package/dist/universal/.opencode/skills/citable/schemas/funnel.schema.json +116 -0
  86. package/dist/universal/.opencode/skills/citable/schemas/mcp-transport-envelope.schema.json +244 -0
  87. package/dist/universal/.opencode/skills/citable/schemas/observation.schema.json +1 -1
  88. package/dist/universal/.pi/agent/skills/citable/SKILL.md +5 -1
  89. package/dist/universal/.pi/agent/skills/citable/VERSION +1 -1
  90. package/dist/universal/.pi/agent/skills/citable/commands/README.md +3 -1
  91. package/dist/universal/.pi/agent/skills/citable/commands/governance.md +12 -0
  92. package/dist/universal/.pi/agent/skills/citable/commands/measurement.md +20 -0
  93. package/dist/universal/.pi/agent/skills/citable/commands/reporting.md +16 -0
  94. package/dist/universal/.pi/agent/skills/citable/manifest.json +14 -11
  95. package/dist/universal/.pi/agent/skills/citable/schemas/experiment.schema.json +1 -1
  96. package/dist/universal/.pi/agent/skills/citable/schemas/fleet.schema.json +93 -0
  97. package/dist/universal/.pi/agent/skills/citable/schemas/funnel.schema.json +116 -0
  98. package/dist/universal/.pi/agent/skills/citable/schemas/mcp-transport-envelope.schema.json +244 -0
  99. package/dist/universal/.pi/agent/skills/citable/schemas/observation.schema.json +1 -1
  100. package/dist/universal/.qoder/skills/citable/SKILL.md +5 -1
  101. package/dist/universal/.qoder/skills/citable/VERSION +1 -1
  102. package/dist/universal/.qoder/skills/citable/commands/README.md +3 -1
  103. package/dist/universal/.qoder/skills/citable/commands/governance.md +12 -0
  104. package/dist/universal/.qoder/skills/citable/commands/measurement.md +20 -0
  105. package/dist/universal/.qoder/skills/citable/commands/reporting.md +16 -0
  106. package/dist/universal/.qoder/skills/citable/manifest.json +14 -11
  107. package/dist/universal/.qoder/skills/citable/schemas/experiment.schema.json +1 -1
  108. package/dist/universal/.qoder/skills/citable/schemas/fleet.schema.json +93 -0
  109. package/dist/universal/.qoder/skills/citable/schemas/funnel.schema.json +116 -0
  110. package/dist/universal/.qoder/skills/citable/schemas/mcp-transport-envelope.schema.json +244 -0
  111. package/dist/universal/.qoder/skills/citable/schemas/observation.schema.json +1 -1
  112. package/dist/universal/.rovodev/skills/citable/SKILL.md +5 -1
  113. package/dist/universal/.rovodev/skills/citable/VERSION +1 -1
  114. package/dist/universal/.rovodev/skills/citable/commands/README.md +3 -1
  115. package/dist/universal/.rovodev/skills/citable/commands/governance.md +12 -0
  116. package/dist/universal/.rovodev/skills/citable/commands/measurement.md +20 -0
  117. package/dist/universal/.rovodev/skills/citable/commands/reporting.md +16 -0
  118. package/dist/universal/.rovodev/skills/citable/manifest.json +14 -11
  119. package/dist/universal/.rovodev/skills/citable/schemas/experiment.schema.json +1 -1
  120. package/dist/universal/.rovodev/skills/citable/schemas/fleet.schema.json +93 -0
  121. package/dist/universal/.rovodev/skills/citable/schemas/funnel.schema.json +116 -0
  122. package/dist/universal/.rovodev/skills/citable/schemas/mcp-transport-envelope.schema.json +244 -0
  123. package/dist/universal/.rovodev/skills/citable/schemas/observation.schema.json +1 -1
  124. package/dist/universal/.trae/skills/citable/SKILL.md +5 -1
  125. package/dist/universal/.trae/skills/citable/VERSION +1 -1
  126. package/dist/universal/.trae/skills/citable/commands/README.md +3 -1
  127. package/dist/universal/.trae/skills/citable/commands/governance.md +12 -0
  128. package/dist/universal/.trae/skills/citable/commands/measurement.md +20 -0
  129. package/dist/universal/.trae/skills/citable/commands/reporting.md +16 -0
  130. package/dist/universal/.trae/skills/citable/manifest.json +14 -11
  131. package/dist/universal/.trae/skills/citable/schemas/experiment.schema.json +1 -1
  132. package/dist/universal/.trae/skills/citable/schemas/fleet.schema.json +93 -0
  133. package/dist/universal/.trae/skills/citable/schemas/funnel.schema.json +116 -0
  134. package/dist/universal/.trae/skills/citable/schemas/mcp-transport-envelope.schema.json +244 -0
  135. package/dist/universal/.trae/skills/citable/schemas/observation.schema.json +1 -1
  136. package/dist/universal/.trae-cn/skills/citable/SKILL.md +5 -1
  137. package/dist/universal/.trae-cn/skills/citable/VERSION +1 -1
  138. package/dist/universal/.trae-cn/skills/citable/commands/README.md +3 -1
  139. package/dist/universal/.trae-cn/skills/citable/commands/governance.md +12 -0
  140. package/dist/universal/.trae-cn/skills/citable/commands/measurement.md +20 -0
  141. package/dist/universal/.trae-cn/skills/citable/commands/reporting.md +16 -0
  142. package/dist/universal/.trae-cn/skills/citable/manifest.json +14 -11
  143. package/dist/universal/.trae-cn/skills/citable/schemas/experiment.schema.json +1 -1
  144. package/dist/universal/.trae-cn/skills/citable/schemas/fleet.schema.json +93 -0
  145. package/dist/universal/.trae-cn/skills/citable/schemas/funnel.schema.json +116 -0
  146. package/dist/universal/.trae-cn/skills/citable/schemas/mcp-transport-envelope.schema.json +244 -0
  147. package/dist/universal/.trae-cn/skills/citable/schemas/observation.schema.json +1 -1
  148. package/dist/universal/manifest.json +172 -136
  149. package/package.json +1 -1
  150. package/schemas/experiment.schema.json +1 -1
  151. package/schemas/fleet.schema.json +93 -0
  152. package/schemas/funnel.schema.json +116 -0
  153. package/schemas/mcp-transport-envelope.schema.json +244 -0
  154. package/schemas/observation.schema.json +1 -1
  155. package/skill/SKILL.md +5 -1
  156. package/skill/commands/README.md +3 -1
  157. package/skill/commands/governance.md +12 -0
  158. package/skill/commands/measurement.md +20 -0
  159. package/skill/commands/reporting.md +16 -0
  160. package/src/cli/index.js +383 -8
  161. package/src/commands/attributeImpact.js +54 -0
  162. package/src/commands/connect.js +3 -0
  163. package/src/commands/edgeRules.js +120 -0
  164. package/src/commands/exceptions.js +241 -0
  165. package/src/commands/fleet.js +104 -0
  166. package/src/commands/generateLlmsTxt.js +111 -0
  167. package/src/commands/inspectAeo.js +74 -0
  168. package/src/commands/inspectCro.js +82 -0
  169. package/src/commands/inspectGeo.js +52 -0
  170. package/src/commands/inspectSerp.js +317 -0
  171. package/src/commands/lintComponents.js +132 -0
  172. package/src/commands/monitor.js +138 -0
  173. package/src/commands/observe.js +6 -1
  174. package/src/commands/planExperiment.js +68 -0
  175. package/src/commands/probe.js +70 -0
  176. package/src/commands/reportConsensus.js +48 -0
  177. package/src/commands/testFunnel.js +107 -0
  178. package/src/connectors/index.js +6 -1
  179. package/src/connectors/indexnow.js +431 -0
  180. package/src/connectors/mcp/allowlist.js +107 -0
  181. package/src/connectors/mcp/client.js +239 -0
  182. package/src/connectors/mcp/diagnostics.js +214 -0
  183. package/src/connectors/mcp/gscServer.js +155 -0
  184. package/src/connectors/mcp/http.js +130 -0
  185. package/src/connectors/mcp/index.js +7 -0
  186. package/src/connectors/mcp/pilot.js +138 -0
  187. package/src/connectors/mcp/pilotServer.js +80 -0
  188. package/src/connectors/mcp/sanitizer.js +38 -0
  189. package/src/connectors/mcp/stdio.js +178 -0
  190. package/src/crawler/ipRanges.js +161 -0
  191. package/src/detectors/agent.js +127 -0
  192. package/src/detectors/ans.js +282 -0
  193. package/src/detectors/crawl.js +46 -0
  194. package/src/detectors/cro.js +777 -0
  195. package/src/detectors/cwv.js +38 -1
  196. package/src/detectors/evd.js +101 -0
  197. package/src/detectors/framework.js +1 -1
  198. package/src/detectors/geoReco.js +408 -0
  199. package/src/detectors/index.js +4 -2
  200. package/src/detectors/link.js +112 -1
  201. package/src/detectors/page.js +101 -0
  202. package/src/detectors/schemaData.js +529 -0
  203. package/src/detectors/tech.js +306 -0
  204. package/src/extractor/page.js +186 -2
  205. package/src/extractor/site.js +9 -2
  206. package/src/installer/index.js +45 -2
  207. package/src/monitoring/alertDelivery.js +101 -7
  208. package/src/observations/attribution.js +217 -0
  209. package/src/registries/index.js +14 -0
  210. package/src/reporting/consensus.js +416 -0
  211. package/src/reporting/executiveExport.js +132 -0
@@ -0,0 +1,244 @@
1
+ {
2
+ "$id": "citable://schemas/mcp-transport-envelope.schema.json",
3
+ "$schema": "http://json-schema.org/draft-07/schema#",
4
+ "title": "Model Context Protocol evidence transport envelope",
5
+ "type": "object",
6
+ "additionalProperties": false,
7
+ "required": [
8
+ "schema_version",
9
+ "transport",
10
+ "server",
11
+ "tool",
12
+ "request",
13
+ "response",
14
+ "provenance",
15
+ "authority",
16
+ "status",
17
+ "collected_at"
18
+ ],
19
+ "properties": {
20
+ "schema_version": {
21
+ "const": 1
22
+ },
23
+ "transport": {
24
+ "type": "object",
25
+ "additionalProperties": false,
26
+ "required": [
27
+ "type",
28
+ "protocol_version",
29
+ "timeout_ms",
30
+ "max_bytes"
31
+ ],
32
+ "properties": {
33
+ "type": {
34
+ "type": "string",
35
+ "enum": [
36
+ "stdio",
37
+ "http"
38
+ ]
39
+ },
40
+ "protocol_version": {
41
+ "type": "string",
42
+ "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$|^[0-9]+\\.[0-9]+.*$"
43
+ },
44
+ "timeout_ms": {
45
+ "type": "integer",
46
+ "minimum": 100,
47
+ "maximum": 60000
48
+ },
49
+ "max_bytes": {
50
+ "type": "integer",
51
+ "minimum": 1024,
52
+ "maximum": 10485760
53
+ },
54
+ "retries": {
55
+ "type": "integer",
56
+ "minimum": 0,
57
+ "maximum": 5
58
+ }
59
+ }
60
+ },
61
+ "server": {
62
+ "type": "object",
63
+ "additionalProperties": false,
64
+ "required": [
65
+ "server_id",
66
+ "transport_target",
67
+ "allowlisted"
68
+ ],
69
+ "properties": {
70
+ "server_id": {
71
+ "type": "string",
72
+ "pattern": "^[a-z0-9_.-]+$"
73
+ },
74
+ "package_name": {
75
+ "type": [
76
+ "string",
77
+ "null"
78
+ ]
79
+ },
80
+ "pinned_version": {
81
+ "type": [
82
+ "string",
83
+ "null"
84
+ ]
85
+ },
86
+ "transport_target": {
87
+ "type": "string",
88
+ "minLength": 1
89
+ },
90
+ "allowlisted": {
91
+ "type": "boolean"
92
+ },
93
+ "capabilities": {
94
+ "type": "object"
95
+ }
96
+ }
97
+ },
98
+ "tool": {
99
+ "type": "object",
100
+ "additionalProperties": false,
101
+ "required": [
102
+ "name",
103
+ "read_only",
104
+ "input_schema_hash"
105
+ ],
106
+ "properties": {
107
+ "name": {
108
+ "type": "string",
109
+ "pattern": "^[a-zA-Z0-9_.-]+$"
110
+ },
111
+ "description": {
112
+ "type": [
113
+ "string",
114
+ "null"
115
+ ]
116
+ },
117
+ "read_only": {
118
+ "type": "boolean"
119
+ },
120
+ "input_schema_hash": {
121
+ "type": "string",
122
+ "pattern": "^[a-f0-9]{64}$"
123
+ },
124
+ "input_schema": {
125
+ "type": "object"
126
+ }
127
+ }
128
+ },
129
+ "request": {
130
+ "type": "object",
131
+ "additionalProperties": false,
132
+ "required": [
133
+ "arguments_hash",
134
+ "arguments"
135
+ ],
136
+ "properties": {
137
+ "arguments_hash": {
138
+ "type": "string",
139
+ "pattern": "^[a-f0-9]{64}$"
140
+ },
141
+ "arguments": {
142
+ "type": "object"
143
+ },
144
+ "authorization_mode": {
145
+ "type": "string",
146
+ "enum": [
147
+ "none",
148
+ "environment",
149
+ "bearer_token",
150
+ "header"
151
+ ]
152
+ },
153
+ "scopes": {
154
+ "type": "array",
155
+ "items": {
156
+ "type": "string"
157
+ }
158
+ }
159
+ }
160
+ },
161
+ "response": {
162
+ "type": "object",
163
+ "additionalProperties": false,
164
+ "required": [
165
+ "raw_sha256",
166
+ "content_bytes",
167
+ "is_error",
168
+ "retention_reason"
169
+ ],
170
+ "properties": {
171
+ "raw_sha256": {
172
+ "type": "string",
173
+ "pattern": "^[a-f0-9]{64}$"
174
+ },
175
+ "content_bytes": {
176
+ "type": "integer",
177
+ "minimum": 0
178
+ },
179
+ "is_error": {
180
+ "type": "boolean"
181
+ },
182
+ "retention_reason": {
183
+ "type": "string",
184
+ "enum": [
185
+ "raw_preserved",
186
+ "hash_locked_only",
187
+ "redacted_sensitive"
188
+ ]
189
+ },
190
+ "content": {
191
+ "type": "array"
192
+ }
193
+ }
194
+ },
195
+ "provenance": {
196
+ "type": "object",
197
+ "additionalProperties": false,
198
+ "required": [
199
+ "adapter_version",
200
+ "normalization_version",
201
+ "sanitized_redactions"
202
+ ],
203
+ "properties": {
204
+ "adapter_version": {
205
+ "type": "string"
206
+ },
207
+ "normalization_version": {
208
+ "type": "string"
209
+ },
210
+ "sanitized_redactions": {
211
+ "type": "integer",
212
+ "minimum": 0
213
+ },
214
+ "duration_ms": {
215
+ "type": "number",
216
+ "minimum": 0
217
+ }
218
+ }
219
+ },
220
+ "authority": {
221
+ "$ref": "citable://schemas/evidence-authority.schema.json"
222
+ },
223
+ "status": {
224
+ "type": "string",
225
+ "enum": [
226
+ "success",
227
+ "incomplete",
228
+ "failed",
229
+ "unsupported",
230
+ "unauthorized"
231
+ ]
232
+ },
233
+ "collected_at": {
234
+ "type": "string",
235
+ "format": "date-time"
236
+ },
237
+ "limitations": {
238
+ "type": "array",
239
+ "items": {
240
+ "type": "string"
241
+ }
242
+ }
243
+ }
244
+ }
@@ -7,7 +7,7 @@
7
7
  "required": ["observation_id", "kind", "state", "collected_at", "collection_method", "confidence", "source", "evidence_hash", "data"],
8
8
  "properties": {
9
9
  "observation_id": { "type": "string", "minLength": 1 },
10
- "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", "stance"] },
10
+ "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", "stance", "mcp_transport", "attribution"] },
11
11
  "state": { "type": "string", "enum": ["observed", "not_observed", "not_evidenced", "incomplete", "review_required", "failed"] },
12
12
  "collected_at": { "type": "string", "format": "date-time" },
13
13
  "collection_method": { "type": "string", "enum": ["live_api", "browser", "owner_import", "synthetic_fetch", "static_analysis", "human_review"] },