@nebulacomponents/citable 1.11.0 → 1.12.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 (95) hide show
  1. package/CHANGELOG.md +11 -0
  2. package/README.md +6 -1
  3. package/dist/universal/.agents/skills/citable/SKILL.md +3 -1
  4. package/dist/universal/.agents/skills/citable/VERSION +1 -1
  5. package/dist/universal/.agents/skills/citable/commands/README.md +1 -1
  6. package/dist/universal/.agents/skills/citable/commands/observe-and-act.md +8 -1
  7. package/dist/universal/.agents/skills/citable/manifest.json +9 -9
  8. package/dist/universal/.agents/skills/citable/references/aeo-geo-validation.md +1 -1
  9. package/dist/universal/.agents/skills/citable/references/capability-boundaries.md +2 -0
  10. package/dist/universal/.claude/skills/citable/SKILL.md +3 -1
  11. package/dist/universal/.claude/skills/citable/VERSION +1 -1
  12. package/dist/universal/.claude/skills/citable/commands/README.md +1 -1
  13. package/dist/universal/.claude/skills/citable/commands/observe-and-act.md +8 -1
  14. package/dist/universal/.claude/skills/citable/manifest.json +9 -9
  15. package/dist/universal/.claude/skills/citable/references/aeo-geo-validation.md +1 -1
  16. package/dist/universal/.claude/skills/citable/references/capability-boundaries.md +2 -0
  17. package/dist/universal/.cursor/skills/citable/SKILL.md +3 -1
  18. package/dist/universal/.cursor/skills/citable/VERSION +1 -1
  19. package/dist/universal/.cursor/skills/citable/commands/README.md +1 -1
  20. package/dist/universal/.cursor/skills/citable/commands/observe-and-act.md +8 -1
  21. package/dist/universal/.cursor/skills/citable/manifest.json +9 -9
  22. package/dist/universal/.cursor/skills/citable/references/aeo-geo-validation.md +1 -1
  23. package/dist/universal/.cursor/skills/citable/references/capability-boundaries.md +2 -0
  24. package/dist/universal/.gemini/skills/citable/SKILL.md +3 -1
  25. package/dist/universal/.gemini/skills/citable/VERSION +1 -1
  26. package/dist/universal/.gemini/skills/citable/commands/README.md +1 -1
  27. package/dist/universal/.gemini/skills/citable/commands/observe-and-act.md +8 -1
  28. package/dist/universal/.gemini/skills/citable/manifest.json +9 -9
  29. package/dist/universal/.gemini/skills/citable/references/aeo-geo-validation.md +1 -1
  30. package/dist/universal/.gemini/skills/citable/references/capability-boundaries.md +2 -0
  31. package/dist/universal/.github/skills/citable/SKILL.md +3 -1
  32. package/dist/universal/.github/skills/citable/VERSION +1 -1
  33. package/dist/universal/.github/skills/citable/commands/README.md +1 -1
  34. package/dist/universal/.github/skills/citable/commands/observe-and-act.md +8 -1
  35. package/dist/universal/.github/skills/citable/manifest.json +9 -9
  36. package/dist/universal/.github/skills/citable/references/aeo-geo-validation.md +1 -1
  37. package/dist/universal/.github/skills/citable/references/capability-boundaries.md +2 -0
  38. package/dist/universal/.kiro/skills/citable/SKILL.md +3 -1
  39. package/dist/universal/.kiro/skills/citable/VERSION +1 -1
  40. package/dist/universal/.kiro/skills/citable/commands/README.md +1 -1
  41. package/dist/universal/.kiro/skills/citable/commands/observe-and-act.md +8 -1
  42. package/dist/universal/.kiro/skills/citable/manifest.json +9 -9
  43. package/dist/universal/.kiro/skills/citable/references/aeo-geo-validation.md +1 -1
  44. package/dist/universal/.kiro/skills/citable/references/capability-boundaries.md +2 -0
  45. package/dist/universal/.opencode/skills/citable/SKILL.md +3 -1
  46. package/dist/universal/.opencode/skills/citable/VERSION +1 -1
  47. package/dist/universal/.opencode/skills/citable/commands/README.md +1 -1
  48. package/dist/universal/.opencode/skills/citable/commands/observe-and-act.md +8 -1
  49. package/dist/universal/.opencode/skills/citable/manifest.json +9 -9
  50. package/dist/universal/.opencode/skills/citable/references/aeo-geo-validation.md +1 -1
  51. package/dist/universal/.opencode/skills/citable/references/capability-boundaries.md +2 -0
  52. package/dist/universal/.pi/agent/skills/citable/SKILL.md +3 -1
  53. package/dist/universal/.pi/agent/skills/citable/VERSION +1 -1
  54. package/dist/universal/.pi/agent/skills/citable/commands/README.md +1 -1
  55. package/dist/universal/.pi/agent/skills/citable/commands/observe-and-act.md +8 -1
  56. package/dist/universal/.pi/agent/skills/citable/manifest.json +9 -9
  57. package/dist/universal/.pi/agent/skills/citable/references/aeo-geo-validation.md +1 -1
  58. package/dist/universal/.pi/agent/skills/citable/references/capability-boundaries.md +2 -0
  59. package/dist/universal/.qoder/skills/citable/SKILL.md +3 -1
  60. package/dist/universal/.qoder/skills/citable/VERSION +1 -1
  61. package/dist/universal/.qoder/skills/citable/commands/README.md +1 -1
  62. package/dist/universal/.qoder/skills/citable/commands/observe-and-act.md +8 -1
  63. package/dist/universal/.qoder/skills/citable/manifest.json +9 -9
  64. package/dist/universal/.qoder/skills/citable/references/aeo-geo-validation.md +1 -1
  65. package/dist/universal/.qoder/skills/citable/references/capability-boundaries.md +2 -0
  66. package/dist/universal/.rovodev/skills/citable/SKILL.md +3 -1
  67. package/dist/universal/.rovodev/skills/citable/VERSION +1 -1
  68. package/dist/universal/.rovodev/skills/citable/commands/README.md +1 -1
  69. package/dist/universal/.rovodev/skills/citable/commands/observe-and-act.md +8 -1
  70. package/dist/universal/.rovodev/skills/citable/manifest.json +9 -9
  71. package/dist/universal/.rovodev/skills/citable/references/aeo-geo-validation.md +1 -1
  72. package/dist/universal/.rovodev/skills/citable/references/capability-boundaries.md +2 -0
  73. package/dist/universal/.trae/skills/citable/SKILL.md +3 -1
  74. package/dist/universal/.trae/skills/citable/VERSION +1 -1
  75. package/dist/universal/.trae/skills/citable/commands/README.md +1 -1
  76. package/dist/universal/.trae/skills/citable/commands/observe-and-act.md +8 -1
  77. package/dist/universal/.trae/skills/citable/manifest.json +9 -9
  78. package/dist/universal/.trae/skills/citable/references/aeo-geo-validation.md +1 -1
  79. package/dist/universal/.trae/skills/citable/references/capability-boundaries.md +2 -0
  80. package/dist/universal/.trae-cn/skills/citable/SKILL.md +3 -1
  81. package/dist/universal/.trae-cn/skills/citable/VERSION +1 -1
  82. package/dist/universal/.trae-cn/skills/citable/commands/README.md +1 -1
  83. package/dist/universal/.trae-cn/skills/citable/commands/observe-and-act.md +8 -1
  84. package/dist/universal/.trae-cn/skills/citable/manifest.json +9 -9
  85. package/dist/universal/.trae-cn/skills/citable/references/aeo-geo-validation.md +1 -1
  86. package/dist/universal/.trae-cn/skills/citable/references/capability-boundaries.md +2 -0
  87. package/dist/universal/manifest.json +99 -99
  88. package/package.json +9 -1
  89. package/skill/SKILL.md +3 -1
  90. package/skill/commands/README.md +1 -1
  91. package/skill/commands/observe-and-act.md +8 -1
  92. package/skill/references/aeo-geo-validation.md +1 -1
  93. package/skill/references/capability-boundaries.md +2 -0
  94. package/src/cli/index.js +6 -0
  95. package/src/commands/observe.js +118 -28
