Skip to content

alexgreensh/repo-forensics / skills/repo-forensics

repo-forensics

Flagged

Security forensics for git repos, AI skills, and MCP servers. Audits dependencies, detects prompt injection, credential theft, runtime dynamism, manifest drift, known CVEs, CISA KEV (actively exploited) vulns, and 2026 attack patterns. Not for fixing vulnerabilities or pentesting.

FileKindSize
.gitignoreother193 B
SKILL.mdskill md43.4 KB
checksums.jsonconfig10.8 KB
checksums.json.sigother64 B
data/README.mdmarkdown1.3 KB
data/compromised_versions.jsonconfig188.3 KB
data/rule_ids.csvother35.3 KB
data/rulepacks/.gitkeepother221 B
data/rulepacks/dead_anchors.jsonconfig9.0 KB
data/rulepacks/mcp_security.jsonconfig31.2 KB
data/rulepacks/runtime_dynamism.jsonconfig46.7 KB
data/rulepacks/sast.jsonconfig107.6 KB
data/rulepacks/secrets.jsonconfig30.4 KB
data/rulepacks/shared.jsonconfig4.4 KB
data/rulepacks/skill_threats.jsonconfig95.4 KB
data/runtime_floors.jsonconfig2.3 KB
data/yara/cryptominers.yarother1.8 KB
data/yara/hacktools.yarother2.2 KB
data/yara/malware.yarother2.2 KB
data/yara/manifest.jsonconfig8.0 KB
data/yara/webshells.yarother2.5 KB
references/cursor-hook-contract.mdmarkdown5.6 KB
references/kernel_privesc_sandbox_pack.mdmarkdown5.0 KB
references/mcp-attack-patterns.mdmarkdown8.7 KB
references/research_sources.mdmarkdown8.0 KB
references/threat_patterns.mdmarkdown20.3 KB
scripts/_context_gate.pyscript21.7 KB
scripts/_ed25519.pyscript5.1 KB
scripts/_pyc_unmarshal.pyscript17.1 KB
scripts/_shared_patterns.pyscript4.8 KB
scripts/adjudication.pyscript16.4 KB
scripts/adjudication_bridge.pyscript1.0 KB
scripts/aggregate_json.pyscript69.2 KB
scripts/auto_scan.pyexecutablescript152.1 KB
scripts/corpus_sync.pyscript10.0 KB
scripts/cursor_pre_scan.pyscript22.5 KB
scripts/dast_sandbox.sbother1.6 KB
scripts/dead_anchors_extract.pyscript14.8 KB
scripts/dead_anchors_probe.pyscript27.1 KB
scripts/forensics_core.pyscript176.5 KB
scripts/gen_rule_ids.pyscript8.6 KB
scripts/hook_adapter.pyscript19.4 KB
scripts/ioc_manager.pyscript49.6 KB
scripts/parse_pnpm_lock.pyscript7.9 KB
scripts/pre_scan.pyscript143.5 KB
scripts/pypi_pins.pyscript8.1 KB
scripts/refresh_controller.pyexecutablescript48.4 KB
scripts/refresh_threat_dbs.pyexecutablescript19.4 KB
scripts/rule_loader.pyscript44.8 KB
scripts/rulepack_feed.pyscript26.4 KB
scripts/run_forensics.shexecutablescript20.3 KB
scripts/sarif_export.pyscript18.6 KB
scripts/scan_agent_skills.pyscript33.2 KB
scripts/scan_archive.pyscript29.1 KB
scripts/scan_ast.pyscript44.9 KB
scripts/scan_binary.pyscript10.9 KB
scripts/scan_bytecode.pyscript28.2 KB
scripts/scan_dast.pyscript28.8 KB
scripts/scan_dataflow.pyscript15.4 KB
scripts/scan_dead_anchors.pyscript15.9 KB
scripts/scan_decode.pyscript37.5 KB
scripts/scan_dependencies.pyscript124.5 KB
scripts/scan_devcontainer.pyscript8.5 KB
scripts/scan_entropy.pyscript15.6 KB
scripts/scan_entrypoint.pyscript34.3 KB
scripts/scan_git_config.pyscript96.3 KB
scripts/scan_git_forensics.pyscript24.1 KB
scripts/scan_history.pyscript14.5 KB
scripts/scan_infra.pyscript54.3 KB
scripts/scan_integrity.pyscript41.0 KB
scripts/scan_lifecycle.pyscript65.1 KB
scripts/scan_manifest_drift.pyscript47.0 KB
scripts/scan_mcp_security.pyscript42.3 KB
scripts/scan_oversize.pyscript11.7 KB
scripts/scan_post_incident.pyscript36.9 KB
scripts/scan_provenance.pyscript19.4 KB
scripts/scan_runtime_dynamism.pyscript23.5 KB
scripts/scan_runtime_floors.pyscript33.5 KB
scripts/scan_sast.pyscript59.1 KB
scripts/scan_secrets.pyscript11.9 KB
scripts/scan_skill_threats.pyscript102.4 KB
scripts/scan_splitstream.pyscript29.5 KB
scripts/scan_yara.pyscript19.7 KB
scripts/session_scan.pyscript54.1 KB
scripts/suppressions.pyscript15.4 KB
scripts/validate_manifests.pyscript13.7 KB
scripts/verify_install.pyscript26.2 KB
scripts/vuln_feed.pyscript31.1 KB
tests/conftest.pyscript13.4 KB
tests/corpus/DEAD_ANCHORS_CORPUS.mdmarkdown2.3 KB
tests/corpus/budgets.jsonconfig5.6 KB
tests/cursor_helpers.pyscript12.6 KB
tests/fixtures/legacy_main_blocks.jsonconfig10.3 KB
tests/fixtures/powershell_verdict_corpus.jsonconfig114.9 KB
tests/golden/parity_mcp_security.jsonconfig17.5 KB
tests/golden/parity_runtime_dynamism.jsonconfig31.7 KB
tests/golden/parity_sast.jsonconfig59.8 KB
tests/golden/parity_secrets.jsonconfig18.8 KB
tests/golden/parity_skill_threats.jsonconfig48.8 KB
tests/parity_corpus.pyscript6.3 KB
tests/powershell_hook.pyscript8.2 KB
tests/report_builders.pyscript5.0 KB
tests/schemas/sarif-schema-2.1.0.jsonconfig109.1 KB
tests/shell_compat.pyscript2.2 KB
tests/test_adjudication_bridge.pyscript832 B
tests/test_adjudication_containment.pyscript1.4 KB
tests/test_adjudication_output.pyscript20.0 KB
tests/test_adjudication_suppressions.pyscript18.7 KB
tests/test_advisory_adjudication.pyscript1.3 KB
tests/test_agent_relay_rules.pyscript7.8 KB
tests/test_aggregate_json.pyscript10.0 KB
tests/test_auto_scan_patterns.pyscript10.5 KB
tests/test_benign_corpus.pyscript16.4 KB
tests/test_benign_new_scanners.pyscript6.1 KB
tests/test_build_output_skip.pyscript10.6 KB
tests/test_capability_ledger.pyscript18.8 KB
tests/test_codex_install.pyscript10.0 KB
tests/test_codex_marketplace.pyscript3.3 KB
tests/test_comment_false_positives.pyscript2.2 KB
tests/test_composer_dependencies.pyscript4.0 KB
tests/test_compromised_versions.pyscript51.2 KB
tests/test_context_gate.pyscript32.4 KB
tests/test_coverage_status.pyscript7.6 KB
tests/test_css_compounding_shrink.pyscript20.8 KB
tests/test_cursor_adapter.pyscript7.8 KB
tests/test_cursor_benign.pyscript3.4 KB
tests/test_cursor_degrade.pyscript12.7 KB
tests/test_cursor_install.pyscript17.1 KB
tests/test_cursor_latency.pyscript7.2 KB
tests/test_cursor_parity.pyscript5.8 KB
tests/test_cursor_redteam_fn.pyscript4.9 KB
tests/test_cursor_tamper_modify.pyscript14.2 KB
tests/test_cursor_wiring.pyscript32.3 KB
tests/test_d1_yara_correlation.pyscript9.2 KB
tests/test_dead_anchors_extract.pyscript7.6 KB
tests/test_dead_anchors_probe.pyscript19.7 KB
tests/test_evidence_engine_parity.pyscript8.1 KB
tests/test_evidence_model.pyscript11.4 KB
tests/test_forensics_core.pyscript79.2 KB
tests/test_fp_hardening_r3.pyscript9.7 KB
tests/test_fp_hardening_r4.pyscript18.8 KB
tests/test_fp_regression_pairs.pyscript62.5 KB
tests/test_fp_structural.pyscript21.2 KB
tests/test_freshness.pyscript6.2 KB
tests/test_frontmatter_validity.pyscript7.0 KB
tests/test_gpg_rce_hotfix.pyscript4.8 KB
tests/test_hook_inert_data.pyscript6.1 KB
tests/test_hook_scripts.pyscript14.0 KB
tests/test_inspection_cpu_budget.pyscript11.6 KB
tests/test_ioc_manager.pyscript55.4 KB
tests/test_kernel_privesc_rules.pyscript27.8 KB
tests/test_legit_precision_regressions.pyscript6.8 KB
tests/test_lethal_trifecta.pyscript20.7 KB
tests/test_manifest_signature.pyscript1.5 KB
tests/test_manifest_validity.pyscript2.9 KB
tests/test_monotonic_trust_e2e.pyscript4.4 KB
tests/test_non_breaking_contract.pyscript22.7 KB
tests/test_openclaw_install.pyscript6.6 KB
tests/test_pack_parity.pyscript24.8 KB
tests/test_parse_pnpm_lock.pyscript10.7 KB
tests/test_plugin_checkout_provenance.pyscript11.1 KB
tests/test_powershell_hook_wire.pyscript10.6 KB
tests/test_powershell_verdict_corpus.pyscript6.2 KB
tests/test_pr44_hardening.pyscript6.5 KB
tests/test_pre_scan.pyscript19.6 KB
tests/test_pre_scan_composer.pyscript7.4 KB
tests/test_precondition_fields.pyscript4.6 KB
tests/test_provenance_offline.pyscript2.5 KB
tests/test_published_rulepack_feed_current.pyscript1.4 KB
tests/test_py38_compat.pyscript3.3 KB
tests/test_pypi_pinned_versions.pyscript19.3 KB
tests/test_pyproject_string_forms.pyscript2.2 KB
tests/test_redteam_fn_regression.pyscript32.5 KB
tests/test_reflective_fetch_execute.pyscript23.5 KB
tests/test_reflective_review_fixes.pyscript17.8 KB
tests/test_refresh_controller.pyscript19.9 KB
tests/test_refresh_rulepacks.pyscript12.4 KB
tests/test_review_gate_regressions.pyscript9.3 KB
tests/test_rule_loader.pyscript23.2 KB
tests/test_rulepack_feed.pyscript38.1 KB
tests/test_run_forensics_json.pyscript1012 B
tests/test_run_scanner_fail_loud.pyscript6.5 KB
tests/test_runtime_floors.pyscript19.8 KB
tests/test_sandbox_probing_rules.pyscript9.6 KB
tests/test_sarif_export.pyscript19.9 KB
tests/test_scan_agent_skills.pyscript31.3 KB
tests/test_scan_archive.pyscript11.6 KB
tests/test_scan_ast.pyscript12.8 KB
tests/test_scan_binary.pyscript15.3 KB
tests/test_scan_bytecode.pyscript21.5 KB
tests/test_scan_dast.pyscript32.1 KB
tests/test_scan_dataflow.pyscript7.1 KB
tests/test_scan_dead_anchors.pyscript11.5 KB
tests/test_scan_decode.pyscript28.0 KB
tests/test_scan_dependencies.pyscript37.8 KB
tests/test_scan_devcontainer.pyscript8.5 KB
tests/test_scan_entropy.pyscript11.2 KB
tests/test_scan_entrypoint.pyscript19.5 KB
tests/test_scan_git_config.pyscript58.5 KB
tests/test_scan_git_config_review_fixes.pyscript33.3 KB

