diff --git a/plugins/llm-security/scanners/lib/severity.mjs b/plugins/llm-security/scanners/lib/severity.mjs
index d87972b..c2bd7c0 100644
--- a/plugins/llm-security/scanners/lib/severity.mjs
+++ b/plugins/llm-security/scanners/lib/severity.mjs
@@ -60,6 +60,7 @@ export function riskScore(counts) {
  * Legacy v1 risk score formula — kept for diff/comparison only.
  * Not exported in production paths; reference for CI re-calibration.
  *
+ * @deprecated Since v7.0.0. Use riskScore() instead. Kept for diff/comparison only — not used in production paths.
  * @param {{ critical: number, high: number, medium: number, low: number, info: number }} counts
  * @returns {number} 0-100 capped score (sum-and-cap model)
  */