@quonfig/cli 0.0.46 → 0.0.48

package/README.md

@@ -17,7 +17,7 @@ $ npm install -g @quonfig/cli
 $ qfg COMMAND
 running command...
 $ qfg (--version)
-@quonfig/cli/0.0.46 linux-x64 node-v24.4.1
+@quonfig/cli/0.0.48 linux-x64 node-v24.4.1
 $ qfg --help [COMMAND]
 USAGE
   $ qfg COMMAND
@@ -195,7 +195,7 @@ EXAMPLES
   $ qfg activity restore my.flag --yes
 ```
 
-_See code: [src/commands/activity.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/activity.ts)_
+_See code: [src/commands/activity.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/activity.ts)_
 
 ## `qfg activity deleted`
 
@@ -224,7 +224,7 @@ EXAMPLES
   $ qfg activity deleted --json
 ```
 
-_See code: [src/commands/activity/deleted.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/activity/deleted.ts)_
+_See code: [src/commands/activity/deleted.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/activity/deleted.ts)_
 
 ## `qfg activity feed`
 
@@ -259,7 +259,7 @@ EXAMPLES
   $ qfg activity feed --json
 ```
 
-_See code: [src/commands/activity/feed.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/activity/feed.ts)_
+_See code: [src/commands/activity/feed.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/activity/feed.ts)_
 
 ## `qfg activity history [NAME]`
 
@@ -293,7 +293,7 @@ EXAMPLES
   $ qfg activity history request.timeout --json
 ```
 
-_See code: [src/commands/activity/history.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/activity/history.ts)_
+_See code: [src/commands/activity/history.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/activity/history.ts)_
 
 ## `qfg activity restore [NAME]`
 
@@ -332,7 +332,7 @@ EXAMPLES
   $ qfg activity restore request.timeout --type config --yes
 ```
 
-_See code: [src/commands/activity/restore.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/activity/restore.ts)_
+_See code: [src/commands/activity/restore.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/activity/restore.ts)_
 
 ## `qfg audit-log [NAME]`
 
@@ -360,7 +360,7 @@ EXAMPLES
   $ qfg audit-log my.flag
 ```
 
-_See code: [src/commands/audit-log.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/audit-log.ts)_
+_See code: [src/commands/audit-log.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/audit-log.ts)_
 
 ## `qfg config-schema`
 
@@ -389,7 +389,7 @@ EXAMPLES
   $ qfg config-schema --json-schema    # full JSON Schema document (copy into your editor)
 ```
 
-_See code: [src/commands/config-schema.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/config-schema.ts)_
+_See code: [src/commands/config-schema.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/config-schema.ts)_
 
 ## `qfg create NAME`
 
@@ -474,7 +474,7 @@ EXAMPLES
   $ qfg set-rollout my.new.flag --environment production --true-percent 20
 ```
 
-_See code: [src/commands/create.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/create.ts)_
+_See code: [src/commands/create.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/create.ts)_
 
 ## `qfg delete NAME`
 
@@ -520,7 +520,7 @@ EXAMPLES
   $ qfg delete my.config --yes
 ```
 
-_See code: [src/commands/delete.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/delete.ts)_
+_See code: [src/commands/delete.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/delete.ts)_
 
 ## `qfg flag info [NAME]`
 
@@ -723,7 +723,7 @@ EXAMPLES
   $ qfg generate --targets node-ts -o ./dist # combine with targets
 ```
 
-_See code: [src/commands/generate.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/generate.ts)_
+_See code: [src/commands/generate.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/generate.ts)_
 
 ## `qfg generate-new-hex-key`
 
@@ -746,7 +746,7 @@ EXAMPLES
   $ qfg generate-new-hex-key
 ```
 
-_See code: [src/commands/generate-new-hex-key.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/generate-new-hex-key.ts)_
+_See code: [src/commands/generate-new-hex-key.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/generate-new-hex-key.ts)_
 
 ## `qfg get [NAME]`
 
@@ -778,7 +778,7 @@ EXAMPLES
   $ qfg get my.config.name --environment=production
 ```
 
