WORK-338
ID:WORK-338Status:draft

Composability authoring contract + CLI coverage audit

The authoring-facing half of SPEC-084: a contract guide for rune authors plus a CLI audit. (The end-user catalog of concrete compositions lives separately in the "Compositions" docs category, WORK-346 — this item is the "how the contract works" reference, not the recipe book.)

Priority:mediumComplexity:moderateMilestone:v0.19.0Source:SPEC-084
changeset-release/main View source

Criteria completion

Criteria completion: 0 of 5 (0%) checked; tracking started on Jun 5, no incremental history yet0%25%50%75%100%Jun 5Jun 15

Tracking started Jun 5 — check back for trends.

Branches 3
History 5
  1. e1084e4
    Created (draft)by github-actions[bot]
  2. c09cb5a
    Content editedby Claude
    plan: de-link mutual refs in composition items to keep the dep graph acy
  3. 0543147
    Content editedby Claude
    plan: media-zone composition model — generalize 339, add bento + docs it
  4. 33c6175
    Content editedby Claude
    plan: revise SPEC-084 to an open-world composability model
  5. 33e11b7
    Content editedby Claude
    plan: shape v0.19.0 around polish, composability & rollups

Acceptance Criteria

  • A composability page under site/content/extend/rune-authoring/ documents the contract: the open-world principle (dependency asymmetry), open containers vs strict requiresParent children, the name-agnostic media-zone/slot styling model, and when to reach for a context modifier.
  • refrakt inspect/audit reports context modifiers that lack CSS coverage.
  • The audit reports requiresParent violations (a child outside its self-declared required parent) for a given content tree.
  • Audit output documented in the tooling docs.
  • The authoring guide cross-links to the "Compositions" catalog (WORK-346).

Approach

Extend the existing inspect/audit tooling (packages/cli) — it already derives selectors from config and checks CSS coverage, so the context-modifier check is an extension of that path. The guide is the contract reference; concrete worked patterns live in the compositions category.

References

  • packages/cli (inspect/audit), site/content/extend/rune-authoring/
  • Depends on SPEC-084; complements WORK-337; pairs with WORK-346