eva-cli 4.1.0__tar.gz → 4.3.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 (178) hide show
  1. {eva_cli-4.1.0 → eva_cli-4.3.1}/.github/workflows/ci.yaml +3 -0
  2. {eva_cli-4.1.0 → eva_cli-4.3.1}/CHANGELOG.md +35 -0
  3. eva_cli-4.1.0/README.md → eva_cli-4.3.1/PKG-INFO +51 -2
  4. eva_cli-4.1.0/PKG-INFO → eva_cli-4.3.1/README.md +18 -34
  5. {eva_cli-4.1.0 → eva_cli-4.3.1}/SECURITY.md +13 -4
  6. {eva_cli-4.1.0 → eva_cli-4.3.1}/docs/README.md +1 -1
  7. {eva_cli-4.1.0 → eva_cli-4.3.1}/docs/command-reference.md +61 -8
  8. {eva_cli-4.1.0 → eva_cli-4.3.1}/docs/configuration.md +66 -0
  9. {eva_cli-4.1.0 → eva_cli-4.3.1}/docs/index.md +11 -7
  10. {eva_cli-4.1.0 → eva_cli-4.3.1}/docs/security-model.md +10 -5
  11. {eva_cli-4.1.0 → eva_cli-4.3.1}/pyproject.toml +3 -2
  12. {eva_cli-4.1.0 → eva_cli-4.3.1}/rust/eva_fastwalk/Cargo.lock +16 -123
  13. {eva_cli-4.1.0 → eva_cli-4.3.1}/rust/eva_fastwalk/Cargo.toml +2 -1
  14. {eva_cli-4.1.0 → eva_cli-4.3.1}/rust/eva_fastwalk/src/lib.rs +2 -1
  15. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/__init__.py +1 -1
  16. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/agent/loop.py +8 -5
  17. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/agent/tools.py +8 -6
  18. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/cli/app.py +248 -12
  19. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/config/config.py +6 -0
  20. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/indexing/packer.py +11 -4
  21. eva_cli-4.3.1/src/eva/replay/crypto.py +100 -0
  22. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/replay/player.py +7 -6
  23. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/replay/recorder.py +11 -10
  24. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/security/redaction.py +44 -5
  25. eva_cli-4.3.1/src/eva/security/sensitive_files.py +46 -0
  26. eva_cli-4.3.1/src/eva/ui/__init__.py +13 -0
  27. eva_cli-4.3.1/src/eva/ui/output.py +22 -0
  28. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/workspace/__init__.py +10 -1
  29. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/workspace/gitignore.py +11 -1
  30. eva_cli-4.3.1/src/eva/workspace/project_context.py +22 -0
  31. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/cli/test_cli_commands.py +70 -0
  32. eva_cli-4.3.1/tests/unit/cli/test_output_format.py +68 -0
  33. eva_cli-4.3.1/tests/unit/replay/test_replay.py +134 -0
  34. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/security/test_redaction.py +45 -0
  35. eva_cli-4.3.1/tests/unit/security/test_sensitive_files_config.py +129 -0
  36. eva_cli-4.3.1/tests/unit/workspace/test_gitignore_config.py +71 -0
  37. eva_cli-4.3.1/tests/unit/workspace/test_project_context.py +112 -0
  38. eva_cli-4.1.0/src/eva/security/sensitive_files.py +0 -31
  39. eva_cli-4.1.0/tests/unit/replay/test_replay.py +0 -55
  40. {eva_cli-4.1.0 → eva_cli-4.3.1}/.github/workflows/fastwalk-release.yml +0 -0
  41. {eva_cli-4.1.0 → eva_cli-4.3.1}/.github/workflows/release.yml +0 -0
  42. {eva_cli-4.1.0 → eva_cli-4.3.1}/.gitignore +0 -0
  43. {eva_cli-4.1.0 → eva_cli-4.3.1}/.pre-commit-config.yaml +0 -0
  44. {eva_cli-4.1.0 → eva_cli-4.3.1}/CONTRIBUTING.md +0 -0
  45. {eva_cli-4.1.0 → eva_cli-4.3.1}/Dockerfile +0 -0
  46. {eva_cli-4.1.0 → eva_cli-4.3.1}/LICENSE +0 -0
  47. {eva_cli-4.1.0 → eva_cli-4.3.1}/assets/demo.gif +0 -0
  48. {eva_cli-4.1.0 → eva_cli-4.3.1}/assets/demo2.gif +0 -0
  49. {eva_cli-4.1.0 → eva_cli-4.3.1}/assets/demo3.gif +0 -0
  50. {eva_cli-4.1.0 → eva_cli-4.3.1}/assets/demo4.gif +0 -0
  51. {eva_cli-4.1.0 → eva_cli-4.3.1}/assets/demo5.gif +0 -0
  52. {eva_cli-4.1.0 → eva_cli-4.3.1}/assets/eva.png +0 -0
  53. {eva_cli-4.1.0 → eva_cli-4.3.1}/docs/architecture.md +0 -0
  54. {eva_cli-4.1.0 → eva_cli-4.3.1}/docs/plugins.md +0 -0
  55. {eva_cli-4.1.0 → eva_cli-4.3.1}/docs/provider-behavior.md +0 -0
  56. {eva_cli-4.1.0 → eva_cli-4.3.1}/examples/eva-plugin-hello/README.md +0 -0
  57. {eva_cli-4.1.0 → eva_cli-4.3.1}/examples/eva-plugin-hello/eva_plugin_hello.py +0 -0
  58. {eva_cli-4.1.0 → eva_cli-4.3.1}/examples/eva-plugin-hello/pyproject.toml +0 -0
  59. {eva_cli-4.1.0 → eva_cli-4.3.1}/install.sh +0 -0
  60. {eva_cli-4.1.0 → eva_cli-4.3.1}/rust/eva_fastwalk/pyproject.toml +0 -0
  61. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/agent/__init__.py +0 -0
  62. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/cache/__init__.py +0 -0
  63. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/cache/cache.py +0 -0
  64. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/cli/__init__.py +0 -0
  65. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/cli.py +0 -0
  66. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/config/__init__.py +0 -0
  67. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/indexing/__init__.py +0 -0
  68. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/indexing/finder.py +0 -0
  69. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/indexing/io.py +0 -0
  70. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/indexing/repo_index.py +0 -0
  71. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/indexing/tokenizer.py +0 -0
  72. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/indexing/tree.py +0 -0
  73. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/plugins/__init__.py +0 -0
  74. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/plugins/loader.py +0 -0
  75. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/plugins/protocol.py +0 -0
  76. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/prompts/__init__.py +0 -0
  77. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/providers/__init__.py +0 -0
  78. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/providers/gemini_provider.py +0 -0
  79. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/providers/groq_provider.py +0 -0
  80. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/providers/llamacpp_provider.py +0 -0
  81. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/providers/ollama_provider.py +0 -0
  82. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/providers/openai_compat.py +0 -0
  83. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/providers/opencode_zen_provider.py +0 -0
  84. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/providers/openrouter_provider.py +0 -0
  85. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/replay/__init__.py +0 -0
  86. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/security/__init__.py +0 -0
  87. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/security/audit.py +0 -0
  88. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/security/sandbox.py +0 -0
  89. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/security/work_safety.py +0 -0
  90. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/shell/__init__.py +0 -0
  91. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/shell/runner.py +0 -0
  92. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/telemetry/__init__.py +0 -0
  93. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/telemetry/diagnostics.py +0 -0
  94. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/telemetry/metrics.py +0 -0
  95. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/ui/formatter.py +0 -0
  96. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/ui/streaming.py +0 -0
  97. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/workflows/__init__.py +0 -0
  98. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/workflows/budget.py +0 -0
  99. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/workflows/builtins/dependency_audit.yaml +0 -0
  100. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/workflows/builtins/repo_health.yaml +0 -0
  101. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/workflows/builtins/security_scan.yaml +0 -0
  102. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/workflows/chat_session.py +0 -0
  103. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/workflows/engine.py +0 -0
  104. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/workspace/git_ops.py +0 -0
  105. {eva_cli-4.1.0 → eva_cli-4.3.1}/src/eva/workspace/session.py +0 -0
  106. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/conftest.py +0 -0
  107. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/fixtures/golden/patches/sample1_expected.diff +0 -0
  108. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/fixtures/golden/patches/sample1_fenced.txt +0 -0
  109. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/fixtures/golden/prompts/analyze_system_prompt.txt +0 -0
  110. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/fixtures/golden/prompts/ask_system_prompt.txt +0 -0
  111. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/fixtures/golden/prompts/changes_system_prompt.txt +0 -0
  112. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/fixtures/golden/prompts/chat_system_prompt.txt +0 -0
  113. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/fixtures/golden/prompts/commit_system_prompt.txt +0 -0
  114. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/fixtures/golden/prompts/edit_system_prompt.txt +0 -0
  115. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/fixtures/golden/prompts/explain_system_prompt.txt +0 -0
  116. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/fixtures/golden/prompts/work_system_prompt.txt +0 -0
  117. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/test_basic.py +0 -0
  118. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/__init__.py +0 -0
  119. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/agent/test_loop.py +0 -0
  120. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/agent/test_tools.py +0 -0
  121. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/cache/__init__.py +0 -0
  122. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/cache/test_cache.py +0 -0
  123. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/cli/__init__.py +0 -0
  124. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/cli/test_ask_repo.py +0 -0
  125. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/cli/test_changes_command.py +0 -0
  126. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/cli/test_cli.py +0 -0
  127. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/cli/test_cli_coverage.py +0 -0
  128. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/cli/test_cli_more.py +0 -0
  129. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/cli/test_investigate.py +0 -0
  130. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/config/__init__.py +0 -0
  131. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/config/test_config.py +0 -0
  132. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/config/test_config_keys.py +0 -0
  133. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/golden/__init__.py +0 -0
  134. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/golden/test_golden_patches.py +0 -0
  135. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/golden/test_golden_prompts.py +0 -0
  136. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/indexing/__init__.py +0 -0
  137. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/indexing/test_indexing.py +0 -0
  138. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/indexing/test_indexing_more.py +0 -0
  139. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/indexing/test_packer.py +0 -0
  140. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/indexing/test_repo_index.py +0 -0
  141. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/indexing/test_tokenizer_offline.py +0 -0
  142. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/plugins/__init__.py +0 -0
  143. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/plugins/test_plugins.py +0 -0
  144. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/providers/__init__.py +0 -0
  145. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/providers/test_context_budget.py +0 -0
  146. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/providers/test_dispatch_caching.py +0 -0
  147. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/providers/test_gemini_tools.py +0 -0
  148. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/providers/test_offline_providers.py +0 -0
  149. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/providers/test_openai_compat_tools.py +0 -0
  150. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/providers/test_provider_coverage.py +0 -0
  151. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/providers/test_provider_errors.py +0 -0
  152. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/providers/test_provider_tools_protocol.py +0 -0
  153. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/providers/test_providers.py +0 -0
  154. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/providers/test_providers_more.py +0 -0
  155. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/providers/test_repo_caching.py +0 -0
  156. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/security/__init__.py +0 -0
  157. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/security/test_allowlist_cli.py +0 -0
  158. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/security/test_audit.py +0 -0
  159. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/security/test_audit_chain.py +0 -0
  160. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/security/test_safety_audit.py +0 -0
  161. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/security/test_sandbox.py +0 -0
  162. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/security/test_work_safety.py +0 -0
  163. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/shell/__init__.py +0 -0
  164. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/shell/test_shell.py +0 -0
  165. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/telemetry/__init__.py +0 -0
  166. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/telemetry/test_metrics.py +0 -0
  167. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/telemetry/test_telemetry.py +0 -0
  168. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/test_compatibility_imports.py +0 -0
  169. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/ui/__init__.py +0 -0
  170. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/ui/test_ui.py +0 -0
  171. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/workflows/__init__.py +0 -0
  172. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/workflows/test_chat_session.py +0 -0
  173. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/workflows/test_workflow_engine.py +0 -0
  174. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/workflows/test_workflows.py +0 -0
  175. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/workspace/__init__.py +0 -0
  176. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/workspace/test_git_ops.py +0 -0
  177. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/workspace/test_session_workspace.py +0 -0
  178. {eva_cli-4.1.0 → eva_cli-4.3.1}/tests/unit/workspace/test_workspace.py +0 -0
