docs: updated examples

Author: tip-dteller

.cursor/rules/live-tests.mdc

@@ -1,4 +1,5 @@
 ---
+globs: scripts/*
 alwaysApply: false
 ---
 ## Live Tests Policy (CLI + YAML)

README.md

@@ -34,6 +34,8 @@ We love how Terraform plans changes before applying, and how kubectl lets you de
 | Feature | Description |
 |---------|-------------|
 | 🌐 **Atlas** | List/get/create/update/delete projects, clusters, users, network access, peering, and network containers |
+| 🔍 **Atlas Search** | Create and manage Atlas Search indexes for full-text and vector search capabilities |
+| 🔗 **VPC Endpoints** | Configure VPC endpoints and Private Link connections for secure Atlas connectivity |
 | 🗄️ **Databases** | List/create/delete databases, collections, and indexes — either via connection string or Atlas cluster reference |
 | 👥 **Database Users** | Create/list/update/delete database-specific users with custom roles — via connection string or Atlas cluster reference |
 | 📋 **Infra** | Discover current state, plan/diff/apply/destroy via declarative YAML |
@@ -271,6 +273,17 @@ matlas atlas users create --project-id <id> --username testuser --show-password
 
 # List network access rules
 matlas atlas network list --project-id <id>
+
+# List Atlas Search indexes
+matlas atlas search list --project-id <id> --cluster <name>
+
+# Create a basic search index
+matlas atlas search create --project-id <id> --cluster <name> \
+  --database <db> --collection <coll> --name <index-name> --type search
+
+# Create VPC endpoint
+matlas atlas vpc-endpoints create --project-id <id> --provider AWS \
+  --region us-east-1 --service-name com.amazonaws.vpce.us-east-1.vpce-svc-123
 ```
 
 ### 🗄️ Database Operations
@@ -334,7 +347,10 @@ matlas infra destroy --discovery-only --project-id <id>  # Discovery only
 Matlas looks for credentials in this order:
 1. Command flags/YAML config
 2. Environment variables (`ATLAS_API_KEY`, `ATLAS_PUB_KEY`)
-3. macOS Keychain (fallback)
+3. Platform-specific secure storage:
+   - **macOS**: Keychain (`security` command)
+   - **Windows**: Credential Manager (PowerShell)
+   - **Linux**: secret-service (`secret-tool` or GNOME Keyring)
 
 ## 🐚 Shell Completion
 Enable auto-completion for your shell:
@@ -385,8 +401,7 @@ cp features/TEMPLATE.md features/$(date +%F)-<short-slug>.md
 ```
 
 ## ⚠️ Current Limitations
-- 🔍 **Atlas Search**: Commands exist but return unsupported errors
-- 🔗 **VPC Endpoints**: Hidden in current build
+- 🔧 **Advanced Configuration**: Some complex cluster configurations (ReplicationSpecs, AutoScaling) require manual Atlas console setup
 
 ## 📄 License
 **MIT License** - see [`LICENSE`](LICENSE) for details.

cmd/atlas/search/search.go

@@ -26,7 +26,6 @@ func NewSearchCmd() *cobra.Command {
 		Short:   "Manage Atlas Search indexes",
 		Long:    "Atlas Search index management commands for full-text and vector search capabilities.",
 		Aliases: []string{"search-index", "search-indexes"},
-		Hidden:  true, // Hide command as it's still in development
 	}
 
 	// Keep subcommands registered but keep parent hidden; each command returns a clear, consistent message.
@@ -125,7 +124,7 @@ func newCreateCmd() *cobra.Command {
 
 	cmd := &cobra.Command{
 		Use:   "create",
-		Short: "Create an Atlas Search index (unsupported)",
+		Short: "Create an Atlas Search index",
 		Long: `Create a new Atlas Search index for full-text search or vector search.
 
 This command creates a new MongoDB Atlas Search index on a collection.
@@ -169,7 +168,7 @@ func newUpdateCmd() *cobra.Command {
 
 	cmd := &cobra.Command{
 		Use:   "update",
-		Short: "Update an Atlas Search index (unsupported)",
+		Short: "Update an Atlas Search index",
 		Long: `Update an existing Atlas Search index configuration.
 
 This command updates the configuration of an existing MongoDB Atlas Search index.

cmd/atlas/search/search_test.go

@@ -4,21 +4,46 @@ import (
 	"testing"
 )
 
-// Ensure the command is hidden and returns a consistent unsupported message when executed without required flags.
-func TestNewSearchCmd_HiddenAndSubcommands(t *testing.T) {
+// Ensure the command is visible and has all expected subcommands available.
+func TestNewSearchCmd_VisibleAndSubcommands(t *testing.T) {
 	cmd := NewSearchCmd()
 	if cmd == nil {
 		t.Fatalf("expected command, got nil")
 	}
-	if !cmd.Hidden {
-		t.Fatalf("expected search command to be hidden")
+	if cmd.Hidden {
+		t.Fatalf("expected search command to be visible, but it was hidden")
 	}
-	// Ensure common subcommands are present
+	
+	// Verify command properties
+	if cmd.Use != "search" {
+		t.Errorf("expected Use to be 'search', got '%s'", cmd.Use)
+	}
+	if cmd.Short == "" {
+		t.Error("expected Short description to be non-empty")
+	}
+	if cmd.Long == "" {
+		t.Error("expected Long description to be non-empty")
+	}
+	
+	// Verify aliases are present
+	expectedAliases := []string{"search-index", "search-indexes"}
+	if len(cmd.Aliases) != len(expectedAliases) {
+		t.Errorf("expected %d aliases, got %d", len(expectedAliases), len(cmd.Aliases))
+	}
+	
+	// Ensure all expected subcommands are present
 	found := map[string]bool{}
 	for _, c := range cmd.Commands() {
 		found[c.Use] = true
 	}
-	if !found["list"] || !found["get"] || !found["create"] || !found["update"] || !found["delete"] {
-		t.Fatalf("expected standard subcommands to be present, got: %+v", found)
+	expectedCommands := []string{"list", "get", "create", "update", "delete"}
+	for _, expectedCmd := range expectedCommands {
+		if !found[expectedCmd] {
+			t.Errorf("expected subcommand '%s' to be present", expectedCmd)
+		}
+	}
+	
+	if len(found) != len(expectedCommands) {
+		t.Errorf("expected exactly %d subcommands, got %d: %+v", len(expectedCommands), len(found), found)
 	}
 }