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/pypi_pins.py

View on GitHub
#!/usr/bin/env python3
"""PyPI requirement parsing for the compromised-version checks.

pip/uv install commands, requirements files and pyproject strings all spell a
pin differently (`litellm==1.107.0`, `"LiteLLM[proxy] == 1.107.0.0"`,
`litellm @ https://.../litellm-1.107.0-py3-none-any.whl`). This module turns
each spelling into (normalised name, version) so one lookup against the PyPI
compromised-version map covers every caller.

Stdlib-only leaf module: pre_scan.py imports it on the hot path of every shell
command, so it must stay cheap and must never raise on hostile input.

Matching is deliberately limited to what is knowable offline:
  * exact pins (`==X`, `===X`) match when X is the same PEP 440 version;
  * a trailing wildcard (`==1.107.*`) matches when the compromised version is
    inside the prefix;
  * ranges (`>=`, `~=`, `<`) and bare names do NOT match. They resolve through
    the index at install time, and compromised releases are usually yanked, so
    blocking every range that merely includes one would block good installs for
    ever. The wheel/archive scanners are the control for those.
"""

import re

_NAME_RE = re.compile(r'^([A-Za-z0-9](?:[A-Za-z0-9._-]*[A-Za-z0-9])?)\s*(?:\[[^\]]*\])?\s*(.*)$', re.S)
_SHELL_OPS = {'&&', '||', ';', '|', '&', ';;', '|&', '>', '>>', '<', '<<', '2>', '2>>'}
_OPERATOR_CHARS = '=<>!~'
_WORD_RE = re.compile(r'(?:"[^"]*"|\'[^\']*\'|[^\s"\'&|;<>()])+|[&|;<>()]+')
# Matched with .match() and no `$`, then the remainder is checked by hand:
# a tail class overlapping the digit groups made the single-regex form
# quadratic on long digit/dot strings.
_VERSION_RE = re.compile(r'(?:\d+!)?v?(\d+(?:\.\d+)*)', re.I)


def normalize_name(name):
    """PEP 503 name normalisation: case-fold, runs of -_. collapse to '-'."""
    if not isinstance(name, str):
        return ''
    return re.sub(r'[-_.]+', '-', name.strip()).lower()


def _release(version):
    """Release tuple of a PLAIN version (no pre/post/dev/local), trailing
    zeros stripped so 1.107 == 1.107.0 == 1.107.0.0. None for anything else
    (including 1.107.0.post1, 1.107.0rc1, 1.107.0+local)."""
    if not isinstance(version, str):
        return None
    m = _VERSION_RE.match(version.strip())
    if not m or m.end() != len(version.strip()):
        return None
    parts = [int(p) for p in m.group(1).split('.')]
    while len(parts) > 1 and parts[-1] == 0:
        parts.pop()
    return tuple(parts)


def spec_hits(spec, bad_versions):
    """Return the compromised version(s) that SPEC pins, as a list.

    `spec` is the text after the name, e.g. '==1.107.0', '== 1.107.*',
    '===1.107.0', '>=1,<2'. Only `==`/`===` clauses can hit (see module doc).
    """
    if not isinstance(spec, str) or not spec:
        return []
    spec = spec.split(';', 1)[0]  # environment marker
    spec = spec.split('#', 1)[0]
    hits = []
    bad = {}
    for v in bad_versions:
        rel = _release(v)
        if rel is not None:
            bad.setdefault(rel, v)
    for clause in spec.split(','):
        m = re.match(r'^\s*(===|==)\s*(\S+)\s*$', clause)
        if not m:
            continue
        op, value = m.group(1), m.group(2).strip('"\'')
        if value.endswith('.*') and op == '==':
            m2 = _VERSION_RE.match(value[:-2])
            if not m2 or m2.end() != len(value) - 2:
                continue
            pref = tuple(int(p) for p in m2.group(1).split('.'))
            for rel, orig in bad.items():
                padded = rel + (0,) * max(0, len(pref) - len(rel))
                if padded[:len(pref)] == pref and orig not in hits:
                    hits.append(orig)
            continue
        rel = _release(value)
        if rel is not None and rel in bad and bad[rel] not in hits:
            hits.append(bad[rel])
    return hits


