@breadstone/archipel-mcp 0.0.45 → 0.0.47

package/data/packages/platform-bootstrap/api/Interface.ICreateWithCompositionOptions.md

@@ -0,0 +1,128 @@
+---
+title: 'Interface: ICreateWithCompositionOptions\<TApplication\>'
+generated: true
+editUrl: false
+---
+# Interface: ICreateWithCompositionOptions\<TApplication\>
+
+Defined in: [application/PlatformApplicationBuilder.ts:22](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-bootstrap/src/application/PlatformApplicationBuilder.ts#L22)
+
+Options for creating a composed application.
+
+## Type Parameters
+
+| Type Parameter | Default type |
+| ------ | ------ |
+| `TApplication` *extends* `INestApplication` | `INestApplication` |
+
+## Properties
+
+### adapter?
+
+```ts
+readonly optional adapter?: unknown;
+```
+
+Defined in: [application/PlatformApplicationBuilder.ts:70](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-bootstrap/src/application/PlatformApplicationBuilder.ts#L70)
+
+Custom HTTP adapter to use.
+
+#### Example
+
+```typescript
+import { ExpressAdapter } from '@nestjs/platform-express';
+
+const builder = await PlatformApplicationBuilder.createWithComposition({
+    adapter: new ExpressAdapter(),
+    // ...
+});
+```
+
+***
+
+### appFactory?
+
+```ts
+readonly optional appFactory?: (composedModule) => Promise<TApplication>;
+```
+
+Defined in: [application/PlatformApplicationBuilder.ts:91](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-bootstrap/src/application/PlatformApplicationBuilder.ts#L91)
+
+Factory function that creates the application type.
+
+If provided, this takes precedence over the default `NestFactory.create()` call.
+Use this for custom application types or adapters.
+
+#### Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `composedModule` | `DynamicModule` |
+
+#### Returns
+
+`Promise`\<`TApplication`\>
+
+#### Example
+
+```typescript
+const builder = await PlatformApplicationBuilder.createWithComposition({
+    appFactory: (module) => NestFactory.create<NestExpressApplication>(
+        module,
+        new ExpressAdapter()
+    ),
+    // ...
+});
+```
+
+***
+
+### compositionModule?
+
+```ts
+readonly optional compositionModule?: Type<unknown>;
+```
+
+Defined in: [application/PlatformApplicationBuilder.ts:30](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-bootstrap/src/application/PlatformApplicationBuilder.ts#L30)
+
+Custom composition module that provides the composition services.
+
+If not provided, the default [CompositionModule](Class.CompositionModule) is used.
+
+***
+
+### enableCompositionLogging?
+
+```ts
+readonly optional enableCompositionLogging?: boolean;
+```
+
+Defined in: [application/PlatformApplicationBuilder.ts:39](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-bootstrap/src/application/PlatformApplicationBuilder.ts#L39)
+
+Whether to enable logging for the composition context.
+
+Defaults to `false`.
+
+***
+
+### nestOptions?
+
+```ts
+readonly optional nestOptions?: NestApplicationOptions;
+```
+
+Defined in: [application/PlatformApplicationBuilder.ts:46](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-bootstrap/src/application/PlatformApplicationBuilder.ts#L46)
+
+NestJS application options passed to `NestFactory.create()`.
+
+***
+
+### platformOptions?
+
+```ts
+readonly optional platformOptions?: IPlatformApplicationOptions;
+```
+
+Defined in: [application/PlatformApplicationBuilder.ts:53](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-bootstrap/src/application/PlatformApplicationBuilder.ts#L53)
+
+Platform application options for the builder.

package/data/packages/platform-bootstrap/api/Interface.IProviderDecision.md

@@ -0,0 +1,36 @@
+---
+title: 'Interface: IProviderDecision'
+generated: true
+editUrl: false
+---
+# Interface: IProviderDecision
+
+Defined in: composition/types/IProviderDecision.ts:12
+
+Represents the result of a provider composition decision.
+
+## Properties
+
+### imports
+
+```ts
+readonly imports: readonly CompositionImport[];
+```
+
+Defined in: composition/types/IProviderDecision.ts:27
+
+The modules to import when [shouldImport](#shouldimport) is `true`.
+
+When [shouldImport](#shouldimport) is `false`, this array should be empty or omitted.
+
+***
+
+### shouldImport
+
+```ts
+readonly shouldImport: boolean;
+```
+
+Defined in: composition/types/IProviderDecision.ts:18
+
+Whether the provider should be imported into the application module graph.

package/data/packages/platform-bootstrap/api/TypeAlias.CompositionImport.md

@@ -0,0 +1,20 @@
+---
+title: 'Type Alias: CompositionImport'
+generated: true
+editUrl: false
+---
+# Type Alias: CompositionImport
+
+```ts
+type CompositionImport = 
+  | Type<unknown>
+  | DynamicModule
+  | Promise<DynamicModule>
+| ForwardReference<unknown>;
+```
+
+Defined in: composition/types/CompositionImport.ts:14
+
+Represents a valid NestJS module import that can be used during composition.
+
+This type mirrors the allowed import types in NestJS module metadata.

package/data/packages/platform-bootstrap/api/TypeAlias.ProviderComposer.md

@@ -0,0 +1,53 @@
+---
+title: 'Type Alias: ProviderComposer\<TContext\>'
+generated: true
+editUrl: false
+---
+# Type Alias: ProviderComposer\<TContext\>
+
+```ts
+type ProviderComposer<TContext> = (context) => Promise<IProviderDecision>;
+```
+
+Defined in: composition/types/ProviderComposer.ts:37
+
+Function signature for a provider composer.
+
+A provider composer is responsible for determining which modules should be
+imported based on the current composition context (configuration, stage, etc.).
+
+## Type Parameters
+
+| Type Parameter | Default type | Description |
+| ------ | ------ | ------ |
+| `TContext` *extends* [`ICompositionContext`](Interface.ICompositionContext) | [`ICompositionContext`](Interface.ICompositionContext) | The composition context type. Defaults to [ICompositionContext](Interface.ICompositionContext). |
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `context` | `TContext` |
+
+## Returns
+
+`Promise`\<[`IProviderDecision`](Interface.IProviderDecision)\>
+
+## Example
+
+```typescript
+const composeMailProvider: ProviderComposer = async (context) => {
+    const driver = context.config.tryGet('MAIL_DRIVER', 'log');
+
+    if (driver === 'smtp') {
+        const { MailModule } = await import('@breadstone/archipel-platform-mailing');
+        const { SmtpDeliveryStrategy } = await import('@breadstone/archipel-platform-mailing/delivering/smtp');
+
+        return {
+            shouldImport: true,
+            imports: [MailModule.register({ deliveryStrategy: SmtpDeliveryStrategy })]
+        };
+    }
+
+    return { shouldImport: false, imports: [] };
+};
+```

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

@@ -9,6 +9,9 @@ editUrl: false
 
 | Class | Description |
 | ------ | ------ |
+| [CompositionContext](Class.CompositionContext) | Default implementation of the composition context. |
+| [CompositionModule](Class.CompositionModule) | Minimal module providing configuration access for composition. |
+| [CompositionResolver](Class.CompositionResolver) | Abstract base class for composition-time feature resolution. |
 | [PlatformApplication](Class.PlatformApplication) | Entry point for composing an existing NestJS application with Archipel bootstrap steps. |
 | [PlatformApplicationBuilder](Class.PlatformApplicationBuilder) | Fluent builder that composes NestJS bootstrap steps and executes them once. |
 | [PlatformBootstrapContext](Class.PlatformBootstrapContext) | Runtime context shared by platform bootstrap steps. |
@@ -20,11 +23,15 @@ editUrl: false
 | ------ | ------ |
 | [IApiStepOptions](Interface.IApiStepOptions) | Options for the generic Archipel API bootstrap step. |
 | [IApiValidationOptions](Interface.IApiValidationOptions) | Validation options used by the generic Archipel API bootstrap step. |
+| [ICompositionContext](Interface.ICompositionContext) | Pre-bootstrap context for stage-aware module composition. |
+| [ICreateCompositionContextOptions](Interface.ICreateCompositionContextOptions) | Options for creating the composition context. |
+| [ICreateWithCompositionOptions](Interface.ICreateWithCompositionOptions) | Options for creating a composed application. |
 | [IExpressServerStepOptions](Interface.IExpressServerStepOptions) | Options for the Express-compatible server bootstrap step. |
 | [IOpenApiStepOptions](Interface.IOpenApiStepOptions) | Options for the OpenAPI bootstrap step. |
 | [IPlatformApplicationOptions](Interface.IPlatformApplicationOptions) | Options for wrapping an existing NestJS application with Archipel platform bootstrap support. |
 | [IPlatformListenOptions](Interface.IPlatformListenOptions) | Options for resolving the HTTP listen port from typed configuration keys. |
 | [IPlatformTestApplication](Interface.IPlatformTestApplication) | In-memory application contract used by platform bootstrap tests. |
+| [IProviderDecision](Interface.IProviderDecision) | Represents the result of a provider composition decision. |
 | [ISecurityStepOptions](Interface.ISecurityStepOptions) | Options for the generic security bootstrap step. |
 | [ISessionStepOptions](Interface.ISessionStepOptions) | Options for the Express-compatible session bootstrap step. |
 
@@ -32,10 +39,12 @@ editUrl: false
 
 | Type Alias | Description |
 | ------ | ------ |
+| [CompositionImport](TypeAlias.CompositionImport) | Represents a valid NestJS module import that can be used during composition. |
 | [PlatformBootstrapNext](TypeAlias.PlatformBootstrapNext) | Continues execution with the next platform bootstrap step. |
 | [PlatformBootstrapStep](TypeAlias.PlatformBootstrapStep) | A composable bootstrap step in the platform application pipeline. |
 | [PlatformContentSecurityPolicyMode](TypeAlias.PlatformContentSecurityPolicyMode) | Named content-security-policy modes supported by `platform-bootstrap/security`. |
 | [PlatformCorsOptions](TypeAlias.PlatformCorsOptions) | CORS options accepted by the security bootstrap step. |
+| [ProviderComposer](TypeAlias.ProviderComposer) | Function signature for a provider composer. |
 | [SecurityRateLimitOptions](TypeAlias.SecurityRateLimitOptions) | Rate-limit options accepted by the security bootstrap step. |
 
 ## Variables
@@ -57,6 +66,7 @@ editUrl: false
 
 | Function | Description |
 | ------ | ------ |
+| [createCompositionContext](Function.createCompositionContext) | Creates a temporary NestJS context for stage-aware module composition. |
 | [createPlatformTestApplication](Function.createPlatformTestApplication) | Creates a lightweight in-memory NestJS application double for platform bootstrap tests. |
 | [useApi](Function.useApi) | Creates the generic Archipel API bootstrap step. |
 | [useExpressServer](Function.useExpressServer) | Creates an Express-compatible server bootstrap step. |

package/data/packages/platform-cryptography/api/Class.OtpService.md

@@ -5,7 +5,7 @@ editUrl: false
 ---
 # Class: OtpService
 
-Defined in: [otp/OtpService.ts:45](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L45)
+Defined in: [otp/OtpService.ts:42](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L42)
 
 OTP service implementation backed by otplib v13.
 
@@ -25,7 +25,7 @@ the library version.
 new OtpService(options?): OtpService;
 ```
 
-Defined in: [otp/OtpService.ts:61](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L61)
+Defined in: [otp/OtpService.ts:57](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L57)
 
 Initializes a new instance of the `OtpService` class.
 
@@ -47,7 +47,7 @@ Initializes a new instance of the `OtpService` class.
 generateSecret(): string;
 ```
 
-Defined in: [otp/OtpService.ts:75](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L75)
+Defined in: [otp/OtpService.ts:66](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L66)
 
 Generates a cryptographically random secret suitable for TOTP.
 
@@ -69,7 +69,7 @@ The generated secret string.
 generateUri(options): string;
 ```
 
-Defined in: [otp/OtpService.ts:80](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L80)
+Defined in: [otp/OtpService.ts:71](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L71)
 
 Generates an `otpauth://` URI for QR code enrollment.
 
@@ -97,7 +97,7 @@ The formatted `otpauth://` URI.
 verify(token, secret): boolean;
 ```
 
-Defined in: [otp/OtpService.ts:92](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L92)
+Defined in: [otp/OtpService.ts:83](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L83)
 
 Verifies a TOTP token against the given secret.
 
@@ -132,7 +132,7 @@ verifyHotp(
 counter): Promise<boolean>;
 ```
 
-Defined in: [otp/OtpService.ts:99](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L99)
+Defined in: [otp/OtpService.ts:96](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L96)
 
 Verifies an HOTP (counter-based) token against the given secret and counter.
 

package/data/packages/platform-cryptography/api/Variable.TOTP_EPOCH_TOLERANCE.md

@@ -9,7 +9,7 @@ editUrl: false
 const TOTP_EPOCH_TOLERANCE: 30 = 30;
 ```
 
-Defined in: [otp/OtpService.ts:33](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L33)
+Defined in: [otp/OtpService.ts:30](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-cryptography/src/otp/OtpService.ts#L30)
 
 Default TOTP verification tolerance expressed in **seconds** (otplib v13 `epochTolerance`).
 

package/data/packages/platform-feature-flags/index.md

@@ -0,0 +1,103 @@
+---
+title: platform-feature-flags
+description: Provider-agnostic feature flag infrastructure for NestJS with support for Azure App Configuration and Vercel Edge Config.
+order: 3
+tags: [feature-flags, azure, vercel, edge-config, configuration]
+package: '@breadstone/archipel-platform-feature-flags'
+---
+
+# platform-feature-flags
+
+Provider-agnostic feature flag infrastructure for NestJS with support for Azure App Configuration and Vercel Edge Config.
+
+**Package:** `@breadstone/archipel-platform-feature-flags`
+
+<InstallTabs />
+
+## Provider Subpaths
+
+Import only the providers you need:
+
+| Provider                | Subpath                                              | SDK                                                                   |
+| ----------------------- | ---------------------------------------------------- | --------------------------------------------------------------------- |
+| Azure App Configuration | `@breadstone/archipel-platform-feature-flags/azure`  | `@azure/app-configuration-provider` + `@microsoft/feature-management` |
+| Vercel Edge Config      | `@breadstone/archipel-platform-feature-flags/vercel` | `@vercel/edge-config`                                                 |
+
+## Quick Start
+
+```typescript
+import { Module } from '@nestjs/common';
+import { FeatureFlagsModule } from '@breadstone/archipel-platform-feature-flags';
+import { AzureFeatureFlagsClient, AZURE_FEATURE_FLAGS_CONFIG_ENTRIES } from '@breadstone/archipel-platform-feature-flags/azure';
+
+@Module({
+  imports: [
+    FeatureFlagsModule.register({
+      client: AzureFeatureFlagsClient,
+      configEntries: AZURE_FEATURE_FLAGS_CONFIG_ENTRIES,
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+## Environment Variables
+
+### Azure App Configuration
+
+| Variable                                | Required | Description                                      |
+| --------------------------------------- | -------- | ------------------------------------------------ |
+| `AZURE_APP_CONFIGURATION_CONNECTION_STRING` | Yes      | Connection string for Azure App Configuration    |
+| `AZURE_FEATURE_FLAGS_LABEL`             | No       | Label filter for feature flags (e.g., `prod`)    |
+
+### Vercel Edge Config
+
+| Variable                | Required | Description                          |
+| ----------------------- | -------- | ------------------------------------ |
+| `EDGE_CONFIG`           | Yes      | Vercel Edge Config connection string |
+
+---
+
+## Checking Feature Flags
+
+```typescript
+import { Injectable } from '@nestjs/common';
+import { FeatureFlagsService } from '@breadstone/archipel-platform-feature-flags';
+
+@Injectable()
+export class MyService {
+  public constructor(private readonly _featureFlags: FeatureFlagsService) {}
+
+  public async doSomething(): Promise<void> {
+    const isEnabled = await this._featureFlags.isEnabled('my-feature');
+
+    if (isEnabled) {
+      // Feature is enabled
+    }
+  }
+}
+```
+
+---
+
+## Architecture
+
+```mermaid
+flowchart TB
+  subgraph FeatureFlagsModule
+    Service[FeatureFlagsService]
+    Port[FeatureFlagsClientPort]
+  end
+
+  subgraph Providers
+    Azure[AzureFeatureFlagsClient]
+    Vercel[VercelFeatureFlagsClient]
+  end
+
+  Service --> Port
+  Port -.-> Azure
+  Port -.-> Vercel
+
+  Azure --> AzureSDK[@azure/app-configuration-provider]
+  Vercel --> VercelSDK[@vercel/edge-config]
+```

package/data/packages/platform-mailing/api/Class.DeliveryStrategyBase.md

@@ -11,7 +11,6 @@ Represents the base class for all email delivery strategies.
 
 ## Extended by
 
-- [`LogDeliveryStrategy`](Class.LogDeliveryStrategy)
 - [`SmtpDeliveryStrategy`](Class.SmtpDeliveryStrategy)
 - [`PostmarkDeliveryStrategy`](Class.PostmarkDeliveryStrategy)
 - [`ResendDeliveryStrategy`](Class.ResendDeliveryStrategy)

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

@@ -13,7 +13,6 @@ editUrl: false
 | [DatabaseTemplateFetchStrategy](Class.DatabaseTemplateFetchStrategy) | Template fetch strategy that loads templates from a database via the [IMailTemplateRepository](Interface.IMailTemplateRepository) port. |
 | [DeliveryStrategyBase](Class.DeliveryStrategyBase) | Represents the base class for all email delivery strategies. |
 | [FileTemplateFetchStrategy](Class.FileTemplateFetchStrategy) | The `FileTemplateFetchStrategy` class. |
-| [LogDeliveryStrategy](Class.LogDeliveryStrategy) | The `LogDeliveryStrategy` class. |
 | [MailDeliveryError](Class.MailDeliveryError) | Domain error thrown when email delivery fails. |
 | [MailgunDeliveryStrategy](Class.MailgunDeliveryStrategy) | Delivers emails via the Mailgun API. |
 | [MailHealthIndicator](Class.MailHealthIndicator) | Health indicator for mail service. |

package/package.json

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

package/data/packages/platform-mailing/api/Class.LogDeliveryStrategy.md

@@ -1,71 +0,0 @@
----
-title: 'Class: LogDeliveryStrategy'
-generated: true
-editUrl: false
----
-# Class: LogDeliveryStrategy
-
-Defined in: [platform-mailing/src/delivering/strategies/logger/LogDeliveryStrategy.ts:14](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/delivering/strategies/logger/LogDeliveryStrategy.ts#L14)
-
-The `LogDeliveryStrategy` class.
-
-## Extends
-
-- [`DeliveryStrategyBase`](Class.DeliveryStrategyBase)
-
-## Constructors
-
-### Constructor
-
-```ts
-new LogDeliveryStrategy(): LogDeliveryStrategy;
-```
-
-Defined in: [platform-mailing/src/delivering/strategies/logger/LogDeliveryStrategy.ts:28](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/delivering/strategies/logger/LogDeliveryStrategy.ts#L28)
-
-Constructs a new instance of the `LogDelivery` class.
-
-#### Returns
-
-`LogDeliveryStrategy`
-
-#### Overrides
-
-[`DeliveryStrategyBase`](Class.DeliveryStrategyBase).[`constructor`](Class.DeliveryStrategyBase#constructor)
-
-## Methods
-
-### send()
-
-```ts
-abstract send(
-   from, 
-   to, 
-   subject, 
-   content, 
-   isHtml, 
-_attachments?): Promise<void>;
-```
-
-Defined in: [platform-mailing/src/delivering/strategies/logger/LogDeliveryStrategy.ts:36](https://github.com/RueDeRennes/archipel/blob/main/libs/platform-mailing/src/delivering/strategies/logger/LogDeliveryStrategy.ts#L36)
-
-Sends an email with either plain text or HTML content.
-
-#### Parameters
-
-| Parameter | Type | Description |
-| ------ | ------ | ------ |
-| `from` | `string` | Sender's email address (optional, defaults to config) |
-| `to` | `string` | Recipient's email address |
-| `subject` | `string` | Subject of the email |
-| `content` | `string` | Email body content (plain text or HTML) |
-| `isHtml` | `boolean` | Flag to indicate whether the email is HTML (true) or plain text (false) |
-| `_attachments?` | [`IMailAttachment`](Interface.IMailAttachment)[] | - |
-
-#### Returns
-
-`Promise`\<`void`\>
-
-#### Overrides
-
-[`DeliveryStrategyBase`](Class.DeliveryStrategyBase).[`send`](Class.DeliveryStrategyBase#send)