neuro-vault-mcp 4.2.0 → 5.0.0

package/README.md

@@ -20,7 +20,7 @@ Your second brain stops being a folder you open between contexts and becomes a f
 - 🎯 **Quick or deep, your call** — fast direct lookups for "find that note", or exploratory mode with related-note expansion when the question is fuzzy.
 - 🧭 **A real navigation toolkit for your agent** — instead of grepping files and opening notes one by one, your assistant walks the vault like a database: filter by tags and properties, batch-read metadata, traverse the wikilink graph, discover the structure, jump to semantic neighbours.
 - 🔎 **Ask structured questions in plain language** — _"active projects tagged #ai"_, _"todo tasks with a deadline this week"_, _"meeting notes from `Work/` newest first"_ — one call, ranked answer, no chains of reads.
-- ✍️ **Read and write through Obsidian itself** — create, append, edit notes, manage frontmatter and daily notes via the [Obsidian CLI](https://github.com/AlexMost/obsidian-cli), so Smart Connections, sync, and other plugins stay in the loop.
+- ✍️ **Full write surface for your notes** — create, in-place replace, or rewrite the whole body; manage frontmatter, tags, and daily notes. Frontmatter and creation route through the [Obsidian CLI](https://github.com/AlexMost/obsidian-cli) so Smart Connections, sync, and other plugins stay in the loop; in-place edits write directly to disk and the watcher catches up.
 - ⚡ **Zero infrastructure** — local stdio MCP server, in-memory index, no database, no background processes, no watchers.
 - 🔌 **Drop-in for any MCP client** — Claude Code, Cursor, Windsurf — configuration is a single JSON block.
 
@@ -30,11 +30,11 @@ Your second brain stops being a folder you open between contexts and becomes a f
 
 Most "vault MCP" servers give you one or the other. Neuro Vault gives you both, and lets your assistant pick the right one per question:
 
-|                  | 🔭 **Semantic recall**                                                    | 🛠 **Vault operations**                                                        |
-| ---------------- | ------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
-| **What it does** | Finds notes by meaning, not keywords. Surfaces neighbours and duplicates. | Reads, writes, edits notes; manages frontmatter, tags, daily notes.            |
-| **Best for**     | _"What did I think about X?"_, fuzzy recall, exploratory research.        | Structured queries, capturing decisions, updating tasks, batch reads.          |
-| **Powered by**   | Smart Connections embeddings (already in your vault).                     | The official Obsidian CLI — Smart Connections, sync, plugins all stay in sync. |
+|                  | 🔭 **Semantic recall**                                                    | 🛠 **Vault operations**                                                                                      |
+| ---------------- | ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
+| **What it does** | Finds notes by meaning, not keywords. Surfaces neighbours and duplicates. | Reads, writes, edits notes (in-place replace and full-body rewrite); manages frontmatter, tags, daily notes. |
+| **Best for**     | _"What did I think about X?"_, fuzzy recall, exploratory research.        | Structured queries, capturing decisions, updating tasks, batch reads.                                        |
+| **Powered by**   | Smart Connections embeddings (already in your vault).                     | The official Obsidian CLI — Smart Connections, sync, plugins all stay in sync.                               |
 
 The two work together: semantic search finds the right region of the vault, vault operations let the assistant actually _do something_ with what it found.
 

package/dist/cli.d.ts

@@ -145,20 +145,11 @@ interface CreateNoteInput {
 interface CreateNoteResult {
     path: string;
 }
-type EditPosition = 'append' | 'prepend';
-interface EditNoteInput {
-    identifier: NoteIdentifier;
-    content: string;
-    position: EditPosition;
-}
 interface DailyNoteResult {
     path: string;
     frontmatter: Record<string, unknown> | null;
     content: string;
 }
-interface AppendDailyInput {
-    content: string;
-}
 type PropertyType = 'text' | 'list' | 'number' | 'checkbox' | 'date' | 'datetime';
 type PropertyValue = string | number | boolean | string[] | number[];
 interface SetPropertyInput {
@@ -188,9 +179,7 @@ interface TagListEntry {
 }
 interface VaultProvider {
     createNote(input: CreateNoteInput): Promise<CreateNoteResult>;
-    editNote(input: EditNoteInput): Promise<void>;
     readDaily(): Promise<DailyNoteResult>;
-    appendDaily(input: AppendDailyInput): Promise<void>;
     setProperty(input: SetPropertyInput): Promise<void>;
     readProperty(input: ReadPropertyInput): Promise<ReadPropertyResult>;
     removeProperty(input: RemovePropertyInput): Promise<void>;
@@ -211,11 +200,28 @@ interface ObsidianCLIProviderOptions {
     exec?: ExecFn;
 }
 
+interface ReplaceInNoteInput {
+    path: string;
+    find: string;
+    content: string;
+}
+interface ReplaceFullBodyInput {
+    path: string;
+    content: string;
+}
+interface VaultWriter {
+    replaceInNote(input: ReplaceInNoteInput): Promise<void>;
+    replaceFullBody(input: ReplaceFullBodyInput): Promise<void>;
+}
+
 interface OperationsModuleDeps {
     vaultProviderFactory?: (opts: ObsidianCLIProviderOptions) => VaultProvider;
     vaultReaderFactory?: (opts: {
         vaultRoot: string;
     }) => VaultReader;
+    vaultWriterFactory?: (opts: {
+        vaultRoot: string;
+    }) => VaultWriter;
     graph?: WikilinkGraphIndex;
 }