package/CHANGELOG.md CHANGED
@@ -2,6 +2,17 @@
2
2
 
3
3
  ## Unreleased
4
4
 
5
+ ## 1.12.0 — 2026-07-19
6
+
7
+ ### Added
8
+
9
+ - Independent desktop, mobile, and JavaScript-disabled Chromium render profiles
10
+ with raw/rendered parity artifacts and bounded interaction discovery.
11
+ - Partial-failure evidence and `--resume-run` recovery that reuses only
12
+ successful profiles from an immutable source run.
13
+ - Optional repeated local Lighthouse execution with pinned runtime metadata,
14
+ per-run artifacts, lab/field separation, and median metric summaries.
15
+
5
16
  ## 1.11.0 — 2026-07-19
6
17
 
7
18
  ### 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]
@@ -212,7 +215,9 @@ citable validate # registry schema + referential integrity
212
215
 
213
216
  Node >= 24.0.0. Network access is used for URL audits and explicitly selected
214
217
  live collectors. Render collection requires the optional `playwright` peer and
215
- an installed Chromium browser. Google index inspection uses `GSC_ACCESS_TOKEN`
218
+ an installed Chromium browser. Local Lighthouse collection requires the
219
+ optional `lighthouse` and `chrome-launcher` peers plus Chrome or Chromium.
220
+ Google index inspection uses `GSC_ACCESS_TOKEN`
216
221
  and `--site-url`; CrUX uses `CRUX_API_KEY`. Missing dependencies or credentials
217
222
  produce incomplete evidence. Supported frameworks for auto-detection: Next.js,
218
223
  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.12.0
11
11
  ---
12
12
 
13
13
  # Citable — evidence and change control for search and AI citation readiness
@@ -96,6 +96,8 @@ 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 performance --target <url> --lighthouse [--repeat 1..5]
99
101
  citable apply --input <spec> [--write] # reviewed, hash-locked remediation; dry run by default
100
102
  citable monitor [runA runB] # observation regression alerts
101
103
  citable metrics import --provider <name> --input <csv|json>