-_See code: [src/commands/get.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/get.ts)_
+_See code: [src/commands/get.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/get.ts)_
 
 ## `qfg history NAME`
 
@@ -804,7 +804,7 @@ EXAMPLES
   $ qfg history my.flag
 ```
 
-_See code: [src/commands/history.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/history.ts)_
+_See code: [src/commands/history.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/history.ts)_
 
 ## `qfg info [NAME]`
 
@@ -852,7 +852,7 @@ EXAMPLES
   $ qfg info my.config.name --exclude-evaluations   # skip 24h stats
 ```
 
-_See code: [src/commands/info.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/info.ts)_
+_See code: [src/commands/info.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/info.ts)_
 
 ## `qfg init [DIRECTORY]`
 
@@ -892,7 +892,7 @@ EXAMPLES
   $ qfg init --dry-run
 ```
 
-_See code: [src/commands/init.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/init.ts)_
+_See code: [src/commands/init.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/init.ts)_
 
 ## `qfg interactive`
 
@@ -922,7 +922,7 @@ EXAMPLES
   $ qfg
 ```
 
-_See code: [src/commands/interactive.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/interactive.ts)_
+_See code: [src/commands/interactive.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/interactive.ts)_
 
 ## `qfg list`
 
@@ -962,7 +962,7 @@ EXAMPLES
   $ qfg list --feature-flags
 ```
 
-_See code: [src/commands/list.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/list.ts)_
+_See code: [src/commands/list.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/list.ts)_
 
 ## `qfg log`
 
@@ -987,7 +987,7 @@ EXAMPLES
   $ qfg log --limit 5
 ```
 
-_See code: [src/commands/log.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/log.ts)_
+_See code: [src/commands/log.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/log.ts)_
 
 ## `qfg log-level NAME`
 
@@ -1052,7 +1052,7 @@ EXAMPLES
   $ qfg log-level log-level.my-app --target=Chatty --value=INFO --environment=production
 ```
 
-_See code: [src/commands/log-level.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/log-level.ts)_
+_See code: [src/commands/log-level.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/log-level.ts)_
 
 ## `qfg login`
 
@@ -1077,7 +1077,7 @@ EXAMPLES
   $ qfg login --profile myprofile
 ```
 
-_See code: [src/commands/login.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/login.ts)_
 
 ## `qfg logout`
 
@@ -1100,7 +1100,7 @@ EXAMPLES
   $ qfg logout
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/logout.ts)_
 
 ## `qfg migrate`
 
