README.md (3002B)
1 # Operation contract v3 2 3 `context.versions.schema = "hyf_ops_v3"` selects the current contract for 4 `farm_update.interpret`, `buyer_request.interpret` and `buyer_request.match`. 5 The envelope remains version 1. These operations are **not activated**: the 6 daemon validates the versioned context and returns `capability_unavailable` 7 before legacy dispatch or provider execution. Full input/response schema and 8 semantic enforcement must be completed before activation. Schema examples and 9 reference checks do not establish that runtime enforcement. 10 11 V2 remains only as historical pre-activation parser/rejection characterization. 12 Its farm context, scaled money and model identifiers do not define v3. The 13 unversioned operation journeys must be characterized and cut over explicitly 14 before activation; they cannot become a second active business engine. 15 16 Public shared SDK wire values are mirrored exactly: 17 18 - Quantity is `{amount, unit}`. Amount is a canonical nonnegative decimal 19 string with coefficient at most 999999999999 and scale at most 6. Units are 20 `g`, `kg`, `mL`, `L` and integral `each`. Unknown quantity is an explicit 21 alternative; it is never encoded as zero. Approximation remains explicit. 22 - Money is `{currency, minor, exponent}`. Minor amount is a canonical integer 23 string at most 999999999999999; currency and exponent must match the pinned 24 public registry. Registry data includes its Apache license and attribution. 25 No conversion, price basis, fee, tax or exchange rate is inferred. 26 - Evaluation, source and ingestion timestamps use the shared `UnixSeconds` 27 representation: unsigned canonical ASCII strings from 0 to 253402300799. 28 RFC3339 is not an alternative v3 encoding. Relative language, source recency 29 and timezone interpretation remain shared SDK/host responsibilities. 30 31 Actor and workspace fields are descriptors. Parsing them does not authenticate 32 a participant or create an SDK `CommandContext`. The native host retains its 33 authenticated context and revalidates current scope, revisions and business 34 preconditions before any later use. A farm/organization association is optional; 35 buyer requests never need a private stock pool identifier. 36 37 Matching consumes authorized SDK projections and returns bounded suggestions 38 with explicit uncertainty, coverage and `commitment: "none"`. It owns no stock 39 allocation, reservation, order, permission or signing action. A source message 40 or model score cannot override an SDK failure. Consulted-record provenance must 41 be based on actual use, independently of whether a suggestion was produced. 42 Source evidence uses UTF-8 byte offsets and exact revisions. 43 44 The model axis is exact `jev-1.14.0`. Account/model availability and actual 45 returned identity require separate live qualification. Zero provider calls 46 requires null execution model and question bundle; manifest strings alone do 47 not prove model use. Existing frame, depth, provider, deadline, attempt and 48 cleanup limits remain binding as recorded in `manifest.json`.