scripts/scan_binary.py

View on GitHub
#!/usr/bin/env python3
"""
scan_binary.py - Binary Camouflage Scanner (v2: severity system)
Detects executables hidden as images/text files.

Created by Alex Greenshpun
"""

import os
import sys

sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
import forensics_core as core

SCANNER_NAME = "binary"

MAGIC_NUMBERS = {
    b'\x7fELF': 'ELF Executable (Linux)',
    b'MZ': 'PE Executable (Windows)',
    b'\xca\xfe\xba\xbe': 'Java Class / Mach-O Fat Binary',
    b'\xfe\xed\xfa\xce': 'Mach-O Binary (32-bit)',
    b'\xfe\xed\xfa\xcf': 'Mach-O Binary (64-bit)',
    b'\xca\xfe\xba\xbf': 'Mach-O Binary (64-bit)',
    b'#!': 'Shebang Script',
    b'RIFF': 'WAV Audio (RIFF container)',
    b'ID3': 'MP3 Audio (ID3 tag)',
    b'fLaC': 'FLAC Audio',
}

SAFE_MEDIA = {'.png', '.jpg', '.jpeg', '.gif', '.svg', '.mp4', '.pdf', '.txt', '.md', '.json', '.csv', '.ico', '.bmp', '.wav', '.mp3', '.flac', '.ogg', '.aac', '.wma'}


