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:
Frank committed 2026-10-14 13:36:40 -07:00
1 parent 65bd5ccea7
commit d4ce76b68b
28 files changed
+195 -164

No files matched your search

+8 -7
View File
@@ -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 \