hyf

Context-aware query service for Radroots
git clone https://radroots.dev/git/hyf.git
Log | Files | Refs | README | LICENSE

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`.