diff --git a/.github/workflows/security-scan.yml b/.github/workflows/security-scan.yml
index d8a36d2..a6dadc6 100644
--- a/.github/workflows/security-scan.yml
+++ b/.github/workflows/security-scan.yml
@@ -1,9 +1,9 @@
 name: security-scan
 
-# Max-heuristic, reliable push safeguard. Direct gitleaks FULL scan (entropy +
-# 150+ rules, respects .gitleaks.toml) — no partial/range scan, so force-pushes
-# and history rewrites don't break it. Plus key/.env/weight-file and private-IP
-# checks (the IP check skips docs/tests/examples to avoid flagging sample IPs).
+# For network tooling repos: hard-fail on real secrets (gitleaks) and committed
+# key/.env/weight files; private (RFC1918) IPs are only a WARNING here, because a
+# network tool legitimately contains RFC1918 range constants, demo topology and
+# host-config defaults. Home/server-specific IPs are scrubbed separately.
 
 on:
   push:
@@ -30,11 +30,11 @@ jobs:
           HITS=$(find . -path ./.git -prune -o -type f \( -name '*.key' -o -name '*.pem' -o -name '.env' -o -name '*.safetensors' -o -name '*.gguf' \) -print | grep -v '.env.example' || true)
           if [ -n "$HITS" ]; then echo "::error::key/.env/weight file committed:"; echo "$HITS"; exit 1; fi
           echo "OK: no key/.env/weight files."
-      - name: private IPs in code/config
+      - name: private IPs (warning only — network tool)
         if: always()
         run: |
           IP='(^|[^0-9.])(10\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}|192\.168\.[0-9]{1,3}\.[0-9]{1,3}|172\.(1[6-9]|2[0-9]|3[01])\.[0-9]{1,3}\.[0-9]{1,3})'
-          if grep -rIEn "$IP" --include='*.py' --include='*.ts' --include='*.js' --include='*.sh' --include='*.yaml' --include='*.yml' --exclude-dir=.git --exclude-dir=.github --exclude-dir=docs --exclude-dir=tests --exclude-dir=test --exclude-dir=__tests__ --exclude-dir=examples --exclude-dir=fixtures . ; then
-            echo "::error::private (RFC1918) IP in code/config — use 192.0.2.0/24 in examples."; exit 1
+          if grep -rIEn "$IP" --include='*.py' --include='*.ts' --include='*.js' --include='*.sh' --exclude-dir=.git --exclude-dir=.github --exclude-dir=docs --exclude-dir=tests . ; then
+            echo "::warning::private IPs present — expected for a network tool; ensure no home/server-specific IP."
           fi
-          echo "OK: no private IPs in code/config."
+          echo "done."