The Complete Production SOP: How to Deploy and Run Unleash Enterprise Feature Toggles & Gradual Rollouts in Autonomous AI Agents

---
name: "unleash-enterprise-feature-toggles"
description: "Control feature releases, kill switches, and canary rollouts using open-source Unleash."
metadata:
  author: "Unleash"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "setup unleash client"
  - "gradual rollout unleash"
  - "kill switch feature toggle"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

import { initialize, Unleash } from 'unleash-client';

let unleashInstance: Unleash | null = null;

export function getUnleashClient(): Unleash {
  if (!unleashInstance) {
    unleashInstance = initialize({
      url: process.env.UNLEASH_API_URL || '',
      appName: process.env.UNLEASH_APP_NAME || 'default-app',
      customHeaders: {
        Authorization: process.env.UNLEASH_API_TOKEN || '',
      },
      refreshInterval: 15000,
      metricsInterval: 60000,
    });
  }
  return unleashInstance;
}

import { getUnleashClient } from '../lib/unleash';

export async function processPayment(userId: string, payload: any) {
  const unleash = getUnleashClient();
  
  // Deterministic evaluation with fallback and stickiness context
  const isV2Enabled = unleash.isEnabled('checkout-v2', {
    userId,
    properties: {
      region: payload.billingCountry,
    },
  }, false);

  if (isV2Enabled) {
    return executeOptimizedCheckoutV2(payload);
  }
  return executeLegacyCheckout(payload);
}

import { processPayment } from '../checkout';
import * as unleashModule from '../../lib/unleash';

describe('Payment Toggle Routing', () => {
  afterEach(() => jest.restoreAllMocks());

  it('routes to legacy checkout when toggle is false', async () => {
    jest.spyOn(unleashModule, 'getUnleashClient').mockReturnValue({
      isEnabled: jest.fn().mockReturnValue(false),
    } as any);
    
    const res = await processPayment('user-123', { amount: 100 });
    expect(res.version).toBe('legacy');
  });
});