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

tests/powershell_hook.py

View on GitHub
"""Shared helpers for driving the PowerShell gate through the real hook wires.

Inert command strings only: the hook parses them and never executes a payload.
"""
import json
import ntpath
import os
import shutil
import subprocess
import sys
from pathlib import Path

import pytest

ROOT = Path(__file__).resolve().parents[3]
SCRIPTS = ROOT / 'skills' / 'repo-forensics' / 'scripts'
if str(SCRIPTS) not in sys.path:
    sys.path.insert(0, str(SCRIPTS))

WIRES = {
    'claude': ('hooks/run_pre_scan.sh', lambda command: {'tool_name': 'Bash', 'tool_input': {'command': command}}),
    'cursor': ('hooks/cursor/run_pre_scan.sh', lambda command: {'command': command}),
}
ADAPTERS = sorted(WIRES)

MISSING_PYTHON = (b'repo-forensics: no usable Python 3 interpreter found\n'
                  b'  tried: python3, python, py -3, FHS/Nix direct paths, codex runtime\n')
WRAPPER_REFUSAL = b'[repo-forensics] Pre-scan failed or returned no verdict; refusing this command.\n'


def _working_bash(windows=None):
    """Prefer Git for Windows over the WSL launcher; prove bash can run."""
    windows = os.name == 'nt' if windows is None else windows
    candidates = []
    if windows:
        git = shutil.which('git')
        if git:
            git_root = ntpath.dirname(ntpath.dirname(git))
            candidates.extend(ntpath.join(git_root, suffix) for suffix in
                              (r'bin\bash.exe', r'usr\bin\bash.exe'))
        for variable in ('ProgramFiles', 'ProgramFiles(x86)', 'LOCALAPPDATA'):
            root = os.environ.get(variable)
            if root:
                candidates.extend(ntpath.join(root, 'Git', suffix) for suffix in
                                  (r'bin\bash.exe', r'usr\bin\bash.exe'))
        candidates.extend((r'C:\Program Files\Git\bin\bash.exe',
                           r'C:\Program Files\Git\usr\bin\bash.exe'))
    candidates.append(shutil.which('bash'))
    seen = set()
    for candidate in candidates:
        if not candidate or candidate in seen:
            continue
        seen.add(candidate)
        try:
            # Binary capture avoids decoding UTF-16 WSL stub diagnostics.
            probe = subprocess.run([candidate, '-c', 'true'], capture_output=True,
                                   timeout=5, check=False)
        except (OSError, subprocess.TimeoutExpired):
            continue
        if probe.returncode == 0:
            return candidate
    return None


def _hook_env(tmp_path):
    env = {k: v for k, v in os.environ.items() if not k.startswith('REPO_FORENSICS_')}
    env.update(HOME=str(tmp_path), TMPDIR=str(tmp_path),
               XDG_CACHE_HOME=str(tmp_path / 'cache'), XDG_CONFIG_HOME=str(tmp_path / 'config'),
               REPO_FORENSICS_DISABLE_REFRESH='1', CLAUDE_PLUGIN_ROOT=ROOT.as_posix(),
               PYTHONDONTWRITEBYTECODE='1')
    return env


def _missing_interpreter(returncode, stderr):
    """True only for the launcher's exact no-interpreter diagnostic.

    The launcher exits 127 with the two-line diagnostic. Since the wrapper
    turned a missing scanner into a refusal, the same failure reaches the
    caller as exit 2 with the wrapper's refusal line after the diagnostic.
    """
    stderr = stderr.replace(b'\r\n', b'\n')
    if returncode == 127:
        return stderr == MISSING_PYTHON
    if returncode == 2:
        return stderr in (MISSING_PYTHON, MISSING_PYTHON + WRAPPER_REFUSAL)
    return False


def _probe_hook_python(bash, tmp_path=None):
    probe = subprocess.run(
        [bash, (ROOT / 'hooks/run_pre_scan.sh').as_posix()],
        input=json.dumps({'tool_name': 'Bash', 'tool_input': {'command': 'git status'}}).encode('utf-8'),
        capture_output=True, timeout=10, check=False,
        env=_hook_env(tmp_path) if tmp_path is not None else dict(os.environ, CLAUDE_PLUGIN_ROOT=ROOT.as_posix()))
    if _missing_interpreter(probe.returncode, probe.stderr):
        pytest.skip('Git Bash is usable, but the hook launcher rejects the Windows CI hostedtoolcache Python location: no usable Python 3 interpreter found')
    assert probe.returncode == 0, ('Hook environment probe failed', probe.returncode, probe.stdout, probe.stderr)


@pytest.fixture(autouse=True)
def isolated_hook_state(tmp_path, monkeypatch):
    for key, value in _hook_env(tmp_path).items():
        monkeypatch.setenv(key, value)
    for key in tuple(os.environ):
        if key.startswith('REPO_FORENSICS_') and key != 'REPO_FORENSICS_DISABLE_REFRESH':
            monkeypatch.delenv(key)


