Stamp the git tag or short commit into the binary (closes #4)

A plain `docker build .` now stamps the version into bsdaily: the
VERSION build argument when one is given, otherwise `git describe
--tags --always` of the .git in the build context. The build fails if
the context carries .git and no version comes out. A host `make` build
stamps the same `git describe` value, or dev when it yields nothing.
bsdaily logs the version on the first line of every run and prints it
with --version.

The new .dockerignore is the canonical copy, which keeps .git/config
out of the build context, plus this repo's host-built artifacts.
script/docker is replaced with the canonical copy, which passes the
version it derives on the host.

Model: opus-5-5

.dockerignore

@@ -58,3 +58,8 @@
 **/.idea
 **/.vscode
 **/*.sublime-*
+
+# This repo's host-built artifacts: `make` and `make test-coverage`.
+/bsdaily
+/coverage.out
+/coverage.html

Makefile

@@ -1,7 +1,7 @@
 .PHONY: all bootstrap setup check test lint fmt fmt-check build clean deps test-coverage test-integration install release release-snapshot docker hooks
 
 # Stamped into the binary: the same `git describe` the Dockerfile runs, so a
-# host build reports the same version as the image.
+# host build reports the same version as the image; dev when it yields nothing.
 VERSION ?= $(shell git describe --tags --always)
 
 # Default target
@@ -37,7 +37,7 @@ lint:
 
 # Build binary (pure Go; no CGO required since we use modernc.org/sqlite).
 bsdaily: internal/*/*.go cmd/bsdaily/*.go
-	CGO_ENABLED=0 go build -ldflags "-X main.Version=$(VERSION)" -o $@ ./cmd/bsdaily
+	CGO_ENABLED=0 go build -ldflags "-X main.Version=$(or $(VERSION),dev)" -o $@ ./cmd/bsdaily
 
 # Clean build artifacts.
 clean:

TODO.md

@@ -15,14 +15,15 @@ pre-1.0
 # Next Step
 
 Bring the repo into policy compliance in one commit: add .gitignore,
-.dockerignore, .editorconfig, and .golangci.yml. Verify `make check` stays
-green with the new lint config.
+.editorconfig, and .golangci.yml. Verify `make check` stays green with the new
+lint config.
 
 # Completed Steps
 
 - 2026-10-02: A plain `docker build .` and a host `make` build stamp the git tag
-  or short commit into the binary, which `bsdaily --version` prints; added the
-  canonical `.dockerignore`, which keeps `.git/config` out of the build context.
+  or short commit into the binary, which `bsdaily` logs on the first line of
+  every run and prints with `--version`; added the canonical `.dockerignore`,
+  which keeps `.git/config` out of the build context.
 - 2026-07-07 Adopted scripts-to-rule-them-all: `script/` entrypoints,
   Makefile shims, README Entrypoints section
 - 2026-06-28: Fixed errcheck lint failures; added compilation smoke test;
@@ -39,8 +40,7 @@ green with the new lint config.
 
 # Future Steps
 
-- Add .gitignore, .dockerignore, .editorconfig, .golangci.yml (the Next
-  Step).
+- Add .gitignore, .editorconfig, .golangci.yml (the Next Step).
 - Expand tests beyond the compilation smoke test: unit tests for the
   extraction, verification, and atomic-publish paths.
 - Cut a first SemVer release once compliance and test coverage land.

cmd/bsdaily/main.go

@@ -11,8 +11,8 @@ import (
 )
 
 // Version is the git tag or short commit, set at link time with -X by the
-// Dockerfile and the Makefile, and printed by --version. Builds that do not set
-// it report dev.
+// Dockerfile and the Makefile, logged on the first line of every run and
+// printed by --version. Builds that do not set it report dev.
 var Version = "dev"
 
 func main() {
@@ -31,6 +31,8 @@ func main() {
 		Version:      Version,
 		SilenceUsage: true,
 		RunE: func(cmd *cobra.Command, args []string) error {
+			slog.Info("starting", "version", Version)
+
 			hasDate := dateFlag != ""
 			hasFrom := fromFlag != ""
 			hasTo := toFlag != ""