v1.5.3

Write Pipeline Fixes

• Auto-link resolver: skip code blocks, inline code, frontmatter, filenames with extensions, and bare date patterns (YYYY-MM-DD)
• Frontmatter merge: user-provided FM fields merged into auto-generated block (no more duplicate FM sections)
• Title extraction: reads title field from frontmatter, skips FM delimiters
• Link application: create_note uses apply_links() with protected regions

Concurrency

• WAL mode: SQLite WAL journal + 5s busy_timeout — concurrent MCP + CLI access now works
• mtime sync: stored mtime updated after edit/rewrite to prevent false conflict errors

Read-Only Mode

• engraph serve --read-only disables all write MCP and HTTP tools while keeping search/read/context accessible

Stats

450 tests (up from 426), all passing. 8 files changed, +1011 lines.

v1.5.2

Fix: add empty components.schemas object to OpenAPI spec — required by ChatGPT Actions import.

v1.5.1

v1.5.1

Hotfix: CORS configuration crash when using specific origins (e.g., https://chat.openai.com).

tower-http does not allow allow_credentials(true) combined with allow_headers(Any). Fixed by listing explicit allowed headers (Authorization, Content-Type, Accept) instead of wildcard.

This was blocking engraph serve --http from starting when CORS origins were configured for ChatGPT Actions.

v1.5.0

engraph v1.5.0

Five major releases rolled into one: v1.1 through v1.5, shipped in a single session.

v1.5 — ChatGPT Actions

• OpenAPI 3.1.0 spec served at /openapi.json
• ChatGPT plugin manifest at /.well-known/ai-plugin.json
• engraph configure --setup-chatgpt interactive helper
• [http.plugin] config section

v1.4 — PARA Migration

• engraph migrate para — AI-assisted vault restructuring
• Heuristic classification (11 rules), preview-then-apply workflow, rollback
• 3 new MCP tools + 3 HTTP endpoints

v1.3 — HTTP/REST Transport

• 20+ REST endpoints mirroring all MCP tools
• API key auth with read/write permissions
• Rate limiting, CORS, graceful shutdown
• engraph serve --http

v1.2 — Temporal Search

• 5th RRF lane for time-aware queries
• Date extraction from frontmatter + filenames
• Heuristic + LLM detection
• Confidence % display

v1.1 — Complete Vault Gateway

• 6 new MCP tools (read_section, health, edit, rewrite, edit_frontmatter, delete)
• Section-level editing, vault health analysis
• Obsidian CLI wrapper with circuit breaker
• Enhanced onboarding

Stats

• 26 modules, 426 tests, 22 MCP tools, 23 HTTP endpoints
• OpenAPI 3.1.0 + ChatGPT Actions compatible

v1.0.2

v1.0.2: Smart person search, suppress logs, clean demo (#12)

- context_who uses FTS search instead of filename matching
- llama.cpp logs suppressed via void_logs()
- find_file_by_basename handles hyphens/underscores/spaces
- Demo tape updated (no 2>/dev/null workarounds)

v1.0.1

docs: add MCP edit/rewrite tools to v1.1 roadmap

v0.7.0

chore: bump to v0.7.0 — warm sync

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

v0.6.0

v0.6.0: Write pipeline with sqlite-vec migration (#7)

* feat: add vecstore module with sqlite-vec integration

Wrap sqlite-vec for vector search, replacing HNSW-based approach.
Provides init, insert, delete, search (with tombstone filtering),
and clear operations on a vec0 virtual table. Includes 5 unit tests.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat: integrate sqlite-vec into Store with transaction helpers

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* refactor: replace HNSW semantic lane with sqlite-vec in search

All search code paths now use store.search_vec() instead of
HnswIndex::search(). The hnsw module remains but is unused — deletion
is deferred to Task 5.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* refactor: replace HNSW rebuild with sqlite-vec inserts in indexer

- Remove HnswIndex import and HNSW rebuild steps (11-12)
- Insert vectors into vec0 table during chunk write loop
- Delete from vec0 when files are deleted or changed
- Clear vec0 on full rebuild
- Use store.next_vector_id() instead of scanning all vectors
- Add folder centroid computation and storage after indexing
- Add folder_centroids table migration and upsert/get methods in Store

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* refactor: remove hnsw_rs dependency, delete hnsw.rs — vectors now in sqlite-vec

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat: auto-migrate existing BLOB vectors to sqlite-vec on startup

Adds `migrate_vectors_to_vec0()` which copies BLOB vectors from
`chunks.vector` into the `chunks_vec` vec0 virtual table. Called from
`init()` after `init_vec_table()` so the virtual table is guaranteed
to exist. No-ops when vec0 is already populated or no BLOBs are present.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat: add tag registry with fuzzy resolution

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat: add link discovery module for auto-wikilinks

Scans note content for potential wikilink targets using exact filename
and alias matching. Supports case-insensitive search, word boundary
checking, existing wikilink skipping, and longest-match-first priority.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat: add folder placement module with type rules and semantic centroids

Three-strategy cascade: type-based rules (person/daily/workout + content
pattern detection) → semantic centroid matching against precomputed folder
embeddings → inbox fallback. 12 tests covering all strategies.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat: add write pipeline orchestrator with create, append, update, and move

Implements the writer module that ties together content analysis, tag
resolution, link discovery, folder placement, and atomic write+index.

- CreateNoteInput: 5-step pipeline (filename, tags, links, placement, write)
- AppendInput: append content with mtime conflict detection
- UpdateMetadataInput: frontmatter-only updates without re-chunking
- move_note: relocate files with store record updates
- All writes use temp+rename for atomicity with transaction rollback
- Pre-computes embeddings before holding DB lock
- Adds Store::resolve_file() for path/basename/#docid resolution
- Adds time crate for date formatting

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: resolve clippy warnings in writer, links, and placement modules

* feat: add create, append, update_metadata, and move_note MCP write tools

Extends the MCP server with 4 write tools that expose the writer module
pipeline to Claude Code clients, completing the read-write tool surface.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* feat: add write CLI subcommands (create, append)

Adds `engraph write create` and `engraph write append` subcommands backed
by the writer module pipeline. Both support --content flag or stdin for
content input, with --json output mode.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat: add crash recovery — cleanup orphan .tmp files on startup

Scans the vault for leftover `.md.tmp` files on both `engraph index` and
`engraph serve` startup, removing any that survived a previous crash mid-write.
Logs the count if any are removed.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* test: add write pipeline integration tests

Three #[ignore] tests covering create_note searchability, append index
update, and mtime conflict detection. Run with:
  cargo test --test write_pipeline -- --ignored

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* chore: v0.6.0 — write pipeline, sqlite-vec migration, tombstone removal

Remove redundant tombstone writes from indexer (delete_vec handles it).
Replace tombstone loading in search with empty set. Fix clippy warning
in writer.rs. Apply cargo fmt across all modules. Bump version to 0.6.0.
Update CLAUDE.md with 19 modules, 190 tests, write pipeline docs, and
sqlite-vec architecture.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: update stored mtime after rename to prevent false conflict detection

* feat: add archive/unarchive for soft-delete with index exclusion

- archive: moves note to 04-Archive/, adds archived frontmatter, removes from index
- unarchive: restores to original location (via archived_from), re-indexes
- indexer auto-excludes archive folder during walks
- MCP tools: archive, unarchive (13 total tools now)
- CLI: engraph write archive/unarchive

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* style: apply cargo fmt to archive/unarchive code

* feat: complete v0.6 spec coverage — content analysis, suggested_folder, incremental centroids, orphan cleanup, tag queries

- Gap 1: Add suggestion field to PlacementResult; add ticket ID detection
  (BRE-XXXX/DRIFT-XXX), meeting note detection, decision type_hint
- Gap 2: Inject suggested_folder frontmatter when semantic placement finds
  a below-threshold match during inbox fallback
- Gap 3: Incrementally update folder centroids after each note creation
  (weighted merge with existing centroid)
- Gap 4: Add verify_index_integrity() to clean orphan DB entries for files
  that no longer exist on disk; called on index and serve startup
- Gap 5: Add agent_created_tags(), low_usage_tags(), stale_tags() queries
  to store for tag hygiene tooling

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

v0.5.0 — MCP Server

What changed

engraph is now an MCP server. AI agents (Claude Code, etc.) connect via stdio and get direct access to your vault's intelligence — search, context bundles, people lookups, project overviews.

New command

engraph serve    # Start MCP stdio server

MCP Tools

Tool	What it does
search	Hybrid 3-lane search (semantic + FTS5 + graph)
read	Full note content with metadata and graph edges
list	Filter notes by folder and/or tags
vault_map	Vault structure overview — use this to orient in a new session
who	Person context: note + mentions + connections
project	Project context: note + children + tasks + team
context	Rich topic context with character budget trimming

Setup for Claude Code

1. Install: brew install devwhodevs/tap/engraph
2. Index your vault: engraph index ~/path/to/vault
3. Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "engraph": {
      "command": "engraph",
      "args": ["serve"]
    }
  }
}

4. Restart Claude Code — engraph tools are now available

Stats

• 14 modules (was 13), serve.rs added
• 146 unit tests
• New deps: rmcp (official Rust MCP SDK), tokio, schemars

What's next (v0.6 — Write Pipeline)

• Create notes with auto-filing, tag resolution, link discovery
• Append to existing notes
• Write tools exposed via MCP

v0.4.0 — Context Engine

What changed

engraph v0.3 had hybrid search with a vault graph. v0.4 adds a context engine — six functions that assemble agent-ready context bundles from search results, graph connections, and vault metadata.

New commands

engraph context read <file_or_docid>              # Full note content with metadata + graph edges
engraph context list [--folder X] [--tags a,b]    # Filter notes by metadata
engraph context vault-map                          # Vault structure overview
engraph context who <name>                         # Person context bundle
engraph context project <name>                     # Project context bundle
engraph context topic <query> [--budget 32000]     # Rich topic context with budget trimming

All commands support --json for structured output.

Context engine highlights

• who "John Nelson" — returns the person's note, all vault mentions with snippets, wikilink connections
• project "Drift" — returns the project note, child notes, active tasks (unchecked checkboxes), team members, recent daily mentions
• topic "delivery date" --budget 8000 — runs hybrid search, reads full note content from disk, expands via graph, assembles within character budget with truncation markers
• vault-map — folder note counts, top tags by frequency, recently indexed files — everything an agent needs to orient in a new session

Internal improvements

• search_internal() extracted from run_search() — reusable 3-lane RRF search for programmatic consumers
• Five new Store query methods for filtering, aggregation, and listing
• ContextParams shared context struct for all functions

Upgrading from v0.3

No migration needed — context engine is read-only and works with existing databases. Run engraph index if you haven't recently.

Stats

• 13 modules (was 12), context.rs added (~1,050 lines)
• 144 unit tests (was 119)
• ~1,600 lines of new Rust code

What's next (v0.5 — MCP Server)

• MCP stdio transport so Claude Code can connect directly
• Context engine tools exposed as MCP tools
• HTTP daemon for REST API consumers