@@ -1 +1 @@
1
- 1.11.0
1
+ 1.12.0
@@ -34,7 +34,7 @@ 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`; desktop/mobile/JavaScript-disabled profiles and bounded interaction exploration are implemented, while cross-browser and application-specific journeys 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
39
 
40
40
  Shared refusal conditions (all commands): any action that would fabricate
@@ -9,7 +9,11 @@ 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.
13
17
  - `observe index --input <JSON>` imports owner exports. With `--target`,
14
18
  `--site-url`, and `GSC_ACCESS_TOKEN`, it calls Google URL Inspection, which
15
19
  reports the indexed version rather than performing a live indexability test.
@@ -21,6 +25,9 @@ failure_behaviour: unavailable dependency, credential, source run, reviewer, exa
21
25
  without IP verification remain low confidence.
22
26
  - `observe passages|consensus --target <dir|URL>` performs static extraction.
23
27
  - `observe performance` imports evidence or calls CrUX with `CRUX_API_KEY`.
28
+ `--lighthouse` instead performs 1-5 local lab runs (default 3) using optional
29
+ `lighthouse` and `chrome-launcher` peers, preserving each result and a median
30
+ summary. Lab evidence remains separate from CrUX field evidence.
24
31
  - `observe corroboration --input <JSON>` records observable external mentions;
25
32
  controlled or unverified sources do not become authority claims.
26
33
 
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "citable",
3
- "version": "1.11.0",
3
+ "version": "1.12.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.12.0",
9
9
  "variantPath": ".agents/skills/citable",
10
10
  "files": {
11
11
  "commands/action-findings.md": "sha256:510361461f24fcd4a550e0a8d960c383aefe23f9a65a54a3ffc44abd4c1293e7",
@@ -14,16 +14,16 @@
14
14
  "commands/ingest.md": "sha256:cf35659aecd9d0e160909003efdbe056864fc5d824c71b4ef0ee801ce07ff598",
15
15
  "commands/measurement.md": "sha256:9cade6dfec23338e18aa67ede3335ac9e2888dc577a7d4d8e3ceac948bce403f",
16
16
  "commands/media-evidence.md": "sha256:f2218feabe3360a2c9d569a5fa9b70d4b33a83a270d657151635e6f404fb34e0",
17
- "commands/observe-and-act.md": "sha256:02a93bbbfddc3d8e11cb921ddccd19b0666133c4bdb4f4a280bcb131bed37e8c",
17
+ "commands/observe-and-act.md": "sha256:00b24966c537b2868e722a49fe49b79e73b60b2454ecdb13b1a34ff3475036ae",
18
18
  "commands/optimize-page.md": "sha256:35866f3d7cdeef0376ea7a7d7036085a9b9cf95bbb300ecf4bd77610ebd74d85",
19
19
  "commands/page-work.md": "sha256:965a66e59bdf7b0da482d26fade53b3d265885ece5d463fe83b0789ebefaef3e",
20
- "commands/README.md": "sha256:36a0462ce9867dd46922185060341110f9c4b71582b96ec3f90ff1ff341f59ea",
20
+ "commands/README.md": "sha256:ced929fc2ea3af9be2b87433b88a1add8d6e0938d59c5b3cd24340a7ccc6abdb",
21
21
  "commands/reviews.md": "sha256:902904aaa405fe5724cf0662c7a5a36eab9a4fe0eb81cbd95ffa2fff946e0ac8",
22
22
  "commands/validate-render.md": "sha256:a8e1d04d40b84d57c35039250d98c6a7302cd44a148a8c3b9d9cfb92678c4347",
23
23
  "policies/crawler-policy-template.md": "sha256:15c88a4eeb21f53f71e5250dd3eb2d2791a814b304eaefce8bb30e2bdf2e2e59",
24
- "references/aeo-geo-validation.md": "sha256:e45828d3ccca54a08513cb4235578c8a8ecf1dc47d1cb98e4a497838103bef70",
24
+ "references/aeo-geo-validation.md": "sha256:47a33e717994191069ce96871e62e9bd6f9db32e8121c8784793ed1a58a1f245",
25
25
  "references/anti-patterns.md": "sha256:de63f8e646af0fbf479b45eb1d050ae62a8637acc320d21b87e4a083fd4c47e7",
26
- "references/capability-boundaries.md": "sha256:5d59f15cf97529fec26a105095278dc7a17ae3b829103994ec5ddf420897f448",
26
+ "references/capability-boundaries.md": "sha256:66d6860a6893a1613d4416b2185c48308457bf006bb943817623fd1bd700d9a8",
27
27
  "references/evidence-authority.md": "sha256:b81ee09953999f16b19dc0eaba6fffe794b58d152e2adbd95c3179730bc08ffc",
28
28
  "rubrics/answer-extractability.md": "sha256:c8e741143c34e53afdb3dc7b6976ce7b4485dce13b12d14c193fccb17bacf1da",
29
29
  "rubrics/claim-boundedness.md": "sha256:0bab1b85248c252b966175912ebfae13bf18aa7e41573f7466831ac78b5d3e27",
@@ -72,9 +72,9 @@
72
72
  "schemas/sampling-plan.schema.json": "sha256:005f70f149baaacd7de698548d556d3e401c630978748271b0e14a74726dd413",
73
73
  "schemas/schedule.schema.json": "sha256:0f02174ab0fc7bbbce9759fd358b18ed97cc683c76933fd3001cf053c499b157",
74
74
  "scripts/README.md": "sha256:1c3e952950ef353849621b07c5f615bf7cd20cc5654da4635492a7bd6384e747",
75
- "SKILL.md": "sha256:d07fdc4d4cbc11b5c530bd97bf3e4d13d9c212cc3c67cf9798042f776f68609c",
75
+ "SKILL.md": "sha256:b5607872edd36746674f596db543f02004d30c98d4c15b745bfdc42afa77be8d",
76
76
  "templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
77
- "VERSION": "sha256:74ee4d121463989183f9a9b848577eb2434f3f5d095de2a4b197bf29ffa2399b"
77
+ "VERSION": "sha256:c92df6bdde330be219d62f48ec6490b01889436f2f59027aab200e74de619168"
78
78
  },
79
- "treeHash": "sha256:26c75b5cf68676c665ecf6a1e8d4ec5c6e77abdef8825c1c3ad8a099147168b8"
79
+ "treeHash": "sha256:bf020f14e20b04db5037c18aa9bcbfa6ac5e39522681be610676de380ab7eeec"
80
80
  }
@@ -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 Chromium profiles can establish bounded raw/desktop/mobile/JavaScript-disabled parity, while cross-browser and application-specific journeys remain 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,8 @@ 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
+ | 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
14
  | Returned by retrieval | Operator supplied | Provider observation containing retrieved source URL |
13
15
  | Cited | Import or disclosed adapter | Complete `observe citations` answer with citation URL and product/adapter mode |
14
16
  | Materially supports answer | Human review required | `citation_review` maps answer claim to source passage and names the reviewer |
@@ -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.12.0
11
11
  ---
12
12
 
13
13
  # Citable — evidence and change control for search and AI citation readiness
@@ -96,6 +96,8 @@ 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 performance --target <url> --lighthouse [--repeat 1..5]
99
101
  citable apply --input <spec> [--write] # reviewed, hash-locked remediation; dry run by default
100
102
  citable monitor [runA runB] # observation regression alerts
101
103
  citable metrics import --provider <name> --input <csv|json>
@@ -1 +1 @@
1
- 1.11.0
1
+ 1.12.0
@@ -34,7 +34,7 @@ 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`; desktop/mobile/JavaScript-disabled profiles and bounded interaction exploration are implemented, while cross-browser and application-specific journeys 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
39
 