@@ -5,6 +5,9 @@ on:
5
5
  push:
6
6
  branches: [main]
7
7
 
8
+ permissions:
9
+ contents: read
10
+
8
11
  jobs:
9
12
  test:
10
13
  runs-on: ${{ matrix.os }}
@@ -7,6 +7,41 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
 
9
9
 
10
+ ## [4.3.1] - 2026-08-15
11
+
12
+ ### Added
13
+ - **Path-Aware Secret Redaction & Configurable Entropy Threshold (`src/eva/security/redaction.py`, `src/eva/cli/app.py`):**
14
+ - 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`).
15
+ - Added configurable Shannon entropy threshold via `GeneralConfig.redaction_entropy_threshold` (default `3.5`) and CLI command `eva config set-redaction-threshold <val>`.
16
+ - Added configurable regex exemption patterns via `GeneralConfig.redaction_ignore_patterns`, `eva config allow-redaction-pattern <regex>`, and `eva config disallow-redaction-pattern <regex>`.
17
+ - **Configurable Ignored Directories (`src/eva/workspace/gitignore.py`, `src/eva/cli/app.py`):**
18
+ - Dynamic ignored directories collection `_effective_ignored_dirs` with `.eva/` excluded by default from indexing and repo packing.
19
+ - Added `GeneralConfig.extra_ignored_dirs` and `GeneralConfig.unignore_dirs` managed via `eva config ignore-dir <name>` and `eva config unignore-dir <name>`.
20
+ - **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`):**
21
+ - Added `GeneralConfig.sensitive_file_allowlist` managed via `eva config allow-sensitive-file <pattern>` and `eva config disallow-sensitive-file <pattern>`.
22
+ - Added `--force-include <pattern>` flag to `eva investigate` and `eva ask --repo` for explicit, user-authorized inspection of denylisted files.
23
+ - Cryptographic hash-chained audit logging with action `sensitive_file_override` for all force-included accesses.
24
+ - **Configurable Context Token Limit (`src/eva/config/config.py`, `src/eva/cli/app.py`):**
25
+ - Added `GeneralConfig.context_token_limit` override allowing users to cap LLM context token consumption process-wide across `ask`, `commit-message`, and `changes`.
26
+ - **Machine-Readable Structured Output `--format json` (`src/eva/ui/output.py`, `src/eva/cli/app.py`):**
27
+ - 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.
28
+ - **Project Memory Support `.eva/context.md` (`src/eva/workspace/project_context.py`, `src/eva/cli/app.py`):**
29
+ - Added automated project memory loader injecting repository-level instructions in `.eva/context.md` into `eva ask` and `eva work` prompts.
30
+ - Added `eva context show` command to display active project memory.
31
+ - Added `--no-project-context` flag to bypass project memory for one-shot runs.
32
+
33
+ ## [4.2.1] - 2026-08-12
34
+
35
+
36
+ ### Security
37
+ - **Replay session data encrypted at rest (`src/eva/replay/`):**
38
+ - 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.
39
+ - Added `src/eva/replay/crypto.py`: encrypts/decrypts replay records using `Fernet` (AES-128-CBC + HMAC via the `cryptography` package).
40
+ - Key storage follows the existing API-key pattern in `eva.config.config`: the key is stored in the OS keyring by default, falling back to a mode-`0600` file in the config directory when no keyring backend is available (e.g. headless CI, containers), so replay recording never hard-fails a command.
41
+ - `record_replay_event` now encrypts each record before it's written; file permissions on `meta.json` and `events.jsonl` are additionally restricted to `0600` as defense-in-depth.
42
+ - `load_replay_session` / `list_replay_sessions` transparently decrypt records, with a fallback to plain `json.loads` on `InvalidToken` so replay data recorded before this change continues to load correctly. No migration required.
43
+ - Added `cryptography>=43.0.0,<47.0.0` as a project dependency.
44
+
10
45
  ## [4.1.0] - 2026-08-11
