@nebulacomponents/citable 1.13.1 → 1.15.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 (359) hide show
  1. package/CHANGELOG.md +312 -0
  2. package/README.md +44 -6
  3. package/dist/universal/.agents/skills/citable/SKILL.md +22 -8
  4. package/dist/universal/.agents/skills/citable/VERSION +1 -1
  5. package/dist/universal/.agents/skills/citable/agents/citable-auditor.md +64 -0
  6. package/dist/universal/.agents/skills/citable/agents/citable-semantic-reviewer.md +66 -0
  7. package/dist/universal/.agents/skills/citable/commands/README.md +4 -1
  8. package/dist/universal/.agents/skills/citable/commands/action-findings.md +9 -1
  9. package/dist/universal/.agents/skills/citable/commands/observe-and-act.md +62 -8
  10. package/dist/universal/.agents/skills/citable/commands/plan-audit.md +35 -0
  11. package/dist/universal/.agents/skills/citable/commands/reporting.md +57 -0
  12. package/dist/universal/.agents/skills/citable/manifest.json +29 -16
  13. package/dist/universal/.agents/skills/citable/schemas/action-plan.schema.json +13 -0
  14. package/dist/universal/.agents/skills/citable/schemas/browser-evidence-plan.schema.json +14 -0
  15. package/dist/universal/.agents/skills/citable/schemas/canonical-index-import.schema.json +30 -0
  16. package/dist/universal/.agents/skills/citable/schemas/common.defs.json +12 -1
  17. package/dist/universal/.agents/skills/citable/schemas/corroboration-import.schema.json +48 -0
  18. package/dist/universal/.agents/skills/citable/schemas/entity-graph.schema.json +75 -0
  19. package/dist/universal/.agents/skills/citable/schemas/entity.schema.json +13 -0
  20. package/dist/universal/.agents/skills/citable/schemas/observation.schema.json +1 -1
  21. package/dist/universal/.agents/skills/citable/schemas/page.schema.json +3 -0
  22. package/dist/universal/.agents/skills/citable/schemas/regional-network-import.schema.json +55 -0
  23. package/dist/universal/.agents/skills/citable/schemas/schedule.schema.json +1 -1
  24. package/dist/universal/.agents/skills/citable/schemas/source-identity-chain.schema.json +83 -0
  25. package/dist/universal/.agents/skills/citable/scripts/README.md +3 -1
  26. package/dist/universal/.claude/agents/citable/citable-auditor.md +64 -0
  27. package/dist/universal/.claude/agents/citable/citable-semantic-reviewer.md +66 -0
  28. package/dist/universal/.claude/agents/citable/manifest.json +12 -0
  29. package/dist/universal/.claude/skills/citable/SKILL.md +22 -8
  30. package/dist/universal/.claude/skills/citable/VERSION +1 -1
  31. package/dist/universal/.claude/skills/citable/agents/citable-auditor.md +64 -0
  32. package/dist/universal/.claude/skills/citable/agents/citable-semantic-reviewer.md +66 -0
  33. package/dist/universal/.claude/skills/citable/commands/README.md +4 -1
  34. package/dist/universal/.claude/skills/citable/commands/action-findings.md +9 -1
  35. package/dist/universal/.claude/skills/citable/commands/observe-and-act.md +62 -8
  36. package/dist/universal/.claude/skills/citable/commands/plan-audit.md +35 -0
  37. package/dist/universal/.claude/skills/citable/commands/reporting.md +57 -0
  38. package/dist/universal/.claude/skills/citable/manifest.json +34 -16
  39. package/dist/universal/.claude/skills/citable/schemas/action-plan.schema.json +13 -0
  40. package/dist/universal/.claude/skills/citable/schemas/browser-evidence-plan.schema.json +14 -0
  41. package/dist/universal/.claude/skills/citable/schemas/canonical-index-import.schema.json +30 -0
  42. package/dist/universal/.claude/skills/citable/schemas/common.defs.json +12 -1
  43. package/dist/universal/.claude/skills/citable/schemas/corroboration-import.schema.json +48 -0
  44. package/dist/universal/.claude/skills/citable/schemas/entity-graph.schema.json +75 -0
  45. package/dist/universal/.claude/skills/citable/schemas/entity.schema.json +13 -0
  46. package/dist/universal/.claude/skills/citable/schemas/observation.schema.json +1 -1
  47. package/dist/universal/.claude/skills/citable/schemas/page.schema.json +3 -0
  48. package/dist/universal/.claude/skills/citable/schemas/regional-network-import.schema.json +55 -0
  49. package/dist/universal/.claude/skills/citable/schemas/schedule.schema.json +1 -1
  50. package/dist/universal/.claude/skills/citable/schemas/source-identity-chain.schema.json +83 -0
  51. package/dist/universal/.claude/skills/citable/scripts/README.md +3 -1
  52. package/dist/universal/.cursor/skills/citable/SKILL.md +22 -8
  53. package/dist/universal/.cursor/skills/citable/VERSION +1 -1
  54. package/dist/universal/.cursor/skills/citable/agents/citable-auditor.md +64 -0
  55. package/dist/universal/.cursor/skills/citable/agents/citable-semantic-reviewer.md +66 -0
  56. package/dist/universal/.cursor/skills/citable/commands/README.md +4 -1
  57. package/dist/universal/.cursor/skills/citable/commands/action-findings.md +9 -1
  58. package/dist/universal/.cursor/skills/citable/commands/observe-and-act.md +62 -8
  59. package/dist/universal/.cursor/skills/citable/commands/plan-audit.md +35 -0
  60. package/dist/universal/.cursor/skills/citable/commands/reporting.md +57 -0
  61. package/dist/universal/.cursor/skills/citable/manifest.json +29 -16
  62. package/dist/universal/.cursor/skills/citable/schemas/action-plan.schema.json +13 -0
  63. package/dist/universal/.cursor/skills/citable/schemas/browser-evidence-plan.schema.json +14 -0
  64. package/dist/universal/.cursor/skills/citable/schemas/canonical-index-import.schema.json +30 -0
  65. package/dist/universal/.cursor/skills/citable/schemas/common.defs.json +12 -1
  66. package/dist/universal/.cursor/skills/citable/schemas/corroboration-import.schema.json +48 -0
  67. package/dist/universal/.cursor/skills/citable/schemas/entity-graph.schema.json +75 -0
  68. package/dist/universal/.cursor/skills/citable/schemas/entity.schema.json +13 -0
  69. package/dist/universal/.cursor/skills/citable/schemas/observation.schema.json +1 -1
  70. package/dist/universal/.cursor/skills/citable/schemas/page.schema.json +3 -0
  71. package/dist/universal/.cursor/skills/citable/schemas/regional-network-import.schema.json +55 -0
  72. package/dist/universal/.cursor/skills/citable/schemas/schedule.schema.json +1 -1
  73. package/dist/universal/.cursor/skills/citable/schemas/source-identity-chain.schema.json +83 -0
  74. package/dist/universal/.cursor/skills/citable/scripts/README.md +3 -1
  75. package/dist/universal/.gemini/skills/citable/SKILL.md +22 -8
  76. package/dist/universal/.gemini/skills/citable/VERSION +1 -1
  77. package/dist/universal/.gemini/skills/citable/agents/citable-auditor.md +64 -0
  78. package/dist/universal/.gemini/skills/citable/agents/citable-semantic-reviewer.md +66 -0
  79. package/dist/universal/.gemini/skills/citable/commands/README.md +4 -1
  80. package/dist/universal/.gemini/skills/citable/commands/action-findings.md +9 -1
  81. package/dist/universal/.gemini/skills/citable/commands/observe-and-act.md +62 -8
  82. package/dist/universal/.gemini/skills/citable/commands/plan-audit.md +35 -0
  83. package/dist/universal/.gemini/skills/citable/commands/reporting.md +57 -0
  84. package/dist/universal/.gemini/skills/citable/manifest.json +29 -16
  85. package/dist/universal/.gemini/skills/citable/schemas/action-plan.schema.json +13 -0
  86. package/dist/universal/.gemini/skills/citable/schemas/browser-evidence-plan.schema.json +14 -0
  87. package/dist/universal/.gemini/skills/citable/schemas/canonical-index-import.schema.json +30 -0
  88. package/dist/universal/.gemini/skills/citable/schemas/common.defs.json +12 -1
  89. package/dist/universal/.gemini/skills/citable/schemas/corroboration-import.schema.json +48 -0
  90. package/dist/universal/.gemini/skills/citable/schemas/entity-graph.schema.json +75 -0
  91. package/dist/universal/.gemini/skills/citable/schemas/entity.schema.json +13 -0
  92. package/dist/universal/.gemini/skills/citable/schemas/observation.schema.json +1 -1
  93. package/dist/universal/.gemini/skills/citable/schemas/page.schema.json +3 -0
  94. package/dist/universal/.gemini/skills/citable/schemas/regional-network-import.schema.json +55 -0
  95. package/dist/universal/.gemini/skills/citable/schemas/schedule.schema.json +1 -1
  96. package/dist/universal/.gemini/skills/citable/schemas/source-identity-chain.schema.json +83 -0
  97. package/dist/universal/.gemini/skills/citable/scripts/README.md +3 -1
  98. package/dist/universal/.github/skills/citable/SKILL.md +22 -8
  99. package/dist/universal/.github/skills/citable/VERSION +1 -1
  100. package/dist/universal/.github/skills/citable/agents/citable-auditor.md +64 -0
  101. package/dist/universal/.github/skills/citable/agents/citable-semantic-reviewer.md +66 -0
  102. package/dist/universal/.github/skills/citable/commands/README.md +4 -1
  103. package/dist/universal/.github/skills/citable/commands/action-findings.md +9 -1
  104. package/dist/universal/.github/skills/citable/commands/observe-and-act.md +62 -8
  105. package/dist/universal/.github/skills/citable/commands/plan-audit.md +35 -0
  106. package/dist/universal/.github/skills/citable/commands/reporting.md +57 -0
  107. package/dist/universal/.github/skills/citable/manifest.json +29 -16
  108. package/dist/universal/.github/skills/citable/schemas/action-plan.schema.json +13 -0
  109. package/dist/universal/.github/skills/citable/schemas/browser-evidence-plan.schema.json +14 -0
  110. package/dist/universal/.github/skills/citable/schemas/canonical-index-import.schema.json +30 -0
  111. package/dist/universal/.github/skills/citable/schemas/common.defs.json +12 -1
  112. package/dist/universal/.github/skills/citable/schemas/corroboration-import.schema.json +48 -0
  113. package/dist/universal/.github/skills/citable/schemas/entity-graph.schema.json +75 -0
  114. package/dist/universal/.github/skills/citable/schemas/entity.schema.json +13 -0
  115. package/dist/universal/.github/skills/citable/schemas/observation.schema.json +1 -1
  116. package/dist/universal/.github/skills/citable/schemas/page.schema.json +3 -0
  117. package/dist/universal/.github/skills/citable/schemas/regional-network-import.schema.json +55 -0
  118. package/dist/universal/.github/skills/citable/schemas/schedule.schema.json +1 -1
  119. package/dist/universal/.github/skills/citable/schemas/source-identity-chain.schema.json +83 -0
  120. package/dist/universal/.github/skills/citable/scripts/README.md +3 -1
  121. package/dist/universal/.kiro/skills/citable/SKILL.md +22 -8
  122. package/dist/universal/.kiro/skills/citable/VERSION +1 -1
  123. package/dist/universal/.kiro/skills/citable/agents/citable-auditor.md +64 -0
  124. package/dist/universal/.kiro/skills/citable/agents/citable-semantic-reviewer.md +66 -0
  125. package/dist/universal/.kiro/skills/citable/commands/README.md +4 -1
  126. package/dist/universal/.kiro/skills/citable/commands/action-findings.md +9 -1
  127. package/dist/universal/.kiro/skills/citable/commands/observe-and-act.md +62 -8
  128. package/dist/universal/.kiro/skills/citable/commands/plan-audit.md +35 -0
  129. package/dist/universal/.kiro/skills/citable/commands/reporting.md +57 -0
  130. package/dist/universal/.kiro/skills/citable/manifest.json +29 -16
  131. package/dist/universal/.kiro/skills/citable/schemas/action-plan.schema.json +13 -0
  132. package/dist/universal/.kiro/skills/citable/schemas/browser-evidence-plan.schema.json +14 -0
  133. package/dist/universal/.kiro/skills/citable/schemas/canonical-index-import.schema.json +30 -0
  134. package/dist/universal/.kiro/skills/citable/schemas/common.defs.json +12 -1
  135. package/dist/universal/.kiro/skills/citable/schemas/corroboration-import.schema.json +48 -0
  136. package/dist/universal/.kiro/skills/citable/schemas/entity-graph.schema.json +75 -0
  137. package/dist/universal/.kiro/skills/citable/schemas/entity.schema.json +13 -0
  138. package/dist/universal/.kiro/skills/citable/schemas/observation.schema.json +1 -1
  139. package/dist/universal/.kiro/skills/citable/schemas/page.schema.json +3 -0
  140. package/dist/universal/.kiro/skills/citable/schemas/regional-network-import.schema.json +55 -0
  141. package/dist/universal/.kiro/skills/citable/schemas/schedule.schema.json +1 -1
  142. package/dist/universal/.kiro/skills/citable/schemas/source-identity-chain.schema.json +83 -0
  143. package/dist/universal/.kiro/skills/citable/scripts/README.md +3 -1
  144. package/dist/universal/.opencode/skills/citable/SKILL.md +22 -8
  145. package/dist/universal/.opencode/skills/citable/VERSION +1 -1
  146. package/dist/universal/.opencode/skills/citable/agents/citable-auditor.md +64 -0
  147. package/dist/universal/.opencode/skills/citable/agents/citable-semantic-reviewer.md +66 -0
  148. package/dist/universal/.opencode/skills/citable/commands/README.md +4 -1
  149. package/dist/universal/.opencode/skills/citable/commands/action-findings.md +9 -1
  150. package/dist/universal/.opencode/skills/citable/commands/observe-and-act.md +62 -8
  151. package/dist/universal/.opencode/skills/citable/commands/plan-audit.md +35 -0
  152. package/dist/universal/.opencode/skills/citable/commands/reporting.md +57 -0
  153. package/dist/universal/.opencode/skills/citable/manifest.json +29 -16
  154. package/dist/universal/.opencode/skills/citable/schemas/action-plan.schema.json +13 -0
  155. package/dist/universal/.opencode/skills/citable/schemas/browser-evidence-plan.schema.json +14 -0
  156. package/dist/universal/.opencode/skills/citable/schemas/canonical-index-import.schema.json +30 -0
  157. package/dist/universal/.opencode/skills/citable/schemas/common.defs.json +12 -1
  158. package/dist/universal/.opencode/skills/citable/schemas/corroboration-import.schema.json +48 -0
  159. package/dist/universal/.opencode/skills/citable/schemas/entity-graph.schema.json +75 -0
  160. package/dist/universal/.opencode/skills/citable/schemas/entity.schema.json +13 -0
  161. package/dist/universal/.opencode/skills/citable/schemas/observation.schema.json +1 -1
  162. package/dist/universal/.opencode/skills/citable/schemas/page.schema.json +3 -0
  163. package/dist/universal/.opencode/skills/citable/schemas/regional-network-import.schema.json +55 -0
  164. package/dist/universal/.opencode/skills/citable/schemas/schedule.schema.json +1 -1
  165. package/dist/universal/.opencode/skills/citable/schemas/source-identity-chain.schema.json +83 -0
  166. package/dist/universal/.opencode/skills/citable/scripts/README.md +3 -1
  167. package/dist/universal/.pi/agent/skills/citable/SKILL.md +22 -8
  168. package/dist/universal/.pi/agent/skills/citable/VERSION +1 -1
  169. package/dist/universal/.pi/agent/skills/citable/agents/citable-auditor.md +64 -0
  170. package/dist/universal/.pi/agent/skills/citable/agents/citable-semantic-reviewer.md +66 -0
  171. package/dist/universal/.pi/agent/skills/citable/commands/README.md +4 -1
  172. package/dist/universal/.pi/agent/skills/citable/commands/action-findings.md +9 -1
  173. package/dist/universal/.pi/agent/skills/citable/commands/observe-and-act.md +62 -8
  174. package/dist/universal/.pi/agent/skills/citable/commands/plan-audit.md +35 -0
  175. package/dist/universal/.pi/agent/skills/citable/commands/reporting.md +57 -0
  176. package/dist/universal/.pi/agent/skills/citable/manifest.json +29 -16
  177. package/dist/universal/.pi/agent/skills/citable/schemas/action-plan.schema.json +13 -0
  178. package/dist/universal/.pi/agent/skills/citable/schemas/browser-evidence-plan.schema.json +14 -0
  179. package/dist/universal/.pi/agent/skills/citable/schemas/canonical-index-import.schema.json +30 -0
  180. package/dist/universal/.pi/agent/skills/citable/schemas/common.defs.json +12 -1
  181. package/dist/universal/.pi/agent/skills/citable/schemas/corroboration-import.schema.json +48 -0
  182. package/dist/universal/.pi/agent/skills/citable/schemas/entity-graph.schema.json +75 -0
  183. package/dist/universal/.pi/agent/skills/citable/schemas/entity.schema.json +13 -0
  184. package/dist/universal/.pi/agent/skills/citable/schemas/observation.schema.json +1 -1
  185. package/dist/universal/.pi/agent/skills/citable/schemas/page.schema.json +3 -0
  186. package/dist/universal/.pi/agent/skills/citable/schemas/regional-network-import.schema.json +55 -0
  187. package/dist/universal/.pi/agent/skills/citable/schemas/schedule.schema.json +1 -1
  188. package/dist/universal/.pi/agent/skills/citable/schemas/source-identity-chain.schema.json +83 -0
  189. package/dist/universal/.pi/agent/skills/citable/scripts/README.md +3 -1
  190. package/dist/universal/.qoder/skills/citable/SKILL.md +22 -8
  191. package/dist/universal/.qoder/skills/citable/VERSION +1 -1
  192. package/dist/universal/.qoder/skills/citable/agents/citable-auditor.md +64 -0
  193. package/dist/universal/.qoder/skills/citable/agents/citable-semantic-reviewer.md +66 -0
  194. package/dist/universal/.qoder/skills/citable/commands/README.md +4 -1
  195. package/dist/universal/.qoder/skills/citable/commands/action-findings.md +9 -1
  196. package/dist/universal/.qoder/skills/citable/commands/observe-and-act.md +62 -8
  197. package/dist/universal/.qoder/skills/citable/commands/plan-audit.md +35 -0
  198. package/dist/universal/.qoder/skills/citable/commands/reporting.md +57 -0
  199. package/dist/universal/.qoder/skills/citable/manifest.json +29 -16
  200. package/dist/universal/.qoder/skills/citable/schemas/action-plan.schema.json +13 -0
  201. package/dist/universal/.qoder/skills/citable/schemas/browser-evidence-plan.schema.json +14 -0
  202. package/dist/universal/.qoder/skills/citable/schemas/canonical-index-import.schema.json +30 -0
  203. package/dist/universal/.qoder/skills/citable/schemas/common.defs.json +12 -1
  204. package/dist/universal/.qoder/skills/citable/schemas/corroboration-import.schema.json +48 -0
  205. package/dist/universal/.qoder/skills/citable/schemas/entity-graph.schema.json +75 -0
  206. package/dist/universal/.qoder/skills/citable/schemas/entity.schema.json +13 -0
  207. package/dist/universal/.qoder/skills/citable/schemas/observation.schema.json +1 -1
  208. package/dist/universal/.qoder/skills/citable/schemas/page.schema.json +3 -0
  209. package/dist/universal/.qoder/skills/citable/schemas/regional-network-import.schema.json +55 -0
  210. package/dist/universal/.qoder/skills/citable/schemas/schedule.schema.json +1 -1
  211. package/dist/universal/.qoder/skills/citable/schemas/source-identity-chain.schema.json +83 -0
  212. package/dist/universal/.qoder/skills/citable/scripts/README.md +3 -1
  213. package/dist/universal/.rovodev/skills/citable/SKILL.md +22 -8
  214. package/dist/universal/.rovodev/skills/citable/VERSION +1 -1
  215. package/dist/universal/.rovodev/skills/citable/agents/citable-auditor.md +64 -0
  216. package/dist/universal/.rovodev/skills/citable/agents/citable-semantic-reviewer.md +66 -0
  217. package/dist/universal/.rovodev/skills/citable/commands/README.md +4 -1
  218. package/dist/universal/.rovodev/skills/citable/commands/action-findings.md +9 -1
  219. package/dist/universal/.rovodev/skills/citable/commands/observe-and-act.md +62 -8
  220. package/dist/universal/.rovodev/skills/citable/commands/plan-audit.md +35 -0
  221. package/dist/universal/.rovodev/skills/citable/commands/reporting.md +57 -0
  222. package/dist/universal/.rovodev/skills/citable/manifest.json +29 -16
  223. package/dist/universal/.rovodev/skills/citable/schemas/action-plan.schema.json +13 -0
  224. package/dist/universal/.rovodev/skills/citable/schemas/browser-evidence-plan.schema.json +14 -0
  225. package/dist/universal/.rovodev/skills/citable/schemas/canonical-index-import.schema.json +30 -0
  226. package/dist/universal/.rovodev/skills/citable/schemas/common.defs.json +12 -1
  227. package/dist/universal/.rovodev/skills/citable/schemas/corroboration-import.schema.json +48 -0
  228. package/dist/universal/.rovodev/skills/citable/schemas/entity-graph.schema.json +75 -0
  229. package/dist/universal/.rovodev/skills/citable/schemas/entity.schema.json +13 -0
  230. package/dist/universal/.rovodev/skills/citable/schemas/observation.schema.json +1 -1
  231. package/dist/universal/.rovodev/skills/citable/schemas/page.schema.json +3 -0
  232. package/dist/universal/.rovodev/skills/citable/schemas/regional-network-import.schema.json +55 -0
  233. package/dist/universal/.rovodev/skills/citable/schemas/schedule.schema.json +1 -1
  234. package/dist/universal/.rovodev/skills/citable/schemas/source-identity-chain.schema.json +83 -0
  235. package/dist/universal/.rovodev/skills/citable/scripts/README.md +3 -1
  236. package/dist/universal/.trae/skills/citable/SKILL.md +22 -8
  237. package/dist/universal/.trae/skills/citable/VERSION +1 -1
  238. package/dist/universal/.trae/skills/citable/agents/citable-auditor.md +64 -0
  239. package/dist/universal/.trae/skills/citable/agents/citable-semantic-reviewer.md +66 -0
  240. package/dist/universal/.trae/skills/citable/commands/README.md +4 -1
  241. package/dist/universal/.trae/skills/citable/commands/action-findings.md +9 -1
  242. package/dist/universal/.trae/skills/citable/commands/observe-and-act.md +62 -8
  243. package/dist/universal/.trae/skills/citable/commands/plan-audit.md +35 -0
  244. package/dist/universal/.trae/skills/citable/commands/reporting.md +57 -0
  245. package/dist/universal/.trae/skills/citable/manifest.json +29 -16
  246. package/dist/universal/.trae/skills/citable/schemas/action-plan.schema.json +13 -0
  247. package/dist/universal/.trae/skills/citable/schemas/browser-evidence-plan.schema.json +14 -0
  248. package/dist/universal/.trae/skills/citable/schemas/canonical-index-import.schema.json +30 -0
  249. package/dist/universal/.trae/skills/citable/schemas/common.defs.json +12 -1
  250. package/dist/universal/.trae/skills/citable/schemas/corroboration-import.schema.json +48 -0
  251. package/dist/universal/.trae/skills/citable/schemas/entity-graph.schema.json +75 -0
  252. package/dist/universal/.trae/skills/citable/schemas/entity.schema.json +13 -0
  253. package/dist/universal/.trae/skills/citable/schemas/observation.schema.json +1 -1
  254. package/dist/universal/.trae/skills/citable/schemas/page.schema.json +3 -0
  255. package/dist/universal/.trae/skills/citable/schemas/regional-network-import.schema.json +55 -0
  256. package/dist/universal/.trae/skills/citable/schemas/schedule.schema.json +1 -1
  257. package/dist/universal/.trae/skills/citable/schemas/source-identity-chain.schema.json +83 -0
  258. package/dist/universal/.trae/skills/citable/scripts/README.md +3 -1
  259. package/dist/universal/.trae-cn/skills/citable/SKILL.md +22 -8
  260. package/dist/universal/.trae-cn/skills/citable/VERSION +1 -1
  261. package/dist/universal/.trae-cn/skills/citable/agents/citable-auditor.md +64 -0
  262. package/dist/universal/.trae-cn/skills/citable/agents/citable-semantic-reviewer.md +66 -0
  263. package/dist/universal/.trae-cn/skills/citable/commands/README.md +4 -1
  264. package/dist/universal/.trae-cn/skills/citable/commands/action-findings.md +9 -1
  265. package/dist/universal/.trae-cn/skills/citable/commands/observe-and-act.md +62 -8
  266. package/dist/universal/.trae-cn/skills/citable/commands/plan-audit.md +35 -0
  267. package/dist/universal/.trae-cn/skills/citable/commands/reporting.md +57 -0
  268. package/dist/universal/.trae-cn/skills/citable/manifest.json +29 -16
  269. package/dist/universal/.trae-cn/skills/citable/schemas/action-plan.schema.json +13 -0
  270. package/dist/universal/.trae-cn/skills/citable/schemas/browser-evidence-plan.schema.json +14 -0
  271. package/dist/universal/.trae-cn/skills/citable/schemas/canonical-index-import.schema.json +30 -0
  272. package/dist/universal/.trae-cn/skills/citable/schemas/common.defs.json +12 -1
  273. package/dist/universal/.trae-cn/skills/citable/schemas/corroboration-import.schema.json +48 -0
  274. package/dist/universal/.trae-cn/skills/citable/schemas/entity-graph.schema.json +75 -0
  275. package/dist/universal/.trae-cn/skills/citable/schemas/entity.schema.json +13 -0
  276. package/dist/universal/.trae-cn/skills/citable/schemas/observation.schema.json +1 -1
  277. package/dist/universal/.trae-cn/skills/citable/schemas/page.schema.json +3 -0
  278. package/dist/universal/.trae-cn/skills/citable/schemas/regional-network-import.schema.json +55 -0
  279. package/dist/universal/.trae-cn/skills/citable/schemas/schedule.schema.json +1 -1
  280. package/dist/universal/.trae-cn/skills/citable/schemas/source-identity-chain.schema.json +83 -0
  281. package/dist/universal/.trae-cn/skills/citable/scripts/README.md +3 -1
  282. package/dist/universal/manifest.json +306 -195
  283. package/package.json +1 -1
  284. package/schemas/action-plan.schema.json +13 -0
  285. package/schemas/browser-evidence-plan.schema.json +14 -0
  286. package/schemas/canonical-index-import.schema.json +30 -0
  287. package/schemas/common.defs.json +12 -1
  288. package/schemas/corroboration-import.schema.json +48 -0
  289. package/schemas/entity-graph.schema.json +75 -0
  290. package/schemas/entity.schema.json +13 -0
  291. package/schemas/observation.schema.json +1 -1
  292. package/schemas/page.schema.json +3 -0
  293. package/schemas/regional-network-import.schema.json +55 -0
  294. package/schemas/schedule.schema.json +1 -1
  295. package/schemas/source-identity-chain.schema.json +83 -0
  296. package/scripts/build-dist.js +36 -3
  297. package/skill/SKILL.md +22 -8
  298. package/skill/agents/citable-auditor.md +64 -0
  299. package/skill/agents/citable-semantic-reviewer.md +66 -0
  300. package/skill/commands/README.md +4 -1
  301. package/skill/commands/action-findings.md +9 -1
  302. package/skill/commands/observe-and-act.md +62 -8
  303. package/skill/commands/plan-audit.md +35 -0
  304. package/skill/commands/reporting.md +57 -0
  305. package/src/cli/index.js +115 -15
  306. package/src/commands/actionPlan.js +12 -1
  307. package/src/commands/audit.js +4 -0
  308. package/src/commands/connect.js +29 -0
  309. package/src/commands/context.js +15 -0
  310. package/src/commands/delivery.js +86 -2
  311. package/src/commands/demo.js +36 -0
  312. package/src/commands/fixtures/demo/.citable/claims.yaml +27 -0
  313. package/src/commands/fixtures/demo/.citable/competitors.yaml +3 -0
  314. package/src/commands/fixtures/demo/.citable/config.yaml +18 -0
  315. package/src/commands/fixtures/demo/.citable/crawlers.yaml +30 -0
  316. package/src/commands/fixtures/demo/.citable/entities.yaml +28 -0
  317. package/src/commands/fixtures/demo/.citable/evidence.yaml +19 -0
  318. package/src/commands/fixtures/demo/.citable/experiments.yaml +3 -0
  319. package/src/commands/fixtures/demo/.citable/pages.yaml +54 -0
  320. package/src/commands/fixtures/demo/.citable/prompts.yaml +11 -0
  321. package/src/commands/fixtures/demo/.citable/queries.yaml +10 -0
  322. package/src/commands/fixtures/demo/site/index.html +12 -0
  323. package/src/commands/fixtures/demo/site/learn/execution-governance/index.html +14 -0
  324. package/src/commands/fixtures/demo/site/pricing/index.html +10 -0
  325. package/src/commands/fixtures/demo/site/products/gatekeeper/index.html +15 -0
  326. package/src/commands/fixtures/demo/site/robots.txt +7 -0
  327. package/src/commands/fixtures/demo/site/sitemap.xml +7 -0
  328. package/src/commands/init.js +5 -2
  329. package/src/commands/monitor.js +35 -0
  330. package/src/commands/observe.js +315 -15
  331. package/src/commands/planAudit.js +151 -0
  332. package/src/commands/reportDashboard.js +21 -0
  333. package/src/commands/reportShareOfVoice.js +60 -0
  334. package/src/commands/schemaCmd.js +5 -1
  335. package/src/commands/substantiate.js +22 -10
  336. package/src/connectors/http.js +6 -3
  337. package/src/connectors/index.js +3 -1
  338. package/src/connectors/webflow.js +224 -0
  339. package/src/connectors/wordpress.js +226 -0
  340. package/src/crawler/fetch.js +34 -6
  341. package/src/detectors/geoReco.js +101 -0
  342. package/src/extractor/page.js +17 -0
  343. package/src/installer/index.js +282 -28
  344. package/src/installer/providers.js +11 -0
  345. package/src/monitoring/alertDelivery.js +98 -0
  346. package/src/observations/browserJourney.js +15 -7
  347. package/src/observations/claimDiff.js +83 -0
  348. package/src/observations/common.js +25 -0
  349. package/src/observations/entityGraph.js +89 -0
  350. package/src/observations/renderParity.js +49 -0
  351. package/src/observations/sourceIdentity.js +62 -0
  352. package/src/observations/stance.js +261 -0
  353. package/src/registries/seed.js +95 -0
  354. package/src/registries/seeds/saas-pricing/claims.yaml +18 -0
  355. package/src/registries/seeds/saas-pricing/entities.yaml +20 -0
  356. package/src/registries/seeds/saas-pricing/seed.json +6 -0
  357. package/src/reporting/dashboard.js +254 -0
  358. package/src/reporting/shareOfVoice.js +362 -0
  359. package/src/shared/checklist.js +19 -0
