Skip to content

Update docs to reflect the broadened GlassWorm-style worm detectorΒ #1177

Description

@squid-protocol

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

  • Threat-category count and example list in gitgalaxy/security/README.md match the actual
    THREAT_SIGNATURES registry contents
  • A new highlight bullet describes the worm-detection capability, in the README's existing
    evidence-first tone (see readme-maintenance skill)
  • No other doc in the repo is left claiming the old count or omitting the new capability
    (quick grep for "13 distinct threat categories" and similar phrasing repo-wide)

Metadata

Metadata

Assignees

No one assigned

    Labels

    appsecAgentic guardrails, prompt injection, and RCE sensorsdocumentationUpdates to standard operating procedures, guides, or wikipriority: lowUI tweaks, documentation, and minor optimizations

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions