A language-agnostic protocol for embedding DAG metadata in CommonMark, enabling agent conversational knowledge convergence. Alias: MD-DAG.
📖 Specification · Reference Implementation (Rust) · Releases
Lodestone Protocol (alias MD-DAG) defines a minimal, deterministic way to embed machine-readable DAG metadata into CommonMark documents via HTML comments. It is designed for AI agent systems that need a shared, conflict-free, file-is-current-state knowledge surface across multiple agents and sessions.
- Current version: v1.3.0 (Final, frozen) — see the Release
- Base standard: CommonMark 0.31.2
- Compliance badge: 25 Golden Fixtures, 14/14 diagnostic codes exercised
| Repository | Role | License |
|---|---|---|
| lodestone-spec | Protocol specification, error code registry, Golden Fixtures (authoritative source) | Apache-2.0 |
| lodestone-md | Rust reference implementation (23 tests, clippy-clean) | MIT |
Future per-language implementations (lodestone-py, lodestone-ts, …) will be added here as third-party demand emerges.
- Read the specification (start with §1–§3 for philosophy and syntax)
- Try the Rust reference implementation
- Pull the Golden Fixtures to validate your own implementation in any language
- Specification changes: open an issue in lodestone-spec — protocol is at v1.3 Final, changes require ADR-level discussion
- Reference implementation bugs: open an issue in lodestone-md
- ADR boundaries: see lodestone-spec/CONTRIBUTING.md
Be excellent to each other. Security issues should be reported privately via GitHub Security Advisories on the affected repository, not via public issues.
🌐 简体中文 · Lodestone Protocol is an independent open-source project.