diff --git a/internal/alerts/alerts.go b/internal/alerts/alerts.go
index cddd388..2fc9b63 100644
--- a/internal/alerts/alerts.go
+++ b/internal/alerts/alerts.go
@@ -4172,6 +4172,7 @@ func (m *Manager) CheckStorage(storage models.Storage) {
 	}
 }
 
+// BuildGuestKey constructs a unique key for a guest from instance, node, and VMID.
 func BuildGuestKey(instance, node string, vmid int) string {
 	instance = strings.TrimSpace(instance)
 	node = strings.TrimSpace(node)
diff --git a/internal/mock/generator.go b/internal/mock/generator.go
index 62f99bb..564c154 100644
--- a/internal/mock/generator.go
+++ b/internal/mock/generator.go
@@ -247,6 +247,7 @@ func generateVirtualDisks() ([]models.Disk, models.Disk) {
 	return disks, aggregated
 }
 
+// GenerateMockData creates a simulated state snapshot for demo/test environments.
 func GenerateMockData(config MockConfig) models.StateSnapshot {
 	// rand is automatically seeded in Go 1.20+
 
diff --git a/internal/updates/adapter_installsh.go b/internal/updates/adapter_installsh.go
index 8ae3543..07b3a0b 100644
--- a/internal/updates/adapter_installsh.go
+++ b/internal/updates/adapter_installsh.go
@@ -649,6 +649,7 @@ func (a *InstallShAdapter) readLastLines(filepath string, n int) string {
 // DockerUpdater provides instructions for Docker deployments
 type DockerUpdater struct{}
 
+// NewDockerUpdater creates an updater for Docker deployments.
 func NewDockerUpdater() *DockerUpdater {
 	return &DockerUpdater{}
 }
@@ -686,6 +687,7 @@ func (u *DockerUpdater) Rollback(ctx context.Context, eventID string) error {
 // AURUpdater provides instructions for Arch Linux AUR deployments
 type AURUpdater struct{}
 
+// NewAURUpdater creates an updater for Arch Linux AUR deployments.
 func NewAURUpdater() *AURUpdater {
 	return &AURUpdater{}
 }
diff --git a/internal/updates/mock_updater.go b/internal/updates/mock_updater.go
index 9332c3b..2fa36f1 100644
--- a/internal/updates/mock_updater.go
+++ b/internal/updates/mock_updater.go
@@ -9,6 +9,7 @@ import (
 // MockUpdater simulates update plans for mock/demo environments.
 type MockUpdater struct{}
 
+// NewMockUpdater creates an updater that simulates update operations.
 func NewMockUpdater() *MockUpdater {
 	return &MockUpdater{}
 }