def get_file_type(filepath):
    try:
        with open(filepath, 'rb') as f:
            header = f.read(4)
        for signature, description in MAGIC_NUMBERS.items():
            if header.startswith(signature):
                return description
        return None
    except (OSError, UnicodeDecodeError):
        return None


AUDIO_EXTENSIONS = {'.wav', '.mp3', '.flac', '.ogg', '.aac'}
_EXEC_DESCS = {'ELF Executable (Linux)', 'PE Executable (Windows)',
               'Mach-O Binary (32-bit)', 'Mach-O Binary (64-bit)',
               'Java Class / Mach-O Fat Binary'}
EXEC_SIGNATURES = [sig for sig, desc in MAGIC_NUMBERS.items() if desc in _EXEC_DESCS]


def _is_valid_pe(content, offset):
    """A real PE has 'PE\\x00\\x00' at the location its e_lfanew field points to.
    A bare 'MZ' pair (2 bytes) appears routinely inside compressed audio,
    so require the structural marker too before treating it as an executable.

    e_lfanew (the DWORD at MZ+0x3C) is RELATIVE to the MZ header, so the PE
    signature sits at ``offset + e_lfanew`` -- not at an absolute file offset.
    Reading it absolutely turns a real embedded PE into a missed detection
    (false negative) and lets an attacker forge a validation by planting
    'PE\\x00\\x00' at absolute e_lfanew. The upper bound matches scan_embedded_pe
    (1 MB) so the two PE checks agree on what a plausible DOS stub looks like."""
    if offset + 0x40 > len(content):
        return False
    e_lfanew = int.from_bytes(content[offset + 0x3C:offset + 0x40], "little")
    if not 0 < e_lfanew <= 1024 * 1024:
        return False
    pe_sig_loc = offset + e_lfanew
    return content[pe_sig_loc:pe_sig_loc + 4] == b'PE\x00\x00'


def _find_embedded_executable(content, search_from):
    """Return the first offset of a valid executable signature in content, else None."""
    for sig in EXEC_SIGNATURES:
        offset = content.find(sig, search_from)
        while offset > 0:
            if sig == b'MZ' and not _is_valid_pe(content, offset):
                offset = content.find(sig, offset + 1)
                continue
            return offset
    return None


def scan_audio_steganography(filepath, rel_path):
    """Detect executable content hidden in audio files (TeamPCP Telnyx attack pattern, March 2026).

    Checks for: ELF/PE/Mach-O magic bytes in audio data sections,
    high base64-density in audio frames, XOR-encrypted payloads.
    """
    findings = []
    ext = os.path.splitext(filepath)[1].lower()
    if ext not in AUDIO_EXTENSIONS:
        return findings

    try:
        file_size = os.path.getsize(filepath)
        if file_size < 1024:
            return findings

        with open(filepath, 'rb') as f:
            content = f.read(min(file_size, 128 * 1024))

        offset = _find_embedded_executable(content, 44 if ext == '.wav' else 0)
        if offset is not None:
            findings.append(core.Finding(
                scanner=SCANNER_NAME, severity="critical",
                title=f"Audio Steganography: Executable in {ext.upper()}",
                description=f"Audio file contains executable signature at offset {offset} (TeamPCP Telnyx attack pattern, March 2026). Malicious code hidden in audio data frames.",
                file=rel_path, line=0,
                snippet=f"Executable signature found at byte offset {offset}",
                category="audio-steganography"
            ))

        data_section = content[44:] if ext == '.wav' else content[128:]
        if len(data_section) > 100:
            try:
                sample = data_section[:4096]
                text_chars = sum(1 for b in sample if 32 <= b < 127 or b in (9, 10, 13))
                text_ratio = text_chars / len(sample)
                if text_ratio > 0.9:
                    findings.append(core.Finding(
                        scanner=SCANNER_NAME, severity="high",
                        title=f"Audio Steganography: Text Content in {ext.upper()} Data",
                        description=f"Audio file data section is {text_ratio:.0%} printable text (expected binary audio data). Possible base64-encoded payload (TeamPCP WAV steganography pattern).",
                        file=rel_path, line=0,
                        snippet=f"Text ratio: {text_ratio:.0%} in first 4KB of audio data",
                        category="audio-steganography"
                    ))
            except (MemoryError, OverflowError, ZeroDivisionError):
                pass

    except (OSError, MemoryError):
        pass

    return findings


