@quonfig/cli 0.0.11 → 0.0.13

package/oclif.manifest.json

@@ -587,6 +587,7 @@
     "interactive": {
       "aliases": [],
       "args": {},
+      "description": "Launch an interactive menu to browse and manage your workspace.\n\nCommon shortcuts:\n  qfg set-default my.flag --environment production --value false   # catch-all fallback\n  qfg set-rollout my.flag --environment production --true-percent 20   # % rollout\n\nFor arbitrary targeting rules (e.g. user.email, plan, segment, custom property),\nrun 'qfg config-schema' then 'qfg pull' and edit the JSON config directly.",
       "examples": [
         "<%= config.bin %>"
       ],
@@ -932,6 +933,136 @@
         "mcp.js"
       ]
     },
+    "migrate": {
+      "aliases": [],
+      "args": {},
+      "description": "Migrate flags and configs from a legacy feature-flag system into a Quonfig workspace.\n\nCurrently supported sources:\n  launch — Reforge Launch (ported from launch-migrator)\n\nSee https://docs.quonfig.com/docs/migrating/from-launch for the step-by-step guide,\nand https://docs.quonfig.com/docs/migrating/troubleshooting when something goes sideways.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --from launch --api-key $LAUNCH_API_KEY --dir ./quonfig-config",
+        "<%= config.bin %> <%= command.id %> --from launch --api-key $LAUNCH_API_KEY --workspace acme-prod --push",
+        "<%= config.bin %> <%= command.id %> --from launch --api-key $LAUNCH_API_KEY --dir ./quonfig-config --reset",
+        "<%= config.bin %> <%= command.id %> --from launch --api-key $LAUNCH_API_KEY --dir ./quonfig-config --dry-run",
+        "<%= config.bin %> <%= command.id %> --from launch --api-key $LAUNCH_API_KEY --dir ./quonfig-config --staging"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "interactive": {
+          "description": "Force interactive mode",
+          "helpGroup": "GLOBAL",
+          "name": "interactive",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "no-color": {
+          "description": "Do not colorize output",
+          "env": "NO_COLOR",
+          "helpGroup": "GLOBAL",
+          "name": "no-color",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "description": "Verbose output",
+          "helpGroup": "GLOBAL",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "api-key": {
+          "description": "API key for the legacy source (or set LAUNCH_API_KEY)",
+          "env": "LAUNCH_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dir": {
+          "description": "Target local workspace directory. Defaults to cwd if it looks like a Quonfig workspace, otherwise ./quonfig-config.",
+          "name": "dir",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dry-run": {
+          "description": "Fetch and summarize changes without writing anything",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "from": {
+          "description": "Legacy source to migrate from",
+          "name": "from",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "launch",
+            "launchdarkly",
+            "flagsmith"
+          ],
+          "type": "option"
+        },
+        "push": {
+          "description": "After migrating to a local dir, also push to the given --workspace on Quonfig cloud",
+          "name": "push",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "recent": {
+          "description": "Import only the last N changes (useful for tire-kicking)",
+          "name": "recent",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "reset": {
+          "description": "Ignore the delta cursor and re-import everything from scratch",
+          "name": "reset",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "since": {
+          "description": "Override the delta cursor (epoch milliseconds or ISO-8601 timestamp)",
+          "name": "since",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "staging": {
+          "description": "Hit the staging API for the source (dev-only)",
+          "name": "staging",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "workspace": {
+          "description": "Quonfig cloud workspace slug to push to. Requires `qfg login` and is typically combined with --push.",
+          "name": "workspace",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "migrate",
+      "pluginAlias": "@quonfig/cli",
+      "pluginName": "@quonfig/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "migrate.js"
+      ]
+    },
     "override": {
       "aliases": [],
       "args": {
@@ -940,7 +1071,7 @@
           "name": "name"
         }
       },
-      "description": "Override the value of an item for your user/SDK key combo",
+      "description": "Override the value of an item for your user/SDK key combo.\n\nTo target users other than yourself, or to express rules like \"user.email == X → value Y\",\nyou cannot use override — see:\n  qfg config-schema   # operator reference + worked multi-rule example\n  qfg pull            # clone the workspace so you can edit JSON directly",
       "examples": [
         "<%= config.bin %> <%= command.id %> # will prompt for name and value",
         "<%= config.bin %> <%= command.id %> my.flag.name --value=true",
@@ -1337,7 +1468,9 @@
         "<%= config.bin %> <%= command.id %> my.flag.name --value=true --secret",
         "<%= config.bin %> <%= command.id %> my.config.name --env-var=MY_ENV_VAR_NAME --environment=production",
         "# For a percentage rollout, use set-rollout instead:",
-        "<%= config.bin %> set-rollout my.flag.name --environment production --true-percent 20"
+        "<%= config.bin %> set-rollout my.flag.name --environment production --true-percent 20",
+        "# For per-user / per-property targeting (e.g. user.email == X), edit JSON directly:",
+        "<%= config.bin %> pull && <%= config.bin %> config-schema"
       ],
       "flags": {
         "json": {
@@ -1822,6 +1955,235 @@
         "workspace.js"
       ]
     },
+    "migrate:doctor": {
+      "aliases": [],
+      "args": {},
+      "description": "Preflight health checks for `qfg migrate`. Verifies auth, workspace provisioning, working tree, and identifier collisions.",
+      "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"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "interactive": {
+          "description": "Force interactive mode",
+          "helpGroup": "GLOBAL",
+          "name": "interactive",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "no-color": {
+          "description": "Do not colorize output",
+          "env": "NO_COLOR",
+          "helpGroup": "GLOBAL",
+          "name": "no-color",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "description": "Verbose output",
+          "helpGroup": "GLOBAL",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "api-key": {
+          "description": "Legacy SDK API key to validate against the source",
+          "name": "api-key",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dir": {
+          "description": "Workspace directory to check (git clean / identifier map)",
+          "name": "dir",
+          "default": ".",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "from": {
+          "description": "Legacy SDK to migrate from",
+          "name": "from",
+          "default": "launch",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "launch"
+          ],
+          "type": "option"
+        },
+        "language": {
+          "description": "Customer SDK language — used to warn when datadir mode is unavailable (e.g. javascript-browser)",
+          "name": "language",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "migrate:doctor",
+      "pluginAlias": "@quonfig/cli",
+      "pluginName": "@quonfig/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "migrate",
+        "doctor.js"
+      ]
+    },
+    "migrate:my-code": {
+      "aliases": [],
+      "args": {},
+      "description": "Migrate Launch SDK call sites in your codebase to Quonfig SDK call sites (invokes the qfg-migrate-code Claude skill)",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --from launch",
+        "<%= config.bin %> <%= command.id %> --dry-run"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "interactive": {
+          "description": "Force interactive mode",
+          "helpGroup": "GLOBAL",
+          "name": "interactive",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "no-color": {
+          "description": "Do not colorize output",
+          "env": "NO_COLOR",
+          "helpGroup": "GLOBAL",
+          "name": "no-color",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "description": "Verbose output",
+          "helpGroup": "GLOBAL",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "dry-run": {
+          "description": "Show what would be migrated without editing any files",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "from": {
+          "description": "Legacy SDK to migrate from",
+          "name": "from",
+          "default": "launch",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "launch"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "migrate:my-code",
+      "pluginAlias": "@quonfig/cli",
+      "pluginName": "@quonfig/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "migrate",
+        "my-code.js"
+      ]
+    },
+    "migrate:status": {
+      "aliases": [],
+      "args": {},
+      "description": "Show the status of a workspace migrated with `qfg migrate`. Reads .qf/import-state.json and summarizes source, counts, and next steps.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --dir ./my-workspace",
+        "<%= config.bin %> <%= command.id %> --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "interactive": {
+          "description": "Force interactive mode",
+          "helpGroup": "GLOBAL",
+          "name": "interactive",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "no-color": {
+          "description": "Do not colorize output",
+          "env": "NO_COLOR",
+          "helpGroup": "GLOBAL",
+          "name": "no-color",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "verbose": {
+          "description": "Verbose output",
+          "helpGroup": "GLOBAL",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "dir": {
+          "description": "Workspace directory to inspect",
+          "name": "dir",
+          "default": ".",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "migrate:status",
+      "pluginAlias": "@quonfig/cli",
+      "pluginName": "@quonfig/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "migrate",
+        "status.js"
+      ]
+    },
     "sdk-key:create": {
       "aliases": [],
       "args": {},
@@ -2217,5 +2579,5 @@
       ]
     }
   },
-  "version": "0.0.11"
+  "version": "0.0.13"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "packageManager": "yarn@4.11.0+sha512.4e54aeace9141df2f0177c266b05ec50dc044638157dae128c471ba65994ac802122d7ab35bcd9e81641228b7dcf24867d28e750e0bcae8a05277d600008ad54",
   "name": "@quonfig/cli",
-  "version": "0.0.11",
+  "version": "0.0.13",
   "bugs": {
     "url": "https://github.com/quonfig/cli/issues"
   },
@@ -21,20 +21,20 @@
     "@oclif/core": "^3.18.2",
     "@oclif/plugin-help": "^6",
     "@oclif/plugin-plugins": "^4",
-    "@quonfig/node": "^0.0.2",
+    "@quonfig/node": "^0.0.11",
     "acorn": "^8.10.0",
     "acorn-walk": "^8.2.0",
     "chalk": "^5.4.1",
-    "comment-json": "^4.2.5",
+    "comment-json": "^4.6.2",
     "common-tags": "^1.8.2",
     "fuzzy": "^0.1.3",
     "inquirer-autocomplete-standalone": "^0.8.1",
     "lodash.camelcase": "^4.3.0",
     "mustache": "^4.2.0",
-    "node-forge": "^1.3.1",
+    "node-forge": "^1.4.0",
     "zod": "^4.1.12"
   },
-  "description": "Quonfig CLI",
+  "description": "Quonfig CLI. For arbitrary targeting rules (email, plan, segment, custom property), run `qfg config-schema` then `qfg pull`.",
   "devDependencies": {
     "@oclif/prettier-config": "^0.2.1",
     "@oclif/test": "^3",
@@ -58,7 +58,7 @@
     "prettier": "^3.6.2",
     "shx": "^0.3.4",
     "ts-node": "^10.9.1",
-    "tsx": "^4.19.3",
+    "tsx": "^4.21.0",
     "typescript": "^5"
   },
   "engines": {