def _artifact_pin(token):
    """(name, version) from a wheel/sdist filename or URL, else None."""
    path = re.split(r'[?#]', token, 1)[0].rstrip('/')
    base = re.split(r'[\\/]', path)[-1]
    low = base.lower()
    if low.endswith('.whl'):
        parts = base[:-4].split('-')
        if len(parts) >= 5:
            return normalize_name(parts[0]), parts[1]
        return None
    for ext in ('.tar.gz', '.zip', '.tar.bz2', '.tgz'):
        if low.endswith(ext):
            stem = base[:-len(ext)]
            if '-' in stem:
                name, ver = stem.rsplit('-', 1)
                return normalize_name(name), ver
    return None


def parse_requirement(text):
    """Parse ONE requirement string into (normalised_name, spec) or None.

    spec is the version clause text; for direct references to a wheel or sdist
    the version is read from the filename and returned as '==<version>'.
    """
    if not isinstance(text, str):
        return None
    text = text.strip().strip('"\'').strip()
    if not text or text.startswith('-'):
        return None
    if re.match(r'(?i)^(?:https?|file|git\+[a-z]+)://|^[A-Za-z]:[\\/]|^\.{0,2}[\\/]', text) or text.lower().endswith(('.whl', '.tar.gz', '.zip')):
        pin = _artifact_pin(text)
        return (pin[0], '==' + pin[1]) if pin else None
    m = _NAME_RE.match(text)
    if not m:
        return None
    name, rest = m.group(1), m.group(2).strip()
    if rest.startswith('@'):
        pin = _artifact_pin(rest[1:].strip().split(';', 1)[0].strip().strip('"\''))
        if pin and pin[0] == normalize_name(name):
            return normalize_name(name), '==' + pin[1]
        return normalize_name(name), ''
    return normalize_name(name), rest


def parse_install_args(raw):
    """Requirements from the argument text of `pip install ...`/`uv add ...`.

    Drops shell operators (but keeps parsing past them) and flags, rejoins `name == ver`
    that the shell split into separate words, and strips quotes. Words such
    as `pip`/`install` from a chained command parse as unpinned names and are
    ignored. Returns a
    list of (normalised_name, spec).
    """
    if not isinstance(raw, str):
        return []
    # Linear-time word split (shlex.read_token grows each token by string
    # concatenation and goes quadratic on one long word: 400 KB took 14 s,
    # past the 10 s PreToolUse timeout, which Claude Code treats as allow).
    # A quoted run stays inside its word; an unmatched quote is dropped.
    words = _WORD_RE.findall(raw)
    # Shell operators only separate words. Parsing continues past them so a
    # pin in a chained command (`pip install a && pip install litellm==X`)
    # is still seen: the install patterns match the FIRST install only.
    # posix=False keeps backslashes (Windows paths) and the quotes; strip them.
    tokens = [w.replace('"', '').replace("'", '') for w in words
              if w and w not in _SHELL_OPS and not set(w) <= set('&|;<>')]
    tokens = [w for w in tokens if w]
    merged = []
    for w in tokens:
        if merged and (w[:1] in _OPERATOR_CHARS + '@' or merged[-1][-1:] in _OPERATOR_CHARS + '@'):
            if not merged[-1].startswith('-'):
                merged[-1] += w
                continue
        merged.append(w)
    out = []
    skip_value = False
    for w in merged:
        if skip_value:
            skip_value = False
            continue
        if w.startswith('-'):
            # flags that take a separate value: don't mistake it for a package
            if re.match(r'^-(?:r|c|e|i|f|-requirement|-constraint|-editable|-index-url|'
                        r'-extra-index-url|-find-links|-target|-prefix|-root|-python|'
                        r'-project|-with|-with-requirements|-index|-default-index)$', w):
                skip_value = True
            continue
        req = parse_requirement(w)
        if req:
            out.append(req)
    return out


def blocked_by(requirements, pypi_versions):
    """Describe each requirement that pins a compromised version.

    `pypi_versions` maps normalised name -> {version: campaign_id}.
    """
    blocked = []
    for name, spec in requirements:
        bad = pypi_versions.get(name)
        if not bad or not spec:
            continue
        for ver in spec_hits(spec, bad):
            shown = re.sub(r'\s+', '', spec) or '==' + ver
            blocked.append(
                f"{name}{shown} (compromised PyPI version {ver}, campaign: {bad[ver]})")
    return blocked
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