Serialized Form

Package hydra.build.assembly

Class hydra.build.assembly.AssemblyEntry extends java.lang.Object implements Serializable

Serialized Fields

destTree

java.lang.String destTree

The destination tree, as a worktree-relative path (e.g. dist/<lang>/<pkg>/src)

exclude

java.util.List<java.lang.String> exclude

Relative path fragments to exclude when realizing the entry (e.g. __pycache__); empty means copy everything

kind

AssemblyEntryKind kind

How the source tree is realized at the destination

sourceTree

java.lang.String sourceTree

The source tree to realize, as a worktree-relative path (e.g. overlay/<lang>/<pkg>/src)

Class hydra.build.assembly.AssemblyEntryKind extends java.lang.Object implements Serializable

Class hydra.build.assembly.AssemblyEntryKind.Merge extends AssemblyEntryKind implements Serializable

Class hydra.build.assembly.AssemblyEntryKind.SymlinkDir extends AssemblyEntryKind implements Serializable

Class hydra.build.assembly.AssemblyEntryKind.SymlinkTree extends AssemblyEntryKind implements Serializable

Class hydra.build.assembly.AssemblyEntryKind.WipeThenCopy extends AssemblyEntryKind implements Serializable

Class hydra.build.assembly.AssemblyPlan extends java.lang.Object implements Serializable

Serialized Fields

entries

java.util.List<AssemblyEntry> entries

The copy/symlink entries to realize, in application order

keepPaths

java.util.List<KeepPathEntry> keepPaths

The files this plan is responsible for, recorded so a prune-stale pass does not delete them

Class hydra.build.assembly.KeepPathEntry extends java.lang.Object implements Serializable

Serialized Fields

relPath

java.lang.String relPath

The file's path relative to its source-set directory

sourceSetDir

java.lang.String sourceSetDir

The source-set directory the file belongs to, as a worktree-relative path

Package hydra.build.benchresult

Class hydra.build.benchresult.BenchMetadata extends java.lang.Object implements Serializable

Serialized Fields

branch

java.lang.String branch

The git branch

commit

java.lang.String commit

The short git commit hash

commitMessage

java.lang.String commitMessage

The commit subject line

language

java.lang.String language

The host language the benchmark ran on

timestamp

java.lang.String timestamp

ISO-8601 UTC timestamp of the run

Class hydra.build.benchresult.GenBenchResult extends java.lang.Object implements Serializable

Serialized Fields

hosts

java.util.Map<java.lang.String,HostResult> hosts

Per-host results, keyed by host language name

metadata

Optional<BenchMetadata> metadata

Optional run metadata

runs

java.lang.Integer runs

The number of timed runs per (host, package)

target

java.lang.String target

The target language being generated

Class hydra.build.benchresult.HostResult extends java.lang.Object implements Serializable

Serialized Fields

packages

java.util.Map<java.lang.String,RunStats> packages

Per-package run statistics, keyed by package name

setupMs

java.lang.Integer setupMs

Host setup/build time in milliseconds

Class hydra.build.benchresult.RunStats extends java.lang.Object implements Serializable

Serialized Fields

medianMs

java.lang.Integer medianMs

The median elapsed time in milliseconds

runsMs

java.util.List<java.lang.Integer> runsMs

Each run's elapsed time in milliseconds

Package hydra.build.comparereport

Class hydra.build.comparereport.CompareReport extends java.lang.Object implements Serializable

Serialized Fields

byteEqCount

java.lang.Integer byteEqCount

How many modules were byte-identical

rows

java.util.List<ModuleCompare> rows

One record per compared module

total

java.lang.Integer total

How many modules were compared

Class hydra.build.comparereport.CompareStatus extends java.lang.Object implements Serializable

Class hydra.build.comparereport.CompareStatus.ByteEq extends CompareStatus implements Serializable

Class hydra.build.comparereport.CompareStatus.Differ extends CompareStatus implements Serializable

Class hydra.build.comparereport.CompareStatus.Missing extends CompareStatus implements Serializable

Class hydra.build.comparereport.ModuleCompare extends java.lang.Object implements Serializable

Serialized Fields

canonSize

java.lang.Integer canonSize

The byte size of the canonical side

diffLines

java.lang.Integer diffLines

The number of differing lines (0 when byte-identical)

module

java.lang.String module

