Skip to main content

0.0.7-beta.2

Beta release notes for localnest-mcp@0.0.7-beta.2.

Channel

Current beta

Use this page when you need the active prerelease contract before the next stable promotion.

Stable relationship

Stable remains 0.0.5

This beta previews the knowledge graph, traversal, and CLI-first work without changing the current stable package line.

Use case

Prerelease validation

Keep this page for beta-install checks, new tool validation, and release comparison.

Open current stableSwitch back to the maintained stable release notes for 0.0.5.Install by versionUse the version matrix when you need exact npm install commands for beta vs stable.

Summary​

0.0.7-beta.2 is the largest feature release to date. It adds a temporal knowledge graph, multi-hop graph traversal, two-level memory hierarchy, agent-scoped isolation, semantic deduplication, conversation ingestion, a hooks system, and a full CLI-first architecture. The MCP tool count grows from 35 to 52.

Key Changes​

Knowledge Graph​

  • Temporal knowledge graph with entities and subject-predicate-object triples (kg_entities, kg_triples tables, schema v6).
  • Temporal validity on all triples: valid_from/valid_to columns, point-in-time as_of queries, chronological timeline view, and KG statistics.
  • Multi-hop graph traversal via SQLite recursive CTEs with cycle prevention (configurable 1-5 hops).
  • Contradiction detection at write time: warns when a new triple conflicts with an existing valid triple on the same subject+predicate.
  • Cross-nest bridge discovery: find entities connected across different memory domains.
  • Entity auto-creation on first triple reference with normalized slug IDs.
  • Triple provenance tracking via source_memory_id linking back to originating memory entries.

Memory Organization​

  • Nest/Branch hierarchy: two-level memory taxonomy. Nests are top-level domains, branches are topics within nests.
  • Metadata-filtered recall: memory recall filters by nest and/or branch for more precise retrieval.
  • Taxonomy tools: list nests, list branches within a nest, get full taxonomy tree with counts.

Agent Isolation​

  • Agent-scoped memory: agent_id column on memory entries for per-agent isolation (schema v8).
  • Private diary: separate agent_diary table for agent scratchpad entries not visible to other agents.
  • Scoped recall: agents see own memories + global memories, never other agents' private data.

Semantic Dedup​

  • Embedding similarity gate on all memory writes (default 0.92 cosine threshold, configurable).
  • Dedup runs automatically on memory_store and memory_capture_event operations.
  • Explicit check_duplicate tool for pre-filing checks with match details.

Conversation Ingestion​

  • Markdown and JSON conversation import: parse chat exports into per-turn memory entries with automatic nest/branch assignment.
  • Rule-based entity extraction: creates knowledge graph triples from conversation content without LLM dependency.
  • Re-ingestion protection: tracks ingested files by path + SHA-256 hash (schema v9, conversation_sources table).

Hooks System​

  • Pre/post operation hooks for memory, KG, graph traversal, diary, ingestion, and dedup operations.
  • Support for cancel, payload transform, one-time listeners, and catch-all wildcards (before:*, after:*).
  • Two new MCP tools: localnest_hooks_stats and localnest_hooks_list_events for hook introspection.

CLI-First Architecture​

  • Unified noun-verb CLI: localnest <noun> <verb> subcommand pattern with zero new dependencies.
  • Memory CLI: localnest memory add|search|list|show|delete with full flag support.
  • Knowledge Graph CLI: localnest kg add|query|timeline|stats for terminal-based KG operations.
  • Skill CLI: localnest skill install|list|remove with multi-client detection.
  • MCP Lifecycle CLI: localnest mcp start|status|config for server management.
  • Ingest CLI: localnest ingest <file> with auto-format detection (Markdown/JSON).
  • Global flags: --json, --verbose, --quiet, --config work on all commands.
  • Shell completions: localnest completion bash|zsh|fish for tab completion.
  • Legacy deprecation: old localnest-mcp-* binaries now show deprecation warnings and redirect to canonical commands.

Migration Safety​

  • Per-version transaction wrapping: each schema migration runs inside its own SQLite transaction with immediate version stamping. Failure mid-migration rolls back cleanly.
  • Schema versions: v5 (existing) through v9 (conversation sources), all additive and backward-compatible.

17 New MCP Tools (52 Total)​

CategoryTools
Knowledge Graph (7)localnest_kg_add_entity, localnest_kg_add_triple, localnest_kg_query, localnest_kg_invalidate, localnest_kg_as_of, localnest_kg_timeline, localnest_kg_stats
Nest/Branch (3)localnest_nest_list, localnest_nest_branches, localnest_nest_tree
Graph Traversal (2)localnest_graph_traverse, localnest_graph_bridges
Agent Diary (2)localnest_diary_write, localnest_diary_read
Conversation Ingestion (2)localnest_ingest_markdown, localnest_ingest_json
Duplicate Check (1)localnest_memory_check_duplicate
Hook Introspection (2)localnest_hooks_stats, localnest_hooks_list_events

New Source Files​

  • src/services/memory/kg.js -- Knowledge graph entity and triple CRUD
  • src/services/memory/graph.js -- Recursive CTE traversal and bridge discovery
  • src/services/memory/taxonomy.js -- Nest/branch hierarchy helpers
  • src/services/memory/scopes.js -- Agent diary CRUD and scope isolation
  • src/services/memory/dedup.js -- Embedding similarity gate
  • src/services/memory/ingest.js -- Conversation parsing and ingestion pipeline
  • src/services/memory/hooks.js -- Pre/post operation hook system
  • src/mcp/tools/graph-tools.js -- MCP tool registration for all new features
  • src/cli/options.js -- Global CLI flag parser
  • src/cli/help.js -- Colored help renderer
  • src/cli/router.js -- Noun-verb subcommand dispatcher
  • src/cli/commands/memory.js -- Memory CLI implementation
  • src/cli/commands/kg.js -- Knowledge Graph CLI implementation
  • src/cli/commands/skill.js -- Skill management CLI
  • src/cli/commands/mcp.js -- MCP lifecycle CLI
  • src/cli/commands/ingest.js -- Conversation ingestion CLI
  • src/cli/commands/completion.js -- Shell completion generators

Practical Impact​

This beta transforms LocalNest from a code retrieval + memory server into a full knowledge management platform. The temporal KG enables structured fact tracking with time-travel queries. Multi-hop traversal lets agents discover indirect connections no other local tool can find. The CLI-first architecture means every MCP capability is also usable directly from the terminal.

When to Use This Page​

  • testing localnest-mcp@0.0.7-beta.2
  • validating the 17 new MCP tools before stable promotion
  • evaluating the temporal knowledge graph and traversal capabilities
  • comparing the beta tool surface against stable 0.0.5