@rulemetric/cli 0.4.0 → 0.5.1

package/oclif.manifest.json

@@ -311,6 +311,67 @@
         "launcher.js"
       ]
     },
+    "setup": {
+      "aliases": [],
+      "args": {
+        "target": {
+          "description": "\"plan\" or a step id (install, auth, hooks, worker)",
+          "name": "target",
+          "required": false
+        }
+      },
+      "description": "Agentic, transparent setup: plan / show diffs / apply the four core onboarding steps",
+      "examples": [
+        "<%= config.bin %> setup                 # interactive walk (TTY)",
+        "<%= config.bin %> setup plan            # read-only: every remaining artifact + diff",
+        "<%= config.bin %> setup hooks --show    # print one step's diff",
+        "<%= config.bin %> setup hooks --apply   # apply one step",
+        "<%= config.bin %> setup --json          # machine-readable status (exit 0 iff complete)"
+      ],
+      "flags": {
+        "api-url": {
+          "description": "Override API base URL",
+          "env": "RULEMETRIC_API_URL",
+          "hidden": true,
+          "name": "api-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "json": {
+          "description": "Machine-readable output",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "show": {
+          "description": "Print the step diff (read-only)",
+          "name": "show",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "apply": {
+          "description": "Apply the step",
+          "name": "apply",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "setup",
+      "pluginAlias": "@rulemetric/cli",
+      "pluginName": "@rulemetric/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "setup.js"
+      ]
+    },
     "antigravity:backfill": {
       "aliases": [],
       "args": {
@@ -1629,12 +1690,18 @@
         "uninstall.js"
       ]
     },
-    "org:current": {
+    "instructions:create": {
       "aliases": [],
-      "args": {},
-      "description": "Show the current active organization",
+      "args": {
+        "file": {
+          "description": "Path to markdown file",
+          "name": "file"
+        }
+      },
+      "description": "Create a new instruction",
       "examples": [
-        "<%= config.bin %> org current"
+        "<%= config.bin %> instructions create ./my-instruction.md --name \"My Rules\"",
+        "<%= config.bin %> instructions create ./rules.md -n \"Rules\" -s project"
       ],
       "flags": {
         "api-url": {
@@ -1645,37 +1712,51 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "org:current",
-      "pluginAlias": "@rulemetric/cli",
-      "pluginName": "@rulemetric/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "org",
-        "current.js"
-      ]
-    },
-    "org:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List organizations the current user is a member of",
-      "examples": [
-        "<%= config.bin %> org list"
-      ],
-      "flags": {
-        "api-url": {
-          "description": "Override API base URL",
-          "env": "RULEMETRIC_API_URL",
-          "hidden": true,
-          "name": "api-url",
+        },
+        "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"
@@ -1683,7 +1764,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "org:list",
+      "id": "instructions:create",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -1693,23 +1774,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "org",
-        "list.js"
+        "instructions",
+        "create.js"
       ]
     },
-    "org:switch": {
+    "instructions:delete": {
       "aliases": [],
       "args": {
-        "slug": {
-          "description": "Organization slug to switch to",
-          "name": "slug",
-          "required": false
+        "id": {
+          "description": "Instruction ID",
+          "name": "id",
+          "required": true
         }
       },
-      "description": "Switch the active organization",
+      "description": "Delete (archive) an instruction",
       "examples": [
-        "<%= config.bin %> org switch acme",
-        "<%= config.bin %> org switch --clear"
+        "<%= config.bin %> instructions delete <id>",
+        "<%= config.bin %> instructions delete <id> --force"
       ],
       "flags": {
         "api-url": {
@@ -1721,16 +1802,17 @@
           "multiple": false,
           "type": "option"
         },
-        "clear": {
-          "description": "Clear the active organization (personal mode)",
-          "name": "clear",
+        "force": {
+          "char": "f",
+          "description": "Skip confirmation prompt",
+          "name": "force",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "org:switch",
+      "id": "instructions:delete",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -1740,27 +1822,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "org",
-        "switch.js"
+        "instructions",
+        "delete.js"
       ]
     },
-    "packs:add-instruction": {
+    "instructions:fork": {
       "aliases": [],
       "args": {
-        "packId": {
-          "description": "Pack ID",
-          "name": "packId",
-          "required": true
-        },
-        "instructionId": {
-          "description": "Instruction ID",
-          "name": "instructionId",
+        "id": {
+          "description": "ID of the instruction to fork",
+          "name": "id",
           "required": true
         }
       },
-      "description": "Add an instruction to a pack",
+      "description": "Fork an instruction to your personal scope",
       "examples": [
-        "<%= config.bin %> packs add-instruction <pack-id> <instruction-id>"
+        "<%= config.bin %> instructions fork <instruction-id>"
       ],
       "flags": {
         "api-url": {
@@ -1775,7 +1852,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "packs:add-instruction",
+      "id": "instructions:fork",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -1785,24 +1862,32 @@
       "relativePath": [
         "dist",
         "commands",
-        "packs",
-        "add-instruction.js"
+        "instructions",
+        "fork.js"
       ]
     },
-    "packs:apply": {
+    "instructions:get": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Pack ID",
+          "description": "Instruction ID",
           "name": "id",
           "required": true
         }
       },
-      "description": "Apply a pack to a project (bulk-link all instructions)",
+      "description": "Get an instruction by ID",
       "examples": [
-        "<%= config.bin %> packs apply <pack-id> --project <project-id>"
+        "<%= 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",
@@ -1812,40 +1897,53 @@
           "multiple": false,
           "type": "option"
         },
-        "project": {
-          "char": "p",
-          "description": "Project ID",
-          "name": "project",
-          "required": true,
+        "format": {
+          "char": "f",
+          "description": "Output format",
+          "name": "format",
+          "default": "yaml",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "yaml",
+            "json",
+            "raw"
+          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "packs:apply",
+      "id": "instructions:get",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
+      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "packs",
-        "apply.js"
+        "instructions",
+        "get.js"
       ]
     },
-    "packs:create": {
+    "instructions:list": {
       "aliases": [],
       "args": {},
-      "description": "Create a new instruction pack",
+      "description": "List your instructions",
       "examples": [
-        "<%= config.bin %> packs create --name \"Security Pack\" --description \"Security-focused instructions\""
+        "<%= 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",
@@ -1855,42 +1953,76 @@
           "multiple": false,
           "type": "option"
         },
-        "name": {
-          "char": "n",
-          "description": "Pack name",
-          "name": "name",
-          "required": true,
+        "format": {
+          "char": "f",
+          "description": "Output format",
+          "name": "format",
+          "default": "table",
           "hasDynamicHelp": false,
           "multiple": false,
-          "type": "option"
-        },
-        "description": {
-          "char": "d",
-          "description": "Pack description",
-          "name": "description",
-          "required": true,
+          "options": [
+            "table",
+            "json"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "instructions:list",
+      "pluginAlias": "@rulemetric/cli",
+      "pluginName": "@rulemetric/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "instructions",
+        "list.js"
+      ]
+    },
+    "instructions:promote": {
+      "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)",
+      "examples": [
+        "<%= config.bin %> instructions promote <id> --scope team --ref <team-id>",
+        "<%= config.bin %> instructions promote <id> --scope org --ref <org-id>"
+      ],
+      "flags": {
+        "api-url": {
+          "description": "Override API base URL",
+          "env": "RULEMETRIC_API_URL",
+          "hidden": true,
+          "name": "api-url",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
         "scope": {
-          "char": "s",
-          "description": "Pack scope",
+          "description": "Target scope",
           "name": "scope",
-          "default": "personal",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "org",
             "team",
-            "personal"
+            "org"
           ],
           "type": "option"
         },
-        "tags": {
-          "char": "t",
-          "description": "Comma-separated tags",
-          "name": "tags",
+        "ref": {
+          "description": "Target scope ref (team or org ID)",
+          "name": "ref",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1898,7 +2030,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "packs:create",
+      "id": "instructions:promote",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -1908,23 +2040,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "packs",
-        "create.js"
+        "instructions",
+        "promote.js"
       ]
     },
-    "packs:fork": {
+    "instructions:pull": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "ID of the pack to fork",
+          "description": "ID of the forked instruction",
           "name": "id",
           "required": true
         }
       },
-      "description": "Fork a pack to your personal scope",
-      "examples": [
-        "<%= config.bin %> packs fork <pack-id>"
-      ],
+      "description": "Pull upstream changes into a forked instruction",
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -1938,7 +2067,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "packs:fork",
+      "id": "instructions:pull",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -1948,23 +2077,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "packs",
-        "fork.js"
+        "instructions",
+        "pull.js"
       ]
     },
-    "packs:get": {
+    "instructions:upstream": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Pack ID",
+          "description": "ID of the forked instruction",
           "name": "id",
           "required": true
         }
       },
-      "description": "Get pack detail with instruction list",
-      "examples": [
-        "<%= config.bin %> packs get <pack-id>"
-      ],
+      "description": "Check if a forked instruction has upstream updates",
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -1978,7 +2104,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "packs:get",
+      "id": "instructions:upstream",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -1988,17 +2114,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "packs",
-        "get.js"
+        "instructions",
+        "upstream.js"
       ]
     },
-    "packs:list": {
+    "instructions:versions": {
       "aliases": [],
-      "args": {},
-      "description": "List your instruction packs",
+      "args": {
+        "id": {
+          "description": "Instruction ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "List version history for an instruction",
       "examples": [
-        "<%= config.bin %> packs list",
-        "<%= config.bin %> packs list --json"
+        "<%= config.bin %> instructions versions <id>"
       ],
       "flags": {
         "json": {
@@ -2016,24 +2147,11 @@
           "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": "packs:list",
+      "id": "instructions:versions",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2043,27 +2161,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "packs",
-        "list.js"
+        "instructions",
+        "versions.js"
       ]
     },
-    "packs:remove-instruction": {
+    "org:current": {
       "aliases": [],
-      "args": {
-        "packId": {
-          "description": "Pack ID",
-          "name": "packId",
-          "required": true
-        },
-        "instructionId": {
-          "description": "Instruction ID",
-          "name": "instructionId",
-          "required": true
-        }
-      },
-      "description": "Remove an instruction from a pack",
+      "args": {},
+      "description": "Show the current active organization",
       "examples": [
-        "<%= config.bin %> packs remove-instruction <pack-id> <instruction-id>"
+        "<%= config.bin %> org current"
       ],
       "flags": {
         "api-url": {
@@ -2078,7 +2185,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "packs:remove-instruction",
+      "id": "org:current",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2088,19 +2195,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "packs",
-        "remove-instruction.js"
+        "org",
+        "current.js"
       ]
     },
-    "proxy:env": {
+    "org:list": {
       "aliases": [],
       "args": {},
-      "description": "Print shell env vars to route any client through the RuleMetric proxy",
+      "description": "List organizations the current user is a member of",
       "examples": [
-        "<%= config.bin %> proxy env",
-        "<%= config.bin %> proxy env --shell fish",
-        "eval \"$(rulemetric proxy env)\"",
-        "rulemetric proxy env --python"
+        "<%= config.bin %> org list"
       ],
       "flags": {
         "api-url": {
@@ -2111,49 +2215,11 @@
           "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": "proxy:env",
+      "id": "org:list",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2163,18 +2229,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "proxy",
-        "env.js"
+        "org",
+        "list.js"
       ]
     },
-    "proxy:logs": {
+    "org:switch": {
       "aliases": [],
-      "args": {},
-      "description": "View context capture proxy logs",
+      "args": {
+        "slug": {
+          "description": "Organization slug to switch to",
+          "name": "slug",
+          "required": false
+        }
+      },
+      "description": "Switch the active organization",
       "examples": [
-        "<%= config.bin %> proxy logs",
-        "<%= config.bin %> proxy logs --follow",
-        "<%= config.bin %> proxy logs --lines 50"
+        "<%= config.bin %> org switch acme",
+        "<%= config.bin %> org switch --clear"
       ],
       "flags": {
         "api-url": {
@@ -2186,26 +2257,16 @@
           "multiple": false,
           "type": "option"
         },
-        "follow": {
-          "char": "f",
-          "description": "Follow log output (like tail -f)",
-          "name": "follow",
+        "clear": {
+          "description": "Clear the active organization (personal mode)",
+          "name": "clear",
           "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": "org:switch",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2215,16 +2276,27 @@
       "relativePath": [
         "dist",
         "commands",
-        "proxy",
-        "logs.js"
+        "org",
+        "switch.js"
       ]
     },
-    "proxy:restart": {
+    "packs:add-instruction": {
       "aliases": [],
-      "args": {},
-      "description": "Restart the context capture proxy (stop + start)",
-      "examples": [
-        "<%= config.bin %> proxy restart"
+      "args": {
+        "packId": {
+          "description": "Pack ID",
+          "name": "packId",
+          "required": true
+        },
+        "instructionId": {
+          "description": "Instruction ID",
+          "name": "instructionId",
+          "required": true
+        }
+      },
+      "description": "Add an instruction to a pack",
+      "examples": [
+        "<%= config.bin %> packs add-instruction <pack-id> <instruction-id>"
       ],
       "flags": {
         "api-url": {
@@ -2235,26 +2307,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": "packs:add-instruction",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2264,18 +2321,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "proxy",
-        "restart.js"
+        "packs",
+        "add-instruction.js"
       ]
     },
-    "proxy:setup": {
+    "packs:apply": {
       "aliases": [],
-      "args": {},
-      "description": "Set up context capture proxy (installs mitmproxy, configures shell)",
+      "args": {
+        "id": {
+          "description": "Pack ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Apply a pack to a project (bulk-link all instructions)",
       "examples": [
-        "<%= config.bin %> proxy setup",
-        "<%= config.bin %> proxy setup --shell zsh",
-        "<%= config.bin %> proxy setup --check"
+        "<%= config.bin %> packs apply <pack-id> --project <project-id>"
       ],
       "flags": {
         "api-url": {
@@ -2287,38 +2348,19 @@
           "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": {
+        "project": {
           "char": "p",
-          "description": "Proxy listen port",
-          "name": "port",
-          "default": 8787,
+          "description": "Project ID",
+          "name": "project",
+          "required": true,
           "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": "packs:apply",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2328,19 +2370,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "proxy",
-        "setup.js"
+        "packs",
+        "apply.js"
       ]
     },
-    "proxy:start": {
+    "packs:create": {
       "aliases": [],
       "args": {},
-      "description": "Start context capture proxy",
+      "description": "Create a new instruction pack",
       "examples": [
-        "<%= config.bin %> proxy start",
-        "<%= config.bin %> proxy start --docker",
-        "<%= config.bin %> proxy start --port 9090",
-        "<%= config.bin %> proxy start --web"
+        "<%= config.bin %> packs create --name \"Security Pack\" --description \"Security-focused instructions\""
       ],
       "flags": {
         "api-url": {
@@ -2352,44 +2391,50 @@
           "multiple": false,
           "type": "option"
         },
-        "port": {
-          "char": "p",
-          "description": "Proxy listen port",
-          "name": "port",
-          "default": 8788,
+        "name": {
+          "char": "n",
+          "description": "Pack name",
+          "name": "name",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "docker": {
+        "description": {
           "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"
+          "description": "Pack description",
+          "name": "description",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "skip-checks": {
-          "description": "Skip prerequisite checks",
-          "name": "skip-checks",
-          "allowNo": false,
-          "type": "boolean"
+        "scope": {
+          "char": "s",
+          "description": "Pack scope",
+          "name": "scope",
+          "default": "personal",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "org",
+            "team",
+            "personal"
+          ],
+          "type": "option"
         },
-        "build": {
-          "description": "Force rebuild Docker image",
-          "name": "build",
-          "allowNo": false,
-          "type": "boolean"
+        "tags": {
+          "char": "t",
+          "description": "Comma-separated tags",
+          "name": "tags",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "proxy:start",
+      "id": "packs:create",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2399,16 +2444,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "proxy",
-        "start.js"
+        "packs",
+        "create.js"
       ]
     },
-    "proxy:status": {
+    "packs:fork": {
       "aliases": [],
-      "args": {},
-      "description": "Check gateway and context capture proxy status",
+      "args": {
+        "id": {
+          "description": "ID of the pack to fork",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Fork a pack to your personal scope",
       "examples": [
-        "<%= config.bin %> proxy status"
+        "<%= config.bin %> packs fork <pack-id>"
       ],
       "flags": {
         "api-url": {
@@ -2423,7 +2474,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "proxy:status",
+      "id": "packs:fork",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2433,16 +2484,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "proxy",
-        "status.js"
+        "packs",
+        "fork.js"
       ]
     },
-    "proxy:stop": {
+    "packs:get": {
       "aliases": [],
-      "args": {},
-      "description": "Stop the context capture proxy",
+      "args": {
+        "id": {
+          "description": "Pack ID",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Get pack detail with instruction list",
       "examples": [
-        "<%= config.bin %> proxy stop"
+        "<%= config.bin %> packs get <pack-id>"
       ],
       "flags": {
         "api-url": {
@@ -2457,7 +2514,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "proxy:stop",
+      "id": "packs:get",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2467,19 +2524,26 @@
       "relativePath": [
         "dist",
         "commands",
-        "proxy",
-        "stop.js"
+        "packs",
+        "get.js"
       ]
     },
-    "research:backfill": {
+    "packs:list": {
       "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": "List your instruction packs",
       "examples": [
-        "<%= config.bin %> research backfill",
-        "<%= config.bin %> research backfill --claude-dir /custom/.claude --dry-run"
+        "<%= config.bin %> packs list",
+        "<%= config.bin %> packs 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",
@@ -2489,48 +2553,55 @@
           "multiple": false,
           "type": "option"
         },
-        "claude-dir": {
-          "description": "Override the Claude Code projects directory",
-          "name": "claude-dir",
-          "default": "/home/runner/.claude",
+        "format": {
+          "char": "f",
+          "description": "Output format",
+          "name": "format",
+          "default": "table",
           "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": "research:backfill",
+      "id": "packs:list",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
+      "enableJsonFlag": true,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "research",
-        "backfill.js"
+        "packs",
+        "list.js"
       ]
     },
-    "research:tail-transcript": {
+    "packs:remove-instruction": {
       "aliases": [],
       "args": {
-        "transcript": {
-          "description": "Absolute path to a Claude Code .jsonl transcript",
-          "name": "transcript",
+        "packId": {
+          "description": "Pack ID",
+          "name": "packId",
+          "required": true
+        },
+        "instructionId": {
+          "description": "Instruction ID",
+          "name": "instructionId",
           "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": {
+      "description": "Remove an instruction from a pack",
+      "examples": [
+        "<%= config.bin %> packs remove-instruction <pack-id> <instruction-id>"
+      ],
+      "flags": {
         "api-url": {
           "description": "Override API base URL",
           "env": "RULEMETRIC_API_URL",
@@ -2539,18 +2610,11 @@
           "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": "packs:remove-instruction",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2560,20 +2624,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "research",
-        "tail-transcript.js"
+        "packs",
+        "remove-instruction.js"
       ]
     },
-    "service:install": {
+    "proxy:env": {
       "aliases": [],
       "args": {},
-      "description": "Install RuleMetric services. Default (in a repo checkout): API + worker + gateway + capture proxy as launchd agents. With --worker-only: just the job worker, targeting the globally-installed CLI — no repo, no build (works from `npm i -g @rulemetric/cli`, macOS launchd or Linux systemd).",
+      "description": "Print shell env vars to route any client through the RuleMetric proxy",
       "examples": [
-        "<%= config.bin %> service install",
-        "<%= config.bin %> service install --port 3000",
-        "<%= config.bin %> service install --skip-build",
-        "<%= config.bin %> service install --no-proxy",
-        "<%= config.bin %> service install --worker-only"
+        "<%= config.bin %> proxy env",
+        "<%= config.bin %> proxy env --shell fish",
+        "eval \"$(rulemetric proxy env)\"",
+        "rulemetric proxy env --python"
       ],
       "flags": {
         "api-url": {
@@ -2585,44 +2648,48 @@
           "multiple": false,
           "type": "option"
         },
-        "port": {
-          "char": "p",
-          "description": "API server port",
-          "name": "port",
-          "default": 3000,
+        "shell": {
+          "char": "s",
+          "description": "Shell format (posix, fish, powershell)",
+          "name": "shell",
+          "default": "posix",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "posix",
+            "fish",
+            "powershell"
+          ],
           "type": "option"
         },
-        "force": {
-          "char": "f",
-          "description": "Overwrite existing service configuration and reclaim conflicting ports",
-          "name": "force",
+        "python": {
+          "description": "Include Python-specific env vars (REQUESTS_CA_BUNDLE, SSL_CERT_FILE)",
+          "name": "python",
           "allowNo": false,
           "type": "boolean"
         },
-        "skip-build": {
-          "description": "Skip the pre-install workspace build (API/web/cli dist must already exist)",
-          "name": "skip-build",
+        "node": {
+          "description": "Include Node.js-specific env vars (NODE_EXTRA_CA_CERTS)",
+          "name": "node",
           "allowNo": false,
           "type": "boolean"
         },
-        "no-proxy": {
-          "description": "Skip gateway + mitmproxy plists (just install API + worker)",
-          "name": "no-proxy",
+        "all": {
+          "description": "Include env vars for all runtimes",
+          "name": "all",
           "allowNo": false,
           "type": "boolean"
         },
-        "worker-only": {
-          "description": "Install ONLY the job worker as a persistent service, targeting the globally-installed CLI (no repo checkout, no build, no API/gateway/proxy). Sources auth from ~/.config/rulemetric/env. macOS (launchd) + Linux (systemd --user).",
-          "name": "worker-only",
+        "vscode": {
+          "description": "Output VS Code settings.json snippet for Copilot proxy",
+          "name": "vscode",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "service:install",
+      "id": "proxy:env",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2632,14 +2699,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "service",
-        "install.js"
+        "proxy",
+        "env.js"
       ]
     },
-    "service:status": {
+    "proxy:logs": {
       "aliases": [],
       "args": {},
-      "description": "Check the status of all RuleMetric launchd services",
+      "description": "View context capture proxy logs",
+      "examples": [
+        "<%= config.bin %> proxy logs",
+        "<%= config.bin %> proxy logs --follow",
+        "<%= config.bin %> proxy logs --lines 50"
+      ],
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -2649,11 +2721,27 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "follow": {
+          "char": "f",
+          "description": "Follow log output (like tail -f)",
+          "name": "follow",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "lines": {
+          "char": "n",
+          "description": "Number of lines to show",
+          "name": "lines",
+          "default": 30,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "service:status",
+      "id": "proxy:logs",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2663,14 +2751,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "service",
-        "status.js"
+        "proxy",
+        "logs.js"
       ]
     },
-    "service:uninstall": {
+    "proxy:restart": {
       "aliases": [],
       "args": {},
-      "description": "Remove RuleMetric services (macOS launchd: API/worker/gateway/proxy; Linux: the --worker-only systemd unit)",
+      "description": "Restart the context capture proxy (stop + start)",
+      "examples": [
+        "<%= config.bin %> proxy restart"
+      ],
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -2680,11 +2771,26 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "port": {
+          "char": "p",
+          "description": "Proxy listen port",
+          "name": "port",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "docker": {
+          "char": "d",
+          "description": "Run in Docker mode",
+          "name": "docker",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "service:uninstall",
+      "id": "proxy:restart",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2694,22 +2800,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "service",
-        "uninstall.js"
+        "proxy",
+        "restart.js"
       ]
     },
-    "sessions:analyze": {
+    "proxy:setup": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Session ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Trigger AI analysis on a session",
+      "args": {},
+      "description": "Set up context capture proxy (installs mitmproxy, configures shell)",
       "examples": [
-        "<%= config.bin %> sessions analyze <session-id>"
+        "<%= config.bin %> proxy setup",
+        "<%= config.bin %> proxy setup --shell zsh",
+        "<%= config.bin %> proxy setup --check"
       ],
       "flags": {
         "api-url": {
@@ -2720,11 +2822,39 @@
           "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": "sessions:analyze",
+      "id": "proxy:setup",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2734,16 +2864,19 @@
       "relativePath": [
         "dist",
         "commands",
-        "sessions",
-        "analyze.js"
+        "proxy",
+        "setup.js"
       ]
     },
-    "sessions:end": {
+    "proxy:start": {
       "aliases": [],
       "args": {},
-      "description": "End the active capture session",
+      "description": "Start context capture proxy",
       "examples": [
-        "<%= config.bin %> sessions end"
+        "<%= config.bin %> proxy start",
+        "<%= config.bin %> proxy start --docker",
+        "<%= config.bin %> proxy start --port 9090",
+        "<%= config.bin %> proxy start --web"
       ],
       "flags": {
         "api-url": {
@@ -2754,11 +2887,45 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "port": {
+          "char": "p",
+          "description": "Proxy listen port",
+          "name": "port",
+          "default": 8788,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "docker": {
+          "char": "d",
+          "description": "Run proxy in Docker (no local mitmproxy needed)",
+          "name": "docker",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "web": {
+          "description": "Launch mitmweb debug UI instead of mitmdump (local mode only)",
+          "name": "web",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "skip-checks": {
+          "description": "Skip prerequisite checks",
+          "name": "skip-checks",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "build": {
+          "description": "Force rebuild Docker image",
+          "name": "build",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sessions:end",
+      "id": "proxy:start",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2768,23 +2935,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "sessions",
-        "end.js"
+        "proxy",
+        "start.js"
       ]
     },
-    "sessions:import": {
+    "proxy:status": {
       "aliases": [],
-      "args": {
-        "path": {
-          "description": "Path to session file",
-          "name": "path",
-          "required": true
-        }
-      },
-      "description": "Import a session file (JSONL, JSON)",
+      "args": {},
+      "description": "Check gateway and context capture proxy status",
       "examples": [
-        "<%= config.bin %> sessions import ~/.claude/projects/my-project/session-abc.jsonl",
-        "<%= config.bin %> sessions import ./copilot-export.json --tool vscode_copilot"
+        "<%= config.bin %> proxy status"
       ],
       "flags": {
         "api-url": {
@@ -2795,18 +2955,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "tool": {
-          "description": "Override tool detection (claude_code, cursor, vscode_copilot)",
-          "name": "tool",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sessions:import",
+      "id": "proxy:status",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2816,17 +2969,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "sessions",
-        "import.js"
+        "proxy",
+        "status.js"
       ]
     },
-    "sessions:list": {
+    "proxy:stop": {
       "aliases": [],
       "args": {},
-      "description": "List captured sessions",
+      "description": "Stop the context capture proxy",
       "examples": [
-        "<%= config.bin %> sessions list",
-        "<%= config.bin %> sessions list --tool claude_code"
+        "<%= config.bin %> proxy stop"
       ],
       "flags": {
         "api-url": {
@@ -2837,26 +2989,11 @@
           "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": "sessions:list",
+      "id": "proxy:stop",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2866,18 +3003,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "sessions",
-        "list.js"
+        "proxy",
+        "stop.js"
       ]
     },
-    "sessions:start": {
+    "research:backfill": {
       "aliases": [],
       "args": {},
-      "description": "Start a capture session for any LLM provider (Cortex, Groq, etc.)",
+      "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 %> 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 %> research backfill",
+        "<%= config.bin %> research backfill --claude-dir /custom/.claude --dry-run"
       ],
       "flags": {
         "api-url": {
@@ -2889,27 +3025,24 @@
           "multiple": false,
           "type": "option"
         },
-        "tool": {
-          "char": "t",
-          "description": "LLM provider or tool name (e.g., cortex, groq, deepseek, custom_app)",
-          "name": "tool",
-          "required": true,
+        "claude-dir": {
+          "description": "Override the Claude Code projects directory",
+          "name": "claude-dir",
+          "default": "/home/runner/.claude",
           "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"
+        "dry-run": {
+          "description": "Print observation count without POSTing",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sessions:start",
+      "id": "research:backfill",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2919,14 +3052,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "sessions",
-        "start.js"
+        "research",
+        "backfill.js"
       ]
     },
-    "signals:report": {
+    "research:tail-transcript": {
       "aliases": [],
-      "args": {},
-      "description": "Report filesystem-detected languages for the current project to the server.",
+      "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",
@@ -2937,18 +3076,17 @@
           "multiple": false,
           "type": "option"
         },
-        "cwd": {
-          "description": "Project path to inspect (defaults to process.cwd())",
-          "name": "cwd",
-          "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": "signals:report",
+      "id": "research:tail-transcript",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -2958,17 +3096,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "signals",
-        "report.js"
+        "research",
+        "tail-transcript.js"
       ]
     },
-    "skills:export-approved": {
+    "service:install": {
       "aliases": [],
       "args": {},
-      "description": "Export approved community submissions as community-skills.json for registry merge",
+      "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 %> skills export-approved",
-        "<%= config.bin %> skills export-approved --output ./community-skills.json"
+        "<%= 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": {
@@ -2980,18 +3121,44 @@
           "multiple": false,
           "type": "option"
         },
-        "output": {
-          "description": "Output file path",
-          "name": "output",
-          "default": "packages/skills-registry/community-skills.json",
+        "port": {
+          "char": "p",
+          "description": "API server port",
+          "name": "port",
+          "default": 3000,
           "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,
       "hiddenAliases": [],
-      "id": "skills:export-approved",
+      "id": "service:install",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3001,25 +3168,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "skills",
-        "export-approved.js"
+        "service",
+        "install.js"
       ]
     },
-    "skills:install": {
+    "service:status": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Skill ID to install",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Install a skill from the registry into your project",
-      "examples": [
-        "<%= config.bin %> skills install tdd-workflow",
-        "<%= config.bin %> skills install tdd-workflow --tool cursor",
-        "<%= config.bin %> skills install tdd-workflow --preview"
-      ],
+      "args": {},
+      "description": "Check the status of all RuleMetric launchd services",
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -3029,37 +3185,11 @@
           "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": "skills:install",
+      "id": "service:status",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3069,18 +3199,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "skills",
-        "install.js"
+        "service",
+        "status.js"
       ]
     },
-    "skills:list": {
+    "service:uninstall": {
       "aliases": [],
       "args": {},
-      "description": "List skills in the registry",
-      "examples": [
-        "<%= config.bin %> skills list",
-        "<%= config.bin %> skills list --stats"
-      ],
+      "description": "Remove RuleMetric services (macOS launchd: API/worker/gateway/proxy; Linux: the --worker-only systemd unit)",
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -3090,25 +3216,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": "service:uninstall",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3118,23 +3230,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "skills",
-        "list.js"
+        "service",
+        "uninstall.js"
       ]
     },
-    "skills:publish": {
+    "sessions:analyze": {
       "aliases": [],
       "args": {
-        "file": {
-          "description": "Path to skill file (.md)",
-          "name": "file",
+        "id": {
+          "description": "Session ID",
+          "name": "id",
           "required": true
         }
       },
-      "description": "Submit a skill file to the RuleMetric skills registry",
+      "description": "Trigger AI analysis on a session",
       "examples": [
-        "<%= config.bin %> skills publish ./my-skill.md",
-        "<%= config.bin %> skills publish ./my-skill.md --category workflow --tool claude_code"
+        "<%= config.bin %> sessions analyze <session-id>"
       ],
       "flags": {
         "api-url": {
@@ -3145,69 +3256,11 @@
           "hasDynamicHelp": false,
           "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": "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"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "skills:publish",
+      "id": "sessions:analyze",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3217,24 +3270,16 @@
       "relativePath": [
         "dist",
         "commands",
-        "skills",
-        "publish.js"
+        "sessions",
+        "analyze.js"
       ]
     },
-    "skills:search": {
+    "sessions:end": {
       "aliases": [],
-      "args": {
-        "query": {
-          "description": "Search term",
-          "name": "query",
-          "required": false
-        }
-      },
-      "description": "Search the community skills registry",
+      "args": {},
+      "description": "End the active capture session",
       "examples": [
-        "<%= config.bin %> skills search \"tdd\"",
-        "<%= config.bin %> skills search --tool cursor --category testing",
-        "<%= config.bin %> skills search --language python"
+        "<%= config.bin %> sessions end"
       ],
       "flags": {
         "api-url": {
@@ -3245,67 +3290,11 @@
           "hasDynamicHelp": false,
           "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",
-          "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": {
-          "description": "Max results",
-          "name": "limit",
-          "default": 20,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "skills:search",
+      "id": "sessions:end",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3315,17 +3304,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "skills",
-        "search.js"
+        "sessions",
+        "end.js"
       ]
     },
-    "skills:update": {
+    "sessions:import": {
       "aliases": [],
-      "args": {},
-      "description": "Fetch latest skills from GitHub sources and update local registry",
+      "args": {
+        "path": {
+          "description": "Path to session file",
+          "name": "path",
+          "required": true
+        }
+      },
+      "description": "Import a session file (JSONL, JSON)",
       "examples": [
-        "<%= config.bin %> skills update",
-        "<%= config.bin %> skills update --all"
+        "<%= config.bin %> sessions import ~/.claude/projects/my-project/session-abc.jsonl",
+        "<%= config.bin %> sessions import ./copilot-export.json --tool vscode_copilot"
       ],
       "flags": {
         "api-url": {
@@ -3337,16 +3332,17 @@
           "multiple": false,
           "type": "option"
         },
-        "all": {
-          "description": "Include Tier 2 (niche) sources",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
+        "tool": {
+          "description": "Override tool detection (claude_code, cursor, vscode_copilot)",
+          "name": "tool",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "skills:update",
+      "id": "sessions:import",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3356,22 +3352,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "skills",
-        "update.js"
+        "sessions",
+        "import.js"
       ]
     },
-    "suggestions:accept": {
+    "sessions:list": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Suggestion UUID from `suggestions list`",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Accept a suggestion and append the instruction to CLAUDE.md",
+      "args": {},
+      "description": "List captured sessions",
       "examples": [
-        "<%= config.bin %> suggestions accept <id>"
+        "<%= config.bin %> sessions list",
+        "<%= config.bin %> sessions list --tool claude_code"
       ],
       "flags": {
         "api-url": {
@@ -3382,11 +3373,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": "suggestions:accept",
+      "id": "sessions:list",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3396,22 +3402,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "suggestions",
-        "accept.js"
+        "sessions",
+        "list.js"
       ]
     },
-    "suggestions:dismiss": {
+    "sessions:start": {
       "aliases": [],
-      "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",
+      "args": {},
+      "description": "Start a capture session for any LLM provider (Cortex, Groq, etc.)",
       "examples": [
-        "<%= config.bin %> suggestions dismiss <id>"
+        "<%= 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": {
@@ -3422,11 +3424,28 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "tool": {
+          "char": "t",
+          "description": "LLM provider or tool name (e.g., cortex, groq, deepseek, custom_app)",
+          "name": "tool",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "project-dir": {
+          "char": "d",
+          "description": "Project directory (defaults to cwd)",
+          "name": "project-dir",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "suggestions:dismiss",
+      "id": "sessions:start",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3436,18 +3455,14 @@
       "relativePath": [
         "dist",
         "commands",
-        "suggestions",
-        "dismiss.js"
+        "sessions",
+        "start.js"
       ]
     },
-    "suggestions:list": {
+    "signals:report": {
       "aliases": [],
       "args": {},
-      "description": "List instruction suggestions for a project",
-      "examples": [
-        "<%= config.bin %> suggestions list",
-        "<%= config.bin %> suggestions list --project /path/to/project"
-      ],
+      "description": "Report filesystem-detected languages for the current project to the server.",
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -3458,18 +3473,18 @@
           "multiple": false,
           "type": "option"
         },
-        "project": {
-          "char": "p",
-          "description": "Project path (defaults to current directory)",
-          "name": "project",
+        "cwd": {
+          "description": "Project path to inspect (defaults to process.cwd())",
+          "name": "cwd",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
+      "hidden": true,
       "hiddenAliases": [],
-      "id": "suggestions:list",
+      "id": "signals:report",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3479,16 +3494,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "suggestions",
-        "list.js"
+        "signals",
+        "report.js"
       ]
     },
-    "suggestions:refresh": {
+    "skills:export-approved": {
       "aliases": [],
       "args": {},
-      "description": "Information about refreshing instruction suggestions",
+      "description": "Export approved community submissions as community-skills.json for registry merge",
       "examples": [
-        "<%= config.bin %> suggestions refresh"
+        "<%= config.bin %> skills export-approved",
+        "<%= config.bin %> skills export-approved --output ./community-skills.json"
       ],
       "flags": {
         "api-url": {
@@ -3499,11 +3515,19 @@
           "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": "suggestions:refresh",
+      "id": "skills:export-approved",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3513,22 +3537,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "suggestions",
-        "refresh.js"
+        "skills",
+        "export-approved.js"
       ]
     },
-    "instructions:create": {
+    "skills:install": {
       "aliases": [],
       "args": {
-        "file": {
-          "description": "Path to markdown file",
-          "name": "file"
+        "id": {
+          "description": "Skill ID to install",
+          "name": "id",
+          "required": true
         }
       },
-      "description": "Create a new instruction",
+      "description": "Install a skill from the registry into your project",
       "examples": [
-        "<%= config.bin %> instructions create ./my-instruction.md --name \"My Rules\"",
-        "<%= config.bin %> instructions create ./rules.md -n \"Rules\" -s project"
+        "<%= config.bin %> skills install tdd-workflow",
+        "<%= config.bin %> skills install tdd-workflow --tool cursor",
+        "<%= config.bin %> skills install tdd-workflow --preview"
       ],
       "flags": {
         "api-url": {
@@ -3540,50 +3566,28 @@
           "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",
+        "tool": {
+          "description": "Target tool format",
+          "name": "tool",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "org",
-            "team",
-            "project",
-            "personal"
+            "claude_code",
+            "cursor",
+            "copilot"
           ],
           "type": "option"
         },
-        "scope-ref": {
-          "description": "Scope reference UUID",
-          "name": "scope-ref",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "preview": {
+          "description": "Preview content without writing",
+          "name": "preview",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "tags": {
-          "char": "t",
-          "description": "Comma-separated tags",
-          "name": "tags",
+        "dir": {
+          "description": "Project directory",
+          "name": "dir",
+          "default": ".",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3591,7 +3595,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "instructions:create",
+      "id": "skills:install",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3601,23 +3605,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "instructions",
-        "create.js"
+        "skills",
+        "install.js"
       ]
     },
-    "instructions:delete": {
+    "skills:list": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Instruction ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Delete (archive) an instruction",
+      "args": {},
+      "description": "List skills in the registry",
       "examples": [
-        "<%= config.bin %> instructions delete <id>",
-        "<%= config.bin %> instructions delete <id> --force"
+        "<%= config.bin %> skills list",
+        "<%= config.bin %> skills list --stats"
       ],
       "flags": {
         "api-url": {
@@ -3629,17 +3627,24 @@
           "multiple": false,
           "type": "option"
         },
-        "force": {
-          "char": "f",
-          "description": "Skip confirmation prompt",
-          "name": "force",
+        "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": "instructions:delete",
+      "id": "skills:list",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3649,22 +3654,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "instructions",
-        "delete.js"
+        "skills",
+        "list.js"
       ]
     },
-    "instructions:fork": {
+    "skills:publish": {
       "aliases": [],
       "args": {
-        "id": {
-          "description": "ID of the instruction to fork",
-          "name": "id",
+        "file": {
+          "description": "Path to skill file (.md)",
+          "name": "file",
           "required": true
         }
       },
-      "description": "Fork an instruction to your personal scope",
+      "description": "Submit a skill file to the RuleMetric skills registry",
       "examples": [
-        "<%= config.bin %> instructions fork <instruction-id>"
+        "<%= config.bin %> skills publish ./my-skill.md",
+        "<%= config.bin %> skills publish ./my-skill.md --category workflow --tool claude_code"
       ],
       "flags": {
         "api-url": {
@@ -3675,11 +3681,69 @@
           "hasDynamicHelp": false,
           "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": "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"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "instructions:fork",
+      "id": "skills:publish",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3689,32 +3753,26 @@
       "relativePath": [
         "dist",
         "commands",
-        "instructions",
-        "fork.js"
+        "skills",
+        "publish.js"
       ]
     },
-    "instructions:get": {
+    "skills:search": {
       "aliases": [],
       "args": {
-        "id": {
-          "description": "Instruction ID",
-          "name": "id",
-          "required": true
+        "query": {
+          "description": "Search term",
+          "name": "query",
+          "required": false
         }
       },
-      "description": "Get an instruction by ID",
+      "description": "Search the community skills registry",
       "examples": [
-        "<%= config.bin %> instructions get <id>",
-        "<%= config.bin %> instructions get <id> --format raw"
+        "<%= config.bin %> skills search \"tdd\"",
+        "<%= config.bin %> skills search --tool cursor --category testing",
+        "<%= config.bin %> skills search --language python"
       ],
       "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",
@@ -3724,53 +3782,88 @@
           "multiple": false,
           "type": "option"
         },
-        "format": {
-          "char": "f",
-          "description": "Output format",
-          "name": "format",
-          "default": "yaml",
+        "tool": {
+          "description": "Filter by tool",
+          "name": "tool",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "yaml",
-            "json",
-            "raw"
+            "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": {
+          "description": "Max results",
+          "name": "limit",
+          "default": 20,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "instructions:get",
+      "id": "skills:search",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
+      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "instructions",
-        "get.js"
+        "skills",
+        "search.js"
       ]
     },
-    "instructions:list": {
+    "skills:update": {
       "aliases": [],
       "args": {},
-      "description": "List your instructions",
+      "description": "Fetch latest skills from GitHub sources and update local registry",
       "examples": [
-        "<%= config.bin %> instructions list",
-        "<%= config.bin %> instructions list --json"
+        "<%= config.bin %> skills update",
+        "<%= config.bin %> skills update --all"
       ],
       "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",
@@ -3780,49 +3873,41 @@
           "multiple": false,
           "type": "option"
         },
-        "format": {
-          "char": "f",
-          "description": "Output format",
-          "name": "format",
-          "default": "table",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "table",
-            "json"
-          ],
-          "type": "option"
+        "all": {
+          "description": "Include Tier 2 (niche) sources",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "instructions:list",
+      "id": "skills:update",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
+      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "instructions",
-        "list.js"
+        "skills",
+        "update.js"
       ]
     },
-    "instructions:promote": {
+    "suggestions:accept": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "ID of the instruction to promote",
+          "description": "Suggestion UUID from `suggestions list`",
           "name": "id",
           "required": true
         }
       },
-      "description": "Promote an instruction to a higher scope (personal → team → org)",
+      "description": "Accept a suggestion and append the instruction to CLAUDE.md",
       "examples": [
-        "<%= config.bin %> instructions promote <id> --scope team --ref <team-id>",
-        "<%= config.bin %> instructions promote <id> --scope org --ref <org-id>"
+        "<%= config.bin %> suggestions accept <id>"
       ],
       "flags": {
         "api-url": {
@@ -3833,31 +3918,11 @@
           "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": "instructions:promote",
+      "id": "suggestions:accept",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3867,20 +3932,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "instructions",
-        "promote.js"
+        "suggestions",
+        "accept.js"
       ]
     },
-    "instructions:pull": {
+    "suggestions:dismiss": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "ID of the forked instruction",
+          "description": "Suggestion UUID from `suggestions list`",
           "name": "id",
           "required": true
         }
       },
-      "description": "Pull upstream changes into a forked instruction",
+      "description": "Dismiss a suggestion so it will not re-surface for 30 days",
+      "examples": [
+        "<%= config.bin %> suggestions dismiss <id>"
+      ],
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -3894,7 +3962,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "instructions:pull",
+      "id": "suggestions:dismiss",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3904,20 +3972,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "instructions",
-        "pull.js"
+        "suggestions",
+        "dismiss.js"
       ]
     },
-    "instructions:upstream": {
+    "suggestions:list": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "ID of the forked instruction",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Check if a forked instruction has upstream updates",
+      "args": {},
+      "description": "List instruction suggestions for a project",
+      "examples": [
+        "<%= config.bin %> suggestions list",
+        "<%= config.bin %> suggestions list --project /path/to/project"
+      ],
       "flags": {
         "api-url": {
           "description": "Override API base URL",
@@ -3927,11 +3993,19 @@
           "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": "instructions:upstream",
+      "id": "suggestions:list",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
@@ -3941,31 +4015,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "instructions",
-        "upstream.js"
+        "suggestions",
+        "list.js"
       ]
     },
-    "instructions:versions": {
+    "suggestions:refresh": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Instruction ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "List version history for an instruction",
+      "args": {},
+      "description": "Information about refreshing instruction suggestions",
       "examples": [
-        "<%= config.bin %> instructions versions <id>"
+        "<%= config.bin %> suggestions refresh"
       ],
       "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",
@@ -3978,20 +4039,20 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "instructions:versions",
+      "id": "suggestions:refresh",
       "pluginAlias": "@rulemetric/cli",
       "pluginName": "@rulemetric/cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
+      "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "instructions",
-        "versions.js"
+        "suggestions",
+        "refresh.js"
       ]
     }
   },
-  "version": "0.4.0"
+  "version": "0.5.1"
 }