Fabric Airlift CLI (fa)

fa is the migration-program CLI for Fabric Airlift. It manages engagement scope, assessment, conversion, transfer, readiness, and migration evidence. It does not deploy, promote, roll back, or reconcile Databricks releases; those operations belong to Fabric Runway's fr CLI.

npm install --global @fabricorg/airlift-cli

fa doctor --profile production
fa actions --json
fa profiles
fa sources
fa source inspect snowflake
fa source plan oracle --json
fa migration-ir import --source adf-synapse --file adf-export/ --estate-name "Commerce ADF" --snapshot-at 2030-01-15T12:00:00Z --output migration-ir.json
fa migration-ir generate --file migration-ir.json --out-dir generated
fa migration-ir validate --file generated/artifact-set.json --root generated
fa application-kit init --name "Customer operations" --module customer_intelligence --cloud azure
fa application-kit validate --file application-kit.json
fa application-kit plan --file application-kit.json --json
fa application-kit qualify --file application-plan.json --evidence application-evidence.json --level hermetic_proven
fa certificate verify certificate.json --keys public-keys.json

For a pinned CI invocation:

npx --yes --package @fabricorg/[email protected] fa source recipe synapse --format json

Authenticated engagement commands use AIRLIFT_API_URL and a short-lived DATABRICKS_TOKEN:

fa engagement create --file engagement.json --idempotency-key onboarding-42
fa engagement list
fa connection register --file source-binding.json --idempotency-key binding-42

For a migration release, declare the outcome Airlift needs and let the admitted Runway integration supply verified release state:

fa deployment require --file deployment-requirement.json --idempotency-key wave-3-release
fa deployment status dpr_01J... --json
fa validation run --file validation-request.json --idempotency-key wave-3-validation
fa discrepancy list --object-id obj_01J... --json
fa certificate list --object-id obj_01J... --json

Discover one resource group at a time and generate completion for your shell:

fa help inventory
fa inventory graph list --assessment-id asm_01J...
fa conversion batch list --engagement-id eng_01J...
fa application-kit module list
fa completion bash

Use --format text|table|json|yaml|jsonl for automation (--json is the concise JSON form), --file - for JSON stdin, --correlation-id for trace propagation, and --timeout to bound remote calls. fa commands --json emits the versioned command manifest. There are no deprecated command aliases. Use the exact resource-first paths from fa commands --json.

For direct Databricks delivery without an Airlift migration engagement, use fr deploy, fr promote, and the Runway console or API. Do not create a synthetic Airlift estate merely to operate Runway.

The CLI has no local mutation or identity override mode. Remote changes use the authenticated Airlift transport described by ADR-0007.