@breadstone/archipel-mcp 0.0.10 → 0.0.13

package/src/main.js

@@ -3,17 +3,23 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
-const zod_1 = require("zod");
 const DocsLoader_1 = require("./DocsLoader");
-const configPattern_1 = require("./knowledge/configPattern");
-const dtoPattern_1 = require("./knowledge/dtoPattern");
-const errorHandlingPattern_1 = require("./knowledge/errorHandlingPattern");
-const guardPattern_1 = require("./knowledge/guardPattern");
-const mappingPattern_1 = require("./knowledge/mappingPattern");
-const modulePattern_1 = require("./knowledge/modulePattern");
-const queryPattern_1 = require("./knowledge/queryPattern");
-const repositoryPattern_1 = require("./knowledge/repositoryPattern");
-const testingPattern_1 = require("./knowledge/testingPattern");
+const GuidesLoader_1 = require("./GuidesLoader");
+const registerGetConfigPatternTool_1 = require("./tools/registerGetConfigPatternTool");
+const registerGetDtoPatternTool_1 = require("./tools/registerGetDtoPatternTool");
+const registerGetErrorHandlingPatternTool_1 = require("./tools/registerGetErrorHandlingPatternTool");
+const registerGetGuardPatternTool_1 = require("./tools/registerGetGuardPatternTool");
+const registerGetGuideTool_1 = require("./tools/registerGetGuideTool");
+const registerGetMappingPatternTool_1 = require("./tools/registerGetMappingPatternTool");
+const registerGetModulePatternTool_1 = require("./tools/registerGetModulePatternTool");
+const registerGetPackageDocTool_1 = require("./tools/registerGetPackageDocTool");
+const registerGetQueryPatternTool_1 = require("./tools/registerGetQueryPatternTool");
+const registerGetRepositoryPatternTool_1 = require("./tools/registerGetRepositoryPatternTool");
+const registerGetTestingPatternTool_1 = require("./tools/registerGetTestingPatternTool");
+const registerListGuidesTool_1 = require("./tools/registerListGuidesTool");
+const registerListPackagesTool_1 = require("./tools/registerListPackagesTool");
+const registerSearchDocsTool_1 = require("./tools/registerSearchDocsTool");
+const registerSearchGuidesTool_1 = require("./tools/registerSearchGuidesTool");
 // #region Fields
 const SERVER_NAME = 'archipel-mcp';
 const SERVER_VERSION = '0.0.1';
@@ -22,203 +28,35 @@ const SERVER_VERSION = '0.0.1';
 async function main() {
     const docsLoader = new DocsLoader_1.DocsLoader();
     docsLoader.load();
+    const guidesLoader = new GuidesLoader_1.GuidesLoader();
+    guidesLoader.load();
     const server = new mcp_js_1.McpServer({
         name: SERVER_NAME,
+        description: 'MCP server for Archipel platform documentation, guides, and knowledge base.',
+        title: 'Archipel MCP Server',
+        websiteUrl: 'https://archipel.breadstone.de/',
         version: SERVER_VERSION,
     });
-    registerTools(server, docsLoader);
+    (0, registerListPackagesTool_1.registerListPackagesTool)(server, docsLoader);
+    (0, registerGetPackageDocTool_1.registerGetPackageDocTool)(server, docsLoader);
+    (0, registerSearchDocsTool_1.registerSearchDocsTool)(server, docsLoader);
+    (0, registerListGuidesTool_1.registerListGuidesTool)(server, guidesLoader);
+    (0, registerGetGuideTool_1.registerGetGuideTool)(server, guidesLoader);
+    (0, registerSearchGuidesTool_1.registerSearchGuidesTool)(server, guidesLoader);
+    (0, registerGetQueryPatternTool_1.registerGetQueryPatternTool)(server);
+    (0, registerGetRepositoryPatternTool_1.registerGetRepositoryPatternTool)(server);
+    (0, registerGetMappingPatternTool_1.registerGetMappingPatternTool)(server);
+    (0, registerGetModulePatternTool_1.registerGetModulePatternTool)(server);
+    (0, registerGetErrorHandlingPatternTool_1.registerGetErrorHandlingPatternTool)(server);
+    (0, registerGetConfigPatternTool_1.registerGetConfigPatternTool)(server);
+    (0, registerGetGuardPatternTool_1.registerGetGuardPatternTool)(server);
+    (0, registerGetDtoPatternTool_1.registerGetDtoPatternTool)(server);
+    (0, registerGetTestingPatternTool_1.registerGetTestingPatternTool)(server);
     const transport = new stdio_js_1.StdioServerTransport();
     await server.connect(transport);
     process.stderr.write(`[${SERVER_NAME}] Server running on stdio\n`);
 }
 // #endregion