@@ -1109,26 +1109,31 @@ Migrate flags and configs from a legacy feature-flag system into a Quonfig works
 ```
 USAGE
   $ qfg migrate --from launch|launchdarkly|flagsmith [--json] [--interactive] [--no-color] [--verbose]
-    [--api-key <value>] [--dir <value>] [--dry-run] [--full-summary] [--push] [--recent <value>] [--reset] [--since
-    <value>] [--staging] [--workspace <value>]
+    [--api-key <value>] [--dir <value>] [--dry-run] [--full-summary] [--project <value>] [--push] [--recent <value>]
+    [--reset] [--since <value>] [--source-api-key <value>] [--staging] [--workspace <value>]
 
 FLAGS
-  --api-key=<value>    API key for the legacy source (or set LAUNCH_API_KEY)
-  --dir=<value>        Target local workspace directory. Defaults to cwd if it looks like a Quonfig workspace, otherwise
-                       ./quonfig-repo.
-  --dry-run            Fetch and summarize changes without writing anything
-  --from=<option>      (required) Legacy source to migrate from
-                       <options: launch|launchdarkly|flagsmith>
-  --full-summary       Reify the full source-side audit log into per-change git commits (author = original user, date =
-                       original timestamp, message = change summary). Only valid on first-run imports — pass --reset to
-                       re-import everything from scratch with this flag.
-  --push               After migrating to a local dir, also push to the given --workspace on Quonfig cloud
-  --recent=<value>     Import only the last N changes (useful for tire-kicking)
-  --reset              Ignore the delta cursor and re-import everything from scratch
-  --since=<value>      Override the delta cursor (epoch milliseconds or ISO-8601 timestamp)
-  --staging            Hit the staging API for the source (dev-only)
-  --workspace=<value>  Quonfig cloud workspace slug to push to. Requires `qfg login` and is typically combined with
-                       --push.
+  --api-key=<value>         Deprecated alias for --source-api-key, kept for the `launch` source (or set LAUNCH_API_KEY).
+                            Prefer --source-api-key.
+  --dir=<value>             Target local workspace directory. Defaults to cwd if it looks like a Quonfig workspace,
+                            otherwise ./quonfig-repo.
+  --dry-run                 Fetch and summarize changes without writing anything
+  --from=<option>           (required) Legacy source to migrate from
+                            <options: launch|launchdarkly|flagsmith>
+  --full-summary            Reify the full source-side audit log into per-change git commits (author = original user,
+                            date = original timestamp, message = change summary). Only valid on first-run imports — pass
+                            --reset to re-import everything from scratch with this flag.
+  --project=<value>         [default: default] LaunchDarkly project key to migrate from (or set
+                            LAUNCHDARKLY_PROJECT_KEY). Scoped to `--from launchdarkly`; ignored by other sources.
+  --push                    After migrating to a local dir, also push to the given --workspace on Quonfig cloud
+  --recent=<value>          Import only the last N changes (useful for tire-kicking)
+  --reset                   Ignore the delta cursor and re-import everything from scratch
+  --since=<value>           Override the delta cursor (epoch milliseconds or ISO-8601 timestamp)
+  --source-api-key=<value>  API key for the legacy source. Set this, QUONFIG_MIGRATE_API_KEY, or the per-provider env
+                            var (LAUNCHDARKLY_API_KEY, LAUNCH_API_KEY, FLAGSMITH_API_KEY).
+  --staging                 Hit the staging API for the source (dev-only)
+  --workspace=<value>       Quonfig cloud workspace slug to push to. Requires `qfg login` and is typically combined with
+                            --push.
 
 GLOBAL FLAGS
   --[no-]interactive  Force interactive mode
@@ -1146,18 +1151,18 @@ DESCRIPTION
   and https://docs.quonfig.com/docs/migrating/troubleshooting when something goes sideways.
 
 EXAMPLES
-  $ qfg migrate --from launch --api-key $LAUNCH_API_KEY --dir ./quonfig-repo
+  $ qfg migrate --from launchdarkly --source-api-key $LAUNCHDARKLY_API_KEY --dir ./quonfig-repo
 
-  $ qfg migrate --from launch --api-key $LAUNCH_API_KEY --workspace acme-prod --push
+  $ qfg migrate --from launch --source-api-key $LAUNCH_API_KEY --workspace acme-prod --push
 
   $ qfg migrate --from launch --api-key $LAUNCH_API_KEY --dir ./quonfig-repo --reset
 
-  $ qfg migrate --from launch --api-key $LAUNCH_API_KEY --dir ./quonfig-repo --dry-run
+  $ qfg migrate --from launch --source-api-key $LAUNCH_API_KEY --dir ./quonfig-repo --dry-run
 
-  $ qfg migrate --from launch --api-key $LAUNCH_API_KEY --dir ./quonfig-repo --staging
+  $ qfg migrate --from launch --source-api-key $LAUNCH_API_KEY --dir ./quonfig-repo --staging
 ```
 
-_See code: [src/commands/migrate.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/migrate.ts)_
+_See code: [src/commands/migrate.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/migrate.ts)_
 
 ## `qfg migrate doctor`
 
