store stabilised production version

Author: source-c

.golangci.yml

@@ -39,6 +39,10 @@ linters:
     rules:
       - path: (.+)\.go$
         text: G104
+      - path: (.+)\.go$
+        text: G115
+      - path: (.+)\.go$
+        text: G117
       - path: (.+)\.go$
         text: SA1019
       - path: (.+)\.go$
@@ -72,7 +76,6 @@ formatters:
       sections:
         - standard
         - default
-        - prefix(pkg.hiveon.dev)
         - alias
       custom-order: true
   exclusions:

Makefile

@@ -17,6 +17,11 @@ MOCKS_DIR := $(CURDIR)/internal/mocks
 
 DEFAULT_TARGET ?= $(BUILD_DIR)/usm
 VERSION ?= $(shell git describe --tags --always --dirty 2>/dev/null || echo "dev")
+BUILD_ID ?= $(shell git rev-parse --short HEAD 2>/dev/null || echo "unknown")
+BUILD_TIME ?= $(shell date -u '+%Y-%m-%dT%H:%M:%SZ')
+LDFLAGS := -X apps.z7.ai/usm/internal/usm.BuildVersion=$(VERSION) \
+           -X apps.z7.ai/usm/internal/usm.BuildID=$(BUILD_ID) \
+           -X apps.z7.ai/usm/internal/usm.BuildTime=$(BUILD_TIME)
 
 default: clean lint build
 	@:
@@ -73,7 +78,7 @@ generate-mocks: .build-mockery
 
 build:
 	@echo "${GREEN}# Building all binaries...${NOCOLOR}"
-	go build -o ${DEFAULT_TARGET} ./main.go
+	go build -ldflags '$(LDFLAGS)' -o ${DEFAULT_TARGET} ./main.go
 
 generate-integrations:
 	@echo "${GREEN}# Generating desktop integration files...${NOCOLOR}"
@@ -128,7 +133,7 @@ package-macos: build-with-integrations
 
 fmt: .build-fmt-tools
 	@echo "${GREEN}# Running gci fmt${NOCOLOR}"
-	gci write --skip-generated -s standard -s default -s 'prefix(pkg.hiveon.dev)' -s alias --custom-order .
+	gci write --skip-generated -s standard -s default -s alias --custom-order .
 	@echo "${GREEN}# Running gofumpt${NOCOLOR}"
 	gofumpt -w -l .
 
@@ -147,6 +152,8 @@ help:
 	@echo ""
 	@echo "Environment variables:"
 	@echo "  VERSION                 - Set version for packages (default: git describe or 'dev')"
+	@echo "  BUILD_ID                - Build identifier (default: git short commit hash)"
+	@echo "  BUILD_TIME              - Build timestamp (default: current UTC time)"
 
 .build-macos-icns:
 	@echo "${GREEN}# Building .icns from logo/usm.png (cross-platform)...${NOCOLOR}"

README.md

@@ -51,6 +51,20 @@ make generate-integrations
 - [Configuration Management](docs/configuration.md) - Versioned configuration system using Viracochan
 - [Desktop Integrations](docs/integrations.md) - Desktop integration file generation for Linux and macOS
 
+## Build identification
+
+Each binary built via `make build` embeds version, build ID (git commit) and build time via linker flags.
+
+```
+$ usm cli version
+usm version v1.0.0 (abc1234 2026-03-05T12:00:00Z)
+instance: 550e8400-e29b-41d4-a716-446655440000
+```
+
+The **instance ID** is a UUID v4 generated on first run and persisted in the application state (`usm.json`). It uniquely identifies a USM installation for backup and synchronization purposes.
+
+When building outside of `make`, the version falls back to Go module metadata or `(unknown)`.
+
 ## How it works - cryptography details
 
 ### Vault initialization

go.mod

@@ -1,20 +1,20 @@
 module apps.z7.ai/usm
 
-go 1.24
+go 1.25.0
 
 require (
-	filippo.io/age v1.2.1
-	fyne.io/fyne/v2 v2.6.2
+	filippo.io/age v1.3.1
+	fyne.io/fyne/v2 v2.7.3
 	github.com/fyne-io/image v0.1.1
-	github.com/godbus/dbus/v5 v5.1.0
-	github.com/source-c/viracochan v0.1.0
-	github.com/stretchr/testify v1.10.0
+	github.com/godbus/dbus/v5 v5.2.2
+	github.com/source-c/viracochan v0.1.1
+	github.com/stretchr/testify v1.11.1
 	golang.design/x/clipboard v0.7.1
-	golang.org/x/crypto v0.41.0
-	golang.org/x/image v0.30.0
-	golang.org/x/net v0.43.0
-	golang.org/x/sync v0.16.0
-	golang.org/x/term v0.34.0
+	golang.org/x/crypto v0.48.0
+	golang.org/x/image v0.36.0
+	golang.org/x/net v0.51.0
+	golang.org/x/sync v0.19.0
+	golang.org/x/term v0.40.0
 	gopkg.in/natefinch/npipe.v2 v2.0.0-20160621034901-c1b8fa8bdcce
 )
 
