@breadstone/archipel-mcp 0.0.15 → 0.0.16

package/data/packages/platform-intelligence/api/Variable.INTELLIGENCE_MAX_OUTPUT_TOKENS.md

@@ -0,0 +1,14 @@
+---
+title: 'Variable: INTELLIGENCE\_MAX\_OUTPUT\_TOKENS'
+generated: true
+editUrl: false
+---
+# Variable: INTELLIGENCE\_MAX\_OUTPUT\_TOKENS
+
+```ts
+const INTELLIGENCE_MAX_OUTPUT_TOKENS: IConfigKey<number>;
+```
+
+Defined in: [env.ts:21](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/env.ts#L21)
+
+Maximum number of output tokens for the AI model.

package/data/packages/platform-intelligence/api/Variable.INTELLIGENCE_MODEL.md

@@ -0,0 +1,14 @@
+---
+title: 'Variable: INTELLIGENCE\_MODEL'
+generated: true
+editUrl: false
+---
+# Variable: INTELLIGENCE\_MODEL
+
+```ts
+const INTELLIGENCE_MODEL: IConfigKey<string>;
+```
+
+Defined in: [env.ts:12](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/env.ts#L12)
+
+AI model identifier to use for text generation.

package/data/packages/platform-intelligence/api/Variable.INTELLIGENCE_PROVIDER.md

@@ -0,0 +1,14 @@
+---
+title: 'Variable: INTELLIGENCE\_PROVIDER'
+generated: true
+editUrl: false
+---
+# Variable: INTELLIGENCE\_PROVIDER
+
+```ts
+const INTELLIGENCE_PROVIDER: IConfigKey<string>;
+```
+
+Defined in: [env.ts:24](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/env.ts#L24)
+
+Intelligence provider name (e.g. openai, anthropic, google, grok).

package/data/packages/platform-intelligence/api/Variable.INTELLIGENCE_TEMPERATURE.md

@@ -0,0 +1,14 @@
+---
+title: 'Variable: INTELLIGENCE\_TEMPERATURE'
+generated: true
+editUrl: false
+---
+# Variable: INTELLIGENCE\_TEMPERATURE
+
+```ts
+const INTELLIGENCE_TEMPERATURE: IConfigKey<number>;
+```
+
+Defined in: [env.ts:15](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/env.ts#L15)
+
+Sampling temperature for the AI model.

package/data/packages/platform-intelligence/api/Variable.INTELLIGENCE_TOP_P.md

@@ -0,0 +1,14 @@
+---
+title: 'Variable: INTELLIGENCE\_TOP\_P'
+generated: true
+editUrl: false
+---
+# Variable: INTELLIGENCE\_TOP\_P
+
+```ts
+const INTELLIGENCE_TOP_P: IConfigKey<number>;
+```
+
+Defined in: [env.ts:18](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/env.ts#L18)
+
+Top-p (nucleus sampling) for the AI model.

package/data/packages/platform-intelligence/api/Variable.IntelligenceConversationMessageRoles.md

@@ -0,0 +1,26 @@
+---
+title: 'Variable: IntelligenceConversationMessageRoles'
+generated: true
+editUrl: false
+---
+# Variable: IntelligenceConversationMessageRoles
+
+```ts
+const IntelligenceConversationMessageRoles: {
+  Assistant: "assistant";
+  System: "system";
+  User: "user";
+};
+```
+
+Defined in: [contracts/IntelligenceConversationMessageRoles.ts:6](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IntelligenceConversationMessageRoles.ts#L6)
+
+Enumerates the conversation roles used for contextual snapshots and messages.
+
+## Type Declaration
+
+| Name | Type | Default value | Defined in |
+| ------ | ------ | ------ | ------ |
+| <a id="property-assistant"></a> `Assistant` | `"assistant"` | `'assistant'` | [contracts/IntelligenceConversationMessageRoles.ts:8](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IntelligenceConversationMessageRoles.ts#L8) |
+| <a id="property-system"></a> `System` | `"system"` | `'system'` | [contracts/IntelligenceConversationMessageRoles.ts:9](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IntelligenceConversationMessageRoles.ts#L9) |
+| <a id="property-user"></a> `User` | `"user"` | `'user'` | [contracts/IntelligenceConversationMessageRoles.ts:7](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IntelligenceConversationMessageRoles.ts#L7) |

package/data/packages/platform-intelligence/api/Variable.IntelligenceProviderNames.md

@@ -0,0 +1,28 @@
+---
+title: 'Variable: IntelligenceProviderNames'
+generated: true
+editUrl: false
+---
+# Variable: IntelligenceProviderNames
+
+```ts
+const IntelligenceProviderNames: {
+  Anthropic: "anthropic";
+  Google: "google";
+  Grok: "grok";
+  OpenAI: "openai";
+};
+```
+
+Defined in: [contracts/IntelligenceProviderNames.ts:6](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IntelligenceProviderNames.ts#L6)
+
+Enumerates the supported model providers powering the intelligence pipeline.
+
+## Type Declaration
+
+| Name | Type | Default value | Defined in |
+| ------ | ------ | ------ | ------ |
+| <a id="property-anthropic"></a> `Anthropic` | `"anthropic"` | `'anthropic'` | [contracts/IntelligenceProviderNames.ts:8](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IntelligenceProviderNames.ts#L8) |
+| <a id="property-google"></a> `Google` | `"google"` | `'google'` | [contracts/IntelligenceProviderNames.ts:9](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IntelligenceProviderNames.ts#L9) |
+| <a id="property-grok"></a> `Grok` | `"grok"` | `'grok'` | [contracts/IntelligenceProviderNames.ts:10](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IntelligenceProviderNames.ts#L10) |
+| <a id="property-openai"></a> `OpenAI` | `"openai"` | `'openai'` | [contracts/IntelligenceProviderNames.ts:7](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/contracts/IntelligenceProviderNames.ts#L7) |

package/data/packages/platform-intelligence/api/Variable.OPENAI_API_KEY.md

@@ -0,0 +1,14 @@
+---
+title: 'Variable: OPENAI\_API\_KEY'
+generated: true
+editUrl: false
+---
+# Variable: OPENAI\_API\_KEY
+
+```ts
+const OPENAI_API_KEY: IConfigKey<string>;
+```
+
+Defined in: [env.ts:33](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/env.ts#L33)
+
+OpenAI-specific API key.

package/data/packages/platform-intelligence/api/Variable.OPENAI_BASE_URL.md

@@ -0,0 +1,14 @@
+---
+title: 'Variable: OPENAI\_BASE\_URL'
+generated: true
+editUrl: false
+---
+# Variable: OPENAI\_BASE\_URL
+
+```ts
+const OPENAI_BASE_URL: IConfigKey<string>;
+```
+
+Defined in: [env.ts:36](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/env.ts#L36)
+
+OpenAI-specific base URL.

package/data/packages/platform-intelligence/api/Variable.PLATFORM_INTELLIGENCE_CONFIG_ENTRIES.md

@@ -0,0 +1,14 @@
+---
+title: 'Variable: PLATFORM\_INTELLIGENCE\_CONFIG\_ENTRIES'
+generated: true
+editUrl: false
+---
+# Variable: PLATFORM\_INTELLIGENCE\_CONFIG\_ENTRIES
+
+```ts
+const PLATFORM_INTELLIGENCE_CONFIG_ENTRIES: ReadonlyArray<Omit<IConfigRegistryEntry, "module">>;
+```
+
+Defined in: [env.ts:70](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/env.ts#L70)
+
+All configuration entries required by `platform-intelligence`.

package/data/packages/platform-intelligence/api/Variable.XAI_API_KEY.md

@@ -0,0 +1,14 @@
+---
+title: 'Variable: XAI\_API\_KEY'
+generated: true
+editUrl: false
+---
+# Variable: XAI\_API\_KEY
+
+```ts
+const XAI_API_KEY: IConfigKey<string>;
+```
+
+Defined in: [env.ts:57](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/env.ts#L57)
+
+X.AI-specific API key (alias for Grok).

package/data/packages/platform-intelligence/api/Variable.XAI_BASE_URL.md

@@ -0,0 +1,14 @@
+---
+title: 'Variable: XAI\_BASE\_URL'
+generated: true
+editUrl: false
+---
+# Variable: XAI\_BASE\_URL
+
+```ts
+const XAI_BASE_URL: IConfigKey<string>;
+```
+
+Defined in: [env.ts:63](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-intelligence/src/env.ts#L63)
+
+X.AI-specific base URL (alias for Grok).

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

@@ -0,0 +1,89 @@
+---
+title: '@breadstone/archipel-platform-intelligence'
+generated: true
+editUrl: false
+---
+# @breadstone/archipel-platform-intelligence
+
+## Classes
+
+| Class | Description |
+| ------ | ------ |
+| [IntelligenceCapabilityRegistrarBase](Class.IntelligenceCapabilityRegistrarBase) | Provides a reusable registration flow that allows feature modules to contribute capabilities to the global intelligence registry while keeping their implementation details private. |
+| [IntelligenceCapabilityRegistry](Class.IntelligenceCapabilityRegistry) | Central registry responsible for resolving intelligence capabilities based on intent metadata. |
+| [IntelligenceModule](Class.IntelligenceModule) | Core module exposing the shared intelligence infrastructure to feature modules. |
+| [IntelligenceProviderError](Class.IntelligenceProviderError) | Error thrown when an intelligence provider call fails. |
+| [IntelligenceTextGenerator](Class.IntelligenceTextGenerator) | Executes text completions using the configured intelligence provider. |
+
+## Interfaces
+
+| Interface | Description |
+| ------ | ------ |
+| [IIntelligenceArtifact](Interface.IIntelligenceArtifact) | Represents a structured artifact returned by a capability. |
+| [IIntelligenceCapability](Interface.IIntelligenceCapability) | Abstraction implemented by all capability providers. |
+| [IIntelligenceCapabilityMetadata](Interface.IIntelligenceCapabilityMetadata) | Metadata describing a capability for orchestration and analytics purposes. |
+| [IIntelligenceCapabilityPayload](Interface.IIntelligenceCapabilityPayload) | Payload forwarded to capabilities for execution. |
+| [IIntelligenceCapabilityRegistry](Interface.IIntelligenceCapabilityRegistry) | Registry abstraction responsible for resolving capabilities. |
+| [IIntelligenceCapabilityResult](Interface.IIntelligenceCapabilityResult) | Represents the outcome produced by a capability execution. |
+| [IIntelligenceCompletionUsage](Interface.IIntelligenceCompletionUsage) | Captures usage telemetry returned by the intelligence provider. |
+| [IIntelligenceContext](Interface.IIntelligenceContext) | Describes the context aggregated before routing a request to a capability. |
+| [IIntelligenceContextBuilder](Interface.IIntelligenceContextBuilder) | Responsible for composing the context supplied to capabilities. |
+| [IIntelligenceConversationMessageSnapshot](Interface.IIntelligenceConversationMessageSnapshot) | Represents a single message returned within a conversation snapshot. |
+| [IIntelligenceConversationSnapshot](Interface.IIntelligenceConversationSnapshot) | Represents a lightweight snapshot of a conversation used for context building. |
+| [IIntelligenceFollowUpQuestion](Interface.IIntelligenceFollowUpQuestion) | Represents a follow-up question suggested to keep the dialogue active. |
+| [IIntelligenceIntent](Interface.IIntelligenceIntent) | Represents the structured intent resolved from a user message. |
+| [IIntelligenceIntentEntity](Interface.IIntelligenceIntentEntity) | Represents an entity extracted from a resolved intelligence intent. |
+| [IIntelligenceMessageModel](Interface.IIntelligenceMessageModel) | Represents a normalized message stored in persistence. |
+| [IIntelligenceMessagePayload](Interface.IIntelligenceMessagePayload) | Carries the payload submitted when messaging the intelligence entrypoint. |
+| [IIntelligencePrompt](Interface.IIntelligencePrompt) | Represents the input supplied to the intelligence text generator. |
+| [IIntelligencePromptMessage](Interface.IIntelligencePromptMessage) | Describes a normalized message used for text generation prompts. |
+| [IIntelligenceProviderConfiguration](Interface.IIntelligenceProviderConfiguration) | Describes the resolved configuration for the intelligence provider. |
+| [IIntelligenceResponseMessage](Interface.IIntelligenceResponseMessage) | Represents a single assistant message returned by a capability. |
+| [IIntelligenceTextCompletion](Interface.IIntelligenceTextCompletion) | Represents the normalized completion result produced by the intelligence provider. |
+| [IIntelligenceTextGenerationOptions](Interface.IIntelligenceTextGenerationOptions) | Options that can be supplied when generating text with the intelligence provider. |
+| [IIntelligenceTextGenerator](Interface.IIntelligenceTextGenerator) | Abstraction responsible for executing text completions using the configured provider. |
+
+## Type Aliases
+
+| Type Alias | Description |
+| ------ | ------ |
+| [IntelligenceConversationMessageRole](TypeAlias.IntelligenceConversationMessageRole) | Represents the union of supported conversation message roles. |
+| [IntelligenceLanguageModelLoader](TypeAlias.IntelligenceLanguageModelLoader) | Represents a factory responsible for resolving a configured language model instance. |
+| [IntelligenceProviderName](TypeAlias.IntelligenceProviderName) | Represents the union of supported intelligence provider identifiers. |
+
+## Variables
+
+| Variable | Description |
+| ------ | ------ |
+| [ANTHROPIC\_API\_KEY](Variable.ANTHROPIC_API_KEY) | Anthropic-specific API key. |
+| [ANTHROPIC\_BASE\_URL](Variable.ANTHROPIC_BASE_URL) | Anthropic-specific base URL. |
+| [GEMINI\_API\_KEY](Variable.GEMINI_API_KEY) | Google-specific Gemini API key. |
+| [GOOGLE\_API\_KEY](Variable.GOOGLE_API_KEY) | Google-specific API key. |
+| [GOOGLE\_BASE\_URL](Variable.GOOGLE_BASE_URL) | Google-specific base URL. |
+| [GROK\_API\_KEY](Variable.GROK_API_KEY) | Grok-specific API key. |
+| [GROK\_BASE\_URL](Variable.GROK_BASE_URL) | Grok-specific base URL. |
+| [INTELLIGENCE\_API\_KEY](Variable.INTELLIGENCE_API_KEY) | Global API key override for the intelligence provider. |
+| [INTELLIGENCE\_BASE\_URL](Variable.INTELLIGENCE_BASE_URL) | Global base URL override for the intelligence provider. |
+| [INTELLIGENCE\_MAX\_OUTPUT\_TOKENS](Variable.INTELLIGENCE_MAX_OUTPUT_TOKENS) | Maximum number of output tokens for the AI model. |
+| [INTELLIGENCE\_MODEL](Variable.INTELLIGENCE_MODEL) | AI model identifier to use for text generation. |
+| [INTELLIGENCE\_PROVIDER](Variable.INTELLIGENCE_PROVIDER) | Intelligence provider name (e.g. openai, anthropic, google, grok). |
+| [INTELLIGENCE\_TEMPERATURE](Variable.INTELLIGENCE_TEMPERATURE) | Sampling temperature for the AI model. |
+| [INTELLIGENCE\_TOP\_P](Variable.INTELLIGENCE_TOP_P) | Top-p (nucleus sampling) for the AI model. |
+| [IntelligenceConversationMessageRoles](Variable.IntelligenceConversationMessageRoles) | Enumerates the conversation roles used for contextual snapshots and messages. |
+| [IntelligenceProviderNames](Variable.IntelligenceProviderNames) | Enumerates the supported model providers powering the intelligence pipeline. |
+| [OPENAI\_API\_KEY](Variable.OPENAI_API_KEY) | OpenAI-specific API key. |
+| [OPENAI\_BASE\_URL](Variable.OPENAI_BASE_URL) | OpenAI-specific base URL. |
+| [PLATFORM\_INTELLIGENCE\_CONFIG\_ENTRIES](Variable.PLATFORM_INTELLIGENCE_CONFIG_ENTRIES) | All configuration entries required by `platform-intelligence`. |
+| [XAI\_API\_KEY](Variable.XAI_API_KEY) | X.AI-specific API key (alias for Grok). |
+| [XAI\_BASE\_URL](Variable.XAI_BASE_URL) | X.AI-specific base URL (alias for Grok). |
+
+## Functions
+
+| Function | Description |
+| ------ | ------ |
+| [createProviderOptions](Function.createProviderOptions) | Creates the provider options object consumed by the AI SDK model factories. |
+| [loadAnthropicLanguageModel](Function.loadAnthropicLanguageModel) | Loads the Anthropic language model based on the resolved provider configuration. |
+| [loadGoogleLanguageModel](Function.loadGoogleLanguageModel) | Loads the Google (Gemini) language model based on the resolved provider configuration. |
+| [loadGrokLanguageModel](Function.loadGrokLanguageModel) | Loads the Grok (xAI) language model based on the resolved provider configuration. |
+| [loadOpenAILanguageModel](Function.loadOpenAILanguageModel) | Loads the OpenAI compatible language model based on the resolved provider configuration. |
+| [loadProviderFactory](Function.loadProviderFactory) | Dynamically loads an AI SDK provider factory and returns the exported function reference. |

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

@@ -0,0 +1,155 @@
+---
+title: platform-intelligence
+description: Multi-provider AI text generation with capability registry and intent-based orchestration.
+order: 16
+tags: [intelligence, ai, openai, anthropic, google, grok, text-generation, capability-registry]
+package: '@breadstone/archipel-platform-intelligence'
+---
+
+# platform-intelligence
+
+Multi-provider AI text generation library supporting OpenAI, Anthropic, Google Generative AI, and Grok. Features a capability registry that maps business intents to provider-specific configurations, enabling intent-based orchestration without coupling consumers to a specific LLM.
+
+**Package:** `@breadstone/archipel-platform-intelligence`
+
+## Quick Start
+
+```typescript
+import { Module } from '@nestjs/common';
+import { IntelligenceModule } from '@breadstone/archipel-platform-intelligence';
+
+@Module({
+  imports: [IntelligenceModule],
+})
+export class AppModule {}
+```
+
+---
+
+## Provider Packages
+
+Install only the providers you need:
+
+| Provider  | Package                                                |
+| --------- | ------------------------------------------------------ |
+| OpenAI    | `@breadstone/archipel-platform-intelligence/openai`    |
+| Anthropic | `@breadstone/archipel-platform-intelligence/anthropic` |
+| Google    | `@breadstone/archipel-platform-intelligence/google`    |
+| Grok      | `@breadstone/archipel-platform-intelligence/grok`      |
+
+---
+
+## Text Generation
+
+Inject `IntelligenceTextGenerator` and call `generateText()`:
+
+```typescript
+import { Injectable } from '@nestjs/common';
+import { IntelligenceTextGenerator, IIntelligencePrompt } from '@breadstone/archipel-platform-intelligence';
+
+@Injectable()
+export class SummaryService {
+  constructor(private readonly _textGenerator: IntelligenceTextGenerator) {}
+
+  async summarize(content: string): Promise<string> {
+    const prompt: IIntelligencePrompt = {
+      system: 'You are a concise summarizer.',
+      messages: [{ role: 'user', content }],
+    };
+
+    const result = await this._textGenerator.generateText(prompt, {
+      provider: 'openai',
+      model: 'gpt-4o',
+      temperature: 0.3,
+    });
+
+    return result.text;
+  }
+}
+```
+
+---
+
+## Capability Registry
+
+The capability registry decouples consumers from specific providers and models by mapping business intents to configurations.
+
+### Defining Capabilities
+
+```typescript
+import { IIntelligenceCapability } from '@breadstone/archipel-platform-intelligence';
+
+const SUMMARIZE_CAPABILITY: IIntelligenceCapability = {
+  intent: 'summarize',
+  provider: 'openai',
+  model: 'gpt-4o',
+  temperature: 0.3,
+  maxTokens: 1024,
+};
+```
+
+### Registering via IntelligenceCapabilityRegistrarBase
+
+```typescript
+import { Injectable } from '@nestjs/common';
+import {
+  IntelligenceCapabilityRegistrarBase,
+  IIntelligenceCapabilityRegistry,
+} from '@breadstone/archipel-platform-intelligence';
+
+@Injectable()
+export class AppCapabilityRegistrar extends IntelligenceCapabilityRegistrarBase {
+  protected registerCapabilities(registry: IIntelligenceCapabilityRegistry): void {
+    registry.register(SUMMARIZE_CAPABILITY);
+    registry.register(TRANSLATE_CAPABILITY);
+  }
+}
+```
+
+### Resolving at Runtime
+
+```typescript
+const capability = this._registry.resolve('summarize');
+const result = await this._textGenerator.generateText(prompt, capability);
+```
+
+---
+
+## Environment Variables
+
+| Variable                         | Description                  | Required           |
+| -------------------------------- | ---------------------------- | ------------------ |
+| `INTELLIGENCE_OPENAI_API_KEY`    | OpenAI API key               | If using OpenAI    |
+| `INTELLIGENCE_ANTHROPIC_API_KEY` | Anthropic API key            | If using Anthropic |
+| `INTELLIGENCE_GOOGLE_API_KEY`    | Google Generative AI API key | If using Google    |
+| `INTELLIGENCE_GROK_API_KEY`      | Grok / xAI API key           | If using Grok      |
+
+---
+
+## Timeout & Retry
+
+All `generateText()` calls include built-in resilience:
+
+| Setting     | Default  | Description                                              |
+| ----------- | -------- | -------------------------------------------------------- |
+| `timeoutMs` | `30000`  | Abort the provider request after this many milliseconds  |
+| Max retries | `2`      | Retryable errors are retried with exponential backoff    |
+| Backoff     | 1s → 4s  | Exponential with a 4-second cap                          |
+
+Override the timeout per call via the options parameter:
+
+```typescript
+const result = await this._textGenerator.generateText(prompt, {
+  provider: 'openai',
+  model: 'gpt-4o',
+  timeoutMs: 15_000, // 15-second timeout
+});
+```
+
+All errors are wrapped in `IntelligenceProviderError` with `provider`, `model`, and `retryable` metadata.
+
+---
+
+## API Reference
+
+See the full [API documentation](./api/) for all exported types, interfaces, and classes.

package/data/packages/platform-logging/api/Class.LoggerModule.md

@@ -0,0 +1,22 @@
+---
+title: 'Class: LoggerModule'
+generated: true
+editUrl: false
+---
+# Class: LoggerModule
+
+Defined in: [LoggerModule.ts:31](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-logging/src/LoggerModule.ts#L31)
+
+Global logging module that configures the NestJS Logger with an application-wide log level.
+
+## Constructors
+
+### Constructor
+
+```ts
+new LoggerModule(): LoggerModule;
+```
+
+#### Returns
+
+`LoggerModule`

package/data/packages/platform-logging/api/Variable.APP_LOG_LEVEL.md

@@ -0,0 +1,14 @@
+---
+title: 'Variable: APP\_LOG\_LEVEL'
+generated: true
+editUrl: false
+---
+# Variable: APP\_LOG\_LEVEL
+
+```ts
+const APP_LOG_LEVEL: IConfigKey<string>;
+```
+
+Defined in: [env.ts:12](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-logging/src/env.ts#L12)
+
+Application log level (e.g. `'debug'`, `'info'`, `'warn'`, `'error'`).

package/data/packages/platform-logging/api/Variable.PLATFORM_LOGGING_CONFIG_ENTRIES.md

@@ -0,0 +1,14 @@
+---
+title: 'Variable: PLATFORM\_LOGGING\_CONFIG\_ENTRIES'
+generated: true
+editUrl: false
+---
+# Variable: PLATFORM\_LOGGING\_CONFIG\_ENTRIES
+
+```ts
+const PLATFORM_LOGGING_CONFIG_ENTRIES: ReadonlyArray<Omit<IConfigRegistryEntry, "module">>;
+```
+
+Defined in: [env.ts:19](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-logging/src/env.ts#L19)
+
+All configuration entries required by `platform-logging`.

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

@@ -0,0 +1,19 @@
+---
+title: '@breadstone/archipel-platform-logging'
+generated: true
+editUrl: false
+---
+# @breadstone/archipel-platform-logging
+
+## Classes
+
+| Class | Description |
+| ------ | ------ |
+| [LoggerModule](Class.LoggerModule) | Global logging module that configures the NestJS Logger with an application-wide log level. |
+
+## Variables
+
+| Variable | Description |
+| ------ | ------ |
+| [APP\_LOG\_LEVEL](Variable.APP_LOG_LEVEL) | Application log level (e.g. `'debug'`, `'info'`, `'warn'`, `'error'`). |
+| [PLATFORM\_LOGGING\_CONFIG\_ENTRIES](Variable.PLATFORM_LOGGING_CONFIG_ENTRIES) | All configuration entries required by `platform-logging`. |

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

@@ -0,0 +1,92 @@
+---
+title: platform-logging
+description: Sentry integration for error tracking and analytics.
+order: 6
+tags: [logging, sentry, error-tracking, analytics]
+package: '@breadstone/archipel-platform-logging'
+---
+
+# platform-logging
+
+Sentry integration for centralized error tracking and analytics. Provides structured error reporting with context enrichment.
+
+**Package:** `@breadstone/archipel-platform-logging`
+
+## Quick Start
+
+```typescript
+import { Module } from '@nestjs/common';
+import { LoggerModule } from '@breadstone/archipel-platform-logging';
+
+@Module({
+  imports: [LoggerModule],
+})
+export class AppModule {}
+```
+
+---
+
+## AnalyticsService
+
+Central service for error and event reporting to Sentry.
+
+```typescript
+import { AnalyticsService } from '@breadstone/archipel-platform-logging';
+
+@Injectable()
+export class PaymentService {
+  constructor(private readonly _analytics: AnalyticsService) {}
+
+  public async processPayment(orderId: string): Promise<void> {
+    try {
+      // ... payment logic
+    } catch (error) {
+      this._analytics.captureException(error, {
+        tags: { module: 'payments', orderId },
+      });
+      throw error;
+    }
+  }
+}
+```
+
+---
+
+## Environment Variables
+
+| Variable                    | Description                                          | Required |
+| --------------------------- | ---------------------------------------------------- | -------- |
+| `SENTRY_DSN`                | Sentry Data Source Name                              | Yes      |
+| `SENTRY_ENVIRONMENT`        | Environment label (e.g. `'production'`, `'staging'`) | No       |
+| `SENTRY_TRACES_SAMPLE_RATE` | Sampling rate for performance traces (0.0–1.0)       | No       |
+
+---
+
+## Real-World Example: Global Error Filter
+
+```typescript
+import { Catch, type ExceptionFilter, type ArgumentsHost } from '@nestjs/common';
+import { AnalyticsService } from '@breadstone/archipel-platform-logging';
+
+@Catch()
+export class GlobalExceptionFilter implements ExceptionFilter {
+  constructor(private readonly _analytics: AnalyticsService) {}
+
+  public catch(exception: unknown, host: ArgumentsHost): void {
+    this._analytics.captureException(exception);
+
+    const ctx = host.switchToHttp();
+    const response = ctx.getResponse();
+    response.status(500).json({ error: 'Internal Server Error' });
+  }
+}
+```
+
+---
+
+## Exports Summary
+
+| Export             | Type          | Description                      |
+| ------------------ | ------------- | -------------------------------- |
+| `LoggerModule`     | NestJS Module | Global Sentry integration        |
+| `AnalyticsService` | Service       | Error capture and event tracking |