@nebulacomponents/citable 1.11.0 → 1.13.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 (397) hide show
  1. package/CHANGELOG.md +151 -0
  2. package/README.md +29 -2
  3. package/dist/universal/.agents/skills/citable/SKILL.md +14 -1
  4. package/dist/universal/.agents/skills/citable/VERSION +1 -1
  5. package/dist/universal/.agents/skills/citable/commands/README.md +2 -1
  6. package/dist/universal/.agents/skills/citable/commands/artifact-interchange.md +28 -0
  7. package/dist/universal/.agents/skills/citable/commands/field-validation.md +71 -0
  8. package/dist/universal/.agents/skills/citable/commands/observe-and-act.md +13 -1
  9. package/dist/universal/.agents/skills/citable/manifest.json +30 -10
  10. package/dist/universal/.agents/skills/citable/references/aeo-geo-validation.md +1 -1
  11. package/dist/universal/.agents/skills/citable/references/capability-boundaries.md +3 -0
  12. package/dist/universal/.agents/skills/citable/schemas/acceptance-corpus.schema.json +168 -0
  13. package/dist/universal/.agents/skills/citable/schemas/acceptance-run-context.schema.json +17 -0
  14. package/dist/universal/.agents/skills/citable/schemas/acceptance-run-receipt.schema.json +88 -0
  15. package/dist/universal/.agents/skills/citable/schemas/artifact-interchange.schema.json +58 -0
  16. package/dist/universal/.agents/skills/citable/schemas/assumption.schema.json +119 -0
  17. package/dist/universal/.agents/skills/citable/schemas/browser-evidence-plan.schema.json +76 -0
  18. package/dist/universal/.agents/skills/citable/schemas/corpus-publication-receipt.schema.json +24 -0
  19. package/dist/universal/.agents/skills/citable/schemas/customer-outcome.schema.json +119 -0
  20. package/dist/universal/.agents/skills/citable/schemas/decision.schema.json +154 -0
  21. package/dist/universal/.agents/skills/citable/schemas/deployment-receipt.schema.json +51 -0
  22. package/dist/universal/.agents/skills/citable/schemas/field-validation-metrics.schema.json +15 -0
  23. package/dist/universal/.agents/skills/citable/schemas/initiative.schema.json +185 -0
  24. package/dist/universal/.agents/skills/citable/schemas/kpi.schema.json +108 -0
  25. package/dist/universal/.agents/skills/citable/schemas/observation.schema.json +1 -1
  26. package/dist/universal/.agents/skills/citable/schemas/release-manifest.schema.json +74 -0
  27. package/dist/universal/.agents/skills/citable/schemas/release-state.schema.json +40 -0
  28. package/dist/universal/.agents/skills/citable/schemas/risk.schema.json +172 -0
  29. package/dist/universal/.agents/skills/citable/schemas/scenario.schema.json +165 -0
  30. package/dist/universal/.agents/skills/citable/schemas/variance.schema.json +112 -0
  31. package/dist/universal/.claude/skills/citable/SKILL.md +14 -1
  32. package/dist/universal/.claude/skills/citable/VERSION +1 -1
  33. package/dist/universal/.claude/skills/citable/commands/README.md +2 -1
  34. package/dist/universal/.claude/skills/citable/commands/artifact-interchange.md +28 -0
  35. package/dist/universal/.claude/skills/citable/commands/field-validation.md +71 -0
  36. package/dist/universal/.claude/skills/citable/commands/observe-and-act.md +13 -1
  37. package/dist/universal/.claude/skills/citable/manifest.json +30 -10
  38. package/dist/universal/.claude/skills/citable/references/aeo-geo-validation.md +1 -1
  39. package/dist/universal/.claude/skills/citable/references/capability-boundaries.md +3 -0
  40. package/dist/universal/.claude/skills/citable/schemas/acceptance-corpus.schema.json +168 -0
  41. package/dist/universal/.claude/skills/citable/schemas/acceptance-run-context.schema.json +17 -0
  42. package/dist/universal/.claude/skills/citable/schemas/acceptance-run-receipt.schema.json +88 -0
  43. package/dist/universal/.claude/skills/citable/schemas/artifact-interchange.schema.json +58 -0
  44. package/dist/universal/.claude/skills/citable/schemas/assumption.schema.json +119 -0
  45. package/dist/universal/.claude/skills/citable/schemas/browser-evidence-plan.schema.json +76 -0
  46. package/dist/universal/.claude/skills/citable/schemas/corpus-publication-receipt.schema.json +24 -0
  47. package/dist/universal/.claude/skills/citable/schemas/customer-outcome.schema.json +119 -0
  48. package/dist/universal/.claude/skills/citable/schemas/decision.schema.json +154 -0
  49. package/dist/universal/.claude/skills/citable/schemas/deployment-receipt.schema.json +51 -0
  50. package/dist/universal/.claude/skills/citable/schemas/field-validation-metrics.schema.json +15 -0
  51. package/dist/universal/.claude/skills/citable/schemas/initiative.schema.json +185 -0
  52. package/dist/universal/.claude/skills/citable/schemas/kpi.schema.json +108 -0
  53. package/dist/universal/.claude/skills/citable/schemas/observation.schema.json +1 -1
  54. package/dist/universal/.claude/skills/citable/schemas/release-manifest.schema.json +74 -0
  55. package/dist/universal/.claude/skills/citable/schemas/release-state.schema.json +40 -0
  56. package/dist/universal/.claude/skills/citable/schemas/risk.schema.json +172 -0
  57. package/dist/universal/.claude/skills/citable/schemas/scenario.schema.json +165 -0
  58. package/dist/universal/.claude/skills/citable/schemas/variance.schema.json +112 -0
  59. package/dist/universal/.cursor/skills/citable/SKILL.md +14 -1
  60. package/dist/universal/.cursor/skills/citable/VERSION +1 -1
  61. package/dist/universal/.cursor/skills/citable/commands/README.md +2 -1
  62. package/dist/universal/.cursor/skills/citable/commands/artifact-interchange.md +28 -0
  63. package/dist/universal/.cursor/skills/citable/commands/field-validation.md +71 -0
  64. package/dist/universal/.cursor/skills/citable/commands/observe-and-act.md +13 -1
  65. package/dist/universal/.cursor/skills/citable/manifest.json +30 -10
  66. package/dist/universal/.cursor/skills/citable/references/aeo-geo-validation.md +1 -1
  67. package/dist/universal/.cursor/skills/citable/references/capability-boundaries.md +3 -0
  68. package/dist/universal/.cursor/skills/citable/schemas/acceptance-corpus.schema.json +168 -0
  69. package/dist/universal/.cursor/skills/citable/schemas/acceptance-run-context.schema.json +17 -0
  70. package/dist/universal/.cursor/skills/citable/schemas/acceptance-run-receipt.schema.json +88 -0
  71. package/dist/universal/.cursor/skills/citable/schemas/artifact-interchange.schema.json +58 -0
  72. package/dist/universal/.cursor/skills/citable/schemas/assumption.schema.json +119 -0
  73. package/dist/universal/.cursor/skills/citable/schemas/browser-evidence-plan.schema.json +76 -0
  74. package/dist/universal/.cursor/skills/citable/schemas/corpus-publication-receipt.schema.json +24 -0
  75. package/dist/universal/.cursor/skills/citable/schemas/customer-outcome.schema.json +119 -0
  76. package/dist/universal/.cursor/skills/citable/schemas/decision.schema.json +154 -0
  77. package/dist/universal/.cursor/skills/citable/schemas/deployment-receipt.schema.json +51 -0
  78. package/dist/universal/.cursor/skills/citable/schemas/field-validation-metrics.schema.json +15 -0
  79. package/dist/universal/.cursor/skills/citable/schemas/initiative.schema.json +185 -0
  80. package/dist/universal/.cursor/skills/citable/schemas/kpi.schema.json +108 -0
  81. package/dist/universal/.cursor/skills/citable/schemas/observation.schema.json +1 -1
  82. package/dist/universal/.cursor/skills/citable/schemas/release-manifest.schema.json +74 -0
  83. package/dist/universal/.cursor/skills/citable/schemas/release-state.schema.json +40 -0
  84. package/dist/universal/.cursor/skills/citable/schemas/risk.schema.json +172 -0
  85. package/dist/universal/.cursor/skills/citable/schemas/scenario.schema.json +165 -0
  86. package/dist/universal/.cursor/skills/citable/schemas/variance.schema.json +112 -0
  87. package/dist/universal/.gemini/skills/citable/SKILL.md +14 -1
  88. package/dist/universal/.gemini/skills/citable/VERSION +1 -1
  89. package/dist/universal/.gemini/skills/citable/commands/README.md +2 -1
  90. package/dist/universal/.gemini/skills/citable/commands/artifact-interchange.md +28 -0
  91. package/dist/universal/.gemini/skills/citable/commands/field-validation.md +71 -0
  92. package/dist/universal/.gemini/skills/citable/commands/observe-and-act.md +13 -1
  93. package/dist/universal/.gemini/skills/citable/manifest.json +30 -10
  94. package/dist/universal/.gemini/skills/citable/references/aeo-geo-validation.md +1 -1
  95. package/dist/universal/.gemini/skills/citable/references/capability-boundaries.md +3 -0
  96. package/dist/universal/.gemini/skills/citable/schemas/acceptance-corpus.schema.json +168 -0
  97. package/dist/universal/.gemini/skills/citable/schemas/acceptance-run-context.schema.json +17 -0
  98. package/dist/universal/.gemini/skills/citable/schemas/acceptance-run-receipt.schema.json +88 -0
  99. package/dist/universal/.gemini/skills/citable/schemas/artifact-interchange.schema.json +58 -0
  100. package/dist/universal/.gemini/skills/citable/schemas/assumption.schema.json +119 -0
  101. package/dist/universal/.gemini/skills/citable/schemas/browser-evidence-plan.schema.json +76 -0
  102. package/dist/universal/.gemini/skills/citable/schemas/corpus-publication-receipt.schema.json +24 -0
  103. package/dist/universal/.gemini/skills/citable/schemas/customer-outcome.schema.json +119 -0
  104. package/dist/universal/.gemini/skills/citable/schemas/decision.schema.json +154 -0
  105. package/dist/universal/.gemini/skills/citable/schemas/deployment-receipt.schema.json +51 -0
  106. package/dist/universal/.gemini/skills/citable/schemas/field-validation-metrics.schema.json +15 -0
  107. package/dist/universal/.gemini/skills/citable/schemas/initiative.schema.json +185 -0
  108. package/dist/universal/.gemini/skills/citable/schemas/kpi.schema.json +108 -0
  109. package/dist/universal/.gemini/skills/citable/schemas/observation.schema.json +1 -1
  110. package/dist/universal/.gemini/skills/citable/schemas/release-manifest.schema.json +74 -0
  111. package/dist/universal/.gemini/skills/citable/schemas/release-state.schema.json +40 -0
  112. package/dist/universal/.gemini/skills/citable/schemas/risk.schema.json +172 -0
  113. package/dist/universal/.gemini/skills/citable/schemas/scenario.schema.json +165 -0
  114. package/dist/universal/.gemini/skills/citable/schemas/variance.schema.json +112 -0
  115. package/dist/universal/.github/skills/citable/SKILL.md +14 -1
  116. package/dist/universal/.github/skills/citable/VERSION +1 -1
  117. package/dist/universal/.github/skills/citable/commands/README.md +2 -1
  118. package/dist/universal/.github/skills/citable/commands/artifact-interchange.md +28 -0
  119. package/dist/universal/.github/skills/citable/commands/field-validation.md +71 -0
  120. package/dist/universal/.github/skills/citable/commands/observe-and-act.md +13 -1
  121. package/dist/universal/.github/skills/citable/manifest.json +30 -10
  122. package/dist/universal/.github/skills/citable/references/aeo-geo-validation.md +1 -1
  123. package/dist/universal/.github/skills/citable/references/capability-boundaries.md +3 -0
  124. package/dist/universal/.github/skills/citable/schemas/acceptance-corpus.schema.json +168 -0
  125. package/dist/universal/.github/skills/citable/schemas/acceptance-run-context.schema.json +17 -0
  126. package/dist/universal/.github/skills/citable/schemas/acceptance-run-receipt.schema.json +88 -0
  127. package/dist/universal/.github/skills/citable/schemas/artifact-interchange.schema.json +58 -0
  128. package/dist/universal/.github/skills/citable/schemas/assumption.schema.json +119 -0
  129. package/dist/universal/.github/skills/citable/schemas/browser-evidence-plan.schema.json +76 -0
  130. package/dist/universal/.github/skills/citable/schemas/corpus-publication-receipt.schema.json +24 -0
  131. package/dist/universal/.github/skills/citable/schemas/customer-outcome.schema.json +119 -0
  132. package/dist/universal/.github/skills/citable/schemas/decision.schema.json +154 -0
  133. package/dist/universal/.github/skills/citable/schemas/deployment-receipt.schema.json +51 -0
  134. package/dist/universal/.github/skills/citable/schemas/field-validation-metrics.schema.json +15 -0
  135. package/dist/universal/.github/skills/citable/schemas/initiative.schema.json +185 -0
  136. package/dist/universal/.github/skills/citable/schemas/kpi.schema.json +108 -0
  137. package/dist/universal/.github/skills/citable/schemas/observation.schema.json +1 -1
  138. package/dist/universal/.github/skills/citable/schemas/release-manifest.schema.json +74 -0
  139. package/dist/universal/.github/skills/citable/schemas/release-state.schema.json +40 -0
  140. package/dist/universal/.github/skills/citable/schemas/risk.schema.json +172 -0
  141. package/dist/universal/.github/skills/citable/schemas/scenario.schema.json +165 -0
  142. package/dist/universal/.github/skills/citable/schemas/variance.schema.json +112 -0
  143. package/dist/universal/.kiro/skills/citable/SKILL.md +14 -1
  144. package/dist/universal/.kiro/skills/citable/VERSION +1 -1
  145. package/dist/universal/.kiro/skills/citable/commands/README.md +2 -1
  146. package/dist/universal/.kiro/skills/citable/commands/artifact-interchange.md +28 -0
  147. package/dist/universal/.kiro/skills/citable/commands/field-validation.md +71 -0
  148. package/dist/universal/.kiro/skills/citable/commands/observe-and-act.md +13 -1
  149. package/dist/universal/.kiro/skills/citable/manifest.json +30 -10
  150. package/dist/universal/.kiro/skills/citable/references/aeo-geo-validation.md +1 -1
  151. package/dist/universal/.kiro/skills/citable/references/capability-boundaries.md +3 -0
  152. package/dist/universal/.kiro/skills/citable/schemas/acceptance-corpus.schema.json +168 -0
  153. package/dist/universal/.kiro/skills/citable/schemas/acceptance-run-context.schema.json +17 -0
  154. package/dist/universal/.kiro/skills/citable/schemas/acceptance-run-receipt.schema.json +88 -0
  155. package/dist/universal/.kiro/skills/citable/schemas/artifact-interchange.schema.json +58 -0
  156. package/dist/universal/.kiro/skills/citable/schemas/assumption.schema.json +119 -0
  157. package/dist/universal/.kiro/skills/citable/schemas/browser-evidence-plan.schema.json +76 -0
  158. package/dist/universal/.kiro/skills/citable/schemas/corpus-publication-receipt.schema.json +24 -0
  159. package/dist/universal/.kiro/skills/citable/schemas/customer-outcome.schema.json +119 -0
  160. package/dist/universal/.kiro/skills/citable/schemas/decision.schema.json +154 -0
  161. package/dist/universal/.kiro/skills/citable/schemas/deployment-receipt.schema.json +51 -0
  162. package/dist/universal/.kiro/skills/citable/schemas/field-validation-metrics.schema.json +15 -0
  163. package/dist/universal/.kiro/skills/citable/schemas/initiative.schema.json +185 -0
  164. package/dist/universal/.kiro/skills/citable/schemas/kpi.schema.json +108 -0
  165. package/dist/universal/.kiro/skills/citable/schemas/observation.schema.json +1 -1
  166. package/dist/universal/.kiro/skills/citable/schemas/release-manifest.schema.json +74 -0
  167. package/dist/universal/.kiro/skills/citable/schemas/release-state.schema.json +40 -0
  168. package/dist/universal/.kiro/skills/citable/schemas/risk.schema.json +172 -0
  169. package/dist/universal/.kiro/skills/citable/schemas/scenario.schema.json +165 -0
  170. package/dist/universal/.kiro/skills/citable/schemas/variance.schema.json +112 -0
  171. package/dist/universal/.opencode/skills/citable/SKILL.md +14 -1
  172. package/dist/universal/.opencode/skills/citable/VERSION +1 -1
  173. package/dist/universal/.opencode/skills/citable/commands/README.md +2 -1
  174. package/dist/universal/.opencode/skills/citable/commands/artifact-interchange.md +28 -0
  175. package/dist/universal/.opencode/skills/citable/commands/field-validation.md +71 -0
  176. package/dist/universal/.opencode/skills/citable/commands/observe-and-act.md +13 -1
  177. package/dist/universal/.opencode/skills/citable/manifest.json +30 -10
  178. package/dist/universal/.opencode/skills/citable/references/aeo-geo-validation.md +1 -1
  179. package/dist/universal/.opencode/skills/citable/references/capability-boundaries.md +3 -0
  180. package/dist/universal/.opencode/skills/citable/schemas/acceptance-corpus.schema.json +168 -0
  181. package/dist/universal/.opencode/skills/citable/schemas/acceptance-run-context.schema.json +17 -0
  182. package/dist/universal/.opencode/skills/citable/schemas/acceptance-run-receipt.schema.json +88 -0
  183. package/dist/universal/.opencode/skills/citable/schemas/artifact-interchange.schema.json +58 -0
  184. package/dist/universal/.opencode/skills/citable/schemas/assumption.schema.json +119 -0
  185. package/dist/universal/.opencode/skills/citable/schemas/browser-evidence-plan.schema.json +76 -0
  186. package/dist/universal/.opencode/skills/citable/schemas/corpus-publication-receipt.schema.json +24 -0
  187. package/dist/universal/.opencode/skills/citable/schemas/customer-outcome.schema.json +119 -0
  188. package/dist/universal/.opencode/skills/citable/schemas/decision.schema.json +154 -0
  189. package/dist/universal/.opencode/skills/citable/schemas/deployment-receipt.schema.json +51 -0
  190. package/dist/universal/.opencode/skills/citable/schemas/field-validation-metrics.schema.json +15 -0
  191. package/dist/universal/.opencode/skills/citable/schemas/initiative.schema.json +185 -0
  192. package/dist/universal/.opencode/skills/citable/schemas/kpi.schema.json +108 -0
  193. package/dist/universal/.opencode/skills/citable/schemas/observation.schema.json +1 -1
  194. package/dist/universal/.opencode/skills/citable/schemas/release-manifest.schema.json +74 -0
  195. package/dist/universal/.opencode/skills/citable/schemas/release-state.schema.json +40 -0
  196. package/dist/universal/.opencode/skills/citable/schemas/risk.schema.json +172 -0
  197. package/dist/universal/.opencode/skills/citable/schemas/scenario.schema.json +165 -0
  198. package/dist/universal/.opencode/skills/citable/schemas/variance.schema.json +112 -0
  199. package/dist/universal/.pi/agent/skills/citable/SKILL.md +14 -1
  200. package/dist/universal/.pi/agent/skills/citable/VERSION +1 -1
  201. package/dist/universal/.pi/agent/skills/citable/commands/README.md +2 -1
  202. package/dist/universal/.pi/agent/skills/citable/commands/artifact-interchange.md +28 -0
  203. package/dist/universal/.pi/agent/skills/citable/commands/field-validation.md +71 -0
  204. package/dist/universal/.pi/agent/skills/citable/commands/observe-and-act.md +13 -1
  205. package/dist/universal/.pi/agent/skills/citable/manifest.json +30 -10
  206. package/dist/universal/.pi/agent/skills/citable/references/aeo-geo-validation.md +1 -1
  207. package/dist/universal/.pi/agent/skills/citable/references/capability-boundaries.md +3 -0
  208. package/dist/universal/.pi/agent/skills/citable/schemas/acceptance-corpus.schema.json +168 -0
  209. package/dist/universal/.pi/agent/skills/citable/schemas/acceptance-run-context.schema.json +17 -0
  210. package/dist/universal/.pi/agent/skills/citable/schemas/acceptance-run-receipt.schema.json +88 -0
  211. package/dist/universal/.pi/agent/skills/citable/schemas/artifact-interchange.schema.json +58 -0
  212. package/dist/universal/.pi/agent/skills/citable/schemas/assumption.schema.json +119 -0
  213. package/dist/universal/.pi/agent/skills/citable/schemas/browser-evidence-plan.schema.json +76 -0
  214. package/dist/universal/.pi/agent/skills/citable/schemas/corpus-publication-receipt.schema.json +24 -0
  215. package/dist/universal/.pi/agent/skills/citable/schemas/customer-outcome.schema.json +119 -0
  216. package/dist/universal/.pi/agent/skills/citable/schemas/decision.schema.json +154 -0
  217. package/dist/universal/.pi/agent/skills/citable/schemas/deployment-receipt.schema.json +51 -0
  218. package/dist/universal/.pi/agent/skills/citable/schemas/field-validation-metrics.schema.json +15 -0
  219. package/dist/universal/.pi/agent/skills/citable/schemas/initiative.schema.json +185 -0
  220. package/dist/universal/.pi/agent/skills/citable/schemas/kpi.schema.json +108 -0
  221. package/dist/universal/.pi/agent/skills/citable/schemas/observation.schema.json +1 -1
  222. package/dist/universal/.pi/agent/skills/citable/schemas/release-manifest.schema.json +74 -0
  223. package/dist/universal/.pi/agent/skills/citable/schemas/release-state.schema.json +40 -0
  224. package/dist/universal/.pi/agent/skills/citable/schemas/risk.schema.json +172 -0
  225. package/dist/universal/.pi/agent/skills/citable/schemas/scenario.schema.json +165 -0
  226. package/dist/universal/.pi/agent/skills/citable/schemas/variance.schema.json +112 -0
  227. package/dist/universal/.qoder/skills/citable/SKILL.md +14 -1
  228. package/dist/universal/.qoder/skills/citable/VERSION +1 -1
  229. package/dist/universal/.qoder/skills/citable/commands/README.md +2 -1
  230. package/dist/universal/.qoder/skills/citable/commands/artifact-interchange.md +28 -0
  231. package/dist/universal/.qoder/skills/citable/commands/field-validation.md +71 -0
  232. package/dist/universal/.qoder/skills/citable/commands/observe-and-act.md +13 -1
  233. package/dist/universal/.qoder/skills/citable/manifest.json +30 -10
  234. package/dist/universal/.qoder/skills/citable/references/aeo-geo-validation.md +1 -1
  235. package/dist/universal/.qoder/skills/citable/references/capability-boundaries.md +3 -0
  236. package/dist/universal/.qoder/skills/citable/schemas/acceptance-corpus.schema.json +168 -0
  237. package/dist/universal/.qoder/skills/citable/schemas/acceptance-run-context.schema.json +17 -0
  238. package/dist/universal/.qoder/skills/citable/schemas/acceptance-run-receipt.schema.json +88 -0
  239. package/dist/universal/.qoder/skills/citable/schemas/artifact-interchange.schema.json +58 -0
  240. package/dist/universal/.qoder/skills/citable/schemas/assumption.schema.json +119 -0
  241. package/dist/universal/.qoder/skills/citable/schemas/browser-evidence-plan.schema.json +76 -0
  242. package/dist/universal/.qoder/skills/citable/schemas/corpus-publication-receipt.schema.json +24 -0
  243. package/dist/universal/.qoder/skills/citable/schemas/customer-outcome.schema.json +119 -0
  244. package/dist/universal/.qoder/skills/citable/schemas/decision.schema.json +154 -0
  245. package/dist/universal/.qoder/skills/citable/schemas/deployment-receipt.schema.json +51 -0
  246. package/dist/universal/.qoder/skills/citable/schemas/field-validation-metrics.schema.json +15 -0
  247. package/dist/universal/.qoder/skills/citable/schemas/initiative.schema.json +185 -0
  248. package/dist/universal/.qoder/skills/citable/schemas/kpi.schema.json +108 -0
  249. package/dist/universal/.qoder/skills/citable/schemas/observation.schema.json +1 -1
  250. package/dist/universal/.qoder/skills/citable/schemas/release-manifest.schema.json +74 -0
  251. package/dist/universal/.qoder/skills/citable/schemas/release-state.schema.json +40 -0
  252. package/dist/universal/.qoder/skills/citable/schemas/risk.schema.json +172 -0
  253. package/dist/universal/.qoder/skills/citable/schemas/scenario.schema.json +165 -0
  254. package/dist/universal/.qoder/skills/citable/schemas/variance.schema.json +112 -0
  255. package/dist/universal/.rovodev/skills/citable/SKILL.md +14 -1
  256. package/dist/universal/.rovodev/skills/citable/VERSION +1 -1
  257. package/dist/universal/.rovodev/skills/citable/commands/README.md +2 -1
  258. package/dist/universal/.rovodev/skills/citable/commands/artifact-interchange.md +28 -0
  259. package/dist/universal/.rovodev/skills/citable/commands/field-validation.md +71 -0
  260. package/dist/universal/.rovodev/skills/citable/commands/observe-and-act.md +13 -1
  261. package/dist/universal/.rovodev/skills/citable/manifest.json +30 -10
  262. package/dist/universal/.rovodev/skills/citable/references/aeo-geo-validation.md +1 -1
  263. package/dist/universal/.rovodev/skills/citable/references/capability-boundaries.md +3 -0
  264. package/dist/universal/.rovodev/skills/citable/schemas/acceptance-corpus.schema.json +168 -0
  265. package/dist/universal/.rovodev/skills/citable/schemas/acceptance-run-context.schema.json +17 -0
  266. package/dist/universal/.rovodev/skills/citable/schemas/acceptance-run-receipt.schema.json +88 -0
  267. package/dist/universal/.rovodev/skills/citable/schemas/artifact-interchange.schema.json +58 -0
  268. package/dist/universal/.rovodev/skills/citable/schemas/assumption.schema.json +119 -0
  269. package/dist/universal/.rovodev/skills/citable/schemas/browser-evidence-plan.schema.json +76 -0
  270. package/dist/universal/.rovodev/skills/citable/schemas/corpus-publication-receipt.schema.json +24 -0
  271. package/dist/universal/.rovodev/skills/citable/schemas/customer-outcome.schema.json +119 -0
  272. package/dist/universal/.rovodev/skills/citable/schemas/decision.schema.json +154 -0
  273. package/dist/universal/.rovodev/skills/citable/schemas/deployment-receipt.schema.json +51 -0
  274. package/dist/universal/.rovodev/skills/citable/schemas/field-validation-metrics.schema.json +15 -0
  275. package/dist/universal/.rovodev/skills/citable/schemas/initiative.schema.json +185 -0
  276. package/dist/universal/.rovodev/skills/citable/schemas/kpi.schema.json +108 -0
  277. package/dist/universal/.rovodev/skills/citable/schemas/observation.schema.json +1 -1
  278. package/dist/universal/.rovodev/skills/citable/schemas/release-manifest.schema.json +74 -0
  279. package/dist/universal/.rovodev/skills/citable/schemas/release-state.schema.json +40 -0
  280. package/dist/universal/.rovodev/skills/citable/schemas/risk.schema.json +172 -0
  281. package/dist/universal/.rovodev/skills/citable/schemas/scenario.schema.json +165 -0
  282. package/dist/universal/.rovodev/skills/citable/schemas/variance.schema.json +112 -0
  283. package/dist/universal/.trae/skills/citable/SKILL.md +14 -1
  284. package/dist/universal/.trae/skills/citable/VERSION +1 -1
  285. package/dist/universal/.trae/skills/citable/commands/README.md +2 -1
  286. package/dist/universal/.trae/skills/citable/commands/artifact-interchange.md +28 -0
  287. package/dist/universal/.trae/skills/citable/commands/field-validation.md +71 -0
  288. package/dist/universal/.trae/skills/citable/commands/observe-and-act.md +13 -1
  289. package/dist/universal/.trae/skills/citable/manifest.json +30 -10
  290. package/dist/universal/.trae/skills/citable/references/aeo-geo-validation.md +1 -1
  291. package/dist/universal/.trae/skills/citable/references/capability-boundaries.md +3 -0
  292. package/dist/universal/.trae/skills/citable/schemas/acceptance-corpus.schema.json +168 -0
  293. package/dist/universal/.trae/skills/citable/schemas/acceptance-run-context.schema.json +17 -0
  294. package/dist/universal/.trae/skills/citable/schemas/acceptance-run-receipt.schema.json +88 -0
  295. package/dist/universal/.trae/skills/citable/schemas/artifact-interchange.schema.json +58 -0
  296. package/dist/universal/.trae/skills/citable/schemas/assumption.schema.json +119 -0
  297. package/dist/universal/.trae/skills/citable/schemas/browser-evidence-plan.schema.json +76 -0
  298. package/dist/universal/.trae/skills/citable/schemas/corpus-publication-receipt.schema.json +24 -0
  299. package/dist/universal/.trae/skills/citable/schemas/customer-outcome.schema.json +119 -0
  300. package/dist/universal/.trae/skills/citable/schemas/decision.schema.json +154 -0
  301. package/dist/universal/.trae/skills/citable/schemas/deployment-receipt.schema.json +51 -0
  302. package/dist/universal/.trae/skills/citable/schemas/field-validation-metrics.schema.json +15 -0
  303. package/dist/universal/.trae/skills/citable/schemas/initiative.schema.json +185 -0
  304. package/dist/universal/.trae/skills/citable/schemas/kpi.schema.json +108 -0
  305. package/dist/universal/.trae/skills/citable/schemas/observation.schema.json +1 -1
  306. package/dist/universal/.trae/skills/citable/schemas/release-manifest.schema.json +74 -0
  307. package/dist/universal/.trae/skills/citable/schemas/release-state.schema.json +40 -0
  308. package/dist/universal/.trae/skills/citable/schemas/risk.schema.json +172 -0
  309. package/dist/universal/.trae/skills/citable/schemas/scenario.schema.json +165 -0
  310. package/dist/universal/.trae/skills/citable/schemas/variance.schema.json +112 -0
  311. package/dist/universal/.trae-cn/skills/citable/SKILL.md +14 -1
  312. package/dist/universal/.trae-cn/skills/citable/VERSION +1 -1
  313. package/dist/universal/.trae-cn/skills/citable/commands/README.md +2 -1
  314. package/dist/universal/.trae-cn/skills/citable/commands/artifact-interchange.md +28 -0
  315. package/dist/universal/.trae-cn/skills/citable/commands/field-validation.md +71 -0
  316. package/dist/universal/.trae-cn/skills/citable/commands/observe-and-act.md +13 -1
  317. package/dist/universal/.trae-cn/skills/citable/manifest.json +30 -10
  318. package/dist/universal/.trae-cn/skills/citable/references/aeo-geo-validation.md +1 -1
  319. package/dist/universal/.trae-cn/skills/citable/references/capability-boundaries.md +3 -0
  320. package/dist/universal/.trae-cn/skills/citable/schemas/acceptance-corpus.schema.json +168 -0
  321. package/dist/universal/.trae-cn/skills/citable/schemas/acceptance-run-context.schema.json +17 -0
  322. package/dist/universal/.trae-cn/skills/citable/schemas/acceptance-run-receipt.schema.json +88 -0
  323. package/dist/universal/.trae-cn/skills/citable/schemas/artifact-interchange.schema.json +58 -0
  324. package/dist/universal/.trae-cn/skills/citable/schemas/assumption.schema.json +119 -0
  325. package/dist/universal/.trae-cn/skills/citable/schemas/browser-evidence-plan.schema.json +76 -0
  326. package/dist/universal/.trae-cn/skills/citable/schemas/corpus-publication-receipt.schema.json +24 -0
  327. package/dist/universal/.trae-cn/skills/citable/schemas/customer-outcome.schema.json +119 -0
  328. package/dist/universal/.trae-cn/skills/citable/schemas/decision.schema.json +154 -0
  329. package/dist/universal/.trae-cn/skills/citable/schemas/deployment-receipt.schema.json +51 -0
  330. package/dist/universal/.trae-cn/skills/citable/schemas/field-validation-metrics.schema.json +15 -0
  331. package/dist/universal/.trae-cn/skills/citable/schemas/initiative.schema.json +185 -0
  332. package/dist/universal/.trae-cn/skills/citable/schemas/kpi.schema.json +108 -0
  333. package/dist/universal/.trae-cn/skills/citable/schemas/observation.schema.json +1 -1
  334. package/dist/universal/.trae-cn/skills/citable/schemas/release-manifest.schema.json +74 -0
  335. package/dist/universal/.trae-cn/skills/citable/schemas/release-state.schema.json +40 -0
  336. package/dist/universal/.trae-cn/skills/citable/schemas/risk.schema.json +172 -0
  337. package/dist/universal/.trae-cn/skills/citable/schemas/scenario.schema.json +165 -0
  338. package/dist/universal/.trae-cn/skills/citable/schemas/variance.schema.json +112 -0
  339. package/dist/universal/manifest.json +363 -123
  340. package/package.json +12 -1
  341. package/release/surfaces.json +21 -0
  342. package/schemas/acceptance-corpus.schema.json +168 -0
  343. package/schemas/acceptance-run-context.schema.json +17 -0
  344. package/schemas/acceptance-run-receipt.schema.json +88 -0
  345. package/schemas/artifact-interchange.schema.json +58 -0
  346. package/schemas/assumption.schema.json +119 -0
  347. package/schemas/browser-evidence-plan.schema.json +76 -0
  348. package/schemas/corpus-publication-receipt.schema.json +24 -0
  349. package/schemas/customer-outcome.schema.json +119 -0
  350. package/schemas/decision.schema.json +154 -0
  351. package/schemas/deployment-receipt.schema.json +51 -0
  352. package/schemas/field-validation-metrics.schema.json +15 -0
  353. package/schemas/initiative.schema.json +185 -0
  354. package/schemas/kpi.schema.json +108 -0
  355. package/schemas/observation.schema.json +1 -1
  356. package/schemas/release-manifest.schema.json +74 -0
  357. package/schemas/release-state.schema.json +40 -0
  358. package/schemas/risk.schema.json +172 -0
  359. package/schemas/scenario.schema.json +165 -0
  360. package/schemas/variance.schema.json +112 -0
  361. package/scripts/release-governance.js +123 -0
  362. package/skill/SKILL.md +14 -1
  363. package/skill/commands/README.md +2 -1
  364. package/skill/commands/artifact-interchange.md +28 -0
  365. package/skill/commands/field-validation.md +71 -0
  366. package/skill/commands/observe-and-act.md +13 -1
  367. package/skill/references/aeo-geo-validation.md +1 -1
  368. package/skill/references/capability-boundaries.md +3 -0
  369. package/src/acceptance/reproducibility.js +180 -0
  370. package/src/artifacts/interchange.js +179 -0
  371. package/src/cli/index.js +149 -4
  372. package/src/commands/assumptionAudit.js +111 -0
  373. package/src/commands/audit.js +6 -0
  374. package/src/commands/boardReport.js +251 -0
  375. package/src/commands/competitiveIntel.js +124 -0
  376. package/src/commands/corpus.js +322 -0
  377. package/src/commands/decisionMemo.js +202 -0
  378. package/src/commands/executive.js +167 -0
  379. package/src/commands/executiveReview.js +206 -0
  380. package/src/commands/init.js +14 -1
  381. package/src/commands/kpi.js +86 -0
  382. package/src/commands/monitor.js +9 -0
  383. package/src/commands/observe.js +202 -30
  384. package/src/commands/outcomes.js +113 -0
  385. package/src/commands/prioritize.js +108 -0
  386. package/src/commands/risk.js +104 -0
  387. package/src/commands/scenario.js +98 -0
  388. package/src/commands/variance.js +102 -0
  389. package/src/detectors/framework.js +37 -0
  390. package/src/detectors/page.js +10 -10
  391. package/src/detectors/tech.js +5 -3
  392. package/src/extractor/site.js +21 -6
  393. package/src/observations/browserJourney.js +167 -0
  394. package/src/observations/media.js +8 -1
  395. package/src/registries/index.js +107 -6
  396. package/src/release/governance.js +331 -0
  397. package/src/shared/asOf.js +18 -0
