Kiln Documentation

ROCm/HF path-attribution result schema

Compare eager and retained HIP-graph logits and greedy selections against one bound Hugging Face reference state.

Source-bound comparison of four Kiln ROCm paths—eager full logits, eager greedy selection, retained HIP-graph full logits, and retained HIP-graph greedy selection—against one retained eager Hugging Face full-vocabulary reference at the exact first-divergence state.

Schema identity

Property Value
Title Kiln ROCm/HF Numerical Path Attribution Result v2
$id https://ericflo.github.io/kiln/schemas/rocm-hf-path-attribution-v2.schema.json
Dialect https://json-schema.org/draft/2020-12/schema
Root type object
Root object closed

Root fields

Field Required Type Constraints and default Description
schema yes any const "kiln.rocm-hf-path-attribution-result.v2" Schema identifier for this path-attribution result.
result_sha256 yes sha256 - Canonical SHA-256 identity of the complete result after removing this self-hash field.
created_at_utc yes string format date-time UTC time when the result record was created.
duration_seconds yes number exclusive minimum 0 Total wall-clock duration of build, fingerprinting, contained execution, verification, and result assembly.
source yes object closed object The exact clean commit, origin/main commit, and Git tree used to build and execute the worker.
binary yes object closed object The bounded offline release build admitted by the hash-bound execution shim.
implementation yes object closed object Content identities for the source-bound runner, exact-argv gate, and process runner.
request yes object closed object Repository-local first-divergence request and its canonical content identity.
model_identity yes modelIdentity - Recomputed content identity of the exact model, tokenizer, chat template, configuration, and weight shards.
model_fingerprint yes modelFingerprintEvidence - Implementation and process evidence for the separate contained model-fingerprinting step.
oracle_reference yes object closed object The retained HF oracle result and ignored raw safetensors reference consumed by the Kiln worker.
containment yes object closed object Host admission, private-network policy, and process cleanup evidence.
worker yes worker - Four-path numerical evidence and the first path that explains the observed divergence.

Definitions

sha256Lowercase SHA-256 digest with the `sha256:` algorithm prefix.0 fields

Type: string. Constraints: pattern ^sha256:[0-9a-f]{64}$.

gitObjectFull lowercase SHA-1 Git object identifier.0 fields

Type: string. Constraints: pattern ^[0-9a-f]{40}$.

tokenIdTokenizer vocabulary ID for the bound Qwen3.5-4B model identity.0 fields

Type: integer. Constraints: minimum 0; maximum 248319.

tokenSequenceFour predicted tokens: one after the prompt and one after each of the three forced common continuation tokens.0 fields

Type: array<tokenId>. Constraints: minimum items 4; maximum items 4.

candidateLogitOne disputed candidate token annotated with its logit and one-based rank in a Kiln full-vocabulary path.3 fields

Type: object. Constraints: closed object.

Field Required Type Constraints and default Description
logit yes number - Kiln F32 logit at this candidate's vocabulary ID.
rank yes integer minimum 1; maximum 248320 One-based rank of this candidate in the complete Kiln vocabulary, with 1 denoting the argmax.
token_id yes tokenId - Vocabulary ID of the disputed candidate.
comparisonFull-vocabulary F32 comparison with the retained HF logits after the third continuation token.8 fields

Type: object. Constraints: closed object.

Field Required Type Constraints and default Description
argmax yes tokenId - Kiln argmax token ID for this full-logits path.
argmax_equal yes boolean - Whether this Kiln argmax equals the retained Hugging Face argmax.
candidate_tokens yes array<candidateLogit> minimum items 2; maximum items 2 The disputed Kiln and vLLM candidates annotated with their logit and rank in this Kiln path.
cosine_similarity yes number minimum -1; maximum 1 Cosine similarity between this complete Kiln F32 logit vector and the retained Hugging Face vector.
logits_sha256 yes sha256 - SHA-256 identity of this path's contiguous F32 full-vocabulary logit bytes.
max_abs_error yes number minimum 0 Largest elementwise absolute difference from the retained Hugging Face logits.
mean_abs_error yes number minimum 0 Mean elementwise absolute difference from the retained Hugging Face logits.
top10_overlap yes integer minimum 0; maximum 10 Number of vocabulary IDs shared by the two unordered top-ten token sets.
fullPathOne Kiln path that materializes full-vocabulary logits at the final forced-continuation state.2 fields

Type: object. Constraints: closed object.

Field Required Type Constraints and default Description
comparison yes comparison - Numerical comparison between this path's final logits and the retained Hugging Face reference.
observed_next_tokens yes tokenSequence - Predicted token after the prompt and after each forced continuation step.
greedyPathOne Kiln greedy-selection path that records tokens without retaining a full-vocabulary comparison.2 fields

Type: object. Constraints: closed object.

Field Required Type Constraints and default Description
final_token_matches_reference yes boolean - Whether the token selected after the third forced continuation equals the retained Hugging Face argmax.
observed_next_tokens yes tokenSequence - Predicted token after the prompt and after each forced continuation step.
graphCumulative graph evidence after one retained-slot prime and exact full and greedy replay rows.9 fields

Type: object. Constraints: closed object.

Field Required Type Constraints and default Description
cache_admission_successes yes integer minimum 1 Number of captured graphs admitted to the retained graph cache.
capture_attempts yes integer minimum 1 Number of HIP graph-capture attempts during the worker.
capture_failures yes any const 0 Number of HIP graph-capture failures; retained evidence requires zero.
capture_successes yes integer minimum 1 Number of successful HIP graph captures during the worker.
enabled yes any const true Whether the retained HIP graph route was enabled.
fallbacks yes any const 0 Number of graph-path executions that fell back to eager execution; retained evidence requires zero.
replay_attempts yes integer minimum 7 Number of retained HIP graph-replay attempts, including priming and both comparison paths.
replay_failures yes any const 0 Number of HIP graph-replay failures; retained evidence requires zero.
replay_successes yes integer minimum 7 Number of successful retained HIP graph replays.
workerOne-model-load comparison across the four production-relevant numerical and selection paths.12 fields

Type: object. Constraints: closed object.

Field Required Type Constraints and default Description
schema yes any const "kiln.rocm-hf-path-attribution.v2" Schema identifier for the contained worker marker.
attribution yes any enum "eager_full_logits", "hip_graph_full_logits", "eager_greedy_selection", "hip_graph_greedy_selection", "serving_only_or_not_reproduced" First evaluated path that diverges from the retained Hugging Face argmax, or serving_only_or_not_reproduced when all four isolated paths match.
eager_full yes fullPath - Eager Kiln path that retains and compares full-vocabulary logits.
eager_greedy yes greedyPath - Eager Kiln path that uses ordinary greedy token selection.
graph yes graph - Cumulative capture, cache-admission, replay, and fallback counters proving that the graph paths actually replayed.
graph_full yes fullPath - Retained HIP graph path that returns and compares full-vocabulary logits.
graph_greedy yes greedyPath - Retained HIP graph path that uses ordinary greedy token selection.
hf_argmax yes tokenId - Argmax token ID from the retained eager Hugging Face reference.
input_token_count yes any const 166 Complete prompt-plus-continuation token count for this fixed first-divergence request.
input_token_ids_sha256 yes sha256 - Canonical SHA-256 identity of the complete input-token sequence.
kernel_policy yes any const "qualified" ROCm kernel profile installed for the isolated worker.
request_id yes string minimum length 1 Identifier copied from the bound next-token request.