v0.1.7 - MCP Agent Fallback Prevention & Lockfile Fixes

Changes in v0.1.7

🛡️ MCP Tool Hardening & Agent Fallback Prevention

• Resilient Parameter Aliasing: All 15 MCP tools now accept common model variations (query/q/search/symbol/topic, endpoint/path, id for page & chunk, snippet/codeSnippet, from/to, goal/task/workflow, projectDir/dir) preventing runtime schema mismatch errors.
• Removed CLI Leaks: Eliminated references to CLI commands (docorbit add <url>) inside MCP tool output text, preventing coding agents from prematurely aborting tool calls and switching to bash.
• Graceful Multi-Source & Empty States: Output friendly markdown instructions with tool call recommendations (ingest_doc, search_docs, get_implementation_context) when resources are empty.
• Global / Local DB Fallback: MCP automatically detects existing ~/.docorbit/docorbit.db if local project database has not been initialized.
• Workspace Version Summary: get_version without parameters now returns a complete table of all detected workspace dependencies.

🔒 Lockfile Resolution Fix

• Fixed docs.lock generation where candidate sources without snapshots shadowed active documentation snapshots.
• Added automatic lockfile synchronization on docorbit add <url>.

🧪 Testing

• Added comprehensive unit tests covering all MCP parameter aliases and workspace lockfile resolution (133 passing tests).

v0.1.6 - Dedicated MCP Subcommand & Protocol Hardening

What's Changed in v0.1.6

🚀 Highlights & Improvements

• MCP Subcommand & Protocol Hardening: Made the mcp subcommand first-class and explicit for client environments (Cursor, Claude Desktop, Claude Code, Windsurf, Zed, Smithery).
• Automated Machine Pipe Detection: In addition to explicit docorbit mcp, automatic detection via !process.stdin.isTTY launches the stdio transport smoothly when piped by AI agent runners.
• Client Configuration Updates: Standardized configuration examples and Smithery integration to use ["-y", "docorbit", "mcp"].
• Project-Local Default with Dual Storage: Verified end-to-end functionality of -p (project-local default, .docorbit/docorbit.db) and -g (global store, ~/.docorbit/docorbit.db).
• 100% Verified MCP Tools: All 14 Model Context Protocol tools tested and verified with full JSON-RPC 2.0 conformance.

📦 Installation

# Zero-install execution via npx
npx -y docorbit mcp

# Global install
npm install -g docorbit

v0.1.5

DocOrbit v0.1.5 Release Notes

Highlights

• Project-Scoped Storage Default: All documentation is now indexed into <projectRoot>/.docorbit/docorbit.db by default. Deleting a project folder completely removes its documentation cache (zero disk leaks and zero version crosstalk between projects).
• Interactive Storage Selector: Running docorbit init or docorbit add in an interactive terminal prompts users to choose between [1] Project-local (default) and [2] Global.
• Flags -p and -g: Pass -p (--project) or -g (--global) to explicitly target storage and bypass interactive questions across all CLI commands.
• MCP Server Workspace Alignment: When launched from coding agents (Cursor, Claude Desktop, Claude Code, Zed), DocOrbit automatically scopes its SQLite knowledge graph to the current workspace root.
• Zero Dependencies: 100% native Node.js 22.5+ (node:sqlite, node:readline/promises, node:test). 131 tests passing.

v0.1.4

DocOrbit v0.1.4

• Zero-dependency version-aware documentation intelligence for AI coding agents
• 15 MCP tools over stdio
• Automated project dependency scanning (package.json, cargo.lock, go.mod)
• Closed-loop AST verification and documentation contract checking
• Zero-arg MCP auto-boot support
• glama.json and Smithery compatibility