40
40
  Shared refusal conditions (all commands): any action that would fabricate
@@ -9,7 +9,11 @@ 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.
13
17
  - `observe index --input <JSON>` imports owner exports. With `--target`,
14
18
  `--site-url`, and `GSC_ACCESS_TOKEN`, it calls Google URL Inspection, which
15
19
  reports the indexed version rather than performing a live indexability test.
@@ -21,6 +25,9 @@ failure_behaviour: unavailable dependency, credential, source run, reviewer, exa
21
25
  without IP verification remain low confidence.
22
26
  - `observe passages|consensus --target <dir|URL>` performs static extraction.
23
27
  - `observe performance` imports evidence or calls CrUX with `CRUX_API_KEY`.
28
+ `--lighthouse` instead performs 1-5 local lab runs (default 3) using optional
29
+ `lighthouse` and `chrome-launcher` peers, preserving each result and a median
30
+ summary. Lab evidence remains separate from CrUX field evidence.
24
31
  - `observe corroboration --input <JSON>` records observable external mentions;
25
32
  controlled or unverified sources do not become authority claims.
26
33
 
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "citable",
3
- "version": "1.11.0",
3
+ "version": "1.12.0",
4
4
  "managedBy": "citable-cli",
5
5
  "provider": "claude",
6
6
  "providerName": "Claude Code",
7
7
  "scope": "bundle",
8
- "sourcePackage": "@nebulacomponents/citable@1.11.0",
8
+ "sourcePackage": "@nebulacomponents/citable@1.12.0",
9
9
  "variantPath": ".claude/skills/citable",
