WORK-463
ID:WORK-463Status:ready

Rename sandbox runtime directory examples to sandboxes with migration

ADR-022 — rename the sandbox runtime directory config from examples/examplesDir to sandbox/dir, with a backwards-compatible migration. The template specs (SPEC-109 §7) reference the new naming.

Priority:mediumComplexity:simpleMilestone:v0.25.0Source:ADR-022
claude/v0.25.0-workitems View source

Criteria completion

Criteria completion: 0 of 4 (0%) 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 2
Branches 4
claude/v0.25.0-workitems current ready
main donechangeset-release/main doneclaude/v0.25.0-impl-3 doneclaude/v0.25.0-impl done
History 1
  1. a6bdcba
    Created (ready)by bjornolofandersson

Acceptance Criteria

  • SiteConfig.sandbox.examplesDir is renamed to sandbox.dir (type + readers/writers); the old name is accepted with a deprecation warning during a migration window
  • assembleFromDirectory and the sandbox sources reader use the new field
  • A migration note (and codemod where practical) updates existing configs
  • Docs and {% sandbox %} references use the new naming

Approach

Update packages/types/src/theme.ts (SiteConfig.sandbox) and packages/runes/src/sandbox-sources.ts. Read both names for a release, preferring the new one and warning on the old.

References

  • ADR-022; packages/runes/src/sandbox-sources.ts; packages/types/src/theme.ts