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

View on GitHub
import importlib.util
import json
import os
from pathlib import Path

import pytest

_POSIX_ONLY = pytest.mark.skipif(
    os.name == "nt", reason="POSIX shell/process behavior not available on Windows"
)


REPO_ROOT = Path(__file__).resolve().parents[3]
CODEX_INSTALL = REPO_ROOT / "scripts" / "codex_install.py"


def _load_codex_install():
    spec = importlib.util.spec_from_file_location("codex_install_under_test", CODEX_INSTALL)
    module = importlib.util.module_from_spec(spec)
    spec.loader.exec_module(module)
    return module


def _read_hooks(codex_home):
    return json.loads((codex_home / "hooks.json").read_text())


def _external_hook(command="echo external"):
    return {
        "matcher": "Bash",
        "hooks": [
            {
                "type": "command",
                "command": command,
                "timeout": 5,
            }
        ],
    }


def test_codex_install_writes_nested_hooks_schema(monkeypatch, tmp_path):
    codex_home = tmp_path / "codex"
    monkeypatch.setenv("CODEX_HOME", str(codex_home))
    codex_install = _load_codex_install()

    assert codex_install.install() == 0

    data = _read_hooks(codex_home)
    assert isinstance(data.get("hooks"), dict)
    for event in codex_install.HOOK_EVENTS:
        assert event not in data
        assert event in data["hooks"]
        assert any(codex_install._is_ours(entry) for entry in data["hooks"][event])


def test_codex_install_preserves_existing_nested_hooks(monkeypatch, tmp_path):
    codex_home = tmp_path / "codex"
    codex_home.mkdir()
    monkeypatch.setenv("CODEX_HOME", str(codex_home))
    codex_install = _load_codex_install()
    existing_post = _external_hook()
    existing_stop = _external_hook("echo stop")
    (codex_home / "hooks.json").write_text(json.dumps({
        "description": "keep me",
        "hooks": {
            "PostToolUse": [existing_post],
            "Stop": [existing_stop],
        },
    }))

    assert codex_install.install() == 0

    data = _read_hooks(codex_home)
    assert data["description"] == "keep me"
    assert existing_post in data["hooks"]["PostToolUse"]
    assert existing_stop in data["hooks"]["Stop"]
    assert any(codex_install._is_ours(entry) for entry in data["hooks"]["PostToolUse"])


def test_codex_install_cleans_legacy_top_level_repo_forensics_hooks(monkeypatch, tmp_path):
    codex_home = tmp_path / "codex"
    codex_home.mkdir()
    monkeypatch.setenv("CODEX_HOME", str(codex_home))
    codex_install = _load_codex_install()
    legacy_repo_forensics = {
        "matcher": "Bash",
        "hooks": [
            {
                "type": "command",
                "command": 'CLAUDE_PLUGIN_ROOT="/tmp/repo-forensics" bash "/tmp/repo-forensics/hooks/run_pre_scan.sh"',
            }
        ],
    }
    unrelated_legacy = _external_hook()
    (codex_home / "hooks.json").write_text(json.dumps({
        "PreToolUse": [legacy_repo_forensics],
        "PostToolUse": [unrelated_legacy],
        "hooks": {
            "SessionStart": [_external_hook("echo nested session")],
        },
    }))

    assert codex_install.install() == 0

    data = _read_hooks(codex_home)
    assert "PreToolUse" not in data
    assert data["PostToolUse"] == [unrelated_legacy]
    for event in codex_install.HOOK_EVENTS:
        legacy_entries = data.get(event, [])
        assert not any(codex_install._is_ours(entry) for entry in legacy_entries)
        assert any(codex_install._is_ours(entry) for entry in data["hooks"][event])


def test_codex_uninstall_removes_only_repo_forensics_nested_hooks(monkeypatch, tmp_path):
    codex_home = tmp_path / "codex"
    codex_home.mkdir()
    monkeypatch.setenv("CODEX_HOME", str(codex_home))
    codex_install = _load_codex_install()
    lifecycle = []
    monkeypatch.setattr(
        codex_install, "_run_refresh_controller",
        lambda command: lifecycle.append(command) or 0,
    )
    external_pre = _external_hook()
    managed = codex_install._managed_hooks()
    (codex_home / "hooks.json").write_text(json.dumps({
        "hooks": {
            "PreToolUse": [external_pre] + managed["PreToolUse"],
            "PostToolUse": managed["PostToolUse"],
            "SessionStart": managed["SessionStart"],
        },
    }))

    assert codex_install.uninstall() == 0

    data = _read_hooks(codex_home)
    assert data == {"hooks": {"PreToolUse": [external_pre]}}
    assert lifecycle == ["uninstall"]


def test_codex_same_basename_third_party_hook_survives_upgrade(monkeypatch, tmp_path):
    codex_home = tmp_path / "codex"
    codex_home.mkdir()
    monkeypatch.setenv("CODEX_HOME", str(codex_home))
    installer = _load_codex_install()
    third_party = _external_hook('bash "/opt/acme/hooks/run_session_scan.sh"')
    stale_ours = _external_hook(
        'CLAUDE_PLUGIN_ROOT="/tmp/old-copy" '
        'bash "/tmp/old-copy/hooks/run_session_scan.sh"'
    )
    (codex_home / "hooks.json").write_text(json.dumps({
        "hooks": {"SessionStart": [third_party, stale_ours]},
    }))

    assert installer.install() == 0

    entries = _read_hooks(codex_home)["hooks"]["SessionStart"]
    assert third_party in entries
    assert stale_ours not in entries
    assert any(installer.OWNERSHIP_MARKER in json.dumps(entry) for entry in entries)


