codesift-mcp 0.1.0

package/dist/cli/commands.js

@@ -0,0 +1,336 @@
+// ---------------------------------------------------------------------------
+// CLI command handlers
+// ---------------------------------------------------------------------------
+import { getFlag, getBoolFlag, getNumFlag, requireArg, output, die } from "./args.js";
+// ---------------------------------------------------------------------------
+// Index commands
+// ---------------------------------------------------------------------------
+async function handleIndex(args, flags) {
+    const path = requireArg(args, 0, "path");
+    const { indexFolder } = await import("../tools/index-tools.js");
+    const includePathsRaw = getFlag(flags, "include-paths");
+    const includePaths = includePathsRaw ? includePathsRaw.split(",").map(p => p.trim()) : undefined;
+    const result = await indexFolder(path, {
+        incremental: getBoolFlag(flags, "incremental"),
+        include_paths: includePaths,
+        watch: getBoolFlag(flags, "no-watch") === true ? false : undefined,
+    });
+    output(result, flags);
+}
+async function handleIndexRepo(args, flags) {
+    const url = requireArg(args, 0, "url");
+    const { indexRepo } = await import("../tools/index-tools.js");
+    const includePathsRaw = getFlag(flags, "include-paths");
+    const includePaths = includePathsRaw ? includePathsRaw.split(",").map(p => p.trim()) : undefined;
+    const result = await indexRepo(url, {
+        branch: getFlag(flags, "branch"),
+        include_paths: includePaths,
+    });
+    output(result, flags);
+}
+async function handleRepos(_args, flags) {
+    const { listAllRepos } = await import("../tools/index-tools.js");
+    const result = await listAllRepos();
+    output(result, flags);
+}
+async function handleInvalidate(args, flags) {
+    const repo = requireArg(args, 0, "repo");
+    const { invalidateCache } = await import("../tools/index-tools.js");
+    const result = await invalidateCache(repo);
+    output({ invalidated: result, repo }, flags);
+}
+// ---------------------------------------------------------------------------
+// Search commands
+// ---------------------------------------------------------------------------
+async function handleSearch(args, flags) {
+    const repo = requireArg(args, 0, "repo");
+    const query = requireArg(args, 1, "query");
+    const { searchText } = await import("../tools/search-tools.js");
+    const result = await searchText(repo, query, {
+        file_pattern: getFlag(flags, "file-pattern"),
+        regex: getBoolFlag(flags, "regex"),
+        context_lines: getNumFlag(flags, "context-lines"),
+        max_results: getNumFlag(flags, "max-results"),
+    });
+    output(result, flags);
+}
+async function handleSymbols(args, flags) {
+    const repo = requireArg(args, 0, "repo");
+    const query = requireArg(args, 1, "query");
+    const { searchSymbols } = await import("../tools/search-tools.js");
+    const includeSource = getBoolFlag(flags, "include-source");
+    const explicitTopK = getNumFlag(flags, "top-k");
+    // When --include-source is set and no explicit --top-k, default to 5
+    // instead of 50 to avoid returning 50 full function bodies
+    const topK = explicitTopK ?? (includeSource ? 5 : undefined);
+    const result = await searchSymbols(repo, query, {
+        kind: getFlag(flags, "kind"),
+        file_pattern: getFlag(flags, "file-pattern"),
+        include_source: includeSource,
+        top_k: topK,
+        source_chars: getNumFlag(flags, "source-chars"),
+    });
+    output(result, flags);
+}
+// ---------------------------------------------------------------------------
+// Outline commands
+// ---------------------------------------------------------------------------
+async function handleTree(args, flags) {
+    const repo = requireArg(args, 0, "repo");
+    const { getFileTree } = await import("../tools/outline-tools.js");
+    const result = await getFileTree(repo, {
+        path_prefix: getFlag(flags, "path") ?? args[1],
+        name_pattern: getFlag(flags, "name-pattern"),
+        depth: getNumFlag(flags, "depth"),
+        compact: getBoolFlag(flags, "compact"),
+        min_symbols: getNumFlag(flags, "min-symbols"),
+    });
+    output(result, flags);
+}
+async function handleOutline(args, flags) {
+    const repo = requireArg(args, 0, "repo");
+    const file = requireArg(args, 1, "file");
+    const { getFileOutline } = await import("../tools/outline-tools.js");
+    const result = await getFileOutline(repo, file);
+    output(result, flags);
+}
+async function handleRepoOutline(args, flags) {
+    const repo = requireArg(args, 0, "repo");
+    const { getRepoOutline } = await import("../tools/outline-tools.js");
+    const result = await getRepoOutline(repo);
+    output(result, flags);
+}
+// ---------------------------------------------------------------------------
+// Symbol commands
+// ---------------------------------------------------------------------------
+async function handleSymbol(args, flags) {
+    const repo = requireArg(args, 0, "repo");
+    const id = requireArg(args, 1, "id");
+    const { getSymbol } = await import("../tools/symbol-tools.js");
+    const result = await getSymbol(repo, id);
+    if (result === null) {
+        die(`Symbol not found: ${id}`);
+    }
+    output(result, flags);
+}
+async function handleSymbolsBatch(args, flags) {
+    const repo = requireArg(args, 0, "repo");
+    const ids = args.slice(1);
+    if (ids.length === 0) {
+        die("Missing required argument: <ids...>");
+    }
+    const { getSymbols } = await import("../tools/symbol-tools.js");
+    const result = await getSymbols(repo, ids);
+    output(result, flags);
+}
+async function handleFind(args, flags) {
+    const repo = requireArg(args, 0, "repo");
+    const query = requireArg(args, 1, "query");
+    const { findAndShow } = await import("../tools/symbol-tools.js");
+    const result = await findAndShow(repo, query, getBoolFlag(flags, "include-refs"));
+    if (result === null) {
+        die(`No symbol found matching: ${query}`);
+    }
+    output(result, flags);
+}
+async function handleRefs(args, flags) {
+    const repo = requireArg(args, 0, "repo");
+    const name = requireArg(args, 1, "name");
+    const { findReferences } = await import("../tools/symbol-tools.js");
+    const result = await findReferences(repo, name, getFlag(flags, "file-pattern"));
+    if (getBoolFlag(flags, "json")) {
+        output(result, flags);
+    }
+    else {
+        // Compact tabular output: file:line:col | context
+        for (const ref of result) {
+            const loc = `${ref.file}:${ref.line}${ref.col ? `:${ref.col}` : ""}`;
+            process.stdout.write(`${loc} | ${ref.context}\n`);
+        }
+        process.stderr.write(`\n${result.length} references found\n`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Graph commands
+// ---------------------------------------------------------------------------
+async function handleTrace(args, flags) {
+    const repo = requireArg(args, 0, "repo");
+    const name = requireArg(args, 1, "name");
+    const { traceCallChain } = await import("../tools/graph-tools.js");
+    const direction = (getFlag(flags, "direction") ?? "callers");
+    if (direction !== "callers" && direction !== "callees") {
+        die(`Invalid --direction: ${direction}. Must be "callers" or "callees".`);
+    }
+    const includeSource = getBoolFlag(flags, "include-source") ?? false;
+    const includeTests = getBoolFlag(flags, "include-tests") ?? false;
+    const result = await traceCallChain(repo, name, direction, {
+        depth: getNumFlag(flags, "depth"),
+        include_source: includeSource,
+        include_tests: includeTests,
+    });
+    if (getBoolFlag(flags, "json")) {
+        output(result, flags);
+    }
+    else {
+        // Compact tree output
+        function printNode(node, indent) {
+            const prefix = indent === 0 ? "" : "  ".repeat(indent) + "|- ";
+            const sym = node.symbol;
+            const sig = sym.signature ? ` ${sym.signature}` : "";
+            const loc = `${sym.file}:${sym.start_line}`;
+            process.stdout.write(`${prefix}${sym.kind} | ${sym.name}${sig} | ${loc}\n`);
+            for (const child of node.children) {
+                printNode(child, indent + 1);
+            }
+        }
+        printNode(result, 0);
+        // Count total nodes
+        function countNodes(node) {
+            return 1 + node.children.reduce((sum, c) => sum + countNodes(c), 0);
+        }
+        process.stderr.write(`\n${countNodes(result)} symbols in trace\n`);
+    }
+}
+async function handleImpact(args, flags) {
+    const repo = requireArg(args, 0, "repo");
+    const since = getFlag(flags, "since");
+    if (!since) {
+        die("Missing required flag: --since <ref>");
+    }
+    const { impactAnalysis } = await import("../tools/graph-tools.js");
+    const result = await impactAnalysis(repo, since, {
+        depth: getNumFlag(flags, "depth"),
+        until: getFlag(flags, "until"),
+        include_source: getBoolFlag(flags, "include-source"),
+    });
+    output(result, flags);
+}
+// ---------------------------------------------------------------------------
+// Context commands
+// ---------------------------------------------------------------------------
+async function handleContext(args, flags) {
+    const repo = requireArg(args, 0, "repo");
+    const query = requireArg(args, 1, "query");
+    const { assembleContext } = await import("../tools/context-tools.js");
+    const result = await assembleContext(repo, query, getNumFlag(flags, "token-budget"));
+    output(result, flags);
+}
+async function handleKnowledgeMap(args, flags) {
+    const repo = requireArg(args, 0, "repo");
+    const { getKnowledgeMap } = await import("../tools/context-tools.js");
+    const result = await getKnowledgeMap(repo, getFlag(flags, "focus"), getNumFlag(flags, "depth"));
+    output(result, flags);
+}
+// ---------------------------------------------------------------------------
+// Diff commands
+// ---------------------------------------------------------------------------
+async function handleDiff(args, flags) {
+    const repo = requireArg(args, 0, "repo");
+    const since = getFlag(flags, "since");
+    if (!since) {
+        die("Missing required flag: --since <ref>");
+    }
+    const { diffOutline } = await import("../tools/diff-tools.js");
+    const result = await diffOutline(repo, since, getFlag(flags, "until"));
+    output(result, flags);
+}
+async function handleChanged(args, flags) {
+    const repo = requireArg(args, 0, "repo");
+    const since = getFlag(flags, "since");
+    if (!since) {
+        die("Missing required flag: --since <ref>");
+    }
+    const { changedSymbols } = await import("../tools/diff-tools.js");
+    const result = await changedSymbols(repo, since, getFlag(flags, "until"));
+    output(result, flags);
+}
+// ---------------------------------------------------------------------------
+// Retrieval & utility commands
+// ---------------------------------------------------------------------------
+async function handleRetrieve(args, flags) {
+    const repo = requireArg(args, 0, "repo");
+    const queriesRaw = getFlag(flags, "queries");
+    if (!queriesRaw) {
+        die("Missing required flag: --queries <json>");
+    }
+    let queries;
+    try {
+        const parsed = JSON.parse(queriesRaw);
+        if (!Array.isArray(parsed)) {
+            die("--queries must be a JSON array");
+        }
+        queries = parsed;
+    }
+    catch {
+        die("Invalid JSON for --queries flag");
+    }
+    // --exclude-tests (default: true) — pass to semantic/hybrid sub-queries
+    // Use --no-exclude-tests or --exclude-tests=false to include test files
+    const excludeTestsFlag = getBoolFlag(flags, "exclude-tests");
+    const excludeTests = excludeTestsFlag !== false; // default true
+    if (excludeTests) {
+        // Inject exclude_tests into semantic/hybrid sub-queries that don't already specify it
+        for (const q of queries) {
+            if ((q.type === "semantic" || q.type === "hybrid") && q["exclude_tests"] === undefined) {
+                q["exclude_tests"] = true;
+            }
+        }
+    }
+    else {
+        // Explicitly set false on semantic/hybrid sub-queries
+        for (const q of queries) {
+            if ((q.type === "semantic" || q.type === "hybrid") && q["exclude_tests"] === undefined) {
+                q["exclude_tests"] = false;
+            }
+        }
+    }
+    const { codebaseRetrieval } = await import("../retrieval/codebase-retrieval.js");
+    const result = await codebaseRetrieval(repo, queries, getNumFlag(flags, "token-budget"));
+    output(result, flags);
+}
+async function handleStats(_args, flags) {
+    const { getUsageStats, formatUsageReport } = await import("../storage/usage-stats.js");
+    const stats = await getUsageStats();
+    // If --json flag is set (or default), output raw stats; otherwise formatted report
+    if (getBoolFlag(flags, "json") === false) {
+        const report = formatUsageReport(stats);
+        process.stdout.write(report + "\n");
+    }
+    else {
+        output(stats, flags);
+    }
+}
+async function handleGenerateClaudeMd(args, flags) {
+    const repo = requireArg(args, 0, "repo");
+    const { generateClaudeMd } = await import("../tools/generate-tools.js");
+    const result = await generateClaudeMd(repo, getFlag(flags, "output"));
+    output(result, flags);
+}
+// ---------------------------------------------------------------------------
+// Command dispatch map
+// ---------------------------------------------------------------------------
+export const COMMAND_MAP = {
+    "index": handleIndex,
+    "index-repo": handleIndexRepo,
+    "repos": handleRepos,
+    "invalidate": handleInvalidate,
+    "search": handleSearch,
+    "symbols": handleSymbols,
+    "tree": handleTree,
+    "outline": handleOutline,
+    "repo-outline": handleRepoOutline,
+    "symbol": handleSymbol,
+    "symbols-batch": handleSymbolsBatch,
+    "find": handleFind,
+    "refs": handleRefs,
+    "trace": handleTrace,
+    "impact": handleImpact,
+    "context": handleContext,
+    "knowledge-map": handleKnowledgeMap,
+    "diff": handleDiff,
+    "changed": handleChanged,
+    "retrieve": handleRetrieve,
+    "stats": handleStats,
+    "generate-claude-md": handleGenerateClaudeMd,
+};
+//# sourceMappingURL=commands.js.map

package/dist/cli/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"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"}

package/dist/cli/help.d.ts

@@ -0,0 +1,3 @@
+export declare const MAIN_HELP = "codesift \u2014 CLI for CodeSift code intelligence\n\nUsage: codesift <command> [options]\n\nCommands:\n  index <path>                    Index a local folder\n  index-repo <url>                Clone and index a remote git repository\n  repos                           List all indexed repositories\n  invalidate <repo>               Clear index cache for a repository\n\n  search <repo> <query>           Full-text search across all files\n  symbols <repo> <query>          Search symbols by name/signature\n  tree <repo>                     Get file tree with symbol counts\n  outline <repo> <file>           Get symbol outline of a single file\n  repo-outline <repo>             High-level repository outline\n\n  symbol <repo> <id>              Get a single symbol by ID\n  symbols-batch <repo> <ids...>   Get multiple symbols by ID\n\n  find <repo> <query>             Find symbol and show source\n  refs <repo> <name>              Find all references to a symbol\n  trace <repo> <name>             Trace call chain (callers/callees)\n\n  impact <repo> --since <ref>     Analyze blast radius of git changes\n  context <repo> <query>          Assemble relevant code context\n  knowledge-map <repo>            Module dependency map\n\n  diff <repo> --since <ref>       Structural diff outline between git refs\n  changed <repo> --since <ref>    List changed symbols between git refs\n\n  retrieve <repo> --queries <json>  Batch multiple queries in one call\n  stats                           Show usage statistics\n  generate-claude-md <repo>       Generate CLAUDE.md project summary\n\nFlags:\n  --help            Show help for a command\n  --version         Show version\n  --compact         Compact JSON output (no indentation)\n  --json            Full JSON output (for refs, trace commands)\n  --include-source  Include source code in output (trace, impact)\n\nExamples:\n  codesift index /path/to/project\n  codesift repos\n  codesift search local/my-project \"createUser\"\n  codesift symbols local/my-project \"handleRequest\" --kind function\n  codesift tree local/my-project --path src/lib --depth 2\n  codesift trace local/my-project \"createRisk\" --direction callers --depth 2\n";
+export declare const COMMAND_HELP: Record<string, string>;
+//# sourceMappingURL=help.d.ts.map

package/dist/cli/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,SAAS,upEAgDrB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA8O/C,CAAC"}

package/dist/cli/help.js

@@ -0,0 +1,271 @@
+// ---------------------------------------------------------------------------
+// CLI help text
+// ---------------------------------------------------------------------------
+export const MAIN_HELP = `codesift — CLI for CodeSift code intelligence
+
+Usage: codesift <command> [options]
+
+Commands:
+  index <path>                    Index a local folder
+  index-repo <url>                Clone and index a remote git repository
+  repos                           List all indexed repositories
+  invalidate <repo>               Clear index cache for a repository
+
+  search <repo> <query>           Full-text search across all files
+  symbols <repo> <query>          Search symbols by name/signature
+  tree <repo>                     Get file tree with symbol counts
+  outline <repo> <file>           Get symbol outline of a single file
+  repo-outline <repo>             High-level repository outline
+
+  symbol <repo> <id>              Get a single symbol by ID
+  symbols-batch <repo> <ids...>   Get multiple symbols by ID
+
+  find <repo> <query>             Find symbol and show source
+  refs <repo> <name>              Find all references to a symbol
+  trace <repo> <name>             Trace call chain (callers/callees)
+
+  impact <repo> --since <ref>     Analyze blast radius of git changes
+  context <repo> <query>          Assemble relevant code context
+  knowledge-map <repo>            Module dependency map
+
+  diff <repo> --since <ref>       Structural diff outline between git refs
+  changed <repo> --since <ref>    List changed symbols between git refs
+
+  retrieve <repo> --queries <json>  Batch multiple queries in one call
+  stats                           Show usage statistics
+  generate-claude-md <repo>       Generate CLAUDE.md project summary
+
+Flags:
+  --help            Show help for a command
+  --version         Show version
+  --compact         Compact JSON output (no indentation)
+  --json            Full JSON output (for refs, trace commands)
+  --include-source  Include source code in output (trace, impact)
+
+Examples:
+  codesift index /path/to/project
+  codesift repos
+  codesift search local/my-project "createUser"
+  codesift symbols local/my-project "handleRequest" --kind function
+  codesift tree local/my-project --path src/lib --depth 2
+  codesift trace local/my-project "createRisk" --direction callers --depth 2
+`;
+export const COMMAND_HELP = {
+    index: `codesift index <path> [options]
+
+Index a local folder, extracting symbols and building the search index.
+
+Arguments:
+  <path>    Absolute path to the folder to index
+
+Options:
+  --incremental     Only re-index changed files
+  --include-paths   Comma-separated path prefixes to include
+  --no-watch        Disable file watcher for incremental updates`,
+    "index-repo": `codesift index-repo <url> [options]
+
+Clone and index a remote git repository.
+
+Arguments:
+  <url>    Git clone URL
+
+Options:
+  --branch          Branch to checkout
+  --include-paths   Comma-separated path prefixes to include`,
+    repos: `codesift repos
+
+List all indexed repositories with metadata.`,
+    invalidate: `codesift invalidate <repo>
+
+Clear the index cache for a repository, forcing full re-index on next use.
+
+Arguments:
+  <repo>    Repository identifier (e.g. local/my-project)`,
+    search: `codesift search <repo> <query> [options]
+
+Full-text search across all files in a repository.
+
+Arguments:
+  <repo>     Repository identifier
+  <query>    Search query or regex pattern
+
+Options:
+  --file-pattern     Glob pattern to filter files (e.g. "*.ts")
+  --regex            Treat query as a regex pattern
+  --context-lines    Number of context lines around each match (default: 2)
+  --max-results      Maximum number of matching lines (default: 500)`,
+    symbols: `codesift symbols <repo> <query> [options]
+
+Search for code symbols (functions, classes, types) by name or signature.
+
+Arguments:
+  <repo>     Repository identifier
+  <query>    Search query string
+
+Options:
+  --kind             Filter by symbol kind (function, class, interface, type, etc.)
+  --file-pattern     Glob pattern to filter files
+  --include-source   Include full source code (default: true; sets top-k default to 5)
+  --top-k            Maximum number of results (default: 50, or 5 with --include-source)
+  --source-chars     Truncate each symbol's source to N characters`,
+    tree: `codesift tree <repo> [options]
+
+Get the file tree of a repository with symbol counts per file.
+
+Arguments:
+  <repo>    Repository identifier
+
+Options:
+  --path            Filter to a subtree by path prefix
+  --name-pattern    Glob pattern to filter file names
+  --depth           Maximum directory depth
+  --compact         Return flat list instead of nested tree
+  --min-symbols     Only include files with at least N symbols`,
+    outline: `codesift outline <repo> <file>
+
+Get the symbol outline of a single file.
+
+Arguments:
+  <repo>    Repository identifier
+  <file>    Relative file path within the repository`,
+    "repo-outline": `codesift repo-outline <repo>
+
+Get a high-level outline of the entire repository grouped by directory.
+
+Arguments:
+  <repo>    Repository identifier`,
+    symbol: `codesift symbol <repo> <id>
+
+Retrieve a single symbol by its unique ID with full source code.
+
+Arguments:
+  <repo>    Repository identifier
+  <id>      Unique symbol identifier`,
+    "symbols-batch": `codesift symbols-batch <repo> <ids...>
+
+Retrieve multiple symbols by ID in a single batch call.
+
+Arguments:
+  <repo>      Repository identifier
+  <ids...>    Space-separated symbol identifiers`,
+    find: `codesift find <repo> <query> [options]
+
+Find a symbol by name and show its source.
+
+Arguments:
+  <repo>     Repository identifier
+  <query>    Symbol name or query to search for
+
+Options:
+  --include-refs    Include locations that reference this symbol`,
+    refs: `codesift refs <repo> <name> [options]
+
+Find all references to a symbol across the codebase.
+
+Arguments:
+  <repo>    Repository identifier
+  <name>    Name of the symbol to find references for
+
+Options:
+  --file-pattern    Glob pattern to filter files
+  --json            Output full JSON instead of compact table`,
+    trace: `codesift trace <repo> <name> [options]
+
+Trace the call chain of a symbol.
+
+Arguments:
+  <repo>    Repository identifier
+  <name>    Name of the symbol to trace
+
+Options:
+  --direction       Trace direction: callers or callees (default: callers)
+  --depth           Maximum depth to traverse (default: 1)
+  --include-source  Include full source code of each symbol
+  --include-tests   Include test files in trace results
+  --json            Output full JSON instead of compact tree`,
+    impact: `codesift impact <repo> --since <ref> [options]
+
+Analyze the blast radius of recent git changes.
+
+Arguments:
+  <repo>    Repository identifier
+
+Options:
+  --since    Git ref to compare from (required, e.g. HEAD~3, commit SHA)
+  --depth    Depth of dependency traversal
+  --until    Git ref to compare to (default: HEAD)`,
+    context: `codesift context <repo> <query> [options]
+
+Assemble a focused code context for a query within a token budget.
+
+Arguments:
+  <repo>     Repository identifier
+  <query>    Natural language query describing what context is needed
+
+Options:
+  --token-budget    Maximum tokens for the assembled context`,
+    "knowledge-map": `codesift knowledge-map <repo> [options]
+
+Get the module dependency map showing how files relate.
+
+Arguments:
+  <repo>    Repository identifier
+
+Options:
+  --focus    Focus on a specific module or directory
+  --depth    Maximum depth of the dependency graph`,
+    diff: `codesift diff <repo> --since <ref> [options]
+
+Get a structural outline of what changed between two git refs.
+
+Arguments:
+  <repo>    Repository identifier
+
+Options:
+  --since    Git ref to compare from (required)
+  --until    Git ref to compare to (default: HEAD)`,
+    changed: `codesift changed <repo> --since <ref> [options]
+
+List symbols in each changed file between two git refs.
+
+Arguments:
+  <repo>    Repository identifier
+
+Options:
+  --since    Git ref to compare from (required)
+  --until    Git ref to compare to (default: HEAD)`,
+    retrieve: `codesift retrieve <repo> --queries <json> [options]
+
+Execute multiple search/retrieval queries in a single batched call.
+
+Arguments:
+  <repo>    Repository identifier
+
+Options:
+  --queries              JSON array of sub-queries (required)
+  --token-budget         Maximum total tokens across all results
+  --exclude-tests        Exclude test files from semantic/hybrid results (default: true)
+  --exclude-tests=false  Include test files in semantic/hybrid results
+
+Sub-query types: symbols, text, file_tree, outline, references,
+  call_chain, impact, context, knowledge_map, semantic, hybrid
+
+Semantic/hybrid sub-queries support an "exclude_tests" field (default: true).
+
+Example:
+  codesift retrieve local/my-project --queries '[{"type":"symbols","query":"createUser"},{"type":"text","query":"TODO"}]'
+  codesift retrieve local/my-project --queries '[{"type":"semantic","query":"caching"}]' --exclude-tests=false`,
+    stats: `codesift stats
+
+Show usage statistics for all CodeSift tool calls.`,
+    "generate-claude-md": `codesift generate-claude-md <repo> [options]
+
+Generate a CLAUDE.md project summary from the repository index.
+
+Arguments:
+  <repo>    Repository identifier
+
+Options:
+  --output    Custom output file path`,
+};
+//# sourceMappingURL=help.js.map

package/dist/cli/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgDxB,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAA2B;IAClD,KAAK,EAAE;;;;;;;;;;iEAUwD;IAE/D,YAAY,EAAE;;;;;;;;;6DAS6C;IAE3D,KAAK,EAAE;;6CAEoC;IAE3C,UAAU,EAAE;;;;;0DAK4C;IAExD,MAAM,EAAE;;;;;;;;;;;;qEAY2D;IAEnE,OAAO,EAAE;;;;;;;;;;;;;mEAawD;IAEjE,IAAI,EAAE;;;;;;;;;;;;+DAYuD;IAE7D,OAAO,EAAE;;;;;;qDAM0C;IAEnD,cAAc,EAAE;;;;;kCAKgB;IAEhC,MAAM,EAAE;;;;;;qCAM2B;IAEnC,eAAe,EAAE;;;;;;iDAM8B;IAE/C,IAAI,EAAE;;;;;;;;;iEASyD;IAE/D,IAAI,EAAE;;;;;;;;;;8DAUsD;IAE5D,KAAK,EAAE;;;;;;;;;;;;;6DAaoD;IAE3D,MAAM,EAAE;;;;;;;;;;mDAUyC;IAEjD,OAAO,EAAE;;;;;;;;;6DASkD;IAE3D,eAAe,EAAE;;;;;;;;;mDASgC;IAEjD,IAAI,EAAE;;;;;;;;;mDAS2C;IAEjD,OAAO,EAAE;;;;;;;;;mDASwC;IAEjD,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;+GAoBmG;IAE7G,KAAK,EAAE;;mDAE0C;IAEjD,oBAAoB,EAAE;;;;;;;;sCAQc;CACrC,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}