@quonfig/cli 0.0.49 → 0.0.50

package/README.md

@@ -17,7 +17,7 @@ $ npm install -g @quonfig/cli
 $ qfg COMMAND
 running command...
 $ qfg (--version)
-@quonfig/cli/0.0.49 linux-x64 node-v24.4.1
+@quonfig/cli/0.0.50 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.49/src/commands/activity.ts)_
+_See code: [src/commands/activity.ts](https://github.com/quonfig/cli/blob/v0.0.50/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.49/src/commands/activity/deleted.ts)_
+_See code: [src/commands/activity/deleted.ts](https://github.com/quonfig/cli/blob/v0.0.50/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.49/src/commands/activity/feed.ts)_
+_See code: [src/commands/activity/feed.ts](https://github.com/quonfig/cli/blob/v0.0.50/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.49/src/commands/activity/history.ts)_
+_See code: [src/commands/activity/history.ts](https://github.com/quonfig/cli/blob/v0.0.50/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.49/src/commands/activity/restore.ts)_
+_See code: [src/commands/activity/restore.ts](https://github.com/quonfig/cli/blob/v0.0.50/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.49/src/commands/audit-log.ts)_
+_See code: [src/commands/audit-log.ts](https://github.com/quonfig/cli/blob/v0.0.50/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.49/src/commands/config-schema.ts)_
+_See code: [src/commands/config-schema.ts](https://github.com/quonfig/cli/blob/v0.0.50/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.49/src/commands/create.ts)_
+_See code: [src/commands/create.ts](https://github.com/quonfig/cli/blob/v0.0.50/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.49/src/commands/delete.ts)_
+_See code: [src/commands/delete.ts](https://github.com/quonfig/cli/blob/v0.0.50/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.49/src/commands/generate.ts)_
+_See code: [src/commands/generate.ts](https://github.com/quonfig/cli/blob/v0.0.50/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.49/src/commands/generate-new-hex-key.ts)_
+_See code: [src/commands/generate-new-hex-key.ts](https://github.com/quonfig/cli/blob/v0.0.50/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.49/src/commands/get.ts)_
+_See code: [src/commands/get.ts](https://github.com/quonfig/cli/blob/v0.0.50/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.49/src/commands/history.ts)_
+_See code: [src/commands/history.ts](https://github.com/quonfig/cli/blob/v0.0.50/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.49/src/commands/info.ts)_
+_See code: [src/commands/info.ts](https://github.com/quonfig/cli/blob/v0.0.50/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.49/src/commands/init.ts)_
+_See code: [src/commands/init.ts](https://github.com/quonfig/cli/blob/v0.0.50/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.49/src/commands/interactive.ts)_
+_See code: [src/commands/interactive.ts](https://github.com/quonfig/cli/blob/v0.0.50/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.49/src/commands/list.ts)_
+_See code: [src/commands/list.ts](https://github.com/quonfig/cli/blob/v0.0.50/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.49/src/commands/log.ts)_
+_See code: [src/commands/log.ts](https://github.com/quonfig/cli/blob/v0.0.50/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.49/src/commands/log-level.ts)_
+_See code: [src/commands/log-level.ts](https://github.com/quonfig/cli/blob/v0.0.50/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.49/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/quonfig/cli/blob/v0.0.50/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.49/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/logout.ts)_
 
 ## `qfg migrate`
 
@@ -1162,7 +1162,7 @@ EXAMPLES
   $ 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.49/src/commands/migrate.ts)_
+_See code: [src/commands/migrate.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/migrate.ts)_
 
 ## `qfg migrate doctor`
 
@@ -1200,7 +1200,7 @@ EXAMPLES
   $ qfg migrate doctor --json
 ```
 
-_See code: [src/commands/migrate/doctor.ts](https://github.com/quonfig/cli/blob/v0.0.49/src/commands/migrate/doctor.ts)_
+_See code: [src/commands/migrate/doctor.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/migrate/doctor.ts)_
 
 ## `qfg migrate my-code`
 
@@ -1232,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.49/src/commands/migrate/my-code.ts)_
+_See code: [src/commands/migrate/my-code.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/migrate/my-code.ts)_
 
 ## `qfg migrate status`
 
@@ -1263,7 +1263,7 @@ EXAMPLES
   $ qfg migrate status --json
 ```
 
-_See code: [src/commands/migrate/status.ts](https://github.com/quonfig/cli/blob/v0.0.49/src/commands/migrate/status.ts)_
+_See code: [src/commands/migrate/status.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/migrate/status.ts)_
 
 ## `qfg override [NAME] [VALUE]`
 
@@ -1318,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.49/src/commands/override.ts)_
+_See code: [src/commands/override.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/override.ts)_
 
 ## `qfg pull`
 
@@ -1366,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.49/src/commands/pull.ts)_
+_See code: [src/commands/pull.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/pull.ts)_
 
 ## `qfg push`
 
@@ -1415,7 +1415,7 @@ EXAMPLES
   $ qfg push --dir ./our-config --yes
 ```
 
-_See code: [src/commands/push.ts](https://github.com/quonfig/cli/blob/v0.0.49/src/commands/push.ts)_
+_See code: [src/commands/push.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/push.ts)_
 
 ## `qfg run [COMMAND]`
 
@@ -1466,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.49/src/commands/run.ts)_
+_See code: [src/commands/run.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/run.ts)_
 
 ## `qfg schema NAME`
 
@@ -1504,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.49/src/commands/schema.ts)_
+_See code: [src/commands/schema.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/schema.ts)_
 
 ## `qfg sdk-key`
 
@@ -1531,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.49/src/commands/sdk-key.ts)_
+_See code: [src/commands/sdk-key.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/sdk-key.ts)_
 
 ## `qfg sdk-key create`
 
@@ -1563,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.49/src/commands/sdk-key/create.ts)_
+_See code: [src/commands/sdk-key/create.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/sdk-key/create.ts)_
 
 ## `qfg sdk-key list`
 
@@ -1592,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.49/src/commands/sdk-key/list.ts)_
+_See code: [src/commands/sdk-key/list.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/sdk-key/list.ts)_
 
 ## `qfg sdk-key revoke KEYID`
 
@@ -1619,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.49/src/commands/sdk-key/revoke.ts)_
+_See code: [src/commands/sdk-key/revoke.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/sdk-key/revoke.ts)_
 
 ## `qfg set-default [NAME]`
 
@@ -1690,7 +1690,7 @@ EXAMPLES
   $ qfg pull && qfg config-schema
 ```
 
-_See code: [src/commands/set-default.ts](https://github.com/quonfig/cli/blob/v0.0.49/src/commands/set-default.ts)_
+_See code: [src/commands/set-default.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/set-default.ts)_
 
 ## `qfg set-rollout [NAME]`
 
@@ -1767,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.49/src/commands/set-rollout.ts)_
+_See code: [src/commands/set-rollout.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/set-rollout.ts)_
 
 ## `qfg sync`
 
@@ -1799,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.49/src/commands/sync.ts)_
+_See code: [src/commands/sync.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/sync.ts)_
 
 ## `qfg toggle [NAME]`
 
@@ -1901,7 +1901,7 @@ EXAMPLES
   $ qfg verify --json
 ```
 
-_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.0.49/src/commands/verify.ts)_
+_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/verify.ts)_
 
 ## `qfg whoami`
 
@@ -1924,7 +1924,7 @@ EXAMPLES
   $ qfg whoami
 ```
 
-_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.0.49/src/commands/whoami.ts)_
+_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/whoami.ts)_
 
 ## `qfg workspace`
 
@@ -1947,7 +1947,7 @@ EXAMPLES
   $ qfg workspace
 ```
 
-_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.0.49/src/commands/workspace.ts)_
+_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/workspace.ts)_
 
 ## `qfg workspace bootstrap`
 
@@ -1980,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.49/src/commands/workspace/bootstrap.ts)_
+_See code: [src/commands/workspace/bootstrap.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/workspace/bootstrap.ts)_
 
 ## `qfg workspace create SLUG`
 
@@ -2014,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.49/src/commands/workspace/create.ts)_
+_See code: [src/commands/workspace/create.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/workspace/create.ts)_
 
 ## `qfg workspace switch [SLUG]`
 
@@ -2042,7 +2042,7 @@ EXAMPLES
   $ qfg workspace switch acme/production
 ```
 
-_See code: [src/commands/workspace/switch.ts](https://github.com/quonfig/cli/blob/v0.0.49/src/commands/workspace/switch.ts)_
+_See code: [src/commands/workspace/switch.ts](https://github.com/quonfig/cli/blob/v0.0.50/src/commands/workspace/switch.ts)_
 <!-- commandsstop -->
 
 ## Local Development

package/dist/commands/info.d.ts

@@ -16,6 +16,7 @@ export default class Info extends APICommand {
     private fetchEvaluationStats;
     private formatValue;
     private hasNonTrivialCriteria;
+    private isSimpleScalarRuleValue;
     private parseConfig;
     private transformEvaluationStatsForJson;
     private transformValueForJson;

package/dist/commands/info.js

@@ -304,6 +304,32 @@ Related commands:
             return false;
         return true;
     }
+    // A rule value is a "simple scalar" if it carries a literal value that can be
+    // rendered inline next to "[override]". Rollouts ({type: 'weighted_values',
+    // ...}, or anything else where `value.value` is itself an object) cannot —
+    // String(obj) yields "[object Object]" (qfg-5j9i), and a percent split is
+    // never a one-token override anyway.
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    isSimpleScalarRuleValue(value) {
+        if (!value || typeof value !== 'object')
+            return false;
+        if (value.type === 'weighted_values' || Array.isArray(value.weightedValues))
+            return false;
+        // Old format: {type: 'string'|'bool'|'int'|'double'|'stringList'|'json', value: X}
+        if (typeof value.type === 'string' && value.value !== undefined) {
+            // A `json` payload may legitimately be an object — render it as JSON, not [object Object].
+            if (value.type === 'json')
+                return true;
+            return typeof value.value !== 'object' || Array.isArray(value.value);
+        }
+        // New format: {string: X} / {bool: X} / {int: X} / {double: X} / {stringList: [...]} / {json: ...}
+        return (value.string !== undefined ||
+            value.bool !== undefined ||
+            value.int !== undefined ||
+            value.double !== undefined ||
+            value.stringList !== undefined ||
+            value.json !== undefined);
+    }
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     parseConfig(config, environments, url) {
         const contents = [];
@@ -354,11 +380,12 @@ Related commands:
                     // Has conditional rules - show [override] with the conditional value
                     // eslint-disable-next-line @typescript-eslint/no-explicit-any
                     const overrideRule = envConfig.rules.find((r) => this.hasNonTrivialCriteria(r));
-                    if (overrideRule) {
+                    if (overrideRule && this.isSimpleScalarRuleValue(overrideRule.value)) {
                         const overrideValue = this.formatValue(overrideRule.value, false);
                         displayValue = `[override] \`${overrideValue}\``;
                     }
                     else {
+                        // Rollouts / weighted_values / anything we can't render inline → defer to the URL (qfg-5j9i).
                         displayValue = '[see rules]';
                     }
                 }

package/dist/commands/pull.js

@@ -101,8 +101,8 @@ CLI shortcuts (no JSON editing needed for simple cases):
             // Plain `git pull` is fine with untracked files, and `git merge --ff-only`
             // below will fail loudly on real conflicts (tracked modifications, or an
             // incoming commit that would overwrite an untracked file). Pre-checking
-            // just creates a self-trap when qfg itself writes files like
-            // `.qfg-friction.log` into the workspace dir (qfg-q2l).
+            // creates a self-trap whenever the customer leaves anything in the
+            // workspace dir that they haven't committed yet.
             // Fetch
             this.log('Fetching from remote...');
             try {

package/dist/migrate/local-write.js

@@ -1,7 +1,7 @@
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import { removeQfFromGitignore, writeImportState } from './import-state.js';
-import { writeMigrationReport } from './migration-report.js';
+import { deriveFollowUpFromConversionNotes, writeMigrationReport } from './migration-report.js';
 import { detectDuplicateKeys } from './sources/launch/translate.js';
 import { MIGRATOR_IDENTITY, stackCommits } from '../util/clone-and-stack-push.js';
 import { runGit, spawnGit } from '../util/git-ops.js';
@@ -199,16 +199,21 @@ export const applyLocalMigration = async (opts) => {
     const skippedConfigs = opts.source.getSkippedConfigs?.() ?? null;
     const coercedSentinels = opts.source.getCoercedSentinels?.() ?? null;
     const conversionNotes = opts.source.getConversionNotes?.() ?? null;
+    const environmentMap = opts.source.getEnvironmentMap?.() ?? null;
+    const maintainerMap = opts.source.getMaintainerMap?.() ?? 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);
     const reportData = {
         ...opts.reportData,
         counts,
+        ...(environmentMap && environmentMap.length > 0 ? { environmentMap } : {}),
+        followUp: deriveFollowUpFromConversionNotes(opts.reportData.followUp, conversionNotes ?? undefined),
         ...(coercedSentinels ? { coercedSentinels } : {}),
         ...(conversionNotes && conversionNotes.length > 0 ? { conversionNotes } : {}),
         ...(droppedOverrides ? { droppedOverrides } : {}),
         ...(duplicateResolutions ? { duplicateResolutions } : {}),
+        ...(maintainerMap && Object.keys(maintainerMap).length > 0 ? { maintainerMap } : {}),
         ...(skippedConfigs ? { skippedConfigs } : {}),
     };
     writeMigrationReport(opts.localDir, reportData);
@@ -331,6 +336,8 @@ export const buildAuditFinalCommit = (opts) => ({
         const skippedConfigs = opts.source.getSkippedConfigs?.() ?? null;
         const coercedSentinels = opts.source.getCoercedSentinels?.() ?? null;
         const conversionNotes = opts.source.getConversionNotes?.() ?? null;
+        const environmentMap = opts.source.getEnvironmentMap?.() ?? null;
+        const maintainerMap = opts.source.getMaintainerMap?.() ?? null;
         const duplicateResolutions = resolutionEntries.length > 0 ? { entries: resolutionEntries, total: resolutionEntries.length } : null;
         removeQfFromGitignore(dir);
         writeImportState(dir, opts.importState);
@@ -339,10 +346,13 @@ export const buildAuditFinalCommit = (opts) => ({
         const reportData = {
             ...opts.reportData,
             counts,
+            ...(environmentMap && environmentMap.length > 0 ? { environmentMap } : {}),
+            followUp: deriveFollowUpFromConversionNotes(opts.reportData.followUp, conversionNotes ?? undefined),
             ...(coercedSentinels ? { coercedSentinels } : {}),
             ...(conversionNotes && conversionNotes.length > 0 ? { conversionNotes } : {}),
             ...(droppedOverrides ? { droppedOverrides } : {}),
             ...(duplicateResolutions ? { duplicateResolutions } : {}),
+            ...(maintainerMap && Object.keys(maintainerMap).length > 0 ? { maintainerMap } : {}),
             ...(skippedConfigs ? { skippedConfigs } : {}),
         };
         writeMigrationReport(dir, reportData);

package/dist/migrate/migration-report.d.ts

@@ -1,6 +1,7 @@
 import type { IdentifierMap } from './identifier-map.js';
 import type { ConversionNote } from './quonfig-target/report.js';
-import type { CoercedSentinelSummary, DroppedOverrideSummary, DuplicateResolutionSummary, SkippedConfigSummary } from './source.js';
+import type { CoercedSentinelSummary, DroppedOverrideSummary, DuplicateResolutionSummary, EnvironmentMapEntry, SkippedConfigSummary } from './source.js';
+export type { EnvironmentMapEntry } from './source.js';
 export interface MigrationReportCounts {
     configsMigrated: number;
     environmentsMapped: number;
@@ -23,10 +24,6 @@ export interface UnsupportedFeature {
     feature: string;
     note?: string;
 }
-export interface EnvironmentMapEntry {
-    quonfigName: string;
-    sourceName: string;
-}
 export interface FollowUpChecklist {
     mustFixBeforeCutover: string[];
     reviewPostCutover: string[];
@@ -65,6 +62,14 @@ export interface MigrationReportData {
     followUp: FollowUpChecklist;
     identifierMap: IdentifierMap;
     lossyMappings: LossyMapping[];
+    /**
+     * qfg-l8uz: source maintainerId → email pairs. Rendered as a sub-table on
+     * `## Identifier map` so the reader sees who owned each dropped-maintainer
+     * note, and consumed by the renderer to decorate the dropped-maintainer
+     * rollup with emails. Optional/undefined when the source has no member
+     * lookup (or it failed) — both the table and the decoration just no-op.
+     */
+    maintainerMap?: null | Record<string, string>;
     /**
      * Configs soft-skipped by translate() because the source data was invalid
      * (e.g. variant/valueType mismatch). Null when nothing was skipped.
@@ -73,6 +78,12 @@ export interface MigrationReportData {
     source: string;
     unsupportedFeatures: UnsupportedFeature[];
 }
+/**
+ * Folds conversion notes into a followUp checklist. De-duplicates by hint
+ * string so a flag with two dropped prerequisites doesn't produce two
+ * identical checkbox lines.
+ */
+export declare const deriveFollowUpFromConversionNotes: (base: FollowUpChecklist, notes: ConversionNote[] | undefined) => FollowUpChecklist;
 export declare const buildMigrationReport: (data: MigrationReportData) => string;
 export declare const migrationReportPath: (outputDir: string) => string;
 export declare const writeMigrationReport: (outputDir: string, data: MigrationReportData) => string;