v0-1-to-v0-2

star 4

Migrate a forge project from v0.1's two-phase Bootstrap+Setup+ApplyDeps DI shape to v0.2's codegen-based wire_gen.go single-phase DI. The change unifies dep construction so validateDeps gates the COMPLETE dep set at New(), eliminating per-RPC nil-check boilerplate. Use when bumping forge_version from v0.1 to v0.2.

reliant-labs By reliant-labs schedule Updated 6/12/2026
play_arrow Run Skill in Manus View GitHub

name: v0.1-to-v0.2 description: TOMBSTONE — retired migration. v0.2's name-matched wire_gen.go DI (pkg/app/{wire_gen,app_gen,app_extras}.go, AppExtras exact-name resolution) was itself removed. Do NOT migrate toward this shape. To arrive at the current explicit composition root, use v0.x-to-typed-di (and v0.x-to-serverkit-composed for the typed-mount cmd layer). relevance: migration

Migrating from forge v0.1 to v0.2 — RETIRED

This migration target no longer exists. Do not follow it.

v0.2 introduced a codegen-based, name-matched DI shape: pkg/app/wire_gen.go with one wireXxxDeps(app, cfg, logger) per service, an *App god-struct, and a user-extension AppExtras whose fields wire_gen resolved against each Deps field by EXACT NAME. That whole pkg/app DI unit has since been deleted. Name-matching silently dropped narrow-interface mismatches (a consumer's narrow Repository interface vs the concrete *PostgresRepository field would be skipped, leaving a nil hazard at runtime), so it was replaced by explicit, compile-checked composition.

If you are upgrading a project that is still on the v0.1 Bootstrap+Setup+ApplyDeps shape, or on the v0.2 wire_gen.go shape, do NOT migrate to wire_gen.go. Migrate straight to the current explicit composition root:

  • migrations/v0.x-to-typed-di — the canonical "arrive at the explicit composition root" upgrade. The destination is an OWNED internal/app/providers.go (Infra struct + OpenInfra) plus a generated internal/app/compose.go with func NewComponents(infra *Infra) (*Components, error) that resolves every Deps field BY TYPE — no *App, no AppExtras, no name match, no validateDeps-fires-too-early problem. A missing provider is a loud generate-/compile-time error.
  • migrations/v0.x-to-serverkit-composed — the matching cmd-layer upgrade: typed (*app.Components).Mount<Svc> mount selection and a real cobra subcommand per service, replacing string service-name selection through a registry.

Everything the old v0.1→v0.2 codemod did (promote setup-locals to fields, strip per-RPC nil-checks) is subsumed by those two migrations against the real, shipping shape.

Install via CLI
npx skills add https://github.com/reliant-labs/forge --skill v0-1-to-v0-2
Repository Details
star Stars 4
call_split Forks 1
navigation Branch main
article Path SKILL.md
More from Creator
reliant-labs
reliant-labs Explore all skills →