Specification

The Context Nest Specification is the canonical reference for the protocol. It defines the complete format, rules, and behavior that implementations must follow.

Current version

The specification is maintained in the context-nest-spec repository.

Sections

§	Section	Description
1	Vault Structure	Layout modes, CONTEXT.md, config.yaml
2	Selector Grammar	Composable query syntax
3	Source Nodes	Live data instructions, transports, dependencies
4	Addressing	`contextnest://` URI scheme, resolution, federation
5	Context Index	`context.yaml` manifest format
6	Per-Document Versioning	Keyframe + diff storage, history.yaml
7	Nest Checkpoints	Vault-level atomic snapshots
8	Integrity Verification	SHA-256 hash chains, cross-chain binding
9	Context Injection & Tracing	Query flow, audit tracing
10	Context Packs	Pack format, agent instructions
11	Configuration	config.yaml schema, server registry
12	Inline Syntax	Context links, tags, mentions
13	Validation Rules	Document, source, and cross-reference validation
14	Obsidian Compatibility	Flat layout, properties panel
15	Git Compatibility	Diff-friendly design, merge behavior
16	Extension Points	Custom fields, transports, edge types

Implementations

Package	Description
`@promptowl/contextnest-engine`	Core engine (TypeScript)
`@promptowl/contextnest-cli`	CLI tool
`@promptowl/contextnest-mcp-server`	MCP server

License

The specification is licensed under Apache-2.0.

Contributing

Contributions to the specification are welcome. See the spec repository for guidelines.