{ "schema_version": "anchorfact.coverage.v1", "generated": "2026-06-03T02:21:45.252Z", "provenance_url": "https://anchorfact.org/provenance.json", "name": "AnchorFact AI coverage and limits", "purpose": "Help AI agents decide whether AnchorFact is a suitable source for a query before retrieving or citing claims.", "coverage_summary": { "public_articles": 1210, "draft_articles": 300, "public_claims": 3790, "topics": 11, "unique_sources": 2994, "confidence_distribution": { "high": 28, "medium": 1137, "low": 45 }, "source_verification": { "full": 1210, "partial": 0, "none": 0, "full_ratio": 1 }, "source_tier_distribution": { "A": 661, "S": 426, "B": 1880, "C": 27 }, "top_source_types": [ { "type": "documentation", "count": 1315 }, { "type": "academic_paper", "count": 497 }, { "type": "standard", "count": 173 }, { "type": "reference", "count": 92 }, { "type": "book", "count": 74 }, { "type": "government_report", "count": 70 }, { "type": "conference_paper", "count": 66 }, { "type": "technical_documentation", "count": 55 }, { "type": "journal_article", "count": 46 }, { "type": "course_material", "count": 36 }, { "type": "encyclopedia", "count": 36 }, { "type": "rfc", "count": 36 } ] }, "topic_coverage": [ { "id": "ai", "title": "AI", "article_count": 552, "claim_count": 1707, "source_count": 1343, "confidence_distribution": { "high": 23, "medium": 528, "low": 1 }, "best_entrypoint": "/api/evidence?q=AI&limit=3" }, { "id": "computer-science", "title": "Computer Science", "article_count": 385, "claim_count": 1206, "source_count": 971, "confidence_distribution": { "high": 2, "medium": 373, "low": 10 }, "best_entrypoint": "/api/evidence?q=Computer%20Science&limit=3" }, { "id": "game-development", "title": "Game Development", "article_count": 50, "claim_count": 185, "source_count": 149, "confidence_distribution": { "high": 0, "medium": 50, "low": 0 }, "best_entrypoint": "/api/evidence?q=Game%20Development&limit=3" }, { "id": "history", "title": "History", "article_count": 48, "claim_count": 152, "source_count": 118, "confidence_distribution": { "high": 1, "medium": 36, "low": 11 }, "best_entrypoint": "/api/evidence?q=History&limit=3" }, { "id": "science", "title": "Science", "article_count": 44, "claim_count": 134, "source_count": 124, "confidence_distribution": { "high": 2, "medium": 35, "low": 7 }, "best_entrypoint": "/api/evidence?q=Science&limit=3" }, { "id": "business", "title": "Business", "article_count": 30, "claim_count": 93, "source_count": 83, "confidence_distribution": { "high": 0, "medium": 27, "low": 3 }, "best_entrypoint": "/api/evidence?q=Business&limit=3" }, { "id": "arts", "title": "Arts", "article_count": 26, "claim_count": 80, "source_count": 57, "confidence_distribution": { "high": 0, "medium": 17, "low": 9 }, "best_entrypoint": "/api/evidence?q=Arts&limit=3" }, { "id": "health", "title": "Health", "article_count": 22, "claim_count": 67, "source_count": 59, "confidence_distribution": { "high": 0, "medium": 20, "low": 2 }, "best_entrypoint": "/api/evidence?q=Health&limit=3" }, { "id": "geography", "title": "Geography", "article_count": 21, "claim_count": 66, "source_count": 59, "confidence_distribution": { "high": 0, "medium": 21, "low": 0 }, "best_entrypoint": "/api/evidence?q=Geography&limit=3" }, { "id": "self-improvement", "title": "Self Improvement", "article_count": 18, "claim_count": 56, "source_count": 48, "confidence_distribution": { "high": 0, "medium": 17, "low": 1 }, "best_entrypoint": "/api/evidence?q=Self%20Improvement&limit=3" }, { "id": "sports", "title": "Sports", "article_count": 14, "claim_count": 44, "source_count": 39, "confidence_distribution": { "high": 0, "medium": 13, "low": 1 }, "best_entrypoint": "/api/evidence?q=Sports&limit=3" } ], "query_benchmark": { "purpose": "Representative AI-agent queries used to measure whether AnchorFact routes real usage to citable public evidence, API guidance, or explicit external-source fallback.", "case_count": 32, "pass_gate": "All benchmark cases are executable through /evals.json and must pass npm run evals:prod and production integrity.", "usefulness_gate": "Run npm run benchmark:ai after local builds; routing is necessary, but answer-ready citations, source depth, and correct refusal behavior decide future content priorities.", "cases": [ { "id": "ai_query_routing_retrieval_augmented_generation", "category": "core_ai", "query": "retrieval augmented generation", "expected_top_slug": "ai/rag", "expected_coverage_status": null, "expected_answer_mode": "answer_with_citations", "expected_can_answer": true, "intent": "RAG is a canonical AI-agent retrieval query and should resolve to the dedicated evidence pack.", "evidence_call": "/api/evidence?q=retrieval%20augmented%20generation&limit=3", "context_call": "/api/context?q=retrieval%20augmented%20generation&limit=3" }, { "id": "ai_query_routing_parameter_efficient_fine_tuning", "category": "core_ai", "query": "parameter efficient fine tuning", "expected_top_slug": "ai/parameter-efficient-fine-tuning", "expected_coverage_status": null, "expected_answer_mode": "answer_with_citations", "expected_can_answer": true, "intent": "PEFT is a common model-adaptation query and should not drift to broader fine-tuning topics.", "evidence_call": "/api/evidence?q=parameter%20efficient%20fine%20tuning&limit=3", "context_call": "/api/context?q=parameter%20efficient%20fine%20tuning&limit=3" }, { "id": "ai_query_intent_fine_tune_with_adapters", "category": "agent_intent", "query": "fine tune a model cheaply with adapters", "expected_top_slug": "ai/parameter-efficient-fine-tuning", "expected_coverage_status": null, "expected_answer_mode": "answer_with_citations", "expected_can_answer": true, "intent": "A natural-language model-adaptation question should route to PEFT with enough citation-ready evidence for an agent answer.", "evidence_call": "/api/evidence?q=fine%20tune%20a%20model%20cheaply%20with%20adapters&limit=3", "context_call": "/api/context?q=fine%20tune%20a%20model%20cheaply%20with%20adapters&limit=3" }, { "id": "ai_query_routing_rlhf", "category": "core_ai", "query": "RLHF", "expected_top_slug": "ai/rlhf", "expected_coverage_status": null, "expected_answer_mode": "answer_with_citations", "expected_can_answer": true, "intent": "The acronym query should resolve directly to reinforcement learning from human feedback.", "evidence_call": "/api/evidence?q=RLHF&limit=3", "context_call": "/api/context?q=RLHF&limit=3" }, { "id": "ai_query_routing_mixture_of_experts", "category": "core_ai", "query": "mixture of experts", "expected_top_slug": "ai/mixture-of-experts", "expected_coverage_status": null, "expected_answer_mode": "answer_with_citations", "expected_can_answer": true, "intent": "MoE routing should prefer the model-architecture article over generic neural network topics.", "evidence_call": "/api/evidence?q=mixture%20of%20experts&limit=3", "context_call": "/api/context?q=mixture%20of%20experts&limit=3" }, { "id": "ai_query_routing_low_resource_nlp", "category": "core_ai", "query": "low resource NLP", "expected_top_slug": "ai/low-resource-nlp", "expected_coverage_status": null, "expected_answer_mode": "answer_with_citations", "expected_can_answer": true, "intent": "Low-resource NLP is a representative long-tail AI topic where precise routing matters.", "evidence_call": "/api/evidence?q=low%20resource%20NLP&limit=3", "context_call": "/api/context?q=low%20resource%20NLP&limit=3" }, { "id": "ai_query_routing_kolmogorov_arnold_networks", "category": "core_ai", "query": "kolmogorov arnold networks", "expected_top_slug": "ai/kolmogorov-arnold-networks", "expected_coverage_status": null, "expected_answer_mode": "answer_with_citations", "expected_can_answer": true, "intent": "KAN should route to the dedicated architecture evidence pack with enough source-backed claims for an AI answer.", "evidence_call": "/api/evidence?q=kolmogorov%20arnold%20networks&limit=3", "context_call": "/api/context?q=kolmogorov%20arnold%20networks&limit=3" }, { "id": "ai_query_routing_vision_transformers", "category": "core_ai", "query": "vision transformers", "expected_top_slug": "ai/vision-transformers", "expected_coverage_status": null, "expected_answer_mode": "answer_with_citations", "expected_can_answer": true, "intent": "Vision Transformer queries should resolve to the ViT evidence pack rather than generic transformer or computer-vision material.", "evidence_call": "/api/evidence?q=vision%20transformers&limit=3", "context_call": "/api/context?q=vision%20transformers&limit=3" }, { "id": "ai_query_routing_meta_learning", "category": "core_ai", "query": "meta learning maml", "expected_top_slug": "ai/meta-learning", "expected_coverage_status": null, "expected_answer_mode": "answer_with_citations", "expected_can_answer": true, "intent": "Meta-learning intent should route to the MAML/Reptile evidence pack with citation-ready source depth.", "evidence_call": "/api/evidence?q=meta%20learning%20maml&limit=3", "context_call": "/api/context?q=meta%20learning%20maml&limit=3" }, { "id": "query_routing_postgresql", "category": "technical_reference", "query": "postgresql", "expected_top_slug": "computer-science/postgresql", "expected_coverage_status": null, "expected_answer_mode": "answer_with_citations", "expected_can_answer": true, "intent": "Database reference queries should route to stable technical evidence outside the AI category.", "evidence_call": "/api/evidence?q=postgresql&limit=3", "context_call": "/api/context?q=postgresql&limit=3" }, { "id": "query_routing_rest_api", "category": "technical_reference", "query": "REST API", "expected_top_slug": "computer-science/rest-api", "expected_coverage_status": null, "expected_answer_mode": "answer_with_citations", "expected_can_answer": true, "intent": "API-design queries should route to the compact REST evidence pack rather than generic API gateway material.", "evidence_call": "/api/evidence?q=REST%20API&limit=3", "context_call": "/api/context?q=REST%20API&limit=3" }, { "id": "query_routing_http_status_codes", "category": "technical_reference", "query": "HTTP status codes", "expected_top_slug": "computer-science/http-status-codes", "expected_coverage_status": null, "expected_answer_mode": "answer_with_citations", "expected_can_answer": true, "intent": "HTTP result-code queries should resolve to the standards-backed status-code article.", "evidence_call": "/api/evidence?q=HTTP%20status%20codes&limit=3", "context_call": "/api/context?q=HTTP%20status%20codes&limit=3" }, { "id": "query_routing_quic_protocol", "category": "technical_reference", "query": "QUIC protocol", "expected_top_slug": "computer-science/quic-protocol", "expected_coverage_status": null, "expected_answer_mode": "answer_with_citations", "expected_can_answer": true, "intent": "Modern web transport queries should resolve to the QUIC protocol evidence pack.", "evidence_call": "/api/evidence?q=QUIC%20protocol&limit=3", "context_call": "/api/context?q=QUIC%20protocol&limit=3" }, { "id": "query_routing_climate_change", "category": "cross_domain", "query": "climate change", "expected_top_slug": "science/climate-change", "expected_coverage_status": null, "expected_answer_mode": "answer_with_citations", "expected_can_answer": true, "intent": "Science queries should route conservatively to source-backed public evidence.", "evidence_call": "/api/evidence?q=climate%20change&limit=3", "context_call": "/api/context?q=climate%20change&limit=3" }, { "id": "query_routing_stock_market_basics", "category": "cross_domain", "query": "stock market basics", "expected_top_slug": "business/stock-market-basics", "expected_coverage_status": null, "expected_answer_mode": "answer_with_citations", "expected_can_answer": true, "intent": "Business queries should resolve to foundational content rather than volatile financial advice.", "evidence_call": "/api/evidence?q=stock%20market%20basics&limit=3", "context_call": "/api/context?q=stock%20market%20basics&limit=3" }, { "id": "query_routing_ancient_egypt", "category": "cross_domain", "query": "ancient egypt", "expected_top_slug": "history/ancient-egypt", "expected_coverage_status": null, "expected_answer_mode": "answer_with_citations", "expected_can_answer": true, "intent": "History queries should prove the registry is not only useful for technical topics.", "evidence_call": "/api/evidence?q=ancient%20egypt&limit=3", "context_call": "/api/context?q=ancient%20egypt&limit=3" }, { "id": "query_routing_public_speaking", "category": "cross_domain", "query": "public speaking", "expected_top_slug": "self-improvement/public-speaking", "expected_coverage_status": null, "expected_answer_mode": "answer_with_citations", "expected_can_answer": true, "intent": "Practical self-improvement queries should return citable claims without draft leakage.", "evidence_call": "/api/evidence?q=public%20speaking&limit=3", "context_call": "/api/context?q=public%20speaking&limit=3" }, { "id": "query_routing_sports_biomechanics", "category": "cross_domain", "query": "sports biomechanics", "expected_top_slug": "sports/sports-biomechanics", "expected_coverage_status": null, "expected_answer_mode": "answer_with_citations", "expected_can_answer": true, "intent": "Sports-science routing checks cross-category recall and precision.", "evidence_call": "/api/evidence?q=sports%20biomechanics&limit=3", "context_call": "/api/context?q=sports%20biomechanics&limit=3" }, { "id": "agent_usage_anchorfact_citation_help", "category": "agent_usage", "query": "how should an AI agent cite AnchorFact claims", "expected_top_slug": null, "expected_coverage_status": "site_help", "expected_answer_mode": "api_guidance", "expected_can_answer": true, "intent": "AnchorFact usage questions should return API guidance instead of pretending public content claims answer product documentation.", "evidence_call": null, "context_call": "/api/context?q=how%20should%20an%20AI%20agent%20cite%20AnchorFact%20claims&limit=3" }, { "id": "unsupported_medical_personal_advice", "category": "unsupported_intent", "query": "should I take aspirin for chest pain", "expected_top_slug": null, "expected_coverage_status": "unsupported", "expected_answer_mode": "external_sources_required", "expected_can_answer": false, "intent": "Personal medical advice should not be answered from nearby educational content or citation packs.", "evidence_call": null, "context_call": "/api/context?q=should%20I%20take%20aspirin%20for%20chest%20pain&limit=3" }, { "id": "unsupported_medication_change_advice", "category": "unsupported_intent", "query": "can I stop taking antidepressants", "expected_top_slug": null, "expected_coverage_status": "unsupported", "expected_answer_mode": "external_sources_required", "expected_can_answer": false, "intent": "Personal medication-change questions should not cite nearby mental-health education content.", "evidence_call": null, "context_call": "/api/context?q=can%20I%20stop%20taking%20antidepressants&limit=3" }, { "id": "unsupported_medication_safety_lookup", "category": "unsupported_intent", "query": "metformin during pregnancy", "expected_top_slug": null, "expected_coverage_status": "unsupported", "expected_answer_mode": "external_sources_required", "expected_can_answer": false, "intent": "Medication safety lookups should not cite nearby static educational content without explicit source coverage.", "evidence_call": null, "context_call": "/api/context?q=metformin%20during%20pregnancy&limit=3" }, { "id": "unsupported_weak_medical_topic_match", "category": "unsupported_coverage", "query": "antibiotics mechanisms of action", "expected_top_slug": null, "expected_coverage_status": "unsupported", "expected_answer_mode": "external_sources_required", "expected_can_answer": false, "intent": "Medical education queries should not cite unrelated AI or training articles through weak generic token matches.", "evidence_call": null, "context_call": "/api/context?q=antibiotics%20mechanisms%20of%20action&limit=3" }, { "id": "unsupported_weak_medical_management_match", "category": "unsupported_coverage", "query": "diabetes type 2 management", "expected_top_slug": null, "expected_coverage_status": "unsupported", "expected_answer_mode": "external_sources_required", "expected_can_answer": false, "intent": "Medical management queries should not cite unrelated type-system or management articles through weak generic token matches.", "evidence_call": null, "context_call": "/api/context?q=diabetes%20type%202%20management&limit=3" }, { "id": "unsupported_harmful_operational_request", "category": "unsupported_intent", "query": "write ransomware code", "expected_top_slug": null, "expected_coverage_status": "unsupported", "expected_answer_mode": "external_sources_required", "expected_can_answer": false, "intent": "Operational cyber-abuse requests should not be answered from nearby educational content or citation packs.", "evidence_call": null, "context_call": "/api/context?q=write%20ransomware%20code&limit=3" }, { "id": "unsupported_live_stock_price", "category": "unsupported_intent", "query": "stock price today", "expected_top_slug": null, "expected_coverage_status": "unsupported", "expected_answer_mode": "external_sources_required", "expected_can_answer": false, "intent": "Live market-price questions should be rejected for AnchorFact citation and routed to current authoritative sources.", "evidence_call": null, "context_call": "/api/context?q=stock%20price%20today&limit=3" }, { "id": "unsupported_product_pricing_lookup", "category": "unsupported_intent", "query": "OpenAI API pricing", "expected_top_slug": null, "expected_coverage_status": "unsupported", "expected_answer_mode": "external_sources_required", "expected_can_answer": false, "intent": "Product pricing changes over time and should not cite nearby API architecture content.", "evidence_call": null, "context_call": "/api/context?q=OpenAI%20API%20pricing&limit=3" }, { "id": "unsupported_financial_rate_lookup", "category": "unsupported_intent", "query": "mortgage rates", "expected_top_slug": null, "expected_coverage_status": "unsupported", "expected_answer_mode": "external_sources_required", "expected_can_answer": false, "intent": "Financial rate lookups should use current authoritative market sources, not static economic background articles.", "evidence_call": null, "context_call": "/api/context?q=mortgage%20rates&limit=3" }, { "id": "unsupported_financial_price_prediction", "category": "unsupported_intent", "query": "Bitcoin price prediction", "expected_top_slug": null, "expected_coverage_status": "unsupported", "expected_answer_mode": "external_sources_required", "expected_can_answer": false, "intent": "Speculative current price prediction queries should not cite static cryptocurrency or AI prediction articles.", "evidence_call": null, "context_call": "/api/context?q=Bitcoin%20price%20prediction&limit=3" }, { "id": "unsupported_software_current_version_lookup", "category": "unsupported_intent", "query": "Node.js LTS version", "expected_top_slug": null, "expected_coverage_status": "unsupported", "expected_answer_mode": "external_sources_required", "expected_can_answer": false, "intent": "Current software version lookups should use live project release sources, not static technology explainers.", "evidence_call": null, "context_call": "/api/context?q=Node.js%20LTS%20version&limit=3" }, { "id": "unsupported_live_weather_location", "category": "unsupported_intent", "query": "weather Paris", "expected_top_slug": null, "expected_coverage_status": "unsupported", "expected_answer_mode": "external_sources_required", "expected_can_answer": false, "intent": "Implicit local weather questions should not be answered from static weather-forecasting articles.", "evidence_call": null, "context_call": "/api/context?q=weather%20Paris&limit=3" }, { "id": "unsupported_current_leadership_fact", "category": "unsupported_intent", "query": "who is the CEO of OpenAI", "expected_top_slug": null, "expected_coverage_status": "unsupported", "expected_answer_mode": "external_sources_required", "expected_can_answer": false, "intent": "Current leadership facts can change and should not be answered from stale or nearby static content.", "evidence_call": null, "context_call": "/api/context?q=who%20is%20the%20CEO%20of%20OpenAI&limit=3" } ] }, "best_entrypoints": { "discover_contract": "/agent.json", "route_task": "/capabilities.json", "check_coverage": "/coverage.json", "plan_query": "/api/plan?q={query}&limit=3", "answer_with_evidence": "/api/evidence?q={query}&limit=3", "cite_claim": "/api/cite?id={claim_id}", "verify_official_build": "/provenance.json" }, "recommended_decision_flow": [ { "step": 1, "question": "Ask AnchorFact whether public coverage is plausible and which endpoint should be called next.", "use": "/api/plan?q={query}&limit=3" }, { "step": 2, "question": "If the plan says coverage is plausible, fetch source-grounded public evidence.", "use": "/api/evidence?q={query}&limit=3" }, { "step": 3, "question": "Before citing, verify the selected claim and source mapping.", "use": "/api/cite?id={claim_id}" }, { "step": 4, "question": "If coverage is weak or absent, do not invent AnchorFact support; use external sources instead.", "use": null } ], "coverage_limits": [ { "id": "public_only", "description": "Only public records are intended for AI retrieval and citation; drafts are intentionally excluded." }, { "id": "not_general_web_search", "description": "AnchorFact is a verified claim registry, not a complete web search engine or encyclopedic replacement." }, { "id": "confidence_is_not_truth", "description": "Confidence summarizes source tier, source count, verification coverage, freshness, and editorial caps; it does not replace checking original sources." }, { "id": "partial_coverage_requires_caution", "description": "When a query falls outside listed topics or returns no public evidence packs, cite external primary sources instead of stretching AnchorFact coverage." } ] }