Skip to main content
AI/MLjeremylongshore

hex-upgrade-migration

'Analyze, plan, and execute Hex SDK upgrades with breaking change detection.

Stars
2,267
Source
jeremylongshore/claude-code-plugins-plus-skills
Updated
2026-05-31
Slug
jeremylongshore--claude-code-plugins-plus-skills--hex-upgrade-migration
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/jeremylongshore/claude-code-plugins-plus-skills/HEAD/plugins/saas-packs/hex-pack/skills/hex-upgrade-migration/SKILL.md -o .claude/skills/hex-upgrade-migration.md

Drops the SKILL.md into .claude/skills/hex-upgrade-migration.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

Hex Upgrade & Migration

Overview

Hex API is versioned at /api/v1/. Monitor the Hex changelog for new endpoints and deprecations.

Instructions

Check API Usage

grep -r "app.hex.tech" src/ --include="*.ts" --include="*.py"

Airflow Provider Updates

pip install --upgrade airflow-provider-hex

Prerequisites

  • Pinned current and target versions, a compatibility assessment, sandbox project fixtures, and an owner for each changed contract.
  • Versioned configuration backups plus approved downgrade, cancellation, and integration-disable procedures.

Output

Produce an upgrade receipt with from/to versions, affected contracts, fixture/canary outcomes, aggregate assertions, owner approval, compatibility decision, and rollback revision. Exclude SQL, workspace output, and credentials.

Error Handling

Stop for incompatible parameter/output contracts, authorization drift, unbounded replays, or a failed canary assertion. Restore the exact pinned prior revision and retain redacted evidence rather than forcing migration.

Examples

from=client-r12; to=client-r13; sandbox=pass; staging=pass; assertions=pass; canary=held; rollback=r12 is a defensible upgrade record.

Resources