@nebulacomponents/citable 1.8.0 → 1.9.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 +7 -2
- package/dist/universal/.agents/skills/citable/SKILL.md +7 -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/reviews.md +18 -0
- package/dist/universal/.agents/skills/citable/manifest.json +9 -6
- package/dist/universal/.agents/skills/citable/schemas/review-item.schema.json +12 -0
- package/dist/universal/.agents/skills/citable/schemas/sampling-plan.schema.json +4 -0
- package/dist/universal/.claude/skills/citable/SKILL.md +7 -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/reviews.md +18 -0
- package/dist/universal/.claude/skills/citable/manifest.json +9 -6
- package/dist/universal/.claude/skills/citable/schemas/review-item.schema.json +12 -0
- package/dist/universal/.claude/skills/citable/schemas/sampling-plan.schema.json +4 -0
- package/dist/universal/.cursor/skills/citable/SKILL.md +7 -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/reviews.md +18 -0
- package/dist/universal/.cursor/skills/citable/manifest.json +9 -6
- package/dist/universal/.cursor/skills/citable/schemas/review-item.schema.json +12 -0
- package/dist/universal/.cursor/skills/citable/schemas/sampling-plan.schema.json +4 -0
- package/dist/universal/.gemini/skills/citable/SKILL.md +7 -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/reviews.md +18 -0
- package/dist/universal/.gemini/skills/citable/manifest.json +9 -6
- package/dist/universal/.gemini/skills/citable/schemas/review-item.schema.json +12 -0
- package/dist/universal/.gemini/skills/citable/schemas/sampling-plan.schema.json +4 -0
- package/dist/universal/.github/skills/citable/SKILL.md +7 -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/reviews.md +18 -0
- package/dist/universal/.github/skills/citable/manifest.json +9 -6
- package/dist/universal/.github/skills/citable/schemas/review-item.schema.json +12 -0
- package/dist/universal/.github/skills/citable/schemas/sampling-plan.schema.json +4 -0
- package/dist/universal/.kiro/skills/citable/SKILL.md +7 -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/reviews.md +18 -0
- package/dist/universal/.kiro/skills/citable/manifest.json +9 -6
- package/dist/universal/.kiro/skills/citable/schemas/review-item.schema.json +12 -0
- package/dist/universal/.kiro/skills/citable/schemas/sampling-plan.schema.json +4 -0
- package/dist/universal/.opencode/skills/citable/SKILL.md +7 -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/reviews.md +18 -0
- package/dist/universal/.opencode/skills/citable/manifest.json +9 -6
- package/dist/universal/.opencode/skills/citable/schemas/review-item.schema.json +12 -0
- package/dist/universal/.opencode/skills/citable/schemas/sampling-plan.schema.json +4 -0
- package/dist/universal/.pi/agent/skills/citable/SKILL.md +7 -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/reviews.md +18 -0
- package/dist/universal/.pi/agent/skills/citable/manifest.json +9 -6
- package/dist/universal/.pi/agent/skills/citable/schemas/review-item.schema.json +12 -0
- package/dist/universal/.pi/agent/skills/citable/schemas/sampling-plan.schema.json +4 -0
- package/dist/universal/.qoder/skills/citable/SKILL.md +7 -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/reviews.md +18 -0
- package/dist/universal/.qoder/skills/citable/manifest.json +9 -6
- package/dist/universal/.qoder/skills/citable/schemas/review-item.schema.json +12 -0
- package/dist/universal/.qoder/skills/citable/schemas/sampling-plan.schema.json +4 -0
- package/dist/universal/.rovodev/skills/citable/SKILL.md +7 -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/reviews.md +18 -0
- package/dist/universal/.rovodev/skills/citable/manifest.json +9 -6
- package/dist/universal/.rovodev/skills/citable/schemas/review-item.schema.json +12 -0
- package/dist/universal/.rovodev/skills/citable/schemas/sampling-plan.schema.json +4 -0
- package/dist/universal/.trae/skills/citable/SKILL.md +7 -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/reviews.md +18 -0
- package/dist/universal/.trae/skills/citable/manifest.json +9 -6
- package/dist/universal/.trae/skills/citable/schemas/review-item.schema.json +12 -0
- package/dist/universal/.trae/skills/citable/schemas/sampling-plan.schema.json +4 -0
- package/dist/universal/.trae-cn/skills/citable/SKILL.md +7 -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/reviews.md +18 -0
- package/dist/universal/.trae-cn/skills/citable/manifest.json +9 -6
- package/dist/universal/.trae-cn/skills/citable/schemas/review-item.schema.json +12 -0
- package/dist/universal/.trae-cn/skills/citable/schemas/sampling-plan.schema.json +4 -0
- package/dist/universal/manifest.json +111 -75
- package/package.json +1 -1
- package/schemas/review-item.schema.json +12 -0
- package/schemas/sampling-plan.schema.json +4 -0
- package/skill/SKILL.md +7 -2
- package/skill/commands/README.md +1 -0
- package/skill/commands/reviews.md +18 -0
- package/src/cli/index.js +17 -0
- package/src/commands/reviews.js +73 -0
- package/src/registries/index.js +9 -0
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,16 @@
|
|
|
2
2
|
|
|
3
3
|
## Unreleased
|
|
4
4
|
|
|
5
|
+
## 1.9.0 — 2026-07-19
|
|
6
|
+
|
|
7
|
+
### Added
|
|
8
|
+
|
|
9
|
+
- Materiality-ranked semantic review queues with explicit missing-input states,
|
|
10
|
+
reviewer assignment, hash-bound decisions, and independent adjudication.
|
|
11
|
+
- Reproducible census and seeded random sampling plans recording population
|
|
12
|
+
hashes, inclusion/exclusion criteria, assignment method, and extrapolation limits.
|
|
13
|
+
- `citable reviews queue|prioritize|plan|sample|evaluate` workflows.
|
|
14
|
+
|
|
5
15
|
## 1.8.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
|
-
|
|
22
|
+
governed exceptions, semantic review items, and sampling plans — 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
|
|
@@ -166,6 +166,11 @@ citable objectives validate
|
|
|
166
166
|
citable evaluate OBJECTIVE-PRODUCT_DISCOVERY --ref-date 2026-07-18
|
|
167
167
|
citable governance validate --ref-date 2026-07-19
|
|
168
168
|
citable governance evaluate <run-id> --ref-date 2026-07-19
|
|
169
|
+
citable reviews queue <run-id> <policy-id> --write
|
|
170
|
+
citable reviews prioritize --write
|
|
171
|
+
citable reviews plan --input sampling-plan.json --write
|
|
172
|
+
citable reviews sample <sampling-plan-id> --write
|
|
173
|
+
citable reviews evaluate
|
|
169
174
|
citable substantiate # claim/evidence assessment (dry run)
|
|
170
175
|
citable validate # registry schema + referential integrity
|
|
171
176
|
```
|
|
@@ -176,7 +181,7 @@ citable validate # registry schema + referential integrity
|
|
|
176
181
|
| --- | --- |
|
|
177
182
|
| `skill/` | Canonical agent skill: SKILL.md, command contracts, rubrics, anti-patterns, policies, templates |
|
|
178
183
|
| `src/` | CLI, commands, registries, detectors, crawler/extractor, evidence, reporting |
|
|
179
|
-
| `schemas/` | JSON Schemas:
|
|
184
|
+
| `schemas/` | JSON Schemas: 18 registries plus findings, runs, observations, remediation, config, and prompt results |
|
|
180
185
|
| `tests/` | Unit + integration suites; positive/negative fixtures |
|
|
181
186
|
| `docs/` | ADR, traceability matrix, known limitations |
|
|
182
187
|
| `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.9.0
|
|
11
11
|
---
|
|
12
12
|
|
|
13
13
|
# Citable — evidence and change control for search and AI citation readiness
|
|
@@ -110,6 +110,11 @@ citable objectives validate
|
|
|
110
110
|
citable evaluate [objective-id] [--ref-date YYYY-MM-DD]
|
|
111
111
|
citable governance validate [--ref-date YYYY-MM-DD]
|
|
112
112
|
citable governance evaluate <run-id> [--ref-date YYYY-MM-DD]
|
|
113
|
+
citable reviews queue <run-id> <policy-id> [--write]
|
|
114
|
+
citable reviews prioritize [--write]
|
|
115
|
+
citable reviews plan --input <json|yaml> [--write]
|
|
116
|
+
citable reviews sample <sampling-plan-id> [--write]
|
|
117
|
+
citable reviews evaluate
|
|
113
118
|
```
|
|
114
119
|
|
|
115
120
|
Audit scopes: `technical seo aeo geo architecture entity claims evidence schema
|
|
@@ -169,7 +174,7 @@ mandatory.
|
|
|
169
174
|
`.citable/` holds YAML registries for queries, prompts, entities, claims,
|
|
170
175
|
evidence, pages, crawlers, competitors, experiments, metrics, objectives,
|
|
171
176
|
interventions, optional connection state, reviewers, review policies, and
|
|
172
|
-
governed exceptions, all schema-validated
|
|
177
|
+
governed exceptions, semantic review items, and sampling plans, all schema-validated
|
|
173
178
|
(`schemas/*.schema.json`) with referential integrity checks. Rules:
|
|
174
179
|
|
|
175
180
|
- Never overwrite registry content without history — use the loader/saver in
|
|
@@ -1 +1 @@
|
|
|
1
|
-
1.
|
|
1
|
+
1.9.0
|
|
@@ -28,6 +28,7 @@ intent, not executability, so statuses are strict:
|
|
|
28
28
|
| /citable objectives init / validate | implemented — user-owned metric selection, cohorts, windows, and guardrails |
|
|
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
|
+
| /citable reviews queue / prioritize / plan / sample / evaluate | implemented — materiality queues, reproducible sampling, stale-decision checks, and independent disagreement adjudication |
|
|
31
32
|
| /citable ingest, map-site, map-queries, map-prompts, map-entities, map-evidence | specified (ingest.md) |
|
|
32
33
|
| /citable optimize-page | specified (optimize-page.md) — requires source-to-render mapping, claim-preserving rewrites, build execution, rollback; none of that is proven yet |
|
|
33
34
|
| /citable create-page, answer-block, architect, interlink, consolidate, metadata | specified (page-work.md) |
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# Semantic review queues and sampling
|
|
2
|
+
|
|
3
|
+
Use `reviews queue` to create hash-bound review work from heuristic or
|
|
4
|
+
review-required findings. Newly queued items expose all missing materiality
|
|
5
|
+
inputs and remain `insufficient_inputs`; model confidence alone never controls
|
|
6
|
+
priority. After authorized operators supply business importance, citation
|
|
7
|
+
frequency, evidence age and authority, regulatory exposure, intervention
|
|
8
|
+
impact, change magnitude, and disagreement history, use `reviews prioritize`.
|
|
9
|
+
|
|
10
|
+
Sampling plans support only `census` and reproducible `simple_random` methods.
|
|
11
|
+
Every selection records its seed, population hash, inclusion/exclusion criteria,
|
|
12
|
+
assignment method, and extrapolation limits. Do not present sampled review as
|
|
13
|
+
complete validation or generalize beyond the recorded population.
|
|
14
|
+
|
|
15
|
+
`reviews evaluate` rejects stale or unauthorized decisions. Distinct verdicts
|
|
16
|
+
produce `adjudication_required`; vote counting never establishes semantic truth.
|
|
17
|
+
Completion requires an evidence-linked, hash-bound decision from an active
|
|
18
|
+
independent reviewer.
|
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "citable",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.9.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.9.0",
|
|
9
9
|
"variantPath": ".agents/skills/citable",
|
|
10
10
|
"files": {
|
|
11
11
|
"commands/action-findings.md": "sha256:510361461f24fcd4a550e0a8d960c383aefe23f9a65a54a3ffc44abd4c1293e7",
|
|
@@ -15,7 +15,8 @@
|
|
|
15
15
|
"commands/observe-and-act.md": "sha256:02a93bbbfddc3d8e11cb921ddccd19b0666133c4bdb4f4a280bcb131bed37e8c",
|
|
16
16
|
"commands/optimize-page.md": "sha256:35866f3d7cdeef0376ea7a7d7036085a9b9cf95bbb300ecf4bd77610ebd74d85",
|
|
17
17
|
"commands/page-work.md": "sha256:965a66e59bdf7b0da482d26fade53b3d265885ece5d463fe83b0789ebefaef3e",
|
|
18
|
-
"commands/README.md": "sha256:
|
|
18
|
+
"commands/README.md": "sha256:3bf43b11d303ae9d37df1e3ed0e115b0a5e87f0f5bb0fda6e0465fb3f2907ea6",
|
|
19
|
+
"commands/reviews.md": "sha256:902904aaa405fe5724cf0662c7a5a36eab9a4fe0eb81cbd95ffa2fff946e0ac8",
|
|
19
20
|
"commands/validate-render.md": "sha256:a8e1d04d40b84d57c35039250d98c6a7302cd44a148a8c3b9d9cfb92678c4347",
|
|
20
21
|
"policies/crawler-policy-template.md": "sha256:15c88a4eeb21f53f71e5250dd3eb2d2791a814b304eaefce8bb30e2bdf2e2e59",
|
|
21
22
|
"references/aeo-geo-validation.md": "sha256:e45828d3ccca54a08513cb4235578c8a8ecf1dc47d1cb98e4a497838103bef70",
|
|
@@ -61,13 +62,15 @@
|
|
|
61
62
|
"schemas/prompt.schema.json": "sha256:7f0f50c83a86ac91faa7b79895dbc1fed371e8c0342e18d8c2877cc81f4f0f4c",
|
|
62
63
|
"schemas/query.schema.json": "sha256:3c0793a8c0c48ab39320416790840b345ea987696f35b1cc364f23245a62aacb",
|
|
63
64
|
"schemas/remediation-spec.schema.json": "sha256:6fe8cb773702862ba6d261198bb5cc2dca3eca0a2310a60ebddd04377654df8d",
|
|
65
|
+
"schemas/review-item.schema.json": "sha256:df532a70385d5031bbc18654f3ccb436dc6e8d402ccf987e58f8f7e3ad2fb3f1",
|
|
64
66
|
"schemas/review-policy.schema.json": "sha256:b2d176b1886f78c384b25532a0c3eb18548dfbd17f362a305e622bab562a1d04",
|
|
65
67
|
"schemas/reviewer.schema.json": "sha256:3716697b752575a1277f2c2b318b1f2565de02bf9dce2a0c165567ab5330d18b",
|
|
66
68
|
"schemas/run.schema.json": "sha256:46c3178620f3a358d936d535aeadb83454b9b35b551e53e6615cc9862063dacb",
|
|
69
|
+
"schemas/sampling-plan.schema.json": "sha256:005f70f149baaacd7de698548d556d3e401c630978748271b0e14a74726dd413",
|
|
67
70
|
"scripts/README.md": "sha256:1c3e952950ef353849621b07c5f615bf7cd20cc5654da4635492a7bd6384e747",
|
|
68
|
-
"SKILL.md": "sha256:
|
|
71
|
+
"SKILL.md": "sha256:f05761b460e8b9a7cf903efbacf077d860f506e93b76a7cebfc3bd91dbf02a83",
|
|
69
72
|
"templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
|
|
70
|
-
"VERSION": "sha256:
|
|
73
|
+
"VERSION": "sha256:30f4611383aa30a15753789f40effde81332f2f8714e6d3b2940bf0fc4592377"
|
|
71
74
|
},
|
|
72
|
-
"treeHash": "sha256:
|
|
75
|
+
"treeHash": "sha256:b4df089f5eafb1d8844a737f7016bc5f4f7041d1aabf7d65a83f6cee457fae35"
|
|
73
76
|
}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$id":"citable://schemas/review-item.schema.json","$schema":"http://json-schema.org/draft-07/schema#","title":"Semantic review item registry","type":"object","additionalProperties":false,"required":["version","kind","updated","entries"],
|
|
3
|
+
"properties":{"version":{"const":1},"kind":{"const":"review_items"},"updated":{"type":"string","format":"date-time"},"entries":{"type":"array","items":{"type":"object","additionalProperties":false,
|
|
4
|
+
"required":["review_item_id","source_run_id","finding_id","finding_hash","review_type","status","priority_inputs","priority_score","priority_tier","missing_inputs","policy_id","assigned_reviewer_ids","decisions","created_at"],
|
|
5
|
+
"properties":{"review_item_id":{"type":"string","pattern":"^REVIEW-[A-Z0-9][A-Z0-9_-]*$"},"source_run_id":{"type":"string"},"finding_id":{"type":"string"},"finding_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},
|
|
6
|
+
"review_type":{"type":"string","enum":["claim_support","citation_correctness","passage_integrity","narrative_accuracy","recommendation_eligibility","comparison_fairness","intent_alignment","evidence_strength","general_semantic_review"]},
|
|
7
|
+
"status":{"type":"string","enum":["queued","assigned","in_review","adjudication_required","completed","withdrawn"]},
|
|
8
|
+
"priority_inputs":{"type":"object","additionalProperties":false,"required":["business_importance","citation_frequency","evidence_age_days","source_authority","regulatory_exposure","intervention_impact","change_magnitude","disagreement_history"],"properties":{"business_importance":{"type":["integer","null"],"minimum":0,"maximum":5},"citation_frequency":{"type":["integer","null"],"minimum":0},"evidence_age_days":{"type":["integer","null"],"minimum":0},"source_authority":{"type":["integer","null"],"minimum":0,"maximum":5},"regulatory_exposure":{"type":["integer","null"],"minimum":0,"maximum":5},"intervention_impact":{"type":["integer","null"],"minimum":0,"maximum":5},"change_magnitude":{"type":["integer","null"],"minimum":0,"maximum":5},"disagreement_history":{"type":["integer","null"],"minimum":0}}},
|
|
9
|
+
"priority_score":{"type":"number","minimum":0},"priority_tier":{"type":"string","enum":["urgent","high","normal","insufficient_inputs"]},"missing_inputs":{"type":"array","items":{"type":"string"}},"policy_id":{"type":"string","pattern":"^POLICY-"},"assigned_reviewer_ids":{"type":"array","uniqueItems":true,"items":{"type":"string","pattern":"^REVIEWER-"}},
|
|
10
|
+
"decisions":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["reviewer_id","verdict","rubric","evidence_refs","rationale","decided_at","review_item_hash"],"properties":{"reviewer_id":{"type":"string","pattern":"^REVIEWER-"},"verdict":{"type":"string","enum":["supported","partially_supported","unsupported","inconclusive","not_applicable"]},"rubric":{"type":"string"},"evidence_refs":{"type":"array","minItems":1,"items":{"type":"string"}},"rationale":{"type":"string","minLength":1},"decided_at":{"type":"string","format":"date-time"},"review_item_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"}}}},"adjudication":{"type":["object","null"],"additionalProperties":false,"required":["reviewer_id","verdict","evidence_refs","rationale","decided_at","review_item_hash"],"properties":{"reviewer_id":{"type":"string","pattern":"^REVIEWER-"},"verdict":{"type":"string","enum":["supported","partially_supported","unsupported","inconclusive","not_applicable"]},"evidence_refs":{"type":"array","minItems":1,"items":{"type":"string"}},"rationale":{"type":"string","minLength":1},"decided_at":{"type":"string","format":"date-time"},"review_item_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"created_at":{"type":"string","format":"date-time"}
|
|
11
|
+
}}}}
|
|
12
|
+
}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$id":"citable://schemas/sampling-plan.schema.json","$schema":"http://json-schema.org/draft-07/schema#","title":"Semantic review sampling plan registry","type":"object","additionalProperties":false,"required":["version","kind","updated","entries"],
|
|
3
|
+
"properties":{"version":{"const":1},"kind":{"const":"sampling_plans"},"updated":{"type":"string","format":"date-time"},"entries":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["sampling_plan_id","status","method","population_statuses","review_types","sample_size","seed","inclusion_criteria","exclusion_criteria","reviewer_assignment_method","extrapolation_limits","population_hash","selected_item_ids","created_at"],"properties":{"sampling_plan_id":{"type":"string","pattern":"^SAMPLE-[A-Z0-9][A-Z0-9_-]*$"},"status":{"type":"string","enum":["draft","selected","completed"]},"method":{"type":"string","enum":["census","simple_random"]},"population_statuses":{"type":"array","minItems":1,"items":{"type":"string","enum":["queued","assigned","in_review","adjudication_required","completed"]}},"review_types":{"type":"array","items":{"type":"string"}},"sample_size":{"type":"integer","minimum":1},"seed":{"type":"string","minLength":1},"inclusion_criteria":{"type":"array","items":{"type":"string"}},"exclusion_criteria":{"type":"array","items":{"type":"string"}},"reviewer_assignment_method":{"type":"string","minLength":1},"extrapolation_limits":{"type":"array","minItems":1,"items":{"type":"string"}},"population_hash":{"type":["string","null"],"pattern":"^[a-f0-9]{64}$"},"selected_item_ids":{"type":"array","uniqueItems":true,"items":{"type":"string","pattern":"^REVIEW-"}},"created_at":{"type":"string","format":"date-time"}}}}}
|
|
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.9.0
|
|
11
11
|
---
|
|
12
12
|
|
|
13
13
|
# Citable — evidence and change control for search and AI citation readiness
|
|
@@ -110,6 +110,11 @@ citable objectives validate
|
|
|
110
110
|
citable evaluate [objective-id] [--ref-date YYYY-MM-DD]
|
|
111
111
|
citable governance validate [--ref-date YYYY-MM-DD]
|
|
112
112
|
citable governance evaluate <run-id> [--ref-date YYYY-MM-DD]
|
|
113
|
+
citable reviews queue <run-id> <policy-id> [--write]
|
|
114
|
+
citable reviews prioritize [--write]
|
|
115
|
+
citable reviews plan --input <json|yaml> [--write]
|
|
116
|
+
citable reviews sample <sampling-plan-id> [--write]
|
|
117
|
+
citable reviews evaluate
|
|
113
118
|
```
|
|
114
119
|
|
|
115
120
|
Audit scopes: `technical seo aeo geo architecture entity claims evidence schema
|
|
@@ -169,7 +174,7 @@ mandatory.
|
|
|
169
174
|
`.citable/` holds YAML registries for queries, prompts, entities, claims,
|
|
170
175
|
evidence, pages, crawlers, competitors, experiments, metrics, objectives,
|
|
171
176
|
interventions, optional connection state, reviewers, review policies, and
|
|
172
|
-
governed exceptions, all schema-validated
|
|
177
|
+
governed exceptions, semantic review items, and sampling plans, all schema-validated
|
|
173
178
|
(`schemas/*.schema.json`) with referential integrity checks. Rules:
|
|
174
179
|
|
|
175
180
|
- Never overwrite registry content without history — use the loader/saver in
|
|
@@ -1 +1 @@
|
|
|
1
|
-
1.
|
|
1
|
+
1.9.0
|
|
@@ -28,6 +28,7 @@ intent, not executability, so statuses are strict:
|
|
|
28
28
|
| /citable objectives init / validate | implemented — user-owned metric selection, cohorts, windows, and guardrails |
|
|
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
|
+
| /citable reviews queue / prioritize / plan / sample / evaluate | implemented — materiality queues, reproducible sampling, stale-decision checks, and independent disagreement adjudication |
|
|
31
32
|
| /citable ingest, map-site, map-queries, map-prompts, map-entities, map-evidence | specified (ingest.md) |
|
|
32
33
|
| /citable optimize-page | specified (optimize-page.md) — requires source-to-render mapping, claim-preserving rewrites, build execution, rollback; none of that is proven yet |
|
|
33
34
|
| /citable create-page, answer-block, architect, interlink, consolidate, metadata | specified (page-work.md) |
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# Semantic review queues and sampling
|
|
2
|
+
|
|
3
|
+
Use `reviews queue` to create hash-bound review work from heuristic or
|
|
4
|
+
review-required findings. Newly queued items expose all missing materiality
|
|
5
|
+
inputs and remain `insufficient_inputs`; model confidence alone never controls
|
|
6
|
+
priority. After authorized operators supply business importance, citation
|
|
7
|
+
frequency, evidence age and authority, regulatory exposure, intervention
|
|
8
|
+
impact, change magnitude, and disagreement history, use `reviews prioritize`.
|
|
9
|
+
|
|
10
|
+
Sampling plans support only `census` and reproducible `simple_random` methods.
|
|
11
|
+
Every selection records its seed, population hash, inclusion/exclusion criteria,
|
|
12
|
+
assignment method, and extrapolation limits. Do not present sampled review as
|
|
13
|
+
complete validation or generalize beyond the recorded population.
|
|
14
|
+
|
|
15
|
+
`reviews evaluate` rejects stale or unauthorized decisions. Distinct verdicts
|
|
16
|
+
produce `adjudication_required`; vote counting never establishes semantic truth.
|
|
17
|
+
Completion requires an evidence-linked, hash-bound decision from an active
|
|
18
|
+
independent reviewer.
|
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "citable",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.9.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.9.0",
|
|
9
9
|
"variantPath": ".claude/skills/citable",
|
|
10
10
|
"files": {
|
|
11
11
|
"commands/action-findings.md": "sha256:510361461f24fcd4a550e0a8d960c383aefe23f9a65a54a3ffc44abd4c1293e7",
|
|
@@ -15,7 +15,8 @@
|
|
|
15
15
|
"commands/observe-and-act.md": "sha256:02a93bbbfddc3d8e11cb921ddccd19b0666133c4bdb4f4a280bcb131bed37e8c",
|
|
16
16
|
"commands/optimize-page.md": "sha256:35866f3d7cdeef0376ea7a7d7036085a9b9cf95bbb300ecf4bd77610ebd74d85",
|
|
17
17
|
"commands/page-work.md": "sha256:965a66e59bdf7b0da482d26fade53b3d265885ece5d463fe83b0789ebefaef3e",
|
|
18
|
-
"commands/README.md": "sha256:
|
|
18
|
+
"commands/README.md": "sha256:3bf43b11d303ae9d37df1e3ed0e115b0a5e87f0f5bb0fda6e0465fb3f2907ea6",
|
|
19
|
+
"commands/reviews.md": "sha256:902904aaa405fe5724cf0662c7a5a36eab9a4fe0eb81cbd95ffa2fff946e0ac8",
|
|
19
20
|
"commands/validate-render.md": "sha256:a8e1d04d40b84d57c35039250d98c6a7302cd44a148a8c3b9d9cfb92678c4347",
|
|
20
21
|
"policies/crawler-policy-template.md": "sha256:15c88a4eeb21f53f71e5250dd3eb2d2791a814b304eaefce8bb30e2bdf2e2e59",
|
|
21
22
|
"references/aeo-geo-validation.md": "sha256:e45828d3ccca54a08513cb4235578c8a8ecf1dc47d1cb98e4a497838103bef70",
|
|
@@ -61,13 +62,15 @@
|
|
|
61
62
|
"schemas/prompt.schema.json": "sha256:7f0f50c83a86ac91faa7b79895dbc1fed371e8c0342e18d8c2877cc81f4f0f4c",
|
|
62
63
|
"schemas/query.schema.json": "sha256:3c0793a8c0c48ab39320416790840b345ea987696f35b1cc364f23245a62aacb",
|
|
63
64
|
"schemas/remediation-spec.schema.json": "sha256:6fe8cb773702862ba6d261198bb5cc2dca3eca0a2310a60ebddd04377654df8d",
|
|
65
|
+
"schemas/review-item.schema.json": "sha256:df532a70385d5031bbc18654f3ccb436dc6e8d402ccf987e58f8f7e3ad2fb3f1",
|
|
64
66
|
"schemas/review-policy.schema.json": "sha256:b2d176b1886f78c384b25532a0c3eb18548dfbd17f362a305e622bab562a1d04",
|
|
65
67
|
"schemas/reviewer.schema.json": "sha256:3716697b752575a1277f2c2b318b1f2565de02bf9dce2a0c165567ab5330d18b",
|
|
66
68
|
"schemas/run.schema.json": "sha256:46c3178620f3a358d936d535aeadb83454b9b35b551e53e6615cc9862063dacb",
|
|
69
|
+
"schemas/sampling-plan.schema.json": "sha256:005f70f149baaacd7de698548d556d3e401c630978748271b0e14a74726dd413",
|
|
67
70
|
"scripts/README.md": "sha256:1c3e952950ef353849621b07c5f615bf7cd20cc5654da4635492a7bd6384e747",
|
|
68
|
-
"SKILL.md": "sha256:
|
|
71
|
+
"SKILL.md": "sha256:f05761b460e8b9a7cf903efbacf077d860f506e93b76a7cebfc3bd91dbf02a83",
|
|
69
72
|
"templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
|
|
70
|
-
"VERSION": "sha256:
|
|
73
|
+
"VERSION": "sha256:30f4611383aa30a15753789f40effde81332f2f8714e6d3b2940bf0fc4592377"
|
|
71
74
|
},
|
|
72
|
-
"treeHash": "sha256:
|
|
75
|
+
"treeHash": "sha256:b4df089f5eafb1d8844a737f7016bc5f4f7041d1aabf7d65a83f6cee457fae35"
|
|
73
76
|
}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$id":"citable://schemas/review-item.schema.json","$schema":"http://json-schema.org/draft-07/schema#","title":"Semantic review item registry","type":"object","additionalProperties":false,"required":["version","kind","updated","entries"],
|
|
3
|
+
"properties":{"version":{"const":1},"kind":{"const":"review_items"},"updated":{"type":"string","format":"date-time"},"entries":{"type":"array","items":{"type":"object","additionalProperties":false,
|
|
4
|
+
"required":["review_item_id","source_run_id","finding_id","finding_hash","review_type","status","priority_inputs","priority_score","priority_tier","missing_inputs","policy_id","assigned_reviewer_ids","decisions","created_at"],
|
|
5
|
+
"properties":{"review_item_id":{"type":"string","pattern":"^REVIEW-[A-Z0-9][A-Z0-9_-]*$"},"source_run_id":{"type":"string"},"finding_id":{"type":"string"},"finding_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},
|
|
6
|
+
"review_type":{"type":"string","enum":["claim_support","citation_correctness","passage_integrity","narrative_accuracy","recommendation_eligibility","comparison_fairness","intent_alignment","evidence_strength","general_semantic_review"]},
|
|
7
|
+
"status":{"type":"string","enum":["queued","assigned","in_review","adjudication_required","completed","withdrawn"]},
|
|
8
|
+
"priority_inputs":{"type":"object","additionalProperties":false,"required":["business_importance","citation_frequency","evidence_age_days","source_authority","regulatory_exposure","intervention_impact","change_magnitude","disagreement_history"],"properties":{"business_importance":{"type":["integer","null"],"minimum":0,"maximum":5},"citation_frequency":{"type":["integer","null"],"minimum":0},"evidence_age_days":{"type":["integer","null"],"minimum":0},"source_authority":{"type":["integer","null"],"minimum":0,"maximum":5},"regulatory_exposure":{"type":["integer","null"],"minimum":0,"maximum":5},"intervention_impact":{"type":["integer","null"],"minimum":0,"maximum":5},"change_magnitude":{"type":["integer","null"],"minimum":0,"maximum":5},"disagreement_history":{"type":["integer","null"],"minimum":0}}},
|
|
9
|
+
"priority_score":{"type":"number","minimum":0},"priority_tier":{"type":"string","enum":["urgent","high","normal","insufficient_inputs"]},"missing_inputs":{"type":"array","items":{"type":"string"}},"policy_id":{"type":"string","pattern":"^POLICY-"},"assigned_reviewer_ids":{"type":"array","uniqueItems":true,"items":{"type":"string","pattern":"^REVIEWER-"}},
|
|
10
|
+
"decisions":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["reviewer_id","verdict","rubric","evidence_refs","rationale","decided_at","review_item_hash"],"properties":{"reviewer_id":{"type":"string","pattern":"^REVIEWER-"},"verdict":{"type":"string","enum":["supported","partially_supported","unsupported","inconclusive","not_applicable"]},"rubric":{"type":"string"},"evidence_refs":{"type":"array","minItems":1,"items":{"type":"string"}},"rationale":{"type":"string","minLength":1},"decided_at":{"type":"string","format":"date-time"},"review_item_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"}}}},"adjudication":{"type":["object","null"],"additionalProperties":false,"required":["reviewer_id","verdict","evidence_refs","rationale","decided_at","review_item_hash"],"properties":{"reviewer_id":{"type":"string","pattern":"^REVIEWER-"},"verdict":{"type":"string","enum":["supported","partially_supported","unsupported","inconclusive","not_applicable"]},"evidence_refs":{"type":"array","minItems":1,"items":{"type":"string"}},"rationale":{"type":"string","minLength":1},"decided_at":{"type":"string","format":"date-time"},"review_item_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"created_at":{"type":"string","format":"date-time"}
|
|
11
|
+
}}}}
|
|
12
|
+
}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$id":"citable://schemas/sampling-plan.schema.json","$schema":"http://json-schema.org/draft-07/schema#","title":"Semantic review sampling plan registry","type":"object","additionalProperties":false,"required":["version","kind","updated","entries"],
|
|
3
|
+
"properties":{"version":{"const":1},"kind":{"const":"sampling_plans"},"updated":{"type":"string","format":"date-time"},"entries":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["sampling_plan_id","status","method","population_statuses","review_types","sample_size","seed","inclusion_criteria","exclusion_criteria","reviewer_assignment_method","extrapolation_limits","population_hash","selected_item_ids","created_at"],"properties":{"sampling_plan_id":{"type":"string","pattern":"^SAMPLE-[A-Z0-9][A-Z0-9_-]*$"},"status":{"type":"string","enum":["draft","selected","completed"]},"method":{"type":"string","enum":["census","simple_random"]},"population_statuses":{"type":"array","minItems":1,"items":{"type":"string","enum":["queued","assigned","in_review","adjudication_required","completed"]}},"review_types":{"type":"array","items":{"type":"string"}},"sample_size":{"type":"integer","minimum":1},"seed":{"type":"string","minLength":1},"inclusion_criteria":{"type":"array","items":{"type":"string"}},"exclusion_criteria":{"type":"array","items":{"type":"string"}},"reviewer_assignment_method":{"type":"string","minLength":1},"extrapolation_limits":{"type":"array","minItems":1,"items":{"type":"string"}},"population_hash":{"type":["string","null"],"pattern":"^[a-f0-9]{64}$"},"selected_item_ids":{"type":"array","uniqueItems":true,"items":{"type":"string","pattern":"^REVIEW-"}},"created_at":{"type":"string","format":"date-time"}}}}}
|
|
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.9.0
|
|
11
11
|
---
|
|
12
12
|
|
|
13
13
|
# Citable — evidence and change control for search and AI citation readiness
|
|
@@ -110,6 +110,11 @@ citable objectives validate
|
|
|
110
110
|
citable evaluate [objective-id] [--ref-date YYYY-MM-DD]
|
|
111
111
|
citable governance validate [--ref-date YYYY-MM-DD]
|
|
112
112
|
citable governance evaluate <run-id> [--ref-date YYYY-MM-DD]
|
|
113
|
+
citable reviews queue <run-id> <policy-id> [--write]
|
|
114
|
+
citable reviews prioritize [--write]
|
|
115
|
+
citable reviews plan --input <json|yaml> [--write]
|
|
116
|
+
citable reviews sample <sampling-plan-id> [--write]
|
|
117
|
+
citable reviews evaluate
|
|
113
118
|
```
|
|
114
119
|
|
|
115
120
|
Audit scopes: `technical seo aeo geo architecture entity claims evidence schema
|
|
@@ -169,7 +174,7 @@ mandatory.
|
|
|
169
174
|
`.citable/` holds YAML registries for queries, prompts, entities, claims,
|
|
170
175
|
evidence, pages, crawlers, competitors, experiments, metrics, objectives,
|
|
171
176
|
interventions, optional connection state, reviewers, review policies, and
|
|
172
|
-
governed exceptions, all schema-validated
|
|
177
|
+
governed exceptions, semantic review items, and sampling plans, all schema-validated
|
|
173
178
|
(`schemas/*.schema.json`) with referential integrity checks. Rules:
|
|
174
179
|
|
|
175
180
|
- Never overwrite registry content without history — use the loader/saver in
|
|
@@ -1 +1 @@
|
|
|
1
|
-
1.
|
|
1
|
+
1.9.0
|
|
@@ -28,6 +28,7 @@ intent, not executability, so statuses are strict:
|
|
|
28
28
|
| /citable objectives init / validate | implemented — user-owned metric selection, cohorts, windows, and guardrails |
|
|
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
|
+
| /citable reviews queue / prioritize / plan / sample / evaluate | implemented — materiality queues, reproducible sampling, stale-decision checks, and independent disagreement adjudication |
|
|
31
32
|
| /citable ingest, map-site, map-queries, map-prompts, map-entities, map-evidence | specified (ingest.md) |
|
|
32
33
|
| /citable optimize-page | specified (optimize-page.md) — requires source-to-render mapping, claim-preserving rewrites, build execution, rollback; none of that is proven yet |
|
|
33
34
|
| /citable create-page, answer-block, architect, interlink, consolidate, metadata | specified (page-work.md) |
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# Semantic review queues and sampling
|
|
2
|
+
|
|
3
|
+
Use `reviews queue` to create hash-bound review work from heuristic or
|
|
4
|
+
review-required findings. Newly queued items expose all missing materiality
|
|
5
|
+
inputs and remain `insufficient_inputs`; model confidence alone never controls
|
|
6
|
+
priority. After authorized operators supply business importance, citation
|
|
7
|
+
frequency, evidence age and authority, regulatory exposure, intervention
|
|
8
|
+
impact, change magnitude, and disagreement history, use `reviews prioritize`.
|
|
9
|
+
|
|
10
|
+
Sampling plans support only `census` and reproducible `simple_random` methods.
|
|
11
|
+
Every selection records its seed, population hash, inclusion/exclusion criteria,
|
|
12
|
+
assignment method, and extrapolation limits. Do not present sampled review as
|
|
13
|
+
complete validation or generalize beyond the recorded population.
|
|
14
|
+
|
|
15
|
+
`reviews evaluate` rejects stale or unauthorized decisions. Distinct verdicts
|
|
16
|
+
produce `adjudication_required`; vote counting never establishes semantic truth.
|
|
17
|
+
Completion requires an evidence-linked, hash-bound decision from an active
|
|
18
|
+
independent reviewer.
|
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "citable",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.9.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.9.0",
|
|
9
9
|
"variantPath": ".cursor/skills/citable",
|
|
10
10
|
"files": {
|
|
11
11
|
"commands/action-findings.md": "sha256:510361461f24fcd4a550e0a8d960c383aefe23f9a65a54a3ffc44abd4c1293e7",
|
|
@@ -15,7 +15,8 @@
|
|
|
15
15
|
"commands/observe-and-act.md": "sha256:02a93bbbfddc3d8e11cb921ddccd19b0666133c4bdb4f4a280bcb131bed37e8c",
|
|
16
16
|
"commands/optimize-page.md": "sha256:35866f3d7cdeef0376ea7a7d7036085a9b9cf95bbb300ecf4bd77610ebd74d85",
|
|
17
17
|
"commands/page-work.md": "sha256:965a66e59bdf7b0da482d26fade53b3d265885ece5d463fe83b0789ebefaef3e",
|
|
18
|
-
"commands/README.md": "sha256:
|
|
18
|
+
"commands/README.md": "sha256:3bf43b11d303ae9d37df1e3ed0e115b0a5e87f0f5bb0fda6e0465fb3f2907ea6",
|
|
19
|
+
"commands/reviews.md": "sha256:902904aaa405fe5724cf0662c7a5a36eab9a4fe0eb81cbd95ffa2fff946e0ac8",
|
|
19
20
|
"commands/validate-render.md": "sha256:a8e1d04d40b84d57c35039250d98c6a7302cd44a148a8c3b9d9cfb92678c4347",
|
|
20
21
|
"policies/crawler-policy-template.md": "sha256:15c88a4eeb21f53f71e5250dd3eb2d2791a814b304eaefce8bb30e2bdf2e2e59",
|
|
21
22
|
"references/aeo-geo-validation.md": "sha256:e45828d3ccca54a08513cb4235578c8a8ecf1dc47d1cb98e4a497838103bef70",
|
|
@@ -61,13 +62,15 @@
|
|
|
61
62
|
"schemas/prompt.schema.json": "sha256:7f0f50c83a86ac91faa7b79895dbc1fed371e8c0342e18d8c2877cc81f4f0f4c",
|
|
62
63
|
"schemas/query.schema.json": "sha256:3c0793a8c0c48ab39320416790840b345ea987696f35b1cc364f23245a62aacb",
|
|
63
64
|
"schemas/remediation-spec.schema.json": "sha256:6fe8cb773702862ba6d261198bb5cc2dca3eca0a2310a60ebddd04377654df8d",
|
|
65
|
+
"schemas/review-item.schema.json": "sha256:df532a70385d5031bbc18654f3ccb436dc6e8d402ccf987e58f8f7e3ad2fb3f1",
|
|
64
66
|
"schemas/review-policy.schema.json": "sha256:b2d176b1886f78c384b25532a0c3eb18548dfbd17f362a305e622bab562a1d04",
|
|
65
67
|
"schemas/reviewer.schema.json": "sha256:3716697b752575a1277f2c2b318b1f2565de02bf9dce2a0c165567ab5330d18b",
|
|
66
68
|
"schemas/run.schema.json": "sha256:46c3178620f3a358d936d535aeadb83454b9b35b551e53e6615cc9862063dacb",
|
|
69
|
+
"schemas/sampling-plan.schema.json": "sha256:005f70f149baaacd7de698548d556d3e401c630978748271b0e14a74726dd413",
|
|
67
70
|
"scripts/README.md": "sha256:1c3e952950ef353849621b07c5f615bf7cd20cc5654da4635492a7bd6384e747",
|
|
68
|
-
"SKILL.md": "sha256:
|
|
71
|
+
"SKILL.md": "sha256:f05761b460e8b9a7cf903efbacf077d860f506e93b76a7cebfc3bd91dbf02a83",
|
|
69
72
|
"templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
|
|
70
|
-
"VERSION": "sha256:
|
|
73
|
+
"VERSION": "sha256:30f4611383aa30a15753789f40effde81332f2f8714e6d3b2940bf0fc4592377"
|
|
71
74
|
},
|
|
72
|
-
"treeHash": "sha256:
|
|
75
|
+
"treeHash": "sha256:b4df089f5eafb1d8844a737f7016bc5f4f7041d1aabf7d65a83f6cee457fae35"
|
|
73
76
|
}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$id":"citable://schemas/review-item.schema.json","$schema":"http://json-schema.org/draft-07/schema#","title":"Semantic review item registry","type":"object","additionalProperties":false,"required":["version","kind","updated","entries"],
|
|
3
|
+
"properties":{"version":{"const":1},"kind":{"const":"review_items"},"updated":{"type":"string","format":"date-time"},"entries":{"type":"array","items":{"type":"object","additionalProperties":false,
|
|
4
|
+
"required":["review_item_id","source_run_id","finding_id","finding_hash","review_type","status","priority_inputs","priority_score","priority_tier","missing_inputs","policy_id","assigned_reviewer_ids","decisions","created_at"],
|
|
5
|
+
"properties":{"review_item_id":{"type":"string","pattern":"^REVIEW-[A-Z0-9][A-Z0-9_-]*$"},"source_run_id":{"type":"string"},"finding_id":{"type":"string"},"finding_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},
|
|
6
|
+
"review_type":{"type":"string","enum":["claim_support","citation_correctness","passage_integrity","narrative_accuracy","recommendation_eligibility","comparison_fairness","intent_alignment","evidence_strength","general_semantic_review"]},
|
|
7
|
+
"status":{"type":"string","enum":["queued","assigned","in_review","adjudication_required","completed","withdrawn"]},
|
|
8
|
+
"priority_inputs":{"type":"object","additionalProperties":false,"required":["business_importance","citation_frequency","evidence_age_days","source_authority","regulatory_exposure","intervention_impact","change_magnitude","disagreement_history"],"properties":{"business_importance":{"type":["integer","null"],"minimum":0,"maximum":5},"citation_frequency":{"type":["integer","null"],"minimum":0},"evidence_age_days":{"type":["integer","null"],"minimum":0},"source_authority":{"type":["integer","null"],"minimum":0,"maximum":5},"regulatory_exposure":{"type":["integer","null"],"minimum":0,"maximum":5},"intervention_impact":{"type":["integer","null"],"minimum":0,"maximum":5},"change_magnitude":{"type":["integer","null"],"minimum":0,"maximum":5},"disagreement_history":{"type":["integer","null"],"minimum":0}}},
|
|
9
|
+
"priority_score":{"type":"number","minimum":0},"priority_tier":{"type":"string","enum":["urgent","high","normal","insufficient_inputs"]},"missing_inputs":{"type":"array","items":{"type":"string"}},"policy_id":{"type":"string","pattern":"^POLICY-"},"assigned_reviewer_ids":{"type":"array","uniqueItems":true,"items":{"type":"string","pattern":"^REVIEWER-"}},
|
|
10
|
+
"decisions":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["reviewer_id","verdict","rubric","evidence_refs","rationale","decided_at","review_item_hash"],"properties":{"reviewer_id":{"type":"string","pattern":"^REVIEWER-"},"verdict":{"type":"string","enum":["supported","partially_supported","unsupported","inconclusive","not_applicable"]},"rubric":{"type":"string"},"evidence_refs":{"type":"array","minItems":1,"items":{"type":"string"}},"rationale":{"type":"string","minLength":1},"decided_at":{"type":"string","format":"date-time"},"review_item_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"}}}},"adjudication":{"type":["object","null"],"additionalProperties":false,"required":["reviewer_id","verdict","evidence_refs","rationale","decided_at","review_item_hash"],"properties":{"reviewer_id":{"type":"string","pattern":"^REVIEWER-"},"verdict":{"type":"string","enum":["supported","partially_supported","unsupported","inconclusive","not_applicable"]},"evidence_refs":{"type":"array","minItems":1,"items":{"type":"string"}},"rationale":{"type":"string","minLength":1},"decided_at":{"type":"string","format":"date-time"},"review_item_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"}}},"created_at":{"type":"string","format":"date-time"}
|
|
11
|
+
}}}}
|
|
12
|
+
}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$id":"citable://schemas/sampling-plan.schema.json","$schema":"http://json-schema.org/draft-07/schema#","title":"Semantic review sampling plan registry","type":"object","additionalProperties":false,"required":["version","kind","updated","entries"],
|
|
3
|
+
"properties":{"version":{"const":1},"kind":{"const":"sampling_plans"},"updated":{"type":"string","format":"date-time"},"entries":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["sampling_plan_id","status","method","population_statuses","review_types","sample_size","seed","inclusion_criteria","exclusion_criteria","reviewer_assignment_method","extrapolation_limits","population_hash","selected_item_ids","created_at"],"properties":{"sampling_plan_id":{"type":"string","pattern":"^SAMPLE-[A-Z0-9][A-Z0-9_-]*$"},"status":{"type":"string","enum":["draft","selected","completed"]},"method":{"type":"string","enum":["census","simple_random"]},"population_statuses":{"type":"array","minItems":1,"items":{"type":"string","enum":["queued","assigned","in_review","adjudication_required","completed"]}},"review_types":{"type":"array","items":{"type":"string"}},"sample_size":{"type":"integer","minimum":1},"seed":{"type":"string","minLength":1},"inclusion_criteria":{"type":"array","items":{"type":"string"}},"exclusion_criteria":{"type":"array","items":{"type":"string"}},"reviewer_assignment_method":{"type":"string","minLength":1},"extrapolation_limits":{"type":"array","minItems":1,"items":{"type":"string"}},"population_hash":{"type":["string","null"],"pattern":"^[a-f0-9]{64}$"},"selected_item_ids":{"type":"array","uniqueItems":true,"items":{"type":"string","pattern":"^REVIEW-"}},"created_at":{"type":"string","format":"date-time"}}}}}
|
|
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.9.0
|
|
11
11
|
---
|
|
12
12
|
|
|
13
13
|
# Citable — evidence and change control for search and AI citation readiness
|
|
@@ -110,6 +110,11 @@ citable objectives validate
|
|
|
110
110
|
citable evaluate [objective-id] [--ref-date YYYY-MM-DD]
|
|
111
111
|
citable governance validate [--ref-date YYYY-MM-DD]
|
|
112
112
|
citable governance evaluate <run-id> [--ref-date YYYY-MM-DD]
|
|
113
|
+
citable reviews queue <run-id> <policy-id> [--write]
|
|
114
|
+
citable reviews prioritize [--write]
|
|
115
|
+
citable reviews plan --input <json|yaml> [--write]
|
|
116
|
+
citable reviews sample <sampling-plan-id> [--write]
|
|
117
|
+
citable reviews evaluate
|
|
113
118
|
```
|
|
114
119
|
|
|
115
120
|
Audit scopes: `technical seo aeo geo architecture entity claims evidence schema
|
|
@@ -169,7 +174,7 @@ mandatory.
|
|
|
169
174
|
`.citable/` holds YAML registries for queries, prompts, entities, claims,
|
|
170
175
|
evidence, pages, crawlers, competitors, experiments, metrics, objectives,
|
|
171
176
|
interventions, optional connection state, reviewers, review policies, and
|
|
172
|
-
governed exceptions, all schema-validated
|
|
177
|
+
governed exceptions, semantic review items, and sampling plans, all schema-validated
|
|
173
178
|
(`schemas/*.schema.json`) with referential integrity checks. Rules:
|
|
174
179
|
|
|
175
180
|
- Never overwrite registry content without history — use the loader/saver in
|
|
@@ -1 +1 @@
|
|
|
1
|
-
1.
|
|
1
|
+
1.9.0
|
|
@@ -28,6 +28,7 @@ intent, not executability, so statuses are strict:
|
|
|
28
28
|
| /citable objectives init / validate | implemented — user-owned metric selection, cohorts, windows, and guardrails |
|
|
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
|
+
| /citable reviews queue / prioritize / plan / sample / evaluate | implemented — materiality queues, reproducible sampling, stale-decision checks, and independent disagreement adjudication |
|
|
31
32
|
| /citable ingest, map-site, map-queries, map-prompts, map-entities, map-evidence | specified (ingest.md) |
|
|
32
33
|
| /citable optimize-page | specified (optimize-page.md) — requires source-to-render mapping, claim-preserving rewrites, build execution, rollback; none of that is proven yet |
|
|
33
34
|
| /citable create-page, answer-block, architect, interlink, consolidate, metadata | specified (page-work.md) |
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# Semantic review queues and sampling
|
|
2
|
+
|
|
3
|
+
Use `reviews queue` to create hash-bound review work from heuristic or
|
|
4
|
+
review-required findings. Newly queued items expose all missing materiality
|
|
5
|
+
inputs and remain `insufficient_inputs`; model confidence alone never controls
|
|
6
|
+
priority. After authorized operators supply business importance, citation
|
|
7
|
+
frequency, evidence age and authority, regulatory exposure, intervention
|
|
8
|
+
impact, change magnitude, and disagreement history, use `reviews prioritize`.
|
|
9
|
+
|
|
10
|
+
Sampling plans support only `census` and reproducible `simple_random` methods.
|
|
11
|
+
Every selection records its seed, population hash, inclusion/exclusion criteria,
|
|
12
|
+
assignment method, and extrapolation limits. Do not present sampled review as
|
|
13
|
+
complete validation or generalize beyond the recorded population.
|
|
14
|
+
|
|
15
|
+
`reviews evaluate` rejects stale or unauthorized decisions. Distinct verdicts
|
|
16
|
+
produce `adjudication_required`; vote counting never establishes semantic truth.
|
|
17
|
+
Completion requires an evidence-linked, hash-bound decision from an active
|
|
18
|
+
independent reviewer.
|
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "citable",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.9.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.9.0",
|
|
9
9
|
"variantPath": ".gemini/skills/citable",
|
|
10
10
|
"files": {
|
|
11
11
|
"commands/action-findings.md": "sha256:510361461f24fcd4a550e0a8d960c383aefe23f9a65a54a3ffc44abd4c1293e7",
|
|
@@ -15,7 +15,8 @@
|
|
|
15
15
|
"commands/observe-and-act.md": "sha256:02a93bbbfddc3d8e11cb921ddccd19b0666133c4bdb4f4a280bcb131bed37e8c",
|
|
16
16
|
"commands/optimize-page.md": "sha256:35866f3d7cdeef0376ea7a7d7036085a9b9cf95bbb300ecf4bd77610ebd74d85",
|
|
17
17
|
"commands/page-work.md": "sha256:965a66e59bdf7b0da482d26fade53b3d265885ece5d463fe83b0789ebefaef3e",
|
|
18
|
-
"commands/README.md": "sha256:
|
|
18
|
+
"commands/README.md": "sha256:3bf43b11d303ae9d37df1e3ed0e115b0a5e87f0f5bb0fda6e0465fb3f2907ea6",
|
|
19
|
+
"commands/reviews.md": "sha256:902904aaa405fe5724cf0662c7a5a36eab9a4fe0eb81cbd95ffa2fff946e0ac8",
|
|
19
20
|
"commands/validate-render.md": "sha256:a8e1d04d40b84d57c35039250d98c6a7302cd44a148a8c3b9d9cfb92678c4347",
|
|
20
21
|
"policies/crawler-policy-template.md": "sha256:15c88a4eeb21f53f71e5250dd3eb2d2791a814b304eaefce8bb30e2bdf2e2e59",
|
|
21
22
|
"references/aeo-geo-validation.md": "sha256:e45828d3ccca54a08513cb4235578c8a8ecf1dc47d1cb98e4a497838103bef70",
|
|
@@ -61,13 +62,15 @@
|
|
|
61
62
|
"schemas/prompt.schema.json": "sha256:7f0f50c83a86ac91faa7b79895dbc1fed371e8c0342e18d8c2877cc81f4f0f4c",
|
|
62
63
|
"schemas/query.schema.json": "sha256:3c0793a8c0c48ab39320416790840b345ea987696f35b1cc364f23245a62aacb",
|
|
63
64
|
"schemas/remediation-spec.schema.json": "sha256:6fe8cb773702862ba6d261198bb5cc2dca3eca0a2310a60ebddd04377654df8d",
|
|
65
|
+
"schemas/review-item.schema.json": "sha256:df532a70385d5031bbc18654f3ccb436dc6e8d402ccf987e58f8f7e3ad2fb3f1",
|
|
64
66
|
"schemas/review-policy.schema.json": "sha256:b2d176b1886f78c384b25532a0c3eb18548dfbd17f362a305e622bab562a1d04",
|
|
65
67
|
"schemas/reviewer.schema.json": "sha256:3716697b752575a1277f2c2b318b1f2565de02bf9dce2a0c165567ab5330d18b",
|
|
66
68
|
"schemas/run.schema.json": "sha256:46c3178620f3a358d936d535aeadb83454b9b35b551e53e6615cc9862063dacb",
|
|
69
|
+
"schemas/sampling-plan.schema.json": "sha256:005f70f149baaacd7de698548d556d3e401c630978748271b0e14a74726dd413",
|
|
67
70
|
"scripts/README.md": "sha256:1c3e952950ef353849621b07c5f615bf7cd20cc5654da4635492a7bd6384e747",
|
|
68
|
-
"SKILL.md": "sha256:
|
|
71
|
+
"SKILL.md": "sha256:f05761b460e8b9a7cf903efbacf077d860f506e93b76a7cebfc3bd91dbf02a83",
|
|
69
72
|
"templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
|
|
70
|
-
"VERSION": "sha256:
|
|
73
|
+
"VERSION": "sha256:30f4611383aa30a15753789f40effde81332f2f8714e6d3b2940bf0fc4592377"
|
|
71
74
|
},
|
|
72
|
-
"treeHash": "sha256:
|
|
75
|
+
"treeHash": "sha256:b4df089f5eafb1d8844a737f7016bc5f4f7041d1aabf7d65a83f6cee457fae35"
|
|
73
76
|
}
|