@breadstone/archipel-mcp 0.0.21 → 0.0.22

package/src/generators/modulePatternGenerator.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MODULE_PATTERN_WITH_CONTEXT = MODULE_PATTERN_WITH_CONTEXT;
+/**
+ * Generates a dynamic NestJS module example with ports, options interface,
+ * module class, and consumer registration for the given module and port names.
+ */
+function MODULE_PATTERN_WITH_CONTEXT(moduleName, ports) {
+    return `
+## Example: Dynamic Module "${moduleName}"
+
+With ports: ${ports.map((p) => `\`${p}\``).join(', ')}
+
+### Port Definitions
+
+${ports
+        .map((port) => `\`\`\`typescript
+// contracts/${port}.ts
+
+export abstract class ${port} {
+
+  // Define abstract methods for the port contract
+  public abstract execute(/* args */): Promise<void>;
+
+}
+\`\`\``)
+        .join('\n\n')}
+
+### Options Interface
+
+\`\`\`typescript
+// interfaces/I${moduleName}Options.ts
+import { Type } from '@nestjs/common';
+${ports.map((port) => `import { ${port} } from '../contracts/${port}';`).join('\n')}
+
+export interface I${moduleName}Options {
+${ports.map((port) => `  ${lowerFirstChar(port)}: Type<${port}>;`).join('\n')}
+  isGlobal?: boolean;
+}
+\`\`\`
+
+### Module Class
+
+\`\`\`typescript
+// ${moduleName}.ts
+import { ConfigModule } from '@breadstone/archipel-platform-core';
+import { type DynamicModule, Module, type Type } from '@nestjs/common';
+import { I${moduleName}Options } from './interfaces/I${moduleName}Options';
+${ports.map((port) => `import { ${port} } from './contracts/${port}';`).join('\n')}
+
+@Module({})
+export class ${moduleName} {
+
+  public static register(options: I${moduleName}Options): DynamicModule {
+    const portProviders = [
+${ports.map((port) => `      { provide: ${port}, useClass: options.${lowerFirstChar(port)} },`).join('\n')}
+    ];
+
+    return {
+      global: options.isGlobal ?? false,
+      module: ${moduleName},
+      imports: [
+        ConfigModule.register('${toKebabCase(moduleName)}', PLATFORM_${toUpperSnakeCase(moduleName)}_CONFIG_ENTRIES),
+      ],
+      providers: [
+        ...portProviders,
+        // Add services, guards, interceptors here
+      ],
+      exports: [
+        // Export public services, guards, interceptors
+      ],
+    };
+  }
+
+}
+\`\`\`
+
+### Consumer Usage
+
+\`\`\`typescript
+@Module({
+  imports: [
+    ${moduleName}.register({
+${ports.map((port) => `      ${lowerFirstChar(port)}: My${port}Adapter,`).join('\n')}
+    }),
+  ],
+})
+export class AppModule {}
+\`\`\`
+`;
+}
+function lowerFirstChar(str) {
+    return str.charAt(0).toLowerCase() + str.slice(1);
+}
+function toKebabCase(name) {
+    return name
+        .replace(/([a-z])([A-Z])/g, '$1-$2')
+        .toLowerCase()
+        .replace(/module$/, '');
+}
+function toUpperSnakeCase(name) {
+    return name
+        .replace(/([a-z])([A-Z])/g, '$1_$2')
+        .toUpperCase()
+        .replace(/MODULE$/, '');
+}
+//# sourceMappingURL=modulePatternGenerator.js.map

package/src/generators/queryPatternGenerator.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Generates model-specific query factory examples based on a Prisma model name and its fields.
+ */
+export declare function QUERY_PATTERN_WITH_MODEL(modelName: string, fields: string[]): string;

