feat(tools): add vault_read/list/write/delete_file MCP tools

CLAUDE.md

@@ -114,7 +114,7 @@ Models: `neurostack-ask` (RAG), `neurostack-search` (hybrid), `neurostack-tiered
 | `neurostack serve` | Start MCP server. `--transport stdio\|sse\|http`, `--host`, `--port` |
 | `neurostack api` | Start OpenAI-compatible HTTP API. `--host`, `--port` |
 
-## MCP Tools (20 tools)
+## MCP Tools (24 tools)
 
 ### Search & Retrieval
 - `vault_search(query, top_k, mode, depth, context, workspace)` - Hybrid search with tiered depth
@@ -144,6 +144,12 @@ Models: `neurostack-ask` (RAG), `neurostack-search` (hybrid), `neurostack-tiered
 - `vault_session_start(source_agent, workspace)` - Begin memory session
 - `vault_session_end(session_id, summarize, auto_harvest)` - End session
 
+### Vault Files (raw markdown CRUD over MCP)
+- `vault_read_file(path)` - Read a .md file under vault_root
+- `vault_list_files(directory, pattern, recursive)` - List .md files (hidden segments excluded)
+- `vault_write_file(path, content, commit_message)` - Create/overwrite a .md file; commits + pushes origin/main. Hard-rejects writes without required frontmatter (`date`, `tags`, `type`). On push conflict: `git pull --rebase --autostash` + retry once, then rollback.
+- `vault_delete_file(path, commit_message)` - Delete a .md file; commits + pushes origin/main
+
 ## Global Flags
 
 All query commands support `--json` for machine-readable output:

npm/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neurostack",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Build, maintain, and search your knowledge vault with AI",
   "bin": {
     "neurostack": "bin/neurostack.js",

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "neurostack"
-version = "0.13.0"
+version = "0.14.0"
 description = "Build, maintain, and search your knowledge vault. CLI + MCP server with stale note detection, semantic search, and neuroscience-grounded memory."
 readme = "README.md"
 license = "Apache-2.0"

src/neurostack/__init__.py

@@ -2,4 +2,4 @@
 # Copyright (c) 2024-2026 Raphael Southall
 """NeuroStack — AI-provider-agnostic, neuroscience-grounded knowledge management."""
 
-__version__ = "0.12.1"
+__version__ = "0.14.0"

src/neurostack/tools/__init__.py

@@ -19,6 +19,7 @@ def ensure_registered() -> ToolRegistry:
     global _registered
     if not _registered:
         from . import (
+            file_tools,  # noqa: F401
             insight_tools,  # noqa: F401
             memory_tools,  # noqa: F401
             search_tools,  # noqa: F401