project

Documentation

Overview

Package project carries the build identity of the agentlab binary: its version, git commit and build time. The generated Makefile (devctl) and the architect CI stamp them through `-ldflags -X`; a plain `go build` or `go install` has no ldflags and falls back to the module build info, which Go 1.24+ derives from the VCS tag of the checkout.

Index

• Constants
• func BuildTimestamp() string
• func GitSHA() string
• func Version() string
• func VersionLine() string

Constants

const (
	Name   = "agentlab"
	Source = "https://github.com/giantswarm/agentlab"
)

Name and Source identify the project in messages and reports.

Functions

func BuildTimestamp

func BuildTimestamp() string

BuildTimestamp returns the build (or, unstamped, the commit) time in RFC 3339, or "" when unknown.

func GitSHA

func GitSHA() string

GitSHA returns the commit the binary was built from, or "" when unknown.

func Version

func Version() string

Version returns the agentlab version in the form the tags use ("v0.17.0"): the linker-stamped one when the binary came out of make or the release pipeline; else the module version Go recorded, which is the tag for `go install …@v0.17.0` and for a `go build` at the tag, a pseudo-version between tags, and carries "+dirty" over local edits; else "dev".

func VersionLine

func VersionLine() string

VersionLine is what `agentlab --version` prints after the name: "v0.17.0 (commit 8b5caa0, built 2026-09-07T10:00:00Z)".