package/src/generators/queryPatternGenerator.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QUERY_PATTERN_WITH_MODEL = QUERY_PATTERN_WITH_MODEL;
+/**
+ * Generates model-specific query factory examples based on a Prisma model name and its fields.
+ */
+function QUERY_PATTERN_WITH_MODEL(modelName, fields) {
+    return `
+## Example: Queries for "${modelName}"
+
+Given a Prisma model \`${modelName}\` with fields: ${fields.map((f) => `\`${f}\``).join(', ')}
+
+### findFirst query
+\`\`\`typescript
+import { Prisma } from '@prisma/client';
+import { query } from '@breadstone/archipel-platform-database';
+
+export function find${modelName}ByIdQuery(id: string) {
+  return query<Prisma.${modelName}Delegate, { ${fields.map((f) => `${f}: ${inferFieldType(f)}`).join('; ')} } | null>(
+    'find${modelName}ById',
+    (model) =>
+      model.findFirst({
+        where: { id },
+        select: { ${fields.map((f) => `${f}: true`).join(', ')} },
+      }),
+  );
+}
+\`\`\`
+
+### findMany query
+\`\`\`typescript
+export function findAll${modelName}sQuery(skip = 0, take = 20) {
+  return query<Prisma.${modelName}Delegate, Array<{ ${fields.map((f) => `${f}: ${inferFieldType(f)}`).join('; ')} }>>(
+    'findAll${modelName}s',
+    (model) =>
+      model.findMany({
+        skip,
+        take,
+        select: { ${fields.map((f) => `${f}: true`).join(', ')} },
+        orderBy: { ${fields.includes('createdAt') ? 'createdAt' : fields[0]}: 'desc' },
+      }),
+  );
+}
+\`\`\`
+
+### count query
+\`\`\`typescript
+export function count${modelName}sQuery() {
+  return query<Prisma.${modelName}Delegate, number>(
+    'count${modelName}s',
+    (model) => model.count(),
+  );
+}
+\`\`\`
+
+### Service usage
+\`\`\`typescript
+// In a service method:
+const item = await this._${lowerFirst(modelName)}Repository.execute(find${modelName}ByIdQuery(id));
+const items = await this._${lowerFirst(modelName)}Repository.execute(findAll${modelName}sQuery(0, 50));
+const total = await this._${lowerFirst(modelName)}Repository.execute(count${modelName}sQuery());
+\`\`\`
+`;
+}
+function inferFieldType(fieldName) {
+    if (fieldName === 'id')
+        return 'string';
+    if (fieldName.endsWith('Id'))
+        return 'string';
+    if (fieldName.endsWith('At') || fieldName === 'createdAt' || fieldName === 'updatedAt')
+        return 'Date';
+    if (fieldName.startsWith('is') || fieldName.startsWith('has'))
+        return 'boolean';
+    if (fieldName === 'count' || fieldName === 'quantity' || fieldName === 'amount' || fieldName === 'order')
+        return 'number';
+    if (fieldName === 'email' || fieldName === 'name' || fieldName === 'title' || fieldName === 'description')
+        return 'string';
+    return 'unknown';
+}
+function lowerFirst(str) {
+    return str.charAt(0).toLowerCase() + str.slice(1);
+}
+//# sourceMappingURL=queryPatternGenerator.js.map

package/src/generators/repositoryPatternGenerator.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Generates a full repository class, entity interface, query factories, module
+ * registration, and service usage example for a given Prisma model.
+ */
+export declare function REPOSITORY_PATTERN_WITH_MODEL(modelName: string, fields: string[]): string;

package/src/generators/repositoryPatternGenerator.js

