Vocabulary and status labels used throughout the Fondaco chapters and the rest of this book.
Label Meaning
Shipped Available in the public Goldy crate today (0.2.x) Designed Specified and intended; not yet implemented, or only partially implemented Experimental Behind a feature flag, alpha binding, or unstable API Speculative Research or exploration; not committed to the roadmap Historical Superseded design kept for context
Do not describe Designed , Experimental , or Speculative capabilities as if they were Shipped .
Term Definition
Merchant The sovereign client: describes parcels and executes schemes; owns every parcel Scheme First-class computation: dispatches plus precedences (a partial order) Dispatch Atomic unit of work admitted to the machine Script Opaque procedure evaluated by a computing dispatch Yielding script Script with structured yield points where the runtime may be petitioned Parcel Stable identity for data held by the runtime in trust for the merchant Ownership / claim Access right over a parcel for the duration of a dispatch (public, private, or private-inaugural) Ledger Runtime standing record of claims across schemes (not merchant-addressable) Gate Interval between adjacent dispatches where the runtime has full intervention powers Exchange Stable mediated relationship with a foreign subsystem; each execution may publish a linear claim Warehouse Runtime-imposed bound on the total extent of parcels the merchant may hold Petition Structured service request filed at a yield point
Fondaco term Goldy type / concept Notes
Scheme Scheme, internal GraphIRPublic recording and submission API Dispatch Scheme node (compute, render, copy, clear, present) Workgroup grid for compute/render Script Slang via [goldy_*] virtual entry points Sole script language (Goldy choice) Parcel Parcel, Buffer, TextureStable handles; bindless indexing is backend-internal Ownership NodeAccess on scheme nodesPrecedences derived from access modes Ledger Cross-submission sync (ParcelStamp, timeline) Crate-private; clients use settlement APIs Gate Submission gate, Context::boundary_crossed Epoch-driven reclamation Exchange SurfaceExchange, MemoryExchangePresent: (&mut submission >> &transaction).take()? (canonical: Transaction → Claim → consume / discard). Deposit: (&deposit << &data)? tenders this submission; internal Claim consumed at copy dispatch Host claim PendingHostRead, HostView(&mut submission >> &parcel).take::<T>() — mapped read or staged copy; CUDA stages into cacheable pinned host memory on the producing stream. Public CPU ownership between gatesWarehouse BudgetPolicy, VramAllocatorBound on committed parcel extent Lease Lease<LeaseTexture>, Lease<LeaseBuffer>, Lease<LeaseRenderTarget>, PresentLeaseTemporary tenancy minted by the lessor (Context / surface pool); schemes intern on first use
Term Location Role
GraphIR task_graphInternal scheme representation Wave / partition analysis task_graph::analysisSubmission partitioning and transient coloring Bindless heap Backends Descriptor indexing; not public ABI
Machine Specification — normative semanticsGoldy Runtime Mapping — what Goldy ships vs designsRender Passes and Schemes — raster grain vs pass clusteringDesign Thesis — why this model on modern GPUsThe rest of this book — tutorials, programming model, and APIs