@nebulacomponents/citable 1.10.0 → 1.11.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 +3 -0
- package/dist/universal/.agents/skills/citable/SKILL.md +2 -1
- package/dist/universal/.agents/skills/citable/VERSION +1 -1
- package/dist/universal/.agents/skills/citable/commands/README.md +1 -0
- package/dist/universal/.agents/skills/citable/commands/media-evidence.md +17 -0
- package/dist/universal/.agents/skills/citable/manifest.json +9 -7
- package/dist/universal/.agents/skills/citable/schemas/media-manifest.schema.json +2 -0
- package/dist/universal/.agents/skills/citable/schemas/observation.schema.json +1 -1
- package/dist/universal/.claude/skills/citable/SKILL.md +2 -1
- package/dist/universal/.claude/skills/citable/VERSION +1 -1
- package/dist/universal/.claude/skills/citable/commands/README.md +1 -0
- package/dist/universal/.claude/skills/citable/commands/media-evidence.md +17 -0
- package/dist/universal/.claude/skills/citable/manifest.json +9 -7
- package/dist/universal/.claude/skills/citable/schemas/media-manifest.schema.json +2 -0
- package/dist/universal/.claude/skills/citable/schemas/observation.schema.json +1 -1
- package/dist/universal/.cursor/skills/citable/SKILL.md +2 -1
- package/dist/universal/.cursor/skills/citable/VERSION +1 -1
- package/dist/universal/.cursor/skills/citable/commands/README.md +1 -0
- package/dist/universal/.cursor/skills/citable/commands/media-evidence.md +17 -0
- package/dist/universal/.cursor/skills/citable/manifest.json +9 -7
- package/dist/universal/.cursor/skills/citable/schemas/media-manifest.schema.json +2 -0
- package/dist/universal/.cursor/skills/citable/schemas/observation.schema.json +1 -1
- package/dist/universal/.gemini/skills/citable/SKILL.md +2 -1
- package/dist/universal/.gemini/skills/citable/VERSION +1 -1
- package/dist/universal/.gemini/skills/citable/commands/README.md +1 -0
- package/dist/universal/.gemini/skills/citable/commands/media-evidence.md +17 -0
- package/dist/universal/.gemini/skills/citable/manifest.json +9 -7
- package/dist/universal/.gemini/skills/citable/schemas/media-manifest.schema.json +2 -0
- package/dist/universal/.gemini/skills/citable/schemas/observation.schema.json +1 -1
- package/dist/universal/.github/skills/citable/SKILL.md +2 -1
- package/dist/universal/.github/skills/citable/VERSION +1 -1
- package/dist/universal/.github/skills/citable/commands/README.md +1 -0
- package/dist/universal/.github/skills/citable/commands/media-evidence.md +17 -0
- package/dist/universal/.github/skills/citable/manifest.json +9 -7
- package/dist/universal/.github/skills/citable/schemas/media-manifest.schema.json +2 -0
- package/dist/universal/.github/skills/citable/schemas/observation.schema.json +1 -1
- package/dist/universal/.kiro/skills/citable/SKILL.md +2 -1
- package/dist/universal/.kiro/skills/citable/VERSION +1 -1
- package/dist/universal/.kiro/skills/citable/commands/README.md +1 -0
- package/dist/universal/.kiro/skills/citable/commands/media-evidence.md +17 -0
- package/dist/universal/.kiro/skills/citable/manifest.json +9 -7
- package/dist/universal/.kiro/skills/citable/schemas/media-manifest.schema.json +2 -0
- package/dist/universal/.kiro/skills/citable/schemas/observation.schema.json +1 -1
- package/dist/universal/.opencode/skills/citable/SKILL.md +2 -1
- package/dist/universal/.opencode/skills/citable/VERSION +1 -1
- package/dist/universal/.opencode/skills/citable/commands/README.md +1 -0
- package/dist/universal/.opencode/skills/citable/commands/media-evidence.md +17 -0
- package/dist/universal/.opencode/skills/citable/manifest.json +9 -7
- package/dist/universal/.opencode/skills/citable/schemas/media-manifest.schema.json +2 -0
- package/dist/universal/.opencode/skills/citable/schemas/observation.schema.json +1 -1
- package/dist/universal/.pi/agent/skills/citable/SKILL.md +2 -1
- package/dist/universal/.pi/agent/skills/citable/VERSION +1 -1
- package/dist/universal/.pi/agent/skills/citable/commands/README.md +1 -0
- package/dist/universal/.pi/agent/skills/citable/commands/media-evidence.md +17 -0
- package/dist/universal/.pi/agent/skills/citable/manifest.json +9 -7
- package/dist/universal/.pi/agent/skills/citable/schemas/media-manifest.schema.json +2 -0
- package/dist/universal/.pi/agent/skills/citable/schemas/observation.schema.json +1 -1
- package/dist/universal/.qoder/skills/citable/SKILL.md +2 -1
- package/dist/universal/.qoder/skills/citable/VERSION +1 -1
- package/dist/universal/.qoder/skills/citable/commands/README.md +1 -0
- package/dist/universal/.qoder/skills/citable/commands/media-evidence.md +17 -0
- package/dist/universal/.qoder/skills/citable/manifest.json +9 -7
- package/dist/universal/.qoder/skills/citable/schemas/media-manifest.schema.json +2 -0
- package/dist/universal/.qoder/skills/citable/schemas/observation.schema.json +1 -1
- package/dist/universal/.rovodev/skills/citable/SKILL.md +2 -1
- package/dist/universal/.rovodev/skills/citable/VERSION +1 -1
- package/dist/universal/.rovodev/skills/citable/commands/README.md +1 -0
- package/dist/universal/.rovodev/skills/citable/commands/media-evidence.md +17 -0
- package/dist/universal/.rovodev/skills/citable/manifest.json +9 -7
- package/dist/universal/.rovodev/skills/citable/schemas/media-manifest.schema.json +2 -0
- package/dist/universal/.rovodev/skills/citable/schemas/observation.schema.json +1 -1
- package/dist/universal/.trae/skills/citable/SKILL.md +2 -1
- package/dist/universal/.trae/skills/citable/VERSION +1 -1
- package/dist/universal/.trae/skills/citable/commands/README.md +1 -0
- package/dist/universal/.trae/skills/citable/commands/media-evidence.md +17 -0
- package/dist/universal/.trae/skills/citable/manifest.json +9 -7
- package/dist/universal/.trae/skills/citable/schemas/media-manifest.schema.json +2 -0
- package/dist/universal/.trae/skills/citable/schemas/observation.schema.json +1 -1
- package/dist/universal/.trae-cn/skills/citable/SKILL.md +2 -1
- package/dist/universal/.trae-cn/skills/citable/VERSION +1 -1
- package/dist/universal/.trae-cn/skills/citable/commands/README.md +1 -0
- package/dist/universal/.trae-cn/skills/citable/commands/media-evidence.md +17 -0
- package/dist/universal/.trae-cn/skills/citable/manifest.json +9 -7
- package/dist/universal/.trae-cn/skills/citable/schemas/media-manifest.schema.json +2 -0
- package/dist/universal/.trae-cn/skills/citable/schemas/observation.schema.json +1 -1
- package/dist/universal/manifest.json +111 -87
- package/package.json +8 -3
- package/schemas/media-manifest.schema.json +2 -0
- package/schemas/observation.schema.json +1 -1
- package/skill/SKILL.md +2 -1
- package/skill/commands/README.md +1 -0
- package/skill/commands/media-evidence.md +17 -0
- package/src/cli/index.js +3 -1
- package/src/commands/observe.js +3 -1
- package/src/observations/media.js +75 -0
|
@@ -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.
|
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "citable",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.11.0",
|
|
4
4
|
"managedBy": "citable-cli",
|
|
5
5
|
"provider": "rovodev",
|
|
6
6
|
"providerName": "Rovo Dev",
|
|
7
7
|
"scope": "bundle",
|
|
8
|
-
"sourcePackage": "@nebulacomponents/citable@1.
|
|
8
|
+
"sourcePackage": "@nebulacomponents/citable@1.11.0",
|
|
9
9
|
"variantPath": ".rovodev/skills/citable",
|
|
10
10
|
"files": {
|
|
11
11
|
"commands/action-findings.md": "sha256:510361461f24fcd4a550e0a8d960c383aefe23f9a65a54a3ffc44abd4c1293e7",
|
|
@@ -13,10 +13,11 @@
|
|
|
13
13
|
"commands/governance.md": "sha256:1fd6272f18b00237fc6e602ac126ae812747937b2bb575068a0d617137eea2b0",
|
|
14
14
|
"commands/ingest.md": "sha256:cf35659aecd9d0e160909003efdbe056864fc5d824c71b4ef0ee801ce07ff598",
|
|
15
15
|
"commands/measurement.md": "sha256:9cade6dfec23338e18aa67ede3335ac9e2888dc577a7d4d8e3ceac948bce403f",
|
|
16
|
+
"commands/media-evidence.md": "sha256:f2218feabe3360a2c9d569a5fa9b70d4b33a83a270d657151635e6f404fb34e0",
|
|
16
17
|
"commands/observe-and-act.md": "sha256:02a93bbbfddc3d8e11cb921ddccd19b0666133c4bdb4f4a280bcb131bed37e8c",
|
|
17
18
|
"commands/optimize-page.md": "sha256:35866f3d7cdeef0376ea7a7d7036085a9b9cf95bbb300ecf4bd77610ebd74d85",
|
|
18
19
|
"commands/page-work.md": "sha256:965a66e59bdf7b0da482d26fade53b3d265885ece5d463fe83b0789ebefaef3e",
|
|
19
|
-
"commands/README.md": "sha256:
|
|
20
|
+
"commands/README.md": "sha256:36a0462ce9867dd46922185060341110f9c4b71582b96ec3f90ff1ff341f59ea",
|
|
20
21
|
"commands/reviews.md": "sha256:902904aaa405fe5724cf0662c7a5a36eab9a4fe0eb81cbd95ffa2fff946e0ac8",
|
|
21
22
|
"commands/validate-render.md": "sha256:a8e1d04d40b84d57c35039250d98c6a7302cd44a148a8c3b9d9cfb92678c4347",
|
|
22
23
|
"policies/crawler-policy-template.md": "sha256:15c88a4eeb21f53f71e5250dd3eb2d2791a814b304eaefce8bb30e2bdf2e2e59",
|
|
@@ -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:
|
|
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:
|
|
75
|
+
"SKILL.md": "sha256:d07fdc4d4cbc11b5c530bd97bf3e4d13d9c212cc3c67cf9798042f776f68609c",
|
|
74
76
|
"templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
|
|
75
|
-
"VERSION": "sha256:
|
|
77
|
+
"VERSION": "sha256:74ee4d121463989183f9a9b848577eb2434f3f5d095de2a4b197bf29ffa2399b"
|
|
76
78
|
},
|
|
77
|
-
"treeHash": "sha256:
|
|
79
|
+
"treeHash": "sha256:26c75b5cf68676c665ecf6a1e8d4ec5c6e77abdef8825c1c3ad8a099147168b8"
|
|
78
80
|
}
|
|
@@ -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
|
+
version: 1.11.0
|
|
11
11
|
---
|
|
12
12
|
|
|
13
13
|
# Citable — evidence and change control for search and AI citation readiness
|
|
@@ -117,6 +117,7 @@ citable reviews sample <sampling-plan-id> [--write]
|
|
|
117
117
|
citable reviews evaluate
|
|
118
118
|
citable schedules run <schedule-id> [--ref-date YYYY-MM-DD]
|
|
119
119
|
citable project github <run-id>
|
|
120
|
+
citable observe media --input <manifest.json> [--ocr]
|
|
120
121
|
```
|
|
121
122
|
|
|
122
123
|
Audit scopes: `technical seo aeo geo architecture entity claims evidence schema
|
|
@@ -1 +1 @@
|
|
|
1
|
-
1.
|
|
1
|
+
1.11.0
|
|
@@ -30,6 +30,7 @@ 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) |
|
|
@@ -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.
|
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "citable",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.11.0",
|
|
4
4
|
"managedBy": "citable-cli",
|
|
5
5
|
"provider": "trae",
|
|
6
6
|
"providerName": "Trae",
|
|
7
7
|
"scope": "bundle",
|
|
8
|
-
"sourcePackage": "@nebulacomponents/citable@1.
|
|
8
|
+
"sourcePackage": "@nebulacomponents/citable@1.11.0",
|
|
9
9
|
"variantPath": ".trae/skills/citable",
|
|
10
10
|
"files": {
|
|
11
11
|
"commands/action-findings.md": "sha256:510361461f24fcd4a550e0a8d960c383aefe23f9a65a54a3ffc44abd4c1293e7",
|
|
@@ -13,10 +13,11 @@
|
|
|
13
13
|
"commands/governance.md": "sha256:1fd6272f18b00237fc6e602ac126ae812747937b2bb575068a0d617137eea2b0",
|
|
14
14
|
"commands/ingest.md": "sha256:cf35659aecd9d0e160909003efdbe056864fc5d824c71b4ef0ee801ce07ff598",
|
|
15
15
|
"commands/measurement.md": "sha256:9cade6dfec23338e18aa67ede3335ac9e2888dc577a7d4d8e3ceac948bce403f",
|
|
16
|
+
"commands/media-evidence.md": "sha256:f2218feabe3360a2c9d569a5fa9b70d4b33a83a270d657151635e6f404fb34e0",
|
|
16
17
|
"commands/observe-and-act.md": "sha256:02a93bbbfddc3d8e11cb921ddccd19b0666133c4bdb4f4a280bcb131bed37e8c",
|
|
17
18
|
"commands/optimize-page.md": "sha256:35866f3d7cdeef0376ea7a7d7036085a9b9cf95bbb300ecf4bd77610ebd74d85",
|
|
18
19
|
"commands/page-work.md": "sha256:965a66e59bdf7b0da482d26fade53b3d265885ece5d463fe83b0789ebefaef3e",
|
|
19
|
-
"commands/README.md": "sha256:
|
|
20
|
+
"commands/README.md": "sha256:36a0462ce9867dd46922185060341110f9c4b71582b96ec3f90ff1ff341f59ea",
|
|
20
21
|
"commands/reviews.md": "sha256:902904aaa405fe5724cf0662c7a5a36eab9a4fe0eb81cbd95ffa2fff946e0ac8",
|
|
21
22
|
"commands/validate-render.md": "sha256:a8e1d04d40b84d57c35039250d98c6a7302cd44a148a8c3b9d9cfb92678c4347",
|
|
22
23
|
"policies/crawler-policy-template.md": "sha256:15c88a4eeb21f53f71e5250dd3eb2d2791a814b304eaefce8bb30e2bdf2e2e59",
|
|
@@ -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:
|
|
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:
|
|
75
|
+
"SKILL.md": "sha256:d07fdc4d4cbc11b5c530bd97bf3e4d13d9c212cc3c67cf9798042f776f68609c",
|
|
74
76
|
"templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
|
|
75
|
-
"VERSION": "sha256:
|
|
77
|
+
"VERSION": "sha256:74ee4d121463989183f9a9b848577eb2434f3f5d095de2a4b197bf29ffa2399b"
|
|
76
78
|
},
|
|
77
|
-
"treeHash": "sha256:
|
|
79
|
+
"treeHash": "sha256:26c75b5cf68676c665ecf6a1e8d4ec5c6e77abdef8825c1c3ad8a099147168b8"
|
|
78
80
|
}
|
|
@@ -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
|
+
version: 1.11.0
|
|
11
11
|
---
|
|
12
12
|
|
|
13
13
|
# Citable — evidence and change control for search and AI citation readiness
|
|
@@ -117,6 +117,7 @@ citable reviews sample <sampling-plan-id> [--write]
|
|
|
117
117
|
citable reviews evaluate
|
|
118
118
|
citable schedules run <schedule-id> [--ref-date YYYY-MM-DD]
|
|
119
119
|
citable project github <run-id>
|
|
120
|
+
citable observe media --input <manifest.json> [--ocr]
|
|
120
121
|
```
|
|
121
122
|
|
|
122
123
|
Audit scopes: `technical seo aeo geo architecture entity claims evidence schema
|
|
@@ -1 +1 @@
|
|
|
1
|
-
1.
|
|
1
|
+
1.11.0
|
|
@@ -30,6 +30,7 @@ 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) |
|
|
@@ -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.
|
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "citable",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.11.0",
|
|
4
4
|
"managedBy": "citable-cli",
|
|
5
5
|
"provider": "trae-cn",
|
|
6
6
|
"providerName": "Trae CN",
|
|
7
7
|
"scope": "bundle",
|
|
8
|
-
"sourcePackage": "@nebulacomponents/citable@1.
|
|
8
|
+
"sourcePackage": "@nebulacomponents/citable@1.11.0",
|
|
9
9
|
"variantPath": ".trae-cn/skills/citable",
|
|
10
10
|
"files": {
|
|
11
11
|
"commands/action-findings.md": "sha256:510361461f24fcd4a550e0a8d960c383aefe23f9a65a54a3ffc44abd4c1293e7",
|
|
@@ -13,10 +13,11 @@
|
|
|
13
13
|
"commands/governance.md": "sha256:1fd6272f18b00237fc6e602ac126ae812747937b2bb575068a0d617137eea2b0",
|
|
14
14
|
"commands/ingest.md": "sha256:cf35659aecd9d0e160909003efdbe056864fc5d824c71b4ef0ee801ce07ff598",
|
|
15
15
|
"commands/measurement.md": "sha256:9cade6dfec23338e18aa67ede3335ac9e2888dc577a7d4d8e3ceac948bce403f",
|
|
16
|
+
"commands/media-evidence.md": "sha256:f2218feabe3360a2c9d569a5fa9b70d4b33a83a270d657151635e6f404fb34e0",
|
|
16
17
|
"commands/observe-and-act.md": "sha256:02a93bbbfddc3d8e11cb921ddccd19b0666133c4bdb4f4a280bcb131bed37e8c",
|
|
17
18
|
"commands/optimize-page.md": "sha256:35866f3d7cdeef0376ea7a7d7036085a9b9cf95bbb300ecf4bd77610ebd74d85",
|
|
18
19
|
"commands/page-work.md": "sha256:965a66e59bdf7b0da482d26fade53b3d265885ece5d463fe83b0789ebefaef3e",
|
|
19
|
-
"commands/README.md": "sha256:
|
|
20
|
+
"commands/README.md": "sha256:36a0462ce9867dd46922185060341110f9c4b71582b96ec3f90ff1ff341f59ea",
|
|
20
21
|
"commands/reviews.md": "sha256:902904aaa405fe5724cf0662c7a5a36eab9a4fe0eb81cbd95ffa2fff946e0ac8",
|
|
21
22
|
"commands/validate-render.md": "sha256:a8e1d04d40b84d57c35039250d98c6a7302cd44a148a8c3b9d9cfb92678c4347",
|
|
22
23
|
"policies/crawler-policy-template.md": "sha256:15c88a4eeb21f53f71e5250dd3eb2d2791a814b304eaefce8bb30e2bdf2e2e59",
|
|
@@ -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:
|
|
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:
|
|
75
|
+
"SKILL.md": "sha256:d07fdc4d4cbc11b5c530bd97bf3e4d13d9c212cc3c67cf9798042f776f68609c",
|
|
74
76
|
"templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
|
|
75
|
-
"VERSION": "sha256:
|
|
77
|
+
"VERSION": "sha256:74ee4d121463989183f9a9b848577eb2434f3f5d095de2a4b197bf29ffa2399b"
|
|
76
78
|
},
|
|
77
|
-
"treeHash": "sha256:
|
|
79
|
+
"treeHash": "sha256:26c75b5cf68676c665ecf6a1e8d4ec5c6e77abdef8825c1c3ad8a099147168b8"
|
|
78
80
|
}
|
|
@@ -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"] },
|