@nebulacomponents/citable 1.18.2 → 1.20.0

package/src/detectors/geoReco.js

@@ -7,6 +7,7 @@ const D = [];
 /* ---------------- EXT: external corroboration ---------------- */
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'EXT-001', name: 'Corroboration claimed from owned surface', namespace: 'EXT',
   description: 'A claim lists "external corroboration" whose source is the organization’s own domain — self-corroboration.',
   discipline: ['aeo', 'geo'], severity: 'medium', deterministic: true, requires: ['registries'],
@@ -40,6 +41,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'EXT-002', name: 'Comparative claim lacking independent corroboration', namespace: 'EXT',
   description: 'A verified comparative claim has no external corroboration recorded at all.',
   discipline: ['geo'], severity: 'low', deterministic: true, requires: ['registries'],
@@ -62,6 +64,7 @@ D.push(defineDetector({
 /* ---------------- GEO: generative representation ---------------- */
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'GEO-001', name: 'Hidden instructions targeting language models', namespace: 'GEO',
   description: 'Hidden page text or HTML comments contain instruction-like phrasing aimed at AI systems (crawler prompt injection).',
   discipline: ['geo'], severity: 'critical', deterministic: true, requires: ['site'],
@@ -99,6 +102,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'GEO-002', name: 'Proprietary concept without stable definition', namespace: 'GEO',
   description: 'A proprietary-concept entity has no definition recorded and/or no canonical page.',
   discipline: ['geo', 'aeo'], severity: 'medium', deterministic: true, requires: ['registries'],
@@ -119,6 +123,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'GEO-003', name: 'Entity absent from its category page', namespace: 'GEO',
   description: 'A product entity declares a category for which a category page exists, but the page never mentions the entity.',
   discipline: ['geo'], severity: 'medium', deterministic: true, requires: ['site', 'registries'],
@@ -153,6 +158,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'GEO-004', name: 'llms.txt treated as authority mechanism', namespace: 'GEO',
   description: 'llms.txt exists and contains directive/authority language, which no engine honors as an authorization mechanism.',
   discipline: ['geo'], severity: 'low', deterministic: false, requires: ['site'],
@@ -178,6 +184,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'GEO-005', name: 'Generative target lacks primary entity mapping', namespace: 'GEO',
   description: 'A page intended to define, compare, categorize, or recommend entities does not declare its primary entities.',
   discipline: ['geo', 'aeo'], severity: 'high', deterministic: true, requires: ['site', 'registries'],
@@ -200,6 +207,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'GEO-006', name: 'Active prompt lacks evaluation brief', namespace: 'GEO',
   description: 'An active prompt lacks the expected answer components, desired outcome, risk classification, or accountable owner needed for reproducible GEO evaluation.',
   discipline: ['geo', 'aeo'], severity: 'medium', deterministic: true, requires: ['registries'],
@@ -226,6 +234,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'GEO-007', name: 'Unfavorable or distorted entity stance in recorded generative answers', namespace: 'GEO',
   description: 'Recorded generative engine answers express an unfavorable, negative, or critically distorted stance toward a registered entity.',
   discipline: ['geo', 'aeo'], severity: 'high', deterministic: false, requires: ['registries'],
@@ -326,6 +335,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'GEO-008', name: 'Generative citation attributes unverified or distorted claim to brand', namespace: 'GEO',
   description: 'Recorded generative engine answers attribute contradicted, distorted, or unverified factual claims to a registered entity or brand.',
   discipline: ['geo', 'aeo'], severity: 'high', deterministic: false, requires: ['registries'],
@@ -430,6 +440,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'GEO-009', name: 'Unstable citation presence across repeated probes', namespace: 'GEO',
   description: 'Brand citation status exhibits high volatility or flapping (alternating between cited and unmentioned) across repeated probe runs for the same prompt and engine.',
   discipline: ['geo', 'aeo'], severity: 'medium', deterministic: false, requires: ['registries'],
@@ -508,6 +519,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'GEO-010', name: 'Brand erasure in multi-competitor category prompt', namespace: 'GEO',
   description: 'A generative engine observation for a relevant category or comparison prompt cites multiple registered competitors but completely omits the first-party entity or brand.',
   discipline: ['geo', 'aeo'], severity: 'high', deterministic: false, requires: ['registries'],
@@ -568,6 +580,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'GEO-011', name: 'RAG chunk fracture: claim separated from citation across oversized section', namespace: 'GEO',
   description: 'A section under a single heading exceeds 450 words without structural sub-headings or lists, separating claims from qualifying citations and causing retrieval fracture in RAG chunking pipelines.',
   discipline: ['geo', 'aeo'], severity: 'medium', deterministic: true, requires: ['site'],
@@ -616,6 +629,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'GEO-012', name: 'Repetitive phrase stuffing in section headings degrading dense retrieval', namespace: 'GEO',
   description: 'Multiple headings repeat the identical multi-word phrase or entity prefix, degrading dense vector discriminability and triggering keyword stuffing penalties in neural search rankers.',
   discipline: ['geo', 'seo'], severity: 'low', deterministic: true, requires: ['site'],
@@ -670,6 +684,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'GEO-013', name: 'AI engine assertion contradicts verified publisher claim registry', namespace: 'GEO',
   description: 'An external AI search engine or generative model assertion directly contradicts or negates a verified publisher claim registered in claims.yaml.',
   discipline: ['geo', 'aeo'], severity: 'high', deterministic: true, requires: ['observations', 'registries'],
@@ -745,6 +760,7 @@ const RECO_CHECKS = [
 
 for (const [id, label, rx, desc, req] of RECO_CHECKS) {
   D.push(defineDetector({
+    coverage_requirement: 'evaluated_subset',
     id, name: `Recommendation data missing: ${label}`, namespace: 'RECO',
     description: desc,
     discipline: ['geo'], severity: 'medium', deterministic: false, requires: ['site', 'registries'],

package/src/detectors/hreflang.js

@@ -10,6 +10,7 @@ import { defineDetector } from './framework.js';
  * HREFLANG-001: hreflang link present and valid
  */
 export const HREFLANG_001 = defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'HREFLANG-001',
   name: 'hreflang link valid',
   namespace: 'HREFLANG',
@@ -79,6 +80,7 @@ export const HREFLANG_001 = defineDetector({
  * HREFLANG-002: Self-referencing hreflang exists
  */
 export const HREFLANG_002 = defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'HREFLANG-002',
   name: 'hreflang self-reference',
   namespace: 'HREFLANG',
@@ -121,6 +123,7 @@ export const HREFLANG_002 = defineDetector({
  * HREFLANG-003: x-default present for international pages
  */
 export const HREFLANG_003 = defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'HREFLANG-003',
   name: 'hreflang x-default',
   namespace: 'HREFLANG',

package/src/detectors/lifeMeas.js

@@ -6,6 +6,7 @@ const D = [];
 /* ---------------- LIFE: lifecycle and ownership ---------------- */
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'LIFE-001', name: 'Page without content owner', namespace: 'LIFE',
   description: 'An active page registry entry has no accountable content owner.',
   discipline: ['seo', 'aeo', 'geo'], severity: 'medium', deterministic: true, requires: ['registries'],
@@ -23,6 +24,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'LIFE-002', name: 'Claim-bearing page without factual reviewer', namespace: 'LIFE',
   description: 'A page that publishes registered claims has no factual reviewer.',
   discipline: ['aeo', 'geo'], severity: 'medium', deterministic: true, requires: ['registries'],
@@ -42,6 +44,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'LIFE-003', name: 'Review overdue', namespace: 'LIFE',
   description: 'A page has passed its next review date.',
   discipline: ['seo', 'aeo', 'geo'], severity: 'medium', deterministic: true, requires: ['registries'],
@@ -61,6 +64,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'LIFE-004', name: 'Page without lifecycle classification', namespace: 'LIFE',
   description: 'An active page has no lifecycle class, so no review model can apply.',
   discipline: ['seo', 'aeo', 'geo'], severity: 'low', deterministic: true, requires: ['registries'],
@@ -80,6 +84,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'LIFE-005', name: 'Regulatory content without jurisdiction', namespace: 'LIFE',
   description: 'A page classified regulatory (or carrying legal claims) records no jurisdiction.',
   discipline: ['aeo', 'geo'], severity: 'medium', deterministic: true, requires: ['registries'],
@@ -100,6 +105,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'LIFE-006', name: 'Freshness theater (date bumped, content unchanged)', namespace: 'LIFE',
   description: 'Between snapshots, a page’s dateModified advanced while its content hash stayed identical.',
   discipline: ['seo', 'aeo'], severity: 'medium', deterministic: true, requires: ['site', 'snapshots'],
@@ -139,6 +145,7 @@ export function extractModified(page) {
 /* ---------------- MEAS: measurement integrity ---------------- */
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'MEAS-001', name: 'Prompt observation missing required metadata', namespace: 'MEAS',
   description: 'A recorded prompt-test observation lacks engine, model/interface, locale, or timestamp context.',
   discipline: ['geo', 'aeo'], severity: 'medium', deterministic: true, requires: ['promptResults'],
@@ -163,6 +170,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'MEAS-002', name: 'Single observation treated as stable outcome', namespace: 'MEAS',
   description: 'A prompt has exactly one recorded observation but its registry accuracy_status asserts a definitive outcome.',
   discipline: ['geo'], severity: 'medium', deterministic: true, requires: ['registries'],
@@ -186,6 +194,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'MEAS-003', name: 'Causal experiment conclusion without controls', namespace: 'MEAS',
   description: 'A concluded experiment asserts a result but records no control group, baseline window, or confounders.',
   discipline: ['seo', 'geo'], severity: 'medium', deterministic: true, requires: ['registries'],

package/src/detectors/link.js

@@ -3,6 +3,7 @@ import { defineDetector, indexTargets, pageSubject } from './framework.js';
 const D = [];
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'LINK-001', name: 'Broken internal link', namespace: 'LINK',
   description: 'An internal link targets a URL that is missing from the audited output or returns 4xx/5xx.',
   discipline: ['seo', 'aeo'], severity: 'medium', deterministic: true, requires: ['site'],
@@ -38,6 +39,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'LINK-002', name: 'Internal link to redirect', namespace: 'LINK',
   description: 'An internal link targets a URL that redirects instead of the final destination.',
   discipline: ['seo'], severity: 'low', deterministic: true, requires: ['site'],
@@ -64,6 +66,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'LINK-003', name: 'Generic anchor text', namespace: 'LINK',
   description: 'Internal links use non-descriptive anchors ("click here", "read more", "learn more").',
   discipline: ['seo', 'aeo'], severity: 'low', deterministic: true, requires: ['site'],
@@ -89,6 +92,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'LINK-004', name: 'Sitewide repeated exact-match anchor', namespace: 'LINK',
   description: 'The same exact anchor text points at the same URL from a large share of pages — a pattern of mechanical link insertion.',
   discipline: ['seo'], severity: 'low', deterministic: false, requires: ['site'],
@@ -119,6 +123,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'LINK-005', name: 'Internal redirect hop chain or circular redirect loop', namespace: 'LINK',
   description: 'An internal link targets a URL that initiates a multi-hop redirect chain (>=2 hops) or a circular redirect loop, dissipating link equity and wasting crawler budget.',
   discipline: ['seo', 'tech'], severity: 'medium', deterministic: true, requires: ['site'],
@@ -186,6 +191,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'LINK-006', name: 'Excessive naked URL or uninformative internal anchor text ratio', namespace: 'LINK',
   description: 'Over 25% of internal links on a page use naked URLs or uninformative anchors, diluting semantic topic graph signals for search engines and generative models.',
   discipline: ['seo', 'aeo'], severity: 'low', deterministic: true, requires: ['site'],
@@ -229,4 +235,3 @@ D.push(defineDetector({
 }));
 
 export default D;
-

package/src/detectors/page.js

@@ -4,6 +4,7 @@ import { parse } from 'node-html-parser';
 const D = [];
 
 D.push(defineDetector({
+  coverage_requirement: 'page_resource',
   id: 'PAGE-001', name: 'Missing title element', namespace: 'PAGE',
   description: 'Index-target page has no <title>.',
   discipline: ['seo', 'aeo'], severity: 'high', deterministic: true, requires: ['site'],
@@ -19,6 +20,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'page_resource',
   id: 'PAGE-002', name: 'Duplicate title across pages', namespace: 'PAGE',
   description: 'Two or more index-target pages share an identical title.',
   discipline: ['seo'], severity: 'medium', deterministic: true, requires: ['site'],
@@ -42,6 +44,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'page_resource',
   id: 'PAGE-003', name: 'Missing meta description', namespace: 'PAGE',
   description: 'Index-target page lacks a meta description (search-result copy).',
   discipline: ['seo'], severity: 'low', deterministic: true, requires: ['site'],
@@ -57,6 +60,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'page_resource',
   id: 'PAGE-004', name: 'Duplicate meta description', namespace: 'PAGE',
   description: 'Multiple pages share an identical meta description.',
   discipline: ['seo'], severity: 'low', deterministic: true, requires: ['site'],
@@ -80,6 +84,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'page_resource',
   id: 'PAGE-005', name: 'Missing or multiple H1', namespace: 'PAGE',
   description: 'Page does not have exactly one primary heading.',
   discipline: ['seo', 'aeo'], severity: 'medium', deterministic: true, requires: ['site'],
@@ -98,6 +103,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'page_resource',
   id: 'PAGE-006', name: 'Heading hierarchy skip', namespace: 'PAGE',
   description: 'Heading levels skip (e.g., H1 → H3), indicating headings used for visual size rather than document structure.',
   discipline: ['seo', 'aeo'], severity: 'low', deterministic: true, requires: ['site'],
@@ -127,6 +133,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'page_resource',
   id: 'PAGE-007', name: 'Image missing alt text', namespace: 'PAGE',
   description: 'Content images lack alt attributes.',
   discipline: ['seo'], severity: 'low', deterministic: true, requires: ['site'],
@@ -147,6 +154,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'page_resource',
   id: 'PAGE-008', name: 'Thin index-target content', namespace: 'PAGE',
   description: 'An index-target page has very little primary text.',
   discipline: ['seo', 'aeo'], severity: 'medium', deterministic: false, requires: ['site'],
@@ -169,6 +177,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'page_resource',
   id: 'PAGE-009', name: 'Keyword stuffing', namespace: 'PAGE',
   description: 'A single non-trivial term dominates the page text at a frequency inconsistent with natural prose.',
   discipline: ['seo'], severity: 'medium', deterministic: false, requires: ['site'],
@@ -201,6 +210,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'page_resource',
   id: 'PAGE-010', name: 'High boilerplate-to-content ratio in extracted answer passages', namespace: 'PAGE',
   description: 'An index-target page has a high ratio of boilerplate (navigation, header, footer, chrome) relative to substantive primary content, diluting extracted answer passages.',
   discipline: ['aeo', 'seo'], severity: 'medium', deterministic: true, requires: ['site'],
@@ -235,6 +245,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'page_resource',
   id: 'PAGE-011', name: 'Critical entity claims rendered inside transient/collapsible UI containers without fallback', namespace: 'PAGE',
   description: 'Registered claim or critical entity statement is rendered exclusively inside a collapsible or transient UI container (<details>, accordion, hidden tab) without an uncollapsed fallback or crawlable representation.',
   discipline: ['aeo', 'geo'], severity: 'medium', deterministic: true, requires: ['site', 'registries'],

package/src/detectors/schemaData.js

@@ -4,6 +4,7 @@ import { isPastDate } from '../shared/io.js';
 const D = [];
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'SCHEMA-001', name: 'JSON-LD parse failure', namespace: 'SCHEMA',
   description: 'A JSON-LD script block does not parse as JSON.',
   discipline: ['seo', 'aeo', 'geo'], severity: 'high', deterministic: true, requires: ['site'],
@@ -29,6 +30,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'SCHEMA-002', name: 'Schema headline/name mismatch with visible content', namespace: 'SCHEMA',
   description: 'Article/WebPage headline in JSON-LD does not match the visible title or H1.',
   discipline: ['seo', 'aeo'], severity: 'medium', deterministic: true, requires: ['site'],
@@ -61,6 +63,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'SCHEMA-003', name: 'Schema URL conflicts with canonical', namespace: 'SCHEMA',
   description: 'JSON-LD url/mainEntityOfPage disagrees with the page canonical.',
   discipline: ['seo'], severity: 'medium', deterministic: true, requires: ['site'],
@@ -91,6 +94,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'SCHEMA-004', name: 'Inaccurate schema dates', namespace: 'SCHEMA',
   description: 'datePublished is in the future, or dateModified precedes datePublished.',
   discipline: ['seo', 'aeo'], severity: 'medium', deterministic: true, requires: ['site'],
@@ -128,6 +132,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'SCHEMA-005', name: 'Rating/review markup without visible reviews', namespace: 'SCHEMA',
   description: 'aggregateRating or review markup exists but the visible page contains no review content.',
   discipline: ['seo'], severity: 'critical', deterministic: true, requires: ['site'],
@@ -157,6 +162,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'SCHEMA-006', name: 'Stale offer price validity', namespace: 'SCHEMA',
   description: 'Offer markup carries a priceValidUntil in the past.',
   discipline: ['seo', 'geo'], severity: 'medium', deterministic: true, requires: ['site'],
@@ -187,6 +193,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'SCHEMA-007', name: 'FAQPage markup without matching visible questions', namespace: 'SCHEMA',
   description: 'FAQPage JSON-LD questions do not appear in the visible page text.',
   discipline: ['seo', 'aeo'], severity: 'high', deterministic: true, requires: ['site'],
@@ -217,6 +224,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'SCHEMA-008', name: 'Contradictory Organization graphs', namespace: 'SCHEMA',
   description: 'Multiple Organization blocks exist with the same @id but different names, or different @id values with the same name (split identity).',
   discipline: ['geo', 'seo'], severity: 'high', deterministic: true, requires: ['site'],
@@ -247,6 +255,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'SCHEMA-009', name: 'Structured data entity facts unsupported by visible content', namespace: 'SCHEMA',
   description: 'Material entity facts in JSON-LD (such as contact phone, address, pricing, or founding year) are absent from visible page content.',
   discipline: ['seo', 'aeo', 'geo'], severity: 'high', deterministic: true, requires: ['site'],
@@ -330,6 +339,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'SCHEMA-010', name: 'Dangling or circular @id reference in entity graph', namespace: 'SCHEMA',
   description: 'A JSON-LD node references an @id URI that is not defined on the site or creates a circular self-reference.',
   discipline: ['geo', 'seo'], severity: 'high', deterministic: true, requires: ['site'],
@@ -417,6 +427,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'SCHEMA-011', name: 'BreadcrumbList schema broken or unanchored', namespace: 'SCHEMA',
   description: 'BreadcrumbList structured data has invalid sequential positions, missing or empty item URLs/names, or broken hierarchical continuity.',
   discipline: ['seo', 'aeo'], severity: 'medium', deterministic: true, requires: ['site'],
@@ -503,6 +514,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'SCHEMA-012', name: 'Temporal contradiction between schema dates, visible text, and HTTP headers', namespace: 'SCHEMA',
   description: 'Structured data dates contradict visible page text timestamps or HTTP Last-Modified headers, undermining search engine freshness consensus.',
   discipline: ['seo', 'aeo', 'geo'], severity: 'medium', deterministic: true, requires: ['site'],
@@ -592,6 +604,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'SCHEMA-013', name: 'VideoObject schema missing critical SERP playback prerequisites', namespace: 'SCHEMA',
   description: 'A VideoObject JSON-LD block is missing required attributes for Google SERP rich video display (name, description, uploadDate, thumbnailUrl, contentUrl or embedUrl).',
   discipline: ['seo', 'aeo'], severity: 'medium', deterministic: true, requires: ['site'],
@@ -635,6 +648,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'SCHEMA-014', name: 'Organization or LocalBusiness schema missing authoritative identity attributes', namespace: 'SCHEMA',
   description: 'An Organization or LocalBusiness JSON-LD block lacks essential identity signals for Google Knowledge Graph or SERP inclusion (name, url, logo, or contactPoint/address).',
   discipline: ['seo', 'aeo', 'geo'], severity: 'low', deterministic: true, requires: ['site'],
@@ -679,6 +693,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'SCHEMA-015', name: 'Circular or self-referential JSON-LD @id node reference', namespace: 'SCHEMA',
   description: 'A JSON-LD structured data graph contains an @id node that points to itself or forms a direct circular reference cycle, breaking search engine graph crawlers and parsers.',
   discipline: ['seo', 'aeo'], severity: 'high', deterministic: true, requires: ['site'],
@@ -728,6 +743,7 @@ D.push(defineDetector({
 }));
 
 D.push(defineDetector({
+  coverage_requirement: 'evaluated_subset',
   id: 'SCHEMA-016', name: 'Author Person entity lacks external disambiguation URL or sameAs', namespace: 'SCHEMA',
   description: 'An Article, BlogPosting, NewsArticle, or Review defines an author Person entity without an external profile URL or sameAs link, preventing search engine Knowledge Graph author disambiguation and weakening E-E-A-T trust signals.',
   discipline: ['seo', 'aeo', 'geo'], severity: 'medium', deterministic: true, requires: ['site'],
@@ -775,4 +791,3 @@ D.push(defineDetector({
 
 export default D;
 
-