@@ -1195,7 +1200,7 @@ EXAMPLES
   $ qfg migrate doctor --json
 ```
 
-_See code: [src/commands/migrate/doctor.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/migrate/doctor.ts)_
+_See code: [src/commands/migrate/doctor.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/migrate/doctor.ts)_
 
 ## `qfg migrate my-code`
 
@@ -1227,7 +1232,7 @@ EXAMPLES
   $ qfg migrate my-code --dry-run
 ```
 
-_See code: [src/commands/migrate/my-code.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/migrate/my-code.ts)_
+_See code: [src/commands/migrate/my-code.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/migrate/my-code.ts)_
 
 ## `qfg migrate status`
 
@@ -1258,7 +1263,7 @@ EXAMPLES
   $ qfg migrate status --json
 ```
 
-_See code: [src/commands/migrate/status.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/migrate/status.ts)_
+_See code: [src/commands/migrate/status.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/migrate/status.ts)_
 
 ## `qfg override [NAME] [VALUE]`
 
@@ -1313,7 +1318,7 @@ EXAMPLES
   $ qfg override my.flag true --env=staging
 ```
 
-_See code: [src/commands/override.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/override.ts)_
+_See code: [src/commands/override.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/override.ts)_
 
 ## `qfg pull`
 
@@ -1361,7 +1366,7 @@ EXAMPLES
   $ qfg pull  # uses QUONFIG_DIR env var
 ```
 
-_See code: [src/commands/pull.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/pull.ts)_
+_See code: [src/commands/pull.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/pull.ts)_
 
 ## `qfg push`
 
@@ -1410,7 +1415,7 @@ EXAMPLES
   $ qfg push --dir ./our-config --yes
 ```
 
-_See code: [src/commands/push.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/push.ts)_
+_See code: [src/commands/push.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/push.ts)_
 
 ## `qfg run [COMMAND]`
 
@@ -1461,7 +1466,7 @@ EXAMPLES
   $ qfg run --env DATABASE_URL=db.url --preserve-env --environment=staging -- npm test
 ```
 
-_See code: [src/commands/run.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/run.ts)_
+_See code: [src/commands/run.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/run.ts)_
 
 ## `qfg schema NAME`
 
@@ -1499,7 +1504,7 @@ EXAMPLES
   $ qfg schema my-schema --set-json-schema=@schemas/my-schema.json --protected
 ```
 
-_See code: [src/commands/schema.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/schema.ts)_
+_See code: [src/commands/schema.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/schema.ts)_
 
 ## `qfg sdk-key`
 
@@ -1526,7 +1531,7 @@ EXAMPLES
   $ qfg sdk-key revoke <key-id>
 ```
 
-_See code: [src/commands/sdk-key.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/sdk-key.ts)_
+_See code: [src/commands/sdk-key.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/sdk-key.ts)_
 
 ## `qfg sdk-key create`
 
@@ -1558,7 +1563,7 @@ EXAMPLES
   $ qfg sdk-key create --environment staging --type browser
 ```
 
-_See code: [src/commands/sdk-key/create.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/sdk-key/create.ts)_
+_See code: [src/commands/sdk-key/create.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/sdk-key/create.ts)_
 
 ## `qfg sdk-key list`
 
@@ -1587,7 +1592,7 @@ EXAMPLES
   $ qfg sdk-key list --environment production
 ```
 
-_See code: [src/commands/sdk-key/list.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/sdk-key/list.ts)_
+_See code: [src/commands/sdk-key/list.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/sdk-key/list.ts)_
 
 ## `qfg sdk-key revoke KEYID`
 
@@ -1614,7 +1619,7 @@ EXAMPLES
   $ qfg sdk-key revoke a1b2c3d4-e5f6-7890-abcd-ef1234567890
 ```
 
