README.md

Documentation Map

Current protocol version: 2026-09-02

Choose a Path

Goal	Read in order
Evaluate the project	Main README → Provider boundary → Production boundary
Integrate an application	Quickstart → Execution control loop → OpenAPI 3.1
Build a Provider	Provider boundary → Capability preflight → Conformance package
Operate safely	Production boundary → Security policy → Release process

Document Index

Need	Document
Run the reference server	Quickstart
Integrate over HTTP/SSE	OpenAPI 3.1
Understand lifecycle semantics	Protocol
Review state and invariants	Runtime model
Implement Artifact handling	Artifact descriptors
Configure the DSH adapter	DeepSeek Harness Provider
Compare neighboring protocols	Protocol stack
Understand execution transitions	Execution lifecycle
Understand one complete run	Execution control loop
Understand capability rejection	Capability preflight
Separate portable and native ownership	Provider boundary
Plan a production deployment	Production boundary
Review architecture decisions	Specification index
Review deployment risk	Security policy
Audit visual provenance	Visual asset index
Review release history	Changelog
Prepare a release	Release process

Source of Truth

• Zod schemas in packages/protocol are the executable portable contract.
• spec/openapi.yaml is the HTTP binding.
• spec/protocol.md and spec/runtime-model.md define portable behavior and invariants.
• Provider guides document adapter-specific support and degradation.
• Generated images explain the model but never override schemas or normative text.