@breadstone/archipel-mcp 0.0.10 → 0.0.13

package/data/packages/platform-database/api/Interface.IDatabaseModuleConfig.md

@@ -11,12 +11,24 @@ Represents the database module configuration.
 
 ## Properties
 
+### accelerateUrl?
+
+```ts
+optional accelerateUrl?: string;
+```
+
+Defined in: [DatabaseModule.ts:19](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-database/src/DatabaseModule.ts#L19)
+
+Prisma Accelerate URL allowing the client to connect through Accelerate.
+
+***
+
 ### middlewares?
 
 ```ts
 optional middlewares?: unknown[];
 ```
 
-Defined in: [DatabaseModule.ts:19](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-database/src/DatabaseModule.ts#L19)
+Defined in: [DatabaseModule.ts:21](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-database/src/DatabaseModule.ts#L21)
 
 Future extension point for Prisma middlewares

package/data/packages/platform-database/api/Interface.IPrismaServiceOptions.md

@@ -0,0 +1,22 @@
+---
+title: 'Interface: IPrismaServiceOptions'
+generated: true
+editUrl: false
+---
+# Interface: IPrismaServiceOptions
+
+Defined in: [services/PrismaService.ts:16](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-database/src/services/PrismaService.ts#L16)
+
+Represents the options for the PrismaService.
+
+## Properties
+
+### accelerateUrl?
+
+```ts
+optional accelerateUrl?: string;
+```
+
+Defined in: [services/PrismaService.ts:18](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-database/src/services/PrismaService.ts#L18)
+
+Prisma Accelerate URL allowing the client to connect through Accelerate. Takes priority over the `DB_ACCELERATE_URL` config key.

package/data/packages/platform-database/api/Variable.DATABASE_MODULE_CONFIG.md

@@ -0,0 +1,14 @@
+---
+title: 'Variable: DATABASE\_MODULE\_CONFIG'
+generated: true
+editUrl: false
+---
+# Variable: DATABASE\_MODULE\_CONFIG
+
+```ts
+const DATABASE_MODULE_CONFIG: "DATABASE_MODULE_CONFIG" = 'DATABASE_MODULE_CONFIG';
+```
+
+Defined in: [DatabaseModule.ts:29](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-database/src/DatabaseModule.ts#L29)
+
+Represents the database module.

package/data/packages/platform-database/api/Variable.DB_ACCELERATE_URL.md

@@ -0,0 +1,14 @@
+---
+title: 'Variable: DB\_ACCELERATE\_URL'
+generated: true
+editUrl: false
+---
+# Variable: DB\_ACCELERATE\_URL
+
+```ts
+const DB_ACCELERATE_URL: IConfigKey<string>;
+```
+
+Defined in: [configKeys.ts:11](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-database/src/configKeys.ts#L11)
+
+Prisma Accelerate URL for managed connection pooling.

package/data/packages/platform-database/api/Variable.DB_AUTO_CONNECTION.md

@@ -0,0 +1,14 @@
+---
+title: 'Variable: DB\_AUTO\_CONNECTION'
+generated: true
+editUrl: false
+---
+# Variable: DB\_AUTO\_CONNECTION
+
+```ts
+const DB_AUTO_CONNECTION: IConfigKey<boolean>;
+```
+
+Defined in: [configKeys.ts:8](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-database/src/configKeys.ts#L8)
+
+Whether to skip the automatic database connection on module init.

package/data/packages/platform-database/api/Variable.DB_OPTIMIZE.md

@@ -0,0 +1,14 @@
+---
+title: 'Variable: DB\_OPTIMIZE'
+generated: true
+editUrl: false
+---
+# Variable: DB\_OPTIMIZE
+
+```ts
+const DB_OPTIMIZE: IConfigKey<boolean>;
+```
+
+Defined in: [configKeys.ts:14](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-database/src/configKeys.ts#L14)
+
+Whether Prisma Optimize query analysis is enabled.

package/data/packages/platform-database/api/Variable.DB_OPTIMIZE_API_KEY.md

@@ -0,0 +1,14 @@
+---
+title: 'Variable: DB\_OPTIMIZE\_API\_KEY'
+generated: true
+editUrl: false
+---
+# Variable: DB\_OPTIMIZE\_API\_KEY
+
+```ts
+const DB_OPTIMIZE_API_KEY: IConfigKey<string>;
+```
+
+Defined in: [configKeys.ts:17](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-database/src/configKeys.ts#L17)
+
+API key for the Prisma Optimize dashboard.

package/data/packages/platform-database/api/Variable.PLATFORM_DATABASE_CONFIG_ENTRIES.md

@@ -0,0 +1,14 @@
+---
+title: 'Variable: PLATFORM\_DATABASE\_CONFIG\_ENTRIES'
+generated: true
+editUrl: false
+---
+# Variable: PLATFORM\_DATABASE\_CONFIG\_ENTRIES
+
+```ts
+const PLATFORM_DATABASE_CONFIG_ENTRIES: ReadonlyArray<Omit<IConfigRegistryEntry, "module">>;
+```
+
+Defined in: [configKeys.ts:20](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-database/src/configKeys.ts#L20)
+
+Core configuration entries required by `platform-database`.

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

@@ -10,7 +10,7 @@ editUrl: false
 | Class | Description |
 | ------ | ------ |
 | [DatabaseHealthIndicator](Class.DatabaseHealthIndicator) | Health indicator for database connectivity. |
-| [DatabaseModule](Class.DatabaseModule) | Represents the database module. |
+| [DatabaseModule](Class.DatabaseModule) | - |
 | [DatabaseService](Class.DatabaseService) | Represents the database service. |
 | [PrismaService](Class.PrismaService) | Represents the prisma service. |
 | [RepositoryBase](Class.RepositoryBase) | The base class for all repositories. |
@@ -23,6 +23,7 @@ editUrl: false
 | [IDatabaseModuleConfig](Interface.IDatabaseModuleConfig) | Represents the database module configuration. |
 | [IPaginatedResult](Interface.IPaginatedResult) | - |
 | [IPaginateOptions](Interface.IPaginateOptions) | - |
+| [IPrismaServiceOptions](Interface.IPrismaServiceOptions) | Represents the options for the PrismaService. |
 | [IRepositoryQuery](Interface.IRepositoryQuery) | Represents a reusable query definition for repositories. |
 | [ITransactionalRepositoryQuery](Interface.ITransactionalRepositoryQuery) | Represents a repository query that requires a Prisma TransactionClient to access multiple delegates. |
 
@@ -36,6 +37,17 @@ editUrl: false
 | [QueryResultType](TypeAlias.QueryResultType) | Extracts the result type from a repository query. Useful for type-safe mapping without duplicating query result types. |
 | [TransactionalQueryResultType](TypeAlias.TransactionalQueryResultType) | Extracts the result type from a transactional repository query. |
 
+## Variables
+
+| Variable | Description |
+| ------ | ------ |
+| [DATABASE\_MODULE\_CONFIG](Variable.DATABASE_MODULE_CONFIG) | Represents the database module. |
+| [DB\_ACCELERATE\_URL](Variable.DB_ACCELERATE_URL) | Prisma Accelerate URL for managed connection pooling. |
+| [DB\_AUTO\_CONNECTION](Variable.DB_AUTO_CONNECTION) | Whether to skip the automatic database connection on module init. |
+| [DB\_OPTIMIZE](Variable.DB_OPTIMIZE) | Whether Prisma Optimize query analysis is enabled. |
+| [DB\_OPTIMIZE\_API\_KEY](Variable.DB_OPTIMIZE_API_KEY) | API key for the Prisma Optimize dashboard. |
+| [PLATFORM\_DATABASE\_CONFIG\_ENTRIES](Variable.PLATFORM_DATABASE_CONFIG_ENTRIES) | Core configuration entries required by `platform-database`. |
+
 ## Functions
 
 | Function | Description |

package/data/packages/platform-database/index.md

@@ -16,10 +16,13 @@ Prisma ORM integration with PostgreSQL featuring a repository base class, type-s
 
 ```typescript
 import { Module } from '@nestjs/common';
-import { DatabaseModule } from '@breadstone/archipel-platform-database';
+import { ConfigModule } from '@breadstone/archipel-platform-core';
+import { DatabaseModule, PLATFORM_DATABASE_CONFIG_ENTRIES } from '@breadstone/archipel-platform-database';
 
 @Module({
   imports: [
+    ConfigModule.register('database', PLATFORM_DATABASE_CONFIG_ENTRIES),
+
     // Global registration (recommended)
     DatabaseModule.forRoot(),
 
@@ -36,6 +39,7 @@ export class AppModule {}
 
 ```typescript
 interface IDatabaseModuleConfig {
+    accelerateUrl?: string;        // Prisma Accelerate URL (overrides DB_ACCELERATE_URL env var)
     middlewares?: Array<unknown>;  // Future extension point
 }
 
@@ -46,14 +50,28 @@ DatabaseModule.forRoot(config?: IDatabaseModuleConfig): DynamicModule
 DatabaseModule.register(config?: IDatabaseModuleConfig): DynamicModule
 ```
 
+### Config Keys
+
+Register all database config keys with `PLATFORM_DATABASE_CONFIG_ENTRIES`:
+
+```typescript
+import { ConfigModule } from '@breadstone/archipel-platform-core';
+import { PLATFORM_DATABASE_CONFIG_ENTRIES } from '@breadstone/archipel-platform-database';
+
+ConfigModule.register('database', PLATFORM_DATABASE_CONFIG_ENTRIES);
+```
+
 ### Environment Variables
 
-| Variable              | Description                      | Required            |
-| --------------------- | -------------------------------- | ------------------- |
-| `DATABASE_URL`        | PostgreSQL connection string     | Yes                 |
-| `DB_OPTIMIZE`         | Enable Prisma query optimization | No                  |
-| `DB_OPTIMIZE_API_KEY` | Prisma Optimize API key          | If optimize enabled |
-| `DB_AUTO_CONNECTION`  | Auto-connect on module init      | No (default: true)  |
+| Variable              | Description                               | Required            | Default |
+| --------------------- | ----------------------------------------- | ------------------- | ------- |
+| `DATABASE_URL`        | PostgreSQL connection string              | Yes                 | —       |
+| `DB_ACCELERATE_URL`   | Prisma Accelerate proxy URL               | No                  | `''`    |
+| `DB_AUTO_CONNECTION`  | Auto-connect on module init               | No                  | `true`  |
+| `DB_OPTIMIZE`         | Enable Prisma Optimize query analysis     | No                  | `true`  |
+| `DB_OPTIMIZE_API_KEY` | API key for the Prisma Optimize dashboard | If optimize enabled | `''`    |
+
+> **Accelerate resolution order:** `accelerateUrl` module parameter → `DB_ACCELERATE_URL` environment variable → no Accelerate.
 
 ---
 
@@ -287,14 +305,19 @@ import { DatabaseHealthIndicator } from '@breadstone/archipel-platform-database'
 
 ## Exports Summary
 
-| Export                    | Type           | Description                              |
-| ------------------------- | -------------- | ---------------------------------------- |
-| `DatabaseModule`          | NestJS Module  | `forRoot()` / `register()`               |
-| `DatabaseService`         | Service        | Extended Prisma client with transactions |
-| `PrismaService`           | Service        | Prisma client with extensions            |
-| `RepositoryBase`          | Abstract class | Base class for repositories              |
-| `query()`                 | Factory        | Create typed query objects               |
-| `transactionalQuery()`    | Factory        | Create transactional query objects       |
-| `paginator()`             | Factory        | Create pagination helper                 |
-| `DatabaseHealthIndicator` | Health         | PostgreSQL health check                  |
-| `DB` (Prisma)             | Namespace      | Re-exported Prisma types                 |
+| Export                             | Type           | Description                              |
+| ---------------------------------- | -------------- | ---------------------------------------- |
+| `DatabaseModule`                   | NestJS Module  | `forRoot()` / `register()`               |
+| `DatabaseService`                  | Service        | Extended Prisma client with transactions |
+| `PrismaService`                    | Service        | Prisma client with extensions            |
+| `RepositoryBase`                   | Abstract class | Base class for repositories              |
+| `query()`                          | Factory        | Create typed query objects               |
+| `transactionalQuery()`             | Factory        | Create transactional query objects       |
+| `paginator()`                      | Factory        | Create pagination helper                 |
+| `DatabaseHealthIndicator`          | Health         | PostgreSQL health check                  |
+| `PLATFORM_DATABASE_CONFIG_ENTRIES` | Constant       | Config entries for `ConfigModule`        |
+| `DB_ACCELERATE_URL`                | Config Key     | Prisma Accelerate URL                    |
+| `DB_AUTO_CONNECTION`               | Config Key     | Auto-connect toggle                      |
+| `DB_OPTIMIZE`                      | Config Key     | Prisma Optimize toggle                   |
+| `DB_OPTIMIZE_API_KEY`              | Config Key     | Prisma Optimize API key                  |
+| `DB` (Prisma)                      | Namespace      | Re-exported Prisma types                 |

package/data/packages/platform-openapi/api/Class.SwaggerFeatureDiscovery.md

@@ -26,10 +26,10 @@ new SwaggerFeatureDiscovery(): SwaggerFeatureDiscovery;
 ### registerDefaultFeatures()
 
 ```ts
-registerDefaultFeatures(featureRegistry): void;
+registerDefaultFeatures(featureRegistry): this;
 ```
 
-Defined in: [discovery/SwaggerFeatureDiscovery.ts:40](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/discovery/SwaggerFeatureDiscovery.ts#L40)
+Defined in: [discovery/SwaggerFeatureDiscovery.ts:45](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/discovery/SwaggerFeatureDiscovery.ts#L45)
 
 Registers the default composite Swagger documents that aggregate the complete API.
 
@@ -41,17 +41,19 @@ Registers the default composite Swagger documents that aggregate the complete AP
 
 #### Returns
 
-`void`
+`this`
+
+The discovery instance for chaining.
 
 ***
 
 ### registerDiscoveredFeatures()
 
 ```ts
-registerDiscoveredFeatures(featureRegistry): void;
+registerDiscoveredFeatures(featureRegistry): this;
 ```
 
-Defined in: [discovery/SwaggerFeatureDiscovery.ts:22](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/discovery/SwaggerFeatureDiscovery.ts#L22)
+Defined in: [discovery/SwaggerFeatureDiscovery.ts:23](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-openapi/src/discovery/SwaggerFeatureDiscovery.ts#L23)
 
 Registers all discovered feature modules in the provided Swagger registry.
 
@@ -63,4 +65,6 @@ Registers all discovered feature modules in the provided Swagger registry.
 
 #### Returns
 
-`void`
+`this`
+
+The discovery instance for chaining.

package/data/packages/platform-telemetry/api/Class.NoopTelemetryFacade.md

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: NoopTelemetryFacade
 
-Defined in: [core/NoopTelemetryFacade.ts:11](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/core/NoopTelemetryFacade.ts#L11)
+Defined in: [core/NoopTelemetryFacade.ts:7](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/core/NoopTelemetryFacade.ts#L7)
 
 ## Implements
 
@@ -31,7 +31,7 @@ new NoopTelemetryFacade(): NoopTelemetryFacade;
 optional recordCacheEvent(_): void;
 ```
 
-Defined in: [core/NoopTelemetryFacade.ts:14](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/core/NoopTelemetryFacade.ts#L14)
+Defined in: [core/NoopTelemetryFacade.ts:11](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/core/NoopTelemetryFacade.ts#L11)
 
 #### Parameters
 
@@ -56,21 +56,21 @@ Defined in: [core/NoopTelemetryFacade.ts:14](https://github.com/RueDeRennes/arch
 
 ```ts
 optional recordClientMetric(
-   name, 
-   type, 
-   value, 
+   _name, 
+   _type, 
+   _value, 
    _labels?): void;
 ```
 
-Defined in: [core/NoopTelemetryFacade.ts:19](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/core/NoopTelemetryFacade.ts#L19)
+Defined in: [core/NoopTelemetryFacade.ts:14](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/core/NoopTelemetryFacade.ts#L14)
 
 #### Parameters
 
 | Parameter | Type |
 | ------ | ------ |
-| `name` | `string` |
-| `type` | `string` |
-| `value` | `number` |
+| `_name` | `string` |
+| `_type` | `string` |
+| `_value` | `number` |
 | `_labels?` | `Record`\<`string`, `string`\> |
 
 #### Returns
@@ -89,7 +89,7 @@ Defined in: [core/NoopTelemetryFacade.ts:19](https://github.com/RueDeRennes/arch
 runOperation<T>(_, fn): Promise<T>;
 ```
 
-Defined in: [core/NoopTelemetryFacade.ts:13](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/core/NoopTelemetryFacade.ts#L13)
+Defined in: [core/NoopTelemetryFacade.ts:8](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/core/NoopTelemetryFacade.ts#L8)
 
 #### Type Parameters
 

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

@@ -42,7 +42,7 @@ optional recordClientMetric(
    labels?): void;
 ```
 
-Defined in: [core/NoopTelemetryFacade.ts:8](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/core/NoopTelemetryFacade.ts#L8)
+Defined in: [core/NoopTelemetryFacade.ts:4](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/core/NoopTelemetryFacade.ts#L4)
 
 #### Parameters
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@breadstone/archipel-mcp",
-  "version": "0.0.10",
+  "version": "0.0.13",
   "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