WORK-448
ID:WORK-448Status:in-progress

Bake ADR-023 peerDeps, compat range, devDeps and build wiring into scaffolds

ADR-023 compliance and the day-one-build guarantee (SPEC-116 §3–§4) must be embodied by every scaffold so an author starts correct rather than remembering the policy. This is the shared scaffolding helper the per-kind scaffolders consume.

Priority:highComplexity:moderateMilestone:v0.25.0Source:SPEC-116
claude/v0.25.0-impl View source

Criteria completion

Criteria completion: 2 of 6 (33%) checked; tracking started on Jun 23, no incremental history yet0%25%50%75%100%Jun 23Jul 11

Tracking started Jun 23 — check back for trends.

Relationships

Implements 1
Related 6
Branches 5
claude/v0.25.0-impl current in-progress
claude/milestone-v0-28-0-llvtfa donemain donechangeset-release/main doneclaude/v0.25.0-impl-2 doneclaude/v0.25.0-workitems ready
History 3
  1. 0a2f563
    Created (in-progress)by bjornolofandersson
  2. c36d24c
    Content editedby Claude
    plan(v0.25.0): renumber WORK-444 → WORK-465 to avoid collision with main
  3. a6bdcba
    Content editedby Claude
    plan(v0.25.0): accept specs/ADRs and decompose into 21 work items

Acceptance Criteria

  • Scaffolded packages declare @refrakt-md/* as peerDependencies with a minor range — no exact ordinary deps on @refrakt-md/*
  • The manifest carries a matching refrakt range, pinned to the scaffolding create-refrakt version (single source)
  • Scaffolds also seed matching devDependencies (same ranges) so the peer-only deps resolve for an isolated build
  • Build is wired (tsconfig, dist/ output, exports map) so every contract path resolving to built output works after npm install && npm run build with no hand-editing
  • A freshly scaffolded package passes its own manifest-validate; build and manifest-validate scripts are present
  • A JSON-carrier preset pack is contract-valid with no compile step

Approach

A shared helper produces the package.json deps block, tsconfig, exports map, and scripts, keyed by kind. Reuse the refrakt range util (the ADR-023 manifest-fields work item) and the create-refrakt version source that the site scaffold already uses for version derivation.

Dependencies

  • WORK-465 — the refrakt range field + checker
  • WORK-447 — the --type dispatch this hangs off

References

  • SPEC-116 §3, §4; ADR-023