SDIF Specification & Conformance Suite

The Single Point of Truth (SPOT) containing the official, stable format specification
and conformance test suite for the Semantic Data Interchange Format (SDIF).

Repository Structure · Conformance Verification · Ecosystem

Compact Less repeated structure. Fewer wasted tokens.

Semantic Tables, relations, metadata and intent.

Canonical Stable output for hashing, signing and comparison.

Auditable Designed to be read, reviewed and trusted.

---

Repository Structure

• docs/ — Official format specifications and analysis:
  • spec.md — Stable core format specification (stable @sdif 1.0 and @sdif.ai 1.0 contract).
  • canonicalization.md — Canonicalization and semantic stability rules.
  • semantic-quality.md — Semantic density, quality, and profile guidelines.
  • ai-speed-profile.md — Context window packing details.
  • comparison.md — Structural comparisons to JSON, YAML, XML, and TOON.
• conformance/ — Portable conformance fixture suite:
  • manifest.sdif — Reference manifest listing all valid and invalid cases.
  • valid/ — Conforming SDIF source documents and their corresponding canonical forms.
  • invalid/ — Non-conforming source documents designed to verify error detection.

---

Conformance Verification

All conforming parser and tool implementations MUST stay aligned with the fixtures in conformance/. Any changes to SDIF syntax, types, or canonical rules must be reflected in the spec and conformance suite before grammar or library extensions are implemented.

---

Ecosystem

This GitHub organization hosts the official SDIF ecosystem: the core format, reference tooling, benchmarks, examples, libraries, and editor extensions.

PYTHON CLIENT & CLI sdif-py Specification, parser, canonicalizer, and CLI. The normative reference implementation. Explore sdif-py →	SPECIFICATION (SSOT) sdif-spec Official format specification, canonicalization rules, and portable conformance test suite. View specification →	BENCHMARKS sdif-benchmarks Reproducible benchmark datasets and reports comparing SDIF with JSON, YAML, XML, and CSV. View benchmarks →
RUST IMPLEMENTATION sdif-rs Pure Rust parser implementation with a span-annotated AST designed for editor tooling. Explore sdif-rs →	LANGUAGE SERVER (LSP) sdif-lsp LSP language server binary (tower-lsp) providing real-time diagnostics and IDE features. View sdif-lsp →	EDITOR INTEGRATION vscode-sdif VS Code extension client providing syntax highlighting, diagnostics, and LSP configuration. Open extension →
GRAMMAR FOUNDATION tree-sitter-sdif Tree-sitter grammar foundation for syntax highlighting and incremental parsing. Open grammar →	DOCUMENTATION sdif-format.github.io Official documentation website containing specification guides, tutorials, and examples. Read docs →	ORGANIZATION META .github Organization profile, assets, and shared community configuration files. View profile →

Repository map

Repository	Purpose
sdif-py	Core Python parser, validator, canonicalizer, and CLI
sdif-spec	Official format specification and conformance test suite (SSOT)
sdif-benchmarks	Benchmark datasets, reports, and comparison tooling
sdif-rs	Rust parser crate with span-annotated AST
sdif-lsp	LSP language server binary
tree-sitter-sdif	Tree-sitter grammar foundation for syntax highlighting
vscode-sdif	VS Code extension client for SDIF
sdif-format.github.io	Public documentation website (Docusaurus)
.github	Organization profile, assets, and shared GitHub community files

License

This specification is licensed under the MIT License. See LICENSE for details.