@venizia/ignis-docs 0.0.1-4 → 0.0.1-6

package/mcp-server/dist/tools/github/list-project-files.tool.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListProjectFilesTool = void 0;
+const tools_1 = require("@mastra/core/tools");
+const zod_1 = require("zod");
+const base_tool_1 = require("../base.tool");
+const helpers_1 = require("@/mcp-server/helpers");
+// ----------------------------------------------------------------------------
+// DESCRIPTIONS
+// ----------------------------------------------------------------------------
+const TOOL_DESCRIPTION = `
+Lists files and directories within the Ignis GitHub repository.
+
+PURPOSE:
+Explore the project structure, discover source code files, and navigate the monorepo.
+Primary tool for understanding codebase layout before reading specific files.
+
+WHEN TO USE:
+- To understand overall project structure
+- To find location of specific modules (e.g., "where are the controllers?")
+- To get list of files in a directory before using viewSourceFile
+- To find configuration files, examples, or documentation
+
+WHEN NOT TO USE:
+- When searching for specific code patterns or keywords (use searchCode instead)
+- When you need to read a file's content (use viewSourceFile instead)
+- For documentation content (use searchDocs, listDocs, getDocContent instead)
+
+WORKFLOW:
+1. Start at root: listProjectFiles()
+2. Explore a package: listProjectFiles({ directoryPath: "packages/core/src" })
+3. Identify a file of interest
+4. Read the file: viewSourceFile({ filePath: "packages/core/src/application.ts" })
+`;
+const DIRECTORY_PATH_DESCRIPTION = `
+The path to the directory you want to list, relative to the project root.
+If omitted, it defaults to the root of the repository.
+
+EXAMPLES:
+- "." (or omitted) -> lists the root directory
+- "packages" -> lists the contents of the 'packages' directory
+- "packages/core/src" -> lists the source files of the core package
+`;
+// ----------------------------------------------------------------------------
+// SCHEMAS
+// ----------------------------------------------------------------------------
+const InputSchema = zod_1.z.object({
+    directoryPath: zod_1.z.string().default('.').describe(DIRECTORY_PATH_DESCRIPTION),
+});
+const OutputSchema = zod_1.z.object({
+    directoryPath: zod_1.z.string(),
+    files: zod_1.z.array(zod_1.z.string()).describe('A list of file names within the specified directory.'),
+    directories: zod_1.z
+        .array(zod_1.z.string())
+        .describe('A list of subdirectory names within the specified directory.'),
+    error: zod_1.z.string().optional().describe('An error message if the directory could not be listed.'),
+});
+// ----------------------------------------------------------------------------
+// TOOL CLASS
+// ----------------------------------------------------------------------------
+class ListProjectFilesTool extends base_tool_1.BaseTool {
+    constructor() {
+        super(...arguments);
+        this.id = 'listProjectFiles';
+        this.description = TOOL_DESCRIPTION;
+        this.inputSchema = InputSchema;
+        this.outputSchema = OutputSchema;
+    }
+    async execute(opts) {
+        const contents = await helpers_1.GithubHelper.getDirectoryContents({ path: opts.directoryPath });
+        if ('error' in contents) {
+            return {
+                directoryPath: opts.directoryPath,
+                files: [],
+                directories: [],
+                error: contents.error,
+            };
+        }
+        const files = contents.filter(item => item.type === 'file').map(item => item.name);
+        const directories = contents.filter(item => item.type === 'dir').map(item => item.name);
+        return {
+            directoryPath: opts.directoryPath,
+            files,
+            directories,
+        };
+    }
+    getTool() {
+        return (0, tools_1.createTool)({
+            id: this.id,
+            description: this.description,
+            inputSchema: this.inputSchema,
+            outputSchema: this.outputSchema,
+            execute: async ({ context }) => this.execute(context),
+        });
+    }
+}
+exports.ListProjectFilesTool = ListProjectFilesTool;
+//# sourceMappingURL=list-project-files.tool.js.map

