Skip to main content

Cloud Migrate

@aaronge/cloud-migratev2026.11.13.1beta· MIT· 5d agoBEHAVIORSWORKFLOWSREPORTSSKILLSACCEPTED WARNINGS
01README

Plan and verify migrations between clouds, from one bucket to a whole estate: 21 resource kinds (networks, subnets, firewalls, VMs, volumes, SQL databases, DNS, load balancers, Kubernetes, registries, queues, functions, caches, file shares, NoSQL, KMS keys, secrets, IAM) across AWS, Google Cloud, DigitalOcean and Hetzner. Reads the official per-cloud swamp behaviors' data, maps each resource onto the target (exact, lossy, needs-decision or unsupported) with dependencies wired by CEL, orders it into dependency waves with transfer and rollback steps, and proves parity once the target is provisioned. Calls no cloud API itself, and ships a stagecraft factory that stops for a person before every irreversible step.

02Behaviors1
@aaronge/cloud-migratev2026.11.13.1cloud_migrate.ts

Global Arguments

ArgumentTypeDescription
sourceobject
targetobject
maxPerWave?numberMost resources in one wave.
fn inventory()
Read the source behaviors' state data and normalise every in-scope resource. Calls no cloud API.
fn map()
Map every inventoried resource onto the target provider, grading each exact, lossy, needs-decision or unsupported.
fn plan()
Order mapped resources into dependency waves with provisioning, data transfer, verification and rollback steps. Changes nothing.
fn resolve(sourceId: string, resolution: string, by: string, decision?: string, overrides?: record, exclude?: boolean, transfer?: string, clear?: boolean)
Record a person's decision on a mapped resource: settle one decision (or all), set target global arguments, or exclude the resource. Run map again to apply it.
ArgumentTypeDescription
sourceIdstringThe resource's source id from the mapping, e.g. aws:vm:i-0abc.
resolutionstringWhat was decided, in the person's words.
bystringWho decided. Record only a person's decision, never an agent's own.
decision?stringText identifying the decision this settles (a substring of it). Omit to settle every open decision on the resource.
overrides?recordMerged into the target\
exclude?booleanLeave this resource out of the migration.
transfer?stringReplace the planned data transfer method with this one, in the person's words (e.g. rebuild from configuration management instead of replicating disks).
clear?booleanForget every resolution recorded for this resource instead.
fn parity(wave?: number)
Compare each provisioned target resource (from its behavior's state data) with what the mapping promised.
ArgumentTypeDescription
wave?numberOnly check this wave's resources. Omit to check every planned resource.

Resources

inventory(infinite)— Every in-scope source resource in canonical form, plus records no adapter understands.
mapping(infinite)— Each resource mapped onto the target: target behavior type and global arguments, fidelity, losses and decisions.
plan(infinite)— Dependency-ordered waves with provisioning, data transfer, verification and rollback per resource.
resolutions(infinite)— Decisions people have settled, by source resource: what was decided, by whom, overrides and exclusions. map applies them.
parity(infinite)— The provisioned target compared with what the mapping promised.
03Workflows1
@aaronge/cloud-migrate/assess1bd30465-b8b8-4cda-9880-2a7852548ad3

Assess a cloud-to-cloud migration: optionally refresh each source provider behavior (its list method), then build the migration's inventory, map every source resource to its target equivalent, and write the plan. Reads and plans only; nothing is created or changed in either cloud. Run manually by whoever is driving the migration; there is no schedule.

refreshRun list on each source behavior (no steps when the array is empty).
1.list${{ self.source }}.list— Refresh one source provider behavior.
assessInventory the sources, map them onto the target, and write the plan.
1.inventory${{ inputs.migration }}.inventory
2.map${{ inputs.migration }}.map
3.plan${{ inputs.migration }}.plan
04Reports1
@aaronge/cloud-migrate-planmodel
migration_plan.ts

Markdown migration plan for approval: open and resolved decisions, waves, losses, unsupported resources and parity.

migrationplanapproval
05Skills1
cloud-migrate6 files
06Stats
A
100 / 100
Downloads
0
Archive size
211.4 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Docs keep secrets in a vault1/1earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License2/2earned
  • Verified public repository2/2earned

08Platforms
09Labels