WORK-446
ID:WORK-446Status:done

Multi-site --site targeting and config read/write helpers

Multi-site projects currently make theme install hard-error ("cannot pick a target automatically"). SPEC-110 §3 replaces that with a --site selector and extends the config read/write helpers. The flag's existence rules differ by apply-mode (select an existing site vs. name a new one), so the helpers must support both.

Priority:highComplexity:moderateMilestone:v0.25.0Source:SPEC-110
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 3
Branches 3
main current done
changeset-release/main doneclaude/v0.25.0-impl doneclaude/v0.25.0-workitems ready
History 3
  1. f6e6a38
    • ☑ `--site <name>` selects the target site; inferred when exactly one site exists; when multiple exist and `--site` is absent, list the site names and exit cleanly (no dead end)
    • ☑ `readThemeFromConfig` / `writeThemeIntoConfig` accept an explicit site key and can **create** a new site entry, not only update an existing one
    • ☑ Adding a second site to a singular `site:` config rewrites it to plural `sites: { default, <new> }`
    • ☑ Helpers are shared so the theme / template / preset apply-modes reuse them
    • ☑ Tests cover single-site infer, multi-site select, missing-flag listing, and singular→plural rewrite
    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

  • --site <name> selects the target site; inferred when exactly one site exists; when multiple exist and --site is absent, list the site names and exit cleanly (no dead end)
  • readThemeFromConfig / writeThemeIntoConfig accept an explicit site key and can create a new site entry, not only update an existing one
  • Adding a second site to a singular site: config rewrites it to plural sites: { default, <new> }
  • Helpers are shared so the theme / template / preset apply-modes reuse them
  • Tests cover single-site infer, multi-site select, missing-flag listing, and singular→plural rewrite

Approach

Extend the helpers in packages/cli/src/commands/theme.ts / config-file.ts to take a site key and to distinguish "update existing" from "create new" (the latter is what full-site template install needs). Normalise singular↔plural config shapes in one place.

References

  • SPEC-110 §3
  • packages/cli/src/commands/theme.ts, packages/cli/src/config-file.ts, packages/types/src/theme.ts

Resolution

Completed: 2026-06-23

Branch: claude/v0.25.0-impl

What was done

  • install.ts site helpers: listSiteKeys, resolveTargetSite(raw, --site, 'existing'|'new'), setSiteTheme(key), appendSitePreset(key), createSite(key) (migrates singular site: → plural sites:{default,<new>}).
  • themeInstallCommand/themeInfoCommand take --site; ambiguous multi-site lists keys and exits cleanly instead of the old hard error.
  • bin.ts parses --site/--registry for the theme subcommand.
  • Tests cover single-site infer, multi-site select, missing-flag listing, collision on new-site, and singular→plural rewrite.

Notes

  • Helpers live in the shared install module so template (new-site) and preset (append) apply-modes reuse them.