feat: add catalog show command and use full UUIDs in search

Implements 'mxcli catalog show <uuid>' for detailed endpoint inspection
and changes search output to show full UUIDs instead of shortened.

Changes:
- Show full UUID (36 chars) in search table output
- Users can copy UUID directly for use with show command
- Add catalog show command with human-readable and JSON output
- Display entities, actions, security scheme, environment

New types:
- EndpointDetails, ServiceVersion, Contract, Document
- Entity, Attribute, Association
- Action, Parameter, ReturnType
- SecurityScheme, SecurityType, Role
- EnvironmentWithApp (nested Application in endpoint response)

New client method:
- GetEndpoint(ctx, uuid) - Calls GET /endpoints/{uuid}

Updated documentation:
- Skills file reflects full UUID in table
- Proposal updated with full UUID rationale
- Table width now ~155 chars with full UUIDs

Tested against real Catalog API.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: dionesiusap

.claude/skills/mendix/catalog-search.md

@@ -37,10 +37,10 @@ mxcli catalog search "data" --json | jq '.[] | {name, uuid, type}'
 
 **Table (default):**
 ```
-NAME                   TYPE    VERSION    APPLICATION           ENVIRONMENT   PROD  UUID
-CustomerService        OData   1.2.0      CRM Application       Production    Yes   a7f3c2d1
-OrderAPI               REST    2.0.1      E-commerce Platform   Acceptance    No    b8e4d3e2
-InventorySync          SOAP    1.0.0      Warehouse System      Test          No    c9f5e4f3
+NAME                TYPE   VERSION  APPLICATION           ENVIRONMENT   PROD  UUID
+CustomerService     OData  1.2.0    CRM Application       Production    Yes   a7f3c2d1-4b5e-6c7f-8d9e-0a1b2c3d4e5f
+OrderAPI            REST   2.0.1    E-commerce Platform   Acceptance    No    b8e4d3e2-1a2b-3c4d-5e6f-7a8b9c0d1e2f
+InventorySync       SOAP   1.0.0    Warehouse System      Test          No    c9f5e4f3-2b3c-4d5e-6f7a-8b9c0d1e2f3a
 
 Total: 42 results (showing 1-3)
 ```
@@ -51,7 +51,7 @@ Total: 42 results (showing 1-3)
 - **APPLICATION**: Hosting application name
 - **ENVIRONMENT**: Production, Acceptance, Test
 - **PROD**: "Yes" if production, blank otherwise