@@ -23,47 +23,60 @@ require (
 replace golang.org/x/mobile => github.com/fyne-io/gomobile-bridge v0.1.0
 
 require (
-	fyne.io/systray v1.11.0 // indirect
+	filippo.io/hpke v0.4.0 // indirect
+	fyne.io/systray v1.12.0 // indirect
 	github.com/BurntSushi/toml v1.5.0 // indirect
-	github.com/btcsuite/btcd/btcec/v2 v2.3.4 // indirect
+	github.com/ImVexed/fasturl v0.0.0-20230304231329-4e41488060f3 // indirect
+	github.com/btcsuite/btcd/btcec/v2 v2.3.6 // indirect
 	github.com/btcsuite/btcd/chaincfg/chainhash v1.1.0 // indirect
+	github.com/bytedance/gopkg v0.1.3 // indirect
+	github.com/bytedance/sonic v1.15.0 // indirect
+	github.com/bytedance/sonic/loader v0.5.0 // indirect
+	github.com/cloudwego/base64x v0.1.6 // indirect
+	github.com/coder/websocket v1.8.14 // indirect
 	github.com/davecgh/go-spew v1.1.1 // indirect
-	github.com/decred/dcrd/crypto/blake256 v1.0.1 // indirect
-	github.com/decred/dcrd/dcrec/secp256k1/v4 v4.3.0 // indirect
+	github.com/decred/dcrd/crypto/blake256 v1.1.0 // indirect
+	github.com/decred/dcrd/dcrec/secp256k1/v4 v4.4.1 // indirect
 	github.com/fredbi/uri v1.1.1 // indirect
 	github.com/fsnotify/fsnotify v1.9.0 // indirect
 	github.com/fyne-io/gl-js v0.2.0 // indirect
 	github.com/fyne-io/glfw-js v0.3.0 // indirect
-	github.com/fyne-io/oksvg v0.1.0 // indirect
+	github.com/fyne-io/oksvg v0.2.0 // indirect
 	github.com/go-gl/gl v0.0.0-20231021071112-07e5d0ea2e71 // indirect
 	github.com/go-gl/glfw/v3.3/glfw v0.0.0-20250301202403-da16c1255728 // indirect
 	github.com/go-text/render v0.2.0 // indirect
-	github.com/go-text/typesetting v0.3.0 // indirect
+	github.com/go-text/typesetting v0.3.3 // indirect
 	github.com/gobwas/httphead v0.1.0 // indirect
 	github.com/gobwas/pool v0.2.1 // indirect
-	github.com/gobwas/ws v1.2.0 // indirect
+	github.com/gobwas/ws v1.4.0 // indirect
 	github.com/hack-pad/go-indexeddb v0.3.2 // indirect
 	github.com/hack-pad/safejs v0.1.1 // indirect
 	github.com/jeandeaual/go-locale v0.0.0-20250612000132-0ef82f21eade // indirect
 	github.com/josharian/intern v1.0.0 // indirect
+	github.com/json-iterator/go v1.1.12 // indirect
 	github.com/jsummers/gobmp v0.0.0-20230614200233-a9de23ed2e25 // indirect
+	github.com/klauspost/cpuid/v2 v2.3.0 // indirect
 	github.com/kr/text v0.2.0 // indirect
-	github.com/mailru/easyjson v0.7.7 // indirect
-	github.com/nbd-wtf/go-nostr v0.31.2 // indirect
+	github.com/mailru/easyjson v0.9.1 // indirect
+	github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd // indirect
+	github.com/modern-go/reflect2 v1.0.2 // indirect
+	github.com/nbd-wtf/go-nostr v0.52.3 // indirect
 	github.com/nfnt/resize v0.0.0-20180221191011-83c6a9932646 // indirect
 	github.com/nicksnyder/go-i18n/v2 v2.6.0 // indirect
 	github.com/pmezard/go-difflib v1.0.0 // indirect
-	github.com/puzpuzpuz/xsync/v3 v3.0.2 // indirect
+	github.com/puzpuzpuz/xsync/v3 v3.5.1 // indirect
 	github.com/rymdport/portal v0.4.2 // indirect
 	github.com/srwiley/oksvg v0.0.0-20221011165216-be6e8873101c // indirect
 	github.com/srwiley/rasterx v0.0.0-20220730225603-2ab79fcdd4ef // indirect
-	github.com/tidwall/gjson v1.14.4 // indirect
-	github.com/tidwall/match v1.1.1 // indirect
-	github.com/tidwall/pretty v1.2.0 // indirect
+	github.com/tidwall/gjson v1.18.0 // indirect
+	github.com/tidwall/match v1.2.0 // indirect
+	github.com/tidwall/pretty v1.2.1 // indirect
+	github.com/twitchyliquid64/golang-asm v0.15.1 // indirect
 	github.com/yuin/goldmark v1.7.13 // indirect
-	golang.org/x/exp v0.0.0-20230425010034-47ecfdc1ba53 // indirect
-	golang.org/x/mobile v0.0.0-20250813145510-f12310a0cfd9 // indirect
-	golang.org/x/sys v0.35.0 // indirect
-	golang.org/x/text v0.28.0 // indirect
+	golang.org/x/arch v0.24.0 // indirect
+	golang.org/x/exp v0.0.0-20260218203240-3dfff04db8fa // indirect
+	golang.org/x/mobile v0.0.0-20260217195705-b56b3793a9c4 // indirect
+	golang.org/x/sys v0.41.0 // indirect
+	golang.org/x/text v0.34.0 // indirect
 	gopkg.in/yaml.v3 v3.0.1 // indirect
 )