@venizia/ignis-docs 0.0.1-1 → 0.0.1-10

package/dist/mcp-server/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 common_1 = require("../../../mcp-server/common");
+const helpers_1 = require("../../../mcp-server/helpers");
+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 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/dist/mcp-server/tools/docs/get-package-overview.tool.js.map

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

package/dist/mcp-server/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/dist/mcp-server/tools/docs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../mcp-server/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/dist/mcp-server/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/dist/mcp-server/tools/docs/index.js.map

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

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

@@ -1,5 +1,5 @@
-import { z } from "zod";
-import { BaseTool, type TMastraTool } from "./base.tool";
+import { z } from 'zod';
+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/dist/mcp-server/tools/docs/list-categories.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-categories.tool.d.ts","sourceRoot":"","sources":["../../../../mcp-server/tools/docs/list-categories.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAuErD,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 → dist/mcp-server/tools/docs}/list-categories.tool.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ListCategoriesTool = void 0;
+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");
+const helpers_1 = require("../../../mcp-server/helpers");
 // ----------------------------------------------------------------------------
 // DESCRIPTIONS
 // ----------------------------------------------------------------------------
@@ -68,9 +69,9 @@ Pass any category name to listDocs(category) to filter documents by that categor
 // ----------------------------------------------------------------------------
 // SCHEMAS
 // ----------------------------------------------------------------------------
-const InputSchema = zod_1.z.object({}).describe("No input parameters required.");
+const InputSchema = zod_1.z.object({}).describe('No input parameters required.');
 const OutputSchema = zod_1.z.object({
-    count: zod_1.z.number().int().describe("Total number of unique categories."),
+    count: zod_1.z.number().int().describe('Total number of unique categories.'),
     categories: zod_1.z.array(zod_1.z.string()).describe(CATEGORIES_DESCRIPTION),
 });
 // ----------------------------------------------------------------------------
@@ -79,12 +80,12 @@ const OutputSchema = zod_1.z.object({
 class ListCategoriesTool extends base_tool_1.BaseTool {
     constructor() {
         super(...arguments);
-        this.id = "listCategories";
+        this.id = 'listCategories';
         this.description = TOOL_DESCRIPTION;
         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/dist/mcp-server/tools/docs/list-categories.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-categories.tool.js","sourceRoot":"","sources":["../../../../mcp-server/tools/docs/list-categories.tool.ts"],"names":[],"mappings":";;;AAAA,8CAAgD;AAChD,6BAAwB;AACxB,4CAAqD;AACrD,kDAAkD;AAElD,+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 → dist/mcp-server/tools/docs/list-documents.tool.d.ts}

@@ -1,5 +1,5 @@
-import { z } from "zod";
-import { BaseTool, type TMastraTool } from "./base.tool";
+import { z } from 'zod';
+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/dist/mcp-server/tools/docs/list-documents.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-documents.tool.d.ts","sourceRoot":"","sources":["../../../../mcp-server/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 → dist/mcp-server/tools/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
 // ----------------------------------------------------------------------------
@@ -78,16 +79,16 @@ TIP: If unsure of exact category name, call listCategories first or omit this pa
 const DocEntrySchema = zod_1.z.object({
     id: zod_1.z
         .string()
-        .describe("Document ID (relative file path). Use with getDocContent or getDocMetadata."),
-    title: zod_1.z.string().describe("Document title from frontmatter or filename."),
-    category: zod_1.z.string().describe("Document category for organizational grouping."),
+        .describe('Document ID (relative file path). Use with getDocContent or getDocMetadata.'),
+    title: zod_1.z.string().describe('Document title from frontmatter or filename.'),
+    category: zod_1.z.string().describe('Document category for organizational grouping.'),
 });
 const InputSchema = zod_1.z.object({
     category: zod_1.z.string().optional().describe(CATEGORY_DESCRIPTION),
 });
 const OutputSchema = zod_1.z.object({
-    count: zod_1.z.number().int().describe("Total documents returned. Reflects filter if applied."),
-    docs: zod_1.z.array(DocEntrySchema).describe("Document entries with id, title, and category."),
+    count: zod_1.z.number().int().describe('Total documents returned. Reflects filter if applied.'),
+    docs: zod_1.z.array(DocEntrySchema).describe('Document entries with id, title, and category.'),
 });
 // ----------------------------------------------------------------------------
 // TOOL CLASS
@@ -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/dist/mcp-server/tools/docs/list-documents.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-documents.tool.js","sourceRoot":"","sources":["../../../../mcp-server/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 → dist/mcp-server/tools/docs/search-documents.tool.d.ts}

@@ -1,32 +1,36 @@
-import { z } from "zod";
-import { BaseTool, type TMastraTool } from "./base.tool";
+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.ZodArray<z.ZodObject<{
-    id: z.ZodString;
-    title: z.ZodString;
-    category: z.ZodString;
-    snippet: z.ZodString;
-    score: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>>;
-export declare class SearchDocsTool extends BaseTool<typeof InputSchema, typeof OutputSchema> {
-    readonly id = "searchDocs";
-    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;
-        limit: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strip>;
-    readonly outputSchema: z.ZodArray<z.ZodObject<{
+declare const OutputSchema: z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         title: z.ZodString;
         category: z.ZodString;
         snippet: z.ZodString;
         score: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
-    execute(input: z.infer<typeof InputSchema>): Promise<z.infer<typeof OutputSchema>>;
+}, z.core.$strip>;
+export declare class SearchDocsTool extends BaseTool<typeof InputSchema, typeof OutputSchema> {
+    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;
+        limit: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    readonly outputSchema: z.ZodObject<{
+        results: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            category: z.ZodString;
+            snippet: z.ZodString;
+            score: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    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/dist/mcp-server/tools/docs/search-documents.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-documents.tool.d.ts","sourceRoot":"","sources":["../../../../mcp-server/tools/docs/search-documents.tool.ts"],"names":[],"mappings":"AACA,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;;;;;;;;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 → dist/mcp-server/tools/docs/search-documents.tool.js}

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SearchDocsTool = void 0;
+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");
+const common_1 = require("../../../mcp-server/common");
+const helpers_1 = require("../../../mcp-server/helpers");
 // ----------------------------------------------------------------------------
 // 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
@@ -70,51 +71,54 @@ RECOMMENDATIONS:
 const SearchResultSchema = zod_1.z.object({
     id: zod_1.z
         .string()
-        .describe("Unique document identifier (relative file path). Use with getDocContent to retrieve full document."),
-    title: zod_1.z.string().describe("Human-readable document title from frontmatter or filename."),
+        .describe('Unique document identifier (relative file path). Use with getDocContent to retrieve full document.'),
+    title: zod_1.z.string().describe('Human-readable document title from frontmatter or filename.'),
     category: zod_1.z.string().describe('Document category (e.g., "Getting Started", "References").'),
-    snippet: zod_1.z.string().describe("Content preview (max 300 chars) for quick assessment."),
-    score: zod_1.z.number().optional().describe("Relevance score 0-1 (lower = better match)."),
+    snippet: zod_1.z.string().describe('Content preview (max 300 chars) for quick assessment.'),
+    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
-    .array(SearchResultSchema)
-    .describe("Search results sorted by relevance. Empty array if no matches.");
+const OutputSchema = zod_1.z.object({
+    results: zod_1.z
+        .array(SearchResultSchema)
+        .describe('Search results sorted by relevance. Empty array if no matches.'),
+});
 // ----------------------------------------------------------------------------
 // TOOL CLASS
 // ----------------------------------------------------------------------------
 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) {
-        return 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