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_agent_relay_rules.py

View on GitHub
"""Detection tests for the Sept 2026 relay-driven agent-malware batch.

Covers the four gaps verified against 18 live malicious npm packages
(AgentGate tarball-verified list, dev.to/agentgate, 2026-09-06):
  1. ESM destructured child_process imports + bare spawn() evaded SA-JS-005.
  2. MCP tools registering remote shell/patch execution were invisible.
  3. Auth-gate inversion (DANGEROUSLY_OMIT_AUTH !== "false") had no rule.
  4. walk_repo skipped dist/, which is the entire payload of an npm tarball.
Plus the package.json self-IOC and provenance-squat checks.
"""

import json
import os

import forensics_core as core
import scan_sast as sast
import scan_mcp_security as mcp
import scan_dependencies as deps


def _walk_scan(scanner, repo_path):
    findings = []
    for fp, rp in core.walk_repo(str(repo_path)):
        findings.extend(scanner.scan_file(fp, rp))
    return findings


def _pkg(root):
    (root / "package.json").write_text(json.dumps({"name": "fixture-pkg", "main": "dist/index.js"}))


def _write(root, rel, content):
    p = root / rel
    p.parent.mkdir(parents=True, exist_ok=True)
    p.write_text(content)
    return p


class TestESMChildProcess:
    def test_destructured_spawn_import_flagged(self, tmp_path):
        _pkg(tmp_path)
        _write(tmp_path, "dist/local-effects.js",
               'import { spawn } from "node:child_process";\nconst child = spawn(command, { shell: true });\n')
        findings = _walk_scan(sast, tmp_path)
        ids = {f.rule_id for f in findings}
        assert "SA-JS-035" in ids
        assert "SA-JS-036" in ids

    def test_bare_require_fs_not_flagged(self, tmp_path):
        _write(tmp_path, "index.js", 'import { readFile } from "fs";\nreadFile("x");\n')
        findings = _walk_scan(sast, tmp_path)
        assert "SA-JS-035" not in {f.rule_id for f in findings}

    def test_agent_cli_spawn_flagged(self, tmp_path):
        _pkg(tmp_path)
        _write(tmp_path, "dist/agent/claude.js",
               'spawnAgent("claude", ["-p", fullPrompt]);\n')
        findings = _walk_scan(sast, tmp_path)
        assert "SA-JS-037" in {f.rule_id for f in findings}

    def test_node_spawn_not_flagged(self, tmp_path):
        _write(tmp_path, "index.js", "spawn('node', args);\n")
        findings = _walk_scan(sast, tmp_path)
        assert "SA-JS-037" not in {f.rule_id for f in findings}


class TestAuthInversion:
    def test_omit_auth_inverted_flagged(self, tmp_path):
        _pkg(tmp_path)
        _write(tmp_path, "build/index.js",
               'const authDisabled = process.env.DANGEROUSLY_OMIT_AUTH !== "false";\n')
        findings = _walk_scan(sast, tmp_path)
        assert "SA-JS-038" in {f.rule_id for f in findings}

    def test_safe_direction_not_flagged(self, tmp_path):
        _write(tmp_path, "index.js",
               'const authDisabled = process.env.DANGEROUSLY_OMIT_AUTH === "true";\n')
        findings = _walk_scan(sast, tmp_path)
        assert "SA-JS-038" not in {f.rule_id for f in findings}


class TestMcpRemoteExec:
    def test_run_command_tool_flagged(self, tmp_path):
        _pkg(tmp_path)
        _write(tmp_path, "dist/mcp-server.js",
               'server.tool("tunnel_run_command", "Run a local shell command in the bridge workdir", {});\n')
        findings = _walk_scan(mcp, tmp_path)
        ids = {f.rule_id for f in findings}
        assert "SM-CFG-007" in ids
        assert "SM-CFG-008" in ids

    def test_benign_tool_not_flagged(self, tmp_path):
        _write(tmp_path, "server.js", 'server.tool("get_weather", "Read the forecast");\n')
        findings = _walk_scan(mcp, tmp_path)
        ids = {f.rule_id for f in findings}
        assert "SM-CFG-007" not in ids
        assert "SM-CFG-008" not in ids


