@quonfig/cli 0.0.11 → 0.0.13

package/dist/commands/info.js

@@ -195,7 +195,6 @@ Related commands:
         // Fetch stats for all environments (similar to original implementation)
         const endTime = Date.now();
         const startTime = endTime - 24 * 60 * 60 * 1000; // 24 hours ago
-        const timeInterval = 'HOURLY';
         const statsPerEnv = {};
         // Fetch stats for each environment via oRPC
         for (const env of environments) {
@@ -275,6 +274,10 @@ Related commands:
                 if (value.type === 'stringList' && Array.isArray(value.value)) {
                     return value.value.join(',');
                 }
+                // JSON values must be stringified, else they render as [object Object]
+                if (value.type === 'json') {
+                    return JSON.stringify(value.value);
+                }
                 return String(value.value);
             }
             // New format: {string: 'abc'}

package/dist/commands/init.js

@@ -55,7 +55,12 @@ export default class Init extends BaseCommand {
                 this.log('  Nothing to do.');
             }
             if (this.jsonEnabled()) {
-                return { actions: plan.actions, dryRun: true, isFirstTime: plan.isFirstTime, samplesIncluded: plan.samplesIncluded };
+                return {
+                    actions: plan.actions,
+                    dryRun: true,
+                    isFirstTime: plan.isFirstTime,
+                    samplesIncluded: plan.samplesIncluded,
+                };
             }
             return plan;
         }
@@ -76,7 +81,12 @@ export default class Init extends BaseCommand {
         }
         this.log('\nRun `qfg verify` to validate the workspace.');
         if (this.jsonEnabled()) {
-            return { actions: plan.actions, dryRun: false, isFirstTime: plan.isFirstTime, samplesIncluded: plan.samplesIncluded };
+            return {
+                actions: plan.actions,
+                dryRun: false,
+                isFirstTime: plan.isFirstTime,
+                samplesIncluded: plan.samplesIncluded,
+            };
         }
         return plan;
     }

package/dist/commands/interactive.d.ts

@@ -1,5 +1,6 @@
 import { BaseCommand } from '../index.js';
 export default class Interactive extends BaseCommand {
+    static description: string;
     static examples: string[];
     run(): Promise<void>;
 }

package/dist/commands/interactive.js