package/CHANGELOG.md CHANGED
@@ -2,6 +2,157 @@
2
2
 
3
3
  ## Unreleased
4
4
 
5
+ ## 1.13.0 — 2026-07-19
6
+
7
+ ### Added — Release Evidence Governance
8
+
9
+ - Canonical release manifests that bind executable detector, namespace,
10
+ registry, provider, distribution, documentation, and generated publisher
11
+ projections to the release commit with fail-closed checksum validation.
12
+ - Two-phase release governance with `published_unfinalized`, immutable
13
+ finalization, bounded dwell, terminal withdrawal or supersession, and
14
+ owner-controlled deployment receipts that cannot be mistaken for independent
15
+ attestation.
16
+ - Direct and cache-busted representation-drift observations with longitudinal
17
+ divergence and convergence evidence that remains `external_unverified` and
18
+ cannot satisfy release gates.
19
+ - Acceptance-corpus contracts and bounded accuracy metrics covering detector
20
+ confusion matrices, incomplete evidence, reviewer agreement, execution cost,
21
+ reproducibility, and remediation verification.
22
+ - Acceptance-run reproducibility receipts that verify sealed run packages,
23
+ preserve partial and unavailable observations, exclude disclosed
24
+ environment-specific fields from fingerprints, and compare property,
25
+ detector, configuration, observation-method, tool, and external-system drift
26
+ independently.
27
+ - Real-property corpus authorization, architecture, collection, retention,
28
+ sanitization, publication, and run-evidence contracts, plus a fail-closed
29
+ public projection with a hash-bound owner-authorized publication receipt.
30
+ - Publishable field-validation metrics with corpus and collection provenance,
31
+ sample/census identity, detector-version cohorts, explicit numerator and
32
+ denominator definitions, unknown-false-negative state, confidence limits,
33
+ and hash-bound JSON and Markdown projections.
34
+ - Schema-validated cross-browser and interaction-journey evidence plans with
35
+ explicit engine/version, device, JavaScript, locale, consent,
36
+ authentication, step, artifact, and partial-failure records.
37
+ - Versioned, independently verifiable artifact interchange with fail-closed
38
+ `artifacts export`, `artifacts verify`, and `artifacts import` commands. The
39
+ contract preserves canonical run bytes and explicitly excludes hosted
40
+ tenancy, authentication, storage, billing, and dashboard authority.
41
+
42
+ ### Migration — Acceptance Corpus Schema v2
43
+
44
+ - Acceptance corpus manifests must migrate `schema_version` from `1` to `2`.
45
+ Replace `owner_authorized` with the structured `authorization` record; add
46
+ `architecture`, `collection_methods`, `publication`, `sanitization`,
47
+ intentional-incompleteness and contradiction state; add run artifact and
48
+ governance references; and declare false-negative discovery and causal
49
+ limitations. Schema v1 manifests are rejected rather than inferred.
50
+ Corpus v2 manifests created before this change must also add
51
+ `evaluation_design`, and every detector case must add `detector_version`.
52
+
53
+ ### Changed — Release Evidence Governance
54
+
55
+ - PR policy validation now skips post-merge edited events, preventing deleted
56
+ head references from creating misleading failures after a successful merge.
57
+ - Controlled surfaces now declare exact-body or projection-hash-header
58
+ verification. Rendered pages without the declared header produce
59
+ `insufficient_evidence` instead of a false body-hash divergence.
60
+ - Release shipping now creates a draft release, records npm publication as an
61
+ explicit unfinalized state, and requires valid controlled-surface receipts in
62
+ a separate protected workflow before publishing the GitHub release as latest.
63
+ - Field-derived detector applicability now keeps non-HTML resources eligible
64
+ for transport checks while restricting HTML semantics to HTML documents,
65
+ excludes Cloudflare `/cdn-cgi/` utility routes from default index-target
66
+ intent, and reports bounded URL crawls as incomplete coverage instead of
67
+ treating unfetched sitemap URLs as confirmed errors.
68
+
69
+ ### Added — Executive Reporting Suite
70
+
71
+ **Governed input registries (8 new schemas + registry specs)**
72
+
73
+ - `kpi` command — KPI Architecture registry: govern metric definitions, sources,
74
+ targets, calculation, known limitations, and restatement policy. Refuses metrics
75
+ lacking executive definitions or empty `known_limitations`.
76
+ - `variance` command — Variance analysis registry: enforces four-act narrative
77
+ (plan → actual → cause → response). Rejects vague causes (`market conditions`,
78
+ `timing`, `customer behaviour`) as primary drivers. Material/critical variances
79
+ require `management_response`.
80
+ - `outcomes` command — Customer Outcomes registry: separates activity from
81
+ validated impact. Enforces `finding_produced → finding_accepted →
82
+ answer_engine_changed → commercial_value_claimed →
83
+ causal_relationship_established` progression. Blocks `commercial_value` at
84
+ `finding_produced` stage.
85
+ - `risk` command — Risk Register: top risks sorted by residual exposure, KRI
86
+ tracking, trigger thresholds, control effectiveness. Board-visible risks require
87
+ `trigger_threshold`. High/critical risks require `key_risk_indicators`.
88
+
89
+ **Executive output commands**
90
+
91
+ - `executive-review` — Monthly Executive Operating Review. Evidence ledger built
92
+ first (governed metrics, variance counts, outcome stages, risk counts), then
93
+ four-act narrative template generated. Returns `ungoverned_warning` when no KPIs
94
+ registered — refuses to produce narrative from ungoverned data.
95
+ - `board-report` — Quarterly Board Pack. Every reported statement carries
96
+ `statement_type`, `source_records`, `period`, `confidence`, and `limitations`.
97
+ Returns `refused_sections` when kpis/customer-outcomes/risks are absent.
98
+ - `decision-memo` — Bounded Decision Record. Requires: named consulted parties,
99
+ `what_would_change_recommendation`, real trade-offs on every option (no
100
+ strawmen), specific `supporting_evidence`, and `reopen_conditions` for
101
+ effectively-one-way decisions.
102
+
103
+ **Strategic analysis commands**
104
+
105
+ - `assumption-audit` — Assumption validity tracking. Validated assumptions require
106
+ `evidence_for`; contradicted assumptions require `evidence_against`; critical
107
+ importance requires `next_test` date.
108
+ - `scenario` — Compound Risk Scenario War Room. Capped at 3 variables per
109
+ scenario. Requires `cascade_analysis`, all three states (base/stress/severe),
110
+ hedges with cost/impact/owner/deadline, and `early_warning_triggers`.
111
+ - `prioritize` — Initiative Prioritization with transparent scoring: `(demand +
112
+ revenue + differentiation − engineering − operating − legal) × evidence_multiplier`.
113
+ Weights exposed in output. Rejects `revenue_potential=transformative` with
114
+ `evidence_strength=assumption`.
115
+ - `competitive-intel` — Competitive Intelligence. Every claim requires
116
+ `observation_date`, `source`, and `claim_type`. Unreliable sources (G2, Capterra,
117
+ homepage, LLM recall) require `independent_verification`. Includes `stale`
118
+ subcommand.
119
+
120
+ **Orchestration**
121
+
122
+ - `executive` command — Chief-of-Staff Router. Routes 11 request patterns to
123
+ the correct reporting skill. Max orchestration depth: 1 (no recursive routing).
124
+ Logs all routing decisions to `.citable/executive-log.yaml` (last 100 retained).
125
+ `--route <command>` forces a specific route. `--log` shows recent decisions.
126
+
127
+ **Infrastructure**
128
+
129
+ - 8 new JSON schemas registered in `REGISTRY_SPECS`:
130
+ `kpi`, `variance`, `customer-outcome`, `risk`, `decision`, `assumption`,
131
+ `scenario`, `initiative` — all with `citable://schemas/` `$id` prefix for AJV
132
+ compatibility.
133
+ - Comprehensive unit coverage in `tests/unit/executive-reporting.test.js` for
134
+ governed inputs, reports, cross-registry integrity, deterministic IDs, and fixed-date evaluation.
135
+
136
+ ## 1.12.0 — 2026-07-19
137
+
138
+ ### Fixed
139
+
140
+ - Replaced regex-based HTML and transcript tag stripping with structured parsing
141
+ that excludes executable elements, including malformed end-tag variants.
142
+ - Restricted schema-source discovery to exact `schema.org` hosts instead of
143
+ accepting deceptive hostname substrings.
144
+ - Removed command-line-derived release-note regular expressions and an
145
+ ineffective identity replacement in schema integration coverage.
146
+
147
+ ### Added
148
+
149
+ - Independent desktop, mobile, and JavaScript-disabled Chromium render profiles
150
+ with raw/rendered parity artifacts and bounded interaction discovery.
151
+ - Partial-failure evidence and `--resume-run` recovery that reuses only
152
+ successful profiles from an immutable source run.
153
+ - Optional repeated local Lighthouse execution with pinned runtime metadata,
154
+ per-run artifacts, lab/field separation, and median metric summaries.
155
+
5
156
  ## 1.11.0 — 2026-07-19
