Canonical fa command groups and resource paths generated from the installed CLI contract.

Generated command index

This page is generated from Fabric Airlift CLI 0.18.4. The same manifest drives fa help, group help, shell completion, tests, and this reference. It describes developer commands only; it does not include credentials, tenant data, deployment state, or internal delivery notes.

Use resource-first paths: fa <resource> <operation>. For a nested resource, continue the path: fa inventory graph list, fa conversion batch create, and fa application-kit module list. There are no deprecated spellings or hidden aliases.

Global automation options:

--format text|table|json|yaml|jsonl; --json is the concise JSON form;
--file - reads a JSON request or manifest from stdin;
--timeout <seconds> bounds remote requests and explicit waits; and
--correlation-id <id> carries a caller trace ID into governed mutations.

Generate completion with fa completion bash, fa completion zsh, or fa completion fish. Emit this command model for tooling with fa commands --json.

`fa organization`

Govern the projected organization membership registry.

Command	Behavior
`fa organization membership set --file <changes.json> --idempotency-key <key>`	Apply governed membership grants and revocations (admin role; last-admin protected).

`fa engagement`

Create and govern migration engagements.

Command	Behavior
`fa engagement list`	List engagements visible to the authenticated principal.
`fa engagement show <id>`	Show one engagement.
`fa engagement status <id>`	Show the derived eight-phase migration status and blockers.
`fa engagement create\|update --file <params.json> --idempotency-key <key>`	Create or update an engagement.
`fa engagement activate\|freeze <id> --idempotency-key <key>`	Advance the engagement lifecycle.
`fa engagement preflight <id>`	Evaluate source-capability and human-lane blockers.

`fa connection`

Command	Behavior
`fa connection list [--engagement-id <id>]`	List connection bindings.
`fa connection register --file <params.json> --idempotency-key <key>`	Register a secret-backed connection reference.
`fa connection verify <id> --digest <sha256> --idempotency-key <key>`	Verify a binding with the digest of a recorded connectivity diagnostic.
`fa connection retire <id> --reason <text> --idempotency-key <key>`	Retire a connection binding.
`fa connection test <id> [--json]`	Report observed connectivity state for a binding; exit 0 only when observed.
`fa connection diagnose <id> --file <probes.json> --idempotency-key <key>`	Record an admitted connectivity diagnostic (system principal).

`fa access`

Inspect derived Databricks deployment access and record admitted access preflights.

Command	Behavior
`fa access show [--json]`	Report the derived access-preflight state and five target-integration states; exit 0 only when access is observed.
`fa access record --file <preflight.json> --idempotency-key <key>`	Record an admitted access preflight (system principal).

`fa evaluator`

Inspect derived evaluation readiness and record admitted candidate freezes and rehearsals.

Command	Behavior
`fa evaluator window [--json]`	Report derived evaluation readiness and the evaluation-window manifest; exit 0 only when evaluation_ready is true.
`fa evaluator freeze --file <freeze.json> --idempotency-key <key>`	Freeze an evaluation candidate (admitted system principal; in-process path).
`fa evaluator rehearsal --file <rehearsal.json> --idempotency-key <key>`	Record an evaluator rehearsal against the frozen candidate (admitted system principal; in-process path).

`fa uc-evidence`

Inspect the derived Databricks-native evidence state and record admitted projection runs and reconciliations.

Command	Behavior
`fa uc-evidence show [--engagement-id <id>] [--json]`	Report the derived UC evidence state; exit 0 only when the evidence is current.
`fa uc-evidence record --kind projection-run\|reconciliation --file <record.json> --idempotency-key <key>`	Record an admitted UC projection run or target reconciliation (admitted system principal; in-process path).

`fa estate`

Command	Behavior
`fa estate list`	List estates.
`fa estate show <id>`	Show an estate.
`fa estate register --file <params.json> --idempotency-key <key>`	Register an estate.

`fa assessment`

Run and accept governed source assessments.

Command	Behavior
`fa assessment list [--estate-id <id>]`	List assessments.
`fa assessment status <id>`	Show assessment status.
`fa assessment start\|record\|accept\|export --file <params.json> --idempotency-key <key>`	Mutate the assessment lifecycle.

`fa inventory`

Command	Behavior
`fa inventory list [--estate-id <id>] [--assessment-id <id>]`	List migration objects.
`fa inventory register --file <params.json> --idempotency-key <key>`	Register inventory.
`fa inventory graph list [--assessment-id <id>]`	List dependency graphs.
`fa inventory graph show <id>`	Show graph edges.
`fa inventory graph start\|record\|accept --file <params.json> --idempotency-key <key>`	Build and accept a dependency graph.