@@ -0,0 +1,165 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REPOSITORY_PATTERN_WITH_MODEL = REPOSITORY_PATTERN_WITH_MODEL;
+/**
+ * Generates a full repository class, entity interface, query factories, module
+ * registration, and service usage example for a given Prisma model.
+ */
+function REPOSITORY_PATTERN_WITH_MODEL(modelName, fields) {
+    return `
+## Example: Repository for "${modelName}"
+
+Given a Prisma model \`${modelName}\` with fields: ${fields.map((f) => `\`${f}\``).join(', ')}
+
+### Repository Class
+
+\`\`\`typescript
+// repositories/${modelName}Repository.ts
+import { Injectable } from '@nestjs/common';
+import { Prisma } from '@prisma/client';
+import {
+  DatabaseService,
+  DelegateArgs,
+  DelegateReturnTypes,
+  RepositoryBase,
+} from '@breadstone/archipel-platform-database';
+import { I${modelName}Entity } from '../models/entities/I${modelName}Entity';
+
+@Injectable()
+export class ${modelName}Repository extends RepositoryBase<
+  Prisma.${modelName}Delegate,
+  DelegateArgs<Prisma.${modelName}Delegate>,
+  DelegateReturnTypes<Prisma.${modelName}Delegate>,
+  I${modelName}Entity
+> {
+
+  // #region Ctor
+
+  public constructor(db: DatabaseService) {
+    super(db, db.client.${lowerFirst(modelName)});
+  }
+
+  // #endregion
+
+}
+\`\`\`
+
+### Entity Interface
+
+\`\`\`typescript
+// models/entities/I${modelName}Entity.ts
+export interface I${modelName}Entity {
+${fields.map((f) => `  readonly ${f}: ${inferFieldType(f)};`).join('\n')}
+}
+\`\`\`
+
+### Query Factories
+
+\`\`\`typescript
+// queries/find${modelName}ByIdQuery.ts
+import { Prisma } from '@prisma/client';
+import { query } from '@breadstone/archipel-platform-database';
+import { I${modelName}Entity } from '../models/entities/I${modelName}Entity';
+
+export function find${modelName}ByIdQuery(id: string) {
+  return query<Prisma.${modelName}Delegate, I${modelName}Entity | null>(
+    'find${modelName}ById',
+    (model) => model.findFirst({
+      where: { id },
+      select: { ${fields.map((f) => `${f}: true`).join(', ')} },
+    }),
+  );
+}
+
+export function findAll${modelName}sQuery(skip = 0, take = 20) {
+  return query<Prisma.${modelName}Delegate, I${modelName}Entity[]>(
+    'findAll${modelName}s',
+    (model) => model.findMany({
+      skip,
+      take,
+      select: { ${fields.map((f) => `${f}: true`).join(', ')} },
+      orderBy: { ${fields.includes('createdAt') ? 'createdAt' : fields[0]}: 'desc' },
+    }),
+  );
+}
+
+export function count${modelName}sQuery() {
+  return query<Prisma.${modelName}Delegate, number>(
+    'count${modelName}s',
+    (model) => model.count(),
+  );
+}
+\`\`\`
+
+### Module Registration
+
+\`\`\`typescript
+import { DatabaseModule } from '@breadstone/archipel-platform-database';
+import { ${modelName}Repository } from './repositories/${modelName}Repository';
+import { ${modelName}Service } from './services/${modelName}Service';
+
+@Module({
+  imports: [DatabaseModule.register()],
+  providers: [${modelName}Repository, ${modelName}Service],
+  exports: [${modelName}Service],
+})
+export class ${modelName}Module {}
+\`\`\`
+
+### Service Usage
+
+\`\`\`typescript
+@Injectable()
+export class ${modelName}Service {
+
+  // #region Fields
+
+  private readonly _${lowerFirst(modelName)}Repository: ${modelName}Repository;
+
+  // #endregion
+
+  // #region Ctor
+
+  public constructor(${lowerFirst(modelName)}Repository: ${modelName}Repository) {
+    this._${lowerFirst(modelName)}Repository = ${lowerFirst(modelName)}Repository;
+  }
+
+  // #endregion
+
+  // #region Methods
+
+  public async findById(id: string): Promise<I${modelName}Entity | null> {
+    return this._${lowerFirst(modelName)}Repository.execute(find${modelName}ByIdQuery(id));
+  }
+
+  public async findAll(skip = 0, take = 20): Promise<I${modelName}Entity[]> {
+    return this._${lowerFirst(modelName)}Repository.execute(findAll${modelName}sQuery(skip, take));
+  }
+
+  public async count(): Promise<number> {
+    return this._${lowerFirst(modelName)}Repository.execute(count${modelName}sQuery());
+  }
+
+  // #endregion
+
+}
+\`\`\`
+`;
+}
+function inferFieldType(fieldName) {
+    if (fieldName === 'id')
+        return 'string';
+    if (fieldName.endsWith('Id'))
+        return 'string';
+    if (fieldName.endsWith('At') || fieldName === 'createdAt' || fieldName === 'updatedAt')
+        return 'Date';
+    if (fieldName.startsWith('is') || fieldName.startsWith('has'))
+        return 'boolean';
+    if (fieldName === 'count' || fieldName === 'quantity' || fieldName === 'amount' || fieldName === 'price')
+        return 'number';
+    return 'string';
+}
+function lowerFirst(str) {
+    return str.charAt(0).toLowerCase() + str.slice(1);
+}
+//# sourceMappingURL=repositoryPatternGenerator.js.map

package/src/main.js

