eva-cli 4.2.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 (274) hide show
  1. {eva_cli-4.2.1 → eva_cli-4.4.0}/.gitignore +2 -0
  2. {eva_cli-4.2.1 → eva_cli-4.4.0}/CHANGELOG.md +55 -0
  3. eva_cli-4.2.1/README.md → eva_cli-4.4.0/PKG-INFO +107 -3
  4. eva_cli-4.2.1/PKG-INFO → eva_cli-4.4.0/README.md +64 -36
  5. {eva_cli-4.2.1 → eva_cli-4.4.0}/SECURITY.md +13 -4
  6. {eva_cli-4.2.1 → eva_cli-4.4.0}/docs/README.md +2 -1
  7. eva_cli-4.4.0/docs/command-reference.md +321 -0
  8. {eva_cli-4.2.1 → eva_cli-4.4.0}/docs/configuration.md +66 -0
  9. eva_cli-4.4.0/docs/eva-sec.md +276 -0
  10. {eva_cli-4.2.1 → eva_cli-4.4.0}/docs/index.md +11 -7
  11. {eva_cli-4.2.1 → eva_cli-4.4.0}/docs/security-model.md +10 -5
  12. eva_cli-4.4.0/examples/sec/local-repo-assessment.yaml +21 -0
  13. eva_cli-4.4.0/examples/sec/passive-zap-baseline.yaml +12 -0
  14. eva_cli-4.4.0/examples/sec/scope.yaml +12 -0
  15. {eva_cli-4.2.1 → eva_cli-4.4.0}/pyproject.toml +24 -5
  16. {eva_cli-4.2.1 → eva_cli-4.4.0}/rust/eva_fastwalk/Cargo.lock +16 -123
  17. {eva_cli-4.2.1 → eva_cli-4.4.0}/rust/eva_fastwalk/Cargo.toml +2 -1
  18. {eva_cli-4.2.1 → eva_cli-4.4.0}/rust/eva_fastwalk/src/lib.rs +2 -1
  19. eva_cli-4.4.0/scripts/linux/audit_hardening.sh +177 -0
  20. eva_cli-4.4.0/scripts/linux/find_persistence.sh +101 -0
  21. eva_cli-4.4.0/scripts/linux/host_triage.sh +129 -0
  22. eva_cli-4.4.0/scripts/linux/network_triage.sh +103 -0
  23. eva_cli-4.4.0/scripts/linux/security_events.sh +104 -0
  24. eva_cli-4.4.0/scripts/test_vm_matrix.py +1038 -0
  25. eva_cli-4.4.0/scripts/windows/Audit-SystemHardening.ps1 +142 -0
  26. eva_cli-4.4.0/scripts/windows/Audit-UserAccounts.ps1 +103 -0
  27. eva_cli-4.4.0/scripts/windows/Find-SuspiciousPersistence.ps1 +138 -0
  28. eva_cli-4.4.0/scripts/windows/Get-HostTriage.ps1 +180 -0
  29. eva_cli-4.4.0/scripts/windows/Get-NetworkTriage.ps1 +104 -0
  30. eva_cli-4.4.0/scripts/windows/Get-SecurityEvents.ps1 +182 -0
  31. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/__init__.py +1 -1
  32. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/agent/loop.py +8 -5
  33. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/agent/tools.py +8 -6
  34. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/cache/__init__.py +2 -0
  35. eva_cli-4.4.0/src/eva/cache/cache.py +164 -0
  36. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/cli/app.py +250 -12
  37. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/config/config.py +6 -0
  38. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/indexing/packer.py +11 -4
  39. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/security/redaction.py +44 -5
  40. eva_cli-4.4.0/src/eva/security/sensitive_files.py +46 -0
  41. eva_cli-4.4.0/src/eva/security_tools/__init__.py +6 -0
  42. eva_cli-4.4.0/src/eva/security_tools/aegis.py +382 -0
  43. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/__init__.py +4 -0
  44. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/analysis/__init__.py +0 -0
  45. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/analysis/authenticity.py +159 -0
  46. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/analysis/binary.py +105 -0
  47. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/analysis/metadata.py +94 -0
  48. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/analysis/rich_model.py +407 -0
  49. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/analysis/steganography.py +394 -0
  50. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/analysis/structure_validator.py +512 -0
  51. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/core/__init__.py +0 -0
  52. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/core/audit.py +54 -0
  53. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/core/hashing.py +45 -0
  54. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/core/image_object.py +87 -0
  55. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/core/pipeline.py +35 -0
  56. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/core/signing.py +69 -0
  57. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/core/vault.py +60 -0
  58. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/main.py +668 -0
  59. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/__init__.py +0 -0
  60. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/algorithms/__init__.py +0 -0
  61. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/algorithms/adaptive.py +336 -0
  62. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/algorithms/cost_functions.py +240 -0
  63. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/algorithms/f5_stego.py +406 -0
  64. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/algorithms/j_uniward.py +378 -0
  65. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/algorithms/stc_embed.py +226 -0
  66. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/channels/__init__.py +1 -0
  67. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/channels/metadata_channel.py +392 -0
  68. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/channels/multi_carrier.py +263 -0
  69. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/channels/network_covert.py +702 -0
  70. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/channels/palette_stego.py +291 -0
  71. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/crypto.py +178 -0
  72. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/offensive/fs_stego.py +47 -0
  73. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/reporting/__init__.py +0 -0
  74. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/reporting/reports.py +149 -0
  75. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/security/__init__.py +0 -0
  76. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/security/sanitization.py +14 -0
  77. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/security/shredder.py +59 -0
  78. eva_cli-4.4.0/src/eva/security_tools/aegis_engine/security/timestomp.py +32 -0
  79. eva_cli-4.4.0/src/eva/security_tools/base.py +91 -0
  80. eva_cli-4.4.0/src/eva/security_tools/cli.py +1179 -0
  81. eva_cli-4.4.0/src/eva/security_tools/elf_analyzer.py +266 -0
  82. eva_cli-4.4.0/src/eva/security_tools/entropy.py +176 -0
  83. eva_cli-4.4.0/src/eva/security_tools/gitleaks.py +43 -0
  84. eva_cli-4.4.0/src/eva/security_tools/intel_client.py +553 -0
  85. eva_cli-4.4.0/src/eva/security_tools/models.py +98 -0
  86. eva_cli-4.4.0/src/eva/security_tools/normalizers.py +526 -0
  87. eva_cli-4.4.0/src/eva/security_tools/osv.py +33 -0
  88. eva_cli-4.4.0/src/eva/security_tools/pe_analyzer.py +384 -0
  89. eva_cli-4.4.0/src/eva/security_tools/registry.py +63 -0
  90. eva_cli-4.4.0/src/eva/security_tools/report.py +76 -0
  91. eva_cli-4.4.0/src/eva/security_tools/rules/yara/cve_exploits.yar +34 -0
  92. eva_cli-4.4.0/src/eva/security_tools/rules/yara/embedded_pe.yar +47 -0
  93. eva_cli-4.4.0/src/eva/security_tools/rules/yara/obfuscation.yar +36 -0
  94. eva_cli-4.4.0/src/eva/security_tools/rules/yara/suspicious_packers.yar +54 -0
  95. eva_cli-4.4.0/src/eva/security_tools/rules/yara/webshells.yar +62 -0
  96. eva_cli-4.4.0/src/eva/security_tools/runner.py +139 -0
  97. eva_cli-4.4.0/src/eva/security_tools/scope.py +123 -0
  98. eva_cli-4.4.0/src/eva/security_tools/semgrep.py +43 -0
  99. eva_cli-4.4.0/src/eva/security_tools/strings_analyzer.py +214 -0
  100. eva_cli-4.4.0/src/eva/security_tools/syft.py +39 -0
  101. eva_cli-4.4.0/src/eva/security_tools/trivy.py +46 -0
  102. eva_cli-4.4.0/src/eva/security_tools/utils.py +153 -0
  103. eva_cli-4.4.0/src/eva/security_tools/workflow.py +161 -0
  104. eva_cli-4.4.0/src/eva/security_tools/yara_scanner.py +172 -0
  105. eva_cli-4.4.0/src/eva/security_tools/zap.py +116 -0
  106. eva_cli-4.4.0/src/eva/ui/__init__.py +13 -0
  107. eva_cli-4.4.0/src/eva/ui/output.py +22 -0
  108. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/workflows/engine.py +40 -1
  109. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/workspace/__init__.py +10 -1
  110. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/workspace/gitignore.py +11 -1
  111. eva_cli-4.4.0/src/eva/workspace/project_context.py +22 -0
  112. eva_cli-4.4.0/tests/unit/cache/test_cache.py +66 -0
  113. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/cli/test_cli_commands.py +70 -0
  114. eva_cli-4.4.0/tests/unit/cli/test_output_format.py +68 -0
  115. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/security/test_redaction.py +45 -0
  116. eva_cli-4.4.0/tests/unit/security/test_sensitive_files_config.py +129 -0
  117. eva_cli-4.4.0/tests/unit/security_tools/__init__.py +1 -0
  118. eva_cli-4.4.0/tests/unit/security_tools/test_aegis.py +255 -0
  119. eva_cli-4.4.0/tests/unit/security_tools/test_binary.py +323 -0
  120. eva_cli-4.4.0/tests/unit/security_tools/test_intel.py +206 -0
  121. eva_cli-4.4.0/tests/unit/security_tools/test_normalizers.py +214 -0
  122. eva_cli-4.4.0/tests/unit/security_tools/test_runner.py +158 -0
  123. eva_cli-4.4.0/tests/unit/security_tools/test_scope.py +55 -0
  124. eva_cli-4.4.0/tests/unit/security_tools/test_sec_cli.py +306 -0
  125. eva_cli-4.4.0/tests/unit/security_tools/test_triage_ingest.py +120 -0
  126. eva_cli-4.4.0/tests/unit/security_tools/test_workflow.py +123 -0
  127. eva_cli-4.4.0/tests/unit/security_tools/test_yara.py +117 -0
  128. eva_cli-4.4.0/tests/unit/security_tools/test_zap.py +131 -0
  129. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/workflows/test_workflow_engine.py +11 -0
  130. eva_cli-4.4.0/tests/unit/workspace/test_gitignore_config.py +71 -0
  131. eva_cli-4.4.0/tests/unit/workspace/test_project_context.py +112 -0
  132. eva_cli-4.4.0/uv.lock +2724 -0
  133. eva_cli-4.2.1/docs/command-reference.md +0 -197
  134. eva_cli-4.2.1/src/eva/cache/cache.py +0 -40
  135. eva_cli-4.2.1/src/eva/security/sensitive_files.py +0 -31
  136. eva_cli-4.2.1/tests/unit/cache/test_cache.py +0 -22
  137. {eva_cli-4.2.1 → eva_cli-4.4.0}/.github/workflows/ci.yaml +0 -0
  138. {eva_cli-4.2.1 → eva_cli-4.4.0}/.github/workflows/fastwalk-release.yml +0 -0
  139. {eva_cli-4.2.1 → eva_cli-4.4.0}/.github/workflows/release.yml +0 -0
  140. {eva_cli-4.2.1 → eva_cli-4.4.0}/.pre-commit-config.yaml +0 -0
  141. {eva_cli-4.2.1 → eva_cli-4.4.0}/CONTRIBUTING.md +0 -0
  142. {eva_cli-4.2.1 → eva_cli-4.4.0}/Dockerfile +0 -0
  143. {eva_cli-4.2.1 → eva_cli-4.4.0}/LICENSE +0 -0
  144. {eva_cli-4.2.1 → eva_cli-4.4.0}/assets/demo.gif +0 -0
  145. {eva_cli-4.2.1 → eva_cli-4.4.0}/assets/demo2.gif +0 -0
  146. {eva_cli-4.2.1 → eva_cli-4.4.0}/assets/demo3.gif +0 -0
  147. {eva_cli-4.2.1 → eva_cli-4.4.0}/assets/demo4.gif +0 -0
  148. {eva_cli-4.2.1 → eva_cli-4.4.0}/assets/demo5.gif +0 -0
  149. {eva_cli-4.2.1 → eva_cli-4.4.0}/assets/eva.png +0 -0
  150. {eva_cli-4.2.1 → eva_cli-4.4.0}/docs/architecture.md +0 -0
  151. {eva_cli-4.2.1 → eva_cli-4.4.0}/docs/plugins.md +0 -0
  152. {eva_cli-4.2.1 → eva_cli-4.4.0}/docs/provider-behavior.md +0 -0
  153. {eva_cli-4.2.1 → eva_cli-4.4.0}/examples/eva-plugin-hello/README.md +0 -0
  154. {eva_cli-4.2.1 → eva_cli-4.4.0}/examples/eva-plugin-hello/eva_plugin_hello.py +0 -0
  155. {eva_cli-4.2.1 → eva_cli-4.4.0}/examples/eva-plugin-hello/pyproject.toml +0 -0
  156. {eva_cli-4.2.1 → eva_cli-4.4.0}/install.sh +0 -0
  157. {eva_cli-4.2.1 → eva_cli-4.4.0}/rust/eva_fastwalk/pyproject.toml +0 -0
  158. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/agent/__init__.py +0 -0
  159. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/cli/__init__.py +0 -0
  160. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/cli.py +0 -0
  161. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/config/__init__.py +0 -0
  162. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/indexing/__init__.py +0 -0
  163. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/indexing/finder.py +0 -0
  164. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/indexing/io.py +0 -0
  165. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/indexing/repo_index.py +0 -0
  166. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/indexing/tokenizer.py +0 -0
  167. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/indexing/tree.py +0 -0
  168. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/plugins/__init__.py +0 -0
  169. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/plugins/loader.py +0 -0
  170. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/plugins/protocol.py +0 -0
  171. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/prompts/__init__.py +0 -0
  172. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/providers/__init__.py +0 -0
  173. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/providers/gemini_provider.py +0 -0
  174. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/providers/groq_provider.py +0 -0
  175. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/providers/llamacpp_provider.py +0 -0
  176. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/providers/ollama_provider.py +0 -0
  177. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/providers/openai_compat.py +0 -0
  178. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/providers/opencode_zen_provider.py +0 -0
  179. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/providers/openrouter_provider.py +0 -0
  180. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/replay/__init__.py +0 -0
  181. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/replay/crypto.py +0 -0
  182. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/replay/player.py +0 -0
  183. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/replay/recorder.py +0 -0
  184. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/security/__init__.py +0 -0
  185. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/security/audit.py +0 -0
  186. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/security/sandbox.py +0 -0
  187. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/security/work_safety.py +0 -0
  188. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/shell/__init__.py +0 -0
  189. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/shell/runner.py +0 -0
  190. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/telemetry/__init__.py +0 -0
  191. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/telemetry/diagnostics.py +0 -0
  192. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/telemetry/metrics.py +0 -0
  193. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/ui/formatter.py +0 -0
  194. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/ui/streaming.py +0 -0
  195. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/workflows/__init__.py +0 -0
  196. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/workflows/budget.py +0 -0
  197. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/workflows/builtins/dependency_audit.yaml +0 -0
  198. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/workflows/builtins/repo_health.yaml +0 -0
  199. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/workflows/builtins/security_scan.yaml +0 -0
  200. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/workflows/chat_session.py +0 -0
  201. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/workspace/git_ops.py +0 -0
  202. {eva_cli-4.2.1 → eva_cli-4.4.0}/src/eva/workspace/session.py +0 -0
  203. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/conftest.py +0 -0
  204. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/fixtures/golden/patches/sample1_expected.diff +0 -0
  205. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/fixtures/golden/patches/sample1_fenced.txt +0 -0
  206. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/fixtures/golden/prompts/analyze_system_prompt.txt +0 -0
  207. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/fixtures/golden/prompts/ask_system_prompt.txt +0 -0
  208. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/fixtures/golden/prompts/changes_system_prompt.txt +0 -0
  209. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/fixtures/golden/prompts/chat_system_prompt.txt +0 -0
  210. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/fixtures/golden/prompts/commit_system_prompt.txt +0 -0
  211. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/fixtures/golden/prompts/edit_system_prompt.txt +0 -0
  212. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/fixtures/golden/prompts/explain_system_prompt.txt +0 -0
  213. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/fixtures/golden/prompts/work_system_prompt.txt +0 -0
  214. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/test_basic.py +0 -0
  215. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/__init__.py +0 -0
  216. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/agent/test_loop.py +0 -0
  217. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/agent/test_tools.py +0 -0
  218. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/cache/__init__.py +0 -0
  219. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/cli/__init__.py +0 -0
  220. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/cli/test_ask_repo.py +0 -0
  221. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/cli/test_changes_command.py +0 -0
  222. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/cli/test_cli.py +0 -0
  223. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/cli/test_cli_coverage.py +0 -0
  224. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/cli/test_cli_more.py +0 -0
  225. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/cli/test_investigate.py +0 -0
  226. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/config/__init__.py +0 -0
  227. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/config/test_config.py +0 -0
  228. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/config/test_config_keys.py +0 -0
  229. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/golden/__init__.py +0 -0
  230. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/golden/test_golden_patches.py +0 -0
  231. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/golden/test_golden_prompts.py +0 -0
  232. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/indexing/__init__.py +0 -0
  233. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/indexing/test_indexing.py +0 -0
  234. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/indexing/test_indexing_more.py +0 -0
  235. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/indexing/test_packer.py +0 -0
  236. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/indexing/test_repo_index.py +0 -0
  237. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/indexing/test_tokenizer_offline.py +0 -0
  238. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/plugins/__init__.py +0 -0
  239. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/plugins/test_plugins.py +0 -0
  240. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/providers/__init__.py +0 -0
  241. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/providers/test_context_budget.py +0 -0
  242. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/providers/test_dispatch_caching.py +0 -0
  243. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/providers/test_gemini_tools.py +0 -0
  244. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/providers/test_offline_providers.py +0 -0
  245. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/providers/test_openai_compat_tools.py +0 -0
  246. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/providers/test_provider_coverage.py +0 -0
  247. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/providers/test_provider_errors.py +0 -0
  248. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/providers/test_provider_tools_protocol.py +0 -0
  249. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/providers/test_providers.py +0 -0
  250. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/providers/test_providers_more.py +0 -0
  251. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/providers/test_repo_caching.py +0 -0
  252. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/replay/test_replay.py +0 -0
  253. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/security/__init__.py +0 -0
  254. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/security/test_allowlist_cli.py +0 -0
  255. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/security/test_audit.py +0 -0
  256. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/security/test_audit_chain.py +0 -0
  257. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/security/test_safety_audit.py +0 -0
  258. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/security/test_sandbox.py +0 -0
  259. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/security/test_work_safety.py +0 -0
  260. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/shell/__init__.py +0 -0
  261. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/shell/test_shell.py +0 -0
  262. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/telemetry/__init__.py +0 -0
  263. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/telemetry/test_metrics.py +0 -0
  264. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/telemetry/test_telemetry.py +0 -0
  265. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/test_compatibility_imports.py +0 -0
  266. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/ui/__init__.py +0 -0
  267. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/ui/test_ui.py +0 -0
  268. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/workflows/__init__.py +0 -0
  269. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/workflows/test_chat_session.py +0 -0
  270. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/workflows/test_workflows.py +0 -0
  271. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/workspace/__init__.py +0 -0
  272. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/workspace/test_git_ops.py +0 -0
  273. {eva_cli-4.2.1 → eva_cli-4.4.0}/tests/unit/workspace/test_session_workspace.py +0 -0
  274. {eva_cli-4.2.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,8 +7,63 @@ 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
+
41
+ ## [4.3.1] - 2026-08-15
42
+
43
+ ### Added
44
+ - **Path-Aware Secret Redaction & Configurable Entropy Threshold (`src/eva/security/redaction.py`, `src/eva/cli/app.py`):**
45
+ - Updated `replace_high_entropy()` to split tokens on `/` and score individual path segments separately, eliminating false-positive redactions on Unix/Windows filesystem paths (e.g. `~/.local/share/.../icon.png`).
46
+ - Added configurable Shannon entropy threshold via `GeneralConfig.redaction_entropy_threshold` (default `3.5`) and CLI command `eva config set-redaction-threshold <val>`.
47
+ - Added configurable regex exemption patterns via `GeneralConfig.redaction_ignore_patterns`, `eva config allow-redaction-pattern <regex>`, and `eva config disallow-redaction-pattern <regex>`.
48
+ - **Configurable Ignored Directories (`src/eva/workspace/gitignore.py`, `src/eva/cli/app.py`):**
49
+ - Dynamic ignored directories collection `_effective_ignored_dirs` with `.eva/` excluded by default from indexing and repo packing.
50
+ - Added `GeneralConfig.extra_ignored_dirs` and `GeneralConfig.unignore_dirs` managed via `eva config ignore-dir <name>` and `eva config unignore-dir <name>`.
51
+ - **Sensitive File Allowlist & `--force-include` Overrides (`src/eva/security/sensitive_files.py`, `src/eva/indexing/packer.py`, `src/eva/agent/tools.py`, `src/eva/cli/app.py`):**
52
+ - Added `GeneralConfig.sensitive_file_allowlist` managed via `eva config allow-sensitive-file <pattern>` and `eva config disallow-sensitive-file <pattern>`.
53
+ - Added `--force-include <pattern>` flag to `eva investigate` and `eva ask --repo` for explicit, user-authorized inspection of denylisted files.
54
+ - Cryptographic hash-chained audit logging with action `sensitive_file_override` for all force-included accesses.
55
+ - **Configurable Context Token Limit (`src/eva/config/config.py`, `src/eva/cli/app.py`):**
56
+ - Added `GeneralConfig.context_token_limit` override allowing users to cap LLM context token consumption process-wide across `ask`, `commit-message`, and `changes`.
57
+ - **Machine-Readable Structured Output `--format json` (`src/eva/ui/output.py`, `src/eva/cli/app.py`):**
58
+ - Added `--format json|text` option to `eva ask` and `eva explain`, emitting deterministic JSON objects (`{"content": ..., "is_error": bool, "provider": ...}`) suitable for scripting and CI integration.
59
+ - **Project Memory Support `.eva/context.md` (`src/eva/workspace/project_context.py`, `src/eva/cli/app.py`):**
60
+ - Added automated project memory loader injecting repository-level instructions in `.eva/context.md` into `eva ask` and `eva work` prompts.
61
+ - Added `eva context show` command to display active project memory.
62
+ - Added `--no-project-context` flag to bypass project memory for one-shot runs.
63
+
10
64
  ## [4.2.1] - 2026-08-12
11
65
 
66
+
12
67
  ### Security
13
68
  - **Replay session data encrypted at rest (`src/eva/replay/`):**
14
69
  - Fixed a high-severity finding from GitHub code scanning: `meta.json` and `events.jsonl` under a session's replay directory were written as plaintext JSON. Terminal output can contain sensitive data that `redact_secrets()` doesn't catch (PII, internal hostnames, proprietary output), so replay files are now encrypted at rest as a second, independent layer.
@@ -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
 
@@ -57,11 +100,20 @@ The design goal is practical: keep routine terminal work fast and local, "Can't
57
100
  - Streaming responses with disk-backed caching.
58
101
  - Local RPM/RPD budget tracking to avoid unexpectedly exhausting free-tier provider quotas.
59
102
  - `.gitignore`-aware context collection with common heavy directories pruned automatically.
103
+ - Project memory support via `.eva/context.md` for repo-level instructions (`eva context show`).
104
+ - Structured machine-readable output mode (`--format json`) for scripting and CI integration.
60
105
  - Safe file-context reads with missing-file, binary-file, large-file, and invalid-UTF-8 handling.
61
106
  - Hardened command generation via `eva work`: strict parsing, risk checks, no `shell=True`, dry-run mode, and audit logging.
62
107
  - Git-aware workflows for explaining diffs and generating commit messages.
63
108
  - Reviewable patch generation with `eva edit`.
64
- - Health checks through `eva config doctor`.
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.
115
+ - Fine-grained security tuning: path-aware secret redaction, configurable Shannon entropy thresholds, and sensitive file allowlists (`eva config allow-sensitive-file`).
116
+ - Health checks through `eva config doctor` and `eva sec doctor`.
65
117
  - Persistent chat sessions with `eva chat --session`.
66
118
 
67
119
  ## Installation
@@ -243,6 +295,38 @@ eva tree src/eva
243
295
 
244
296
  ```
245
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
+
246
330
  ## Command reference
247
331
 
248
332
  | Command | Purpose |
@@ -269,13 +353,26 @@ eva tree src/eva
269
353
  | `eva find` | Find files locally without AI usage. |
270
354
  | `eva tree` | Print a `.gitignore`-aware directory tree. |
271
355
  | `eva usage` | Show normalized local provider usage counters. |
272
-
273
-
356
+ | `eva context show` | Display project memory from `.eva/context.md` if present. |
274
357
  | `eva config set-key <provider>` | Store an API key in the OS keyring. |
275
358
  | `eva config remove-key <provider>` | Delete a stored API key from the OS keyring. |
276
359
  | `eva config set-model <provider> <model>` | Set active model for a provider. |
360
+ | `eva config set-redaction-threshold <val>` | Set entropy threshold for secret redaction (default 3.5). |
361
+ | `eva config allow-redaction-pattern <regex>` | Add regex pattern exempt from secret redaction. |
362
+ | `eva config disallow-redaction-pattern <regex>` | Remove regex pattern from redaction ignore list. |
363
+ | `eva config ignore-dir <name>` | Add directory name to process-wide ignored directories. |
364
+ | `eva config unignore-dir <name>` | Remove directory name from ignored directories. |
365
+ | `eva config allow-sensitive-file <glob>` | Add glob pattern to sensitive file allowlist. |
366
+ | `eva config disallow-sensitive-file <glob>` | Remove glob pattern from sensitive file allowlist. |
277
367
  | `eva config` | Manage provider, model, and API-key configuration. |
278
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. |
279
376
 
280
377
 
281
378
  Global options:
@@ -285,8 +382,15 @@ eva --version
285
382
  eva --verbose ask "Why did this fail?"
286
383
  ```
287
384
 
385
+ Scripting & Automation Options:
386
+
387
+ - `--format json|text`: Supported on `eva ask` and `eva explain` for structured machine-readable JSON output (`{"content": ..., "is_error": ..., "provider": ...}`).
388
+ - `--no-project-context`: Suppress auto-inclusion of `.eva/context.md` project memory for one-shot runs in `eva ask` or `eva work`.
389
+ - `--force-include <pattern>`: Force-include specific sensitive files (e.g. `*.pem`, `.env`) in `eva investigate` or `eva ask --repo` with hash-chained audit logging.
390
+
288
391
  Verbose mode writes diagnostics to stderr and to Eva’s log file.
289
392
 
393
+
290
394
  ## Safety model & Production Hardening
291
395
 
292
396
  `eva work` and `eva workflow` are intentionally conservative:
@@ -1,36 +1,3 @@
1
- Metadata-Version: 2.5
2
- Name: eva-cli
3
- Version: 4.2.1
4
- Summary: Command Line Intelligence
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
 
@@ -90,11 +57,20 @@ The design goal is practical: keep routine terminal work fast and local, "Can't
90
57
  - Streaming responses with disk-backed caching.
91
58
  - Local RPM/RPD budget tracking to avoid unexpectedly exhausting free-tier provider quotas.
92
59
  - `.gitignore`-aware context collection with common heavy directories pruned automatically.
60
+ - Project memory support via `.eva/context.md` for repo-level instructions (`eva context show`).
61
+ - Structured machine-readable output mode (`--format json`) for scripting and CI integration.
93
62
  - Safe file-context reads with missing-file, binary-file, large-file, and invalid-UTF-8 handling.
94
63
  - Hardened command generation via `eva work`: strict parsing, risk checks, no `shell=True`, dry-run mode, and audit logging.
95
64
  - Git-aware workflows for explaining diffs and generating commit messages.
96
65
  - Reviewable patch generation with `eva edit`.
97
- - Health checks through `eva config doctor`.
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.
72
+ - Fine-grained security tuning: path-aware secret redaction, configurable Shannon entropy thresholds, and sensitive file allowlists (`eva config allow-sensitive-file`).
73
+ - Health checks through `eva config doctor` and `eva sec doctor`.
98
74
  - Persistent chat sessions with `eva chat --session`.
99
75
 
100
76
  ## Installation
@@ -276,6 +252,38 @@ eva tree src/eva
276
252
 
277
253
  ```
278
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
+
279
287
  ## Command reference
280
288
 
281
289
  | Command | Purpose |
@@ -302,13 +310,26 @@ eva tree src/eva
302
310
  | `eva find` | Find files locally without AI usage. |
303
311
  | `eva tree` | Print a `.gitignore`-aware directory tree. |
304
312
  | `eva usage` | Show normalized local provider usage counters. |
305
-
306
-
313
+ | `eva context show` | Display project memory from `.eva/context.md` if present. |
307
314
  | `eva config set-key <provider>` | Store an API key in the OS keyring. |
308
315
  | `eva config remove-key <provider>` | Delete a stored API key from the OS keyring. |
309
316
  | `eva config set-model <provider> <model>` | Set active model for a provider. |
317
+ | `eva config set-redaction-threshold <val>` | Set entropy threshold for secret redaction (default 3.5). |
318
+ | `eva config allow-redaction-pattern <regex>` | Add regex pattern exempt from secret redaction. |
319
+ | `eva config disallow-redaction-pattern <regex>` | Remove regex pattern from redaction ignore list. |
320
+ | `eva config ignore-dir <name>` | Add directory name to process-wide ignored directories. |
321
+ | `eva config unignore-dir <name>` | Remove directory name from ignored directories. |
322
+ | `eva config allow-sensitive-file <glob>` | Add glob pattern to sensitive file allowlist. |
323
+ | `eva config disallow-sensitive-file <glob>` | Remove glob pattern from sensitive file allowlist. |
310
324
  | `eva config` | Manage provider, model, and API-key configuration. |
311
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. |
312
333
 
313
334
 
314
335
  Global options:
@@ -318,8 +339,15 @@ eva --version
318
339
  eva --verbose ask "Why did this fail?"
319
340
  ```
320
341
 
342
+ Scripting & Automation Options:
343
+
344
+ - `--format json|text`: Supported on `eva ask` and `eva explain` for structured machine-readable JSON output (`{"content": ..., "is_error": ..., "provider": ...}`).
345
+ - `--no-project-context`: Suppress auto-inclusion of `.eva/context.md` project memory for one-shot runs in `eva ask` or `eva work`.
346
+ - `--force-include <pattern>`: Force-include specific sensitive files (e.g. `*.pem`, `.env`) in `eva investigate` or `eva ask --repo` with hash-chained audit logging.
347
+
321
348
  Verbose mode writes diagnostics to stderr and to Eva’s log file.
322
349
 
350
+
323
351
  ## Safety model & Production Hardening
324
352
 
325
353
  `eva work` and `eva workflow` are intentionally conservative:
@@ -21,16 +21,25 @@ Eva automatically sanitizes text to redact sensitive credentials **before** data
21
21
  - **Generic Secret Assignments**: `api_key`, `secret`, `password`, `auth_token`, `access_token`
22
22
  - **PEM Private Key Blocks**: `-----BEGIN [RSA|EC|DSA|OPENSSH] PRIVATE KEY-----`
23
23
 
24
- 2. **Shannon Entropy Analysis**:
25
- - Evaluates randomness for all strings $\ge 16$ characters using Shannon entropy:
24
+ 2. **Shannon Entropy Analysis & Path-Aware Tokenization**:
25
+ - Evaluates randomness for string tokens $\ge 16$ characters using Shannon entropy:
26
26
  $$H(S) = -\sum_{i} p(x_i) \log_2 p(x_i)$$
27
- - Tokens exceeding the entropy threshold ($H(S) > 3.5$ bits/char) are automatically redacted as `[REDACTED_HIGH_ENTROPY]`.
27
+ - Paths are tokenized by path separators (`/`) and scored per segment to prevent false positive redactions of structured paths.
28
+ - Tokens exceeding the configurable entropy threshold ($H(S) > 3.5$ bits/char by default) are automatically redacted as `[REDACTED_HIGH_ENTROPY]`.
29
+ - Entropy threshold can be customized via `eva config set-redaction-threshold <val>`.
30
+ - Specific regex patterns can be exempted from entropy redaction via `eva config allow-redaction-pattern <regex>` and `eva config disallow-redaction-pattern <regex>`.
31
+
32
+ 3. **Sensitive File Protection & Overrides**:
33
+ - High-risk credential and configuration files (`.env*`, `*.pem`, `*.key`, `credentials.*`, `secrets.*`, etc.) are blocked by default from indexing, repository packing, and agent file exploration.
34
+ - Persistent allowlist patterns can be configured via `eva config allow-sensitive-file <pattern>` and `eva config disallow-sensitive-file <pattern>`.
35
+ - Per-command overrides can be passed via `--force-include <pattern>` in `eva investigate` and `eva ask --repo`. Every force-included sensitive file access is recorded in the cryptographic audit log as a `sensitive_file_override` event.
28
36
 
29
37
  ---
30
38
 
31
39
  ## 2. Hash-Chained Audit Log
32
40
 
33
- All executed, blocked, or declined commands generated via `eva work` or `eva workflow` are recorded in an append-only, tamper-evident audit log at `~/.config/eva/command_audit.jsonl`.
41
+ All executed, blocked, or declined commands generated via `eva work` or `eva workflow`, as well as sensitive file overrides (`--force-include`), are recorded in an append-only, tamper-evident audit log at `~/.config/eva/command_audit.jsonl`.
42
+
34
43
 
35
44
  ### Cryptographic Tamper Detection
36
45
 
@@ -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**.