`fa plan`

Generate, compare, select, and freeze migration plans.

Command	Behavior
`fa plan list\|compare [--engagement-id <id>]`	List or compare plans.
`fa plan show <id>`	Show a migration plan.
`fa plan generate --file <params.json> --idempotency-key <key>`	Generate a plan.
`fa plan select\|freeze <id> --idempotency-key <key>`	Select or freeze a plan.

`fa wave`

Inspect dependency-aware migration waves.

Command	Behavior
`fa wave list [--estate-id <id>]`	List cutover waves.

`fa conversion`

Run conversion batches and govern remediation residue.

Command	Behavior
`fa conversion list [--object-id <id>]`	List conversion attempts with their hazard-scan state (clean, hazardous, or unassessed).
`fa conversion show <id>`	Show a conversion attempt; hazardous attempts block certification until their conversion_hazard residue is reviewed.
`fa conversion diff <object-id>`	Compare attempts for an object.
`fa conversion batch list [--engagement-id <id>]`	List conversion batches.
`fa conversion batch show <id>`	Show a conversion batch.
`fa conversion batch create\|start\|complete --file <params.json> --idempotency-key <key>`	Mutate a conversion batch.
`fa conversion attempt start\|record --file <params.json> --idempotency-key <key>`	Start or record a conversion attempt.
`fa conversion retry --file <params.json> --idempotency-key <key>`	Retry through the governed conversion action.

`fa residue`

Estimate, assign, and resolve human or agent remediation.

Command	Behavior
`fa residue list [--engagement-id <id>] [--object-id <id>]`	List remediation residue.
`fa residue show <id>`	Show one residue item; conversion_hazard cases name their exact origin conversion and assessment digest.
`fa residue create\|estimate\|assign\|resolve\|review\|cancel --file <params.json> --idempotency-key <key>`	Mutate the residue lifecycle. After an approved review, retry certification with a FRESH idempotency key — a denied key stays denied.

`fa transfer`

Plan, operate, and reconcile data movement.

Command	Behavior
`fa transfer list [--engagement-id <id>] [--estate-id <id>]`	List transfer plans.
`fa transfer status <id>`	Show transfer status.
`fa transfer plan\|checkpoint\|reconcile-record\|fail --file <params.json> --idempotency-key <key>`	Record transfer plans and evidence.
`fa transfer run\|resume\|reconcile <id> --idempotency-key <key>`	Operate a transfer workflow.
`fa transfer pause\|cancel <id> --reason <text> --idempotency-key <key>`	Pause or cancel a transfer.

`fa validation`

Run Experiments-backed parity validation and inspect readiness.

Command	Behavior
`fa validation list [--engagement-id <id>] [--estate-id <id>]`	List validation executions.
`fa validation status <id>`	Show validation status.
`fa validation runs\|readiness [--object-id <id>]`	Inspect admitted evidence and readiness.
`fa validation run --file <request.json> --idempotency-key <key>`	Request validation.
`fa validation cancel <id> --reason <text> --idempotency-key <key>`	Cancel validation.

`fa certificate`

Inspect, verify, mint, and invalidate migration certificates.

Command	Behavior
`fa certificate list [--object-id <id>]`	List certificates.
`fa certificate show <id>`	Show a governed certificate record.
`fa certificate inspect <file>`	Inspect a certificate envelope locally.
`fa certificate verify <file> [--keys <public-keys.json>]`	Verify digest and signature locally.
`fa certificate mint\|invalidate --file <params.json> --idempotency-key <key>`	Mutate governed certificate state.

`fa cutover`

Freeze, approve, execute, and observe governed cutover.

Command	Behavior
`fa cutover list [--estate-id <id>]`	List cutover controls.
`fa cutover status <wave-id>`	Show cutover readiness.
`fa cutover freeze\|runbook\|rehearse\|observe\|certify-effector --file <params.json> --idempotency-key <key>`	Record cutover control evidence.
`fa cutover incident-open\|incident-resolve --file <params.json> --idempotency-key <key>`	Govern a cutover incident.
`fa cutover approve <wave-id> [--note <text>] --idempotency-key <key>`	Approve through the authenticated mutation boundary.
`fa cutover start <wave-id> --window <window> --reason <text> [--wait] [--timeout <seconds>]`	Start or attach to the durable cutover workflow.
`fa cutover workflow-status\|wake <workflow-id>`	Query or wake a durable cutover workflow.

`fa hypercare`

Record post-cutover observation and decommission evidence.

Command	Behavior
`fa hypercare start\|observe\|complete\|decommission --file <params.json> --idempotency-key <key>`	Mutate the hypercare lifecycle.

