palantir-upgrade-migration

# Palantir Upgrade & Migration ## Overview Safely upgrade `foundry-platform-sdk` versions, handle breaking changes, and migrate between Foundry API versions. Includes a step-by-step upgrade checklist and rollback procedure. ## Prerequisites - Current `foundry-platform-sdk` installed - Git for version control - Test suite covering Foundry API calls - Staging environment ## Instructions ### Step 1: Check Current Version and Available Updates ```bash set -euo pipefail pip show foundry-platform-sdk | grep -E "^(Name|Version)" pip index versions foundry-platform-sdk 2>/dev/null | head -3 # Check OSDK version too npm list @osdk/client 2>/dev/null || echo "OSDK not installed" ``` ### Step 2: Review Changelog ```bash # Check GitHub releases for breaking changes python -c " import urllib.request, json url = 'https://api.github.com/repos/palantir/foundry-platform-python/releases?per_page=5' releases = json.loads(urllib.request.urlopen(url).read()) for r in releases: print(f'{r[\"tag_name\"]:12s} {r[\"published_at\"][:10]}') body = r.get('body', '')[:200] if 'BREAKING' in body.upper(): print(f' *** BREAKING CHANGES DETECTED ***') print() " ``` ### Step 3: Create Upgrade Branch and Update ```bash set -euo pipefail git checkout -b upgrade/foundry-sdk-$(date +%Y%m%d) pip install --upgrade foundry-platform-sdk pip show foundry-platform-sdk | grep Version ``` ### Step 4: Run Tests and Fix Breaking Changes ```bash set -euo pipefail pytest tests/ -v --tb=short 2...