WORK-455
ID:WORK-455Status:done

Reference template fixture and scaffold-build CI

SPEC-109 §6,§3 — ship exactly one in-repo reference template as a fixture/worked example, and scaffold-build it in CI so rune-syntax drift can't silently rot a template.

Priority:mediumComplexity:moderateMilestone:v0.25.0Source:SPEC-109
main View source

Criteria completion

Criteria completion: 4 of 4 (100%) checked; history from Jun 23 to Jun 240%25%50%75%100%Jun 23Jun 24

Relationships

Implements 1
Related 4
Branches 3
main current done
changeset-release/main doneclaude/v0.25.0-impl-3 doneclaude/v0.25.0-workitems ready
History 3
  1. ac87cf4
    • ☑ Exactly one in-repo reference template exists, framed as a fixture/worked example (a generic multi-section starter), not a catalog
    • ☑ CI scaffolds it, builds it, and asserts no errors; extended with the {% ref "SPEC-094" /%} visual-regression harness where applicable
    • ☑ It dogfoods the `template.json` manifest and is the canonical example third-party authors copy
    • ☑ It stays content-only/generic (sandbox-bearing templates are downstream artifacts, not shipped in-repo)
    by bjornolofandersson
  2. dede57e
    Created (ready)by bjornolofandersson
  3. a6bdcba
    Content editedby Claude
    plan(v0.25.0): accept specs/ADRs and decompose into 21 work items

Acceptance Criteria

  • Exactly one in-repo reference template exists, framed as a fixture/worked example (a generic multi-section starter), not a catalog
  • CI scaffolds it, builds it, and asserts no errors; extended with the SPEC-094 visual-regression harness where applicable
  • It dogfoods the template.json manifest and is the canonical example third-party authors copy
  • It stays content-only/generic (sandbox-bearing templates are downstream artifacts, not shipped in-repo)

Approach

Add the template under a fixtures path, authored against the format (WORK-451) and installable via the axis (WORK-452) + apply (WORK-453). Add a CI job that scaffolds + builds it; hook into the existing gallery/regression harness if practical.

Dependencies

  • WORK-451 — template.json type
  • WORK-452 — framework × purpose axis
  • WORK-453 — template apply

References

  • SPEC-109 §6, §3; SPEC-094

Resolution

Completed: 2026-06-24

Branch: claude/v0.25.0-impl-3. Shipped exactly one in-repo reference template — packages/create-refrakt/templates/docs-starter/ (template.json kind:"site" + a generic multi-section content/ tree, content-only/generic, no sandboxes). It's the bundled template create-refrakt --template docs-starter resolves, dogfoods the manifest, and is the canonical example authors copy. apply-template.test.ts scaffolds+composes it and asserts no errors (the scaffold guard), and validates the manifest shape.

Note

The composition guard runs as a unit test; a full vite build of the scaffolded site + the SPEC-094 visual-regression harness is the CI extension (needs the full adapter toolchain, not runnable as a pure unit test here).