@breadstone/archipel-mcp 0.0.45 → 0.0.46

package/data/guides/ai-text-generation.md

@@ -64,7 +64,7 @@ Register only the provider loaders you install. The root entry does not import p
 
 All intelligence settings are read from environment variables via `ConfigService`. No direct `process.env` access is needed.
 
-```env
+```dotenv
 INTELLIGENCE_PROVIDER=openai
 INTELLIGENCE_MODEL=gpt-4o-mini
 INTELLIGENCE_API_KEY=sk-...
@@ -85,7 +85,7 @@ INTELLIGENCE_BASE_URL=              # optional — override for custom endpoints
 
 Each provider resolves its API key and base URL from dedicated environment variables when the generic `INTELLIGENCE_API_KEY` is not set:
 
-```env
+```dotenv
 # Provider-specific keys (optional — fallback from INTELLIGENCE_API_KEY)
 OPENAI_API_KEY=sk-...
 ANTHROPIC_API_KEY=sk-ant-...

package/data/guides/authentication-and-authorization.md

@@ -475,7 +475,7 @@ If `mfaRequired` is `true`, the client receives a `challengeId` instead of an `a
 
 ### MFA Configuration
 
-```env
+```dotenv
 AUTH_MFA_ENCRYPTION_KEY=<32-byte-hex-key>
 AUTH_MFA_CHALLENGE_EXPIRES_IN=5m
 AUTH_MFA_MAX_ATTEMPTS=5
@@ -584,7 +584,7 @@ AuthModule.register({
 
 ### Step 4: Set Environment Variables
 
-```env
+```dotenv
 # Google
 AUTH_GOOGLE_CLIENT_ID=your-client-id
 AUTH_GOOGLE_CLIENT_SECRET=your-client-secret

package/data/guides/blob-storage.md

@@ -54,7 +54,7 @@ Each provider reads its credentials from environment variables via the `ConfigMo
 
 ### AWS S3
 
-```env
+```dotenv
 BLOB_AWS_REGION=eu-central-1
 BLOB_AWS_BUCKET=my-app-uploads
 BLOB_AWS_ACCESS_KEY_ID=AKIA...
@@ -67,7 +67,7 @@ BLOB_AWS_SECRET_ACCESS_KEY=secret...
 
 You can authenticate with either a **connection string** or **DefaultAzureCredential** (via managed identity):
 
-```env
+```dotenv
 # Option 1: Connection string
 BLOB_AZURE_CONNECTION_STRING=DefaultEndpointsProtocol=https;AccountName=...
 BLOB_AZURE_CONTAINER=uploads
@@ -83,7 +83,7 @@ When using `accountName` without a `connectionString`, the provider authenticate
 
 ### Vercel Blob
 
-```env
+```dotenv
 BLOB_VERCEL_TOKEN=your-vercel-blob-token
 ```
 

package/data/guides/caching.md

@@ -28,7 +28,7 @@ yarn add ioredis
 
 ### Core Variables
 
-```env
+```dotenv
 CACHE_DEFAULT_TTL_MS=60000
 CACHE_MAX_ENTRIES=1000
 CACHE_STALE_WHILE_REVALIDATE=false
@@ -38,7 +38,7 @@ All core variables are optional. When omitted, each cache instance uses the valu
 
 ### Redis Variables
 
-```env
+```dotenv
 REDIS_URL=redis://localhost:6379
 REDIS_KEY_PREFIX=app:
 REDIS_TTL_SECONDS=300

package/data/guides/database-setup.md

@@ -48,19 +48,19 @@ npx prisma init
 
 `platform-database` ships its own config keys and a ready-made entries array. Set the relevant variables in your environment:
 
-```env
+```dotenv
 DATABASE_URL=postgresql://user:password@localhost:5432/mydb
 ```
 
 For Prisma Accelerate (managed connection pooling), add the Accelerate URL from the Prisma Console:
 
