@nebulacomponents/citable 1.9.0 → 1.10.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 +10 -0
- package/README.md +4 -2
- package/dist/universal/.agents/skills/citable/SKILL.md +5 -2
- 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/delivery.md +18 -0
- package/dist/universal/.agents/skills/citable/manifest.json +8 -6
- package/dist/universal/.agents/skills/citable/schemas/schedule.schema.json +4 -0
- package/dist/universal/.claude/skills/citable/SKILL.md +5 -2
- 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/delivery.md +18 -0
- package/dist/universal/.claude/skills/citable/manifest.json +8 -6
- package/dist/universal/.claude/skills/citable/schemas/schedule.schema.json +4 -0
- package/dist/universal/.cursor/skills/citable/SKILL.md +5 -2
- 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/delivery.md +18 -0
- package/dist/universal/.cursor/skills/citable/manifest.json +8 -6
- package/dist/universal/.cursor/skills/citable/schemas/schedule.schema.json +4 -0
- package/dist/universal/.gemini/skills/citable/SKILL.md +5 -2
- 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/delivery.md +18 -0
- package/dist/universal/.gemini/skills/citable/manifest.json +8 -6
- package/dist/universal/.gemini/skills/citable/schemas/schedule.schema.json +4 -0
- package/dist/universal/.github/skills/citable/SKILL.md +5 -2
- 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/delivery.md +18 -0
- package/dist/universal/.github/skills/citable/manifest.json +8 -6
- package/dist/universal/.github/skills/citable/schemas/schedule.schema.json +4 -0
- package/dist/universal/.kiro/skills/citable/SKILL.md +5 -2
- 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/delivery.md +18 -0
- package/dist/universal/.kiro/skills/citable/manifest.json +8 -6
- package/dist/universal/.kiro/skills/citable/schemas/schedule.schema.json +4 -0
- package/dist/universal/.opencode/skills/citable/SKILL.md +5 -2
- 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/delivery.md +18 -0
- package/dist/universal/.opencode/skills/citable/manifest.json +8 -6
- package/dist/universal/.opencode/skills/citable/schemas/schedule.schema.json +4 -0
- package/dist/universal/.pi/agent/skills/citable/SKILL.md +5 -2
- 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/delivery.md +18 -0
- package/dist/universal/.pi/agent/skills/citable/manifest.json +8 -6
- package/dist/universal/.pi/agent/skills/citable/schemas/schedule.schema.json +4 -0
- package/dist/universal/.qoder/skills/citable/SKILL.md +5 -2
- 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/delivery.md +18 -0
- package/dist/universal/.qoder/skills/citable/manifest.json +8 -6
- package/dist/universal/.qoder/skills/citable/schemas/schedule.schema.json +4 -0
- package/dist/universal/.rovodev/skills/citable/SKILL.md +5 -2
- 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/delivery.md +18 -0
- package/dist/universal/.rovodev/skills/citable/manifest.json +8 -6
- package/dist/universal/.rovodev/skills/citable/schemas/schedule.schema.json +4 -0
- package/dist/universal/.trae/skills/citable/SKILL.md +5 -2
- 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/delivery.md +18 -0
- package/dist/universal/.trae/skills/citable/manifest.json +8 -6
- package/dist/universal/.trae/skills/citable/schemas/schedule.schema.json +4 -0
- package/dist/universal/.trae-cn/skills/citable/SKILL.md +5 -2
- 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/delivery.md +18 -0
- package/dist/universal/.trae-cn/skills/citable/manifest.json +8 -6
- package/dist/universal/.trae-cn/skills/citable/schemas/schedule.schema.json +4 -0
- package/dist/universal/manifest.json +99 -75
- package/package.json +1 -1
- package/schemas/schedule.schema.json +4 -0
- package/skill/SKILL.md +5 -2
- package/skill/commands/README.md +1 -0
- package/skill/commands/delivery.md +18 -0
- package/src/cli/index.js +15 -0
- package/src/commands/compareSnapshots.js +15 -0
- package/src/commands/delivery.js +50 -0
- package/src/registries/index.js +1 -0
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,16 @@
|
|
|
2
2
|
|
|
3
3
|
## Unreleased
|
|
4
4
|
|
|
5
|
+
## 1.10.0 — 2026-07-19
|
|
6
|
+
|
|
7
|
+
### Added
|
|
8
|
+
|
|
9
|
+
- Version-pinned audit schedules that invoke the canonical audit path and keep
|
|
10
|
+
external trigger limitations explicit.
|
|
11
|
+
- Hash-bound, non-authoritative GitHub annotation projections from immutable runs.
|
|
12
|
+
- Differential comparability dimensions for resource, evidence artifact,
|
|
13
|
+
detector, configuration, observation method, tool, and external-system changes.
|
|
14
|
+
|
|
5
15
|
## 1.9.0 — 2026-07-19
|
|
6
16
|
|
|
7
17
|
### Added
|
package/README.md
CHANGED
|
@@ -19,7 +19,7 @@ generator, not a Lighthouse wrapper, not an "AI visibility score".
|
|
|
19
19
|
- **Persistent registries** (`.citable/`): queries, prompts, entities, claims,
|
|
20
20
|
evidence, pages, crawler policies, competitors, experiments, metrics,
|
|
21
21
|
objectives, interventions, optional connections, reviewers, review policies,
|
|
22
|
-
governed exceptions, semantic review items,
|
|
22
|
+
governed exceptions, semantic review items, sampling plans, and audit schedules — all
|
|
23
23
|
JSON-Schema validated with referential integrity and history-preserving saves.
|
|
24
24
|
- **123 detectors** across 18 namespaces (TECH, CRAWL, ARCH, PAGE, ANS,
|
|
25
25
|
ENTITY, CLAIM, EVD, SCHEMA, LINK, EXT, GEO, RECO, LIFE, MEAS, HREFLANG, CWV, AGENT), each with
|
|
@@ -171,6 +171,8 @@ citable reviews prioritize --write
|
|
|
171
171
|
citable reviews plan --input sampling-plan.json --write
|
|
172
172
|
citable reviews sample <sampling-plan-id> --write
|
|
173
173
|
citable reviews evaluate
|
|
174
|
+
citable schedules run <schedule-id> --ref-date 2026-07-19
|
|
175
|
+
citable project github <run-id>
|
|
174
176
|
citable substantiate # claim/evidence assessment (dry run)
|
|
175
177
|
citable validate # registry schema + referential integrity
|
|
176
178
|
```
|
|
@@ -181,7 +183,7 @@ citable validate # registry schema + referential integrity
|
|
|
181
183
|
| --- | --- |
|
|
182
184
|
| `skill/` | Canonical agent skill: SKILL.md, command contracts, rubrics, anti-patterns, policies, templates |
|
|
183
185
|
| `src/` | CLI, commands, registries, detectors, crawler/extractor, evidence, reporting |
|
|
184
|
-
| `schemas/` | JSON Schemas:
|
|
186
|
+
| `schemas/` | JSON Schemas: 19 registries plus findings, runs, observations, remediation, config, and prompt results |
|
|
185
187
|
| `tests/` | Unit + integration suites; positive/negative fixtures |
|
|
186
188
|
| `docs/` | ADR, traceability matrix, known limitations |
|
|
187
189
|
| `dist/` | Generated distribution packages (run `npm run build:dist`) |
|
|
@@ -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.10.0
|
|
11
11
|
---
|
|
12
12
|
|
|
13
13
|
# Citable — evidence and change control for search and AI citation readiness
|
|
@@ -115,6 +115,8 @@ citable reviews prioritize [--write]
|
|
|
115
115
|
citable reviews plan --input <json|yaml> [--write]
|
|
116
116
|
citable reviews sample <sampling-plan-id> [--write]
|
|
117
117
|
citable reviews evaluate
|
|
118
|
+
citable schedules run <schedule-id> [--ref-date YYYY-MM-DD]
|
|
119
|
+
citable project github <run-id>
|
|
118
120
|
```
|
|
119
121
|
|
|
120
122
|
Audit scopes: `technical seo aeo geo architecture entity claims evidence schema
|
|
@@ -174,7 +176,8 @@ mandatory.
|
|
|
174
176
|
`.citable/` holds YAML registries for queries, prompts, entities, claims,
|
|
175
177
|
evidence, pages, crawlers, competitors, experiments, metrics, objectives,
|
|
176
178
|
interventions, optional connection state, reviewers, review policies, and
|
|
177
|
-
governed exceptions, semantic review items,
|
|
179
|
+
governed exceptions, semantic review items, sampling plans, and audit schedules,
|
|
180
|
+
all schema-validated
|
|
178
181
|
(`schemas/*.schema.json`) with referential integrity checks. Rules:
|
|
179
182
|
|
|
180
183
|
- Never overwrite registry content without history — use the loader/saver in
|
|
@@ -1 +1 @@
|
|
|
1
|
-
1.
|
|
1
|
+
1.10.0
|
|
@@ -29,6 +29,7 @@ intent, not executability, so statuses are strict:
|
|
|
29
29
|
| /citable evaluate | implemented — independent baseline/evaluation comparisons with inconclusive handling |
|
|
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
|
+
| /citable schedules run / project github | implemented — canonical scheduled audits and hash-bound non-authoritative GitHub projections |
|
|
32
33
|
| /citable ingest, map-site, map-queries, map-prompts, map-entities, map-evidence | specified (ingest.md) |
|
|
33
34
|
| /citable optimize-page | specified (optimize-page.md) — requires source-to-render mapping, claim-preserving rewrites, build execution, rollback; none of that is proven yet |
|
|
34
35
|
| /citable create-page, answer-block, architect, interlink, consolidate, metadata | specified (page-work.md) |
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# Scheduling, projections, and differential delivery
|
|
2
|
+
|
|
3
|
+
`citable schedules run <schedule-id>` executes the same canonical audit function
|
|
4
|
+
used by direct CLI calls. Schedules are version-pinned and fail closed when
|
|
5
|
+
paused, missing, invalid, or bound to another Citable version. The external
|
|
6
|
+
cron service remains responsible for triggering the command; a declared cron
|
|
7
|
+
does not prove execution. Schedule metadata is stored outside the finalized
|
|
8
|
+
audit package and binds back to its manifest checksum.
|
|
9
|
+
|
|
10
|
+
`citable project github <run-id>` creates GitHub annotation JSON as a
|
|
11
|
+
non-authoritative projection. It records hashes of the source manifest and
|
|
12
|
+
findings and never edits the run. Dashboards and check annotations must link to
|
|
13
|
+
these artifacts rather than maintain separate finding state.
|
|
14
|
+
|
|
15
|
+
`compare-snapshots` reports observed comparability dimensions: resource input,
|
|
16
|
+
evidence artifact, detector set, configuration, observation method, tool
|
|
17
|
+
version, and possible external-system change. These dimensions identify why
|
|
18
|
+
runs may not be directly comparable; they do not establish causal attribution.
|
|
@@ -1,21 +1,22 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "citable",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.10.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.10.0",
|
|
9
9
|
"variantPath": ".agents/skills/citable",
|
|
10
10
|
"files": {
|
|
11
11
|
"commands/action-findings.md": "sha256:510361461f24fcd4a550e0a8d960c383aefe23f9a65a54a3ffc44abd4c1293e7",
|
|
12
|
+
"commands/delivery.md": "sha256:3b29250f9e9f84442812e320a70d5d2784b4286e91af3866f99cb6062a85a10f",
|
|
12
13
|
"commands/governance.md": "sha256:1fd6272f18b00237fc6e602ac126ae812747937b2bb575068a0d617137eea2b0",
|
|
13
14
|
"commands/ingest.md": "sha256:cf35659aecd9d0e160909003efdbe056864fc5d824c71b4ef0ee801ce07ff598",
|
|
14
15
|
"commands/measurement.md": "sha256:9cade6dfec23338e18aa67ede3335ac9e2888dc577a7d4d8e3ceac948bce403f",
|
|
15
16
|
"commands/observe-and-act.md": "sha256:02a93bbbfddc3d8e11cb921ddccd19b0666133c4bdb4f4a280bcb131bed37e8c",
|
|
16
17
|
"commands/optimize-page.md": "sha256:35866f3d7cdeef0376ea7a7d7036085a9b9cf95bbb300ecf4bd77610ebd74d85",
|
|
17
18
|
"commands/page-work.md": "sha256:965a66e59bdf7b0da482d26fade53b3d265885ece5d463fe83b0789ebefaef3e",
|
|
18
|
-
"commands/README.md": "sha256:
|
|
19
|
+
"commands/README.md": "sha256:0d1831883c99925d3eccef7ae551f88f9789b12cf9598ab4026f50c776697a5a",
|
|
19
20
|
"commands/reviews.md": "sha256:902904aaa405fe5724cf0662c7a5a36eab9a4fe0eb81cbd95ffa2fff946e0ac8",
|
|
20
21
|
"commands/validate-render.md": "sha256:a8e1d04d40b84d57c35039250d98c6a7302cd44a148a8c3b9d9cfb92678c4347",
|
|
21
22
|
"policies/crawler-policy-template.md": "sha256:15c88a4eeb21f53f71e5250dd3eb2d2791a814b304eaefce8bb30e2bdf2e2e59",
|
|
@@ -67,10 +68,11 @@
|
|
|
67
68
|
"schemas/reviewer.schema.json": "sha256:3716697b752575a1277f2c2b318b1f2565de02bf9dce2a0c165567ab5330d18b",
|
|
68
69
|
"schemas/run.schema.json": "sha256:46c3178620f3a358d936d535aeadb83454b9b35b551e53e6615cc9862063dacb",
|
|
69
70
|
"schemas/sampling-plan.schema.json": "sha256:005f70f149baaacd7de698548d556d3e401c630978748271b0e14a74726dd413",
|
|
71
|
+
"schemas/schedule.schema.json": "sha256:0f02174ab0fc7bbbce9759fd358b18ed97cc683c76933fd3001cf053c499b157",
|
|
70
72
|
"scripts/README.md": "sha256:1c3e952950ef353849621b07c5f615bf7cd20cc5654da4635492a7bd6384e747",
|
|
71
|
-
"SKILL.md": "sha256:
|
|
73
|
+
"SKILL.md": "sha256:95336d8e690b54f72de14020a35d87d41fcaa1080a6242d821ff3df4efdf0ab6",
|
|
72
74
|
"templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
|
|
73
|
-
"VERSION": "sha256:
|
|
75
|
+
"VERSION": "sha256:4f5ba6a3e380bf810cc968b58d30a8d7163eafe9e2fb1ad19bdc6d9d64a1e549"
|
|
74
76
|
},
|
|
75
|
-
"treeHash": "sha256:
|
|
77
|
+
"treeHash": "sha256:81a5e1f3bf7560060b3f950c18804d5481b1230ab9e0b81d3ce16d0b97e43893"
|
|
76
78
|
}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$id":"citable://schemas/schedule.schema.json","$schema":"http://json-schema.org/draft-07/schema#","title":"Audit schedule registry","type":"object","additionalProperties":false,"required":["version","kind","updated","entries"],
|
|
3
|
+
"properties":{"version":{"const":1},"kind":{"const":"schedules"},"updated":{"type":"string","format":"date-time"},"entries":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["schedule_id","name","status","cron","owner","expected_tool_version","audit","retention_days","limitations"],"properties":{"schedule_id":{"type":"string","pattern":"^SCHEDULE-[A-Z0-9][A-Z0-9_-]*$"},"name":{"type":"string","minLength":1},"status":{"type":"string","enum":["active","paused","retired"]},"cron":{"type":"string","minLength":5},"owner":{"type":"string","minLength":1},"expected_tool_version":{"type":"string","pattern":"^\\d+\\.\\d+\\.\\d+$"},"audit":{"type":"object","additionalProperties":false,"required":["target","scope"],"properties":{"target":{"type":"string","minLength":1},"scope":{"type":["string","null"]},"base_url":{"type":["string","null"]}}},"retention_days":{"type":"integer","minimum":1},"limitations":{"type":"array","minItems":1,"items":{"type":"string"}}}}}}
|
|
4
|
+
}
|
|
@@ -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.10.0
|
|
11
11
|
---
|
|
12
12
|
|
|
13
13
|
# Citable — evidence and change control for search and AI citation readiness
|
|
@@ -115,6 +115,8 @@ citable reviews prioritize [--write]
|
|
|
115
115
|
citable reviews plan --input <json|yaml> [--write]
|
|
116
116
|
citable reviews sample <sampling-plan-id> [--write]
|
|
117
117
|
citable reviews evaluate
|
|
118
|
+
citable schedules run <schedule-id> [--ref-date YYYY-MM-DD]
|
|
119
|
+
citable project github <run-id>
|
|
118
120
|
```
|
|
119
121
|
|
|
120
122
|
Audit scopes: `technical seo aeo geo architecture entity claims evidence schema
|
|
@@ -174,7 +176,8 @@ mandatory.
|
|
|
174
176
|
`.citable/` holds YAML registries for queries, prompts, entities, claims,
|
|
175
177
|
evidence, pages, crawlers, competitors, experiments, metrics, objectives,
|
|
176
178
|
interventions, optional connection state, reviewers, review policies, and
|
|
177
|
-
governed exceptions, semantic review items,
|
|
179
|
+
governed exceptions, semantic review items, sampling plans, and audit schedules,
|
|
180
|
+
all schema-validated
|
|
178
181
|
(`schemas/*.schema.json`) with referential integrity checks. Rules:
|
|
179
182
|
|
|
180
183
|
- Never overwrite registry content without history — use the loader/saver in
|
|
@@ -1 +1 @@
|
|
|
1
|
-
1.
|
|
1
|
+
1.10.0
|
|
@@ -29,6 +29,7 @@ intent, not executability, so statuses are strict:
|
|
|
29
29
|
| /citable evaluate | implemented — independent baseline/evaluation comparisons with inconclusive handling |
|
|
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
|
+
| /citable schedules run / project github | implemented — canonical scheduled audits and hash-bound non-authoritative GitHub projections |
|
|
32
33
|
| /citable ingest, map-site, map-queries, map-prompts, map-entities, map-evidence | specified (ingest.md) |
|
|
33
34
|
| /citable optimize-page | specified (optimize-page.md) — requires source-to-render mapping, claim-preserving rewrites, build execution, rollback; none of that is proven yet |
|
|
34
35
|
| /citable create-page, answer-block, architect, interlink, consolidate, metadata | specified (page-work.md) |
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# Scheduling, projections, and differential delivery
|
|
2
|
+
|
|
3
|
+
`citable schedules run <schedule-id>` executes the same canonical audit function
|
|
4
|
+
used by direct CLI calls. Schedules are version-pinned and fail closed when
|
|
5
|
+
paused, missing, invalid, or bound to another Citable version. The external
|
|
6
|
+
cron service remains responsible for triggering the command; a declared cron
|
|
7
|
+
does not prove execution. Schedule metadata is stored outside the finalized
|
|
8
|
+
audit package and binds back to its manifest checksum.
|
|
9
|
+
|
|
10
|
+
`citable project github <run-id>` creates GitHub annotation JSON as a
|
|
11
|
+
non-authoritative projection. It records hashes of the source manifest and
|
|
12
|
+
findings and never edits the run. Dashboards and check annotations must link to
|
|
13
|
+
these artifacts rather than maintain separate finding state.
|
|
14
|
+
|
|
15
|
+
`compare-snapshots` reports observed comparability dimensions: resource input,
|
|
16
|
+
evidence artifact, detector set, configuration, observation method, tool
|
|
17
|
+
version, and possible external-system change. These dimensions identify why
|
|
18
|
+
runs may not be directly comparable; they do not establish causal attribution.
|
|
@@ -1,21 +1,22 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "citable",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.10.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.10.0",
|
|
9
9
|
"variantPath": ".claude/skills/citable",
|
|
10
10
|
"files": {
|
|
11
11
|
"commands/action-findings.md": "sha256:510361461f24fcd4a550e0a8d960c383aefe23f9a65a54a3ffc44abd4c1293e7",
|
|
12
|
+
"commands/delivery.md": "sha256:3b29250f9e9f84442812e320a70d5d2784b4286e91af3866f99cb6062a85a10f",
|
|
12
13
|
"commands/governance.md": "sha256:1fd6272f18b00237fc6e602ac126ae812747937b2bb575068a0d617137eea2b0",
|
|
13
14
|
"commands/ingest.md": "sha256:cf35659aecd9d0e160909003efdbe056864fc5d824c71b4ef0ee801ce07ff598",
|
|
14
15
|
"commands/measurement.md": "sha256:9cade6dfec23338e18aa67ede3335ac9e2888dc577a7d4d8e3ceac948bce403f",
|
|
15
16
|
"commands/observe-and-act.md": "sha256:02a93bbbfddc3d8e11cb921ddccd19b0666133c4bdb4f4a280bcb131bed37e8c",
|
|
16
17
|
"commands/optimize-page.md": "sha256:35866f3d7cdeef0376ea7a7d7036085a9b9cf95bbb300ecf4bd77610ebd74d85",
|
|
17
18
|
"commands/page-work.md": "sha256:965a66e59bdf7b0da482d26fade53b3d265885ece5d463fe83b0789ebefaef3e",
|
|
18
|
-
"commands/README.md": "sha256:
|
|
19
|
+
"commands/README.md": "sha256:0d1831883c99925d3eccef7ae551f88f9789b12cf9598ab4026f50c776697a5a",
|
|
19
20
|
"commands/reviews.md": "sha256:902904aaa405fe5724cf0662c7a5a36eab9a4fe0eb81cbd95ffa2fff946e0ac8",
|
|
20
21
|
"commands/validate-render.md": "sha256:a8e1d04d40b84d57c35039250d98c6a7302cd44a148a8c3b9d9cfb92678c4347",
|
|
21
22
|
"policies/crawler-policy-template.md": "sha256:15c88a4eeb21f53f71e5250dd3eb2d2791a814b304eaefce8bb30e2bdf2e2e59",
|
|
@@ -67,10 +68,11 @@
|
|
|
67
68
|
"schemas/reviewer.schema.json": "sha256:3716697b752575a1277f2c2b318b1f2565de02bf9dce2a0c165567ab5330d18b",
|
|
68
69
|
"schemas/run.schema.json": "sha256:46c3178620f3a358d936d535aeadb83454b9b35b551e53e6615cc9862063dacb",
|
|
69
70
|
"schemas/sampling-plan.schema.json": "sha256:005f70f149baaacd7de698548d556d3e401c630978748271b0e14a74726dd413",
|
|
71
|
+
"schemas/schedule.schema.json": "sha256:0f02174ab0fc7bbbce9759fd358b18ed97cc683c76933fd3001cf053c499b157",
|
|
70
72
|
"scripts/README.md": "sha256:1c3e952950ef353849621b07c5f615bf7cd20cc5654da4635492a7bd6384e747",
|
|
71
|
-
"SKILL.md": "sha256:
|
|
73
|
+
"SKILL.md": "sha256:95336d8e690b54f72de14020a35d87d41fcaa1080a6242d821ff3df4efdf0ab6",
|
|
72
74
|
"templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
|
|
73
|
-
"VERSION": "sha256:
|
|
75
|
+
"VERSION": "sha256:4f5ba6a3e380bf810cc968b58d30a8d7163eafe9e2fb1ad19bdc6d9d64a1e549"
|
|
74
76
|
},
|
|
75
|
-
"treeHash": "sha256:
|
|
77
|
+
"treeHash": "sha256:81a5e1f3bf7560060b3f950c18804d5481b1230ab9e0b81d3ce16d0b97e43893"
|
|
76
78
|
}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$id":"citable://schemas/schedule.schema.json","$schema":"http://json-schema.org/draft-07/schema#","title":"Audit schedule registry","type":"object","additionalProperties":false,"required":["version","kind","updated","entries"],
|
|
3
|
+
"properties":{"version":{"const":1},"kind":{"const":"schedules"},"updated":{"type":"string","format":"date-time"},"entries":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["schedule_id","name","status","cron","owner","expected_tool_version","audit","retention_days","limitations"],"properties":{"schedule_id":{"type":"string","pattern":"^SCHEDULE-[A-Z0-9][A-Z0-9_-]*$"},"name":{"type":"string","minLength":1},"status":{"type":"string","enum":["active","paused","retired"]},"cron":{"type":"string","minLength":5},"owner":{"type":"string","minLength":1},"expected_tool_version":{"type":"string","pattern":"^\\d+\\.\\d+\\.\\d+$"},"audit":{"type":"object","additionalProperties":false,"required":["target","scope"],"properties":{"target":{"type":"string","minLength":1},"scope":{"type":["string","null"]},"base_url":{"type":["string","null"]}}},"retention_days":{"type":"integer","minimum":1},"limitations":{"type":"array","minItems":1,"items":{"type":"string"}}}}}}
|
|
4
|
+
}
|
|
@@ -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.10.0
|
|
11
11
|
---
|
|
12
12
|
|
|
13
13
|
# Citable — evidence and change control for search and AI citation readiness
|
|
@@ -115,6 +115,8 @@ citable reviews prioritize [--write]
|
|
|
115
115
|
citable reviews plan --input <json|yaml> [--write]
|
|
116
116
|
citable reviews sample <sampling-plan-id> [--write]
|
|
117
117
|
citable reviews evaluate
|
|
118
|
+
citable schedules run <schedule-id> [--ref-date YYYY-MM-DD]
|
|
119
|
+
citable project github <run-id>
|
|
118
120
|
```
|
|
119
121
|
|
|
120
122
|
Audit scopes: `technical seo aeo geo architecture entity claims evidence schema
|
|
@@ -174,7 +176,8 @@ mandatory.
|
|
|
174
176
|
`.citable/` holds YAML registries for queries, prompts, entities, claims,
|
|
175
177
|
evidence, pages, crawlers, competitors, experiments, metrics, objectives,
|
|
176
178
|
interventions, optional connection state, reviewers, review policies, and
|
|
177
|
-
governed exceptions, semantic review items,
|
|
179
|
+
governed exceptions, semantic review items, sampling plans, and audit schedules,
|
|
180
|
+
all schema-validated
|
|
178
181
|
(`schemas/*.schema.json`) with referential integrity checks. Rules:
|
|
179
182
|
|
|
180
183
|
- Never overwrite registry content without history — use the loader/saver in
|
|
@@ -1 +1 @@
|
|
|
1
|
-
1.
|
|
1
|
+
1.10.0
|
|
@@ -29,6 +29,7 @@ intent, not executability, so statuses are strict:
|
|
|
29
29
|
| /citable evaluate | implemented — independent baseline/evaluation comparisons with inconclusive handling |
|
|
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
|
+
| /citable schedules run / project github | implemented — canonical scheduled audits and hash-bound non-authoritative GitHub projections |
|
|
32
33
|
| /citable ingest, map-site, map-queries, map-prompts, map-entities, map-evidence | specified (ingest.md) |
|
|
33
34
|
| /citable optimize-page | specified (optimize-page.md) — requires source-to-render mapping, claim-preserving rewrites, build execution, rollback; none of that is proven yet |
|
|
34
35
|
| /citable create-page, answer-block, architect, interlink, consolidate, metadata | specified (page-work.md) |
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# Scheduling, projections, and differential delivery
|
|
2
|
+
|
|
3
|
+
`citable schedules run <schedule-id>` executes the same canonical audit function
|
|
4
|
+
used by direct CLI calls. Schedules are version-pinned and fail closed when
|
|
5
|
+
paused, missing, invalid, or bound to another Citable version. The external
|
|
6
|
+
cron service remains responsible for triggering the command; a declared cron
|
|
7
|
+
does not prove execution. Schedule metadata is stored outside the finalized
|
|
8
|
+
audit package and binds back to its manifest checksum.
|
|
9
|
+
|
|
10
|
+
`citable project github <run-id>` creates GitHub annotation JSON as a
|
|
11
|
+
non-authoritative projection. It records hashes of the source manifest and
|
|
12
|
+
findings and never edits the run. Dashboards and check annotations must link to
|
|
13
|
+
these artifacts rather than maintain separate finding state.
|
|
14
|
+
|
|
15
|
+
`compare-snapshots` reports observed comparability dimensions: resource input,
|
|
16
|
+
evidence artifact, detector set, configuration, observation method, tool
|
|
17
|
+
version, and possible external-system change. These dimensions identify why
|
|
18
|
+
runs may not be directly comparable; they do not establish causal attribution.
|
|
@@ -1,21 +1,22 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "citable",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.10.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.10.0",
|
|
9
9
|
"variantPath": ".cursor/skills/citable",
|
|
10
10
|
"files": {
|
|
11
11
|
"commands/action-findings.md": "sha256:510361461f24fcd4a550e0a8d960c383aefe23f9a65a54a3ffc44abd4c1293e7",
|
|
12
|
+
"commands/delivery.md": "sha256:3b29250f9e9f84442812e320a70d5d2784b4286e91af3866f99cb6062a85a10f",
|
|
12
13
|
"commands/governance.md": "sha256:1fd6272f18b00237fc6e602ac126ae812747937b2bb575068a0d617137eea2b0",
|
|
13
14
|
"commands/ingest.md": "sha256:cf35659aecd9d0e160909003efdbe056864fc5d824c71b4ef0ee801ce07ff598",
|
|
14
15
|
"commands/measurement.md": "sha256:9cade6dfec23338e18aa67ede3335ac9e2888dc577a7d4d8e3ceac948bce403f",
|
|
15
16
|
"commands/observe-and-act.md": "sha256:02a93bbbfddc3d8e11cb921ddccd19b0666133c4bdb4f4a280bcb131bed37e8c",
|
|
16
17
|
"commands/optimize-page.md": "sha256:35866f3d7cdeef0376ea7a7d7036085a9b9cf95bbb300ecf4bd77610ebd74d85",
|
|
17
18
|
"commands/page-work.md": "sha256:965a66e59bdf7b0da482d26fade53b3d265885ece5d463fe83b0789ebefaef3e",
|
|
18
|
-
"commands/README.md": "sha256:
|
|
19
|
+
"commands/README.md": "sha256:0d1831883c99925d3eccef7ae551f88f9789b12cf9598ab4026f50c776697a5a",
|
|
19
20
|
"commands/reviews.md": "sha256:902904aaa405fe5724cf0662c7a5a36eab9a4fe0eb81cbd95ffa2fff946e0ac8",
|
|
20
21
|
"commands/validate-render.md": "sha256:a8e1d04d40b84d57c35039250d98c6a7302cd44a148a8c3b9d9cfb92678c4347",
|
|
21
22
|
"policies/crawler-policy-template.md": "sha256:15c88a4eeb21f53f71e5250dd3eb2d2791a814b304eaefce8bb30e2bdf2e2e59",
|
|
@@ -67,10 +68,11 @@
|
|
|
67
68
|
"schemas/reviewer.schema.json": "sha256:3716697b752575a1277f2c2b318b1f2565de02bf9dce2a0c165567ab5330d18b",
|
|
68
69
|
"schemas/run.schema.json": "sha256:46c3178620f3a358d936d535aeadb83454b9b35b551e53e6615cc9862063dacb",
|
|
69
70
|
"schemas/sampling-plan.schema.json": "sha256:005f70f149baaacd7de698548d556d3e401c630978748271b0e14a74726dd413",
|
|
71
|
+
"schemas/schedule.schema.json": "sha256:0f02174ab0fc7bbbce9759fd358b18ed97cc683c76933fd3001cf053c499b157",
|
|
70
72
|
"scripts/README.md": "sha256:1c3e952950ef353849621b07c5f615bf7cd20cc5654da4635492a7bd6384e747",
|
|
71
|
-
"SKILL.md": "sha256:
|
|
73
|
+
"SKILL.md": "sha256:95336d8e690b54f72de14020a35d87d41fcaa1080a6242d821ff3df4efdf0ab6",
|
|
72
74
|
"templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
|
|
73
|
-
"VERSION": "sha256:
|
|
75
|
+
"VERSION": "sha256:4f5ba6a3e380bf810cc968b58d30a8d7163eafe9e2fb1ad19bdc6d9d64a1e549"
|
|
74
76
|
},
|
|
75
|
-
"treeHash": "sha256:
|
|
77
|
+
"treeHash": "sha256:81a5e1f3bf7560060b3f950c18804d5481b1230ab9e0b81d3ce16d0b97e43893"
|
|
76
78
|
}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$id":"citable://schemas/schedule.schema.json","$schema":"http://json-schema.org/draft-07/schema#","title":"Audit schedule registry","type":"object","additionalProperties":false,"required":["version","kind","updated","entries"],
|
|
3
|
+
"properties":{"version":{"const":1},"kind":{"const":"schedules"},"updated":{"type":"string","format":"date-time"},"entries":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["schedule_id","name","status","cron","owner","expected_tool_version","audit","retention_days","limitations"],"properties":{"schedule_id":{"type":"string","pattern":"^SCHEDULE-[A-Z0-9][A-Z0-9_-]*$"},"name":{"type":"string","minLength":1},"status":{"type":"string","enum":["active","paused","retired"]},"cron":{"type":"string","minLength":5},"owner":{"type":"string","minLength":1},"expected_tool_version":{"type":"string","pattern":"^\\d+\\.\\d+\\.\\d+$"},"audit":{"type":"object","additionalProperties":false,"required":["target","scope"],"properties":{"target":{"type":"string","minLength":1},"scope":{"type":["string","null"]},"base_url":{"type":["string","null"]}}},"retention_days":{"type":"integer","minimum":1},"limitations":{"type":"array","minItems":1,"items":{"type":"string"}}}}}}
|
|
4
|
+
}
|
|
@@ -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.10.0
|
|
11
11
|
---
|
|
12
12
|
|
|
13
13
|
# Citable — evidence and change control for search and AI citation readiness
|
|
@@ -115,6 +115,8 @@ citable reviews prioritize [--write]
|
|
|
115
115
|
citable reviews plan --input <json|yaml> [--write]
|
|
116
116
|
citable reviews sample <sampling-plan-id> [--write]
|
|
117
117
|
citable reviews evaluate
|
|
118
|
+
citable schedules run <schedule-id> [--ref-date YYYY-MM-DD]
|
|
119
|
+
citable project github <run-id>
|
|
118
120
|
```
|
|
119
121
|
|
|
120
122
|
Audit scopes: `technical seo aeo geo architecture entity claims evidence schema
|
|
@@ -174,7 +176,8 @@ mandatory.
|
|
|
174
176
|
`.citable/` holds YAML registries for queries, prompts, entities, claims,
|
|
175
177
|
evidence, pages, crawlers, competitors, experiments, metrics, objectives,
|
|
176
178
|
interventions, optional connection state, reviewers, review policies, and
|
|
177
|
-
governed exceptions, semantic review items,
|
|
179
|
+
governed exceptions, semantic review items, sampling plans, and audit schedules,
|
|
180
|
+
all schema-validated
|
|
178
181
|
(`schemas/*.schema.json`) with referential integrity checks. Rules:
|
|
179
182
|
|
|
180
183
|
- Never overwrite registry content without history — use the loader/saver in
|
|
@@ -1 +1 @@
|
|
|
1
|
-
1.
|
|
1
|
+
1.10.0
|
|
@@ -29,6 +29,7 @@ intent, not executability, so statuses are strict:
|
|
|
29
29
|
| /citable evaluate | implemented — independent baseline/evaluation comparisons with inconclusive handling |
|
|
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
|
+
| /citable schedules run / project github | implemented — canonical scheduled audits and hash-bound non-authoritative GitHub projections |
|
|
32
33
|
| /citable ingest, map-site, map-queries, map-prompts, map-entities, map-evidence | specified (ingest.md) |
|
|
33
34
|
| /citable optimize-page | specified (optimize-page.md) — requires source-to-render mapping, claim-preserving rewrites, build execution, rollback; none of that is proven yet |
|
|
34
35
|
| /citable create-page, answer-block, architect, interlink, consolidate, metadata | specified (page-work.md) |
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# Scheduling, projections, and differential delivery
|
|
2
|
+
|
|
3
|
+
`citable schedules run <schedule-id>` executes the same canonical audit function
|
|
4
|
+
used by direct CLI calls. Schedules are version-pinned and fail closed when
|
|
5
|
+
paused, missing, invalid, or bound to another Citable version. The external
|
|
6
|
+
cron service remains responsible for triggering the command; a declared cron
|
|
7
|
+
does not prove execution. Schedule metadata is stored outside the finalized
|
|
8
|
+
audit package and binds back to its manifest checksum.
|
|
9
|
+
|
|
10
|
+
`citable project github <run-id>` creates GitHub annotation JSON as a
|
|
11
|
+
non-authoritative projection. It records hashes of the source manifest and
|
|
12
|
+
findings and never edits the run. Dashboards and check annotations must link to
|
|
13
|
+
these artifacts rather than maintain separate finding state.
|
|
14
|
+
|
|
15
|
+
`compare-snapshots` reports observed comparability dimensions: resource input,
|
|
16
|
+
evidence artifact, detector set, configuration, observation method, tool
|
|
17
|
+
version, and possible external-system change. These dimensions identify why
|
|
18
|
+
runs may not be directly comparable; they do not establish causal attribution.
|
|
@@ -1,21 +1,22 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "citable",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.10.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.10.0",
|
|
9
9
|
"variantPath": ".gemini/skills/citable",
|
|
10
10
|
"files": {
|
|
11
11
|
"commands/action-findings.md": "sha256:510361461f24fcd4a550e0a8d960c383aefe23f9a65a54a3ffc44abd4c1293e7",
|
|
12
|
+
"commands/delivery.md": "sha256:3b29250f9e9f84442812e320a70d5d2784b4286e91af3866f99cb6062a85a10f",
|
|
12
13
|
"commands/governance.md": "sha256:1fd6272f18b00237fc6e602ac126ae812747937b2bb575068a0d617137eea2b0",
|
|
13
14
|
"commands/ingest.md": "sha256:cf35659aecd9d0e160909003efdbe056864fc5d824c71b4ef0ee801ce07ff598",
|
|
14
15
|
"commands/measurement.md": "sha256:9cade6dfec23338e18aa67ede3335ac9e2888dc577a7d4d8e3ceac948bce403f",
|
|
15
16
|
"commands/observe-and-act.md": "sha256:02a93bbbfddc3d8e11cb921ddccd19b0666133c4bdb4f4a280bcb131bed37e8c",
|
|
16
17
|
"commands/optimize-page.md": "sha256:35866f3d7cdeef0376ea7a7d7036085a9b9cf95bbb300ecf4bd77610ebd74d85",
|
|
17
18
|
"commands/page-work.md": "sha256:965a66e59bdf7b0da482d26fade53b3d265885ece5d463fe83b0789ebefaef3e",
|
|
18
|
-
"commands/README.md": "sha256:
|
|
19
|
+
"commands/README.md": "sha256:0d1831883c99925d3eccef7ae551f88f9789b12cf9598ab4026f50c776697a5a",
|
|
19
20
|
"commands/reviews.md": "sha256:902904aaa405fe5724cf0662c7a5a36eab9a4fe0eb81cbd95ffa2fff946e0ac8",
|
|
20
21
|
"commands/validate-render.md": "sha256:a8e1d04d40b84d57c35039250d98c6a7302cd44a148a8c3b9d9cfb92678c4347",
|
|
21
22
|
"policies/crawler-policy-template.md": "sha256:15c88a4eeb21f53f71e5250dd3eb2d2791a814b304eaefce8bb30e2bdf2e2e59",
|
|
@@ -67,10 +68,11 @@
|
|
|
67
68
|
"schemas/reviewer.schema.json": "sha256:3716697b752575a1277f2c2b318b1f2565de02bf9dce2a0c165567ab5330d18b",
|
|
68
69
|
"schemas/run.schema.json": "sha256:46c3178620f3a358d936d535aeadb83454b9b35b551e53e6615cc9862063dacb",
|
|
69
70
|
"schemas/sampling-plan.schema.json": "sha256:005f70f149baaacd7de698548d556d3e401c630978748271b0e14a74726dd413",
|
|
71
|
+
"schemas/schedule.schema.json": "sha256:0f02174ab0fc7bbbce9759fd358b18ed97cc683c76933fd3001cf053c499b157",
|
|
70
72
|
"scripts/README.md": "sha256:1c3e952950ef353849621b07c5f615bf7cd20cc5654da4635492a7bd6384e747",
|
|
71
|
-
"SKILL.md": "sha256:
|
|
73
|
+
"SKILL.md": "sha256:95336d8e690b54f72de14020a35d87d41fcaa1080a6242d821ff3df4efdf0ab6",
|
|
72
74
|
"templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
|
|
73
|
-
"VERSION": "sha256:
|
|
75
|
+
"VERSION": "sha256:4f5ba6a3e380bf810cc968b58d30a8d7163eafe9e2fb1ad19bdc6d9d64a1e549"
|
|
74
76
|
},
|
|
75
|
-
"treeHash": "sha256:
|
|
77
|
+
"treeHash": "sha256:81a5e1f3bf7560060b3f950c18804d5481b1230ab9e0b81d3ce16d0b97e43893"
|
|
76
78
|
}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$id":"citable://schemas/schedule.schema.json","$schema":"http://json-schema.org/draft-07/schema#","title":"Audit schedule registry","type":"object","additionalProperties":false,"required":["version","kind","updated","entries"],
|
|
3
|
+
"properties":{"version":{"const":1},"kind":{"const":"schedules"},"updated":{"type":"string","format":"date-time"},"entries":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["schedule_id","name","status","cron","owner","expected_tool_version","audit","retention_days","limitations"],"properties":{"schedule_id":{"type":"string","pattern":"^SCHEDULE-[A-Z0-9][A-Z0-9_-]*$"},"name":{"type":"string","minLength":1},"status":{"type":"string","enum":["active","paused","retired"]},"cron":{"type":"string","minLength":5},"owner":{"type":"string","minLength":1},"expected_tool_version":{"type":"string","pattern":"^\\d+\\.\\d+\\.\\d+$"},"audit":{"type":"object","additionalProperties":false,"required":["target","scope"],"properties":{"target":{"type":"string","minLength":1},"scope":{"type":["string","null"]},"base_url":{"type":["string","null"]}}},"retention_days":{"type":"integer","minimum":1},"limitations":{"type":"array","minItems":1,"items":{"type":"string"}}}}}}
|
|
4
|
+
}
|
|
@@ -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.10.0
|
|
11
11
|
---
|
|
12
12
|
|
|
13
13
|
# Citable — evidence and change control for search and AI citation readiness
|
|
@@ -115,6 +115,8 @@ citable reviews prioritize [--write]
|
|
|
115
115
|
citable reviews plan --input <json|yaml> [--write]
|
|
116
116
|
citable reviews sample <sampling-plan-id> [--write]
|
|
117
117
|
citable reviews evaluate
|
|
118
|
+
citable schedules run <schedule-id> [--ref-date YYYY-MM-DD]
|
|
119
|
+
citable project github <run-id>
|
|
118
120
|
```
|
|
119
121
|
|
|
120
122
|
Audit scopes: `technical seo aeo geo architecture entity claims evidence schema
|
|
@@ -174,7 +176,8 @@ mandatory.
|
|
|
174
176
|
`.citable/` holds YAML registries for queries, prompts, entities, claims,
|
|
175
177
|
evidence, pages, crawlers, competitors, experiments, metrics, objectives,
|
|
176
178
|
interventions, optional connection state, reviewers, review policies, and
|
|
177
|
-
governed exceptions, semantic review items,
|
|
179
|
+
governed exceptions, semantic review items, sampling plans, and audit schedules,
|
|
180
|
+
all schema-validated
|
|
178
181
|
(`schemas/*.schema.json`) with referential integrity checks. Rules:
|
|
179
182
|
|
|
180
183
|
- Never overwrite registry content without history — use the loader/saver in
|
|
@@ -1 +1 @@
|
|
|
1
|
-
1.
|
|
1
|
+
1.10.0
|
|
@@ -29,6 +29,7 @@ intent, not executability, so statuses are strict:
|
|
|
29
29
|
| /citable evaluate | implemented — independent baseline/evaluation comparisons with inconclusive handling |
|
|
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
|
+
| /citable schedules run / project github | implemented — canonical scheduled audits and hash-bound non-authoritative GitHub projections |
|
|
32
33
|
| /citable ingest, map-site, map-queries, map-prompts, map-entities, map-evidence | specified (ingest.md) |
|
|
33
34
|
| /citable optimize-page | specified (optimize-page.md) — requires source-to-render mapping, claim-preserving rewrites, build execution, rollback; none of that is proven yet |
|
|
34
35
|
| /citable create-page, answer-block, architect, interlink, consolidate, metadata | specified (page-work.md) |
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# Scheduling, projections, and differential delivery
|
|
2
|
+
|
|
3
|
+
`citable schedules run <schedule-id>` executes the same canonical audit function
|
|
4
|
+
used by direct CLI calls. Schedules are version-pinned and fail closed when
|
|
5
|
+
paused, missing, invalid, or bound to another Citable version. The external
|
|
6
|
+
cron service remains responsible for triggering the command; a declared cron
|
|
7
|
+
does not prove execution. Schedule metadata is stored outside the finalized
|
|
8
|
+
audit package and binds back to its manifest checksum.
|
|
9
|
+
|
|
10
|
+
`citable project github <run-id>` creates GitHub annotation JSON as a
|
|
11
|
+
non-authoritative projection. It records hashes of the source manifest and
|
|
12
|
+
findings and never edits the run. Dashboards and check annotations must link to
|
|
13
|
+
these artifacts rather than maintain separate finding state.
|
|
14
|
+
|
|
15
|
+
`compare-snapshots` reports observed comparability dimensions: resource input,
|
|
16
|
+
evidence artifact, detector set, configuration, observation method, tool
|
|
17
|
+
version, and possible external-system change. These dimensions identify why
|
|
18
|
+
runs may not be directly comparable; they do not establish causal attribution.
|
|
@@ -1,21 +1,22 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "citable",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.10.0",
|
|
4
4
|
"managedBy": "citable-cli",
|
|
5
5
|
"provider": "github",
|
|
6
6
|
"providerName": "GitHub Copilot",
|
|
7
7
|
"scope": "bundle",
|
|
8
|
-
"sourcePackage": "@nebulacomponents/citable@1.
|
|
8
|
+
"sourcePackage": "@nebulacomponents/citable@1.10.0",
|
|
9
9
|
"variantPath": ".github/skills/citable",
|
|
10
10
|
"files": {
|
|
11
11
|
"commands/action-findings.md": "sha256:510361461f24fcd4a550e0a8d960c383aefe23f9a65a54a3ffc44abd4c1293e7",
|
|
12
|
+
"commands/delivery.md": "sha256:3b29250f9e9f84442812e320a70d5d2784b4286e91af3866f99cb6062a85a10f",
|
|
12
13
|
"commands/governance.md": "sha256:1fd6272f18b00237fc6e602ac126ae812747937b2bb575068a0d617137eea2b0",
|
|
13
14
|
"commands/ingest.md": "sha256:cf35659aecd9d0e160909003efdbe056864fc5d824c71b4ef0ee801ce07ff598",
|
|
14
15
|
"commands/measurement.md": "sha256:9cade6dfec23338e18aa67ede3335ac9e2888dc577a7d4d8e3ceac948bce403f",
|
|
15
16
|
"commands/observe-and-act.md": "sha256:02a93bbbfddc3d8e11cb921ddccd19b0666133c4bdb4f4a280bcb131bed37e8c",
|
|
16
17
|
"commands/optimize-page.md": "sha256:35866f3d7cdeef0376ea7a7d7036085a9b9cf95bbb300ecf4bd77610ebd74d85",
|
|
17
18
|
"commands/page-work.md": "sha256:965a66e59bdf7b0da482d26fade53b3d265885ece5d463fe83b0789ebefaef3e",
|
|
18
|
-
"commands/README.md": "sha256:
|
|
19
|
+
"commands/README.md": "sha256:0d1831883c99925d3eccef7ae551f88f9789b12cf9598ab4026f50c776697a5a",
|
|
19
20
|
"commands/reviews.md": "sha256:902904aaa405fe5724cf0662c7a5a36eab9a4fe0eb81cbd95ffa2fff946e0ac8",
|
|
20
21
|
"commands/validate-render.md": "sha256:a8e1d04d40b84d57c35039250d98c6a7302cd44a148a8c3b9d9cfb92678c4347",
|
|
21
22
|
"policies/crawler-policy-template.md": "sha256:15c88a4eeb21f53f71e5250dd3eb2d2791a814b304eaefce8bb30e2bdf2e2e59",
|
|
@@ -67,10 +68,11 @@
|
|
|
67
68
|
"schemas/reviewer.schema.json": "sha256:3716697b752575a1277f2c2b318b1f2565de02bf9dce2a0c165567ab5330d18b",
|
|
68
69
|
"schemas/run.schema.json": "sha256:46c3178620f3a358d936d535aeadb83454b9b35b551e53e6615cc9862063dacb",
|
|
69
70
|
"schemas/sampling-plan.schema.json": "sha256:005f70f149baaacd7de698548d556d3e401c630978748271b0e14a74726dd413",
|
|
71
|
+
"schemas/schedule.schema.json": "sha256:0f02174ab0fc7bbbce9759fd358b18ed97cc683c76933fd3001cf053c499b157",
|
|
70
72
|
"scripts/README.md": "sha256:1c3e952950ef353849621b07c5f615bf7cd20cc5654da4635492a7bd6384e747",
|
|
71
|
-
"SKILL.md": "sha256:
|
|
73
|
+
"SKILL.md": "sha256:95336d8e690b54f72de14020a35d87d41fcaa1080a6242d821ff3df4efdf0ab6",
|
|
72
74
|
"templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
|
|
73
|
-
"VERSION": "sha256:
|
|
75
|
+
"VERSION": "sha256:4f5ba6a3e380bf810cc968b58d30a8d7163eafe9e2fb1ad19bdc6d9d64a1e549"
|
|
74
76
|
},
|
|
75
|
-
"treeHash": "sha256:
|
|
77
|
+
"treeHash": "sha256:81a5e1f3bf7560060b3f950c18804d5481b1230ab9e0b81d3ce16d0b97e43893"
|
|
76
78
|
}
|