11
46
 
12
47
  ### Added
@@ -1,3 +1,36 @@
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
+
1
34
 
2
35
  # Eva CLI
3
36
 
@@ -57,10 +90,13 @@ The design goal is practical: keep routine terminal work fast and local, "Can't
57
90
  - Streaming responses with disk-backed caching.
58
91
  - Local RPM/RPD budget tracking to avoid unexpectedly exhausting free-tier provider quotas.
59
92
  - `.gitignore`-aware context collection with common heavy directories pruned automatically.
93
+ - Project memory support via `.eva/context.md` for repo-level instructions (`eva context show`).
94
+ - Structured machine-readable output mode (`--format json`) for scripting and CI integration.
60
95
  - Safe file-context reads with missing-file, binary-file, large-file, and invalid-UTF-8 handling.
61
96
  - Hardened command generation via `eva work`: strict parsing, risk checks, no `shell=True`, dry-run mode, and audit logging.
62
97
  - Git-aware workflows for explaining diffs and generating commit messages.
63
98
  - Reviewable patch generation with `eva edit`.
99
+ - Fine-grained security tuning: path-aware secret redaction, configurable Shannon entropy thresholds, and sensitive file allowlists (`eva config allow-sensitive-file`).
64
100
  - Health checks through `eva config doctor`.
