@breadstone/archipel-mcp 0.0.9 → 0.0.11

package/data/packages/platform-telemetry/api/Interface.ITelemetryTracesOptions.md

@@ -3,7 +3,6 @@ title: 'Interface: ITelemetryTracesOptions'
 generated: true
 editUrl: false
 ---
-
 # Interface: ITelemetryTracesOptions
 
 Defined in: [options/TelemetryOptions.ts:3](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/options/TelemetryOptions.ts#L3)
@@ -18,7 +17,7 @@ enabled: boolean;
 
 Defined in: [options/TelemetryOptions.ts:4](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/options/TelemetryOptions.ts#L4)
 
----
+***
 
 ### exporter?
 
@@ -28,7 +27,7 @@ optional exporter?: "otlp-http" | "console";
 
 Defined in: [options/TelemetryOptions.ts:6](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/options/TelemetryOptions.ts#L6)
 
----
+***
 
 ### samplingRatio?
 

package/data/packages/platform-telemetry/api/Variable.TELEMETRY_ENABLED.md

@@ -3,8 +3,7 @@ title: 'Variable: TELEMETRY\_ENABLED'
 generated: true
 editUrl: false
 ---
-
-# Variable: TELEMETRY_ENABLED
+# Variable: TELEMETRY\_ENABLED
 
 ```ts
 const TELEMETRY_ENABLED: typeof TELEMETRY_ENABLED;

package/data/packages/platform-telemetry/api/Variable.TELEMETRY_FACADE.md

@@ -3,8 +3,7 @@ title: 'Variable: TELEMETRY\_FACADE'
 generated: true
 editUrl: false
 ---
-
-# Variable: TELEMETRY_FACADE
+# Variable: TELEMETRY\_FACADE
 
 ```ts
 const TELEMETRY_FACADE: typeof TELEMETRY_FACADE;

package/data/packages/platform-telemetry/api/Variable.TELEMETRY_OPTIONS.md

@@ -3,8 +3,7 @@ title: 'Variable: TELEMETRY\_OPTIONS'
 generated: true
 editUrl: false
 ---
-
-# Variable: TELEMETRY_OPTIONS
+# Variable: TELEMETRY\_OPTIONS
 
 ```ts
 const TELEMETRY_OPTIONS: typeof TELEMETRY_OPTIONS;

package/data/packages/platform-telemetry/api/Variable.TELEMETRY_SHUTDOWN.md

@@ -3,8 +3,7 @@ title: 'Variable: TELEMETRY\_SHUTDOWN'
 generated: true
 editUrl: false
 ---
-
-# Variable: TELEMETRY_SHUTDOWN
+# Variable: TELEMETRY\_SHUTDOWN
 
 ```ts
 const TELEMETRY_SHUTDOWN: typeof TELEMETRY_SHUTDOWN;

package/data/packages/platform-telemetry/api/Variable.defaultTelemetryOptions.md

@@ -3,7 +3,6 @@ title: 'Variable: defaultTelemetryOptions'
 generated: true
 editUrl: false
 ---
-
 # Variable: defaultTelemetryOptions
 
 ```ts

package/data/packages/platform-telemetry/api/index.md

@@ -3,35 +3,34 @@ title: '@breadstone/archipel-platform-telemetry'
 generated: true
 editUrl: false
 ---
-
 # @breadstone/archipel-platform-telemetry
 
 ## Classes
 
-| Class                                                                | Description                                                                                                                        |
-| -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
-| [NoopTelemetryFacade](Class.NoopTelemetryFacade)                     | -                                                                                                                                  |
+| Class | Description |
+| ------ | ------ |
+| [NoopTelemetryFacade](Class.NoopTelemetryFacade) | - |
 | [TelemetryCacheMetricsRecorder](Class.TelemetryCacheMetricsRecorder) | Generic cache metrics recorder that forwards cache lifecycle events into the telemetry facade (which may be a noop when disabled). |
-| [TelemetryFacade](Class.TelemetryFacade)                             | -                                                                                                                                  |
-| [TelemetryLoggerService](Class.TelemetryLoggerService)               | -                                                                                                                                  |
-| [TelemetryModule](Class.TelemetryModule)                             | -                                                                                                                                  |
-| [TelemetryRuleEngine](Class.TelemetryRuleEngine)                     | -                                                                                                                                  |
+| [TelemetryFacade](Class.TelemetryFacade) | - |
+| [TelemetryLoggerService](Class.TelemetryLoggerService) | - |
+| [TelemetryModule](Class.TelemetryModule) | - |
+| [TelemetryRuleEngine](Class.TelemetryRuleEngine) | - |
 
 ## Interfaces
 
-| Interface                                                      | Description |
-| -------------------------------------------------------------- | ----------- |
-| [ITelemetryFacade](Interface.ITelemetryFacade)                 | -           |
-| [ITelemetryMetricsOptions](Interface.ITelemetryMetricsOptions) | -           |
-| [ITelemetryOptions](Interface.ITelemetryOptions)               | -           |
-| [ITelemetryTracesOptions](Interface.ITelemetryTracesOptions)   | -           |
+| Interface | Description |
+| ------ | ------ |
+| [ITelemetryFacade](Interface.ITelemetryFacade) | - |
+| [ITelemetryMetricsOptions](Interface.ITelemetryMetricsOptions) | - |
+| [ITelemetryOptions](Interface.ITelemetryOptions) | - |
+| [ITelemetryTracesOptions](Interface.ITelemetryTracesOptions) | - |
 
 ## Variables
 
-| Variable                                                    | Description |
-| ----------------------------------------------------------- | ----------- |
-| [defaultTelemetryOptions](Variable.defaultTelemetryOptions) | -           |
-| [TELEMETRY_ENABLED](Variable.TELEMETRY_ENABLED)             | -           |
-| [TELEMETRY_FACADE](Variable.TELEMETRY_FACADE)               | -           |
-| [TELEMETRY_OPTIONS](Variable.TELEMETRY_OPTIONS)             | -           |
-| [TELEMETRY_SHUTDOWN](Variable.TELEMETRY_SHUTDOWN)           | -           |
+| Variable | Description |
+| ------ | ------ |
+| [defaultTelemetryOptions](Variable.defaultTelemetryOptions) | - |
+| [TELEMETRY\_ENABLED](Variable.TELEMETRY_ENABLED) | - |
+| [TELEMETRY\_FACADE](Variable.TELEMETRY_FACADE) | - |
+| [TELEMETRY\_OPTIONS](Variable.TELEMETRY_OPTIONS) | - |
+| [TELEMETRY\_SHUTDOWN](Variable.TELEMETRY_SHUTDOWN) | - |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@breadstone/archipel-mcp",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "description": "MCP server providing Archipel platform knowledge — documentation, query patterns, and coding conventions — to AI development tools.",
   "type": "commonjs",
   "main": "./src/main.js",

package/src/GuidesLoader.d.ts

@@ -0,0 +1,13 @@
+import type { IGuideDoc } from './models/IGuideDoc';
+/**
+ * Loads and indexes Archipel platform guides from the `.docs/guides/`
+ * directory (monorepo dev) or from the bundled `data/guides/` directory
+ * (published npm package).
+ */
+export declare class GuidesLoader {
+    private readonly _guides;
+    get guides(): ReadonlyMap<string, IGuideDoc>;
+    load(): void;
+    search(query: string): IGuideDoc[];
+    private resolveGuidesDirectory;
+}

package/src/GuidesLoader.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GuidesLoader = void 0;
+const tslib_1 = require("tslib");
+const gray_matter_1 = tslib_1.__importDefault(require("gray-matter"));
+const fs = tslib_1.__importStar(require("node:fs"));
+const path = tslib_1.__importStar(require("node:path"));
+/**
+ * Loads and indexes Archipel platform guides from the `.docs/guides/`
+ * directory (monorepo dev) or from the bundled `data/guides/` directory
+ * (published npm package).
+ */
+class GuidesLoader {
+    constructor() {
+        // #region Fields
+        this._guides = new Map();
+        // #endregion
+    }
+    // #endregion
+    // #region Properties
+    get guides() {
+        return this._guides;
+    }
+    // #endregion
+    // #region Methods
+    load() {
+        const guidesDirectory = this.resolveGuidesDirectory();
+        if (!guidesDirectory) {
+            process.stderr.write('[archipel-mcp] Warning: Could not locate guides directory.\n');
+            return;
+        }
+        const files = fs.readdirSync(guidesDirectory).filter((file) => file.endsWith('.md') && file !== 'index.md');
+        for (const file of files) {
+            const filePath = path.join(guidesDirectory, file);
+            const raw = fs.readFileSync(filePath, 'utf-8');
+            const parsed = (0, gray_matter_1.default)(raw);
+            const name = path.basename(file, '.md');
+            this._guides.set(name, {
+                name,
+                title: parsed.data['title'] || name,
+                description: parsed.data['description'] || '',
+                order: parsed.data['order'] || 999,
+                content: parsed.content.trim(),
+            });
+        }
+        process.stderr.write(`[archipel-mcp] Loaded ${this._guides.size} guide(s)\n`);
+    }
+    search(query) {
+        const lowerQuery = query.toLowerCase();
+        const results = [];
+        for (const guide of this._guides.values()) {
+            if (guide.name.toLowerCase().includes(lowerQuery) ||
+                guide.title.toLowerCase().includes(lowerQuery) ||
+                guide.description.toLowerCase().includes(lowerQuery) ||
+                guide.content.toLowerCase().includes(lowerQuery)) {
+                results.push(guide);
+            }
+        }
+        return results.sort((a, b) => a.order - b.order);
+    }
+    resolveGuidesDirectory() {
+        // 1. Bundled data (published npm package)
+        const bundledPath = path.resolve(__dirname, '..', 'data', 'guides');
+        if (fs.existsSync(bundledPath)) {
+            return bundledPath;
+        }
+        // 2. Workspace root (monorepo dev)
+        const cwdPath = path.resolve(process.cwd(), '.docs', 'guides');
+        if (fs.existsSync(cwdPath)) {
+            return cwdPath;
+        }
+        // 3. Relative from compiled source (dist/tools/mcp/src/)
+        const relativePath = path.resolve(__dirname, '..', '..', '..', '..', '.docs', 'guides');
+        if (fs.existsSync(relativePath)) {
+            return relativePath;
+        }
+        return null;
+    }
+}
+exports.GuidesLoader = GuidesLoader;
+//# sourceMappingURL=GuidesLoader.js.map

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;