# Changelog

## Score

- CAI 52 → 52 (+0.1)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.

## Lenses

- Code Health 54 → 53 (-0.9)
- Architecture 76 → 79 (+3.8)
- Maturity 61 → 65 (+3.7)
- Readiness 41 → 41 (+0.1)
- Security 70 → 65 (-4.8)
- Performance 100 → 100 (+0.0)

## Resolved (32)

- Duplicate FunctionCall definition. The API protocol includes an 'id' and 'type' field (OpenAI style), while the internal data tool utils uses a simpler structure with just name and arguments. This forces conversion logic between the API layer and the internal processing layer.
- Duplicate Role definitions with divergent values. The API protocol defines 'TOOL' as a role, while the data utils defines 'OBSERVATION'. These represent the same semantic concept (tool output/observation) but are named differently in different parts of the public surface, causing confusion for users implementing custom formatters or parsers.
- Duplicated block (15 lines × 2) (src/llamafactory/launcher.py)
- Duplicated block (15 lines × 3) (src/llamafactory/model/model_utils/longlora.py)
- Duplicated block (9 lines × 2) (scripts/dcp2hf.py)
- Hotspot: src/llamafactory/model/adapter.py (src/llamafactory/model/adapter.py)
- Hotspot: src/llamafactory/model/loader.py (src/llamafactory/model/loader.py)
- Hotspot: src/llamafactory/train/hyper_parallel/workflow.py (src/llamafactory/train/hyper_parallel/workflow.py)
- Hotspot: src/llamafactory/train/tuner.py (src/llamafactory/train/tuner.py)
- Hotspot: src/llamafactory/v1/core/model_engine.py (src/llamafactory/v1/core/model_engine.py)
- Hotspot: src/llamafactory/v1/core/rendering/rendering.py (src/llamafactory/v1/core/rendering/rendering.py)
- Hotspot: src/llamafactory/v1/plugins/trainer_plugins/distributed/fsdp2.py (src/llamafactory/v1/plugins/trainer_plugins/distributed/fsdp2.py)
- Leaked secret: hardcoded-credential (data/glaive_toolcall_en_demo.json)
- Leaked secret: hardcoded-credential (data/glaive_toolcall_en_demo.json)
- Leaked secret: hardcoded-credential (data/glaive_toolcall_en_demo.json)
- Leaked secret: hardcoded-credential (data/glaive_toolcall_en_demo.json)
- Leaked secret: hardcoded-credential (data/glaive_toolcall_en_demo.json)
- Leaked secret: hardcoded-credential (data/glaive_toolcall_en_demo.json)
- Leaked secret: hardcoded-credential (data/glaive_toolcall_en_demo.json)
- Near-duplicate member family (3 members, 40 shared lines) (src/llamafactory/model/model_utils/longlora.py)
- …and 12 more

## New (56)

- Duplicated block (9 lines × 2) (src/llamafactory/model/patcher.py)
- Edited copies of one member (3 members, 13+ corresponding lines) (src/llamafactory/v1/trainers/dpo_trainer.py)
- Edited copies of one member (3 members, 16+ corresponding lines) (src/llamafactory/data/tool_utils.py)
- Edited copies of one member (3 members, 25+ corresponding lines) (src/llamafactory/v1/plugins/model_plugins/kernels/ops/mlp/npu_fused_moe.py)
- Edited copies of one member (3 members, 4+ corresponding lines) (src/llamafactory/data/processor/feedback.py)
- Edited copies of one member (5 members, 3+ corresponding lines) (src/llamafactory/train/dpo/trainer.py)
- Edited copies of one member (5 members, 4+ corresponding lines) (src/llamafactory/train/dpo/trainer.py)
- Edited copy of a member (10 corresponding lines) (src/llamafactory/data/mm_plugin.py)
- Edited copy of a member (11 corresponding lines) (src/llamafactory/v1/plugins/trainer_plugins/batching.py)
- Edited copy of a member (12 corresponding lines) (scripts/convert_ckpt/llamafy_baichuan2.py)
- Edited copy of a member (14 corresponding lines) (src/llamafactory/data/tool_utils.py)
- Edited copy of a member (14 corresponding lines) (src/llamafactory/train/trainer_utils.py)
- Edited copy of a member (16 corresponding lines) (src/llamafactory/v1/trainers/dpo_trainer.py)
- Edited copy of a member (17 corresponding lines) (src/llamafactory/data/mm_plugin.py)
- Edited copy of a member (17 corresponding lines) (src/llamafactory/v1/plugins/trainer_plugins/distributed/fsdp2.py)
- Edited copy of a member (18 corresponding lines) (src/llamafactory/v1/plugins/model_plugins/kernels/ops/rms_norm/npu_rms_norm.py)
- Edited copy of a member (19 corresponding lines) (src/llamafactory/chat/hf_engine.py)
- Edited copy of a member (19 corresponding lines) (src/llamafactory/v1/plugins/model_plugins/kernels/ops/mlp/cuda_fused_moe.py)
- Edited copy of a member (19 corresponding lines) (src/llamafactory/v1/plugins/model_plugins/kernels/ops/mlp/npu_fused_moe.py)
- Edited copy of a member (20 corresponding lines) (src/llamafactory/data/template.py)
- …and 36 more

## Changes since last survey

- 15 commits — 7 feature/other, 8 fixes

## By area

- src/llamafactory — 8 commits
- .github/workflows — 2 commits
- (root) — 1 commit
- .agents/skills — 1 commit
- docker/docker-npu — 1 commit
- requirements/vllm.txt — 1 commit
- tests_v1/plugins — 1 commit

## Notable commits

- fix: Revert "[ci] Trigger docs workflow for README PRs (#10959)" (#10961)
- fix: [data] fix: parse nested JSON literals in LFM2 tools (#10940)
- fix: [docs] fix stale paths in the README (#10934)
- fix: [npu] Fix fused MoE backward, GDN patching and EP freezing (#10951)
- fix: [v1] Fix custom model export with FSDP2 (#10916)
- fix: [v1] fix: avoid HashStore in FSDP2 unit test on Windows (#10943)
- fix: fix model type cast (#10971)
- fix: fix(longlora): extend device type check to include Ascend NPU (#10829)
- change: [ci] Trigger docs workflow for README PRs (#10959)
- change: [deps] upgrade vllm to 0.28.0 (#10857)
- change: [docker] update CANN to 9.2.0 and torch-npu to 2.10.0.post7 (#10925)
- change: [model] add Xing4 model support (#10754)
- change: [npu] Skip unnecessary gradients in NPU fused MoE backward (#10918)
- change: [train] migrate HyperParallel model plans to replace schema (#10962)
- change: docs: add Qwen3.8 LlamaFactory SFT skill (#10901)

## Architecture

- Unchanged — 0 containers · 1 contexts · 0 edges
