docs: full reference + how-to set, migrate Makefile to Justfile Documentation overhaul that adds the missing user-facing surface: four reference pages (runtime-api, generated-api, cli, grpc-contract), twelve how-tos walking from first-message through custom transports, a troubleshooting page, and a docs/index map. Every how-to references a runnable artifact under examples/, all of them verified end-to-end. Build system migration: the Makefile is gone; the Justfile is now the canonical entry point and absorbs every target. examples/Justfile ships one recipe per runnable example, forwarded via top-level 'just examples <name>'. The 'examples are part of the documented surface' convention is pinned in CLAUDE.md, alongside a dedicated section on updating the conformance harness (PROTOBUF_TAG bumps, libjsoncpp path drift, new test-category wiring). Stale-number sweep across README/PLAN/CLAUDE: fixture count 18→10, test count 613/130→639, wire.lua LOC dropped, M7 marked done. Descriptor-shape block deduplicated against codegen.md as the canonical source. gRPC transports spec status reframed from 'draft / decision deferred' to 'shipped contract; external transports deferred'. .gitignore picks up *.snap / *.xlog / *.vylog / *.run / *.pid / 512.lock so example state can't leak into the working tree.
docs: spec out msgpack encoding and gRPC transport story Two design slices captured under docs/specs/ for later pickup: - msgpack_encoding.md: proto schemas as IDL, msgpack as wire format. Default mp_map keyed by field number; ARRAY/MP_TUPLE opt-ins for box.space feeders; WKT bridging to MP_DATETIME / MP_INTERVAL. - grpc_transports.md: Connect-JSON over HTTP/1.1 as default external transport, net.box tunnel for in-cluster, explicit no on HTTP/2 termination (recommend Envoy). Conformance anchored on connectrpc/conformance — same framed-runner shape as the existing protobuf conformance harness. PLAN.md cross-links both specs from M4, Open Questions, and Non-goals.