Fixes + stable gateway ids

api/discovery/internal/appversion/version.go

@@ -1,3 +1,4 @@
+// Package appversion exposes build-time version information for the discovery service.
 package appversion
 
 import (
@@ -14,6 +15,7 @@ var (
 	BuildDate string
 )
 
+// Create returns a version printer populated with the compile-time build metadata.
 func Create() version.Printer { //nolint:ireturn // factory returns interface by design
 	info := version.Info{
 		Program:   "Sendico Discovery Service",

api/discovery/internal/server/internal/config.go

@@ -1,3 +1,4 @@
+// Package serverimp contains the concrete discovery server implementation.
 package serverimp
 
 import (

api/discovery/internal/server/internal/serverimp.go

@@ -12,6 +12,7 @@ import (
 
 const defaultShutdownTimeout = 15 * time.Second
 
+// Create returns a new server implementation configured with the given logger, config file, and debug flag.
 func Create(logger mlogger.Logger, file string, debug bool) (*Imp, error) {
 	return &Imp{
 		logger: logger.Named("server"),
@@ -20,6 +21,7 @@ func Create(logger mlogger.Logger, file string, debug bool) (*Imp, error) {
 	}, nil
 }
 
+// Start loads configuration, starts metrics and the discovery registry, then blocks until stopped.
 func (i *Imp) Start() error {
 	i.initStopChannels()
 	defer i.closeDone()
@@ -73,6 +75,7 @@ func (i *Imp) Start() error {
 	return nil
 }
 
+// Shutdown gracefully stops the discovery service and its metrics server.
 func (i *Imp) Shutdown() {
 	timeout := i.shutdownTimeout()
 	i.logger.Info("Stopping discovery service", zap.Duration("timeout", timeout))

api/discovery/internal/server/internal/types.go

@@ -9,6 +9,7 @@ import (
 	"github.com/tech/sendico/pkg/mlogger"
 )
 
+// Imp is the concrete implementation of the discovery server application.
 type Imp struct {
 	logger mlogger.Logger
 	file   string

api/discovery/internal/server/server.go

@@ -1,3 +1,4 @@
+// Package server provides the discovery service application factory.
 package server
 
 import (
@@ -6,6 +7,8 @@ import (
 	"github.com/tech/sendico/pkg/server"
 )
 
+// Create initialises and returns a new discovery server application.
+//
 //nolint:ireturn // factory returns interface by design
 func Create(logger mlogger.Logger, file string, debug bool) (server.Application, error) {
 	return serverimp.Create(logger, file, debug) //nolint:wrapcheck

api/discovery/main.go

@@ -1,3 +1,4 @@
+// Package main is the entry point for the discovery service.
 package main
 
 import (