`fa artifact`

Command	Behavior
`fa artifact list [--engagement-id <id>] [--object-id <id>]`	List artifacts.
`fa artifact show <id>`	Show one artifact.
`fa artifact register --file <params.json> --idempotency-key <key>`	Register an immutable artifact reference.

`fa deployment`

Declare and inspect deployment requirements; Runway executes releases.

Command	Behavior
`fa deployment list [--engagement-id <id>] [--estate-id <id>]`	List deployment requirements.
`fa deployment status <id>`	Show a deployment requirement.
`fa deployment require --file <requirement.json> --idempotency-key <key>`	Declare a required Runway outcome.
`fa deployment connect --file <reference.json> --idempotency-key <key>`	Connect an existing requirement to a Runway deployment reference.

`fa modernization`

Separate baseline migration from measurable Databricks modernization.

Command	Behavior
`fa modernization list [--engagement-id <id>] [--object-id <id>]`	List modernization items.
`fa modernization show <id>`	Show one modernization item.
`fa modernization recommend\|decide\|plan\|start\|evidence\|promote\|rework --file <params.json> --idempotency-key <key>`	Mutate modernization state.

`fa value`

Record baselines and publish measurable outcome reports.

Command	Behavior
`fa value observations\|summaries\|reports [--engagement-id <id>]`	Inspect value evidence.
`fa value record\|summarize\|publish --file <params.json> --idempotency-key <key>`	Mutate value evidence.

`fa capability`

Inspect and govern source-capability evidence.

Command	Behavior
`fa capability list [--source <source>] [--variant <variant>] [--capability <name>] [--construct <id>] [--artifact-kind <kind>]`	List capability entries.
`fa capability show <id>`	Show one capability entry.
`fa capability matrix --source <source> [--variant <variant>]`	Render the capability matrix.
`fa capability propose\|evidence\|promote\|expire\|revoke\|reconcile --file <params.json> --idempotency-key <key>`	Mutate capability evidence.

`fa source`

Inspect, plan, diagnose, and qualify supported source profiles.

Command	Behavior
`fa source inspect <source>`	Inspect one source profile.
`fa source plan <source> [--variant <variant>]`	Create a source migration plan.
`fa source recipe <source> [--variant <variant>]`	Render the complete developer command and artifact sequence for one source.
`fa source constructs <source> [--variant <variant>] [--construct <id>] [--artifact-kind <kind>]`	List repository-owned construct routing without implying provider proof.
`fa source doctor\|certify <source> [--variant <variant>] [--level <level>]`	Diagnose or certify capability evidence.
`fa source limitations <source> [--variant <variant>]`	List explicit source limitations.
`fa source certification-check <manifest.json>`	Evaluate source certification evidence.

`fa migration-pack`

Compile and qualify source-specific migration packs.

Command	Behavior
`fa migration-pack inspect\|plan --file <manifest.json>`	Inspect or compile a migration pack.
`fa migration-pack register --file <bundle.json> --engagement-id <id> --estate-id <id> --artifact-id <ref> --idempotency-key <key>`	Register a compiled pack.
`fa migration-pack certification-check --file <evidence.json>`	Evaluate pack certification evidence.

`fa migration-ir`

Import, compile, generate, and qualify ETL migration IR.

Command	Behavior
`fa migration-ir import --source <source> --file <export> --estate-name <name> --snapshot-at <iso> [--product-version <version>] [--credential-map <file>] [--output <file>]`	Import a supported source export.
`fa migration-ir inspect\|compile --file <manifest.json>`	Inspect or compile migration IR.
`fa migration-ir generate --file <manifest.json> --out-dir <directory> [--artifact-set <file>] [--engagement-id <id> --estate-id <id> --artifact-ref-prefix <ref>]`	Generate Databricks artifacts.
`fa migration-ir materialize --file <artifact-set.json> --out-dir <directory>`	Materialize generated files.
`fa migration-ir validate --file <artifact-set.json> [--root <directory>]`	Validate generated files.
`fa migration-ir qualify --file <artifact-set.json> --root <directory> [--proof <level>] [--bindings <file>] [--resolutions <file>] [--workspace-evidence <file>] [--output <file>] [--databricks-cli <path>]`	Qualify a release candidate.
`fa migration-ir register --file <bundle.json> --engagement-id <id> --estate-id <id> --artifact-id <ref> --idempotency-key <key>`	Register migration IR.

`fa lakebase`

Plan and qualify SQL Server migrations to Databricks Lakebase.

