releasekit/docs/internal/overview.md

# Internal package inventory

Public facades and their contracts are defined in Go declarations and GoDoc.
The [runtime consumer guide](../consumers/runtime-version.md) covers application
usage, and the [CLI contract](../cli.md) covers command behavior.

Implemented internal packages:

- `internal/runtimeinfo` holds the injected version value and selects the
  executable's main-module version when no injected value is present.
- `internal/versioncontract` names the linker symbol shared with the future
  release builder.
- `internal/apicheck` checks compiled exports with `go/types` and checks import
  direction. Run it with `go run ./internal/apicheck` from the repository root.
- `internal/process` runs cancellable child commands with per-child environment
  overlays.
- `internal/candidate` captures and validates one clean local candidate, checks
  its committed release note and local tag state, runs validation once, and
  rechecks mutable repository state.
- `internal/git` resolves one effective push destination, applies it to a
  command-scoped remote, reads exact authoritative branch and tag refs, and
  creates and pushes exact annotated tag objects.
- `internal/publish` coordinates local and remote guards around one validation
  run and reports the publication state reached by that invocation.
- `cmd/releasekit/internal/cli` parses implemented commands, loads strict JSON
  profiles, and adapts configured checks to the process runner.

The executable controller uses the runtime facade and the command-owned CLI
adapter. The adapter uses the process runner and imports neither public facade.
The publication operation coordinates the candidate and Git packages. Build
and Gitea implementation packages will be added as those responsibilities land.