Skip to content

Migration guide — v0.1.x (initial release)

This is the first tagged release of golusoris. No breaking changes from pre-alpha main — this guide documents the stable API surface established at v0.1.0.

Core changes from pre-alpha

config.Config is now always passed as *config.Config

fx params structs must use *config.Config (pointer), not config.Config (value). The value form triggers a govet copylocks error because Config embeds a mutex.

Before:

type params struct {
    fx.In
    Config config.Config
}

After:

type params struct {
    fx.In
    Config *config.Config
}

clock.Clock replaces all time.Now() calls

All time operations in framework code use the injected clockwork.Clock. In fx-wired code, accept clock.Clock via fx.In. In tests, use clockwork.NewFakeClock().

Before:

ts := time.Now()

After:

// in production:
ts := clk.Now()  // clk clockwork.Clock injected via fx

// in tests:
fake := clockwork.NewFakeClock()
fake.Advance(5 * time.Second)

Errors must wrap with fmt.Errorf("pkg: action: %w", err)

All errors must be wrapped following the pkg: action: upstream convention. Bare err returns (without wrapping) cause wrapcheck lint failures.

New modules in v0.1.0

All modules from Steps 1–24 are considered stable API in v0.1.0. See README.md "Landed so far" for the full list.

Config key changes

None — this is the initial release establishing the config schema.

Deprecated symbols

None in v0.1.0.