@breadstone/archipel-mcp 0.0.19 → 0.0.21

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

@@ -7,10 +7,14 @@ editUrl: false
 
 Defined in: [metrics/MetricsService.ts:25](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/metrics/MetricsService.ts#L25)
 
-Provides lazily-initialized OpenTelemetry metric instruments.
+Provides eagerly-initialized OpenTelemetry metric instruments.
 
 Replaces the former module-level `let instruments` closure (TEL-4).
 
+## Implements
+
+- `OnModuleInit`
+
 ## Constructors
 
 ### Constructor
@@ -31,10 +35,32 @@ new MetricsService(): MetricsService;
 getInstruments(): IMetricInstruments | undefined;
 ```
 
-Defined in: [metrics/MetricsService.ts:38](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/metrics/MetricsService.ts#L38)
+Defined in: [metrics/MetricsService.ts:61](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/metrics/MetricsService.ts#L61)
 
-Returns the cached metric instruments, creating them on first access.
+Returns the cached metric instruments.
 
 #### Returns
 
 [`IMetricInstruments`](Interface.IMetricInstruments) \| `undefined`
+
+***
+
+### onModuleInit()
+
+```ts
+onModuleInit(): void;
+```
+
+Defined in: [metrics/MetricsService.ts:40](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/metrics/MetricsService.ts#L40)
+
+Eagerly initializes metric instruments at module startup.
+
+#### Returns
+
+`void`
+
+#### Implementation of
+
+```ts
+OnModuleInit.onModuleInit
+```

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

@@ -36,7 +36,7 @@ new OtelSdkHolder(): OtelSdkHolder;
 onApplicationShutdown(): Promise<void>;
 ```
 
-Defined in: [OtelSdkHolder.ts:34](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/OtelSdkHolder.ts#L34)
+Defined in: [OtelSdkHolder.ts:39](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/OtelSdkHolder.ts#L39)
 
 #### Returns
 
@@ -58,9 +58,10 @@ OnApplicationShutdown.onApplicationShutdown
 setSdk(sdk): void;
 ```
 
-Defined in: [OtelSdkHolder.ts:29](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/OtelSdkHolder.ts#L29)
+Defined in: [OtelSdkHolder.ts:30](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/OtelSdkHolder.ts#L30)
 
 Stores the SDK reference so it can be shut down later.
+Can only be called once — subsequent calls are ignored.
 
 #### Parameters
 

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

@@ -23,7 +23,7 @@ Defined in: [logger/TelemetryLoggerService.ts:5](https://github.com/RueDeRennes/
 new TelemetryLoggerService(ruleEngine?): TelemetryLoggerService;
 ```
 
-Defined in: [logger/TelemetryLoggerService.ts:12](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/logger/TelemetryLoggerService.ts#L12)
+Defined in: [logger/TelemetryLoggerService.ts:11](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/logger/TelemetryLoggerService.ts#L11)
 
 #### Parameters
 
@@ -49,7 +49,7 @@ ConsoleLogger.constructor
 debug(message, context?): void;
 ```
 
-Defined in: [logger/TelemetryLoggerService.ts:19](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/logger/TelemetryLoggerService.ts#L19)
+Defined in: [logger/TelemetryLoggerService.ts:30](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/logger/TelemetryLoggerService.ts#L30)
 
 Write a 'debug' level log, if the configured level allows for it.
 Prints to `stdout` with newline.
@@ -88,7 +88,7 @@ error(
    context?): void;
 ```
 
-Defined in: [logger/TelemetryLoggerService.ts:17](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/logger/TelemetryLoggerService.ts#L17)
+Defined in: [logger/TelemetryLoggerService.ts:22](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/logger/TelemetryLoggerService.ts#L22)
 
 Write an 'error' level log, if the configured level allows for it.
 Prints to `stderr` with newline.
@@ -125,7 +125,7 @@ ConsoleLogger.error
 log(message, context?): void;
 ```
 
-Defined in: [logger/TelemetryLoggerService.ts:16](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/logger/TelemetryLoggerService.ts#L16)
+Defined in: [logger/TelemetryLoggerService.ts:18](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/logger/TelemetryLoggerService.ts#L18)
 
 Write a 'log' level log, if the configured level allows for it.
 Prints to `stdout` with newline.
@@ -161,7 +161,7 @@ ConsoleLogger.log
 verbose(message, context?): void;
 ```
 
-Defined in: [logger/TelemetryLoggerService.ts:20](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/logger/TelemetryLoggerService.ts#L20)
+Defined in: [logger/TelemetryLoggerService.ts:34](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/logger/TelemetryLoggerService.ts#L34)
 
 Write a 'verbose' level log, if the configured level allows for it.
 Prints to `stdout` with newline.
@@ -197,7 +197,7 @@ ConsoleLogger.verbose
 warn(message, context?): void;
 ```
 
-Defined in: [logger/TelemetryLoggerService.ts:18](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/logger/TelemetryLoggerService.ts#L18)
+Defined in: [logger/TelemetryLoggerService.ts:26](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/logger/TelemetryLoggerService.ts#L26)
 
 Write a 'warn' level log, if the configured level allows for it.
 Prints to `stdout` with newline.

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

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: TelemetryRuleEngine
 
-Defined in: [rules/TelemetryRuleEngine.ts:11](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/rules/TelemetryRuleEngine.ts#L11)
+Defined in: [rules/TelemetryRuleEngine.ts:12](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/rules/TelemetryRuleEngine.ts#L12)
 
 ## Constructors
 
@@ -15,7 +15,7 @@ Defined in: [rules/TelemetryRuleEngine.ts:11](https://github.com/RueDeRennes/arc
 new TelemetryRuleEngine(options, metricsService): TelemetryRuleEngine;
 ```
 
-Defined in: [rules/TelemetryRuleEngine.ts:18](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/rules/TelemetryRuleEngine.ts#L18)
+Defined in: [rules/TelemetryRuleEngine.ts:20](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/rules/TelemetryRuleEngine.ts#L20)
 
 #### Parameters
 
@@ -36,7 +36,7 @@ Defined in: [rules/TelemetryRuleEngine.ts:18](https://github.com/RueDeRennes/arc
 process(message): void;
 ```
 
-Defined in: [rules/TelemetryRuleEngine.ts:25](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/rules/TelemetryRuleEngine.ts#L25)
+Defined in: [rules/TelemetryRuleEngine.ts:27](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-telemetry/src/rules/TelemetryRuleEngine.ts#L27)
 
 #### Parameters
 

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

@@ -9,7 +9,7 @@ editUrl: false
 
 | Class | Description |
 | ------ | ------ |
-| [MetricsService](Class.MetricsService) | Provides lazily-initialized OpenTelemetry metric instruments. |
+| [MetricsService](Class.MetricsService) | Provides eagerly-initialized OpenTelemetry metric instruments. |
 | [NoopTelemetryFacade](Class.NoopTelemetryFacade) | - |
 | [OtelSdkHolder](Class.OtelSdkHolder) | Holds a reference to the OpenTelemetry NodeSDK instance and performs a graceful shutdown when the application terminates. |
 | [TelemetryCacheMetricsRecorder](Class.TelemetryCacheMetricsRecorder) | Generic cache metrics recorder that forwards cache lifecycle events into the telemetry facade (which may be a noop when disabled). |

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

@@ -164,7 +164,9 @@ The module initializes these OTEL components:
 | Metrics exporter        | OTLP/HTTP                                |
 | Express instrumentation | `@opentelemetry/instrumentation-express` |
 | HTTP instrumentation    | `@opentelemetry/instrumentation-http`    |
-| SDK shutdown hook       | Graceful on `OnModuleDestroy`            |
+| SDK shutdown hook       | Graceful on `OnModuleDestroy` (5-second timeout) |
+| SDK init guard          | `OtelSdkHolder` write-once — prevents double-init |
+| Metric instruments      | Eager init via `MetricsService.onModuleInit()`     |
 
 ---
 

package/package.json

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