Skip to content

team-telnyx/ai / providers/claude/plugins/telnyx-platform/skills/telnyx-twilio-migration

telnyx-twilio-migration

Unverified

Migrate from Twilio to Telnyx. Orchestrates a complete 6-phase migration: discovery, planning, setup, code migration, validation, and cleanup. Covers voice (TwiML to TeXML, Call Control API), messaging, WebRTC, SIP trunking, verify, fax, video, IoT, number lookup, and porting. Includes automated scanners, validation scripts, and integration tests.

FileKindSize
SKILL.mdskill md43.3 KB
references/account-setup-guide.mdmarkdown17.8 KB
references/error-code-mapping.mdmarkdown11.0 KB
references/fax-migration.mdmarkdown14.7 KB
references/iot-migration.mdmarkdown17.9 KB
references/lookup-migration.mdmarkdown14.3 KB
references/messaging-migration.mdmarkdown36.5 KB
references/mobile-sdk-migration.mdmarkdown38.6 KB
references/number-porting.mdmarkdown17.0 KB
references/numbers-migration.mdmarkdown21.1 KB
references/product-mapping.mdmarkdown6.7 KB
references/sdk-api-details/10dlc.mdmarkdown9.8 KB
references/sdk-api-details/ai-assistants.mdmarkdown5.8 KB
references/sdk-api-details/messaging.mdmarkdown16.1 KB
references/sdk-api-details/numbers.mdmarkdown10.1 KB
references/sdk-api-details/voice.mdmarkdown9.6 KB
references/sip-trunking-migration.mdmarkdown18.1 KB
references/texml-verbs.mdmarkdown43.7 KB
references/unsupported-products.mdmarkdown3.5 KB
references/verify-migration.mdmarkdown18.4 KB
references/video-migration.mdmarkdown20.6 KB
references/voice-migration.mdmarkdown37.2 KB
references/webhook-migration.mdmarkdown20.3 KB
references/webrtc-migration.mdmarkdown50.0 KB
scripts/lint-telnyx-correctness.shexecutablescript31.4 KB
scripts/migration-state.shexecutablescript7.3 KB
scripts/post-test-diagnostic.shexecutablescript18.9 KB
scripts/preflight-check.shexecutablescript13.4 KB
scripts/run-discovery.shexecutablescript7.7 KB
scripts/run-validation.shexecutablescript13.1 KB
scripts/scan-twilio-deep.pyexecutablescript64.8 KB
scripts/scan-twilio-usage.shexecutablescript29.1 KB
scripts/test-migration/smoke-test.shexecutablescript10.0 KB
scripts/test-migration/test-fax.shexecutablescript8.7 KB
scripts/test-migration/test-lookup.shexecutablescript5.5 KB
scripts/test-migration/test-messaging.shexecutablescript18.8 KB
scripts/test-migration/test-sip.shexecutablescript29.6 KB
scripts/test-migration/test-verify.shexecutablescript13.6 KB
scripts/test-migration/test-voice.shexecutablescript22.4 KB
scripts/test-migration/test-webhooks-local.pyexecutablescript9.7 KB
scripts/test-migration/test-webrtc.shexecutablescript24.0 KB
scripts/test-migration/webhook-receiver.pyexecutablescript11.8 KB
scripts/validate-migration.shexecutablescript31.1 KB
scripts/validate-texml.shexecutablescript61.4 KB
sdk-reference/curl/10dlc.mdmarkdown25.8 KB
sdk-reference/curl/account-access.mdmarkdown15.6 KB
sdk-reference/curl/account-management.mdmarkdown9.5 KB
sdk-reference/curl/account-notifications.mdmarkdown11.0 KB
sdk-reference/curl/account-reports.mdmarkdown45.5 KB
sdk-reference/curl/account.mdmarkdown8.1 KB
sdk-reference/curl/ai-assistants.mdmarkdown34.3 KB
sdk-reference/curl/ai-inference.mdmarkdown34.5 KB
sdk-reference/curl/fax.mdmarkdown19.8 KB
sdk-reference/curl/iot.mdmarkdown49.4 KB
sdk-reference/curl/messaging-hosted.mdmarkdown23.3 KB
sdk-reference/curl/messaging-profiles.mdmarkdown14.2 KB
sdk-reference/curl/messaging.mdmarkdown29.1 KB
sdk-reference/curl/missions.mdmarkdown23.5 KB
sdk-reference/curl/networking.mdmarkdown39.8 KB
sdk-reference/curl/numbers-compliance.mdmarkdown30.2 KB
sdk-reference/curl/numbers-config.mdmarkdown29.7 KB
sdk-reference/curl/numbers-services.mdmarkdown12.6 KB
sdk-reference/curl/numbers.mdmarkdown24.0 KB
sdk-reference/curl/oauth.mdmarkdown15.6 KB
sdk-reference/curl/porting-in.mdmarkdown35.1 KB
sdk-reference/curl/porting-out.mdmarkdown9.8 KB
sdk-reference/curl/sip-integrations.mdmarkdown27.5 KB
sdk-reference/curl/sip.mdmarkdown47.6 KB
sdk-reference/curl/storage.mdmarkdown4.2 KB
sdk-reference/curl/texml.mdmarkdown31.4 KB
sdk-reference/curl/verify.mdmarkdown13.2 KB
sdk-reference/curl/video.mdmarkdown17.2 KB
sdk-reference/curl/voice-advanced.mdmarkdown32.8 KB
sdk-reference/curl/voice-conferencing.mdmarkdown41.6 KB
sdk-reference/curl/voice-gather.mdmarkdown14.7 KB
sdk-reference/curl/voice-media.mdmarkdown17.8 KB
sdk-reference/curl/voice-streaming.mdmarkdown13.3 KB
sdk-reference/curl/voice.mdmarkdown37.6 KB
sdk-reference/curl/webrtc.mdmarkdown6.5 KB
sdk-reference/go/10dlc.mdmarkdown29.0 KB
sdk-reference/go/account-access.mdmarkdown17.0 KB
sdk-reference/go/account-management.mdmarkdown9.9 KB
sdk-reference/go/account-notifications.mdmarkdown12.4 KB
sdk-reference/go/account-reports.mdmarkdown31.5 KB
sdk-reference/go/account.mdmarkdown9.1 KB
sdk-reference/go/ai-assistants.mdmarkdown37.7 KB
sdk-reference/go/ai-inference.mdmarkdown27.1 KB
sdk-reference/go/fax.mdmarkdown20.2 KB
sdk-reference/go/iot.mdmarkdown51.3 KB
sdk-reference/go/messaging-hosted.mdmarkdown24.5 KB
sdk-reference/go/messaging-profiles.mdmarkdown15.2 KB
sdk-reference/go/messaging.mdmarkdown30.1 KB
sdk-reference/go/missions.mdmarkdown26.9 KB
sdk-reference/go/networking.mdmarkdown42.5 KB
sdk-reference/go/numbers-compliance.mdmarkdown28.2 KB
sdk-reference/go/numbers-config.mdmarkdown29.5 KB
sdk-reference/go/numbers-services.mdmarkdown14.1 KB
sdk-reference/go/numbers.mdmarkdown26.7 KB
sdk-reference/go/oauth.mdmarkdown11.7 KB
sdk-reference/go/porting-in.mdmarkdown41.1 KB
sdk-reference/go/porting-out.mdmarkdown10.9 KB
sdk-reference/go/sip-integrations.mdmarkdown32.3 KB
sdk-reference/go/sip.mdmarkdown49.1 KB
sdk-reference/go/storage.mdmarkdown4.8 KB
sdk-reference/go/texml.mdmarkdown35.7 KB
sdk-reference/go/verify.mdmarkdown14.4 KB
sdk-reference/go/video.mdmarkdown18.6 KB
sdk-reference/go/voice-advanced.mdmarkdown33.2 KB
sdk-reference/go/voice-conferencing.mdmarkdown42.3 KB
sdk-reference/go/voice-gather.mdmarkdown14.5 KB
sdk-reference/go/voice-media.mdmarkdown18.1 KB
sdk-reference/go/voice-streaming.mdmarkdown13.5 KB
sdk-reference/go/voice.mdmarkdown39.2 KB
sdk-reference/go/webrtc.mdmarkdown7.5 KB
sdk-reference/java/10dlc.mdmarkdown31.3 KB
sdk-reference/java/account-access.mdmarkdown18.5 KB
sdk-reference/java/account-management.mdmarkdown11.1 KB
sdk-reference/java/account-notifications.mdmarkdown14.3 KB
sdk-reference/java/account-reports.mdmarkdown36.5 KB
sdk-reference/java/account.mdmarkdown10.3 KB
sdk-reference/java/ai-assistants.mdmarkdown39.2 KB
sdk-reference/java/ai-inference.mdmarkdown30.7 KB
sdk-reference/java/fax.mdmarkdown21.5 KB
sdk-reference/java/iot.mdmarkdown57.5 KB
sdk-reference/java/messaging-hosted.mdmarkdown28.4 KB
sdk-reference/java/messaging-profiles.mdmarkdown15.7 KB
sdk-reference/java/messaging.mdmarkdown32.2 KB
sdk-reference/java/missions.mdmarkdown31.6 KB
sdk-reference/java/networking.mdmarkdown47.1 KB
sdk-reference/java/numbers-compliance.mdmarkdown31.1 KB
sdk-reference/java/numbers-config.mdmarkdown32.2 KB
sdk-reference/java/numbers-services.mdmarkdown15.9 KB
sdk-reference/java/numbers.mdmarkdown28.4 KB
sdk-reference/java/oauth.mdmarkdown13.0 KB
sdk-reference/java/porting-in.mdmarkdown46.2 KB
sdk-reference/java/porting-out.mdmarkdown11.9 KB
sdk-reference/java/sip-integrations.mdmarkdown38.1 KB
sdk-reference/java/sip.mdmarkdown51.9 KB
sdk-reference/java/storage.mdmarkdown5.7 KB
sdk-reference/java/texml.mdmarkdown41.3 KB
sdk-reference/java/verify.mdmarkdown16.0 KB
sdk-reference/java/video.mdmarkdown20.3 KB
sdk-reference/java/voice-advanced.mdmarkdown35.0 KB
sdk-reference/java/voice-conferencing.mdmarkdown46.0 KB
sdk-reference/java/voice-gather.mdmarkdown16.1 KB
sdk-reference/java/voice-media.mdmarkdown19.5 KB
sdk-reference/java/voice-streaming.mdmarkdown14.7 KB
sdk-reference/java/voice.mdmarkdown40.8 KB
sdk-reference/java/webrtc.mdmarkdown8.5 KB
sdk-reference/javascript/10dlc.mdmarkdown28.5 KB
sdk-reference/javascript/account-access.mdmarkdown15.9 KB
sdk-reference/javascript/account-management.mdmarkdown9.6 KB
sdk-reference/javascript/account-notifications.mdmarkdown11.7 KB
sdk-reference/javascript/account-reports.mdmarkdown29.3 KB
sdk-reference/javascript/account.mdmarkdown8.7 KB
sdk-reference/javascript/ai-assistants.mdmarkdown37.5 KB
sdk-reference/javascript/ai-inference.mdmarkdown24.4 KB
sdk-reference/javascript/fax.mdmarkdown19.9 KB
sdk-reference/javascript/iot.mdmarkdown47.4 KB
sdk-reference/javascript/messaging-hosted.mdmarkdown22.4 KB
sdk-reference/javascript/messaging-profiles.mdmarkdown14.8 KB
sdk-reference/javascript/messaging.mdmarkdown29.7 KB
sdk-reference/javascript/missions.mdmarkdown23.8 KB
sdk-reference/javascript/networking.mdmarkdown39.3 KB
sdk-reference/javascript/numbers-compliance.mdmarkdown25.9 KB
sdk-reference/javascript/numbers-config.mdmarkdown28.3 KB
sdk-reference/javascript/numbers-services.mdmarkdown13.0 KB
sdk-reference/javascript/numbers.mdmarkdown26.1 KB
sdk-reference/javascript/oauth.mdmarkdown10.8 KB
sdk-reference/javascript/porting-in.mdmarkdown37.4 KB
sdk-reference/javascript/porting-out.mdmarkdown10.2 KB
sdk-reference/javascript/sip-integrations.mdmarkdown28.5 KB
sdk-reference/javascript/sip.mdmarkdown47.4 KB
sdk-reference/javascript/storage.mdmarkdown4.5 KB
sdk-reference/javascript/texml.mdmarkdown31.9 KB
sdk-reference/javascript/verify.mdmarkdown13.3 KB
sdk-reference/javascript/video.mdmarkdown17.2 KB
sdk-reference/javascript/voice-advanced.mdmarkdown32.6 KB
sdk-reference/javascript/voice-conferencing.mdmarkdown40.4 KB
sdk-reference/javascript/voice-gather.mdmarkdown14.3 KB
sdk-reference/javascript/voice-media.mdmarkdown17.8 KB
sdk-reference/javascript/voice-streaming.mdmarkdown13.4 KB
sdk-reference/javascript/voice.mdmarkdown39.4 KB
sdk-reference/javascript/webrtc.mdmarkdown7.2 KB
sdk-reference/python/10dlc.mdmarkdown28.5 KB
sdk-reference/python/account-access.mdmarkdown15.0 KB
sdk-reference/python/account-management.mdmarkdown9.1 KB
sdk-reference/python/account-notifications.mdmarkdown10.9 KB
sdk-reference/python/account-reports.mdmarkdown28.1 KB
sdk-reference/python/account.mdmarkdown8.1 KB
sdk-reference/python/ai-assistants.mdmarkdown37.3 KB
sdk-reference/python/ai-inference.mdmarkdown23.4 KB
sdk-reference/python/fax.mdmarkdown19.5 KB
sdk-reference/python/iot.mdmarkdown45.3 KB
sdk-reference/python/messaging-hosted.mdmarkdown21.7 KB
sdk-reference/python/messaging-profiles.mdmarkdown14.1 KB
sdk-reference/python/messaging.mdmarkdown29.4 KB
sdk-reference/python/missions.mdmarkdown23.2 KB
sdk-reference/python/networking.mdmarkdown37.1 KB
sdk-reference/python/numbers-compliance.mdmarkdown24.6 KB

