src-mcp 1.0.1

package/dist/prompts/index.js

@@ -0,0 +1,188 @@
+/**
+ * Register MCP prompts
+ *
+ * Prompts are reusable templates that help AI assistants understand
+ * how to use SRC effectively for code search and analysis.
+ */
+export function registerPrompts(server) {
+    // Main overview prompt - helps AI understand when to use SRC
+    server.registerPrompt("src-overview", {
+        title: "SRC Overview",
+        description: "Learn about SRC capabilities and when to use it for code search and analysis",
+    }, () => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `# SRC (Structured Repo Context) - Overview
+
+## What is SRC?
+SRC is a semantic code search MCP server. It indexes codebases and provides intelligent search using:
+- **Vector embeddings** for semantic similarity (understands meaning, not just keywords)
+- **BM25 keyword search** for exact matches
+- **Hybrid search** combining both with RRF fusion
+- **LLM re-ranking** for optimal relevance
+- **Call graph analysis** showing function relationships
+
+## When to use SRC?
+
+**USE SRC when the user wants to:**
+- Find code by meaning/concept ("find authentication logic", "where is error handling")
+- Understand code relationships ("what calls this function", "what does this function call")
+- Search across a large codebase
+- Find similar code patterns
+- Explore unfamiliar code
+
+**DON'T USE SRC for:**
+- Reading a specific file (use file read tools instead)
+- Simple text search in a single file (use grep/search)
+- Non-code queries
+
+## Typical Workflow
+
+1. **Check status**: Use \`get_index_status\` to see if index exists
+2. **Index if needed**: Use \`index_codebase\` (only once per project)
+3. **Search**: Use \`search_code\` with natural language queries
+
+Note: When using \`serve\` mode, the server auto-indexes on startup and watches for file changes.
+
+## Supported Languages
+- **Full AST support (18)**: JavaScript, TypeScript, Python, Rust, Go, Java, C, C++, C#, Ruby, PHP, Kotlin, Scala, Swift, HTML, Svelte, OCaml
+- **Text splitting (16+)**: Markdown, LaTeX, Solidity, Haskell, Elixir, and more
+- **Generic (30+)**: Config files, shell scripts, SQL, and more
+
+## Tips
+- Use natural language queries: "authentication middleware" not "auth*"
+- The hybrid search mode (default) works best for most queries
+- Call context is included by default - shows who calls what`,
+                },
+            },
+        ],
+    }));
+    // Workflow prompt - step by step guide
+    server.registerPrompt("code-search-workflow", {
+        title: "Code Search Workflow",
+        description: "Step-by-step guide for searching code with SRC",
+    }, () => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `# Code Search Workflow with SRC
+
+## Step 1: Check Index
+\`\`\`
+get_index_status()
+\`\`\`
+
+## Step 2: Index if Needed
+If no index exists:
+\`\`\`
+index_codebase()
+\`\`\`
+
+## Step 3: Search
+\`\`\`
+search_code(query: "your search query here")
+\`\`\`
+
+## search_code Arguments
+
+| Argument | Type | Default | Description |
+|----------|------|---------|-------------|
+| query | string | required | Natural language search query |
+| limit | number | 10 | Max results to return |
+| mode | "hybrid" / "vector" / "fts" | "hybrid" | Search mode |
+| rerank | boolean | true | LLM re-ranking for better relevance |
+| includeCallContext | boolean | true | Include caller/callee info |
+| threshold | number | - | Distance threshold (vector mode only) |
+
+## Search Modes
+- **hybrid** (default): Vector + BM25 + RRF fusion - best overall
+- **vector**: Semantic similarity only - good for conceptual queries
+- **fts**: Keyword search only - good for exact identifiers
+
+## Examples
+\`\`\`
+// Find authentication code
+search_code(query: "user authentication and login")
+
+// More results
+search_code(query: "error handling", limit: 20)
+
+// Exact identifier search
+search_code(query: "UserAuthService", mode: "fts")
+
+// Without call context (faster)
+search_code(query: "database queries", includeCallContext: false)
+\`\`\``,
+                },
+            },
+        ],
+    }));
+    // Search tips prompt
+    server.registerPrompt("search-tips", {
+        title: "Search Tips",
+        description: "Tips for writing effective code search queries",
+    }, () => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `# Effective Code Search Tips
+
+## Good Query Examples
+
+| Goal | Good Query | Why |
+|------|------------|-----|
+| Find auth code | "user authentication and login validation" | Describes the concept |
+| Find error handling | "error handling and exception catching" | Uses related terms |
+| Find API endpoints | "REST API route handlers" | Specifies the pattern |
+| Find database code | "database query and data persistence" | Covers the domain |
+| Find a function | "calculateTotalPrice function" | Includes the name |
+
+## Query Writing Tips
+
+1. **Be descriptive, not literal**
+   - Good: "user password validation and hashing"
+   - Bad: "validatePassword"
+
+2. **Include context**
+   - Good: "authentication middleware for Express routes"
+   - Bad: "auth middleware"
+
+3. **Use domain language**
+   - Good: "shopping cart checkout process"
+   - Bad: "cart function"
+
+4. **Combine concepts**
+   - Good: "file upload with size validation and error handling"
+   - Bad: "upload"
+
+## Search Mode Selection
+
+| Mode | Use When |
+|------|----------|
+| **hybrid** | Default choice, works for most queries |
+| **vector** | Conceptual searches like "code that handles retries" |
+| **fts** | Exact identifiers like "UserAuthService" |
+
+## Understanding Results
+
+Each result includes:
+- **content**: The matching code chunk
+- **filePath**: Source file location
+- **startLine/endLine**: Line numbers
+- **symbolName/Type**: Function or class name if detected
+- **score**: Relevance score (higher = better match)
+- **callers**: Functions that call this code
+- **callees**: Functions this code calls`,
+                },
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,6DAA6D;IAC7D,MAAM,CAAC,cAAc,CACnB,cAAc,EACd;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EACT,8EAA8E;KACjF,EACD,GAAG,EAAE,CAAC,CAAC;QACL,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6DAwC2C;iBAClD;aACF;SACF;KACF,CAAC,CACH,CAAC;IAEF,uCAAuC;IACvC,MAAM,CAAC,cAAc,CACnB,sBAAsB,EACtB;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,gDAAgD;KAC9D,EACD,GAAG,EAAE,CAAC,CAAC;QACL,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+CX;iBACI;aACF;SACF;KACF,CAAC,CACH,CAAC;IAEF,qBAAqB;IACrB,MAAM,CAAC,cAAc,CACnB,aAAa,EACb;QACE,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,gDAAgD;KAC9D,EACD,GAAG,EAAE,CAAC,CAAC;QACL,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yCA+CuB;iBAC9B;aACF;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/resources/index.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerResources(server: McpServer): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAczD"}