10
10
  "files": {
11
11
  "commands/action-findings.md": "sha256:510361461f24fcd4a550e0a8d960c383aefe23f9a65a54a3ffc44abd4c1293e7",
@@ -14,16 +14,16 @@
14
14
  "commands/ingest.md": "sha256:cf35659aecd9d0e160909003efdbe056864fc5d824c71b4ef0ee801ce07ff598",
15
15
  "commands/measurement.md": "sha256:9cade6dfec23338e18aa67ede3335ac9e2888dc577a7d4d8e3ceac948bce403f",
16
16
  "commands/media-evidence.md": "sha256:f2218feabe3360a2c9d569a5fa9b70d4b33a83a270d657151635e6f404fb34e0",
17
- "commands/observe-and-act.md": "sha256:02a93bbbfddc3d8e11cb921ddccd19b0666133c4bdb4f4a280bcb131bed37e8c",
17
+ "commands/observe-and-act.md": "sha256:00b24966c537b2868e722a49fe49b79e73b60b2454ecdb13b1a34ff3475036ae",
18
18
  "commands/optimize-page.md": "sha256:35866f3d7cdeef0376ea7a7d7036085a9b9cf95bbb300ecf4bd77610ebd74d85",
19
19
  "commands/page-work.md": "sha256:965a66e59bdf7b0da482d26fade53b3d265885ece5d463fe83b0789ebefaef3e",
20
- "commands/README.md": "sha256:36a0462ce9867dd46922185060341110f9c4b71582b96ec3f90ff1ff341f59ea",
20
+ "commands/README.md": "sha256:ced929fc2ea3af9be2b87433b88a1add8d6e0938d59c5b3cd24340a7ccc6abdb",
21
21
  "commands/reviews.md": "sha256:902904aaa405fe5724cf0662c7a5a36eab9a4fe0eb81cbd95ffa2fff946e0ac8",
22
22
  "commands/validate-render.md": "sha256:a8e1d04d40b84d57c35039250d98c6a7302cd44a148a8c3b9d9cfb92678c4347",
23
23
  "policies/crawler-policy-template.md": "sha256:15c88a4eeb21f53f71e5250dd3eb2d2791a814b304eaefce8bb30e2bdf2e2e59",
24
- "references/aeo-geo-validation.md": "sha256:e45828d3ccca54a08513cb4235578c8a8ecf1dc47d1cb98e4a497838103bef70",
24
+ "references/aeo-geo-validation.md": "sha256:47a33e717994191069ce96871e62e9bd6f9db32e8121c8784793ed1a58a1f245",
25
25
  "references/anti-patterns.md": "sha256:de63f8e646af0fbf479b45eb1d050ae62a8637acc320d21b87e4a083fd4c47e7",
26
- "references/capability-boundaries.md": "sha256:5d59f15cf97529fec26a105095278dc7a17ae3b829103994ec5ddf420897f448",
26
+ "references/capability-boundaries.md": "sha256:66d6860a6893a1613d4416b2185c48308457bf006bb943817623fd1bd700d9a8",
27
27
  "references/evidence-authority.md": "sha256:b81ee09953999f16b19dc0eaba6fffe794b58d152e2adbd95c3179730bc08ffc",
28
28
  "rubrics/answer-extractability.md": "sha256:c8e741143c34e53afdb3dc7b6976ce7b4485dce13b12d14c193fccb17bacf1da",
29
29
  "rubrics/claim-boundedness.md": "sha256:0bab1b85248c252b966175912ebfae13bf18aa7e41573f7466831ac78b5d3e27",
@@ -72,9 +72,9 @@
72
72
  "schemas/sampling-plan.schema.json": "sha256:005f70f149baaacd7de698548d556d3e401c630978748271b0e14a74726dd413",
73
73
  "schemas/schedule.schema.json": "sha256:0f02174ab0fc7bbbce9759fd358b18ed97cc683c76933fd3001cf053c499b157",
74
74
  "scripts/README.md": "sha256:1c3e952950ef353849621b07c5f615bf7cd20cc5654da4635492a7bd6384e747",
75
- "SKILL.md": "sha256:d07fdc4d4cbc11b5c530bd97bf3e4d13d9c212cc3c67cf9798042f776f68609c",
75
+ "SKILL.md": "sha256:b5607872edd36746674f596db543f02004d30c98d4c15b745bfdc42afa77be8d",
76
76
  "templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
77
- "VERSION": "sha256:74ee4d121463989183f9a9b848577eb2434f3f5d095de2a4b197bf29ffa2399b"
77
+ "VERSION": "sha256:c92df6bdde330be219d62f48ec6490b01889436f2f59027aab200e74de619168"
78
78
  },
79
- "treeHash": "sha256:26c75b5cf68676c665ecf6a1e8d4ec5c6e77abdef8825c1c3ad8a099147168b8"
79
+ "treeHash": "sha256:bf020f14e20b04db5037c18aa9bcbfa6ac5e39522681be610676de380ab7eeec"
80
80
  }
@@ -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 Chromium profiles can establish bounded raw/desktop/mobile/JavaScript-disabled parity, while cross-browser and application-specific journeys remain 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,8 @@ 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
+ | 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
14
  | Returned by retrieval | Operator supplied | Provider observation containing retrieved source URL |
13
15
  | Cited | Import or disclosed adapter | Complete `observe citations` answer with citation URL and product/adapter mode |
14
16
  | Materially supports answer | Human review required | `citation_review` maps answer claim to source passage and names the reviewer |
@@ -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.12.0
11
11
  ---
12
12
 
13
13
  # Citable — evidence and change control for search and AI citation readiness
@@ -96,6 +96,8 @@ 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 performance --target <url> --lighthouse [--repeat 1..5]
99
101
  citable apply --input <spec> [--write] # reviewed, hash-locked remediation; dry run by default
100
102
  citable monitor [runA runB] # observation regression alerts
101
103
  citable metrics import --provider <name> --input <csv|json>
