# description
Canonical format for design verification findings. A superset schema that accommodates designesy, Google design.md, Lighthouse, and jakubkrehel/skills outputs. Agents consuming findings from multiple verifiers need a common schema.

# properties.schemaVersion.description
Schema version. Increment on breaking changes.

# properties.generatedAt.description
ISO 8601 timestamp when the report was generated.

# properties.tool.description
The verification tool that produced this report.

# properties.tool.properties.version.description
Tool version. designesy contract version (v0.3.0), Lighthouse version (12.0.0), etc.

# properties.tool.properties.userAgent.description
User agent if the tool fetched the subject via HTTP.

# properties.subject.properties.type.description
The kind of subject: a live URL, a file path, a token spec, etc.

# properties.subject.properties.requested.description
The URL or path as supplied to the tool.

# properties.subject.properties.final.description
The final URL after redirects (if different from requested).

# properties.config.description
Tool configuration (ruleset, thresholds, categories enabled). Opaque.

# properties.coverage.description
Scope and coverage table (jakubkrehel pattern). One row per domain reviewed.

# properties.coverage.items.properties.domain.description
Review domain: accessibility, layout, writing, typography, colors, ui, tokens, motion, security, spec.

# properties.coverage.items.properties.evidenceInspected.description
What was examined (CSS, HTML, screenshots, code).

# properties.coverage.items.properties.result.description
Findings count, "Clear", or "Not reviewed: reason".

# properties.categories.description
Category scores (designesy categoryScores, Lighthouse categories). Each category gets a 0-100 score.

# properties.categories.items.properties.score.description
Category score 0-100 (designesy) or 0-1 (Lighthouse). null if unscored.

# properties.categories.items.properties.weight.description
Category weight in the composite score (designesy).

# properties.findings.description
Individual check findings. Each finding is one check result from the verification engine.

# properties.consideredButRejected.description
Findings considered during review but rejected (jakubkrehel pattern). Opaque for most tools.

# properties.verification.description
Verification steps taken (jakubkrehel pattern). Commands run, interactions tested.

# properties.summary.properties.countsByStatus.description
Count of findings by status (designesy native terminology).

# properties.summary.properties.countsBySeverity.description
Count of findings by severity (normalized across tools).

# properties.summary.properties.countsBySeverity.properties.error.description
Maps to designesy FAIL, Google error, Lighthouse fail.

# properties.summary.properties.countsBySeverity.properties.info.description
Maps to Google info, Lighthouse informative.

# properties.summary.properties.countsBySeverity.properties.pass.description
Maps to designesy PASS, Lighthouse pass.

# properties.summary.properties.countsBySeverity.properties.skip.description
Maps to designesy SKIP, Lighthouse notApplicable/manual.

# properties.summary.properties.scored.description
Number of findings that contributed to the score (excludes SKIP).

# properties.summary.properties.a11yFloorApplied.description
Whether the accessibility floor was applied (designesy-specific).

# properties.summary.properties.categoryScores.additionalProperties.description
Per-category 0-100 score. null if unscored.

# properties.summary.properties.categoryScores.description
Shorthand map of category id to score for quick access.

# properties.verdict.description
Overall verdict. pass = no FAIL/error findings; fail = at least one FAIL/error; block = any HIGH (jakubkrehel); needs-changes = only WARN remaining; approve = no actionable findings; not-scored = all SKIP.

# properties.runtimeError.description
Fatal error if the tool could not complete. If present, findings may be incomplete.

# properties.raw.description
Native tool output preserved verbatim for lossless round-trip. Consumers that need the original shape can read this.

# $defs.finding.description
One verification finding (one check result).

# $defs.finding.properties.id.description
Check identifier (designesy v01-v37, Lighthouse audit id, Google rule name).

# $defs.finding.properties.item.description
Human-readable check name (designesy item field).

# $defs.finding.properties.category.description
Check category (designesy: cadence, accessibility, motion, tokens, etc.). Maps to Lighthouse categoryId and jakubkrehel domain.

# $defs.finding.properties.severityRaw.description
The native severity token verbatim (e.g. "PASS", "warning", "HIGH"). Preserved for lossless round-trip.

# $defs.finding.properties.status.description
designesy-native status. Equivalent to severity but using designesy terminology.

# $defs.finding.properties.message.description
Human-readable finding detail. designesy detail, Google message, Lighthouse explanation.

# $defs.finding.properties.detail.description
Extended detail string (designesy detail field). May overlap with message.

# $defs.finding.properties.remediation.description
How to fix this finding (designesy remediation guidance).

# $defs.finding.properties.locations.description
Multiple locations for a systemic finding (jakubkrehel consolidation).

# $defs.finding.properties.domain.description
Review domain (jakubkrehel: accessibility, layout, writing, typography, colors, ui).

# $defs.finding.properties.why.description
Violated principle + user impact (jakubkrehel why column).

# $defs.finding.properties.score.description
Numeric score 0-1 (Lighthouse audit score). null if not scored.

# $defs.finding.properties.numericValue.description
Raw metric value (Lighthouse: ms, bytes, count).

# $defs.finding.properties.displayValue.description
Display string for the metric (Lighthouse).

# $defs.finding.properties.scoreDisplayMode.description
How the score is displayed (Lighthouse).

# $defs.finding.properties.weight.description
Check weight in the category (designesy per-check weight, Lighthouse auditRef weight).