refact(comments): state the mechanism, not the incident
Every comment that invoked a 'law' (50 word-boundary sites across 28 tracked files) now states what is going on and why, in terms that transfer to any project: gate twins drift until one side greenlights what the other refuses; a tag re-points while a digest pins; a restrictive engine behavior belongs to the runtime that imposed it and must be re-tested, not inherited; a speculative head is tensors in the file, not a flag; snapshot links dangle where the container resolves them; exit 0 is a clean stop to systemd, so a self-exiting daemon on on-failure goes dark reporting success. Event narratives and dates are gone from these comments; the mechanics carry the argument. Behavior-identical: bash -n, py_compile, yaml parse, full bats suite 408/408 green. One symbol rename rides along (stack script local scale_law -> scale_contract, with its log text).
This commit is contained in:
1 parent
65bd5ccea7
commit
d4ce76b68b
28 files changed
+195
-164
No files matched your search
@@ -29,9 +29,10 @@ set -euo pipefail
|
||||
|
||||
SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
|
||||
|
||||
# The artifact gates are the shared library: the serve script and the
|
||||
# deployer must refuse the same missing payload with the same words
|
||||
# (scripts/lib/llm-gates.sh; the fleet law from the 2026-10-01 crash-loop).
|
||||
# The artifact gates are the shared library (scripts/lib/llm-gates.sh): the
|
||||
# serve script and the deployer gate the same payload, and two hand-written
|
||||
# copies of the same checks drift apart until one side passes what the
|
||||
# other refuses.
|
||||
export GATE_PREFIX=frank-zealot
|
||||
# shellcheck disable=SC1091
|
||||
source "$SCRIPT_DIR/lib/llm-gates.sh"
|
||||
@@ -69,9 +70,9 @@ fi
|
||||
# FP8 class; no true fp8 KV dtype exists in this build).
|
||||
: "${CACHE_TYPE_K:=f16}"
|
||||
: "${CACHE_TYPE_V:=f16}"
|
||||
# Speculative decoding is OFF: this Q6_K file carries NO nextn/mtp tensors, so
|
||||
# there is no in-file head (the law: MTP is a property of the file, not of the
|
||||
# flags). SPEC_TYPE=none strips BOTH speculative flags (flags move as a set);
|
||||
# Speculative decoding is OFF: this Q6_K file carries NO nextn/mtp tensors,
|
||||
# so there is no in-file head — a speculative head is a property of the
|
||||
# model file, not of the flags; no flag creates tensors that are absent.
|
||||
# naming a drafter requires SPEC_DRAFT_FILE alongside SPEC_TYPE — the Gemma4
|
||||
# assistant on disk is arch gemma4-assistant and cannot drafter-match qwen35.
|
||||
: "${SPEC_TYPE:=none}"
|
||||
@@ -89,7 +90,7 @@ fi
|
||||
# Fail loudly rather than half-loading: a missing file is a download that
|
||||
# has not finished, and Restart=always would turn it into a crash loop that
|
||||
# reads like a runtime fault. The refusal text is the shared gate library's,
|
||||
# so the deployer's twin refuses identically (the 2026-10-01 crash-loop law).
|
||||
# so the deployer's twin refuses identically.
|
||||
require_file "$LLAMA_BIN" runtime \
|
||||
"build it: scripts/build-llama-master-cuda.sh" || exit 1
|
||||
require_file "$MODEL_FILE" gguf \
|
||||
|
||||
Reference in new issue
Block a user