@@ -1,6 +1,14 @@
 import { BaseCommand } from '../index.js';
 import { interactivePrompt } from '../interactive-prompt.js';
 export default class Interactive extends BaseCommand {
+    static description = `Launch an interactive menu to browse and manage your workspace.
+
+Common shortcuts:
+  qfg set-default my.flag --environment production --value false   # catch-all fallback
+  qfg set-rollout my.flag --environment production --true-percent 20   # % rollout
+
+For arbitrary targeting rules (e.g. user.email, plan, segment, custom property),
+run 'qfg config-schema' then 'qfg pull' and edit the JSON config directly.`;
     static examples = ['<%= config.bin %>'];
     async run() {
         await interactivePrompt(this.config);

package/dist/commands/login.js

@@ -17,6 +17,9 @@ export default class Login extends BaseCommand {
     async run() {
         const { flags } = await this.parse(Login);
         const profileName = flags.profile || 'default';
+        if (process.env.QUONFIG_API_KEY && process.env.QUONFIG_API_KEY.length > 0) {
+            this.log('Note: QUONFIG_API_KEY is set — runtime will prefer it over the login session.');
+        }
         // Step 1: Request device code from WorkOS
         this.verboseLog('Requesting device authorization code...');
         const deviceAuth = await requestDeviceCode();
@@ -65,13 +68,13 @@ export default class Login extends BaseCommand {
             const res = await fetch(`${apiUrl}/api/v1/userWorkspaces/list`, {
                 method: 'POST',
                 headers: {
-                    'Authorization': `Bearer ${tokenResponse.access_token}`,
+                    Authorization: `Bearer ${tokenResponse.access_token}`,
                     'Content-Type': 'application/json',
                 },
                 body: JSON.stringify({ json: {} }),
             });
             if (res.ok) {
-                const body = await res.json();
+                const body = (await res.json());
                 const allWorkspaces = (body.json ?? body);
                 const candidates = Array.isArray(allWorkspaces) ? allWorkspaces : [];
                 multipleWorkspacesAvailable = candidates.length > 1;
@@ -81,7 +84,10 @@ export default class Login extends BaseCommand {
                 }
                 else if (candidates.length > 1) {
                     const chosen = await select({
-                        choices: candidates.map((w) => ({ name: `${w.organizationName} / ${w.workspaceSlug}`, value: w.workspaceId })),
+                        choices: candidates.map((w) => ({
+                            name: `${w.organizationName} / ${w.workspaceSlug}`,
+                            value: w.workspaceId,
+                        })),
                         message: 'Select workspace:',
                     });
                     match = candidates.find((w) => w.workspaceId === chosen);

package/dist/commands/migrate/doctor.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../index.js';
+export default class MigrateDoctor extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'api-key': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        dir: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        from: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        language: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/migrate/doctor.js

@@ -0,0 +1,63 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../index.js';
+import { formatHumanReport, runDoctor } from '../../migrate/doctor.js';
+import { loadTokens } from '../../util/token-storage.js';
+const SUPPORTED_SOURCES = new Set(['launch']);
+const defaultLoadSession = async () => {
+    const tokens = await loadTokens();
+    if (!tokens?.accessToken)
+        return null;
+    return { expiresAt: tokens.expiresAt ?? 0 };
+};
+export default class MigrateDoctor extends BaseCommand {
+    static description = 'Preflight health checks for `qfg migrate`. Verifies auth, workspace provisioning, working tree, and identifier collisions.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --from launch --api-key $LAUNCH_API_KEY',
+        '<%= config.bin %> <%= command.id %> --dir ./my-workspace --language node',
+        '<%= config.bin %> <%= command.id %> --json',
+    ];
+    static flags = {
+        'api-key': Flags.string({
+            description: 'Legacy SDK API key to validate against the source',
+            required: false,
+        }),
+        dir: Flags.string({
+            default: '.',
+            description: 'Workspace directory to check (git clean / identifier map)',
+        }),
+        from: Flags.string({
+            default: 'launch',
+            description: 'Legacy SDK to migrate from',
+            options: ['launch'],
+        }),
+        language: Flags.string({
+            description: 'Customer SDK language — used to warn when datadir mode is unavailable (e.g. javascript-browser)',
+            required: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(MigrateDoctor);
+        if (!SUPPORTED_SOURCES.has(flags.from)) {
+            this.err(`Unsupported --from source: ${flags.from}. Only 'launch' is supported today.`);
+            return;
+        }
+        const ctx = {
+            apiKey: flags['api-key'],
+            dir: flags.dir,
+            from: flags.from,
+            language: flags.language,
+            loadSession: defaultLoadSession,
+        };
+        const report = await runDoctor(ctx);
+        if (this.jsonEnabled()) {
+            process.stdout.write(JSON.stringify(report) + '\n');
+        }
+        else {
+            this.log(formatHumanReport(report));
+        }
+        if (!report.passed) {
+            this.exit(1);
+        }
+    }
+}

package/dist/commands/migrate/my-code.d.ts

@@ -0,0 +1,11 @@
+import type { JsonObj } from '../../result.js';
+import { BaseCommand } from '../../index.js';
+export default class MigrateMyCode extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        '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>;
+    };
+    run(): Promise<JsonObj | void>;
+}

package/dist/commands/migrate/my-code.js

@@ -0,0 +1,80 @@
+import { Flags } from '@oclif/core';
+import fs from 'node:fs';
+import path from 'node:path';
+import { BaseCommand } from '../../index.js';
+const SKILL_NAME = 'qfg-migrate-code';
+const SUPPORTED_SOURCES = new Set(['launch']);
+function findIdentifierMap(startDir) {
+    let dir = path.resolve(startDir);
+    while (true) {
+        const candidate = path.join(dir, '.qf', 'identifier-map.json');
+        if (fs.existsSync(candidate)) {
+            const raw = fs.readFileSync(candidate, 'utf8');
+            return { dir, map: JSON.parse(raw) };
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+export default class MigrateMyCode extends BaseCommand {
+    static description = 'Migrate Launch SDK call sites in your codebase to Quonfig SDK call sites (invokes the qfg-migrate-code Claude skill)';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --from launch',
+        '<%= config.bin %> <%= command.id %> --dry-run',
+    ];
+    static flags = {
+        'dry-run': Flags.boolean({
+            default: false,
+            description: 'Show what would be migrated without editing any files',
+        }),
+        from: Flags.string({
+            default: 'launch',
+            description: 'Legacy SDK to migrate from',
+            options: ['launch'],
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(MigrateMyCode);
+        if (!SUPPORTED_SOURCES.has(flags.from)) {
+            return this.err(`Unsupported --from source: ${flags.from}. Only 'launch' is supported today; 'launchdarkly' and 'flagsmith' will follow.`);
+        }
+        const found = findIdentifierMap(process.cwd());
+        if (!found) {
+            return this.err(`Could not find .qf/identifier-map.json in the current directory or any parent.\n\n` +
+                `This file is produced by \`qfg migrate --from ${flags.from}\` and maps legacy keys to their Quonfig equivalents.\n` +
+                `Run \`qfg migrate --from ${flags.from} --dir <your-workspace-dir>\` first, then re-run this command from your codebase.`);
+        }
+        const { dir: workspaceDir, map: mappings } = found;
+        const mappingCount = Object.keys(mappings).length;
+        const relativeMapPath = path.relative(process.cwd(), path.join(workspaceDir, '.qf', 'identifier-map.json')) || '.qf/identifier-map.json';
+        this.log(`Skill:         ${SKILL_NAME}`);
+        this.log(`From:          ${flags.from}`);
+        this.log(`Identifier map: ${relativeMapPath}`);
+        this.log(`Found:         ${mappingCount} identifier remapping${mappingCount === 1 ? '' : 's'}`);
+        if (flags['dry-run']) {
+            this.log(`Mode:          dry-run (no files will be modified)`);
+        }
+        this.log('');
+        this.log(`To run the migration, invoke Claude with the ${SKILL_NAME} skill. For example:`);
+        this.log('');
+        this.log(`  claude "/${SKILL_NAME}${flags['dry-run'] ? ' --dry-run' : ''}"`);
+        this.log('');
+        this.log(`The skill will:`);
+        this.log(`  1. Scan for ${flags.from} SDK imports and call sites`);
+        this.log(`  2. Propose edits using the ${mappingCount} key remapping${mappingCount === 1 ? '' : 's'} above`);
+        this.log(`  3. Ask for approval before editing files`);
+        this.log(`  4. Run your tests / typecheck afterwards if available`);
+        this.log(`  5. Summarize anything it could not auto-migrate`);
+        return {
+            dryRun: flags['dry-run'],
+            from: flags.from,
+            identifierMapPath: path.join(workspaceDir, '.qf', 'identifier-map.json'),
+            mappingCount,
+            mappings,
+            skill: SKILL_NAME,
+        };
+    }
+}

package/dist/commands/migrate/status.d.ts

@@ -0,0 +1,10 @@
+import type { JsonObj } from '../../result.js';
+import { BaseCommand } from '../../index.js';
+export default class MigrateStatus extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        dir: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+    };
+    run(): Promise<JsonObj | void>;
+}

package/dist/commands/migrate/status.js

@@ -0,0 +1,99 @@
+import { Flags } from '@oclif/core';
+import fs from 'node:fs';
+import path from 'node:path';
+import { BaseCommand } from '../../index.js';
+import { readImportState } from '../../migrate/import-state.js';
+const FLAGS_DIR = 'feature-flags';
+const SEGMENTS_DIR = 'segments';
+const WORKSPACE_FILE = 'quonfig.json';
+const NO_STATE_MESSAGE = 'No migration state found. Run qfg migrate --from <source> first.';
+function countJsonFiles(dir) {
+    if (!fs.existsSync(dir) || !fs.statSync(dir).isDirectory())
+        return 0;
+    return fs.readdirSync(dir).filter((name) => name.endsWith('.json') && !name.startsWith('.')).length;
+}
+function countEnvironments(dir) {
+    const file = path.join(dir, WORKSPACE_FILE);
+    if (!fs.existsSync(file))
+        return 0;
+    try {
+        const parsed = JSON.parse(fs.readFileSync(file, 'utf8'));
+        return Array.isArray(parsed.environments) ? parsed.environments.length : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+function workspaceCounts(dir) {
+    return {
+        environments: countEnvironments(dir),
+        flags: countJsonFiles(path.join(dir, FLAGS_DIR)),
+        segments: countJsonFiles(path.join(dir, SEGMENTS_DIR)),
+    };
+}
+function toIsoTimestamp(value) {
+    if (value === null || value === undefined)
+        return null;
+    const date = typeof value === 'number' ? new Date(value) : new Date(value);
+    if (Number.isNaN(date.getTime()))
+        return null;
+    return date.toISOString();
+}
+function nextHint(source, counts) {
+    if (counts.flags === 0 && counts.segments === 0) {
+        return `Run \`qfg migrate --from ${source}\` to import flags and segments.`;
+    }
+    return `Run \`qfg migrate my-code --from ${source}\` to update your SDK call sites, or re-run \`qfg migrate --from ${source}\` to pick up changes.`;
+}
+function formatHuman(payload) {
+    const lines = [];
+    lines.push(`Source:            ${payload.source}`, `Source workspace:  ${payload.sourceWorkspaceId ?? '(not recorded)'}`, `Last processed at: ${payload.lastProcessedAtIso ?? '(not recorded)'}`, `Workspace dir:     ${payload.dir}`, '', 'Counts:', `  Flags:         ${payload.counts.flags}`, `  Segments:      ${payload.counts.segments}`, `  Environments:  ${payload.counts.environments}`, '', `Next: ${payload.next}`);
+    return lines.join('\n');
+}
+export default class MigrateStatus extends BaseCommand {
+    static description = 'Show the status of a workspace migrated with `qfg migrate`. Reads .qf/import-state.json and summarizes source, counts, and next steps.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --dir ./my-workspace',
+        '<%= config.bin %> <%= command.id %> --json',
+    ];
+    static flags = {
+        dir: Flags.string({
+            default: '.',
+            description: 'Workspace directory to inspect',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(MigrateStatus);
+        const dir = path.resolve(flags.dir);
+        const state = readImportState(dir);
+        if (!state) {
+            const payload = {
+                dir,
+                found: false,
+                message: NO_STATE_MESSAGE,
+            };
+            if (this.jsonEnabled())
+                return payload;
+            this.log(NO_STATE_MESSAGE);
+            return payload;
+        }
+        const counts = workspaceCounts(dir);
+        const lastProcessedAtIso = toIsoTimestamp(state.lastProcessedAt);
+        const next = nextHint(state.source, counts);
+        const payload = {
+            counts,
+            dir,
+            found: true,
+            lastProcessedAt: state.lastProcessedAt ?? null,
+            lastProcessedAtIso,
+            next,
+            source: state.source,
+            sourceWorkspaceId: state.sourceWorkspaceId ?? null,
+        };
+        if (this.jsonEnabled())
+            return payload;
+        this.log(formatHuman(payload));
+        return payload;
+    }
+}

package/dist/commands/migrate.d.ts

@@ -0,0 +1,20 @@
+import type { JsonObj } from '../result.js';
+import { BaseCommand } from '../index.js';
+export default class Migrate extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'api-key': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        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>;
+        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>;
+        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>;
+    };
+    run(): Promise<JsonObj | void>;
+    private resolvePushWorkspace;
+}