class TestTarballWalk:
    def test_dist_walked_for_package_tarball(self, tmp_path):
        _write(tmp_path, "package.json", json.dumps({"name": "x", "main": "dist/index.js"}))
        _write(tmp_path, "dist/index.js", 'spawnAgent("claude", ["-p", p]);\n')
        findings = _walk_scan(sast, tmp_path)
        assert any(f.file.replace(os.sep, "/").endswith("dist/index.js") for f in findings)

    def test_dist_still_skipped_beside_source_tree(self, tmp_path):
        _write(tmp_path, "package.json", json.dumps({"name": "x"}))
        _write(tmp_path, "src/index.js", "const a = 1;\n")
        _write(tmp_path, "dist/index.js", 'spawnAgent("claude", ["-p", p]);\n')
        findings = _walk_scan(sast, tmp_path)
        assert not any("dist" in f.file.split(os.sep) for f in findings)


class TestPackageJsonChecks:
    def test_self_ioc_flagged(self, tmp_path):
        p = _write(tmp_path, "package.json", json.dumps({"name": "agenttunnels", "version": "0.1.17"}))
        findings = deps.scan_package_json(str(p), "package.json")
        assert any("Known Malicious Package (self)" in f.title for f in findings)

    def test_provenance_squat_flagged(self, tmp_path):
        p = _write(tmp_path, "package.json", json.dumps({
            "name": "@atom8n/inspector", "author": "Anthropic, PBC (https://anthropic.com)",
            "homepage": "https://modelcontextprotocol.io"}))
        findings = deps.scan_package_json(str(p), "package.json")
        assert any("Provenance Squat" in f.title for f in findings)

    def test_canonical_scope_not_flagged(self, tmp_path):
        p = _write(tmp_path, "package.json", json.dumps({
            "name": "@modelcontextprotocol/inspector", "author": "Anthropic, PBC",
            "homepage": "https://modelcontextprotocol.io"}))
        findings = deps.scan_package_json(str(p), "package.json")
        assert not any("Provenance Squat" in f.title for f in findings)

    def test_unrelated_package_not_flagged(self, tmp_path):
        p = _write(tmp_path, "package.json", json.dumps({
            "name": "@someone/toolkit", "author": "Some Dev", "homepage": "https://example.dev"}))
        findings = deps.scan_package_json(str(p), "package.json")
        assert not any("Provenance Squat" in f.title for f in findings)


class TestAgentCLIPermissionBypass:
    """SA-JS-039 / SA-TS-019 / SA-SH-020: --dangerously-skip-permissions and
    bypassPermissions passed to agent CLIs (MCPA-2026-0063/0084 pattern)."""

    def _titles(self, root):
        return [f.title for f in _walk_scan(sast, root)]

    def test_js_spawn_flag_flagged(self, tmp_path):
        _pkg(tmp_path)
        _write(tmp_path, "dist/spawn.js",
               "permissionFlags.push('--dangerously-skip-permissions');\n")
        assert any("Permission Bypass" in t for t in self._titles(tmp_path))

    def test_js_bypass_permissions_const_flagged(self, tmp_path):
        _pkg(tmp_path)
        _write(tmp_path, "dist/spawn.js",
               "if (input.permissionMode === 'bypassPermissions') { go(); }\n")
        assert any("Permission Bypass" in t for t in self._titles(tmp_path))

    def test_ts_permission_mode_bypass_flagged(self, tmp_path):
        _pkg(tmp_path)
        _write(tmp_path, "src/run.ts",
               "spawn('claude', ['--permission-mode', 'bypass']);\n")
        assert any("Permission Bypass" in t for t in self._titles(tmp_path))

    def test_shell_wrapper_flagged(self, tmp_path):
        _pkg(tmp_path)
        _write(tmp_path, "dist/run-claude.sh",
               "#!/bin/bash\nclaude -p \"$PROMPT\" \\\n  --dangerously-skip-permissions \\\n")
        assert any("Permission Bypass" in t for t in self._titles(tmp_path))

    def test_benign_spawn_not_flagged(self, tmp_path):
        _pkg(tmp_path)
        _write(tmp_path, "dist/run.sh", "#!/bin/bash\nclaude -p \"$PROMPT\"\n")
        _write(tmp_path, "dist/s.js", "spawn('claude', ['-p', prompt]);\n")
        assert not any("Permission Bypass" in t for t in self._titles(tmp_path))

    def test_permission_mode_auto_not_flagged(self, tmp_path):
        _pkg(tmp_path)
        _write(tmp_path, "src/audit.js",
               "spawn(claudeCmd, ['-p', '--permission-mode', 'auto']);\n")
        assert not any("Permission Bypass" in t for t in self._titles(tmp_path))
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: 196kUpdated Claude CodeCodexVerifiedInstall