@breadstone/archipel-mcp 0.0.1

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

@@ -0,0 +1,81 @@
+---
+title: '@breadstone/archipel-platform-telemetry'
+generated: true
+editUrl: false
+---
+
+[**@breadstone/archipel-platform-telemetry**](../)
+
+---
+
+# @breadstone/archipel-platform-telemetry
+
+## Classes
+
+| 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)                     | -                                                                                                                                  |
+
+## Interfaces
+
+| Interface                                                      | Description |
+| -------------------------------------------------------------- | ----------- |
+| [ITelemetryFacade](Interface.ITelemetryFacade)                 | -           |
+| [ITelemetryMetricsOptions](Interface.ITelemetryMetricsOptions) | -           |
+| [ITelemetryOptions](Interface.ITelemetryOptions)               | -           |
+| [ITelemetryTracesOptions](Interface.ITelemetryTracesOptions)   | -           |
+
+## Variables
+
+### defaultTelemetryOptions
+
+```ts
+const defaultTelemetryOptions: ITelemetryOptions;
+```
+
+Defined in: [options/TelemetryOptions.ts:35](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/options/TelemetryOptions.ts#L35)
+
+---
+
+### TELEMETRY_ENABLED
+
+```ts
+const TELEMETRY_ENABLED: typeof TELEMETRY_ENABLED;
+```
+
+Defined in: [tokens.ts:4](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/tokens.ts#L4)
+
+---
+
+### TELEMETRY_FACADE
+
+```ts
+const TELEMETRY_FACADE: typeof TELEMETRY_FACADE;
+```
+
+Defined in: [tokens.ts:3](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/tokens.ts#L3)
+
+---
+
+### TELEMETRY_OPTIONS
+
+```ts
+const TELEMETRY_OPTIONS: typeof TELEMETRY_OPTIONS;
+```
+
+Defined in: [tokens.ts:2](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/tokens.ts#L2)
+
+---
+
+### TELEMETRY_SHUTDOWN
+
+```ts
+const TELEMETRY_SHUTDOWN: typeof TELEMETRY_SHUTDOWN;
+```
+
+Defined in: [tokens.ts:5](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/tokens.ts#L5)

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

@@ -0,0 +1,234 @@
+---
+title: platform-telemetry
+description: OpenTelemetry integration with tracing, metrics, and graceful no-op fallback.
+order: 11
+tags: [telemetry, opentelemetry, tracing, metrics, observability]
+package: '@breadstone/archipel-platform-telemetry'
+---
+
+# platform-telemetry
+
+OpenTelemetry integration providing distributed tracing, metrics collection, and a graceful no-op fallback when telemetry is disabled. Wraps the OTEL SDK with a clean facade pattern.
+
+**Package:** `@breadstone/archipel-platform-telemetry`
+
+## Quick Start
+
+```typescript
+import { Module } from '@nestjs/common';
+import { TelemetryModule } from '@breadstone/archipel-platform-telemetry';
+
+@Module({
+  imports: [
+    TelemetryModule.register({
+      enabled: true,
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+---
+
+## Module Configuration
+
+### ITelemetryOptions
+
+| Property  | Type      | Default | Description              |
+| --------- | --------- | ------- | ------------------------ |
+| `enabled` | `boolean` | `false` | Enable/disable telemetry |
+
+When disabled, the `NoopTelemetryFacade` is injected instead — all method calls are no-ops with zero overhead.
+
+```typescript
+// Disabled telemetry — safe, no-overhead
+TelemetryModule.register({ enabled: false });
+
+// Enabled telemetry — full OTEL SDK
+TelemetryModule.register({ enabled: true });
+```
+
+---
+
+## TelemetryFacade
+
+Main API for recording operations, cache events, and custom metrics.
+
+### Wrap Operations
+
+Automatically trace async operations with duration, success/failure status, and error capture:
+
+```typescript
+import { TelemetryFacade, TELEMETRY_FACADE } from '@breadstone/archipel-platform-telemetry';
+
+@Injectable()
+export class OrderService {
+  constructor(@Inject(TELEMETRY_FACADE) private readonly _telemetry: TelemetryFacade) {}
+
+  public async processOrder(orderId: string): Promise<IOrder> {
+    return this._telemetry.runOperation('processOrder', async () => {
+      const order = await this._orderRepo.findById(orderId);
+      await this._paymentService.charge(order);
+      await this._inventoryService.reserve(order.items);
+      return order;
+    });
+    // Automatically records:
+    // - operation.name = 'processOrder'
+    // - duration_ms
+    // - status = 'success' | 'error'
+    // - error details (if thrown)
+  }
+}
+```
+
+### Record Cache Events
+
+Track cache hits and misses:
+
+```typescript
+this._telemetry.recordCacheEvent({
+  cache: 'products',
+  outcome: 'hit', // 'hit' | 'miss'
+  phase: 'memory', // optional: 'memory' | 'redis' | 'db'
+});
+```
+
+### Record Custom Metrics
+
+```typescript
+this._telemetry.recordClientMetric('order_total_amount', 'histogram', order.total, { currency: 'EUR', region: 'DE' });
+```
+
+### Get Logger
+
+```typescript
+const logger = this._telemetry.getLogger();
+logger.log('Order processed', { orderId, total: order.total });
+```
+
+---
+
+## TelemetryCacheMetricsRecorder
+
+Bridges the `ICacheMetricsRecorder` interface (from `platform-core`) with the telemetry facade:
+
+```typescript
+import { TelemetryCacheMetricsRecorder } from '@breadstone/archipel-platform-telemetry';
+import { MemoryLayeredCache } from '@breadstone/archipel-platform-core';
+
+// In a module provider
+{
+    provide: 'PRODUCT_CACHE',
+    useFactory: (recorder: TelemetryCacheMetricsRecorder) => {
+        return new MemoryLayeredCache<string, IProduct>(
+            async (key) => fetchProduct(key),
+            {
+                ttlMs: 60_000,
+                metricsRecorder: recorder,
+                cacheName: 'products',
+            }
+        );
+    },
+    inject: [TelemetryCacheMetricsRecorder],
+}
+```
+
+---
+
+## TelemetryRuleEngine
+
+Conditionally enable/disable telemetry recording per operation:
+
+```typescript
+import { TelemetryRuleEngine } from '@breadstone/archipel-platform-telemetry';
+
+@Injectable()
+export class AppTelemetryRules extends TelemetryRuleEngine {
+  public shouldRecord(operationName: string): boolean {
+    // Skip noisy health checks
+    if (operationName === 'healthCheck') return false;
+    return true;
+  }
+}
+```
+
+---
+
+## OpenTelemetry Internals
+
+The module initializes these OTEL components:
+
+| Component               | Implementation                           |
+| ----------------------- | ---------------------------------------- |
+| Trace exporter          | OTLP/HTTP                                |
+| Metrics exporter        | OTLP/HTTP                                |
+| Express instrumentation | `@opentelemetry/instrumentation-express` |
+| HTTP instrumentation    | `@opentelemetry/instrumentation-http`    |
+| SDK shutdown hook       | Graceful on `OnModuleDestroy`            |
+
+---
+
+## Real-World Example: Full Observability Stack
+
+```typescript
+@Module({
+  imports: [
+    TelemetryModule.register({ enabled: process.env.OTEL_ENABLED === 'true' }),
+    LoggerModule, // Sentry integration
+    DatabaseModule.forRoot(),
+  ],
+})
+export class AppModule {}
+
+// In a service
+@Injectable()
+export class ProductService {
+  constructor(
+    @Inject(TELEMETRY_FACADE) private readonly _telemetry: TelemetryFacade,
+    private readonly _analytics: AnalyticsService,
+    private readonly _productRepo: ProductRepository,
+  ) {}
+
+  public async searchProducts(query: string): Promise<IProduct[]> {
+    return this._telemetry.runOperation('searchProducts', async () => {
+      const results = await this._productRepo.execute(searchProducts(query));
+
+      this._telemetry.recordClientMetric('search_results_count', 'histogram', results.length, {
+        query_length: query.length.toString(),
+      });
+
+      return results;
+    });
+  }
+}
+```
+
+---
+
+## Graceful Degradation
+
+When `enabled: false` or when the OTEL SDK fails to initialize:
+
+- `NoopTelemetryFacade` is injected instead of `TelemetryFacade`
+- All operations execute normally without tracing overhead
+- `runOperation()` simply invokes the callback
+- `recordCacheEvent()` and `recordClientMetric()` are no-ops
+- No errors thrown — the application runs normally
+
+---
+
+## Exports Summary
+
+| Export                          | Type          | Description                |
+| ------------------------------- | ------------- | -------------------------- |
+| `TelemetryModule`               | NestJS Module | `register()` configuration |
+| `TelemetryFacade`               | Service       | Main telemetry API         |
+| `NoopTelemetryFacade`           | Service       | Disabled-mode fallback     |
+| `TelemetryCacheMetricsRecorder` | Service       | Bridge for cache metrics   |
+| `TelemetryRuleEngine`           | Service       | Conditional recording      |
+| `TelemetryLoggerService`        | Service       | Logger integration         |
+| `OperationTelemetryInterceptor` | Interceptor   | Auto-trace HTTP requests   |
+| `TELEMETRY_FACADE`              | Token         | Injection token for facade |
+| `TELEMETRY_ENABLED`             | Token         | Boolean enabled flag       |
+| `TELEMETRY_OPTIONS`             | Token         | Configuration options      |
+| `TELEMETRY_SHUTDOWN`            | Token         | Shutdown hook              |

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@breadstone/archipel-mcp",
+  "version": "0.0.1",
+  "description": "MCP server providing Archipel platform knowledge — documentation, query patterns, and coding conventions — to AI development tools.",
+  "type": "commonjs",
+  "main": "./src/main.js",
+  "bin": "./src/main.js",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/RueDeRennes/archipel",
+    "directory": "tools/mcp"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "copilot",
+    "nestjs",
+    "archipel",
+    "code-generation"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "src/**/*.js",
+    "src/**/*.d.ts",
+    "data/**/*.md",
+    "README.md"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.29.0",
+    "gray-matter": "4.0.3",
+    "tslib": "2.8.1",
+    "zod": "4.3.6"
+  },
+  "types": "./src/main.d.ts"
+}

package/src/DocsLoader.d.ts

@@ -0,0 +1,14 @@
+import type { IPackageDoc } from './models/IPackageDoc';
+/**
+ * Loads and indexes Archipel platform documentation from the `.docs/packages/`
+ * directory (monorepo dev) or from the bundled `data/packages/` directory
+ * (published npm package).
+ */
+export declare class DocsLoader {
+    private readonly _packages;
+    get packages(): ReadonlyMap<string, IPackageDoc>;
+    load(): void;
+    search(query: string): IPackageDoc[];
+    private loadApiDocs;
+    private resolveDocsDirectory;
+}

package/src/DocsLoader.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocsLoader = 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 documentation from the `.docs/packages/`
+ * directory (monorepo dev) or from the bundled `data/packages/` directory
+ * (published npm package).
+ */
+class DocsLoader {
+    constructor() {
+        // #region Fields
+        this._packages = new Map();
+        // #endregion
+    }
+    // #endregion
+    // #region Properties
+    get packages() {
+        return this._packages;
+    }
+    // #endregion
+    // #region Methods
+    load() {
+        const docsDirectory = this.resolveDocsDirectory();
+        if (!docsDirectory) {
+            process.stderr.write('[archipel-mcp] Warning: Could not locate documentation directory.\n');
+            return;
+        }
+        const entries = fs.readdirSync(docsDirectory, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory()) {
+                continue;
+            }
+            const indexPath = path.join(docsDirectory, entry.name, 'index.md');
+            if (!fs.existsSync(indexPath)) {
+                continue;
+            }
+            const raw = fs.readFileSync(indexPath, 'utf-8');
+            const parsed = (0, gray_matter_1.default)(raw);
+            const apiDirectory = path.join(docsDirectory, entry.name, 'api');
+            const apiContent = fs.existsSync(apiDirectory) ? this.loadApiDocs(apiDirectory) : '';
+            this._packages.set(entry.name, {
+                name: entry.name,
+                title: parsed.data['title'] || entry.name,
+                description: parsed.data['description'] || '',
+                tags: parsed.data['tags'] || [],
+                packageScope: parsed.data['package'] || `@breadstone/archipel-${entry.name}`,
+                content: parsed.content.trim(),
+                apiContent,
+            });
+        }
+        process.stderr.write(`[archipel-mcp] Loaded documentation for ${this._packages.size} package(s)\n`);
+    }
+    search(query) {
+        const lowerQuery = query.toLowerCase();
+        const results = [];
+        for (const packageDoc of this._packages.values()) {
+            if (packageDoc.name.toLowerCase().includes(lowerQuery) ||
+                packageDoc.description.toLowerCase().includes(lowerQuery) ||
+                packageDoc.content.toLowerCase().includes(lowerQuery) ||
+                packageDoc.tags.some((tag) => tag.toLowerCase().includes(lowerQuery))) {
+                results.push(packageDoc);
+            }
+        }
+        return results;
+    }
+    loadApiDocs(apiDirectory) {
+        const parts = [];
+        const files = fs
+            .readdirSync(apiDirectory)
+            .filter((file) => file.endsWith('.md'))
+            .sort();
+        for (const file of files) {
+            const raw = fs.readFileSync(path.join(apiDirectory, file), 'utf-8');
+            const parsed = (0, gray_matter_1.default)(raw);
+            parts.push(parsed.content.trim());
+        }
+        return parts.join('\n\n---\n\n');
+    }
+    resolveDocsDirectory() {
+        // 1. Bundled data (published npm package)
+        const bundledPath = path.resolve(__dirname, '..', 'data', 'packages');
+        if (fs.existsSync(bundledPath)) {
+            return bundledPath;
+        }
+        // 2. Workspace root (monorepo dev)
+        const cwdPath = path.resolve(process.cwd(), '.docs', 'packages');
+        if (fs.existsSync(cwdPath)) {
+            return cwdPath;
+        }
+        // 3. Relative from compiled source (dist/tools/mcp/src/)
+        const relativePath = path.resolve(__dirname, '..', '..', '..', '..', '.docs', 'packages');
+        if (fs.existsSync(relativePath)) {
+            return relativePath;
+        }
+        return null;
+    }
+}
+exports.DocsLoader = DocsLoader;
+//# sourceMappingURL=DocsLoader.js.map

package/src/knowledge/configPattern.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Static knowledge content for the Archipel configuration pattern.
+ * Returned by the get-config-pattern tool.
+ */
+export declare const CONFIG_PATTERN_KNOWLEDGE = "# Archipel Configuration Pattern\n\n## Overview\n\nArchipel uses a **typed configuration key** system with a **central registry**.\nEach platform library declares its required and optional config keys in an `env.ts`\nfile, which are registered into the global `ConfigRegistry`. At runtime, the\n`ConfigService` resolves values through a pluggable strategy (environment variables,\nAzure App Configuration, etc.).\n\n**Rule:** No direct `process.env` access outside of config strategy implementations.\n\n## Core Types\n\n### IConfigKey<TType>\n\n```typescript\nexport interface IConfigKey<TType = unknown> {\n  readonly _type?: TType;  // Phantom type for compile-time safety\n  readonly key: string;     // The actual config key string\n}\n```\n\n### createConfigKey<TType>\n\n```typescript\nimport { createConfigKey } from '@breadstone/archipel-platform-core';\n\nexport const APP_URL = createConfigKey<string>('APP_URL');\nexport const APP_PORT = createConfigKey<number>('APP_PORT');\nexport const FEATURE_ENABLED = createConfigKey<boolean>('FEATURE_ENABLED');\n```\n\n## ConfigService API\n\n```typescript\n@Injectable()\nexport class ConfigService {\n\n  // Throws if key not found\n  public get<T>(key: string): T;\n\n  // Returns fallback if key not found\n  public tryGet<T>(key: string, fallback: T): T;\n\n  // Compares a key's value to an expected value\n  public compare<T>(key: string, value: T): boolean;\n\n}\n```\n\n**Auto-parsing:** String values are automatically converted:\n- `'true'` / `'false'` \u2192 `boolean`\n- Numeric strings \u2192 `number`\n- Empty strings \u2192 `null`\n\n## ConfigRegistry\n\nA static global registry that collects all declared config keys at module initialization.\n\n```typescript\nexport class ConfigRegistry {\n\n  // Register keys for a module\n  public static register(module: string, entries: ReadonlyArray<Omit<IConfigRegistryEntry, 'module'>>): void;\n\n  // Query all registered entries\n  public static getAll(): ReadonlyArray<IConfigRegistryEntry>;\n  public static getByModule(): ReadonlyMap<string, ReadonlyArray<IConfigRegistryEntry>>;\n  public static getRequired(): ReadonlyArray<IConfigRegistryEntry>;\n  public static getModules(): ReadonlyArray<string>;\n\n}\n```\n\n### IConfigRegistryEntry\n\n```typescript\nexport interface IConfigRegistryEntry<TType = unknown> {\n  readonly key: IConfigKey<TType>;\n  readonly module: string;\n  readonly required: boolean;\n  readonly defaultValue?: TType;\n  readonly description?: string;\n}\n```\n\n## How to Add Configuration to a Library\n\n### Step 1: Define typed config keys in env.ts\n\n```typescript\n// src/env.ts\nimport { createConfigKey } from '@breadstone/archipel-platform-core';\nimport { ConfigRegistry, IConfigRegistryEntry } from '@breadstone/archipel-platform-core';\n\n// \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n// Keys\n// \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport const STRIPE_SECRET_KEY = createConfigKey<string>('STRIPE_SECRET_KEY');\nexport const STRIPE_WEBHOOK_SECRET = createConfigKey<string>('STRIPE_WEBHOOK_SECRET');\nexport const PAYMENT_CURRENCY = createConfigKey<string>('PAYMENT_CURRENCY');\n\n// \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n// Registry entries\n// \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport const PLATFORM_PAYMENTS_CONFIG_ENTRIES: ReadonlyArray<Omit<IConfigRegistryEntry, 'module'>> = [\n  { key: STRIPE_SECRET_KEY, required: true, description: 'Stripe API secret key.' },\n  { key: STRIPE_WEBHOOK_SECRET, required: true, description: 'Stripe webhook signing secret.' },\n  { key: PAYMENT_CURRENCY, required: false, defaultValue: 'EUR', description: 'Default payment currency.' },\n];\n```\n\n### Step 2: Register in ConfigModule\n\n```typescript\n// In the module's register() method:\nimports: [ConfigModule.register('platform-payments', PLATFORM_PAYMENTS_CONFIG_ENTRIES)]\n```\n\nOr for libraries without a dedicated module (self-registration):\n\n```typescript\n// At the bottom of env.ts:\nConfigRegistry.register('platform-payments', PLATFORM_PAYMENTS_CONFIG_ENTRIES);\n```\n\n### Step 3: Use in services\n\n```typescript\n@Injectable()\nexport class StripeClient {\n\n  private readonly _configService: ConfigService;\n\n  public constructor(configService: ConfigService) {\n    this._configService = configService;\n  }\n\n  private getApiKey(): string {\n    return this._configService.get<string>('STRIPE_SECRET_KEY');\n  }\n\n}\n```\n\n## ConfigModule\n\n### register() \u2014 Per-library config registration\n\nDeclares which config keys a library needs. Used in `imports` of feature modules.\n\n```typescript\nConfigModule.register('platform-authentication', PLATFORM_AUTHENTICATION_CONFIG_ENTRIES)\n```\n\n### forRoot() \u2014 Application bootstrap\n\nConfigures the global strategy and static overrides. Used once in the root module.\n\n```typescript\nConfigModule.forRoot({\n  strategyFactory: () => new EnvironmentConfigStrategy(),\n  statics: { APP_VERSION: '1.0.0' },\n})\n```\n\n## ConfigStrategyBase\n\nPluggable strategy for resolving config values:\n\n```typescript\nexport abstract class ConfigStrategyBase {\n  public abstract initialize(): void;\n  public abstract resolve<T>(key: string): T;\n  public abstract tryResolve<T>(key: string, fallback: T): T;\n  public abstract has(key: string): boolean;\n}\n```\n\nImplementations can read from environment variables, Azure App Configuration, Consul, etc.\n\n## Existing Config Modules\n\n| Module | Prefix | Example Keys |\n|--------|--------|-------------|\n| platform-core | APP_, NODE_ENV, INTELLIGENCE_ | APP_URL, APP_PORT, APP_VERSION, INTELLIGENCE_MODEL |\n| platform-authentication | AUTH_ | AUTH_JWT_SECRET, AUTH_JWT_EXPIRES_IN |\n| platform-payments | STRIPE_ | STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET |\n| platform-openapi | SWAGGER_ | SWAGGER_CONTACT_NAME, SWAGGER_CONTACT_URL |\n\n## Rules\n\n1. **All config keys defined via `createConfigKey<T>()`** \u2014 never raw `process.env` access.\n2. **Each library declares entries in `env.ts`** with required flag, default value, and description.\n3. **Registration via `ConfigModule.register()`** in the module, or self-registration for libraries without modules.\n4. **`ConfigService.get()` throws on missing required keys** \u2014 fail-fast at startup.\n5. **Use `tryGet()` with fallback** for optional keys.\n6. **Config key names use UPPER_SNAKE_CASE** matching environment variable conventions.\n7. **Group related keys** with comment separators in env.ts.\n";