extbin

var (
	// Go is the `go` binary itself (`go env`, `go build`). Reproducibility
	// comes from the go.mod toolchain directive + GOTOOLCHAIN.
	Go = Declare(Program{
		Name:        "go",
		Kind:        GoToolchain,
		InstallHint: "the Go toolchain (https://go.dev/dl)",
	})

	// SCC is the scc code-counter, pinned in go.mod's tool block and invoked as
	// `go tool scc`, falling back to an `scc` on PATH.
	SCC = Declare(Program{
		Name:        "scc",
		Kind:        GoTool,
		Module:      "github.com/boyter/scc/v3",
		InstallHint: "run via `go tool scc`, or install scc on PATH (https://github.com/boyter/scc)",
	})
)

var (
	// Git backs the governance tooling (commitdigest, repo, doclint) and repo
	// introspection (scctree).
	Git = Declare(Program{
		Name:        "git",
		Kind:        Host,
		InstallHint: "install git (https://git-scm.com)",
	})

	// Pijul backs the pushout pijul adapter.
	Pijul = Declare(Program{
		Name:        "pijul",
		Kind:        Host,
		InstallHint: "https://pijul.org/manual/installation.html",
	})
)

var (
	// TinyGo compiles the WASM survey probes. The airgap bundle ships a pinned
	// TinyGo distribution and points BOXER_TINYGO at it (ADR-0095), so an
	// offline target resolves the copy that was verified against the bundled Go
	// SDK rather than whatever PATH happens to offer.
	TinyGo = Declare(Program{
		Name:        "tinygo",
		Kind:        Host,
		OverrideEnv: "BOXER_TINYGO",
		InstallHint: "https://tinygo.org/getting-started/install/",
	})

	// Rustfmt formats generated Rust (egui2 driver output).
	Rustfmt = Declare(Program{
		Name:        "rustfmt",
		Kind:        Host,
		InstallHint: "rustup component add rustfmt",
	})

	// Cargo drives Rust builds in the deploy showcase.
	Cargo = Declare(Program{
		Name:        "cargo",
		Kind:        Host,
		InstallHint: "install the Rust toolchain (https://rustup.rs)",
	})

	// Bash runs shell build steps in the deploy showcase.
	Bash = Declare(Program{
		Name:        "bash",
		Kind:        Host,
		InstallHint: "install bash",
	})
)

var (
	Flamegraph = Declare(Program{
		Name:        "flamegraph",
		Kind:        Host,
		InstallHint: "cargo install flamegraph",
	})

	Valgrind = Declare(Program{
		Name:        "valgrind",
		Kind:        Host,
		InstallHint: "install valgrind (https://valgrind.org)",
	})

	Heaptrack = Declare(Program{
		Name:        "heaptrack",
		Kind:        Host,
		InstallHint: "install heaptrack",
	})
)

var (
	// Restorecon relabels SELinux contexts during deploy.
	Restorecon = Declare(Program{
		Name:        "restorecon",
		Kind:        Host,
		InstallHint: "part of policycoreutils (SELinux)",
	})

	// FcMatch resolves a font file path via fontconfig for the deploy showcase.
	FcMatch = Declare(Program{
		Name:        "fc-match",
		Kind:        Host,
		InstallHint: "install fontconfig",
	})

	// Systemctl restarts the service after an atomic deploy swap.
	Systemctl = Declare(Program{
		Name:        "systemctl",
		Kind:        Host,
		InstallHint: "systemd (systemctl) is required on the deploy host",
	})
)

var (
	// ClickHouseLocal runs one-shot SQL over local files (adr query, recordstore
	// exec, the chlocalpool worker, arrow formatting, mine-trends). Callers with
	// a configured binary path pass it via [Opts].Path.
	ClickHouseLocal = Declare(Program{
		Name:        "clickhouse-local",
		Kind:        Host,
		OverrideEnv: "BOXER_CLICKHOUSE_LOCAL",
		InstallHint: "https://clickhouse.com/docs/en/install",
	})
)

var PackageProps = packageprops.Props{
	WASMWASI:         packageprops.WASMCompiles,
	WASMJS:           packageprops.WASMCompiles,
	WASMFreestanding: packageprops.WASMCompiles,
}

var (
	// Rclone is both halves of the lading store's SFTP-over-stdio seam
	// (ADR-0198 §SD9): it runs the head in place of ssh to reach the store,
	// and ladingremote.Serve spawns `rclone serve sftp --stdio` on the other
	// side to snapshot a remote. That second half is shipped code, not a test
	// fixture — this declaration is the resolution chokepoint for it, which is
	// what makes the spawn auditable from here rather than from a call site.
	Rclone = Declare(Program{
		Name:        "rclone",
		Kind:        Host,
		OverrideEnv: "BOXER_RCLONE",
		InstallHint: "https://rclone.org/install/",
	})
)