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

View on GitHub
#!/usr/bin/env python3
"""
scan_devcontainer.py - Devcontainer Security Scanner
Audits devcontainer.json for host secret exposure, container escape vectors,
and supply chain risks via lifecycle commands.

Uses json.load() for structured analysis (not regex on raw text).

Created by Alex Greenshpun
"""

import json
import os
import re
import sys

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

SCANNER_NAME = "devcontainer"

TARGET_FILENAMES = {"devcontainer.json", ".devcontainer.json"}

SECRET_PATHS = {".npmrc", ".ssh", ".aws", ".env", ".gnupg", ".config/gcloud", ".azure", ".kube"}

SECRET_ENV_KEYWORDS = re.compile(
    r'(?i)(API_KEY|TOKEN|SECRET|PASSWORD|PRIVATE_KEY|AUTH|CREDENTIAL|ACCESS_KEY)', re.IGNORECASE
)

LIFECYCLE_COMMANDS = [
    "initializeCommand", "onCreateCommand", "updateContentCommand",
    "postCreateCommand", "postStartCommand", "postAttachCommand",
]


def _commands_to_strings(value):
    """Normalize a devcontainer command field to a list of strings.
    Handles string, list, and dict forms per the devcontainer spec."""
    if isinstance(value, str):
        return [value]
    if isinstance(value, list):
        return [" ".join(str(s) for s in value)]
    if isinstance(value, dict):
        result = []
        for v in value.values():
            result.extend(_commands_to_strings(v))
        return result
    return []


def _has_secret_path(text):
    """Check if a string references a known host secret path."""
    for sp in SECRET_PATHS:
        if sp in text:
            return sp
    return None


def scan_devcontainer(file_path, rel_path):
    findings = []
    try:
        with open(file_path, 'r', encoding='utf-8') as f:
            data = json.load(f)
    except (json.JSONDecodeError, OSError, UnicodeDecodeError) as e:
        print(f"[!] Skipped {rel_path}: {e}", file=sys.stderr)
        return findings

    if not isinstance(data, dict):
        return findings

    # --- Mounts: host secret exposure ---
    for mount in data.get("mounts", []):
        mount_str = mount if isinstance(mount, str) else json.dumps(mount)
        secret = _has_secret_path(mount_str)
        if secret:
            findings.append(core.Finding(
                scanner=SCANNER_NAME, severity="critical",
                title="Devcontainer: Host Secret Mount",
                description=f"Mounts host path containing '{secret}' into container",
                file=rel_path, line=0, snippet=mount_str[:120],
                category="host-secret-exposure"
            ))
        if "/var/run/docker.sock" in mount_str:
            findings.append(core.Finding(
                scanner=SCANNER_NAME, severity="critical",
                title="Devcontainer: Docker Socket Mount",
                description="Docker socket mounted into container (container escape vector)",
                file=rel_path, line=0, snippet=mount_str[:120],
                category="container-escape"
            ))

    # --- runArgs ---
    run_args = data.get("runArgs", [])
    if isinstance(run_args, list):
        run_args_str = " ".join(str(a) for a in run_args)

        if "--privileged" in run_args_str:
            findings.append(core.Finding(
                scanner=SCANNER_NAME, severity="critical",
                title="Devcontainer: Privileged Container",
                description="Container runs in privileged mode (full host access)",
                file=rel_path, line=0, snippet="--privileged in runArgs",
                category="container-escape"
            ))

        if re.search(r'--cap-add[=\s]*SYS_ADMIN', run_args_str):
            findings.append(core.Finding(
                scanner=SCANNER_NAME, severity="high",
                title="Devcontainer: SYS_ADMIN Capability",
                description="SYS_ADMIN capability grants near-full host access",
                file=rel_path, line=0, snippet="--cap-add SYS_ADMIN in runArgs",
                category="container-escape"
            ))

        for i, arg in enumerate(run_args):
            arg_str = str(arg)
            if arg_str in ("-v", "--volume") and i + 1 < len(run_args):
                vol = str(run_args[i + 1])
                secret = _has_secret_path(vol)
                if secret:
                    findings.append(core.Finding(
                        scanner=SCANNER_NAME, severity="high",
                        title="Devcontainer: runArgs Host Volume Mount",
                        description=f"Volume mount references host secret path '{secret}'",
                        file=rel_path, line=0, snippet=vol[:120],
                        category="host-secret-exposure"
                    ))
            if arg_str == "-e" and i + 1 < len(run_args):
                env_val = str(run_args[i + 1])
                if SECRET_ENV_KEYWORDS.search(env_val.split("=")[0] if "=" in env_val else env_val):
                    findings.append(core.Finding(
                        scanner=SCANNER_NAME, severity="high",
                        title="Devcontainer: Secret in runArgs Env Var",
                        description="Secret environment variable passed via runArgs",
                        file=rel_path, line=0, snippet=env_val[:120],
                        category="secret-in-config"
                    ))

    # --- remoteEnv / containerEnv: localEnv interpolation ---
    for env_field in ("remoteEnv", "containerEnv"):
        env_map = data.get(env_field, {})
        if not isinstance(env_map, dict):
            continue
        for key, val in env_map.items():
            if isinstance(val, str) and "${localEnv:" in val:
                findings.append(core.Finding(
                    scanner=SCANNER_NAME, severity="high",
                    title=f"Devcontainer: {env_field} Pulls Host Secret",
                    description=f"'{key}' interpolates host env via ${{localEnv:}}. Lifecycle commands can exfiltrate this.",
                    file=rel_path, line=0, snippet=f"{key}={val}"[:120],
                    category="host-secret-exposure"
                ))

    # --- Lifecycle commands ---
    for cmd_name in LIFECYCLE_COMMANDS:
        raw = data.get(cmd_name)
        if raw is None:
            continue
        commands = _commands_to_strings(raw)
        for cmd in commands:
            secret = _has_secret_path(cmd)
            if secret:
                findings.append(core.Finding(
                    scanner=SCANNER_NAME, severity="critical",
                    title=f"Devcontainer: {cmd_name} Accesses Host Secrets",
                    description=f"Lifecycle command references host secret path '{secret}'",
                    file=rel_path, line=0, snippet=cmd[:120],
                    category="host-secret-exposure"
                ))

            if re.search(r'\b(curl|wget)\s+', cmd):
                findings.append(core.Finding(
                    scanner=SCANNER_NAME, severity="high",
                    title=f"Devcontainer: Remote Fetch in {cmd_name}",
                    description="Lifecycle command fetches remote content at container creation",
                    file=rel_path, line=0, snippet=cmd[:120],
                    category="remote-code-execution"
                ))

    # --- Features: untrusted OCI artifacts ---
    features = data.get("features", {})
    if isinstance(features, dict):
        trusted_prefixes = ("ghcr.io/devcontainers/", "mcr.microsoft.com/")
        for feature_ref in features:
            if not any(feature_ref.startswith(p) for p in trusted_prefixes):
                findings.append(core.Finding(
                    scanner=SCANNER_NAME, severity="medium",
                    title="Devcontainer: Untrusted Feature",
                    description=f"Feature '{feature_ref}' is not from a trusted registry. Features run install scripts as root.",
                    file=rel_path, line=0, snippet=feature_ref[:120],
                    category="untrusted-source"
                ))

    return findings


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

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

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

    for file_path, rel_path in core.walk_repo(repo_path, ignore_patterns, skip_binary=True):
        basename = os.path.basename(file_path)
        if basename in TARGET_FILENAMES:
            all_findings.extend(scan_devcontainer(file_path, 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