Merge pull request #96 from vkop007/68-TranscriptToolsAdded

feat: add search command to index and query providers, commands, and …

Author: vkop007

README.md

@@ -100,6 +100,7 @@ Typical commands:
 
 ```bash
 autocli status
+autocli search "youtube download"
 autocli llm chatgpt text "Write release notes for AutoCLI"
 autocli developer github login --browser
 autocli developer github me --json
@@ -175,6 +176,19 @@ autocli tools download batch ./urls.txt --mode video --quality 720p
 autocli tools download info 'https://www.youtube.com/playlist?list=PLFgquLnL59alCl_2TQvOiD5Vgm1hCaGSI' --playlist --limit 5
 ```
 
+## Command Search
+
+Use `autocli search` to find providers and exact runnable commands across AutoCLI's built-in command surface.
+
+Examples:
+
+```bash
+autocli search github
+autocli search "youtube download"
+autocli search uptime --category devops
+autocli search transcript --json
+```
+
 ## Cross-Site Transcripts
 
 Use `autocli tools transcript` to pull subtitles or transcripts from media pages supported by `yt-dlp`, with plain text by default and subtitle formats when you need them.

skills/autocli/SKILL.md

@@ -60,6 +60,7 @@ Use only one recovery step before retrying unless the user explicitly asks for t
 ## Global Commands
 
 - `autocli login --browser`
+- `autocli search <query>`
 - `autocli status --json`
 - `autocli doctor --json`
 - `autocli sessions --json`

src/__tests__/readme-category-commands.test.ts

@@ -2,7 +2,7 @@ import { describe, expect, test } from "bun:test";
 
 import { getPlatformCategories } from "../platforms/index.js";
 
-const ALLOWED_ROOT_COMMANDS = new Set<string>(["login", "status", "doctor", "sessions", "help", "-h", "--help", "-v", "--version", ...getPlatformCategories()]);
+const ALLOWED_ROOT_COMMANDS = new Set<string>(["login", "search", "status", "doctor", "sessions", "help", "-h", "--help", "-v", "--version", ...getPlatformCategories()]);
 
 describe("README command examples", () => {
   test("use category-based routing for provider commands", async () => {

src/__tests__/search-command.test.ts

@@ -0,0 +1,41 @@
+import { describe, expect, test } from "bun:test";
+
+import { buildSearchIndex, searchCommandIndex } from "../commands/search.js";
+import { createProgram } from "../program.js";
+
+describe("search command", () => {
+  test("registers the root search command", () => {
+    const commandNames = createProgram().commands.map((command) => command.name());
+    expect(commandNames).toContain("search");
+  });
+
+  test("indexes providers and nested commands", () => {
+    const index = buildSearchIndex();
+    expect(index.some((entry) => entry.command === "autocli tools download")).toBe(true);
+    expect(index.some((entry) => entry.command === "autocli tools download video")).toBe(true);
+    expect(index.some((entry) => entry.command === "autocli login")).toBe(true);
+  });
+
+  test("finds provider matches by display name and category words", () => {
+    const results = searchCommandIndex(buildSearchIndex(), "uptime robot", { limit: 5 });
+    expect(results[0]?.command).toBe("autocli devops uptimerobot");
+  });
+
+  test("finds command matches from examples and descriptions", () => {
+    const results = searchCommandIndex(buildSearchIndex(), "youtube download", { limit: 5 });
+    expect(results.some((entry) => entry.command === "autocli tools download")).toBe(true);
+  });
+
+  test("supports category filtering", () => {
+    const results = searchCommandIndex(buildSearchIndex(), "uptime", {
+      category: "devops",
+      limit: 10,
+    });
+    expect(results.every((entry) => entry.category === "devops")).toBe(true);
+  });
+
+  test("finds root commands by option text", () => {
+    const results = searchCommandIndex(buildSearchIndex(), "browser login", { limit: 5 });
+    expect(results[0]?.command).toBe("autocli login");
+  });
+});