Part of epic #1171. Should land last, once the other sub-issues (#1172-#1176) have actually
merged β the exact counts/category list below depend on which of them land and in what form.
π Problem Statement
gitgalaxy/security/README.md line 35 claims:
It applies highly optimized regular expressions to detect 13 distinct threat categories (e.g.,
Hardcoded Secrets, Memory Corruption, Prompt Injection).
This number happens to still be numerically correct right now purely by coincidence (security_lens.py's
THREAT_SIGNATURES dict has exactly 13 entries as of PR #1169), but the example list doesn't
mention unicode_steganography or self_propagation at all, and the count will silently go stale
the moment any of #1172/#1173/#1175/#1176 add a new signature key. More broadly: the README's
"Engineering Highlights" section documents entropy-based obfuscation detection (Obfuscation Detection (security_lens.py)) but has zero mention of the GlassWorm-style worm-detection
capability at all, despite it being a real, shipped, tested feature since PR #1169 β it's
currently invisible to anyone reading the README.
π― Objective
Bring gitgalaxy/security/README.md back in sync with what's actually shipped once epic #1171
lands, and give the worm-detection capability the same visibility the README already gives
entropy-based obfuscation detection.
π οΈ Proposed Implementation
β
Acceptance Criteria
Part of epic #1171. Should land last, once the other sub-issues (#1172-#1176) have actually
merged β the exact counts/category list below depend on which of them land and in what form.
π Problem Statement
gitgalaxy/security/README.mdline 35 claims:This number happens to still be numerically correct right now purely by coincidence (
security_lens.py'sTHREAT_SIGNATURESdict has exactly 13 entries as of PR #1169), but the example list doesn'tmention
unicode_steganographyorself_propagationat all, and the count will silently go stalethe moment any of #1172/#1173/#1175/#1176 add a new signature key. More broadly: the README's
"Engineering Highlights" section documents entropy-based obfuscation detection (
Obfuscation Detection (security_lens.py)) but has zero mention of the GlassWorm-style worm-detectioncapability at all, despite it being a real, shipped, tested feature since PR #1169 β it's
currently invisible to anyone reading the README.
π― Objective
Bring
gitgalaxy/security/README.mdback in sync with what's actually shipped once epic #1171lands, and give the worm-detection capability the same visibility the README already gives
entropy-based obfuscation detection.
π οΈ Proposed Implementation
THREAT_SIGNATURESactuallycontains once Extend self_propagation language coverage: fix dead PHP/Ruby token, add PowerShell + ShellΒ #1172/New signal: credential/token-file targeting (what a worm is actually after)Β #1173/New signal: persistence / auto-run registration (surviving a reboot)Β #1175/New signal (needs design pass): bulk environment/secret dump, gated on a nearby network sinkΒ #1176 have landed (checking, not assuming β
grep -cthe dictthe way this issue's investigation did, don't hand-count).
Detection" and "Shadow Patch & Evasion Detection" bullets) describing the self-propagation /
credential-targeting / persistence-registration signals and what real-world campaign
(GlassWorm) motivated them β with the same evidence-first tone the rest of the README uses
(link to specific signals/tests, not marketing language).
obfuscation_flag's SQLite column deserves a mention anywhere docs describe thefile_dataschema (if such a doc exists) now that it reads a real detector instead of ahardcoded 0.
readme-maintenanceskill for this β it governs this repo's specific tone/evidencerules (claims need paired links/numbers, section ordering is trust-ranked) rather than
freehanding the update.
β Acceptance Criteria
gitgalaxy/security/README.mdmatch the actualTHREAT_SIGNATURESregistry contentsevidence-first tone (see
readme-maintenanceskill)(quick grep for "13 distinct threat categories" and similar phrasing repo-wide)