@quonfig/cli 0.0.54 → 0.0.57

package/oclif.manifest.json

@@ -115,6 +115,61 @@
         "audit-log.js"
       ]
     },
+    "cleanup": {
+      "aliases": [],
+      "args": {},
+      "description": "Retire feature flags that have done their job.\n\nThe cleanup workflow turns a flag's \"Ready for cleanup\" marker into an end-to-end\nremoval flow: surface the flags that are safe to retire, hand the actual code\nremoval to the qfg-flag-cleanup Claude skill, then delete the flag definition\nonce the call sites are gone.\n\nLifecycle (high-level):\n  1. Owner flips readyForCleanup=true in the UI            (already exists)\n  2. qfg cleanup list                                       see candidates + telemetry\n  3. qfg cleanup status <key>                               drill into one flag\n  4. qfg cleanup remove <key>                               handoff to the cleanup skill\n  5. PR merges, SDK redeploys, telemetry confirms 0 evals\n  6. qfg cleanup verify <key>                               (optional) confirm safe\n  7. qfg delete <key>                                       remove the flag definition",
+      "examples": [
+        "<%= config.bin %> cleanup list",
+        "<%= config.bin %> cleanup list --json",
+        "<%= config.bin %> cleanup status my.flag.key"
+      ],
+      "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"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cleanup",
+      "pluginAlias": "@quonfig/cli",
+      "pluginName": "@quonfig/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cleanup.js"
+      ]
+    },
     "config-schema": {
       "aliases": [],
       "args": {},
@@ -184,7 +239,7 @@
           "required": true
         }
       },
-      "description": "Create a new feature flag, config value, or other item.\n\nUse --type to specify the kind of item:\n  boolean-flag  On/off feature flag (sendToClientSdk defaults to true; best for gradual rollouts)\n  string        A string configuration value\n  int           An integer configuration value\n  double        A floating-point configuration value\n  string-list   A comma-separated list of strings\n  json          An arbitrary JSON blob\n  boolean       A plain boolean (not a feature flag)\n  duration      An ISO 8601 duration string, e.g. PT30S, PT5M, PT1H30M (SDK returns milliseconds)\n  log_level     A dynamic log level (value must be one of TRACE/DEBUG/INFO/WARN/ERROR/FATAL)\n\nThis sets the global default value. Override per-environment with:\n  qfg set-default my.flag --environment production --value true\n\nFor a percentage rollout (gradual rollout / A/B test / canary deploy), use:\n  qfg set-rollout my.flag --environment production --true-percent 20\n\nOr edit the JSON config file directly for complex targeting rules:\n  qfg config-schema          # full operator reference + examples\n  qfg pull --dir ./config    # clone workspace, then edit JSON and git push\n\nLog levels:\n  qfg create log-level.my-app --type log_level --value WARN\n  # Log-level keys must start with \"log-level.\".\n  # For per-logger targeting, create ONE log-level config per service and add\n  # rules on the \"quonfig-sdk-logging.key\" context property (e.g.\n  # PROP_STARTS_WITH_ONE_OF MyPackage.) rather than one config per logger.",
+      "description": "Create a new feature flag, config value, or other item.\n\nUse --type to specify the kind of item:\n  boolean-flag  On/off feature flag (sendToClientSdk defaults to true; best for gradual rollouts)\n  string        A string configuration value\n  int           An integer configuration value\n  double        A floating-point configuration value\n  string-list   A comma-separated list of strings\n  json          An arbitrary JSON blob\n  boolean       A plain boolean (not a feature flag)\n  duration      An ISO 8601 duration string, e.g. PT30S, PT5M, PT1H30M (SDK returns milliseconds)\n  log_level     A dynamic log level (value must be one of TRACE/DEBUG/INFO/WARN/ERROR/FATAL)\n\nThis sets the global default value. Override per-environment with:\n  qfg set-default my.flag --environment production --value true\n\nFor a percentage rollout (gradual rollout / A/B test / canary deploy), use:\n  qfg set-rollout my.flag --environment production --true-percent 20\n\nOr edit the JSON config file directly for complex targeting rules:\n  qfg config-schema          # full operator reference + examples\n  qfg pull --dir ./config    # clone workspace, then edit JSON and git push\n\nLog levels:\n  qfg create log-level.my-app --type log_level --value WARN\n  # Log-level keys must start with \"log-level.\".\n  # For per-logger targeting, create ONE log-level config per service and add\n  # rules on the \"quonfig-sdk-logging.key\" context property (e.g.\n  # PROP_STARTS_WITH_ONE_OF MyPackage.) rather than one config per logger.\n\nWhen this flag has done its job, mark readyForCleanup: true in the UI and run `qfg cleanup list` to retire it.",
       "examples": [
         "<%= config.bin %> <%= command.id %> my.new.flag --type boolean-flag",
         "<%= config.bin %> <%= command.id %> my.new.flag --type boolean-flag --value=true",
@@ -3029,6 +3084,339 @@
         "restore.js"
       ]
     },
+    "cleanup:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List feature flags marked readyForCleanup=true, with eval volume per window.\n\nColumns:\n  KEY         the flag key\n  TYPE        the flag's valueType (bool, string, int, etc.)\n  EVALS_24H   evals counted in today's bucket (latest day)\n  EVALS_2D    evals in the last 2 calendar days\n  EVALS_7D    evals in the last 7 calendar days\n  EVALS_30D   evals in the last 30 calendar days\n  LAST_EVAL   most recent calendar day with any evals (UTC), blank if none\n  CLASS       quiet (zero evals in last 2 days) or active\n\nDefault sort: quiet first, oldest LAST_EVAL at top.\n\nPass --json for the structured object (rows[]). Each row carries the columns\nabove plus the raw eval counts your agent can reason about itself.\n\nOnce you've picked a candidate, run `qfg cleanup status <key>` for the\ndrill-in or hand off the removal to the qfg-flag-cleanup Claude skill.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Return structured rows for agent consumption",
+          "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"
+        },
+        "workspace": {
+          "char": "w",
+          "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)",
+          "helpGroup": "GLOBAL",
+          "name": "workspace",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "profile": {
+          "char": "p",
+          "description": "Deprecated: use --workspace instead",
+          "helpGroup": "GLOBAL",
+          "hidden": true,
+          "name": "profile",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cleanup:list",
+      "pluginAlias": "@quonfig/cli",
+      "pluginName": "@quonfig/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cleanup",
+        "list.js"
+      ]
+    },
+    "cleanup:remove": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "description": "config/feature-flag/etc. name",
+          "name": "name"
+        }
+      },
+      "description": "Write a cleanup payload for a ready-for-cleanup flag and hand off to the qfg-flag-cleanup Claude skill.\n\nModeled on `qfg migrate my-code` — this command never edits source files\nitself. It validates that the flag is marked readyForCleanup=true, refuses to\nproceed if there are still evals_2d > 0 (use --force to override), writes\n`.qf/cleanup/<key>.json` describing the flag's current rule shape +\ntelemetry, and prints instructions to invoke the qfg-flag-cleanup skill which\nasks the engineer which value should \"win\" and applies the inlining.\n\nThe payload deliberately does NOT suggest a winning value; that's the\nengineer's call. Run `qfg cleanup status <key>` first if you want to inspect\ntelemetry before retiring.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> my.flag.key",
+        "<%= config.bin %> <%= command.id %> my.flag.key --force",
+        "<%= config.bin %> <%= command.id %> my.flag.key --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"
+        },
+        "workspace": {
+          "char": "w",
+          "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)",
+          "helpGroup": "GLOBAL",
+          "name": "workspace",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "profile": {
+          "char": "p",
+          "description": "Deprecated: use --workspace instead",
+          "helpGroup": "GLOBAL",
+          "hidden": true,
+          "name": "profile",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "force": {
+          "description": "Skip the evals_2d > 0 safety gate (useful when telemetry is delayed but you know the flag is dead)",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cleanup:remove",
+      "pluginAlias": "@quonfig/cli",
+      "pluginName": "@quonfig/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cleanup",
+        "remove.js"
+      ]
+    },
+    "cleanup:status": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "description": "config/feature-flag/etc. name",
+          "name": "name"
+        }
+      },
+      "description": "Drill into one ready-for-cleanup flag — show telemetry across all environments and the current rule shape.\n\nUse this after `qfg cleanup list` to inspect a specific flag before handing\nremoval off to the qfg-flag-cleanup Claude skill. The eval counts come from\nanalytics.configSparklines (the same backing data the per-flag sparklines on\nthe flag detail page use), summed into 24h/2d/7d/30d windows so you can decide\nwhether it's safe to retire.\n\nPass --json for the structured object including the full rule shape per\nenvironment — the cleanup skill consumes this directly.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> my.flag.key",
+        "<%= config.bin %> <%= command.id %> my.flag.key --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Return structured object for agent consumption",
+          "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"
+        },
+        "workspace": {
+          "char": "w",
+          "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)",
+          "helpGroup": "GLOBAL",
+          "name": "workspace",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "profile": {
+          "char": "p",
+          "description": "Deprecated: use --workspace instead",
+          "helpGroup": "GLOBAL",
+          "hidden": true,
+          "name": "profile",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cleanup:status",
+      "pluginAlias": "@quonfig/cli",
+      "pluginName": "@quonfig/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cleanup",
+        "status.js"
+      ]
+    },
+    "cleanup:verify": {
+      "aliases": [],
+      "args": {
+        "name": {
+          "description": "config/feature-flag/etc. name",
+          "name": "name"
+        }
+      },
+      "description": "Confirm zero evals for a flag in the trailing N days (default 7). Exits 0 if safe to delete, non-zero otherwise.\n\nRead-only gate intended for chaining with `qfg delete` after a cleanup PR\nhas merged and the SDK has redeployed:\n\n  qfg cleanup verify my.flag.key && qfg delete my.flag.key\n\nThe trailing window is stricter than the `qfg cleanup remove` 2-day gate on\npurpose — `remove` only writes a payload describing the flag, but `delete`\npermanently removes the flag definition, so we want a longer quiet period\nbefore chaining. Bump --days N if you want a more conservative window.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> my.flag.key",
+        "<%= config.bin %> <%= command.id %> my.flag.key --days 14",
+        "<%= config.bin %> <%= command.id %> my.flag.key --json",
+        "<%= config.bin %> <%= command.id %> my.flag.key && <%= config.bin %> delete my.flag.key"
+      ],
+      "flags": {
+        "json": {
+          "description": "Return structured object for agent consumption",
+          "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"
+        },
+        "workspace": {
+          "char": "w",
+          "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)",
+          "helpGroup": "GLOBAL",
+          "name": "workspace",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "profile": {
+          "char": "p",
+          "description": "Deprecated: use --workspace instead",
+          "helpGroup": "GLOBAL",
+          "hidden": true,
+          "name": "profile",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "days": {
+          "description": "Number of trailing calendar days that must have zero evals",
+          "name": "days",
+          "default": 7,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cleanup:verify",
+      "pluginAlias": "@quonfig/cli",
+      "pluginName": "@quonfig/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cleanup",
+        "verify.js"
+      ]
+    },
     "migrate:doctor": {
       "aliases": [],
       "args": {},
@@ -3738,5 +4126,5 @@
       ]
     }
   },
-  "version": "0.0.54"
+  "version": "0.0.57"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "packageManager": "yarn@4.11.0+sha512.4e54aeace9141df2f0177c266b05ec50dc044638157dae128c471ba65994ac802122d7ab35bcd9e81641228b7dcf24867d28e750e0bcae8a05277d600008ad54",
   "name": "@quonfig/cli",
-  "version": "0.0.54",
+  "version": "0.0.57",
   "bugs": {
     "url": "https://github.com/quonfig/cli/issues"
   },
@@ -24,7 +24,7 @@
     "@quonfig/node": "^0.0.32",
     "acorn": "^8.10.0",
     "acorn-walk": "^8.3.5",
-    "chalk": "^5.4.1",
+    "chalk": "^5.6.2",
     "common-tags": "^1.8.2",
     "fuzzy": "^0.1.3",
     "inquirer-autocomplete-standalone": "^0.8.1",
@@ -54,11 +54,11 @@
     "eslint-plugin-only-error": "^1.0.2",
     "mocha": "^11.7.5",
     "msw": "^2.14.6",
-    "oclif": "^4.22.29",
+    "oclif": "^4.23.7",
     "prettier": "^3.8.3",
     "shx": "^0.3.4",
     "ts-node": "^10.9.1",
-    "tsx": "^4.21.0"
+    "tsx": "^4.22.0"
   },
   "engines": {
     "node": ">=20.9.0"