Function entitySearchCommand

internal/cli/management.go:70–248

============================================================================ search — 3-tier search: GitHub → skill_repos.json → config.yaml remotes ============================================================================

(kind entities.Kind)

// ============================================================================

func entitySearchCommand(kind entities.Kind) *cobra.Command {
	var (
		owner string
		limit int
		local bool
	)
	cmd := &cobra.Command{
		Use:   "search <query>",
		Short: "Search for " + string(kind) + "s across GitHub",
		Long: "Search across all public GitHub repositories for " + string(kind) + `s matching a keyword.

Uses the GitHub Code Search API to find ` + defaultManifestName(kind) + ` files whose
name or description matches the query term.

Search results are validated to ensure they follow the skill standard
(valid directory conventions, proper SKILL.md frontmatter with name and
description).

Results are presented in three tiers:
  1. GitHub Code Search (primary discovery)
  2. Configured skill repositories (skill_repos.json)
  3. Remote sources (config.yaml)

Also searches the local store and configured repositories for matches.

Use --owner to scope GitHub results to a specific GitHub user or organization.
Use --local to skip the GitHub search and only search local sources.

Set GITHUB_TOKEN or GH_TOKEN for higher API rate limits.`,
		Example: "  cam " + string(kind) + " search terraform\n" +
			"  cam " + string(kind) + " search code-review\n" +
			"  cam " + string(kind) + " search terraform --owner hashicorp\n" +
			"  cam " + string(kind) + " search terraform --limit 5\n" +
			"  cam " + string(kind) + " search terraform --local",
		Args: cobra.MinimumNArgs(1),
		RunE: func(cmd *cobra.Command, args []string) error {
			query := strings.ToLower(strings.Join(args, " "))
			out := cmd.OutOrStdout()

			// -----------------------------------------------------------
			// Tier 1: GitHub Code Search (skip with --local).
			// -----------------------------------------------------------
			var ghResults []ghSearchResult
			if !local {
				var err error
				ghResults, err = searchGitHub(kind, strings.Join(args, " "), owner, limit)
				if err != nil {
					fmt.Fprintf(out, "GitHub search: %v\n\n", err)
				}

				// Validate: filter to only valid skills.
				if kind == entities.KindSkill {
					ghResults = filterValidSkillResults(ghResults)
				}

				// Rank by relevance.
				rankGHResults(ghResults, strings.Join(args, " "))
			}