65
101
  - Persistent chat sessions with `eva chat --session`.
66
102
 
@@ -269,11 +305,17 @@ eva tree src/eva
269
305
  | `eva find` | Find files locally without AI usage. |
270
306
  | `eva tree` | Print a `.gitignore`-aware directory tree. |
271
307
  | `eva usage` | Show normalized local provider usage counters. |
272
-
273
-
308
+ | `eva context show` | Display project memory from `.eva/context.md` if present. |
274
309
  | `eva config set-key <provider>` | Store an API key in the OS keyring. |
275
310
  | `eva config remove-key <provider>` | Delete a stored API key from the OS keyring. |
276
311
  | `eva config set-model <provider> <model>` | Set active model for a provider. |
312
+ | `eva config set-redaction-threshold <val>` | Set entropy threshold for secret redaction (default 3.5). |
313
+ | `eva config allow-redaction-pattern <regex>` | Add regex pattern exempt from secret redaction. |
314
+ | `eva config disallow-redaction-pattern <regex>` | Remove regex pattern from redaction ignore list. |
315
+ | `eva config ignore-dir <name>` | Add directory name to process-wide ignored directories. |
316
+ | `eva config unignore-dir <name>` | Remove directory name from ignored directories. |
317
+ | `eva config allow-sensitive-file <glob>` | Add glob pattern to sensitive file allowlist. |
318
+ | `eva config disallow-sensitive-file <glob>` | Remove glob pattern from sensitive file allowlist. |
277
319
  | `eva config` | Manage provider, model, and API-key configuration. |
278
320
  | `eva cache clear` | Clear cached AI responses. |
279
321
 
@@ -285,8 +327,15 @@ eva --version
285
327
  eva --verbose ask "Why did this fail?"