-_See code: [src/commands/sdk-key/revoke.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/sdk-key/revoke.ts)_
+_See code: [src/commands/sdk-key/revoke.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/sdk-key/revoke.ts)_
 
 ## `qfg set-default [NAME]`
 
@@ -1685,7 +1690,7 @@ EXAMPLES
   $ qfg pull && qfg config-schema
 ```
 
-_See code: [src/commands/set-default.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/set-default.ts)_
+_See code: [src/commands/set-default.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/set-default.ts)_
 
 ## `qfg set-rollout [NAME]`
 
@@ -1762,7 +1767,7 @@ EXAMPLES
   $ qfg set-rollout my.variant.flag --environment production --weights "a:33,b:33,c:34" --hash-by user.id
 ```
 
-_See code: [src/commands/set-rollout.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/set-rollout.ts)_
+_See code: [src/commands/set-rollout.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/set-rollout.ts)_
 
 ## `qfg sync`
 
@@ -1794,7 +1799,7 @@ EXAMPLES
   $ qfg sync --watch --dir ./our-config --interval 30
 ```
 
-_See code: [src/commands/sync.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/sync.ts)_
+_See code: [src/commands/sync.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/sync.ts)_
 
 ## `qfg toggle [NAME]`
 
@@ -1896,7 +1901,7 @@ EXAMPLES
   $ qfg verify --json
 ```
 
-_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/verify.ts)_
+_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/verify.ts)_
 
 ## `qfg whoami`
 
@@ -1919,7 +1924,7 @@ EXAMPLES
   $ qfg whoami
 ```
 
-_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/whoami.ts)_
+_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/whoami.ts)_
 
 ## `qfg workspace`
 
@@ -1942,7 +1947,7 @@ EXAMPLES
   $ qfg workspace
 ```
 
-_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/workspace.ts)_
+_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/workspace.ts)_
 
 ## `qfg workspace bootstrap`
 
@@ -1975,7 +1980,7 @@ EXAMPLES
   $ qfg workspace bootstrap --dir ./our-config --skip-validate
 ```
 
-_See code: [src/commands/workspace/bootstrap.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/workspace/bootstrap.ts)_
+_See code: [src/commands/workspace/bootstrap.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/workspace/bootstrap.ts)_
 
 ## `qfg workspace create SLUG`
 
@@ -2009,7 +2014,7 @@ EXAMPLES
   $ qfg workspace create my-team --org 11111111-1111-1111-1111-111111111111
 ```
 
-_See code: [src/commands/workspace/create.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/workspace/create.ts)_
+_See code: [src/commands/workspace/create.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/workspace/create.ts)_
 
 ## `qfg workspace switch [SLUG]`
 
