@quonfig/cli 0.0.49 → 0.0.51

package/dist/migrate/sources/launchdarkly.js

@@ -12,7 +12,7 @@ import * as fs from 'node:fs';
 import * as os from 'node:os';
 import * as path from 'node:path';
 import { ConversionReport } from '../quonfig-target/report.js';
-import { fetchProjectEnvironments, fetchSegmentsForEnv, fetchSnapshot } from './launchdarkly/api.js';
+import { fetchMembers, fetchProjectEnvironments, fetchProjectEnvironmentsDetailed, fetchSegmentsForEnv, fetchSnapshot, } from './launchdarkly/api.js';
 import { auditEntryToLegacyChange, buildFlagAuditSpec, getCommitMetaForAuditEntry, probeRetentionHorizon, walkAuditLog, } from './launchdarkly/audit.js';
 import { flagOutputPath, segmentOutputPath, translateFlag, translateSegment } from './launchdarkly/translate.js';
 const SOURCE_NAME = 'launchdarkly';
@@ -39,7 +39,9 @@ function resolveProjectKey() {
 const state = {
     apiKey: null,
     environments: [],
+    environmentSourceNames: [],
     fullSummary: false,
+    maintainerMap: null,
     projectKey: resolveProjectKey(),
     report: new ConversionReport(),
     retentionHorizon: null,
@@ -89,11 +91,15 @@ function slugifyEnvKey(key) {
 }
 async function validateAuthImpl(apiKey) {
     // A cheap authenticated call — 401s on a bad token, 404s on a bad project.
-    await fetchProjectEnvironments(apiKey, state.projectKey);
+    // Use the detailed call so we can stash {key, name} for the report's env
+    // mapping table (qfg-1t7m) without a second round-trip.
+    const detailed = await fetchProjectEnvironmentsDetailed(apiKey, state.projectKey);
     state.apiKey = apiKey;
     state.report = new ConversionReport();
     state.environments = [];
+    state.environmentSourceNames = detailed;
     state.retentionHorizon = null;
+    state.maintainerMap = null;
     // Plan §4.1.1: under --full-summary, probe the audit-log retention window
     // here — the earliest authenticated hook — so the command can tell the user
     // the real history horizon BEFORE the slow Phase-2 walk starts. The walk can
@@ -103,10 +109,33 @@ async function validateAuthImpl(apiKey) {
         state.retentionHorizon = await probeRetentionHorizon(apiKey, { spec: buildFlagAuditSpec(state.projectKey) });
     }
 }
+/**
+ * qfg-l8uz: best-effort `/members` lookup so MIGRATION_REPORT.md can render
+ * `maintainerId → email`. Project-scoped tokens or accounts that hide member
+ * data will 403 here — that's fine, the migration must not fail just because
+ * the rollup loses a label. Returns null on any error, the empty map when the
+ * endpoint returns no members, and a stripped map otherwise (members without
+ * an email are skipped — we have nothing useful to render for them).
+ */
+async function loadMaintainerMap(apiKey) {
+    try {
+        const members = await fetchMembers(apiKey);
+        const map = {};
+        for (const member of members) {
+            if (member.email)
+                map[member._id] = member.email;
+        }
+        return map;
+    }
+    catch {
+        return null;
+    }
+}
 async function listEnvironmentsImpl() {
     const apiKey = requireApiKey('listEnvironments');
-    const envKeys = await fetchProjectEnvironments(apiKey, state.projectKey);
-    state.environments = envKeys.map((k) => slugifyEnvKey(k));
+    const detailed = await fetchProjectEnvironmentsDetailed(apiKey, state.projectKey);
+    state.environmentSourceNames = detailed;
+    state.environments = detailed.map((e) => slugifyEnvKey(e.key));
     return [...new Set(state.environments)];
 }
 /**
@@ -120,6 +149,11 @@ async function listEnvironmentsImpl() {
  */
 async function* fetchChangesImpl() {
     const apiKey = requireApiKey('fetchChanges');
+    // qfg-l8uz: load the account-wide member directory once so the report can
+    // render maintainerId → email pairs. Deliberately best-effort — a failed
+    // call (project-scoped token, hidden member data) just leaves the rollup
+    // showing opaque hex IDs.
+    state.maintainerMap = await loadMaintainerMap(apiKey);
     if (state.fullSummary) {
         yield* fetchAuditHistory(apiKey);
         return;
@@ -243,6 +277,39 @@ function getSkippedConfigsImpl() {
 export function getConversionReport() {
     return state.report;
 }
+/**
+ * qfg-l8uz: maintainerId → email map produced by `/members` during
+ * validateAuth, or null when the call failed (project-scoped token, account
+ * hides members, etc.). The report renderer surfaces this as a sub-table on
+ * `## Identifier map` and decorates `dropped-maintainer` rollups so a reader
+ * sees real emails alongside the opaque hex IDs.
+ */
+function getMaintainerMapImpl() {
+    if (state.maintainerMap === null)
+        return null;
+    return Object.keys(state.maintainerMap).length === 0 ? null : { ...state.maintainerMap };
+}
+/**
+ * qfg-1t7m: source-name → Quonfig-name pairs for the report's "Environment
+ * mapping table". The source name is LD's user-facing env display name; the
+ * Quonfig name is the slugified env key. De-duped on the slugified key — two
+ * source envs that collapse to the same slug get one row (the first wins),
+ * since that is the row that will exist in quonfig.json.
+ */
+function getEnvironmentMapImpl() {
+    if (state.environmentSourceNames.length === 0)
+        return null;
+    const seen = new Set();
+    const entries = [];
+    for (const env of state.environmentSourceNames) {
+        const quonfigName = slugifyEnvKey(env.key);
+        if (seen.has(quonfigName))
+            continue;
+        seen.add(quonfigName);
+        entries.push({ quonfigName, sourceName: env.name });
+    }
+    return entries.length === 0 ? null : entries;
+}
 /**
  * Every structured conversion note from this run — re-bucketed rollouts,
  * dropped prerequisites, lossy individual-target conversions, etc. The write
@@ -275,6 +342,8 @@ export const launchdarklySource = {
     },
     getCommitMeta: getCommitMetaImpl,
     getConversionNotes: getConversionNotesImpl,
+    getEnvironmentMap: getEnvironmentMapImpl,
+    getMaintainerMap: getMaintainerMapImpl,
     getSkippedConfigs: getSkippedConfigsImpl,
     listEnvironments: listEnvironmentsImpl,
     name: SOURCE_NAME,
@@ -284,7 +353,9 @@ export const launchdarklySource = {
 export function __resetLaunchDarklySourceForTests() {
     state.apiKey = null;
     state.environments = [];
+    state.environmentSourceNames = [];
     state.fullSummary = false;
+    state.maintainerMap = null;
     state.projectKey = resolveProjectKey();
     state.report = new ConversionReport();
     state.retentionHorizon = null;

package/dist/util/friction-log.d.ts

@@ -4,6 +4,7 @@ export interface FrictionEntry {
     exitCode: number;
     ts: string;
 }
+export declare function getDefaultFrictionLogPath(home?: string): string;
 export declare function getFrictionLogPath(envValue?: string | undefined, cwd?: string): null | string;
 export declare function buildFrictionEntry(opts: {
     argv?: string[];

package/dist/util/friction-log.js

@@ -1,5 +1,9 @@
 import fs from 'node:fs';
+import os from 'node:os';
 import path from 'node:path';
+export function getDefaultFrictionLogPath(home = os.homedir()) {
+    return path.join(home, '.qfg', 'friction.log');
+}
 export function getFrictionLogPath(envValue, cwd = process.cwd()) {
     if (envValue === undefined)
         return null;
@@ -7,7 +11,7 @@ export function getFrictionLogPath(envValue, cwd = process.cwd()) {
     if (trimmed === '' || trimmed === 'false' || trimmed === '0')
         return null;
     if (trimmed === 'true' || trimmed === '1') {
-        return path.join(cwd, '.qfg-friction.log');
+        return getDefaultFrictionLogPath();
     }
     return path.isAbsolute(trimmed) ? trimmed : path.resolve(cwd, trimmed);
 }
@@ -23,6 +27,7 @@ export function buildFrictionEntry(opts) {
     };
 }
 export function appendFrictionEntry(logPath, entry) {
+    fs.mkdirSync(path.dirname(logPath), { recursive: true });
     fs.appendFileSync(logPath, JSON.stringify(entry) + '\n', 'utf8');
 }
 const MAX_STDERR_CAPTURE = 4000;

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-declare const _default: "0.0.49";
+declare const _default: "0.0.51";
 export default _default;

package/dist/version.js

@@ -1,2 +1,2 @@
 // AUTO-GENERATED from package.json by scripts/generate-version.mjs — do not edit.
-export default '0.0.49';
+export default '0.0.51';