@breadstone/archipel-mcp 0.0.9 → 0.0.11

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

package/src/tools/registerListGuidesTool.d.ts

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

package/src/tools/registerListGuidesTool.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerListGuidesTool = registerListGuidesTool;
+/**
+ * Registers the list-guides tool on the MCP server.
+ */
+function registerListGuidesTool(server, guidesLoader) {
+    server.tool('list-guides', 'Lists all available Archipel platform guides with their titles, descriptions, and sort order.', {}, async () => {
+        const guides = Array.from(guidesLoader.guides.values())
+            .sort((a, b) => a.order - b.order)
+            .map((guide) => ({
+            name: guide.name,
+            title: guide.title,
+            description: guide.description,
+            order: guide.order,
+        }));
+        return {
+            content: [{ type: 'text', text: JSON.stringify(guides, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=registerListGuidesTool.js.map

package/src/tools/registerListPackagesTool.d.ts

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

package/src/tools/registerListPackagesTool.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerListPackagesTool = registerListPackagesTool;
+/**
+ * Registers the list-packages tool on the MCP server.
+ */
+function registerListPackagesTool(server, docsLoader) {
+    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) }],
+        };
+    });
+}
+//# sourceMappingURL=registerListPackagesTool.js.map

package/src/tools/registerSearchDocsTool.d.ts

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

package/src/tools/registerSearchDocsTool.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSearchDocsTool = registerSearchDocsTool;
+const zod_1 = require("zod");
+/**
+ * Registers the search-docs tool on the MCP server.
+ */
+function registerSearchDocsTool(server, docsLoader) {
+    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}` },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=registerSearchDocsTool.js.map

package/src/tools/registerSearchGuidesTool.d.ts

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

package/src/tools/registerSearchGuidesTool.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSearchGuidesTool = registerSearchGuidesTool;
+const zod_1 = require("zod");
+/**
+ * Registers the search-guides tool on the MCP server.
+ */
+function registerSearchGuidesTool(server, guidesLoader) {
+    server.tool('search-guides', 'Searches across all Archipel platform guides by keyword or phrase.', {
+        query: zod_1.z.string().describe('The search query to match against guide names, titles, descriptions, and content.'),
+    }, async (params) => {
+        const results = guidesLoader.search(params.query);
+        if (results.length === 0) {
+            return {
+                content: [{ type: 'text', text: `No guides found matching: "${params.query}"` }],
+            };
+        }
+        const summary = results
+            .map((guide) => [`## ${guide.title}`, '', guide.description, '', guide.content].join('\n'))
+            .join('\n\n---\n\n');
+        return {
+            content: [
+                { type: 'text', text: `Found ${results.length} guide(s) for "${params.query}":\n\n${summary}` },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=registerSearchGuidesTool.js.map