WORK-068
ID:WORK-068Status:done

Inspector Dimensions Audit

Priority:mediumComplexity:simpleMilestone:v0.9.0Source:SPEC-025
changeset-release/main View source

Criteria completion

No incremental history — criteria tracking started on Apr 19.

Relationships

Implements 1
Branches 3
changeset-release/main current done
main doneclaude/file-naming-convention-LJdwR doneclaude/align-sidenav-styling-4MuxV done
History 6
  1. f2b3512
    Content editedby Claude
    Add {ID}-{slug}.md filename convention + migrate filenames subcommand
  2. 59ded4a
    Content editedby Claude
    Implement SPEC-037 plan package hardening: all 7 work items
  3. f262d7b
    Content editedby Claude
    Backfill source attributes on all 123 work items
  4. ef043bd
    Content editedby Claude
    feat(cli): add --audit-dimensions to refrakt inspect (WORK-068)
  5. a129a9e
    Content editedby Claude
    Assign all new work items (WORK-051–068) to v0.9.0 milestone
  6. a333007
    Created (done)by Claude
    Add work items for SPEC-024 (Metadata) and SPEC-025 (Universal Theming)

Summary

Add a --audit-dimensions flag to refrakt inspect that verifies universal theming dimension coverage: surface assignments, density theming, section anatomy theming, interactive state theming, and media slot theming. Flags community runes missing surface assignments and any dimension values without corresponding theme CSS.

Acceptance Criteria

  • refrakt inspect --audit-dimensions shows surface assignments with rune counts and unassigned runes
  • Audit shows density coverage across all three levels
  • Audit shows section anatomy coverage for all 6 section roles
  • Audit shows interactive state coverage
  • Audit shows media slot coverage for all 5 slot types
  • Community runes with dimensions but no surface assignment are flagged
  • --json flag works with --audit-dimensions

Approach

Extend the inspector audit. Walk all rune configs collecting dimension declarations. Walk theme CSS collecting [data-density], [data-section], [data-state], [data-media] selectors. Cross-reference and report gaps.

References

  • SPEC-025 (Universal Theming Dimensions — Inspector Audit)