scripts/run-discovery.sh

View on GitHub
#!/usr/bin/env bash
#
# run-discovery.sh — Phase 1: Full discovery pipeline
#
# Runs all Phase 1 steps in order: Twilio usage scan (no API key needed),
# preflight check, and optionally the deep scanner.
#
# The scanner runs FIRST so you can inspect Twilio usage even without
# a Telnyx API key. Preflight failures are reported as warnings — they
# don't block scan results.
#
# Usage: bash run-discovery.sh <project-root>
#
# Environment variables (optional for scan, required for preflight):
#   TELNYX_API_KEY   Your Telnyx API key
#
# Output:
#   <project-root>/twilio-scan.json       Scan results (products, files, patterns)
#   <project-root>/twilio-deep-scan.json  Deep scan results (if Python available)
#   stdout: Preflight report + scan summary
#
# Exit codes:
#   0 — Discovery complete (scan succeeded; preflight may have warnings)
#   2 — Invalid arguments (project root doesn't exist, etc.)

set -uo pipefail

# --- bash 4+ auto-upgrade (macOS ships bash 3.2, sub-scripts need bash 4+) ---
if [ "${BASH_VERSINFO[0]}" -lt 4 ]; then
  for _alt_bash in /opt/homebrew/bin/bash /usr/local/bin/bash; do
    if [ -x "$_alt_bash" ] && "$_alt_bash" -c 'exit $(( BASH_VERSINFO[0] < 4 ))' 2>/dev/null; then
      exec "$_alt_bash" "$0" "$@"
    fi
  done
  echo "Warning: bash 4+ recommended for full functionality. Install: brew install bash" >&2
  echo "  Continuing with bash ${BASH_VERSION} — some sub-scripts may fail." >&2
