Documentation

FUI1007: Component shadows a canonical primitive

moderate

Why Fragments emitted FUI1007 and how to resolve components/shadow-component.

Details

diagnostic
{
  "code": "FUI1007",
  "ruleId": "components/shadow-component",
  "category": "Canonical Usage",
  "defaultSeverity": "moderate",
  "lifecycle": "experimental",
  "fixAvailable": false,
  "evidenceRequired": true
}

Guidance

What it means

Fragments emitted FUI1007 from components/shadow-component because the scanned source conflicts with an active canonical-usage contract rule. The finding location and evidence identify the exact authored input that was evaluated.

How to resolve it

Review the finding evidence, then change the source or the authored governance configuration so components/shadow-component reflects the intended contract. Do not hide the finding with a broad repository exclude; use a rule-specific exclude or a line-attached, reasoned suppression only when the exception is intentional.

Verify the change

Run npx @usefragments/cli check --changed --format agent, inspect the resulting evidence, and then run npx @usefragments/cli check --changed --ci. If the finding changes identity, review baseline churn instead of silently regenerating the baseline.