itsdevcoffee
diff --git a/‎README.md‎
Lines changed: 28 additions & 0 deletions b/‎README.md‎
Lines changed: 28 additions & 0 deletions
diff --git a/‎internal/marketplace/discovery.go‎
Lines changed: 44 additions & 6 deletions b/‎internal/marketplace/discovery.go‎
Lines changed: 44 additions & 6 deletions
diff --git a/‎internal/marketplace/discovery_test.go‎
Lines changed: 155 additions & 0 deletions b/‎internal/marketplace/discovery_test.go‎
Lines changed: 155 additions & 0 deletions
@@ -174,13 +174,41 @@ Press `?` to see all keyboard shortcuts:
 
 ## Building from Source
 
+**Requirements:** Go 1.24+
+
 ```bash
 git clone https://github.com/itsdevcoffee/plum.git
 cd plum
 go build -o plum ./cmd/plum
 ./plum
 ```
 
+## Development
+
+**Prerequisites:**
+- Go 1.24+ ([download](https://go.dev/dl/))
+- golangci-lint (optional, for local linting)
+
+**Run tests:**
+```bash
+go test ./...                    # Run all tests
+go test -cover ./...             # With coverage
+go test -v ./internal/ui         # Specific package
+```
+
+**Format code:**
+```bash
+gofmt -w .
+```
+
+**Run linter (requires Go 1.24):**
+```bash
+go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest
+golangci-lint run
+```
+
+**Note:** Ensure your golangci-lint is built with Go 1.24+ to match the project's Go version. If you see version mismatch errors, reinstall with: `go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest`
+
 ## Troubleshooting
 
 **"command not found: plum" after installing**
 
@@ -13,10 +13,11 @@ const (
 
 // PopularMarketplace represents a hardcoded popular marketplace
 type PopularMarketplace struct {
-	Name        string `json:"name"`
-	DisplayName string `json:"displayName"`
-	Repo        string `json:"repo"` // Full repo URL (e.g., https://github.com/owner/repo)
-	Description string `json:"description"`
+	Name        string        `json:"name"`
+	DisplayName string        `json:"displayName"`
+	Repo        string        `json:"repo"` // Full repo URL (e.g., https://github.com/owner/repo)
+	Description string        `json:"description"`
+	StaticStats *GitHubStats  `json:"staticStats,omitempty"` // Static GitHub stats snapshot (fallback if cache empty)
 }
 
 // DiscoveredMarketplace contains a marketplace manifest with source information
@@ -26,55 +27,92 @@ type DiscoveredMarketplace struct {
 	Source   string // Derived CLI source (owner/repo for GitHub, full URL for others)
 }
 
-// PopularMarketplaces is the hardcoded list from README.md
+// PopularMarketplaces is the hardcoded list from README.md with static GitHub stats
+// Stats snapshot: 2025-12-30 (automatically updated periodically)
 var PopularMarketplaces = []PopularMarketplace{
 	{
 		Name:        "claude-code-plugins-plus",
 		DisplayName: "Claude Code Plugins Plus",
 		Repo:        "https://github.com/jeremylongshore/claude-code-plugins",
 		Description: "The largest collection with 254 plugins and 185 Agent Skills",
+		// Note: Stats unavailable for this repo (private or rate limited)
 	},
 	{
 		Name:        "claude-code-marketplace",
 		DisplayName: "Claude Code Marketplace",
 		Repo:        "https://github.com/ananddtyagi/claude-code-marketplace",
 		Description: "Community-driven marketplace with granular installation",
+		// Note: Stats unavailable for this repo (private or rate limited)
 	},
 	{
 		Name:        "claude-code-plugins",
 		DisplayName: "Claude Code Plugins",
 		Repo:        "https://github.com/anthropics/claude-code",
 		Description: "Official Anthropic plugins maintained by the Claude Code team",
+		StaticStats: &GitHubStats{Stars: 49810, Forks: 3529, OpenIssues: 6540},
 	},
 	{
 		Name:        "mag-claude-plugins",
 		DisplayName: "MAG Claude Plugins",
 		Repo:        "https://github.com/MadAppGang/claude-code",
 		Description: "Battle-tested workflows with 4 specialized plugins",
+		StaticStats: &GitHubStats{Stars: 190, Forks: 17, OpenIssues: 1},
 	},
 	{
 		Name:        "dev-gom-plugins",
 		DisplayName: "Dev-GOM Plugins",
 		Repo:        "https://github.com/Dev-GOM/claude-code-marketplace",
 		Description: "Automation-focused collection with 15 plugins",
+		StaticStats: &GitHubStats{Stars: 41, Forks: 5, OpenIssues: 0},
 	},
 	{
 		Name:        "feedmob-claude-plugins",
 		DisplayName: "FeedMob Plugins",
 		Repo:        "https://github.com/feed-mob/claude-code-marketplace",
 		Description: "Productivity and workflow tools with 6 specialized plugins",
+		StaticStats: &GitHubStats{Stars: 2, Forks: 1, OpenIssues: 1},
 	},
 	{
 		Name:        "claude-plugins-official",
 		DisplayName: "Claude Plugins Official",
 		Repo:        "https://github.com/anthropics/claude-plugins-official",
 		Description: "Official Anthropic plugins for Claude Code",
+		// Note: Repo may not exist or is private
 	},
 	{
 		Name:        "anthropic-agent-skills",
 		DisplayName: "Anthropic Agent Skills",
 		Repo:        "https://github.com/anthropics/skills",
-		Description: "Official Anthropic skills reference with document manipulation and examples",
+		Description: "Official Anthropic Agent Skills reference repository",
+		StaticStats: &GitHubStats{Stars: 29937, Forks: 2738, OpenIssues: 117},
+	},
+	{
+		Name:        "wshobson-agents",
+		DisplayName: "Hobson's Agent Collection",
+		Repo:        "https://github.com/wshobson/agents",
+		Description: "Comprehensive production system with 65 plugins and multi-agent orchestration",
+		StaticStats: &GitHubStats{Stars: 23895, Forks: 2654, OpenIssues: 257},
+	},
+	{
+		Name:        "docker-plugins",
+		DisplayName: "Docker Official Plugins",
+		Repo:        "https://github.com/docker/claude-plugins",
+		Description: "Official Docker Inc. marketplace with Docker Desktop MCP Toolkit integration",
+		StaticStats: &GitHubStats{Stars: 11, Forks: 3, OpenIssues: 0},
+	},
+	{
+		Name:        "ccplugins-marketplace",
+		DisplayName: "CC Plugins Curated",
+		Repo:        "https://github.com/ccplugins/marketplace",
+		Description: "Curated collection of 200 plugins across 13 categories",
+		StaticStats: &GitHubStats{Stars: 10, Forks: 7, OpenIssues: 2},
+	},
+	{
+		Name:        "claude-mem",
+		DisplayName: "Claude-Mem",
+		Repo:        "https://github.com/thedotmack/claude-mem",
+		Description: "Persistent memory compression system for Claude Code with context preservation",
+		StaticStats: &GitHubStats{Stars: 9585, Forks: 578, OpenIssues: 14},
 	},
 }
 
 
@@ -0,0 +1,155 @@
+package marketplace
+
+import (
+	"testing"
+)
+
+// TestPopularMarketplaces verifies the hardcoded marketplace list
+func TestPopularMarketplaces(t *testing.T) {
+	t.Run("list is not empty", func(t *testing.T) {
+		if len(PopularMarketplaces) == 0 {
+			t.Error("PopularMarketplaces should not be empty")
+		}
+	})
+
+	t.Run("all marketplaces have required fields", func(t *testing.T) {
+		for i, pm := range PopularMarketplaces {
+			if pm.Name == "" {
+				t.Errorf("Marketplace %d has empty Name", i)
+			}
+			if pm.DisplayName == "" {
+				t.Errorf("Marketplace %d (%s) has empty DisplayName", i, pm.Name)
+			}
+			if pm.Repo == "" {
+				t.Errorf("Marketplace %d (%s) has empty Repo", i, pm.Name)
+			}
+			if pm.Description == "" {
+				t.Errorf("Marketplace %d (%s) has empty Description", i, pm.Name)
+			}
+		}
+	})
+
+	t.Run("verify specific known marketplaces", func(t *testing.T) {
+		// Check that key marketplaces exist
+		found := make(map[string]bool)
+		for _, pm := range PopularMarketplaces {
+			found[pm.Name] = true
+		}
+
+		expectedMarketplaces := []string{
+			"claude-code-plugins",
+			"anthropic-agent-skills",
+			"wshobson-agents",
+			"claude-mem",
+		}
+
+		for _, expected := range expectedMarketplaces {
+			if !found[expected] {
+				t.Errorf("Expected marketplace %q not found in PopularMarketplaces", expected)
+			}
+		}
+	})
+
+	t.Run("static stats present for some marketplaces", func(t *testing.T) {
+		statsCount := 0
+		for _, pm := range PopularMarketplaces {
+			if pm.StaticStats != nil {
+				statsCount++
+
+				// Verify stats have reasonable values
+				if pm.StaticStats.Stars < 0 {
+					t.Errorf("Marketplace %s has negative stars: %d", pm.Name, pm.StaticStats.Stars)
+				}
+				if pm.StaticStats.Forks < 0 {
+					t.Errorf("Marketplace %s has negative forks: %d", pm.Name, pm.StaticStats.Forks)
+				}
+			}
+		}
+
+		if statsCount == 0 {
+			t.Error("At least some marketplaces should have StaticStats")
+		}
+	})
+
+	t.Run("no duplicate names", func(t *testing.T) {
+		seen := make(map[string]bool)
+		for _, pm := range PopularMarketplaces {
+			if seen[pm.Name] {
+				t.Errorf("Duplicate marketplace name: %s", pm.Name)
+			}
+			seen[pm.Name] = true
+		}
+	})
+
+	t.Run("repo URLs are valid format", func(t *testing.T) {
+		for _, pm := range PopularMarketplaces {
+			// Should contain github.com
+			if pm.Repo != "" {
+				// Most should be GitHub URLs
+				// Just verify it's not empty and doesn't have obvious issues
+				if len(pm.Repo) < 10 {
+					t.Errorf("Marketplace %s has suspiciously short Repo URL: %s", pm.Name, pm.Repo)
+				}
+			}
+		}
+	})
+}
+
+// TestPopularMarketplace verifies the struct
+func TestPopularMarketplace(t *testing.T) {
+	t.Run("create with all fields", func(t *testing.T) {
+		pm := PopularMarketplace{
+			Name:        "test-marketplace",
+			DisplayName: "Test Marketplace",
+			Repo:        "https://github.com/test/marketplace",
+			Description: "A test marketplace",
+			StaticStats: &GitHubStats{
+				Stars: 100,
+				Forks: 10,
+			},
+		}
+
+		if pm.Name != "test-marketplace" {
+			t.Errorf("Expected name %q, got %q", "test-marketplace", pm.Name)
+		}
+
+		if pm.StaticStats == nil {
+			t.Error("StaticStats should not be nil")
+		}
+
+		if pm.StaticStats.Stars != 100 {
+			t.Errorf("Expected 100 stars, got %d", pm.StaticStats.Stars)
+		}
+	})
+
+	t.Run("nil static stats allowed", func(t *testing.T) {
+		pm := PopularMarketplace{
+			Name:        "test",
+			DisplayName: "Test",
+			Repo:        "https://github.com/test/repo",
+			Description: "Test",
+			StaticStats: nil,
+		}
+
+		if pm.StaticStats != nil {
+			t.Error("StaticStats should be nil")
+		}
+	})
+}
+
+// TestPluginSearchSource verifies the search source implementation
+func TestPluginSearchSource(t *testing.T) {
+	pm := PopularMarketplaces[0] // Use first marketplace
+
+	t.Run("marketplace has name", func(t *testing.T) {
+		if pm.Name == "" {
+			t.Error("First marketplace should have a name")
+		}
+	})
+
+	t.Run("marketplace has valid repo", func(t *testing.T) {
+		if pm.Repo == "" {
+			t.Error("First marketplace should have a repo URL")
+		}
+	})
+}