@@ -7,7 +7,7 @@ description: >
7
7
  generative engine optimization, structured data governance, claim substantiation,
8
8
  crawler policy, entity consistency, content discoverability, or wants a site audited
9
9
  for how search and AI systems will retrieve, understand, cite, or recommend it.
10
- version: 1.13.1
10
+ version: 1.15.0
11
11
  ---
12
12
 
13
13
  # Citable — evidence and change control for search and AI citation readiness
@@ -87,6 +87,7 @@ prefer running it over re-deriving its checks by hand:
87
87
  ```
88
88
  citable init # initialize .citable/ (non-destructive)
89
89
  citable audit [scope] --target <dir|url> [--base-url <url>] [--ref-date YYYY-MM-DD]
90
+ citable plan-audit --target <dir|url> [--base-url <url>]
90
91
  citable inspect <page> --target <dir|url>
91
92
  citable map-claims --target <dir|url> [--write]
92
93
  citable substantiate [--write]
@@ -94,19 +95,26 @@ citable schema --target <dir|url>
94
95
  citable validate [registries|claims|evidence|schema|links]
95
96
  citable compare-snapshots [runA runB]
96
97
  citable action-plan [run-id] # ordered actions, blockers, semantic gates, verification
97
- citable observe <mode> [options] # render/index/citation/log/passage/consensus/performance evidence
98
+ citable observe <mode> [options] # render/index/citation/log/probe/passage/consensus/performance/stance evidence
99
+ citable observe stance --input <citations|prompts.json> [--entity <id>]
98
100
  citable observe bing --dataset <search_performance|ai_performance> --input <csv|json>
101
+ citable observe probes --target <url> [--region <label>]
102
+ citable observe network --input <regional-network-import.json>
99
103
  citable observe render --target <url> [--interactions] [--resume-run <run-id>]
100
104
  citable observe render --input <browser-evidence-plan.json>
101
105
  citable observe performance --target <url> --lighthouse [--repeat 1..5]
102
106
  citable apply --input <spec> [--write] # reviewed, hash-locked remediation; dry run by default
103
- citable monitor [runA runB] # observation regression alerts
107
+ citable monitor [runA runB] [--webhook <url>] [--min-severity <sev>] # observation regression alerts
108
+ citable report dashboard [--last N] [--since <run-id>] # cross-run evidence trend (Markdown + HTML)
109
+ citable report share-of-voice [--last N] [--since <run-id>] # competitor citation share (Markdown + HTML)
104
110
  citable metrics import --provider <name> --input <csv|json>
105
111
  citable connect status
106
- citable connect configure --provider <gsc|ga4> --connection-id <id> --property-id <id> [--credential-env <name>] [--write]
107
- citable connect discover --provider <gsc|ga4>
112
+ citable connect configure --provider <gsc|ga4|wordpress|webflow> --connection-id <id> --property-id <id> [--credential-env <name>] [--write]
113
+ citable connect discover --provider <gsc|ga4|wordpress|webflow>
108
114
  citable connect validate --connection-id <id>
109
115
  citable connect sync --connection-id <id> --start-date YYYY-MM-DD --end-date YYYY-MM-DD
116
+ citable connect read --connection-id <id> --target-id <id>
117
+ citable connect apply --connection-id <id> --input <cms-spec.json> [--write]
110
118
  citable connect disconnect --connection-id <id> [--write]
111
119
  citable objectives init --input <json|yaml> [--write]
112
120
  citable objectives validate
@@ -118,7 +126,7 @@ citable reviews prioritize [--write]
118
126
  citable reviews plan --input <json|yaml> [--write]
119
127
  citable reviews sample <sampling-plan-id> [--write]
120
128
  citable reviews evaluate
121
- citable schedules run <schedule-id> [--ref-date YYYY-MM-DD]
129
+ citable schedules run <schedule-id> [--ref-date YYYY-MM-DD] [--monitor] [--webhook <url>]
122
130
  citable project github <run-id>
123
131
  citable observe media --input <manifest.json> [--ocr]
124
132
  citable observe representation --input <release-manifest.json> --target <controlled-url>
@@ -134,8 +142,14 @@ citable artifacts import --input <directory>
134
142
  Audit scopes: `technical seo aeo geo architecture entity claims evidence schema