-- **UUID**: First 8 characters (full UUID in JSON mode)
+- **UUID**: Full UUID (36 chars) - copy this for use with `mxcli catalog show <uuid>`
 
 **JSON mode:**
 ```bash

cmd/mxcli/cmd_catalog.go

@@ -5,6 +5,7 @@ package main
 import (
 	"encoding/json"
 	"fmt"
+	"strings"
 	"text/tabwriter"
 
 	"github.com/mendixlabs/mxcli/internal/auth"
@@ -38,6 +39,18 @@ Examples:
 	RunE: runCatalogSearch,
 }
 
+var catalogShowCmd = &cobra.Command{
+	Use:   "show <uuid>",
+	Short: "Show detailed endpoint metadata",
+	Long: `Display detailed metadata for a Catalog endpoint including entities, actions, and contract.
+
+Examples:
+  mxcli catalog show a7f3c2d1-4b5e-6c7f-8d9e-0a1b2c3d4e5f
+  mxcli catalog show a7f3c2d1 --json`,
+	Args: cobra.ExactArgs(1),
+	RunE: runCatalogShow,
+}
+
 func init() {
 	catalogSearchCmd.Flags().String("profile", auth.ProfileDefault, "credential profile name")
 	catalogSearchCmd.Flags().String("service-type", "", "filter by service type (OData, REST, SOAP)")
@@ -47,7 +60,11 @@ func init() {
 	catalogSearchCmd.Flags().Int("offset", 0, "pagination offset")
 	catalogSearchCmd.Flags().Bool("json", false, "output as JSON array")
 
+	catalogShowCmd.Flags().String("profile", auth.ProfileDefault, "credential profile name")
+	catalogShowCmd.Flags().Bool("json", false, "output full JSON response")
+
 	catalogCmd.AddCommand(catalogSearchCmd)
+	catalogCmd.AddCommand(catalogShowCmd)
 	rootCmd.AddCommand(catalogCmd)
 }
 
@@ -113,10 +130,7 @@ func outputTable(cmd *cobra.Command, resp *catalog.SearchResponse) error {
 		if item.Environment.Type == "Production" {
 			prod = "Yes"
 		}
-		uuid := item.UUID
-		if len(uuid) >= 8 {
-			uuid = uuid[:8] // Short UUID
-		}
+		uuid := item.UUID // Full UUID (36 chars) so users can use it with `show`
 
 		fmt.Fprintf(w, "%s\t%s\t%s\t%s\t%s\t%s\t%s\n",
 			name, typ, version, app, env, prod, uuid)
@@ -134,6 +148,109 @@ func outputJSON(cmd *cobra.Command, data []catalog.SearchResult) error {
 	return enc.Encode(data)
 }
 
+func runCatalogShow(cmd *cobra.Command, args []string) error {
+	uuid := args[0]
+	profile, _ := cmd.Flags().GetString("profile")
+	asJSON, _ := cmd.Flags().GetBool("json")
+
+	// Create client
+	client, err := catalog.NewClient(cmd.Context(), profile)
+	if err != nil {
+		if _, ok := err.(*auth.ErrNoCredential); ok {
+			return fmt.Errorf("no credential found. Run: mxcli auth login")
+		}
+		return err
+	}
+
+	// Get endpoint details
+	endpoint, err := client.GetEndpoint(cmd.Context(), uuid)
+	if err != nil {
+		if _, ok := err.(*auth.ErrUnauthenticated); ok {
+			return fmt.Errorf("authentication failed. Run: mxcli auth login")
+		}
+		return err
+	}
+
+	// Output
+	if asJSON {
+		enc := json.NewEncoder(cmd.OutOrStdout())
+		enc.SetIndent("", "  ")
+		return enc.Encode(endpoint)
+	}
+	return outputEndpointDetails(cmd, endpoint)
+}
+
+func outputEndpointDetails(cmd *cobra.Command, ep *catalog.EndpointDetails) error {
+	w := cmd.OutOrStdout()
+	sv := ep.ServiceVersion
+
+	// Basic info
+	fmt.Fprintf(w, "Name:         %s\n", sv.Description)
+	fmt.Fprintf(w, "Type:         %s\n", sv.Type)
+	fmt.Fprintf(w, "Version:      %s\n", sv.Version)
+	fmt.Fprintf(w, "Application:  %s\n", ep.Environment.Application.Name)
+	fmt.Fprintf(w, "Environment:  %s (%s)\n", ep.Environment.Type, ep.Environment.Location)
+	if ep.Location != "" {
+		fmt.Fprintf(w, "Location:     %s\n", ep.Location)
+	}
+	fmt.Fprintf(w, "\n")
+
+	// Security
+	if sv.SecurityScheme != nil && len(sv.SecurityScheme.SecurityTypes) > 0 {
+		var types []string
+		for _, st := range sv.SecurityScheme.SecurityTypes {
+			types = append(types, st.Name)
+		}
+		fmt.Fprintf(w, "Security:     %s\n", strings.Join(types, ", "))
+	}
+	fmt.Fprintf(w, "Validated:    %v\n", ep.Validated)
+	fmt.Fprintf(w, "Last Updated: %s\n", ep.LastUpdated)
+	fmt.Fprintf(w, "\n")
+
+	// Entities (OData only)
+	if sv.TotalEntities > 0 {
+		fmt.Fprintf(w, "Entities (%d):\n", sv.TotalEntities)
+		for _, ent := range sv.Entities {
+			fmt.Fprintf(w, "  - %s (%d attributes", ent.Name, ent.TotalAttributes)
+			if ent.TotalAssociations > 0 {
+				fmt.Fprintf(w, ", %d associations", ent.TotalAssociations)
+			}
+			fmt.Fprintf(w, ")\n")
+
+			// Show first 3 attributes
+			if len(ent.Attributes) > 0 {
+				var attrNames []string
+				for i, attr := range ent.Attributes {
+					if i >= 3 {
+						break
+					}
+					attrNames = append(attrNames, attr.Name)
+				}
+				fmt.Fprintf(w, "    Attributes: %s", strings.Join(attrNames, ", "))
+				if len(ent.Attributes) > 3 {
+					fmt.Fprintf(w, ", ...")
+				}
+				fmt.Fprintf(w, "\n")
+			}
+		}
+		fmt.Fprintf(w, "\n")
+	}
+
+	// Actions (OData only)
+	if sv.TotalActions > 0 {
+		fmt.Fprintf(w, "Actions (%d):\n", sv.TotalActions)
+		for _, action := range sv.Actions {
+			fmt.Fprintf(w, "  - %s", action.Name)
+			if action.TotalParameters > 0 {
+				fmt.Fprintf(w, " (%d parameters)", action.TotalParameters)
+			}
+			fmt.Fprintf(w, "\n")
+		}
+	}
+
+	return nil
+}
+
 func truncate(s string, max int) string {
 	if len(s) <= max {
 		return s

docs/11-proposals/PROPOSAL_catalog_integration.md

@@ -186,13 +186,13 @@ mxcli catalog search "sales" --owned-only
 
 ### Table Output Format
 
-**Design Decision:** 7 columns, ~120 chars wide (fits standard terminal width).
+**Design Decision:** 7 columns, ~155 chars wide with full UUIDs.
 
 ```