286
328
  ```
287
329
 
330
+ Scripting & Automation Options:
331
+
332
+ - `--format json|text`: Supported on `eva ask` and `eva explain` for structured machine-readable JSON output (`{"content": ..., "is_error": ..., "provider": ...}`).
333
+ - `--no-project-context`: Suppress auto-inclusion of `.eva/context.md` project memory for one-shot runs in `eva ask` or `eva work`.
334
+ - `--force-include <pattern>`: Force-include specific sensitive files (e.g. `*.pem`, `.env`) in `eva investigate` or `eva ask --repo` with hash-chained audit logging.
335
+
288
336
  Verbose mode writes diagnostics to stderr and to Eva’s log file.
289
337
 
338
+
290
339
  ## Safety model & Production Hardening
291
340
 
292
341
  `eva work` and `eva workflow` are intentionally conservative:
@@ -1,35 +1,3 @@
1
- Metadata-Version: 2.5
2
- Name: eva-cli
3
- Version: 4.1.0
4
- Summary: Command Line Intelligence
5
- License-File: LICENSE
6
- Requires-Python: >=3.10
7
- Requires-Dist: diskcache<6.0.0,>=5.6.0
8
- Requires-Dist: google-genai<2.0.0,>=0.1.0
9
- Requires-Dist: httpx<1.0.0,>=0.27.0
10
- Requires-Dist: keyring<26.0.0,>=25.0.0
11
- Requires-Dist: openai<3.0.0,>=1.40.0
12
- Requires-Dist: pathspec<1.0.0,>=0.12.0
13
- Requires-Dist: platformdirs<5.0.0,>=4.0.0
14
- Requires-Dist: pydantic-settings<3.0.0,>=2.0.0
15
- Requires-Dist: pydantic<3.0.0,>=2.0.0
16
- Requires-Dist: pyyaml<7.0.0,>=6.0.0
17
- Requires-Dist: rich<15.0.0,>=13.0.0
18
- Requires-Dist: tenacity<10.0.0,>=9.0.0
19
- Requires-Dist: tiktoken<1.0.0,>=0.7.0
20
- Requires-Dist: tomli-w<2.0.0,>=1.0.0
21
- Requires-Dist: tomli<3.0.0,>=2.0.0
22
- Requires-Dist: typer<1.0.0,>=0.12.0
23
- Provides-Extra: dev
24
- Requires-Dist: hypothesis<7.0.0,>=6.0.0; extra == 'dev'
25
- Requires-Dist: pytest-cov<8.0.0,>=5.0.0; extra == 'dev'
26
- Requires-Dist: pytest<10.0.0,>=8.0.0; extra == 'dev'
27
- Requires-Dist: respx<1.0.0,>=0.21.0; extra == 'dev'
28
- Requires-Dist: ruff<1.0.0,>=0.5.0; extra == 'dev'
29
- Provides-Extra: fast
30
- Requires-Dist: eva-fastwalk<0.2.0,>=0.1.0; extra == 'fast'
31
- Description-Content-Type: text/markdown
32
-
33
1
 
34
2
  # Eva CLI
35
3
 
@@ -89,10 +57,13 @@ The design goal is practical: keep routine terminal work fast and local, "Can't
89
57
  - Streaming responses with disk-backed caching.
90
58
  - Local RPM/RPD budget tracking to avoid unexpectedly exhausting free-tier provider quotas.
91
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.
92
62
  - Safe file-context reads with missing-file, binary-file, large-file, and invalid-UTF-8 handling.
93
63
  - Hardened command generation via `eva work`: strict parsing, risk checks, no `shell=True`, dry-run mode, and audit logging.
94
64
  - Git-aware workflows for explaining diffs and generating commit messages.
95
65
  - Reviewable patch generation with `eva edit`.
66
+ - Fine-grained security tuning: path-aware secret redaction, configurable Shannon entropy thresholds, and sensitive file allowlists (`eva config allow-sensitive-file`).
96
67
  - Health checks through `eva config doctor`.
97
68
  - Persistent chat sessions with `eva chat --session`.
98
69
 
@@ -301,11 +272,17 @@ eva tree src/eva
301
272
  | `eva find` | Find files locally without AI usage. |
302
273
  | `eva tree` | Print a `.gitignore`-aware directory tree. |
303
274
  | `eva usage` | Show normalized local provider usage counters. |
304
-
305
-
275
+ | `eva context show` | Display project memory from `.eva/context.md` if present. |
306
276
  | `eva config set-key <provider>` | Store an API key in the OS keyring. |
307
277
  | `eva config remove-key <provider>` | Delete a stored API key from the OS keyring. |
308
278
  | `eva config set-model <provider> <model>` | Set active model for a provider. |
279
+ | `eva config set-redaction-threshold <val>` | Set entropy threshold for secret redaction (default 3.5). |
280
+ | `eva config allow-redaction-pattern <regex>` | Add regex pattern exempt from secret redaction. |
281
+ | `eva config disallow-redaction-pattern <regex>` | Remove regex pattern from redaction ignore list. |
282
+ | `eva config ignore-dir <name>` | Add directory name to process-wide ignored directories. |
283
+ | `eva config unignore-dir <name>` | Remove directory name from ignored directories. |
284
+ | `eva config allow-sensitive-file <glob>` | Add glob pattern to sensitive file allowlist. |
285
+ | `eva config disallow-sensitive-file <glob>` | Remove glob pattern from sensitive file allowlist. |
309
286
  | `eva config` | Manage provider, model, and API-key configuration. |
310
287
  | `eva cache clear` | Clear cached AI responses. |
311
288
 
@@ -317,8 +294,15 @@ eva --version
317
294
  eva --verbose ask "Why did this fail?"
318
295
  ```
319
296
 
297
+ Scripting & Automation Options:
298
+
299
+ - `--format json|text`: Supported on `eva ask` and `eva explain` for structured machine-readable JSON output (`{"content": ..., "is_error": ..., "provider": ...}`).
300
+ - `--no-project-context`: Suppress auto-inclusion of `.eva/context.md` project memory for one-shot runs in `eva ask` or `eva work`.
301
+ - `--force-include <pattern>`: Force-include specific sensitive files (e.g. `*.pem`, `.env`) in `eva investigate` or `eva ask --repo` with hash-chained audit logging.
302
+
320
303
  Verbose mode writes diagnostics to stderr and to Eva’s log file.
321
304
 
305
+
322
306
  ## Safety model & Production Hardening
323
307
 
324
308
  `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
 
@@ -16,4 +16,4 @@ This directory contains the official documentation for Eva CLI, mirroring the co
16
16
 
17
17
  ## Version
18
18
 
19
- This documentation corresponds to **Eva CLI v4.1.0**.
19
+ This documentation corresponds to **Eva CLI v4.2.1**.
@@ -30,6 +30,12 @@ eva ask "Find architectural flaws" --repo . --yes
30
30
 
31
31
  # Bypass response cache
32
32
  eva ask "Why did this fail?" --no-cache
33
+
34
+ # Structured JSON output for scripting and CI
35
+ eva ask "List open issues" --format json
36
+
37
+ # Bypass .eva/context.md project memory
38
+ eva ask "What is the entry point?" --no-project-context
33
39
  ```
34
40
 
35
41
  ### `eva investigate`
@@ -41,6 +47,9 @@ eva investigate "Find how CLI commands are registered and explain the app flow"
41
47
 
42
48
  # Custom turn cap and provider
43
49
  eva investigate "Trace where budget limits are checked" . --max-turns 10 --provider groq --yes
50
+
51
+ # Force include specific denylisted files (audited)
52
+ eva investigate "Analyze security certificates" . --force-include server.pem --yes
44
53
  ```
45
54
 
46
55
  #### Comparison: `eva investigate` vs `eva ask --repo`
@@ -51,12 +60,16 @@ eva investigate "Trace where budget limits are checked" . --max-turns 10 --provi
51
60
  | **Tool Calling** | None | `list_directory`, `read_file`, `search_code` |
52
61
  | **Token Usage** | Pre-packs files up to token budget | Reads only files needed for the query |
53
62
  | **Supported Providers** | All providers | Tool-capable providers (`groq`, `openrouter`, `opencode_zen`, `gemini`) |
63
+ | **Sensitive Overrides** | Supported (`--force-include`) | Supported (`--force-include`) |
54
64
 
55
65
  ### `eva explain`
56
66
  Explain a file, concept, or repository with automatic stack detection and module dependency graph extraction.
57
67
 
58
68
  ```bash
