eva-cli 4.3.1__tar.gz → 4.4.1__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 (292) hide show
  1. {eva_cli-4.3.1 → eva_cli-4.4.1}/.gitignore +2 -0
  2. {eva_cli-4.3.1 → eva_cli-4.4.1}/CHANGELOG.md +48 -0
  3. eva_cli-4.3.1/README.md → eva_cli-4.4.1/PKG-INFO +89 -1
  4. eva_cli-4.3.1/PKG-INFO → eva_cli-4.4.1/README.md +46 -34
  5. {eva_cli-4.3.1 → eva_cli-4.4.1}/docs/README.md +2 -1
  6. {eva_cli-4.3.1 → eva_cli-4.4.1}/docs/command-reference.md +72 -1
  7. eva_cli-4.4.1/docs/eva-sec.md +278 -0
  8. {eva_cli-4.3.1 → eva_cli-4.4.1}/docs/index.md +3 -3
  9. eva_cli-4.4.1/examples/sec/local-repo-assessment.yaml +21 -0
  10. eva_cli-4.4.1/examples/sec/passive-zap-baseline.yaml +12 -0
  11. eva_cli-4.4.1/examples/sec/scope.yaml +12 -0
  12. eva_cli-4.4.1/install.sh +99 -0
  13. {eva_cli-4.3.1 → eva_cli-4.4.1}/pyproject.toml +23 -4
  14. eva_cli-4.4.1/scripts/linux/audit_hardening.sh +177 -0
  15. eva_cli-4.4.1/scripts/linux/find_persistence.sh +101 -0
  16. eva_cli-4.4.1/scripts/linux/host_triage.sh +129 -0
  17. eva_cli-4.4.1/scripts/linux/network_triage.sh +103 -0
  18. eva_cli-4.4.1/scripts/linux/security_events.sh +104 -0
  19. eva_cli-4.4.1/scripts/test_vm_matrix.py +1038 -0
  20. eva_cli-4.4.1/scripts/windows/Audit-SystemHardening.ps1 +142 -0
  21. eva_cli-4.4.1/scripts/windows/Audit-UserAccounts.ps1 +103 -0
  22. eva_cli-4.4.1/scripts/windows/Find-SuspiciousPersistence.ps1 +138 -0
  23. eva_cli-4.4.1/scripts/windows/Get-HostTriage.ps1 +180 -0
  24. eva_cli-4.4.1/scripts/windows/Get-NetworkTriage.ps1 +104 -0
  25. eva_cli-4.4.1/scripts/windows/Get-SecurityEvents.ps1 +182 -0
  26. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/__init__.py +1 -1
  27. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/cache/__init__.py +2 -0
  28. eva_cli-4.4.1/src/eva/cache/cache.py +164 -0
  29. eva_cli-4.4.1/src/eva/cli/app.py +169 -0
  30. eva_cli-4.4.1/src/eva/cli/commands/__init__.py +1 -0
  31. eva_cli-4.4.1/src/eva/cli/commands/ask.py +370 -0
  32. eva_cli-4.4.1/src/eva/cli/commands/budget.py +53 -0
  33. eva_cli-4.4.1/src/eva/cli/commands/cache_cmd.py +16 -0
  34. eva_cli-4.4.1/src/eva/cli/commands/chat.py +19 -0
  35. eva_cli-4.4.1/src/eva/cli/commands/config_cmd.py +437 -0
  36. eva_cli-4.4.1/src/eva/cli/commands/context.py +20 -0
  37. eva_cli-4.4.1/src/eva/cli/commands/edit.py +136 -0
  38. eva_cli-4.4.1/src/eva/cli/commands/security.py +29 -0
  39. eva_cli-4.4.1/src/eva/cli/commands/work.py +240 -0
  40. eva_cli-4.4.1/src/eva/cli/commands/workflow.py +86 -0
  41. eva_cli-4.4.1/src/eva/cli/commands/workspace.py +123 -0
  42. eva_cli-4.4.1/src/eva/cli/helpers.py +45 -0
  43. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/config/config.py +12 -2
  44. eva_cli-4.4.1/src/eva/indexing/__init__.py +41 -0
  45. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/providers/__init__.py +20 -10
  46. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/providers/gemini_provider.py +28 -3
  47. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/providers/openai_compat.py +24 -3
  48. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/providers/opencode_zen_provider.py +2 -2
  49. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/providers/openrouter_provider.py +2 -2
  50. eva_cli-4.4.1/src/eva/security/__init__.py +53 -0
  51. eva_cli-4.4.1/src/eva/security_tools/__init__.py +6 -0
  52. eva_cli-4.4.1/src/eva/security_tools/aegis.py +382 -0
  53. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/__init__.py +4 -0
  54. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/analysis/__init__.py +0 -0
  55. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/analysis/authenticity.py +159 -0
  56. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/analysis/binary.py +105 -0
  57. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/analysis/metadata.py +94 -0
  58. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/analysis/rich_model.py +407 -0
  59. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/analysis/steganography.py +394 -0
  60. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/analysis/structure_validator.py +512 -0
  61. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/core/__init__.py +0 -0
  62. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/core/audit.py +54 -0
  63. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/core/hashing.py +45 -0
  64. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/core/image_object.py +87 -0
  65. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/core/pipeline.py +35 -0
  66. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/core/signing.py +69 -0
  67. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/core/vault.py +60 -0
  68. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/main.py +668 -0
  69. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/offensive/__init__.py +0 -0
  70. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/offensive/algorithms/__init__.py +0 -0
  71. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/offensive/algorithms/adaptive.py +336 -0
  72. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/offensive/algorithms/cost_functions.py +240 -0
  73. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/offensive/algorithms/f5_stego.py +406 -0
  74. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/offensive/algorithms/j_uniward.py +378 -0
  75. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/offensive/algorithms/stc_embed.py +226 -0
  76. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/offensive/channels/__init__.py +1 -0
  77. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/offensive/channels/metadata_channel.py +392 -0
  78. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/offensive/channels/multi_carrier.py +263 -0
  79. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/offensive/channels/network_covert.py +702 -0
  80. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/offensive/channels/palette_stego.py +291 -0
  81. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/offensive/crypto.py +178 -0
  82. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/offensive/fs_stego.py +47 -0
  83. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/reporting/__init__.py +0 -0
  84. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/reporting/reports.py +149 -0
  85. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/security/__init__.py +0 -0
  86. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/security/sanitization.py +14 -0
  87. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/security/shredder.py +59 -0
  88. eva_cli-4.4.1/src/eva/security_tools/aegis_engine/security/timestomp.py +32 -0
  89. eva_cli-4.4.1/src/eva/security_tools/base.py +91 -0
  90. eva_cli-4.4.1/src/eva/security_tools/cli.py +1179 -0
  91. eva_cli-4.4.1/src/eva/security_tools/elf_analyzer.py +266 -0
  92. eva_cli-4.4.1/src/eva/security_tools/entropy.py +176 -0
  93. eva_cli-4.4.1/src/eva/security_tools/gitleaks.py +43 -0
  94. eva_cli-4.4.1/src/eva/security_tools/intel_client.py +553 -0
  95. eva_cli-4.4.1/src/eva/security_tools/models.py +98 -0
  96. eva_cli-4.4.1/src/eva/security_tools/normalizers.py +526 -0
  97. eva_cli-4.4.1/src/eva/security_tools/osv.py +33 -0
  98. eva_cli-4.4.1/src/eva/security_tools/pe_analyzer.py +384 -0
  99. eva_cli-4.4.1/src/eva/security_tools/registry.py +63 -0
  100. eva_cli-4.4.1/src/eva/security_tools/report.py +76 -0
  101. eva_cli-4.4.1/src/eva/security_tools/rules/yara/aegis_offensive_artifacts.yar +50 -0
  102. eva_cli-4.4.1/src/eva/security_tools/rules/yara/cve_exploits.yar +34 -0
  103. eva_cli-4.4.1/src/eva/security_tools/rules/yara/embedded_pe.yar +47 -0
  104. eva_cli-4.4.1/src/eva/security_tools/rules/yara/obfuscation.yar +36 -0
  105. eva_cli-4.4.1/src/eva/security_tools/rules/yara/suspicious_packers.yar +54 -0
  106. eva_cli-4.4.1/src/eva/security_tools/rules/yara/webshells.yar +62 -0
  107. eva_cli-4.4.1/src/eva/security_tools/runner.py +139 -0
  108. eva_cli-4.4.1/src/eva/security_tools/scope.py +123 -0
  109. eva_cli-4.4.1/src/eva/security_tools/semgrep.py +43 -0
  110. eva_cli-4.4.1/src/eva/security_tools/strings_analyzer.py +214 -0
  111. eva_cli-4.4.1/src/eva/security_tools/syft.py +39 -0
  112. eva_cli-4.4.1/src/eva/security_tools/trivy.py +46 -0
  113. eva_cli-4.4.1/src/eva/security_tools/utils.py +153 -0
  114. eva_cli-4.4.1/src/eva/security_tools/workflow.py +161 -0
  115. eva_cli-4.4.1/src/eva/security_tools/yara_scanner.py +172 -0
  116. eva_cli-4.4.1/src/eva/security_tools/zap.py +116 -0
  117. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/workflows/builtins/security_scan.yaml +1 -1
  118. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/workflows/engine.py +40 -1
  119. eva_cli-4.4.1/src/eva/workspace/__init__.py +57 -0
  120. eva_cli-4.4.1/tests/unit/cache/test_cache.py +66 -0
  121. eva_cli-4.4.1/tests/unit/cli/test_lazy_startup.py +34 -0
  122. eva_cli-4.4.1/tests/unit/security_tools/__init__.py +1 -0
  123. eva_cli-4.4.1/tests/unit/security_tools/test_aegis.py +255 -0
  124. eva_cli-4.4.1/tests/unit/security_tools/test_binary.py +323 -0
  125. eva_cli-4.4.1/tests/unit/security_tools/test_intel.py +206 -0
  126. eva_cli-4.4.1/tests/unit/security_tools/test_normalizers.py +214 -0
  127. eva_cli-4.4.1/tests/unit/security_tools/test_runner.py +158 -0
  128. eva_cli-4.4.1/tests/unit/security_tools/test_scope.py +55 -0
  129. eva_cli-4.4.1/tests/unit/security_tools/test_sec_cli.py +306 -0
  130. eva_cli-4.4.1/tests/unit/security_tools/test_triage_ingest.py +120 -0
  131. eva_cli-4.4.1/tests/unit/security_tools/test_workflow.py +123 -0
  132. eva_cli-4.4.1/tests/unit/security_tools/test_yara.py +117 -0
  133. eva_cli-4.4.1/tests/unit/security_tools/test_zap.py +131 -0
  134. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/workflows/test_workflow_engine.py +11 -0
  135. eva_cli-4.4.1/uv.lock +2724 -0
  136. eva_cli-4.3.1/install.sh +0 -59
  137. eva_cli-4.3.1/src/eva/cache/cache.py +0 -40
  138. eva_cli-4.3.1/src/eva/cli/app.py +0 -1420
  139. eva_cli-4.3.1/src/eva/indexing/__init__.py +0 -21
  140. eva_cli-4.3.1/src/eva/security/__init__.py +0 -41
  141. eva_cli-4.3.1/src/eva/workspace/__init__.py +0 -48
  142. eva_cli-4.3.1/tests/unit/cache/test_cache.py +0 -22
  143. {eva_cli-4.3.1 → eva_cli-4.4.1}/.github/workflows/ci.yaml +0 -0
  144. {eva_cli-4.3.1 → eva_cli-4.4.1}/.github/workflows/fastwalk-release.yml +0 -0
  145. {eva_cli-4.3.1 → eva_cli-4.4.1}/.github/workflows/release.yml +0 -0
  146. {eva_cli-4.3.1 → eva_cli-4.4.1}/.pre-commit-config.yaml +0 -0
  147. {eva_cli-4.3.1 → eva_cli-4.4.1}/CONTRIBUTING.md +0 -0
  148. {eva_cli-4.3.1 → eva_cli-4.4.1}/Dockerfile +0 -0
  149. {eva_cli-4.3.1 → eva_cli-4.4.1}/LICENSE +0 -0
  150. {eva_cli-4.3.1 → eva_cli-4.4.1}/SECURITY.md +0 -0
  151. {eva_cli-4.3.1 → eva_cli-4.4.1}/assets/demo.gif +0 -0
  152. {eva_cli-4.3.1 → eva_cli-4.4.1}/assets/demo2.gif +0 -0
  153. {eva_cli-4.3.1 → eva_cli-4.4.1}/assets/demo3.gif +0 -0
  154. {eva_cli-4.3.1 → eva_cli-4.4.1}/assets/demo4.gif +0 -0
  155. {eva_cli-4.3.1 → eva_cli-4.4.1}/assets/demo5.gif +0 -0
  156. {eva_cli-4.3.1 → eva_cli-4.4.1}/assets/eva.png +0 -0
  157. {eva_cli-4.3.1 → eva_cli-4.4.1}/docs/architecture.md +0 -0
  158. {eva_cli-4.3.1 → eva_cli-4.4.1}/docs/configuration.md +0 -0
  159. {eva_cli-4.3.1 → eva_cli-4.4.1}/docs/plugins.md +0 -0
  160. {eva_cli-4.3.1 → eva_cli-4.4.1}/docs/provider-behavior.md +0 -0
  161. {eva_cli-4.3.1 → eva_cli-4.4.1}/docs/security-model.md +0 -0
  162. {eva_cli-4.3.1 → eva_cli-4.4.1}/examples/eva-plugin-hello/README.md +0 -0
  163. {eva_cli-4.3.1 → eva_cli-4.4.1}/examples/eva-plugin-hello/eva_plugin_hello.py +0 -0
  164. {eva_cli-4.3.1 → eva_cli-4.4.1}/examples/eva-plugin-hello/pyproject.toml +0 -0
  165. {eva_cli-4.3.1 → eva_cli-4.4.1}/rust/eva_fastwalk/Cargo.lock +0 -0
  166. {eva_cli-4.3.1 → eva_cli-4.4.1}/rust/eva_fastwalk/Cargo.toml +0 -0
  167. {eva_cli-4.3.1 → eva_cli-4.4.1}/rust/eva_fastwalk/pyproject.toml +0 -0
  168. {eva_cli-4.3.1 → eva_cli-4.4.1}/rust/eva_fastwalk/src/lib.rs +0 -0
  169. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/agent/__init__.py +0 -0
  170. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/agent/loop.py +0 -0
  171. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/agent/tools.py +0 -0
  172. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/cli/__init__.py +0 -0
  173. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/cli.py +0 -0
  174. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/config/__init__.py +0 -0
  175. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/indexing/finder.py +0 -0
  176. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/indexing/io.py +0 -0
  177. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/indexing/packer.py +0 -0
  178. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/indexing/repo_index.py +0 -0
  179. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/indexing/tokenizer.py +0 -0
  180. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/indexing/tree.py +0 -0
  181. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/plugins/__init__.py +0 -0
  182. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/plugins/loader.py +0 -0
  183. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/plugins/protocol.py +0 -0
  184. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/prompts/__init__.py +0 -0
  185. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/providers/groq_provider.py +0 -0
  186. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/providers/llamacpp_provider.py +0 -0
  187. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/providers/ollama_provider.py +0 -0
  188. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/replay/__init__.py +0 -0
  189. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/replay/crypto.py +0 -0
  190. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/replay/player.py +0 -0
  191. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/replay/recorder.py +0 -0
  192. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/security/audit.py +0 -0
  193. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/security/redaction.py +0 -0
  194. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/security/sandbox.py +0 -0
  195. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/security/sensitive_files.py +0 -0
  196. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/security/work_safety.py +0 -0
  197. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/shell/__init__.py +0 -0
  198. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/shell/runner.py +0 -0
  199. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/telemetry/__init__.py +0 -0
  200. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/telemetry/diagnostics.py +0 -0
  201. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/telemetry/metrics.py +0 -0
  202. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/ui/__init__.py +0 -0
  203. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/ui/formatter.py +0 -0
  204. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/ui/output.py +0 -0
  205. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/ui/streaming.py +0 -0
  206. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/workflows/__init__.py +0 -0
  207. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/workflows/budget.py +0 -0
  208. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/workflows/builtins/dependency_audit.yaml +0 -0
  209. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/workflows/builtins/repo_health.yaml +0 -0
  210. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/workflows/chat_session.py +0 -0
  211. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/workspace/git_ops.py +0 -0
  212. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/workspace/gitignore.py +0 -0
  213. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/workspace/project_context.py +0 -0
  214. {eva_cli-4.3.1 → eva_cli-4.4.1}/src/eva/workspace/session.py +0 -0
  215. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/conftest.py +0 -0
  216. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/fixtures/golden/patches/sample1_expected.diff +0 -0
  217. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/fixtures/golden/patches/sample1_fenced.txt +0 -0
  218. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/fixtures/golden/prompts/analyze_system_prompt.txt +0 -0
  219. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/fixtures/golden/prompts/ask_system_prompt.txt +0 -0
  220. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/fixtures/golden/prompts/changes_system_prompt.txt +0 -0
  221. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/fixtures/golden/prompts/chat_system_prompt.txt +0 -0
  222. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/fixtures/golden/prompts/commit_system_prompt.txt +0 -0
  223. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/fixtures/golden/prompts/edit_system_prompt.txt +0 -0
  224. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/fixtures/golden/prompts/explain_system_prompt.txt +0 -0
  225. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/fixtures/golden/prompts/work_system_prompt.txt +0 -0
  226. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/test_basic.py +0 -0
  227. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/__init__.py +0 -0
  228. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/agent/test_loop.py +0 -0
  229. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/agent/test_tools.py +0 -0
  230. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/cache/__init__.py +0 -0
  231. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/cli/__init__.py +0 -0
  232. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/cli/test_ask_repo.py +0 -0
  233. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/cli/test_changes_command.py +0 -0
  234. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/cli/test_cli.py +0 -0
  235. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/cli/test_cli_commands.py +0 -0
  236. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/cli/test_cli_coverage.py +0 -0
  237. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/cli/test_cli_more.py +0 -0
  238. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/cli/test_investigate.py +0 -0
  239. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/cli/test_output_format.py +0 -0
  240. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/config/__init__.py +0 -0
  241. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/config/test_config.py +0 -0
  242. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/config/test_config_keys.py +0 -0
  243. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/golden/__init__.py +0 -0
  244. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/golden/test_golden_patches.py +0 -0
  245. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/golden/test_golden_prompts.py +0 -0
  246. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/indexing/__init__.py +0 -0
  247. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/indexing/test_indexing.py +0 -0
  248. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/indexing/test_indexing_more.py +0 -0
  249. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/indexing/test_packer.py +0 -0
  250. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/indexing/test_repo_index.py +0 -0
  251. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/indexing/test_tokenizer_offline.py +0 -0
  252. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/plugins/__init__.py +0 -0
  253. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/plugins/test_plugins.py +0 -0
  254. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/providers/__init__.py +0 -0
  255. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/providers/test_context_budget.py +0 -0
  256. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/providers/test_dispatch_caching.py +0 -0
  257. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/providers/test_gemini_tools.py +0 -0
  258. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/providers/test_offline_providers.py +0 -0
  259. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/providers/test_openai_compat_tools.py +0 -0
  260. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/providers/test_provider_coverage.py +0 -0
  261. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/providers/test_provider_errors.py +0 -0
  262. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/providers/test_provider_tools_protocol.py +0 -0
  263. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/providers/test_providers.py +0 -0
  264. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/providers/test_providers_more.py +0 -0
  265. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/providers/test_repo_caching.py +0 -0
  266. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/replay/test_replay.py +0 -0
  267. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/security/__init__.py +0 -0
  268. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/security/test_allowlist_cli.py +0 -0
  269. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/security/test_audit.py +0 -0
  270. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/security/test_audit_chain.py +0 -0
  271. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/security/test_redaction.py +0 -0
  272. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/security/test_safety_audit.py +0 -0
  273. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/security/test_sandbox.py +0 -0
  274. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/security/test_sensitive_files_config.py +0 -0
  275. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/security/test_work_safety.py +0 -0
  276. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/shell/__init__.py +0 -0
  277. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/shell/test_shell.py +0 -0
  278. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/telemetry/__init__.py +0 -0
  279. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/telemetry/test_metrics.py +0 -0
  280. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/telemetry/test_telemetry.py +0 -0
  281. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/test_compatibility_imports.py +0 -0
  282. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/ui/__init__.py +0 -0
  283. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/ui/test_ui.py +0 -0
  284. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/workflows/__init__.py +0 -0
  285. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/workflows/test_chat_session.py +0 -0
  286. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/workflows/test_workflows.py +0 -0
  287. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/workspace/__init__.py +0 -0
  288. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/workspace/test_git_ops.py +0 -0
  289. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/workspace/test_gitignore_config.py +0 -0
  290. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/workspace/test_project_context.py +0 -0
  291. {eva_cli-4.3.1 → eva_cli-4.4.1}/tests/unit/workspace/test_session_workspace.py +0 -0
  292. {eva_cli-4.3.1 → eva_cli-4.4.1}/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,54 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
 
