Go

The Go plugin discovers modules from go.work or a root go.mod, bumps versions, updates require directives, and publishes via git tags.

import { tegami } from "tegami";
import { go } from "tegami/plugins/go";

const paper = tegami({
  plugins: [go()],
});

How Go versioning works

Go modules do not store a version in go.mod. Tegami tracks versions differently from npm or Cargo:

• Current version is read from existing git tags (v1.0.0 for the root module, pkg/api/v1.0.0 for nested modules).
• Next version is written to the publish lock during tegami version, not to go.mod.
• Publishing creates git tags that the Go proxy picks up. Tegami delegates tagging to the git plugin.

Discovery

Tegami discovers modules with the go CLI:

• If go.work exists, every entry in use is scanned.
• Otherwise, the root go.mod is treated as a single-module workspace.

Each module's require and replace directives are read from go mod edit -json.

Dependency bumping

When a module is bumped, dependents with a require on that module are patch-bumped by default. Tegami also rewrites require directives when the new version falls outside the existing constraint.

Members of the same package group with syncBump are not auto-bumped when a sibling is released.

Customize this with bumpDep:

go({
  bumpDep: () => "minor",
});

Configuration

const paper = tegami({
  plugins: [
    go({
      updateLockFile: false,
    }),
  ],
});

After versioning, Tegami runs go work sync when a go.work file is present, or go mod tidy in each module otherwise.

Publishing

Publishing is handled through git tags, not a registry upload. Tegami:

1. Sets the tag for each module (v1.2.0 at the repo root, relative/path/v1.2.0 for nested modules).
2. Waits for workspace dependencies (from require and local replace directives) before publishing a module.
3. Waits for the git plugin to create (and push) the tags, a module publish fails when its tag work fails.
4. Checks proxy.golang.org to see whether a version is already available.

Package options

Disable publishing for specific modules with packages or groups:

tegami({
  plugins: [git(), go()],
  groups: {
    internal: {
      go: { publish: false },
    },
  },
  packages: {
    "example.com/acme/api": {
      go: { publish: true },
    },
  },
});

Package-level go.publish overrides the group default.