6
157
 
7
158
  ### Added
package/README.md CHANGED
@@ -155,6 +155,9 @@ citable observe logs --input edge-logs.json
155
155
  citable observe bing --dataset ai_performance --input bing-ai-performance.csv
156
156
  citable observe consensus --target ./dist --base-url https://example.com
157
157
  citable observe performance --target https://example.com # CRUX_API_KEY
158
+ citable observe performance --target https://example.com --lighthouse --repeat 3
159
+ citable observe render --target https://example.com --interactions
160
+ citable observe render --target https://example.com --resume-run <run-id>
158
161
  citable apply --input remediation-spec.json # dry run
159
162
  citable apply --input remediation-spec.json --write # reviewed + hash-locked
160
163
  citable monitor [runA runB]
@@ -174,6 +177,14 @@ citable reviews evaluate
174
177
  citable schedules run <schedule-id> --ref-date 2026-07-19
175
178
  citable project github <run-id>
176
179
  citable observe media --input media-manifest.json # add --ocr explicitly when required
180
+ citable observe representation --input release-manifest.json --target https://example.com/llms.txt
181
+ citable corpus evaluate --input acceptance-corpus.json
182
+ citable corpus publish --input acceptance-corpus.json --output public-corpus.json
183
+ citable corpus receipt --run <run-id> --input execution-context.json
184
+ citable corpus compare-receipts <receipt-a.json> <receipt-b.json>
185
+ citable artifacts export <run-id> --output ./portable-run
186
+ citable artifacts verify --input ./portable-run
187
+ citable artifacts import --input ./portable-run
177
188
  citable substantiate # claim/evidence assessment (dry run)
