Module capability 

Explicit architecture capability registry for the generic GGUF path.

Mirrors the pinned llama.cpp llm_arch / LLM_ARCH_NAMES inventory (.scratch/llama.cpp/src/llama-arch.{h,cpp}) with Ferrox-side classification into decoder families, memory kinds, and scope. Unknown strings and detected-but-unimplemented features fail closed (LoadError) instead of silently defaulting into fluent-but-wrong logits.

Architecture names are registry keys only. Hot-path kernels never branch on them; load-time resolution produces an ArchProfile whose fields the decoder reads as plain data.

Structs

ArchProfile

Load-time resolved profile for one GGUF general.architecture string.

SwaPattern

llama.cpp’s hardcoded alternating sliding-window layout for one architecture: the period, and which end of each period is the full-attention layer.

UnauditedTriage

One architecture’s triage verdict, carried on its own catalog row.

Enums

ArchPath

How the generic Decoder / ModelConfig::from_gguf path treats a GGUF architecture string.

ArchScope

How far this architecture is in Ferrox’s delivery scope (plan: text-generation parity; encoder/multimodal/diffusion/audio deferred).

DecoderFamily

Shared execution family (maps many GGUF strings onto one engine path).

MemoryKind

Memory / KV backend selected once at load (llama.cpp create_memory).

QkNormStyle

How attn_q_norm / attn_k_norm weights are applied (when present).

TriageClass

How much work admitting one UNAUDITED architecture to the generic path would actually be.

Constants

AUDITED_GENERIC_GQA

Architectures on the shared generic-GQA path that somebody has actually PROVEN, and the evidence for each.

TRIAGE_PENDING

Unaudited generic-path architectures nobody has read against llama.cpp’s graph yet.

Functions

architecture_catalog

Full inventory keyed by GGUF general.architecture string. Kept in sync with .scratch/llama.cpp/src/llama-arch.cpp LLM_ARCH_NAMES.

coverage_report_markdown

Markdown coverage table for docs / CI drift checks.

default_swa_layout

is_audited_generic

Is this architecture’s use of the shared generic path backed by evidence?

resolve_architecture

Resolve a GGUF general.architecture value. None means the string is not in the registry — callers must fail closed rather than guess.

resolve_profile

Resolve a GGUF general.architecture value to its profile.

swa_disabled_by_arch

Every architecture for which llama.cpp seeds a sliding-window period before letting {arch}.attention.sliding_window_pattern override it, transcribed from src/models/*.cpp.

swa_rope_base_follows_model

True when this architecture’s SWA layers use the model’s own RoPE base rather than llama.cpp’s rope_freq_base_train_swa default of 10000.

unaudited_refusal_detail

The triage half of the UnauditedArchitecture refusal, rendered for the user.

unaudited_triage

This architecture’s triage verdict, or None when it has not been triaged (see TRIAGE_PENDING) or does not need one.

unsupported_feature_keys

Metadata keys that, when present with a nonzero value, require math ferrox’s generic decoder does not implement unless the architecture profile opts into those features (Gemma family).

unsupported_scaling_keys

Scalar multipliers a checkpoint can declare in metadata that the generic decoder does not apply, with the value that means “no-op”.

uses_geglu

Architectures whose FFN gate uses GELU rather than SiLU, i.e. GeGLU rather than SwiGLU.