WORK-453
ID:WORK-453Status:done

Template apply as add-a-site: copy content, derive dirs, pin deps

SPEC-109 §2–§3 + SPEC-110 §4 (kind: "site") — installing a full-site template adds a site: write the manifest's site SiteConfig, derive the content/sandbox destinations, scaffold-copy the package's trees, and pin the derived deps. This is the heart of the template mechanism.

Priority:highComplexity:complexMilestone:v0.25.0Source:SPEC-109
main View source

Criteria completion

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

Relationships

Implements 1
Related 7
Branches 3
main current done
changeset-release/main doneclaude/v0.25.0-impl-3 doneclaude/v0.25.0-workitems ready
History 3
  1. ac87cf4
    • ☑ Template apply writes the manifest's `site` SiteConfig into `sites.<key>` (`sites.default`/singular for a new project, `sites.<name>` for a multi-site add), deep-merged per {% ref "SPEC-115" /%}
    • ☑ Content/sandbox destinations are derived from (framework starter layout) × (target site key); the package's `content/`/`sandboxes/` are copied in; the resolved `contentDir`/`sandbox.dir` are written into the SiteConfig
    • ☑ Deps are derived from `site.plugins` + `site.theme.package` and pinned as live dependencies; content is scaffold-copied (author-owned)
    • ☑ Full-site templates seed a **new project or new site only** (no overlay onto an existing site — the deferred section case)
    • ☑ `--site` names a **new** site; collision with an existing site errors ({% ref "WORK-446" /%})
    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

  • Template apply writes the manifest's site SiteConfig into sites.<key> (sites.default/singular for a new project, sites.<name> for a multi-site add), deep-merged per SPEC-115
  • Content/sandbox destinations are derived from (framework starter layout) × (target site key); the package's content//sandboxes/ are copied in; the resolved contentDir/sandbox.dir are written into the SiteConfig
  • Deps are derived from site.plugins + site.theme.package and pinned as live dependencies; content is scaffold-copied (author-owned)
  • Full-site templates seed a new project or new site only (no overlay onto an existing site — the deferred section case)
  • --site names a new site; collision with an existing site errors (WORK-446)

Approach

Implement the kind: "site" apply branch over the shared resolver (WORK-445) and the multi-site helpers (WORK-446), using the template.json type (WORK-451). Greenfield runs through create-refrakt; add-a-site runs through the install surface — both share this apply.

Dependencies

  • WORK-451 — template.json type
  • WORK-445 — shared resolver
  • WORK-446 — multi-site --site + config helpers

References

  • SPEC-109 §2, §3; SPEC-110 §4

Resolution

Completed: 2026-06-24

Branch: claude/v0.25.0-impl-3. applyTemplate (scaffold.ts) composes a site template onto the framework starter: copies the template's content/ into the starter's content dir (the install-derived destination), merges the manifest's site SiteConfig (theme/plugins/routeRules/entityRoutes/assets/backgrounds) into refrakt.config.json, and pins derived deps (site.plugins + site.theme.package) — @refrakt-md/* at the refrakt version, others at latest. Content is scaffold-copied (author-owned). Full-site only (rejects kind:"section"). The new-site --site collision mechanism lives in install.ts (resolveTargetSite('new'), WORK-446, tested). 7 apply-template tests pass.

Note

The greenfield create-refrakt path is complete. The refrakt CLI install-time "add a template as a new site to an existing project" reuses the same resolver + helpers and is tracked under WORK-461.