fi

# --- Resolve script directory ---
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"

# --- Colors ---
if [ -t 1 ]; then
  RED='\033[0;31m'
  YELLOW='\033[0;33m'
  GREEN='\033[0;32m'
  BLUE='\033[0;34m'
  BOLD='\033[1m'
  NC='\033[0m'
else
  RED='' YELLOW='' GREEN='' BLUE='' BOLD='' NC=''
fi

# --- Parse arguments ---
if [ $# -lt 1 ] || [ "${1:-}" = "--help" ] || [ "${1:-}" = "-h" ]; then
  echo "Usage: bash run-discovery.sh <project-root>"
  echo ""
  echo "Runs the full Phase 1 discovery pipeline:"
  echo "  1. Twilio usage scan (grep-based, no API key needed)"
  echo "  2. Preflight check (API key, account, tools)"
  echo "  3. Deep scan (AST-based, if Python available)"
  echo ""
  echo "Produces: twilio-scan.json and twilio-deep-scan.json in <project-root>"
  exit 0
fi

PROJECT_ROOT="$1"

if [ ! -d "$PROJECT_ROOT" ]; then
  echo -e "${RED}ERROR${NC}  Project root does not exist: $PROJECT_ROOT" >&2
  exit 2
fi

echo -e "${BOLD}═══════════════════════════════════${NC}"
echo -e "${BOLD}  Phase 1: Discovery${NC}"
echo -e "${BOLD}═══════════════════════════════════${NC}"
echo ""

# --- Step 1.1: Scan for Twilio Usage (no API key needed) ---
echo -e "${BOLD}Step 1.1: Twilio Usage Scan${NC}"
echo "─────────────────────────────"
echo -e "  ${BLUE}INFO${NC}  Scanning source code for Twilio patterns (no API key required)..."
echo ""

SCAN_OUTPUT="$PROJECT_ROOT/twilio-scan.json"
bash "$SCRIPT_DIR/scan-twilio-usage.sh" "$PROJECT_ROOT" > "$SCAN_OUTPUT" 2>/dev/null
SCAN_EXIT=$?

if [ "$SCAN_EXIT" -ne 0 ]; then
  echo -e "  ${YELLOW}WARN${NC}  Scanner exited with code $SCAN_EXIT"
fi

if [ -f "$SCAN_OUTPUT" ] && [ -s "$SCAN_OUTPUT" ]; then
  echo -e "  ${GREEN}PASS${NC}  Scan results saved to: $SCAN_OUTPUT"

  # Print summary if jq is available
  if command -v jq &>/dev/null; then
    PRODUCTS=$(jq -r '.products_used // [] | join(", ")' "$SCAN_OUTPUT" 2>/dev/null || echo "unknown")
    FILE_COUNT=$(jq -r '.files | length // 0' "$SCAN_OUTPUT" 2>/dev/null || echo "0")
    LANGUAGES=$(jq -r '.languages_detected // [] | join(", ")' "$SCAN_OUTPUT" 2>/dev/null || echo "unknown")
    echo ""
    echo -e "  ${BOLD}Scan Summary:${NC}"
    echo "  Languages:  $LANGUAGES"
    echo "  Products:   $PRODUCTS"
    echo "  Files:      $FILE_COUNT files with Twilio patterns"
  fi
else
  echo -e "  ${YELLOW}WARN${NC}  Scan produced no output — the project may have no Twilio code"
fi

echo ""

# --- Step 1.2: Preflight Check (API key, account, tools) ---
echo -e "${BOLD}Step 1.2: Preflight Check${NC}"
echo "─────────────────────────"

API_KEY_OK=true
if [ -z "${TELNYX_API_KEY:-}" ]; then
  echo -e "  ${YELLOW}WARN${NC}  TELNYX_API_KEY is not set"
  echo "  Set it with: export TELNYX_API_KEY='KEY...'"
  echo "  Get one at:  https://portal.telnyx.com/#/app/api-keys"
  echo -e "  ${BLUE}INFO${NC}  Scan results above are still valid — set the key and re-run for full preflight."
  API_KEY_OK=false
else
  bash "$SCRIPT_DIR/preflight-check.sh" "$PROJECT_ROOT"
  PREFLIGHT_EXIT=$?
  if [ "$PREFLIGHT_EXIT" -ne 0 ]; then
    echo ""
    echo -e "  ${YELLOW}WARN${NC}  Preflight check had failures. Scan results above are still valid."
    echo "  Fix preflight issues before proceeding to Phase 2."
    API_KEY_OK=false
  fi
fi

echo ""

# --- Step 1.3: Deep Scan (optional) ---
echo -e "${BOLD}Step 1.3: Deep Scan (AST-based)${NC}"
echo "──────────────────────────────────"

DEEP_SCAN_OUTPUT="$PROJECT_ROOT/twilio-deep-scan.json"

if command -v python3 &>/dev/null; then
  if [ -f "$SCRIPT_DIR/scan-twilio-deep.py" ]; then
    echo -e "  ${BLUE}INFO${NC}  Running scan-twilio-deep.py..."
    python3 "$SCRIPT_DIR/scan-twilio-deep.py" "$PROJECT_ROOT" > "$DEEP_SCAN_OUTPUT" 2>/dev/null
    DEEP_EXIT=$?
    if [ "$DEEP_EXIT" -eq 0 ] && [ -f "$DEEP_SCAN_OUTPUT" ] && [ -s "$DEEP_SCAN_OUTPUT" ]; then
      echo -e "  ${GREEN}PASS${NC}  Deep scan results saved to: $DEEP_SCAN_OUTPUT"
    else
      echo -e "  ${YELLOW}WARN${NC}  Deep scan failed or produced no output (exit code: $DEEP_EXIT)"
    fi
  else
    echo -e "  ${BLUE}INFO${NC}  Deep scanner not available — skipping"
  fi
else
  echo -e "  ${BLUE}INFO${NC}  Python3 not available — skipping deep scan"
  echo "  The grep-based scan above is sufficient for most projects."
fi

echo ""

# --- Step 1.4: Check for Partial Migration ---
echo -e "${BOLD}Step 1.4: Partial Migration Check${NC}"
echo "────────────────────────────────────"

if command -v git &>/dev/null && [ -d "$PROJECT_ROOT/.git" ]; then
  UNCOMMITTED=$(cd "$PROJECT_ROOT" && git status --porcelain 2>/dev/null | wc -l | tr -d ' ')
  if [ "$UNCOMMITTED" -gt 0 ]; then
    echo -e "  ${YELLOW}WARN${NC}  $UNCOMMITTED uncommitted changes detected"
    # Check if any changes contain Telnyx patterns (partial migration)
    TELNYX_IN_DIFF=$(cd "$PROJECT_ROOT" && git diff 2>/dev/null | grep -c -i "telnyx" || true)
    TELNYX_IN_DIFF="${TELNYX_IN_DIFF:-0}"
    if [ "$TELNYX_IN_DIFF" -gt 0 ]; then
      echo -e "  ${YELLOW}WARN${NC}  Telnyx patterns found in uncommitted changes — possible partial migration"
      echo "  Review with: cd $PROJECT_ROOT && git diff --stat"
    fi
  else
    echo -e "  ${GREEN}PASS${NC}  Git working tree is clean"
  fi
else
  echo -e "  ${BLUE}INFO${NC}  Not a git repository — skipping partial migration check"
fi

# --- Summary ---
echo ""
echo -e "${BOLD}═══════════════════════════════════${NC}"
echo -e "${BOLD}  Phase 1 Complete${NC}"
echo -e "${BOLD}═══════════════════════════════════${NC}"
echo ""
echo "  Scan results:      $SCAN_OUTPUT"
if [ -f "$DEEP_SCAN_OUTPUT" ] && [ -s "$DEEP_SCAN_OUTPUT" ]; then
  echo "  Deep scan results: $DEEP_SCAN_OUTPUT"
fi
echo ""
echo "  Next: Review scan results, triage matches, then proceed to Phase 2 (Planning)."

if [ "$API_KEY_OK" = false ]; then
  echo -e "  ${YELLOW}NOTE${NC}  Set TELNYX_API_KEY and re-run preflight before starting Phase 2."
fi
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall