@quonfig/cli 0.2.3 → 0.3.0

package/oclif.manifest.json

@@ -118,7 +118,7 @@
     "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",
+      "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 your coding agent with the Quonfig agent skill (install it with\n`qfg agent install-skill`), then delete the flag definition once the call\nsites 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 agent 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",
@@ -230,6 +230,59 @@
         "config-schema.js"
       ]
     },
+    "contexts": {
+      "aliases": [],
+      "args": {},
+      "description": "Look up contexts (organizations, users, ...) your SDKs have reported, to target them by key.",
+      "examples": [
+        "<%= config.bin %> contexts search organization formhealth"
+      ],
+      "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": "contexts",
+      "pluginAlias": "@quonfig/cli",
+      "pluginName": "@quonfig/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "contexts.js"
+      ]
+    },
     "create": {
       "aliases": [],
       "args": {
@@ -2255,7 +2308,7 @@
           "name": "name"
         }
       },
-      "description": "Set the fallback value for a flag or config in one environment.\n\nThe fallback is the unconditional rule at the end of the environment's rule\nlist: what users receive when no targeting rule matches. Targeting rules and\npercentage rollouts above it are kept, and the command tells you how many.\nIf the environment has no rules of its own yet, they are copied from the\nflag's default rules first, so inherited targeting is kept too.\n\nTo turn a flag on or off for EVERYONE, including users matched by targeting\nrules, add --replace-targeting. This deletes the environment's targeting\nrules (they stay in git history).\n\nTo set a percentage rollout (gradual rollout / A/B test / canary deploy) instead:\n  qfg set-rollout my.flag --environment production --true-percent 20\n\nTo see all current values and rules for a flag:\n  qfg info my.flag",
+      "description": "Set the fallback value for a flag or config in one environment.\n\nThe fallback is the unconditional rule at the end of the environment's rule\nlist: what users receive when no targeting rule matches. Targeting rules and\npercentage rollouts above it are kept, and the command tells you how many.\nIf the environment has no rules of its own yet, they are copied from the\nflag's default rules first, so inherited targeting is kept too.\n\nTo turn a flag on or off for EVERYONE, including users matched by targeting\nrules, add --replace-targeting. This deletes the environment's targeting\nrules (they stay in git history).\n\nTo set a percentage rollout (gradual rollout / A/B test / canary deploy) instead:\n  qfg set-rollout my.flag --environment production --true-percent 20\n\nTo see all current values and rules for a flag:\n  qfg info my.flag\n\nTo target specific organizations or users, write rules on their KEY\n(organization.key, user.key), not a slug or email; find a key from a name with:\n  qfg contexts search organization formhealth",
       "examples": [
         "<%= config.bin %> <%= command.id %> my.flag.name                                          # prompts for value and env",
         "<%= config.bin %> <%= command.id %> my.flag.name --value=true --environment=staging",
@@ -3108,10 +3161,87 @@
         "restore.js"
       ]
     },