The module name (the JSON file's base name, without the .json suffix)

ourSize

java.lang.Integer ourSize

The byte size of our (freshly generated) side, or 0 if missing

status

CompareStatus status

The comparison status

Package hydra.build.format

Class hydra.build.format.DefinitionNameConventionProfile extends java.lang.Object implements Serializable

Serialized Fields

allowUnderscores

java.lang.Boolean allowUnderscores

Whether underscores are permitted in definition names

severity

Severity severity

How a finding of this check is treated

Class hydra.build.format.DefinitionValidationProfile extends java.lang.Object implements Serializable

Serialized Fields

duplicateName

Optional<Severity> duplicateName

Whether duplicate definition names within a module are reported

hasDescription

Optional<DocumentationProfile> hasDescription

Configuration for the definition-documentation check

nameConvention

Optional<DefinitionNameConventionProfile> nameConvention

Configuration for the definition-name-convention check

notInModuleName

Optional<Severity> notInModuleName

Whether a definition name may duplicate part of its module name

ordering

Optional<Severity> ordering

Whether definitions must appear in alphabetical order

Class hydra.build.format.DigestEntry extends java.lang.Object implements Serializable

Serialized Fields

hash

Sha256Hash hash

The SHA-256 hash of the file content

kind

DigestKind kind

The kind of artifact recorded

Class hydra.build.format.DigestKind extends java.lang.Object implements Serializable

Class hydra.build.format.DigestKind.DslSource extends DigestKind implements Serializable

Class hydra.build.format.DigestKind.JsonFile extends DigestKind implements Serializable

Class hydra.build.format.DigestKind.Other extends DigestKind implements Serializable

Class hydra.build.format.DigestKind.RuntimeFile extends DigestKind implements Serializable

Class hydra.build.format.DigestKind.TargetFile extends DigestKind implements Serializable

Class hydra.build.format.DocumentationProfile extends java.lang.Object implements Serializable

Serialized Fields

exemptDeprecated

java.lang.Boolean exemptDeprecated

Whether deprecated definitions are exempt from the documentation requirement

severity

Severity severity

How a finding of this check is treated

Class hydra.build.format.Generation extends java.lang.Object implements Serializable

Serialized Fields

generatorId

java.lang.String generatorId

The gating cache key identifying the generator that produced the outputs

host

LanguageName host

The producing host language (informational)

hydraVersion

Optional<Version> hydraVersion

The release version of the producing host (informational; omitted for shim builds)

mode

GenerationMode mode

Whether the artifact was produced by a published host or a locally-built migration shim

revision

Optional<java.lang.String> revision

The producing worktree's revision, as <short-sha> with "-dirty" appended when the tree has uncommitted changes (informational; required for shim builds)

timestamp

Optional<java.lang.String> timestamp

The ISO-8601 UTC time of generation (informational; non-deterministic across byte-identical rebuilds)

Class hydra.build.format.GenerationMode extends java.lang.Object implements Serializable

Class hydra.build.format.GenerationMode.Published extends GenerationMode implements Serializable

Class hydra.build.format.GenerationMode.Shim extends GenerationMode implements Serializable

Class hydra.build.format.HostOverride extends java.lang.Object implements Serializable

Class hydra.build.format.HostOverride.Local extends HostOverride implements Serializable

Class hydra.build.format.HostOverride.Version extends HostOverride implements Serializable

Serialized Fields

value

Version value

Class hydra.build.format.InputDigest extends java.lang.Object implements Serializable

Serialized Fields

dependencyHashes

java.util.Map<PackageName,Sha256Hash> dependencyHashes

For each declared dependency package, that package's selfHash as recorded at write time

digestFormatVersion

java.lang.Integer digestFormatVersion

The version of this digest file's own schema

moduleFormatVersion

java.lang.Integer moduleFormatVersion

The version of the JSON encoding of the sibling module files

moduleHashes

java.util.Map<ModuleName,Sha256Hash> moduleHashes

The hash of each module's source, keyed by module name

selfHash

Optional<Sha256Hash> selfHash

A deterministic hash over all of the package's per-module hashes (absent in legacy digests)

Class hydra.build.format.LanguageName extends java.lang.Object implements Serializable

Serialized Fields

value

java.lang.String value

Class hydra.build.format.ModuleValidationProfile extends java.lang.Object implements Serializable

Serialized Fields

conflictingVariantName

Optional<Severity> conflictingVariantName

Whether union variant names conflicting across the module are reported

definitions

Optional<DefinitionValidationProfile> definitions

Validation rules applying to the module's individual definitions

nameConvention

Optional<Severity> nameConvention

Whether module names must follow naming conventions

Class hydra.build.format.OutputDigest extends java.lang.Object implements Serializable

Serialized Fields

dependencyHashes

java.util.Map<PackageName,Sha256Hash> dependencyHashes

For each declared dependency package, that package's selfHash as recorded at refresh time

digestFormatVersion

java.lang.Integer digestFormatVersion

The version of this digest file's own schema

generation

Generation generation

The structured generation-provenance record

generator

java.lang.String generator

The flat gating generator identity (a compatibility duplicate of generation.generatorId)

inputs

java.util.Map<java.lang.String,DigestEntry> inputs

Every input file's kind and hash, keyed by worktree-relative path

moduleFormatVersion

java.lang.Integer moduleFormatVersion

The version of the JSON encoding of the module files this digest governs

outputs

java.util.Map<java.lang.String,DigestEntry> outputs

Every output file's kind and hash, keyed by path relative to the output directory

selfHash

Optional<Sha256Hash> selfHash

The input package's selfHash as recorded at refresh time (absent in legacy digests)

Class hydra.build.format.PackageDescriptor extends java.lang.Object implements Serializable

Serialized Fields

dependencies

java.util.List<PackageName> dependencies

The names of the packages this package depends upon

description

java.lang.String description

A concise human-readable summary of the package

name

PackageName name

The unique name of the package, e.g. "hydra-kernel"

packageFormatVersion

java.lang.Integer packageFormatVersion

The version of this descriptor file's schema

sourceLanguage

LanguageName sourceLanguage

The language in which the package's DSL sources are authored

targetLanguages

Optional<java.util.List<LanguageName>> targetLanguages

The target languages for which distributions of this package are generated. When absent, the default target set applies.

validation

Optional<PackageValidationConfiguration> validation

Optional per-package validation configuration. When absent, the validation engine's defaults apply.

Class hydra.build.format.PackageManifest extends java.lang.Object implements Serializable

Serialized Fields

mainDslModules

java.util.List<ModuleName> mainDslModules

The subset of main modules which define type schemas and give rise to generated DSL wrapper modules

mainEncodingModules

java.util.List<ModuleName> mainEncodingModules

The subset of main modules for which encoding and decoding modules are generated

mainModules

java.util.List<ModuleName> mainModules

All main-source-set modules in the package

manifestFormatVersion

java.lang.Integer manifestFormatVersion

The version of this manifest file's schema

moduleFormatVersion

java.lang.Integer moduleFormatVersion

The version of the JSON encoding of the sibling module files

package_

PackageName package_

The name of the package this manifest describes

testModules

java.util.List<ModuleName> testModules

All test-source-set modules in the package

Class hydra.build.format.PackageValidationConfiguration extends java.lang.Object implements Serializable

Serialized Fields

module

Optional<ModuleValidationProfile> module

Validation rules applying to each module

package_

Optional<PackageValidationProfile> package_

Validation rules applying to the package as a whole

term

Optional<TermValidationProfile> term

Validation rules applying to term-definition bodies

type

Optional<TypeValidationProfile> type

Validation rules applying to type-definition bodies

Class hydra.build.format.PackageValidationProfile extends java.lang.Object implements Serializable

Serialized Fields

conflictingModuleName

Optional<Severity> conflictingModuleName

Whether module names conflicting across the package are reported

duplicateModuleName

Optional<Severity> duplicateModuleName

Whether duplicate module names within the package are reported

nameConvention

Optional<Severity> nameConvention

Whether package names must follow naming conventions

Class hydra.build.format.RepositoryDescriptor extends java.lang.Object implements Serializable

Serialized Fields

author

java.lang.String author

The author attribution for published artifacts

currentVersion

Version currentVersion

The version currently under development

group

java.lang.String group

The group identifier under which artifacts are published, e.g. a Maven group id

hostOverrides

java.util.Map<LanguageName,HostOverride> hostOverrides

Per-host-language overrides of the default published-host consumption

hostVersion

Version hostVersion

The published host version consumed by default when generating code

license

java.lang.String license

The license identifier for published artifacts, e.g. "Apache-2.0"

packages

java.util.List<PackageName> packages

The names of the repository's source packages

url

java.lang.String url

The URL of the project

Class hydra.build.format.Severity extends java.lang.Object implements Serializable

Class hydra.build.format.Severity.Error_ extends Severity implements Serializable

Class hydra.build.format.Severity.Warning extends Severity implements Serializable

Class hydra.build.format.Sha256Hash extends java.lang.Object implements Serializable

Serialized Fields

value

java.lang.String value

Class hydra.build.format.TermValidationProfile extends java.lang.Object implements Serializable

Serialized Fields

duplicateBinding

Optional<Severity> duplicateBinding

Whether duplicate let bindings are reported

emptyTermAnnotation

Optional<Severity> emptyTermAnnotation

Whether empty term annotations are reported

undefinedVariable

Optional<Severity> undefinedVariable

Whether references to undefined variables are reported

Class hydra.build.format.TypeValidationProfile extends java.lang.Object implements Serializable

Serialized Fields

duplicateField

Optional<Severity> duplicateField

Whether duplicate field names within a record or union are reported

emptyAnnotation

Optional<Severity> emptyAnnotation

Whether empty type annotations are reported

singleVariantUnion

Optional<Severity> singleVariantUnion

Whether single-variant unions are reported