32 lines
1.7 KiB
Markdown
32 lines
1.7 KiB
Markdown
# 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.
|