9
9
 
10
+ ## [4.4.1] - 2026-10-03
11
+
12
+ ### Changed
13
+ - **CLI Startup Performance Optimization (~15x Faster Cold Launch):**
14
+ - Eliminated eager top-level imports of heavy LLM SDKs (`google.genai`, `openai`), security analyzers (`yara`, `pefile`, `pyelftools`, `aegis`), and `keyring` across the CLI startup path, reducing `eva --help` and `eva --version` startup latency from ~6.0s to <0.4s.
15
+ - Moved plugin discovery (`load_plugins(app)`) from module import scope into the `@app.callback()` runtime hook in `src/eva/cli/app.py`.
16
+ - Wrapped `eva sec` in a lazy Click group (`_LazySecGroup` in `src/eva/cli/commands/security.py`) so `eva.security_tools.cli` is only imported when `eva sec` subcommands are invoked.
17
+ - Replaced eager provider registration in `src/eva/providers/__init__.py` with a lazy `PROVIDER_MAP` registry that loads provider modules on first request, and deferred `google.genai`, `openai`, and `httpx` client imports until generation/model-listing time.
18
+ - Added lazy `__getattr__` package exports in `eva.indexing`, `eva.security`, and `eva.workspace`, and deferred `keyring` backend imports in `src/eva/config/config.py`.
19
+ - **Phase 0 CLI Foundation Refactoring (`src/eva/cli/`):**
20
+ - Decomposed the monolithic 1,423-line `src/eva/cli/app.py` into per-domain command modules under `src/eva/cli/commands/` (`ask.py`, `chat.py`, `work.py`, `edit.py`, `context.py`, `config_cmd.py`, `budget.py`, `cache_cmd.py`, `workflow.py`, `workspace.py`, `security.py`) and shared utilities in `src/eva/cli/helpers.py`.
21
+ - Preserved full backward compatibility for module-level attribute access and test monkeypatching on `eva.cli.app` via PEP 562 `__getattr__`.
22
+
23
+ ### Fixed
24
+ - **Built-in `security_scan` Workflow (`src/eva/workflows/builtins/security_scan.yaml`):**
25
+ - Removed the disallowed `|| true` shell control operator from the `Scan Config Key Patterns` step so `eva workflow run security_scan` passes strict argv safety validation.
26
+
27
+ ## [4.4.0] - 2026-09-18
28
+
29
+ ### Added
30
+ - **Defensive YARA Scanning & Rule Precompilation (`eva sec yara`):**
31
+ - 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>`).
32
+ - Curated baseline defensive rule set in `src/eva/security_tools/rules/yara/`:
33
+ - `webshells.yar`: Detects PHP, JSP, ASPX webshell execution primitives, `eval(base64_decode(...))`, and droppers.
34
+ - `suspicious_packers.yar`: Signatures for UPX, ASPack, Themida, and PECompact.
35
+ - `embedded_pe.yar`: Detects embedded Windows PE executables inside documents (PDF) and images (PNG, JPEG, GIF) with DOS stub validation.
36
+ - `obfuscation.yar`: Detects obfuscated PowerShell execution flags (`-w hidden -enc`, `DownloadString`, `IEX`) and base64 encoded binaries.
37
+ - `cve_exploits.yar`: Signatures for Log4j JNDI lookups and generic reverse shell commands.
38
+ - Normalizes rule matches into Eva's unified `Finding` schema with exact matched strings and byte offsets as evidence.
39
+ - Full multi-format report exports: Terminal table, JSON, Markdown, and SARIF 2.1.0 (`$schema: .../sarif-schema-2.1.0.json`).
40
+ - **Static Binary & Malware Analysis (`eva sec binary`):**
41
+ - `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).
42
+ - `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.
43
+ - `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.
44
+ - `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).
45
+ - Resilient, non-crashing parser design: graceful error handling and structured `malformed` findings for truncated/corrupt headers.
46
+ - **Threat Intelligence Enrichment (`eva sec intel`):**
47
+ - `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.
48
+ - `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.
49
+ - **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.
50
+ - `eva sec intel extract <target>`: Unstructured log/text parsing with IOC deduplication, domain false-positive filtering (`localhost`, `.internal`, `.local`), and secret redaction.
51
+ - **Cross-Platform Endpoint Triage Scripts (`scripts/`):**
52
+ - **Windows PowerShell Suite** (`scripts/windows/`): `Get-HostTriage.ps1`, `Audit-SystemHardening.ps1`, `Get-SecurityEvents.ps1`, `Find-SuspiciousPersistence.ps1`, `Audit-UserAccounts.ps1`, `Get-NetworkTriage.ps1`.
53
+ - **Linux POSIX Shell Suite** (`scripts/linux/`): Zero-dependency scripts `host_triage.sh`, `audit_hardening.sh`, `find_persistence.sh`, `security_events.sh`, `network_triage.sh`.
54
+ - Ingestable via `eva sec ingest <file.json>` and reportable via `eva sec report`.
55
+ - **Validation on Live Arch Linux VM:**
56
+ - 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.
57
+
10
58
  ## [4.3.1] - 2026-08-15
11
59
 
12
60
  ### Added
@@ -1,3 +1,46 @@
1
+ Metadata-Version: 2.5
2
+ Name: eva-cli
3
+ Version: 4.4.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: 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.1**.
@@ -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
-