CITATION
CITATION
SERVICE CONTRACT · VIEW: GOV
Constraints
MUST: Centralize all citation definitions in BIBLIOGRAPHY.md (one authored source, all surfaces)
MUST: Compile BIBLIOGRAPHY.md into REGISTRY.json at build time (machine-readable, _generated)
MUST: Validate every [X-n], [I-n], [P-n], [B-n], [W-n], [G-n] reference across all writing surfaces
MUST: Track freshness tier per citation (STABLE, ANNUAL, QUARTERLY, EPHEMERAL)
MUST: Detect value drift (inline numeric claim vs bibliography value)
MUST: Fail build on unresolved citations (referenced in surface, not in bibliography)
MUST: Fail build on namespace collisions (same code, different sources, different documents)
MUST: Generate per-document reference sections as compiled subsets of bibliography
MUST: Resolve citations to sources on every surface — WEB (hyperlink), TEX (bibliography entry), PDF (endnote or reference section)
MUST: Compile citation references into clickable links on WEB surfaces ([X-1] → anchor to reference section with source URL)
MUST: Compile citation references into LaTeX bibliography entries on TEX/PDF surfaces (no raw [X-1] in output)
MUST: Resolve Sources table URLs into inline links on first mention in prose (BLOGS, PAPERS)
MUST: Inline link resolution is compiler-generated from Sources table — not hand-authored
MUST: Every surface that renders governed prose MUST pass through CITATION validation before publish
MUST NOT: Allow per-document reference tables to be hand-edited (compiled, not authored)
MUST NOT: Publish stale citations past expiry without explicit override
MUST NOT: Duplicate citation definitions across documents (one entry per source, globally unique)
MUST NOT: Hardcode citation mappings (discover via bibliography scan)
MUST NOT: Pass raw citation codes ([X-n], [W-n], etc.) through to any rendered surface — resolve or fail
Capabilities
BIBLIOGRAPHY_COMPILE, REGISTRY_EMIT, CITATION_VALIDATE, VALUE_DRIFT_DETECT, FRESHNESS_TRACK, SURFACE_GATE
TASK Contract
| Field | Value |
|---|---|
| task | CITATIONS |
| schedule | 0 10 * * 1 |
| scope | SERVICES/CITATION/BIBLIOGRAPHY.md |
| write | SERVICES/TASK/_data/CITATIONS.json |
| model | claude-haiku-4-5 |
Prompt
You are the CITATION FRESHNESS agent. Read SERVICES/CITATION/CANON.md first.
- Read SERVICES/CITATION/BIBLIOGRAPHY.md
- Extract every URL, grouped by reference code (X-6, X-7, I-1, G-1, etc.)
- curl -sI each unique URL. Record HTTP status. Max 1 URL per second.
- Write results to SERVICES/TASK/_data/CITATIONS.json with _generated marker.
- Flag any broken URLs with the reference code and source name.
- Commit if any changes from previous run.
| Print summary: total citations | URLs checked | healthy | broken | list of broken with reference codes. |
| *CITATION | CANON | SERVICES* |
CITATION · SERVICE CONTRACT · CANONIC ∩