59
69
  eva explain src/eva/router
70
+
71
+ # Structured JSON output
72
+ eva explain src/eva/security --format json
60
73
  ```
61
74
 
62
75
  ### `eva analyze`
@@ -89,6 +102,9 @@ eva work "find all TODO comments" --dry-run-explain
89
102
 
90
103
  # Re-enable shell feature evaluation (pipes / redirects)
91
104
  eva work "find top memory using processes" --allow-shell-features
105
+
106
+ # Bypass repository .eva/context.md project memory
107
+ eva work "format codebase" --no-project-context
92
108
  ```
93
109
 
94
110
  ### `eva edit`
@@ -104,6 +120,19 @@ eva edit "add validation for empty provider names" --file src/eva/cli.py --apply
104
120
 
105
121
  ---
106
122
 
123
+ ## Project Memory Commands
124
+
125
+ ### `eva context show`
126
+ Display project memory loaded from `.eva/context.md` at the repository root.
127
+
128
+ ```bash
129
+ eva context show
130
+ ```
131
+
132
+ > **Note:** `.eva/context.md` is automatically loaded into prompt context for `eva ask` and `eva work` to provide project-specific conventions without needing manual `--file` flags.
133
+
134
+ ---
135
+
107
136
  ## Workflow & Workspace Management
108
137
 
109
138
  ### `eva workflow`
@@ -174,17 +203,42 @@ These utility commands run 100% locally and consume no LLM provider quota.
174
203
  ## Configuration Commands
175
204
 
176
205
  ```bash
177
- eva config set-key <provider> # Store key in OS keyring
178
- eva config remove-key <provider> # Remove key from OS keyring
179
- eva config set-model <provider> <model> # Configure default model for provider
180
- eva config doctor # Run diagnostic health check on environment
181
- eva config allow-command <prefix> # Add command prefix to execution allowlist
182
- eva config disallow-command <prefix> # Remove command prefix from execution allowlist
183
- eva config import-allowlist <path> # Import allowlist from a file
206
+ eva config set-key <provider> # Store key in OS keyring
207
+ eva config remove-key <provider> # Remove key from OS keyring
208
+ eva config set-model <provider> <model> # Configure default model for provider
209
+ eva config doctor # Run diagnostic health check on environment
210
+ eva config allow-command <prefix> # Add command prefix to execution allowlist
211
+ eva config disallow-command <prefix> # Remove command prefix from execution allowlist
212
+ eva config import-allowlist <path> # Import allowlist from a file
213
+ eva config set-redaction-threshold <val> # Set Shannon entropy threshold (default 3.5)
214
+ eva config allow-redaction-pattern <regex> # Add regex pattern to secret redaction ignore list
215
+ eva config disallow-redaction-pattern <regex> # Remove pattern from secret redaction ignore list
216
+ eva config ignore-dir <name> # Add directory to process-wide ignored dirs
217
+ eva config unignore-dir <name> # Remove directory from process-wide ignored dirs
218
+ eva config allow-sensitive-file <glob> # Add glob pattern to sensitive file allowlist
219
+ eva config disallow-sensitive-file <glob> # Remove glob pattern from sensitive file allowlist
184
220
  ```
185
221
 
186
222
  ---
187
223
 
224
+ ## Scripting & Automation Options
225
+
226
+ Eva commands accept global and command-specific automation flags:
227
+
228
+ - `--format json|text`: Supported on `eva ask` and `eva explain` to output deterministic machine-readable JSON:
229
+ ```json
230
+ {
231
+ "content": "Explanation or answer text...",
232
+ "is_error": false,
233
+ "provider": "groq",
234
+ "model": "llama-3.3-70b-versatile"
235
+ }
236
+ ```
237
+ - `--no-project-context`: Skip auto-injecting repository-level `.eva/context.md` project memory.
238
+ - `--force-include <pattern>`: Authorize reading specific denylisted sensitive files (`*.pem`, `.env`, etc.) in `eva investigate` and `eva ask --repo`.
239
+
240
+ ---
241
+
188
242
  ## Shell & Global Options
189
243
 
190
244
  ```bash
@@ -194,4 +248,3 @@ eva --install-completion # Install shell completion (bash/zsh
194
248
  eva --show-completion # Print shell completion script
195
249
  ```
196
250
 
197
- Verbose mode writes diagnostics to stderr and to Eva's log file.
@@ -57,6 +57,14 @@ telemetry_enabled = false
57
57
  sandbox_risky_commands = true
58
58
  allowed_command_prefixes = ["git", "npm", "cargo", "pytest", "ls"]
59
59
 
60
+ # v4.3.1 Configurability Options:
61
+ redaction_entropy_threshold = 3.5 # Default: 3.5 bits/char (0.0 to 8.0)
62
+ redaction_ignore_patterns = ["^SAFE_.*"] # Regex patterns exempt from secret redaction
63
+ extra_ignored_dirs = ["build_scratch"] # Additional directories to exclude from indexing
64
+ unignore_dirs = [] # Directories to unignore from default ignore list
65
+ sensitive_file_allowlist = ["*.staging.env"] # Glob patterns exempt from sensitive file denylist
66
+ context_token_limit = 4000 # Optional context budget token limit override (null = provider default)
67
+
60
68
  [providers.groq]
