Documentation

Mechanism and Evidence Capabilities

Reference for the 15 scored mechanism dimensions plus the optional C16 search-result snapshot, including dependencies and evidence limits.

The composite contains 15 mechanism dimensions labeled C1 through C15. C16 is an optional, time-stamped search-result evidence snapshot; it is stored separately and does not add a sixteenth score weight. Capabilities run during Stage 2 (Measure) or Stage 3.5 (Post-processing), and their gates and quality states determine whether they contribute to scoring.

Together, the 15 capabilities account for 66% of the overall audit score (0.044 weight each). The remaining 34% comes from traditional SEO (14%) and the judge pipeline (20%).

Quick Reference

IDCapabilityExecution
C1Tokenizer TaxLocal
C2Entity ResolutionGated sources + providers
C3Retrieval PoolFeature-gated; local embeddings + sources
C4Token ProbabilityFeature-gated provider calls
C5PMI Co-occurrenceFeature-gated local corpus
C6Seven-Source AnalysisFeature-gated provider calls
C7Aggregator PresenceSource-gated; optional fallbacks
C8Chunk GapsFeature-gated; local embeddings + sources
C9Hallucination LogDepends on fact-archaeology output
C10Phrasing SensitivityFeature-gated provider calls
C11Loop ThresholdsRequires prior audit history
C12CounterfactualFeature-gated external sidecar or fallback
C13Query IntentRule-based; depends on prompt variants
C14PerceptionFeature-gated; depends on provider text
C15Competitive DecompositionFeature-gated derived calculation
C16AI OverviewAvailability-gated search-result source

Detailed Reference

C1Tokenizer TaxLocal
What it measures

How many tokens represent the brand name in cl100k_base and o200k_base, with optional competitor context. The count is reported directly rather than converted into a universal mention-probability claim.

How it works

Uses js-tiktoken to encode the brand name plus up to 3 competitors and 10 common vocabulary terms in both cl100k and o200k. The score is derived from the ratio of your brand's token count to the category average. Single-token brands score near 100; brands exceeding the average token count score proportionally lower.

Why it matters

Tokenization is stable for a particular vocabulary and useful as one structural input. It should not be treated as proof that a model will or will not mention a brand.

C2Entity ResolutionGated sources + providers
What it measures

How the configured provider probes describe the brand, plus whether the entity-source waterfall resolves a structured entity record.

How it works

Runs 3 response probes across up to 5 LLM providers and classifies each response with a keyword rubric. Separately, the entity waterfall tries configured knowledge-graph sources and records source confidence. A schema post-processor inspects the submitted page's JSON-LD.

Why it matters

Confused or inconsistent responses can reveal an identity problem worth investigating. A missing Wikidata match is one absent corroborating signal, not proof that every provider fails to recognize the brand.

C3Retrieval PoolFeature-gated; local embeddings + sources
What it measures

Which chunks rank highest inside the corpus assembled by this audit for category-derived prompts.

How it works

Collects owned content from the crawled site and relevant Wikipedia articles. Content is chunked, then embedded locally via MiniLM-L6-v2 (384 dimensions) and stored in pgvector. Five category-specific prompts generated from the Stage 1.5 classification are embedded and compared with the stored chunks using top-20 cosine similarity. The score reflects the proportion of top-20 results that come from owned content versus competitor or third-party sources.

Why it matters

This local retrieval simulation can expose weak or missing owned-page coverage. It does not reproduce a commercial provider's private index and cannot guarantee citation behavior.

C4Token ProbabilityFeature-gated provider calls
What it measures

The top-k probability assigned to the brand token in the recorded category prompts on providers that expose log probabilities.

How it works

Uses the active scale's prompt, sample, and provider configuration. It scans the first generated positions for the brand prefix and bootstraps an interval over completed samples. Failed or mock-only rows are marked degraded.

Why it matters

This is a direct observation for specific prompts and provider endpoints. It does not expose training data and should not be generalized to every prompt, model, or answer format.

C5PMI Co-occurrenceFeature-gated local corpus
What it measures

The statistical association between your brand name and page-derived anchor terms, with optional context from up to three classified competitors whose pages fetched successfully. Pointwise mutual information (PMI) quantifies co-occurrence inside this audit's corpus.

How it works

Builds a per-audit corpus from the submitted page and successfully fetched competitor pages. It does not use the bundled demo corpus for customer scores. If the corpus has fewer than 200 tokens or no page-derived anchors, the dimension returns an error quality state and no score contribution.

Why it matters

PMI describes co-occurrence inside the corpus used for the calculation. It does not reveal a provider's training corpus or guarantee generated wording.

C6Seven-Source AnalysisFeature-gated provider calls
What it measures

How recorded provider responses vary across seven prompt conditions: no-web, retrieval-requested, completion, balanced, system-constrained, safety, and model-comparison.

How it works

The database retains historical layer-shaped field names, but the implementation changes prompts; it cannot isolate pretraining, instruction tuning, RLHF, system prompts, safety filters, or fine-tuning. Unsupported and failed cells remain explicit.

Why it matters

Prompt-condition differences can identify responses worth inspecting. They must not be presented as access to a provider's hidden training or alignment stack.