def scan_embedded_pe(filepath, rel_path):
    """Detect PE executables embedded in non-PE files (InQuest Embedded_PE pattern).

    Checks for MZ magic at non-zero offset with valid PE signature.
    Catches polyglot files (image+PE, document+PE) used in APT campaigns
    (UNK_CraftyCamel, Proofpoint Sosano).
    """
    findings = []
    ext = os.path.splitext(filepath)[1].lower()

    # Skip actual PE files - MZ at offset 0 is expected there
    if ext in {'.exe', '.dll', '.sys', '.scr', '.drv', '.ocx', '.com'}:
        return findings

    try:
        file_size = os.path.getsize(filepath)
        if file_size < 64 or file_size > 10 * 1024 * 1024:  # Skip tiny/huge files
            return findings

        with open(filepath, 'rb') as f:
            content = f.read(min(file_size, 128 * 1024))

        # Search for MZ at non-zero offsets
        offset = 1  # Skip offset 0 (would be a normal PE)
        while offset < len(content) - 64:
            offset = content.find(b'MZ', offset)
            if offset < 0:
                break

            try:
                pe_offset_loc = offset + 0x3C
                if pe_offset_loc + 4 <= len(content):
                    pe_offset = int.from_bytes(content[pe_offset_loc:pe_offset_loc + 4], 'little')
                    if pe_offset > 1024 * 1024:
                        offset += 2
                        continue
                    pe_sig_loc = offset + pe_offset
                    pe_sig = None
                    if pe_sig_loc + 4 <= len(content):
                        pe_sig = content[pe_sig_loc:pe_sig_loc + 4]
                    elif pe_sig_loc + 4 <= file_size:
                        try:
                            with open(filepath, 'rb') as f2:
                                f2.seek(pe_sig_loc)
                                pe_sig = f2.read(4)
                        except OSError:
                            pass
                    if pe_sig == b'PE\x00\x00':
                        findings.append(core.Finding(
                            scanner=SCANNER_NAME, severity="critical",
                            title=f"Embedded PE Executable in {ext.upper() or 'file'}",
                            description=f"PE executable found at offset {offset} inside non-PE file. Polyglot file technique used in APT campaigns (UNK_CraftyCamel, Proofpoint Sosano).",
                            file=rel_path, line=0,
                            snippet=f"MZ+PE signature at offset {offset}",
                            category="embedded-executable"
                        ))
                        break
            except (IndexError, OverflowError):
                pass

            offset += 2

    except (OSError, MemoryError):
        pass

    return findings


def main():
    args = core.parse_common_args(sys.argv, "Binary Camouflage Scanner")
    repo_path = args.repo_path

    core.emit_status(args.format, f"[*] Scanning for masquerading binaries in {repo_path}...")

    ignore_patterns = core.load_ignore_patterns(repo_path)
    all_findings = []

    for filepath, rel_path in core.walk_repo(repo_path, ignore_patterns, skip_binary=False):
        ext = os.path.splitext(filepath)[1].lower()

        if ext in SAFE_MEDIA:
            description = get_file_type(filepath)
            if description and ('Executable' in description or 'Mach-O' in description):
                all_findings.append(core.Finding(
                    scanner=SCANNER_NAME, severity="critical",
                    title=f"Binary Masquerading as {ext}",
                    description=f"File has extension '{ext}' but magic number indicates: {description}",
                    file=rel_path, line=0,
                    snippet=f"Magic: {description}",
                    category="binary-camouflage"
                ))

        if os.name == 'posix':
            if os.access(filepath, os.X_OK) and ext in {'.png', '.jpg', '.txt', '.md', '.json', '.csv'}:
                # Issue #38: by this code path the file has NO exec magic and
                # NO shebang (those are caught earlier as CRITICAL). An exec
                # bit alone is permission hygiene, not binary camouflage —
                # real camouflage (ELF/PE/Mach-O + image extension) is still
                # caught upstream as CRITICAL. Demote this single signal to
                # LOW severity under a category that reflects intent. HIGH
                # only when combined with executable content / shebang /
                # magic mismatch, which are detected separately and unchanged.
                all_findings.append(core.Finding(
                    scanner=SCANNER_NAME, severity="low",
                    title=f"Executable bit on data file ({ext})",
                    description=(
                        f"Data file ({ext}) has the executable bit set (+x). "
                        "Permission-hygiene signal only; high-confidence "
                        "binary camouflage is detected separately when the "
                        "file also carries executable magic or a shebang."
                    ),
                    file=rel_path, line=0,
                    snippet=f"chmod +x on {ext} file",
                    category="permission-hygiene"
                ))

        # Audio steganography check
        if ext in AUDIO_EXTENSIONS:
            all_findings.extend(scan_audio_steganography(filepath, rel_path))

        # Embedded PE check (polyglot files: image+PE, document+PE)
        all_findings.extend(scan_embedded_pe(filepath, rel_path))

    core.output_findings(all_findings, args.format, SCANNER_NAME)


if __name__ == "__main__":
    main()
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall