rlm-navigator 0.1.1 → 0.1.3

package/bin/cli.js

@@ -132,8 +132,8 @@ async function install() {
     if (existing.includes("<!-- rlm-navigator:start -->")) {
       console.log("  CLAUDE.md already contains RLM Navigator block — skipped.\n");
     } else {
-      fs.writeFileSync(claudeMdPath, existing + "\n" + snippet);
-      console.log("  Appended RLM Navigator block to CLAUDE.md.\n");
+      fs.writeFileSync(claudeMdPath, snippet + "\n" + existing);
+      console.log("  Prepended RLM Navigator block to CLAUDE.md.\n");
     }
   }
 

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "rlm-navigator",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Token-efficient codebase navigation for AI-assisted coding",
   "bin": {
-    "rlm-navigator": "./bin/cli.js"
+    "rlm-navigator": "bin/cli.js"
   },
   "files": [
     "bin/",

package/server/src/index.ts

@@ -13,11 +13,30 @@ import { z } from "zod";
 import * as net from "node:net";
 import * as fs from "node:fs";
 import * as path from "node:path";
+import { fileURLToPath } from "node:url";
 import { spawn, ChildProcess } from "node:child_process";
 
 const DAEMON_HOST = "127.0.0.1";
 const MAX_RESPONSE_CHARS = parseInt(process.env.RLM_MAX_RESPONSE || "8000", 10);
-const PROJECT_ROOT = process.env.RLM_PROJECT_ROOT || process.cwd();
+
+function resolveProjectRoot(): string {
+  // 1. Explicit env var
+  if (process.env.RLM_PROJECT_ROOT) return process.env.RLM_PROJECT_ROOT;
+
+  // 2. Detect from script location: if running from <project>/.rlm/server/build/index.js,
+  //    walk up to find the .rlm parent
+  const scriptDir = path.dirname(fileURLToPath(import.meta.url));
+  const parts = scriptDir.split(path.sep);
+  const rlmIdx = parts.lastIndexOf(".rlm");
+  if (rlmIdx > 0) {
+    return parts.slice(0, rlmIdx).join(path.sep);
+  }
+
+  // 3. Fallback
+  return process.cwd();
+}
+
+const PROJECT_ROOT = resolveProjectRoot();
 
 let daemonChild: ChildProcess | null = null;
 

package/templates/CLAUDE_SNIPPET.md

@@ -1,21 +1,29 @@
 <!-- rlm-navigator:start -->
 
-## RLM Navigator — Token Conservation Rules
+## REQUIRED: Use RLM Navigator for All Codebase Navigation
 
-1. **Never read full files** — use `rlm_map` for signatures, `rlm_drill` for specific symbols
-2. **Never use ls/find/Glob** for exploration — use `rlm_tree`
-3. **Map before drill** — always see the skeleton first
-4. **Surgical edits only** — use Edit tool with minimal context
-5. **Minimalist responses** — no verbose explanations unless asked
-6. **No redundant reads** — if it's in context, don't read it again
+This project uses the `/rlm-navigator` skill. You MUST follow the RLM Navigator workflow for ALL codebase exploration, file reading, and code search. This is NOT optional.
+
+**Mandatory workflow: `rlm_tree` → `rlm_map` → `rlm_drill` → Edit**
+
+### What you MUST do:
+- Use `rlm_tree` instead of `ls`, `find`, or `Glob` for directory exploration
+- Use `rlm_map` instead of `Read` or `cat` to understand file contents
+- Use `rlm_drill` to read only the specific symbol you need
+- Use `rlm_search` to find symbols across files
+
+### What you MUST NOT do:
+- Do NOT read full files with the `Read` tool unless the file is under 50 lines or is a config file
+- Do NOT use `Glob` or `find` to explore the project structure
+- Do NOT use `grep` or `Grep` for code search — use `rlm_search` or the REPL's `grep()` helper
 
 ### Navigation Tools
 
 | Tool | Purpose |
 |------|---------|
 | `get_status` | Check daemon health |
-| `rlm_tree` | See directory structure (replaces ls/find) |
-| `rlm_map` | See file signatures only (replaces cat/read) |
+| `rlm_tree` | See directory structure (replaces ls/find/Glob) |
+| `rlm_map` | See file signatures only (replaces Read/cat) |
 | `rlm_drill` | Read specific symbol implementation |
 | `rlm_search` | Find symbols across files |