package/mcp-server/dist/tools/github/list-project-files.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-project-files.tool.js","sourceRoot":"","sources":["../../../tools/github/list-project-files.tool.ts"],"names":[],"mappings":";;;AAAA,8CAAgD;AAChD,6BAAwB;AACxB,4CAAqD;AACrD,kDAAoD;AAEpD,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;CAuBxB,CAAC;AAEF,MAAM,0BAA0B,GAAG;;;;;;;;CAQlC,CAAC;AAEF,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,MAAM,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3B,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;CAC5E,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5B,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE;IACzB,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,sDAAsD,CAAC;IAC3F,WAAW,EAAE,OAAC;SACX,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,CAAC,8DAA8D,CAAC;IAC3E,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;CAChG,CAAC,CAAC;AAEH,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E,MAAa,oBAAqB,SAAQ,oBAAiD;IAA3F;;QACW,OAAE,GAAG,kBAAkB,CAAC;QACxB,gBAAW,GAAG,gBAAgB,CAAC;QAC/B,gBAAW,GAAG,WAAW,CAAC;QAC1B,iBAAY,GAAG,YAAY,CAAC;IAkCvC,CAAC;IAhCC,KAAK,CAAC,OAAO,CAAC,IAAiC;QAC7C,MAAM,QAAQ,GAAG,MAAM,sBAAY,CAAC,oBAAoB,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;QAEvF,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC;YACxB,OAAO;gBACL,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,KAAK,EAAE,EAAE;gBACT,WAAW,EAAE,EAAE;gBACf,KAAK,EAAE,QAAQ,CAAC,KAAK;aACtB,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEnF,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAExF,OAAO;YACL,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,KAAK;YACL,WAAW;SACZ,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,IAAA,kBAAU,EAAC;YAChB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;SACtD,CAAC,CAAC;IACL,CAAC;CACF;AAtCD,oDAsCC"}