-NAME                   TYPE    VERSION    APPLICATION           ENVIRONMENT   PROD  UUID
-CustomerService        OData   1.2.0      CRM Application       Production    Yes   a7f3c2d1
-OrderAPI               REST    2.0.1      E-commerce Platform   Acceptance    No    b8e4d3e2
-InventorySync          SOAP    1.0.0      Warehouse System      Test          No    c9f5e4f3
+NAME                TYPE   VERSION  APPLICATION           ENVIRONMENT   PROD  UUID
+CustomerService     OData  1.2.0    CRM Application       Production    Yes   a7f3c2d1-4b5e-6c7f-8d9e-0a1b2c3d4e5f
+OrderAPI            REST   2.0.1    E-commerce Platform   Acceptance    No    b8e4d3e2-1a2b-3c4d-5e6f-7a8b9c0d1e2f
+InventorySync       SOAP   1.0.0    Warehouse System      Test          No    c9f5e4f3-2b3c-4d5e-6f7a-8b9c0d1e2f3a
 ```
 
 **Column Widths:**
@@ -202,10 +202,10 @@ InventorySync          SOAP    1.0.0      Warehouse System      Test          No
 - APPLICATION (20 chars) — Truncate with "..." if longer
 - ENVIRONMENT (12 chars) — Type field (Production, Acceptance, Test)
 - PROD (4 chars) — "Yes" if environment.Type == "Production", blank otherwise
-- UUID (8 chars) — First 8 chars only (full UUID available in --json mode)
+- UUID (36 chars) — Full UUID for use with `mxcli catalog show <uuid>`
 
 **Rationale:**
-- Short UUIDs reduce cognitive load while remaining unique enough for manual lookup
+- Full UUIDs required for `catalog show` command (API requires full UUID)
 - PROD column provides at-a-glance production status without reading ENVIRONMENT
 - APPLICATION provides context without requiring a separate lookup
 - Full details available via `--json` for scripting use cases

internal/catalog/client.go

@@ -84,3 +84,35 @@ func (c *Client) Search(ctx context.Context, opts SearchOptions) (*SearchRespons
 
 	return &result, nil
 }
+
+// GetEndpoint retrieves detailed endpoint metadata by UUID.
+// Calls GET /endpoints/{uuid} and returns parsed result including embedded contract.
+func (c *Client) GetEndpoint(ctx context.Context, uuid string) (*EndpointDetails, error) {
+	reqURL := c.baseURL + "/endpoints/" + uuid
+	req, err := http.NewRequestWithContext(ctx, "GET", reqURL, nil)
+	if err != nil {
+		return nil, err
+	}
+	req.Header.Set("Accept", "application/json")
+
+	resp, err := c.httpClient.Do(req)
+	if err != nil {
+		// auth.authTransport wraps 401/403 as auth.ErrUnauthenticated
+		return nil, err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode == http.StatusNotFound {
+		return nil, fmt.Errorf("endpoint %s not found", uuid)
+	}
+	if resp.StatusCode != http.StatusOK {
+		return nil, fmt.Errorf("catalog API returned status %d", resp.StatusCode)
+	}
+
+	var result EndpointDetails
+	if err := json.NewDecoder(resp.Body).Decode(&result); err != nil {
+		return nil, fmt.Errorf("decode response: %w", err)
+	}
+
+	return &result, nil
+}

internal/catalog/types.go

@@ -57,3 +57,141 @@ type Owner struct {
 	Email string `json:"email"`
 	UUID  string `json:"uuid"`
 }
+
+// EndpointDetails represents the full response from GET /endpoints/{uuid}.
+type EndpointDetails struct {
+	UUID                   string                `json:"uuid"`
+	Path                   string                `json:"path"`
+	Location               string                `json:"location"`
+	Discoverable           bool                  `json:"discoverable"`
+	Validated              bool                  `json:"validated"`
+	SecurityClassification string                `json:"securityClassification"`
+	Connections            int                   `json:"connections"`
+	LastUpdated            string                `json:"lastUpdated"`
+	ServiceVersion         ServiceVersion        `json:"serviceVersion"`
+	Environment            EnvironmentWithApp    `json:"environment"`
+}
+
+// EnvironmentWithApp extends Environment with nested Application (used in endpoint details).
+type EnvironmentWithApp struct {
+	Name     string      `json:"name"`
+	Location string      `json:"location"`
+	Type     string      `json:"type"`
+	UUID     string      `json:"uuid"`
+	Application Application `json:"application"`
+}
+
+// ServiceVersion contains version-specific metadata and contract.
+type ServiceVersion struct {
+	Version         string           `json:"version"`
+	Description     string           `json:"description"`
+	UUID            string           `json:"uuid"`
+	PublishDate     string           `json:"publishDate"`
+	Type            string           `json:"type"` // "OData", "REST", "SOAP"
+	Contracts       []Contract       `json:"contracts"`
+	SecurityScheme  *SecurityScheme  `json:"securityScheme,omitempty"`
+	TotalEntities   int              `json:"totalEntities"`
+	Entities        []Entity         `json:"entities"`
+	TotalActions    int              `json:"totalActions"`
+	Actions         []Action         `json:"actions"`
+}
+
+// Contract represents an API contract (metadata, OpenAPI, WSDL, etc).
+type Contract struct {
+	Type                 string     `json:"type"` // "CSDL", "OpenAPI", "WSDL"
+	SpecificationVersion string     `json:"specificationVersion"`
+	DocumentBaseURL      string     `json:"documentBaseURL"`
+	Documents            []Document `json:"documents"`
+}
+
+// Document contains the actual contract content.
+type Document struct {
+	IsPrimary bool   `json:"isPrimary"`
+	URI       string `json:"uri"`
+	Contents  string `json:"contents"` // Embedded XML/JSON contract
+}
+
+// SecurityScheme describes authentication requirements.
+type SecurityScheme struct {
+	SecurityTypes  []SecurityType `json:"securityTypes"`
+	MxAllowedRoles []Role         `json:"mxAllowedRoles,omitempty"`
+}
+
+// SecurityType represents an authentication method.
+type SecurityType struct {
+	Name                string `json:"name"` // "Basic", "MxID", etc.
+	MarketplaceModuleID string `json:"marketplaceModuleID,omitempty"`
+}
+
+// Role represents a Mendix module role.
+type Role struct {
+	Name string `json:"name"`
+	UUID string `json:"uuid"`
+}
+
+// Entity represents an OData entity set.
+type Entity struct {
+	Name              string        `json:"name"`
+	EntitySetName     string        `json:"entitySetName"`
+	EntityTypeName    string        `json:"entityTypeName"`
+	Namespace         string        `json:"namespace"`
+	Validated         bool          `json:"validated"`
+	Updatable         bool          `json:"updatable"`
+	Insertable        bool          `json:"insertable"`
+	Deletable         bool          `json:"deletable"`
+	TotalAttributes   int           `json:"totalAttributes"`
+	Attributes        []Attribute   `json:"attributes"`
+	TotalAssociations int           `json:"totalAssociations"`
+	Associations      []Association `json:"associations"`
+}
+
+// Attribute represents an entity attribute.
+type Attribute struct {
+	Name       string `json:"name"`
+	TypeName   string `json:"typeName"`
+	TypeKind   string `json:"typeKind"`
+	Updatable  bool   `json:"updatable"`
+	Insertable bool   `json:"insertable"`
+	Filterable bool   `json:"filterable"`
+	Sortable   bool   `json:"sortable"`
+}
+
+// Association represents an entity association.
+type Association struct {
+	Name              string `json:"name"`
+	ReferencedDataset string `json:"referencedDataset"`
+	Multiplicity      string `json:"multiplicity"`
+	EntitySetName     string `json:"entitySetName"`
+	EntityTypeName    string `json:"entityTypeName"`
+	Namespace         string `json:"namespace"`
+}
+
+// Action represents an OData action or function.
+type Action struct {
+	Name                string      `json:"name"`
+	FullyQualifiedName  string      `json:"fullyQualifiedName"`
+	Summary             string      `json:"summary"`
+	Description         string      `json:"description"`
+	TotalParameters     int         `json:"totalParameters"`
+	Parameters          []Parameter `json:"parameters"`
+	ReturnType          *ReturnType `json:"returnType,omitempty"`
+}
+
+// Parameter represents an action/function parameter.
+type Parameter struct {
+	Name         string `json:"name"`
+	TypeKind     string `json:"typekind"`
+	TypeName     string `json:"typeName"`
+	IsCollection bool   `json:"isCollection"`
+	Nullable     bool   `json:"nullable"`
+	Summary      string `json:"summary"`
+	Description  string `json:"description"`
+}
+
+// ReturnType represents an action/function return type.
+type ReturnType struct {
+	TypeKind     string `json:"typekind"`
+	TypeName     string `json:"typeName"`
+	IsCollection bool   `json:"isCollection"`
+	Nullable     bool   `json:"nullable"`
+}