135
143
  lifecycle corroboration`. Every audit writes an evidence package to
136
144
  `.citable/runs/<run-id>/` (manifest, findings.json, report.md, headers, robots,
137
- sitemaps, schema, link graph, checksums). A report without its evidence package
138
- is not a deliverable.
145
+ sitemaps, raw JSON-LD, normalized entity graph, link graph, checksums). The
146
+ entity graph preserves declared nodes, relations, unresolved references, parse
147
+ failures, and literal visible-text support; it does not prove semantic
148
+ correctness or search-engine recognition. The source identity-chain artifact
149
+ joins declared publisher, author affiliations, content owner, factual reviewer,
150
+ evidence owner, and correction path while preserving missing links. Registry
151
+ linkage does not prove that disclosures are visible, current, or independent.
152
+ A report without its evidence package is not a deliverable.
139
153
 
140
154
  ## Finding-to-action protocol
141
155
 
@@ -1 +1 @@
1
- 1.13.1
1
+ 1.15.0
@@ -0,0 +1,64 @@
1
+ ---
2
+ name: citable-auditor
3
+ description: Run a Citable audit or evidence collection when the user needs a plan, immutable or sealed run, observation, capability diagnosis, or evidence-bounded summary. Not for semantic approval, source remediation, content rewriting, or claims that an outcome is guaranteed.
4
+ tools:
5
+ - Read
6
+ - Glob
7
+ - Grep
8
+ - Bash
9
+ model: inherit
10
+ maxTurns: 20
11
+ skills:
12
+ - citable
13
+ ---
14
+
15
+ You are Citable's evidence-collection specialist. Establish what the target
16
+ makes observable, what the selected method could not collect, and where the
17
+ resulting immutable evidence package lives.
18
+
19
+ ## Authority boundary
20
+
21
+ - You may run the Citable CLI and read its artifacts.
22
+ - Never edit the audited property, its source, its registries, or an existing
23
+ run package.
24
+ - Do not use `curl`, `wget`, raw browser automation, or ad hoc HTTP clients.
25
+ Network collection must go through the applicable guarded Citable command.
26
+ - Do not run `citable apply`, use `--write`, or create implementation facts.
27
+ - Do not infer crawling, indexing, ranking, citation, recommendation,
28
+ inclusion, sentiment, or conversion outcomes.
29
+
30
+ ## Workflow
31
+
32
+ 1. Read repository instructions and identify the target and requested evidence
33
+ question.
34
+ 2. Run `citable doctor` when optional browser, API, OCR, or lab capability is
35
+ relevant. Treat `ready` as prerequisite presence only.
36
+ 3. Run `citable plan-audit --target <target>` when the appropriate scopes or
37
+ collectors are not already explicit. The plan is not evidence.
38
+ 4. Run `citable audit [scope] --target <target>` for deterministic and
39
+ heuristic site findings. Preserve the full audit unless the user explicitly
40
+ requested a scope.
41
+ 5. Run only the relevant `citable observe <mode>` commands for external or
42
+ rendered observations. Preserve provider, method, authority, authenticity,
43
+ collection, and representativeness boundaries.
44
+ 6. Read the run manifest, findings, summary, warnings, incomplete state, and
45
+ checksums before reporting.
46
+
47
+ If prerequisites, authorization, source facts, or required inputs are absent,
48
+ preserve `blocked`, `incomplete`, `not_established`, or `not_evidenced`.
49
+ Never translate one of those states into zero, pass, absence, or failure of the
50
+ external system.
51
+
52
+ ## Return contract
53
+
54
+ Report:
55
+
56
+ 1. target, command, scope, and collection method;
57
+ 2. run ID and artifact directory;
58
+ 3. deterministic observations;
59
+ 4. evidence-backed semantic findings and probabilistic inferences, separately;
60
+ 5. skipped checks, collection failures, limitations, and residual unknowns;
61
+ 6. exact next evidence or owner input required;
62
+ 7. whether semantic review or a governed action plan is the next bounded step.
63
+
64
+ A human-readable report without its run package is not a deliverable.
@@ -0,0 +1,66 @@
1
+ ---
2
+ name: citable-semantic-reviewer
3
+ description: Review semantic questions in an existing Citable run, finding, action, or artifact, including claim support, answer extractability, entity clarity, comparison fairness, and narrative accuracy. Not for collecting new evidence, running audits, editing source, or approving publication.
4
+ tools:
5
+ - Read
6
+ - Glob
7
+ - Grep
8
+ model: inherit
9
+ maxTurns: 15
10
+ skills:
11
+ - citable
12
+ ---
13
+
14
+ You are Citable's read-only semantic reviewer. Evaluate meaning against the
15
+ exact source evidence and review policy without changing technical findings,
16
+ registries, source files, or sealed artifacts.
17
+
18
+ ## Preconditions
19
+
20
+ Require an existing source run, finding, review item, or action artifact. Bind
21
+ the review to the available run ID, finding ID and finding hash, review-item
22
+ hash, policy, subject, captured evidence, and declared limitations. If the
23
+ binding or source material is unavailable, return `review_required` with the
24
+ missing input instead of reconstructing it.
25
+
26
+ ## Review dimensions
27
+
28
+ Apply only dimensions relevant to the requested item:
29
+
30
+ - intent alignment and answer extractability;
31
+ - claim boundedness and evidence strength;
32
+ - entity clarity and source identity;
33
+ - information gain and comparison fairness;
34
+ - recommendation eligibility and narrative accuracy;
35
+ - factual accuracy, accessibility, conversion function, legal defensibility,
36
+ and maintainability.
37
+
38
+ Separate deterministic fact from evidence-backed semantic finding,
39
+ probabilistic inference, strategic hypothesis, experiment result, and
40
+ untestable condition. Never present inference as fact.
41
+
42
+ ## Authority boundary
43
+
44
+ - Never edit source files, registries, findings, review items, action plans, or
45
+ sealed run artifacts.
46
+ - Do not collect new external evidence or treat general knowledge as source-run
47
+ evidence.
48
+ - Do not change a technical failure to pass or accepted risk.
49
+ - Do not mark a claim `verified`, complete a required review, approve
50
+ publication, or satisfy an owner-controlled gate. Automation cannot upgrade
51
+ evidence authority.
52
+ - Preserve `review_required` when evidence or accountable authority is missing.
53
+ - Preserve `adjudication_required` when current authorized reviewers disagree.
54
+
55
+ ## Return contract
56
+
57
+ For each reviewed item, report:
58
+
59
+ 1. artifact binding and review dimensions applied;
60
+ 2. supporting and contradicting evidence;
61
+ 3. semantic assessment with confidence and false-positive conditions;
62
+ 4. missing evidence, ambiguity, residual risk, and required owner input;
63
+ 5. proposed disposition: `review_required`, `adjudication_required`, or a
64
+ recommendation for an authorized human reviewer to record.
65
+
66
+ Your output is review context, not an approval or a mutation instruction.
@@ -21,9 +21,12 @@ intent, not executability, so statuses are strict:
21
21
  | /citable validate, validate-claims, validate-evidence, validate-schema, validate-links | implemented |
22
22
  | /citable compare-snapshots / validate-regression | implemented |
23
23
  | /citable action-plan | implemented — writes ordered, source-run-bound action artifacts outside immutable evidence packages |
24
- | /citable observe | implemented — render, index, citation, crawler-log, passage, consensus, performance, and corroboration evidence |
24
+ | /citable observe | implemented — render, index, citation, crawler-log, passage, consensus, performance, corroboration, and stance evidence |
25
25
  | /citable apply | implemented — reviewed, hash-locked source replacements; dry run by default |
26
+ | /citable connect status / configure / discover / validate / sync / read / apply / disconnect | implemented — GA4, GSC, WordPress, and Webflow adapters with hash-locked CMS remediation |
26
27
  | /citable monitor | implemented — compares immutable observation runs and emits evidence-linked alerts |
28
+ | /citable report dashboard | implemented — folds each run's recorded summary into a cross-run Markdown/HTML trend; derives no new findings and no combined score |
29
+ | /citable report share-of-voice | implemented — joins competitor registry against recorded citation observations to compute verified share-of-citation |
27
30
  | /citable metrics import | implemented — validates declared CSV/JSON metrics and writes immutable observations |
28
31
  | /citable objectives init / validate | implemented — user-owned metric selection, cohorts, windows, and guardrails |
29
32
  | /citable evaluate | implemented — independent baseline/evaluation comparisons with inconclusive handling |
@@ -15,6 +15,11 @@ failure_behaviour: missing or invalid source run -> fail; review-required action
15
15
  3. Assign owners. Resolve each blocked action's exact required input. Missing
16
16
  facts, evidence, legal review, or semantic review are blockers, not drafting
17
17
  opportunities.
18
+ Treat `decision_owner` independently from implementation responsibility when
19
+ the generated plan names different roles. Empty `depends_on_action_ids`,
20
+ `leading_indicators`, or `monitoring_window` fields mean those relationships
21
+ are not established by the source evidence; do not fill them with generic
22
+ SEO assumptions.
18
23
  4. Capture a before state for each subject. Use the finding's evidence,
19
24
  preferred remediation, unsafe shortcuts, and detector lineage as the change
20
25
  boundary.
@@ -24,7 +29,10 @@ failure_behaviour: missing or invalid source run -> fail; review-required action
24
29
  writes use the loader/saver and retain history. Content claims remain equal
25
30
  to or narrower than their registered scope.
26
31
  7. Build and test the target repository. Run the generated verification
27
- command, then compare the new audit to the source run.
32
+ command, evaluate the explicit `failure_condition`, then compare the new
33
+ audit to the source run. Monitor only the listed leading indicators over the
34
+ declared window; an empty list or null window does not authorize an inferred
35
+ outcome measure.
28
36
  8. Close only with evidence: resolved detector/subject pair, before/after run
29
37
  IDs, diff, reviewer, and residual risk. Mark blocked, accepted risk, and
30
38
  false positive explicitly; do not silently drop findings.
@@ -19,22 +19,69 @@ failure_behaviour: unavailable dependency, credential, source run, reviewer, exa
19
19
  browser version, device, JavaScript, locale, consent, authentication state,
20
20
  and ordered interaction steps. Fill/select values are referenced by
21
21
  environment-variable name and are never written to the plan or artifacts.
22
+ Targets, subresources, and navigation steps must remain on public network
23
+ destinations; unsupported schemes and configured non-public address ranges
24
+ are blocked. DNS validation does not pin the later browser connection, so
25
+ isolated execution with egress controls remains required for untrusted URLs.
26
+ Plans may include a strict semantic-impact policy covering text retention,
27
+ heading, link, and structured-data parity. Deterministic violations name a
28
+ review owner and always remain `review_required`; passing configured checks
29
+ does not establish semantic or retrieval equivalence.
22
30
  - `observe index --input <JSON>` imports owner exports. With `--target`,
23
31
  `--site-url`, and `GSC_ACCESS_TOKEN`, it calls Google URL Inspection, which
24
32
  reports the indexed version rather than performing a live indexability test.
25
33
  - `observe citations --input <JSON>` imports complete controlled observations.
26
34
  With `--endpoint`, the input is a versioned prompt corpus and each prompt runs
27
35
  1-20 times (default 3) through the disclosed adapter protocol. An API is not
28
- presumed equivalent to a provider's consumer search experience.
36
+ presumed equivalent to a provider's consumer search experience. Adapter
37
+ endpoints require HTTPS, must resolve only to public destinations, and may
38
+ not redirect.
39
+ Citation objects may include a strict `source_profile` containing declared
40
+ format, word and heading counts, freshness date, and evidence features.
41
+ Competitive summaries group these profiles by cited domain. Imported profile
42
+ values are comparative metadata, not independently fetched or verified
43
+ qualities.
29
44
  - `observe logs --input <JSON>` imports server/CDN records. User-agent matches
30
45
  without IP verification remain low confidence.
46
+ - `observe probes --target <URL> [--region <label>]` sends one bounded synthetic
47
+ request for every active identity in `crawlers.yaml`, preserving response
48
+ bodies, safe diagnostic headers, redirects, and coarse edge/challenge
49
+ classification. The request merely spoofs each declared user agent: it does
50
+ not establish crawler identity, production access, regional
51
+ representativeness, or alignment between declared policy and actual crawler
52
+ treatment.
53
+ - `observe network --input <JSON>` accepts a strict regional runner export with
54
+ region, network, user agent, DNS answers, TLS authorization/fingerprint,
55
+ status, latency, and cache state for every probe. Citable validates and seals
56
+ these observations but does not operate the runner or infer global coverage.
31
57
  - `observe passages|consensus --target <dir|URL>` performs static extraction.
58
+ Passage observations include raw/extracted byte and visible-token ratios plus
59
+ exact repeated header, navigation, aside, and footer regions across the
60
+ audited page cohort. These classifications are descriptive and do not imply
61
+ content harm, retrieval effects, or ranking effects.
62
+ Versioned passage records also join declared page prompts, questions, and
63
+ expected answer components. This only creates review context:
64
+ question-to-passage suitability remains `review_required`.
65
+ Consensus normalizes parseable HTTP, sitemap, and visible/meta freshness
66
+ dates, preserves conflicts and invalid values, and compares the current
67
+ content hash with the latest immutable page snapshot. A detected hash change
68
+ establishes only an interval after the prior capture—not an exact change
69
+ time, cause, quality improvement, or ranking effect. Lifecycle review dates
70
+ remain a separate governance signal.
71
+ `observe consensus --input <canonical-index-import.json>` additionally joins
72
+ schema-validated engine-selected canonical observations while preserving
73
+ their collection authority and authenticity. Missing engine observations
74
+ remain `null`; they are never inferred from static declarations.
32
75
  - `observe performance` imports evidence or calls CrUX with `CRUX_API_KEY`.
33
76
  `--lighthouse` instead performs 1-5 local lab runs (default 3) using optional
34
77
  `lighthouse` and `chrome-launcher` peers, preserving each result and a median
35
78
  summary. Lab evidence remains separate from CrUX field evidence.
36
- - `observe corroboration --input <JSON>` records observable external mentions;
37
- controlled or unverified sources do not become authority claims.
79
+ - `observe corroboration --input <JSON>` accepts only the versioned
80
+ `corroboration-import` contract. Each mention must disclose source control,
81
+ relationship, collection authority, authenticity, and dataset coverage.
82
+ Legacy independence booleans and undisclosed control fail closed. An
83
+ observable mention does not establish source authority, claim support,
84
+ ranking impact, citation eligibility, or representative coverage.
38
85
 
39
86
  ## Guarded remediation
40
87
 
@@ -44,9 +91,16 @@ reviewer, matches the exact file hash, and identifies exactly one source string.
44
91
  `--write` applies only after all operations validate. Build, tests, semantic
45
92
  review, re-audit, and snapshot comparison remain mandatory afterward.
46
93
 
47
- ## Monitoring
94
+ ## Monitoring and alert delivery
48
95
 
49
- `monitor [runA runB]` reports state changes, missing observations, index loss,
50
- canonical disagreement, and citation-presence changes. Alerts are evidence
51
- changes, not causal explanations or ranking conclusions. Schedule it in CI at
52
- the cadence defined by lifecycle and experiment records.
96
+ `monitor [runA runB] [--webhook <url>] [--min-severity <level>]` reports state
97
+ changes, missing observations, index loss, canonical disagreement, and
98
+ citation-presence changes. With `--webhook`, detected regressions matching or
99
+ exceeding `--min-severity` (default `medium`) are dispatched as sealed JSON
100
+ alert payloads and logged under `.citable/monitoring/deliveries/`. Destination
101
+ URLs must be public network destinations (private/loopback addresses are blocked).
102
+ Alerts are evidence changes, not causal explanations or ranking conclusions.
103
+
104
+ Scheduled monitoring (`schedules run <id> --monitor [--webhook <url>]`) automatically
105
+ compares the scheduled audit against the preceding baseline run and dispatches
106
+ regression alerts when configured in `schedules.yaml`.
@@ -0,0 +1,35 @@
1
+ ---
2
+ command: /citable plan-audit --target <dir|url>
3
+ 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.
4
+ preconditions: [readable built output directory or permitted public URL]
5
+ artifacts_created: []
6
+ failure_behaviour: missing or unreadable target -> fail; fewer than two supporting signals -> no profile established; unavailable optional prerequisite -> collector blocked
7
+ ---
8
+
9
+ # Profile-aware audit planning
10
+
11
+ 1. Run `citable plan-audit --target <dir|url>` before choosing optional
12
+ collectors. The command builds the same bounded site model used by audit but
13
+ does not create an audit, observation, snapshot, or remediation artifact.
14
+ 2. Treat every returned profile as `probabilistic_inference`. Preserve its
15
+ confidence and evidence list. A profile changes semantic emphasis only; it
16
+ does not suppress detectors or establish the target's business model.
17
+ 3. Use the proposed full audit as the deterministic baseline. Do not translate
18
+ an inferred profile into a reduced audit that could hide cross-discipline
19
+ findings.
20
+ 4. Read collector states independently. `available` means the prerequisite is
21
+ present, not that browser launch, authorization, property access, quota, or
22
+ collection will succeed. `blocked` lists the missing input and remains
23
+ unresolved until the relevant collector produces evidence.
24
+ 5. Keep profile-specific emphasis bounded:
25
+ SaaS focuses review on pricing, capability claims, and product identity;
26
+ e-commerce on product/offer support; local on identity/NAP and review
27
+ evidence; publisher on authorship/freshness; multilingual on hreflang and
28
+ parity; API/docs on machine interfaces and authentication claims.
29
+
30
+ # Refusal boundary
31
+
32
+ Do not invent an industry, customer segment, locale strategy, product catalog,
33
+ local presence, or API capability to complete the plan. If no profile reaches
34
+ the two-signal threshold, report that none is established and run the full
35
+ audit without profile-specific emphasis.
@@ -0,0 +1,57 @@
1
+ ---
2
+ command: /citable report dashboard [--last N] [--since <run-id>]
3
+ purpose: Fold the summary each audit run already recorded into a cross-run Markdown table and self-contained HTML page without deriving new findings, scores, or causal explanations.
4
+ preconditions: [at least one finalized audit run under .citable/runs/ with a summary.json]
5
+ failure_behaviour: fewer than two audit runs -> explicit insufficient-history state, not a trend; unreadable summary or manifest -> run reported under skipped runs; non-integer --last -> fail
6
+ artifacts_created: [.citable/reports/dashboard.md, .citable/reports/dashboard.html]
7
+ ---
8
+
9
+ # Cross-run evidence reporting
10
+
11
+ 1. Run `citable report dashboard` to read severity counts, retrieval
12
+ eligibility, source extraction and support, and observed citation presence
13
+ rate across run history. Every value is copied from a run's own
14
+ `summary.json`. The command runs no detector, opens no network connection,
15
+ and never edits an immutable run package.
16
+ 2. Treat the output as derived, not canonical. It is written to
17
+ `.citable/reports/`, alongside `monitor` and `action-plan` derived
18
+ artifacts. The evidence of record remains `.citable/runs/<run-id>/`.
19
+ 3. Window the history with `--since <run-id>` (keeps that run and everything
20
+ after it) and `--last N` (keeps the final N runs). Run IDs sort
21
+ chronologically, so both filters are deterministic.
22
+ 4. Read fewer than two runs as no trend. With zero or one run the dashboard
23
+ states insufficient history explicitly instead of drawing a line through a
24
+ single point. Direction, rate of change, and improvement are not established
25
+ by one observation.
26
+ 5. Read skipped runs as a gap in the series, not as absence of a problem. A run
27
+ whose `summary.json` or `manifest.json` cannot be parsed, and an observation
28
+ run whose summary records no severity or posture, is listed with its reason
29
+ rather than counted as zero findings.
30
+ 6. Read a falling count as an observed difference between runs, not as proof
31
+ that a condition was fixed. Use `citable compare-snapshots` to establish
32
+ whether two runs are comparable at all — detector set, configuration,
33
+ observation method, and tool version all change what a count means.
34
+
35
+ # Refusal boundary
36
+
37
+ Do not present the dashboard as an AI visibility score, a ranking forecast, or
38
+ a measure of citation likelihood. The three posture dimensions are reported
39
+ separately and are never combined into a single number. Do not interpolate,
40
+ estimate, or carry forward a missing value: a run with no evidenced citation
41
+ presence rate is omitted from that trend line, not filled in. Do not attribute
42
+ any observed change to a specific intervention.
43
+
44
+ # Share of voice and competitor reporting
45
+
46
+ 1. Run `citable report share-of-voice [--last N] [--since <run-id>]` to evaluate
47
+ first-party and competitor citation presence and share across recorded
48
+ `observe citation` runs.
49
+ 2. Contested competitor domains are loaded from `.citable/competitors.yaml`.
50
+ Citations whose canonical URL matches declared competitor domains are joined
51
+ into per-prompt and aggregate shares.
52
+ 3. Competitor share is calculated strictly from evidenced observations; missing
53
+ observations or unevaluated prompts are never filled with fabricated zeros or
54
+ interpolated estimates.
55
+ 4. Outputs are written to `.citable/reports/share-of-voice.md` and
56
+ `.citable/reports/share-of-voice.html`.
57
+
@@ -1,14 +1,20 @@
1
1
  {
2
2
  "name": "citable",
3
- "version": "1.13.1",
3
+ "version": "1.15.0",
4
4
  "managedBy": "citable-cli",
5
5
  "provider": "gemini",
6
6
  "providerName": "Gemini CLI",
7
7
  "scope": "bundle",
8
- "sourcePackage": "@nebulacomponents/citable@1.13.1",
8
+ "sourcePackage": "@nebulacomponents/citable@1.15.0",
9
9
  "variantPath": ".gemini/skills/citable",
10
+ "agentProfiles": {
11
+ "status": "unsupported",
12
+ "reason": "native agent profile discovery and permission contract not verified for this host"
13
+ },
10
14
  "files": {
11
- "commands/action-findings.md": "sha256:510361461f24fcd4a550e0a8d960c383aefe23f9a65a54a3ffc44abd4c1293e7",
15
+ "agents/citable-auditor.md": "sha256:06fe8d84834b2c09b7e7083aa6f57e94e837e0643dbe4ead4bbecf651fb41cad",
16
+ "agents/citable-semantic-reviewer.md": "sha256:77582263a048ea41ae3f7ee326dbd036222fab81ed83bda98034ec83ee21ef2e",
17
+ "commands/action-findings.md": "sha256:b1d5c4d8d8b1092bc73b99430bea0a2e460031658e42bed33eb94da9a3c0e48f",
12
18
  "commands/artifact-interchange.md": "sha256:18d56fbfa6bb3f23f08593a9a8135e51c268618b049e53c793969b68000875c3",
13
19
  "commands/delivery.md": "sha256:3b29250f9e9f84442812e320a70d5d2784b4286e91af3866f99cb6062a85a10f",
14
20
  "commands/field-validation.md": "sha256:4f24b2758eef746d704b218364f1e45ee9e07418c8ae111081b1fd41f93dde2d",
@@ -16,10 +22,12 @@
16
22
  "commands/ingest.md": "sha256:cf35659aecd9d0e160909003efdbe056864fc5d824c71b4ef0ee801ce07ff598",
17
23
  "commands/measurement.md": "sha256:9cade6dfec23338e18aa67ede3335ac9e2888dc577a7d4d8e3ceac948bce403f",
18
24
  "commands/media-evidence.md": "sha256:f2218feabe3360a2c9d569a5fa9b70d4b33a83a270d657151635e6f404fb34e0",
19
- "commands/observe-and-act.md": "sha256:3862708da9d787d61a9c7bc8639b2fb28bc021d5784e11f313b0e9ecdff261bc",
25
+ "commands/observe-and-act.md": "sha256:32ad048f14610de0e9a00a7faf27ff18ec0d892f5b20d568f519e44a7ffc0faf",
20
26
  "commands/optimize-page.md": "sha256:35866f3d7cdeef0376ea7a7d7036085a9b9cf95bbb300ecf4bd77610ebd74d85",
21
27
  "commands/page-work.md": "sha256:965a66e59bdf7b0da482d26fade53b3d265885ece5d463fe83b0789ebefaef3e",
22
- "commands/README.md": "sha256:c27f69e0e33712e00f780c0988c7b033650c17d3450baea33f2b14212be8438e",
28
+ "commands/plan-audit.md": "sha256:69875c9654e13b84566dafb16afe5afe08cffb9f3bded1f2d8d2261ae871c869",
29
+ "commands/README.md": "sha256:a8242f715219a549ad4b40a3573b62e1d2249a76a3162622e0cd61f80682d971",
30
+ "commands/reporting.md": "sha256:b4e7003d291180ddac574915ebc17a05faac0a72acf5ae2f21bcaa59d273e7ad",
23
31
  "commands/reviews.md": "sha256:902904aaa405fe5724cf0662c7a5a36eab9a4fe0eb81cbd95ffa2fff946e0ac8",
24
32
  "commands/validate-render.md": "sha256:a8e1d04d40b84d57c35039250d98c6a7302cd44a148a8c3b9d9cfb92678c4347",
25
33
  "policies/crawler-policy-template.md": "sha256:15c88a4eeb21f53f71e5250dd3eb2d2791a814b304eaefce8bb30e2bdf2e2e59",
@@ -43,24 +51,27 @@
43
51
  "schemas/acceptance-corpus.schema.json": "sha256:b703be371ee33747d83814e448d18cd01f103f1832480a95df4331b86982165d",
44
52
  "schemas/acceptance-run-context.schema.json": "sha256:56d75c7bcd166c3578a71699df1aa5466327c23c1e06e33773f2493f5caa1a50",
45
53
  "schemas/acceptance-run-receipt.schema.json": "sha256:6c6e66767cf3b9adb42ace087f7e9a428312f41b7ecbaf533fc8d7ba5953da44",
46
- "schemas/action-plan.schema.json": "sha256:4b6c4c877840a065c7c0c0c7b52f696502bf3d4ca6d31179622fc364ea868d5e",
54
+ "schemas/action-plan.schema.json": "sha256:e2ca871c92595a55ac56248cd87df67d94449ac39ac216e60751baaec5b74f1e",
47
55
  "schemas/artifact-interchange.schema.json": "sha256:c6f628934c8a1b8ea2996e03c2c5abd46c2a0e74c680b0a43e44c2343dc9aa21",
48
56
  "schemas/assumption.schema.json": "sha256:31a0f44bbf1d207e013961ec4c39eea85c3ae9efde1485b5e26084562c816844",
49
57
  "schemas/bing-webmaster.schema.json": "sha256:8357c518a8cb4ccd1def2da38950fbba68270e2b1613ad522b50c568a3b8538f",
50
- "schemas/browser-evidence-plan.schema.json": "sha256:f2c1a3fe05cdaf72a41c0a3d548ccf5bdf247dbe71b546759b15277df0e723ba",
58
+ "schemas/browser-evidence-plan.schema.json": "sha256:81ef14f665b4a00f01afb747576faeb06025722e5c15a36eff3d17e59e978851",
59
+ "schemas/canonical-index-import.schema.json": "sha256:ef633662cb30873242ca356443bc4835afe56bb020208e8f42fa47ac8047b66e",
51
60
  "schemas/claim.schema.json": "sha256:ce79ccbfa34ece9b7a309a6962522ea06a1f44c468b4c472b5c376554a788537",
52
- "schemas/common.defs.json": "sha256:effdd812910d1c275c50520bb70d8aec085e53fa8cb68054dc58c04a5d4a66b3",
61
+ "schemas/common.defs.json": "sha256:ac66081df6b86f652e066ea868edecfcd36cdd1b1c81e55a1e3af880f671b727",
53
62
  "schemas/competitor.schema.json": "sha256:2f6fd7e4543846bde56ff4dc62bb41fa366889787b794a7cdb0bff1a3392e591",
54
63
  "schemas/config.schema.json": "sha256:a87f3bb0087de09035b9f2dafea66e32e4fcc2e3e329abcd0fd8a5ec33318f2a",
55
64
  "schemas/connection.schema.json": "sha256:abcedde8d62d0c0663d4f959e06132a617908058ed965078965445ef3b108310",
56
65
  "schemas/corpus-publication-receipt.schema.json": "sha256:a4d523fd1c1fa53762522891c06c06edb668cd15e1de3c7123d2b9948445ae32",
66
+ "schemas/corroboration-import.schema.json": "sha256:927983d0590f1ec569e86195d2031be0cd212f9436ff98acca468cbae108d85e",
57
67
  "schemas/crawler-identity.schema.json": "sha256:e1e3e6da203a8bc49fba8f9bbde525368891db022d542fc615b677401825351d",
58
68
  "schemas/crawler.schema.json": "sha256:1a113dfb80bc6cde904c3ea648c82ea1d88fe50f2c1a0e7175d44abba28ac64e",
59
69
  "schemas/customer-outcome.schema.json": "sha256:c0cdfee31a692feadb31dc6be734d45ae178ee53f28349c2a9e7504bdfcf9e50",
60
70
  "schemas/decision.schema.json": "sha256:7c30f3ad83a6aa0b67ecc51ac6691e5e041b633d01bab17cee2b5218d926204e",
61
71
  "schemas/deployment-receipt.schema.json": "sha256:789455907e7f3039fd55ee5b2568e09871128f513f5ddfe1f3afac1a4dd6b2bd",
62
72
  "schemas/detector-quality.schema.json": "sha256:5e9e1ac80b1198a0ff8fa17b9f7a543d3ccf3ed3d60196152f6ff095cfdebccd",
63
- "schemas/entity.schema.json": "sha256:78a08c35c8f4eb7a804ab46b61a238502f59621ac5218991e783251fbde61c4f",
73
+ "schemas/entity-graph.schema.json": "sha256:b9cc1312e3c7657d301e63c8dd302d79c7348f245ce3c324eeaa1e796720b74b",
74
+ "schemas/entity.schema.json": "sha256:ce7cb7a0117a2fbd3032c9f244ab43855b47b285b81313513c3bb3287d37a33b",
64
75
  "schemas/evidence-authority.schema.json": "sha256:4f8165a37304ebab019e1c2dfec13f1168ecf89ce9bec88f7dca9c8554e39ac0",
65
76
  "schemas/evidence.schema.json": "sha256:76baec7ad7e89c6952473c01dacb9e3b26953c088331e6314d531ce620df9ec1",
66
77
  "schemas/exception.schema.json": "sha256:c88985494ec66554330fdc5b65d033527d0005acf41f10798b1e831d171f8944",
@@ -73,12 +84,13 @@
73
84
  "schemas/media-manifest.schema.json": "sha256:3f37301aab9e913fa7febb15c720ed6384b106f12cef8d26cdd12d93fd85b41f",
74
85
  "schemas/metric.schema.json": "sha256:2ada648e7274a8d78cc9d6e7ed616f91faa79cf9ed07613e2c1fc53b247aac8d",
75
86
  "schemas/objective.schema.json": "sha256:94404dc95d04a6641ea7b9654317d0222793251ad44d3dfd2875738622a36025",
76
- "schemas/observation.schema.json": "sha256:b572ae8ba3d175509cc9fae914d8d054c0fb84ebcaf81de981532b527064538d",
77
- "schemas/page.schema.json": "sha256:627613c35f461177fa946df08edf66fbf6f6bbdfc57eef812572b3af796d5e07",
87
+ "schemas/observation.schema.json": "sha256:a5daabab86dacaa1a81e1f4c4900a0332bb3bf657ffeed60e5c6e0c5a8e5b7da",
88
+ "schemas/page.schema.json": "sha256:11d116b22ab79c152cfc7bbbec3a00cebe6dcd8ea2845b0ce819c15111fb0166",
78
89
  "schemas/project.schema.json": "sha256:ea48fdb6480f7047ba4594bd5908bc1f79c1ad6b9a2c204df900959b5f203dc6",
79
90
  "schemas/prompt-result.schema.json": "sha256:b55be47d7d58d7b1dd8c3b1e849e24e55216212c592cde7eb836953379b85737",
80
91
  "schemas/prompt.schema.json": "sha256:7f0f50c83a86ac91faa7b79895dbc1fed371e8c0342e18d8c2877cc81f4f0f4c",
81
92
  "schemas/query.schema.json": "sha256:3c0793a8c0c48ab39320416790840b345ea987696f35b1cc364f23245a62aacb",
93
+ "schemas/regional-network-import.schema.json": "sha256:9dc1062fbab9b98ccc485d605bb7e7d65d21449cccc17005251d4efea910fed0",
82
94
  "schemas/release-manifest.schema.json": "sha256:962be645e790b5f3dc6f6ea455e187492d727dcb91d00f91e4e25b40e2dbc360",
83
95
  "schemas/release-state.schema.json": "sha256:9920f68e538915d0d07044f313a9e410775a38ce9bb46a55d9ebe02970784803",
84
96
  "schemas/remediation-spec.schema.json": "sha256:6fe8cb773702862ba6d261198bb5cc2dca3eca0a2310a60ebddd04377654df8d",
@@ -89,12 +101,13 @@
89
101
  "schemas/run.schema.json": "sha256:46c3178620f3a358d936d535aeadb83454b9b35b551e53e6615cc9862063dacb",
90
102
  "schemas/sampling-plan.schema.json": "sha256:005f70f149baaacd7de698548d556d3e401c630978748271b0e14a74726dd413",
91
103
  "schemas/scenario.schema.json": "sha256:3f5bc2032d08f973600db068f475176a0e4706b33be42f99c778fe755a0ff38b",
92
- "schemas/schedule.schema.json": "sha256:0f02174ab0fc7bbbce9759fd358b18ed97cc683c76933fd3001cf053c499b157",
104
+ "schemas/schedule.schema.json": "sha256:645df065bf33577a960c0bf8bb97e141e9326840303569468dae8a553d468482",
105
+ "schemas/source-identity-chain.schema.json": "sha256:a65d9c12eaed1bd6b637c66a2f9362c17287fdfcb454d8676fb611d2d28aa019",
93
106
  "schemas/variance.schema.json": "sha256:68389f64f0a3be13ff8951e8eefba9a5c31d0738325cb47e37c1a8435bea48f0",
94
- "scripts/README.md": "sha256:1c3e952950ef353849621b07c5f615bf7cd20cc5654da4635492a7bd6384e747",
95
- "SKILL.md": "sha256:27be7a85cff672dfd0ed505b4b4a2af7572aa5c33ff98ef6c8497183acc5dabe",
107
+ "scripts/README.md": "sha256:9eee4e8beb4579a183bd714c9dd24b83abd020753eada5caeffae004739d60b5",
108
+ "SKILL.md": "sha256:b1aaeca8a5b2489e904d6d68491b9df409b5ec4599868e91892bb70c13771422",
96
109
  "templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
97
- "VERSION": "sha256:ca0bc79c4cde0ad64e1ec9df2882425197b5ba85704a4ac6bd67f8f99936eb25"
110
+ "VERSION": "sha256:d5b1f46669d1cff3be556b1656732c8777ad8ad3f3d05459cfb11dadb1f17d19"
98
111
  },
99
- "treeHash": "sha256:d263f9f8d9be899e61d93ccedb51a671dacb679b6bc97fad128e27ccd4b6e420"
112
+ "treeHash": "sha256:d0e363afa74d831ac7721911acf254eb3c8b613d3c56cc55b596d99c789cc7c7"
100
113
  }
@@ -28,15 +28,28 @@
28
28
  "properties": {
29
29
  "action_id": { "$ref": "citable://schemas/common.defs.json#/definitions/id" },
30
30
  "finding_ids": { "type": "array", "minItems": 1, "items": { "type": "string" } },
31
+ "depends_on_action_ids": {
32
+ "type": "array",
33
+ "uniqueItems": true,
34
+ "items": { "$ref": "citable://schemas/common.defs.json#/definitions/id" }
35
+ },
31
36
  "phase": { "type": "string", "enum": ["unblock", "governance", "content", "optimization"] },
32
37
  "priority": { "type": "string", "enum": ["critical", "high", "medium", "low"] },
33
38
  "subject": { "type": "string" },
34
39
  "action": { "type": "string", "minLength": 1 },
35
40
  "owner": { "type": ["string", "null"] },
41
+ "decision_owner": { "type": ["string", "null"] },
36
42
  "status": { "type": "string", "enum": ["ready", "blocked"] },
37
43
  "required_input": { "type": "array", "items": { "type": "string" } },
38
44
  "semantic_gates": { "type": "array", "items": { "type": "string" } },
39
45
  "unsafe_shortcuts": { "type": "array", "items": { "type": "string" } },
46
+ "failure_condition": { "type": "string", "minLength": 1 },
47
+ "leading_indicators": {
48
+ "type": "array",
49
+ "uniqueItems": true,
50
+ "items": { "type": "string", "minLength": 1 }
51
+ },
52
+ "monitoring_window": { "type": ["string", "null"], "minLength": 1 },
40
53
  "verification": {
41
54
  "type": "object",
42
55
  "additionalProperties": false,
@@ -9,6 +9,20 @@
9
9
  "schema_version": { "const": 1 },
10
10
  "plan_id": { "type": "string", "pattern": "^BROWSER-PLAN-[A-Z0-9_-]+$" },
11
11
  "target": { "type": "string", "format": "uri", "pattern": "^https?://" },
12
+ "semantic_impact_policy": {
13
+ "type": "object",
14
+ "additionalProperties": false,
15
+ "required": ["policy_id", "review_owner", "min_text_retention_ratio", "require_heading_parity", "require_link_parity", "require_structured_data_parity", "limitations"],
16
+ "properties": {
17
+ "policy_id": { "type": "string", "pattern": "^RENDER-POLICY-[A-Z0-9_-]+$" },
18
+ "review_owner": { "type": "string", "minLength": 1 },
19
+ "min_text_retention_ratio": { "type": "number", "minimum": 0, "maximum": 1 },
20
+ "require_heading_parity": { "type": "boolean" },
21
+ "require_link_parity": { "type": "boolean" },
22
+ "require_structured_data_parity": { "type": "boolean" },
23
+ "limitations": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } }
24
+ }
25
+ },
12
26
  "profiles": {
13
27
  "type": "array",
14
28
  "minItems": 1,