@breadstone/archipel-mcp 0.0.22 → 0.0.25

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

@@ -0,0 +1,78 @@
+---
+title: 'Class: TelemetryHealthIndicator'
+generated: true
+editUrl: false
+---
+# Class: TelemetryHealthIndicator
+
+Defined in: health/TelemetryHealthIndicator.ts:17
+
+Health indicator for the telemetry infrastructure.
+Checks whether the OpenTelemetry SDK has been initialized via [OtelSdkHolder](Class.OtelSdkHolder).
+
+## Implements
+
+- `IHealthIndicator`
+
+## Constructors
+
+### Constructor
+
+```ts
+new TelemetryHealthIndicator(sdkHolder?): TelemetryHealthIndicator;
+```
+
+Defined in: health/TelemetryHealthIndicator.ts:26
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `sdkHolder?` | [`OtelSdkHolder`](Class.OtelSdkHolder) |
+
+#### Returns
+
+`TelemetryHealthIndicator`
+
+## Properties
+
+### key
+
+```ts
+readonly key: string = 'telemetry';
+```
+
+Defined in: health/TelemetryHealthIndicator.ts:34
+
+Unique key identifying the indicator
+
+#### Implementation of
+
+```ts
+IHealthIndicator.key
+```
+
+## Methods
+
+### check()
+
+```ts
+check(): HealthIndicatorResult<string>;
+```
+
+Defined in: health/TelemetryHealthIndicator.ts:47
+
+Checks whether the OpenTelemetry SDK has been initialized.
+Returns disabled status when no SDK holder is configured.
+
+#### Returns
+
+`HealthIndicatorResult`\<`string`\>
+
+The health indicator result.
+
+#### Implementation of
+
+```ts
+IHealthIndicator.check
+```

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

@@ -14,6 +14,7 @@ editUrl: false
 | [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). |
 | [TelemetryFacade](Class.TelemetryFacade) | - |
+| [TelemetryHealthIndicator](Class.TelemetryHealthIndicator) | Health indicator for the telemetry infrastructure. Checks whether the OpenTelemetry SDK has been initialized via [OtelSdkHolder](Class.OtelSdkHolder). |
 | [TelemetryLoggerService](Class.TelemetryLoggerService) | - |
 | [TelemetryModule](Class.TelemetryModule) | - |
 | [TelemetryRuleEngine](Class.TelemetryRuleEngine) | - |

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

@@ -2,7 +2,7 @@
 title: platform-telemetry
 description: OpenTelemetry integration with tracing, metrics, and graceful no-op fallback.
 order: 11
-tags: [telemetry, opentelemetry, tracing, metrics, observability]
+tags: [telemetry, opentelemetry, tracing, metrics, observability, health]
 package: '@breadstone/archipel-platform-telemetry'
 ---
 
@@ -219,6 +219,29 @@ When `enabled: false` or when the OTEL SDK fails to initialize:
 
 ---
 
+## Health Check
+
+The `TelemetryHealthIndicator` verifies that the `OtelSdkHolder` is injected. If the OpenTelemetry SDK is not initialized, it reports `disabled: true`. Import it from the `/health` subpath:
+
+```typescript
+import { TelemetryHealthIndicator } from '@breadstone/archipel-platform-telemetry/health';
+import { HealthModule } from '@breadstone/archipel-platform-health';
+
+@Module({
+  imports: [
+    TelemetryModule,
+    HealthModule.withIndicators([TelemetryHealthIndicator]),
+  ],
+})
+export class AppModule {}
+```
+
+| Key | Check | Dependencies |
+| --- | ----- | ------------ |
+| `telemetry` | `up` if `OtelSdkHolder` injected, else `disabled` | `@Optional() OtelSdkHolder` |
+
+---
+
 ## Exports Summary
 
 | Export                          | Type          | Description                |
@@ -234,3 +257,4 @@ When `enabled: false` or when the OTEL SDK fails to initialize:
 | `TELEMETRY_ENABLED`             | Token         | Boolean enabled flag       |
 | `TELEMETRY_OPTIONS`             | Token         | Configuration options      |
 | `TELEMETRY_SHUTDOWN`            | Token         | Shutdown hook              |
+| `TelemetryHealthIndicator`      | Health        | Telemetry readiness check (`/health` subpath) |

