@opennous/cli 0.9.0 → 0.10.0

package/CHANGELOG.md

@@ -0,0 +1,18 @@
+# @opennous/cli changelog
+
+## 0.10.0
+
+### Added — `nous vault`: on-device retrieval over your linked local vault
+
+Once a folder is paired with `nous link`, an agent running on your own machine
+(Claude Code, Hermes, …) can now read and search your private vault **locally** —
+with no server round-trip. It's fresher (no sync lag), fuller (whole files, not
+snippets), faster (no network), and private (the reads never leave the device).
+This is the native counterpart to the `search_my_vault` MCP tool, which stays the
+fallback for when you're *not* on the machine.
+
+- `nous vault search <query>` — local keyword search over your vault notes
+  (filename-weighted, ranked, with snippets). Options: `--folder`, `--limit`, `--json`.
+- `nous vault read <path>` — print a note's full content (e.g. `decisions/pricing`).
+- `nous vault list [folder]` — list vault files, optionally within one folder.
+- `nous vault path` — print the linked folder, so you can point your own Grep/Read at it.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opennous/cli",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Nous CLI — set up Nous, connect it to your coding agent, and read the Context API from your terminal",
   "type": "module",
   "bin": {
@@ -8,7 +8,8 @@
   },
   "files": [
     "src",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "dev": "node src/index.js",

package/src/index.js

@@ -1277,5 +1277,108 @@ program
     console.log("✓ Unlinked. Your files are still in Nous; this folder just stopped syncing.");
   });
 
+// ---------------------------------------------------------------------------
+// nous vault — read + search the LINKED local vault ON-DEVICE. When an agent runs
+// where the vault is linked (`nous link`), it should read these files directly
+// instead of calling the search_my_vault MCP tool: fresher (no sync lag), fuller
+// (whole files, not snippets), faster (no network), and private (the reads never
+// leave the machine). This is the native personal-vault retrieval path.
+// ---------------------------------------------------------------------------
+function linkedVaultRoot() {
+  const dir = readConfig().link?.dir;
+  if (!dir || !existsSync(dir)) return null;
+  return dir;
+}
+function requireVaultRoot() {
+  const root = linkedVaultRoot();
+  if (!root) { console.error("No local vault linked. Run `nous link <dir>` first."); process.exit(1); }
+  return root;
+}
+// Resolve a 'folder/[subfolder/]name' argument to an absolute .md path under the vault.
+function resolveVaultRel(root, p) {
+  const rel = String(p).replace(/^\/+/, "").endsWith(".md") ? String(p).replace(/^\/+/, "") : `${String(p).replace(/^\/+/, "")}.md`;
+  return { rel, abs: join(root, rel.split("/").join(sep)) };
+}
+
+const vaultCmd = program
+  .command("vault")
+  .description("Read and search your linked local vault — on-device, no server round-trip");
+
+vaultCmd
+  .command("path")
+  .description("Print the linked vault folder (point your own Read/Grep at it)")
+  .action(() => { console.log(requireVaultRoot()); });
+
+vaultCmd
+  .command("list [folder]")
+  .description("List vault files, optionally within one folder")
+  .option("--json", "Output JSON", false)
+  .action((folder, { json }) => {
+    const root = requireVaultRoot();
+    let files = walkVaultMd(root).map((f) => f.rel);
+    if (folder) files = files.filter((r) => r.split("/")[0] === folder);
+    files.sort();
+    if (json) { console.log(JSON.stringify(files)); return; }
+    if (!files.length) { console.log(folder ? `No files in ${folder}.` : "Vault is empty."); return; }
+    for (const r of files) console.log(`  ${r}`);
+  });
+
+vaultCmd
+  .command("read <path>")
+  .description("Print a vault file's full content (e.g. decisions/pricing)")
+  .action((p) => {
+    const root = requireVaultRoot();
+    const { rel, abs } = resolveVaultRel(root, p);
+    const content = safeRead(abs);
+    if (content == null) { console.error(`Not found: ${rel}`); process.exit(1); }
+    process.stdout.write(content.endsWith("\n") ? content : content + "\n");
+  });
+
+vaultCmd
+  .command("search <query...>")
+  .description("Search the linked vault locally (on-device — never leaves your machine)")
+  .option("--folder <folder>", "Restrict to one vault folder")
+  .option("--limit <n>", "Max results", "6")
+  .option("--json", "Output JSON", false)
+  .action((queryParts, { folder, limit, json }) => {
+    const root = requireVaultRoot();
+    const query = queryParts.join(" ");
+    const terms = query.toLowerCase().split(/\s+/).filter(Boolean);
+    if (!terms.length) { console.error("Pass a query, e.g. `nous vault search pricing objections`."); process.exit(1); }
+
+    let files = walkVaultMd(root);
+    if (folder) files = files.filter((f) => f.rel.split("/")[0] === folder);
+
+    const hits = [];
+    for (const f of files) {
+      const content = safeRead(f.abs) ?? "";
+      const hay = content.toLowerCase();
+      const name = f.rel.toLowerCase();
+      let score = 0;
+      for (const t of terms) {
+        if (name.includes(t)) score += 5;                         // a filename hit is a strong signal
+        score += Math.min(hay.split(t).length - 1, 5);            // content occurrences, capped
+      }
+      if (score <= 0) continue;
+      // Snippet around the first matching term.
+      let snippet = "";
+      for (const t of terms) {
+        const i = hay.indexOf(t);
+        if (i >= 0) { snippet = content.slice(Math.max(0, i - 60), i + 140).replace(/\s+/g, " ").trim(); break; }
+      }
+      hits.push({ path: f.rel, score, snippet });
+    }
+    hits.sort((a, b) => b.score - a.score);
+    const top = hits.slice(0, Math.min(Math.max(1, Number(limit) || 6), 30));
+
+    if (json) { console.log(JSON.stringify(top)); return; }
+    if (!top.length) { console.log(`No local vault notes matched "${query}".`); return; }
+    console.log(`Local vault notes matching "${query}":\n`);
+    for (const h of top) {
+      console.log(`  ${h.path}`);
+      if (h.snippet) console.log(`    ${h.snippet}`);
+    }
+  });
+
 // ---------------------------------------------------------------------------
 program.name("nous").version("0.8.0").parse();