178
189
  citable validate # registry schema + referential integrity
179
190
  ```
@@ -184,7 +195,7 @@ citable validate # registry schema + referential integrity
184
195
  | --- | --- |
185
196
  | `skill/` | Canonical agent skill: SKILL.md, command contracts, rubrics, anti-patterns, policies, templates |
186
197
  | `src/` | CLI, commands, registries, detectors, crawler/extractor, evidence, reporting |
187
- | `schemas/` | JSON Schemas: 19 registries plus findings, runs, observations, remediation, config, and prompt results |
198
+ | `schemas/` | JSON Schemas: 27 registries plus findings, runs, observations, release governance, remediation, config, and prompt results |
188
199
  | `tests/` | Unit + integration suites; positive/negative fixtures |
189
200
  | `docs/` | ADR, traceability matrix, known limitations |
190
201
  | `dist/` | Generated distribution packages (run `npm run build:dist`) |
@@ -208,11 +219,27 @@ citable validate # registry schema + referential integrity
208
219
  - [Known limitations](docs/known-limitations.md) includes medium-specific PDF,
209
220
  transcript, image-context, and optional OCR boundaries.
210
221
 
222
+ ## Community And Governance
223
+
224
+ - [Contributing](CONTRIBUTING.md) - engineering and pull-request contracts
225
+ - [Support](SUPPORT.md) - Issues, Discussions, hosted-service, and security routing
226
+ - [Governance](GOVERNANCE.md) - authority, decisions, roles, and continuity
227
+ - [Maintainers](MAINTAINERS.md) - current responsibilities and succession
228
+ - [Security](SECURITY.md) - private reporting and supported-version policy
229
+ - [Code of Conduct](CODE_OF_CONDUCT.md) - participation and enforcement
230
+
231
+ Repository documentation and released schemas are canonical. Issues track
232
+ accepted work, Discussions develop questions and proposals, and the Wiki holds
233
+ non-authoritative operational recipes. The hosted Nebula Components dashboard
234
+ is a separate product surface.
235
+
211
236
  ## Requirements
212
237
 
213
238
  Node >= 24.0.0. Network access is used for URL audits and explicitly selected
214
239
  live collectors. Render collection requires the optional `playwright` peer and
215
- an installed Chromium browser. Google index inspection uses `GSC_ACCESS_TOKEN`
240
+ an installed Chromium browser. Local Lighthouse collection requires the
241
+ optional `lighthouse` and `chrome-launcher` peers plus Chrome or Chromium.
242
+ Google index inspection uses `GSC_ACCESS_TOKEN`
216
243
  and `--site-url`; CrUX uses `CRUX_API_KEY`. Missing dependencies or credentials
217
244
  produce incomplete evidence. Supported frameworks for auto-detection: Next.js,
218
245
  Astro, Nuxt, SvelteKit, Gatsby (other stacks: audit their built HTML output).
@@ -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.11.0
10
+ version: 1.13.0
11
11
  ---
12
12
 
13
13
  # Citable — evidence and change control for search and AI citation readiness
@@ -96,6 +96,9 @@ citable compare-snapshots [runA runB]
96
96
  citable action-plan [run-id] # ordered actions, blockers, semantic gates, verification
97
97
  citable observe <mode> [options] # render/index/citation/log/passage/consensus/performance evidence
98
98
  citable observe bing --dataset <search_performance|ai_performance> --input <csv|json>
99
+ citable observe render --target <url> [--interactions] [--resume-run <run-id>]
100
+ citable observe render --input <browser-evidence-plan.json>
101
+ citable observe performance --target <url> --lighthouse [--repeat 1..5]
99
102
  citable apply --input <spec> [--write] # reviewed, hash-locked remediation; dry run by default
100
103
  citable monitor [runA runB] # observation regression alerts
101
104
  citable metrics import --provider <name> --input <csv|json>
@@ -118,6 +121,14 @@ citable reviews evaluate
118
121
  citable schedules run <schedule-id> [--ref-date YYYY-MM-DD]
119
122
  citable project github <run-id>
120
123
  citable observe media --input <manifest.json> [--ocr]
124
+ citable observe representation --input <release-manifest.json> --target <controlled-url>
125
+ citable corpus evaluate --input <acceptance-corpus.json>
126
+ citable corpus publish --input <acceptance-corpus.json> --output <public-corpus.json>
127
+ citable corpus receipt --run <run-id> [--input <execution-context.json>]
128
+ citable corpus compare-receipts <receipt-a.json> <receipt-b.json>
129
+ citable artifacts export <run-id> --output <directory>
130
+ citable artifacts verify --input <directory>
131
+ citable artifacts import --input <directory>
121
132
  ```