@@ -1 +1 @@
1
- 1.11.0
1
+ 1.12.0
@@ -34,7 +34,7 @@ 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`; desktop/mobile/JavaScript-disabled profiles and bounded interaction exploration are implemented, while cross-browser and application-specific journeys 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
39
 
40
40
  Shared refusal conditions (all commands): any action that would fabricate
@@ -9,7 +9,11 @@ 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.
13
17
  - `observe index --input <JSON>` imports owner exports. With `--target`,
14
18
  `--site-url`, and `GSC_ACCESS_TOKEN`, it calls Google URL Inspection, which
15
19
  reports the indexed version rather than performing a live indexability test.
@@ -21,6 +25,9 @@ failure_behaviour: unavailable dependency, credential, source run, reviewer, exa
21
25
  without IP verification remain low confidence.
22
26
  - `observe passages|consensus --target <dir|URL>` performs static extraction.
23
27
  - `observe performance` imports evidence or calls CrUX with `CRUX_API_KEY`.
28
+ `--lighthouse` instead performs 1-5 local lab runs (default 3) using optional
29
+ `lighthouse` and `chrome-launcher` peers, preserving each result and a median
30
+ summary. Lab evidence remains separate from CrUX field evidence.
24
31
  - `observe corroboration --input <JSON>` records observable external mentions;
25
32
  controlled or unverified sources do not become authority claims.
26
33
 
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "citable",
3
- "version": "1.11.0",
3
+ "version": "1.12.0",
4
4
  "managedBy": "citable-cli",
5
5
  "provider": "cursor",
6
6
  "providerName": "Cursor",
7
7
  "scope": "bundle",
8
- "sourcePackage": "@nebulacomponents/citable@1.11.0",
8
+ "sourcePackage": "@nebulacomponents/citable@1.12.0",
9
9
  "variantPath": ".cursor/skills/citable",
10
10
  "files": {
11
11
  "commands/action-findings.md": "sha256:510361461f24fcd4a550e0a8d960c383aefe23f9a65a54a3ffc44abd4c1293e7",
@@ -14,16 +14,16 @@
14
14
  "commands/ingest.md": "sha256:cf35659aecd9d0e160909003efdbe056864fc5d824c71b4ef0ee801ce07ff598",
15
15
  "commands/measurement.md": "sha256:9cade6dfec23338e18aa67ede3335ac9e2888dc577a7d4d8e3ceac948bce403f",
16
16
  "commands/media-evidence.md": "sha256:f2218feabe3360a2c9d569a5fa9b70d4b33a83a270d657151635e6f404fb34e0",
17
- "commands/observe-and-act.md": "sha256:02a93bbbfddc3d8e11cb921ddccd19b0666133c4bdb4f4a280bcb131bed37e8c",
17
+ "commands/observe-and-act.md": "sha256:00b24966c537b2868e722a49fe49b79e73b60b2454ecdb13b1a34ff3475036ae",
18
18
  "commands/optimize-page.md": "sha256:35866f3d7cdeef0376ea7a7d7036085a9b9cf95bbb300ecf4bd77610ebd74d85",
19
19
  "commands/page-work.md": "sha256:965a66e59bdf7b0da482d26fade53b3d265885ece5d463fe83b0789ebefaef3e",
20
- "commands/README.md": "sha256:36a0462ce9867dd46922185060341110f9c4b71582b96ec3f90ff1ff341f59ea",
20
+ "commands/README.md": "sha256:ced929fc2ea3af9be2b87433b88a1add8d6e0938d59c5b3cd24340a7ccc6abdb",
21
21
  "commands/reviews.md": "sha256:902904aaa405fe5724cf0662c7a5a36eab9a4fe0eb81cbd95ffa2fff946e0ac8",
22
22
  "commands/validate-render.md": "sha256:a8e1d04d40b84d57c35039250d98c6a7302cd44a148a8c3b9d9cfb92678c4347",
23
23
  "policies/crawler-policy-template.md": "sha256:15c88a4eeb21f53f71e5250dd3eb2d2791a814b304eaefce8bb30e2bdf2e2e59",
24
- "references/aeo-geo-validation.md": "sha256:e45828d3ccca54a08513cb4235578c8a8ecf1dc47d1cb98e4a497838103bef70",
24
+ "references/aeo-geo-validation.md": "sha256:47a33e717994191069ce96871e62e9bd6f9db32e8121c8784793ed1a58a1f245",
25
25
  "references/anti-patterns.md": "sha256:de63f8e646af0fbf479b45eb1d050ae62a8637acc320d21b87e4a083fd4c47e7",
26
- "references/capability-boundaries.md": "sha256:5d59f15cf97529fec26a105095278dc7a17ae3b829103994ec5ddf420897f448",
26
+ "references/capability-boundaries.md": "sha256:66d6860a6893a1613d4416b2185c48308457bf006bb943817623fd1bd700d9a8",
27
27
  "references/evidence-authority.md": "sha256:b81ee09953999f16b19dc0eaba6fffe794b58d152e2adbd95c3179730bc08ffc",
28
28
  "rubrics/answer-extractability.md": "sha256:c8e741143c34e53afdb3dc7b6976ce7b4485dce13b12d14c193fccb17bacf1da",
29
29
  "rubrics/claim-boundedness.md": "sha256:0bab1b85248c252b966175912ebfae13bf18aa7e41573f7466831ac78b5d3e27",
@@ -72,9 +72,9 @@
72
72
  "schemas/sampling-plan.schema.json": "sha256:005f70f149baaacd7de698548d556d3e401c630978748271b0e14a74726dd413",
73
73
  "schemas/schedule.schema.json": "sha256:0f02174ab0fc7bbbce9759fd358b18ed97cc683c76933fd3001cf053c499b157",
74
74
  "scripts/README.md": "sha256:1c3e952950ef353849621b07c5f615bf7cd20cc5654da4635492a7bd6384e747",
75
- "SKILL.md": "sha256:d07fdc4d4cbc11b5c530bd97bf3e4d13d9c212cc3c67cf9798042f776f68609c",
75
+ "SKILL.md": "sha256:b5607872edd36746674f596db543f02004d30c98d4c15b745bfdc42afa77be8d",
76
76
  "templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
77
- "VERSION": "sha256:74ee4d121463989183f9a9b848577eb2434f3f5d095de2a4b197bf29ffa2399b"
77
+ "VERSION": "sha256:c92df6bdde330be219d62f48ec6490b01889436f2f59027aab200e74de619168"
78
78
  },
79
- "treeHash": "sha256:26c75b5cf68676c665ecf6a1e8d4ec5c6e77abdef8825c1c3ad8a099147168b8"
79
+ "treeHash": "sha256:bf020f14e20b04db5037c18aa9bcbfa6ac5e39522681be610676de380ab7eeec"
80
80
  }
@@ -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 Chromium profiles can establish bounded raw/desktop/mobile/JavaScript-disabled parity, while cross-browser and application-specific journeys remain 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,8 @@ 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
+ | 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
14
  | Returned by retrieval | Operator supplied | Provider observation containing retrieved source URL |
13
15
  | Cited | Import or disclosed adapter | Complete `observe citations` answer with citation URL and product/adapter mode |
14
16
  | Materially supports answer | Human review required | `citation_review` maps answer claim to source passage and names the reviewer |
@@ -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.12.0
11
11
  ---
12
12
 
13
13
  # Citable — evidence and change control for search and AI citation readiness
@@ -96,6 +96,8 @@ 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 performance --target <url> --lighthouse [--repeat 1..5]
99
101
  citable apply --input <spec> [--write] # reviewed, hash-locked remediation; dry run by default
100
102
  citable monitor [runA runB] # observation regression alerts
101
103
  citable metrics import --provider <name> --input <csv|json>
@@ -1 +1 @@
1
- 1.11.0
1
+ 1.12.0
@@ -34,7 +34,7 @@ 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`; desktop/mobile/JavaScript-disabled profiles and bounded interaction exploration are implemented, while cross-browser and application-specific journeys 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
39
 
