@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.
- package/CHANGELOG.md +11 -0
- package/README.md +6 -1
- package/dist/universal/.agents/skills/citable/SKILL.md +3 -1
- package/dist/universal/.agents/skills/citable/VERSION +1 -1
- package/dist/universal/.agents/skills/citable/commands/README.md +1 -1
- package/dist/universal/.agents/skills/citable/commands/observe-and-act.md +8 -1
- package/dist/universal/.agents/skills/citable/manifest.json +9 -9
- package/dist/universal/.agents/skills/citable/references/aeo-geo-validation.md +1 -1
- package/dist/universal/.agents/skills/citable/references/capability-boundaries.md +2 -0
- package/dist/universal/.claude/skills/citable/SKILL.md +3 -1
- package/dist/universal/.claude/skills/citable/VERSION +1 -1
- package/dist/universal/.claude/skills/citable/commands/README.md +1 -1
- package/dist/universal/.claude/skills/citable/commands/observe-and-act.md +8 -1
- package/dist/universal/.claude/skills/citable/manifest.json +9 -9
- package/dist/universal/.claude/skills/citable/references/aeo-geo-validation.md +1 -1
- package/dist/universal/.claude/skills/citable/references/capability-boundaries.md +2 -0
- package/dist/universal/.cursor/skills/citable/SKILL.md +3 -1
- package/dist/universal/.cursor/skills/citable/VERSION +1 -1
- package/dist/universal/.cursor/skills/citable/commands/README.md +1 -1
- package/dist/universal/.cursor/skills/citable/commands/observe-and-act.md +8 -1
- package/dist/universal/.cursor/skills/citable/manifest.json +9 -9
- package/dist/universal/.cursor/skills/citable/references/aeo-geo-validation.md +1 -1
- package/dist/universal/.cursor/skills/citable/references/capability-boundaries.md +2 -0
- package/dist/universal/.gemini/skills/citable/SKILL.md +3 -1
- package/dist/universal/.gemini/skills/citable/VERSION +1 -1
- package/dist/universal/.gemini/skills/citable/commands/README.md +1 -1
- package/dist/universal/.gemini/skills/citable/commands/observe-and-act.md +8 -1
- package/dist/universal/.gemini/skills/citable/manifest.json +9 -9
- package/dist/universal/.gemini/skills/citable/references/aeo-geo-validation.md +1 -1
- package/dist/universal/.gemini/skills/citable/references/capability-boundaries.md +2 -0
- package/dist/universal/.github/skills/citable/SKILL.md +3 -1
- package/dist/universal/.github/skills/citable/VERSION +1 -1
- package/dist/universal/.github/skills/citable/commands/README.md +1 -1
- package/dist/universal/.github/skills/citable/commands/observe-and-act.md +8 -1
- package/dist/universal/.github/skills/citable/manifest.json +9 -9
- package/dist/universal/.github/skills/citable/references/aeo-geo-validation.md +1 -1
- package/dist/universal/.github/skills/citable/references/capability-boundaries.md +2 -0
- package/dist/universal/.kiro/skills/citable/SKILL.md +3 -1
- package/dist/universal/.kiro/skills/citable/VERSION +1 -1
- package/dist/universal/.kiro/skills/citable/commands/README.md +1 -1
- package/dist/universal/.kiro/skills/citable/commands/observe-and-act.md +8 -1
- package/dist/universal/.kiro/skills/citable/manifest.json +9 -9
- package/dist/universal/.kiro/skills/citable/references/aeo-geo-validation.md +1 -1
- package/dist/universal/.kiro/skills/citable/references/capability-boundaries.md +2 -0
- package/dist/universal/.opencode/skills/citable/SKILL.md +3 -1
- package/dist/universal/.opencode/skills/citable/VERSION +1 -1
- package/dist/universal/.opencode/skills/citable/commands/README.md +1 -1
- package/dist/universal/.opencode/skills/citable/commands/observe-and-act.md +8 -1
- package/dist/universal/.opencode/skills/citable/manifest.json +9 -9
- package/dist/universal/.opencode/skills/citable/references/aeo-geo-validation.md +1 -1
- package/dist/universal/.opencode/skills/citable/references/capability-boundaries.md +2 -0
- package/dist/universal/.pi/agent/skills/citable/SKILL.md +3 -1
- package/dist/universal/.pi/agent/skills/citable/VERSION +1 -1
- package/dist/universal/.pi/agent/skills/citable/commands/README.md +1 -1
- package/dist/universal/.pi/agent/skills/citable/commands/observe-and-act.md +8 -1
- package/dist/universal/.pi/agent/skills/citable/manifest.json +9 -9
- package/dist/universal/.pi/agent/skills/citable/references/aeo-geo-validation.md +1 -1
- package/dist/universal/.pi/agent/skills/citable/references/capability-boundaries.md +2 -0
- package/dist/universal/.qoder/skills/citable/SKILL.md +3 -1
- package/dist/universal/.qoder/skills/citable/VERSION +1 -1
- package/dist/universal/.qoder/skills/citable/commands/README.md +1 -1
- package/dist/universal/.qoder/skills/citable/commands/observe-and-act.md +8 -1
- package/dist/universal/.qoder/skills/citable/manifest.json +9 -9
- package/dist/universal/.qoder/skills/citable/references/aeo-geo-validation.md +1 -1
- package/dist/universal/.qoder/skills/citable/references/capability-boundaries.md +2 -0
- package/dist/universal/.rovodev/skills/citable/SKILL.md +3 -1
- package/dist/universal/.rovodev/skills/citable/VERSION +1 -1
- package/dist/universal/.rovodev/skills/citable/commands/README.md +1 -1
- package/dist/universal/.rovodev/skills/citable/commands/observe-and-act.md +8 -1
- package/dist/universal/.rovodev/skills/citable/manifest.json +9 -9
- package/dist/universal/.rovodev/skills/citable/references/aeo-geo-validation.md +1 -1
- package/dist/universal/.rovodev/skills/citable/references/capability-boundaries.md +2 -0
- package/dist/universal/.trae/skills/citable/SKILL.md +3 -1
- package/dist/universal/.trae/skills/citable/VERSION +1 -1
- package/dist/universal/.trae/skills/citable/commands/README.md +1 -1
- package/dist/universal/.trae/skills/citable/commands/observe-and-act.md +8 -1
- package/dist/universal/.trae/skills/citable/manifest.json +9 -9
- package/dist/universal/.trae/skills/citable/references/aeo-geo-validation.md +1 -1
- package/dist/universal/.trae/skills/citable/references/capability-boundaries.md +2 -0
- package/dist/universal/.trae-cn/skills/citable/SKILL.md +3 -1
- package/dist/universal/.trae-cn/skills/citable/VERSION +1 -1
- package/dist/universal/.trae-cn/skills/citable/commands/README.md +1 -1
- package/dist/universal/.trae-cn/skills/citable/commands/observe-and-act.md +8 -1
- package/dist/universal/.trae-cn/skills/citable/manifest.json +9 -9
- package/dist/universal/.trae-cn/skills/citable/references/aeo-geo-validation.md +1 -1
- package/dist/universal/.trae-cn/skills/citable/references/capability-boundaries.md +2 -0
- package/dist/universal/manifest.json +99 -99
- package/package.json +9 -1
- package/skill/SKILL.md +3 -1
- package/skill/commands/README.md +1 -1
- package/skill/commands/observe-and-act.md +8 -1
- package/skill/references/aeo-geo-validation.md +1 -1
- package/skill/references/capability-boundaries.md +2 -0
- package/src/cli/index.js +6 -0
- 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.
|
|
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.
|
|
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.
|
|
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/
|
|
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.
|
|
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.
|
|
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:
|
|
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:
|
|
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:
|
|
24
|
+
"references/aeo-geo-validation.md": "sha256:47a33e717994191069ce96871e62e9bd6f9db32e8121c8784793ed1a58a1f245",
|
|
25
25
|
"references/anti-patterns.md": "sha256:de63f8e646af0fbf479b45eb1d050ae62a8637acc320d21b87e4a083fd4c47e7",
|
|
26
|
-
"references/capability-boundaries.md": "sha256:
|
|
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:
|
|
75
|
+
"SKILL.md": "sha256:b5607872edd36746674f596db543f02004d30c98d4c15b745bfdc42afa77be8d",
|
|
76
76
|
"templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
|
|
77
|
-
"VERSION": "sha256:
|
|
77
|
+
"VERSION": "sha256:c92df6bdde330be219d62f48ec6490b01889436f2f59027aab200e74de619168"
|
|
78
78
|
},
|
|
79
|
-
"treeHash": "sha256:
|
|
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
|
|
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.
|
|
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.
|
|
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/
|
|
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.
|
|
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.
|
|
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:
|
|
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:
|
|
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:
|
|
24
|
+
"references/aeo-geo-validation.md": "sha256:47a33e717994191069ce96871e62e9bd6f9db32e8121c8784793ed1a58a1f245",
|
|
25
25
|
"references/anti-patterns.md": "sha256:de63f8e646af0fbf479b45eb1d050ae62a8637acc320d21b87e4a083fd4c47e7",
|
|
26
|
-
"references/capability-boundaries.md": "sha256:
|
|
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:
|
|
75
|
+
"SKILL.md": "sha256:b5607872edd36746674f596db543f02004d30c98d4c15b745bfdc42afa77be8d",
|
|
76
76
|
"templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
|
|
77
|
-
"VERSION": "sha256:
|
|
77
|
+
"VERSION": "sha256:c92df6bdde330be219d62f48ec6490b01889436f2f59027aab200e74de619168"
|
|
78
78
|
},
|
|
79
|
-
"treeHash": "sha256:
|
|
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
|
|
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.
|
|
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.
|
|
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/
|
|
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.
|
|
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.
|
|
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:
|
|
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:
|
|
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:
|
|
24
|
+
"references/aeo-geo-validation.md": "sha256:47a33e717994191069ce96871e62e9bd6f9db32e8121c8784793ed1a58a1f245",
|
|
25
25
|
"references/anti-patterns.md": "sha256:de63f8e646af0fbf479b45eb1d050ae62a8637acc320d21b87e4a083fd4c47e7",
|
|
26
|
-
"references/capability-boundaries.md": "sha256:
|
|
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:
|
|
75
|
+
"SKILL.md": "sha256:b5607872edd36746674f596db543f02004d30c98d4c15b745bfdc42afa77be8d",
|
|
76
76
|
"templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
|
|
77
|
-
"VERSION": "sha256:
|
|
77
|
+
"VERSION": "sha256:c92df6bdde330be219d62f48ec6490b01889436f2f59027aab200e74de619168"
|
|
78
78
|
},
|
|
79
|
-
"treeHash": "sha256:
|
|
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
|
|
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.
|
|
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.
|
|
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/
|
|
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.
|
|
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.
|
|
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:
|
|
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:
|
|
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:
|
|
24
|
+
"references/aeo-geo-validation.md": "sha256:47a33e717994191069ce96871e62e9bd6f9db32e8121c8784793ed1a58a1f245",
|
|
25
25
|
"references/anti-patterns.md": "sha256:de63f8e646af0fbf479b45eb1d050ae62a8637acc320d21b87e4a083fd4c47e7",
|
|
26
|
-
"references/capability-boundaries.md": "sha256:
|
|
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:
|
|
75
|
+
"SKILL.md": "sha256:b5607872edd36746674f596db543f02004d30c98d4c15b745bfdc42afa77be8d",
|
|
76
76
|
"templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
|
|
77
|
-
"VERSION": "sha256:
|
|
77
|
+
"VERSION": "sha256:c92df6bdde330be219d62f48ec6490b01889436f2f59027aab200e74de619168"
|
|
78
78
|
},
|
|
79
|
-
"treeHash": "sha256:
|
|
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
|
|
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.
|
|
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.
|
|
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/
|
|
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
|