+    "agent:install-skill": {
+      "aliases": [],
+      "args": {},
+      "description": "Install the Quonfig agent skill into this repo so coding agents use Quonfig correctly.\n\nWrites .claude/skills/quonfig/ (SKILL.md + references/) — the same files as\n`claude plugin install quonfig@quonfig` from github.com/quonfig/skills, embedded\nin this qfg build (no network). Claude Code picks the skill up automatically;\nfor Codex, Cursor and other agents that read AGENTS.md, add --add-pointer.\n\nSafe to re-run: files still as qfg wrote them are upgraded in place, files you\nedited are left alone (the command fails and lists them) unless you pass --force.\n\nThis skill is for APPLICATION repos (SDK + qfg + MCP usage). A workspace repo\ncreated by `qfg init` has its own AGENTS.md/CLAUDE.md for editing config JSON.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --add-pointer",
+        "<%= config.bin %> <%= command.id %> --dir .agents/skills",
+        "<%= config.bin %> <%= command.id %> --force"
+      ],
+      "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"
+        },
+        "add-pointer": {
+          "description": "Also append a one-line pointer to the skill in ./AGENTS.md (created if missing)",
+          "name": "add-pointer",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "dir": {
+          "description": "Skills directory to install into, relative to the current directory",
+          "name": "dir",
+          "default": ".claude/skills",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "force": {
+          "description": "Overwrite skill files you have edited locally",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "agent:install-skill",
+      "pluginAlias": "@quonfig/cli",
+      "pluginName": "@quonfig/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "agent",
+        "install-skill.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.",
+      "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 `qfg cleanup remove <key>` to hand the removal to your coding agent\nwith the Quonfig agent skill.",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --json"
@@ -3191,7 +3321,7 @@
           "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.",
+      "description": "Write a cleanup payload for a ready-for-cleanup flag and hand off to the Quonfig agent 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 how to have your coding agent remove the call sites with\nthe quonfig agent skill (its references/retire-a-flag.md), which asks the\nengineer which value should \"win\" and applies the inlining. Install the skill\nwith `qfg agent install-skill` or `claude plugin install quonfig@quonfig`.\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",
@@ -3279,7 +3409,7 @@
           "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.",
+      "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 Quonfig agent 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 agent skill consumes this directly.",
       "examples": [
         "<%= config.bin %> <%= command.id %> my.flag.key",
         "<%= config.bin %> <%= command.id %> my.flag.key --json"
@@ -3441,6 +3571,109 @@
         "verify.js"
       ]
     },
+    "contexts:search": {
+      "aliases": [],
+      "args": {
+        "contextType": {
+          "description": "Context type to search, e.g. organization or user (the part before \".key\" in a rule)",
+          "name": "contextType",
+          "required": true
+        },
+        "query": {
+          "description": "Case-insensitive text matched against each context key and its reported properties (e.g. a name)",
+          "name": "query",
+          "required": true
+        }
+      },
+      "description": "Find a context's key from a name, to target it in a rule.\n\nTargeting rules should match a context by its KEY (<contextType>.key, e.g.\norganization.key or user.key), not by a slug, email or name. This searches the\ncontexts your SDKs have reported through telemetry, matching the query against\neach context's key and properties, and prints each match's key, its name and\nits email (blank when the context reported none), most recently seen first.\n\nOnly contexts your SDKs have reported are searchable. If nothing matches, the key\nis unknown: get it from whoever owns that customer rather than targeting a slug\nor email instead.\n\nPass a key as the query to see its name and email.\n\n--json prints {contexts: [{key, name, email?}]}: name is null when the context\nreported no name, and email is present only when it reported one.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> organization formhealth",
+        "<%= config.bin %> <%= command.id %> user barry@example.com --environment production",
+        "<%= config.bin %> <%= command.id %> organization formhealth --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"
+        },
+        "environment": {
+          "description": "Only contexts reported from this environment (default: every environment)",
+          "name": "environment",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "limit": {
+          "description": "Maximum number of matches (1-100)",
+          "name": "limit",
+          "default": 20,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "contexts:search",
+      "pluginAlias": "@quonfig/cli",
+      "pluginName": "@quonfig/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "contexts",
+        "search.js"
+      ]
+    },
     "migrate:doctor": {
       "aliases": [],
       "args": {},
@@ -4150,5 +4383,5 @@
       ]
     }
   },
-  "version": "0.2.3"
+  "version": "0.3.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "packageManager": "yarn@4.11.0+sha512.4e54aeace9141df2f0177c266b05ec50dc044638157dae128c471ba65994ac802122d7ab35bcd9e81641228b7dcf24867d28e750e0bcae8a05277d600008ad54",
   "name": "@quonfig/cli",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "bugs": {
     "url": "https://github.com/quonfig/cli/issues"
   },
@@ -94,8 +94,7 @@
     }
   },
   "scripts": {
-    "prebuild": "node scripts/generate-version.mjs",
-    "build": "shx rm -rf dist && tsc -b",
+    "build": "node scripts/generate-version.mjs && shx rm -rf dist && tsc -b",
     "lint": "eslint --cache=true \"**/*.{ts,md,json}\"",
     "lint:fix": "eslint --cache=true --fix \"**/*.{ts,md,json}\"",
     "postpack": "shx rm -f oclif.manifest.json",