@hanzlaa/rcode 2.4.1 → 2.5.1

package/cli/install.js

@@ -116,6 +116,7 @@ function parseArgs(argv) {
     language: 'English',
     mode: 'guided',
     ide: 'claude',  // claude, cursor, gemini (copilot = TODO)
+    ideProvided: false, // true when --ide is passed explicitly — skip interactive prompt
     help: false,
     modules: [],  // --module core --module execution or empty = all
     // #189 — planning commit policy. null = ask interactively (or default true under --yes).
@@ -143,7 +144,7 @@ function parseArgs(argv) {
     else if (arg === '--project') opts.projectName = argv[++i];
     else if (arg === '--language') opts.language = argv[++i];
     else if (arg === '--mode') opts.mode = argv[++i];
-    else if (arg === '--ide') opts.ide = argv[++i];
+    else if (arg === '--ide') { opts.ide = argv[++i]; opts.ideProvided = true; }
     else if (arg === '--module') opts.modules.push(argv[++i]);
     else if (arg === '--commit-planning') opts.commitPlanning = true;
     else if (arg === '--no-commit-planning' || arg === '--ignore-planning') opts.commitPlanning = false;
@@ -163,6 +164,102 @@ function parseArgs(argv) {
   return opts;
 }
 
+/**
+ * Print the Rihal Memory Bank installer header. Box-drawn banner shown once
+ * at the top of every interactive install run.
+ */
+function printInstallHeader(targetVersion) {
+  const v = targetVersion || readPackageVersion();
+  const lines = [
+    '',
+    pc.cyan('╭───────────────────────────────────────────────────────────╮'),
+    pc.cyan('│') + '                                                           ' + pc.cyan('│'),
+    pc.cyan('│') + '   ' + pc.bold(pc.yellow('🕌  Rihal Memory Bank')) + '  ' + dim('— installer') + '                       ' + pc.cyan('│'),
+    pc.cyan('│') + '   ' + dim('A persistent context-brain for your editor') + '             ' + pc.cyan('│'),
+    pc.cyan('│') + '                                                           ' + pc.cyan('│'),
+    pc.cyan('│') + '   ' + dim('version  ') + pc.green('v' + v) + '                                          ' + pc.cyan('│'),
+    pc.cyan('│') + '   ' + dim('docs     ') + 'github.com/hanzla-habib/rihal-code              ' + pc.cyan('│'),
+    pc.cyan('│') + '                                                           ' + pc.cyan('│'),
+    pc.cyan('╰───────────────────────────────────────────────────────────╯'),
+    '',
+  ];
+  console.log(lines.join('\n'));
+}
+
+/**
+ * Detect which IDEs the user likely uses. Soft signals only — never rejects,
+ * just biases the default selection in the interactive prompt.
+ * Returns a set like { claude: true, cursor: false, gemini: false }.
+ */
+function detectIdeSignals(target) {
+  const signals = { claude: false, cursor: false, gemini: false };
+  // 1. Project-local install dirs (strongest signal — they already use one)
+  if (fs.existsSync(path.join(target, '.claude'))) signals.claude = true;
+  if (fs.existsSync(path.join(target, '.cursor'))) signals.cursor = true;
+  if (fs.existsSync(path.join(target, '.gemini'))) signals.gemini = true;
+  // 2. User-level config dirs
+  const home = os.homedir();
+  if (fs.existsSync(path.join(home, '.claude'))) signals.claude = true;
+  if (fs.existsSync(path.join(home, '.cursor'))) signals.cursor = true;
+  if (fs.existsSync(path.join(home, '.config', 'Cursor'))) signals.cursor = true;
+  if (fs.existsSync(path.join(home, '.gemini'))) signals.gemini = true;
+  // 3. Env vars commonly set by editor terminals
+  if (process.env.CURSOR_TRACE_ID || /cursor/i.test(process.env.TERM_PROGRAM || '')) signals.cursor = true;
+  if (process.env.CLAUDECODE === '1' || process.env.CLAUDE_CODE_ENTRYPOINT) signals.claude = true;
+  return signals;
+}
+
+/**
+ * Resolve target IDE — explicit --ide flag wins, then interactive prompt
+ * (when TTY + not --yes + not --ideProvided), else default to 'claude'.
+ *
+ * Closes the gap where users got auto-installed to claude even when they
+ * actually wanted cursor or gemini.
+ */
+async function resolveIde(opts) {
+  if (opts.ideProvided) return opts.ide;            // user passed --ide, respect it
+  if (opts.yes || !process.stdin.isTTY) return opts.ide || 'claude';
+
+  const signals = detectIdeSignals(opts.target);
+  const detected = ['claude', 'cursor', 'gemini'].filter(k => signals[k]);
+
+  // Build the menu — detected IDEs marked with a hint
+  const choices = [
+    { key: '1', value: 'claude', label: 'Claude Code',  hint: signals.claude ? dim('(detected)') : '' },
+    { key: '2', value: 'cursor', label: 'Cursor',       hint: signals.cursor ? dim('(detected)') : '' },
+    { key: '3', value: 'gemini', label: 'Gemini CLI',   hint: signals.gemini ? dim('(detected)') : dim('(beta — limited)') },
+  ];
+
+  // Pick a default: prefer the single detected IDE; otherwise claude
+  let defaultValue = 'claude';
+  if (detected.length === 1) defaultValue = detected[0];
+
+  const readline = require('readline');
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const prompt = (q) => new Promise(r => rl.question(q, a => r(a)));
+
+  console.log(pc.bold('🎯 Which editor will you use Rihal with?'));
+  console.log('');
+  for (const c of choices) {
+    const marker = c.value === defaultValue ? pc.green('●') : dim('○');
+    const label = c.value === defaultValue ? pc.bold(c.label) : c.label;
+    console.log(`   ${marker} ${pc.cyan('[' + c.key + ']')} ${label}  ${c.hint}`);
+  }
+  console.log('');
+  const defaultKey = choices.find(c => c.value === defaultValue).key;
+  const answer = (await prompt(`   Pick an editor [${defaultKey}]: `)).trim().toLowerCase();
+  rl.close();
+
+  if (!answer) return defaultValue;
+  // Accept either the number key or the name
+  const byKey = choices.find(c => c.key === answer);
+  if (byKey) return byKey.value;
+  const byName = choices.find(c => c.value === answer || c.label.toLowerCase().startsWith(answer));
+  if (byName) return byName.value;
+  console.log(dim(`   Unrecognised choice "${answer}" — falling back to ${defaultValue}.`));
+  return defaultValue;
+}
+
 /**
  * Resolve commit-planning preference — CLI flag wins, then interactive
  * prompt (when TTY + not --yes), else GSD-style default: true.
@@ -1018,10 +1115,18 @@ function convertToCursorMdc(sourceText) {
 async function install(opts) {
   if (opts.help) { printHelp(); return 0; }
 
+  const pkgVersion = readPackageVersion();
+
+  // Header banner — only shown for interactive runs to keep CI/non-TTY logs terse.
+  const isInteractive = process.stdin.isTTY && !opts.yes;
+  if (isInteractive) printInstallHeader(pkgVersion);
+
+  // Resolve target IDE (interactive prompt unless --ide flag, --yes, or non-TTY).
+  opts.ide = await resolveIde(opts);
+
   // Resolve commit-planning preference (interactive prompt or flag) — #189.
   opts.commitPlanning = await resolveCommitPlanning(opts);
 
-  const pkgVersion = readPackageVersion();
   console.log(`\n🕌 ${bold('Rihal Code')} ${pc.cyan('v' + pkgVersion)} ${dim('→')} ${opts.target}`);
 
   // Detect an existing install and surface it (#195).

package/cli/uninstall.js

@@ -17,6 +17,10 @@
  *   --editor=claude|cursor|windsurf|antigravity|all   Limit scope
  *   --keep-state                                      Never touch .rihal/
  *   --delete-state                                    Also delete .rihal/ (skip prompt)
+ *   --purge / --all                                   Wipe everything — editor files,
+ *                                                       .rihal/, .planning/, gitignore block.
+ *                                                       Use when you want /rihal:init to
+ *                                                       report "fresh" on next install.
  *   --yes / -y                                        Skip the main confirmation
  */
 
@@ -32,6 +36,7 @@ function parseArgs(args) {
     keepState: false,       // if true, never delete .rihal/
     deleteState: false,     // if true, delete .rihal/ without prompting
     yes: false,             // skip the main confirmation
+    purge: false,           // wipe everything: editor files + .rihal/ + .planning/ + gitignore block
   };
   for (const arg of args) {
     if (arg.startsWith('--editor=')) {
@@ -42,6 +47,11 @@ function parseArgs(args) {
       opts.deleteState = true;
     } else if (arg === '--yes' || arg === '-y') {
       opts.yes = true;
+    } else if (arg === '--purge' || arg === '--all') {
+      // --purge implies --delete-state and removes .planning/ + gitignore block.
+      // Use this when you want a clean slate so /rihal:init reports "fresh" next time.
+      opts.purge = true;
+      opts.deleteState = true;
     }
   }
   return opts;
@@ -365,9 +375,14 @@ async function runUninstall(args) {
   console.log();
 
   // Fast path: is Rihal Code installed here at all? Check our own marker
-  // (.rihal/config.json) + any editor install trace. If nothing, exit cleanly
+  // (.rihal/config.yaml) + any editor install trace. If nothing, exit cleanly
   // with a clear message so users don't wonder "did it work?"
-  const hasConfig = fs.existsSync(path.join(cwd, '.rihal/config.json'));
+  // (Was checking config.json — a long-standing typo since the installer
+  // writes config.yaml. The check still worked thanks to the editor-files
+  // fallback, but a project with .rihal/ and no editor files would falsely
+  // report "not installed".)
+  const hasConfig = fs.existsSync(path.join(cwd, '.rihal/config.yaml'))
+    || fs.existsSync(path.join(cwd, '.rihal/config.json'));
   const hasAnyEditorFiles =
     fs.existsSync(path.join(cwd, '.claude/skills')) ||
     fs.existsSync(path.join(cwd, '.cursor/rules')) ||
@@ -565,9 +580,14 @@ async function runUninstall(args) {
     if (!opts.deleteState && !opts.keepState && !opts.yes) {
       console.log();
       console.log(`⚠️  The .rihal/ state directory contains your project data:`);
+      console.log(`   - config.yaml, state.json, RIHLA.md`);
       console.log(`   - phases, decisions, progress, artifacts, context`);
       console.log(`   - ${plan.stateDir.files} files total`);
       console.log();
+      console.log(`   If you keep it: /rihal:init will report "already configured"`);
+      console.log(`     and reuse your existing config + history on next install.`);
+      console.log(`   If you delete it: next install starts fresh — no carry-over.`);
+      console.log();
       shouldDeleteState = await askConfirm(
         `Also delete .rihal/ state? This is destructive and cannot be undone. [y/N] `,
         { default: 'n' },
@@ -582,11 +602,51 @@ async function runUninstall(args) {
     }
   }
 
+  // --purge: also wipe .planning/ artifacts and the rcode .gitignore block.
+  // Without this, "uninstall + reinstall" carries forward stale phases /
+  // sprints / SUMMARY files even after .rihal/ is gone.
+  if (opts.purge) {
+    const planningDir = path.join(cwd, '.planning');
+    if (fs.existsSync(planningDir)) {
+      fs.rmSync(planningDir, { recursive: true, force: true });
+      console.log(`   ✓ removed .planning/ (--purge)`);
+    }
+
+    // Strip the rcode-managed block from .gitignore. The installer writes
+    // a fenced block; we remove it cleanly without touching user lines.
+    const gitignorePath = path.join(cwd, '.gitignore');
+    if (fs.existsSync(gitignorePath)) {
+      try {
+        const before = fs.readFileSync(gitignorePath, 'utf8');
+        // Match either fenced markers or the legacy "# rcode" header through to
+        // the next blank line — both shapes the installer has used historically.
+        const stripped = before
+          .replace(/\n?# >>> rihal-code >>>[\s\S]*?# <<< rihal-code <<<\n?/g, '\n')
+          .replace(/\n?# rcode[\s\S]*?(?=\n\n|\n$|$)/g, '\n')
+          .replace(/\n{3,}/g, '\n\n');
+        if (stripped !== before) {
+          fs.writeFileSync(gitignorePath, stripped);
+          console.log(`   ✓ stripped rcode block from .gitignore (--purge)`);
+        }
+      } catch (err) {
+        console.log(`   ⚠ could not strip .gitignore block: ${err.message}`);
+      }
+    }
+  }
+
   console.log(`\n✅ Uninstall complete. Removed ${removed} files.`);
   if (backup.ok) {
     console.log(`   Backup: ${backup.path} (restore with: tar -xzf ${backup.path})`);
   }
 
+  // Hint about the purge flag if the user kept state — closes the user's
+  // most common confusion: "I uninstalled but /rihal:init still says configured."
+  if (plan.stateDir && fs.existsSync(path.join(cwd, '.rihal'))) {
+    console.log();
+    console.log(`ℹ  .rihal/ state was preserved. /rihal:init will detect this on reinstall.`);
+    console.log(`   For a fully clean slate next time, use: rcode uninstall --purge`);
+  }
+
   // Hint about reinstalling
   console.log(`\nTo reinstall later:`);
   console.log(`   rcode install`);

package/dist/rcode.js

@@ -15830,6 +15830,8 @@ var require_install = __commonJS({
         mode: "guided",
         ide: "claude",
         // claude, cursor, gemini (copilot = TODO)
+        ideProvided: false,
+        // true when --ide is passed explicitly — skip interactive prompt
         help: false,
         modules: [],
         // --module core --module execution or empty = all
@@ -15858,8 +15860,10 @@ var require_install = __commonJS({
         else if (arg === "--project") opts.projectName = argv[++i];
         else if (arg === "--language") opts.language = argv[++i];
         else if (arg === "--mode") opts.mode = argv[++i];
-        else if (arg === "--ide") opts.ide = argv[++i];
-        else if (arg === "--module") opts.modules.push(argv[++i]);
+        else if (arg === "--ide") {
+          opts.ide = argv[++i];
+          opts.ideProvided = true;
+        } else if (arg === "--module") opts.modules.push(argv[++i]);
         else if (arg === "--commit-planning") opts.commitPlanning = true;
         else if (arg === "--no-commit-planning" || arg === "--ignore-planning") opts.commitPlanning = false;
         else if (arg === "--non-destructive") opts.nonDestructive = true;
@@ -15877,6 +15881,71 @@ var require_install = __commonJS({
       if (!opts.projectName) opts.projectName = path2.basename(opts.target);
       return opts;
     }
+    function printInstallHeader(targetVersion) {
+      const v = targetVersion || readPackageVersion();
+      const lines = [
+        "",
+        pc.cyan("\u256D\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256E"),
+        pc.cyan("\u2502") + "                                                           " + pc.cyan("\u2502"),
+        pc.cyan("\u2502") + "   " + pc.bold(pc.yellow("\u{1F54C}  Rihal Memory Bank")) + "  " + dim("\u2014 installer") + "                       " + pc.cyan("\u2502"),
+        pc.cyan("\u2502") + "   " + dim("A persistent context-brain for your editor") + "             " + pc.cyan("\u2502"),
+        pc.cyan("\u2502") + "                                                           " + pc.cyan("\u2502"),
+        pc.cyan("\u2502") + "   " + dim("version  ") + pc.green("v" + v) + "                                          " + pc.cyan("\u2502"),
+        pc.cyan("\u2502") + "   " + dim("docs     ") + "github.com/hanzla-habib/rihal-code              " + pc.cyan("\u2502"),
+        pc.cyan("\u2502") + "                                                           " + pc.cyan("\u2502"),
+        pc.cyan("\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256F"),
+        ""
+      ];
+      console.log(lines.join("\n"));
+    }
+    function detectIdeSignals(target) {
+      const signals = { claude: false, cursor: false, gemini: false };
+      if (fs2.existsSync(path2.join(target, ".claude"))) signals.claude = true;
+      if (fs2.existsSync(path2.join(target, ".cursor"))) signals.cursor = true;
+      if (fs2.existsSync(path2.join(target, ".gemini"))) signals.gemini = true;
+      const home = os.homedir();
+      if (fs2.existsSync(path2.join(home, ".claude"))) signals.claude = true;
+      if (fs2.existsSync(path2.join(home, ".cursor"))) signals.cursor = true;
+      if (fs2.existsSync(path2.join(home, ".config", "Cursor"))) signals.cursor = true;
+      if (fs2.existsSync(path2.join(home, ".gemini"))) signals.gemini = true;
+      if (process.env.CURSOR_TRACE_ID || /cursor/i.test(process.env.TERM_PROGRAM || "")) signals.cursor = true;
+      if (process.env.CLAUDECODE === "1" || process.env.CLAUDE_CODE_ENTRYPOINT) signals.claude = true;
+      return signals;
+    }
+    async function resolveIde(opts) {
+      if (opts.ideProvided) return opts.ide;
+      if (opts.yes || !process.stdin.isTTY) return opts.ide || "claude";
+      const signals = detectIdeSignals(opts.target);
+      const detected = ["claude", "cursor", "gemini"].filter((k) => signals[k]);
+      const choices = [
+        { key: "1", value: "claude", label: "Claude Code", hint: signals.claude ? dim("(detected)") : "" },
+        { key: "2", value: "cursor", label: "Cursor", hint: signals.cursor ? dim("(detected)") : "" },
+        { key: "3", value: "gemini", label: "Gemini CLI", hint: signals.gemini ? dim("(detected)") : dim("(beta \u2014 limited)") }
+      ];
+      let defaultValue = "claude";
+      if (detected.length === 1) defaultValue = detected[0];
+      const readline = require("readline");
+      const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+      const prompt = (q) => new Promise((r) => rl.question(q, (a) => r(a)));
+      console.log(pc.bold("\u{1F3AF} Which editor will you use Rihal with?"));
+      console.log("");
+      for (const c of choices) {
+        const marker = c.value === defaultValue ? pc.green("\u25CF") : dim("\u25CB");
+        const label = c.value === defaultValue ? pc.bold(c.label) : c.label;
+        console.log(`   ${marker} ${pc.cyan("[" + c.key + "]")} ${label}  ${c.hint}`);
+      }
+      console.log("");
+      const defaultKey = choices.find((c) => c.value === defaultValue).key;
+      const answer = (await prompt(`   Pick an editor [${defaultKey}]: `)).trim().toLowerCase();
+      rl.close();
+      if (!answer) return defaultValue;
+      const byKey = choices.find((c) => c.key === answer);
+      if (byKey) return byKey.value;
+      const byName = choices.find((c) => c.value === answer || c.label.toLowerCase().startsWith(answer));
+      if (byName) return byName.value;
+      console.log(dim(`   Unrecognised choice "${answer}" \u2014 falling back to ${defaultValue}.`));
+      return defaultValue;
+    }
     async function resolveCommitPlanning(opts) {
       if (opts.commitPlanning !== null) return opts.commitPlanning;
       if (opts.yes || !process.stdin.isTTY) return true;
@@ -16555,8 +16624,11 @@ Say "plan a sprint" or run \`/rihal:sprint-planning\` to break Phase 01 into sto
         printHelp2();
         return 0;
       }
-      opts.commitPlanning = await resolveCommitPlanning(opts);
       const pkgVersion = readPackageVersion();
+      const isInteractive = process.stdin.isTTY && !opts.yes;
+      if (isInteractive) printInstallHeader(pkgVersion);
+      opts.ide = await resolveIde(opts);
+      opts.commitPlanning = await resolveCommitPlanning(opts);
       console.log(`
 \u{1F54C} ${bold("Rihal Code")} ${pc.cyan("v" + pkgVersion)} ${dim("\u2192")} ${opts.target}`);
       const existingManifestPath = path2.join(opts.target, ".rihal", "_config", "manifest.yaml");
@@ -17793,8 +17865,10 @@ var require_uninstall = __commonJS({
         // if true, never delete .rihal/
         deleteState: false,
         // if true, delete .rihal/ without prompting
-        yes: false
+        yes: false,
         // skip the main confirmation
+        purge: false
+        // wipe everything: editor files + .rihal/ + .planning/ + gitignore block
       };
       for (const arg of args) {
         if (arg.startsWith("--editor=")) {
@@ -17805,6 +17879,9 @@ var require_uninstall = __commonJS({
           opts.deleteState = true;
         } else if (arg === "--yes" || arg === "-y") {
           opts.yes = true;
+        } else if (arg === "--purge" || arg === "--all") {
+          opts.purge = true;
+          opts.deleteState = true;
         }
       }
       return opts;
@@ -18037,7 +18114,7 @@ var require_uninstall = __commonJS({
       console.log(`   Project: ${cwd}`);
       console.log(`   Scope:   ${editors.join(", ")}`);
       console.log();
-      const hasConfig = fs2.existsSync(path2.join(cwd, ".rihal/config.json"));
+      const hasConfig = fs2.existsSync(path2.join(cwd, ".rihal/config.yaml")) || fs2.existsSync(path2.join(cwd, ".rihal/config.json"));
       const hasAnyEditorFiles = fs2.existsSync(path2.join(cwd, ".claude/skills")) || fs2.existsSync(path2.join(cwd, ".cursor/rules")) || fs2.existsSync(path2.join(cwd, ".windsurf/rules")) || fs2.existsSync(path2.join(cwd, ".antigravity/agents"));
       if (!hasConfig && !hasAnyEditorFiles) {
         console.log(`
@@ -18202,9 +18279,14 @@ var require_uninstall = __commonJS({
         if (!opts.deleteState && !opts.keepState && !opts.yes) {
           console.log();
           console.log(`\u26A0\uFE0F  The .rihal/ state directory contains your project data:`);
+          console.log(`   - config.yaml, state.json, RIHLA.md`);
           console.log(`   - phases, decisions, progress, artifacts, context`);
           console.log(`   - ${plan.stateDir.files} files total`);
           console.log();
+          console.log(`   If you keep it: /rihal:init will report "already configured"`);
+          console.log(`     and reuse your existing config + history on next install.`);
+          console.log(`   If you delete it: next install starts fresh \u2014 no carry-over.`);
+          console.log();
           shouldDeleteState = await askConfirm(
             `Also delete .rihal/ state? This is destructive and cannot be undone. [y/N] `,
             { default: "n" }
@@ -18217,11 +18299,36 @@ var require_uninstall = __commonJS({
           console.log(`   \u2139 kept .rihal/ state directory (your project data is preserved)`);
         }
       }
+      if (opts.purge) {
+        const planningDir = path2.join(cwd, ".planning");
+        if (fs2.existsSync(planningDir)) {
+          fs2.rmSync(planningDir, { recursive: true, force: true });
+          console.log(`   \u2713 removed .planning/ (--purge)`);
+        }
+        const gitignorePath = path2.join(cwd, ".gitignore");
+        if (fs2.existsSync(gitignorePath)) {
+          try {
+            const before = fs2.readFileSync(gitignorePath, "utf8");
+            const stripped = before.replace(/\n?# >>> rihal-code >>>[\s\S]*?# <<< rihal-code <<<\n?/g, "\n").replace(/\n?# rcode[\s\S]*?(?=\n\n|\n$|$)/g, "\n").replace(/\n{3,}/g, "\n\n");
+            if (stripped !== before) {
+              fs2.writeFileSync(gitignorePath, stripped);
+              console.log(`   \u2713 stripped rcode block from .gitignore (--purge)`);
+            }
+          } catch (err) {
+            console.log(`   \u26A0 could not strip .gitignore block: ${err.message}`);
+          }
+        }
+      }
       console.log(`
 \u2705 Uninstall complete. Removed ${removed} files.`);
       if (backup.ok) {
         console.log(`   Backup: ${backup.path} (restore with: tar -xzf ${backup.path})`);
       }
+      if (plan.stateDir && fs2.existsSync(path2.join(cwd, ".rihal"))) {
+        console.log();
+        console.log(`\u2139  .rihal/ state was preserved. /rihal:init will detect this on reinstall.`);
+        console.log(`   For a fully clean slate next time, use: rcode uninstall --purge`);
+      }
       console.log(`
 To reinstall later:`);
       console.log(`   rcode install`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hanzlaa/rcode",
-  "version": "2.4.1",
+  "version": "2.5.1",
   "description": "Rihal Code (rcode) — installable context-brain for Rihalians. 43 agents, 99 slash commands, 56 skills, pullable Rihal standards. Unified install for Claude Code, Cursor, and Gemini.",
   "main": "cli/index.js",
   "bin": {