WORK-062
ID:WORK-062Status:done

Inspector Metadata Audit

Priority:mediumComplexity:simpleMilestone:v0.9.0Source:SPEC-024
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. 0f16019
    Content editedby Claude
    feat(cli): add --audit-meta flag to refrakt inspect (WORK-062)
  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-meta flag to refrakt inspect that verifies metadata configuration across all runes: which meta types are in use, which status/category fields have sentiment maps, and whether the theme provides CSS for all meta types and sentiments.

Acceptance Criteria

  • refrakt inspect --audit-meta shows meta types in use with rune counts
  • Audit shows sentiment coverage — which fields with sentiment maps vs. which lack them
  • Audit checks theme CSS for [data-meta-type], [data-meta-sentiment], and [data-meta-rank] selectors
  • Missing theme rules are flagged as warnings
  • Output is clear and actionable for theme developers
  • --json flag works with --audit-meta for programmatic use

Approach

Extend the existing inspector audit infrastructure. Walk all rune configs, collect structure entries with metaType, group by type/sentiment. Compare against CSS selectors found in the theme's stylesheets. Report gaps.

References

  • SPEC-024 (Metadata System — Inspector Audit)