@nebulacomponents/citable 1.10.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 (135) hide show
  1. package/CHANGELOG.md +22 -0
  2. package/README.md +9 -1
  3. package/dist/universal/.agents/skills/citable/SKILL.md +4 -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/media-evidence.md +17 -0
  7. package/dist/universal/.agents/skills/citable/commands/observe-and-act.md +8 -1
  8. package/dist/universal/.agents/skills/citable/manifest.json +12 -10
  9. package/dist/universal/.agents/skills/citable/references/aeo-geo-validation.md +1 -1
  10. package/dist/universal/.agents/skills/citable/references/capability-boundaries.md +2 -0
  11. package/dist/universal/.agents/skills/citable/schemas/media-manifest.schema.json +2 -0
  12. package/dist/universal/.agents/skills/citable/schemas/observation.schema.json +1 -1
  13. package/dist/universal/.claude/skills/citable/SKILL.md +4 -1
  14. package/dist/universal/.claude/skills/citable/VERSION +1 -1
  15. package/dist/universal/.claude/skills/citable/commands/README.md +2 -1
  16. package/dist/universal/.claude/skills/citable/commands/media-evidence.md +17 -0
  17. package/dist/universal/.claude/skills/citable/commands/observe-and-act.md +8 -1
  18. package/dist/universal/.claude/skills/citable/manifest.json +12 -10
  19. package/dist/universal/.claude/skills/citable/references/aeo-geo-validation.md +1 -1
  20. package/dist/universal/.claude/skills/citable/references/capability-boundaries.md +2 -0
  21. package/dist/universal/.claude/skills/citable/schemas/media-manifest.schema.json +2 -0
  22. package/dist/universal/.claude/skills/citable/schemas/observation.schema.json +1 -1
  23. package/dist/universal/.cursor/skills/citable/SKILL.md +4 -1
  24. package/dist/universal/.cursor/skills/citable/VERSION +1 -1
  25. package/dist/universal/.cursor/skills/citable/commands/README.md +2 -1
  26. package/dist/universal/.cursor/skills/citable/commands/media-evidence.md +17 -0
  27. package/dist/universal/.cursor/skills/citable/commands/observe-and-act.md +8 -1
  28. package/dist/universal/.cursor/skills/citable/manifest.json +12 -10
  29. package/dist/universal/.cursor/skills/citable/references/aeo-geo-validation.md +1 -1
  30. package/dist/universal/.cursor/skills/citable/references/capability-boundaries.md +2 -0
  31. package/dist/universal/.cursor/skills/citable/schemas/media-manifest.schema.json +2 -0
  32. package/dist/universal/.cursor/skills/citable/schemas/observation.schema.json +1 -1
  33. package/dist/universal/.gemini/skills/citable/SKILL.md +4 -1
  34. package/dist/universal/.gemini/skills/citable/VERSION +1 -1
  35. package/dist/universal/.gemini/skills/citable/commands/README.md +2 -1
  36. package/dist/universal/.gemini/skills/citable/commands/media-evidence.md +17 -0
  37. package/dist/universal/.gemini/skills/citable/commands/observe-and-act.md +8 -1
  38. package/dist/universal/.gemini/skills/citable/manifest.json +12 -10
  39. package/dist/universal/.gemini/skills/citable/references/aeo-geo-validation.md +1 -1
  40. package/dist/universal/.gemini/skills/citable/references/capability-boundaries.md +2 -0
  41. package/dist/universal/.gemini/skills/citable/schemas/media-manifest.schema.json +2 -0
  42. package/dist/universal/.gemini/skills/citable/schemas/observation.schema.json +1 -1
  43. package/dist/universal/.github/skills/citable/SKILL.md +4 -1
  44. package/dist/universal/.github/skills/citable/VERSION +1 -1
  45. package/dist/universal/.github/skills/citable/commands/README.md +2 -1
  46. package/dist/universal/.github/skills/citable/commands/media-evidence.md +17 -0
  47. package/dist/universal/.github/skills/citable/commands/observe-and-act.md +8 -1
  48. package/dist/universal/.github/skills/citable/manifest.json +12 -10
  49. package/dist/universal/.github/skills/citable/references/aeo-geo-validation.md +1 -1
  50. package/dist/universal/.github/skills/citable/references/capability-boundaries.md +2 -0
  51. package/dist/universal/.github/skills/citable/schemas/media-manifest.schema.json +2 -0
  52. package/dist/universal/.github/skills/citable/schemas/observation.schema.json +1 -1
  53. package/dist/universal/.kiro/skills/citable/SKILL.md +4 -1
  54. package/dist/universal/.kiro/skills/citable/VERSION +1 -1
  55. package/dist/universal/.kiro/skills/citable/commands/README.md +2 -1
  56. package/dist/universal/.kiro/skills/citable/commands/media-evidence.md +17 -0
  57. package/dist/universal/.kiro/skills/citable/commands/observe-and-act.md +8 -1
  58. package/dist/universal/.kiro/skills/citable/manifest.json +12 -10
  59. package/dist/universal/.kiro/skills/citable/references/aeo-geo-validation.md +1 -1
  60. package/dist/universal/.kiro/skills/citable/references/capability-boundaries.md +2 -0
  61. package/dist/universal/.kiro/skills/citable/schemas/media-manifest.schema.json +2 -0
  62. package/dist/universal/.kiro/skills/citable/schemas/observation.schema.json +1 -1
  63. package/dist/universal/.opencode/skills/citable/SKILL.md +4 -1
  64. package/dist/universal/.opencode/skills/citable/VERSION +1 -1
  65. package/dist/universal/.opencode/skills/citable/commands/README.md +2 -1
  66. package/dist/universal/.opencode/skills/citable/commands/media-evidence.md +17 -0
  67. package/dist/universal/.opencode/skills/citable/commands/observe-and-act.md +8 -1
  68. package/dist/universal/.opencode/skills/citable/manifest.json +12 -10
  69. package/dist/universal/.opencode/skills/citable/references/aeo-geo-validation.md +1 -1
  70. package/dist/universal/.opencode/skills/citable/references/capability-boundaries.md +2 -0
  71. package/dist/universal/.opencode/skills/citable/schemas/media-manifest.schema.json +2 -0
  72. package/dist/universal/.opencode/skills/citable/schemas/observation.schema.json +1 -1
  73. package/dist/universal/.pi/agent/skills/citable/SKILL.md +4 -1
  74. package/dist/universal/.pi/agent/skills/citable/VERSION +1 -1
  75. package/dist/universal/.pi/agent/skills/citable/commands/README.md +2 -1
  76. package/dist/universal/.pi/agent/skills/citable/commands/media-evidence.md +17 -0
  77. package/dist/universal/.pi/agent/skills/citable/commands/observe-and-act.md +8 -1
  78. package/dist/universal/.pi/agent/skills/citable/manifest.json +12 -10
  79. package/dist/universal/.pi/agent/skills/citable/references/aeo-geo-validation.md +1 -1
  80. package/dist/universal/.pi/agent/skills/citable/references/capability-boundaries.md +2 -0
  81. package/dist/universal/.pi/agent/skills/citable/schemas/media-manifest.schema.json +2 -0
  82. package/dist/universal/.pi/agent/skills/citable/schemas/observation.schema.json +1 -1
  83. package/dist/universal/.qoder/skills/citable/SKILL.md +4 -1
  84. package/dist/universal/.qoder/skills/citable/VERSION +1 -1
  85. package/dist/universal/.qoder/skills/citable/commands/README.md +2 -1
  86. package/dist/universal/.qoder/skills/citable/commands/media-evidence.md +17 -0
  87. package/dist/universal/.qoder/skills/citable/commands/observe-and-act.md +8 -1
  88. package/dist/universal/.qoder/skills/citable/manifest.json +12 -10
  89. package/dist/universal/.qoder/skills/citable/references/aeo-geo-validation.md +1 -1
  90. package/dist/universal/.qoder/skills/citable/references/capability-boundaries.md +2 -0
  91. package/dist/universal/.qoder/skills/citable/schemas/media-manifest.schema.json +2 -0
  92. package/dist/universal/.qoder/skills/citable/schemas/observation.schema.json +1 -1
  93. package/dist/universal/.rovodev/skills/citable/SKILL.md +4 -1
  94. package/dist/universal/.rovodev/skills/citable/VERSION +1 -1
  95. package/dist/universal/.rovodev/skills/citable/commands/README.md +2 -1
  96. package/dist/universal/.rovodev/skills/citable/commands/media-evidence.md +17 -0
  97. package/dist/universal/.rovodev/skills/citable/commands/observe-and-act.md +8 -1
  98. package/dist/universal/.rovodev/skills/citable/manifest.json +12 -10
  99. package/dist/universal/.rovodev/skills/citable/references/aeo-geo-validation.md +1 -1
  100. package/dist/universal/.rovodev/skills/citable/references/capability-boundaries.md +2 -0
  101. package/dist/universal/.rovodev/skills/citable/schemas/media-manifest.schema.json +2 -0
  102. package/dist/universal/.rovodev/skills/citable/schemas/observation.schema.json +1 -1
  103. package/dist/universal/.trae/skills/citable/SKILL.md +4 -1
  104. package/dist/universal/.trae/skills/citable/VERSION +1 -1
  105. package/dist/universal/.trae/skills/citable/commands/README.md +2 -1
  106. package/dist/universal/.trae/skills/citable/commands/media-evidence.md +17 -0
  107. package/dist/universal/.trae/skills/citable/commands/observe-and-act.md +8 -1
  108. package/dist/universal/.trae/skills/citable/manifest.json +12 -10
  109. package/dist/universal/.trae/skills/citable/references/aeo-geo-validation.md +1 -1
  110. package/dist/universal/.trae/skills/citable/references/capability-boundaries.md +2 -0
  111. package/dist/universal/.trae/skills/citable/schemas/media-manifest.schema.json +2 -0
  112. package/dist/universal/.trae/skills/citable/schemas/observation.schema.json +1 -1
  113. package/dist/universal/.trae-cn/skills/citable/SKILL.md +4 -1
  114. package/dist/universal/.trae-cn/skills/citable/VERSION +1 -1
  115. package/dist/universal/.trae-cn/skills/citable/commands/README.md +2 -1
  116. package/dist/universal/.trae-cn/skills/citable/commands/media-evidence.md +17 -0
  117. package/dist/universal/.trae-cn/skills/citable/commands/observe-and-act.md +8 -1
  118. package/dist/universal/.trae-cn/skills/citable/manifest.json +12 -10
  119. package/dist/universal/.trae-cn/skills/citable/references/aeo-geo-validation.md +1 -1
  120. package/dist/universal/.trae-cn/skills/citable/references/capability-boundaries.md +2 -0
  121. package/dist/universal/.trae-cn/skills/citable/schemas/media-manifest.schema.json +2 -0
  122. package/dist/universal/.trae-cn/skills/citable/schemas/observation.schema.json +1 -1
  123. package/dist/universal/manifest.json +147 -123
  124. package/package.json +16 -3
  125. package/schemas/media-manifest.schema.json +2 -0
  126. package/schemas/observation.schema.json +1 -1
  127. package/skill/SKILL.md +4 -1
  128. package/skill/commands/README.md +2 -1
  129. package/skill/commands/media-evidence.md +17 -0
  130. package/skill/commands/observe-and-act.md +8 -1
  131. package/skill/references/aeo-geo-validation.md +1 -1
  132. package/skill/references/capability-boundaries.md +2 -0
  133. package/src/cli/index.js +9 -1
  134. package/src/commands/observe.js +121 -29
  135. package/src/observations/media.js +75 -0
