feat(rest): sos-report endpoint stub (501 Not Implemented)

GET /v1/sos-report returns 501 with a clear message. linstor CLI's
`sos-report download` calls this; without the endpoint it 404s
confusingly. Real bundling of controller logs + per-satellite state
into a tarball is operationally useful but non-trivial work.

Co-Authored-By: Claude <noreply@anthropic.com>
Signed-off-by: Andrei Kvapil <kvapss@gmail.com>

Author: kvaps

pkg/rest/server.go

@@ -79,6 +79,7 @@ func (s *Server) Start(ctx context.Context) error {
 	s.registerExternalFiles(mux)
 	s.registerDRBDPassphrase(mux)
 	s.registerRDClone(mux)
+	s.registerSOSReport(mux)
 
 	srv := &http.Server{
 		Addr:              s.Addr,

pkg/rest/sos_report.go

@@ -0,0 +1,33 @@
+/*
+Copyright 2026 Cozystack contributors.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+package rest
+
+import (
+	"net/http"
+)
+
+// registerSOSReport wires the `linstor sos-report download` endpoint.
+// Bundling controller logs + every satellite's local state into a
+// tarball is operationally useful but non-trivial — we 501 today so
+// the CLI gets a clear error rather than 404'ing.
+func (s *Server) registerSOSReport(mux *http.ServeMux) {
+	mux.HandleFunc("GET /v1/sos-report", handleSOSReport)
+}
+
+func handleSOSReport(w http.ResponseWriter, _ *http.Request) {
+	writeError(w, http.StatusNotImplemented, "sos-report bundling not yet implemented")
+}

pkg/rest/sos_report_test.go

@@ -0,0 +1,40 @@
+/*
+Copyright 2026 Cozystack contributors.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+package rest
+
+import (
+	"net/http"
+	"testing"
+
+	"github.com/cozystack/blockstor/pkg/store"
+)
+
+// TestSOSReportReturns501: linstor CLI's `sos-report download` calls
+// /v1/sos-report. We don't yet bundle controller logs / state into a
+// tarball; explicitly 501 so the CLI can render a clear error rather
+// than crash on the unexpected 404.
+func TestSOSReportReturns501(t *testing.T) {
+	base, stop := startServerWithStore(t, store.NewInMemory())
+	defer stop()
+
+	resp := httpGet(t, base+"/v1/sos-report")
+	_ = resp.Body.Close()
+
+	if resp.StatusCode != http.StatusNotImplemented {
+		t.Errorf("status: got %d, want 501", resp.StatusCode)
+	}
+}