TwinMind Multi-Environment Setup

Overview

Configure TwinMind for development, staging, and production environments with proper isolation and promotion workflows.

Prerequisites

Multiple TwinMind accounts or API keys per environment
Understanding of environment management
CI/CD pipeline for deployments

Instructions

Step 1: Environment Configuration Structure

// src/config/environments.ts
export type Environment = 'development' | 'staging' | 'production';

export interface EnvironmentConfig {
  name: Environment;
  twinmind: {
    apiKey: string;
    baseUrl: string;
    webhookSecret: string;
    model: 'ear-2' | 'ear-3' | 'ear-3-custom';
    features: {
      diarization: boolean;
      autoSummary: boolean;
      actionItems: boolean;
      debug: boolean;
    };
  };
  limits: {
    rateLimit: number;
    concurrentJobs: number;
    dailyQuota?: number;
  };
  integrations: {
    slack?: { webhook: string; channel: string };
    calendar?: { enabled: boolean };
    email?: { enabled: boolean };
  };
}

// Environment-specific configurations
const configs: Record<Environment, Partial<EnvironmentConfig>> = {
  development: {
    name: 'development',
    twinmind: {
      apiKey: process.env.TWINMIND_API_KEY_DEV!,
      baseUrl: 'https://api.twinmind.com/v1',
      webhookSecret: process.env.TWINMIND_WEBHOOK_SECRET_DEV!,
      model: 'ear-2',  // Use cheaper model in dev
      features: {
        diarization: false,  // Faster without diarization
        autoSummary: true,
        actionItems: true,
        debug: true,
      },
    },
    limits: {
      rateLimit: 30,
      concurrentJobs: 1,
      dailyQuota: 10,  // Limit dev usage
    },
    integrations: {
      slack: { webhook: process.env.SLACK_WEBHOOK_DEV!, channel: '#dev-alerts' },
      calendar: { enabled: false },
      email: { enabled: false },
    },
  },

  staging: {
    name: 'staging',
    twinmind: {
      apiKey: process.env.TWINMIND_API_KEY_STAGING!,
      baseUrl: 'https://api.twinmind.com/v1',
      webhookSecret: process.env.TWINMIND_WEBHOOK_SECRET_STAGING!,
      model: 'ear-3',
      features: {
        diarization: true,
        autoSummary: true,
        actionItems: true,
        debug: true,
      },
    },
    limits: {
      rateLimit: 60,
      concurrentJobs: 2,
      dailyQuota: 50,
    },
    integrations: {
      slack: { webhook: process.env.SLACK_WEBHOOK_STAGING!, channel: '#staging-alerts' },
      calendar: { enabled: true },
      email: { enabled: false },  // No real emails in staging
    },
  },

  production: {
    name: 'production',
    twinmind: {
      apiKey: process.env.TWINMIND_API_KEY_PROD!,
      baseUrl: 'https://api.twinmind.com/v1',
      webhookSecret: process.env.TWINMIND_WEBHOOK_SECRET_PROD!,
      model: 'ear-3',
      features: {
        diarization: true,
        autoSummary: true,
        actionItems: true,
        debug: false,  // No debug in production
      },
    },
    limits: {
      rateLimit: 300,  // Enterprise limits
      concurrentJobs: 10,
    },
    integrations: {
      slack: { webhook: process.env.SLACK_WEBHOOK_PROD!, channel: '#production-alerts' },
      calendar: { enabled: true },
      email: { enabled: true },
    },
  },
};

export function getEnvironmentConfig(): EnvironmentConfig {
  const env = (process.env.NODE_ENV || 'development') as Environment;
  const config = configs[env];

  if (!config) {
    throw new Error(`Unknown environment: ${env}`);
  }

  return config as EnvironmentConfig;
}

Loading…

Instructions

Step 1: Environment Configuration Structure