-// #region Tool Registration
-function registerTools(server, docsLoader) {
-    // --- list-packages ---
-    server.tool('list-packages', 'Lists all available Archipel platform packages with their descriptions and tags.', {}, async () => {
-        const packages = Array.from(docsLoader.packages.values()).map((packageDoc) => ({
-            name: packageDoc.name,
-            package: packageDoc.packageScope,
-            description: packageDoc.description,
-            tags: packageDoc.tags,
-        }));
-        return {
-            content: [{ type: 'text', text: JSON.stringify(packages, null, 2) }],
-        };
-    });
-    // --- get-package-doc ---
-    server.tool('get-package-doc', 'Gets the full documentation (overview + API reference) for a specific Archipel platform package.', {
-        packageName: zod_1.z.string().describe('The package directory name (e.g. "platform-core", "platform-database").'),
-    }, async (params) => {
-        const packageDoc = docsLoader.packages.get(params.packageName);
-        if (!packageDoc) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: `Package "${params.packageName}" not found. Use the list-packages tool to see available packages.`,
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const sections = [
-            `# ${packageDoc.title}`,
-            '',
-            `> ${packageDoc.description}`,
-            '',
-            `**Package:** \`${packageDoc.packageScope}\``,
-        ];
-        if (packageDoc.tags.length > 0) {
-            sections.push(`**Tags:** ${packageDoc.tags.join(', ')}`);
-        }
-        sections.push('', packageDoc.content);
-        if (packageDoc.apiContent) {
-            sections.push('', '---', '', '## API Reference', '', packageDoc.apiContent);
-        }
-        return {
-            content: [{ type: 'text', text: sections.join('\n') }],
-        };
-    });
-    // --- search-docs ---
-    server.tool('search-docs', 'Searches across all Archipel platform documentation by keyword or phrase.', {
-        query: zod_1.z.string().describe('The search query to match against package names, descriptions, tags, and content.'),
-    }, async (params) => {
-        const results = docsLoader.search(params.query);
-        if (results.length === 0) {
-            return {
-                content: [{ type: 'text', text: `No documentation found matching: "${params.query}"` }],
-            };
-        }
-        const summary = results
-            .map((packageDoc) => [
-            `## ${packageDoc.title}`,
-            `**Package:** \`${packageDoc.packageScope}\``,
-            '',
-            packageDoc.description,
-            '',
-            packageDoc.content,
-        ].join('\n'))
-            .join('\n\n---\n\n');
-        return {
-            content: [
-                { type: 'text', text: `Found ${results.length} result(s) for "${params.query}":\n\n${summary}` },
-            ],
-        };
-    });
-    // --- get-query-pattern ---
-    server.tool('get-query-pattern', 'Returns the Archipel query pattern documentation — interfaces, factories, rules, and examples. Optionally tailored to a specific Prisma model.', {
-        modelName: zod_1.z
-            .string()
-            .optional()
-            .describe('Prisma model name (e.g. "User", "Order"). If provided, generates model-specific examples.'),
-        fields: zod_1.z
-            .array(zod_1.z.string())
-            .optional()
-            .describe('Field names of the model (e.g. ["id", "email", "name", "createdAt"]). Used with modelName for tailored examples.'),
-    }, async (params) => {
-        let content = queryPattern_1.QUERY_PATTERN_KNOWLEDGE;
-        if (params.modelName && params.fields && params.fields.length > 0) {
-            content += '\n\n' + (0, queryPattern_1.QUERY_PATTERN_WITH_MODEL)(params.modelName, params.fields);
-        }
-        return {
-            content: [{ type: 'text', text: content }],
-        };
-    });
-    // --- get-repository-pattern ---
-    server.tool('get-repository-pattern', 'Returns the Archipel repository class pattern — how to create a RepositoryBase subclass with correct generics, module registration, and service injection. Optionally tailored to a specific Prisma model.', {
-        modelName: zod_1.z
-            .string()
-            .optional()
-            .describe('Prisma model name (e.g. "User", "Order"). If provided, generates a complete repository scaffold.'),
-        fields: zod_1.z
-            .array(zod_1.z.string())
-            .optional()
-            .describe('Field names of the model (e.g. ["id", "email", "name", "createdAt"]). Used with modelName for tailored examples.'),
-    }, async (params) => {
-        let content = repositoryPattern_1.REPOSITORY_PATTERN_KNOWLEDGE;
-        if (params.modelName && params.fields && params.fields.length > 0) {
-            content += '\n\n' + (0, repositoryPattern_1.REPOSITORY_PATTERN_WITH_MODEL)(params.modelName, params.fields);
-        }
-        return {
-            content: [{ type: 'text', text: content }],
-        };
-    });
-    // --- get-mapping-pattern ---
-    server.tool('get-mapping-pattern', 'Returns the Archipel mapping pattern — branded type-safe mapping keys, MappingProfileBase, MappingService, and MappingModule registration. Optionally tailored to a specific entity and response class.', {
-        entityName: zod_1.z
-            .string()
-            .optional()
-            .describe('Entity name (e.g. "Product", "User"). If provided, generates tailored mapping scaffold.'),
-        fields: zod_1.z
-            .array(zod_1.z.string())
-            .optional()
-            .describe('Field names of the entity (e.g. ["id", "name", "barcode", "createdAt"]).'),
-        responseName: zod_1.z
-            .string()
-            .optional()
-            .describe('Response class name (e.g. "ProductResponse"). Defaults to "{entityName}Response".'),
-    }, async (params) => {
-        let content = mappingPattern_1.MAPPING_PATTERN_KNOWLEDGE;
-        if (params.entityName && params.fields && params.fields.length > 0) {
-            const responseName = params.responseName || `${params.entityName}Response`;
-            content += '\n\n' + (0, mappingPattern_1.MAPPING_PATTERN_WITH_CONTEXT)(params.entityName, params.fields, responseName);
-        }
-        return {
-            content: [{ type: 'text', text: content }],
-        };
-    });
-    // --- get-module-pattern ---
-    server.tool('get-module-pattern', 'Returns the Archipel NestJS dynamic module pattern — register(), port/adapter injection, ConfigModule integration. Optionally tailored with module name and port definitions.', {
-        moduleName: zod_1.z
-            .string()
-            .optional()
-            .describe('Module name (e.g. "NotificationModule"). If provided, generates a complete module scaffold.'),
-        ports: zod_1.z
-            .array(zod_1.z.string())
-            .optional()
-            .describe('Port class names (e.g. ["NotificationPort", "TemplatePort"]). Abstract port classes for dependency inversion.'),
-    }, async (params) => {
-        let content = modulePattern_1.MODULE_PATTERN_KNOWLEDGE;
-        if (params.moduleName && params.ports && params.ports.length > 0) {
-            content += '\n\n' + (0, modulePattern_1.MODULE_PATTERN_WITH_CONTEXT)(params.moduleName, params.ports);
-        }
-        return {
-            content: [{ type: 'text', text: content }],
-        };
-    });
-    // --- get-error-handling-pattern ---
-    server.tool('get-error-handling-pattern', 'Returns the Archipel error handling pattern — domain errors, RepositoryError, exception filters, and structured error response envelopes.', {}, async () => {
-        return {
-            content: [{ type: 'text', text: errorHandlingPattern_1.ERROR_HANDLING_PATTERN_KNOWLEDGE }],
-        };
-    });
-    // --- get-config-pattern ---
-    server.tool('get-config-pattern', 'Returns the Archipel configuration pattern — typed config keys (createConfigKey), ConfigRegistry, ConfigService, env.ts conventions, and ConfigModule integration.', {}, async () => {
-        return {
-            content: [{ type: 'text', text: configPattern_1.CONFIG_PATTERN_KNOWLEDGE }],
-        };
-    });
-    // --- get-guard-pattern ---
-    server.tool('get-guard-pattern', 'Returns the Archipel guard & interceptor pattern — metadata decorators, FeatureGuard, RolesGuard, FeatureUsageInterceptor, and the full decorator-guard-interceptor trio.', {}, async () => {
-        return {
-            content: [{ type: 'text', text: guardPattern_1.GUARD_PATTERN_KNOWLEDGE }],
-        };
-    });
-    // --- get-dto-pattern ---
-    server.tool('get-dto-pattern', 'Returns the Archipel DTO & validation pattern — Request/Response DTOs, class-validator decorators, cross-field validation, query parameter DTOs, OpenAPI integration, and naming conventions.', {}, async () => {
-        return {
-            content: [{ type: 'text', text: dtoPattern_1.DTO_PATTERN_KNOWLEDGE }],
-        };
-    });
-    // --- get-testing-pattern ---
-    server.tool('get-testing-pattern', 'Returns the Archipel testing pattern — Vitest conventions, mocking patterns for repositories/services/delegates, AAA structure, and test naming conventions.', {}, async () => {
-        return {
-            content: [{ type: 'text', text: testingPattern_1.TESTING_PATTERN_KNOWLEDGE }],
-        };
-    });
-}
-// #endregion
 main().catch((error) => {
     process.stderr.write(`[${SERVER_NAME}] Fatal error: ${String(error)}\n`);
     process.exit(1);

package/src/models/IGuideDoc.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Describes a loaded guide documentation entry.
+ */
+export interface IGuideDoc {
+    /** File name without extension (e.g. "getting-started"). */
+    readonly name: string;
+    /** Human-readable title from frontmatter. */
+    readonly title: string;
+    /** Short description from frontmatter. */
+    readonly description: string;
+    /** Sort order from frontmatter. */
+    readonly order: number;
+    /** Markdown body (without frontmatter). */
+    readonly content: string;
+}

package/src/models/IGuideDoc.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IGuideDoc.js.map

package/src/tools/registerGetConfigPatternTool.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Registers the get-config-pattern tool on the MCP server.
+ */
+export declare function registerGetConfigPatternTool(server: McpServer): void;

package/src/tools/registerGetConfigPatternTool.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerGetConfigPatternTool = registerGetConfigPatternTool;
+const configPattern_1 = require("../knowledge/configPattern");
+/**
+ * Registers the get-config-pattern tool on the MCP server.
+ */
+function registerGetConfigPatternTool(server) {
+    server.tool('get-config-pattern', 'Returns the Archipel configuration pattern — typed config keys (createConfigKey), ConfigRegistry, ConfigService, env.ts conventions, and ConfigModule integration.', {}, async () => {
+        return {
+            content: [{ type: 'text', text: configPattern_1.CONFIG_PATTERN_KNOWLEDGE }],
+        };
+    });
+}
+//# sourceMappingURL=registerGetConfigPatternTool.js.map

package/src/tools/registerGetDtoPatternTool.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Registers the get-dto-pattern tool on the MCP server.
+ */
+export declare function registerGetDtoPatternTool(server: McpServer): void;

package/src/tools/registerGetDtoPatternTool.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerGetDtoPatternTool = registerGetDtoPatternTool;
+const dtoPattern_1 = require("../knowledge/dtoPattern");
+/**
+ * Registers the get-dto-pattern tool on the MCP server.
+ */
+function registerGetDtoPatternTool(server) {
+    server.tool('get-dto-pattern', 'Returns the Archipel DTO & validation pattern — Request/Response DTOs, class-validator decorators, cross-field validation, query parameter DTOs, OpenAPI integration, and naming conventions.', {}, async () => {
+        return {
+            content: [{ type: 'text', text: dtoPattern_1.DTO_PATTERN_KNOWLEDGE }],
+        };
+    });
+}
+//# sourceMappingURL=registerGetDtoPatternTool.js.map

package/src/tools/registerGetErrorHandlingPatternTool.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Registers the get-error-handling-pattern tool on the MCP server.
+ */
+export declare function registerGetErrorHandlingPatternTool(server: McpServer): void;

package/src/tools/registerGetErrorHandlingPatternTool.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerGetErrorHandlingPatternTool = registerGetErrorHandlingPatternTool;
+const errorHandlingPattern_1 = require("../knowledge/errorHandlingPattern");
+/**
+ * Registers the get-error-handling-pattern tool on the MCP server.
+ */
+function registerGetErrorHandlingPatternTool(server) {
+    server.tool('get-error-handling-pattern', 'Returns the Archipel error handling pattern — domain errors, RepositoryError, exception filters, and structured error response envelopes.', {}, async () => {
+        return {
+            content: [{ type: 'text', text: errorHandlingPattern_1.ERROR_HANDLING_PATTERN_KNOWLEDGE }],
+        };
+    });
+}
+//# sourceMappingURL=registerGetErrorHandlingPatternTool.js.map

package/src/tools/registerGetGuardPatternTool.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Registers the get-guard-pattern tool on the MCP server.
+ */
+export declare function registerGetGuardPatternTool(server: McpServer): void;

package/src/tools/registerGetGuardPatternTool.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerGetGuardPatternTool = registerGetGuardPatternTool;
+const guardPattern_1 = require("../knowledge/guardPattern");
+/**
+ * Registers the get-guard-pattern tool on the MCP server.
+ */
+function registerGetGuardPatternTool(server) {
+    server.tool('get-guard-pattern', 'Returns the Archipel guard & interceptor pattern — metadata decorators, FeatureGuard, RolesGuard, FeatureUsageInterceptor, and the full decorator-guard-interceptor trio.', {}, async () => {
+        return {
+            content: [{ type: 'text', text: guardPattern_1.GUARD_PATTERN_KNOWLEDGE }],
+        };
+    });
+}
+//# sourceMappingURL=registerGetGuardPatternTool.js.map

package/src/tools/registerGetGuideTool.d.ts

@@ -0,0 +1,6 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { GuidesLoader } from '../GuidesLoader';
+/**
+ * Registers the get-guide tool on the MCP server.
+ */
+export declare function registerGetGuideTool(server: McpServer, guidesLoader: GuidesLoader): void;

package/src/tools/registerGetGuideTool.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerGetGuideTool = registerGetGuideTool;
+const zod_1 = require("zod");
+/**
+ * Registers the get-guide tool on the MCP server.
+ */
+function registerGetGuideTool(server, guidesLoader) {
+    server.tool('get-guide', 'Gets the full content of a specific Archipel platform guide.', {
+        guideName: zod_1.z
+            .string()
+            .describe('The guide file name without extension (e.g. "getting-started", "caching", "authentication-and-authorization").'),
+    }, async (params) => {
+        const guide = guidesLoader.guides.get(params.guideName);
+        if (!guide) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Guide "${params.guideName}" not found. Use the list-guides tool to see available guides.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const sections = [`# ${guide.title}`, '', `> ${guide.description}`, '', guide.content];
+        return {
+            content: [{ type: 'text', text: sections.join('\n') }],
+        };
+    });
+}
+//# sourceMappingURL=registerGetGuideTool.js.map

package/src/tools/registerGetMappingPatternTool.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Registers the get-mapping-pattern tool on the MCP server.
+ */
+export declare function registerGetMappingPatternTool(server: McpServer): void;

package/src/tools/registerGetMappingPatternTool.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerGetMappingPatternTool = registerGetMappingPatternTool;
+const zod_1 = require("zod");
+const mappingPattern_1 = require("../knowledge/mappingPattern");
+/**
+ * Registers the get-mapping-pattern tool on the MCP server.
+ */
+function registerGetMappingPatternTool(server) {
+    server.tool('get-mapping-pattern', 'Returns the Archipel mapping pattern — branded type-safe mapping keys, MappingProfileBase, MappingService, and MappingModule registration. Optionally tailored to a specific entity and response class.', {
+        entityName: zod_1.z
+            .string()
+            .optional()
+            .describe('Entity name (e.g. "Product", "User"). If provided, generates tailored mapping scaffold.'),
+        fields: zod_1.z
+            .array(zod_1.z.string())
+            .optional()
+            .describe('Field names of the entity (e.g. ["id", "name", "barcode", "createdAt"]).'),
+        responseName: zod_1.z
+            .string()
+            .optional()
+            .describe('Response class name (e.g. "ProductResponse"). Defaults to "{entityName}Response".'),
+    }, async (params) => {
+        let content = mappingPattern_1.MAPPING_PATTERN_KNOWLEDGE;
+        if (params.entityName && params.fields && params.fields.length > 0) {
+            const responseName = params.responseName || `${params.entityName}Response`;
+            content += '\n\n' + (0, mappingPattern_1.MAPPING_PATTERN_WITH_CONTEXT)(params.entityName, params.fields, responseName);
+        }
+        return {
+            content: [{ type: 'text', text: content }],
+        };
+    });
+}
+//# sourceMappingURL=registerGetMappingPatternTool.js.map

package/src/tools/registerGetModulePatternTool.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Registers the get-module-pattern tool on the MCP server.
+ */
+export declare function registerGetModulePatternTool(server: McpServer): void;

package/src/tools/registerGetModulePatternTool.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerGetModulePatternTool = registerGetModulePatternTool;
+const zod_1 = require("zod");
+const modulePattern_1 = require("../knowledge/modulePattern");
+/**
+ * Registers the get-module-pattern tool on the MCP server.
+ */
+function registerGetModulePatternTool(server) {
+    server.tool('get-module-pattern', 'Returns the Archipel NestJS dynamic module pattern — register(), port/adapter injection, ConfigModule integration. Optionally tailored with module name and port definitions.', {
+        moduleName: zod_1.z
+            .string()
+            .optional()
+            .describe('Module name (e.g. "NotificationModule"). If provided, generates a complete module scaffold.'),
+        ports: zod_1.z
+            .array(zod_1.z.string())
+            .optional()
+            .describe('Port class names (e.g. ["NotificationPort", "TemplatePort"]). Abstract port classes for dependency inversion.'),
+    }, async (params) => {
+        let content = modulePattern_1.MODULE_PATTERN_KNOWLEDGE;
+        if (params.moduleName && params.ports && params.ports.length > 0) {
+            content += '\n\n' + (0, modulePattern_1.MODULE_PATTERN_WITH_CONTEXT)(params.moduleName, params.ports);
+        }
+        return {
+            content: [{ type: 'text', text: content }],
+        };
+    });
+}
+//# sourceMappingURL=registerGetModulePatternTool.js.map

package/src/tools/registerGetPackageDocTool.d.ts

@@ -0,0 +1,6 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { DocsLoader } from '../DocsLoader';
+/**
+ * Registers the get-package-doc tool on the MCP server.
+ */
+export declare function registerGetPackageDocTool(server: McpServer, docsLoader: DocsLoader): void;

package/src/tools/registerGetPackageDocTool.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerGetPackageDocTool = registerGetPackageDocTool;
+const zod_1 = require("zod");
+/**
+ * Registers the get-package-doc tool on the MCP server.
+ */
+function registerGetPackageDocTool(server, docsLoader) {
+    server.tool('get-package-doc', 'Gets the full documentation (overview + API reference) for a specific Archipel platform package.', {
+        packageName: zod_1.z.string().describe('The package directory name (e.g. "platform-core", "platform-database").'),
+    }, async (params) => {
+        const packageDoc = docsLoader.packages.get(params.packageName);
+        if (!packageDoc) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Package "${params.packageName}" not found. Use the list-packages tool to see available packages.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const sections = [
+            `# ${packageDoc.title}`,
+            '',
+            `> ${packageDoc.description}`,
+            '',
+            `**Package:** \`${packageDoc.packageScope}\``,
+        ];
+        if (packageDoc.tags.length > 0) {
+            sections.push(`**Tags:** ${packageDoc.tags.join(', ')}`);
+        }
+        sections.push('', packageDoc.content);
+        if (packageDoc.apiContent) {
+            sections.push('', '---', '', '## API Reference', '', packageDoc.apiContent);
+        }
+        return {
+            content: [{ type: 'text', text: sections.join('\n') }],
+        };
+    });
+}
+//# sourceMappingURL=registerGetPackageDocTool.js.map

package/src/tools/registerGetQueryPatternTool.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Registers the get-query-pattern tool on the MCP server.
+ */
+export declare function registerGetQueryPatternTool(server: McpServer): void;

package/src/tools/registerGetQueryPatternTool.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerGetQueryPatternTool = registerGetQueryPatternTool;
+const zod_1 = require("zod");
+const queryPattern_1 = require("../knowledge/queryPattern");
+/**
+ * Registers the get-query-pattern tool on the MCP server.
+ */
+function registerGetQueryPatternTool(server) {
+    server.tool('get-query-pattern', 'Returns the Archipel query pattern documentation — interfaces, factories, rules, and examples. Optionally tailored to a specific Prisma model.', {
+        modelName: zod_1.z
+            .string()
+            .optional()
+            .describe('Prisma model name (e.g. "User", "Order"). If provided, generates model-specific examples.'),
+        fields: zod_1.z
+            .array(zod_1.z.string())
+            .optional()
+            .describe('Field names of the model (e.g. ["id", "email", "name", "createdAt"]). Used with modelName for tailored examples.'),
+    }, async (params) => {
+        let content = queryPattern_1.QUERY_PATTERN_KNOWLEDGE;
+        if (params.modelName && params.fields && params.fields.length > 0) {
+            content += '\n\n' + (0, queryPattern_1.QUERY_PATTERN_WITH_MODEL)(params.modelName, params.fields);
+        }
+        return {
+            content: [{ type: 'text', text: content }],
+        };
+    });
+}
+//# sourceMappingURL=registerGetQueryPatternTool.js.map

package/src/tools/registerGetRepositoryPatternTool.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Registers the get-repository-pattern tool on the MCP server.
+ */
+export declare function registerGetRepositoryPatternTool(server: McpServer): void;

package/src/tools/registerGetRepositoryPatternTool.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerGetRepositoryPatternTool = registerGetRepositoryPatternTool;
+const zod_1 = require("zod");
+const repositoryPattern_1 = require("../knowledge/repositoryPattern");
+/**
+ * Registers the get-repository-pattern tool on the MCP server.
+ */
+function registerGetRepositoryPatternTool(server) {
+    server.tool('get-repository-pattern', 'Returns the Archipel repository class pattern — how to create a RepositoryBase subclass with correct generics, module registration, and service injection. Optionally tailored to a specific Prisma model.', {
+        modelName: zod_1.z
+            .string()
+            .optional()
+            .describe('Prisma model name (e.g. "User", "Order"). If provided, generates a complete repository scaffold.'),
+        fields: zod_1.z
+            .array(zod_1.z.string())
+            .optional()
+            .describe('Field names of the model (e.g. ["id", "email", "name", "createdAt"]). Used with modelName for tailored examples.'),
+    }, async (params) => {
+        let content = repositoryPattern_1.REPOSITORY_PATTERN_KNOWLEDGE;
+        if (params.modelName && params.fields && params.fields.length > 0) {
+            content += '\n\n' + (0, repositoryPattern_1.REPOSITORY_PATTERN_WITH_MODEL)(params.modelName, params.fields);
+        }
+        return {
+            content: [{ type: 'text', text: content }],
+        };
+    });
+}
+//# sourceMappingURL=registerGetRepositoryPatternTool.js.map

package/src/tools/registerGetTestingPatternTool.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Registers the get-testing-pattern tool on the MCP server.
+ */
+export declare function registerGetTestingPatternTool(server: McpServer): void;

package/src/tools/registerGetTestingPatternTool.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerGetTestingPatternTool = registerGetTestingPatternTool;
+const testingPattern_1 = require("../knowledge/testingPattern");
+/**
+ * Registers the get-testing-pattern tool on the MCP server.
+ */
+function registerGetTestingPatternTool(server) {
+    server.tool('get-testing-pattern', 'Returns the Archipel testing pattern — Vitest conventions, mocking patterns for repositories/services/delegates, AAA structure, and test naming conventions.', {}, async () => {
+        return {
+            content: [{ type: 'text', text: testingPattern_1.TESTING_PATTERN_KNOWLEDGE }],
+        };
+    });
+}
+//# sourceMappingURL=registerGetTestingPatternTool.js.map