40
40
  Shared refusal conditions (all commands): any action that would fabricate
@@ -9,7 +9,11 @@ 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.
13
17
  - `observe index --input <JSON>` imports owner exports. With `--target`,
14
18
  `--site-url`, and `GSC_ACCESS_TOKEN`, it calls Google URL Inspection, which
15
19
  reports the indexed version rather than performing a live indexability test.
@@ -21,6 +25,9 @@ failure_behaviour: unavailable dependency, credential, source run, reviewer, exa
21
25
  without IP verification remain low confidence.
22
26
  - `observe passages|consensus --target <dir|URL>` performs static extraction.
23
27
  - `observe performance` imports evidence or calls CrUX with `CRUX_API_KEY`.
28
+ `--lighthouse` instead performs 1-5 local lab runs (default 3) using optional
29
+ `lighthouse` and `chrome-launcher` peers, preserving each result and a median
30
+ summary. Lab evidence remains separate from CrUX field evidence.
24
31
  - `observe corroboration --input <JSON>` records observable external mentions;
25
32
  controlled or unverified sources do not become authority claims.
26
33
 
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "citable",
3
- "version": "1.11.0",
3
+ "version": "1.12.0",
4
4
  "managedBy": "citable-cli",
5
5
  "provider": "gemini",
6
6
  "providerName": "Gemini CLI",
7
7
  "scope": "bundle",
8
- "sourcePackage": "@nebulacomponents/citable@1.11.0",
8
+ "sourcePackage": "@nebulacomponents/citable@1.12.0",
9
9
  "variantPath": ".gemini/skills/citable",