122
133
 
123
134
  Audit scopes: `technical seo aeo geo architecture entity claims evidence schema
@@ -162,6 +173,8 @@ operator data or future adapters.
162
173
  Use `commands/observe-and-act.md` for collector prerequisites, evidence labels,
163
174
  the controlled citation adapter protocol, remediation refusal conditions, and
164
175
  monitoring interpretation.
176
+ Use `commands/field-validation.md` for acceptance-corpus authorization,
177
+ sanitization, publication refusal, reproducibility, and evidence boundaries.
165
178
 
166
179
  ## Command workflows
167
180
 
@@ -1 +1 @@
1
- 1.11.0
1
+ 1.13.0
@@ -34,8 +34,9 @@ intent, not executability, so statuses are strict:
34
34
  | /citable ingest, map-site, map-queries, map-prompts, map-entities, map-evidence | specified (ingest.md) |
35
35
  | /citable optimize-page | specified (optimize-page.md) — requires source-to-render mapping, claim-preserving rewrites, build execution, rollback; none of that is proven yet |
36
36
  | /citable create-page, answer-block, architect, interlink, consolidate, metadata | specified (page-work.md) |
37
- | /citable validate-render | partially implemented by `observe render`; mobile/cross-browser and interaction exploration remain |
37
+ | /citable validate-render | partially implemented by `observe render`; fixed Chromium profiles and schema-validated Chromium/Firefox/WebKit journeys are implemented, while reviewed semantic-impact detectors and reusable application-specific journey libraries remain |
38
38
  | /citable measure seo/aeo/geo, test-prompts, monitor-crawlers, monitor-contradictions | partially implemented by metric/observation imports, objective evaluation, Google/CrUX live APIs, custom citation adapters, and monitor comparisons |
39
+ | `citable artifacts export/verify/import` | implemented — portable, versioned, checksum-bound run interchange without hosted-service authority |
39
40
 
40
41
  Shared refusal conditions (all commands): any action that would fabricate
41
42
  facts, citations, evidence, authorship, reviews, corroboration, or hidden
@@ -0,0 +1,28 @@
1
+ # Portable artifact interchange
2
+
3
+ Use artifact interchange to move one sealed Citable run between local or
4
+ external workspaces without changing its canonical bytes.
5
+
6
+ ```sh
7
+ citable artifacts export <run-id> --output <directory>
8
+ citable artifacts verify --input <directory>
9
+ citable artifacts import --input <directory>
10
+ ```
11
+
12
+ An export contains the original run package plus
13
+ `citable-artifact.json`. The versioned envelope binds the run identity,
14
+ exporter identity, source-run versions, manifest and checksum hashes, exact
15
+ artifact inventory, byte sizes, and a canonical package hash. Verification rejects missing,
16
+ additional, modified, unsafe, or symbolic-link entries. Import verifies into a
17
+ temporary directory before atomically creating `.citable/runs/<run-id>`.
18
+
19
+ Import never rewrites the run manifest, checksums, or artifacts. An identical
20
+ existing run is `already_present`; a different package with the same run ID is
21
+ a collision and fails closed. The interchange envelope is transport metadata
22
+ and is not copied into the canonical run package.
23
+
24
+ Checksums prove preservation after export. They do not prove that the source
25
+ was authentic, that external observations were representative or complete, or
26
+ that an intervention caused an outcome. Hosted tenancy, authentication,
27
+ storage, retention, billing, scheduling, and dashboards are outside this
28
+ contract.
@@ -0,0 +1,71 @@
1
+ # Field validation corpus
2
+
3
+ Use this workflow to assemble, evaluate, and publish an acceptance corpus. A
4
+ fixture-valid corpus is not field evidence. Do not describe a corpus as real,
5
+ representative, accurate, or public until the corresponding records and reviews
6
+ exist.
7
+
8
+ ## Preconditions
9
+
10
+ For every property, record:
11
+
12
+ - architecture and property class;
13
+ - owner authorization for collection, retention, review, and the intended
14
+ publication level;
15
+ - collection methods, authority labels, timestamps, and limitations;
16
+ - unavailable evidence, intentional incompleteness, and contradictions;
17
+ - publication approval, retention, and the exact artifact-reference allowlist;
18
+ - human sanitization review covering personal data, credentials, and source
19
+ identifiers.
20
+
21
+ Every execution must reference raw artifacts, deterministic and heuristic
22
+ findings, reviewer assignments, disagreements, exceptions, interventions,
23
+ verification, and its reproducibility receipt where available. Empty reference
24
+ arrays are valid only where that class of evidence did not occur.
25
+
26
+ ## Evaluate
27
+
28
+ ```sh
29
+ citable corpus evaluate --input acceptance-corpus.json
30
+ ```
31
+
32
+ Evaluation validates the v2 contract and writes `accuracy-metrics.json` plus a
33
+ human-readable `accuracy-metrics.md` projection from the same hash-bound data.
34
+ Every reported metric discloses its numerator, denominator, population,
35
+ exclusions, and confidence limits. Sample and census designs remain distinct,
36
+ and detector versions are reported as separate cohorts. Evaluation does not
37
+ authorize publication. Unknown false negatives remain unknown; discovered
38
+ false-negative rates apply only to adjudicated expected detections in the
39
+ disclosed population.
40
+
41
+ ## Publish
42
+
43
+ ```sh
44
+ citable corpus publish \
45
+ --input acceptance-corpus.json \
46
+ --output public-corpus.json
47
+ ```
48
+
49
+ Publication fails closed when any property is private or aggregate-only, owner
50
+ authority is expired or incomplete, sanitization review is incomplete, an
51
+ artifact reference is unsafe or outside the allowlist, sensitive patterns are
52
+ detected, or the output already exists. It emits the public corpus, a hash-bound
53
+ publisher-controlled receipt, and an immutable local evidence package.
54
+
55
+ Automated checks supplement but do not replace human sanitization review. The
56
+ receipt is owner-authorized publication evidence, not independent attestation.
57
+ Never publish production credentials, customer data, private property artifacts,
58
+ or evidence outside the exact approved scope.
59
+
60
+ ## Reproducibility
61
+
62
+ Create one receipt per sealed acceptance run, then compare repeated envelopes:
63
+
64
+ ```sh
65
+ citable corpus receipt --run <run-id> --input execution-context.json
66
+ citable corpus compare-receipts <receipt-a.json> <receipt-b.json>
67
+ ```
68
+
69
+ Treat fingerprint equality as bounded equality of declared inputs, methods,
70
+ tools, external-system versions, and artifacts. It does not establish causation
71
+ or performance on untested properties.
@@ -9,7 +9,16 @@ failure_behaviour: unavailable dependency, credential, source run, reviewer, exa
9
9
  ## Collection modes
10
10
 
11
11
  - `observe render --target <URL>` uses optional Playwright. Browser evidence is
12
- not search-index evidence.
12
+ not search-index evidence. It captures independent desktop, mobile, and
13
+ JavaScript-disabled profiles. `--interactions` exercises at most 20 visible
14
+ disclosure, inactive-tab, and load-more-like controls; it does not prove an
15
+ application-specific journey. `--resume-run` reuses only successful profile
16
+ observations from the named immutable run and recollects failed/absent ones.
17
+ `observe render --input <browser-evidence-plan.json>` executes an
18
+ explicit Chromium, Firefox, or WebKit profile matrix. Each plan records the
19
+ browser version, device, JavaScript, locale, consent, authentication state,
20
+ and ordered interaction steps. Fill/select values are referenced by
21
+ environment-variable name and are never written to the plan or artifacts.
13
22
  - `observe index --input <JSON>` imports owner exports. With `--target`,
14
23
  `--site-url`, and `GSC_ACCESS_TOKEN`, it calls Google URL Inspection, which
15
24
  reports the indexed version rather than performing a live indexability test.
@@ -21,6 +30,9 @@ failure_behaviour: unavailable dependency, credential, source run, reviewer, exa
21
30
  without IP verification remain low confidence.
22
31
  - `observe passages|consensus --target <dir|URL>` performs static extraction.
23
32
  - `observe performance` imports evidence or calls CrUX with `CRUX_API_KEY`.
33
+ `--lighthouse` instead performs 1-5 local lab runs (default 3) using optional
34
+ `lighthouse` and `chrome-launcher` peers, preserving each result and a median
35
+ summary. Lab evidence remains separate from CrUX field evidence.
24
36
  - `observe corroboration --input <JSON>` records observable external mentions;
25
37
  controlled or unverified sources do not become authority claims.
26
38
 
@@ -1,29 +1,31 @@
1
1
  {
2
2
  "name": "citable",
3
- "version": "1.11.0",
3
+ "version": "1.13.0",
4
4
  "managedBy": "citable-cli",
5
5
  "provider": "codex",
6
6
  "providerName": "OpenAI Codex",
7
7
  "scope": "bundle",
8
- "sourcePackage": "@nebulacomponents/citable@1.11.0",
8
+ "sourcePackage": "@nebulacomponents/citable@1.13.0",
9
9
  "variantPath": ".agents/skills/citable",
10
10
  "files": {
11
11
  "commands/action-findings.md": "sha256:510361461f24fcd4a550e0a8d960c383aefe23f9a65a54a3ffc44abd4c1293e7",
12
+ "commands/artifact-interchange.md": "sha256:18d56fbfa6bb3f23f08593a9a8135e51c268618b049e53c793969b68000875c3",
12
13
  "commands/delivery.md": "sha256:3b29250f9e9f84442812e320a70d5d2784b4286e91af3866f99cb6062a85a10f",
14
+ "commands/field-validation.md": "sha256:4f24b2758eef746d704b218364f1e45ee9e07418c8ae111081b1fd41f93dde2d",
13
15
  "commands/governance.md": "sha256:1fd6272f18b00237fc6e602ac126ae812747937b2bb575068a0d617137eea2b0",
14
16
  "commands/ingest.md": "sha256:cf35659aecd9d0e160909003efdbe056864fc5d824c71b4ef0ee801ce07ff598",
15
17
  "commands/measurement.md": "sha256:9cade6dfec23338e18aa67ede3335ac9e2888dc577a7d4d8e3ceac948bce403f",
16
18
  "commands/media-evidence.md": "sha256:f2218feabe3360a2c9d569a5fa9b70d4b33a83a270d657151635e6f404fb34e0",
17
- "commands/observe-and-act.md": "sha256:02a93bbbfddc3d8e11cb921ddccd19b0666133c4bdb4f4a280bcb131bed37e8c",
19
+ "commands/observe-and-act.md": "sha256:3862708da9d787d61a9c7bc8639b2fb28bc021d5784e11f313b0e9ecdff261bc",
18
20
  "commands/optimize-page.md": "sha256:35866f3d7cdeef0376ea7a7d7036085a9b9cf95bbb300ecf4bd77610ebd74d85",
19
21
  "commands/page-work.md": "sha256:965a66e59bdf7b0da482d26fade53b3d265885ece5d463fe83b0789ebefaef3e",
20
- "commands/README.md": "sha256:36a0462ce9867dd46922185060341110f9c4b71582b96ec3f90ff1ff341f59ea",
22
+ "commands/README.md": "sha256:c27f69e0e33712e00f780c0988c7b033650c17d3450baea33f2b14212be8438e",
21
23
  "commands/reviews.md": "sha256:902904aaa405fe5724cf0662c7a5a36eab9a4fe0eb81cbd95ffa2fff946e0ac8",
22
24
  "commands/validate-render.md": "sha256:a8e1d04d40b84d57c35039250d98c6a7302cd44a148a8c3b9d9cfb92678c4347",
23
25
  "policies/crawler-policy-template.md": "sha256:15c88a4eeb21f53f71e5250dd3eb2d2791a814b304eaefce8bb30e2bdf2e2e59",
24
- "references/aeo-geo-validation.md": "sha256:e45828d3ccca54a08513cb4235578c8a8ecf1dc47d1cb98e4a497838103bef70",
26
+ "references/aeo-geo-validation.md": "sha256:4b0041764f2fdbfbff1e1a2907eaed02cf0aef491254a9c98ec9250ff1084e80",
25
27
  "references/anti-patterns.md": "sha256:de63f8e646af0fbf479b45eb1d050ae62a8637acc320d21b87e4a083fd4c47e7",
26
- "references/capability-boundaries.md": "sha256:5d59f15cf97529fec26a105095278dc7a17ae3b829103994ec5ddf420897f448",
28
+ "references/capability-boundaries.md": "sha256:4901a32efbe747c8fed54ed1bffe345603c03a1bf5906b7f6da91395720f00e0",
27
29
  "references/evidence-authority.md": "sha256:b81ee09953999f16b19dc0eaba6fffe794b58d152e2adbd95c3179730bc08ffc",
28
30
  "rubrics/answer-extractability.md": "sha256:c8e741143c34e53afdb3dc7b6976ce7b4485dce13b12d14c193fccb17bacf1da",
29
31
  "rubrics/claim-boundedness.md": "sha256:0bab1b85248c252b966175912ebfae13bf18aa7e41573f7466831ac78b5d3e27",
@@ -38,43 +40,61 @@
38
40
  "rubrics/recommendation-eligibility.md": "sha256:38d2055fc5f6ab5e40fd1b48de4e0518fc4382da0b7062ad09c5afebcc673fc3",
39
41
  "rubrics/semantic-clarity.md": "sha256:66d9f4843a4a620ea8c00625c5e17c02baeaa373f2b445ce13de6f81d78ec7ba",
40
42
  "rubrics/source-authority.md": "sha256:8dbfe46bdcd0b5351f038be503601268c7d0abb9bed83be9ca58bf54dec5a73b",
43
+ "schemas/acceptance-corpus.schema.json": "sha256:b703be371ee33747d83814e448d18cd01f103f1832480a95df4331b86982165d",
44
+ "schemas/acceptance-run-context.schema.json": "sha256:56d75c7bcd166c3578a71699df1aa5466327c23c1e06e33773f2493f5caa1a50",
45
+ "schemas/acceptance-run-receipt.schema.json": "sha256:6c6e66767cf3b9adb42ace087f7e9a428312f41b7ecbaf533fc8d7ba5953da44",
41
46
  "schemas/action-plan.schema.json": "sha256:4b6c4c877840a065c7c0c0c7b52f696502bf3d4ca6d31179622fc364ea868d5e",
47
+ "schemas/artifact-interchange.schema.json": "sha256:c6f628934c8a1b8ea2996e03c2c5abd46c2a0e74c680b0a43e44c2343dc9aa21",
48
+ "schemas/assumption.schema.json": "sha256:31a0f44bbf1d207e013961ec4c39eea85c3ae9efde1485b5e26084562c816844",
42
49
  "schemas/bing-webmaster.schema.json": "sha256:8357c518a8cb4ccd1def2da38950fbba68270e2b1613ad522b50c568a3b8538f",
50
+ "schemas/browser-evidence-plan.schema.json": "sha256:f2c1a3fe05cdaf72a41c0a3d548ccf5bdf247dbe71b546759b15277df0e723ba",
43
51
  "schemas/claim.schema.json": "sha256:ce79ccbfa34ece9b7a309a6962522ea06a1f44c468b4c472b5c376554a788537",
44
52
  "schemas/common.defs.json": "sha256:effdd812910d1c275c50520bb70d8aec085e53fa8cb68054dc58c04a5d4a66b3",
45
53
  "schemas/competitor.schema.json": "sha256:2f6fd7e4543846bde56ff4dc62bb41fa366889787b794a7cdb0bff1a3392e591",
46
54
  "schemas/config.schema.json": "sha256:a87f3bb0087de09035b9f2dafea66e32e4fcc2e3e329abcd0fd8a5ec33318f2a",
47
55
  "schemas/connection.schema.json": "sha256:abcedde8d62d0c0663d4f959e06132a617908058ed965078965445ef3b108310",
56
+ "schemas/corpus-publication-receipt.schema.json": "sha256:a4d523fd1c1fa53762522891c06c06edb668cd15e1de3c7123d2b9948445ae32",
48
57
  "schemas/crawler-identity.schema.json": "sha256:e1e3e6da203a8bc49fba8f9bbde525368891db022d542fc615b677401825351d",
49
58
  "schemas/crawler.schema.json": "sha256:1a113dfb80bc6cde904c3ea648c82ea1d88fe50f2c1a0e7175d44abba28ac64e",
59
+ "schemas/customer-outcome.schema.json": "sha256:c0cdfee31a692feadb31dc6be734d45ae178ee53f28349c2a9e7504bdfcf9e50",
60
+ "schemas/decision.schema.json": "sha256:7c30f3ad83a6aa0b67ecc51ac6691e5e041b633d01bab17cee2b5218d926204e",
61
+ "schemas/deployment-receipt.schema.json": "sha256:789455907e7f3039fd55ee5b2568e09871128f513f5ddfe1f3afac1a4dd6b2bd",
50
62
  "schemas/detector-quality.schema.json": "sha256:5e9e1ac80b1198a0ff8fa17b9f7a543d3ccf3ed3d60196152f6ff095cfdebccd",
51
63
  "schemas/entity.schema.json": "sha256:78a08c35c8f4eb7a804ab46b61a238502f59621ac5218991e783251fbde61c4f",
52
64
  "schemas/evidence-authority.schema.json": "sha256:4f8165a37304ebab019e1c2dfec13f1168ecf89ce9bec88f7dca9c8554e39ac0",
53
65
  "schemas/evidence.schema.json": "sha256:76baec7ad7e89c6952473c01dacb9e3b26953c088331e6314d531ce620df9ec1",
54
66
  "schemas/exception.schema.json": "sha256:c88985494ec66554330fdc5b65d033527d0005acf41f10798b1e831d171f8944",
55
67
  "schemas/experiment.schema.json": "sha256:3cebebc5745a9eb359261408b0a0421b8370d2c94f8244ce939827cd9da41cb6",
68
+ "schemas/field-validation-metrics.schema.json": "sha256:bd5daeafc1593f1c4707d75180e1feb1e81d9345a57c1f269eadf13c36cb7012",
56
69
  "schemas/finding.schema.json": "sha256:85907cd04cd8d2fe24a1e618e0df7160f6d56aa1818db501f345aebce5eb5edb",
70
+ "schemas/initiative.schema.json": "sha256:491f6cc022c7ac1f9ea9ac9ddfcd270cb49c390e2601fe1e73aa6192a9e7689a",
57
71
  "schemas/intervention.schema.json": "sha256:fcf28e117b207e64ffc96088aa70a95370841a2a9fa43ecb1c82b34c2058a818",
72
+ "schemas/kpi.schema.json": "sha256:a45e2178ac03a97692b2c1dd667abde6b25b936c73ba0c32e4e98becb3d9d1c2",
58
73
  "schemas/media-manifest.schema.json": "sha256:3f37301aab9e913fa7febb15c720ed6384b106f12cef8d26cdd12d93fd85b41f",
59
74
  "schemas/metric.schema.json": "sha256:2ada648e7274a8d78cc9d6e7ed616f91faa79cf9ed07613e2c1fc53b247aac8d",
60
75
  "schemas/objective.schema.json": "sha256:94404dc95d04a6641ea7b9654317d0222793251ad44d3dfd2875738622a36025",
61
- "schemas/observation.schema.json": "sha256:eebb7deb445b9de8c2ffa603fce441f9a857ce290602d8828915fb630b566693",
76
+ "schemas/observation.schema.json": "sha256:b572ae8ba3d175509cc9fae914d8d054c0fb84ebcaf81de981532b527064538d",
62
77
  "schemas/page.schema.json": "sha256:627613c35f461177fa946df08edf66fbf6f6bbdfc57eef812572b3af796d5e07",
63
78
  "schemas/project.schema.json": "sha256:ea48fdb6480f7047ba4594bd5908bc1f79c1ad6b9a2c204df900959b5f203dc6",
64
79
  "schemas/prompt-result.schema.json": "sha256:b55be47d7d58d7b1dd8c3b1e849e24e55216212c592cde7eb836953379b85737",
65
80
  "schemas/prompt.schema.json": "sha256:7f0f50c83a86ac91faa7b79895dbc1fed371e8c0342e18d8c2877cc81f4f0f4c",
66
81
  "schemas/query.schema.json": "sha256:3c0793a8c0c48ab39320416790840b345ea987696f35b1cc364f23245a62aacb",
82
+ "schemas/release-manifest.schema.json": "sha256:962be645e790b5f3dc6f6ea455e187492d727dcb91d00f91e4e25b40e2dbc360",
83
+ "schemas/release-state.schema.json": "sha256:9920f68e538915d0d07044f313a9e410775a38ce9bb46a55d9ebe02970784803",
67
84
  "schemas/remediation-spec.schema.json": "sha256:6fe8cb773702862ba6d261198bb5cc2dca3eca0a2310a60ebddd04377654df8d",
68
85
  "schemas/review-item.schema.json": "sha256:df532a70385d5031bbc18654f3ccb436dc6e8d402ccf987e58f8f7e3ad2fb3f1",
69
86
  "schemas/review-policy.schema.json": "sha256:b2d176b1886f78c384b25532a0c3eb18548dfbd17f362a305e622bab562a1d04",
70
87
  "schemas/reviewer.schema.json": "sha256:3716697b752575a1277f2c2b318b1f2565de02bf9dce2a0c165567ab5330d18b",
88
+ "schemas/risk.schema.json": "sha256:ea3ca47a8457d98ea65df78e07ba6c20479906e8a3df07a6fa4be5644828fc49",
71
89
  "schemas/run.schema.json": "sha256:46c3178620f3a358d936d535aeadb83454b9b35b551e53e6615cc9862063dacb",
72
90
  "schemas/sampling-plan.schema.json": "sha256:005f70f149baaacd7de698548d556d3e401c630978748271b0e14a74726dd413",
91
+ "schemas/scenario.schema.json": "sha256:3f5bc2032d08f973600db068f475176a0e4706b33be42f99c778fe755a0ff38b",
73
92
  "schemas/schedule.schema.json": "sha256:0f02174ab0fc7bbbce9759fd358b18ed97cc683c76933fd3001cf053c499b157",
93
+ "schemas/variance.schema.json": "sha256:68389f64f0a3be13ff8951e8eefba9a5c31d0738325cb47e37c1a8435bea48f0",
74
94
  "scripts/README.md": "sha256:1c3e952950ef353849621b07c5f615bf7cd20cc5654da4635492a7bd6384e747",
75
- "SKILL.md": "sha256:d07fdc4d4cbc11b5c530bd97bf3e4d13d9c212cc3c67cf9798042f776f68609c",
95
+ "SKILL.md": "sha256:ac5817aa956c0d845ab4cc3adcc07b8bd814f924883b9c1178cbe745333616d1",
76
96
  "templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
77
- "VERSION": "sha256:74ee4d121463989183f9a9b848577eb2434f3f5d095de2a4b197bf29ffa2399b"
97
+ "VERSION": "sha256:b4a9545a385e9701482be56a0efee678d467d9c586ec476f2c5986cfaa24e96c"
78
98
  },
79
- "treeHash": "sha256:26c75b5cf68676c665ecf6a1e8d4ec5c6e77abdef8825c1c3ad8a099147168b8"
99
+ "treeHash": "sha256:8c0cfbcf3b6ed8a20ec337f655a3ee299f3f7cfd837bad5f7beb8627f3954242"
80
100
  }
@@ -9,7 +9,7 @@ not a prediction of citation or recommendation. Report every row as
9
9
  | State | Current evidence boundary |
10
10
  | --- | --- |
11
11
  | Retrieval eligibility | Static policy plus captured synthetic HTTP response; crawler identity remains simulated unless verified logs/IP evidence are supplied |
12
- | Source extraction and support suitability | Initial-HTML extraction plus registries/detectors/rubrics; rendered-DOM parity remains not established without a renderer |
12
+ | Source extraction and support suitability | Initial HTML plus registries/detectors/rubrics; optional fixed Chromium profiles and explicit Chromium/Firefox/WebKit journey plans establish bounded artifact-level parity, while semantic impact remains unproven |
13
13
  | Observed citation behavior | Operator-supplied prompt-result observations only; report cohort size and property citation presence, never infer from readiness |
14
14
 
15
15
  ## AEO checks
@@ -9,6 +9,9 @@ Use the narrowest supported state. Never promote evidence across rows.
9
9
  | Verified crawler reached edge | Imported evidence | `observe logs` record plus provider-published IP verification where supported |
10
10
  | Observed in production logs | Imported evidence | Timestamped `observe logs` artifact with URL, status, bytes, latency, cache result, UA, and verification result |
11
11
  | Indexed | Google API or imported evidence | `observe index`; Google inspection covers the indexed version, other engines require owner exports |
12
+ | Rendered profile observed | Optional local browser evidence | Successful profile-specific Chromium DOM, text, screenshot, failed requests, interactions, viewport, and configuration; failed profiles remain independent |
13
+ | Browser journey observed | Schema-validated local browser plan | Engine/version, device, JavaScript, locale, consent, authentication declaration, steps, DOM, text, accessibility snapshot, screenshots, and failures remain separate; differences do not establish semantic or citation impact |
14
+ | Render parity compared | Bounded local comparison | Raw/desktop and mobile/desktop word ratios from the same run or explicitly resumed immutable profiles; not semantic equivalence |
12
15
  | Returned by retrieval | Operator supplied | Provider observation containing retrieved source URL |
13
16
  | Cited | Import or disclosed adapter | Complete `observe citations` answer with citation URL and product/adapter mode |
14
17
  | Materially supports answer | Human review required | `citation_review` maps answer claim to source passage and names the reviewer |