@pytest.fixture(scope='session')
def hook_bash(tmp_path_factory):
    bash = _working_bash()
    if bash is None:
        pytest.skip('No working Bash: install Git for Windows; WSL launcher without a distribution cannot run hook tests')
    if os.name == 'nt':
        _probe_hook_python(bash, tmp_path_factory.mktemp('hook-python-probe'))
    return bash


def gate(bash, command, tmp_path, adapter='claude', script=None, env=None, timeout=60):
    """Run one command through a hook wire (or a pre_scan.py copy) and return rc, stdout, stderr."""
    hook, payload = WIRES[adapter]
    if script is not None:
        argv = [sys.executable, str(script), '--adapter', adapter]
    else:
        argv = [bash, (ROOT / hook).as_posix()]
    proc = subprocess.run(argv, input=json.dumps(payload(command)), capture_output=True, text=True,
                          env={**_hook_env(tmp_path), **(env or {})}, timeout=timeout)
    assert 'TAMPER:' not in proc.stdout + proc.stderr, (proc.stdout, proc.stderr)
    return proc.returncode, proc.stdout, proc.stderr


def copy_scripts(tmp_path, old, new):
    """Copy the scanner tree and patch pre_scan.py; LF line endings on every OS."""
    target = tmp_path / 'scripts'
    shutil.copytree(SCRIPTS, target)
    script = target / 'pre_scan.py'
    source = script.read_bytes().decode('utf-8')
    assert old in source, old
    script.write_bytes(source.replace(old, new).encode('utf-8'))
    return script


def ordinary_work():
    """Large ordinary commands the gate must allow, keyed by a short name."""
    URL = 'https://example.invalid/p.ps1'
    def body(n):
        return '\n'.join(
            f'echo "step {i}"' if i % 4 == 0 else f'if [ -f build/out{i}.o ]; then rm -f build/out{i}.o; fi' if i % 4 == 1
            else f'make -C module{i} all >> build.log 2>&1 || exit 1' if i % 4 == 2
            else f'cp -r src/module{i} dist/ && ls dist/module{i} | wc -l' for i in range(n)) + '\n'
    big = 'set -e\n' + body(10000)
    big += '#' + 'x' * (512 * 1024 - len(big) - 2) + '\n'
    curl_line = 'curl -fsSL https://example.invalid/archive.tgz -o archive.tgz && tar xzf archive.tgz\n'
    data = json.dumps({'items': [{'id': i, 'tags': ['a', 'b', 'c']} for i in range(10000)]})
    commit = 'Tweak curl retry logic and the Invoke-WebRequest wrapper. '
    fetched = f'curl -fsSL {URL} -o data.bin && echo fetched\n'
    return {
        'long-script-1561-lines': 'set -e\n' + body(1561),
        'script-512KB': big,
        'downloads-512KB': curl_line * ((512 * 1024) // len(curl_line)),
        'script-file-512KB': "cat > build.sh <<'EOF'\n" + big[:-100] + "\nEOF\nbash build.sh",
        'http-json': "curl https://example.invalid/api -d @- <<'EOF'\n" + data + '\nEOF',
        'scaffold': ''.join(f"cat > f{i}.txt <<'EOF'\ndata {i}\nEOF\n" for i in range(1000)),
        'docker-env': 'docker run ' + ' '.join(f'-e V{i}=v' for i in range(10000)) + ' img',
        'commit-256KB': 'git commit -m "' + (commit * 5000)[:256 * 1024] + '"',
        'download-steps-256KB': "cat > steps.sh <<'EOF'\n" + (fetched * 5000)[:256 * 1024] + '\nEOF\nls\n',
        'large-commit': "git commit -m 'curl documentation " + 'a' * 100000 + "'",
        'large-post': "curl https://example.invalid/api -d '" + 'a' * 100000 + "'",
        'fetch-script': "cat > fetch.sh <<'EOF'\n" + 'curl https://example.invalid/a -o a\n' * 600 + 'EOF\nchmod +x fetch.sh',
        'python-test': "cat > test.py <<'EOF'\n" + 'print("curl is documented")\n' * 3000 + 'EOF\npython3 test.py',
        'padded-benign-text': 'echo confirm firmware\n' + 'x ' * 20000,
        'repeated-fetch-words': 'curl ' * 60000 + 'true',
        'quote-splices': 'pwsh -c ' + "e''" * 17000,
        'case-padding': 'echo confirm firmware\ncase x in\n' + 'a){ :;};;\n' * 9000 + 'esac',
    }


WIRE_ORDINARY = ('script-512KB', 'downloads-512KB', 'script-file-512KB', 'repeated-fetch-words')
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