@@ -2037,7 +2042,7 @@ EXAMPLES
   $ qfg workspace switch acme/production
 ```
 
-_See code: [src/commands/workspace/switch.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/workspace/switch.ts)_
+_See code: [src/commands/workspace/switch.ts](https://github.com/quonfig/cli/blob/v0.0.48/src/commands/workspace/switch.ts)_
 <!-- commandsstop -->
 
 ## Local Development

package/dist/commands/migrate.d.ts

@@ -9,10 +9,12 @@ export default class Migrate extends BaseCommand {
         'dry-run': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
         from: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
         'full-summary': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        project: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
         push: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
         recent: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
         reset: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
         since: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        'source-api-key': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
         staging: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
         workspace: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
     };

package/dist/commands/migrate.js

@@ -9,7 +9,10 @@ import { PushConflictError, PushHookRejectedError } from '../util/clone-and-stac
 import { MigratorVerifyError, pushMigrationToCloud } from '../migrate/push-to-cloud.js';
 import { UnknownSourceError, getSource } from '../migrate/registry.js';
 import { NotYetImplementedError, } from '../migrate/source.js';
+import { missingSourceApiKeyMessage, resolveSourceApiKey } from '../migrate/source-api-key.js';
 import { applyLaunchBaseUrl } from '../migrate/sources/launch/api.js';
+import { applyLaunchDarklyBaseUrl } from '../migrate/sources/launchdarkly/api.js';
+import { getLaunchDarklyRetentionHorizon, setLaunchDarklyFullSummary, setLaunchDarklyProjectKey, } from '../migrate/sources/launchdarkly.js';
 import { mintGiteaToken } from '../util/gitea-api.js';
 import { displayUrl } from '../util/git-ops.js';
 import { resolveWorkspaceUuid } from '../util/resolve-workspace.js';
@@ -22,15 +25,15 @@ export default class Migrate extends BaseCommand {
         'See https://docs.quonfig.com/docs/migrating/from-launch for the step-by-step guide,\n' +
         'and https://docs.quonfig.com/docs/migrating/troubleshooting when something goes sideways.';
     static examples = [
-        '<%= config.bin %> <%= command.id %> --from launch --api-key $LAUNCH_API_KEY --dir ./quonfig-repo',
-        '<%= config.bin %> <%= command.id %> --from launch --api-key $LAUNCH_API_KEY --workspace acme-prod --push',
+        '<%= config.bin %> <%= command.id %> --from launchdarkly --source-api-key $LAUNCHDARKLY_API_KEY --dir ./quonfig-repo',
+        '<%= config.bin %> <%= command.id %> --from launch --source-api-key $LAUNCH_API_KEY --workspace acme-prod --push',
         '<%= config.bin %> <%= command.id %> --from launch --api-key $LAUNCH_API_KEY --dir ./quonfig-repo --reset',
-        '<%= config.bin %> <%= command.id %> --from launch --api-key $LAUNCH_API_KEY --dir ./quonfig-repo --dry-run',
-        '<%= config.bin %> <%= command.id %> --from launch --api-key $LAUNCH_API_KEY --dir ./quonfig-repo --staging',
+        '<%= config.bin %> <%= command.id %> --from launch --source-api-key $LAUNCH_API_KEY --dir ./quonfig-repo --dry-run',
+        '<%= config.bin %> <%= command.id %> --from launch --source-api-key $LAUNCH_API_KEY --dir ./quonfig-repo --staging',
     ];
     static flags = {
         'api-key': Flags.string({
-            description: 'API key for the legacy source (or set LAUNCH_API_KEY)',
+            description: 'Deprecated alias for --source-api-key, kept for the `launch` source (or set LAUNCH_API_KEY). Prefer --source-api-key.',
             env: 'LAUNCH_API_KEY',
         }),
         dir: Flags.string({
@@ -51,6 +54,12 @@ export default class Migrate extends BaseCommand {
                 '(author = original user, date = original timestamp, message = change summary). ' +
                 'Only valid on first-run imports — pass --reset to re-import everything from scratch with this flag.',
         }),
+        project: Flags.string({
+            default: 'default',
+            description: 'LaunchDarkly project key to migrate from (or set LAUNCHDARKLY_PROJECT_KEY). ' +
+                'Scoped to `--from launchdarkly`; ignored by other sources.',
+            env: 'LAUNCHDARKLY_PROJECT_KEY',
+        }),
         push: Flags.boolean({
             default: false,
             description: 'After migrating to a local dir, also push to the given --workspace on Quonfig cloud',
@@ -65,6 +74,11 @@ export default class Migrate extends BaseCommand {
         since: Flags.string({
             description: 'Override the delta cursor (epoch milliseconds or ISO-8601 timestamp)',
         }),
+        'source-api-key': Flags.string({
+            description: 'API key for the legacy source. Set this, QUONFIG_MIGRATE_API_KEY, or the ' +
+                'per-provider env var (LAUNCHDARKLY_API_KEY, LAUNCH_API_KEY, FLAGSMITH_API_KEY).',
+            env: 'QUONFIG_MIGRATE_API_KEY',
+        }),
         staging: Flags.boolean({
             default: false,
             description: 'Hit the staging API for the source (dev-only)',
@@ -79,8 +93,19 @@ export default class Migrate extends BaseCommand {
             return this.err('`--dir` and `--workspace` are mutually exclusive unless `--push` is also passed. ' +
                 'Pass `--push` to migrate locally and then push to the cloud workspace, or drop one of the flags.');
         }
-        if (!flags['api-key']) {
-            return this.err('--api-key is required. For --from launch you can also set LAUNCH_API_KEY in your environment.');
+        const sourceApiKey = resolveSourceApiKey({
+            apiKeyFlag: flags['api-key'],
+            from: flags.from,
+            sourceApiKeyFlag: flags['source-api-key'],
+        });
+        if (!sourceApiKey) {
+            return this.err(missingSourceApiKeyMessage(flags.from));
+        }
+        // --api-key is the deprecated launch-only alias (D8). Nudge non-launch users
+        // toward the generalized flag, but don't fail — the key still resolved.
+        if (flags['api-key'] && !flags['source-api-key'] && flags.from !== 'launch') {
+            this.warn(`--api-key is a deprecated alias scoped to the \`launch\` source. For --from ${flags.from}, ` +
+                'use --source-api-key (or the QUONFIG_MIGRATE_API_KEY env var) instead.');
         }
         if (flags['full-summary'] && flags.recent !== undefined) {
             return this.err('--full-summary and --recent are incompatible: --full-summary reifies the entire audit log into git history, ' +
@@ -117,6 +142,16 @@ export default class Migrate extends BaseCommand {
         if (flags.from === 'launch') {
             applyLaunchBaseUrl(flags.staging);
         }
+        if (flags.from === 'launchdarkly') {
+            // Thread run-scoped source config in before the first API call. The base
+            // URL honours the LAUNCHDARKLY_API_URL escape hatch; --project (env-backed
+            // by LAUNCHDARKLY_PROJECT_KEY) selects which LD project to snapshot;
+            // --full-summary swaps the snapshot for the Phase-2 audit-log walk (the
+            // walk's own resume cursor lives in os.tmpdir, not in `dir`).
+            applyLaunchDarklyBaseUrl();
+            setLaunchDarklyProjectKey(flags.project);
+            setLaunchDarklyFullSummary(flags['full-summary']);
+        }
         let source;
         try {
             source = getSource(flags.from);
@@ -128,8 +163,17 @@ export default class Migrate extends BaseCommand {
         }
         let duplicateResolutionsForWarn = null;
         try {
-            await source.validateAuth(flags['api-key']);
+            await source.validateAuth(sourceApiKey);
             const environments = await source.listEnvironments();
+            // Plan §4.1.1: tell the user the real history horizon BEFORE the slow
+            // Phase-2 walk starts. validateAuth populated this for LD under
+            // --full-summary; the message also names the Developer-plan ≤ 30 days
+            // ceiling explicitly when that's what we observed.
+            if (flags.from === 'launchdarkly' && flags['full-summary']) {
+                const horizon = getLaunchDarklyRetentionHorizon();
+                if (horizon)
+                    this.log(`History pre-flight: ${horizon.label}`);
+            }
             const existing = readImportState(dir);
             const sinceEpochMs = computeSince(flags, existing);
             const changes = [];
@@ -251,6 +295,7 @@ export default class Migrate extends BaseCommand {
             warnAboutSkippedConfigs(this, source.getSkippedConfigs?.() ?? null);
             warnAboutCoercedSentinels(this, source.getCoercedSentinels?.() ?? null);
             warnAboutDuplicateResolutions(this, duplicateResolutionsForWarn);
+            warnAboutConversionNotes(this, source.getConversionNotes?.() ?? null);
         }
     }
     async resolvePushWorkspace(slugOrId) {
@@ -339,6 +384,21 @@ function warnAboutCoercedSentinels(cmd, coerced) {
     }
     cmd.warn(`If you want a real default for these rules, set one in the source system and re-run the migration. Full detail is also written to MIGRATION_REPORT.md.`);
 }
+function warnAboutConversionNotes(cmd, notes) {
+    if (!notes || notes.length === 0)
+        return;
+    const rebucketed = notes.filter((n) => n.category === 'rebucketed-rollout');
+    if (rebucketed.length > 0) {
+        cmd.warn(`${rebucketed.length} flag(s)/segment(s) use a percentage rollout — LaunchDarkly and Quonfig bucket users ` +
+            `differently, so individual user assignments WILL change after migration (the rollout percentage is preserved). ` +
+            `See the "Users will be re-bucketed" section of MIGRATION_REPORT.md.`);
+    }
+    const other = notes.filter((n) => n.category !== 'rebucketed-rollout' && n.category !== 'skipped-config');
+    if (other.length > 0) {
+        cmd.warn(`${other.length} source concept(s) could not be converted exactly (dropped prerequisites, lossy individual ` +
+            `targets, etc.). Nothing was silently dropped — see the "Conversion notes" section of MIGRATION_REPORT.md.`);
+    }
+}
 function warnAboutSkippedConfigs(cmd, skipped) {
     if (!skipped || skipped.total === 0)
         return;

package/dist/migrate/local-write.js

@@ -187,6 +187,7 @@ export const applyLocalMigration = async (opts) => {
     const droppedOverrides = opts.source.getDroppedOverrides?.() ?? null;
     const skippedConfigs = opts.source.getSkippedConfigs?.() ?? null;
     const coercedSentinels = opts.source.getCoercedSentinels?.() ?? null;
+    const conversionNotes = opts.source.getConversionNotes?.() ?? null;
     const duplicateResolutions = resolutionEntries.length > 0 ? { entries: resolutionEntries, total: resolutionEntries.length } : null;
     const skippedTotal = (skippedConfigs?.total ?? 0) + resolutionEntries.reduce((sum, r) => sum + r.deleted.length, 0);
     const counts = buildMigrationCounts(livePaths, opts.environments.length, skippedTotal);
@@ -194,6 +195,7 @@ export const applyLocalMigration = async (opts) => {
         ...opts.reportData,
         counts,
         ...(coercedSentinels ? { coercedSentinels } : {}),
+        ...(conversionNotes && conversionNotes.length > 0 ? { conversionNotes } : {}),
         ...(droppedOverrides ? { droppedOverrides } : {}),
         ...(duplicateResolutions ? { duplicateResolutions } : {}),
         ...(skippedConfigs ? { skippedConfigs } : {}),
@@ -317,6 +319,7 @@ export const buildAuditFinalCommit = (opts) => ({
         const droppedOverrides = opts.source.getDroppedOverrides?.() ?? null;
         const skippedConfigs = opts.source.getSkippedConfigs?.() ?? null;
         const coercedSentinels = opts.source.getCoercedSentinels?.() ?? null;
+        const conversionNotes = opts.source.getConversionNotes?.() ?? null;
         const duplicateResolutions = resolutionEntries.length > 0 ? { entries: resolutionEntries, total: resolutionEntries.length } : null;
         removeQfFromGitignore(dir);
         writeImportState(dir, opts.importState);
@@ -326,6 +329,7 @@ export const buildAuditFinalCommit = (opts) => ({
             ...opts.reportData,
             counts,
             ...(coercedSentinels ? { coercedSentinels } : {}),
+            ...(conversionNotes && conversionNotes.length > 0 ? { conversionNotes } : {}),
             ...(droppedOverrides ? { droppedOverrides } : {}),
             ...(duplicateResolutions ? { duplicateResolutions } : {}),
             ...(skippedConfigs ? { skippedConfigs } : {}),