WORK-445
ID:WORK-445Status:ready

Shared install resolver: tarball name, registry passthrough, source-type detection

theme install resolves only directories and registry names and dead-ends on .tgz tarballs (pluginName = ''). SPEC-110 §1–§2,§4 factor source resolution into one helper that theme, template, and preset-pack install all call — so the tarball/registry improvements land once.

Priority:highComplexity:moderateMilestone:v0.25.0Source:SPEC-110
claude/v0.25.0-workitems View source

Criteria completion

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

Acceptance Criteria

  • A shared resolver detects source type (local directory | .tgz tarball | registry specifier) and returns a concrete package name + version
  • Tarball resolution reads package/package.json from inside the archive up front; the .tgz branch no longer dead-ends to "install from the unzipped directory"
  • --registry <url> is passed through to the detected package manager; .npmrc/scope config is honoured; refrakt stores no credentials
  • theme install is refactored onto the shared resolver with no regression for the directory/registry-name cases
  • Unit tests cover each source type, including a malformed tarball

Approach

Extract resolution from packages/cli/src/commands/theme.ts into a reusable helper. Use a minimal tar reader (or an existing dependency) for the .tgz case. Package-manager detection stays in config-file.ts. The resolver returns { name, version, source }; the apply-mode is a separate concern (the kind-keyed apply work item).

References

  • SPEC-110 §1, §2, §4
  • packages/cli/src/commands/theme.ts, packages/cli/src/config-file.ts