@hanzlaa/rcode 2.7.0 → 2.7.1

package/cli/install.js

@@ -1025,12 +1025,18 @@ function sweepStaleInstalledFiles(target, newPlan) {
   const newRelsSet = new Set(newPlan.map(e => e.rel.split(path.sep).join('/')));
   // Safety — never sweep these, even if they somehow landed in the manifest.
   const neverSweep = /^(\.rihal\/config\.yaml|\.rihal\/state\.json|\.rihal\/state\.json\.lock|\.planning\/|\.rihal\/brain\/sources\.yaml)/;
+  // #382 — local overrides: files matching <name>.local.md are user-managed.
+  // The installer never touches them: not in copy, not in sweep, not even on
+  // --force-overwrite. This gives users a stable path to customize agent
+  // voice / examples / project-specific rules without losing them on update.
+  const isLocalOverride = (rel) => /\.local\.(md|mdc|json|yaml|yml|toml|js|ts)$/.test(rel);
 
   let removed = 0;
   const emptyCandidateDirs = new Set();
   for (const rel of oldRels) {
     if (newRelsSet.has(rel)) continue;
     if (neverSweep.test(rel)) continue;
+    if (isLocalOverride(rel)) continue; // #382 — never sweep user-owned overrides
     const full = path.join(target, rel);
     try {
       if (fs.existsSync(full)) {
@@ -1603,6 +1609,10 @@ async function install(opts) {
   console.log(dim('    npx @hanzlaa/rcode@latest install   # pull the latest rcode + brain'));
   console.log(dim(`    /rihal:update v${version}              # pin rcode to a specific version`));
   console.log('');
+  console.log(dim('  Customize without losing changes on update:'));
+  console.log(dim('    Create <name>.local.md siblings (e.g. .claude/agents/rihal-waleed.local.md)'));
+  console.log(dim('    *.local.md files are NEVER touched by install / --force-overwrite / uninstall.'));
+  console.log('');
   console.log('  ' + warn('If your IDE is already open, reload the window to refresh skills/commands.'));
   console.log(dim('    Claude Code / VS Code / Cursor:  Cmd+Shift+P → Reload Window'));
   console.log('');

package/cli/uninstall.js

@@ -57,14 +57,26 @@ function parseArgs(args) {
   return opts;
 }
 
+/**
+ * #382 — Local overrides: files matching <name>.local.md (or .local.mdc /
+ * .local.json / etc.) are user-managed. The uninstaller never removes them
+ * — they survive both regular uninstall AND --purge. Users can customize
+ * an agent voice / skill / command by creating a .local.md sibling, knowing
+ * it'll persist across updates and uninstalls.
+ */
+function isLocalOverride(name) {
+  return /\.local\.(md|mdc|json|yaml|yml|toml|js|ts)$/.test(name);
+}
+
 /**
  * Walk a directory and remove all files/subdirs whose name matches a predicate.
- * Returns the number of entries removed.
+ * Returns the number of entries removed. Always skips local overrides (#382).
  */
 function removeMatching(dir, predicate) {
   if (!fs.existsSync(dir)) return 0;
   let count = 0;
   for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    if (isLocalOverride(entry.name)) continue; // #382 — never remove user overrides
     if (!predicate(entry.name)) continue;
     const full = path.join(dir, entry.name);
     fs.rmSync(full, { recursive: true, force: true });

package/dist/rcode.js

@@ -16530,11 +16530,13 @@ Say "plan a sprint" or run \`/rihal:sprint-planning\` to break Phase 01 into sto
       }
       const newRelsSet = new Set(newPlan.map((e) => e.rel.split(path2.sep).join("/")));
       const neverSweep = /^(\.rihal\/config\.yaml|\.rihal\/state\.json|\.rihal\/state\.json\.lock|\.planning\/|\.rihal\/brain\/sources\.yaml)/;
+      const isLocalOverride = (rel) => /\.local\.(md|mdc|json|yaml|yml|toml|js|ts)$/.test(rel);
       let removed = 0;
       const emptyCandidateDirs = /* @__PURE__ */ new Set();
       for (const rel of oldRels) {
         if (newRelsSet.has(rel)) continue;
         if (neverSweep.test(rel)) continue;
+        if (isLocalOverride(rel)) continue;
         const full = path2.join(target, rel);
         try {
           if (fs2.existsSync(full)) {
@@ -17005,6 +17007,10 @@ Say "plan a sprint" or run \`/rihal:sprint-planning\` to break Phase 01 into sto
       console.log(dim("    npx @hanzlaa/rcode@latest install   # pull the latest rcode + brain"));
       console.log(dim(`    /rihal:update v${version}              # pin rcode to a specific version`));
       console.log("");
+      console.log(dim("  Customize without losing changes on update:"));
+      console.log(dim("    Create <name>.local.md siblings (e.g. .claude/agents/rihal-waleed.local.md)"));
+      console.log(dim("    *.local.md files are NEVER touched by install / --force-overwrite / uninstall."));
+      console.log("");
       console.log("  " + warn("If your IDE is already open, reload the window to refresh skills/commands."));
       console.log(dim("    Claude Code / VS Code / Cursor:  Cmd+Shift+P \u2192 Reload Window"));
       console.log("");
@@ -17953,10 +17959,14 @@ var require_uninstall = __commonJS({
       }
       return opts;
     }
+    function isLocalOverride(name) {
+      return /\.local\.(md|mdc|json|yaml|yml|toml|js|ts)$/.test(name);
+    }
     function removeMatching(dir, predicate) {
       if (!fs2.existsSync(dir)) return 0;
       let count = 0;
       for (const entry of fs2.readdirSync(dir, { withFileTypes: true })) {
+        if (isLocalOverride(entry.name)) continue;
         if (!predicate(entry.name)) continue;
         const full = path2.join(dir, entry.name);
         fs2.rmSync(full, { recursive: true, force: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hanzlaa/rcode",
-  "version": "2.7.0",
+  "version": "2.7.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": {