All chapters25
On this page

HHY Language Report

HHY Language Status Report · 2026-09-01

Published status of HHY semantics, Runtime, performance, and engineering quality with reproducible CI measurements.

Release summary

DimensionQuestionCurrent conclusion
Language baselineAre core semantics stable?Pipe, Value, Stream, Error, and core callable contracts are frozen
Runtime healthAre resource, memory, and cancellation boundaries reliable?Resource limits, GC stress, sanitizers, fuzzing, and explicit ownership governance are present
PerformanceIs performance measurable and controlled?Fixed workloads, five-sample medians, machine-readable evidence, and blocking budgets are established
Engineering governanceAre changes auditable?Four-platform CI, layered gates, version consistency, and release evidence form a closed loop

Data at a glance

SignalResultEvidence basis
Current formal releasev1.3.10Four platform archives, per-asset SHA-256, and SHA256SUMS
Execution enginesBytecode default / AST fallbackFull dual-engine suite and machine-readable decision
Core callables96Runtime Callable Contract Registry
Continuous-verification platforms4macOS arm64, Linux arm64, Linux x86_64, Windows x86_64
Final CI engine gatesAll pass1M CPU 0.3695; short task 1.0088; sustained JSON 1.0207
Profiler overhead1.0269× / +2.786 msNine samples; limits 1.35× and 12 ms
Bytecode cacheNot admittedFive workloads × 21 samples; compile+verify is not a major cost
Complete practical projects6AST/Bytecode end-to-end acceptance with stable exit status

Overall baseline and compatibility

BaselineStable commitmentVerification
Language semanticsNo second Pipe, Stream, or Error modelSpecification examples, Parser/Checker fixtures, and valid-program regression
Callable contractsNames, arity, effect, lazy, cancellable, and threading metadata are machine-readableContract Registry JSON and 96-contract consistency checks
DiagnosticsCLI text and JSON/LSP share the Core checking pathDiagnostic schema and LSP protocol tests
Extension boundaryThird-party capabilities prefer the Process Extension ProtocolManifest integrity, Protocol 1, and official-extension acceptance
C ABIRuntime internals are not currently a public ABIReconsider only when real integrations prove the process protocol insufficient

The current formal baseline is v1.3.10. Bytecode is default; the AST evaluator remains the semantic oracle and is selectable through --engine ast or HHY_ENGINE=ast. Compiler-produced Stream Kernels must pass their independent Verifier; dynamic and unknown shapes fall back losslessly to general Bytecode.

v1.2.2 release and extension status

CapabilityCurrent stateAcceptance result
Extension distributionEd25519-signed Registry and deterministic resolutionTampering, unknown sources, and dependency conflicts fail closed
Reproducible environmentLockfile and content-addressed offline cacheThe same lock yields the same graph and rebuilds offline
Safe changeTransactional install, upgrade, and explicit rollbackFailed upgrades preserve the old environment
HTML 0.2.0Lexbor, CSS selectors, and single-parse multi-field projectionMalformed HTML, hard limits, truncation, and structured errors pass on four platforms
Protocol decisionRetain the bounded synchronous batch APINo real evidence requires stream credit, cross-call cancellation, or opaque handles
Open the HHY Language v1.2.2 releaseDownload all four platform archives and checksums and read the release notes.

v1.3.7–v1.3.10 Bytecode hardening

VersionCore deliveryVerified conclusion
v1.3.7Named specialization metadata, unified stack/error rules, fallback reasonsNo magic kinds; three-path differential and metamorphic gates pass
v1.3.8Compiler-produced versioned Stream Kernel IRRuntime does not inspect AST shapes; independent verification; safe dynamic fallback
v1.3.9Shared optimization decisions for normal and profiled executionKernel/opcode, cancellation, CPU/Heap attribution, and machine reports remain consistent
v1.3.10Performance-triggered cache governanceEvidence did not admit a cache; no process/disk cache; unverified external Bytecode rejected
Open the HHY Language v1.3.10 releaseFour platform archives, per-asset SHA-256, SHA256SUMS, and cache-governance release notes.

Measured performance

Final v1.3.10 CI evidence comes from commit 4ddc8c3 on GitHub Actions Ubuntu 24.04: schema-2 paired/interleaved engine benchmarks plus independent Profiler and cache-decision artifacts. Ratios are Bytecode/AST wall time; lower than one means Bytecode is faster.

GateMeasuredLimitResult
1M CPU0.3695×0.90×Pass
Short task1.0088×1.25×Pass
Sustained JSON/I/O1.0207×1.10×Pass
Profiler overhead1.0269× / +2.786 ms1.35× / +12 msPass
Cache-admission workloadCompile+verify medianCold-run medianShare
Hello0.0097 ms5.860 ms0.1649%
Advanced Flow0.0269 ms5.916 ms0.4546%
Stdlib0.0286 ms7.003 ms0.4086%
Sustained JSON0.0089 ms33.518 ms0.0266%
Core Flow 1M0.0105 ms166.285 ms0.0063%

v1.3.10 six-runtime same-machine rerun

Rerun on 2026-09-01 on macOS 26.6.2 arm64 with HHY 1.3.10, PHP 8.5.10, Go 1.27.0, Python 3.14.7, Lua 5.5.1, and OpenJDK 26.0.2.1. The fixed task maps, filters, stable-distincts, materializes, and counts one million integers; all six implementations validate output 333334. After two warmups, two independent rounds use seven deterministically shuffled and interleaved fresh processes per runtime. Wall time includes process startup; Go and Java are precompiled and compile time is excluded.

ImplementationVersionRound 1 medianRound 2 medianCombined range
Go1.27.07.995 ms7.969 ms7.622–15.325 ms
Lua5.5.118.368 ms17.957 ms17.582–19.822 ms
PHP8.5.1043.174 ms43.549 ms42.588–49.033 ms
JavaOpenJDK 26.0.2.149.394 ms48.153 ms46.995–53.066 ms
HHY Bytecode1.3.1055.297 ms53.404 ms51.027–78.702 ms
Python3.14.781.747 ms86.459 ms79.993–87.774 ms
ComparisonRound 1Round 2Interpretation
HHY / PHP1.28×1.23×HHY uses about 23%–28% more wall time on this task
HHY / Java1.12×1.11×Java is slightly faster including fresh-JVM startup
HHY / Python0.68×0.62×HHY takes less wall time on this task
HHY / Lua3.01×2.97×Lua is faster on this integer loop
HHY / Go6.92×6.70×Precompiled Go remains substantially faster

Governance conclusion and watch list

  • Overall status: v1.3.10 is formally released; v1.3.7–v1.3.10 semantic, three-path, Profiler, resource, and cache-governance gates are complete.
  • Engine policy: Bytecode is default; AST remains permanently available as the semantic oracle, differential-test engine, and --engine ast emergency fallback.
  • Performance conclusion: final CI reports 0.3695 for the 1M CPU ratio, 1.0088 for short tasks, 1.0207 for sustained JSON, and 1.0269× Profiler overhead; all gates pass.
  • Cache conclusion: compile+verify is not a major cold-run cost; no cache is introduced until new data and a complete threat model trigger review.
  • Cross-language conclusion: this same-machine fixed task has Go/Lua/PHP/Java ahead of HHY and HHY ahead of Python; it cannot be generalized to all workloads.
  • Update rule: synchronize this report whenever the release baseline, measurement method, engine/cache decision, or overall risk conclusion changes.
Open final v1.3.10 continuous-verification evidenceFour-platform builds, sanitizers, fuzzing, Profiler, cache decision, performance gates, and practical-project acceptance.