package/dist/resources/index.js

@@ -0,0 +1,17 @@
+import { getServerInfo } from "@features";
+export function registerResources(server) {
+    // eslint-disable-next-line @typescript-eslint/no-deprecated
+    server.resource("server_info", "src://server/info", (uri) => {
+        const info = getServerInfo();
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "application/json",
+                    text: JSON.stringify(info, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,4DAA4D;IAC5D,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,mBAAmB,EAAE,CAAC,GAAG,EAAE,EAAE;QAC1D,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;QAC7B,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,GAAG,CAAC,IAAI;oBACb,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;iBACpC;aACF;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createServer(): McpServer;
+export declare function startServer(): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQpE,wBAAgB,YAAY,IAAI,SAAS,CAWxC;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAMjD"}

package/dist/server.js

@@ -0,0 +1,24 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { config } from "@config";
+import { registerTools } from "@tools";
+import { registerResources } from "@resources";
+import { registerPrompts } from "@prompts";
+import { logger } from "@utils";
+export function createServer() {
+    const server = new McpServer({
+        name: config.name,
+        version: config.version,
+    });
+    registerTools(server);
+    registerResources(server);
+    registerPrompts(server);
+    return server;
+}
+export async function startServer() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info(`${config.name} v${config.version} started`);
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC,CAAC;IAEH,aAAa,CAAC,MAAM,CAAC,CAAC;IACtB,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,eAAe,CAAC,MAAM,CAAC,CAAC;IAExB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC;AAC3D,CAAC"}

package/dist/tools/adapter.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Feature } from "@features/types";
+export declare function registerFeatureAsTool(server: McpServer, feature: Feature): void;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/tools/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/tools/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAU/C,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,OAAO,GACf,IAAI,CA2BN"}

package/dist/tools/adapter.js

@@ -0,0 +1,28 @@
+import { z } from "zod";
+function zodToMcpSchema(schema) {
+    if (schema instanceof z.ZodObject) {
+        return schema.shape;
+    }
+    return { input: schema };
+}
+export function registerFeatureAsTool(server, feature) {
+    const mcpSchema = zodToMcpSchema(feature.schema);
+    // eslint-disable-next-line @typescript-eslint/no-deprecated
+    server.tool(feature.name, feature.description, mcpSchema, async (params) => {
+        const result = feature.execute(params);
+        const formatResult = (res) => ({
+            content: [
+                {
+                    type: "text",
+                    text: res.message ?? JSON.stringify(res.data, null, 2),
+                },
+            ],
+            isError: !res.success,
+        });
+        if (result instanceof Promise) {
+            return await result.then(formatResult);
+        }
+        return formatResult(result);
+    });
+}
+//# sourceMappingURL=adapter.js.map

package/dist/tools/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/tools/adapter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,SAAS,cAAc,CAAC,MAAiB;IACvC,IAAI,MAAM,YAAY,CAAC,CAAC,SAAS,EAAE,CAAC;QAClC,OAAO,MAAM,CAAC,KAAkC,CAAC;IACnD,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,MAAiB,EACjB,OAAgB;IAEhB,MAAM,SAAS,GAAG,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAEjD,4DAA4D;IAC5D,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QACzE,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAEvC,MAAM,YAAY,GAAG,CACnB,GAAgD,EAIhD,EAAE,CAAC,CAAC;YACJ,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;iBACvD;aACF;YACD,OAAO,EAAE,CAAC,GAAG,CAAC,OAAO;SACtB,CAAC,CAAC;QAEH,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;YAC9B,OAAO,MAAM,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { features } from "@features";
+export declare function registerTools(server: McpServer): void;
+export { features as tools };
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGrC,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAIrD;AAED,OAAO,EAAE,QAAQ,IAAI,KAAK,EAAE,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,9 @@
+import { features } from "@features";
+import { registerFeatureAsTool } from "@tools/adapter";
+export function registerTools(server) {
+    for (const feature of features) {
+        registerFeatureAsTool(server, feature);
+    }
+}
+export { features as tools };
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,MAAM,UAAU,aAAa,CAAC,MAAiB;IAC7C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED,OAAO,EAAE,QAAQ,IAAI,KAAK,EAAE,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,20 @@
+export type { Feature, FeatureResult } from "@features/types";
+export interface ServerConfig {
+    name: string;
+    fullName: string;
+    version: string;
+    description?: string;
+}
+export interface CLICommand {
+    name: string;
+    description: string;
+    options?: CLIOption[];
+    action: (args: string[], options: Record<string, string | boolean>) => void;
+}
+export interface CLIOption {
+    flag: string;
+    description: string;
+    required?: boolean;
+    defaultValue?: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE9D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IACtB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC;CAC7E;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/dist/utils/colors.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Color utilities for CLI output
+ */
+export declare const colors: {
+    success: import("picocolors/types").Formatter;
+    error: import("picocolors/types").Formatter;
+    warn: import("picocolors/types").Formatter;
+    info: import("picocolors/types").Formatter;
+    dim: import("picocolors/types").Formatter;
+    bold: import("picocolors/types").Formatter;
+    cyan: import("picocolors/types").Formatter;
+    magenta: import("picocolors/types").Formatter;
+    successBold: (text: string) => string;
+    errorBold: (text: string) => string;
+    infoBold: (text: string) => string;
+    formatSuccess: (msg: string) => string;
+    formatError: (msg: string) => string;
+    formatInfo: (msg: string) => string;
+    formatWarn: (msg: string) => string;
+    formatCommand: (cmd: string) => string;
+    formatValue: (val: string) => string;
+    formatPath: (path: string) => string;
+};
+//# sourceMappingURL=colors.d.ts.map

package/dist/utils/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../src/utils/colors.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,MAAM;;;;;;;;;wBAcG,MAAM,KAAG,MAAM;sBACjB,MAAM,KAAG,MAAM;qBAChB,MAAM,KAAG,MAAM;yBAGX,MAAM,KAAG,MAAM;uBACjB,MAAM,KAAG,MAAM;sBAChB,MAAM,KAAG,MAAM;sBACf,MAAM,KAAG,MAAM;yBAGZ,MAAM,KAAG,MAAM;uBACjB,MAAM,KAAG,MAAM;uBACf,MAAM,KAAG,MAAM;CACnC,CAAC"}

package/dist/utils/colors.js

@@ -0,0 +1,30 @@
+import pc from "picocolors";
+/**
+ * Color utilities for CLI output
+ */
+export const colors = {
+    // Status colors
+    success: pc.green,
+    error: pc.red,
+    warn: pc.yellow,
+    info: pc.blue,
+    // UI elements
+    dim: pc.dim,
+    bold: pc.bold,
+    cyan: pc.cyan,
+    magenta: pc.magenta,
+    // Composite helpers
+    successBold: (text) => pc.bold(pc.green(text)),
+    errorBold: (text) => pc.bold(pc.red(text)),
+    infoBold: (text) => pc.bold(pc.blue(text)),
+    // Format messages with icons
+    formatSuccess: (msg) => `${pc.green("✓")} ${msg}`,
+    formatError: (msg) => `${pc.red("✗")} ${msg}`,
+    formatInfo: (msg) => `${pc.blue("ℹ")} ${msg}`,
+    formatWarn: (msg) => `${pc.yellow("⚠")} ${msg}`,
+    // Format for CLI output
+    formatCommand: (cmd) => pc.cyan(cmd),
+    formatValue: (val) => pc.magenta(val),
+    formatPath: (path) => pc.dim(path),
+};
+//# sourceMappingURL=colors.js.map

package/dist/utils/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../../src/utils/colors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,gBAAgB;IAChB,OAAO,EAAE,EAAE,CAAC,KAAK;IACjB,KAAK,EAAE,EAAE,CAAC,GAAG;IACb,IAAI,EAAE,EAAE,CAAC,MAAM;IACf,IAAI,EAAE,EAAE,CAAC,IAAI;IAEb,cAAc;IACd,GAAG,EAAE,EAAE,CAAC,GAAG;IACX,IAAI,EAAE,EAAE,CAAC,IAAI;IACb,IAAI,EAAE,EAAE,CAAC,IAAI;IACb,OAAO,EAAE,EAAE,CAAC,OAAO;IAEnB,oBAAoB;IACpB,WAAW,EAAE,CAAC,IAAY,EAAU,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9D,SAAS,EAAE,CAAC,IAAY,EAAU,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1D,QAAQ,EAAE,CAAC,IAAY,EAAU,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE1D,6BAA6B;IAC7B,aAAa,EAAE,CAAC,GAAW,EAAU,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE;IACjE,WAAW,EAAE,CAAC,GAAW,EAAU,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE;IAC7D,UAAU,EAAE,CAAC,GAAW,EAAU,EAAE,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE;IAC7D,UAAU,EAAE,CAAC,GAAW,EAAU,EAAE,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE;IAE/D,wBAAwB;IACxB,aAAa,EAAE,CAAC,GAAW,EAAU,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;IACpD,WAAW,EAAE,CAAC,GAAW,EAAU,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;IACrD,UAAU,EAAE,CAAC,IAAY,EAAU,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC;CACnD,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,4 @@
+export { logger } from "@utils/logger";
+export { colors } from "@utils/colors";
+export { createSpinner, withSpinner } from "@utils/spinner";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,4 @@
+export { logger } from "@utils/logger";
+export { colors } from "@utils/colors";
+export { createSpinner, withSpinner } from "@utils/spinner";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,8 @@
+export declare const logger: {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    success(message: string, ...args: unknown[]): void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAqCA,eAAO,MAAM,MAAM;mBACF,MAAM,WAAW,OAAO,EAAE,GAAG,IAAI;kBAMlC,MAAM,WAAW,OAAO,EAAE,GAAG,IAAI;kBAOjC,MAAM,WAAW,OAAO,EAAE,GAAG,IAAI;mBAMhC,MAAM,WAAW,OAAO,EAAE,GAAG,IAAI;qBAM/B,MAAM,WAAW,OAAO,EAAE,GAAG,IAAI;CAInD,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,57 @@
+import { ENV } from "@config";
+import pc from "picocolors";
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+const LEVEL_COLORS = {
+    debug: pc.dim,
+    info: pc.blue,
+    warn: pc.yellow,
+    error: pc.red,
+};
+function isValidLogLevel(level) {
+    return level in LOG_LEVELS;
+}
+function shouldLog(level) {
+    const configLevel = ENV.logLevel;
+    const currentLevel = isValidLogLevel(configLevel)
+        ? LOG_LEVELS[configLevel]
+        : LOG_LEVELS.info;
+    return LOG_LEVELS[level] >= currentLevel;
+}
+function formatMessage(level, message) {
+    const timestamp = pc.dim(new Date().toISOString());
+    const levelTag = LEVEL_COLORS[level](level.toUpperCase().padEnd(5));
+    return `${timestamp} ${levelTag} ${message}`;
+}
+export const logger = {
+    debug(message, ...args) {
+        if (shouldLog("debug")) {
+            console.error(formatMessage("debug", message), ...args);
+        }
+    },
+    info(message, ...args) {
+        if (shouldLog("info")) {
+            // eslint-disable-next-line no-console
+            console.log(formatMessage("info", message), ...args);
+        }
+    },
+    warn(message, ...args) {
+        if (shouldLog("warn")) {
+            console.warn(formatMessage("warn", message), ...args);
+        }
+    },
+    error(message, ...args) {
+        if (shouldLog("error")) {
+            console.error(formatMessage("error", message), ...args);
+        }
+    },
+    success(message, ...args) {
+        // eslint-disable-next-line no-console
+        console.log(pc.green("✓ ") + message, ...args);
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,MAAM,YAAY,CAAC;AAI5B,MAAM,UAAU,GAA6B;IAC3C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,MAAM,YAAY,GAA4C;IAC5D,KAAK,EAAE,EAAE,CAAC,GAAG;IACb,IAAI,EAAE,EAAE,CAAC,IAAI;IACb,IAAI,EAAE,EAAE,CAAC,MAAM;IACf,KAAK,EAAE,EAAE,CAAC,GAAG;CACd,CAAC;AAEF,SAAS,eAAe,CAAC,KAAa;IACpC,OAAO,KAAK,IAAI,UAAU,CAAC;AAC7B,CAAC;AAED,SAAS,SAAS,CAAC,KAAe;IAChC,MAAM,WAAW,GAAG,GAAG,CAAC,QAAQ,CAAC;IACjC,MAAM,YAAY,GAAG,eAAe,CAAC,WAAW,CAAC;QAC/C,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC;QACzB,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;IACpB,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC;AAC3C,CAAC;AAED,SAAS,aAAa,CAAC,KAAe,EAAE,OAAe;IACrD,MAAM,SAAS,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACpE,OAAO,GAAG,SAAS,IAAI,QAAQ,IAAI,OAAO,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YACtB,sCAAsC;YACtC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,OAAO,CAAC,OAAe,EAAE,GAAG,IAAe;QACzC,sCAAsC;QACtC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACjD,CAAC;CACF,CAAC"}

package/dist/utils/spinner.d.ts

@@ -0,0 +1,11 @@
+import { type Ora } from "ora";
+/**
+ * Create a spinner with consistent styling
+ */
+export declare function createSpinner(text: string): Ora;
+/**
+ * Run an async function with a spinner
+ * Shows the spinner while the function is running, then shows success/failure
+ */
+export declare function withSpinner<T>(text: string, fn: () => Promise<T>, successText?: string): Promise<T>;
+//# sourceMappingURL=spinner.d.ts.map

package/dist/utils/spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../src/utils/spinner.ts"],"names":[],"mappings":"AAAA,OAAY,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAEpC;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAK/C;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,CAAC,CAAC,CAoBZ"}

package/dist/utils/spinner.js

@@ -0,0 +1,36 @@
+import ora from "ora";
+/**
+ * Create a spinner with consistent styling
+ */
+export function createSpinner(text) {
+    return ora({
+        text,
+        spinner: "dots",
+    });
+}
+/**
+ * Run an async function with a spinner
+ * Shows the spinner while the function is running, then shows success/failure
+ */
+export async function withSpinner(text, fn, successText) {
+    // Skip spinner in non-TTY environments (CI, pipes, etc.)
+    if (!process.stdout.isTTY) {
+        // eslint-disable-next-line no-console
+        console.log(text);
+        const result = await fn();
+        // eslint-disable-next-line no-console
+        console.log(successText ?? "Done");
+        return result;
+    }
+    const spinner = createSpinner(text).start();
+    try {
+        const result = await fn();
+        spinner.succeed(successText ?? text);
+        return result;
+    }
+    catch (error) {
+        spinner.fail();
+        throw error;
+    }
+}
+//# sourceMappingURL=spinner.js.map

package/dist/utils/spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../src/utils/spinner.ts"],"names":[],"mappings":"AAAA,OAAO,GAAiB,MAAM,KAAK,CAAC;AAEpC;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,GAAG,CAAC;QACT,IAAI;QACJ,OAAO,EAAE,MAAM;KAChB,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAY,EACZ,EAAoB,EACpB,WAAoB;IAEpB,yDAAyD;IACzD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC1B,sCAAsC;QACtC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;QAC1B,sCAAsC;QACtC,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,MAAM,CAAC,CAAC;QACnC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;QAC1B,OAAO,CAAC,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC;QACrC,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}