[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6F8D2XCJ5R7GWNQZQR9TQE4":3,"skill-same:01M6F8D2XCJ5R7GWNQZQR9TQE4":73},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":41,"linkOnly":42,"markdownContent":43,"markdownBody":44,"frontMatter":45,"refName":50,"commitSha":51,"skillDirectory":52,"forksCount":53,"repositoryHtmlUrl":54,"repositoryHomepageUrl":6,"ownerHtmlUrl":55,"ownerBlogUrl":56,"ownerDescription":57,"updatedAt":58,"install":59,"resources":72},"01M6F8D2XCJ5R7GWNQZQR9TQE4","openevidence-multi-env-setup",null,"Configure OpenEvidence across development, staging, and production environments.\nUse when setting up multiple environments, managing environment-specific configurations,\nor implementing environment promotion strategies for clinical AI applications.\nTrigger with phrases like \"openevidence environments\", \"openevidence staging\",\n\"openevidence dev setup\", \"multi-environment openevidence\".","Dicklesworthstone\u002Fpi_agent_rust","Dicklesworthstone","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F35050222?v=4","01M6CG26AR942CSVMN1M5E3DSE","Jeff Emanuel","01M6CG26EPP71PSHW1VDS71121",1992,"MIT","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Fopenevidence-pack\u002Fskills\u002Fopenevidence-multi-env-setup\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40],"setup","openevidence multi env setup","multi","env setup","env","when","dev setup","implementing","environments","trigger","io","clinical","strategies","across","multi-environment","up","environment","edit","write","read","configure","development","2026-11-10 10:12:30",false,"---\nname: openevidence-multi-env-setup\ndescription: |\n  Configure OpenEvidence across development, staging, and production environments.\n  Use when setting up multiple environments, managing environment-specific configurations,\n  or implementing environment promotion strategies for clinical AI applications.\n  Trigger with phrases like \"openevidence environments\", \"openevidence staging\",\n  \"openevidence dev setup\", \"multi-environment openevidence\".\nallowed-tools: Read, Write, Edit\nversion: 1.0.0\nlicense: MIT\nauthor: Jeremy Longshore \u003Cjeremy@intentsolutions.io>\n---\n\n# OpenEvidence Multi-Environment Setup\n\n## Overview\nConfigure and manage OpenEvidence integrations across development, staging, and production environments with proper isolation and promotion strategies.\n\n## Prerequisites\n- OpenEvidence accounts for each environment\n- Separate API keys per environment\n- Infrastructure for each environment (cloud or on-premise)\n- CI\u002FCD pipeline configured\n\n## Environment Strategy\n\n| Environment | API Endpoint | Purpose | Data |\n|-------------|--------------|---------|------|\n| Development | sandbox.openevidence.com | Local development | Synthetic |\n| Staging | sandbox.openevidence.com | Integration testing | Synthetic |\n| Production | api.openevidence.com | Live clinical use | Real (PHI) |\n\n## Instructions\n\n### Step 1: Environment Configuration Files\n```typescript\n\u002F\u002F config\u002Fenvironments\u002Fdevelopment.ts\nexport const developmentConfig = {\n  env: 'development',\n  openevidence: {\n    baseUrl: 'https:\u002F\u002Fapi.sandbox.openevidence.com',\n    timeout: 60000, \u002F\u002F Longer timeout for debugging\n    retries: 1,\n    rateLimit: {\n      enabled: false, \u002F\u002F No rate limiting in dev\n    },\n  },\n  cache: {\n    enabled: false, \u002F\u002F Disable cache for fresh responses\n    ttlSeconds: 0,\n  },\n  logging: {\n    level: 'debug',\n    prettyPrint: true,\n  },\n  features: {\n    deepConsult: true,\n    webhooks: false, \u002F\u002F No webhooks in local dev\n    auditLogging: false,\n  },\n};\n\n\u002F\u002F config\u002Fenvironments\u002Fstaging.ts\nexport const stagingConfig = {\n  env: 'staging',\n  openevidence: {\n    baseUrl: 'https:\u002F\u002Fapi.sandbox.openevidence.com',\n    timeout: 45000,\n    retries: 2,\n    rateLimit: {\n      enabled: true,\n      requestsPerMinute: 60,\n    },\n  },\n  cache: {\n    enabled: true,\n    ttlSeconds: 1800, \u002F\u002F 30 min cache\n  },\n  logging: {\n    level: 'info',\n    prettyPrint: false,\n  },\n  features: {\n    deepConsult: true,\n    webhooks: true,\n    auditLogging: true,\n  },\n};\n\n\u002F\u002F config\u002Fenvironments\u002Fproduction.ts\nexport const productionConfig = {\n  env: 'production',\n  openevidence: {\n    baseUrl: 'https:\u002F\u002Fapi.openevidence.com',\n    timeout: 30000,\n    retries: 3,\n    rateLimit: {\n      enabled: true,\n      requestsPerMinute: 300, \u002F\u002F Higher limit in prod\n    },\n  },\n  cache: {\n    enabled: true,\n    ttlSeconds: 3600, \u002F\u002F 1 hour cache\n  },\n  logging: {\n    level: 'warn',\n    prettyPrint: false,\n  },\n  features: {\n    deepConsult: true,\n    webhooks: true,\n    auditLogging: true,\n  },\n};\n```\n\n### Step 2: Configuration Loader\n```typescript\n\u002F\u002F src\u002Fconfig\u002Findex.ts\nimport { developmentConfig } from '.\u002Fenvironments\u002Fdevelopment';\nimport { stagingConfig } from '.\u002Fenvironments\u002Fstaging';\nimport { productionConfig } from '.\u002Fenvironments\u002Fproduction';\n\ntype Environment = 'development' | 'staging' | 'production';\n\nconst configs = {\n  development: developmentConfig,\n  staging: stagingConfig,\n  production: productionConfig,\n};\n\nexport function loadConfig(env?: Environment) {\n  const environment = env || (process.env.NODE_ENV as Environment) || 'development';\n\n  if (!configs[environment]) {\n    throw new Error(`Unknown environment: ${environment}`);\n  }\n\n  const baseConfig = configs[environment];\n\n  \u002F\u002F Override with environment variables\n  return {\n    ...baseConfig,\n    openevidence: {\n      ...baseConfig.openevidence,\n      apiKey: process.env.OPENEVIDENCE_API_KEY,\n      orgId: process.env.OPENEVIDENCE_ORG_ID,\n      ...(process.env.OPENEVIDENCE_BASE_URL && {\n        baseUrl: process.env.OPENEVIDENCE_BASE_URL,\n      }),\n      ...(process.env.OPENEVIDENCE_TIMEOUT && {\n        timeout: parseInt(process.env.OPENEVIDENCE_TIMEOUT),\n      }),\n    },\n  };\n}\n\n\u002F\u002F Singleton config instance\nlet configInstance: ReturnType\u003Ctypeof loadConfig> | null = null;\n\nexport function getConfig() {\n  if (!configInstance) {\n    configInstance = loadConfig();\n  }\n  return configInstance;\n}\n\n\u002F\u002F For testing - reset config\nexport function resetConfig() {\n  configInstance = null;\n}\n```\n\n### Step 3: Environment-Aware Client Factory\n```typescript\n\u002F\u002F src\u002Fopenevidence\u002Fclient-factory.ts\nimport { OpenEvidenceClient } from '@openevidence\u002Fsdk';\nimport { getConfig } from '..\u002Fconfig';\nimport { ClinicalQueryCache } from '.\u002Fcache';\nimport { MetricsCollector } from '..\u002Fmonitoring\u002Fmetrics';\n\nexport class OpenEvidenceClientFactory {\n  private static instances: Map\u003Cstring, OpenEvidenceClient> = new Map();\n\n  static getClient(environment?: string): OpenEvidenceClient {\n    const config = getConfig();\n    const env = environment || config.env;\n\n    if (!this.instances.has(env)) {\n      const client = new OpenEvidenceClient({\n        apiKey: config.openevidence.apiKey,\n        orgId: config.openevidence.orgId,\n        baseUrl: config.openevidence.baseUrl,\n        timeout: config.openevidence.timeout,\n      });\n\n      this.instances.set(env, client);\n    }\n\n    return this.instances.get(env)!;\n  }\n\n  \u002F\u002F For testing - inject mock client\n  static setClient(env: string, client: OpenEvidenceClient): void {\n    this.instances.set(env, client);\n  }\n\n  static clearClients(): void {\n    this.instances.clear();\n  }\n}\n```\n\n### Step 4: Secret Management Per Environment\n```typescript\n\u002F\u002F src\u002Fsecrets\u002Fmanager.ts\nimport { SecretManagerServiceClient } from '@google-cloud\u002Fsecret-manager';\n\ninterface SecretPaths {\n  apiKey: string;\n  orgId: string;\n  webhookSecret?: string;\n}\n\nconst SECRET_PATHS: Record\u003Cstring, SecretPaths> = {\n  development: {\n    apiKey: 'local', \u002F\u002F Use .env in development\n    orgId: 'local',\n  },\n  staging: {\n    apiKey: 'projects\u002Fstaging-project\u002Fsecrets\u002Fopenevidence-api-key\u002Fversions\u002Flatest',\n    orgId: 'projects\u002Fstaging-project\u002Fsecrets\u002Fopenevidence-org-id\u002Fversions\u002Flatest',\n    webhookSecret: 'projects\u002Fstaging-project\u002Fsecrets\u002Fopenevidence-webhook-secret\u002Fversions\u002Flatest',\n  },\n  production: {\n    apiKey: 'projects\u002Fprod-project\u002Fsecrets\u002Fopenevidence-api-key\u002Fversions\u002Flatest',\n    orgId: 'projects\u002Fprod-project\u002Fsecrets\u002Fopenevidence-org-id\u002Fversions\u002Flatest',\n    webhookSecret: 'projects\u002Fprod-project\u002Fsecrets\u002Fopenevidence-webhook-secret\u002Fversions\u002Flatest',\n  },\n};\n\nexport class SecretManager {\n  private client: SecretManagerServiceClient;\n\n  constructor() {\n    this.client = new SecretManagerServiceClient();\n  }\n\n  async getSecrets(env: string): Promise\u003C{\n    apiKey: string;\n    orgId: string;\n    webhookSecret?: string;\n  }> {\n    const paths = SECRET_PATHS[env];\n\n    if (!paths) {\n      throw new Error(`Unknown environment: ${env}`);\n    }\n\n    \u002F\u002F Development uses environment variables\n    if (paths.apiKey === 'local') {\n      return {\n        apiKey: process.env.OPENEVIDENCE_API_KEY!,\n        orgId: process.env.OPENEVIDENCE_ORG_ID!,\n        webhookSecret: process.env.OPENEVIDENCE_WEBHOOK_SECRET,\n      };\n    }\n\n    \u002F\u002F Staging\u002FProduction use Secret Manager\n    const [apiKeyVersion] = await this.client.accessSecretVersion({ name: paths.apiKey });\n    const [orgIdVersion] = await this.client.accessSecretVersion({ name: paths.orgId });\n\n    const secrets: any = {\n      apiKey: apiKeyVersion.payload?.data?.toString(),\n      orgId: orgIdVersion.payload?.data?.toString(),\n    };\n\n    if (paths.webhookSecret) {\n      const [webhookVersion] = await this.client.accessSecretVersion({ name: paths.webhookSecret });\n      secrets.webhookSecret = webhookVersion.payload?.data?.toString();\n    }\n\n    return secrets;\n  }\n}\n```\n\n### Step 5: Environment Promotion Workflow\n```yaml\n# .github\u002Fworkflows\u002Fpromotion.yml\nname: Environment Promotion\n\non:\n  workflow_dispatch:\n    inputs:\n      source_env:\n        description: 'Source environment'\n        required: true\n        type: choice\n        options:\n          - staging\n      target_env:\n        description: 'Target environment'\n        required: true\n        type: choice\n        options:\n          - production\n      version:\n        description: 'Version to promote (e.g., v1.2.3)'\n        required: true\n\njobs:\n  validate:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions\u002Fcheckout@v4\n\n      - name: Validate version exists in source\n        run: |\n          # Check that the version exists and is deployed in source\n          SOURCE_VERSION=$(curl -sf \"${{ secrets.STAGING_URL }}\u002Fhealth\" | jq -r '.version')\n          if [ \"$SOURCE_VERSION\" != \"${{ inputs.version }}\" ]; then\n            echo \"Version mismatch: staging has $SOURCE_VERSION, expected ${{ inputs.version }}\"\n            exit 1\n          fi\n\n      - name: Validate staging tests passed\n        run: |\n          # Check that all tests passed for this version\n          gh run list --workflow=openevidence-ci.yml \\\n            --branch=main --status=success \\\n            --json conclusion,headBranch | jq -e '.[0]'\n\n  promote:\n    needs: validate\n    runs-on: ubuntu-latest\n    environment: production\n    steps:\n      - uses: actions\u002Fcheckout@v4\n        with:\n          ref: ${{ inputs.version }}\n\n      - name: Setup Cloud SDK\n        uses: google-github-actions\u002Fsetup-gcloud@v2\n        with:\n          project_id: ${{ secrets.PROD_PROJECT_ID }}\n\n      - name: Deploy to Production\n        run: |\n          gcloud run deploy clinical-evidence-api \\\n            --image gcr.io\u002F${{ secrets.STAGING_PROJECT_ID }}\u002Fclinical-evidence-api:${{ inputs.version }} \\\n            --region us-central1 \\\n            --set-env-vars NODE_ENV=production \\\n            --no-traffic\n\n      - name: Run smoke tests\n        run: |\n          REVISION=$(gcloud run revisions list --service clinical-evidence-api \\\n            --region us-central1 --format 'value(metadata.name)' --limit 1)\n          # Test the new revision directly\n          .\u002Fscripts\u002Fsmoke-test.sh \"$REVISION\"\n\n      - name: Gradual traffic shift\n        run: |\n          # 10% -> 50% -> 100%\n          for percent in 10 50 100; do\n            gcloud run services update-traffic clinical-evidence-api \\\n              --region us-central1 \\\n              --to-latest=$percent\n            sleep 300 # Wait 5 minutes between shifts\n          done\n\n      - name: Create production release\n        uses: softprops\u002Faction-gh-release@v1\n        with:\n          tag_name: ${{ inputs.version }}-production\n          name: Production Release ${{ inputs.version }}\n          body: |\n            Promoted to production from staging.\n            Original version: ${{ inputs.version }}\n```\n\n### Step 6: Environment Health Checks\n```typescript\n\u002F\u002F src\u002Fhealth\u002Fenvironment-health.ts\nimport { OpenEvidenceClientFactory } from '..\u002Fopenevidence\u002Fclient-factory';\nimport { getConfig } from '..\u002Fconfig';\n\ninterface EnvironmentHealth {\n  environment: string;\n  status: 'healthy' | 'degraded' | 'unhealthy';\n  checks: {\n    openevidence: { status: string; latencyMs?: number };\n    cache: { status: string; hitRate?: number };\n    database: { status: string };\n  };\n  version: string;\n  timestamp: string;\n}\n\nexport async function checkEnvironmentHealth(): Promise\u003CEnvironmentHealth> {\n  const config = getConfig();\n  const checks: EnvironmentHealth['checks'] = {\n    openevidence: { status: 'unknown' },\n    cache: { status: 'unknown' },\n    database: { status: 'unknown' },\n  };\n\n  \u002F\u002F Check OpenEvidence connectivity\n  try {\n    const client = OpenEvidenceClientFactory.getClient();\n    const start = Date.now();\n    await client.health.check();\n    checks.openevidence = {\n      status: 'healthy',\n      latencyMs: Date.now() - start,\n    };\n  } catch (error: any) {\n    checks.openevidence = { status: 'unhealthy' };\n  }\n\n  \u002F\u002F Check cache\n  try {\n    if (config.cache.enabled) {\n      const stats = await cache.getStats();\n      checks.cache = {\n        status: 'healthy',\n        hitRate: stats.hitRate,\n      };\n    } else {\n      checks.cache = { status: 'disabled' };\n    }\n  } catch {\n    checks.cache = { status: 'unhealthy' };\n  }\n\n  \u002F\u002F Check database\n  try {\n    await db.$queryRaw`SELECT 1`;\n    checks.database = { status: 'healthy' };\n  } catch {\n    checks.database = { status: 'unhealthy' };\n  }\n\n  \u002F\u002F Determine overall status\n  const unhealthyCount = Object.values(checks).filter(\n    c => c.status === 'unhealthy'\n  ).length;\n\n  let status: EnvironmentHealth['status'] = 'healthy';\n  if (unhealthyCount > 0) status = 'degraded';\n  if (checks.openevidence.status === 'unhealthy') status = 'unhealthy';\n\n  return {\n    environment: config.env,\n    status,\n    checks,\n    version: process.env.npm_package_version || 'unknown',\n    timestamp: new Date().toISOString(),\n  };\n}\n```\n\n## Output\n- Environment-specific configuration files\n- Configuration loader with env var overrides\n- Secret management per environment\n- Promotion workflow\n- Health checks per environment\n\n## Environment Checklist\n\n### Development\n- [ ] Sandbox API key configured\n- [ ] Local .env file created\n- [ ] Cache disabled for fresh responses\n- [ ] Debug logging enabled\n\n### Staging\n- [ ] Separate sandbox API key\n- [ ] Secrets in Secret Manager\n- [ ] Webhooks configured\n- [ ] HIPAA audit logging enabled\n- [ ] Performance testing completed\n\n### Production\n- [ ] Production API key from OpenEvidence\n- [ ] BAA signed\n- [ ] All secrets in Secret Manager\n- [ ] Monitoring and alerting configured\n- [ ] Runbook documented\n- [ ] On-call rotation established\n\n## Error Handling\n| Environment Issue | Detection | Resolution |\n|-------------------|-----------|------------|\n| Wrong API endpoint | Health check fails | Verify baseUrl in config |\n| Secret not found | Startup failure | Check Secret Manager permissions |\n| Config mismatch | Unexpected behavior | Validate config loading |\n| Promotion failure | CI\u002FCD error | Check version tagging |\n\n## Resources\n- [OpenEvidence Sandbox](https:\u002F\u002Fsandbox.openevidence.com\u002F)\n- [Google Cloud Secret Manager](https:\u002F\u002Fcloud.google.com\u002Fsecret-manager)\n\n## Next Steps\nFor observability setup, see `openevidence-observability`.\n","# OpenEvidence Multi-Environment Setup\n\n## Overview\nConfigure and manage OpenEvidence integrations across development, staging, and production environments with proper isolation and promotion strategies.\n\n## Prerequisites\n- OpenEvidence accounts for each environment\n- Separate API keys per environment\n- Infrastructure for each environment (cloud or on-premise)\n- CI\u002FCD pipeline configured\n\n## Environment Strategy\n\n| Environment | API Endpoint | Purpose | Data |\n|-------------|--------------|---------|------|\n| Development | sandbox.openevidence.com | Local development | Synthetic |\n| Staging | sandbox.openevidence.com | Integration testing | Synthetic |\n| Production | api.openevidence.com | Live clinical use | Real (PHI) |\n\n## Instructions\n\n### Step 1: Environment Configuration Files\n```typescript\n\u002F\u002F config\u002Fenvironments\u002Fdevelopment.ts\nexport const developmentConfig = {\n  env: 'development',\n  openevidence: {\n    baseUrl: 'https:\u002F\u002Fapi.sandbox.openevidence.com',\n    timeout: 60000, \u002F\u002F Longer timeout for debugging\n    retries: 1,\n    rateLimit: {\n      enabled: false, \u002F\u002F No rate limiting in dev\n    },\n  },\n  cache: {\n    enabled: false, \u002F\u002F Disable cache for fresh responses\n    ttlSeconds: 0,\n  },\n  logging: {\n    level: 'debug',\n    prettyPrint: true,\n  },\n  features: {\n    deepConsult: true,\n    webhooks: false, \u002F\u002F No webhooks in local dev\n    auditLogging: false,\n  },\n};\n\n\u002F\u002F config\u002Fenvironments\u002Fstaging.ts\nexport const stagingConfig = {\n  env: 'staging',\n  openevidence: {\n    baseUrl: 'https:\u002F\u002Fapi.sandbox.openevidence.com',\n    timeout: 45000,\n    retries: 2,\n    rateLimit: {\n      enabled: true,\n      requestsPerMinute: 60,\n    },\n  },\n  cache: {\n    enabled: true,\n    ttlSeconds: 1800, \u002F\u002F 30 min cache\n  },\n  logging: {\n    level: 'info',\n    prettyPrint: false,\n  },\n  features: {\n    deepConsult: true,\n    webhooks: true,\n    auditLogging: true,\n  },\n};\n\n\u002F\u002F config\u002Fenvironments\u002Fproduction.ts\nexport const productionConfig = {\n  env: 'production',\n  openevidence: {\n    baseUrl: 'https:\u002F\u002Fapi.openevidence.com',\n    timeout: 30000,\n    retries: 3,\n    rateLimit: {\n      enabled: true,\n      requestsPerMinute: 300, \u002F\u002F Higher limit in prod\n    },\n  },\n  cache: {\n    enabled: true,\n    ttlSeconds: 3600, \u002F\u002F 1 hour cache\n  },\n  logging: {\n    level: 'warn',\n    prettyPrint: false,\n  },\n  features: {\n    deepConsult: true,\n    webhooks: true,\n    auditLogging: true,\n  },\n};\n```\n\n### Step 2: Configuration Loader\n```typescript\n\u002F\u002F src\u002Fconfig\u002Findex.ts\nimport { developmentConfig } from '.\u002Fenvironments\u002Fdevelopment';\nimport { stagingConfig } from '.\u002Fenvironments\u002Fstaging';\nimport { productionConfig } from '.\u002Fenvironments\u002Fproduction';\n\ntype Environment = 'development' | 'staging' | 'production';\n\nconst configs = {\n  development: developmentConfig,\n  staging: stagingConfig,\n  production: productionConfig,\n};\n\nexport function loadConfig(env?: Environment) {\n  const environment = env || (process.env.NODE_ENV as Environment) || 'development';\n\n  if (!configs[environment]) {\n    throw new Error(`Unknown environment: ${environment}`);\n  }\n\n  const baseConfig = configs[environment];\n\n  \u002F\u002F Override with environment variables\n  return {\n    ...baseConfig,\n    openevidence: {\n      ...baseConfig.openevidence,\n      apiKey: process.env.OPENEVIDENCE_API_KEY,\n      orgId: process.env.OPENEVIDENCE_ORG_ID,\n      ...(process.env.OPENEVIDENCE_BASE_URL && {\n        baseUrl: process.env.OPENEVIDENCE_BASE_URL,\n      }),\n      ...(process.env.OPENEVIDENCE_TIMEOUT && {\n        timeout: parseInt(process.env.OPENEVIDENCE_TIMEOUT),\n      }),\n    },\n  };\n}\n\n\u002F\u002F Singleton config instance\nlet configInstance: ReturnType\u003Ctypeof loadConfig> | null = null;\n\nexport function getConfig() {\n  if (!configInstance) {\n    configInstance = loadConfig();\n  }\n  return configInstance;\n}\n\n\u002F\u002F For testing - reset config\nexport function resetConfig() {\n  configInstance = null;\n}\n```\n\n### Step 3: Environment-Aware Client Factory\n```typescript\n\u002F\u002F src\u002Fopenevidence\u002Fclient-factory.ts\nimport { OpenEvidenceClient } from '@openevidence\u002Fsdk';\nimport { getConfig } from '..\u002Fconfig';\nimport { ClinicalQueryCache } from '.\u002Fcache';\nimport { MetricsCollector } from '..\u002Fmonitoring\u002Fmetrics';\n\nexport class OpenEvidenceClientFactory {\n  private static instances: Map\u003Cstring, OpenEvidenceClient> = new Map();\n\n  static getClient(environment?: string): OpenEvidenceClient {\n    const config = getConfig();\n    const env = environment || config.env;\n\n    if (!this.instances.has(env)) {\n      const client = new OpenEvidenceClient({\n        apiKey: config.openevidence.apiKey,\n        orgId: config.openevidence.orgId,\n        baseUrl: config.openevidence.baseUrl,\n        timeout: config.openevidence.timeout,\n      });\n\n      this.instances.set(env, client);\n    }\n\n    return this.instances.get(env)!;\n  }\n\n  \u002F\u002F For testing - inject mock client\n  static setClient(env: string, client: OpenEvidenceClient): void {\n    this.instances.set(env, client);\n  }\n\n  static clearClients(): void {\n    this.instances.clear();\n  }\n}\n```\n\n### Step 4: Secret Management Per Environment\n```typescript\n\u002F\u002F src\u002Fsecrets\u002Fmanager.ts\nimport { SecretManagerServiceClient } from '@google-cloud\u002Fsecret-manager';\n\ninterface SecretPaths {\n  apiKey: string;\n  orgId: string;\n  webhookSecret?: string;\n}\n\nconst SECRET_PATHS: Record\u003Cstring, SecretPaths> = {\n  development: {\n    apiKey: 'local', \u002F\u002F Use .env in development\n    orgId: 'local',\n  },\n  staging: {\n    apiKey: 'projects\u002Fstaging-project\u002Fsecrets\u002Fopenevidence-api-key\u002Fversions\u002Flatest',\n    orgId: 'projects\u002Fstaging-project\u002Fsecrets\u002Fopenevidence-org-id\u002Fversions\u002Flatest',\n    webhookSecret: 'projects\u002Fstaging-project\u002Fsecrets\u002Fopenevidence-webhook-secret\u002Fversions\u002Flatest',\n  },\n  production: {\n    apiKey: 'projects\u002Fprod-project\u002Fsecrets\u002Fopenevidence-api-key\u002Fversions\u002Flatest',\n    orgId: 'projects\u002Fprod-project\u002Fsecrets\u002Fopenevidence-org-id\u002Fversions\u002Flatest',\n    webhookSecret: 'projects\u002Fprod-project\u002Fsecrets\u002Fopenevidence-webhook-secret\u002Fversions\u002Flatest',\n  },\n};\n\nexport class SecretManager {\n  private client: SecretManagerServiceClient;\n\n  constructor() {\n    this.client = new SecretManagerServiceClient();\n  }\n\n  async getSecrets(env: string): Promise\u003C{\n    apiKey: string;\n    orgId: string;\n    webhookSecret?: string;\n  }> {\n    const paths = SECRET_PATHS[env];\n\n    if (!paths) {\n      throw new Error(`Unknown environment: ${env}`);\n    }\n\n    \u002F\u002F Development uses environment variables\n    if (paths.apiKey === 'local') {\n      return {\n        apiKey: process.env.OPENEVIDENCE_API_KEY!,\n        orgId: process.env.OPENEVIDENCE_ORG_ID!,\n        webhookSecret: process.env.OPENEVIDENCE_WEBHOOK_SECRET,\n      };\n    }\n\n    \u002F\u002F Staging\u002FProduction use Secret Manager\n    const [apiKeyVersion] = await this.client.accessSecretVersion({ name: paths.apiKey });\n    const [orgIdVersion] = await this.client.accessSecretVersion({ name: paths.orgId });\n\n    const secrets: any = {\n      apiKey: apiKeyVersion.payload?.data?.toString(),\n      orgId: orgIdVersion.payload?.data?.toString(),\n    };\n\n    if (paths.webhookSecret) {\n      const [webhookVersion] = await this.client.accessSecretVersion({ name: paths.webhookSecret });\n      secrets.webhookSecret = webhookVersion.payload?.data?.toString();\n    }\n\n    return secrets;\n  }\n}\n```\n\n### Step 5: Environment Promotion Workflow\n```yaml\n# .github\u002Fworkflows\u002Fpromotion.yml\nname: Environment Promotion\n\non:\n  workflow_dispatch:\n    inputs:\n      source_env:\n        description: 'Source environment'\n        required: true\n        type: choice\n        options:\n          - staging\n      target_env:\n        description: 'Target environment'\n        required: true\n        type: choice\n        options:\n          - production\n      version:\n        description: 'Version to promote (e.g., v1.2.3)'\n        required: true\n\njobs:\n  validate:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions\u002Fcheckout@v4\n\n      - name: Validate version exists in source\n        run: |\n          # Check that the version exists and is deployed in source\n          SOURCE_VERSION=$(curl -sf \"${{ secrets.STAGING_URL }}\u002Fhealth\" | jq -r '.version')\n          if [ \"$SOURCE_VERSION\" != \"${{ inputs.version }}\" ]; then\n            echo \"Version mismatch: staging has $SOURCE_VERSION, expected ${{ inputs.version }}\"\n            exit 1\n          fi\n\n      - name: Validate staging tests passed\n        run: |\n          # Check that all tests passed for this version\n          gh run list --workflow=openevidence-ci.yml \\\n            --branch=main --status=success \\\n            --json conclusion,headBranch | jq -e '.[0]'\n\n  promote:\n    needs: validate\n    runs-on: ubuntu-latest\n    environment: production\n    steps:\n      - uses: actions\u002Fcheckout@v4\n        with:\n          ref: ${{ inputs.version }}\n\n      - name: Setup Cloud SDK\n        uses: google-github-actions\u002Fsetup-gcloud@v2\n        with:\n          project_id: ${{ secrets.PROD_PROJECT_ID }}\n\n      - name: Deploy to Production\n        run: |\n          gcloud run deploy clinical-evidence-api \\\n            --image gcr.io\u002F${{ secrets.STAGING_PROJECT_ID }}\u002Fclinical-evidence-api:${{ inputs.version }} \\\n            --region us-central1 \\\n            --set-env-vars NODE_ENV=production \\\n            --no-traffic\n\n      - name: Run smoke tests\n        run: |\n          REVISION=$(gcloud run revisions list --service clinical-evidence-api \\\n            --region us-central1 --format 'value(metadata.name)' --limit 1)\n          # Test the new revision directly\n          .\u002Fscripts\u002Fsmoke-test.sh \"$REVISION\"\n\n      - name: Gradual traffic shift\n        run: |\n          # 10% -> 50% -> 100%\n          for percent in 10 50 100; do\n            gcloud run services update-traffic clinical-evidence-api \\\n              --region us-central1 \\\n              --to-latest=$percent\n            sleep 300 # Wait 5 minutes between shifts\n          done\n\n      - name: Create production release\n        uses: softprops\u002Faction-gh-release@v1\n        with:\n          tag_name: ${{ inputs.version }}-production\n          name: Production Release ${{ inputs.version }}\n          body: |\n            Promoted to production from staging.\n            Original version: ${{ inputs.version }}\n```\n\n### Step 6: Environment Health Checks\n```typescript\n\u002F\u002F src\u002Fhealth\u002Fenvironment-health.ts\nimport { OpenEvidenceClientFactory } from '..\u002Fopenevidence\u002Fclient-factory';\nimport { getConfig } from '..\u002Fconfig';\n\ninterface EnvironmentHealth {\n  environment: string;\n  status: 'healthy' | 'degraded' | 'unhealthy';\n  checks: {\n    openevidence: { status: string; latencyMs?: number };\n    cache: { status: string; hitRate?: number };\n    database: { status: string };\n  };\n  version: string;\n  timestamp: string;\n}\n\nexport async function checkEnvironmentHealth(): Promise\u003CEnvironmentHealth> {\n  const config = getConfig();\n  const checks: EnvironmentHealth['checks'] = {\n    openevidence: { status: 'unknown' },\n    cache: { status: 'unknown' },\n    database: { status: 'unknown' },\n  };\n\n  \u002F\u002F Check OpenEvidence connectivity\n  try {\n    const client = OpenEvidenceClientFactory.getClient();\n    const start = Date.now();\n    await client.health.check();\n    checks.openevidence = {\n      status: 'healthy',\n      latencyMs: Date.now() - start,\n    };\n  } catch (error: any) {\n    checks.openevidence = { status: 'unhealthy' };\n  }\n\n  \u002F\u002F Check cache\n  try {\n    if (config.cache.enabled) {\n      const stats = await cache.getStats();\n      checks.cache = {\n        status: 'healthy',\n        hitRate: stats.hitRate,\n      };\n    } else {\n      checks.cache = { status: 'disabled' };\n    }\n  } catch {\n    checks.cache = { status: 'unhealthy' };\n  }\n\n  \u002F\u002F Check database\n  try {\n    await db.$queryRaw`SELECT 1`;\n    checks.database = { status: 'healthy' };\n  } catch {\n    checks.database = { status: 'unhealthy' };\n  }\n\n  \u002F\u002F Determine overall status\n  const unhealthyCount = Object.values(checks).filter(\n    c => c.status === 'unhealthy'\n  ).length;\n\n  let status: EnvironmentHealth['status'] = 'healthy';\n  if (unhealthyCount > 0) status = 'degraded';\n  if (checks.openevidence.status === 'unhealthy') status = 'unhealthy';\n\n  return {\n    environment: config.env,\n    status,\n    checks,\n    version: process.env.npm_package_version || 'unknown',\n    timestamp: new Date().toISOString(),\n  };\n}\n```\n\n## Output\n- Environment-specific configuration files\n- Configuration loader with env var overrides\n- Secret management per environment\n- Promotion workflow\n- Health checks per environment\n\n## Environment Checklist\n\n### Development\n- [ ] Sandbox API key configured\n- [ ] Local .env file created\n- [ ] Cache disabled for fresh responses\n- [ ] Debug logging enabled\n\n### Staging\n- [ ] Separate sandbox API key\n- [ ] Secrets in Secret Manager\n- [ ] Webhooks configured\n- [ ] HIPAA audit logging enabled\n- [ ] Performance testing completed\n\n### Production\n- [ ] Production API key from OpenEvidence\n- [ ] BAA signed\n- [ ] All secrets in Secret Manager\n- [ ] Monitoring and alerting configured\n- [ ] Runbook documented\n- [ ] On-call rotation established\n\n## Error Handling\n| Environment Issue | Detection | Resolution |\n|-------------------|-----------|------------|\n| Wrong API endpoint | Health check fails | Verify baseUrl in config |\n| Secret not found | Startup failure | Check Secret Manager permissions |\n| Config mismatch | Unexpected behavior | Validate config loading |\n| Promotion failure | CI\u002FCD error | Check version tagging |\n\n## Resources\n- [OpenEvidence Sandbox](https:\u002F\u002Fsandbox.openevidence.com\u002F)\n- [Google Cloud Secret Manager](https:\u002F\u002Fcloud.google.com\u002Fsecret-manager)\n\n## Next Steps\nFor observability setup, see `openevidence-observability`.\n",{"name":5,"author":46,"license":15,"version":47,"description":48,"allowed-tools":49},"Jeremy Longshore \u003Cjeremy@intentsolutions.io>","1.0.0","Configure OpenEvidence across development, staging, and production environments.\nUse when setting up multiple environments, managing environment-specific configurations,\nor implementing environment promotion strategies for clinical AI applications.\nTrigger with phrases like \"openevidence environments\", \"openevidence staging\",\n\"openevidence dev setup\", \"multi-environment openevidence\".\n","Read, Write, Edit","main","90b50ed0778745a80fd5bfb13b1843d45b9e82f7","tests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Fopenevidence-pack\u002Fskills\u002Fopenevidence-multi-env-setup",233,"https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust","https:\u002F\u002Fgithub.com\u002FDicklesworthstone","https:\u002F\u002Fwww.jeffreyemanuel.com\u002F","Building in NY","2026-11-15 01:54:15",{"source":8,"skillName":5,"commands":60,"prompt":70,"zipAvailable":71},[61,64,67],{"tool":62,"command":63},"npx","npx skills add Dicklesworthstone\u002Fpi_agent_rust --skill openevidence-multi-env-setup",{"tool":65,"command":66},"bunx","bunx skills add Dicklesworthstone\u002Fpi_agent_rust --skill openevidence-multi-env-setup",{"tool":68,"command":69},"pnpm","pnpm dlx skills add Dicklesworthstone\u002Fpi_agent_rust --skill openevidence-multi-env-setup","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Fplugins-community\u002Fplugins\u002Fsaas-packs\u002Fopenevidence-pack\u002Fskills\u002Fopenevidence-multi-env-setup\u002FSKILL.md",true,[],[74,108,143,166,192,219],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":78,"licenseFileUrl":79,"sourceHtmlUrl":80,"categories":81,"keywords":87,"publishedAt":107},"01M6FCR7G5A005P364Z6ZWCJDP","theme-factory","Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors\u002Ffonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fcreative-design\u002Ftheme-factory\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fcreative-design\u002Ftheme-factory\u002FSKILL.md",[82],{"categoryNo":83,"categoryName":84,"taxonomyType":85,"taxonomyTypeDesc":86},"01JBSEEDCAT000000000000015","视觉设计","SCENARIO","使用场景",[88,89,90,91,92,93,94,95,96,97,98,99,100,101,102,103,104,105,106],"theme factory","factory","theme","docs","toolkit","generate","artifacts","SET","fly","slides","landing","html","styling","artifact","pages","themes","with","you","fonts","2026-11-11 15:11:14",{"skillNo":109,"name":110,"nameZh":6,"description":111,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":78,"licenseFileUrl":112,"sourceHtmlUrl":113,"categories":114,"keywords":118,"publishedAt":41},"01M6FEGPPK0ZTKCCM0R3E3KS33","web-artifacts-builder","Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn\u002Fui). Use for complex artifacts requiring state management, routing, or shadcn\u002Fui components - not for simple single-file HTML\u002FJSX artifacts.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Futilities\u002Fweb-artifacts-builder\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Futilities\u002Fweb-artifacts-builder\u002FSKILL.md",[115],{"categoryNo":116,"categoryName":117,"taxonomyType":85,"taxonomyTypeDesc":86},"01JBSEEDCAT000000000000009","前端开发",[119,120,94,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,99,137,138,139,21,140,141,142],"web artifacts builder","web","artifacts builder","builder","frontend","css","components","react","component","routing","state management","state","shadcn","file","ui","Tools","Tailwind","use","single-file","simple","ui components","for","jsx","suite",{"skillNo":144,"name":145,"nameZh":6,"description":146,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":78,"licenseFileUrl":147,"sourceHtmlUrl":148,"categories":149,"keywords":154,"publishedAt":41},"01M6FEE9VTK1W4GY21AKREJXRG","webapp-testing","Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fsecurity\u002Fwebapp-testing\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fsecurity\u002Fwebapp-testing\u002FSKILL.md",[150,153],{"categoryNo":151,"categoryName":152,"taxonomyType":85,"taxonomyTypeDesc":86},"01JBSEEDCAT000000000000008","测试与质量",{"categoryNo":116,"categoryName":117,"taxonomyType":85,"taxonomyTypeDesc":86},[155,156,157,123,158,159,120,160,92,161,133,162,163,164,165,104,140],"testing","webapp testing","webapp","screenshots","playwright","debugging","browser","logs","applications","behavior","local",{"skillNo":167,"name":168,"nameZh":6,"description":169,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":170,"sourceHtmlUrl":171,"categories":172,"keywords":173,"publishedAt":41},"01M6FE20F7ZTQBFWKF4MPJ2SBX","neuropixels-analysis","Neuropixels neural recording analysis. Load SpikeGLX\u002FOpenEphys data, preprocess, motion correction, Kilosort4 spike sorting, quality metrics, Allen\u002FIBL curation, AI-assisted visual analysis, for Neuropixels 1.0\u002F2.0 extracellular electrophysiology. Use when working with neural recordings, spike sorting, extracellular electrophysiology, or when the user mentions Neuropixels, SpikeGLX, Open Ephys, Kilosort, quality metrics, or unit curation.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fscientific\u002Fneuropixels-analysis\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fscientific\u002Fneuropixels-analysis\u002FSKILL.md",[],[174,175,176,177,178,179,180,181,136,182,183,184,185,186,187,188,104,189,190,191,140,24],"analysis","neuropixels analysis","spike","metrics","data","open","quality","user","recordings","Neural","motion","visual","quality metrics","unit","sorting","curation","recording","load",{"skillNo":193,"name":194,"nameZh":6,"description":195,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":78,"licenseFileUrl":196,"sourceHtmlUrl":197,"categories":198,"keywords":202,"publishedAt":41},"01M6FDP0PDK6F1GGX395C7625Z","skill-creator","Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fskill-creator\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fskill-creator\u002FSKILL.md",[199],{"categoryNo":200,"categoryName":201,"taxonomyType":85,"taxonomyTypeDesc":86},"01JBSEEDCAT000000000000023","Skill与智能体开发",[203,204,205,206,207,208,209,210,211,212,213,214,215,216,104,140,217,24,218],"skill creator","creator","workflows","create","update","capabilities","knowledge","tool","integrations","specialized","guide","new skill","existing skill","users","Existing","new",{"skillNo":220,"name":221,"nameZh":6,"description":222,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":223,"sourceHtmlUrl":224,"categories":225,"keywords":227,"publishedAt":41},"01M6FDM8Y7VK7NYG9SM7QPA3PW","notebooklm","Use this skill to query your Google NotebookLM notebooks directly from Claude Code for source-grounded, citation-backed answers from Gemini. Browser automation, library management, persistent auth. Drastically reduced hallucinations through document-only responses.","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fnotebooklm\u002FLICENSE","https:\u002F\u002Fgithub.com\u002FDicklesworthstone\u002Fpi_agent_rust\u002Fblob\u002Fmain\u002Ftests\u002Fext_conformance\u002Fartifacts\u002Ftemplates-davila7\u002Fcli-tool\u002Fcomponents\u002Fskills\u002Fproductivity\u002Fnotebooklm\u002FSKILL.md",[226],{"categoryNo":200,"categoryName":201,"taxonomyType":85,"taxonomyTypeDesc":86},[221,228,229,230,231,232,233,161,234,235,136,236,237,238,239,140,240],"google","browser automation","gemini","automation","auth","code","library","management","only","document","query","Citation","source"]