rpi-kit 2.0.0 → 2.1.0

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "rpi-kit",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Research → Plan → Implement. 7-phase pipeline with 13 named agents, delta specs, party mode, and knowledge compounding.",
   "author": {
     "name": "Daniel Mendes",

package/README.md

@@ -50,6 +50,7 @@ Use `/rpi <feature>` to auto-detect the current phase and progress to the next o
 | `/rpi:party <topic>` | Multi-agent debate on any topic |
 | `/rpi:learn` | Save a solution or insight to the knowledge base |
 | `/rpi:archive <feature>` | Merge delta specs into `rpi/specs/` and clean up |
+| `/rpi:update` | Update RPIKit plugin to the latest version |
 | `/rpi:onboarding` | Guided first-time setup with codebase analysis |
 
 ## Agents

package/bin/cli.js

@@ -73,6 +73,107 @@ function installGeminiCLI() {
   return true;
 }
 
+function findInstalledPlugin() {
+  const home = process.env.HOME || process.env.USERPROFILE;
+  const searchDirs = [
+    path.join(home, ".claude", "plugins", "marketplaces", "rpi-kit"),
+    path.join(home, ".claude", "plugins", "installed", "rpi-kit"),
+  ];
+  for (const dir of searchDirs) {
+    if (fs.existsSync(path.join(dir, ".claude-plugin", "plugin.json"))) {
+      return dir;
+    }
+  }
+  // Glob fallback
+  const pluginsRoot = path.join(home, ".claude", "plugins");
+  if (fs.existsSync(pluginsRoot)) {
+    const { execFileSync } = require("child_process");
+    try {
+      const result = execFileSync("find", [pluginsRoot, "-path", "*/rpi-kit/.claude-plugin/plugin.json", "-maxdepth", 5], { encoding: "utf8" }).trim();
+      if (result) {
+        const pluginJson = result.split("\n")[0];
+        return path.resolve(pluginJson, "..", "..");
+      }
+    } catch {}
+  }
+  return null;
+}
+
+function updatePlugin() {
+  const pluginDir = findInstalledPlugin();
+  if (!pluginDir) {
+    log("RPIKit installation not found in ~/.claude/plugins/.");
+    log("Install first: claude plugin install rpi-kit");
+    return false;
+  }
+
+  const gitDir = path.join(pluginDir, ".git");
+  if (!fs.existsSync(gitDir)) {
+    log("Installed plugin has no .git directory — cannot update via git pull.");
+    log("Re-install to enable updates:");
+    log("  claude plugin remove rpi-kit");
+    log("  claude plugin install git@github.com:dmend3z/rpi-kit.git");
+    return false;
+  }
+
+  // Current version
+  let currentVersion = "unknown";
+  try {
+    const pj = JSON.parse(fs.readFileSync(path.join(pluginDir, ".claude-plugin", "plugin.json"), "utf8"));
+    currentVersion = pj.version || "unknown";
+  } catch {}
+
+  const currentCommit = spawnSync("git", ["-C", pluginDir, "rev-parse", "--short", "HEAD"], { encoding: "utf8" });
+  const oldCommit = (currentCommit.stdout || "").trim();
+
+  log(`Current: v${currentVersion} (${oldCommit})`);
+  log("Pulling latest...");
+
+  const pull = spawnSync("git", ["-C", pluginDir, "pull", "origin", "main"], { encoding: "utf8", stdio: "pipe" });
+
+  if (pull.status !== 0) {
+    log("Git pull failed:");
+    log(pull.stderr || pull.stdout || "Unknown error");
+    return false;
+  }
+
+  if ((pull.stdout || "").includes("Already up to date")) {
+    log("Already up to date.");
+    return true;
+  }
+
+  // New version
+  let newVersion = "unknown";
+  try {
+    const pj = JSON.parse(fs.readFileSync(path.join(pluginDir, ".claude-plugin", "plugin.json"), "utf8"));
+    newVersion = pj.version || "unknown";
+  } catch {}
+
+  const newCommit = spawnSync("git", ["-C", pluginDir, "rev-parse", "--short", "HEAD"], { encoding: "utf8" });
+  const newHash = (newCommit.stdout || "").trim();
+
+  // Changelog
+  if (oldCommit) {
+    const changelog = spawnSync("git", ["-C", pluginDir, "log", "--oneline", `${oldCommit}..${newHash}`], { encoding: "utf8" });
+    if (changelog.stdout) {
+      log(`\nv${currentVersion} (${oldCommit}) → v${newVersion} (${newHash})\n`);
+      log("Changes:");
+      log(changelog.stdout.trim());
+    }
+  }
+
+  // Clear cache
+  const home = process.env.HOME || process.env.USERPROFILE;
+  const cacheDir = path.join(home, ".claude", "plugins", "cache", "rpi-kit");
+  if (fs.existsSync(cacheDir)) {
+    fs.rmSync(cacheDir, { recursive: true, force: true });
+    log("\nPlugin cache cleared.");
+  }
+
+  log("\nRestart Claude Code to load the new version.");
+  return true;
+}
+
 function uninstallClaude() {
   log("Removing RPIKit from Claude Code...");
   try {
@@ -99,11 +200,12 @@ Usage:
   rpi-kit install --claude   Install for Claude Code only
   rpi-kit install --codex    Install for Codex only (copies AGENTS.md to cwd)
   rpi-kit install --gemini   Install for Gemini CLI only
+  rpi-kit update             Update installed plugin to latest version
   rpi-kit uninstall          Remove from Claude Code
   rpi-kit onboarding         Interactive walkthrough of the workflow
   rpi-kit help               Show this help
 
-Commands (14):
+Commands (15):
   /rpi:new <feature>         Describe your feature → REQUEST.md
   /rpi:research <feature>    Parallel agent analysis → RESEARCH.md
   /rpi:plan <feature>        Generate specs + tasks → PLAN.md
@@ -116,6 +218,7 @@ Commands (14):
   /rpi:status                Show all features and their phases
   /rpi <feature>             Auto-progress to next phase
   /rpi:onboarding            Guided first-time setup
+  /rpi:update                Update plugin to latest version
   /rpi:learn [description]   Capture a solution to knowledge base
   /rpi:archive <feature>     Archive a completed feature
   /rpi:party                 Multi-agent debate on any topic
@@ -238,6 +341,10 @@ async function run() {
       break;
     }
 
+    case "update":
+      updatePlugin();
+      break;
+
     case "onboarding": {
       const { run } = require("./onboarding");
       run();

package/commands/rpi/update.md

@@ -0,0 +1,113 @@
+---
+name: rpi:update
+description: Update RPIKit plugin to the latest version from the remote repository.
+argument-hint: ""
+allowed-tools:
+  - Bash
+  - Read
+  - Glob
+---
+
+# /rpi:update — Update RPIKit
+
+Pull the latest version of RPIKit from the remote repository and clear the plugin cache.
+
+---
+
+## Step 1: Find the installed plugin directory
+
+Search for the RPIKit installation:
+
+```bash
+find ~/.claude/plugins -name "plugin.json" -path "*/rpi-kit/*" 2>/dev/null
+```
+
+From the results, determine the plugin root directory (the parent of `.claude-plugin/`).
+
+If not found:
+```
+RPIKit installation not found in ~/.claude/plugins/.
+Re-install from the marketplace or run:
+  claude plugin add git@github.com:dmend3z/rpi-kit.git
+```
+Stop.
+
+Store the plugin root path as `$PLUGIN_DIR`.
+
+## Step 2: Show current version
+
+Read `$PLUGIN_DIR/.claude-plugin/plugin.json` and extract the current `version` field.
+Store as `$CURRENT_VERSION`.
+
+Also get the current git commit:
+
+```bash
+cd $PLUGIN_DIR && git rev-parse --short HEAD
+```
+
+Store as `$CURRENT_COMMIT`.
+
+## Step 3: Pull latest changes
+
+Run git pull in the plugin directory:
+
+```bash
+cd $PLUGIN_DIR && git pull origin main 2>&1
+```
+
+If it fails:
+- If "not a git repository": report the error and suggest re-installing.
+- If merge conflict: report the error and suggest `cd $PLUGIN_DIR && git reset --hard origin/main` (ask user first — this discards local changes).
+- If network error: report "Could not reach remote. Check your connection."
+- Stop on any error.
+
+If output says "Already up to date.":
+```
+RPIKit is already up to date (v{$CURRENT_VERSION}, {$CURRENT_COMMIT}).
+```
+Stop.
+
+## Step 4: Show what changed
+
+Get the new version:
+
+```bash
+cd $PLUGIN_DIR && cat .claude-plugin/plugin.json | grep '"version"'
+```
+
+Store as `$NEW_VERSION`.
+
+Get the new commit:
+
+```bash
+cd $PLUGIN_DIR && git rev-parse --short HEAD
+```
+
+Store as `$NEW_COMMIT`.
+
+Show the changelog between old and new commits:
+
+```bash
+cd $PLUGIN_DIR && git log --oneline $CURRENT_COMMIT..$NEW_COMMIT
+```
+
+## Step 5: Clear plugin cache
+
+Remove cached versions so Claude Code picks up the new files:
+
+```bash
+rm -rf ~/.claude/plugins/cache/rpi-kit 2>/dev/null
+```
+
+## Step 6: Output summary
+
+```
+RPIKit updated!
+
+{$CURRENT_VERSION} ({$CURRENT_COMMIT}) → {$NEW_VERSION} ({$NEW_COMMIT})
+
+Changes:
+{git log output from step 4}
+
+Restart Claude Code to load the new version.
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rpi-kit",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Research → Plan → Implement. AI-assisted feature development with 13 named agents, delta specs, and knowledge compounding.",
   "license": "MIT",
   "author": "Daniel Mendes",

package/skills/rpi-workflow/SKILL.md

@@ -149,6 +149,7 @@ Output is saved to `rpi/solutions/decisions/` when requested.
 /rpi:party      -- multi-agent debate on any topic
 /rpi:learn      -- manually capture a solution/insight
 /rpi:archive    -- merge delta into specs, delete feature folder
+/rpi:update      -- update RPIKit to the latest version from remote
 /rpi:onboarding -- first-time setup, analyzes codebase, guides the user
 ```