@@ -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 |
@@ -0,0 +1,2 @@
1
+ {
2
+ "$id":"citable://schemas/media-manifest.schema.json","$schema":"http://json-schema.org/draft-07/schema#","title":"Media evidence import manifest","type":"object","additionalProperties":false,"required":["version","items"],"properties":{"version":{"const":1},"items":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":false,"required":["media_id","type","path","source_url","page_url","claim_ids","permission_status"],"properties":{"media_id":{"type":"string","pattern":"^MEDIA-[A-Z0-9][A-Z0-9_-]*$"},"type":{"type":"string","enum":["pdf","transcript","image"]},"path":{"type":"string","minLength":1},"source_url":{"type":["string","null"]},"page_url":{"type":["string","null"]},"claim_ids":{"type":"array","uniqueItems":true,"items":{"type":"string"}},"permission_status":{"type":"string","enum":["owner_authorized","licensed","public_unknown","internal"]},"image_src":{"type":"string"},"language":{"type":"string"},"published_at":{"type":"string","format":"date-time"}}}}}}
@@ -7,7 +7,7 @@
7
7
  "required": ["observation_id", "kind", "state", "collected_at", "collection_method", "confidence", "source", "evidence_hash", "data"],
8
8
  "properties": {
9
9
  "observation_id": { "type": "string", "minLength": 1 },
10
- "kind": { "type": "string", "enum": ["render", "index", "citation", "citation_review", "crawler_log", "bing_webmaster", "passage", "canonical_freshness", "performance", "corroboration", "metric"] },
10
+ "kind": { "type": "string", "enum": ["render", "index", "citation", "citation_review", "crawler_log", "bing_webmaster", "passage", "canonical_freshness", "performance", "corroboration", "metric", "media_pdf", "media_transcript", "media_image"] },
11
11
  "state": { "type": "string", "enum": ["observed", "not_observed", "not_evidenced", "incomplete", "review_required", "failed"] },
12
12
  "collected_at": { "type": "string", "format": "date-time" },
13
13
  "collection_method": { "type": "string", "enum": ["live_api", "browser", "owner_import", "synthetic_fetch", "static_analysis", "human_review"] },
@@ -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.10.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>
@@ -117,6 +119,7 @@ citable reviews sample <sampling-plan-id> [--write]
117
119
  citable reviews evaluate
118
120
  citable schedules run <schedule-id> [--ref-date YYYY-MM-DD]
119
121
  citable project github <run-id>
122
+ citable observe media --input <manifest.json> [--ocr]
120
123
  ```
121
124
 
122
125
  Audit scopes: `technical seo aeo geo architecture entity claims evidence schema
@@ -1 +1 @@
1
- 1.10.0
1
+ 1.12.0
@@ -30,10 +30,11 @@ intent, not executability, so statuses are strict:
30
30
  | /citable governance validate / evaluate | implemented — validates reviewer and exception authority and emits immutable dispositions without changing failed findings |
31
31
  | /citable reviews queue / prioritize / plan / sample / evaluate | implemented — materiality queues, reproducible sampling, stale-decision checks, and independent disagreement adjudication |
32
32
  | /citable schedules run / project github | implemented — canonical scheduled audits and hash-bound non-authoritative GitHub projections |
33
+ | /citable observe media | implemented — bounded PDF, transcript, image-context, optional OCR, and declared claim-link evidence |
33
34
  | /citable ingest, map-site, map-queries, map-prompts, map-entities, map-evidence | specified (ingest.md) |
34
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 |
35
36
  | /citable create-page, answer-block, architect, interlink, consolidate, metadata | specified (page-work.md) |
36
- | /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 |
37
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 |
38
39
 
39
40
  Shared refusal conditions (all commands): any action that would fabricate
@@ -0,0 +1,17 @@
1
+ # Media evidence collection
2
+
3
+ Use `citable observe media --input <manifest.json>` for bounded local-media
4
+ evidence. The manifest declares source URL, owning page, permission status, and
5
+ linked claim IDs for each PDF, transcript, or image-context source.
6
+
7
+ PDF collection extracts native text, basic metadata, and stable page anchors.
8
+ It does not establish reading order, table structure, footnote linkage,
9
+ signatures, revisions, scan accuracy, accessibility, or claim support.
10
+ Transcript collection preserves cues but does not verify speakers, timing,
11
+ accuracy, or source-media parity. Image collection records alt text, captions,
12
+ and nearby figure text without inferring visual entailment.
13
+
14
+ OCR is off by default. `--ocr` explicitly requests the optional `tesseract.js`
15
+ path; an unavailable engine or image produces incomplete evidence, never guessed
16
+ text. Every media-to-claim relationship is declarative and still requires
17
+ human-authoritative semantic review.
@@ -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.10.0",
3
+ "version": "1.12.0",
4
4
  "managedBy": "citable-cli",
5
5
  "provider": "opencode",
6
6
  "providerName": "OpenCode",
7
7
  "scope": "bundle",
8
- "sourcePackage": "@nebulacomponents/citable@1.10.0",
8
+ "sourcePackage": "@nebulacomponents/citable@1.12.0",
9
9
  "variantPath": ".opencode/skills/citable",
10
10
  "files": {
11
11
  "commands/action-findings.md": "sha256:510361461f24fcd4a550e0a8d960c383aefe23f9a65a54a3ffc44abd4c1293e7",
@@ -13,16 +13,17 @@
13
13
  "commands/governance.md": "sha256:1fd6272f18b00237fc6e602ac126ae812747937b2bb575068a0d617137eea2b0",
14
14
  "commands/ingest.md": "sha256:cf35659aecd9d0e160909003efdbe056864fc5d824c71b4ef0ee801ce07ff598",
15
15
  "commands/measurement.md": "sha256:9cade6dfec23338e18aa67ede3335ac9e2888dc577a7d4d8e3ceac948bce403f",
16
- "commands/observe-and-act.md": "sha256:02a93bbbfddc3d8e11cb921ddccd19b0666133c4bdb4f4a280bcb131bed37e8c",
16
+ "commands/media-evidence.md": "sha256:f2218feabe3360a2c9d569a5fa9b70d4b33a83a270d657151635e6f404fb34e0",
17
+ "commands/observe-and-act.md": "sha256:00b24966c537b2868e722a49fe49b79e73b60b2454ecdb13b1a34ff3475036ae",
17
18
  "commands/optimize-page.md": "sha256:35866f3d7cdeef0376ea7a7d7036085a9b9cf95bbb300ecf4bd77610ebd74d85",
18
19
  "commands/page-work.md": "sha256:965a66e59bdf7b0da482d26fade53b3d265885ece5d463fe83b0789ebefaef3e",
19
- "commands/README.md": "sha256:0d1831883c99925d3eccef7ae551f88f9789b12cf9598ab4026f50c776697a5a",
20
+ "commands/README.md": "sha256:ced929fc2ea3af9be2b87433b88a1add8d6e0938d59c5b3cd24340a7ccc6abdb",
20
21
  "commands/reviews.md": "sha256:902904aaa405fe5724cf0662c7a5a36eab9a4fe0eb81cbd95ffa2fff946e0ac8",
21
22
  "commands/validate-render.md": "sha256:a8e1d04d40b84d57c35039250d98c6a7302cd44a148a8c3b9d9cfb92678c4347",
22
23
  "policies/crawler-policy-template.md": "sha256:15c88a4eeb21f53f71e5250dd3eb2d2791a814b304eaefce8bb30e2bdf2e2e59",
23
- "references/aeo-geo-validation.md": "sha256:e45828d3ccca54a08513cb4235578c8a8ecf1dc47d1cb98e4a497838103bef70",
24
+ "references/aeo-geo-validation.md": "sha256:47a33e717994191069ce96871e62e9bd6f9db32e8121c8784793ed1a58a1f245",
24
25
  "references/anti-patterns.md": "sha256:de63f8e646af0fbf479b45eb1d050ae62a8637acc320d21b87e4a083fd4c47e7",
25
- "references/capability-boundaries.md": "sha256:5d59f15cf97529fec26a105095278dc7a17ae3b829103994ec5ddf420897f448",
26
+ "references/capability-boundaries.md": "sha256:66d6860a6893a1613d4416b2185c48308457bf006bb943817623fd1bd700d9a8",
26
27
  "references/evidence-authority.md": "sha256:b81ee09953999f16b19dc0eaba6fffe794b58d152e2adbd95c3179730bc08ffc",
27
28
  "rubrics/answer-extractability.md": "sha256:c8e741143c34e53afdb3dc7b6976ce7b4485dce13b12d14c193fccb17bacf1da",
28
29
  "rubrics/claim-boundedness.md": "sha256:0bab1b85248c252b966175912ebfae13bf18aa7e41573f7466831ac78b5d3e27",
@@ -54,9 +55,10 @@
54
55
  "schemas/experiment.schema.json": "sha256:3cebebc5745a9eb359261408b0a0421b8370d2c94f8244ce939827cd9da41cb6",
55
56
  "schemas/finding.schema.json": "sha256:85907cd04cd8d2fe24a1e618e0df7160f6d56aa1818db501f345aebce5eb5edb",
56
57
  "schemas/intervention.schema.json": "sha256:fcf28e117b207e64ffc96088aa70a95370841a2a9fa43ecb1c82b34c2058a818",
58
+ "schemas/media-manifest.schema.json": "sha256:3f37301aab9e913fa7febb15c720ed6384b106f12cef8d26cdd12d93fd85b41f",
57
59
  "schemas/metric.schema.json": "sha256:2ada648e7274a8d78cc9d6e7ed616f91faa79cf9ed07613e2c1fc53b247aac8d",
58
60
  "schemas/objective.schema.json": "sha256:94404dc95d04a6641ea7b9654317d0222793251ad44d3dfd2875738622a36025",
59
- "schemas/observation.schema.json": "sha256:bea8eb7ea74442a1be745aa40ff22d25dcd89a82fb0205dfc6c597da40831f64",
61
+ "schemas/observation.schema.json": "sha256:eebb7deb445b9de8c2ffa603fce441f9a857ce290602d8828915fb630b566693",
60
62
  "schemas/page.schema.json": "sha256:627613c35f461177fa946df08edf66fbf6f6bbdfc57eef812572b3af796d5e07",
61
63
  "schemas/project.schema.json": "sha256:ea48fdb6480f7047ba4594bd5908bc1f79c1ad6b9a2c204df900959b5f203dc6",
62
64
  "schemas/prompt-result.schema.json": "sha256:b55be47d7d58d7b1dd8c3b1e849e24e55216212c592cde7eb836953379b85737",
@@ -70,9 +72,9 @@
70
72
  "schemas/sampling-plan.schema.json": "sha256:005f70f149baaacd7de698548d556d3e401c630978748271b0e14a74726dd413",
71
73
  "schemas/schedule.schema.json": "sha256:0f02174ab0fc7bbbce9759fd358b18ed97cc683c76933fd3001cf053c499b157",
72
74
  "scripts/README.md": "sha256:1c3e952950ef353849621b07c5f615bf7cd20cc5654da4635492a7bd6384e747",
73
- "SKILL.md": "sha256:95336d8e690b54f72de14020a35d87d41fcaa1080a6242d821ff3df4efdf0ab6",
75
+ "SKILL.md": "sha256:b5607872edd36746674f596db543f02004d30c98d4c15b745bfdc42afa77be8d",
74
76
  "templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
75
- "VERSION": "sha256:4f5ba6a3e380bf810cc968b58d30a8d7163eafe9e2fb1ad19bdc6d9d64a1e549"
77
+ "VERSION": "sha256:c92df6bdde330be219d62f48ec6490b01889436f2f59027aab200e74de619168"
76
78
  },
77
- "treeHash": "sha256:81a5e1f3bf7560060b3f950c18804d5481b1230ab9e0b81d3ce16d0b97e43893"
79
+ "treeHash": "sha256:bf020f14e20b04db5037c18aa9bcbfa6ac5e39522681be610676de380ab7eeec"
78
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 |
@@ -0,0 +1,2 @@
1
+ {
2
+ "$id":"citable://schemas/media-manifest.schema.json","$schema":"http://json-schema.org/draft-07/schema#","title":"Media evidence import manifest","type":"object","additionalProperties":false,"required":["version","items"],"properties":{"version":{"const":1},"items":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":false,"required":["media_id","type","path","source_url","page_url","claim_ids","permission_status"],"properties":{"media_id":{"type":"string","pattern":"^MEDIA-[A-Z0-9][A-Z0-9_-]*$"},"type":{"type":"string","enum":["pdf","transcript","image"]},"path":{"type":"string","minLength":1},"source_url":{"type":["string","null"]},"page_url":{"type":["string","null"]},"claim_ids":{"type":"array","uniqueItems":true,"items":{"type":"string"}},"permission_status":{"type":"string","enum":["owner_authorized","licensed","public_unknown","internal"]},"image_src":{"type":"string"},"language":{"type":"string"},"published_at":{"type":"string","format":"date-time"}}}}}}
@@ -7,7 +7,7 @@
7
7
  "required": ["observation_id", "kind", "state", "collected_at", "collection_method", "confidence", "source", "evidence_hash", "data"],
8
8
  "properties": {
9
9
  "observation_id": { "type": "string", "minLength": 1 },
10
- "kind": { "type": "string", "enum": ["render", "index", "citation", "citation_review", "crawler_log", "bing_webmaster", "passage", "canonical_freshness", "performance", "corroboration", "metric"] },
10
+ "kind": { "type": "string", "enum": ["render", "index", "citation", "citation_review", "crawler_log", "bing_webmaster", "passage", "canonical_freshness", "performance", "corroboration", "metric", "media_pdf", "media_transcript", "media_image"] },
11
11
  "state": { "type": "string", "enum": ["observed", "not_observed", "not_evidenced", "incomplete", "review_required", "failed"] },
12
12
  "collected_at": { "type": "string", "format": "date-time" },
13
13
  "collection_method": { "type": "string", "enum": ["live_api", "browser", "owner_import", "synthetic_fetch", "static_analysis", "human_review"] },
@@ -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.10.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>
@@ -117,6 +119,7 @@ citable reviews sample <sampling-plan-id> [--write]
117
119
  citable reviews evaluate
118
120
  citable schedules run <schedule-id> [--ref-date YYYY-MM-DD]
119
121
  citable project github <run-id>
122
+ citable observe media --input <manifest.json> [--ocr]
120
123
  ```
121
124
 
122
125
  Audit scopes: `technical seo aeo geo architecture entity claims evidence schema
@@ -1 +1 @@
1
- 1.10.0
1
+ 1.12.0
@@ -30,10 +30,11 @@ intent, not executability, so statuses are strict:
30
30
  | /citable governance validate / evaluate | implemented — validates reviewer and exception authority and emits immutable dispositions without changing failed findings |
31
31
  | /citable reviews queue / prioritize / plan / sample / evaluate | implemented — materiality queues, reproducible sampling, stale-decision checks, and independent disagreement adjudication |
32
32
  | /citable schedules run / project github | implemented — canonical scheduled audits and hash-bound non-authoritative GitHub projections |
33
+ | /citable observe media | implemented — bounded PDF, transcript, image-context, optional OCR, and declared claim-link evidence |
33
34
  | /citable ingest, map-site, map-queries, map-prompts, map-entities, map-evidence | specified (ingest.md) |
34
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 |
35
36
  | /citable create-page, answer-block, architect, interlink, consolidate, metadata | specified (page-work.md) |
36
- | /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 |
37
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 |
38
39
 
39
40
  Shared refusal conditions (all commands): any action that would fabricate
@@ -0,0 +1,17 @@
1
+ # Media evidence collection
2
+
3
+ Use `citable observe media --input <manifest.json>` for bounded local-media
4
+ evidence. The manifest declares source URL, owning page, permission status, and
5
+ linked claim IDs for each PDF, transcript, or image-context source.
6
+
7
+ PDF collection extracts native text, basic metadata, and stable page anchors.
8
+ It does not establish reading order, table structure, footnote linkage,
9
+ signatures, revisions, scan accuracy, accessibility, or claim support.
10
+ Transcript collection preserves cues but does not verify speakers, timing,
11
+ accuracy, or source-media parity. Image collection records alt text, captions,
12
+ and nearby figure text without inferring visual entailment.
13
+
14
+ OCR is off by default. `--ocr` explicitly requests the optional `tesseract.js`
15
+ path; an unavailable engine or image produces incomplete evidence, never guessed
16
+ text. Every media-to-claim relationship is declarative and still requires
17
+ human-authoritative semantic review.
@@ -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.10.0",
3
+ "version": "1.12.0",
4
4
  "managedBy": "citable-cli",
5
5
  "provider": "pi",
6
6
  "providerName": "Pi",
7
7
  "scope": "bundle",
8
- "sourcePackage": "@nebulacomponents/citable@1.10.0",
8
+ "sourcePackage": "@nebulacomponents/citable@1.12.0",
9
9
  "variantPath": ".pi/agent/skills/citable",
10
10
  "files": {
11
11
  "commands/action-findings.md": "sha256:510361461f24fcd4a550e0a8d960c383aefe23f9a65a54a3ffc44abd4c1293e7",
@@ -13,16 +13,17 @@
13
13
  "commands/governance.md": "sha256:1fd6272f18b00237fc6e602ac126ae812747937b2bb575068a0d617137eea2b0",
14
14
  "commands/ingest.md": "sha256:cf35659aecd9d0e160909003efdbe056864fc5d824c71b4ef0ee801ce07ff598",
15
15
  "commands/measurement.md": "sha256:9cade6dfec23338e18aa67ede3335ac9e2888dc577a7d4d8e3ceac948bce403f",
16
- "commands/observe-and-act.md": "sha256:02a93bbbfddc3d8e11cb921ddccd19b0666133c4bdb4f4a280bcb131bed37e8c",
16
+ "commands/media-evidence.md": "sha256:f2218feabe3360a2c9d569a5fa9b70d4b33a83a270d657151635e6f404fb34e0",
17
+ "commands/observe-and-act.md": "sha256:00b24966c537b2868e722a49fe49b79e73b60b2454ecdb13b1a34ff3475036ae",
17
18
  "commands/optimize-page.md": "sha256:35866f3d7cdeef0376ea7a7d7036085a9b9cf95bbb300ecf4bd77610ebd74d85",
18
19
  "commands/page-work.md": "sha256:965a66e59bdf7b0da482d26fade53b3d265885ece5d463fe83b0789ebefaef3e",
19
- "commands/README.md": "sha256:0d1831883c99925d3eccef7ae551f88f9789b12cf9598ab4026f50c776697a5a",
20
+ "commands/README.md": "sha256:ced929fc2ea3af9be2b87433b88a1add8d6e0938d59c5b3cd24340a7ccc6abdb",
20
21
  "commands/reviews.md": "sha256:902904aaa405fe5724cf0662c7a5a36eab9a4fe0eb81cbd95ffa2fff946e0ac8",
21
22
  "commands/validate-render.md": "sha256:a8e1d04d40b84d57c35039250d98c6a7302cd44a148a8c3b9d9cfb92678c4347",
22
23
  "policies/crawler-policy-template.md": "sha256:15c88a4eeb21f53f71e5250dd3eb2d2791a814b304eaefce8bb30e2bdf2e2e59",
23
- "references/aeo-geo-validation.md": "sha256:e45828d3ccca54a08513cb4235578c8a8ecf1dc47d1cb98e4a497838103bef70",
24
+ "references/aeo-geo-validation.md": "sha256:47a33e717994191069ce96871e62e9bd6f9db32e8121c8784793ed1a58a1f245",
24
25
  "references/anti-patterns.md": "sha256:de63f8e646af0fbf479b45eb1d050ae62a8637acc320d21b87e4a083fd4c47e7",
25
- "references/capability-boundaries.md": "sha256:5d59f15cf97529fec26a105095278dc7a17ae3b829103994ec5ddf420897f448",
26
+ "references/capability-boundaries.md": "sha256:66d6860a6893a1613d4416b2185c48308457bf006bb943817623fd1bd700d9a8",
26
27
  "references/evidence-authority.md": "sha256:b81ee09953999f16b19dc0eaba6fffe794b58d152e2adbd95c3179730bc08ffc",
27
28
  "rubrics/answer-extractability.md": "sha256:c8e741143c34e53afdb3dc7b6976ce7b4485dce13b12d14c193fccb17bacf1da",
28
29
  "rubrics/claim-boundedness.md": "sha256:0bab1b85248c252b966175912ebfae13bf18aa7e41573f7466831ac78b5d3e27",
@@ -54,9 +55,10 @@
54
55
  "schemas/experiment.schema.json": "sha256:3cebebc5745a9eb359261408b0a0421b8370d2c94f8244ce939827cd9da41cb6",
55
56
  "schemas/finding.schema.json": "sha256:85907cd04cd8d2fe24a1e618e0df7160f6d56aa1818db501f345aebce5eb5edb",
56
57
  "schemas/intervention.schema.json": "sha256:fcf28e117b207e64ffc96088aa70a95370841a2a9fa43ecb1c82b34c2058a818",
58
+ "schemas/media-manifest.schema.json": "sha256:3f37301aab9e913fa7febb15c720ed6384b106f12cef8d26cdd12d93fd85b41f",
57
59
  "schemas/metric.schema.json": "sha256:2ada648e7274a8d78cc9d6e7ed616f91faa79cf9ed07613e2c1fc53b247aac8d",
58
60
  "schemas/objective.schema.json": "sha256:94404dc95d04a6641ea7b9654317d0222793251ad44d3dfd2875738622a36025",
59
- "schemas/observation.schema.json": "sha256:bea8eb7ea74442a1be745aa40ff22d25dcd89a82fb0205dfc6c597da40831f64",
61
+ "schemas/observation.schema.json": "sha256:eebb7deb445b9de8c2ffa603fce441f9a857ce290602d8828915fb630b566693",
60
62
  "schemas/page.schema.json": "sha256:627613c35f461177fa946df08edf66fbf6f6bbdfc57eef812572b3af796d5e07",
61
63
  "schemas/project.schema.json": "sha256:ea48fdb6480f7047ba4594bd5908bc1f79c1ad6b9a2c204df900959b5f203dc6",
62
64
  "schemas/prompt-result.schema.json": "sha256:b55be47d7d58d7b1dd8c3b1e849e24e55216212c592cde7eb836953379b85737",
@@ -70,9 +72,9 @@
70
72
  "schemas/sampling-plan.schema.json": "sha256:005f70f149baaacd7de698548d556d3e401c630978748271b0e14a74726dd413",
71
73
  "schemas/schedule.schema.json": "sha256:0f02174ab0fc7bbbce9759fd358b18ed97cc683c76933fd3001cf053c499b157",
72
74
  "scripts/README.md": "sha256:1c3e952950ef353849621b07c5f615bf7cd20cc5654da4635492a7bd6384e747",
73
- "SKILL.md": "sha256:95336d8e690b54f72de14020a35d87d41fcaa1080a6242d821ff3df4efdf0ab6",
75
+ "SKILL.md": "sha256:b5607872edd36746674f596db543f02004d30c98d4c15b745bfdc42afa77be8d",
74
76
  "templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
75
- "VERSION": "sha256:4f5ba6a3e380bf810cc968b58d30a8d7163eafe9e2fb1ad19bdc6d9d64a1e549"
77
+ "VERSION": "sha256:c92df6bdde330be219d62f48ec6490b01889436f2f59027aab200e74de619168"
76
78
  },
77
- "treeHash": "sha256:81a5e1f3bf7560060b3f950c18804d5481b1230ab9e0b81d3ce16d0b97e43893"
79
+ "treeHash": "sha256:bf020f14e20b04db5037c18aa9bcbfa6ac5e39522681be610676de380ab7eeec"
78
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 |
@@ -0,0 +1,2 @@
1
+ {
2
+ "$id":"citable://schemas/media-manifest.schema.json","$schema":"http://json-schema.org/draft-07/schema#","title":"Media evidence import manifest","type":"object","additionalProperties":false,"required":["version","items"],"properties":{"version":{"const":1},"items":{"type":"array","minItems":1,"items":{"type":"object","additionalProperties":false,"required":["media_id","type","path","source_url","page_url","claim_ids","permission_status"],"properties":{"media_id":{"type":"string","pattern":"^MEDIA-[A-Z0-9][A-Z0-9_-]*$"},"type":{"type":"string","enum":["pdf","transcript","image"]},"path":{"type":"string","minLength":1},"source_url":{"type":["string","null"]},"page_url":{"type":["string","null"]},"claim_ids":{"type":"array","uniqueItems":true,"items":{"type":"string"}},"permission_status":{"type":"string","enum":["owner_authorized","licensed","public_unknown","internal"]},"image_src":{"type":"string"},"language":{"type":"string"},"published_at":{"type":"string","format":"date-time"}}}}}}
@@ -7,7 +7,7 @@
7
7
  "required": ["observation_id", "kind", "state", "collected_at", "collection_method", "confidence", "source", "evidence_hash", "data"],
8
8
  "properties": {
9
9
  "observation_id": { "type": "string", "minLength": 1 },
10
- "kind": { "type": "string", "enum": ["render", "index", "citation", "citation_review", "crawler_log", "bing_webmaster", "passage", "canonical_freshness", "performance", "corroboration", "metric"] },
10
+ "kind": { "type": "string", "enum": ["render", "index", "citation", "citation_review", "crawler_log", "bing_webmaster", "passage", "canonical_freshness", "performance", "corroboration", "metric", "media_pdf", "media_transcript", "media_image"] },
11
11
  "state": { "type": "string", "enum": ["observed", "not_observed", "not_evidenced", "incomplete", "review_required", "failed"] },
12
12
  "collected_at": { "type": "string", "format": "date-time" },
13
13
  "collection_method": { "type": "string", "enum": ["live_api", "browser", "owner_import", "synthetic_fetch", "static_analysis", "human_review"] },
@@ -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.10.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>
@@ -117,6 +119,7 @@ citable reviews sample <sampling-plan-id> [--write]
117
119
  citable reviews evaluate
118
120
  citable schedules run <schedule-id> [--ref-date YYYY-MM-DD]
119
121
  citable project github <run-id>
122
+ citable observe media --input <manifest.json> [--ocr]
120
123
  ```
121
124
 
122
125
  Audit scopes: `technical seo aeo geo architecture entity claims evidence schema
@@ -1 +1 @@
1
- 1.10.0
1
+ 1.12.0
@@ -30,10 +30,11 @@ intent, not executability, so statuses are strict:
30
30
  | /citable governance validate / evaluate | implemented — validates reviewer and exception authority and emits immutable dispositions without changing failed findings |
31
31
  | /citable reviews queue / prioritize / plan / sample / evaluate | implemented — materiality queues, reproducible sampling, stale-decision checks, and independent disagreement adjudication |
32
32
  | /citable schedules run / project github | implemented — canonical scheduled audits and hash-bound non-authoritative GitHub projections |
33
+ | /citable observe media | implemented — bounded PDF, transcript, image-context, optional OCR, and declared claim-link evidence |
33
34
  | /citable ingest, map-site, map-queries, map-prompts, map-entities, map-evidence | specified (ingest.md) |
34
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 |
35
36
  | /citable create-page, answer-block, architect, interlink, consolidate, metadata | specified (page-work.md) |
36
- | /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 |
37
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 |
38
39
 
39
40
  Shared refusal conditions (all commands): any action that would fabricate
@@ -0,0 +1,17 @@
1
+ # Media evidence collection
2
+
3
+ Use `citable observe media --input <manifest.json>` for bounded local-media
4
+ evidence. The manifest declares source URL, owning page, permission status, and
5
+ linked claim IDs for each PDF, transcript, or image-context source.
6
+
7
+ PDF collection extracts native text, basic metadata, and stable page anchors.
8
+ It does not establish reading order, table structure, footnote linkage,
9
+ signatures, revisions, scan accuracy, accessibility, or claim support.
10
+ Transcript collection preserves cues but does not verify speakers, timing,
11
+ accuracy, or source-media parity. Image collection records alt text, captions,
12
+ and nearby figure text without inferring visual entailment.
13
+
14
+ OCR is off by default. `--ocr` explicitly requests the optional `tesseract.js`
15
+ path; an unavailable engine or image produces incomplete evidence, never guessed
16
+ text. Every media-to-claim relationship is declarative and still requires
17
+ human-authoritative semantic review.
@@ -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.10.0",
3
+ "version": "1.12.0",
4
4
  "managedBy": "citable-cli",
5
5
  "provider": "qoder",
6
6
  "providerName": "Qoder",
7
7
  "scope": "bundle",
8
- "sourcePackage": "@nebulacomponents/citable@1.10.0",
8
+ "sourcePackage": "@nebulacomponents/citable@1.12.0",
9
9
  "variantPath": ".qoder/skills/citable",
10
10
  "files": {
11
11
  "commands/action-findings.md": "sha256:510361461f24fcd4a550e0a8d960c383aefe23f9a65a54a3ffc44abd4c1293e7",
@@ -13,16 +13,17 @@
13
13
  "commands/governance.md": "sha256:1fd6272f18b00237fc6e602ac126ae812747937b2bb575068a0d617137eea2b0",
14
14
  "commands/ingest.md": "sha256:cf35659aecd9d0e160909003efdbe056864fc5d824c71b4ef0ee801ce07ff598",
15
15
  "commands/measurement.md": "sha256:9cade6dfec23338e18aa67ede3335ac9e2888dc577a7d4d8e3ceac948bce403f",
16
- "commands/observe-and-act.md": "sha256:02a93bbbfddc3d8e11cb921ddccd19b0666133c4bdb4f4a280bcb131bed37e8c",
16
+ "commands/media-evidence.md": "sha256:f2218feabe3360a2c9d569a5fa9b70d4b33a83a270d657151635e6f404fb34e0",
17
+ "commands/observe-and-act.md": "sha256:00b24966c537b2868e722a49fe49b79e73b60b2454ecdb13b1a34ff3475036ae",
17
18
  "commands/optimize-page.md": "sha256:35866f3d7cdeef0376ea7a7d7036085a9b9cf95bbb300ecf4bd77610ebd74d85",
18
19
  "commands/page-work.md": "sha256:965a66e59bdf7b0da482d26fade53b3d265885ece5d463fe83b0789ebefaef3e",
19
- "commands/README.md": "sha256:0d1831883c99925d3eccef7ae551f88f9789b12cf9598ab4026f50c776697a5a",
20
+ "commands/README.md": "sha256:ced929fc2ea3af9be2b87433b88a1add8d6e0938d59c5b3cd24340a7ccc6abdb",
20
21
  "commands/reviews.md": "sha256:902904aaa405fe5724cf0662c7a5a36eab9a4fe0eb81cbd95ffa2fff946e0ac8",
21
22
  "commands/validate-render.md": "sha256:a8e1d04d40b84d57c35039250d98c6a7302cd44a148a8c3b9d9cfb92678c4347",
22
23
  "policies/crawler-policy-template.md": "sha256:15c88a4eeb21f53f71e5250dd3eb2d2791a814b304eaefce8bb30e2bdf2e2e59",
23
- "references/aeo-geo-validation.md": "sha256:e45828d3ccca54a08513cb4235578c8a8ecf1dc47d1cb98e4a497838103bef70",
24
+ "references/aeo-geo-validation.md": "sha256:47a33e717994191069ce96871e62e9bd6f9db32e8121c8784793ed1a58a1f245",
24
25
  "references/anti-patterns.md": "sha256:de63f8e646af0fbf479b45eb1d050ae62a8637acc320d21b87e4a083fd4c47e7",
25
- "references/capability-boundaries.md": "sha256:5d59f15cf97529fec26a105095278dc7a17ae3b829103994ec5ddf420897f448",
26
+ "references/capability-boundaries.md": "sha256:66d6860a6893a1613d4416b2185c48308457bf006bb943817623fd1bd700d9a8",
26
27
  "references/evidence-authority.md": "sha256:b81ee09953999f16b19dc0eaba6fffe794b58d152e2adbd95c3179730bc08ffc",
27
28
  "rubrics/answer-extractability.md": "sha256:c8e741143c34e53afdb3dc7b6976ce7b4485dce13b12d14c193fccb17bacf1da",
28
29
  "rubrics/claim-boundedness.md": "sha256:0bab1b85248c252b966175912ebfae13bf18aa7e41573f7466831ac78b5d3e27",
@@ -54,9 +55,10 @@
54
55
  "schemas/experiment.schema.json": "sha256:3cebebc5745a9eb359261408b0a0421b8370d2c94f8244ce939827cd9da41cb6",
55
56
  "schemas/finding.schema.json": "sha256:85907cd04cd8d2fe24a1e618e0df7160f6d56aa1818db501f345aebce5eb5edb",
56
57
  "schemas/intervention.schema.json": "sha256:fcf28e117b207e64ffc96088aa70a95370841a2a9fa43ecb1c82b34c2058a818",
58
+ "schemas/media-manifest.schema.json": "sha256:3f37301aab9e913fa7febb15c720ed6384b106f12cef8d26cdd12d93fd85b41f",
57
59
  "schemas/metric.schema.json": "sha256:2ada648e7274a8d78cc9d6e7ed616f91faa79cf9ed07613e2c1fc53b247aac8d",
58
60
  "schemas/objective.schema.json": "sha256:94404dc95d04a6641ea7b9654317d0222793251ad44d3dfd2875738622a36025",
59
- "schemas/observation.schema.json": "sha256:bea8eb7ea74442a1be745aa40ff22d25dcd89a82fb0205dfc6c597da40831f64",
61
+ "schemas/observation.schema.json": "sha256:eebb7deb445b9de8c2ffa603fce441f9a857ce290602d8828915fb630b566693",
60
62
  "schemas/page.schema.json": "sha256:627613c35f461177fa946df08edf66fbf6f6bbdfc57eef812572b3af796d5e07",
61
63
  "schemas/project.schema.json": "sha256:ea48fdb6480f7047ba4594bd5908bc1f79c1ad6b9a2c204df900959b5f203dc6",
62
64
  "schemas/prompt-result.schema.json": "sha256:b55be47d7d58d7b1dd8c3b1e849e24e55216212c592cde7eb836953379b85737",
@@ -70,9 +72,9 @@
70
72
  "schemas/sampling-plan.schema.json": "sha256:005f70f149baaacd7de698548d556d3e401c630978748271b0e14a74726dd413",
71
73
  "schemas/schedule.schema.json": "sha256:0f02174ab0fc7bbbce9759fd358b18ed97cc683c76933fd3001cf053c499b157",
72
74
  "scripts/README.md": "sha256:1c3e952950ef353849621b07c5f615bf7cd20cc5654da4635492a7bd6384e747",
73
- "SKILL.md": "sha256:95336d8e690b54f72de14020a35d87d41fcaa1080a6242d821ff3df4efdf0ab6",
75
+ "SKILL.md": "sha256:b5607872edd36746674f596db543f02004d30c98d4c15b745bfdc42afa77be8d",
74
76
  "templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
75
- "VERSION": "sha256:4f5ba6a3e380bf810cc968b58d30a8d7163eafe9e2fb1ad19bdc6d9d64a1e549"
77
+ "VERSION": "sha256:c92df6bdde330be219d62f48ec6490b01889436f2f59027aab200e74de619168"
76
78
  },
77
- "treeHash": "sha256:81a5e1f3bf7560060b3f950c18804d5481b1230ab9e0b81d3ce16d0b97e43893"
79
+ "treeHash": "sha256:bf020f14e20b04db5037c18aa9bcbfa6ac5e39522681be610676de380ab7eeec"
78
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 |