C7Aggregator PresenceSource-gated; optional fallbacks
What it measures

Whether configured public-source checks find the brand in selected aggregator or roundup results, plus citations parsed from captured provider responses.

How it works

Two components. First: search against a registry of known aggregators to check whether the brand appears. Second: citation extraction from provider responses that were actually captured during the run. The source waterfall can try configured fallbacks when a source is empty or unavailable.

Why it matters

Source consistency and captured citations are useful public-evidence checks. The audit does not know whether a source was in a provider's training data or treated as ground truth.

C8Chunk GapsFeature-gated; local embeddings + sources
What it measures

Topic clusters present in successfully fetched competitor content but not matched in the submitted page. The result is a difference in this audit's corpus, not proof of an external retrieval loss.

How it works

Fetches available content from the submitted site and classified competitor pages through the configured page-source waterfall. Content is divided into passages, embedded, and grouped by topic. Gap severity summarizes the distance between successfully fetched competitor topics and the submitted page.

Why it matters

A successfully measured gap shows a topic difference in the fetched corpus. It does not prove which page an external retrieval system will serve or that every gap deserves new content.

C9Hallucination LogDepends on fact-archaeology output
What it measures

Candidate contradictions between a captured no-page model response and facts present on the submitted page.

How it works

One call captures a fact response without page content. A second call compares that response with the public page and flags direct contradictions. The page is only an audit reference, so flagged rows require manual verification.

Why it matters

A verified contradiction is actionable evidence for correcting owned facts or relevant profiles. The module does not prove the provider's training source or the prevalence of the claim elsewhere.

C10Phrasing SensitivityFeature-gated provider calls
What it measures

Variation in recorded brand-mention outcomes across generated wording variants for the audited category.

How it works

Builds prompt variants, sends them through the configured providers, records the returned text and mention outcome, and summarizes observed variance. The paired intent view classifies those variants with rules; it does not infer private user-query demand.

Why it matters

Prompt wording can materially change an observed response. This capability describes the sampled prompts and providers only, and does not estimate a universal mention rate.

C11Loop ThresholdsRequires prior audit history
What it measures

How five derived measurements changed from a prior audit and where they sit relative to product-configured heuristic thresholds.

How it works

Defines five feedback-loop metrics and compares the current audit with prior snapshots for the same brand. When history is insufficient, the result is marked degraded rather than presented as measured velocity.

Why it matters

Repeated measurements can show direction and support follow-up investigation. The configured thresholds are not validated causal tipping points, so this capability is labelled degraded even with history.

C12CounterfactualFeature-gated external sidecar or fallback
What it measures

A modeled composite-score change for a simulated issue fix.

How it works

For qualifying issues, the processor can call the configured prediction sidecar with the current feature vector and a simulated fix. If the sidecar is unavailable, the client can return a labelled fallback estimate. The stored prediction source identifies which path produced the result.

Why it matters

A labelled estimate can help rank experiments, but it is not a promised causal lift. Estimates should not be added together unless the model evaluated the combined intervention.

C13Query IntentRule-based; depends on prompt variants
What it measures

How recorded mention rates differ across rule-classified prompt intents: informational, navigational, transactional, and commercial.

How it works

A rule-based classifier categorizes prompt variants from the phrasing-sensitivity module. The product weighting gives commercial and transactional classes more score weight; that weighting is a product choice, not measured revenue attribution.

Why it matters

Breaking out the recorded mention rate by intent can reveal prompt-specific variation without claiming that one class caused a business outcome.

C14PerceptionFeature-gated; depends on provider text
What it measures

Lexicon-based sentiment and attribute terms in the provider responses captured by this audit.

How it works

Runs lexicon-based sentiment analysis on each provider's raw text output about the brand. Extracts attribute terms (adjectives, descriptive phrases) per provider. Results are compared across providers to identify consensus attributes (mentioned by 3+ providers) vs. outliers. The score reflects sentiment positivity, attribute consistency, and alignment with the brand's stated positioning.

Why it matters

The recorded wording can reveal a response worth reviewing. It is not an exact measurement of a provider's overall perception or the cause of that wording.

C15Competitive DecompositionFeature-gated derived calculation
What it measures

A six-group allocation of a score gap only when a classified competitor has a completed ResourceAI audit with comparable dimensions.

How it works

Matches the latest completed audit by competitor brand name, keeps dimensions with usable scores in both audits, and allocates the positive weighted gap across response proxy, retrieval, entity, content, tokenizer, and other groups. Without a match, no decomposition is emitted.

Why it matters

Matched-audit provenance makes a comparison inspectable. It remains a score decomposition, not proof that a component caused market performance.

C16AI OverviewAvailability-gated search-result source
What it measures

A time-stamped search-result snapshot of whether an AI Overview was returned for up to five generated category queries and whether its text mentions the brand.

How it works

Runs only when the configured search-result source is available. For returned overviews, it records the query, text, cited sources, brand mention position, and sentiment. When the source is unavailable, the capability is marked unavailable rather than reported as an empty result.

Why it matters

When configured and successfully returned, this is direct query-result evidence for that place and time. It is not universal ground truth across users, locations, queries, or later results.

© 2026 ResourceAIEvidence first · public web pages