Command	Behavior
`fa lakebase inspect\|plan --file <manifest.json>`	Inspect or compile a Lakebase target plan.
`fa lakebase register --file <plan.json> --engagement-id <id> --estate-id <id> --artifact-id <ref> --idempotency-key <key>`	Register the immutable plan with an engagement.
`fa lakebase qualification-check --file <evidence.json>`	Evaluate digest-bound compatibility or managed Lakebase evidence.

`fa application-pack`

Compile enterprise application migration packs.

Command	Behavior
`fa application-pack inspect\|plan --file <manifest.json>`	Inspect or compile an application pack.
`fa application-pack register --file <bundle.json> --engagement-id <id> --estate-id <id> --artifact-id <ref> --idempotency-key <key>`	Register an application pack.

`fa application-kit`

Plan and qualify Databricks operational applications.

Command	Behavior
`fa application-kit module list`	List supported application modules.
`fa application-kit init --name <name> --module <module> [--cloud aws\|azure\|gcp]`	Create an application-kit manifest.
`fa application-kit validate --file <manifest.json>`	Validate a manifest without compiling it.
`fa application-kit inspect\|plan --file <manifest.json>`	Inspect or compile a portable plan.
`fa application-kit qualify --file <plan.json> [--evidence <evidence.json>] [--level <level>]`	Evaluate qualification evidence.
`fa application-kit list [--engagement-id <id>]`	List registered application-kit artifacts.
`fa application-kit show <artifact-id>`	Show a registered application-kit artifact.
`fa application-kit register --file <plan.json> --engagement-id <id> --estate-id <id> --artifact-id <ref> --idempotency-key <key>`	Register a plan reference.

`fa databricks-native`

Plan modernization for estates already on Databricks.

Command	Behavior
`fa databricks-native inspect\|plan --file <manifest.json>`	Inspect or compile a native modernization plan.
`fa databricks-native register --file <bundle.json> --engagement-id <id> --estate-id <id> --artifact-id <ref> --idempotency-key <key>`	Register a native plan.

`fa delivery`

Build delivery kits and validate external claims.

Command	Behavior
`fa delivery preflight\|kit --file <qualification.json>`	Evaluate or package delivery readiness.
`fa delivery connector-policy-check --file <policy.json>`	Validate a connector execution policy.
`fa delivery claim-check\|activation-check --file <evidence.json>`	Evaluate an external claim or activation evidence.
`fa delivery public-check --file <document>`	Reject internal-only language in public material.

`fa synapse`

Run the Synapse golden-path helpers.

Command	Behavior
`fa synapse inspect\|plan --file <manifest.json>`	Inspect or compile a Synapse plan.
`fa synapse compile-adf --file <arm-template.json>`	Compile an ADF export.
`fa synapse register --file <bundle.json> --engagement-id <id> --estate-id <id> --artifact-id <ref> --idempotency-key <key>`	Register a Synapse plan.
`fa synapse certification-check --file <evidence.json>`	Evaluate Synapse certification evidence.

`fa discrepancy`

Triage and resolve validation discrepancies.

Command	Behavior
`fa discrepancy list [--engagement-id <id>] [--estate-id <id>] [--object-id <id>]`	List discrepancies.
`fa discrepancy show <id>`	Show a discrepancy.
`fa discrepancy create\|triage\|accept\|resolve\|verify --file <params.json> --idempotency-key <key>`	Mutate discrepancy state.

`fa evidence`

Export content-digested migration evidence.

Command	Behavior
`fa evidence inspect <manifest.json>`	Inspect a secret-free live-evidence manifest locally.
`fa evidence admit --file <manifest.json> --engagement-id <id> --estate-id <id> --idempotency-key <key>`	Register verified immutable artifact references without manufacturing provider verdicts.
`fa evidence list [--engagement-id <id>]`	List admitted evidence artifacts.
`fa evidence show <artifact-id>`	Show one admitted evidence artifact.
`fa evidence export --file <params.json> --idempotency-key <key>`	Request an evidence export.

Utilities

Command	Behavior
`fa help [<group>]`	Show global or group help.
`fa --help	-h`
`fa actions`	List governed action contracts.
`fa profiles`	List validation profiles.
`fa sources`	List source profiles.
`fa sources export --plans`	Export one canonical plan record per source variant.
`fa doctor [--profile local	production]`
`fa commands`	Emit the machine-readable command manifest.
`fa completion bash	zsh
`fa docs [<topic>]`	Print the documentation URL.
`fa version	--version

Ownership boundary

fa deployment require/list/status governs the deployment outcome required by a migration. Fabric Runway's fr command executes deployment, promotion, rollback, and release reconciliation. Airlift may block on a verified Runway reference; it never re-owns Runway state.

Generated command index

On this page