-```env
+```dotenv
 DB_ACCELERATE_URL=prisma://accelerate.prisma-data.net/?api_key=your-accelerate-api-key
 ```
 
 Optional environment variables for Prisma Optimize (query analysis dashboard):
 
-```env
+```dotenv
 DB_OPTIMIZE=true
 DB_OPTIMIZE_API_KEY=your-optimize-api-key
 ```
@@ -120,7 +120,7 @@ Accelerate provides connection pooling, global caching, and query optimization
 
 Set `DB_ACCELERATE_URL` in your environment. The module reads it automatically via `ConfigService` — no code changes needed:
 
-```env
+```dotenv
 DB_ACCELERATE_URL=prisma://accelerate.prisma-data.net/?api_key=your-accelerate-api-key
 ```
 

package/data/guides/email-delivery.md

@@ -96,7 +96,7 @@ This ensures that importing the core package does **not** pull in provider-speci
 
 ### Core Variables
 
-```env
+```dotenv
 MAIL_TEMPLATE_ENGINE_FORMAT=html
 MAIL_SENDER_EMAIL=noreply@yourapp.com
 ```
@@ -109,7 +109,7 @@ The delivery strategy and template-fetch strategy are no longer configured via e
 
 #### SMTP
 
-```env
+```dotenv
 MAIL_SMTP_HOST=smtp.example.com
 MAIL_SMTP_PORT=587
 MAIL_SMTP_USER=user@example.com
@@ -119,25 +119,25 @@ MAIL_SMTP_SECURE=true
 
 #### Resend
 
-```env
+```dotenv
 MAIL_RESEND_API_KEY=re_...
 ```
 
 #### Postmark
 
-```env
+```dotenv
 MAIL_POSTMARK_API_KEY=...
 ```
 
 #### SendGrid
 
-```env
+```dotenv
 MAIL_SENDGRID_API_KEY=SG...
 ```
 
 #### Mailgun
 
-```env
+```dotenv
 MAIL_MAILGUN_API_KEY=key-...
 MAIL_MAILGUN_DOMAIN=mg.yourapp.com
 ```

package/data/guides/openapi-and-feature-discovery.md

@@ -24,7 +24,7 @@ yarn add @breadstone/archipel-platform-openapi
 
 All four variables are **required**:
 
-```env
+```dotenv
 APP_VERSION=1.0.0
 SWAGGER_CONTACT_NAME=Your Team
 SWAGGER_CONTACT_URL=https://yourcompany.com

package/data/guides/queue-infrastructure.md

@@ -40,7 +40,7 @@ yarn add @vercel/queue
 
 ### Core Variables
 
-```env
+```dotenv
 QUEUE_MAX_JOBS=10000
 ```
 
@@ -48,7 +48,7 @@ QUEUE_MAX_JOBS=10000
 
 ### BullMQ Variables
 
-```env
+```dotenv
 BULLMQ_REDIS_URL=redis://localhost:6379
 BULLMQ_PREFIX=myapp:
 ```
@@ -57,7 +57,7 @@ BULLMQ_PREFIX=myapp:
 
 ### Azure Service Bus Variables
 
-```env
+```dotenv
 AZURE_CONNECTION_STRING=Endpoint=sb://my-namespace.servicebus.windows.net/;SharedAccessKeyName=...;SharedAccessKey=...
 AZURE_RECEIVE_WAIT_MS=5000
 ```
@@ -66,7 +66,7 @@ AZURE_RECEIVE_WAIT_MS=5000
 
 ### Vercel Queues Variables
 
-```env
+```dotenv
 VERCEL_QUEUE_REGION=iad1
 VERCEL_QUEUE_CONSUMER_GROUP=my-consumer
 VERCEL_QUEUE_TOKEN=

package/data/guides/telemetry-and-observability.md

@@ -43,7 +43,7 @@ When `enabled` is `false`, the module provides a no-op facade (`NoopTelemetryFac
 
 ## Configuration
 
-```env
+```dotenv
 TELEMETRY_ENABLED=true
 TELEMETRY_SERVICE_NAME=my-api
 TELEMETRY_EXPORTER_ENDPOINT=https://otel-collector.example.com:4318

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/package.json

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