61
69
  model = "llama-3.3-70b-versatile"
62
70
  temperature = 0.2
@@ -68,6 +76,62 @@ temperature = 0.2
68
76
 
69
77
  ---
70
78
 
79
+ ## Secret Redaction & Shannon Entropy Tuning
80
+
81
+ Eva features a two-layer secret redaction engine: deterministic regex pattern matching and Shannon entropy analysis. You can tune the sensitivity or exempt specific token patterns without disabling safety defaults:
82
+
83
+ ### Setting Entropy Threshold
84
+ ```bash
85
+ # Set entropy threshold (default: 3.5 bits/char; 8.0 disables entropy-based redaction)
86
+ eva config set-redaction-threshold 4.0
87
+ ```
88
+
89
+ ### Redaction Ignore Patterns
90
+ Exempt specific safe tokens or environment variable prefixes from redaction:
91
+ ```bash
92
+ eva config allow-redaction-pattern "^CUSTOM_SAFE_PREFIX_.*"
93
+ eva config disallow-redaction-pattern "^CUSTOM_SAFE_PREFIX_.*"
94
+ ```
95
+
96
+ ---
97
+
98
+ ## Ignored Directories Overrides
99
+
100
+ By default, Eva automatically ignores standard heavy and cache directories (`.git`, `node_modules`, `__pycache__`, `.venv`, `.eva`, etc.) during file discovery and repo-wide packing:
101
+
102
+ ```bash
103
+ # Add custom directory to process-wide ignored directories
104
+ eva config ignore-dir build_artifacts
105
+
106
+ # Unignore a previously ignored directory
107
+ eva config unignore-dir build_artifacts
108
+ ```
109
+
110
+ ---
111
+
112
+ ## Sensitive File Allowlist & Overrides
113
+
114
+ Eva protects credentials by denylisting sensitive file types (`.env`, `*.pem`, `*.key`, `secrets.*`, `credentials.json`, `id_rsa*`). You can allowlist non-secret template files or override on a per-command basis:
115
+
116
+ ### Persistent Allowlist
117
+ ```bash
118
+ # Add glob pattern to sensitive file allowlist
119
+ eva config allow-sensitive-file "*.staging.env"
120
+
121
+ # Remove glob pattern from allowlist
122
+ eva config disallow-sensitive-file "*.staging.env"
123
+ ```
124
+
125
+ ### Per-Command `--force-include`
126
+ For one-off agentic investigations or repo packing involving specific files:
127
+ ```bash
128
+ eva investigate "Analyze certificate configuration" . --force-include server.pem --yes
129
+ eva ask "Inspect staging environment" --repo . --force-include .env.staging --yes
130
+ ```
131
+ > **Audit Note:** Every use of `--force-include` on a denylisted file is automatically recorded in the SHA-256 hash-chained audit log with action `sensitive_file_override`.
132
+
133
+ ---
134
+
71
135
  ## Air-Gapped & Offline Tokenization
72
136
 
73
137
  By default, Eva uses `tiktoken` for accurate BPE token counting. In restricted-network or air-gapped environments where the BPE vocabulary file cannot be downloaded:
@@ -137,4 +201,6 @@ Specify active models per provider:
137
201
  ```bash
138
202
  eva config set-model groq llama-3.3-70b-versatile
139
203
  eva config set-model openrouter anthropic/claude-3.5-sonnet
204
+ eva config set-model opencode_zen nemotron-3.5-lightning-free
140
205
  ```
206
+
@@ -73,11 +73,15 @@ eva --install-completion
73
73
 
74
74
  ## Key Features
75
75
 
76
- 1. **One-Shot Queries**: `eva ask "How do I untar a gz archive?"`
76
+ 1. **One-Shot Queries**: `eva ask "How do I untar a gz archive?"` (supports `--format json`).
77
77
  2. **Context-Aware Analysis**: Pass `--file` or `--dir` context safely with `.gitignore` filtering.
78
- 3. **Terminal Pipeline Analysis**: Pipe command output directly into `eva analyze`.
79
- 4. **Interactive Session Chat**: Persistent sessions with `eva chat --session <id>`.
80
- 5. **Safe Command Generation**: Natural language command generation via `eva work` with `--dry-run`, `--dry-run-explain`, and safety checks.
81
- 6. **Git & Patch Workflows**: Reviewable diff generation with `eva edit` and automated commit messages via `eva commit-message`.
82
- 7. **Plugin Architecture**: Extend Eva with custom commands and providers via `EvaPlugin` subclasses and Python entry points.
83
- 8. **Rust Performance**: Optional `eva-fastwalk` extension for native-speed file discovery.
78
+ 3. **Repository Packing & Agentic Investigation**: `eva ask --repo .` and `eva investigate` for query-driven codebase exploration.
79
+ 4. **Project Memory (`.eva/context.md`)**: Automatically injects repository-level instructions into `ask` and `work` prompts.
80
+ 5. **Terminal Pipeline Analysis**: Pipe command output directly into `eva analyze`.
81
+ 6. **Interactive Session Chat**: Persistent sessions with `eva chat --session <id>`.
82
+ 7. **Safe Command Generation**: Natural language command generation via `eva work` with `--dry-run`, `--dry-run-explain`, and safety checks.
83
+ 8. **Git & Patch Workflows**: Reviewable diff generation with `eva edit` and automated commit messages via `eva commit-message`.
84
+ 9. **Fine-Grained Security Controls**: Path-aware secret redaction, configurable Shannon entropy thresholds, sensitive file allowlists, and SHA-256 hash-chained audit logging.
85
+ 10. **Plugin Architecture**: Extend Eva with custom commands and providers via `EvaPlugin` subclasses and Python entry points.
86
+ 11. **Rust Performance**: Optional `eva-fastwalk` extension for native-speed file discovery.
87
+
@@ -21,14 +21,16 @@ Eva automatically redacts sensitive credentials **before** data is transmitted t
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**:
24
+ 2. **Shannon Entropy Analysis (Path-Aware)**:
25
25
  For any string `S` with length >= 16 characters, Eva calculates its Shannon entropy:
