@rulemetric/cli 0.19.1 → 0.21.0

package/oclif.manifest.json

@@ -937,120 +937,6 @@
         "list.js"
       ]
     },
-    "experiments:enroll": {
-      "aliases": [],
-      "args": {},
-      "description": "Submit a fresh work request to an eligible project experiment",
-      "examples": [
-        "<%= config.bin %> experiments enroll --project /repo --family parser-repair --prompt-file task.txt"
-      ],
-      "flags": {
-        "api-url": {
-          "description": "Override API base URL",
-          "env": "RULEMETRIC_API_URL",
-          "hidden": true,
-          "name": "api-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "project": {
-          "char": "p",
-          "description": "Project path (defaults to current directory)",
-          "name": "project",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "family": {
-          "description": "Task family shown by the waiting experiment",
-          "name": "family",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "prompt-file": {
-          "description": "UTF-8 file containing a real, fresh work request",
-          "name": "prompt-file",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "model": {
-          "description": "Optional model constraint; must match the experiment pin",
-          "name": "model",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "experiments:enroll",
-      "pluginAlias": "@rulemetric/cli",
-      "pluginName": "@rulemetric/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "experiments",
-        "enroll.js"
-      ]
-    },
-    "experiments:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List experiments with execution, metric finding, and application separately",
-      "examples": [
-        "<%= config.bin %> experiments list",
-        "<%= config.bin %> experiments list --all"
-      ],
-      "flags": {
-        "api-url": {
-          "description": "Override API base URL",
-          "env": "RULEMETRIC_API_URL",
-          "hidden": true,
-          "name": "api-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "project": {
-          "char": "p",
-          "description": "Project path (defaults to current directory)",
-          "name": "project",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "all": {
-          "description": "Every project",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "experiments:list",
-      "pluginAlias": "@rulemetric/cli",
-      "pluginName": "@rulemetric/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "experiments",
-        "list.js"
-      ]
-    },
     "evals:agent": {
       "aliases": [],
       "args": {},
@@ -1781,10 +1667,10 @@
         "validate-judge.js"
       ]
     },
-    "gateway:ensure": {
+    "experiments:admissions": {
       "aliases": [],
       "args": {},
-      "description": "Ensure the gateway proxy is running (called by hooks, not for direct use)",
+      "description": "Show automatic captured-task admission, exclusions and experiment links",
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -1794,12 +1680,26 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "project": {
+          "description": "Canonical project checkout path",
+          "name": "project",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "offset": {
+          "description": "Receipt pagination offset",
+          "name": "offset",
+          "default": 0,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
-      "hidden": true,
       "hiddenAliases": [],
-      "id": "gateway:ensure",
+      "id": "experiments:admissions",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -1809,34 +1709,62 @@
       "relativePath": [
         "dist",
         "commands",
-        "gateway",
-        "ensure.js"
+        "experiments",
+        "admissions.js"
       ]
     },
-    "hooks:emit-instructions": {
+    "experiments:enroll": {
       "aliases": [],
       "args": {},
-      "description": "Print a synthetic instruction snapshot (on-disk instruction files) as JSON for zero-proxy instruction linking",
+      "description": "Submit a fresh work request to an eligible project experiment",
+      "examples": [
+        "<%= config.bin %> experiments enroll --project /repo --family parser-repair --prompt-file task.txt"
+      ],
       "flags": {
-        "project-dir": {
-          "description": "Project directory to scan (defaults to cwd)",
-          "name": "project-dir",
+        "api-url": {
+          "description": "Override API base URL",
+          "env": "RULEMETRIC_API_URL",
+          "hidden": true,
+          "name": "api-url",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "tool": {
-          "description": "Hook tool id whose instruction files to read (claude_code, codex, copilot_agent, copilot_cli, vscode_copilot)",
-          "name": "tool",
+        "project": {
+          "char": "p",
+          "description": "Project path (defaults to current directory)",
+          "name": "project",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "family": {
+          "description": "Task family shown by the waiting experiment",
+          "name": "family",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "prompt-file": {
+          "description": "UTF-8 file containing a real, fresh work request",
+          "name": "prompt-file",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "model": {
+          "description": "Optional model constraint; must match the experiment pin",
+          "name": "model",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
-      "hidden": true,
       "hiddenAliases": [],
-      "id": "hooks:emit-instructions",
+      "id": "experiments:enroll",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -1846,18 +1774,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "hooks",
-        "emit-instructions.js"
+        "experiments",
+        "enroll.js"
       ]
     },
-    "hooks:install": {
+    "experiments:list": {
       "aliases": [],
       "args": {},
-      "description": "Install session tracking hooks and context capture proxy for Claude Code",
+      "description": "List experiments with execution, metric finding, and application separately",
       "examples": [
-        "<%= config.bin %> hooks install",
-        "<%= config.bin %> hooks install --global",
-        "<%= config.bin %> hooks install --no-proxy"
+        "<%= config.bin %> experiments list",
+        "<%= config.bin %> experiments list --all"
       ],
       "flags": {
         "api-url": {
@@ -1869,42 +1796,24 @@
           "multiple": false,
           "type": "option"
         },
-        "no-proxy": {
-          "description": "Skip proxy/gateway configuration (hooks only)",
-          "name": "no-proxy",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "project-dir": {
-          "description": "Project directory to install hooks in (defaults to cwd)",
-          "name": "project-dir",
+        "project": {
+          "char": "p",
+          "description": "Project path (defaults to current directory)",
+          "name": "project",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "user-hooks": {
-          "description": "Write user-level Cursor/Antigravity hooks (~/.cursor, ~/.gemini). Required for Cursor capture — its traffic bypasses the proxy.",
-          "name": "user-hooks",
-          "allowNo": true,
-          "type": "boolean"
-        },
-        "global": {
-          "char": "g",
-          "description": "Install hooks globally (~/.claude/settings.json) so all projects are tracked",
-          "name": "global",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "statusline-usage": {
-          "description": "Install the statusline shim so Claude Code pushes live rate_limits on every refresh (makes /usage rings update in real time without needing the proxy)",
-          "name": "statusline-usage",
+        "all": {
+          "description": "Every project",
+          "name": "all",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hooks:install",
+      "id": "experiments:list",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -1914,27 +1823,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "hooks",
-        "install.js"
+        "experiments",
+        "list.js"
       ]
     },
-    "hooks:run": {
+    "experiments:reuse": {
       "aliases": [],
       "args": {
-        "hook": {
-          "description": "Hook name to run",
-          "name": "hook",
-          "options": [
-            "session-start",
-            "session-end",
-            "user-prompt",
-            "post-tool-use",
-            "assistant-response"
-          ],
+        "id": {
+          "description": "Completed source experiment UUID",
+          "name": "id",
           "required": true
         }
       },
-      "description": "Execute a hook script (called by AI tool hooks, not for direct use)",
+      "description": "Run selected previously measured fixture tasks with a new bounded exploratory budget",
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -1944,18 +1846,222 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hidden": true,
-      "hiddenAliases": [],
-      "id": "hooks:run",
-      "pluginAlias": "@rulemetric/cli",
-      "pluginName": "@rulemetric/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
+        },
+        "task": {
+          "description": "Source task ID to reuse (repeat for multiple tasks)",
+          "name": "task",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "reason": {
+          "description": "Why this additional exploratory execution is useful (at least 20 characters)",
+          "name": "reason",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "request-id": {
+          "description": "Explicit UUID for a new budget; identical arguments otherwise recover the same request",
+          "name": "request-id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "experiments:reuse",
+      "pluginAlias": "@rulemetric/cli",
+      "pluginName": "@rulemetric/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "experiments",
+        "reuse.js"
+      ]
+    },
+    "gateway:ensure": {
+      "aliases": [],
+      "args": {},
+      "description": "Ensure the gateway proxy is running (called by hooks, not for direct use)",
+      "flags": {
+        "api-url": {
+          "description": "Override API base URL",
+          "env": "RULEMETRIC_API_URL",
+          "hidden": true,
+          "name": "api-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hidden": true,
+      "hiddenAliases": [],
+      "id": "gateway:ensure",
+      "pluginAlias": "@rulemetric/cli",
+      "pluginName": "@rulemetric/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "gateway",
+        "ensure.js"
+      ]
+    },
+    "hooks:emit-instructions": {
+      "aliases": [],
+      "args": {},
+      "description": "Print a synthetic instruction snapshot (on-disk instruction files) as JSON for zero-proxy instruction linking",
+      "flags": {
+        "project-dir": {
+          "description": "Project directory to scan (defaults to cwd)",
+          "name": "project-dir",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "tool": {
+          "description": "Hook tool id whose instruction files to read (claude_code, codex, copilot_agent, copilot_cli, vscode_copilot)",
+          "name": "tool",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hidden": true,
+      "hiddenAliases": [],
+      "id": "hooks:emit-instructions",
+      "pluginAlias": "@rulemetric/cli",
+      "pluginName": "@rulemetric/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "hooks",
+        "emit-instructions.js"
+      ]
+    },
+    "hooks:install": {
+      "aliases": [],
+      "args": {},
+      "description": "Install session tracking hooks and context capture proxy for Claude Code",
+      "examples": [
+        "<%= config.bin %> hooks install",
+        "<%= config.bin %> hooks install --global",
+        "<%= config.bin %> hooks install --no-proxy"
+      ],
+      "flags": {
+        "api-url": {
+          "description": "Override API base URL",
+          "env": "RULEMETRIC_API_URL",
+          "hidden": true,
+          "name": "api-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "no-proxy": {
+          "description": "Skip proxy/gateway configuration (hooks only)",
+          "name": "no-proxy",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "project-dir": {
+          "description": "Project directory to install hooks in (defaults to cwd)",
+          "name": "project-dir",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "user-hooks": {
+          "description": "Write user-level Cursor/Antigravity hooks (~/.cursor, ~/.gemini). Required for Cursor capture — its traffic bypasses the proxy.",
+          "name": "user-hooks",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "global": {
+          "char": "g",
+          "description": "Install hooks globally (~/.claude/settings.json) so all projects are tracked",
+          "name": "global",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "statusline-usage": {
+          "description": "Install the statusline shim so Claude Code pushes live rate_limits on every refresh (makes /usage rings update in real time without needing the proxy)",
+          "name": "statusline-usage",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "hooks:install",
+      "pluginAlias": "@rulemetric/cli",
+      "pluginName": "@rulemetric/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "hooks",
+        "install.js"
+      ]
+    },
+    "hooks:run": {
+      "aliases": [],
+      "args": {
+        "hook": {
+          "description": "Hook name to run",
+          "name": "hook",
+          "options": [
+            "session-start",
+            "session-end",
+            "user-prompt",
+            "post-tool-use",
+            "assistant-response"
+          ],
+          "required": true
+        }
+      },
+      "description": "Execute a hook script (called by AI tool hooks, not for direct use)",
+      "flags": {
+        "api-url": {
+          "description": "Override API base URL",
+          "env": "RULEMETRIC_API_URL",
+          "hidden": true,
+          "name": "api-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hidden": true,
+      "hiddenAliases": [],
+      "id": "hooks:run",
+      "pluginAlias": "@rulemetric/cli",
+      "pluginName": "@rulemetric/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
       "relativePath": [
         "dist",
         "commands",
@@ -2668,10 +2774,13 @@
         "versions.js"
       ]
     },
-    "local:down": {
+    "org:current": {
       "aliases": [],
       "args": {},
-      "description": "Stop the local RuleMetric server and database stack. Data is preserved (restart with `rulemetric local up`); use --delete-data to also wipe the local database.",
+      "description": "Show the current active organization",
+      "examples": [
+        "<%= config.bin %> org current"
+      ],
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -2681,17 +2790,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "delete-data": {
-          "description": "Also delete the local database volumes (irreversible)",
-          "name": "delete-data",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "local:down",
+      "id": "org:current",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2701,123 +2804,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "local",
-        "down.js"
+        "org",
+        "current.js"
       ]
     },
-    "local:up": {
+    "org:list": {
       "aliases": [],
       "args": {},
-      "description": "Run RuleMetric fully locally: start a local Supabase stack (Docker), apply migrations, and serve the API + dashboard from the @rulemetric/local runtime — all data on this machine, zero cloud contact. Downloads the runtime package on first run.",
+      "description": "List organizations the current user is a member of",
       "examples": [
-        "<%= config.bin %> local up --email you@example.com --password <pw>",
-        "<%= config.bin %> local up --port 3000",
-        "<%= config.bin %> local up --foreground"
-      ],
-      "flags": {
-        "api-url": {
-          "description": "Override API base URL",
-          "env": "RULEMETRIC_API_URL",
-          "hidden": true,
-          "name": "api-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "port": {
-          "char": "p",
-          "description": "Local API + dashboard port",
-          "name": "port",
-          "default": 3000,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "email": {
-          "char": "e",
-          "description": "Create the first user with this email (with --password)",
-          "name": "email",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "password": {
-          "description": "Password for the first user (min 8 chars)",
-          "name": "password",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "foreground": {
-          "description": "Run the server in this terminal instead of installing a launchd service (works on any OS; skips user provisioning)",
-          "name": "foreground",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "yes": {
-          "char": "y",
-          "description": "Skip the runtime-download confirmation",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "local:up",
-      "pluginAlias": "@rulemetric/cli",
-      "pluginName": "@rulemetric/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "local",
-        "up.js"
-      ]
-    },
-    "org:current": {
-      "aliases": [],
-      "args": {},
-      "description": "Show the current active organization",
-      "examples": [
-        "<%= config.bin %> org current"
-      ],
-      "flags": {
-        "api-url": {
-          "description": "Override API base URL",
-          "env": "RULEMETRIC_API_URL",
-          "hidden": true,
-          "name": "api-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "org:current",
-      "pluginAlias": "@rulemetric/cli",
-      "pluginName": "@rulemetric/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "org",
-        "current.js"
-      ]
-    },
-    "org:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List organizations the current user is a member of",
-      "examples": [
-        "<%= config.bin %> org list"
+        "<%= config.bin %> org list"
       ],
       "flags": {
         "api-url": {
@@ -2893,14 +2889,10 @@
         "switch.js"
       ]
     },
-    "research:backfill": {
+    "local:down": {
       "aliases": [],
       "args": {},
-      "description": "Scan every ~/.claude/projects transcript for past rate-limit (429) events and POST them as observations. Opt-in seed for the usage-research dataset — forward-only tail is the default capture path.",
-      "examples": [
-        "<%= config.bin %> research backfill",
-        "<%= config.bin %> research backfill --claude-dir /custom/.claude --dry-run"
-      ],
+      "description": "Stop the local RuleMetric server and database stack. Data is preserved (restart with `rulemetric local up`); use --delete-data to also wipe the local database.",
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -2911,24 +2903,16 @@
           "multiple": false,
           "type": "option"
         },
-        "claude-dir": {
-          "description": "Override the Claude Code projects directory (defaults to ~/.claude)",
-          "name": "claude-dir",
-          "noCacheDefault": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "dry-run": {
-          "description": "Print observation count without POSTing",
-          "name": "dry-run",
+        "delete-data": {
+          "description": "Also delete the local database volumes (irreversible)",
+          "name": "delete-data",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "research:backfill",
+      "id": "local:down",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2938,17 +2922,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "research",
-        "backfill.js"
+        "local",
+        "down.js"
       ]
     },
-    "research:resume-scoped-outcomes": {
+    "local:up": {
       "aliases": [],
       "args": {},
-      "description": "Finish uploading scoped headless outcomes whose receipt was preserved locally after the actor exited but whose capture or verification upload failed. Never re-runs the actor or re-measures the repository; ships the stored receipt and exact transcript only.",
+      "description": "Run RuleMetric fully locally: start a local Supabase stack (Docker), apply migrations, and serve the API + dashboard from the @rulemetric/local runtime — all data on this machine, zero cloud contact. Downloads the runtime package on first run.",
       "examples": [
-        "<%= config.bin %> research resume-scoped-outcomes",
-        "<%= config.bin %> research resume-scoped-outcomes --list"
+        "<%= config.bin %> local up --email you@example.com --password <pw>",
+        "<%= config.bin %> local up --port 3000",
+        "<%= config.bin %> local up --foreground"
       ],
       "flags": {
         "api-url": {
@@ -2960,61 +2945,47 @@
           "multiple": false,
           "type": "option"
         },
-        "list": {
-          "description": "Show the outcome store without uploading anything",
-          "name": "list",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hidden": true,
-      "hiddenAliases": [],
-      "id": "research:resume-scoped-outcomes",
-      "pluginAlias": "@rulemetric/cli",
-      "pluginName": "@rulemetric/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "research",
-        "resume-scoped-outcomes.js"
-      ]
-    },
-    "research:tail-transcript": {
-      "aliases": [],
-      "args": {
-        "transcript": {
-          "description": "Absolute path to a Claude Code .jsonl transcript",
-          "name": "transcript",
-          "required": true
-        }
-      },
-      "description": "Read new lines from a Claude Code transcript since the last cached offset, POST any 429 events, and persist the new offset. Invoked by the session-end hook — safe to re-run.",
-      "flags": {
-        "api-url": {
-          "description": "Override API base URL",
-          "env": "RULEMETRIC_API_URL",
-          "hidden": true,
-          "name": "api-url",
+        "port": {
+          "char": "p",
+          "description": "Local API + dashboard port",
+          "name": "port",
+          "default": 3000,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "no-post": {
-          "description": "Parse and advance the offset without POSTing (debug)",
-          "name": "no-post",
+        "email": {
+          "char": "e",
+          "description": "Create the first user with this email (with --password)",
+          "name": "email",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "password": {
+          "description": "Password for the first user (min 8 chars)",
+          "name": "password",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "foreground": {
+          "description": "Run the server in this terminal instead of installing a launchd service (works on any OS; skips user provisioning)",
+          "name": "foreground",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Skip the runtime-download confirmation",
+          "name": "yes",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
-      "hidden": true,
       "hiddenAliases": [],
-      "id": "research:tail-transcript",
+      "id": "local:up",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3024,8 +2995,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "research",
-        "tail-transcript.js"
+        "local",
+        "up.js"
       ]
     },
     "packs:add-instruction": {
@@ -3376,15 +3347,13 @@
         "remove-instruction.js"
       ]
     },
-    "proxy:env": {
+    "research:backfill": {
       "aliases": [],
       "args": {},
-      "description": "Print shell env vars to route any client through the RuleMetric proxy",
+      "description": "Scan every ~/.claude/projects transcript for past rate-limit (429) events and POST them as observations. Opt-in seed for the usage-research dataset — forward-only tail is the default capture path.",
       "examples": [
-        "<%= config.bin %> proxy env",
-        "<%= config.bin %> proxy env --shell fish",
-        "eval \"$(rulemetric proxy env)\"",
-        "rulemetric proxy env --python"
+        "<%= config.bin %> research backfill",
+        "<%= config.bin %> research backfill --claude-dir /custom/.claude --dry-run"
       ],
       "flags": {
         "api-url": {
@@ -3396,48 +3365,24 @@
           "multiple": false,
           "type": "option"
         },
-        "shell": {
-          "char": "s",
-          "description": "Shell format (posix, fish, powershell)",
-          "name": "shell",
-          "default": "posix",
+        "claude-dir": {
+          "description": "Override the Claude Code projects directory (defaults to ~/.claude)",
+          "name": "claude-dir",
+          "noCacheDefault": true,
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "posix",
-            "fish",
-            "powershell"
-          ],
           "type": "option"
         },
-        "python": {
-          "description": "Include Python-specific env vars (REQUESTS_CA_BUNDLE, SSL_CERT_FILE)",
-          "name": "python",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "node": {
-          "description": "Include Node.js-specific env vars (NODE_EXTRA_CA_CERTS)",
-          "name": "node",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "all": {
-          "description": "Include env vars for all runtimes",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "vscode": {
-          "description": "Output VS Code settings.json snippet for Copilot proxy",
-          "name": "vscode",
+        "dry-run": {
+          "description": "Print observation count without POSTing",
+          "name": "dry-run",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "proxy:env",
+      "id": "research:backfill",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3447,18 +3392,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "proxy",
-        "env.js"
+        "research",
+        "backfill.js"
       ]
     },
-    "proxy:logs": {
+    "research:resume-scoped-outcomes": {
       "aliases": [],
       "args": {},
-      "description": "View context capture proxy logs",
+      "description": "Finish uploading scoped headless outcomes whose receipt was preserved locally after the actor exited but whose capture or verification upload failed. Never re-runs the actor or re-measures the repository; ships the stored receipt and exact transcript only.",
       "examples": [
-        "<%= config.bin %> proxy logs",
-        "<%= config.bin %> proxy logs --follow",
-        "<%= config.bin %> proxy logs --lines 50"
+        "<%= config.bin %> research resume-scoped-outcomes",
+        "<%= config.bin %> research resume-scoped-outcomes --list"
       ],
       "flags": {
         "api-url": {
@@ -3470,26 +3414,17 @@
           "multiple": false,
           "type": "option"
         },
-        "follow": {
-          "char": "f",
-          "description": "Follow log output (like tail -f)",
-          "name": "follow",
+        "list": {
+          "description": "Show the outcome store without uploading anything",
+          "name": "list",
           "allowNo": false,
           "type": "boolean"
-        },
-        "lines": {
-          "char": "n",
-          "description": "Number of lines to show",
-          "name": "lines",
-          "default": 30,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
+      "hidden": true,
       "hiddenAliases": [],
-      "id": "proxy:logs",
+      "id": "research:resume-scoped-outcomes",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3499,17 +3434,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "proxy",
-        "logs.js"
+        "research",
+        "resume-scoped-outcomes.js"
       ]
     },
-    "proxy:restart": {
+    "research:tail-transcript": {
       "aliases": [],
-      "args": {},
-      "description": "Restart the context capture proxy (stop + start)",
-      "examples": [
-        "<%= config.bin %> proxy restart"
-      ],
+      "args": {
+        "transcript": {
+          "description": "Absolute path to a Claude Code .jsonl transcript",
+          "name": "transcript",
+          "required": true
+        }
+      },
+      "description": "Read new lines from a Claude Code transcript since the last cached offset, POST any 429 events, and persist the new offset. Invoked by the session-end hook — safe to re-run.",
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -3520,25 +3458,17 @@
           "multiple": false,
           "type": "option"
         },
-        "port": {
-          "char": "p",
-          "description": "Proxy listen port",
-          "name": "port",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "docker": {
-          "char": "d",
-          "description": "Run in Docker mode",
-          "name": "docker",
+        "no-post": {
+          "description": "Parse and advance the offset without POSTing (debug)",
+          "name": "no-post",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
+      "hidden": true,
       "hiddenAliases": [],
-      "id": "proxy:restart",
+      "id": "research:tail-transcript",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3548,18 +3478,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "proxy",
-        "restart.js"
+        "research",
+        "tail-transcript.js"
       ]
     },
-    "proxy:setup": {
+    "service:install": {
       "aliases": [],
       "args": {},
-      "description": "Set up context capture proxy (installs mitmproxy, configures shell)",
+      "description": "Install RuleMetric services. Default (in a repo checkout): API + worker + gateway + capture proxy as launchd agents. With --worker-only: just the job worker, targeting the globally-installed CLI — no repo, no build (works from `npm i -g @rulemetric/cli`, macOS launchd or Linux systemd).",
       "examples": [
-        "<%= config.bin %> proxy setup",
-        "<%= config.bin %> proxy setup --shell zsh",
-        "<%= config.bin %> proxy setup --check"
+        "<%= config.bin %> service install",
+        "<%= config.bin %> service install --port 3000",
+        "<%= config.bin %> service install --skip-build",
+        "<%= config.bin %> service install --no-proxy",
+        "<%= config.bin %> service install --worker-only"
       ],
       "flags": {
         "api-url": {
@@ -3571,38 +3503,53 @@
           "multiple": false,
           "type": "option"
         },
-        "shell": {
-          "description": "Shell to configure (auto-detected if omitted)",
-          "name": "shell",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "zsh",
-            "bash",
-            "fish",
-            "powershell"
-          ],
-          "type": "option"
-        },
         "port": {
           "char": "p",
-          "description": "Proxy listen port",
+          "description": "API server port",
           "name": "port",
-          "default": 8787,
+          "default": 3000,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "check": {
-          "description": "Only check prerequisites, do not install anything",
-          "name": "check",
+        "force": {
+          "char": "f",
+          "description": "Overwrite existing service configuration and reclaim conflicting ports",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "skip-build": {
+          "description": "Skip the pre-install workspace build (API/web/cli dist must already exist)",
+          "name": "skip-build",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-proxy": {
+          "description": "Skip gateway + mitmproxy plists (just install API + worker)",
+          "name": "no-proxy",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "auto-update": {
+          "dependsOn": [
+            "worker-only"
+          ],
+          "description": "Opt this machine into automatic stable CLI updates after active worker jobs finish (requires --worker-only)",
+          "name": "auto-update",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "worker-only": {
+          "description": "Install ONLY the job worker as a persistent service, targeting the globally-installed CLI (no repo checkout, no build, no API/gateway/proxy). Sources auth from ~/.config/rulemetric/env. macOS (launchd) + Linux (systemd --user).",
+          "name": "worker-only",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "proxy:setup",
+      "id": "service:install",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3612,20 +3559,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "proxy",
-        "setup.js"
+        "service",
+        "install.js"
       ]
     },
-    "proxy:start": {
+    "service:status": {
       "aliases": [],
       "args": {},
-      "description": "Start context capture proxy",
-      "examples": [
-        "<%= config.bin %> proxy start",
-        "<%= config.bin %> proxy start --docker",
-        "<%= config.bin %> proxy start --port 9090",
-        "<%= config.bin %> proxy start --web"
-      ],
+      "description": "Check the status of installed RuleMetric services (launchd on macOS; systemd --user worker on Linux)",
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -3635,45 +3576,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "port": {
-          "char": "p",
-          "description": "Proxy listen port",
-          "name": "port",
-          "default": 8788,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "docker": {
-          "char": "d",
-          "description": "Run proxy in Docker (no local mitmproxy needed)",
-          "name": "docker",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "web": {
-          "description": "Launch mitmweb debug UI instead of mitmdump (local mode only)",
-          "name": "web",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "skip-checks": {
-          "description": "Skip prerequisite checks",
-          "name": "skip-checks",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "build": {
-          "description": "Force rebuild Docker image",
-          "name": "build",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "proxy:start",
+      "id": "service:status",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3683,17 +3590,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "proxy",
-        "start.js"
+        "service",
+        "status.js"
       ]
     },
-    "proxy:status": {
+    "service:uninstall": {
       "aliases": [],
       "args": {},
-      "description": "Check gateway and context capture proxy status",
-      "examples": [
-        "<%= config.bin %> proxy status"
-      ],
+      "description": "Remove RuleMetric services (macOS launchd: API/worker/gateway/proxy; Linux: the --worker-only systemd unit)",
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -3707,7 +3611,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "proxy:status",
+      "id": "service:uninstall",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3717,16 +3621,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "proxy",
-        "status.js"
+        "service",
+        "uninstall.js"
       ]
     },
-    "proxy:stop": {
+    "service:updates": {
       "aliases": [],
       "args": {},
-      "description": "Stop the context capture proxy",
+      "description": "Show or change automatic worker updates on this machine (off by default)",
       "examples": [
-        "<%= config.bin %> proxy stop"
+        "<%= config.bin %> service updates",
+        "<%= config.bin %> service updates --enable",
+        "<%= config.bin %> service updates --disable"
       ],
       "flags": {
         "api-url": {
@@ -3737,11 +3643,29 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "enable": {
+          "description": "Install stable npm releases automatically after active jobs finish",
+          "exclusive": [
+            "disable"
+          ],
+          "name": "enable",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "disable": {
+          "description": "Stop future automatic updates",
+          "exclusive": [
+            "enable"
+          ],
+          "name": "disable",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "proxy:stop",
+      "id": "service:updates",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3751,20 +3675,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "proxy",
-        "stop.js"
+        "service",
+        "updates.js"
       ]
     },
-    "service:install": {
+    "proxy:env": {
       "aliases": [],
       "args": {},
-      "description": "Install RuleMetric services. Default (in a repo checkout): API + worker + gateway + capture proxy as launchd agents. With --worker-only: just the job worker, targeting the globally-installed CLI — no repo, no build (works from `npm i -g @rulemetric/cli`, macOS launchd or Linux systemd).",
+      "description": "Print shell env vars to route any client through the RuleMetric proxy",
       "examples": [
-        "<%= config.bin %> service install",
-        "<%= config.bin %> service install --port 3000",
-        "<%= config.bin %> service install --skip-build",
-        "<%= config.bin %> service install --no-proxy",
-        "<%= config.bin %> service install --worker-only"
+        "<%= config.bin %> proxy env",
+        "<%= config.bin %> proxy env --shell fish",
+        "eval \"$(rulemetric proxy env)\"",
+        "rulemetric proxy env --python"
       ],
       "flags": {
         "api-url": {
@@ -3776,53 +3699,48 @@
           "multiple": false,
           "type": "option"
         },
-        "port": {
-          "char": "p",
-          "description": "API server port",
-          "name": "port",
-          "default": 3000,
+        "shell": {
+          "char": "s",
+          "description": "Shell format (posix, fish, powershell)",
+          "name": "shell",
+          "default": "posix",
           "hasDynamicHelp": false,
           "multiple": false,
-          "type": "option"
-        },
-        "force": {
-          "char": "f",
-          "description": "Overwrite existing service configuration and reclaim conflicting ports",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
+          "options": [
+            "posix",
+            "fish",
+            "powershell"
+          ],
+          "type": "option"
         },
-        "skip-build": {
-          "description": "Skip the pre-install workspace build (API/web/cli dist must already exist)",
-          "name": "skip-build",
+        "python": {
+          "description": "Include Python-specific env vars (REQUESTS_CA_BUNDLE, SSL_CERT_FILE)",
+          "name": "python",
           "allowNo": false,
           "type": "boolean"
         },
-        "no-proxy": {
-          "description": "Skip gateway + mitmproxy plists (just install API + worker)",
-          "name": "no-proxy",
+        "node": {
+          "description": "Include Node.js-specific env vars (NODE_EXTRA_CA_CERTS)",
+          "name": "node",
           "allowNo": false,
           "type": "boolean"
         },
-        "auto-update": {
-          "dependsOn": [
-            "worker-only"
-          ],
-          "description": "Opt this machine into automatic stable CLI updates after active worker jobs finish (requires --worker-only)",
-          "name": "auto-update",
+        "all": {
+          "description": "Include env vars for all runtimes",
+          "name": "all",
           "allowNo": false,
           "type": "boolean"
         },
-        "worker-only": {
-          "description": "Install ONLY the job worker as a persistent service, targeting the globally-installed CLI (no repo checkout, no build, no API/gateway/proxy). Sources auth from ~/.config/rulemetric/env. macOS (launchd) + Linux (systemd --user).",
-          "name": "worker-only",
+        "vscode": {
+          "description": "Output VS Code settings.json snippet for Copilot proxy",
+          "name": "vscode",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "service:install",
+      "id": "proxy:env",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3832,14 +3750,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "service",
-        "install.js"
+        "proxy",
+        "env.js"
       ]
     },
-    "service:status": {
+    "proxy:logs": {
       "aliases": [],
       "args": {},
-      "description": "Check the status of installed RuleMetric services (launchd on macOS; systemd --user worker on Linux)",
+      "description": "View context capture proxy logs",
+      "examples": [
+        "<%= config.bin %> proxy logs",
+        "<%= config.bin %> proxy logs --follow",
+        "<%= config.bin %> proxy logs --lines 50"
+      ],
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -3849,11 +3772,27 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "follow": {
+          "char": "f",
+          "description": "Follow log output (like tail -f)",
+          "name": "follow",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "lines": {
+          "char": "n",
+          "description": "Number of lines to show",
+          "name": "lines",
+          "default": 30,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "service:status",
+      "id": "proxy:logs",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3863,14 +3802,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "service",
-        "status.js"
+        "proxy",
+        "logs.js"
       ]
     },
-    "service:uninstall": {
+    "proxy:restart": {
       "aliases": [],
       "args": {},
-      "description": "Remove RuleMetric services (macOS launchd: API/worker/gateway/proxy; Linux: the --worker-only systemd unit)",
+      "description": "Restart the context capture proxy (stop + start)",
+      "examples": [
+        "<%= config.bin %> proxy restart"
+      ],
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -3880,11 +3822,26 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "port": {
+          "char": "p",
+          "description": "Proxy listen port",
+          "name": "port",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "docker": {
+          "char": "d",
+          "description": "Run in Docker mode",
+          "name": "docker",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "service:uninstall",
+      "id": "proxy:restart",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3894,18 +3851,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "service",
-        "uninstall.js"
+        "proxy",
+        "restart.js"
       ]
     },
-    "service:updates": {
+    "proxy:setup": {
       "aliases": [],
       "args": {},
-      "description": "Show or change automatic worker updates on this machine (off by default)",
+      "description": "Set up context capture proxy (installs mitmproxy, configures shell)",
       "examples": [
-        "<%= config.bin %> service updates",
-        "<%= config.bin %> service updates --enable",
-        "<%= config.bin %> service updates --disable"
+        "<%= config.bin %> proxy setup",
+        "<%= config.bin %> proxy setup --shell zsh",
+        "<%= config.bin %> proxy setup --check"
       ],
       "flags": {
         "api-url": {
@@ -3917,28 +3874,38 @@
           "multiple": false,
           "type": "option"
         },
-        "enable": {
-          "description": "Install stable npm releases automatically after active jobs finish",
-          "exclusive": [
-            "disable"
+        "shell": {
+          "description": "Shell to configure (auto-detected if omitted)",
+          "name": "shell",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "zsh",
+            "bash",
+            "fish",
+            "powershell"
           ],
-          "name": "enable",
-          "allowNo": false,
-          "type": "boolean"
+          "type": "option"
         },
-        "disable": {
-          "description": "Stop future automatic updates",
-          "exclusive": [
-            "enable"
-          ],
-          "name": "disable",
+        "port": {
+          "char": "p",
+          "description": "Proxy listen port",
+          "name": "port",
+          "default": 8787,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "check": {
+          "description": "Only check prerequisites, do not install anything",
+          "name": "check",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "service:updates",
+      "id": "proxy:setup",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3948,22 +3915,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "service",
-        "updates.js"
+        "proxy",
+        "setup.js"
       ]
     },
-    "sessions:analyze": {
+    "proxy:start": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Session ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Trigger AI analysis on a session",
+      "args": {},
+      "description": "Start context capture proxy",
       "examples": [
-        "<%= config.bin %> sessions analyze <session-id>"
+        "<%= config.bin %> proxy start",
+        "<%= config.bin %> proxy start --docker",
+        "<%= config.bin %> proxy start --port 9090",
+        "<%= config.bin %> proxy start --web"
       ],
       "flags": {
         "api-url": {
@@ -3974,11 +3938,45 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "port": {
+          "char": "p",
+          "description": "Proxy listen port",
+          "name": "port",
+          "default": 8788,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "docker": {
+          "char": "d",
+          "description": "Run proxy in Docker (no local mitmproxy needed)",
+          "name": "docker",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "web": {
+          "description": "Launch mitmweb debug UI instead of mitmdump (local mode only)",
+          "name": "web",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "skip-checks": {
+          "description": "Skip prerequisite checks",
+          "name": "skip-checks",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "build": {
+          "description": "Force rebuild Docker image",
+          "name": "build",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sessions:analyze",
+      "id": "proxy:start",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3988,24 +3986,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "sessions",
-        "analyze.js"
+        "proxy",
+        "start.js"
       ]
     },
-    "sessions:delete": {
+    "proxy:status": {
       "aliases": [],
-      "args": {
-        "ids": {
-          "description": "Session id(s) to delete",
-          "name": "ids",
-          "required": false
-        }
-      },
-      "description": "Permanently delete captured sessions and everything stored with them (events, context snapshots, offloaded blobs)",
+      "args": {},
+      "description": "Check gateway and context capture proxy status",
       "examples": [
-        "<%= config.bin %> sessions delete 4f9d…",
-        "<%= config.bin %> sessions delete 4f9d… 8a21…",
-        "<%= config.bin %> sessions delete --project /work/client-a --yes"
+        "<%= config.bin %> proxy status"
       ],
       "flags": {
         "api-url": {
@@ -4016,43 +4006,30 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "project": {
-          "description": "Delete every session captured under this project path (use with --yes).",
-          "name": "project",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "yes": {
-          "description": "Skip the confirmation prompt. Required for --project in non-interactive use.",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sessions:delete",
+      "id": "proxy:status",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
-      "strict": false,
+      "strict": true,
       "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "sessions",
-        "delete.js"
+        "proxy",
+        "status.js"
       ]
     },
-    "sessions:end": {
+    "proxy:stop": {
       "aliases": [],
       "args": {},
-      "description": "End the active capture session",
+      "description": "Stop the context capture proxy",
       "examples": [
-        "<%= config.bin %> sessions end"
+        "<%= config.bin %> proxy stop"
       ],
       "flags": {
         "api-url": {
@@ -4067,7 +4044,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sessions:end",
+      "id": "proxy:stop",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -4077,160 +4054,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "sessions",
-        "end.js"
-      ]
-    },
-    "sessions:import": {
-      "aliases": [],
-      "args": {
-        "path": {
-          "description": "Path to session file",
-          "name": "path",
-          "required": true
-        }
-      },
-      "description": "Import a session file (JSONL, JSON)",
-      "examples": [
-        "<%= config.bin %> sessions import ~/.claude/projects/my-project/session-abc.jsonl",
-        "<%= config.bin %> sessions import ./copilot-export.json --tool vscode_copilot"
-      ],
-      "flags": {
-        "api-url": {
-          "description": "Override API base URL",
-          "env": "RULEMETRIC_API_URL",
-          "hidden": true,
-          "name": "api-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "tool": {
-          "description": "Override tool detection (claude_code, cursor, vscode_copilot)",
-          "name": "tool",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "sessions:import",
-      "pluginAlias": "@rulemetric/cli",
-      "pluginName": "@rulemetric/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "sessions",
-        "import.js"
-      ]
-    },
-    "sessions:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List captured sessions",
-      "examples": [
-        "<%= config.bin %> sessions list",
-        "<%= config.bin %> sessions list --tool claude_code",
-        "<%= config.bin %> sessions list --tool codex"
-      ],
-      "flags": {
-        "api-url": {
-          "description": "Override API base URL",
-          "env": "RULEMETRIC_API_URL",
-          "hidden": true,
-          "name": "api-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "tool": {
-          "description": "Filter by tool (claude_code, cursor, vscode_copilot, copilot_agent, rulemetric_mcp, codex, pi, opencode, antigravity)",
-          "name": "tool",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "limit": {
-          "description": "Max results",
-          "name": "limit",
-          "default": 20,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "sessions:list",
-      "pluginAlias": "@rulemetric/cli",
-      "pluginName": "@rulemetric/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "sessions",
-        "list.js"
-      ]
-    },
-    "sessions:start": {
-      "aliases": [],
-      "args": {},
-      "description": "Start a capture session for any LLM provider (Cortex, Groq, etc.)",
-      "examples": [
-        "<%= config.bin %> sessions start --tool cortex",
-        "<%= config.bin %> sessions start --tool groq --project-dir /path/to/project",
-        "eval \"$(rulemetric proxy env --python)\" && rulemetric sessions start --tool cortex"
-      ],
-      "flags": {
-        "api-url": {
-          "description": "Override API base URL",
-          "env": "RULEMETRIC_API_URL",
-          "hidden": true,
-          "name": "api-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "tool": {
-          "char": "t",
-          "description": "LLM provider or tool name (e.g., cortex, groq, deepseek, custom_app)",
-          "name": "tool",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "project-dir": {
-          "char": "d",
-          "description": "Project directory (defaults to cwd)",
-          "name": "project-dir",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "sessions:start",
-      "pluginAlias": "@rulemetric/cli",
-      "pluginName": "@rulemetric/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "sessions",
-        "start.js"
+        "proxy",
+        "stop.js"
       ]
     },
     "skills:export-approved": {
@@ -4638,6 +4463,287 @@
         "update.js"
       ]
     },
+    "sessions:analyze": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Session ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Trigger AI analysis on a session",
+      "examples": [
+        "<%= config.bin %> sessions analyze <session-id>"
+      ],
+      "flags": {
+        "api-url": {
+          "description": "Override API base URL",
+          "env": "RULEMETRIC_API_URL",
+          "hidden": true,
+          "name": "api-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "sessions:analyze",
+      "pluginAlias": "@rulemetric/cli",
+      "pluginName": "@rulemetric/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "sessions",
+        "analyze.js"
+      ]
+    },
+    "sessions:delete": {
+      "aliases": [],
+      "args": {
+        "ids": {
+          "description": "Session id(s) to delete",
+          "name": "ids",
+          "required": false
+        }
+      },
+      "description": "Permanently delete captured sessions and everything stored with them (events, context snapshots, offloaded blobs)",
+      "examples": [
+        "<%= config.bin %> sessions delete 4f9d…",
+        "<%= config.bin %> sessions delete 4f9d… 8a21…",
+        "<%= config.bin %> sessions delete --project /work/client-a --yes"
+      ],
+      "flags": {
+        "api-url": {
+          "description": "Override API base URL",
+          "env": "RULEMETRIC_API_URL",
+          "hidden": true,
+          "name": "api-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "project": {
+          "description": "Delete every session captured under this project path (use with --yes).",
+          "name": "project",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "yes": {
+          "description": "Skip the confirmation prompt. Required for --project in non-interactive use.",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "sessions:delete",
+      "pluginAlias": "@rulemetric/cli",
+      "pluginName": "@rulemetric/cli",
+      "pluginType": "core",
+      "strict": false,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "sessions",
+        "delete.js"
+      ]
+    },
+    "sessions:end": {
+      "aliases": [],
+      "args": {},
+      "description": "End the active capture session",
+      "examples": [
+        "<%= config.bin %> sessions end"
+      ],
+      "flags": {
+        "api-url": {
+          "description": "Override API base URL",
+          "env": "RULEMETRIC_API_URL",
+          "hidden": true,
+          "name": "api-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "sessions:end",
+      "pluginAlias": "@rulemetric/cli",
+      "pluginName": "@rulemetric/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "sessions",
+        "end.js"
+      ]
+    },
+    "sessions:import": {
+      "aliases": [],
+      "args": {
+        "path": {
+          "description": "Path to session file",
+          "name": "path",
+          "required": true
+        }
+      },
+      "description": "Import a session file (JSONL, JSON)",
+      "examples": [
+        "<%= config.bin %> sessions import ~/.claude/projects/my-project/session-abc.jsonl",
+        "<%= config.bin %> sessions import ./copilot-export.json --tool vscode_copilot"
+      ],
+      "flags": {
+        "api-url": {
+          "description": "Override API base URL",
+          "env": "RULEMETRIC_API_URL",
+          "hidden": true,
+          "name": "api-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "tool": {
+          "description": "Override tool detection (claude_code, cursor, vscode_copilot)",
+          "name": "tool",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "sessions:import",
+      "pluginAlias": "@rulemetric/cli",
+      "pluginName": "@rulemetric/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "sessions",
+        "import.js"
+      ]
+    },
+    "sessions:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List captured sessions",
+      "examples": [
+        "<%= config.bin %> sessions list",
+        "<%= config.bin %> sessions list --tool claude_code",
+        "<%= config.bin %> sessions list --tool codex"
+      ],
+      "flags": {
+        "api-url": {
+          "description": "Override API base URL",
+          "env": "RULEMETRIC_API_URL",
+          "hidden": true,
+          "name": "api-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "tool": {
+          "description": "Filter by tool (claude_code, cursor, vscode_copilot, copilot_agent, rulemetric_mcp, codex, pi, opencode, antigravity)",
+          "name": "tool",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "limit": {
+          "description": "Max results",
+          "name": "limit",
+          "default": 20,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "sessions:list",
+      "pluginAlias": "@rulemetric/cli",
+      "pluginName": "@rulemetric/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "sessions",
+        "list.js"
+      ]
+    },
+    "sessions:start": {
+      "aliases": [],
+      "args": {},
+      "description": "Start a capture session for any LLM provider (Cortex, Groq, etc.)",
+      "examples": [
+        "<%= config.bin %> sessions start --tool cortex",
+        "<%= config.bin %> sessions start --tool groq --project-dir /path/to/project",
+        "eval \"$(rulemetric proxy env --python)\" && rulemetric sessions start --tool cortex"
+      ],
+      "flags": {
+        "api-url": {
+          "description": "Override API base URL",
+          "env": "RULEMETRIC_API_URL",
+          "hidden": true,
+          "name": "api-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "tool": {
+          "char": "t",
+          "description": "LLM provider or tool name (e.g., cortex, groq, deepseek, custom_app)",
+          "name": "tool",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "project-dir": {
+          "char": "d",
+          "description": "Project directory (defaults to cwd)",
+          "name": "project-dir",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "sessions:start",
+      "pluginAlias": "@rulemetric/cli",
+      "pluginName": "@rulemetric/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "sessions",
+        "start.js"
+      ]
+    },
     "suggestions:accept": {
       "aliases": [],
       "args": {
@@ -4938,5 +5044,5 @@
       ]
     }
   },
-  "version": "0.19.1"
+  "version": "0.21.0"
 }