// src/config/environments.ts export type Environment = 'development' | 'staging' | 'production'; export interface EnvironmentConfig { name: Environment; twinmind: { apiKey: string; baseUrl: string; webhookSecret: string; model: 'ear-2' | 'ear-3' | 'ear-3-custom'; features: { diarization: boolean; autoSummary: boolean; actionItems: boolean; debug: boolean; }; }; limits: { rateLimit: number; concurrentJobs: number; dailyQuota?: number; }; integrations: { slack?: { webhook: string; channel: string }; calendar?: { enabled: boolean }; email?: { enabled: boolean }; }; } // Environment-specific configurations const configs: Record<Environment, Partial<EnvironmentConfig>> = { development: { name: 'development', twinmind: { apiKey: process.env.TWINMIND_API_KEY_DEV!, baseUrl: 'https://api.twinmind.com/v1', webhookSecret: process.env.TWINMIND_WEBHOOK_SECRET_DEV!, model: 'ear-2', // Use cheaper model in dev features: { diarization: false, // Faster without diarization autoSummary: true, actionItems: true, debug: true, }, }, limits: { rateLimit: 30, concurrentJobs: 1, dailyQuota: 10, // Limit dev usage }, integrations: { slack: { webhook: process.env.SLACK_WEBHOOK_DEV!, channel: '#dev-alerts' }, calendar: { enabled: false }, email: { enabled: false }, }, }, staging: { name: 'staging', twinmind: { apiKey: process.env.TWINMIND_API_KEY_STAGING!, baseUrl: 'https://api.twinmind.com/v1', webhookSecret: process.env.TWINMIND_WEBHOOK_SECRET_STAGING!, model: 'ear-3', features: { diarization: true, autoSummary: true, actionItems: true, debug: true, }, }, limits: { rateLimit: 60, concurrentJobs: 2, dailyQuota: 50, }, integrations: { slack: { webhook: process.env.SLACK_WEBHOOK_STAGING!, channel: '#staging-alerts' }, calendar: { enabled: true }, email: { enabled: false }, // No real emails in staging }, }, production: { name: 'production', twinmind: { apiKey: process.env.TWINMIND_API_KEY_PROD!, baseUrl: 'https://api.twinmind.com/v1', webhookSecret: process.env.TWINMIND_WEBHOOK_SECRET_PROD!, model: 'ear-3', features: { diarization: true, autoSummary: true, actionItems: true, debug: false, // No debug in production }, }, limits: { rateLimit: 300, // Enterprise limits concurrentJobs: 10, }, integrations: { slack: { webhook: process.env.SLACK_WEBHOOK_PROD!, channel: '#production-alerts' }, calendar: { enabled: true }, email: { enabled: true }, }, }, }; export function getEnvironmentConfig(): EnvironmentConfig { const env = (process.env.NODE_ENV || 'development') as Environment; const config = configs[env]; if (!config) { throw new Error(`Unknown environment: ${env}`); } return config as EnvironmentConfig; }

// scripts/promote-config.ts import * as fs from 'fs'; import * as path from 'path'; interface PromotionResult { success: boolean; fromEnv: string; toEnv: string; changes: string[]; } async function promoteConfig( fromEnv: 'development' | 'staging', toEnv: 'staging' | 'production' ): Promise<PromotionResult> { const changes: string[] = []; // Read source config const sourceConfigPath = path.join(__dirname, `../config/twinmind.${fromEnv}.json`); const sourceConfig = JSON.parse(fs.readFileSync(sourceConfigPath, 'utf-8')); // Read target config const targetConfigPath = path.join(__dirname, `../config/twinmind.${toEnv}.json`); const targetConfig = JSON.parse(fs.readFileSync(targetConfigPath, 'utf-8')); // Identify changes to promote const promotableKeys = ['features', 'webhookEvents', 'integrationSettings']; for (const key of promotableKeys) { if (JSON.stringify(sourceConfig[key]) !== JSON.stringify(targetConfig[key])) { changes.push(`${key}: ${JSON.stringify(sourceConfig[key])}`); targetConfig[key] = sourceConfig[key]; } } // Write updated target config if (changes.length > 0) { fs.writeFileSync(targetConfigPath, JSON.stringify(targetConfig, null, 2)); } return { success: true, fromEnv, toEnv, changes, }; } // CLI interface async function main(): Promise<void> { const args = process.argv.slice(2); const fromEnv = args[0] as 'development' | 'staging'; const toEnv = args[1] as 'staging' | 'production'; if (!fromEnv || !toEnv) { console.log('Usage: ts-node promote-config.ts <from-env> <to-env>'); console.log('Example: ts-node promote-config.ts staging production'); process.exit(1); } const result = await promoteConfig(fromEnv, toEnv); console.log(`\nPromotion: ${fromEnv} -> ${toEnv}`); console.log(`Changes: ${result.changes.length}`); if (result.changes.length > 0) { console.log('\nPromoted settings:'); result.changes.forEach(c => console.log(` - ${c}`)); } else { console.log('\nNo changes to promote.'); } } main();

Setting	Development	Staging	Production
Model	ear-2	ear-3	ear-3
Diarization	Off	On	On
Debug mode	On	On	Off
Rate limit	30/min	60/min	300/min
Email sending	Off	Off	On
Daily quota	10 hrs	50 hrs	Unlimited

Issue	Cause	Solution
Wrong API key used	Env mismatch	Validate before deploy
Feature not available	Wrong environment	Check feature flags
Config not loading	Missing file	Verify config paths
Promotion failed	Schema mismatch	Validate configs first

twinmind-multi-env-setup

TwinMind Multi-Environment Setup

Overview

Prerequisites

Instructions

Step 1: Environment Configuration Structure

Related Skills

flow

verify

feature-flags

flags

TwinMind Multi-Environment Setup

Overview

Prerequisites

Instructions

Step 1: Environment Configuration Structure

Step 2: Environment Variable Files

Step 3: Environment-Aware Client Factory

Step 4: Environment Validation

Step 5: Promotion Workflow

Step 6: Feature Flags per Environment

Output

Environment Matrix

Error Handling

Resources

Next Steps

Related Skills

flow

verify

feature-flags

flags