{"id":"compute.kernels--portableKernelWorkContract","name":"portableKernelWorkContract","owner":"yeho","package":"compute.kernels","kind":"thing","signature":"external thing portableKernelWorkContract","description":"A portable kernel work contract record carrying rank, globalDimensions, localDimensions, boundsPolicy, localMemoryBytes, and related state.","context":"Describe reusable compute kernels and their workload contracts.","parameters":[],"returns":"void","members":[{"name":"rank","kind":"field","type":"int","description":"Stores rank as int.","signature":"int rank","tags":["thing","field","compute.kernels"],"updated":"2026-09-09"},{"name":"globalDimensions","kind":"field","type":"list of int","description":"Stores global dimensions as list of int.","signature":"list of int globalDimensions","tags":["thing","field","compute.kernels"],"updated":"2026-09-09"},{"name":"localDimensions","kind":"field","type":"list of int","description":"Stores local dimensions as list of int.","signature":"list of int localDimensions","tags":["thing","field","compute.kernels"],"updated":"2026-09-09"},{"name":"boundsPolicy","kind":"field","type":"text","description":"Stores bounds policy as text.","signature":"text boundsPolicy","tags":["thing","field","compute.kernels"],"updated":"2026-09-09"},{"name":"localMemoryBytes","kind":"field","type":"int","description":"Stores local memory bytes as int.","signature":"int localMemoryBytes","tags":["thing","field","compute.kernels"],"updated":"2026-09-09"},{"name":"barrierCount","kind":"field","type":"int","description":"Stores barrier count as int.","signature":"int barrierCount","tags":["thing","field","compute.kernels"],"updated":"2026-09-09"},{"name":"barrierPolicy","kind":"field","type":"text","description":"Stores barrier policy as text.","signature":"text barrierPolicy","tags":["thing","field","compute.kernels"],"updated":"2026-09-09"},{"name":"reductionKind","kind":"field","type":"text","description":"Stores reduction kind as text.","signature":"text reductionKind","tags":["thing","field","compute.kernels"],"updated":"2026-09-09"},{"name":"reductionOrder","kind":"field","type":"text","description":"Stores reduction order as text.","signature":"text reductionOrder","tags":["thing","field","compute.kernels"],"updated":"2026-09-09"},{"name":"portableKernelWorkContract","kind":"constructor","parameters":[{"name":"rank","type":"int","description":"Rank."},{"name":"globalDimensions","type":"list of int","description":"Global dimensions."},{"name":"localDimensions","type":"list of int","description":"Local dimensions."},{"name":"boundsPolicy","type":"text","description":"Bounds policy."},{"name":"localMemoryBytes","type":"int","description":"Local memory bytes."},{"name":"barrierCount","type":"int","description":"Barrier count."},{"name":"barrierPolicy","type":"text","description":"Barrier policy."},{"name":"reductionKind","type":"text","description":"Reduction kind."},{"name":"reductionOrder","type":"text","description":"Reduction order."}],"returns":"void","signature":"portableKernelWorkContract(int rank, list of int globalDimensions, list of int localDimensions, text boundsPolicy, int localMemoryBytes, int barrierCount, text barrierPolicy, text reductionKind, text reductionOrder)","description":"Portable kernel work contract.","tags":["thing","constructor","compute.kernels"],"updated":"2026-09-09"},{"name":"WorkItemCount","kind":"method","parameters":[],"returns":"int","signature":"WorkItemCount() returns int","description":"Work item count.","tags":["thing","method","compute.kernels"],"exampleId":"method-WorkItemCount-10","updated":"2026-09-09"},{"name":"DimensionValidationIssue","kind":"method","parameters":[],"returns":"text","signature":"DimensionValidationIssue() returns text","description":"Dimension validation issue.","tags":["thing","method","compute.kernels"],"exampleId":"method-DimensionValidationIssue-11","updated":"2026-09-09"},{"name":"MemoryAndBarrierValidationIssue","kind":"method","parameters":[{"name":"localMemoryLimitBytes","type":"int","description":"Local memory limit bytes."}],"returns":"text","signature":"MemoryAndBarrierValidationIssue(int localMemoryLimitBytes) returns text","description":"Memory and barrier validation issue.","tags":["thing","method","compute.kernels"],"exampleId":"method-MemoryAndBarrierValidationIssue-12","updated":"2026-09-09"},{"name":"ReductionValidationIssue","kind":"method","parameters":[],"returns":"text","signature":"ReductionValidationIssue() returns text","description":"Reduction validation issue.","tags":["thing","method","compute.kernels"],"exampleId":"method-ReductionValidationIssue-13","updated":"2026-09-09"},{"name":"ValidationIssue","kind":"method","parameters":[{"name":"localMemoryLimitBytes","type":"int","description":"Local memory limit bytes."}],"returns":"text","signature":"ValidationIssue(int localMemoryLimitBytes) returns text","description":"Validation issue.","tags":["thing","method","compute.kernels"],"exampleId":"method-ValidationIssue-14","updated":"2026-09-09"},{"name":"Describe","kind":"method","parameters":[],"returns":"text","signature":"Describe() returns text","description":"Describe.","tags":["thing","method","compute.kernels"],"exampleId":"method-Describe-15","updated":"2026-09-09"}],"tags":["compute","compute.kernels","cpu","kernels","method","source-example","thing","yeho"],"updated":"2026-09-09","source":{"repository":"yeho","path":"packages/compute/kernels/portable_contract.yh","line":78,"sha256":"374e7fc951e82c532d89923c59e362a879757e22adbb3165c1497fd7eb1e29d9"},"status":"source-declared","notes":["Package presence and a declaration do not establish support on every host. Host services need their platform and lifecycle setup."],"examples":[{"id":"usage","title":"Use portableKernelWorkContract","description":"A complete small caller. Values are illustrative; check the returned result and package requirements before connecting live resources.","code":"using compute.kernels\n\n// Describe reusable compute kernels and their workload contracts.\nportableKernelWorkContract sample = portableKernelWorkContract(1, [], [], \"bounds Policy\", 4, 1, \"barrier Policy\", \"reduction Kind\", \"reduction Order\")\nConsole.Log(Text.From(sample.rank))\n","manifest":"manifestVersion = \"2\"\npackage = \"api.example.compute_kernels__portablekernelworkcontract\"\nversion = \"0.1.0\"\nlanguageEdition = \"yeho-core-2026.1\"\n\n[app]\nkind = \"headless\"\n\n[[dependencies]]\npackage = \"compute.kernels\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/compute/kernels\"\n\n[[dependencies]]\npackage = \"compute.tensor\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/compute/tensor\"\n\n[[dependencies]]\npackage = \"console\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/console\"\n\n[[dependencies]]\npackage = \"diagnostics\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/diagnostics\"\n","tags":["cpu","source-example"],"verification":"type checked","run":"cpu-oracle","sha256":"53fcd6780f02341187c63dc7ebe81af4174d6e92988b85fba2f37efcb3547179","checked":"2026-09-09","diagnostic":"","observedOutput":null,"checkedBackend":null},{"id":"method-WorkItemCount-10","title":"portableKernelWorkContract.WorkItemCount","description":"A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.","code":"using compute.kernels\n\n// Work item count.\nportableKernelWorkContract instance = portableKernelWorkContract(1, [], [], \"bounds Policy\", 4, 1, \"barrier Policy\", \"reduction Kind\", \"reduction Order\")\nint result = instance.WorkItemCount()\nConsole.Log(Text.From(result))\n","manifest":"manifestVersion = \"2\"\npackage = \"api.example.compute_kernels__portablekernelworkcontract\"\nversion = \"0.1.0\"\nlanguageEdition = \"yeho-core-2026.1\"\n\n[app]\nkind = \"headless\"\n\n[[dependencies]]\npackage = \"compute.kernels\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/compute/kernels\"\n\n[[dependencies]]\npackage = \"compute.tensor\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/compute/tensor\"\n\n[[dependencies]]\npackage = \"console\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/console\"\n\n[[dependencies]]\npackage = \"diagnostics\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/diagnostics\"\n","tags":["cpu","method","source-example"],"run":"cpu-oracle","verification":"type checked","sha256":"3589a1328d1edcefd786edc8bcb3684ad772ac7f23ceae550efdbfb6d86f95d0","checked":"2026-09-09","diagnostic":"","observedOutput":null,"checkedBackend":null},{"id":"method-DimensionValidationIssue-11","title":"portableKernelWorkContract.DimensionValidationIssue","description":"A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.","code":"using compute.kernels\n\n// Dimension validation issue.\nportableKernelWorkContract instance = portableKernelWorkContract(1, [], [], \"bounds Policy\", 4, 1, \"barrier Policy\", \"reduction Kind\", \"reduction Order\")\ntext result = instance.DimensionValidationIssue()\nConsole.Log(Text.From(result))\n","manifest":"manifestVersion = \"2\"\npackage = \"api.example.compute_kernels__portablekernelworkcontract\"\nversion = \"0.1.0\"\nlanguageEdition = \"yeho-core-2026.1\"\n\n[app]\nkind = \"headless\"\n\n[[dependencies]]\npackage = \"compute.kernels\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/compute/kernels\"\n\n[[dependencies]]\npackage = \"compute.tensor\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/compute/tensor\"\n\n[[dependencies]]\npackage = \"console\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/console\"\n\n[[dependencies]]\npackage = \"diagnostics\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/diagnostics\"\n","tags":["cpu","method","source-example"],"run":"cpu-oracle","verification":"type checked","sha256":"3692adef976d9a70b70f445fb5b7bdc82d963651a911b24225094f19f0e6d01a","checked":"2026-09-09","diagnostic":"","observedOutput":null,"checkedBackend":null},{"id":"method-MemoryAndBarrierValidationIssue-12","title":"portableKernelWorkContract.MemoryAndBarrierValidationIssue","description":"A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.","code":"using compute.kernels\n\n// Memory and barrier validation issue.\nportableKernelWorkContract instance = portableKernelWorkContract(1, [], [], \"bounds Policy\", 4, 1, \"barrier Policy\", \"reduction Kind\", \"reduction Order\")\nint argument_localMemoryLimitBytes = 4\ntext result = instance.MemoryAndBarrierValidationIssue(argument_localMemoryLimitBytes)\nConsole.Log(Text.From(result))\n","manifest":"manifestVersion = \"2\"\npackage = \"api.example.compute_kernels__portablekernelworkcontract\"\nversion = \"0.1.0\"\nlanguageEdition = \"yeho-core-2026.1\"\n\n[app]\nkind = \"headless\"\n\n[[dependencies]]\npackage = \"compute.kernels\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/compute/kernels\"\n\n[[dependencies]]\npackage = \"compute.tensor\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/compute/tensor\"\n\n[[dependencies]]\npackage = \"console\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/console\"\n\n[[dependencies]]\npackage = \"diagnostics\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/diagnostics\"\n","tags":["cpu","method","source-example"],"run":"cpu-oracle","verification":"type checked","sha256":"21e53603b8eddf8f4a7726d69fe99ed4cd3cdd87ab5078c8dd97ba295e262cf2","checked":"2026-09-09","diagnostic":"","observedOutput":null,"checkedBackend":null},{"id":"method-ReductionValidationIssue-13","title":"portableKernelWorkContract.ReductionValidationIssue","description":"A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.","code":"using compute.kernels\n\n// Reduction validation issue.\nportableKernelWorkContract instance = portableKernelWorkContract(1, [], [], \"bounds Policy\", 4, 1, \"barrier Policy\", \"reduction Kind\", \"reduction Order\")\ntext result = instance.ReductionValidationIssue()\nConsole.Log(Text.From(result))\n","manifest":"manifestVersion = \"2\"\npackage = \"api.example.compute_kernels__portablekernelworkcontract\"\nversion = \"0.1.0\"\nlanguageEdition = \"yeho-core-2026.1\"\n\n[app]\nkind = \"headless\"\n\n[[dependencies]]\npackage = \"compute.kernels\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/compute/kernels\"\n\n[[dependencies]]\npackage = \"compute.tensor\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/compute/tensor\"\n\n[[dependencies]]\npackage = \"console\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/console\"\n\n[[dependencies]]\npackage = \"diagnostics\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/diagnostics\"\n","tags":["cpu","method","source-example"],"run":"cpu-oracle","verification":"type checked","sha256":"956c494c221242c58bbabd17448f5e23f47511f21efb206e32ba617888f9eba5","checked":"2026-09-09","diagnostic":"","observedOutput":null,"checkedBackend":null},{"id":"method-ValidationIssue-14","title":"portableKernelWorkContract.ValidationIssue","description":"A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.","code":"using compute.kernels\n\n// Validation issue.\nportableKernelWorkContract instance = portableKernelWorkContract(1, [], [], \"bounds Policy\", 4, 1, \"barrier Policy\", \"reduction Kind\", \"reduction Order\")\nint argument_localMemoryLimitBytes = 4\ntext result = instance.ValidationIssue(argument_localMemoryLimitBytes)\nConsole.Log(Text.From(result))\n","manifest":"manifestVersion = \"2\"\npackage = \"api.example.compute_kernels__portablekernelworkcontract\"\nversion = \"0.1.0\"\nlanguageEdition = \"yeho-core-2026.1\"\n\n[app]\nkind = \"headless\"\n\n[[dependencies]]\npackage = \"compute.kernels\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/compute/kernels\"\n\n[[dependencies]]\npackage = \"compute.tensor\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/compute/tensor\"\n\n[[dependencies]]\npackage = \"console\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/console\"\n\n[[dependencies]]\npackage = \"diagnostics\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/diagnostics\"\n","tags":["cpu","method","source-example"],"run":"cpu-oracle","verification":"type checked","sha256":"e1e22bf640e66e333fcab27b064c118508cb33a1d0172f7164e95ca66417e6b8","checked":"2026-09-09","diagnostic":"","observedOutput":null,"checkedBackend":null},{"id":"method-Describe-15","title":"portableKernelWorkContract.Describe","description":"A complete caller for this public method. Sample inputs are illustrative; native resources require their owning lifecycle.","code":"using compute.kernels\n\n// Describe.\nportableKernelWorkContract instance = portableKernelWorkContract(1, [], [], \"bounds Policy\", 4, 1, \"barrier Policy\", \"reduction Kind\", \"reduction Order\")\ntext result = instance.Describe()\nConsole.Log(Text.From(result))\n","manifest":"manifestVersion = \"2\"\npackage = \"api.example.compute_kernels__portablekernelworkcontract\"\nversion = \"0.1.0\"\nlanguageEdition = \"yeho-core-2026.1\"\n\n[app]\nkind = \"headless\"\n\n[[dependencies]]\npackage = \"compute.kernels\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/compute/kernels\"\n\n[[dependencies]]\npackage = \"compute.tensor\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/compute/tensor\"\n\n[[dependencies]]\npackage = \"console\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/console\"\n\n[[dependencies]]\npackage = \"diagnostics\"\nversion = \"0.1.0\"\npath = \"../../../yeho/packages/diagnostics\"\n","tags":["cpu","method","source-example"],"run":"cpu-oracle","verification":"type checked","sha256":"4adc686c9df31f7b241f4042d130985c6fdb9679c1bf05391031c9e08c000d4c","checked":"2026-09-09","diagnostic":"","observedOutput":null,"checkedBackend":null}],"searchTerms":["rank","globalDimensions","localDimensions","boundsPolicy","localMemoryBytes","barrierCount","barrierPolicy","reductionKind","reductionOrder","portableKernelWorkContract","WorkItemCount","DimensionValidationIssue","MemoryAndBarrierValidationIssue","ReductionValidationIssue","ValidationIssue","Describe"],"url":"https://demonhunterlabs.com/academy/api?item=compute.kernels--portableKernelWorkContract","json":"https://demonhunterlabs.com/reference/items/compute.kernels--portableKernelWorkContract.json","markdown":"https://demonhunterlabs.com/reference/text/compute.kernels--portableKernelWorkContract.md"}