Repository navigation
v0.2.0
yamlprims v0.2.0
Feature release of yamlprims implementing the spec-v1.5 YAML 1.2.2 Core Schema data-layer writer, checked caller-tree constructors, stack-safe heap-worklist Node operations, symmetric decode_wire over yamlprims-value/1, and strict six-rule RFC 7493 I-JSON projection across Rust (yamlprims), pure Go (github.com/3leaps/yamlprims/yaml), TypeScript WebAssembly (@3leaps/yamlprims), Python PyO3/maturin (yamlprims), and the yamlprims CLI (ADR-0005).
What it ships
- Deterministic YAML 1.2.2 Core Schema emitter (
spec-v1.5 §10.2):- Rust (
yamlprims):emit,emit_with,emit_all,emit_all_with,CompatQuoting(Yaml11Safedefault,CoreOnly),EmitLimits,EmitOptions, andserde::Serializesupport (impl serde::SerializeforValue/Node/Document/Mapping/Integerplusto_node,to_string, andto_string_with). - Go (
github.com/3leaps/yamlprims/yaml):Emit,EmitWith,EmitAll,EmitAllWith,CompatQuoting(CompatQuotingYaml11Safedefault,CompatQuotingCoreOnly),EmitLimits,EmitOptions,FromPlain,Marshal, andMarshalWith. - TypeScript (
@3leaps/yamlprims):dump,dumpAll,fromPlain,defaultEmitLimits, anddefaultEmitOptionsover the zero-importwasm32-unknown-unknownmodule (emit_wire,load_ijson). - Python (
yamlprims):dump,dump_all,from_plain,EmitLimits, andEmitOptionsover thecp310-abi3PyO3module (GIL detached during native emission and wire decoding). - CLI (
yamlprims):yamlprims emit(--from-wire,--from-plain,--compat-quoting=yaml11_safe|core_only,--merge=reject|apply|as_key,--max-output-bytes=N).
- Rust (
- Strict RFC 7493 I-JSON projection (
spec-v1.5 §11.6):- Rust:
encode_ijson,load_ijson,load_ijson_with,load_ijson_bytes, andOptions::ijson_default(). - Go:
EncodeIJSON,EncodeIJSONWith,LoadIJSON,LoadIJSONWith,LoadIJSONBytes, andDefaultIJSONOptions(). - TypeScript & Python:
loadIjson/load_ijson. - CLI:
yamlprims dump --ijson. - Enforces the six RFC 7493 rules: single non-empty-stream document (
ErrorKind::Type { expected: "single YAML document", found: "empty_stream" }on empty/comment-only streams,MultipleDocumentson>1), IEEE 754 safe integers in[-9_007_199_254_740_991, +9_007_199_254_740_991](IntegerOutOfRange), finitebinary64floats with-0.0emitted as0(FloatOutOfRangeonNaN/±Infinity),String-only mapping keys (ErrorKind::Type { expected: "I-JSON string key", found: "non_string_key" }), mandatoryUnknownTags::Reject(UnknownTagon anyTaggednode), and rejection of all 66 Unicode noncharacters (U+FDD0..=U+FDEFandU+nFFFE/U+nFFFFacross planes0..=16) in keys and strings (ErrorKind::Type { expected: "RFC 7493 I-JSON string", found: "noncharacter" }).
- Rust:
- Checked caller-tree construction, stack-safe
Nodeoperations, and symmetricdecode_wire(spec-v1.5 §3,§6,§11.1):- Checked
Document::new,Document::with_metadata,Tag::try_new,Tag::with_spelling,Tagged::new, andNode::into_valuein Rust (plus aligned GoNewSimpleDocument,TryNewDocumentWithMetadata,TryNewTag,TryNewTagWithSpelling,TryNewTagged). - Iterative heap-worklist
Drop,Clone, andPartialEqplus depth-boundedDebug(<= 255) forNode,Value,Mapping,Tagged, andDocument, preventing call-stack overflow on deep caller-constructed trees on 2 MiB threads. - Symmetric Rust
decode_wire(json: &str, opts: &Options) -> Result<WireEnvelope, Error>and aligned GoDecodeWireenforcingLimitsbefore materialization.
- Checked
Conformance & differential parity
- Pinned
structcorpusload and emit round-trip qualification (conformance/pins/pin-6b1266e.json): Both the Rust conformance driver (crates/yamlprims/examples/structcorpus.rs) and the pure-Go conformance driver (cmd/structcorpus-driver) qualify all20profile rows ofstructcorpuscommit6b1266e16676dc456328eb64c0eed028060845c3acrossspec-v1.0throughspec-v1.4(61,366corpus cases /90,988expectations, includingload -> emit_all_with -> loadsemantic identity across every positive value expectation in both drivers, plus51synthetic revision 1.4 boundary probes). - Four-language byte-for-byte parity (
176in-repo vectors):make crosscheck,make ts-check, andmake python-checkverify byte-for-byte agreement across Rust, Go, TypeScript, and Python on all176in-repo conformance vectors (conformance/vectors/cases.jsonl, SHA-25691916121ab33318509739adce37e1e45804b20514c66339d1c1a97d028e690dc) coveringyamlprims-value/1wire output,decode_wireround-trip, plain JSON projection, deterministicemit_alloutput, andencode_ijsonprojection.
Verification
The yamlprims CLI parses, emits, and projects YAML; it verifies no cryptographic signatures and embeds no keys. To verify this release, verify the annotated OpenPGP-signed v0.2.0 tag and the dual-signed checksum manifests (SHA256SUMS and SHA512SUMS, signed with both Minisign and the OpenPGP release signing subkey) against the public pins committed in the tagged tree (docs/security/ and keys/expected-fingerprints.txt); see docs/security/README.md and RELEASE_CHECKLIST.md.