Initial commit

Assisted-by: GLM 5.3

internal/version/version.go

@@ -0,0 +1,20 @@
+// Copyright (c) 2026 Petr Balvín <opensource@petrbalvin.org> (https://petrbalvin.org)
+// SPDX-License-Identifier: PolyForm-Noncommercial-1.0.0
+
+// The volumen release identity.
+package version
+
+import "runtime/debug"
+
+// Version reports the release the toolchain recorded for this build: the
+// tag when the checkout is at one, a pseudo-version naming the commit
+// otherwise, and (devel) outside version control. Nothing writes a version
+// number, so the recorded value cannot go stale, and a dirty tree reports
+// +dirty honestly.
+func Version() string {
+	bi, ok := debug.ReadBuildInfo()
+	if !ok || bi.Main.Version == "" {
+		return "(devel)"
+	}
+	return bi.Main.Version
+}

internal/version/version_test.go

@@ -0,0 +1,19 @@
+// Copyright (c) 2026 Petr Balvín <opensource@petrbalvin.org> (https://petrbalvin.org)
+// SPDX-License-Identifier: PolyForm-Noncommercial-1.0.0
+
+package version
+
+import (
+	"strings"
+	"testing"
+)
+
+func TestVersionReportsABuild(t *testing.T) {
+	v := Version()
+	if v == "" {
+		t.Fatal("Version() = empty, want the recorded version or (devel)")
+	}
+	if strings.ContainsAny(v, " \t\n") {
+		t.Fatalf("Version() = %q, want a single token", v)
+	}
+}