eva-cli 4.3.1__tar.gz → 4.4.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {eva_cli-4.3.1 → eva_cli-4.4.0}/.gitignore +2 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/CHANGELOG.md +31 -0
- eva_cli-4.3.1/README.md → eva_cli-4.4.0/PKG-INFO +89 -1
- eva_cli-4.3.1/PKG-INFO → eva_cli-4.4.0/README.md +46 -34
- {eva_cli-4.3.1 → eva_cli-4.4.0}/docs/README.md +2 -1
- {eva_cli-4.3.1 → eva_cli-4.4.0}/docs/command-reference.md +72 -1
- eva_cli-4.4.0/docs/eva-sec.md +276 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/docs/index.md +3 -3
- eva_cli-4.4.0/examples/sec/local-repo-assessment.yaml +21 -0
- eva_cli-4.4.0/examples/sec/passive-zap-baseline.yaml +12 -0
- eva_cli-4.4.0/examples/sec/scope.yaml +12 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/pyproject.toml +23 -4
- eva_cli-4.4.0/scripts/linux/audit_hardening.sh +177 -0
- eva_cli-4.4.0/scripts/linux/find_persistence.sh +101 -0
- eva_cli-4.4.0/scripts/linux/host_triage.sh +129 -0
- eva_cli-4.4.0/scripts/linux/network_triage.sh +103 -0
- eva_cli-4.4.0/scripts/linux/security_events.sh +104 -0
- eva_cli-4.4.0/scripts/test_vm_matrix.py +1038 -0
- eva_cli-4.4.0/scripts/windows/Audit-SystemHardening.ps1 +142 -0
- eva_cli-4.4.0/scripts/windows/Audit-UserAccounts.ps1 +103 -0
- eva_cli-4.4.0/scripts/windows/Find-SuspiciousPersistence.ps1 +138 -0
- eva_cli-4.4.0/scripts/windows/Get-HostTriage.ps1 +180 -0
- eva_cli-4.4.0/scripts/windows/Get-NetworkTriage.ps1 +104 -0
- eva_cli-4.4.0/scripts/windows/Get-SecurityEvents.ps1 +182 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/__init__.py +1 -1
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/cache/__init__.py +2 -0
- eva_cli-4.4.0/src/eva/cache/cache.py +164 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/cli/app.py +2 -0
- eva_cli-4.4.0/src/eva/security_tools/__init__.py +6 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis.py +382 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/__init__.py +4 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/analysis/__init__.py +0 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/analysis/authenticity.py +159 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/analysis/binary.py +105 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/analysis/metadata.py +94 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/analysis/rich_model.py +407 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/analysis/steganography.py +394 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/analysis/structure_validator.py +512 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/core/__init__.py +0 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/core/audit.py +54 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/core/hashing.py +45 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/core/image_object.py +87 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/core/pipeline.py +35 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/core/signing.py +69 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/core/vault.py +60 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/main.py +668 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/__init__.py +0 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/algorithms/__init__.py +0 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/algorithms/adaptive.py +336 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/algorithms/cost_functions.py +240 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/algorithms/f5_stego.py +406 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/algorithms/j_uniward.py +378 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/algorithms/stc_embed.py +226 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/channels/__init__.py +1 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/channels/metadata_channel.py +392 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/channels/multi_carrier.py +263 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/channels/network_covert.py +702 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/channels/palette_stego.py +291 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/crypto.py +178 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/fs_stego.py +47 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/reporting/__init__.py +0 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/reporting/reports.py +149 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/security/__init__.py +0 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/security/sanitization.py +14 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/security/shredder.py +59 -0
- eva_cli-4.4.0/src/eva/security_tools/aegis_engine/security/timestomp.py +32 -0
- eva_cli-4.4.0/src/eva/security_tools/base.py +91 -0
- eva_cli-4.4.0/src/eva/security_tools/cli.py +1179 -0
- eva_cli-4.4.0/src/eva/security_tools/elf_analyzer.py +266 -0
- eva_cli-4.4.0/src/eva/security_tools/entropy.py +176 -0
- eva_cli-4.4.0/src/eva/security_tools/gitleaks.py +43 -0
- eva_cli-4.4.0/src/eva/security_tools/intel_client.py +553 -0
- eva_cli-4.4.0/src/eva/security_tools/models.py +98 -0
- eva_cli-4.4.0/src/eva/security_tools/normalizers.py +526 -0
- eva_cli-4.4.0/src/eva/security_tools/osv.py +33 -0
- eva_cli-4.4.0/src/eva/security_tools/pe_analyzer.py +384 -0
- eva_cli-4.4.0/src/eva/security_tools/registry.py +63 -0
- eva_cli-4.4.0/src/eva/security_tools/report.py +76 -0
- eva_cli-4.4.0/src/eva/security_tools/rules/yara/cve_exploits.yar +34 -0
- eva_cli-4.4.0/src/eva/security_tools/rules/yara/embedded_pe.yar +47 -0
- eva_cli-4.4.0/src/eva/security_tools/rules/yara/obfuscation.yar +36 -0
- eva_cli-4.4.0/src/eva/security_tools/rules/yara/suspicious_packers.yar +54 -0
- eva_cli-4.4.0/src/eva/security_tools/rules/yara/webshells.yar +62 -0
- eva_cli-4.4.0/src/eva/security_tools/runner.py +139 -0
- eva_cli-4.4.0/src/eva/security_tools/scope.py +123 -0
- eva_cli-4.4.0/src/eva/security_tools/semgrep.py +43 -0
- eva_cli-4.4.0/src/eva/security_tools/strings_analyzer.py +214 -0
- eva_cli-4.4.0/src/eva/security_tools/syft.py +39 -0
- eva_cli-4.4.0/src/eva/security_tools/trivy.py +46 -0
- eva_cli-4.4.0/src/eva/security_tools/utils.py +153 -0
- eva_cli-4.4.0/src/eva/security_tools/workflow.py +161 -0
- eva_cli-4.4.0/src/eva/security_tools/yara_scanner.py +172 -0
- eva_cli-4.4.0/src/eva/security_tools/zap.py +116 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/workflows/engine.py +40 -1
- eva_cli-4.4.0/tests/unit/cache/test_cache.py +66 -0
- eva_cli-4.4.0/tests/unit/security_tools/__init__.py +1 -0
- eva_cli-4.4.0/tests/unit/security_tools/test_aegis.py +255 -0
- eva_cli-4.4.0/tests/unit/security_tools/test_binary.py +323 -0
- eva_cli-4.4.0/tests/unit/security_tools/test_intel.py +206 -0
- eva_cli-4.4.0/tests/unit/security_tools/test_normalizers.py +214 -0
- eva_cli-4.4.0/tests/unit/security_tools/test_runner.py +158 -0
- eva_cli-4.4.0/tests/unit/security_tools/test_scope.py +55 -0
- eva_cli-4.4.0/tests/unit/security_tools/test_sec_cli.py +306 -0
- eva_cli-4.4.0/tests/unit/security_tools/test_triage_ingest.py +120 -0
- eva_cli-4.4.0/tests/unit/security_tools/test_workflow.py +123 -0
- eva_cli-4.4.0/tests/unit/security_tools/test_yara.py +117 -0
- eva_cli-4.4.0/tests/unit/security_tools/test_zap.py +131 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/workflows/test_workflow_engine.py +11 -0
- eva_cli-4.4.0/uv.lock +2724 -0
- eva_cli-4.3.1/src/eva/cache/cache.py +0 -40
- eva_cli-4.3.1/tests/unit/cache/test_cache.py +0 -22
- {eva_cli-4.3.1 → eva_cli-4.4.0}/.github/workflows/ci.yaml +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/.github/workflows/fastwalk-release.yml +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/.github/workflows/release.yml +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/.pre-commit-config.yaml +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/CONTRIBUTING.md +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/Dockerfile +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/LICENSE +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/SECURITY.md +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/assets/demo.gif +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/assets/demo2.gif +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/assets/demo3.gif +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/assets/demo4.gif +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/assets/demo5.gif +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/assets/eva.png +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/docs/architecture.md +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/docs/configuration.md +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/docs/plugins.md +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/docs/provider-behavior.md +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/docs/security-model.md +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/examples/eva-plugin-hello/README.md +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/examples/eva-plugin-hello/eva_plugin_hello.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/examples/eva-plugin-hello/pyproject.toml +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/install.sh +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/rust/eva_fastwalk/Cargo.lock +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/rust/eva_fastwalk/Cargo.toml +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/rust/eva_fastwalk/pyproject.toml +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/rust/eva_fastwalk/src/lib.rs +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/agent/__init__.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/agent/loop.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/agent/tools.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/cli/__init__.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/cli.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/config/__init__.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/config/config.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/indexing/__init__.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/indexing/finder.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/indexing/io.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/indexing/packer.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/indexing/repo_index.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/indexing/tokenizer.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/indexing/tree.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/plugins/__init__.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/plugins/loader.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/plugins/protocol.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/prompts/__init__.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/providers/__init__.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/providers/gemini_provider.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/providers/groq_provider.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/providers/llamacpp_provider.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/providers/ollama_provider.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/providers/openai_compat.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/providers/opencode_zen_provider.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/providers/openrouter_provider.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/replay/__init__.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/replay/crypto.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/replay/player.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/replay/recorder.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/security/__init__.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/security/audit.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/security/redaction.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/security/sandbox.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/security/sensitive_files.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/security/work_safety.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/shell/__init__.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/shell/runner.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/telemetry/__init__.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/telemetry/diagnostics.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/telemetry/metrics.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/ui/__init__.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/ui/formatter.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/ui/output.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/ui/streaming.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/workflows/__init__.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/workflows/budget.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/workflows/builtins/dependency_audit.yaml +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/workflows/builtins/repo_health.yaml +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/workflows/builtins/security_scan.yaml +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/workflows/chat_session.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/workspace/__init__.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/workspace/git_ops.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/workspace/gitignore.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/workspace/project_context.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/workspace/session.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/conftest.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/fixtures/golden/patches/sample1_expected.diff +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/fixtures/golden/patches/sample1_fenced.txt +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/fixtures/golden/prompts/analyze_system_prompt.txt +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/fixtures/golden/prompts/ask_system_prompt.txt +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/fixtures/golden/prompts/changes_system_prompt.txt +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/fixtures/golden/prompts/chat_system_prompt.txt +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/fixtures/golden/prompts/commit_system_prompt.txt +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/fixtures/golden/prompts/edit_system_prompt.txt +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/fixtures/golden/prompts/explain_system_prompt.txt +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/fixtures/golden/prompts/work_system_prompt.txt +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/test_basic.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/__init__.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/agent/test_loop.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/agent/test_tools.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/cache/__init__.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/cli/__init__.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/cli/test_ask_repo.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/cli/test_changes_command.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/cli/test_cli.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/cli/test_cli_commands.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/cli/test_cli_coverage.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/cli/test_cli_more.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/cli/test_investigate.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/cli/test_output_format.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/config/__init__.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/config/test_config.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/config/test_config_keys.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/golden/__init__.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/golden/test_golden_patches.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/golden/test_golden_prompts.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/indexing/__init__.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/indexing/test_indexing.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/indexing/test_indexing_more.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/indexing/test_packer.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/indexing/test_repo_index.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/indexing/test_tokenizer_offline.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/plugins/__init__.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/plugins/test_plugins.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/providers/__init__.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/providers/test_context_budget.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/providers/test_dispatch_caching.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/providers/test_gemini_tools.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/providers/test_offline_providers.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/providers/test_openai_compat_tools.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/providers/test_provider_coverage.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/providers/test_provider_errors.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/providers/test_provider_tools_protocol.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/providers/test_providers.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/providers/test_providers_more.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/providers/test_repo_caching.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/replay/test_replay.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/security/__init__.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/security/test_allowlist_cli.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/security/test_audit.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/security/test_audit_chain.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/security/test_redaction.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/security/test_safety_audit.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/security/test_sandbox.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/security/test_sensitive_files_config.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/security/test_work_safety.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/shell/__init__.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/shell/test_shell.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/telemetry/__init__.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/telemetry/test_metrics.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/telemetry/test_telemetry.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/test_compatibility_imports.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/ui/__init__.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/ui/test_ui.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/workflows/__init__.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/workflows/test_chat_session.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/workflows/test_workflows.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/workspace/__init__.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/workspace/test_git_ops.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/workspace/test_gitignore_config.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/workspace/test_project_context.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/workspace/test_session_workspace.py +0 -0
- {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/workspace/test_workspace.py +0 -0
|
@@ -29,6 +29,7 @@ MANIFEST
|
|
|
29
29
|
# Unit test / linter caches
|
|
30
30
|
.pytest_cache/
|
|
31
31
|
.ruff_cache/
|
|
32
|
+
vm_test_artifacts/
|
|
32
33
|
.coverage
|
|
33
34
|
.hypothesis/
|
|
34
35
|
htmlcov/
|
|
@@ -58,4 +59,5 @@ eva.log
|
|
|
58
59
|
# Temporary / agent directories
|
|
59
60
|
.agents/
|
|
60
61
|
.codex/
|
|
62
|
+
.eva/
|
|
61
63
|
assets/demo.mp4
|
|
@@ -7,6 +7,37 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
7
7
|
|
|
8
8
|
|
|
9
9
|
|
|
10
|
+
## [4.4.0] - 2026-09-18
|
|
11
|
+
|
|
12
|
+
### Added
|
|
13
|
+
- **Defensive YARA Scanning & Rule Precompilation (`eva sec yara`):**
|
|
14
|
+
- High-performance scanning engine powered by `yara-python` with compiled binary rule caching (`eva sec yara compile <dir> -o <bin>` and `eva sec yara scan <path> --rules <rules>`).
|
|
15
|
+
- Curated baseline defensive rule set in `src/eva/security_tools/rules/yara/`:
|
|
16
|
+
- `webshells.yar`: Detects PHP, JSP, ASPX webshell execution primitives, `eval(base64_decode(...))`, and droppers.
|
|
17
|
+
- `suspicious_packers.yar`: Signatures for UPX, ASPack, Themida, and PECompact.
|
|
18
|
+
- `embedded_pe.yar`: Detects embedded Windows PE executables inside documents (PDF) and images (PNG, JPEG, GIF) with DOS stub validation.
|
|
19
|
+
- `obfuscation.yar`: Detects obfuscated PowerShell execution flags (`-w hidden -enc`, `DownloadString`, `IEX`) and base64 encoded binaries.
|
|
20
|
+
- `cve_exploits.yar`: Signatures for Log4j JNDI lookups and generic reverse shell commands.
|
|
21
|
+
- Normalizes rule matches into Eva's unified `Finding` schema with exact matched strings and byte offsets as evidence.
|
|
22
|
+
- Full multi-format report exports: Terminal table, JSON, Markdown, and SARIF 2.1.0 (`$schema: .../sarif-schema-2.1.0.json`).
|
|
23
|
+
- **Static Binary & Malware Analysis (`eva sec binary`):**
|
|
24
|
+
- `eva sec binary elf <file>`: ELF32/ELF64 header parsing, architecture, entry point, shared libraries, dynamic symbols, and exploit mitigation auditing (Stack Canary, Full/Partial/None RELRO, NX/DEP, PIE). Flags $W \oplus X$ violations (executable stack).
|
|
25
|
+
- `eva sec binary pe <file>`: Windows PE32/PE32+ static inspection (DOS/NT headers, entry point, compilation timestamp, imported DLLs/APIs, exported functions, sections). Flags missing ASLR/DEP in `DllCharacteristics` and RWX section violations.
|
|
26
|
+
- `eva sec binary entropy <file> [--block-size 1024]`: Shannon entropy calculation per block and sliding window. Flags packed/encrypted code regions ($\ge 7.2$ bits/byte) with `entropy.file.packed_encrypted` findings. Zero-safe on empty and uniform files.
|
|
27
|
+
- `eva sec binary strings <file> [--min-len 4] [--encoding ascii,utf16]`: Pure-Python string extraction with automatic IOC regex classification (public/private IPv4, URLs, Windows Registry persistence keys, PowerShell cradles, reverse shell commands).
|
|
28
|
+
- Resilient, non-crashing parser design: graceful error handling and structured `malformed` findings for truncated/corrupt headers.
|
|
29
|
+
- **Threat Intelligence Enrichment (`eva sec intel`):**
|
|
30
|
+
- `eva sec intel cve <cve-id>`: Live vulnerability enrichment via NIST NVD API v2, extracting descriptions, CVSS v3.1 base score, severity, CWE IDs, and affected CPE criteria.
|
|
31
|
+
- `eva sec intel ioc <ioc-value>`: Automatic IOC detection (IPv4, IPv6, Domain, URL, MD5, SHA-256) and multi-feed enrichment via AlienVault OTX, URLhaus, and AbuseIPDB.
|
|
32
|
+
- **Internal RFC 1918 Network Protection**: Automatically identifies RFC 1918 private IPs (`10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) and loopback addresses, immediately suppressing outbound queries to public feeds to prevent corporate topology leaks.
|
|
33
|
+
- `eva sec intel extract <target>`: Unstructured log/text parsing with IOC deduplication, domain false-positive filtering (`localhost`, `.internal`, `.local`), and secret redaction.
|
|
34
|
+
- **Cross-Platform Endpoint Triage Scripts (`scripts/`):**
|
|
35
|
+
- **Windows PowerShell Suite** (`scripts/windows/`): `Get-HostTriage.ps1`, `Audit-SystemHardening.ps1`, `Get-SecurityEvents.ps1`, `Find-SuspiciousPersistence.ps1`, `Audit-UserAccounts.ps1`, `Get-NetworkTriage.ps1`.
|
|
36
|
+
- **Linux POSIX Shell Suite** (`scripts/linux/`): Zero-dependency scripts `host_triage.sh`, `audit_hardening.sh`, `find_persistence.sh`, `security_events.sh`, `network_triage.sh`.
|
|
37
|
+
- Ingestable via `eva sec ingest <file.json>` and reportable via `eva sec report`.
|
|
38
|
+
- **Validation on Live Arch Linux VM:**
|
|
39
|
+
- 44-scenario automated test matrix (`scripts/test_vm_matrix.py`) executed cleanly on live Arch Linux VM (`Linux Valyria 7.2.6-arch2-1 x86_64`) with 100% pass rate.
|
|
40
|
+
|
|
10
41
|
## [4.3.1] - 2026-08-15
|
|
11
42
|
|
|
12
43
|
### Added
|
|
@@ -1,3 +1,46 @@
|
|
|
1
|
+
Metadata-Version: 2.5
|
|
2
|
+
Name: eva-cli
|
|
3
|
+
Version: 4.4.0
|
|
4
|
+
Summary: AI-powered terminal assistant focused on security, speed, and cross-platform workflows.
|
|
5
|
+
License-File: LICENSE
|
|
6
|
+
Requires-Python: >=3.10
|
|
7
|
+
Requires-Dist: argon2-cffi>=23.1.0
|
|
8
|
+
Requires-Dist: click>=8.0.0
|
|
9
|
+
Requires-Dist: cryptography>=49.0.0
|
|
10
|
+
Requires-Dist: google-genai<2.0.0,>=0.1.0
|
|
11
|
+
Requires-Dist: httpx<1.0.0,>=0.27.0
|
|
12
|
+
Requires-Dist: keyring<26.0.0,>=25.0.0
|
|
13
|
+
Requires-Dist: numpy>=1.24.0
|
|
14
|
+
Requires-Dist: openai<3.0.0,>=1.40.0
|
|
15
|
+
Requires-Dist: opencv-python-headless>=4.8.0
|
|
16
|
+
Requires-Dist: pathspec<1.0.0,>=0.12.0
|
|
17
|
+
Requires-Dist: pefile>=2024.8.26
|
|
18
|
+
Requires-Dist: piexif>=1.1.3
|
|
19
|
+
Requires-Dist: pillow>=10.0.0
|
|
20
|
+
Requires-Dist: platformdirs<5.0.0,>=4.0.0
|
|
21
|
+
Requires-Dist: pycryptodome>=3.20.0
|
|
22
|
+
Requires-Dist: pydantic-settings<3.0.0,>=2.0.0
|
|
23
|
+
Requires-Dist: pydantic<3.0.0,>=2.0.0
|
|
24
|
+
Requires-Dist: pyelftools>=0.31
|
|
25
|
+
Requires-Dist: pyyaml<7.0.0,>=6.0.0
|
|
26
|
+
Requires-Dist: rich<15.0.0,>=13.0.0
|
|
27
|
+
Requires-Dist: scipy>=1.10.0
|
|
28
|
+
Requires-Dist: tenacity<10.0.0,>=9.0.0
|
|
29
|
+
Requires-Dist: tiktoken<1.0.0,>=0.7.0
|
|
30
|
+
Requires-Dist: tomli-w<2.0.0,>=1.0.0
|
|
31
|
+
Requires-Dist: tomli<3.0.0,>=2.0.0
|
|
32
|
+
Requires-Dist: typer<1.0.0,>=0.12.0
|
|
33
|
+
Requires-Dist: yara-python>=4.5.0
|
|
34
|
+
Provides-Extra: dev
|
|
35
|
+
Requires-Dist: hypothesis<7.0.0,>=6.0.0; extra == 'dev'
|
|
36
|
+
Requires-Dist: pytest-cov<8.0.0,>=5.0.0; extra == 'dev'
|
|
37
|
+
Requires-Dist: pytest<10.0.0,>=8.0.0; extra == 'dev'
|
|
38
|
+
Requires-Dist: respx<1.0.0,>=0.21.0; extra == 'dev'
|
|
39
|
+
Requires-Dist: ruff<1.0.0,>=0.5.0; extra == 'dev'
|
|
40
|
+
Provides-Extra: fast
|
|
41
|
+
Requires-Dist: eva-fastwalk<0.2.0,>=0.1.0; extra == 'fast'
|
|
42
|
+
Description-Content-Type: text/markdown
|
|
43
|
+
|
|
1
44
|
|
|
2
45
|
# Eva CLI
|
|
3
46
|
|
|
@@ -63,8 +106,14 @@ The design goal is practical: keep routine terminal work fast and local, "Can't
|
|
|
63
106
|
- Hardened command generation via `eva work`: strict parsing, risk checks, no `shell=True`, dry-run mode, and audit logging.
|
|
64
107
|
- Git-aware workflows for explaining diffs and generating commit messages.
|
|
65
108
|
- Reviewable patch generation with `eva edit`.
|
|
109
|
+
- Defensive security & threat inspection (`eva sec`):
|
|
110
|
+
- YARA rule compilation and high-speed scanning with curated defensive baseline rules (webshells, packers, embedded PEs, obfuscation).
|
|
111
|
+
- Static binary analysis for Windows PE32/PE32+ and Linux ELF (mitigations: ASLR, DEP/NX, Stack Canary, RELRO, PIE, $W \oplus X$ violations).
|
|
112
|
+
- Shannon block entropy calculation and sliding window analysis for packed/encrypted code detection.
|
|
113
|
+
- Threat intelligence enrichment: live NIST NVD API v2 queries, multi-feed IOC lookups with RFC 1918 internal IP leak protection, and unstructured log IOC extraction.
|
|
114
|
+
- Cross-platform endpoint triage scripts (Windows PowerShell and Linux POSIX shell) with unified finding normalization and SARIF 2.1.0 reporting.
|
|
66
115
|
- Fine-grained security tuning: path-aware secret redaction, configurable Shannon entropy thresholds, and sensitive file allowlists (`eva config allow-sensitive-file`).
|
|
67
|
-
- Health checks through `eva config doctor`.
|
|
116
|
+
- Health checks through `eva config doctor` and `eva sec doctor`.
|
|
68
117
|
- Persistent chat sessions with `eva chat --session`.
|
|
69
118
|
|
|
70
119
|
## Installation
|
|
@@ -246,6 +295,38 @@ eva tree src/eva
|
|
|
246
295
|
|
|
247
296
|
```
|
|
248
297
|
|
|
298
|
+
Authorized defensive security operations (`eva sec`):
|
|
299
|
+
|
|
300
|
+
```bash
|
|
301
|
+
# Scan files or web roots with curated defensive YARA rules
|
|
302
|
+
eva sec yara scan /var/www/html --recursive --format sarif
|
|
303
|
+
|
|
304
|
+
# Compile YARA rules into high-performance binary cache
|
|
305
|
+
eva sec yara compile src/eva/security_tools/rules/yara -o /tmp/rules.bin
|
|
306
|
+
|
|
307
|
+
# Static ELF and PE exploit mitigation inspection (PIE, Canary, RELRO, W^X)
|
|
308
|
+
eva sec binary elf /usr/bin/custom_daemon
|
|
309
|
+
eva sec binary pe /tmp/sample.exe
|
|
310
|
+
|
|
311
|
+
# Shannon entropy analysis to detect packed/encrypted payloads
|
|
312
|
+
eva sec binary entropy /tmp/firmware.bin --block-size 1024
|
|
313
|
+
|
|
314
|
+
# Extract IOCs and categorized strings (IPs, URLs, registry keys, reverse shells)
|
|
315
|
+
eva sec binary strings /tmp/suspicious.bin --min-len 4
|
|
316
|
+
|
|
317
|
+
# Threat intelligence enrichment via NIST NVD API v2
|
|
318
|
+
eva sec intel cve CVE-2021-44228
|
|
319
|
+
|
|
320
|
+
# Multi-feed IOC enrichment with internal RFC 1918 privacy leak protection
|
|
321
|
+
eva sec intel ioc 198.51.100.45
|
|
322
|
+
|
|
323
|
+
# Unstructured log file IOC extraction with false-positive filtering
|
|
324
|
+
eva sec intel extract /var/log/auth.log
|
|
325
|
+
|
|
326
|
+
# Normalize and ingest cross-platform endpoint triage findings
|
|
327
|
+
eva sec ingest /tmp/audit_hardening.json --format markdown --format sarif
|
|
328
|
+
```
|
|
329
|
+
|
|
249
330
|
## Command reference
|
|
250
331
|
|
|
251
332
|
| Command | Purpose |
|
|
@@ -285,6 +366,13 @@ eva tree src/eva
|
|
|
285
366
|
| `eva config disallow-sensitive-file <glob>` | Remove glob pattern from sensitive file allowlist. |
|
|
286
367
|
| `eva config` | Manage provider, model, and API-key configuration. |
|
|
287
368
|
| `eva cache clear` | Clear cached AI responses. |
|
|
369
|
+
| `eva sec yara` | Compile and scan files with defensive YARA rules. |
|
|
370
|
+
| `eva sec binary` | Static malware and binary analysis (PE, ELF, entropy, strings). |
|
|
371
|
+
| `eva sec intel` | Threat intelligence enrichment and IOC extraction (NVD, OTX, URLhaus). |
|
|
372
|
+
| `eva sec media` | Defensive media forensics through embedded Aegis engine. |
|
|
373
|
+
| `eva sec assess` | Run local repo security assessment (Trivy, Semgrep, Gitleaks, OSV). |
|
|
374
|
+
| `eva sec ingest` | Normalize scanner and endpoint triage JSON reports into unified findings. |
|
|
375
|
+
| `eva sec report` | Render terminal, JSON, Markdown, or SARIF reports from normalized findings. |
|
|
288
376
|
|
|
289
377
|
|
|
290
378
|
Global options:
|
|
@@ -1,36 +1,3 @@
|
|
|
1
|
-
Metadata-Version: 2.5
|
|
2
|
-
Name: eva-cli
|
|
3
|
-
Version: 4.3.1
|
|
4
|
-
Summary: AI-powered terminal assistant focused on security, speed, and cross-platform workflows.
|
|
5
|
-
License-File: LICENSE
|
|
6
|
-
Requires-Python: >=3.10
|
|
7
|
-
Requires-Dist: cryptography<47.0.0,>=43.0.0
|
|
8
|
-
Requires-Dist: diskcache<6.0.0,>=5.6.0
|
|
9
|
-
Requires-Dist: google-genai<2.0.0,>=0.1.0
|
|
10
|
-
Requires-Dist: httpx<1.0.0,>=0.27.0
|
|
11
|
-
Requires-Dist: keyring<26.0.0,>=25.0.0
|
|
12
|
-
Requires-Dist: openai<3.0.0,>=1.40.0
|
|
13
|
-
Requires-Dist: pathspec<1.0.0,>=0.12.0
|
|
14
|
-
Requires-Dist: platformdirs<5.0.0,>=4.0.0
|
|
15
|
-
Requires-Dist: pydantic-settings<3.0.0,>=2.0.0
|
|
16
|
-
Requires-Dist: pydantic<3.0.0,>=2.0.0
|
|
17
|
-
Requires-Dist: pyyaml<7.0.0,>=6.0.0
|
|
18
|
-
Requires-Dist: rich<15.0.0,>=13.0.0
|
|
19
|
-
Requires-Dist: tenacity<10.0.0,>=9.0.0
|
|
20
|
-
Requires-Dist: tiktoken<1.0.0,>=0.7.0
|
|
21
|
-
Requires-Dist: tomli-w<2.0.0,>=1.0.0
|
|
22
|
-
Requires-Dist: tomli<3.0.0,>=2.0.0
|
|
23
|
-
Requires-Dist: typer<1.0.0,>=0.12.0
|
|
24
|
-
Provides-Extra: dev
|
|
25
|
-
Requires-Dist: hypothesis<7.0.0,>=6.0.0; extra == 'dev'
|
|
26
|
-
Requires-Dist: pytest-cov<8.0.0,>=5.0.0; extra == 'dev'
|
|
27
|
-
Requires-Dist: pytest<10.0.0,>=8.0.0; extra == 'dev'
|
|
28
|
-
Requires-Dist: respx<1.0.0,>=0.21.0; extra == 'dev'
|
|
29
|
-
Requires-Dist: ruff<1.0.0,>=0.5.0; extra == 'dev'
|
|
30
|
-
Provides-Extra: fast
|
|
31
|
-
Requires-Dist: eva-fastwalk<0.2.0,>=0.1.0; extra == 'fast'
|
|
32
|
-
Description-Content-Type: text/markdown
|
|
33
|
-
|
|
34
1
|
|
|
35
2
|
# Eva CLI
|
|
36
3
|
|
|
@@ -96,8 +63,14 @@ The design goal is practical: keep routine terminal work fast and local, "Can't
|
|
|
96
63
|
- Hardened command generation via `eva work`: strict parsing, risk checks, no `shell=True`, dry-run mode, and audit logging.
|
|
97
64
|
- Git-aware workflows for explaining diffs and generating commit messages.
|
|
98
65
|
- Reviewable patch generation with `eva edit`.
|
|
66
|
+
- Defensive security & threat inspection (`eva sec`):
|
|
67
|
+
- YARA rule compilation and high-speed scanning with curated defensive baseline rules (webshells, packers, embedded PEs, obfuscation).
|
|
68
|
+
- Static binary analysis for Windows PE32/PE32+ and Linux ELF (mitigations: ASLR, DEP/NX, Stack Canary, RELRO, PIE, $W \oplus X$ violations).
|
|
69
|
+
- Shannon block entropy calculation and sliding window analysis for packed/encrypted code detection.
|
|
70
|
+
- Threat intelligence enrichment: live NIST NVD API v2 queries, multi-feed IOC lookups with RFC 1918 internal IP leak protection, and unstructured log IOC extraction.
|
|
71
|
+
- Cross-platform endpoint triage scripts (Windows PowerShell and Linux POSIX shell) with unified finding normalization and SARIF 2.1.0 reporting.
|
|
99
72
|
- Fine-grained security tuning: path-aware secret redaction, configurable Shannon entropy thresholds, and sensitive file allowlists (`eva config allow-sensitive-file`).
|
|
100
|
-
- Health checks through `eva config doctor`.
|
|
73
|
+
- Health checks through `eva config doctor` and `eva sec doctor`.
|
|
101
74
|
- Persistent chat sessions with `eva chat --session`.
|
|
102
75
|
|
|
103
76
|
## Installation
|
|
@@ -279,6 +252,38 @@ eva tree src/eva
|
|
|
279
252
|
|
|
280
253
|
```
|
|
281
254
|
|
|
255
|
+
Authorized defensive security operations (`eva sec`):
|
|
256
|
+
|
|
257
|
+
```bash
|
|
258
|
+
# Scan files or web roots with curated defensive YARA rules
|
|
259
|
+
eva sec yara scan /var/www/html --recursive --format sarif
|
|
260
|
+
|
|
261
|
+
# Compile YARA rules into high-performance binary cache
|
|
262
|
+
eva sec yara compile src/eva/security_tools/rules/yara -o /tmp/rules.bin
|
|
263
|
+
|
|
264
|
+
# Static ELF and PE exploit mitigation inspection (PIE, Canary, RELRO, W^X)
|
|
265
|
+
eva sec binary elf /usr/bin/custom_daemon
|
|
266
|
+
eva sec binary pe /tmp/sample.exe
|
|
267
|
+
|
|
268
|
+
# Shannon entropy analysis to detect packed/encrypted payloads
|
|
269
|
+
eva sec binary entropy /tmp/firmware.bin --block-size 1024
|
|
270
|
+
|
|
271
|
+
# Extract IOCs and categorized strings (IPs, URLs, registry keys, reverse shells)
|
|
272
|
+
eva sec binary strings /tmp/suspicious.bin --min-len 4
|
|
273
|
+
|
|
274
|
+
# Threat intelligence enrichment via NIST NVD API v2
|
|
275
|
+
eva sec intel cve CVE-2021-44228
|
|
276
|
+
|
|
277
|
+
# Multi-feed IOC enrichment with internal RFC 1918 privacy leak protection
|
|
278
|
+
eva sec intel ioc 198.51.100.45
|
|
279
|
+
|
|
280
|
+
# Unstructured log file IOC extraction with false-positive filtering
|
|
281
|
+
eva sec intel extract /var/log/auth.log
|
|
282
|
+
|
|
283
|
+
# Normalize and ingest cross-platform endpoint triage findings
|
|
284
|
+
eva sec ingest /tmp/audit_hardening.json --format markdown --format sarif
|
|
285
|
+
```
|
|
286
|
+
|
|
282
287
|
## Command reference
|
|
283
288
|
|
|
284
289
|
| Command | Purpose |
|
|
@@ -318,6 +323,13 @@ eva tree src/eva
|
|
|
318
323
|
| `eva config disallow-sensitive-file <glob>` | Remove glob pattern from sensitive file allowlist. |
|
|
319
324
|
| `eva config` | Manage provider, model, and API-key configuration. |
|
|
320
325
|
| `eva cache clear` | Clear cached AI responses. |
|
|
326
|
+
| `eva sec yara` | Compile and scan files with defensive YARA rules. |
|
|
327
|
+
| `eva sec binary` | Static malware and binary analysis (PE, ELF, entropy, strings). |
|
|
328
|
+
| `eva sec intel` | Threat intelligence enrichment and IOC extraction (NVD, OTX, URLhaus). |
|
|
329
|
+
| `eva sec media` | Defensive media forensics through embedded Aegis engine. |
|
|
330
|
+
| `eva sec assess` | Run local repo security assessment (Trivy, Semgrep, Gitleaks, OSV). |
|
|
331
|
+
| `eva sec ingest` | Normalize scanner and endpoint triage JSON reports into unified findings. |
|
|
332
|
+
| `eva sec report` | Render terminal, JSON, Markdown, or SARIF reports from normalized findings. |
|
|
321
333
|
|
|
322
334
|
|
|
323
335
|
Global options:
|
|
@@ -10,10 +10,11 @@ This directory contains the official documentation for Eva CLI, mirroring the co
|
|
|
10
10
|
| [Command Reference](command-reference.md) | Complete CLI command reference with examples. |
|
|
11
11
|
| [Configuration](configuration.md) | Provider setup, environment variables, config.toml, and health diagnostics. |
|
|
12
12
|
| [Security & Hardening](security-model.md) | Secret redaction, audit logging, command safety, and sandbox controls. |
|
|
13
|
+
| [Eva Sec](eva-sec.md) | Authorized security assessment, YARA scanning, binary analysis, threat intel, endpoint triage, and SARIF. |
|
|
13
14
|
| [Provider Behavior](provider-behavior.md) | Provider routing, fallback strategy, caching, and offline tokenization. |
|
|
14
15
|
| [Architecture](architecture.md) | Module layout, request flow diagrams, and execution pipeline. |
|
|
15
16
|
| [Plugin System](plugins.md) | Writing plugins, entry points, lifecycle hooks, and fail-soft safety. |
|
|
16
17
|
|
|
17
18
|
## Version
|
|
18
19
|
|
|
19
|
-
This documentation corresponds to **Eva CLI v4.
|
|
20
|
+
This documentation corresponds to **Eva CLI v4.4.0**.
|
|
@@ -167,6 +167,35 @@ eva replay session-2026-08-10
|
|
|
167
167
|
|
|
168
168
|
---
|
|
169
169
|
|
|
170
|
+
## Security Assessment Commands
|
|
171
|
+
|
|
172
|
+
### `eva sec`
|
|
173
|
+
Run authorized repository security assessment, defensive media forensics, report normalization, scoped ZAP baseline testing, and declarative security workflows.
|
|
174
|
+
|
|
175
|
+
| Subcommand | Description |
|
|
176
|
+
| --- | --- |
|
|
177
|
+
| `eva sec doctor` | Detect optional tools, versions, supported features, and install guidance. |
|
|
178
|
+
| `eva sec assess [PATH]` | Run Trivy, Semgrep, Gitleaks, and optional OSV/Syft local assessment adapters. |
|
|
179
|
+
| `eva sec media <CMD> <FILE>` | Run Aegis forensic media analysis, steganography, signing, and file utilities. |
|
|
180
|
+
| `eva sec ingest <REPORT>` | Import SARIF, scanner JSON, or Aegis JSON into Eva's finding schema. |
|
|
181
|
+
| `eva sec report [REPORT]` | Produce terminal, JSON, Markdown, and SARIF reports. |
|
|
182
|
+
| `eva sec run <PLAN.yaml>` | Execute a Pydantic-validated declarative security workflow. |
|
|
183
|
+
| `eva sec zap <URL> --scope <scope.yaml>` | Run an authorized passive ZAP baseline scan. |
|
|
184
|
+
|
|
185
|
+
```bash
|
|
186
|
+
eva sec assess . --format terminal --format sarif
|
|
187
|
+
eva sec media analyze ./evidence/photo.jpg
|
|
188
|
+
eva sec media sign ./evidence/photo.jpg --key secretkey
|
|
189
|
+
eva sec run ./examples/sec/local-repo-assessment.yaml --dry-run
|
|
190
|
+
eva sec zap https://staging.example.internal --scope ./examples/sec/scope.yaml --dry-run
|
|
191
|
+
```
|
|
192
|
+
|
|
193
|
+
ZAP active scanning requires `--active`, a non-expired scope file with `allow_active_scanning: true`, and confirmation unless `--yes` is supplied. `--yes` never bypasses invalid scope.
|
|
194
|
+
|
|
195
|
+
See [Eva Sec](eva-sec.md) for full Aegis media operations, workflow schema, scope-file rules, and SARIF integration.
|
|
196
|
+
|
|
197
|
+
---
|
|
198
|
+
|
|
170
199
|
## Git Intelligence Commands
|
|
171
200
|
|
|
172
201
|
### `eva changes`
|
|
@@ -187,6 +216,49 @@ eva commit-message
|
|
|
187
216
|
|
|
188
217
|
---
|
|
189
218
|
|
|
219
|
+
## Authorized Security Operations (`eva sec`)
|
|
220
|
+
|
|
221
|
+
Eva Sec provides deterministic defensive security analysis, malware inspection, and threat intelligence.
|
|
222
|
+
|
|
223
|
+
| Command | Purpose |
|
|
224
|
+
| --- | --- |
|
|
225
|
+
| `eva sec yara scan <path>` | Scan files/directories using curated defensive YARA rules. |
|
|
226
|
+
| `eva sec yara compile <dir>` | Compile raw `.yar` rules into high-performance binary rules. |
|
|
227
|
+
| `eva sec binary elf <file>` | Audit ELF mitigations (Stack Canary, RELRO, PIE, NX) and W^X violations. |
|
|
228
|
+
| `eva sec binary pe <file>` | Audit PE headers, ASLR, DEP/NX, and RWX section violations. |
|
|
229
|
+
| `eva sec binary entropy <file>` | Compute Shannon entropy to detect packed/encrypted blocks. |
|
|
230
|
+
| `eva sec binary strings <file>` | Extract ASCII/UTF-16 strings with automatic IOC classification. |
|
|
231
|
+
| `eva sec intel cve <cve-id>` | Live vulnerability enrichment via NIST NVD API v2. |
|
|
232
|
+
| `eva sec intel ioc <ioc>` | Threat feed enrichment with RFC 1918 internal IP leak protection. |
|
|
233
|
+
| `eva sec intel extract <target>`| Parse logs/text for IOCs with false-positive filtering. |
|
|
234
|
+
| `eva sec ingest <report>` | Normalize scanner and endpoint triage JSON reports. |
|
|
235
|
+
| `eva sec report` | Render Markdown, SARIF 2.1.0, JSON, or Terminal finding reports. |
|
|
236
|
+
| `eva sec doctor` | Check installed security tooling status. |
|
|
237
|
+
| `eva sec media` | Defensive media forensics through embedded Aegis engine. |
|
|
238
|
+
|
|
239
|
+
```bash
|
|
240
|
+
# Scan directory with YARA rules and output SARIF
|
|
241
|
+
eva sec yara scan /var/www/html --recursive --format sarif
|
|
242
|
+
|
|
243
|
+
# Audit binary exploit mitigations
|
|
244
|
+
eva sec binary elf /usr/bin/daemon
|
|
245
|
+
eva sec binary pe payload.exe
|
|
246
|
+
|
|
247
|
+
# Shannon entropy analysis
|
|
248
|
+
eva sec binary entropy sample.bin --block-size 1024
|
|
249
|
+
|
|
250
|
+
# Live CVE query from NIST NVD
|
|
251
|
+
eva sec intel cve CVE-2021-44228
|
|
252
|
+
|
|
253
|
+
# Enrich IOC while protecting internal RFC 1918 addresses
|
|
254
|
+
eva sec intel ioc 198.51.100.45
|
|
255
|
+
|
|
256
|
+
# Ingest and normalize endpoint triage report
|
|
257
|
+
eva sec ingest /tmp/audit_hardening.json --format markdown --format sarif
|
|
258
|
+
```
|
|
259
|
+
|
|
260
|
+
---
|
|
261
|
+
|
|
190
262
|
## Deterministic Local Commands (Zero Quota)
|
|
191
263
|
|
|
192
264
|
These utility commands run 100% locally and consume no LLM provider quota.
|
|
@@ -247,4 +319,3 @@ eva --verbose ask "Why did this fail?" # Enable verbose diagnostics logging
|
|
|
247
319
|
eva --install-completion # Install shell completion (bash/zsh/fish)
|
|
248
320
|
eva --show-completion # Print shell completion script
|
|
249
321
|
```
|
|
250
|
-
|
|
@@ -0,0 +1,276 @@
|
|
|
1
|
+
# Eva Sec
|
|
2
|
+
|
|
3
|
+
`eva sec` is Eva's authorized security assessment and evidence-analysis module. It is designed for local repository checks, defensive media forensics, report normalization, and scoped web-app baseline testing.
|
|
4
|
+
|
|
5
|
+
Eva Sec does not install third-party tools automatically. Use `eva sec doctor` to see what is available and how to install missing tools.
|
|
6
|
+
|
|
7
|
+
## Commands
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
eva sec doctor
|
|
11
|
+
eva sec assess .
|
|
12
|
+
eva sec assess . --include-osv --include-syft --format terminal --format sarif
|
|
13
|
+
eva sec media analyze ./evidence/photo.jpg
|
|
14
|
+
eva sec ingest ./trivy-report.json
|
|
15
|
+
eva sec report
|
|
16
|
+
eva sec run ./examples/sec/local-repo-assessment.yaml --dry-run
|
|
17
|
+
eva sec zap https://staging.example.internal --scope ./examples/sec/scope.yaml --dry-run
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
## Normalized Finding Schema
|
|
21
|
+
|
|
22
|
+
All imported and generated findings are normalized to:
|
|
23
|
+
|
|
24
|
+
```text
|
|
25
|
+
id, tool, rule_id, title, severity, confidence, category,
|
|
26
|
+
file, line_start, line_end, target, evidence,
|
|
27
|
+
remediation, references, fingerprint, artifact_path
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
Console output, audit logs, and reports redact common secrets and high-entropy tokens before writing.
|
|
31
|
+
|
|
32
|
+
## Workflow Format
|
|
33
|
+
|
|
34
|
+
Security workflows are declarative YAML. They use a reviewed adapter registry rather than arbitrary commands.
|
|
35
|
+
|
|
36
|
+
```yaml
|
|
37
|
+
version: 1
|
|
38
|
+
name: secure-repo-assessment
|
|
39
|
+
scope: ./scope.yaml
|
|
40
|
+
artifacts_dir: .eva/artifacts
|
|
41
|
+
steps:
|
|
42
|
+
- uses: trivy.filesystem
|
|
43
|
+
with:
|
|
44
|
+
path: .
|
|
45
|
+
scanners: [vuln, secret, misconfig, license]
|
|
46
|
+
|
|
47
|
+
- uses: semgrep.scan
|
|
48
|
+
with:
|
|
49
|
+
path: .
|
|
50
|
+
config: auto
|
|
51
|
+
|
|
52
|
+
- uses: gitleaks.scan
|
|
53
|
+
with:
|
|
54
|
+
path: .
|
|
55
|
+
|
|
56
|
+
- uses: aegis.analyze
|
|
57
|
+
when: input.evidence_image
|
|
58
|
+
with:
|
|
59
|
+
path: ${input.evidence_image}
|
|
60
|
+
|
|
61
|
+
- uses: report.merge
|
|
62
|
+
with:
|
|
63
|
+
format: [terminal, json, markdown, sarif]
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
The workflow validator rejects `command`, `cmd`, `shell`, `bash`, `script`, and `run` keys, as well as pipes, redirects, command substitution, inline shell control syntax, and unknown adapters.
|
|
67
|
+
|
|
68
|
+
## Scope Files
|
|
69
|
+
|
|
70
|
+
Local repository scans do not need network authorization. ZAP operations always require a valid scope file.
|
|
71
|
+
|
|
72
|
+
```yaml
|
|
73
|
+
version: 1
|
|
74
|
+
engagement_id: local-dev-001
|
|
75
|
+
expires_at: 2026-12-31T23:59:59Z
|
|
76
|
+
paths:
|
|
77
|
+
- .
|
|
78
|
+
web_targets:
|
|
79
|
+
- https://staging.example.internal
|
|
80
|
+
allowed_ports: [80, 443]
|
|
81
|
+
max_requests_per_second: 2
|
|
82
|
+
max_concurrency: 2
|
|
83
|
+
max_duration_seconds: 600
|
|
84
|
+
allow_active_scanning: false
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
ZAP targets must match the approved scheme, host, port, and path scope. Expired scopes are rejected. Active scanning requires `allow_active_scanning: true`, `--active`, and confirmation unless `--yes` is supplied. `--yes` never bypasses an invalid, absent, or expired scope.
|
|
88
|
+
|
|
89
|
+
## Aegis Integration (`eva sec media`)
|
|
90
|
+
|
|
91
|
+
Eva directly vendors and integrates the full feature set from `rootagi/Aegis` directly within the CLI engine under `eva.security_tools.aegis_engine`, providing in-process forensic analysis, steganographic detection and simulation, cryptographic evidence signing, and safe evidence utilities:
|
|
92
|
+
|
|
93
|
+
### Forensic Analysis & Integrity
|
|
94
|
+
- `analyze`: Comprehensive image and media analysis (metadata, ELA, bitplanes, structural anomalies).
|
|
95
|
+
- `detect-stego`: Statistical and signature-based steganography detection.
|
|
96
|
+
- `scan-structure`: Structural validation and format conformance verification.
|
|
97
|
+
- `slice-bitplanes`: Extract and visualize individual RGB bitplanes.
|
|
98
|
+
- `extract-hidden`: Extract detected hidden streams or metadata payloads.
|
|
99
|
+
- `sanitize`: Strip metadata, GPS coords, ICC profiles, and hidden appended payloads from images.
|
|
100
|
+
|
|
101
|
+
### Cryptographic Signatures
|
|
102
|
+
- `sign` / `verify`: Symmetric HMAC-SHA256 evidence signature creation and verification.
|
|
103
|
+
- `keygen`: Generate Ed25519 asymmetric cryptographic keypairs for evidence authentication.
|
|
104
|
+
- `sign-asymmetric` / `verify-asymmetric`: Asymmetric Ed25519 evidence signing and verification.
|
|
105
|
+
|
|
106
|
+
### Steganographic Analysis & Carrier Testing
|
|
107
|
+
- `embed` / `extract`: Carrier steganography embedding and extraction.
|
|
108
|
+
- `palette-embed` / `palette-extract`: Color-palette steganographic carrier testing.
|
|
109
|
+
- `meta-embed` / `meta-extract`: Metadata channel (EXIF, XMP, ICC, GPS) carrier testing.
|
|
110
|
+
- `split` / `reconstruct`: Multi-carrier secret splitting across multiple media files.
|
|
111
|
+
- `fs-embed` / `fs-extract`: Extended filesystem attribute (xattr) carrier testing.
|
|
112
|
+
|
|
113
|
+
### Secure File Utilities
|
|
114
|
+
- `timestomp`: Clone timestamps between forensic artifacts or sanitize metadata time stamps.
|
|
115
|
+
- `shred`: Multi-pass DoD-compliant secure file shredding.
|
|
116
|
+
|
|
117
|
+
## Defensive YARA Scanning (`eva sec yara`)
|
|
118
|
+
|
|
119
|
+
Eva provides an integrated defensive YARA engine powered by `yara-python` with compiled rule caching and curated threat detection rules:
|
|
120
|
+
|
|
121
|
+
### Curated Rule Baseline (`src/eva/security_tools/rules/yara/`)
|
|
122
|
+
- `webshells.yar`: Detects PHP, JSP, ASPX webshell execution primitives, `eval(base64_decode(...))`, China Chopper, and command execution backdoors.
|
|
123
|
+
- `suspicious_packers.yar`: Signatures for UPX, ASPack, Themida, and PECompact.
|
|
124
|
+
- `embedded_pe.yar`: Detects embedded Windows PE executables inside non-executable media and documents (PDF, PNG, JPEG, GIF) with DOS stub validation.
|
|
125
|
+
- `obfuscation.yar`: Detects obfuscated PowerShell execution flags (`-w hidden -enc`, `DownloadString`, `IEX`) and base64 encoded binaries.
|
|
126
|
+
- `cve_exploits.yar`: Signatures for Log4j JNDI lookups and generic reverse shell commands.
|
|
127
|
+
|
|
128
|
+
### Commands
|
|
129
|
+
```bash
|
|
130
|
+
# Scan a directory recursively with default rules and export to SARIF
|
|
131
|
+
eva sec yara scan /var/www/html --recursive --format sarif
|
|
132
|
+
|
|
133
|
+
# Scan with custom rules file
|
|
134
|
+
eva sec yara scan /path/to/target --rules /path/to/custom.yar
|
|
135
|
+
|
|
136
|
+
# Precompile a directory of rules into a fast binary cache
|
|
137
|
+
eva sec yara compile src/eva/security_tools/rules/yara -o /tmp/rules.bin
|
|
138
|
+
|
|
139
|
+
# Scan using the precompiled rules binary
|
|
140
|
+
eva sec yara scan /path/to/target --rules /tmp/rules.bin
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
Rule matches are normalized into Eva's unified `Finding` model with severity mapped from YARA metadata tags and evidence detailing matched strings and byte offsets.
|
|
144
|
+
|
|
145
|
+
## Malware & Binary Static Analysis (`eva sec binary`)
|
|
146
|
+
|
|
147
|
+
Perform in-depth static analysis of executable binaries, byte distributions, and strings without executing untrusted code:
|
|
148
|
+
|
|
149
|
+
### ELF Binary Analysis (`eva sec binary elf`)
|
|
150
|
+
Extracts ELF headers, machine architecture, entry point, dynamically linked libraries, and dynamic symbols. Audits critical exploit mitigations:
|
|
151
|
+
- **Stack Canary**: Detects presence of stack protection guards (`__stack_chk_fail`).
|
|
152
|
+
- **RELRO**: Checks for Full RELRO (`BIND_NOW`), Partial RELRO, or None.
|
|
153
|
+
- **NX / DEP**: Validates non-executable stack (`GNU_STACK` permissions). Flags $W \oplus X$ violations (executable stacks).
|
|
154
|
+
- **PIE**: Validates Position Independent Executable status.
|
|
155
|
+
|
|
156
|
+
```bash
|
|
157
|
+
eva sec binary elf /usr/bin/ls
|
|
158
|
+
eva sec binary elf ./custom_daemon --format json
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
### Windows PE Analysis (`eva sec binary pe`)
|
|
162
|
+
Extracts DOS/NT headers, machine type, compilation timestamp, image base, entry point, imported DLLs/APIs, exported symbols, and section characteristics.
|
|
163
|
+
- Inspects `DllCharacteristics` for ASLR (`DYNAMIC_BASE`) and DEP (`NX_COMPAT`).
|
|
164
|
+
- Identifies $W \oplus X$ section violations: flags sections possessing both Read, Write, and Execute permissions (`IMAGE_SCN_MEM_WRITE` and `IMAGE_SCN_MEM_EXECUTE`).
|
|
165
|
+
|
|
166
|
+
```bash
|
|
167
|
+
eva sec binary pe /path/to/binary.exe
|
|
168
|
+
```
|
|
169
|
+
|
|
170
|
+
### Shannon Entropy Analysis (`eva sec binary entropy`)
|
|
171
|
+
Calculates Shannon entropy across uniform byte blocks and sliding windows (0.0 to 8.0 bits per byte).
|
|
172
|
+
- Flags high-entropy packed or encrypted regions ($\ge 7.2$ bits/byte) with `entropy.file.packed_encrypted` security findings.
|
|
173
|
+
- Handled safely on zero-filled and empty files without division-by-zero errors.
|
|
174
|
+
|
|
175
|
+
```bash
|
|
176
|
+
eva sec binary entropy /path/to/firmware.bin --block-size 1024
|
|
177
|
+
```
|
|
178
|
+
|
|
179
|
+
### Strings & IOC Extraction (`eva sec binary strings`)
|
|
180
|
+
Extracts ASCII and UTF-16 LE/BE strings and automatically classifies extracted tokens using defensive regex patterns:
|
|
181
|
+
- Public and private IPv4 addresses
|
|
182
|
+
- HTTP/HTTPS URLs
|
|
183
|
+
- Windows Registry persistence keys (`HKLM\...`, `HKCU\...`)
|
|
184
|
+
- PowerShell download cradles and invocation flags
|
|
185
|
+
- Unix reverse shell commands (`nc -e`, `sh -i`, `bash -i`)
|
|
186
|
+
|
|
187
|
+
```bash
|
|
188
|
+
eva sec binary strings /path/to/sample.bin --min-len 4
|
|
189
|
+
```
|
|
190
|
+
|
|
191
|
+
## Threat Intelligence & Enrichment (`eva sec intel`)
|
|
192
|
+
|
|
193
|
+
### Live CVE Enrichment (`eva sec intel cve`)
|
|
194
|
+
Queries the official NIST National Vulnerability Database (NVD) API v2 over HTTPS:
|
|
195
|
+
- Retrieves vulnerability descriptions, CVSS v3.1 base score, severity ratings, CWE weakness IDs, and affected CPE criteria.
|
|
196
|
+
- Validates CVE identifier syntax and normalizes vulnerabilities into unified `Finding` objects.
|
|
197
|
+
|
|
198
|
+
```bash
|
|
199
|
+
eva sec intel cve CVE-2021-44228
|
|
200
|
+
eva sec intel cve CVE-2024-3094 --format markdown
|
|
201
|
+
```
|
|
202
|
+
|
|
203
|
+
### Defensive Multi-Feed IOC Enrichment (`eva sec intel ioc`)
|
|
204
|
+
Automatically detects IOC type (IPv4, IPv6, Domain, URL, MD5, SHA-256) and queries free/open intelligence feeds (AlienVault OTX, URLhaus, AbuseIPDB, VirusTotal):
|
|
205
|
+
- **RFC 1918 Internal Network Protection**: Private IPs (`10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`, `127.0.0.0/8`) are automatically protected; external queries to public threat feeds are immediately suppressed to prevent corporate infrastructure leakage.
|
|
206
|
+
|
|
207
|
+
```bash
|
|
208
|
+
eva sec intel ioc 8.8.8.8
|
|
209
|
+
eva sec intel ioc 192.168.1.1
|
|
210
|
+
eva sec intel ioc example.com
|
|
211
|
+
eva sec intel ioc e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
|
|
212
|
+
```
|
|
213
|
+
|
|
214
|
+
### Unstructured Log IOC Extraction (`eva sec intel extract`)
|
|
215
|
+
Parses raw text, terminal output, or log files, extracting and deduplicating public IPs, internal IPs, domains, URLs, hashes, and CVEs:
|
|
216
|
+
- Filters out domain false positives (`localhost`, `.internal`, `.local`) and redacts high-entropy secrets.
|
|
217
|
+
|
|
218
|
+
```bash
|
|
219
|
+
eva sec intel extract /var/log/auth.log
|
|
220
|
+
eva sec intel extract "C2 at 198.51.100.22 and http://evil.com/payload"
|
|
221
|
+
```
|
|
222
|
+
|
|
223
|
+
## Cross-Platform Endpoint Triage (`scripts/`)
|
|
224
|
+
|
|
225
|
+
Eva provides standalone, zero-dependency endpoint triage and hardening audit scripts for Windows and Linux endpoints.
|
|
226
|
+
|
|
227
|
+
### Windows PowerShell Suite (`scripts/windows/`)
|
|
228
|
+
- `Get-HostTriage.ps1`: Collects OS details, listening sockets, active processes, and startup run keys.
|
|
229
|
+
- `Audit-SystemHardening.ps1`: Audits UAC, SMBv1, Windows Firewall profiles, and PowerShell script logging.
|
|
230
|
+
- `Get-SecurityEvents.ps1`: Queries Event IDs 4624/4625, 4672, 4688, and 7045.
|
|
231
|
+
- `Find-SuspiciousPersistence.ps1`: Inspects Run/RunOnce keys, Startup folders, WMI event consumers, and BITS jobs.
|
|
232
|
+
- `Audit-UserAccounts.ps1`: Audits local administrators, guest account status, and password policies.
|
|
233
|
+
- `Get-NetworkTriage.ps1`: Collects active connections, DNS cache, and hosts file redirects.
|
|
234
|
+
|
|
235
|
+
### Linux POSIX Shell Suite (`scripts/linux/`)
|
|
236
|
+
- `host_triage.sh`: Zero-dependency POSIX script collecting kernel info, active listeners, cron jobs, and systemd timers.
|
|
237
|
+
- `audit_hardening.sh`: Inspects SSH daemon configuration, `/etc/login.defs`, sysctl parameters (ASLR, IP forward), and SUID binaries.
|
|
238
|
+
- `find_persistence.sh`: Inspects `/etc/ld.so.preload`, `/etc/rc.local`, cron directories, and systemd units for `/tmp` execution.
|
|
239
|
+
- `security_events.sh`: Analyzes failed SSH logons and non-root UID 0 accounts.
|
|
240
|
+
- `network_triage.sh`: Inspects default route, DNS resolvers, hosts file redirects, and firewall status.
|
|
241
|
+
|
|
242
|
+
### Unified Ingestion & Reporting
|
|
243
|
+
All triage scripts emit valid `eva.triage.v1` JSON. Ingest outputs directly into Eva:
|
|
244
|
+
|
|
245
|
+
```bash
|
|
246
|
+
# Run triage on endpoint
|
|
247
|
+
bash scripts/linux/audit_hardening.sh > /tmp/audit.json
|
|
248
|
+
|
|
249
|
+
# Ingest and normalize into Eva findings
|
|
250
|
+
eva sec ingest /tmp/audit.json --format terminal --format markdown --format sarif
|
|
251
|
+
|
|
252
|
+
# Render consolidated reports across all runs
|
|
253
|
+
eva sec report --format markdown --format sarif
|
|
254
|
+
```
|
|
255
|
+
|
|
256
|
+
## ZAP Rules
|
|
257
|
+
|
|
258
|
+
`eva sec zap` generates or imports an OWASP ZAP Automation Framework YAML plan. The default mode is passive/baseline scanning. Eva does not expose WAF bypass, stealth, brute force, evasion, exploit, or destructive modes.
|
|
259
|
+
|
|
260
|
+
Rate, concurrency, and duration limits live in the scope file and are included in the generated plan where supported by ZAP automation jobs. Keep ZAP policies conservative for shared staging environments.
|
|
261
|
+
|
|
262
|
+
## Artifacts and Audit
|
|
263
|
+
|
|
264
|
+
Each run writes artifacts under:
|
|
265
|
+
|
|
266
|
+
```text
|
|
267
|
+
.eva/artifacts/<run-id>/
|
|
268
|
+
```
|
|
269
|
+
|
|
270
|
+
Eva hashes inputs and generated artifacts with SHA-256 and adds run IDs, scope IDs, tool details, timestamps, artifact paths, and exit status to the existing hash-chained command audit log.
|
|
271
|
+
|
|
272
|
+
## Security Limitations
|
|
273
|
+
|
|
274
|
+
Scanner output, source code, media metadata, file content, and web responses are treated as untrusted. Eva Sec does not send evidence file content to remote LLM prompts. It normalizes summaries and redacted findings by default.
|
|
275
|
+
|
|
276
|
+
Third-party tools are optional. Missing binaries are skipped or reported with install guidance instead of being installed automatically.
|
|
@@ -82,6 +82,6 @@ eva --install-completion
|
|
|
82
82
|
7. **Safe Command Generation**: Natural language command generation via `eva work` with `--dry-run`, `--dry-run-explain`, and safety checks.
|
|
83
83
|
8. **Git & Patch Workflows**: Reviewable diff generation with `eva edit` and automated commit messages via `eva commit-message`.
|
|
84
84
|
9. **Fine-Grained Security Controls**: Path-aware secret redaction, configurable Shannon entropy thresholds, sensitive file allowlists, and SHA-256 hash-chained audit logging.
|
|
85
|
-
10. **
|
|
86
|
-
11. **
|
|
87
|
-
|
|
85
|
+
10. **Authorized Security Assessment & Threat Inspection**: `eva sec` provides defensive YARA scanning and rule precompilation, static binary/malware analysis (ELF, PE, Shannon block entropy, strings/IOCs), threat intelligence enrichment (NIST NVD v2, multi-feed IOC lookups with internal RFC 1918 protection), cross-platform endpoint triage scripts (Windows/Linux), report normalization, and SARIF 2.1.0 generation.
|
|
86
|
+
11. **Plugin Architecture**: Extend Eva with custom commands and providers via `EvaPlugin` subclasses and Python entry points.
|
|
87
|
+
12. **Rust Performance**: Optional `eva-fastwalk` extension for native-speed file discovery.
|