@nebulacomponents/citable 1.8.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 +20 -0
- package/README.md +9 -2
- package/dist/universal/.agents/skills/citable/SKILL.md +10 -2
- package/dist/universal/.agents/skills/citable/VERSION +1 -1
- package/dist/universal/.agents/skills/citable/commands/README.md +2 -0
- package/dist/universal/.agents/skills/citable/commands/delivery.md +18 -0
- package/dist/universal/.agents/skills/citable/commands/reviews.md +18 -0
- package/dist/universal/.agents/skills/citable/manifest.json +11 -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/.agents/skills/citable/schemas/schedule.schema.json +4 -0
- package/dist/universal/.claude/skills/citable/SKILL.md +10 -2
- package/dist/universal/.claude/skills/citable/VERSION +1 -1
- package/dist/universal/.claude/skills/citable/commands/README.md +2 -0
- package/dist/universal/.claude/skills/citable/commands/delivery.md +18 -0
- package/dist/universal/.claude/skills/citable/commands/reviews.md +18 -0
- package/dist/universal/.claude/skills/citable/manifest.json +11 -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/.claude/skills/citable/schemas/schedule.schema.json +4 -0
- package/dist/universal/.cursor/skills/citable/SKILL.md +10 -2
- package/dist/universal/.cursor/skills/citable/VERSION +1 -1
- package/dist/universal/.cursor/skills/citable/commands/README.md +2 -0
- package/dist/universal/.cursor/skills/citable/commands/delivery.md +18 -0
- package/dist/universal/.cursor/skills/citable/commands/reviews.md +18 -0
- package/dist/universal/.cursor/skills/citable/manifest.json +11 -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/.cursor/skills/citable/schemas/schedule.schema.json +4 -0
- package/dist/universal/.gemini/skills/citable/SKILL.md +10 -2
- package/dist/universal/.gemini/skills/citable/VERSION +1 -1
- package/dist/universal/.gemini/skills/citable/commands/README.md +2 -0
- package/dist/universal/.gemini/skills/citable/commands/delivery.md +18 -0
- package/dist/universal/.gemini/skills/citable/commands/reviews.md +18 -0
- package/dist/universal/.gemini/skills/citable/manifest.json +11 -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/.gemini/skills/citable/schemas/schedule.schema.json +4 -0
- package/dist/universal/.github/skills/citable/SKILL.md +10 -2
- package/dist/universal/.github/skills/citable/VERSION +1 -1
- package/dist/universal/.github/skills/citable/commands/README.md +2 -0
- package/dist/universal/.github/skills/citable/commands/delivery.md +18 -0
- package/dist/universal/.github/skills/citable/commands/reviews.md +18 -0
- package/dist/universal/.github/skills/citable/manifest.json +11 -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/.github/skills/citable/schemas/schedule.schema.json +4 -0
- package/dist/universal/.kiro/skills/citable/SKILL.md +10 -2
- package/dist/universal/.kiro/skills/citable/VERSION +1 -1
- package/dist/universal/.kiro/skills/citable/commands/README.md +2 -0
- package/dist/universal/.kiro/skills/citable/commands/delivery.md +18 -0
- package/dist/universal/.kiro/skills/citable/commands/reviews.md +18 -0
- package/dist/universal/.kiro/skills/citable/manifest.json +11 -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/.kiro/skills/citable/schemas/schedule.schema.json +4 -0
- package/dist/universal/.opencode/skills/citable/SKILL.md +10 -2
- package/dist/universal/.opencode/skills/citable/VERSION +1 -1
- package/dist/universal/.opencode/skills/citable/commands/README.md +2 -0
- package/dist/universal/.opencode/skills/citable/commands/delivery.md +18 -0
- package/dist/universal/.opencode/skills/citable/commands/reviews.md +18 -0
- package/dist/universal/.opencode/skills/citable/manifest.json +11 -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/.opencode/skills/citable/schemas/schedule.schema.json +4 -0
- package/dist/universal/.pi/agent/skills/citable/SKILL.md +10 -2
- package/dist/universal/.pi/agent/skills/citable/VERSION +1 -1
- package/dist/universal/.pi/agent/skills/citable/commands/README.md +2 -0
- package/dist/universal/.pi/agent/skills/citable/commands/delivery.md +18 -0
- package/dist/universal/.pi/agent/skills/citable/commands/reviews.md +18 -0
- package/dist/universal/.pi/agent/skills/citable/manifest.json +11 -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/.pi/agent/skills/citable/schemas/schedule.schema.json +4 -0
- package/dist/universal/.qoder/skills/citable/SKILL.md +10 -2
- package/dist/universal/.qoder/skills/citable/VERSION +1 -1
- package/dist/universal/.qoder/skills/citable/commands/README.md +2 -0
- package/dist/universal/.qoder/skills/citable/commands/delivery.md +18 -0
- package/dist/universal/.qoder/skills/citable/commands/reviews.md +18 -0
- package/dist/universal/.qoder/skills/citable/manifest.json +11 -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/.qoder/skills/citable/schemas/schedule.schema.json +4 -0
- package/dist/universal/.rovodev/skills/citable/SKILL.md +10 -2
- package/dist/universal/.rovodev/skills/citable/VERSION +1 -1
- package/dist/universal/.rovodev/skills/citable/commands/README.md +2 -0
- package/dist/universal/.rovodev/skills/citable/commands/delivery.md +18 -0
- package/dist/universal/.rovodev/skills/citable/commands/reviews.md +18 -0
- package/dist/universal/.rovodev/skills/citable/manifest.json +11 -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/.rovodev/skills/citable/schemas/schedule.schema.json +4 -0
- package/dist/universal/.trae/skills/citable/SKILL.md +10 -2
- package/dist/universal/.trae/skills/citable/VERSION +1 -1
- package/dist/universal/.trae/skills/citable/commands/README.md +2 -0
- package/dist/universal/.trae/skills/citable/commands/delivery.md +18 -0
- package/dist/universal/.trae/skills/citable/commands/reviews.md +18 -0
- package/dist/universal/.trae/skills/citable/manifest.json +11 -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/skills/citable/schemas/schedule.schema.json +4 -0
- package/dist/universal/.trae-cn/skills/citable/SKILL.md +10 -2
- package/dist/universal/.trae-cn/skills/citable/VERSION +1 -1
- package/dist/universal/.trae-cn/skills/citable/commands/README.md +2 -0
- package/dist/universal/.trae-cn/skills/citable/commands/delivery.md +18 -0
- package/dist/universal/.trae-cn/skills/citable/commands/reviews.md +18 -0
- package/dist/universal/.trae-cn/skills/citable/manifest.json +11 -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/.trae-cn/skills/citable/schemas/schedule.schema.json +4 -0
- package/dist/universal/manifest.json +135 -75
- package/package.json +1 -1
- package/schemas/review-item.schema.json +12 -0
- package/schemas/sampling-plan.schema.json +4 -0
- package/schemas/schedule.schema.json +4 -0
- package/skill/SKILL.md +10 -2
- package/skill/commands/README.md +2 -0
- package/skill/commands/delivery.md +18 -0
- package/skill/commands/reviews.md +18 -0
- package/src/cli/index.js +32 -0
- package/src/commands/compareSnapshots.js +15 -0
- package/src/commands/delivery.js +50 -0
- package/src/commands/reviews.js +73 -0
- package/src/registries/index.js +10 -0
|
@@ -28,6 +28,8 @@ 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 |
|
|
32
|
+
| /citable schedules run / project github | implemented — canonical scheduled audits and hash-bound non-authoritative GitHub projections |
|
|
31
33
|
| /citable ingest, map-site, map-queries, map-prompts, map-entities, map-evidence | specified (ingest.md) |
|
|
32
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 |
|
|
33
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.
|
|
@@ -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,21 +1,23 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "citable",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.10.0",
|
|
4
4
|
"managedBy": "citable-cli",
|
|
5
5
|
"provider": "opencode",
|
|
6
6
|
"providerName": "OpenCode",
|
|
7
7
|
"scope": "bundle",
|
|
8
|
-
"sourcePackage": "@nebulacomponents/citable@1.
|
|
8
|
+
"sourcePackage": "@nebulacomponents/citable@1.10.0",
|
|
9
9
|
"variantPath": ".opencode/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",
|
|
20
|
+
"commands/reviews.md": "sha256:902904aaa405fe5724cf0662c7a5a36eab9a4fe0eb81cbd95ffa2fff946e0ac8",
|
|
19
21
|
"commands/validate-render.md": "sha256:a8e1d04d40b84d57c35039250d98c6a7302cd44a148a8c3b9d9cfb92678c4347",
|
|
20
22
|
"policies/crawler-policy-template.md": "sha256:15c88a4eeb21f53f71e5250dd3eb2d2791a814b304eaefce8bb30e2bdf2e2e59",
|
|
21
23
|
"references/aeo-geo-validation.md": "sha256:e45828d3ccca54a08513cb4235578c8a8ecf1dc47d1cb98e4a497838103bef70",
|
|
@@ -61,13 +63,16 @@
|
|
|
61
63
|
"schemas/prompt.schema.json": "sha256:7f0f50c83a86ac91faa7b79895dbc1fed371e8c0342e18d8c2877cc81f4f0f4c",
|
|
62
64
|
"schemas/query.schema.json": "sha256:3c0793a8c0c48ab39320416790840b345ea987696f35b1cc364f23245a62aacb",
|
|
63
65
|
"schemas/remediation-spec.schema.json": "sha256:6fe8cb773702862ba6d261198bb5cc2dca3eca0a2310a60ebddd04377654df8d",
|
|
66
|
+
"schemas/review-item.schema.json": "sha256:df532a70385d5031bbc18654f3ccb436dc6e8d402ccf987e58f8f7e3ad2fb3f1",
|
|
64
67
|
"schemas/review-policy.schema.json": "sha256:b2d176b1886f78c384b25532a0c3eb18548dfbd17f362a305e622bab562a1d04",
|
|
65
68
|
"schemas/reviewer.schema.json": "sha256:3716697b752575a1277f2c2b318b1f2565de02bf9dce2a0c165567ab5330d18b",
|
|
66
69
|
"schemas/run.schema.json": "sha256:46c3178620f3a358d936d535aeadb83454b9b35b551e53e6615cc9862063dacb",
|
|
70
|
+
"schemas/sampling-plan.schema.json": "sha256:005f70f149baaacd7de698548d556d3e401c630978748271b0e14a74726dd413",
|
|
71
|
+
"schemas/schedule.schema.json": "sha256:0f02174ab0fc7bbbce9759fd358b18ed97cc683c76933fd3001cf053c499b157",
|
|
67
72
|
"scripts/README.md": "sha256:1c3e952950ef353849621b07c5f615bf7cd20cc5654da4635492a7bd6384e747",
|
|
68
|
-
"SKILL.md": "sha256:
|
|
73
|
+
"SKILL.md": "sha256:95336d8e690b54f72de14020a35d87d41fcaa1080a6242d821ff3df4efdf0ab6",
|
|
69
74
|
"templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
|
|
70
|
-
"VERSION": "sha256:
|
|
75
|
+
"VERSION": "sha256:4f5ba6a3e380bf810cc968b58d30a8d7163eafe9e2fb1ad19bdc6d9d64a1e549"
|
|
71
76
|
},
|
|
72
|
-
"treeHash": "sha256:
|
|
77
|
+
"treeHash": "sha256:81a5e1f3bf7560060b3f950c18804d5481b1230ab9e0b81d3ce16d0b97e43893"
|
|
73
78
|
}
|
|
@@ -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
|
+
}
|
|
@@ -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
|
|
@@ -110,6 +110,13 @@ 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
|
|
118
|
+
citable schedules run <schedule-id> [--ref-date YYYY-MM-DD]
|
|
119
|
+
citable project github <run-id>
|
|
113
120
|
```
|
|
114
121
|
|
|
115
122
|
Audit scopes: `technical seo aeo geo architecture entity claims evidence schema
|
|
@@ -169,7 +176,8 @@ mandatory.
|
|
|
169
176
|
`.citable/` holds YAML registries for queries, prompts, entities, claims,
|
|
170
177
|
evidence, pages, crawlers, competitors, experiments, metrics, objectives,
|
|
171
178
|
interventions, optional connection state, reviewers, review policies, and
|
|
172
|
-
governed exceptions,
|
|
179
|
+
governed exceptions, semantic review items, sampling plans, and audit schedules,
|
|
180
|
+
all schema-validated
|
|
173
181
|
(`schemas/*.schema.json`) with referential integrity checks. Rules:
|
|
174
182
|
|
|
175
183
|
- Never overwrite registry content without history — use the loader/saver in
|
|
@@ -1 +1 @@
|
|
|
1
|
-
1.
|
|
1
|
+
1.10.0
|
|
@@ -28,6 +28,8 @@ 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 |
|
|
32
|
+
| /citable schedules run / project github | implemented — canonical scheduled audits and hash-bound non-authoritative GitHub projections |
|
|
31
33
|
| /citable ingest, map-site, map-queries, map-prompts, map-entities, map-evidence | specified (ingest.md) |
|
|
32
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 |
|
|
33
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.
|
|
@@ -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,21 +1,23 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "citable",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.10.0",
|
|
4
4
|
"managedBy": "citable-cli",
|
|
5
5
|
"provider": "pi",
|
|
6
6
|
"providerName": "Pi",
|
|
7
7
|
"scope": "bundle",
|
|
8
|
-
"sourcePackage": "@nebulacomponents/citable@1.
|
|
8
|
+
"sourcePackage": "@nebulacomponents/citable@1.10.0",
|
|
9
9
|
"variantPath": ".pi/agent/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",
|
|
20
|
+
"commands/reviews.md": "sha256:902904aaa405fe5724cf0662c7a5a36eab9a4fe0eb81cbd95ffa2fff946e0ac8",
|
|
19
21
|
"commands/validate-render.md": "sha256:a8e1d04d40b84d57c35039250d98c6a7302cd44a148a8c3b9d9cfb92678c4347",
|
|
20
22
|
"policies/crawler-policy-template.md": "sha256:15c88a4eeb21f53f71e5250dd3eb2d2791a814b304eaefce8bb30e2bdf2e2e59",
|
|
21
23
|
"references/aeo-geo-validation.md": "sha256:e45828d3ccca54a08513cb4235578c8a8ecf1dc47d1cb98e4a497838103bef70",
|
|
@@ -61,13 +63,16 @@
|
|
|
61
63
|
"schemas/prompt.schema.json": "sha256:7f0f50c83a86ac91faa7b79895dbc1fed371e8c0342e18d8c2877cc81f4f0f4c",
|
|
62
64
|
"schemas/query.schema.json": "sha256:3c0793a8c0c48ab39320416790840b345ea987696f35b1cc364f23245a62aacb",
|
|
63
65
|
"schemas/remediation-spec.schema.json": "sha256:6fe8cb773702862ba6d261198bb5cc2dca3eca0a2310a60ebddd04377654df8d",
|
|
66
|
+
"schemas/review-item.schema.json": "sha256:df532a70385d5031bbc18654f3ccb436dc6e8d402ccf987e58f8f7e3ad2fb3f1",
|
|
64
67
|
"schemas/review-policy.schema.json": "sha256:b2d176b1886f78c384b25532a0c3eb18548dfbd17f362a305e622bab562a1d04",
|
|
65
68
|
"schemas/reviewer.schema.json": "sha256:3716697b752575a1277f2c2b318b1f2565de02bf9dce2a0c165567ab5330d18b",
|
|
66
69
|
"schemas/run.schema.json": "sha256:46c3178620f3a358d936d535aeadb83454b9b35b551e53e6615cc9862063dacb",
|
|
70
|
+
"schemas/sampling-plan.schema.json": "sha256:005f70f149baaacd7de698548d556d3e401c630978748271b0e14a74726dd413",
|
|
71
|
+
"schemas/schedule.schema.json": "sha256:0f02174ab0fc7bbbce9759fd358b18ed97cc683c76933fd3001cf053c499b157",
|
|
67
72
|
"scripts/README.md": "sha256:1c3e952950ef353849621b07c5f615bf7cd20cc5654da4635492a7bd6384e747",
|
|
68
|
-
"SKILL.md": "sha256:
|
|
73
|
+
"SKILL.md": "sha256:95336d8e690b54f72de14020a35d87d41fcaa1080a6242d821ff3df4efdf0ab6",
|
|
69
74
|
"templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
|
|
70
|
-
"VERSION": "sha256:
|
|
75
|
+
"VERSION": "sha256:4f5ba6a3e380bf810cc968b58d30a8d7163eafe9e2fb1ad19bdc6d9d64a1e549"
|
|
71
76
|
},
|
|
72
|
-
"treeHash": "sha256:
|
|
77
|
+
"treeHash": "sha256:81a5e1f3bf7560060b3f950c18804d5481b1230ab9e0b81d3ce16d0b97e43893"
|
|
73
78
|
}
|
|
@@ -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
|
+
}
|
|
@@ -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
|
|
@@ -110,6 +110,13 @@ 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
|
|
118
|
+
citable schedules run <schedule-id> [--ref-date YYYY-MM-DD]
|
|
119
|
+
citable project github <run-id>
|
|
113
120
|
```
|
|
114
121
|
|
|
115
122
|
Audit scopes: `technical seo aeo geo architecture entity claims evidence schema
|
|
@@ -169,7 +176,8 @@ mandatory.
|
|
|
169
176
|
`.citable/` holds YAML registries for queries, prompts, entities, claims,
|
|
170
177
|
evidence, pages, crawlers, competitors, experiments, metrics, objectives,
|
|
171
178
|
interventions, optional connection state, reviewers, review policies, and
|
|
172
|
-
governed exceptions,
|
|
179
|
+
governed exceptions, semantic review items, sampling plans, and audit schedules,
|
|
180
|
+
all schema-validated
|
|
173
181
|
(`schemas/*.schema.json`) with referential integrity checks. Rules:
|
|
174
182
|
|
|
175
183
|
- Never overwrite registry content without history — use the loader/saver in
|
|
@@ -1 +1 @@
|
|
|
1
|
-
1.
|
|
1
|
+
1.10.0
|
|
@@ -28,6 +28,8 @@ 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 |
|
|
32
|
+
| /citable schedules run / project github | implemented — canonical scheduled audits and hash-bound non-authoritative GitHub projections |
|
|
31
33
|
| /citable ingest, map-site, map-queries, map-prompts, map-entities, map-evidence | specified (ingest.md) |
|
|
32
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 |
|
|
33
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.
|
|
@@ -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,21 +1,23 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "citable",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.10.0",
|
|
4
4
|
"managedBy": "citable-cli",
|
|
5
5
|
"provider": "qoder",
|
|
6
6
|
"providerName": "Qoder",
|
|
7
7
|
"scope": "bundle",
|
|
8
|
-
"sourcePackage": "@nebulacomponents/citable@1.
|
|
8
|
+
"sourcePackage": "@nebulacomponents/citable@1.10.0",
|
|
9
9
|
"variantPath": ".qoder/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",
|
|
20
|
+
"commands/reviews.md": "sha256:902904aaa405fe5724cf0662c7a5a36eab9a4fe0eb81cbd95ffa2fff946e0ac8",
|
|
19
21
|
"commands/validate-render.md": "sha256:a8e1d04d40b84d57c35039250d98c6a7302cd44a148a8c3b9d9cfb92678c4347",
|
|
20
22
|
"policies/crawler-policy-template.md": "sha256:15c88a4eeb21f53f71e5250dd3eb2d2791a814b304eaefce8bb30e2bdf2e2e59",
|
|
21
23
|
"references/aeo-geo-validation.md": "sha256:e45828d3ccca54a08513cb4235578c8a8ecf1dc47d1cb98e4a497838103bef70",
|
|
@@ -61,13 +63,16 @@
|
|
|
61
63
|
"schemas/prompt.schema.json": "sha256:7f0f50c83a86ac91faa7b79895dbc1fed371e8c0342e18d8c2877cc81f4f0f4c",
|
|
62
64
|
"schemas/query.schema.json": "sha256:3c0793a8c0c48ab39320416790840b345ea987696f35b1cc364f23245a62aacb",
|
|
63
65
|
"schemas/remediation-spec.schema.json": "sha256:6fe8cb773702862ba6d261198bb5cc2dca3eca0a2310a60ebddd04377654df8d",
|
|
66
|
+
"schemas/review-item.schema.json": "sha256:df532a70385d5031bbc18654f3ccb436dc6e8d402ccf987e58f8f7e3ad2fb3f1",
|
|
64
67
|
"schemas/review-policy.schema.json": "sha256:b2d176b1886f78c384b25532a0c3eb18548dfbd17f362a305e622bab562a1d04",
|
|
65
68
|
"schemas/reviewer.schema.json": "sha256:3716697b752575a1277f2c2b318b1f2565de02bf9dce2a0c165567ab5330d18b",
|
|
66
69
|
"schemas/run.schema.json": "sha256:46c3178620f3a358d936d535aeadb83454b9b35b551e53e6615cc9862063dacb",
|
|
70
|
+
"schemas/sampling-plan.schema.json": "sha256:005f70f149baaacd7de698548d556d3e401c630978748271b0e14a74726dd413",
|
|
71
|
+
"schemas/schedule.schema.json": "sha256:0f02174ab0fc7bbbce9759fd358b18ed97cc683c76933fd3001cf053c499b157",
|
|
67
72
|
"scripts/README.md": "sha256:1c3e952950ef353849621b07c5f615bf7cd20cc5654da4635492a7bd6384e747",
|
|
68
|
-
"SKILL.md": "sha256:
|
|
73
|
+
"SKILL.md": "sha256:95336d8e690b54f72de14020a35d87d41fcaa1080a6242d821ff3df4efdf0ab6",
|
|
69
74
|
"templates/finding-review.md": "sha256:b270a83d3f015150aac80249ae9314979c0befea39ff92ec455f9a5aaa73404c",
|
|
70
|
-
"VERSION": "sha256:
|
|
75
|
+
"VERSION": "sha256:4f5ba6a3e380bf810cc968b58d30a8d7163eafe9e2fb1ad19bdc6d9d64a1e549"
|
|
71
76
|
},
|
|
72
|
-
"treeHash": "sha256:
|
|
77
|
+
"treeHash": "sha256:81a5e1f3bf7560060b3f950c18804d5481b1230ab9e0b81d3ce16d0b97e43893"
|
|
73
78
|
}
|
|
@@ -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
|
+
}
|
|
@@ -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
|
|
@@ -110,6 +110,13 @@ 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
|
|
118
|
+
citable schedules run <schedule-id> [--ref-date YYYY-MM-DD]
|
|
119
|
+
citable project github <run-id>
|
|
113
120
|
```
|
|
114
121
|
|
|
115
122
|
Audit scopes: `technical seo aeo geo architecture entity claims evidence schema
|
|
@@ -169,7 +176,8 @@ mandatory.
|
|
|
169
176
|
`.citable/` holds YAML registries for queries, prompts, entities, claims,
|
|
170
177
|
evidence, pages, crawlers, competitors, experiments, metrics, objectives,
|
|
171
178
|
interventions, optional connection state, reviewers, review policies, and
|
|
172
|
-
governed exceptions,
|
|
179
|
+
governed exceptions, semantic review items, sampling plans, and audit schedules,
|
|
180
|
+
all schema-validated
|
|
173
181
|
(`schemas/*.schema.json`) with referential integrity checks. Rules:
|
|
174
182
|
|
|
175
183
|
- Never overwrite registry content without history — use the loader/saver in
|
|
@@ -1 +1 @@
|
|
|
1
|
-
1.
|
|
1
|
+
1.10.0
|
|
@@ -28,6 +28,8 @@ 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 |
|
|
32
|
+
| /citable schedules run / project github | implemented — canonical scheduled audits and hash-bound non-authoritative GitHub projections |
|
|
31
33
|
| /citable ingest, map-site, map-queries, map-prompts, map-entities, map-evidence | specified (ingest.md) |
|
|
32
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 |
|
|
33
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.
|
|
@@ -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.
|