26
26
 
27
27
  `H(S) = - ∑ p(x) * log2(p(x))`
28
28
 
29
- Tokens exceeding the threshold (entropy > 3.5 bits/character) are automatically redacted as `[REDACTED_HIGH_ENTROPY]`.
29
+ - **Path-Aware Tokenization**: For Unix/Windows filesystem paths containing `/`, entropy is evaluated per path segment rather than treating the entire path as a single high-entropy token, preventing false-positive redaction on normal file paths (e.g. `~/.local/share/icons/.../app.png`).
30
+ - **Configurable Threshold**: The default threshold is `3.5` bits/character. Can be tuned via `eva config set-redaction-threshold <val>` (setting to `8.0` disables entropy-based redactions while preserving deterministic regex safety).
31
+ - **Pattern Exemption**: Safe environment variable formats or tokens can be exempted via `eva config allow-redaction-pattern <regex>`.
30
32
 
31
- ### Sensitive-File Denylist (Repo Context Packing & Agentic Investigation)
33
+ ### Sensitive-File Denylist & Overrides (Repo Packing & Agentic Exploration)
32
34
 
33
35
  Because `.gitignore` is not a security boundary, repository context packing (`eva ask --repo`) and agentic repo exploration (`eva investigate`) apply an explicit built-in denylist (`DENYLIST_PATTERNS`) **before** file contents are read, regardless of `.gitignore` state:
34
36
 
@@ -37,18 +39,21 @@ Because `.gitignore` is not a security boundary, repository context packing (`ev
37
39
  - **SSH Keys**: `id_rsa*`, `id_dsa*`, `id_ecdsa*`, `id_ed25519*`
38
40
  - **Known Credentials & Tokens**: `credentials.json`, `credentials.*`, `secrets.*`, `.netrc`, `.npmrc`, `.pypirc`, `*.tfvars`
39
41
 
40
- This denylist is applied as defense-in-depth alongside automatic text secret redaction (`redact_secrets`), which remains active on all text before provider transmission.
42
+ #### Defense-in-Depth Overrides & Auditing
43
+ - **Persistent Allowlist**: Specific non-secret template files can be exempted via `eva config allow-sensitive-file <glob>`.
44
+ - **Audited Force-Include (`--force-include`)**: Users can explicitly pass `--force-include <pattern>` to `eva investigate` or `eva ask --repo`. Every force-included access to a denylisted file is recorded in the append-only SHA-256 hash-chained audit log with action `sensitive_file_override`.
41
45
 
42
46
  ### Agentic Investigation Tool Security (`eva investigate`)
43
47
 
44
48
  For Codex-style agentic exploration (`eva investigate`), all tool invocations (`list_directory`, `read_file`, `search_code`) operate under strict defense-in-depth rules:
45
49
 
46
50
  1. **Strict Path Containment**: Every invocation enforces relative root containment via `Path.resolve()`. Any path traversal outside the repository root (`../` escape) is rejected with a structured error without raising unhandled exceptions.
47
- 2. **Denylist & Gitignore Exclusion**: Denylisted files and `.gitignore`-matched paths are hidden from `list_directory` listings and `search_code` hits, and rejected with a security error on `read_file`.
51
+ 2. **Denylist & Gitignore Exclusion**: Denylisted files and `.gitignore`-matched paths are hidden from `list_directory` listings and `search_code` hits, and rejected with a security error on `read_file` (unless explicitly force-included).
48
52
  3. **Secret Redaction**: Content returned by `read_file` and matching lines from `search_code` pass through `redact_secrets()` before being added to model context.
49
53
  4. **Session Audit Logging**: Each completed or partial investigation session appends a hash-chained audit entry recording the query, provider, relative `files_read`, turn count, and `stopped_reason`.
50
54
 
51
55
 
56
+
52
57
  ---
53
58
 
54
59
  ## 2. Hash-Chained Audit Log
@@ -1,9 +1,9 @@
1
1
  [project]
2
2
  name = "eva-cli"
3
- version = "4.1.0"
3
+ version = "4.3.1"
4
4
 
5
5
 
6
- description = "Command Line Intelligence"
6
+ description = "AI-powered terminal assistant focused on security, speed, and cross-platform workflows."
7
7
  readme = "README.md"
8
8
  requires-python = ">=3.10"
9
9
  dependencies = [
@@ -12,6 +12,7 @@ dependencies = [
12
12
  "pydantic-settings>=2.0.0,<3.0.0",
13
13
  "platformdirs>=4.0.0,<5.0.0",
14
14
  "keyring>=25.0.0,<26.0.0",
15
+ "cryptography>=43.0.0,<47.0.0",
15
16
  "diskcache>=5.6.0,<6.0.0",
16
17
  "tenacity>=9.0.0,<10.0.0",
17
18
  "rich>=13.0.0,<15.0.0",