10
10
  "files": {
11
11
  "commands/action-findings.md": "sha256:510361461f24fcd4a550e0a8d960c383aefe23f9a65a54a3ffc44abd4c1293e7",
@@ -14,16 +14,16 @@
14
14
  "commands/ingest.md": "sha256:cf35659aecd9d0e160909003efdbe056864fc5d824c71b4ef0ee801ce07ff598",
15
15
  "commands/measurement.md": "sha256:9cade6dfec23338e18aa67ede3335ac9e2888dc577a7d4d8e3ceac948bce403f",
16
16
  "commands/media-evidence.md": "sha256:f2218feabe3360a2c9d569a5fa9b70d4b33a83a270d657151635e6f404fb34e0",
17
- "commands/observe-and-act.md": "sha256:02a93bbbfddc3d8e11cb921ddccd19b0666133c4bdb4f4a280bcb131bed37e8c",
17
+ "commands/observe-and-act.md": "sha256:00b24966c537b2868e722a49fe49b79e73b60b2454ecdb13b1a34ff3475036ae",
18
18
  "commands/optimize-page.md": "sha256:35866f3d7cdeef0376ea7a7d7036085a9b9cf95bbb300ecf4bd77610ebd74d85",
19
19
  "commands/page-work.md": "sha256:965a66e59bdf7b0da482d26fade53b3d265885ece5d463fe83b0789ebefaef3e",
20
- "commands/README.md": "sha256:36a0462ce9867dd46922185060341110f9c4b71582b96ec3f90ff1ff341f59ea",
20
+ "commands/README.md": "sha256:ced929fc2ea3af9be2b87433b88a1add8d6e0938d59c5b3cd24340a7ccc6abdb",
21
21
  "commands/reviews.md": "sha256:902904aaa405fe5724cf0662c7a5a36eab9a4fe0eb81cbd95ffa2fff946e0ac8",
22
22
  "commands/validate-render.md": "sha256:a8e1d04d40b84d57c35039250d98c6a7302cd44a148a8c3b9d9cfb92678c4347",
23
23
  "policies/crawler-policy-template.md": "sha256:15c88a4eeb21f53f71e5250dd3eb2d2791a814b304eaefce8bb30e2bdf2e2e59",
24
- "references/aeo-geo-validation.md": "sha256:e45828d3ccca54a08513cb4235578c8a8ecf1dc47d1cb98e4a497838103bef70",
24
+ "references/aeo-geo-validation.md": "sha256:47a33e717994191069ce96871e62e9bd6f9db32e8121c8784793ed1a58a1f245",
25
25
  "references/anti-patterns.md": "sha256:de63f8e646af0fbf479b45eb1d050ae62a8637acc320d21b87e4a083fd4c47e7",
26
- "references/capability-boundaries.md": "sha256:5d59f15cf97529fec26a105095278dc7a17ae3b829103994ec5ddf420897f448",
26
+ "references/capability-boundaries.md": "sha256:66d6860a6893a1613d4416b2185c48308457bf006bb943817623fd1bd700d9a8",
27
27
  "references/evidence-authority.md": "sha256:b81ee09953999f16b19dc0eaba6fffe794b58d152e2adbd95c3179730bc08ffc",
28
28
  "rubrics/answer-extractability.md": "sha256:c8e741143c34e53afdb3dc7b6976ce7b4485dce13b12d14c193fccb17bacf1da",
29
29
  "rubrics/claim-boundedness.md": "sha256:0bab1b85248c252b966175912ebfae13bf18aa7e41573f7466831ac78b5d3e27",
@@ -72,9 +72,9 @@
72
72
  "schemas/sampling-plan.schema.json": "sha256:005f70f149baaacd7de698548d556d3e401c630978748271b0e14a74726dd413",
73
73
  "schemas/schedule.schema.json": "sha256:0f02174ab0fc7bbbce9759fd358b18ed97cc683c76933fd3001cf053c499b157",
74
74
  "scripts/README.md": "sha256:1c3e952950ef353849621b07c5f615bf7cd20cc5654da4635492a7bd6384e747",
75
- "SKILL.md": "sha256:d07fdc4d4cbc11b5c530bd97bf3e4d13d9c212cc3c67cf9798042f776f68609c",
75
+ "SKILL.md": "sha256:b5607872edd36746674f596db543f02004d30c98d4c15b745bfdc42afa77be8d",
76
76
  "templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
77
- "VERSION": "sha256:74ee4d121463989183f9a9b848577eb2434f3f5d095de2a4b197bf29ffa2399b"
77
+ "VERSION": "sha256:c92df6bdde330be219d62f48ec6490b01889436f2f59027aab200e74de619168"
78
78
  },
79
- "treeHash": "sha256:26c75b5cf68676c665ecf6a1e8d4ec5c6e77abdef8825c1c3ad8a099147168b8"
79
+ "treeHash": "sha256:bf020f14e20b04db5037c18aa9bcbfa6ac5e39522681be610676de380ab7eeec"
80
80
  }
@@ -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 Chromium profiles can establish bounded raw/desktop/mobile/JavaScript-disabled parity, while cross-browser and application-specific journeys remain 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,8 @@ 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
+ | 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
14
  | Returned by retrieval | Operator supplied | Provider observation containing retrieved source URL |
13
15
  | Cited | Import or disclosed adapter | Complete `observe citations` answer with citation URL and product/adapter mode |
14
16
  | Materially supports answer | Human review required | `citation_review` maps answer claim to source passage and names the reviewer |
@@ -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.12.0
11
11
  ---
12
12
 
13
13
  # Citable — evidence and change control for search and AI citation readiness
@@ -96,6 +96,8 @@ 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 performance --target <url> --lighthouse [--repeat 1..5]
99
101
  citable apply --input <spec> [--write] # reviewed, hash-locked remediation; dry run by default
100
102
  citable monitor [runA runB] # observation regression alerts
101
103
  citable metrics import --provider <name> --input <csv|json>
@@ -1 +1 @@
1
- 1.11.0
1
+ 1.12.0
@@ -34,7 +34,7 @@ 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`; desktop/mobile/JavaScript-disabled profiles and bounded interaction exploration are implemented, while cross-browser and application-specific journeys 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
39
 
40
40
  Shared refusal conditions (all commands): any action that would fabricate