package/data/patterns/config-pattern.md

@@ -18,7 +18,7 @@ Azure App Configuration, etc.).
 
 ## Core Types
 
-### IConfigKey<TType>
+### `IConfigKey<TType>`
 
 ```typescript
 export interface IConfigKey<TType = unknown> {
@@ -27,7 +27,7 @@ export interface IConfigKey<TType = unknown> {
 }
 ```
 
-### createConfigKey<TType>
+### `createConfigKey<TType>`
 
 ```typescript
 import { createConfigKey } from '@breadstone/archipel-platform-core';
@@ -194,8 +194,10 @@ Implementations can read from environment variables, Azure App Configuration, Co
 |--------|--------|-------------|
 | platform-core | APP_, NODE_ENV, INTELLIGENCE_ | APP_URL, APP_PORT, APP_VERSION, INTELLIGENCE_MODEL |
 | platform-authentication | AUTH_ | AUTH_JWT_SECRET, AUTH_JWT_EXPIRES_IN |
-| platform-payments | STRIPE_ | STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET |
+| platform-payments | STRIPE_, PADDLE_, LEMONSQUEEZY_, MOLLIE_ | STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET |
 | platform-openapi | SWAGGER_ | SWAGGER_CONTACT_NAME, SWAGGER_CONTACT_URL |
+| platform-caching | CACHE_, REDIS_ | CACHE_DEFAULT_TTL_MS, CACHE_MAX_ENTRIES, REDIS_URL |
+| platform-logging | APP_LOG_LEVEL | APP_LOG_LEVEL |
 
 ## Rules
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@breadstone/archipel-mcp",
-  "version": "0.0.22",
-  "description": "MCP server providing Archipel platform knowledge — documentation, query patterns, and coding conventions — to AI development tools.",
+  "version": "0.0.25",
+  "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",

package/src/tools/registerGetConfigPatternTool.js

@@ -5,7 +5,7 @@ exports.registerGetConfigPatternTool = registerGetConfigPatternTool;
  * Registers the get-config-pattern tool on the MCP 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 () => {
+    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 {

package/src/tools/registerGetDtoPatternTool.js

@@ -5,7 +5,7 @@ exports.registerGetDtoPatternTool = registerGetDtoPatternTool;
  * Registers the get-dto-pattern tool on the MCP 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 () => {
+    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 {

package/src/tools/registerGetErrorHandlingPatternTool.js

@@ -5,7 +5,7 @@ exports.registerGetErrorHandlingPatternTool = registerGetErrorHandlingPatternToo
  * Registers the get-error-handling-pattern tool on the MCP 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 () => {
+    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 {

package/src/tools/registerGetGuardPatternTool.js

@@ -5,7 +5,7 @@ exports.registerGetGuardPatternTool = registerGetGuardPatternTool;
  * Registers the get-guard-pattern tool on the MCP 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 () => {
+    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 {

package/src/tools/registerGetMappingPatternTool.js

@@ -7,7 +7,7 @@ const mappingPatternGenerator_1 = require("../generators/mappingPatternGenerator
  * Registers the get-mapping-pattern tool on the MCP 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.', {
+    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()
             .optional()

package/src/tools/registerGetModulePatternTool.js

@@ -7,7 +7,7 @@ const modulePatternGenerator_1 = require("../generators/modulePatternGenerator")
  * Registers the get-module-pattern tool on the MCP 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.', {
+    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()
             .optional()

package/src/tools/registerGetQueryPatternTool.js

@@ -7,7 +7,7 @@ const queryPatternGenerator_1 = require("../generators/queryPatternGenerator");
  * Registers the get-query-pattern tool on the MCP 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.', {
+    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()
             .optional()

package/src/tools/registerGetRepositoryPatternTool.js

@@ -7,7 +7,7 @@ const repositoryPatternGenerator_1 = require("../generators/repositoryPatternGen
  * Registers the get-repository-pattern tool on the MCP 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.', {
+    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()
             .optional()

package/src/tools/registerGetTestingPatternTool.js

@@ -5,7 +5,7 @@ exports.registerGetTestingPatternTool = registerGetTestingPatternTool;
  * Registers the get-testing-pattern tool on the MCP 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 () => {
+    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 {