MDGraph 1.0.0

MDGraph 1.0.0

MDGraph 1.0.0 is the first stable release of the local-first Markdown document graph for AI coding workflows.

Compatibility promises

• Stable CLI commands, MCP tool names, documented JSON fields, configuration fields, GraphJSON v1, graph record types, edge kinds, and doctor warning shapes now follow the published 1.0 contract.
• Additive fields may be introduced without changing the meaning of existing stable fields.
• Internal SQLite details, private bundle internals, text presentation, and explicitly experimental helpers remain outside the stable contract.

Highlights

• Deterministic Markdown indexing, graph-aware search, context packing, node inspection, relationship tracing, and documentation health checks.
• Five MCP tools designed for AI coding agents, with freshness metadata and explainable provenance.
• Local SQLite storage with no required cloud service, LLM, or remote embedding provider.
• Trackable .mdgraph/config.json with built-in safety exclusions for dependencies, build outputs, caches, and local graph artifacts.
• Published ESM entry point with matching TypeScript declarations.
• English and Chinese documentation plus a reusable agent integration pack.

Validation

• 123 automated tests passed.
• Ubuntu and Windows full CI passed; macOS build, CLI, and packed-artifact smoke passed.
• Clean Git archive installation, build, tests, CLI/evaluation smoke, npm package import, TypeScript consumer, and strict doctor gates passed.
• The public npm package is @daogee/mdgraph; the installed command is mdgraph.

Node.js >=22.5.0 is required. Current Node versions may print an informational node:sqlite experimental warning.