def test_codex_third_party_command_survives_inside_shared_matcher(monkeypatch, tmp_path):
    codex_home = tmp_path / "codex"
    codex_home.mkdir()
    monkeypatch.setenv("CODEX_HOME", str(codex_home))
    installer = _load_codex_install()
    third_party_command = {
        "type": "command", "command": 'bash "/opt/acme/hooks/run_pre_scan.sh"'
    }
    owned_command = {
        "type": "command",
        "command": 'CLAUDE_PLUGIN_ROOT="/tmp/old" bash "/tmp/old/hooks/run_pre_scan.sh"',
    }
    shared = {"matcher": "Bash", "hooks": [third_party_command, owned_command]}
    (codex_home / "hooks.json").write_text(json.dumps({"hooks": {"PreToolUse": [shared]}}))

    assert installer.install() == 0
    commands = [hook for entry in _read_hooks(codex_home)["hooks"]["PreToolUse"]
                for hook in entry.get("hooks", [])]
    assert third_party_command in commands
    assert owned_command not in commands


@_POSIX_ONLY
def test_codex_verify_rejects_stale_owned_command(monkeypatch, tmp_path):
    codex_home = tmp_path / "codex"
    monkeypatch.setenv("CODEX_HOME", str(codex_home))
    installer = _load_codex_install()
    assert installer.install() == 0
    data = _read_hooks(codex_home)
    command = data["hooks"]["PreToolUse"][0]["hooks"][0]["command"]
    data["hooks"]["PreToolUse"][0]["hooks"][0]["command"] = command.replace(
        str(REPO_ROOT), "/tmp/old-repo-forensics"
    )
    (codex_home / "hooks.json").write_text(json.dumps(data))

    assert installer.verify() == 1


def test_codex_uninstall_controller_failure_preserves_hooks(monkeypatch, tmp_path):
    codex_home = tmp_path / "codex"
    monkeypatch.setenv("CODEX_HOME", str(codex_home))
    installer = _load_codex_install()
    assert installer.install() == 0
    before = (codex_home / "hooks.json").read_text()
    monkeypatch.setattr(installer, "_run_refresh_controller", lambda _command: 7)

    assert installer.uninstall() == 1
    assert (codex_home / "hooks.json").read_text() == before


def test_codex_uninstall_without_hooks_still_removes_scheduler(monkeypatch, tmp_path):
    monkeypatch.setenv("CODEX_HOME", str(tmp_path / "codex"))
    installer = _load_codex_install()
    lifecycle = []
    monkeypatch.setattr(
        installer, "_run_refresh_controller",
        lambda command: lifecycle.append(command) or 0,
    )

    assert installer.uninstall() == 0
    assert lifecycle == ["uninstall"]


def test_codex_plugin_manifest_points_to_nested_hooks_schema():
    plugin = json.loads((REPO_ROOT / ".codex-plugin" / "plugin.json").read_text())
    hooks_path = REPO_ROOT / plugin["hooks"]
    hook_data = json.loads(hooks_path.read_text())

    # Codex deserializes plugin hook files with a strict top-level schema.
    # Extra metadata such as Claude Code's optional "description" field makes
    # Codex reject the entire file and silently disables all automation hooks.
    assert set(hook_data) == {"hooks"}
    assert isinstance(hook_data.get("hooks"), dict)
    for event in ("PreToolUse", "PostToolUse", "SessionStart"):
        assert event in hook_data["hooks"]
        assert event not in {key for key in hook_data.keys() if key != "hooks"}


def test_codex_marketplace_mirror_uses_strict_hooks_schema():
    hooks_path = REPO_ROOT / "plugins" / "repo-forensics" / "hooks" / "hooks.json"
    hook_data = json.loads(hooks_path.read_text())

    assert set(hook_data) == {"hooks"}


def test_codex_install_session_start_matches_marketplace_hook_commands(monkeypatch, tmp_path):
    codex_home = tmp_path / "codex"
    monkeypatch.setenv("CODEX_HOME", str(codex_home))
    codex_install = _load_codex_install()

    assert codex_install.install() == 0

    data = _read_hooks(codex_home)
    session_commands = [
        hook["command"]
        for entry in data["hooks"]["SessionStart"]
        for hook in entry["hooks"]
    ]
    assert any("run_session_scan.sh" in command for command in session_commands)
    assert any("first-run-nudge.sh" in command for command in session_commands)


def test_codex_verify_can_require_registration_state(monkeypatch, tmp_path):
    codex_home = tmp_path / "codex"
    monkeypatch.setenv("CODEX_HOME", str(codex_home))
    codex_install = _load_codex_install()
    assert codex_install.install() == 0
    hooks_path = codex_home / "hooks.json"
    state_blocks = "\n".join(
        f'[hooks.state."{hooks_path}:{event}:0:0"]\ntrusted = true\n'
        for event in ("pre_tool_use", "post_tool_use", "session_start")
    )
    (codex_home / "config.toml").write_text(state_blocks)

    assert codex_install.verify(require_registered=True) == 0


def test_codex_invalid_json_is_preserved(monkeypatch, tmp_path):
    codex_home = tmp_path / "codex"
    codex_home.mkdir()
    hooks = codex_home / "hooks.json"
    hooks.write_text("{broken")
    monkeypatch.setenv("CODEX_HOME", str(codex_home))
    installer = _load_codex_install()

    with pytest.raises(ValueError):
        installer.install()

    assert hooks.read_text() == "{broken"
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