STAC-24149: add topology inspect cmd

Author: deontaljaard

.gitignore

@@ -24,3 +24,5 @@ release-notes.json
 
 .localdev/
 stackstate-cli
+
+.claude

cmd/sts.go

@@ -33,6 +33,7 @@ func STSCommand(cli *di.Deps) *cobra.Command {
 	cmd.AddCommand(AgentCommand(cli))
 	cmd.AddCommand(UserSessionCommand(cli))
 	cmd.AddCommand(DashboardCommand(cli))
+	cmd.AddCommand(TopologyCommand(cli))
 
 	// Experimental commands for otel mapping
 	if os.Getenv("STS_EXPERIMENTAL_OTEL_MAPPING") != "" {

cmd/sts_test.go

@@ -38,6 +38,7 @@ func TestSTSCommandContainsExpectedSubcommands(t *testing.T) {
 		"agent",
 		"user-session",
 		"dashboard",
+		"topology",
 	}
 
 	// Verify expected commands are present
@@ -57,7 +58,7 @@ func TestSTSCommandStructure(t *testing.T) {
 	cli := di.NewMockDeps(t)
 	cmd := STSCommand(&cli.Deps)
 
-	assert.Len(t, cmd.Commands(), 16, "Expected 16 subcommands")
+	assert.Len(t, cmd.Commands(), 17, "Expected 17 subcommands")
 }
 
 func TestSTSCommandUsageTemplate(t *testing.T) {

cmd/topology.go

@@ -0,0 +1,18 @@
+package cmd
+
+import (
+	"github.com/spf13/cobra"
+	"github.com/stackvista/stackstate-cli/cmd/topology"
+	"github.com/stackvista/stackstate-cli/internal/di"
+)
+
+func TopologyCommand(cli *di.Deps) *cobra.Command {
+	cmd := &cobra.Command{
+		Use:   "topology",
+		Short: "Inspect SUSE Observability topology components",
+		Long:  "Inspect SUSE Observability topology components. Query and display topology components using component types, tags, and identifiers.",
+	}
+	cmd.AddCommand(topology.InspectCommand(cli))
+
+	return cmd
+}