0.1.0

Release notes for localnest-mcp@0.1.0.

Channel

First stable after beta

This is the first stable release after the 0.0.7-beta series. All beta features are now promoted.

Migration

Full TypeScript codebase

96 TypeScript files, 0 JavaScript in src/. Uses tsx for runtime and tsc for builds.

Performance

Indexes, caching, async persistence

Composite SQLite indexes, embedding LRU cache, async vector index writes, and graph CTE optimization.

Open current stableSwitch to the maintained stable release notes.Install by versionUse the version matrix for exact npm install commands.

Summary

0.1.0 is a major internal overhaul. The entire src/ directory is now TypeScript (96 files, 0 JS). The CLI has been refreshed with shared modules and ora spinners. SQLite query performance is improved with composite indexes, embedding caching, and async vector index persistence. Dependencies are updated to MCP SDK 1.29.0 and ora 9.3.0.

TypeScript Migration

• All 96 source files in src/ are now .ts. Zero JavaScript remains.
• Runtime uses tsx for TypeScript execution without a separate compile step during development.
• Production builds use tsc for type-checked compilation.
• New src/types/ directory for shared type declarations (e.g. tree-sitter.d.ts).

CLI Refresh

Shared Modules

• src/cli/ansi.ts -- ANSI color and formatting utilities shared across all CLI commands.
• src/cli/output.ts -- Structured output helpers (tables, lists, JSON formatting).
• src/cli/spinner.ts -- Wrapper around ora for consistent spinner behavior.

Spinners

• All async CLI operations now show ora spinners with progress feedback.
• Spinner states: start, succeed, fail, warn -- consistent across all commands.

New CLI Commands

• dashboard -- interactive terminal dashboard with memory stats, KG overview, server status.
• onboard -- guided first-run setup wizard.
• selftest -- end-to-end pipeline validation.
• hooks -- hook management CLI.

Performance Optimizations

SQLite Indexes

• 3 new composite indexes for memory recall, KG queries, and relation lookups.
• Targeted at the most frequent query patterns to reduce full-table scans.

Embedding Cache

• LRU cache with 256-entry capacity for embedding vectors.
• Avoids redundant embedding computation for repeated or similar content.

Async Vector Index

• Vector index persistence is now async -- writes happen in the background without blocking the MCP response path.
• Batch embedding queries reduce round-trips during index builds.

Graph CTE Optimization

• Recursive CTE traversal now uses INSTR() for cycle detection instead of string concatenation checks.
• Measurable improvement on multi-hop traversal queries (3+ hops).

Dependency Updates

Package	Version
@modelcontextprotocol/sdk	1.29.0
ora	9.3.0

Agentic Orchestration

All 11 nest:* orchestration commands from 0.0.7-beta.3 are included:

Command	Purpose
nest:flow	Orchestrator -- routes feature requests through the full pipeline
nest:research	Research agent -- investigate approach, patterns, risks
nest:implement	Implementation agent -- write code following LocalNest conventions
nest:test	QA agent -- run tests, lint, verify build, diagnose failures
nest:review	Code review agent -- security, quality, backwards compatibility
nest:docs	Docs agent -- maintain Docusaurus site, changelog, skill refs
nest:release	Release agent -- version bumps, changelog, branch creation
nest:cicd	CI/CD agent -- GitHub Actions workflows, pipeline health
nest:hotfix	Hotfix agent -- fast-track bug fixes with minimal overhead
nest:skill-sync	Skill sync agent -- update skill definitions for all AI clients
nest:help	Show all available orchestration commands

When to Use This Page

• upgrading from any 0.0.x version to 0.1.0
• reviewing the TypeScript migration scope
• understanding the new performance characteristics
• checking which CLI modules are now available