@quonfig/cli 0.0.44 → 0.0.46

package/README.md

@@ -17,7 +17,7 @@ $ npm install -g @quonfig/cli
 $ qfg COMMAND
 running command...
 $ qfg (--version)
-@quonfig/cli/0.0.44 linux-x64 node-v24.4.1
+@quonfig/cli/0.0.46 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.44/src/commands/activity.ts)_
+_See code: [src/commands/activity.ts](https://github.com/quonfig/cli/blob/v0.0.46/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.44/src/commands/activity/deleted.ts)_
+_See code: [src/commands/activity/deleted.ts](https://github.com/quonfig/cli/blob/v0.0.46/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.44/src/commands/activity/feed.ts)_
+_See code: [src/commands/activity/feed.ts](https://github.com/quonfig/cli/blob/v0.0.46/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.44/src/commands/activity/history.ts)_
+_See code: [src/commands/activity/history.ts](https://github.com/quonfig/cli/blob/v0.0.46/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.44/src/commands/activity/restore.ts)_
+_See code: [src/commands/activity/restore.ts](https://github.com/quonfig/cli/blob/v0.0.46/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.44/src/commands/audit-log.ts)_
+_See code: [src/commands/audit-log.ts](https://github.com/quonfig/cli/blob/v0.0.46/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.44/src/commands/config-schema.ts)_
+_See code: [src/commands/config-schema.ts](https://github.com/quonfig/cli/blob/v0.0.46/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.44/src/commands/create.ts)_
+_See code: [src/commands/create.ts](https://github.com/quonfig/cli/blob/v0.0.46/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.44/src/commands/delete.ts)_
+_See code: [src/commands/delete.ts](https://github.com/quonfig/cli/blob/v0.0.46/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.44/src/commands/generate.ts)_
+_See code: [src/commands/generate.ts](https://github.com/quonfig/cli/blob/v0.0.46/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.44/src/commands/generate-new-hex-key.ts)_
+_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)_
 
 ## `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.44/src/commands/get.ts)_
+_See code: [src/commands/get.ts](https://github.com/quonfig/cli/blob/v0.0.46/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.44/src/commands/history.ts)_
+_See code: [src/commands/history.ts](https://github.com/quonfig/cli/blob/v0.0.46/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.44/src/commands/info.ts)_
+_See code: [src/commands/info.ts](https://github.com/quonfig/cli/blob/v0.0.46/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.44/src/commands/init.ts)_
+_See code: [src/commands/init.ts](https://github.com/quonfig/cli/blob/v0.0.46/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.44/src/commands/interactive.ts)_
+_See code: [src/commands/interactive.ts](https://github.com/quonfig/cli/blob/v0.0.46/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.44/src/commands/list.ts)_
+_See code: [src/commands/list.ts](https://github.com/quonfig/cli/blob/v0.0.46/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.44/src/commands/log.ts)_
+_See code: [src/commands/log.ts](https://github.com/quonfig/cli/blob/v0.0.46/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.44/src/commands/log-level.ts)_
+_See code: [src/commands/log-level.ts](https://github.com/quonfig/cli/blob/v0.0.46/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.44/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/quonfig/cli/blob/v0.0.46/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.44/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/logout.ts)_
 
 ## `qfg migrate`
 
@@ -1109,8 +1109,8 @@ 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] [--push] [--recent <value>] [--reset] [--since <value>] [--staging]
-    [--workspace <value>]
+    [--api-key <value>] [--dir <value>] [--dry-run] [--full-summary] [--push] [--recent <value>] [--reset] [--since
+    <value>] [--staging] [--workspace <value>]
 
 FLAGS
   --api-key=<value>    API key for the legacy source (or set LAUNCH_API_KEY)
@@ -1119,6 +1119,9 @@ FLAGS
   --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
@@ -1154,7 +1157,7 @@ EXAMPLES
   $ qfg migrate --from launch --api-key $LAUNCH_API_KEY --dir ./quonfig-repo --staging
 ```
 
-_See code: [src/commands/migrate.ts](https://github.com/quonfig/cli/blob/v0.0.44/src/commands/migrate.ts)_
+_See code: [src/commands/migrate.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/migrate.ts)_
 
 ## `qfg migrate doctor`
 
@@ -1192,7 +1195,7 @@ EXAMPLES
   $ qfg migrate doctor --json
 ```
 
-_See code: [src/commands/migrate/doctor.ts](https://github.com/quonfig/cli/blob/v0.0.44/src/commands/migrate/doctor.ts)_
+_See code: [src/commands/migrate/doctor.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/migrate/doctor.ts)_
 
 ## `qfg migrate my-code`
 
@@ -1224,7 +1227,7 @@ EXAMPLES
   $ qfg migrate my-code --dry-run
 ```
 
-_See code: [src/commands/migrate/my-code.ts](https://github.com/quonfig/cli/blob/v0.0.44/src/commands/migrate/my-code.ts)_
+_See code: [src/commands/migrate/my-code.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/migrate/my-code.ts)_
 
 ## `qfg migrate status`
 
@@ -1255,7 +1258,7 @@ EXAMPLES
   $ qfg migrate status --json
 ```
 
-_See code: [src/commands/migrate/status.ts](https://github.com/quonfig/cli/blob/v0.0.44/src/commands/migrate/status.ts)_
+_See code: [src/commands/migrate/status.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/migrate/status.ts)_
 
 ## `qfg override [NAME] [VALUE]`
 
@@ -1310,7 +1313,7 @@ EXAMPLES
   $ qfg override my.flag true --env=staging
 ```
 
-_See code: [src/commands/override.ts](https://github.com/quonfig/cli/blob/v0.0.44/src/commands/override.ts)_
+_See code: [src/commands/override.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/override.ts)_
 
 ## `qfg pull`
 
@@ -1322,7 +1325,8 @@ USAGE
     <value>]
 
 FLAGS
-  --dir=<value>        Local directory to clone/update (defaults to QUONFIG_DIR env var)
+  --dir=<value>        Local directory to clone/update (defaults to cwd / nearest ancestor with quonfig.json /
+                       QUONFIG_DIR env var)
   --rebase             Replay local commits on top of origin/main when the two have diverged. Conflicts are surfaced via
                        standard git markers; resolve with `git rebase --continue`.
   --workspace=<value>  Workspace ID (defaults to active profile)
@@ -1357,7 +1361,7 @@ EXAMPLES
   $ qfg pull  # uses QUONFIG_DIR env var
 ```
 
-_See code: [src/commands/pull.ts](https://github.com/quonfig/cli/blob/v0.0.44/src/commands/pull.ts)_
+_See code: [src/commands/pull.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/pull.ts)_
 
 ## `qfg push`
 
@@ -1370,7 +1374,8 @@ USAGE
 
 FLAGS
   -m, --message=<value>    Commit message for bare-path pushes (ignored on clone-path; push what is already committed)
-      --dir=<value>        Local directory to push (defaults to QUONFIG_DIR env var)
+      --dir=<value>        Local directory to push (defaults to cwd / nearest ancestor with quonfig.json / QUONFIG_DIR
+                           env var)
       --no-pin-write       Do not offer to write workspace slug into quonfig.json on success
       --skip-validate      Skip `qfg validate` preflight
       --workspace=<value>  Workspace slug or UUID (defaults to active profile)
@@ -1391,7 +1396,7 @@ DESCRIPTION
   3. A diff summary is shown; destructive changes (10+ deletes, >=25% of
   files, or an unpinned dir) require typing the workspace slug to confirm.
 
-  qfg push                                 # uses QUONFIG_DIR + profile workspace
+  qfg push                                 # resolves dir from cwd, QUONFIG_DIR, or --dir
   qfg push --dir ./our-config
   qfg push --dir ./our-config --workspace acme-prod
   qfg push --dir ./our-config --yes        # skip normal Y/N (never skips typed-slug)
@@ -1405,7 +1410,7 @@ EXAMPLES
   $ qfg push --dir ./our-config --yes
 ```
 
-_See code: [src/commands/push.ts](https://github.com/quonfig/cli/blob/v0.0.44/src/commands/push.ts)_
+_See code: [src/commands/push.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/push.ts)_
 
 ## `qfg run [COMMAND]`
 
@@ -1456,7 +1461,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.44/src/commands/run.ts)_
+_See code: [src/commands/run.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/run.ts)_
 
 ## `qfg schema NAME`
 
@@ -1494,7 +1499,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.44/src/commands/schema.ts)_
+_See code: [src/commands/schema.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/schema.ts)_
 
 ## `qfg sdk-key`
 
@@ -1521,7 +1526,7 @@ EXAMPLES
   $ qfg sdk-key revoke <key-id>
 ```
 
-_See code: [src/commands/sdk-key.ts](https://github.com/quonfig/cli/blob/v0.0.44/src/commands/sdk-key.ts)_
+_See code: [src/commands/sdk-key.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/sdk-key.ts)_
 
 ## `qfg sdk-key create`
 
@@ -1553,7 +1558,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.44/src/commands/sdk-key/create.ts)_
+_See code: [src/commands/sdk-key/create.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/sdk-key/create.ts)_
 
 ## `qfg sdk-key list`
 
@@ -1582,7 +1587,7 @@ EXAMPLES
   $ qfg sdk-key list --environment production
 ```
 
-_See code: [src/commands/sdk-key/list.ts](https://github.com/quonfig/cli/blob/v0.0.44/src/commands/sdk-key/list.ts)_
+_See code: [src/commands/sdk-key/list.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/sdk-key/list.ts)_
 
 ## `qfg sdk-key revoke KEYID`
 
@@ -1609,7 +1614,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.44/src/commands/sdk-key/revoke.ts)_
+_See code: [src/commands/sdk-key/revoke.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/sdk-key/revoke.ts)_
 
 ## `qfg set-default [NAME]`
 
@@ -1680,7 +1685,7 @@ EXAMPLES
   $ qfg pull && qfg config-schema
 ```
 
-_See code: [src/commands/set-default.ts](https://github.com/quonfig/cli/blob/v0.0.44/src/commands/set-default.ts)_
+_See code: [src/commands/set-default.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/set-default.ts)_
 
 ## `qfg set-rollout [NAME]`
 
@@ -1757,7 +1762,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.44/src/commands/set-rollout.ts)_
+_See code: [src/commands/set-rollout.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/set-rollout.ts)_
 
 ## `qfg sync`
 
@@ -1789,7 +1794,7 @@ EXAMPLES
   $ qfg sync --watch --dir ./our-config --interval 30
 ```
 
-_See code: [src/commands/sync.ts](https://github.com/quonfig/cli/blob/v0.0.44/src/commands/sync.ts)_
+_See code: [src/commands/sync.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/sync.ts)_
 
 ## `qfg toggle [NAME]`
 
@@ -1891,7 +1896,7 @@ EXAMPLES
   $ qfg verify --json
 ```
 
-_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.0.44/src/commands/verify.ts)_
+_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/verify.ts)_
 
 ## `qfg whoami`
 
@@ -1914,7 +1919,7 @@ EXAMPLES
   $ qfg whoami
 ```
 
-_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.0.44/src/commands/whoami.ts)_
+_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/whoami.ts)_
 
 ## `qfg workspace`
 
@@ -1937,7 +1942,7 @@ EXAMPLES
   $ qfg workspace
 ```
 
-_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.0.44/src/commands/workspace.ts)_
+_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/workspace.ts)_
 
 ## `qfg workspace bootstrap`
 
@@ -1970,7 +1975,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.44/src/commands/workspace/bootstrap.ts)_
+_See code: [src/commands/workspace/bootstrap.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/workspace/bootstrap.ts)_
 
 ## `qfg workspace create SLUG`
 
@@ -2004,7 +2009,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.44/src/commands/workspace/create.ts)_
+_See code: [src/commands/workspace/create.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/workspace/create.ts)_
 
 ## `qfg workspace switch [SLUG]`
 
@@ -2032,7 +2037,7 @@ EXAMPLES
   $ qfg workspace switch acme/production
 ```
 
-_See code: [src/commands/workspace/switch.ts](https://github.com/quonfig/cli/blob/v0.0.44/src/commands/workspace/switch.ts)_
+_See code: [src/commands/workspace/switch.ts](https://github.com/quonfig/cli/blob/v0.0.46/src/commands/workspace/switch.ts)_
 <!-- commandsstop -->
 
 ## Local Development

package/dist/commands/migrate.d.ts

@@ -8,6 +8,7 @@ export default class Migrate extends BaseCommand {
         dir: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
         '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>;
         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>;

package/dist/commands/migrate.js

@@ -45,6 +45,12 @@ export default class Migrate extends BaseCommand {
             options: ['launch', 'launchdarkly', 'flagsmith'],
             required: true,
         }),
+        'full-summary': Flags.boolean({
+            default: false,
+            description: '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: Flags.boolean({
             default: false,
             description: 'After migrating to a local dir, also push to the given --workspace on Quonfig cloud',
@@ -76,6 +82,10 @@ export default class Migrate extends BaseCommand {
         if (!flags['api-key']) {
             return this.err('--api-key is required. For --from launch you can also set LAUNCH_API_KEY in your environment.');
         }
+        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, ' +
+                'so trimming changes with --recent would produce a misleading partial log. Drop one of the flags.');
+        }
         let workspaceContext = null;
         if (flags.push) {
             const resolved = await this.resolvePushWorkspace(flags.workspace);
@@ -94,6 +104,16 @@ export default class Migrate extends BaseCommand {
                 throw error;
             }
         }
+        // qfg-wbkj: --full-summary is a one-shot first-run import. Re-running it on
+        // top of an incremental migration would produce a mixed history (one
+        // collapsed commit on the bottom, per-change commits on top) which is
+        // worse than either pure mode. Force the customer to either drop the flag
+        // or explicitly --reset.
+        if (flags['full-summary'] && !flags.reset && readImportState(dir) !== null) {
+            return this.err('--full-summary is only valid on first-run imports, but this directory has already been migrated incrementally ' +
+                '(.qf/import-state.json exists). Either drop --full-summary to continue the incremental import, ' +
+                'or re-import everything from scratch by passing --reset alongside --full-summary into a fresh directory.');
+        }
         if (flags.from === 'launch') {
             applyLaunchBaseUrl(flags.staging);
         }
@@ -146,11 +166,14 @@ export default class Migrate extends BaseCommand {
                 const importState = { source: flags.from };
                 if (latestChangedAt !== undefined)
                     importState.lastProcessedAt = latestChangedAt;
-                this.log(`Pushing ${toProcess.length} change(s) to workspace ${workspaceId} (clone-and-stack)...`);
+                this.log(flags['full-summary']
+                    ? `Pushing ${toProcess.length} change(s) to workspace ${workspaceId} as per-change audit-log commits...`
+                    : `Pushing ${toProcess.length} change(s) to workspace ${workspaceId} (clone-and-stack)...`);
                 try {
                     const result = await pushMigrationToCloud({
                         changes: toProcess,
                         environments,
+                        fullHistory: flags['full-summary'],
                         importState,
                         localDir: dir,
                         remoteUrl: repoUrl,
@@ -197,6 +220,7 @@ export default class Migrate extends BaseCommand {
             const localResult = await applyLocalMigration({
                 changes: toProcess,
                 environments,
+                fullHistory: flags['full-summary'],
                 importState: localImportState,
                 localDir: dir,
                 reportData: buildReportData(flags.from),

package/dist/commands/pull.js

@@ -1,12 +1,13 @@
-import * as path from 'node:path';
 import * as fs from 'node:fs';
 import { Flags } from '@oclif/core';
 import { BaseCommand } from '../index.js';
 import { loadGiteaToken, isGiteaTokenExpired, saveGiteaToken } from '../util/gitea-token-storage.js';
 import { mintAndStoreGiteaReadToken, mintGiteaToken } from '../util/gitea-api.js';
 import { readWorkspaceSlug, tryParseWorkspacePin, writeWorkspaceSlug } from '../util/quonfig-json.js';
+import { resolveWorkspaceDir } from '../util/resolve-workspace-dir.js';
 import { resolveWorkspaceUuid } from '../util/resolve-workspace.js';
-import { isGitRepo, getRemoteUrl, gitFetch, gitSetRemote, canFastForward, hasDivergedFromRemote, gitMergeFfOnly, gitPullRebase, gitClone, displayUrl, addAndCommitFile, dirtyTrackedFiles, } from '../util/git-ops.js';
+import { isGitRepo, getAllRemoteUrls, getRemoteUrl, gitFetch, gitSetRemote, canFastForward, hasDivergedFromRemote, gitMergeFfOnly, gitPullRebase, gitClone, displayUrl, addAndCommitFile, dirtyTrackedFiles, } from '../util/git-ops.js';
+import { findQuonfigRemote } from '../push/identity-check.js';
 export default class Pull extends BaseCommand {
     static description = `Clone or update a local copy of your workspace config files.
 
@@ -27,7 +28,7 @@ CLI shortcuts (no JSON editing needed for simple cases):
     static examples = ['<%= config.bin %> pull --dir ./our-config', '<%= config.bin %> pull  # uses QUONFIG_DIR env var'];
     static flags = {
         dir: Flags.string({
-            description: 'Local directory to clone/update (defaults to QUONFIG_DIR env var)',
+            description: 'Local directory to clone/update (defaults to cwd / nearest ancestor with quonfig.json / QUONFIG_DIR env var)',
         }),
         rebase: Flags.boolean({
             default: false,
@@ -39,12 +40,18 @@ CLI shortcuts (no JSON editing needed for simple cases):
     };
     async run() {
         const { flags } = await this.parse(Pull);
-        // Resolve target directory
-        const dir = flags.dir || process.env.QUONFIG_DIR;
-        if (!dir) {
-            return this.err('No directory specified. Use --dir <path> or set QUONFIG_DIR.');
+        // Resolve target directory. The cwd walk is for the "already inside a
+        // workspace" case; for a first-time clone the user passes --dir
+        // explicitly (no quonfig.json exists yet, so the walk would fail).
+        const resolved = resolveWorkspaceDir({
+            flagDir: flags.dir,
+            envDir: process.env.QUONFIG_DIR,
+            cwd: process.cwd(),
+        });
+        if (resolved.kind === 'error') {
+            return this.err(resolved.message);
         }
-        const resolvedDir = path.resolve(dir);
+        const resolvedDir = resolved.dir;
         // Resolve workspace ID — supports both OAuth and QUONFIG_API_KEY paths,
         // mirroring what APICommand does via get-client.ts so `qfg pull` behaves
         // the same in CI as `qfg create` or `qfg push`.
@@ -56,11 +63,37 @@ CLI shortcuts (no JSON editing needed for simple cases):
         // Perform git operation
         const isRepo = await isGitRepo(resolvedDir);
         if (isRepo) {
-            // Existing repo — check remote
-            const existingRemote = await getRemoteUrl(resolvedDir);
+            // Multi-remote support (qfg-glrd.3): walk every configured remote to
+            // find one whose URL matches the backend repo. Customers commonly run
+            // `origin = github.com/<org>/configs` for PR review with a secondary
+            // remote pointing at Quonfig — a single-remote check would falsely
+            // abort here. We accept as long as ANY configured remote matches.
+            const allRemotes = await getAllRemoteUrls(resolvedDir);
+            const matchingRemote = findQuonfigRemote(allRemotes, repoUrl);
             const expectedUrlBase = stripAuth(repoUrl);
-            if (existingRemote && stripAuth(existingRemote) !== expectedUrlBase) {
-                return this.err(`Directory has a different git remote:\n  existing: ${displayUrl(existingRemote)}\n  expected: ${expectedUrlBase}\n\nResolve manually or use a different --dir.`);
+            if (allRemotes.length > 0 && !matchingRemote) {
+                // No configured remote points at the Quonfig backend. List every
+                // remote we considered so the user can see what's misconfigured —
+                // refuse BEFORE fetching anything from the wrong target.
+                const remoteList = allRemotes.map((r) => `  - ${displayUrl(r)}`).join('\n');
+                return this.err(`No configured git remote matches the Quonfig backend.\n` +
+                    `Configured remotes:\n${remoteList}\n` +
+                    `Expected: ${expectedUrlBase}\n\n` +
+                    `Resolve manually or use a different --dir.`);
+            }
+            // The Quonfig-matching remote must be `origin` for the current pull
+            // flow, which fetches `origin` and merges `origin/main`. If a non-
+            // origin remote matches, tell the user how to align — refusing
+            // cleanly is safer than silently rewriting `origin` (which would
+            // clobber their PR-review remote URL).
+            const originRemote = await getRemoteUrl(resolvedDir);
+            const originMatches = originRemote !== null && stripAuth(originRemote) === expectedUrlBase;
+            if (matchingRemote && !originMatches) {
+                return this.err(`qfg pull requires the Quonfig remote to be named "origin".\n` +
+                    `A matching remote was found, but it is not origin:\n` +
+                    `  matching remote: ${displayUrl(matchingRemote)}\n` +
+                    `  origin:          ${originRemote ? displayUrl(originRemote) : '(unset)'}\n\n` +
+                    `Rename the Quonfig remote to origin (replacing the current origin), or set origin to ${expectedUrlBase}.`);
             }
             // Update the remote URL to use current (possibly refreshed) token
             await gitSetRemote(resolvedDir, repoUrl);