@breadstone/archipel-mcp 0.0.20 → 0.0.22

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;

package/src/tools/registerGetQueryPatternTool.js

@@ -2,11 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerGetQueryPatternTool = registerGetQueryPatternTool;
 const zod_1 = require("zod");
-const queryPattern_1 = require("../knowledge/queryPattern");
+const queryPatternGenerator_1 = require("../generators/queryPatternGenerator");
 /**
  * Registers the get-query-pattern tool on the MCP server.
  */
-function registerGetQueryPatternTool(server) {
+function registerGetQueryPatternTool(server, patternsLoader) {
     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()
@@ -17,9 +17,10 @@ function registerGetQueryPatternTool(server) {
             .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;
+        const pattern = patternsLoader.patterns.get('query-pattern');
+        let content = pattern?.content ?? 'Query pattern documentation not available.';
         if (params.modelName && params.fields && params.fields.length > 0) {
-            content += '\n\n' + (0, queryPattern_1.QUERY_PATTERN_WITH_MODEL)(params.modelName, params.fields);
+            content += '\n\n' + (0, queryPatternGenerator_1.QUERY_PATTERN_WITH_MODEL)(params.modelName, params.fields);
         }
         return {
             content: [{ type: 'text', text: content }],

package/src/tools/registerGetRepositoryPatternTool.d.ts

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

package/src/tools/registerGetRepositoryPatternTool.js

@@ -2,11 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerGetRepositoryPatternTool = registerGetRepositoryPatternTool;
 const zod_1 = require("zod");
-const repositoryPattern_1 = require("../knowledge/repositoryPattern");
+const repositoryPatternGenerator_1 = require("../generators/repositoryPatternGenerator");
 /**
  * Registers the get-repository-pattern tool on the MCP server.
  */
-function registerGetRepositoryPatternTool(server) {
+function registerGetRepositoryPatternTool(server, patternsLoader) {
     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()
@@ -17,9 +17,10 @@ function registerGetRepositoryPatternTool(server) {
             .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;
+        const pattern = patternsLoader.patterns.get('repository-pattern');
+        let content = pattern?.content ?? 'Repository pattern documentation not available.';
         if (params.modelName && params.fields && params.fields.length > 0) {
-            content += '\n\n' + (0, repositoryPattern_1.REPOSITORY_PATTERN_WITH_MODEL)(params.modelName, params.fields);
+            content += '\n\n' + (0, repositoryPatternGenerator_1.REPOSITORY_PATTERN_WITH_MODEL)(params.modelName, params.fields);
         }
         return {
             content: [{ type: 'text', text: content }],

package/src/tools/registerGetTestingPatternTool.d.ts

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

package/src/tools/registerGetTestingPatternTool.js

@@ -1,14 +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) {
+function registerGetTestingPatternTool(server, patternsLoader) {
     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 () => {
+        const pattern = patternsLoader.patterns.get('testing-pattern');
+        const text = pattern?.content ?? 'Testing pattern documentation not available.';
         return {
-            content: [{ type: 'text', text: testingPattern_1.TESTING_PATTERN_KNOWLEDGE }],
+            content: [{ type: 'text', text }],
         };
     });
 }

package/data/packages/platform-core/api/Class.BlobResourceStrategy.md

@@ -1,195 +0,0 @@
----
-title: 'Class: BlobResourceStrategy'
-generated: true
-editUrl: false
----
-# Class: BlobResourceStrategy
-
-Defined in: [resources/strategies/BlobResourceStrategy.ts:51](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-core/src/resources/strategies/BlobResourceStrategy.ts#L51)
-
-Strategy for loading resources from blob storage.
-
-## Implements
-
-- [`IResourceStrategy`](Interface.IResourceStrategy)
-
-## Constructors
-
-### Constructor
-
-```ts
-new BlobResourceStrategy(blobService, config?): BlobResourceStrategy;
-```
-
-Defined in: [resources/strategies/BlobResourceStrategy.ts:68](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-core/src/resources/strategies/BlobResourceStrategy.ts#L68)
-
-Constructs a new instance of the `BlobResourceStrategy` class.
-
-#### Parameters
-
-| Parameter | Type |
-| ------ | ------ |
-| `blobService` | [`IBlobServiceAdapter`](Interface.IBlobServiceAdapter) |
-| `config` | [`IBlobResourceStrategyConfig`](Interface.IBlobResourceStrategyConfig) |
-
-#### Returns
-
-`BlobResourceStrategy`
-
-## Accessors
-
-### name
-
-#### Get Signature
-
-```ts
-get name(): string;
-```
-
-Defined in: [resources/strategies/BlobResourceStrategy.ts:77](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-core/src/resources/strategies/BlobResourceStrategy.ts#L77)
-
-The unique name of this strategy.
-
-##### Returns
-
-`string`
-
-The unique name of this strategy.
-
-#### Implementation of
-
-[`IResourceStrategy`](Interface.IResourceStrategy).[`name`](Interface.IResourceStrategy#name)
-
-## Methods
-
-### exists()
-
-```ts
-exists(key): boolean;
-```
-
-Defined in: [resources/strategies/BlobResourceStrategy.ts:143](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-core/src/resources/strategies/BlobResourceStrategy.ts#L143)
-
-Checks if a resource exists without loading it.
-Note: Blob storage is inherently async, so this delegates to existsAsync internally.
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `key` | `string` | The resource key |
-
-#### Returns
-
-`boolean`
-
-True if the resource exists
-
-#### Implementation of
-
-[`IResourceStrategy`](Interface.IResourceStrategy).[`exists`](Interface.IResourceStrategy#exists)
-
-***
-
-### existsAsync()
-
-```ts
-existsAsync(key): Promise<boolean>;
-```
-
-Defined in: [resources/strategies/BlobResourceStrategy.ts:154](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-core/src/resources/strategies/BlobResourceStrategy.ts#L154)
-
-Checks if a resource exists without loading it (asynchronous).
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `key` | `string` | The resource key |
-
-#### Returns
-
-`Promise`\<`boolean`\>
-
-Promise resolving to true if the resource exists
-
-#### Implementation of
-
-[`IResourceStrategy`](Interface.IResourceStrategy).[`existsAsync`](Interface.IResourceStrategy#existsasync)
-
-***
-
-### load()
-
-```ts
-load(key): IResourceResult | undefined;
-```
-
-Defined in: [resources/strategies/BlobResourceStrategy.ts:93](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-core/src/resources/strategies/BlobResourceStrategy.ts#L93)
-
-Loads a resource by its key.
-Note: Blob storage is inherently async, so this delegates to loadAsync internally.
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `key` | `string` | The resource key |
-
-#### Returns
-
-[`IResourceResult`](Interface.IResourceResult) \| `undefined`
-
-The resource result or undefined if not found
-
-#### Implementation of
-
-[`IResourceStrategy`](Interface.IResourceStrategy).[`load`](Interface.IResourceStrategy#load)
-
-***
-
-### loadAsync()
-
-```ts
-loadAsync(key): Promise<IResourceResult | undefined>;
-```
-
-Defined in: [resources/strategies/BlobResourceStrategy.ts:104](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-core/src/resources/strategies/BlobResourceStrategy.ts#L104)
-
-Loads a resource by its key (asynchronous).
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `key` | `string` | The resource key |
-
-#### Returns
-
-`Promise`\<[`IResourceResult`](Interface.IResourceResult) \| `undefined`\>
-
-Promise resolving to the resource result or undefined if not found
-
-#### Implementation of
-
-[`IResourceStrategy`](Interface.IResourceStrategy).[`loadAsync`](Interface.IResourceStrategy#loadasync)
-
-***
-
-### whatDoIHave()
-
-```ts
-whatDoIHave(): void;
-```
-
-Defined in: [resources/strategies/BlobResourceStrategy.ts:170](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-core/src/resources/strategies/BlobResourceStrategy.ts#L170)
-
-List all files and folders in the base paths for debugging purposes.
-
-#### Returns
-
-`void`
-
-#### Implementation of
-
-[`IResourceStrategy`](Interface.IResourceStrategy).[`whatDoIHave`](Interface.IResourceStrategy#whatdoihave)

package/data/packages/platform-core/api/Class.EmbeddedResourceStrategy.md

@@ -1,215 +0,0 @@
----
-title: 'Class: EmbeddedResourceStrategy'
-generated: true
-editUrl: false
----
-# Class: EmbeddedResourceStrategy
-
-Defined in: [resources/strategies/EmbeddedResourceStrategy.ts:14](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-core/src/resources/strategies/EmbeddedResourceStrategy.ts#L14)
-
-Strategy for loading embedded resources from memory.
-
-## Implements
-
-- [`IResourceStrategy`](Interface.IResourceStrategy)
-
-## Constructors
-
-### Constructor
-
-```ts
-new EmbeddedResourceStrategy(resources?): EmbeddedResourceStrategy;
-```
-
-Defined in: [resources/strategies/EmbeddedResourceStrategy.ts:30](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-core/src/resources/strategies/EmbeddedResourceStrategy.ts#L30)
-
-Constructs a new instance of the `EmbeddedResourceStrategy` class.
-
-#### Parameters
-
-| Parameter | Type |
-| ------ | ------ |
-| `resources` | `Record`\<`string`, `string`\> |
-
-#### Returns
-
-`EmbeddedResourceStrategy`
-
-## Accessors
-
-### name
-
-#### Get Signature
-
-```ts
-get name(): string;
-```
-
-Defined in: [resources/strategies/EmbeddedResourceStrategy.ts:38](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-core/src/resources/strategies/EmbeddedResourceStrategy.ts#L38)
-
-The unique name of this strategy.
-
-##### Returns
-
-`string`
-
-The unique name of this strategy.
-
-#### Implementation of
-
-[`IResourceStrategy`](Interface.IResourceStrategy).[`name`](Interface.IResourceStrategy#name)
-
-## Methods
-
-### exists()
-
-```ts
-exists(key): boolean;
-```
-
-Defined in: [resources/strategies/EmbeddedResourceStrategy.ts:94](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-core/src/resources/strategies/EmbeddedResourceStrategy.ts#L94)
-
-Checks if a resource exists without loading it.
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `key` | `string` | The resource key |
-
-#### Returns
-
-`boolean`
-
-True if the resource exists
-
-#### Implementation of
-
-[`IResourceStrategy`](Interface.IResourceStrategy).[`exists`](Interface.IResourceStrategy#exists)
-
-***
-
-### existsAsync()
-
-```ts
-existsAsync(key): Promise<boolean>;
-```
-
-Defined in: [resources/strategies/EmbeddedResourceStrategy.ts:105](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-core/src/resources/strategies/EmbeddedResourceStrategy.ts#L105)
-
-Checks if a resource exists without loading it (asynchronous).
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `key` | `string` | The resource key |
-
-#### Returns
-
-`Promise`\<`boolean`\>
-
-Promise resolving to true if the resource exists
-
-#### Implementation of
-
-[`IResourceStrategy`](Interface.IResourceStrategy).[`existsAsync`](Interface.IResourceStrategy#existsasync)
-
-***
-
-### load()
-
-```ts
-load(key): IResourceResult | undefined;
-```
-
-Defined in: [resources/strategies/EmbeddedResourceStrategy.ts:53](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-core/src/resources/strategies/EmbeddedResourceStrategy.ts#L53)
-
-Loads a resource by its key.
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `key` | `string` | The resource key |
-
-#### Returns
-
-[`IResourceResult`](Interface.IResourceResult) \| `undefined`
-
-The resource result or undefined if not found
-
-#### Implementation of
-
-[`IResourceStrategy`](Interface.IResourceStrategy).[`load`](Interface.IResourceStrategy#load)
-
-***
-
-### loadAsync()
-
-```ts
-loadAsync(key): Promise<IResourceResult | undefined>;
-```
-
-Defined in: [resources/strategies/EmbeddedResourceStrategy.ts:83](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-core/src/resources/strategies/EmbeddedResourceStrategy.ts#L83)
-
-Loads a resource by its key (asynchronous).
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `key` | `string` | The resource key |
-
-#### Returns
-
-`Promise`\<[`IResourceResult`](Interface.IResourceResult) \| `undefined`\>
-
-Promise resolving to the resource result or undefined if not found
-
-#### Implementation of
-
-[`IResourceStrategy`](Interface.IResourceStrategy).[`loadAsync`](Interface.IResourceStrategy#loadasync)
-
-***
-
-### register()
-
-```ts
-register(key, content): void;
-```
-
-Defined in: [resources/strategies/EmbeddedResourceStrategy.ts:116](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-core/src/resources/strategies/EmbeddedResourceStrategy.ts#L116)
-
-Registers a new embedded resource.
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `key` | `string` | The resource key |
-| `content` | `string` | The resource content |
-
-#### Returns
-
-`void`
-
-***
-
-### whatDoIHave()
-
-```ts
-whatDoIHave(): void;
-```
-
-Defined in: [resources/strategies/EmbeddedResourceStrategy.ts:125](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-core/src/resources/strategies/EmbeddedResourceStrategy.ts#L125)
-
-List all files and folders in the base paths for debugging purposes.
-
-#### Returns
-
-`void`
-
-#### Implementation of
-
-[`IResourceStrategy`](Interface.IResourceStrategy).[`whatDoIHave`](Interface.IResourceStrategy#whatdoihave)