@rulemetric/cli 0.3.0 → 0.4.0

package/oclif.manifest.json

@@ -1458,6 +1458,36 @@
         "ensure.js"
       ]
     },
+    "hooks:emit-instructions": {
+      "aliases": [],
+      "args": {},
+      "description": "Print a synthetic instruction snapshot (on-disk CLAUDE.md) 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"
+        }
+      },
+      "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": {},
@@ -1599,18 +1629,12 @@
         "uninstall.js"
       ]
     },
-    "instructions:create": {
+    "org:current": {
       "aliases": [],
-      "args": {
-        "file": {
-          "description": "Path to markdown file",
-          "name": "file"
-        }
-      },
-      "description": "Create a new instruction",
+      "args": {},
+      "description": "Show the current active organization",
       "examples": [
-        "<%= config.bin %> instructions create ./my-instruction.md --name \"My Rules\"",
-        "<%= config.bin %> instructions create ./rules.md -n \"Rules\" -s project"
+        "<%= config.bin %> org current"
       ],
       "flags": {
         "api-url": {
@@ -1621,59 +1645,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "name": {
-          "char": "n",
-          "description": "Instruction name",
-          "name": "name",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "description": {
-          "char": "d",
-          "description": "Instruction description",
-          "name": "description",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "scope": {
-          "char": "s",
-          "description": "Instruction scope",
-          "name": "scope",
-          "default": "personal",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "org",
-            "team",
-            "project",
-            "personal"
-          ],
-          "type": "option"
-        },
-        "scope-ref": {
-          "description": "Scope reference UUID",
-          "name": "scope-ref",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "tags": {
-          "char": "t",
-          "description": "Comma-separated tags",
-          "name": "tags",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "instructions:create",
+      "id": "org:current",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -1683,23 +1659,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "instructions",
-        "create.js"
+        "org",
+        "current.js"
       ]
     },
-    "instructions:delete": {
+    "org:list": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Instruction ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Delete (archive) an instruction",
+      "args": {},
+      "description": "List organizations the current user is a member of",
       "examples": [
-        "<%= config.bin %> instructions delete <id>",
-        "<%= config.bin %> instructions delete <id> --force"
+        "<%= config.bin %> org list"
       ],
       "flags": {
         "api-url": {
@@ -1710,18 +1679,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "force": {
-          "char": "f",
-          "description": "Skip confirmation prompt",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "instructions:delete",
+      "id": "org:list",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -1731,22 +1693,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "instructions",
-        "delete.js"
+        "org",
+        "list.js"
       ]
     },
-    "instructions:fork": {
+    "org:switch": {
       "aliases": [],
       "args": {
-        "id": {
-          "description": "ID of the instruction to fork",
-          "name": "id",
-          "required": true
+        "slug": {
+          "description": "Organization slug to switch to",
+          "name": "slug",
+          "required": false
         }
       },
-      "description": "Fork an instruction to your personal scope",
+      "description": "Switch the active organization",
       "examples": [
-        "<%= config.bin %> instructions fork <instruction-id>"
+        "<%= config.bin %> org switch acme",
+        "<%= config.bin %> org switch --clear"
       ],
       "flags": {
         "api-url": {
@@ -1757,11 +1720,17 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "clear": {
+          "description": "Clear the active organization (personal mode)",
+          "name": "clear",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "instructions:fork",
+      "id": "org:switch",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -1771,32 +1740,29 @@
       "relativePath": [
         "dist",
         "commands",
-        "instructions",
-        "fork.js"
+        "org",
+        "switch.js"
       ]
     },
-    "instructions:get": {
+    "packs:add-instruction": {
       "aliases": [],
       "args": {
-        "id": {
+        "packId": {
+          "description": "Pack ID",
+          "name": "packId",
+          "required": true
+        },
+        "instructionId": {
           "description": "Instruction ID",
-          "name": "id",
+          "name": "instructionId",
           "required": true
         }
       },
-      "description": "Get an instruction by ID",
+      "description": "Add an instruction to a pack",
       "examples": [
-        "<%= config.bin %> instructions get <id>",
-        "<%= config.bin %> instructions get <id> --format raw"
+        "<%= config.bin %> packs add-instruction <pack-id> <instruction-id>"
       ],
       "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "api-url": {
           "description": "Override API base URL",
           "env": "RULEMETRIC_API_URL",
@@ -1805,54 +1771,38 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "format": {
-          "char": "f",
-          "description": "Output format",
-          "name": "format",
-          "default": "yaml",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "yaml",
-            "json",
-            "raw"
-          ],
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "instructions:get",
+      "id": "packs:add-instruction",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
+      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "instructions",
-        "get.js"
+        "packs",
+        "add-instruction.js"
       ]
     },
-    "instructions:list": {
+    "packs:apply": {
       "aliases": [],
-      "args": {},
-      "description": "List your instructions",
+      "args": {
+        "id": {
+          "description": "Pack ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Apply a pack to a project (bulk-link all instructions)",
       "examples": [
-        "<%= config.bin %> instructions list",
-        "<%= config.bin %> instructions list --json"
+        "<%= config.bin %> packs apply <pack-id> --project <project-id>"
       ],
       "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "api-url": {
           "description": "Override API base URL",
           "env": "RULEMETRIC_API_URL",
@@ -1862,49 +1812,38 @@
           "multiple": false,
           "type": "option"
         },
-        "format": {
-          "char": "f",
-          "description": "Output format",
-          "name": "format",
-          "default": "table",
+        "project": {
+          "char": "p",
+          "description": "Project ID",
+          "name": "project",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "table",
-            "json"
-          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "instructions:list",
+      "id": "packs:apply",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
+      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "instructions",
-        "list.js"
+        "packs",
+        "apply.js"
       ]
     },
-    "instructions:promote": {
+    "packs:create": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "ID of the instruction to promote",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Promote an instruction to a higher scope (personal → team → org)",
+      "args": {},
+      "description": "Create a new instruction pack",
       "examples": [
-        "<%= config.bin %> instructions promote <id> --scope team --ref <team-id>",
-        "<%= config.bin %> instructions promote <id> --scope org --ref <org-id>"
+        "<%= config.bin %> packs create --name \"Security Pack\" --description \"Security-focused instructions\""
       ],
       "flags": {
         "api-url": {
@@ -1916,22 +1855,42 @@
           "multiple": false,
           "type": "option"
         },
-        "scope": {
-          "description": "Target scope",
-          "name": "scope",
-          "required": true,
+        "name": {
+          "char": "n",
+          "description": "Pack name",
+          "name": "name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "char": "d",
+          "description": "Pack description",
+          "name": "description",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "scope": {
+          "char": "s",
+          "description": "Pack scope",
+          "name": "scope",
+          "default": "personal",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
+            "org",
             "team",
-            "org"
+            "personal"
           ],
           "type": "option"
         },
-        "ref": {
-          "description": "Target scope ref (team or org ID)",
-          "name": "ref",
-          "required": true,
+        "tags": {
+          "char": "t",
+          "description": "Comma-separated tags",
+          "name": "tags",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1939,7 +1898,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "instructions:promote",
+      "id": "packs:create",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -1949,20 +1908,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "instructions",
-        "promote.js"
+        "packs",
+        "create.js"
       ]
     },
-    "instructions:pull": {
+    "packs:fork": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "ID of the forked instruction",
+          "description": "ID of the pack to fork",
           "name": "id",
           "required": true
         }
       },
-      "description": "Pull upstream changes into a forked instruction",
+      "description": "Fork a pack to your personal scope",
+      "examples": [
+        "<%= config.bin %> packs fork <pack-id>"
+      ],
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -1976,7 +1938,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "instructions:pull",
+      "id": "packs:fork",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -1986,20 +1948,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "instructions",
-        "pull.js"
+        "packs",
+        "fork.js"
       ]
     },
-    "instructions:upstream": {
+    "packs:get": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "ID of the forked instruction",
+          "description": "Pack ID",
           "name": "id",
           "required": true
         }
       },
-      "description": "Check if a forked instruction has upstream updates",
+      "description": "Get pack detail with instruction list",
+      "examples": [
+        "<%= config.bin %> packs get <pack-id>"
+      ],
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -2013,7 +1978,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "instructions:upstream",
+      "id": "packs:get",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2023,22 +1988,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "instructions",
-        "upstream.js"
+        "packs",
+        "get.js"
       ]
     },
-    "instructions:versions": {
+    "packs:list": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Instruction ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "List version history for an instruction",
+      "args": {},
+      "description": "List your instruction packs",
       "examples": [
-        "<%= config.bin %> instructions versions <id>"
+        "<%= config.bin %> packs list",
+        "<%= config.bin %> packs list --json"
       ],
       "flags": {
         "json": {
@@ -2056,11 +2016,24 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "format": {
+          "char": "f",
+          "description": "Output format",
+          "name": "format",
+          "default": "table",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "table",
+            "json"
+          ],
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "instructions:versions",
+      "id": "packs:list",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2070,16 +2043,27 @@
       "relativePath": [
         "dist",
         "commands",
-        "instructions",
-        "versions.js"
+        "packs",
+        "list.js"
       ]
     },
-    "org:current": {
+    "packs:remove-instruction": {
       "aliases": [],
-      "args": {},
-      "description": "Show the current active organization",
+      "args": {
+        "packId": {
+          "description": "Pack ID",
+          "name": "packId",
+          "required": true
+        },
+        "instructionId": {
+          "description": "Instruction ID",
+          "name": "instructionId",
+          "required": true
+        }
+      },
+      "description": "Remove an instruction from a pack",
       "examples": [
-        "<%= config.bin %> org current"
+        "<%= config.bin %> packs remove-instruction <pack-id> <instruction-id>"
       ],
       "flags": {
         "api-url": {
@@ -2094,7 +2078,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "org:current",
+      "id": "packs:remove-instruction",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2104,16 +2088,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "org",
-        "current.js"
+        "packs",
+        "remove-instruction.js"
       ]
     },
-    "org:list": {
+    "proxy:env": {
       "aliases": [],
       "args": {},
-      "description": "List organizations the current user is a member of",
+      "description": "Print shell env vars to route any client through the RuleMetric proxy",
       "examples": [
-        "<%= config.bin %> org list"
+        "<%= config.bin %> proxy env",
+        "<%= config.bin %> proxy env --shell fish",
+        "eval \"$(rulemetric proxy env)\"",
+        "rulemetric proxy env --python"
       ],
       "flags": {
         "api-url": {
@@ -2124,11 +2111,49 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "shell": {
+          "char": "s",
+          "description": "Shell format (posix, fish, powershell)",
+          "name": "shell",
+          "default": "posix",
+          "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",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "org:list",
+      "id": "proxy:env",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2138,23 +2163,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "org",
-        "list.js"
+        "proxy",
+        "env.js"
       ]
     },
-    "org:switch": {
+    "proxy:logs": {
       "aliases": [],
-      "args": {
-        "slug": {
-          "description": "Organization slug to switch to",
-          "name": "slug",
-          "required": false
-        }
-      },
-      "description": "Switch the active organization",
+      "args": {},
+      "description": "View context capture proxy logs",
       "examples": [
-        "<%= config.bin %> org switch acme",
-        "<%= config.bin %> org switch --clear"
+        "<%= config.bin %> proxy logs",
+        "<%= config.bin %> proxy logs --follow",
+        "<%= config.bin %> proxy logs --lines 50"
       ],
       "flags": {
         "api-url": {
@@ -2166,16 +2186,26 @@
           "multiple": false,
           "type": "option"
         },
-        "clear": {
-          "description": "Clear the active organization (personal mode)",
-          "name": "clear",
+        "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": "org:switch",
+      "id": "proxy:logs",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2185,27 +2215,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "org",
-        "switch.js"
+        "proxy",
+        "logs.js"
       ]
     },
-    "packs:add-instruction": {
+    "proxy:restart": {
       "aliases": [],
-      "args": {
-        "packId": {
-          "description": "Pack ID",
-          "name": "packId",
-          "required": true
-        },
-        "instructionId": {
-          "description": "Instruction ID",
-          "name": "instructionId",
-          "required": true
-        }
-      },
-      "description": "Add an instruction to a pack",
+      "args": {},
+      "description": "Restart the context capture proxy (stop + start)",
       "examples": [
-        "<%= config.bin %> packs add-instruction <pack-id> <instruction-id>"
+        "<%= config.bin %> proxy restart"
       ],
       "flags": {
         "api-url": {
@@ -2216,11 +2235,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": "packs:add-instruction",
+      "id": "proxy:restart",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2230,22 +2264,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "packs",
-        "add-instruction.js"
+        "proxy",
+        "restart.js"
       ]
     },
-    "packs:apply": {
+    "proxy:setup": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Pack ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Apply a pack to a project (bulk-link all instructions)",
+      "args": {},
+      "description": "Set up context capture proxy (installs mitmproxy, configures shell)",
       "examples": [
-        "<%= config.bin %> packs apply <pack-id> --project <project-id>"
+        "<%= config.bin %> proxy setup",
+        "<%= config.bin %> proxy setup --shell zsh",
+        "<%= config.bin %> proxy setup --check"
       ],
       "flags": {
         "api-url": {
@@ -2257,19 +2287,38 @@
           "multiple": false,
           "type": "option"
         },
-        "project": {
+        "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": "Project ID",
-          "name": "project",
-          "required": true,
+          "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": "packs:apply",
+      "id": "proxy:setup",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2279,16 +2328,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "packs",
-        "apply.js"
+        "proxy",
+        "setup.js"
       ]
     },
-    "packs:create": {
+    "proxy:start": {
       "aliases": [],
       "args": {},
-      "description": "Create a new instruction pack",
+      "description": "Start context capture proxy",
       "examples": [
-        "<%= config.bin %> packs create --name \"Security Pack\" --description \"Security-focused instructions\""
+        "<%= config.bin %> proxy start",
+        "<%= config.bin %> proxy start --docker",
+        "<%= config.bin %> proxy start --port 9090",
+        "<%= config.bin %> proxy start --web"
       ],
       "flags": {
         "api-url": {
@@ -2300,50 +2352,44 @@
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "char": "n",
-          "description": "Pack name",
-          "name": "name",
-          "required": true,
+        "port": {
+          "char": "p",
+          "description": "Proxy listen port",
+          "name": "port",
+          "default": 8788,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "description": {
+        "docker": {
           "char": "d",
-          "description": "Pack description",
-          "name": "description",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+          "description": "Run proxy in Docker (no local mitmproxy needed)",
+          "name": "docker",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "scope": {
-          "char": "s",
-          "description": "Pack scope",
-          "name": "scope",
-          "default": "personal",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "org",
-            "team",
-            "personal"
-          ],
-          "type": "option"
+        "web": {
+          "description": "Launch mitmweb debug UI instead of mitmdump (local mode only)",
+          "name": "web",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "tags": {
-          "char": "t",
-          "description": "Comma-separated tags",
-          "name": "tags",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "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": "packs:create",
+      "id": "proxy:start",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2353,22 +2399,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "packs",
-        "create.js"
+        "proxy",
+        "start.js"
       ]
     },
-    "packs:fork": {
+    "proxy:status": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "ID of the pack to fork",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Fork a pack to your personal scope",
+      "args": {},
+      "description": "Check gateway and context capture proxy status",
       "examples": [
-        "<%= config.bin %> packs fork <pack-id>"
+        "<%= config.bin %> proxy status"
       ],
       "flags": {
         "api-url": {
@@ -2383,7 +2423,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "packs:fork",
+      "id": "proxy:status",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2393,22 +2433,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "packs",
-        "fork.js"
+        "proxy",
+        "status.js"
       ]
     },
-    "packs:get": {
+    "proxy:stop": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Pack ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Get pack detail with instruction list",
+      "args": {},
+      "description": "Stop the context capture proxy",
       "examples": [
-        "<%= config.bin %> packs get <pack-id>"
+        "<%= config.bin %> proxy stop"
       ],
       "flags": {
         "api-url": {
@@ -2423,7 +2457,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "packs:get",
+      "id": "proxy:stop",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2433,26 +2467,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "packs",
-        "get.js"
+        "proxy",
+        "stop.js"
       ]
     },
-    "packs:list": {
+    "research:backfill": {
       "aliases": [],
       "args": {},
-      "description": "List your instruction packs",
+      "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 %> packs list",
-        "<%= config.bin %> packs list --json"
+        "<%= config.bin %> research backfill",
+        "<%= config.bin %> research backfill --claude-dir /custom/.claude --dry-run"
       ],
       "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "api-url": {
           "description": "Override API base URL",
           "env": "RULEMETRIC_API_URL",
@@ -2462,54 +2489,47 @@
           "multiple": false,
           "type": "option"
         },
-        "format": {
-          "char": "f",
-          "description": "Output format",
-          "name": "format",
-          "default": "table",
+        "claude-dir": {
+          "description": "Override the Claude Code projects directory",
+          "name": "claude-dir",
+          "default": "/home/runner/.claude",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "table",
-            "json"
-          ],
           "type": "option"
+        },
+        "dry-run": {
+          "description": "Print observation count without POSTing",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "packs:list",
+      "id": "research:backfill",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
+      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "packs",
-        "list.js"
+        "research",
+        "backfill.js"
       ]
     },
-    "packs:remove-instruction": {
+    "research:tail-transcript": {
       "aliases": [],
       "args": {
-        "packId": {
-          "description": "Pack ID",
-          "name": "packId",
-          "required": true
-        },
-        "instructionId": {
-          "description": "Instruction ID",
-          "name": "instructionId",
+        "transcript": {
+          "description": "Absolute path to a Claude Code .jsonl transcript",
+          "name": "transcript",
           "required": true
         }
       },
-      "description": "Remove an instruction from a pack",
-      "examples": [
-        "<%= config.bin %> packs remove-instruction <pack-id> <instruction-id>"
-      ],
+      "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",
@@ -2519,11 +2539,18 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "no-post": {
+          "description": "Parse and advance the offset without POSTing (debug)",
+          "name": "no-post",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
+      "hidden": true,
       "hiddenAliases": [],
-      "id": "packs:remove-instruction",
+      "id": "research:tail-transcript",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2533,19 +2560,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "packs",
-        "remove-instruction.js"
+        "research",
+        "tail-transcript.js"
       ]
     },
-    "proxy:env": {
+    "service:install": {
       "aliases": [],
       "args": {},
-      "description": "Print shell env vars to route any client through the RuleMetric proxy",
+      "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 env",
-        "<%= config.bin %> proxy env --shell fish",
-        "eval \"$(rulemetric proxy env)\"",
-        "rulemetric proxy env --python"
+        "<%= 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": {
@@ -2557,48 +2585,44 @@
           "multiple": false,
           "type": "option"
         },
-        "shell": {
-          "char": "s",
-          "description": "Shell format (posix, fish, powershell)",
-          "name": "shell",
-          "default": "posix",
+        "port": {
+          "char": "p",
+          "description": "API server port",
+          "name": "port",
+          "default": 3000,
           "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",
+        "force": {
+          "char": "f",
+          "description": "Overwrite existing service configuration and reclaim conflicting ports",
+          "name": "force",
           "allowNo": false,
           "type": "boolean"
         },
-        "node": {
-          "description": "Include Node.js-specific env vars (NODE_EXTRA_CA_CERTS)",
-          "name": "node",
+        "skip-build": {
+          "description": "Skip the pre-install workspace build (API/web/cli dist must already exist)",
+          "name": "skip-build",
           "allowNo": false,
           "type": "boolean"
         },
-        "all": {
-          "description": "Include env vars for all runtimes",
-          "name": "all",
+        "no-proxy": {
+          "description": "Skip gateway + mitmproxy plists (just install API + worker)",
+          "name": "no-proxy",
           "allowNo": false,
           "type": "boolean"
         },
-        "vscode": {
-          "description": "Output VS Code settings.json snippet for Copilot proxy",
-          "name": "vscode",
+        "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:env",
+      "id": "service:install",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2608,19 +2632,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "proxy",
-        "env.js"
+        "service",
+        "install.js"
       ]
     },
-    "proxy:logs": {
+    "service:status": {
       "aliases": [],
       "args": {},
-      "description": "View context capture proxy logs",
-      "examples": [
-        "<%= config.bin %> proxy logs",
-        "<%= config.bin %> proxy logs --follow",
-        "<%= config.bin %> proxy logs --lines 50"
-      ],
+      "description": "Check the status of all RuleMetric launchd services",
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -2630,27 +2649,11 @@
           "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": "proxy:logs",
+      "id": "service:status",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2660,17 +2663,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "proxy",
-        "logs.js"
+        "service",
+        "status.js"
       ]
     },
-    "proxy:restart": {
+    "service:uninstall": {
       "aliases": [],
       "args": {},
-      "description": "Restart the context capture proxy (stop + start)",
-      "examples": [
-        "<%= config.bin %> proxy restart"
-      ],
+      "description": "Remove RuleMetric services (macOS launchd: API/worker/gateway/proxy; Linux: the --worker-only systemd unit)",
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -2680,26 +2680,11 @@
           "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": "proxy:restart",
+      "id": "service:uninstall",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2709,18 +2694,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "proxy",
-        "restart.js"
+        "service",
+        "uninstall.js"
       ]
     },
-    "proxy:setup": {
+    "sessions:analyze": {
       "aliases": [],
-      "args": {},
-      "description": "Set up context capture proxy (installs mitmproxy, configures shell)",
+      "args": {
+        "id": {
+          "description": "Session ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Trigger AI analysis on a session",
       "examples": [
-        "<%= config.bin %> proxy setup",
-        "<%= config.bin %> proxy setup --shell zsh",
-        "<%= config.bin %> proxy setup --check"
+        "<%= config.bin %> sessions analyze <session-id>"
       ],
       "flags": {
         "api-url": {
@@ -2731,39 +2720,11 @@
           "hasDynamicHelp": false,
           "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",
-          "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": "proxy:setup",
+      "id": "sessions:analyze",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2773,19 +2734,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "proxy",
-        "setup.js"
+        "sessions",
+        "analyze.js"
       ]
     },
-    "proxy:start": {
+    "sessions:end": {
       "aliases": [],
       "args": {},
-      "description": "Start context capture proxy",
+      "description": "End the active capture session",
       "examples": [
-        "<%= config.bin %> proxy start",
-        "<%= config.bin %> proxy start --docker",
-        "<%= config.bin %> proxy start --port 9090",
-        "<%= config.bin %> proxy start --web"
+        "<%= config.bin %> sessions end"
       ],
       "flags": {
         "api-url": {
@@ -2796,45 +2754,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": "sessions:end",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2844,16 +2768,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "proxy",
-        "start.js"
+        "sessions",
+        "end.js"
       ]
     },
-    "proxy:status": {
+    "sessions:import": {
       "aliases": [],
-      "args": {},
-      "description": "Check gateway and context capture proxy status",
+      "args": {
+        "path": {
+          "description": "Path to session file",
+          "name": "path",
+          "required": true
+        }
+      },
+      "description": "Import a session file (JSONL, JSON)",
       "examples": [
-        "<%= config.bin %> proxy status"
+        "<%= config.bin %> sessions import ~/.claude/projects/my-project/session-abc.jsonl",
+        "<%= config.bin %> sessions import ./copilot-export.json --tool vscode_copilot"
       ],
       "flags": {
         "api-url": {
@@ -2864,11 +2795,18 @@
           "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": "proxy:status",
+      "id": "sessions:import",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2878,16 +2816,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "proxy",
-        "status.js"
+        "sessions",
+        "import.js"
       ]
     },
-    "proxy:stop": {
+    "sessions:list": {
       "aliases": [],
       "args": {},
-      "description": "Stop the context capture proxy",
+      "description": "List captured sessions",
       "examples": [
-        "<%= config.bin %> proxy stop"
+        "<%= config.bin %> sessions list",
+        "<%= config.bin %> sessions list --tool claude_code"
       ],
       "flags": {
         "api-url": {
@@ -2898,11 +2837,26 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "tool": {
+          "description": "Filter by tool (claude_code, cursor, vscode_copilot)",
+          "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": "proxy:stop",
+      "id": "sessions:list",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2912,17 +2866,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "proxy",
-        "stop.js"
-      ]
+        "sessions",
+        "list.js"
+      ]
     },
-    "research:backfill": {
+    "sessions:start": {
       "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.",
+      "description": "Start a capture session for any LLM provider (Cortex, Groq, etc.)",
       "examples": [
-        "<%= config.bin %> research backfill",
-        "<%= config.bin %> research backfill --claude-dir /custom/.claude --dry-run"
+        "<%= 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": {
@@ -2934,68 +2889,27 @@
           "multiple": false,
           "type": "option"
         },
-        "claude-dir": {
-          "description": "Override the Claude Code projects directory",
-          "name": "claude-dir",
-          "default": "/home/runner/.claude",
+        "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"
         },
-        "dry-run": {
-          "description": "Print observation count without POSTing",
-          "name": "dry-run",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "research:backfill",
-      "pluginAlias": "@rulemetric/cli",
-      "pluginName": "@rulemetric/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "research",
-        "backfill.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",
+        "project-dir": {
+          "char": "d",
+          "description": "Project directory (defaults to cwd)",
+          "name": "project-dir",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "no-post": {
-          "description": "Parse and advance the offset without POSTing (debug)",
-          "name": "no-post",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
-      "hidden": true,
       "hiddenAliases": [],
-      "id": "research:tail-transcript",
+      "id": "sessions:start",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3005,21 +2919,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "research",
-        "tail-transcript.js"
+        "sessions",
+        "start.js"
       ]
     },
-    "service:install": {
+    "signals:report": {
       "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).",
-      "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"
-      ],
+      "description": "Report filesystem-detected languages for the current project to the server.",
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -3030,44 +2937,18 @@
           "multiple": false,
           "type": "option"
         },
-        "port": {
-          "char": "p",
-          "description": "API server port",
-          "name": "port",
-          "default": 3000,
+        "cwd": {
+          "description": "Project path to inspect (defaults to process.cwd())",
+          "name": "cwd",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "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"
-        },
-        "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,
+      "hidden": true,
       "hiddenAliases": [],
-      "id": "service:install",
+      "id": "signals:report",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3077,14 +2958,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "service",
-        "install.js"
+        "signals",
+        "report.js"
       ]
     },
-    "service:status": {
+    "skills:export-approved": {
       "aliases": [],
       "args": {},
-      "description": "Check the status of all RuleMetric launchd services",
+      "description": "Export approved community submissions as community-skills.json for registry merge",
+      "examples": [
+        "<%= config.bin %> skills export-approved",
+        "<%= config.bin %> skills export-approved --output ./community-skills.json"
+      ],
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -3094,34 +2979,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "service:status",
-      "pluginAlias": "@rulemetric/cli",
-      "pluginName": "@rulemetric/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "service",
-        "status.js"
-      ]
-    },
-    "service:uninstall": {
-      "aliases": [],
-      "args": {},
-      "description": "Remove RuleMetric services (macOS launchd: API/worker/gateway/proxy; Linux: the --worker-only systemd unit)",
-      "flags": {
-        "api-url": {
-          "description": "Override API base URL",
-          "env": "RULEMETRIC_API_URL",
-          "hidden": true,
-          "name": "api-url",
+        },
+        "output": {
+          "description": "Output file path",
+          "name": "output",
+          "default": "packages/skills-registry/community-skills.json",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3129,7 +2991,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "service:uninstall",
+      "id": "skills:export-approved",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3139,22 +3001,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "service",
-        "uninstall.js"
+        "skills",
+        "export-approved.js"
       ]
     },
-    "sessions:analyze": {
+    "skills:install": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Session ID",
+          "description": "Skill ID to install",
           "name": "id",
           "required": true
         }
       },
-      "description": "Trigger AI analysis on a session",
+      "description": "Install a skill from the registry into your project",
       "examples": [
-        "<%= config.bin %> sessions analyze <session-id>"
+        "<%= config.bin %> skills install tdd-workflow",
+        "<%= config.bin %> skills install tdd-workflow --tool cursor",
+        "<%= config.bin %> skills install tdd-workflow --preview"
       ],
       "flags": {
         "api-url": {
@@ -3165,11 +3029,37 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "tool": {
+          "description": "Target tool format",
+          "name": "tool",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "claude_code",
+            "cursor",
+            "copilot"
+          ],
+          "type": "option"
+        },
+        "preview": {
+          "description": "Preview content without writing",
+          "name": "preview",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "dir": {
+          "description": "Project directory",
+          "name": "dir",
+          "default": ".",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sessions:analyze",
+      "id": "skills:install",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3179,16 +3069,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "sessions",
-        "analyze.js"
+        "skills",
+        "install.js"
       ]
     },
-    "sessions:end": {
+    "skills:list": {
       "aliases": [],
       "args": {},
-      "description": "End the active capture session",
+      "description": "List skills in the registry",
       "examples": [
-        "<%= config.bin %> sessions end"
+        "<%= config.bin %> skills list",
+        "<%= config.bin %> skills list --stats"
       ],
       "flags": {
         "api-url": {
@@ -3199,11 +3090,25 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "stats": {
+          "description": "Show registry statistics",
+          "name": "stats",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "limit": {
+          "description": "Max skills to show",
+          "name": "limit",
+          "default": 30,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sessions:end",
+      "id": "skills:list",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3213,23 +3118,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "sessions",
-        "end.js"
+        "skills",
+        "list.js"
       ]
     },
-    "sessions:import": {
+    "skills:publish": {
       "aliases": [],
       "args": {
-        "path": {
-          "description": "Path to session file",
-          "name": "path",
+        "file": {
+          "description": "Path to skill file (.md)",
+          "name": "file",
           "required": true
         }
       },
-      "description": "Import a session file (JSONL, JSON)",
+      "description": "Submit a skill file to the RuleMetric skills registry",
       "examples": [
-        "<%= config.bin %> sessions import ~/.claude/projects/my-project/session-abc.jsonl",
-        "<%= config.bin %> sessions import ./copilot-export.json --tool vscode_copilot"
+        "<%= config.bin %> skills publish ./my-skill.md",
+        "<%= config.bin %> skills publish ./my-skill.md --category workflow --tool claude_code"
       ],
       "flags": {
         "api-url": {
@@ -3241,9 +3146,60 @@
           "multiple": false,
           "type": "option"
         },
+        "name": {
+          "description": "Skill name (defaults to filename)",
+          "name": "name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "description": {
+          "description": "One-line description",
+          "name": "description",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "category": {
+          "description": "Skill category",
+          "name": "category",
+          "default": "other",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "workflow",
+            "language",
+            "framework",
+            "tool",
+            "security",
+            "testing",
+            "architecture",
+            "devops",
+            "documentation",
+            "performance",
+            "other"
+          ],
+          "type": "option"
+        },
         "tool": {
-          "description": "Override tool detection (claude_code, cursor, vscode_copilot)",
+          "description": "Primary tool this skill targets",
           "name": "tool",
+          "default": "universal",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "claude_code",
+            "cursor",
+            "copilot",
+            "windsurf",
+            "universal"
+          ],
+          "type": "option"
+        },
+        "tags": {
+          "description": "Comma-separated tags",
+          "name": "tags",
+          "default": "",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3251,7 +3207,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sessions:import",
+      "id": "skills:publish",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3261,17 +3217,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "sessions",
-        "import.js"
+        "skills",
+        "publish.js"
       ]
     },
-    "sessions:list": {
+    "skills:search": {
       "aliases": [],
-      "args": {},
-      "description": "List captured sessions",
+      "args": {
+        "query": {
+          "description": "Search term",
+          "name": "query",
+          "required": false
+        }
+      },
+      "description": "Search the community skills registry",
       "examples": [
-        "<%= config.bin %> sessions list",
-        "<%= config.bin %> sessions list --tool claude_code"
+        "<%= config.bin %> skills search \"tdd\"",
+        "<%= config.bin %> skills search --tool cursor --category testing",
+        "<%= config.bin %> skills search --language python"
       ],
       "flags": {
         "api-url": {
@@ -3284,10 +3247,51 @@
           "type": "option"
         },
         "tool": {
-          "description": "Filter by tool (claude_code, cursor, vscode_copilot)",
+          "description": "Filter by tool",
           "name": "tool",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "claude_code",
+            "cursor",
+            "copilot",
+            "windsurf",
+            "cline",
+            "universal"
+          ],
+          "type": "option"
+        },
+        "category": {
+          "description": "Filter by category",
+          "name": "category",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "workflow",
+            "language",
+            "framework",
+            "tool",
+            "security",
+            "testing",
+            "architecture",
+            "devops",
+            "documentation",
+            "performance"
+          ],
+          "type": "option"
+        },
+        "language": {
+          "description": "Filter by programming language",
+          "name": "language",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "framework": {
+          "description": "Filter by framework",
+          "name": "framework",
+          "hasDynamicHelp": false,
+          "multiple": false,
           "type": "option"
         },
         "limit": {
@@ -3301,7 +3305,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sessions:list",
+      "id": "skills:search",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3311,18 +3315,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "sessions",
-        "list.js"
+        "skills",
+        "search.js"
       ]
     },
-    "sessions:start": {
+    "skills:update": {
       "aliases": [],
       "args": {},
-      "description": "Start a capture session for any LLM provider (Cortex, Groq, etc.)",
+      "description": "Fetch latest skills from GitHub sources and update local registry",
       "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"
+        "<%= config.bin %> skills update",
+        "<%= config.bin %> skills update --all"
       ],
       "flags": {
         "api-url": {
@@ -3334,27 +3337,16 @@
           "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"
+        "all": {
+          "description": "Include Tier 2 (niche) sources",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sessions:start",
+      "id": "skills:update",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3364,14 +3356,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "sessions",
-        "start.js"
+        "skills",
+        "update.js"
       ]
     },
-    "signals:report": {
+    "suggestions:accept": {
       "aliases": [],
-      "args": {},
-      "description": "Report filesystem-detected languages for the current project to the server.",
+      "args": {
+        "id": {
+          "description": "Suggestion UUID from `suggestions list`",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Accept a suggestion and append the instruction to CLAUDE.md",
+      "examples": [
+        "<%= config.bin %> suggestions accept <id>"
+      ],
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -3381,19 +3382,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "cwd": {
-          "description": "Project path to inspect (defaults to process.cwd())",
-          "name": "cwd",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
-      "hidden": true,
       "hiddenAliases": [],
-      "id": "signals:report",
+      "id": "suggestions:accept",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3403,17 +3396,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "signals",
-        "report.js"
+        "suggestions",
+        "accept.js"
       ]
     },
-    "skills:export-approved": {
+    "suggestions:dismiss": {
       "aliases": [],
-      "args": {},
-      "description": "Export approved community submissions as community-skills.json for registry merge",
+      "args": {
+        "id": {
+          "description": "Suggestion UUID from `suggestions list`",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Dismiss a suggestion so it will not re-surface for 30 days",
       "examples": [
-        "<%= config.bin %> skills export-approved",
-        "<%= config.bin %> skills export-approved --output ./community-skills.json"
+        "<%= config.bin %> suggestions dismiss <id>"
       ],
       "flags": {
         "api-url": {
@@ -3424,19 +3422,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "output": {
-          "description": "Output file path",
-          "name": "output",
-          "default": "packages/skills-registry/community-skills.json",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "skills:export-approved",
+      "id": "suggestions:dismiss",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3446,24 +3436,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "skills",
-        "export-approved.js"
+        "suggestions",
+        "dismiss.js"
       ]
     },
-    "skills:install": {
+    "suggestions:list": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Skill ID to install",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Install a skill from the registry into your project",
+      "args": {},
+      "description": "List instruction suggestions for a project",
       "examples": [
-        "<%= config.bin %> skills install tdd-workflow",
-        "<%= config.bin %> skills install tdd-workflow --tool cursor",
-        "<%= config.bin %> skills install tdd-workflow --preview"
+        "<%= config.bin %> suggestions list",
+        "<%= config.bin %> suggestions list --project /path/to/project"
       ],
       "flags": {
         "api-url": {
@@ -3475,28 +3458,10 @@
           "multiple": false,
           "type": "option"
         },
-        "tool": {
-          "description": "Target tool format",
-          "name": "tool",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "claude_code",
-            "cursor",
-            "copilot"
-          ],
-          "type": "option"
-        },
-        "preview": {
-          "description": "Preview content without writing",
-          "name": "preview",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "dir": {
-          "description": "Project directory",
-          "name": "dir",
-          "default": ".",
+        "project": {
+          "char": "p",
+          "description": "Project path (defaults to current directory)",
+          "name": "project",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3504,7 +3469,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "skills:install",
+      "id": "suggestions:list",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3514,17 +3479,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "skills",
-        "install.js"
+        "suggestions",
+        "list.js"
       ]
     },
-    "skills:list": {
+    "suggestions:refresh": {
       "aliases": [],
       "args": {},
-      "description": "List skills in the registry",
+      "description": "Information about refreshing instruction suggestions",
       "examples": [
-        "<%= config.bin %> skills list",
-        "<%= config.bin %> skills list --stats"
+        "<%= config.bin %> suggestions refresh"
       ],
       "flags": {
         "api-url": {
@@ -3535,25 +3499,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "stats": {
-          "description": "Show registry statistics",
-          "name": "stats",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "limit": {
-          "description": "Max skills to show",
-          "name": "limit",
-          "default": 30,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "skills:list",
+      "id": "suggestions:refresh",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3563,23 +3513,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "skills",
-        "list.js"
+        "suggestions",
+        "refresh.js"
       ]
     },
-    "skills:publish": {
+    "instructions:create": {
       "aliases": [],
       "args": {
         "file": {
-          "description": "Path to skill file (.md)",
-          "name": "file",
-          "required": true
+          "description": "Path to markdown file",
+          "name": "file"
         }
       },
-      "description": "Submit a skill file to the RuleMetric skills registry",
+      "description": "Create a new instruction",
       "examples": [
-        "<%= config.bin %> skills publish ./my-skill.md",
-        "<%= config.bin %> skills publish ./my-skill.md --category workflow --tool claude_code"
+        "<%= config.bin %> instructions create ./my-instruction.md --name \"My Rules\"",
+        "<%= config.bin %> instructions create ./rules.md -n \"Rules\" -s project"
       ],
       "flags": {
         "api-url": {
@@ -3592,59 +3541,49 @@
           "type": "option"
         },
         "name": {
-          "description": "Skill name (defaults to filename)",
+          "char": "n",
+          "description": "Instruction name",
           "name": "name",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "description": {
-          "description": "One-line description",
+          "char": "d",
+          "description": "Instruction description",
           "name": "description",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "category": {
-          "description": "Skill category",
-          "name": "category",
-          "default": "other",
+        "scope": {
+          "char": "s",
+          "description": "Instruction scope",
+          "name": "scope",
+          "default": "personal",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "workflow",
-            "language",
-            "framework",
-            "tool",
-            "security",
-            "testing",
-            "architecture",
-            "devops",
-            "documentation",
-            "performance",
-            "other"
+            "org",
+            "team",
+            "project",
+            "personal"
           ],
           "type": "option"
         },
-        "tool": {
-          "description": "Primary tool this skill targets",
-          "name": "tool",
-          "default": "universal",
+        "scope-ref": {
+          "description": "Scope reference UUID",
+          "name": "scope-ref",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "claude_code",
-            "cursor",
-            "copilot",
-            "windsurf",
-            "universal"
-          ],
           "type": "option"
         },
         "tags": {
+          "char": "t",
           "description": "Comma-separated tags",
           "name": "tags",
-          "default": "",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3652,7 +3591,95 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "skills:publish",
+      "id": "instructions:create",
+      "pluginAlias": "@rulemetric/cli",
+      "pluginName": "@rulemetric/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "instructions",
+        "create.js"
+      ]
+    },
+    "instructions:delete": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Instruction ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Delete (archive) an instruction",
+      "examples": [
+        "<%= config.bin %> instructions delete <id>",
+        "<%= config.bin %> instructions delete <id> --force"
+      ],
+      "flags": {
+        "api-url": {
+          "description": "Override API base URL",
+          "env": "RULEMETRIC_API_URL",
+          "hidden": true,
+          "name": "api-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "force": {
+          "char": "f",
+          "description": "Skip confirmation prompt",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "instructions:delete",
+      "pluginAlias": "@rulemetric/cli",
+      "pluginName": "@rulemetric/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "instructions",
+        "delete.js"
+      ]
+    },
+    "instructions:fork": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "ID of the instruction to fork",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Fork an instruction to your personal scope",
+      "examples": [
+        "<%= config.bin %> instructions fork <instruction-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": "instructions:fork",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3662,26 +3689,32 @@
       "relativePath": [
         "dist",
         "commands",
-        "skills",
-        "publish.js"
+        "instructions",
+        "fork.js"
       ]
     },
-    "skills:search": {
+    "instructions:get": {
       "aliases": [],
       "args": {
-        "query": {
-          "description": "Search term",
-          "name": "query",
-          "required": false
+        "id": {
+          "description": "Instruction ID",
+          "name": "id",
+          "required": true
         }
       },
-      "description": "Search the community skills registry",
+      "description": "Get an instruction by ID",
       "examples": [
-        "<%= config.bin %> skills search \"tdd\"",
-        "<%= config.bin %> skills search --tool cursor --category testing",
-        "<%= config.bin %> skills search --language python"
+        "<%= config.bin %> instructions get <id>",
+        "<%= config.bin %> instructions get <id> --format raw"
       ],
       "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "api-url": {
           "description": "Override API base URL",
           "env": "RULEMETRIC_API_URL",
@@ -3691,88 +3724,53 @@
           "multiple": false,
           "type": "option"
         },
-        "tool": {
-          "description": "Filter by tool",
-          "name": "tool",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "claude_code",
-            "cursor",
-            "copilot",
-            "windsurf",
-            "cline",
-            "universal"
-          ],
-          "type": "option"
-        },
-        "category": {
-          "description": "Filter by category",
-          "name": "category",
+        "format": {
+          "char": "f",
+          "description": "Output format",
+          "name": "format",
+          "default": "yaml",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "workflow",
-            "language",
-            "framework",
-            "tool",
-            "security",
-            "testing",
-            "architecture",
-            "devops",
-            "documentation",
-            "performance"
+            "yaml",
+            "json",
+            "raw"
           ],
           "type": "option"
-        },
-        "language": {
-          "description": "Filter by programming language",
-          "name": "language",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "framework": {
-          "description": "Filter by framework",
-          "name": "framework",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "limit": {
-          "description": "Max results",
-          "name": "limit",
-          "default": 20,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "skills:search",
+      "id": "instructions:get",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
+      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "skills",
-        "search.js"
+        "instructions",
+        "get.js"
       ]
     },
-    "skills:update": {
+    "instructions:list": {
       "aliases": [],
       "args": {},
-      "description": "Fetch latest skills from GitHub sources and update local registry",
+      "description": "List your instructions",
       "examples": [
-        "<%= config.bin %> skills update",
-        "<%= config.bin %> skills update --all"
+        "<%= config.bin %> instructions list",
+        "<%= config.bin %> instructions list --json"
       ],
       "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "api-url": {
           "description": "Override API base URL",
           "env": "RULEMETRIC_API_URL",
@@ -3782,41 +3780,49 @@
           "multiple": false,
           "type": "option"
         },
-        "all": {
-          "description": "Include Tier 2 (niche) sources",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
+        "format": {
+          "char": "f",
+          "description": "Output format",
+          "name": "format",
+          "default": "table",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "table",
+            "json"
+          ],
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "skills:update",
+      "id": "instructions:list",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
+      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "skills",
-        "update.js"
+        "instructions",
+        "list.js"
       ]
     },
-    "suggestions:accept": {
+    "instructions:promote": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Suggestion UUID from `suggestions list`",
+          "description": "ID of the instruction to promote",
           "name": "id",
           "required": true
         }
       },
-      "description": "Accept a suggestion and append the instruction to CLAUDE.md",
+      "description": "Promote an instruction to a higher scope (personal → team → org)",
       "examples": [
-        "<%= config.bin %> suggestions accept <id>"
+        "<%= config.bin %> instructions promote <id> --scope team --ref <team-id>",
+        "<%= config.bin %> instructions promote <id> --scope org --ref <org-id>"
       ],
       "flags": {
         "api-url": {
@@ -3827,11 +3833,31 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "scope": {
+          "description": "Target scope",
+          "name": "scope",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "team",
+            "org"
+          ],
+          "type": "option"
+        },
+        "ref": {
+          "description": "Target scope ref (team or org ID)",
+          "name": "ref",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "suggestions:accept",
+      "id": "instructions:promote",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3841,23 +3867,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "suggestions",
-        "accept.js"
+        "instructions",
+        "promote.js"
       ]
     },
-    "suggestions:dismiss": {
+    "instructions:pull": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Suggestion UUID from `suggestions list`",
+          "description": "ID of the forked instruction",
           "name": "id",
           "required": true
         }
       },
-      "description": "Dismiss a suggestion so it will not re-surface for 30 days",
-      "examples": [
-        "<%= config.bin %> suggestions dismiss <id>"
-      ],
+      "description": "Pull upstream changes into a forked instruction",
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -3871,7 +3894,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "suggestions:dismiss",
+      "id": "instructions:pull",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3881,18 +3904,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "suggestions",
-        "dismiss.js"
+        "instructions",
+        "pull.js"
       ]
     },
-    "suggestions:list": {
+    "instructions:upstream": {
       "aliases": [],
-      "args": {},
-      "description": "List instruction suggestions for a project",
-      "examples": [
-        "<%= config.bin %> suggestions list",
-        "<%= config.bin %> suggestions list --project /path/to/project"
-      ],
+      "args": {
+        "id": {
+          "description": "ID of the forked instruction",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Check if a forked instruction has upstream updates",
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -3902,19 +3927,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "project": {
-          "char": "p",
-          "description": "Project path (defaults to current directory)",
-          "name": "project",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "suggestions:list",
+      "id": "instructions:upstream",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3924,18 +3941,31 @@
       "relativePath": [
         "dist",
         "commands",
-        "suggestions",
-        "list.js"
+        "instructions",
+        "upstream.js"
       ]
     },
-    "suggestions:refresh": {
+    "instructions:versions": {
       "aliases": [],
-      "args": {},
-      "description": "Information about refreshing instruction suggestions",
+      "args": {
+        "id": {
+          "description": "Instruction ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "List version history for an instruction",
       "examples": [
-        "<%= config.bin %> suggestions refresh"
+        "<%= config.bin %> instructions versions <id>"
       ],
       "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "api-url": {
           "description": "Override API base URL",
           "env": "RULEMETRIC_API_URL",
@@ -3948,20 +3978,20 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "suggestions:refresh",
+      "id": "instructions:versions",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
+      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "suggestions",
-        "refresh.js"
+        "instructions",
+        "versions.js"
       ]
     }
   },
-  "version": "0.3.0"
+  "version": "0.4.0"
 }