package/mcp-server/dist/tools/github/search-code.tool.d.ts

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+import { BaseTool, TMastraTool } from '../base.tool';
+declare const InputSchema: z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+declare const OutputSchema: z.ZodObject<{
+    query: z.ZodString;
+    totalCount: z.ZodNumber;
+    results: z.ZodArray<z.ZodObject<{
+        filePath: z.ZodString;
+        fileName: z.ZodString;
+        matchSnippet: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    error: z.ZodOptional<z.ZodString>;
+    rateLimitWarning: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare class SearchCodeTool extends BaseTool<typeof InputSchema, typeof OutputSchema> {
+    readonly id = "searchCode";
+    readonly description = "\nSearches for code patterns, function names, class definitions, and keywords across the Ignis source code.\n\nPURPOSE:\nFind specific code implementations, locate where functions/classes are defined, and discover\ncode patterns throughout the repository. Essential for understanding how features are implemented.\n\nWHEN TO USE:\n- To find where a specific function or class is defined\n- To locate usages of a particular API or pattern\n- To find configuration files or specific code constructs\n- When you know WHAT you're looking for but not WHERE it is\n- To answer questions like \"where is X implemented?\" or \"how is Y used?\"\n\nWHEN NOT TO USE:\n- For general project structure exploration (use listProjectFiles instead)\n- For documentation content (use searchDocs instead)\n- When you already know the file path (use viewSourceFile instead)\n\nSEARCH TIPS:\n- Use specific terms: \"createApplication\" instead of \"create\"\n- Include file extension for targeted results: \"extension:ts HttpServer\"\n- Search for class/function names: \"class DependencyContainer\"\n- Combine terms: \"inject decorator\"\n\nOUTPUT:\nReturns matching files with code snippets showing the match context.\nUse viewSourceFile to read the complete file content.\n";
+    readonly inputSchema: z.ZodObject<{
+        query: z.ZodString;
+        limit: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    readonly outputSchema: z.ZodObject<{
+        query: z.ZodString;
+        totalCount: z.ZodNumber;
+        results: z.ZodArray<z.ZodObject<{
+            filePath: z.ZodString;
+            fileName: z.ZodString;
+            matchSnippet: z.ZodOptional<z.ZodString>;
+            url: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        error: z.ZodOptional<z.ZodString>;
+        rateLimitWarning: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    execute(opts: z.infer<typeof InputSchema>): Promise<z.infer<typeof OutputSchema>>;
+    getTool(): TMastraTool;
+}
+export {};
+//# sourceMappingURL=search-code.tool.d.ts.map

package/mcp-server/dist/tools/github/search-code.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-code.tool.d.ts","sourceRoot":"","sources":["../../../tools/github/search-code.tool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAmFrD,QAAA,MAAM,WAAW;;;iBASf,CAAC;AAEH,QAAA,MAAM,YAAY;;;;;;;;;;;iBAShB,CAAC;AA6BH,qBAAa,cAAe,SAAQ,QAAQ,CAAC,OAAO,WAAW,EAAE,OAAO,YAAY,CAAC;IACnF,QAAQ,CAAC,EAAE,gBAAgB;IAC3B,QAAQ,CAAC,WAAW,6uCAAoB;IACxC,QAAQ,CAAC,WAAW;;;sBAAe;IACnC,QAAQ,CAAC,YAAY;;;;;;;;;;;sBAAgB;IAE/B,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;IAiFvF,OAAO,IAAI,WAAW;CASvB"}

package/mcp-server/dist/tools/github/search-code.tool.js

@@ -0,0 +1,194 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchCodeTool = void 0;
+const common_1 = require("@/mcp-server/common");
+const tools_1 = require("@mastra/core/tools");
+const zod_1 = require("zod");
+const base_tool_1 = require("../base.tool");
+const helpers_1 = require("@/mcp-server/helpers");
+// ----------------------------------------------------------------------------
+// DESCRIPTIONS
+// ----------------------------------------------------------------------------
+const TOOL_DESCRIPTION = `
+Searches for code patterns, function names, class definitions, and keywords across the Ignis source code.
+
+PURPOSE:
+Find specific code implementations, locate where functions/classes are defined, and discover
+code patterns throughout the repository. Essential for understanding how features are implemented.
+
+WHEN TO USE:
+- To find where a specific function or class is defined
+- To locate usages of a particular API or pattern
+- To find configuration files or specific code constructs
+- When you know WHAT you're looking for but not WHERE it is
+- To answer questions like "where is X implemented?" or "how is Y used?"
+
+WHEN NOT TO USE:
+- For general project structure exploration (use listProjectFiles instead)
+- For documentation content (use searchDocs instead)
+- When you already know the file path (use viewSourceFile instead)
+
+SEARCH TIPS:
+- Use specific terms: "createApplication" instead of "create"
+- Include file extension for targeted results: "extension:ts HttpServer"
+- Search for class/function names: "class DependencyContainer"
+- Combine terms: "inject decorator"
+
+OUTPUT:
+Returns matching files with code snippets showing the match context.
+Use viewSourceFile to read the complete file content.
+`;
+const QUERY_DESCRIPTION = `
+Search query to find in the codebase.
+
+QUERY SYNTAX:
+- Simple keyword: "HttpServer" - finds files containing HttpServer
+- Multiple terms: "inject service" - files containing both terms
+- Exact phrase: "\\"dependency injection\\"" - exact phrase match
+- File extension: "extension:ts middleware" - only TypeScript files
+- Path filter: "path:packages/core createTool" - search in specific path
+
+EXAMPLES:
+- "class Application" - find Application class definition
+- "export function create" - find exported create functions
+- "extension:ts @Injectable" - find Injectable decorators in TS files
+- "path:packages/helpers redis" - find redis usage in helpers package
+- "BaseController extends" - find classes extending BaseController
+
+TIPS:
+- Be specific to reduce noise
+- Use class/function names when known
+- Combine with path: or extension: for targeted results
+`;
+const LIMIT_DESCRIPTION = `
+Maximum number of results to return (1-${common_1.MCPConfigs.codeSearch.maxLimit}, default: ${common_1.MCPConfigs.codeSearch.defaultLimit}).
+
+RECOMMENDATIONS:
+- Use 5-10 for specific searches (function names, class definitions)
+- Use 15-20 for broader pattern searches
+- Use ${common_1.MCPConfigs.codeSearch.maxLimit} when exploring all usages of a common term
+`;
+// ----------------------------------------------------------------------------
+// SCHEMAS
+// ----------------------------------------------------------------------------
+const SearchResultSchema = zod_1.z.object({
+    filePath: zod_1.z.string().describe('Full file path from repository root. Use with viewSourceFile.'),
+    fileName: zod_1.z.string().describe('File name for quick reference.'),
+    matchSnippet: zod_1.z
+        .string()
+        .optional()
+        .describe('Code snippet showing the match context (if available).'),
+    url: zod_1.z.string().optional().describe('GitHub URL to view the file online.'),
+});
+const InputSchema = zod_1.z.object({
+    query: zod_1.z.string().min(common_1.MCPConfigs.codeSearch.minQueryLength).describe(QUERY_DESCRIPTION),
+    limit: zod_1.z
+        .number()
+        .int()
+        .min(1)
+        .max(common_1.MCPConfigs.codeSearch.maxLimit)
+        .default(common_1.MCPConfigs.codeSearch.defaultLimit)
+        .describe(LIMIT_DESCRIPTION),
+});
+const OutputSchema = zod_1.z.object({
+    query: zod_1.z.string().describe('The search query that was executed.'),
+    totalCount: zod_1.z.number().int().describe('Total number of matches found.'),
+    results: zod_1.z.array(SearchResultSchema).describe('Search results with file paths and snippets.'),
+    error: zod_1.z.string().optional().describe('Error message if search failed.'),
+    rateLimitWarning: zod_1.z
+        .string()
+        .optional()
+        .describe('Warning if approaching GitHub API rate limits.'),
+});
+/* eslint-enable @typescript-eslint/naming-convention */
+// ----------------------------------------------------------------------------
+// TOOL CLASS
+// ----------------------------------------------------------------------------
+class SearchCodeTool extends base_tool_1.BaseTool {
+    constructor() {
+        super(...arguments);
+        this.id = 'searchCode';
+        this.description = TOOL_DESCRIPTION;
+        this.inputSchema = InputSchema;
+        this.outputSchema = OutputSchema;
+    }
+    async execute(opts) {
+        const { query, limit } = opts;
+        const { apiBase, repoOwner, repoName, userAgent } = common_1.MCPConfigs.github;
+        // Build GitHub code search query
+        const searchQuery = `${query} repo:${repoOwner}/${repoName}`;
+        const url = `${apiBase}/search/code?q=${encodeURIComponent(searchQuery)}&per_page=${limit}`;
+        helpers_1.Logger.debug(`Searching code on GitHub: ${url}`);
+        try {
+            const response = await fetch(url, {
+                headers: {
+                    'User-Agent': userAgent,
+                    Accept: 'application/vnd.github.text-match+json', // Include text match fragments
+                },
+            });
+            // Check rate limit headers
+            const rateLimitRemaining = response.headers.get('X-RateLimit-Remaining');
+            const rateLimitWarning = rateLimitRemaining &&
+                parseInt(rateLimitRemaining) < common_1.MCPConfigs.codeSearch.rateLimitWarningThreshold
+                ? `GitHub API rate limit low: ${rateLimitRemaining} requests remaining. Consider waiting before more searches.`
+                : undefined;
+            if (!response.ok) {
+                const errorData = (await response.json().catch(() => ({})));
+                helpers_1.Logger.error(`GitHub code search failed: ${response.statusText}`);
+                if (response.status === 403) {
+                    return {
+                        query,
+                        totalCount: 0,
+                        results: [],
+                        error: 'GitHub API rate limit exceeded. Please wait a moment before searching again. Unauthenticated requests are limited to 10 per minute.',
+                        rateLimitWarning,
+                    };
+                }
+                return {
+                    query,
+                    totalCount: 0,
+                    results: [],
+                    error: errorData.message || `GitHub API error: ${response.statusText}`,
+                    rateLimitWarning,
+                };
+            }
+            const data = (await response.json());
+            const results = data.items.map(item => {
+                // Extract the best text match snippet
+                const matchSnippet = item.text_matches?.[0]?.fragment;
+                return {
+                    filePath: item.path,
+                    fileName: item.name,
+                    matchSnippet,
+                    url: item.html_url,
+                };
+            });
+            return {
+                query,
+                totalCount: data.total_count,
+                results,
+                rateLimitWarning,
+            };
+        }
+        catch (error) {
+            helpers_1.Logger.error('Failed to search code on GitHub:', error);
+            return {
+                query,
+                totalCount: 0,
+                results: [],
+                error: `Search failed: ${error instanceof Error ? error.message : 'Unknown error'}`,
+            };
+        }
+    }
+    getTool() {
+        return (0, tools_1.createTool)({
+            id: this.id,
+            description: this.description,
+            inputSchema: this.inputSchema,
+            outputSchema: this.outputSchema,
+            execute: async ({ context }) => this.execute(context),
+        });
+    }
+}
+exports.SearchCodeTool = SearchCodeTool;
+//# sourceMappingURL=search-code.tool.js.map

package/mcp-server/dist/tools/github/search-code.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-code.tool.js","sourceRoot":"","sources":["../../../tools/github/search-code.tool.ts"],"names":[],"mappings":";;;AAAA,gDAAiD;AACjD,8CAAgD;AAChD,6BAAwB;AACxB,4CAAqD;AACrD,kDAA8C;AAE9C,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BxB,CAAC;AAEF,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;CAqBzB,CAAC;AAEF,MAAM,iBAAiB,GAAG;yCACe,mBAAU,CAAC,UAAU,CAAC,QAAQ,cAAc,mBAAU,CAAC,UAAU,CAAC,YAAY;;;;;QAK/G,mBAAU,CAAC,UAAU,CAAC,QAAQ;CACrC,CAAC;AAEF,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,MAAM,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IAClC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+DAA+D,CAAC;IAC9F,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IAC/D,YAAY,EAAE,OAAC;SACZ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,wDAAwD,CAAC;IACrE,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;CAC3E,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3B,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,mBAAU,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IACvF,KAAK,EAAE,OAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,mBAAU,CAAC,UAAU,CAAC,QAAQ,CAAC;SACnC,OAAO,CAAC,mBAAU,CAAC,UAAU,CAAC,YAAY,CAAC;SAC3C,QAAQ,CAAC,iBAAiB,CAAC;CAC/B,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5B,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IACjE,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IACvE,OAAO,EAAE,OAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IAC7F,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IACxE,gBAAgB,EAAE,OAAC;SAChB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,gDAAgD,CAAC;CAC9D,CAAC,CAAC;AAuBH,wDAAwD;AAExD,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E,MAAa,cAAe,SAAQ,oBAAiD;IAArF;;QACW,OAAE,GAAG,YAAY,CAAC;QAClB,gBAAW,GAAG,gBAAgB,CAAC;QAC/B,gBAAW,GAAG,WAAW,CAAC;QAC1B,iBAAY,GAAG,YAAY,CAAC;IA4FvC,CAAC;IA1FC,KAAK,CAAC,OAAO,CAAC,IAAiC;QAC7C,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAC9B,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,mBAAU,CAAC,MAAM,CAAC;QAEtE,iCAAiC;QACjC,MAAM,WAAW,GAAG,GAAG,KAAK,SAAS,SAAS,IAAI,QAAQ,EAAE,CAAC;QAC7D,MAAM,GAAG,GAAG,GAAG,OAAO,kBAAkB,kBAAkB,CAAC,WAAW,CAAC,aAAa,KAAK,EAAE,CAAC;QAE5F,gBAAM,CAAC,KAAK,CAAC,6BAA6B,GAAG,EAAE,CAAC,CAAC;QAEjD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,OAAO,EAAE;oBACP,YAAY,EAAE,SAAS;oBACvB,MAAM,EAAE,wCAAwC,EAAE,+BAA+B;iBAClF;aACF,CAAC,CAAC;YAEH,2BAA2B;YAC3B,MAAM,kBAAkB,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;YACzE,MAAM,gBAAgB,GACpB,kBAAkB;gBAClB,QAAQ,CAAC,kBAAkB,CAAC,GAAG,mBAAU,CAAC,UAAU,CAAC,yBAAyB;gBAC5E,CAAC,CAAC,8BAA8B,kBAAkB,6DAA6D;gBAC/G,CAAC,CAAC,SAAS,CAAC;YAEhB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,SAAS,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAyB,CAAC;gBACpF,gBAAM,CAAC,KAAK,CAAC,8BAA8B,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;gBAElE,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;oBAC5B,OAAO;wBACL,KAAK;wBACL,UAAU,EAAE,CAAC;wBACb,OAAO,EAAE,EAAE;wBACX,KAAK,EACH,qIAAqI;wBACvI,gBAAgB;qBACjB,CAAC;gBACJ,CAAC;gBAED,OAAO;oBACL,KAAK;oBACL,UAAU,EAAE,CAAC;oBACb,OAAO,EAAE,EAAE;oBACX,KAAK,EAAE,SAAS,CAAC,OAAO,IAAI,qBAAqB,QAAQ,CAAC,UAAU,EAAE;oBACtE,gBAAgB;iBACjB,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA0B,CAAC;YAE9D,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;gBACpC,sCAAsC;gBACtC,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC;gBAEtD,OAAO;oBACL,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,YAAY;oBACZ,GAAG,EAAE,IAAI,CAAC,QAAQ;iBACnB,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,OAAO;gBACL,KAAK;gBACL,UAAU,EAAE,IAAI,CAAC,WAAW;gBAC5B,OAAO;gBACP,gBAAgB;aACjB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,gBAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAC;YACxD,OAAO;gBACL,KAAK;gBACL,UAAU,EAAE,CAAC;gBACb,OAAO,EAAE,EAAE;gBACX,KAAK,EAAE,kBAAkB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE;aACpF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,IAAA,kBAAU,EAAC;YAChB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;SACtD,CAAC,CAAC;IACL,CAAC;CACF;AAhGD,wCAgGC"}

package/mcp-server/dist/tools/github/verify-dependencies.tool.d.ts

@@ -0,0 +1,55 @@
+import { z } from 'zod';
+import { BaseTool, TMastraTool } from '../base.tool';
+declare const InputSchema: z.ZodObject<{
+    packagePath: z.ZodString;
+}, z.core.$strip>;
+declare const OutputSchema: z.ZodObject<{
+    packageName: z.ZodOptional<z.ZodString>;
+    dependencies: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        currentVersion: z.ZodString;
+        latestVersion: z.ZodString;
+        isOutdated: z.ZodBoolean;
+    }, z.core.$strip>>>;
+    devDependencies: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        currentVersion: z.ZodString;
+        latestVersion: z.ZodString;
+        isOutdated: z.ZodBoolean;
+    }, z.core.$strip>>>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare class VerifyDependenciesTool extends BaseTool<typeof InputSchema, typeof OutputSchema> {
+    readonly id = "verifyDependencies";
+    readonly description = "\nVerifies dependencies of a package within the Ignis monorepo against NPM registry.\n\nPURPOSE:\nCheck for outdated dependencies. Reads package.json from a specific package,\nfetches latest version for each dependency from NPM registry, and reports\nwhich packages may need updating.\n\nWHEN TO USE:\n- To assess maintenance status of a package\n- To identify potential security risks from outdated dependencies\n- Before starting development, to see what needs updating\n- To answer user questions about package dependencies\n\nWHEN NOT TO USE:\n- This tool can be slow as it makes multiple network requests to NPM\n- For workspace dependencies (e.g., \"workspace:*\") - these are internal references\n\nNOTE: Version comparison is simplified (string comparison). Complex version ranges\nor intentionally pinned versions may show as \"outdated\" even when correct.\n";
+    readonly inputSchema: z.ZodObject<{
+        packagePath: z.ZodString;
+    }, z.core.$strip>;
+    readonly outputSchema: z.ZodObject<{
+        packageName: z.ZodOptional<z.ZodString>;
+        dependencies: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            currentVersion: z.ZodString;
+            latestVersion: z.ZodString;
+            isOutdated: z.ZodBoolean;
+        }, z.core.$strip>>>;
+        devDependencies: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            currentVersion: z.ZodString;
+            latestVersion: z.ZodString;
+            isOutdated: z.ZodBoolean;
+        }, z.core.$strip>>>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    private getLatestVersion;
+    /**
+     * Extracts a clean semver version from various version specifiers.
+     * Returns null for non-standard versions that can't be compared.
+     */
+    private parseVersion;
+    private processDependencies;
+    execute(opts: z.infer<typeof InputSchema>): Promise<z.infer<typeof OutputSchema>>;
+    getTool(): TMastraTool;
+}
+export {};
+//# sourceMappingURL=verify-dependencies.tool.d.ts.map

package/mcp-server/dist/tools/github/verify-dependencies.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-dependencies.tool.d.ts","sourceRoot":"","sources":["../../../tools/github/verify-dependencies.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAkDrD,QAAA,MAAM,WAAW;;iBAEf,CAAC;AAEH,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;iBAKhB,CAAC;AAWH,qBAAa,sBAAuB,SAAQ,QAAQ,CAAC,OAAO,WAAW,EAAE,OAAO,YAAY,CAAC;IAC3F,QAAQ,CAAC,EAAE,wBAAwB;IACnC,QAAQ,CAAC,WAAW,02BAAoB;IACxC,QAAQ,CAAC,WAAW;;sBAAe;IACnC,QAAQ,CAAC,YAAY;;;;;;;;;;;;;;;sBAAgB;YAEvB,gBAAgB;IAe9B;;;OAGG;IACH,OAAO,CAAC,YAAY;YAsBN,mBAAmB;IA+B3B,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;IA0BvF,OAAO,IAAI,WAAW;CASvB"}

package/mcp-server/dist/tools/github/verify-dependencies.tool.js

@@ -0,0 +1,167 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VerifyDependenciesTool = void 0;
+const tools_1 = require("@mastra/core/tools");
+const zod_1 = require("zod");
+const base_tool_1 = require("../base.tool");
+const helpers_1 = require("@/mcp-server/helpers");
+// ----------------------------------------------------------------------------
+// DESCRIPTIONS
+// ----------------------------------------------------------------------------
+const TOOL_DESCRIPTION = `
+Verifies dependencies of a package within the Ignis monorepo against NPM registry.
+
+PURPOSE:
+Check for outdated dependencies. Reads package.json from a specific package,
+fetches latest version for each dependency from NPM registry, and reports
+which packages may need updating.
+
+WHEN TO USE:
+- To assess maintenance status of a package
+- To identify potential security risks from outdated dependencies
+- Before starting development, to see what needs updating
+- To answer user questions about package dependencies
+
+WHEN NOT TO USE:
+- This tool can be slow as it makes multiple network requests to NPM
+- For workspace dependencies (e.g., "workspace:*") - these are internal references
+
+NOTE: Version comparison is simplified (string comparison). Complex version ranges
+or intentionally pinned versions may show as "outdated" even when correct.
+`;
+const PACKAGE_PATH_DESCRIPTION = `
+The path to the package directory from the repository root.
+This directory must contain a 'package.json' file.
+
+EXAMPLES:
+- "packages/core"
+- "packages/helpers"
+- "examples/5-mins-qs"
+`;
+// ----------------------------------------------------------------------------
+// SCHEMAS
+// ----------------------------------------------------------------------------
+const DependencyInfoSchema = zod_1.z.object({
+    name: zod_1.z.string(),
+    currentVersion: zod_1.z.string(),
+    latestVersion: zod_1.z.string(),
+    isOutdated: zod_1.z.boolean(),
+});
+const InputSchema = zod_1.z.object({
+    packagePath: zod_1.z.string().describe(PACKAGE_PATH_DESCRIPTION),
+});
+const OutputSchema = zod_1.z.object({
+    packageName: zod_1.z.string().optional(),
+    dependencies: zod_1.z.array(DependencyInfoSchema).optional(),
+    devDependencies: zod_1.z.array(DependencyInfoSchema).optional(),
+    error: zod_1.z.string().optional(),
+});
+// ----------------------------------------------------------------------------
+// TOOL CLASS
+// ----------------------------------------------------------------------------
+class VerifyDependenciesTool extends base_tool_1.BaseTool {
+    constructor() {
+        super(...arguments);
+        this.id = 'verifyDependencies';
+        this.description = TOOL_DESCRIPTION;
+        this.inputSchema = InputSchema;
+        this.outputSchema = OutputSchema;
+    }
+    async getLatestVersion(opts) {
+        try {
+            const url = `https://registry.npmjs.org/${opts.packageName}/latest`;
+            const response = await fetch(url);
+            if (!response.ok) {
+                return 'unknown';
+            }
+            const data = (await response.json());
+            return data.version || 'unknown';
+        }
+        catch (error) {
+            helpers_1.Logger.warn(`Could not fetch latest version for ${opts.packageName}:`, error);
+            return 'unknown';
+        }
+    }
+    /**
+     * Extracts a clean semver version from various version specifiers.
+     * Returns null for non-standard versions that can't be compared.
+     */
+    parseVersion(opts) {
+        // Skip workspace, file, git, and URL references
+        if (opts.version.startsWith('workspace:') ||
+            opts.version.startsWith('file:') ||
+            opts.version.startsWith('git') ||
+            opts.version.startsWith('http') ||
+            opts.version === '*' ||
+            opts.version === 'latest') {
+            return null;
+        }
+        // Remove common prefixes: ^, ~, >=, >, <=, <, =
+        const cleaned = opts.version.replace(/^[\^~>=<]+/, '').trim();
+        // Handle version ranges (e.g., "1.0.0 || 2.0.0", ">=1.0.0 <2.0.0")
+        // Just take the first version-like string
+        const semverMatch = cleaned.match(/(\d+\.\d+\.\d+(?:-[\w.]+)?)/);
+        return semverMatch ? semverMatch[1] : null;
+    }
+    async processDependencies(opts) {
+        if (!opts.deps) {
+            return [];
+        }
+        const results = [];
+        for (const [name, version] of Object.entries(opts.deps)) {
+            const parsedVersion = this.parseVersion({ version });
+            // Skip non-standard versions
+            if (!parsedVersion) {
+                results.push({
+                    name,
+                    currentVersion: version,
+                    latestVersion: 'N/A',
+                    isOutdated: false,
+                });
+                continue;
+            }
+            const latestVersion = await this.getLatestVersion({ packageName: name });
+            results.push({
+                name,
+                currentVersion: parsedVersion,
+                latestVersion,
+                isOutdated: latestVersion !== 'unknown' && parsedVersion !== latestVersion,
+            });
+        }
+        return results;
+    }
+    async execute(opts) {
+        const packageJsonPath = `${opts.packagePath}/package.json`;
+        const result = await helpers_1.GithubHelper.getFileContent({ filePath: packageJsonPath });
+        if ('error' in result) {
+            return { error: `Could not read package.json at ${packageJsonPath}. Error: ${result.error}` };
+        }
+        try {
+            const packageJson = JSON.parse(result.content);
+            const [dependencies, devDependencies] = await Promise.all([
+                this.processDependencies({ deps: packageJson.dependencies }),
+                this.processDependencies({ deps: packageJson.devDependencies }),
+            ]);
+            return {
+                packageName: packageJson.name,
+                dependencies,
+                devDependencies,
+            };
+        }
+        catch (error) {
+            helpers_1.Logger.error('[execute] Failed to execute | Error: ', error);
+            return { error: `Failed to parse package.json at ${packageJsonPath}.` };
+        }
+    }
+    getTool() {
+        return (0, tools_1.createTool)({
+            id: this.id,
+            description: this.description,
+            inputSchema: this.inputSchema,
+            outputSchema: this.outputSchema,
+            execute: async ({ context }) => this.execute(context),
+        });
+    }
+}
+exports.VerifyDependenciesTool = VerifyDependenciesTool;
+//# sourceMappingURL=verify-dependencies.tool.js.map

package/mcp-server/dist/tools/github/verify-dependencies.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-dependencies.tool.js","sourceRoot":"","sources":["../../../tools/github/verify-dependencies.tool.ts"],"names":[],"mappings":"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"}

package/mcp-server/dist/tools/github/view-source-file.tool.d.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import { BaseTool, TMastraTool } from '../base.tool';
+declare const InputSchema: z.ZodObject<{
+    filePath: z.ZodString;
+}, z.core.$strip>;
+declare const OutputSchema: z.ZodObject<{
+    filePath: z.ZodString;
+    content: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare class ViewSourceFileTool extends BaseTool<typeof InputSchema, typeof OutputSchema> {
+    readonly id = "viewSourceFile";
+    readonly description = "\nRetrieves the full source code content of a specific file from the Ignis GitHub repository.\n\nPURPOSE:\nRead contents of a source file. Primary method for inspecting implementation details,\nunderstanding logic, and viewing exact code.\n\nWHEN TO USE:\n- After finding a relevant file with listProjectFiles or searchCode\n- When you need to see implementation of a specific class, function, or component\n- To verify details not present in documentation\n- To extract specific code examples or snippets\n\nWHEN NOT TO USE:\n- For discovering files (use listProjectFiles to browse, or searchCode to find by keyword)\n- Do not use on non-text files (images, binaries) or very large files unless necessary\n- For documentation content (use getDocContent instead)\n";
+    readonly inputSchema: z.ZodObject<{
+        filePath: z.ZodString;
+    }, z.core.$strip>;
+    readonly outputSchema: z.ZodObject<{
+        filePath: z.ZodString;
+        content: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    execute(opts: z.infer<typeof InputSchema>): Promise<z.infer<typeof OutputSchema>>;
+    getTool(): TMastraTool;
+}
+export {};
+//# sourceMappingURL=view-source-file.tool.d.ts.map

package/mcp-server/dist/tools/github/view-source-file.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-source-file.tool.d.ts","sourceRoot":"","sources":["../../../tools/github/view-source-file.tool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AA2CrD,QAAA,MAAM,WAAW;;iBAEf,CAAC;AAEH,QAAA,MAAM,YAAY;;;;iBAOhB,CAAC;AAMH,qBAAa,kBAAmB,SAAQ,QAAQ,CAAC,OAAO,WAAW,EAAE,OAAO,YAAY,CAAC;IACvF,QAAQ,CAAC,EAAE,oBAAoB;IAC/B,QAAQ,CAAC,WAAW,kwBAAoB;IACxC,QAAQ,CAAC,WAAW;;sBAAe;IACnC,QAAQ,CAAC,YAAY;;;;sBAAgB;IAE/B,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;IAgBvF,OAAO,IAAI,WAAW;CASvB"}