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

package/mcp-server/dist/tools/docs/get-package-overview.tool.js

@@ -0,0 +1,221 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetPackageOverviewTool = void 0;
+const tools_1 = require("@mastra/core/tools");
+const fast_glob_1 = __importDefault(require("fast-glob"));
+const gray_matter_1 = __importDefault(require("gray-matter"));
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const zod_1 = require("zod");
+const common_1 = require("../../common");
+const helpers_1 = require("../../helpers");
+const base_tool_1 = require("../base.tool");
+// ----------------------------------------------------------------------------
+// DESCRIPTIONS
+// ----------------------------------------------------------------------------
+const TOOL_DESCRIPTION = `
+Returns an overview of Ignis packages from the source details documentation.
+
+PURPOSE:
+Provides AI agents with comprehensive understanding of the Ignis monorepo structure,
+package purposes, main exports, and directory layouts. This is essential for helping
+users understand which package to use for specific features.
+
+WHEN TO USE:
+- When user asks "what packages does Ignis have?"
+- When user needs to understand project structure
+- When user asks which package provides a specific feature
+- Before helping user implement a feature (to know where code should go)
+- When user asks about imports or package dependencies
+
+WHEN NOT TO USE:
+- For specific API documentation (use getDocContent with references/ docs)
+- For code examples (use searchCode or getDocContent)
+- For troubleshooting (use searchDocs)
+
+OUTPUT:
+Returns package name, description, main directories, and key components.
+The content comes from wiki/references/src-details/ documentation.
+`;
+const PACKAGE_NAME_DESCRIPTION = `
+Optional: Name of specific package to get details for.
+
+VALID VALUES:
+- "core" - @venizia/ignis main framework
+- "helpers" - @venizia/ignis-helpers utility helpers
+- "inversion" - @venizia/ignis-inversion DI container
+- "dev-configs" - @venizia/dev-configs ESLint, Prettier, TSConfig
+- "docs" - Documentation package
+- "mcp-server" - MCP documentation server
+
+If not provided, returns overview of ALL packages.
+`;
+// ----------------------------------------------------------------------------
+// SCHEMAS
+// ----------------------------------------------------------------------------
+const PackageInfoSchema = zod_1.z.object({
+    name: zod_1.z.string().describe('Package name (e.g., "core", "helpers")'),
+    npmName: zod_1.z.string().describe('NPM package name (e.g., "@venizia/ignis")'),
+    description: zod_1.z.string().describe('Brief description of package purpose'),
+    directories: zod_1.z
+        .array(zod_1.z.object({
+        name: zod_1.z.string(),
+        purpose: zod_1.z.string(),
+    }))
+        .describe('Main directories and their purposes'),
+    content: zod_1.z.string().optional().describe('Full markdown content if single package requested'),
+});
+const InputSchema = zod_1.z.object({
+    packageName: zod_1.z.string().optional().describe(PACKAGE_NAME_DESCRIPTION),
+});
+const OutputSchema = zod_1.z.object({
+    packages: zod_1.z.array(PackageInfoSchema).describe('List of package overviews'),
+    error: zod_1.z.string().optional().describe('Error message if operation failed'),
+});
+// ----------------------------------------------------------------------------
+// PACKAGE MAPPING
+// ----------------------------------------------------------------------------
+const PACKAGE_NPM_NAMES = {
+    core: '@venizia/ignis',
+    helpers: '@venizia/ignis-helpers',
+    inversion: '@venizia/ignis-inversion',
+    'dev-configs': '@venizia/dev-configs',
+    docs: '@venizia/ignis-docs',
+    'mcp-server': '@venizia/ignis-docs (MCP Server)',
+};
+// ----------------------------------------------------------------------------
+// TOOL CLASS
+// ----------------------------------------------------------------------------
+class GetPackageOverviewTool extends base_tool_1.BaseTool {
+    constructor() {
+        super(...arguments);
+        this.id = 'getPackageOverview';
+        this.description = TOOL_DESCRIPTION;
+        this.inputSchema = InputSchema;
+        this.outputSchema = OutputSchema;
+    }
+    /**
+     * Extracts package description from first paragraph after title
+     */
+    extractDescription(opts) {
+        const lines = opts.content.split('\n');
+        let bFoundTitle = false;
+        const descLines = [];
+        for (const line of lines) {
+            if (line.startsWith('# ')) {
+                bFoundTitle = true;
+                continue;
+            }
+            if (bFoundTitle && line.trim() === '') {
+                if (descLines.length > 0) {
+                    break;
+                }
+                continue;
+            }
+            if (bFoundTitle && !line.startsWith('#') && !line.startsWith('|') && !line.startsWith('-')) {
+                descLines.push(line.trim());
+                if (descLines.length >= 2) {
+                    break;
+                }
+            }
+        }
+        return descLines.join(' ').slice(0, 300) || 'No description available';
+    }
+    /**
+     * Extracts directory table from markdown content
+     */
+    extractDirectories(opts) {
+        const directories = [];
+        const lines = opts.content.split('\n');
+        let isInTable = false;
+        let isHeaderPassed = false;
+        for (const line of lines) {
+            // Look for tables with Directory/Folder column
+            if (line.includes('| Directory') || line.includes('| Folder') || line.includes('| **`')) {
+                isInTable = true;
+                continue;
+            }
+            if (isInTable && line.startsWith('|---')) {
+                isHeaderPassed = true;
+                continue;
+            }
+            if (isInTable && isHeaderPassed && line.startsWith('|')) {
+                const cells = line
+                    .split('|')
+                    .map(c => c.trim())
+                    .filter(Boolean);
+                if (cells.length >= 2) {
+                    const dirName = cells[0].replace(/\*\*/g, '').replace(/`/g, '').trim();
+                    const purpose = cells[1].replace(/\*\*/g, '').slice(0, 150);
+                    if (dirName && !dirName.includes('---')) {
+                        directories.push({ name: dirName, purpose });
+                    }
+                }
+            }
+            // Stop at next section
+            if (isInTable && isHeaderPassed && (line.startsWith('##') || line.startsWith('---'))) {
+                break;
+            }
+        }
+        return directories.slice(0, 10); // Limit to top 10 directories
+    }
+    async execute(opts) {
+        const srcDetailsPath = common_1.Paths.SOURCE_DETAILS;
+        try {
+            // Get specific package or all packages
+            const pattern = opts.packageName ? `${opts.packageName}.md` : '*.md';
+            const files = await (0, fast_glob_1.default)(pattern, {
+                cwd: srcDetailsPath,
+                absolute: true,
+            });
+            if (files.length === 0) {
+                return {
+                    packages: [],
+                    error: opts.packageName
+                        ? `Package "${opts.packageName}" not found. Valid: core, helpers, inversion, dev-configs, docs, mcp-server`
+                        : 'No package documentation found',
+                };
+            }
+            const packages = await Promise.all(files.map(async (file) => {
+                const rawContent = await promises_1.default.readFile(file, 'utf-8');
+                const { content } = (0, gray_matter_1.default)(rawContent);
+                const baseName = node_path_1.default.basename(file, '.md');
+                const packageInfo = {
+                    name: baseName,
+                    npmName: PACKAGE_NPM_NAMES[baseName] || `@venizia/ignis-${baseName}`,
+                    description: this.extractDescription({ content }),
+                    directories: this.extractDirectories({ content }),
+                };
+                // Include full content only if single package requested
+                if (opts.packageName) {
+                    packageInfo.content = content;
+                }
+                return packageInfo;
+            }));
+            // Sort by package name
+            packages.sort((a, b) => a.name.localeCompare(b.name));
+            return { packages };
+        }
+        catch (error) {
+            helpers_1.Logger.error('Failed to get package overview:', error);
+            return {
+                packages: [],
+                error: `Failed to load package overview: ${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.GetPackageOverviewTool = GetPackageOverviewTool;
+//# sourceMappingURL=get-package-overview.tool.js.map

package/mcp-server/dist/tools/docs/get-package-overview.tool.js.map

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

package/mcp-server/dist/tools/docs/index.d.ts

@@ -0,0 +1,7 @@
+export * from './get-document-content.tool';
+export * from './get-document-metadata.tool';
+export * from './get-package-overview.tool';
+export * from './list-categories.tool';
+export * from './list-documents.tool';
+export * from './search-documents.tool';
+//# sourceMappingURL=index.d.ts.map

package/mcp-server/dist/tools/docs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../tools/docs/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC"}

package/mcp-server/dist/tools/docs/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./get-document-content.tool"), exports);
+__exportStar(require("./get-document-metadata.tool"), exports);
+__exportStar(require("./get-package-overview.tool"), exports);
+__exportStar(require("./list-categories.tool"), exports);
+__exportStar(require("./list-documents.tool"), exports);
+__exportStar(require("./search-documents.tool"), exports);
+//# sourceMappingURL=index.js.map

package/mcp-server/dist/tools/docs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../tools/docs/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8DAA4C;AAC5C,+DAA6C;AAC7C,8DAA4C;AAC5C,yDAAuC;AACvC,wDAAsC;AACtC,0DAAwC"}

package/mcp-server/dist/tools/{list-categories.tool.d.ts → docs/list-categories.tool.d.ts}

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { BaseTool, type TMastraTool } from './base.tool';
+import { BaseTool, TMastraTool } from '../base.tool';
 declare const InputSchema: z.ZodObject<{}, z.core.$strip>;
 declare const OutputSchema: z.ZodObject<{
     count: z.ZodNumber;
@@ -13,7 +13,7 @@ export declare class ListCategoriesTool extends BaseTool<typeof InputSchema, typ
         count: z.ZodNumber;
         categories: z.ZodArray<z.ZodString>;
     }, z.core.$strip>;
-    execute(_input: z.infer<typeof InputSchema>): Promise<z.infer<typeof OutputSchema>>;
+    execute(_opts: z.infer<typeof InputSchema>): Promise<z.infer<typeof OutputSchema>>;
     getTool(): TMastraTool;
 }
 export {};

package/mcp-server/dist/tools/docs/list-categories.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-categories.tool.d.ts","sourceRoot":"","sources":["../../../tools/docs/list-categories.tool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAsErD,QAAA,MAAM,WAAW,gCAAyD,CAAC;AAE3E,QAAA,MAAM,YAAY;;;iBAGhB,CAAC;AAMH,qBAAa,kBAAmB,SAAQ,QAAQ,CAAC,OAAO,WAAW,EAAE,OAAO,YAAY,CAAC;IACvF,QAAQ,CAAC,EAAE,oBAAoB;IAC/B,QAAQ,CAAC,WAAW,i7CAAoB;IACxC,QAAQ,CAAC,WAAW,iCAAe;IACnC,QAAQ,CAAC,YAAY;;;sBAAgB;IAE/B,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;IASxF,OAAO,IAAI,WAAW;CASvB"}

package/mcp-server/dist/tools/{list-categories.tool.js → docs/list-categories.tool.js}

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ListCategoriesTool = void 0;
+const helpers_1 = require("@/mcp-server/helpers");
+const tools_1 = require("@mastra/core/tools");
 const zod_1 = require("zod");
-const helpers_1 = require("../helpers");
-const base_tool_1 = require("./base.tool");
+const base_tool_1 = require("../base.tool");
 // ----------------------------------------------------------------------------
 // DESCRIPTIONS
 // ----------------------------------------------------------------------------
@@ -84,7 +85,7 @@ class ListCategoriesTool extends base_tool_1.BaseTool {
         this.inputSchema = InputSchema;
         this.outputSchema = OutputSchema;
     }
-    async execute(_input) {
+    async execute(_opts) {
         const categories = await helpers_1.DocsHelper.listCategories();
         return {
             count: categories.length,
@@ -92,11 +93,11 @@ class ListCategoriesTool extends base_tool_1.BaseTool {
         };
     }
     getTool() {
-        return (0, base_tool_1.createTool)({
+        return (0, tools_1.createTool)({
             id: this.id,
             description: this.description,
-            inputSchema: InputSchema,
-            outputSchema: OutputSchema,
+            inputSchema: this.inputSchema,
+            outputSchema: this.outputSchema,
             execute: async ({ context }) => this.execute(context),
         });
     }

package/mcp-server/dist/tools/docs/list-categories.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-categories.tool.js","sourceRoot":"","sources":["../../../tools/docs/list-categories.tool.ts"],"names":[],"mappings":";;;AAAA,kDAAkD;AAClD,8CAAgD;AAChD,6BAAwB;AACxB,4CAAqD;AAErD,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCxB,CAAC;AAEF,MAAM,sBAAsB,GAAG;;;;;;;;;;;;;;;;;;CAkB9B,CAAC;AAEF,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,MAAM,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC,CAAC;AAE3E,MAAM,YAAY,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5B,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IACtE,UAAU,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;CACjE,CAAC,CAAC;AAEH,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E,MAAa,kBAAmB,SAAQ,oBAAiD;IAAzF;;QACW,OAAE,GAAG,gBAAgB,CAAC;QACtB,gBAAW,GAAG,gBAAgB,CAAC;QAC/B,gBAAW,GAAG,WAAW,CAAC;QAC1B,iBAAY,GAAG,YAAY,CAAC;IAoBvC,CAAC;IAlBC,KAAK,CAAC,OAAO,CAAC,KAAkC;QAC9C,MAAM,UAAU,GAAG,MAAM,oBAAU,CAAC,cAAc,EAAE,CAAC;QAErD,OAAO;YACL,KAAK,EAAE,UAAU,CAAC,MAAM;YACxB,UAAU;SACX,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;AAxBD,gDAwBC"}

package/mcp-server/dist/tools/{list-docs.tool.d.ts → docs/list-documents.tool.d.ts}

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { BaseTool, type TMastraTool } from './base.tool';
+import { BaseTool, TMastraTool } from '../base.tool';
 declare const InputSchema: z.ZodObject<{
     category: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -12,7 +12,7 @@ declare const OutputSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare class ListDocsTool extends BaseTool<typeof InputSchema, typeof OutputSchema> {
-    readonly id = "listDocs";
+    readonly id = "listDocuments";
     readonly description = "\nLists all available Ignis Framework documentation files with their identifiers, titles, and categories.\n\nPURPOSE:\nUse this tool to discover what documentation is available. It provides a complete catalog\nof all documents, optionally filtered by category. Essential for understanding the documentation\nstructure and finding specific pages.\n\nWHEN TO USE:\n- To explore what documentation exists\n- To find document IDs for use with getDocContent\n- To browse documents within a specific category\n- When searchDocs doesn't find what you're looking for\n- To understand the overall documentation structure\n- To provide users with a list of available resources\n\nWHEN NOT TO USE:\n- When you know what you're looking for (use searchDocs instead)\n- When you need document content (use getDocContent after getting IDs)\n\nCATEGORY FILTERING:\n- Omit 'category' parameter to get ALL documents\n- Provide exact category name to filter (case-sensitive)\n- Use listCategories first to see available category names\n\nCOMMON CATEGORIES IN IGNIS DOCS:\n- \"Getting Started\" - Introductory guides, quickstart, philosophy\n- \"Core Concepts\" - DI, lifecycle, configuration fundamentals\n- \"Best Practices\" - Recommended patterns and approaches\n- \"References\" - API documentation, component details\n- \"Helpers\" - Utility libraries documentation\n- \"Utilities\" - Utility function references\n\nWORKFLOW EXAMPLES:\n1. Browse all docs:\n   listDocs() \u2192 Review titles \u2192 getDocContent(id)\n\n2. Explore a category:\n   listCategories() \u2192 Pick category \u2192 listDocs(category) \u2192 getDocContent(id)\n\n3. Find specific documentation:\n   searchDocs(query) \u2192 If not found \u2192 listDocs() to browse manually\n";
     readonly inputSchema: z.ZodObject<{
         category: z.ZodOptional<z.ZodString>;
@@ -25,8 +25,8 @@ export declare class ListDocsTool extends BaseTool<typeof InputSchema, typeof Ou
             category: z.ZodString;
         }, z.core.$strip>>;
     }, z.core.$strip>;
-    execute(input: z.infer<typeof InputSchema>): Promise<z.infer<typeof OutputSchema>>;
+    execute(opts: z.infer<typeof InputSchema>): Promise<z.infer<typeof OutputSchema>>;
     getTool(): TMastraTool;
 }
 export {};
-//# sourceMappingURL=list-docs.tool.d.ts.map
+//# sourceMappingURL=list-documents.tool.d.ts.map

package/mcp-server/dist/tools/docs/list-documents.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-documents.tool.d.ts","sourceRoot":"","sources":["../../../tools/docs/list-documents.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAsFrD,QAAA,MAAM,WAAW;;iBAEf,CAAC;AAEH,QAAA,MAAM,YAAY;;;;;;;iBAGhB,CAAC;AAMH,qBAAa,YAAa,SAAQ,QAAQ,CAAC,OAAO,WAAW,EAAE,OAAO,YAAY,CAAC;IACjF,QAAQ,CAAC,EAAE,mBAAmB;IAC9B,QAAQ,CAAC,WAAW,+sDAAoB;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;IASvF,OAAO,IAAI,WAAW;CASvB"}

package/mcp-server/dist/tools/{list-docs.tool.js → docs/list-documents.tool.js}

@@ -2,8 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ListDocsTool = void 0;
 const zod_1 = require("zod");
-const helpers_1 = require("../helpers");
-const base_tool_1 = require("./base.tool");
+const tools_1 = require("@mastra/core/tools");
+const base_tool_1 = require("../base.tool");
+const helpers_1 = require("@/mcp-server/helpers");
 // ----------------------------------------------------------------------------
 // DESCRIPTIONS
 // ----------------------------------------------------------------------------
@@ -95,27 +96,27 @@ const OutputSchema = zod_1.z.object({
 class ListDocsTool extends base_tool_1.BaseTool {
     constructor() {
         super(...arguments);
-        this.id = 'listDocs';
+        this.id = 'listDocuments';
         this.description = TOOL_DESCRIPTION;
         this.inputSchema = InputSchema;
         this.outputSchema = OutputSchema;
     }
-    async execute(input) {
-        const docs = await helpers_1.DocsHelper.listDocs({ category: input.category });
+    async execute(opts) {
+        const docs = await helpers_1.DocsHelper.listDocumentFiles({ category: opts.category });
         return {
             count: docs.length,
             docs,
         };
     }
     getTool() {
-        return (0, base_tool_1.createTool)({
+        return (0, tools_1.createTool)({
             id: this.id,
             description: this.description,
-            inputSchema: InputSchema,
-            outputSchema: OutputSchema,
+            inputSchema: this.inputSchema,
+            outputSchema: this.outputSchema,
             execute: async ({ context }) => this.execute(context),
         });
     }
 }
 exports.ListDocsTool = ListDocsTool;
-//# sourceMappingURL=list-docs.tool.js.map
+//# sourceMappingURL=list-documents.tool.js.map

package/mcp-server/dist/tools/docs/list-documents.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-documents.tool.js","sourceRoot":"","sources":["../../../tools/docs/list-documents.tool.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,8CAAgD;AAChD,4CAAqD;AACrD,kDAAkD;AAElD,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0CxB,CAAC;AAEF,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;;CAqB5B,CAAC;AAEF,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,MAAM,cAAc,GAAG,OAAC,CAAC,MAAM,CAAC;IAC9B,EAAE,EAAE,OAAC;SACF,MAAM,EAAE;SACR,QAAQ,CAAC,6EAA6E,CAAC;IAC1F,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IAC1E,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;CAChF,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3B,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;CAC/D,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5B,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;IACzF,IAAI,EAAE,OAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,QAAQ,CAAC,gDAAgD,CAAC;CACzF,CAAC,CAAC;AAEH,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E,MAAa,YAAa,SAAQ,oBAAiD;IAAnF;;QACW,OAAE,GAAG,eAAe,CAAC;QACrB,gBAAW,GAAG,gBAAgB,CAAC;QAC/B,gBAAW,GAAG,WAAW,CAAC;QAC1B,iBAAY,GAAG,YAAY,CAAC;IAoBvC,CAAC;IAlBC,KAAK,CAAC,OAAO,CAAC,IAAiC;QAC7C,MAAM,IAAI,GAAG,MAAM,oBAAU,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAE7E,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,IAAI;SACL,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;AAxBD,oCAwBC"}

package/mcp-server/dist/tools/{search-docs.tool.d.ts → docs/search-documents.tool.d.ts}

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { BaseTool, type TMastraTool } from './base.tool';
+import { BaseTool, TMastraTool } from '../base.tool';
 declare const InputSchema: z.ZodObject<{
     query: z.ZodString;
     limit: z.ZodDefault<z.ZodNumber>;
@@ -14,7 +14,7 @@ declare const OutputSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare class SearchDocsTool extends BaseTool<typeof InputSchema, typeof OutputSchema> {
-    readonly id = "searchDocs";
+    readonly id = "searchDocuments";
     readonly description = "\nPerforms intelligent fuzzy search across the entire Ignis Framework documentation corpus.\n\nPURPOSE:\nUse this tool to find documentation pages relevant to a user's question or topic.\nIt searches both document titles (weighted higher) and content body using the Fuse.js fuzzy matching algorithm.\n\nWHEN TO USE:\n- User asks \"how do I...\" or \"what is...\" questions about Ignis\n- You need to find documentation about a specific feature, concept, or API\n- You want to discover related documentation before diving into specifics\n- User mentions keywords that might appear in documentation\n\nSEARCH BEHAVIOR:\n- Fuzzy matching tolerates typos and partial matches\n- Title matches are weighted 70%, content matches 30%\n- Results sorted by relevance score (lower = better match)\n- Returns snippet previews for quick assessment\n\nWORKFLOW RECOMMENDATION:\n1. Start with searchDocs to find relevant pages\n2. Review returned snippets to identify best matches\n3. Use getDocContent with specific IDs to retrieve full content\n4. Use getDocMetadata if you need document statistics\n\nOUTPUT STRUCTURE:\nReturns array of {id, title, category, snippet, score} objects.\nUse the 'id' field with getDocContent to fetch full document content.\n";
     readonly inputSchema: z.ZodObject<{
         query: z.ZodString;
@@ -29,8 +29,8 @@ export declare class SearchDocsTool extends BaseTool<typeof InputSchema, typeof
             score: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
     }, z.core.$strip>;
-    execute(input: z.infer<typeof InputSchema>): Promise<z.infer<typeof OutputSchema>>;
+    execute(opts: z.infer<typeof InputSchema>): Promise<z.infer<typeof OutputSchema>>;
     getTool(): TMastraTool;
 }
 export {};
-//# sourceMappingURL=search-docs.tool.d.ts.map
+//# sourceMappingURL=search-documents.tool.d.ts.map

package/mcp-server/dist/tools/docs/search-documents.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-documents.tool.d.ts","sourceRoot":"","sources":["../../../tools/docs/search-documents.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAiFrD,QAAA,MAAM,WAAW;;;iBASf,CAAC;AAEH,QAAA,MAAM,YAAY;;;;;;;;iBAIhB,CAAC;AAMH,qBAAa,cAAe,SAAQ,QAAQ,CAAC,OAAO,WAAW,EAAE,OAAO,YAAY,CAAC;IACnF,QAAQ,CAAC,EAAE,qBAAqB;IAChC,QAAQ,CAAC,WAAW,kuCAAoB;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;IAQvF,OAAO,IAAI,WAAW;CASvB"}

package/mcp-server/dist/tools/{search-docs.tool.js → docs/search-documents.tool.js}

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SearchDocsTool = void 0;
+const common_1 = require("@/mcp-server/common");
+const helpers_1 = require("@/mcp-server/helpers");
+const tools_1 = require("@mastra/core/tools");
 const zod_1 = require("zod");
-const common_1 = require("../common");
-const helpers_1 = require("../helpers");
-const base_tool_1 = require("./base.tool");
+const base_tool_1 = require("../base.tool");
 // ----------------------------------------------------------------------------
 // DESCRIPTIONS
 // ----------------------------------------------------------------------------
@@ -41,7 +42,7 @@ const QUERY_DESCRIPTION = `
 Search query string to match against documentation titles and content.
 
 REQUIREMENTS:
-- Minimum ${common_1.MCP_CONFIG.search.minQueryLength} characters required
+- Minimum ${common_1.MCPConfigs.search.minQueryLength} characters required
 - Supports natural language queries (e.g., "dependency injection setup")
 - Supports technical terms (e.g., "HttpServer middleware")
 - Case-insensitive matching
@@ -56,8 +57,8 @@ Maximum number of results to return.
 
 CONSTRAINTS:
 - Minimum: 1
-- Maximum: ${common_1.MCP_CONFIG.search.maxLimit}
-- Default: ${common_1.MCP_CONFIG.search.defaultLimit}
+- Maximum: ${common_1.MCPConfigs.search.maxLimit}
+- Default: ${common_1.MCPConfigs.search.defaultLimit}
 
 RECOMMENDATIONS:
 - Use default (10) for general queries
@@ -77,13 +78,13 @@ const SearchResultSchema = zod_1.z.object({
     score: zod_1.z.number().optional().describe('Relevance score 0-1 (lower = better match).'),
 });
 const InputSchema = zod_1.z.object({
-    query: zod_1.z.string().min(common_1.MCP_CONFIG.search.minQueryLength).describe(QUERY_DESCRIPTION),
+    query: zod_1.z.string().min(common_1.MCPConfigs.search.minQueryLength).describe(QUERY_DESCRIPTION),
     limit: zod_1.z
         .number()
         .int()
         .min(1)
-        .max(common_1.MCP_CONFIG.search.maxLimit)
-        .default(common_1.MCP_CONFIG.search.defaultLimit)
+        .max(common_1.MCPConfigs.search.maxLimit)
+        .default(common_1.MCPConfigs.search.defaultLimit)
         .describe(LIMIT_DESCRIPTION),
 });
 const OutputSchema = zod_1.z.object({
@@ -97,27 +98,27 @@ const OutputSchema = zod_1.z.object({
 class SearchDocsTool extends base_tool_1.BaseTool {
     constructor() {
         super(...arguments);
-        this.id = 'searchDocs';
+        this.id = 'searchDocuments';
         this.description = TOOL_DESCRIPTION;
         this.inputSchema = InputSchema;
         this.outputSchema = OutputSchema;
     }
-    async execute(input) {
-        const results = await helpers_1.DocsHelper.searchDocs({
-            query: input.query,
-            limit: input.limit,
+    async execute(opts) {
+        const results = await helpers_1.DocsHelper.searchDocuments({
+            query: opts.query,
+            limit: opts.limit,
         });
         return { results };
     }
     getTool() {
-        return (0, base_tool_1.createTool)({
+        return (0, tools_1.createTool)({
             id: this.id,
             description: this.description,
-            inputSchema: InputSchema,
-            outputSchema: OutputSchema,
+            inputSchema: this.inputSchema,
+            outputSchema: this.outputSchema,
             execute: async ({ context }) => this.execute(context),
         });
     }
 }
 exports.SearchDocsTool = SearchDocsTool;
-//# sourceMappingURL=search-docs.tool.js.map
+//# sourceMappingURL=search-documents.tool.js.map

package/mcp-server/dist/tools/docs/search-documents.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-documents.tool.js","sourceRoot":"","sources":["../../../tools/docs/search-documents.tool.ts"],"names":[],"mappings":";;;AAAA,gDAAiD;AACjD,kDAAkD;AAClD,8CAAgD;AAChD,6BAAwB;AACxB,4CAAqD;AAErD,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BxB,CAAC;AAEF,MAAM,iBAAiB,GAAG;;;;YAId,mBAAU,CAAC,MAAM,CAAC,cAAc;;;;;;;;;CAS3C,CAAC;AAEF,MAAM,iBAAiB,GAAG;;;;;aAKb,mBAAU,CAAC,MAAM,CAAC,QAAQ;aAC1B,mBAAU,CAAC,MAAM,CAAC,YAAY;;;;;;CAM1C,CAAC;AAEF,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,MAAM,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IAClC,EAAE,EAAE,OAAC;SACF,MAAM,EAAE;SACR,QAAQ,CACP,oGAAoG,CACrG;IACH,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6DAA6D,CAAC;IACzF,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;IAC3F,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;IACrF,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;CACrF,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3B,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,mBAAU,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IACnF,KAAK,EAAE,OAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,mBAAU,CAAC,MAAM,CAAC,QAAQ,CAAC;SAC/B,OAAO,CAAC,mBAAU,CAAC,MAAM,CAAC,YAAY,CAAC;SACvC,QAAQ,CAAC,iBAAiB,CAAC;CAC/B,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5B,OAAO,EAAE,OAAC;SACP,KAAK,CAAC,kBAAkB,CAAC;SACzB,QAAQ,CAAC,gEAAgE,CAAC;CAC9E,CAAC,CAAC;AAEH,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E,MAAa,cAAe,SAAQ,oBAAiD;IAArF;;QACW,OAAE,GAAG,iBAAiB,CAAC;QACvB,gBAAW,GAAG,gBAAgB,CAAC;QAC/B,gBAAW,GAAG,WAAW,CAAC;QAC1B,iBAAY,GAAG,YAAY,CAAC;IAmBvC,CAAC;IAjBC,KAAK,CAAC,OAAO,CAAC,IAAiC;QAC7C,MAAM,OAAO,GAAG,MAAM,oBAAU,CAAC,eAAe,CAAC;YAC/C,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,CAAC;IACrB,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;AAvBD,wCAuBC"}

package/mcp-server/dist/tools/github/index.d.ts

@@ -0,0 +1,5 @@
+export * from './list-project-files.tool';
+export * from './search-code.tool';
+export * from './verify-dependencies.tool';
+export * from './view-source-file.tool';
+//# sourceMappingURL=index.d.ts.map

package/mcp-server/dist/tools/github/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../tools/github/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC"}

package/mcp-server/dist/tools/github/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./list-project-files.tool"), exports);
+__exportStar(require("./search-code.tool"), exports);
+__exportStar(require("./verify-dependencies.tool"), exports);
+__exportStar(require("./view-source-file.tool"), exports);
+//# sourceMappingURL=index.js.map

package/mcp-server/dist/tools/github/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../tools/github/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4DAA0C;AAC1C,qDAAmC;AACnC,6DAA2C;AAC3C,0DAAwC"}

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

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import { BaseTool, TMastraTool } from '../base.tool';
+declare const InputSchema: z.ZodObject<{
+    directoryPath: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+declare const OutputSchema: z.ZodObject<{
+    directoryPath: z.ZodString;
+    files: z.ZodArray<z.ZodString>;
+    directories: z.ZodArray<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare class ListProjectFilesTool extends BaseTool<typeof InputSchema, typeof OutputSchema> {
+    readonly id = "listProjectFiles";
+    readonly description = "\nLists files and directories within the Ignis GitHub repository.\n\nPURPOSE:\nExplore the project structure, discover source code files, and navigate the monorepo.\nPrimary tool for understanding codebase layout before reading specific files.\n\nWHEN TO USE:\n- To understand overall project structure\n- To find location of specific modules (e.g., \"where are the controllers?\")\n- To get list of files in a directory before using viewSourceFile\n- To find configuration files, examples, or documentation\n\nWHEN NOT TO USE:\n- When searching for specific code patterns or keywords (use searchCode instead)\n- When you need to read a file's content (use viewSourceFile instead)\n- For documentation content (use searchDocs, listDocs, getDocContent instead)\n\nWORKFLOW:\n1. Start at root: listProjectFiles()\n2. Explore a package: listProjectFiles({ directoryPath: \"packages/core/src\" })\n3. Identify a file of interest\n4. Read the file: viewSourceFile({ filePath: \"packages/core/src/application.ts\" })\n";
+    readonly inputSchema: z.ZodObject<{
+        directoryPath: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>;
+    readonly outputSchema: z.ZodObject<{
+        directoryPath: z.ZodString;
+        files: z.ZodArray<z.ZodString>;
+        directories: z.ZodArray<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=list-project-files.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-project-files.tool.d.ts","sourceRoot":"","sources":["../../../tools/github/list-project-files.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AA8CrD,QAAA,MAAM,WAAW;;iBAEf,CAAC;AAEH,QAAA,MAAM,YAAY;;;;;iBAOhB,CAAC;AAMH,qBAAa,oBAAqB,SAAQ,QAAQ,CAAC,OAAO,WAAW,EAAE,OAAO,YAAY,CAAC;IACzF,QAAQ,CAAC,EAAE,sBAAsB;IACjC,QAAQ,CAAC,WAAW,0/BAAoB;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;IAuBvF,OAAO,IAAI,WAAW;CASvB"}