llard Service Specification

This document specifies the externally observable contract of the llard HTTP service: its request/response format and the guarantees a client may rely on. It does not describe internal mechanisms.

Request

GET /v1/artifacts/<module>@<version>?<matrix query>

Path

• <module> — package module identifier (e.g. madler/zlib).
• <version> — version string (e.g. v1.3.1).

Query

• A flat set of key=value pairs, in the natural shape of the LLAR matrix CLI (e.g. arch=amd64&os=linux&debug=false).
• The query string is not a serialized formula.Matrix and does not expose Require or Options.
• The mapping from query values to LLAR's internal matrix representation is owned by the LLAR build path and is not part of this wire protocol.

Response

• Content type: application/x-cmdjsonl. See github.com/qiniu/x/cmdjsonl for the line format (Command <space> JSON object, newline-delimited).