WORK-059
ID:WORK-059Status:done

Metadata Dimensions on StructureEntry

Priority:highComplexity:moderateMilestone:v0.9.0
claude/align-sidenav-styling-4MuxV View source

Criteria completion

No incremental history — criteria tracking started on Apr 17.

Relationships

Implements 1
Related 1
Branches 3
claude/align-sidenav-styling-4MuxV current done
main doneclaude/file-naming-convention-LJdwR donechangeset-release/main done
History 3
  1. 4954888
    Content editedby Claude
    feat(transform): add metadata dimensions to StructureEntry (WORK-059)
  2. a129a9e
    Content editedby Claude
    Assign all new work items (WORK-051–068) to v0.9.0 milestone
  3. a333007
    Created (done)by Claude
    Add work items for SPEC-024 (Metadata) and SPEC-025 (Universal Theming)

Summary

Add three semantic metadata fields to the StructureEntry interface: metaType, metaRank, and sentimentMap. The identity transform reads these from rune configs and emits data-meta-type, data-meta-rank, and data-meta-sentiment attributes on generated badge elements. This is the foundation that enables themes to style every metadata badge generically with ~18 CSS rules.

Acceptance Criteria

  • StructureEntry in packages/transform/src/types.ts gains metaType, metaRank, and sentimentMap optional fields
  • Identity transform engine emits data-meta-type when metaType is present on a structure entry child
  • Identity transform engine emits data-meta-rank when metaRank is present
  • Identity transform engine resolves sentiment by looking up the current modifier value in sentimentMap, emitting data-meta-sentiment when a match exists
  • Existing structure entries without metadata fields continue to work unchanged (backwards compatible)
  • refrakt inspect output shows the new data attributes on badge elements
  • Unit tests in packages/transform/test/ verify metadata attribute emission for: status with sentiment, category without sentiment, temporal, quantity, tag, and id types

Approach

  1. Extend StructureEntry interface in packages/transform/src/types.ts with the three optional fields
  2. In packages/transform/src/engine.ts, in the code path that processes structure entry children, add logic to: read metaType and emit data-meta-type, read metaRank and emit data-meta-rank, look up the current modifier value in sentimentMap and emit data-meta-sentiment if found
  3. The existing data-{modifier-name} attributes continue to be emitted as before — metadata attributes are additive

References

  • SPEC-024 (Metadata System — Extending StructureEntry, Identity Transform)