@@ -5,6 +5,7 @@ const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
 const DocsLoader_1 = require("./DocsLoader");
 const GuidesLoader_1 = require("./GuidesLoader");
+const PatternsLoader_1 = require("./PatternsLoader");
 const registerGetConfigPatternTool_1 = require("./tools/registerGetConfigPatternTool");
 const registerGetDtoPatternTool_1 = require("./tools/registerGetDtoPatternTool");
 const registerGetErrorHandlingPatternTool_1 = require("./tools/registerGetErrorHandlingPatternTool");
@@ -30,6 +31,8 @@ async function main() {
     docsLoader.load();
     const guidesLoader = new GuidesLoader_1.GuidesLoader();
     guidesLoader.load();
+    const patternsLoader = new PatternsLoader_1.PatternsLoader();
+    patternsLoader.load();
     const server = new mcp_js_1.McpServer({
         name: SERVER_NAME,
         description: 'MCP server for Archipel platform documentation, guides, and knowledge base.',
@@ -37,21 +40,24 @@ async function main() {
         websiteUrl: 'https://archipel.breadstone.de/',
         version: SERVER_VERSION,
     });
+    // docs tools
     (0, registerListPackagesTool_1.registerListPackagesTool)(server, docsLoader);
     (0, registerGetPackageDocTool_1.registerGetPackageDocTool)(server, docsLoader);
     (0, registerSearchDocsTool_1.registerSearchDocsTool)(server, docsLoader);
+    // guides tools
     (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);
+    // pattern tools
+    (0, registerGetQueryPatternTool_1.registerGetQueryPatternTool)(server, patternsLoader);
+    (0, registerGetRepositoryPatternTool_1.registerGetRepositoryPatternTool)(server, patternsLoader);
+    (0, registerGetMappingPatternTool_1.registerGetMappingPatternTool)(server, patternsLoader);
+    (0, registerGetModulePatternTool_1.registerGetModulePatternTool)(server, patternsLoader);
+    (0, registerGetErrorHandlingPatternTool_1.registerGetErrorHandlingPatternTool)(server, patternsLoader);
+    (0, registerGetConfigPatternTool_1.registerGetConfigPatternTool)(server, patternsLoader);
+    (0, registerGetGuardPatternTool_1.registerGetGuardPatternTool)(server, patternsLoader);
+    (0, registerGetDtoPatternTool_1.registerGetDtoPatternTool)(server, patternsLoader);
+    (0, registerGetTestingPatternTool_1.registerGetTestingPatternTool)(server, patternsLoader);
     const transport = new stdio_js_1.StdioServerTransport();
     await server.connect(transport);
     process.stderr.write(`[${SERVER_NAME}] Server running on stdio\n`);

package/src/models/IPatternDoc.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Describes a loaded pattern documentation entry.
+ */
+export interface IPatternDoc {
+    /** File name without extension (e.g. "config-pattern"). */
+    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/IPatternDoc.js

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

package/src/tools/registerGetConfigPatternTool.d.ts

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

package/src/tools/registerGetConfigPatternTool.js

@@ -1,14 +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) {
+function registerGetConfigPatternTool(server, patternsLoader) {
     server.tool('get-config-pattern', 'Returns the Archipel configuration pattern — typed config keys (createConfigKey), ConfigRegistry, ConfigService, env.ts conventions, and ConfigModule integration.', {}, async () => {
+        const pattern = patternsLoader.patterns.get('config-pattern');
+        const text = pattern?.content ?? 'Config pattern documentation not available.';
         return {
-            content: [{ type: 'text', text: configPattern_1.CONFIG_PATTERN_KNOWLEDGE }],
+            content: [{ type: 'text', text }],
         };
     });
 }

package/src/tools/registerGetDtoPatternTool.d.ts

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

package/src/tools/registerGetDtoPatternTool.js

@@ -1,14 +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) {
+function registerGetDtoPatternTool(server, patternsLoader) {
     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 () => {
+        const pattern = patternsLoader.patterns.get('dto-pattern');
+        const text = pattern?.content ?? 'DTO pattern documentation not available.';
         return {
-            content: [{ type: 'text', text: dtoPattern_1.DTO_PATTERN_KNOWLEDGE }],
+            content: [{ type: 'text', text }],
         };
     });
 }

package/src/tools/registerGetErrorHandlingPatternTool.d.ts

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

package/src/tools/registerGetErrorHandlingPatternTool.js

@@ -1,14 +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) {
+function registerGetErrorHandlingPatternTool(server, patternsLoader) {
     server.tool('get-error-handling-pattern', 'Returns the Archipel error handling pattern — domain errors, RepositoryError, exception filters, and structured error response envelopes.', {}, async () => {
+        const pattern = patternsLoader.patterns.get('error-handling-pattern');
+        const text = pattern?.content ?? 'Error handling pattern documentation not available.';
         return {
-            content: [{ type: 'text', text: errorHandlingPattern_1.ERROR_HANDLING_PATTERN_KNOWLEDGE }],
+            content: [{ type: 'text', text }],
         };
     });
 }

package/src/tools/registerGetGuardPatternTool.d.ts

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

package/src/tools/registerGetGuardPatternTool.js

@@ -1,14 +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) {
+function registerGetGuardPatternTool(server, patternsLoader) {
     server.tool('get-guard-pattern', 'Returns the Archipel guard & interceptor pattern — metadata decorators, FeatureGuard, RolesGuard, FeatureUsageInterceptor, and the full decorator-guard-interceptor trio.', {}, async () => {
+        const pattern = patternsLoader.patterns.get('guard-pattern');
+        const text = pattern?.content ?? 'Guard pattern documentation not available.';
         return {
-            content: [{ type: 'text', text: guardPattern_1.GUARD_PATTERN_KNOWLEDGE }],
+            content: [{ type: 'text', text }],
         };
     });
 }

package/src/tools/registerGetMappingPatternTool.d.ts

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

package/src/tools/registerGetMappingPatternTool.js

@@ -2,11 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerGetMappingPatternTool = registerGetMappingPatternTool;
 const zod_1 = require("zod");
-const mappingPattern_1 = require("../knowledge/mappingPattern");
+const mappingPatternGenerator_1 = require("../generators/mappingPatternGenerator");
 /**
  * Registers the get-mapping-pattern tool on the MCP server.
  */
-function registerGetMappingPatternTool(server) {
+function registerGetMappingPatternTool(server, patternsLoader) {
     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()
@@ -21,10 +21,11 @@ function registerGetMappingPatternTool(server) {
             .optional()
             .describe('Response class name (e.g. "ProductResponse"). Defaults to "{entityName}Response".'),
     }, async (params) => {
-        let content = mappingPattern_1.MAPPING_PATTERN_KNOWLEDGE;
+        const pattern = patternsLoader.patterns.get('mapping-pattern');
+        let content = pattern?.content ?? 'Mapping pattern documentation not available.';
         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);
+            content += '\n\n' + (0, mappingPatternGenerator_1.MAPPING_PATTERN_WITH_CONTEXT)(params.entityName, params.fields, responseName);
         }
         return {
             content: [{ type: 'text', text: content }],

package/src/tools/registerGetModulePatternTool.d.ts

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

package/src/tools/registerGetModulePatternTool.js

@@ -2,11 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerGetModulePatternTool = registerGetModulePatternTool;
 const zod_1 = require("zod");
-const modulePattern_1 = require("../knowledge/modulePattern");
+const modulePatternGenerator_1 = require("../generators/modulePatternGenerator");
 /**
  * Registers the get-module-pattern tool on the MCP server.
  */
-function registerGetModulePatternTool(server) {
+function registerGetModulePatternTool(server, patternsLoader) {
     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()
@@ -17,9 +17,10 @@ function registerGetModulePatternTool(server) {
             .optional()
             .describe('Port class names (e.g. ["NotificationPort", "TemplatePort"]). Abstract port classes for dependency inversion.'),
     }, async (params) => {
-        let content = modulePattern_1.MODULE_PATTERN_KNOWLEDGE;
+        const pattern = patternsLoader.patterns.get('module-pattern');
+        let content = pattern?.content ?? 'Module pattern documentation not available.';
         if (params.moduleName && params.ports && params.ports.length > 0) {
-            content += '\n\n' + (0, modulePattern_1.MODULE_PATTERN_WITH_CONTEXT)(params.moduleName, params.ports);
+            content += '\n\n' + (0, modulePatternGenerator_1.MODULE_PATTERN_WITH_CONTEXT)(params.moduleName, params.ports);
         }
         return {
             content: [{ type: 'text', text: content }],

package/src/tools/registerGetQueryPatternTool.d.ts

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