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.
Files changed (272) hide show
  1. {eva_cli-4.3.1 → eva_cli-4.4.0}/.gitignore +2 -0
  2. {eva_cli-4.3.1 → eva_cli-4.4.0}/CHANGELOG.md +31 -0
  3. eva_cli-4.3.1/README.md → eva_cli-4.4.0/PKG-INFO +89 -1
  4. eva_cli-4.3.1/PKG-INFO → eva_cli-4.4.0/README.md +46 -34
  5. {eva_cli-4.3.1 → eva_cli-4.4.0}/docs/README.md +2 -1
  6. {eva_cli-4.3.1 → eva_cli-4.4.0}/docs/command-reference.md +72 -1
  7. eva_cli-4.4.0/docs/eva-sec.md +276 -0
  8. {eva_cli-4.3.1 → eva_cli-4.4.0}/docs/index.md +3 -3
  9. eva_cli-4.4.0/examples/sec/local-repo-assessment.yaml +21 -0
  10. eva_cli-4.4.0/examples/sec/passive-zap-baseline.yaml +12 -0
  11. eva_cli-4.4.0/examples/sec/scope.yaml +12 -0
  12. {eva_cli-4.3.1 → eva_cli-4.4.0}/pyproject.toml +23 -4
  13. eva_cli-4.4.0/scripts/linux/audit_hardening.sh +177 -0
  14. eva_cli-4.4.0/scripts/linux/find_persistence.sh +101 -0
  15. eva_cli-4.4.0/scripts/linux/host_triage.sh +129 -0
  16. eva_cli-4.4.0/scripts/linux/network_triage.sh +103 -0
  17. eva_cli-4.4.0/scripts/linux/security_events.sh +104 -0
  18. eva_cli-4.4.0/scripts/test_vm_matrix.py +1038 -0
  19. eva_cli-4.4.0/scripts/windows/Audit-SystemHardening.ps1 +142 -0
  20. eva_cli-4.4.0/scripts/windows/Audit-UserAccounts.ps1 +103 -0
  21. eva_cli-4.4.0/scripts/windows/Find-SuspiciousPersistence.ps1 +138 -0
  22. eva_cli-4.4.0/scripts/windows/Get-HostTriage.ps1 +180 -0
  23. eva_cli-4.4.0/scripts/windows/Get-NetworkTriage.ps1 +104 -0
  24. eva_cli-4.4.0/scripts/windows/Get-SecurityEvents.ps1 +182 -0
  25. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/__init__.py +1 -1
  26. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/cache/__init__.py +2 -0
  27. eva_cli-4.4.0/src/eva/cache/cache.py +164 -0
  28. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/cli/app.py +2 -0
  29. eva_cli-4.4.0/src/eva/security_tools/__init__.py +6 -0
  30. eva_cli-4.4.0/src/eva/security_tools/aegis.py +382 -0
  31. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/__init__.py +4 -0
  32. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/analysis/__init__.py +0 -0
  33. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/analysis/authenticity.py +159 -0
  34. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/analysis/binary.py +105 -0
  35. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/analysis/metadata.py +94 -0
  36. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/analysis/rich_model.py +407 -0
  37. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/analysis/steganography.py +394 -0
  38. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/analysis/structure_validator.py +512 -0
  39. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/core/__init__.py +0 -0
  40. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/core/audit.py +54 -0
  41. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/core/hashing.py +45 -0
  42. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/core/image_object.py +87 -0
  43. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/core/pipeline.py +35 -0
  44. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/core/signing.py +69 -0
  45. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/core/vault.py +60 -0
  46. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/main.py +668 -0
  47. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/__init__.py +0 -0
  48. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/algorithms/__init__.py +0 -0
  49. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/algorithms/adaptive.py +336 -0
  50. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/algorithms/cost_functions.py +240 -0
  51. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/algorithms/f5_stego.py +406 -0
  52. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/algorithms/j_uniward.py +378 -0
  53. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/algorithms/stc_embed.py +226 -0
  54. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/channels/__init__.py +1 -0
  55. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/channels/metadata_channel.py +392 -0
  56. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/channels/multi_carrier.py +263 -0
  57. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/channels/network_covert.py +702 -0
  58. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/channels/palette_stego.py +291 -0
  59. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/crypto.py +178 -0
  60. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/fs_stego.py +47 -0
  61. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/reporting/__init__.py +0 -0
  62. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/reporting/reports.py +149 -0
  63. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/security/__init__.py +0 -0
  64. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/security/sanitization.py +14 -0
  65. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/security/shredder.py +59 -0
  66. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/security/timestomp.py +32 -0
  67. eva_cli-4.4.0/src/eva/security_tools/base.py +91 -0
  68. eva_cli-4.4.0/src/eva/security_tools/cli.py +1179 -0
  69. eva_cli-4.4.0/src/eva/security_tools/elf_analyzer.py +266 -0
  70. eva_cli-4.4.0/src/eva/security_tools/entropy.py +176 -0
  71. eva_cli-4.4.0/src/eva/security_tools/gitleaks.py +43 -0
  72. eva_cli-4.4.0/src/eva/security_tools/intel_client.py +553 -0
  73. eva_cli-4.4.0/src/eva/security_tools/models.py +98 -0
  74. eva_cli-4.4.0/src/eva/security_tools/normalizers.py +526 -0
  75. eva_cli-4.4.0/src/eva/security_tools/osv.py +33 -0
  76. eva_cli-4.4.0/src/eva/security_tools/pe_analyzer.py +384 -0
  77. eva_cli-4.4.0/src/eva/security_tools/registry.py +63 -0
  78. eva_cli-4.4.0/src/eva/security_tools/report.py +76 -0
  79. eva_cli-4.4.0/src/eva/security_tools/rules/yara/cve_exploits.yar +34 -0
  80. eva_cli-4.4.0/src/eva/security_tools/rules/yara/embedded_pe.yar +47 -0
  81. eva_cli-4.4.0/src/eva/security_tools/rules/yara/obfuscation.yar +36 -0
  82. eva_cli-4.4.0/src/eva/security_tools/rules/yara/suspicious_packers.yar +54 -0
  83. eva_cli-4.4.0/src/eva/security_tools/rules/yara/webshells.yar +62 -0
  84. eva_cli-4.4.0/src/eva/security_tools/runner.py +139 -0
  85. eva_cli-4.4.0/src/eva/security_tools/scope.py +123 -0
  86. eva_cli-4.4.0/src/eva/security_tools/semgrep.py +43 -0
  87. eva_cli-4.4.0/src/eva/security_tools/strings_analyzer.py +214 -0
  88. eva_cli-4.4.0/src/eva/security_tools/syft.py +39 -0
  89. eva_cli-4.4.0/src/eva/security_tools/trivy.py +46 -0
  90. eva_cli-4.4.0/src/eva/security_tools/utils.py +153 -0
  91. eva_cli-4.4.0/src/eva/security_tools/workflow.py +161 -0
  92. eva_cli-4.4.0/src/eva/security_tools/yara_scanner.py +172 -0
  93. eva_cli-4.4.0/src/eva/security_tools/zap.py +116 -0
  94. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/workflows/engine.py +40 -1
  95. eva_cli-4.4.0/tests/unit/cache/test_cache.py +66 -0
  96. eva_cli-4.4.0/tests/unit/security_tools/__init__.py +1 -0
  97. eva_cli-4.4.0/tests/unit/security_tools/test_aegis.py +255 -0
  98. eva_cli-4.4.0/tests/unit/security_tools/test_binary.py +323 -0
  99. eva_cli-4.4.0/tests/unit/security_tools/test_intel.py +206 -0
  100. eva_cli-4.4.0/tests/unit/security_tools/test_normalizers.py +214 -0
  101. eva_cli-4.4.0/tests/unit/security_tools/test_runner.py +158 -0
  102. eva_cli-4.4.0/tests/unit/security_tools/test_scope.py +55 -0
  103. eva_cli-4.4.0/tests/unit/security_tools/test_sec_cli.py +306 -0
  104. eva_cli-4.4.0/tests/unit/security_tools/test_triage_ingest.py +120 -0
  105. eva_cli-4.4.0/tests/unit/security_tools/test_workflow.py +123 -0
  106. eva_cli-4.4.0/tests/unit/security_tools/test_yara.py +117 -0
  107. eva_cli-4.4.0/tests/unit/security_tools/test_zap.py +131 -0
  108. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/workflows/test_workflow_engine.py +11 -0
  109. eva_cli-4.4.0/uv.lock +2724 -0
  110. eva_cli-4.3.1/src/eva/cache/cache.py +0 -40
  111. eva_cli-4.3.1/tests/unit/cache/test_cache.py +0 -22
  112. {eva_cli-4.3.1 → eva_cli-4.4.0}/.github/workflows/ci.yaml +0 -0
  113. {eva_cli-4.3.1 → eva_cli-4.4.0}/.github/workflows/fastwalk-release.yml +0 -0
  114. {eva_cli-4.3.1 → eva_cli-4.4.0}/.github/workflows/release.yml +0 -0
  115. {eva_cli-4.3.1 → eva_cli-4.4.0}/.pre-commit-config.yaml +0 -0
  116. {eva_cli-4.3.1 → eva_cli-4.4.0}/CONTRIBUTING.md +0 -0
  117. {eva_cli-4.3.1 → eva_cli-4.4.0}/Dockerfile +0 -0
  118. {eva_cli-4.3.1 → eva_cli-4.4.0}/LICENSE +0 -0
  119. {eva_cli-4.3.1 → eva_cli-4.4.0}/SECURITY.md +0 -0
  120. {eva_cli-4.3.1 → eva_cli-4.4.0}/assets/demo.gif +0 -0
  121. {eva_cli-4.3.1 → eva_cli-4.4.0}/assets/demo2.gif +0 -0
  122. {eva_cli-4.3.1 → eva_cli-4.4.0}/assets/demo3.gif +0 -0
  123. {eva_cli-4.3.1 → eva_cli-4.4.0}/assets/demo4.gif +0 -0
  124. {eva_cli-4.3.1 → eva_cli-4.4.0}/assets/demo5.gif +0 -0
  125. {eva_cli-4.3.1 → eva_cli-4.4.0}/assets/eva.png +0 -0
  126. {eva_cli-4.3.1 → eva_cli-4.4.0}/docs/architecture.md +0 -0
  127. {eva_cli-4.3.1 → eva_cli-4.4.0}/docs/configuration.md +0 -0
  128. {eva_cli-4.3.1 → eva_cli-4.4.0}/docs/plugins.md +0 -0
  129. {eva_cli-4.3.1 → eva_cli-4.4.0}/docs/provider-behavior.md +0 -0
  130. {eva_cli-4.3.1 → eva_cli-4.4.0}/docs/security-model.md +0 -0
  131. {eva_cli-4.3.1 → eva_cli-4.4.0}/examples/eva-plugin-hello/README.md +0 -0
  132. {eva_cli-4.3.1 → eva_cli-4.4.0}/examples/eva-plugin-hello/eva_plugin_hello.py +0 -0
  133. {eva_cli-4.3.1 → eva_cli-4.4.0}/examples/eva-plugin-hello/pyproject.toml +0 -0
  134. {eva_cli-4.3.1 → eva_cli-4.4.0}/install.sh +0 -0
  135. {eva_cli-4.3.1 → eva_cli-4.4.0}/rust/eva_fastwalk/Cargo.lock +0 -0
  136. {eva_cli-4.3.1 → eva_cli-4.4.0}/rust/eva_fastwalk/Cargo.toml +0 -0
  137. {eva_cli-4.3.1 → eva_cli-4.4.0}/rust/eva_fastwalk/pyproject.toml +0 -0
  138. {eva_cli-4.3.1 → eva_cli-4.4.0}/rust/eva_fastwalk/src/lib.rs +0 -0
  139. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/agent/__init__.py +0 -0
  140. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/agent/loop.py +0 -0
  141. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/agent/tools.py +0 -0
  142. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/cli/__init__.py +0 -0
  143. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/cli.py +0 -0
  144. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/config/__init__.py +0 -0
  145. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/config/config.py +0 -0
  146. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/indexing/__init__.py +0 -0
  147. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/indexing/finder.py +0 -0
  148. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/indexing/io.py +0 -0
  149. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/indexing/packer.py +0 -0
  150. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/indexing/repo_index.py +0 -0
  151. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/indexing/tokenizer.py +0 -0
  152. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/indexing/tree.py +0 -0
  153. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/plugins/__init__.py +0 -0
  154. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/plugins/loader.py +0 -0
  155. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/plugins/protocol.py +0 -0
  156. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/prompts/__init__.py +0 -0
  157. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/providers/__init__.py +0 -0
  158. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/providers/gemini_provider.py +0 -0
  159. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/providers/groq_provider.py +0 -0
  160. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/providers/llamacpp_provider.py +0 -0
  161. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/providers/ollama_provider.py +0 -0
  162. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/providers/openai_compat.py +0 -0
  163. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/providers/opencode_zen_provider.py +0 -0
  164. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/providers/openrouter_provider.py +0 -0
  165. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/replay/__init__.py +0 -0
  166. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/replay/crypto.py +0 -0
  167. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/replay/player.py +0 -0
  168. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/replay/recorder.py +0 -0
  169. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/security/__init__.py +0 -0
  170. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/security/audit.py +0 -0
  171. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/security/redaction.py +0 -0
  172. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/security/sandbox.py +0 -0
  173. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/security/sensitive_files.py +0 -0
  174. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/security/work_safety.py +0 -0
  175. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/shell/__init__.py +0 -0
  176. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/shell/runner.py +0 -0
  177. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/telemetry/__init__.py +0 -0
  178. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/telemetry/diagnostics.py +0 -0
  179. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/telemetry/metrics.py +0 -0
  180. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/ui/__init__.py +0 -0
  181. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/ui/formatter.py +0 -0
  182. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/ui/output.py +0 -0
  183. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/ui/streaming.py +0 -0
  184. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/workflows/__init__.py +0 -0
  185. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/workflows/budget.py +0 -0
  186. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/workflows/builtins/dependency_audit.yaml +0 -0
  187. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/workflows/builtins/repo_health.yaml +0 -0
  188. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/workflows/builtins/security_scan.yaml +0 -0
  189. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/workflows/chat_session.py +0 -0
  190. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/workspace/__init__.py +0 -0
  191. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/workspace/git_ops.py +0 -0
  192. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/workspace/gitignore.py +0 -0
  193. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/workspace/project_context.py +0 -0
  194. {eva_cli-4.3.1 → eva_cli-4.4.0}/src/eva/workspace/session.py +0 -0
  195. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/conftest.py +0 -0
  196. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/fixtures/golden/patches/sample1_expected.diff +0 -0
  197. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/fixtures/golden/patches/sample1_fenced.txt +0 -0
  198. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/fixtures/golden/prompts/analyze_system_prompt.txt +0 -0
  199. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/fixtures/golden/prompts/ask_system_prompt.txt +0 -0
  200. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/fixtures/golden/prompts/changes_system_prompt.txt +0 -0
  201. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/fixtures/golden/prompts/chat_system_prompt.txt +0 -0
  202. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/fixtures/golden/prompts/commit_system_prompt.txt +0 -0
  203. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/fixtures/golden/prompts/edit_system_prompt.txt +0 -0
  204. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/fixtures/golden/prompts/explain_system_prompt.txt +0 -0
  205. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/fixtures/golden/prompts/work_system_prompt.txt +0 -0
  206. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/test_basic.py +0 -0
  207. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/__init__.py +0 -0
  208. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/agent/test_loop.py +0 -0
  209. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/agent/test_tools.py +0 -0
  210. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/cache/__init__.py +0 -0
  211. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/cli/__init__.py +0 -0
  212. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/cli/test_ask_repo.py +0 -0
  213. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/cli/test_changes_command.py +0 -0
  214. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/cli/test_cli.py +0 -0
  215. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/cli/test_cli_commands.py +0 -0
  216. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/cli/test_cli_coverage.py +0 -0
  217. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/cli/test_cli_more.py +0 -0
  218. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/cli/test_investigate.py +0 -0
  219. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/cli/test_output_format.py +0 -0
  220. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/config/__init__.py +0 -0
  221. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/config/test_config.py +0 -0
  222. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/config/test_config_keys.py +0 -0
  223. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/golden/__init__.py +0 -0
  224. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/golden/test_golden_patches.py +0 -0
  225. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/golden/test_golden_prompts.py +0 -0
  226. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/indexing/__init__.py +0 -0
  227. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/indexing/test_indexing.py +0 -0
  228. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/indexing/test_indexing_more.py +0 -0
  229. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/indexing/test_packer.py +0 -0
  230. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/indexing/test_repo_index.py +0 -0
  231. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/indexing/test_tokenizer_offline.py +0 -0
  232. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/plugins/__init__.py +0 -0
  233. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/plugins/test_plugins.py +0 -0
  234. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/providers/__init__.py +0 -0
  235. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/providers/test_context_budget.py +0 -0
  236. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/providers/test_dispatch_caching.py +0 -0
  237. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/providers/test_gemini_tools.py +0 -0
  238. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/providers/test_offline_providers.py +0 -0
  239. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/providers/test_openai_compat_tools.py +0 -0
  240. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/providers/test_provider_coverage.py +0 -0
  241. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/providers/test_provider_errors.py +0 -0
  242. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/providers/test_provider_tools_protocol.py +0 -0
  243. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/providers/test_providers.py +0 -0
  244. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/providers/test_providers_more.py +0 -0
  245. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/providers/test_repo_caching.py +0 -0
  246. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/replay/test_replay.py +0 -0
  247. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/security/__init__.py +0 -0
  248. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/security/test_allowlist_cli.py +0 -0
  249. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/security/test_audit.py +0 -0
  250. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/security/test_audit_chain.py +0 -0
  251. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/security/test_redaction.py +0 -0
  252. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/security/test_safety_audit.py +0 -0
  253. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/security/test_sandbox.py +0 -0
  254. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/security/test_sensitive_files_config.py +0 -0
  255. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/security/test_work_safety.py +0 -0
  256. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/shell/__init__.py +0 -0
  257. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/shell/test_shell.py +0 -0
  258. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/telemetry/__init__.py +0 -0
  259. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/telemetry/test_metrics.py +0 -0
  260. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/telemetry/test_telemetry.py +0 -0
  261. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/test_compatibility_imports.py +0 -0
  262. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/ui/__init__.py +0 -0
  263. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/ui/test_ui.py +0 -0
  264. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/workflows/__init__.py +0 -0
  265. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/workflows/test_chat_session.py +0 -0
  266. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/workflows/test_workflows.py +0 -0
  267. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/workspace/__init__.py +0 -0
  268. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/workspace/test_git_ops.py +0 -0
  269. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/workspace/test_gitignore_config.py +0 -0
  270. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/workspace/test_project_context.py +0 -0
  271. {eva_cli-4.3.1 → eva_cli-4.4.0}/tests/unit/workspace/test_session_workspace.py +0 -0
  272. {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.2.1**.
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. **Plugin Architecture**: Extend Eva with custom commands and providers via `EvaPlugin` subclasses and Python entry points.
86
- 11. **Rust Performance**: Optional `eva-fastwalk` extension for native-speed file discovery.
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.