eva-cli 3.0.1__tar.gz → 4.1.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 (197) hide show
  1. {eva_cli-3.0.1 → eva_cli-4.1.0}/.github/workflows/ci.yaml +12 -2
  2. eva_cli-4.1.0/.github/workflows/fastwalk-release.yml +145 -0
  3. {eva_cli-3.0.1 → eva_cli-4.1.0}/.gitignore +3 -0
  4. eva_cli-4.1.0/CHANGELOG.md +232 -0
  5. {eva_cli-3.0.1 → eva_cli-4.1.0}/CONTRIBUTING.md +2 -2
  6. {eva_cli-3.0.1 → eva_cli-4.1.0}/PKG-INFO +104 -6
  7. {eva_cli-3.0.1 → eva_cli-4.1.0}/README.md +100 -4
  8. eva_cli-4.1.0/SECURITY.md +100 -0
  9. eva_cli-4.1.0/assets/eva.png +0 -0
  10. eva_cli-4.1.0/docs/README.md +19 -0
  11. eva_cli-4.1.0/docs/architecture.md +94 -0
  12. eva_cli-4.1.0/docs/command-reference.md +197 -0
  13. eva_cli-4.1.0/docs/configuration.md +140 -0
  14. eva_cli-4.1.0/docs/index.md +83 -0
  15. eva_cli-4.1.0/docs/plugins.md +92 -0
  16. eva_cli-4.1.0/docs/provider-behavior.md +60 -0
  17. eva_cli-4.1.0/docs/security-model.md +117 -0
  18. eva_cli-4.1.0/examples/eva-plugin-hello/README.md +21 -0
  19. eva_cli-4.1.0/examples/eva-plugin-hello/eva_plugin_hello.py +18 -0
  20. eva_cli-4.1.0/examples/eva-plugin-hello/pyproject.toml +16 -0
  21. {eva_cli-3.0.1 → eva_cli-4.1.0}/install.sh +4 -4
  22. {eva_cli-3.0.1 → eva_cli-4.1.0}/pyproject.toml +5 -1
  23. {eva_cli-3.0.1 → eva_cli-4.1.0}/rust/eva_fastwalk/Cargo.toml +3 -1
  24. eva_cli-4.1.0/rust/eva_fastwalk/pyproject.toml +24 -0
  25. {eva_cli-3.0.1 → eva_cli-4.1.0}/rust/eva_fastwalk/src/lib.rs +5 -3
  26. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/__init__.py +1 -1
  27. eva_cli-4.1.0/src/eva/agent/__init__.py +12 -0
  28. eva_cli-4.1.0/src/eva/agent/loop.py +251 -0
  29. eva_cli-4.1.0/src/eva/agent/tools.py +174 -0
  30. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/cli/app.py +341 -10
  31. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/config/config.py +7 -4
  32. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/indexing/__init__.py +3 -0
  33. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/indexing/io.py +1 -2
  34. eva_cli-4.1.0/src/eva/indexing/packer.py +237 -0
  35. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/indexing/repo_index.py +1 -1
  36. eva_cli-4.1.0/src/eva/indexing/tokenizer.py +131 -0
  37. eva_cli-4.1.0/src/eva/plugins/__init__.py +11 -0
  38. eva_cli-4.1.0/src/eva/plugins/loader.py +102 -0
  39. eva_cli-4.1.0/src/eva/plugins/protocol.py +45 -0
  40. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/prompts/__init__.py +5 -0
  41. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/providers/__init__.py +111 -0
  42. eva_cli-4.1.0/src/eva/providers/gemini_provider.py +156 -0
  43. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/providers/llamacpp_provider.py +4 -2
  44. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/providers/ollama_provider.py +4 -2
  45. eva_cli-4.1.0/src/eva/providers/openai_compat.py +146 -0
  46. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/security/__init__.py +9 -0
  47. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/security/audit.py +21 -1
  48. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/security/redaction.py +3 -3
  49. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/security/sandbox.py +33 -2
  50. eva_cli-4.1.0/src/eva/security/sensitive_files.py +31 -0
  51. eva_cli-4.1.0/src/eva/security/work_safety.py +166 -0
  52. eva_cli-4.1.0/src/eva/shell/runner.py +11 -0
  53. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/telemetry/diagnostics.py +4 -2
  54. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/workflows/budget.py +39 -16
  55. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/workspace/git_ops.py +14 -3
  56. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/workspace/gitignore.py +1 -2
  57. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/conftest.py +6 -0
  58. eva_cli-4.1.0/tests/fixtures/golden/prompts/changes_system_prompt.txt +3 -0
  59. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/test_basic.py +12 -10
  60. eva_cli-4.1.0/tests/unit/agent/test_loop.py +116 -0
  61. eva_cli-4.1.0/tests/unit/agent/test_tools.py +53 -0
  62. eva_cli-4.1.0/tests/unit/cli/test_ask_repo.py +97 -0
  63. eva_cli-4.1.0/tests/unit/cli/test_changes_command.py +51 -0
  64. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/cli/test_cli.py +15 -0
  65. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/cli/test_cli_commands.py +56 -1
  66. eva_cli-4.1.0/tests/unit/cli/test_investigate.py +68 -0
  67. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/config/test_config_keys.py +32 -0
  68. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/golden/test_golden_prompts.py +7 -0
  69. eva_cli-4.1.0/tests/unit/indexing/test_packer.py +72 -0
  70. eva_cli-4.1.0/tests/unit/indexing/test_tokenizer_offline.py +117 -0
  71. eva_cli-4.1.0/tests/unit/plugins/__init__.py +1 -0
  72. eva_cli-4.1.0/tests/unit/plugins/test_plugins.py +272 -0
  73. eva_cli-4.1.0/tests/unit/providers/test_context_budget.py +26 -0
  74. eva_cli-4.1.0/tests/unit/providers/test_dispatch_caching.py +102 -0
  75. eva_cli-4.1.0/tests/unit/providers/test_gemini_tools.py +58 -0
  76. eva_cli-4.1.0/tests/unit/providers/test_openai_compat_tools.py +72 -0
  77. eva_cli-4.1.0/tests/unit/providers/test_provider_tools_protocol.py +42 -0
  78. eva_cli-4.1.0/tests/unit/providers/test_repo_caching.py +33 -0
  79. eva_cli-4.1.0/tests/unit/security/test_allowlist_cli.py +77 -0
  80. eva_cli-4.1.0/tests/unit/security/test_audit.py +29 -0
  81. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/security/test_sandbox.py +12 -0
  82. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/security/test_work_safety.py +55 -0
  83. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/telemetry/test_telemetry.py +3 -0
  84. eva_cli-4.1.0/tests/unit/test_compatibility_imports.py +31 -0
  85. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/workflows/test_workflow_engine.py +19 -4
  86. eva_cli-3.0.1/CHANGELOG.md +0 -84
  87. eva_cli-3.0.1/SECURITY.md +0 -77
  88. eva_cli-3.0.1/assets/logo.png +0 -0
  89. eva_cli-3.0.1/src/eva/budget.py +0 -31
  90. eva_cli-3.0.1/src/eva/cache.py +0 -19
  91. eva_cli-3.0.1/src/eva/chat_session.py +0 -5
  92. eva_cli-3.0.1/src/eva/config.py +0 -35
  93. eva_cli-3.0.1/src/eva/context/__init__.py +0 -19
  94. eva_cli-3.0.1/src/eva/context/finder.py +0 -5
  95. eva_cli-3.0.1/src/eva/context/gitignore.py +0 -5
  96. eva_cli-3.0.1/src/eva/context/io.py +0 -5
  97. eva_cli-3.0.1/src/eva/context/tokenizer.py +0 -5
  98. eva_cli-3.0.1/src/eva/context/tree.py +0 -5
  99. eva_cli-3.0.1/src/eva/diagnostics.py +0 -9
  100. eva_cli-3.0.1/src/eva/git_ops.py +0 -15
  101. eva_cli-3.0.1/src/eva/indexing/tokenizer.py +0 -37
  102. eva_cli-3.0.1/src/eva/plugins/__init__.py +0 -3
  103. eva_cli-3.0.1/src/eva/providers/gemini_provider.py +0 -72
  104. eva_cli-3.0.1/src/eva/providers/openai_compat.py +0 -57
  105. eva_cli-3.0.1/src/eva/router/__init__.py +0 -25
  106. eva_cli-3.0.1/src/eva/router/gemini_provider.py +0 -5
  107. eva_cli-3.0.1/src/eva/router/groq_provider.py +0 -5
  108. eva_cli-3.0.1/src/eva/router/openai_compat.py +0 -5
  109. eva_cli-3.0.1/src/eva/router/opencode_zen_provider.py +0 -5
  110. eva_cli-3.0.1/src/eva/router/openrouter_provider.py +0 -5
  111. eva_cli-3.0.1/src/eva/security/work_safety.py +0 -85
  112. eva_cli-3.0.1/src/eva/shell/runner.py +0 -6
  113. eva_cli-3.0.1/src/eva/work_safety.py +0 -21
  114. eva_cli-3.0.1/tests/unit/test_compatibility_imports.py +0 -25
  115. {eva_cli-3.0.1 → eva_cli-4.1.0}/.github/workflows/release.yml +0 -0
  116. {eva_cli-3.0.1 → eva_cli-4.1.0}/.pre-commit-config.yaml +0 -0
  117. {eva_cli-3.0.1 → eva_cli-4.1.0}/Dockerfile +0 -0
  118. {eva_cli-3.0.1 → eva_cli-4.1.0}/LICENSE +0 -0
  119. {eva_cli-3.0.1 → eva_cli-4.1.0}/assets/demo.gif +0 -0
  120. {eva_cli-3.0.1 → eva_cli-4.1.0}/assets/demo2.gif +0 -0
  121. {eva_cli-3.0.1 → eva_cli-4.1.0}/assets/demo3.gif +0 -0
  122. {eva_cli-3.0.1 → eva_cli-4.1.0}/assets/demo4.gif +0 -0
  123. {eva_cli-3.0.1 → eva_cli-4.1.0}/assets/demo5.gif +0 -0
  124. {eva_cli-3.0.1 → eva_cli-4.1.0}/rust/eva_fastwalk/Cargo.lock +0 -0
  125. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/cache/__init__.py +0 -0
  126. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/cache/cache.py +0 -0
  127. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/cli/__init__.py +0 -0
  128. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/cli.py +0 -0
  129. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/config/__init__.py +0 -0
  130. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/indexing/finder.py +0 -0
  131. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/indexing/tree.py +0 -0
  132. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/providers/groq_provider.py +0 -0
  133. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/providers/opencode_zen_provider.py +0 -0
  134. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/providers/openrouter_provider.py +0 -0
  135. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/replay/__init__.py +0 -0
  136. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/replay/player.py +0 -0
  137. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/replay/recorder.py +0 -0
  138. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/shell/__init__.py +0 -0
  139. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/telemetry/__init__.py +0 -0
  140. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/telemetry/metrics.py +0 -0
  141. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/ui/formatter.py +0 -0
  142. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/ui/streaming.py +0 -0
  143. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/workflows/__init__.py +0 -0
  144. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/workflows/builtins/dependency_audit.yaml +0 -0
  145. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/workflows/builtins/repo_health.yaml +0 -0
  146. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/workflows/builtins/security_scan.yaml +0 -0
  147. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/workflows/chat_session.py +0 -0
  148. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/workflows/engine.py +0 -0
  149. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/workspace/__init__.py +0 -0
  150. {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/workspace/session.py +0 -0
  151. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/fixtures/golden/patches/sample1_expected.diff +0 -0
  152. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/fixtures/golden/patches/sample1_fenced.txt +0 -0
  153. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/fixtures/golden/prompts/analyze_system_prompt.txt +0 -0
  154. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/fixtures/golden/prompts/ask_system_prompt.txt +0 -0
  155. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/fixtures/golden/prompts/chat_system_prompt.txt +0 -0
  156. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/fixtures/golden/prompts/commit_system_prompt.txt +0 -0
  157. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/fixtures/golden/prompts/edit_system_prompt.txt +0 -0
  158. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/fixtures/golden/prompts/explain_system_prompt.txt +0 -0
  159. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/fixtures/golden/prompts/work_system_prompt.txt +0 -0
  160. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/__init__.py +0 -0
  161. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/cache/__init__.py +0 -0
  162. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/cache/test_cache.py +0 -0
  163. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/cli/__init__.py +0 -0
  164. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/cli/test_cli_coverage.py +0 -0
  165. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/cli/test_cli_more.py +0 -0
  166. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/config/__init__.py +0 -0
  167. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/config/test_config.py +0 -0
  168. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/golden/__init__.py +0 -0
  169. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/golden/test_golden_patches.py +0 -0
  170. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/indexing/__init__.py +0 -0
  171. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/indexing/test_indexing.py +0 -0
  172. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/indexing/test_indexing_more.py +0 -0
  173. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/indexing/test_repo_index.py +0 -0
  174. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/providers/__init__.py +0 -0
  175. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/providers/test_offline_providers.py +0 -0
  176. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/providers/test_provider_coverage.py +0 -0
  177. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/providers/test_provider_errors.py +0 -0
  178. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/providers/test_providers.py +0 -0
  179. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/providers/test_providers_more.py +0 -0
  180. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/replay/test_replay.py +0 -0
  181. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/security/__init__.py +0 -0
  182. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/security/test_audit_chain.py +0 -0
  183. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/security/test_redaction.py +0 -0
  184. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/security/test_safety_audit.py +0 -0
  185. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/shell/__init__.py +0 -0
  186. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/shell/test_shell.py +0 -0
  187. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/telemetry/__init__.py +0 -0
  188. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/telemetry/test_metrics.py +0 -0
  189. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/ui/__init__.py +0 -0
  190. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/ui/test_ui.py +0 -0
  191. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/workflows/__init__.py +0 -0
  192. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/workflows/test_chat_session.py +0 -0
  193. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/workflows/test_workflows.py +0 -0
  194. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/workspace/__init__.py +0 -0
  195. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/workspace/test_git_ops.py +0 -0
  196. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/workspace/test_session_workspace.py +0 -0
  197. {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/workspace/test_workspace.py +0 -0
@@ -7,9 +7,10 @@ on:
7
7
 
8
8
  jobs:
9
9
  test:
10
- runs-on: ubuntu-latest
10
+ runs-on: ${{ matrix.os }}
11
11
  strategy:
12
12
  matrix:
13
+ os: [ubuntu-latest, windows-latest, macos-latest]
13
14
  python-version: ["3.10", "3.11", "3.12"]
14
15
  steps:
15
16
  - uses: actions/checkout@v4
@@ -19,9 +20,18 @@ jobs:
19
20
  with:
20
21
  python-version: ${{ matrix.python-version }}
21
22
 
22
- - name: Install ripgrep
23
+ - name: Install ripgrep (Linux)
24
+ if: runner.os == 'Linux'
23
25
  run: sudo apt-get update && sudo apt-get install -y ripgrep
24
26
 
27
+ - name: Install ripgrep (macOS)
28
+ if: runner.os == 'macOS'
29
+ run: brew install ripgrep
30
+
31
+ - name: Install ripgrep (Windows)
32
+ if: runner.os == 'Windows'
33
+ run: choco install ripgrep
34
+
25
35
  - name: Install dependencies
26
36
  run: python -m pip install -e ".[dev]"
27
37
 
@@ -0,0 +1,145 @@
1
+ # .github/workflows/fastwalk-release.yml
2
+ #
3
+ # Triggers on a tag like: fastwalk-v0.1.0
4
+ # git tag fastwalk-v0.1.0 && git push origin fastwalk-v0.1.0
5
+ #
6
+ # Separate from release.yml (main `eva` package) on purpose — this crate
7
+ # changes rarely and needs a real per-platform build matrix, so it gets
8
+ # its own version number and its own tag prefix.
9
+ #
10
+ # One wheel per platform covers all of Python 3.10+ because Cargo.toml
11
+ # already builds pyo3 with the "abi3-py310" feature (stable ABI).
12
+ #
13
+ # Before first use: register rootagi/eva as a trusted publisher for the
14
+ # "eva-fastwalk" PyPI project (pypi.org -> project -> Publishing),
15
+ # workflow filename fastwalk-release.yml, environment name "pypi".
16
+
17
+ name: Release eva_fastwalk
18
+
19
+ on:
20
+ push:
21
+ tags: ["fastwalk-v*"]
22
+
23
+ permissions:
24
+ id-token: write # PyPI trusted publishing (OIDC)
25
+ contents: write # to attach files to the GitHub Release
26
+
27
+
28
+ jobs:
29
+ linux:
30
+ name: Linux wheels (${{ matrix.target }})
31
+ runs-on: ${{ matrix.runner }}
32
+ strategy:
33
+ fail-fast: false
34
+ matrix:
35
+ include:
36
+ - runner: ubuntu-latest
37
+ target: x86_64
38
+ - runner: ubuntu-24.04-arm
39
+ target: aarch64
40
+ steps:
41
+ - uses: actions/checkout@v4
42
+ - name: Build wheel
43
+ uses: PyO3/maturin-action@v1
44
+ with:
45
+ working-directory: rust/eva_fastwalk
46
+ target: ${{ matrix.target }}
47
+ args: --release --out ../../dist -i python3.10
48
+ manylinux: auto
49
+ - uses: actions/upload-artifact@v4
50
+ with:
51
+ name: wheels-linux-${{ matrix.target }}
52
+ path: dist
53
+
54
+ macos:
55
+ name: macOS wheels (${{ matrix.target }})
56
+ runs-on: ${{ matrix.runner }}
57
+ strategy:
58
+ fail-fast: false
59
+ matrix:
60
+ include:
61
+ - runner: macos-latest # Intel (cross-compiled)
62
+ target: x86_64
63
+ - runner: macos-latest # Apple Silicon
64
+ target: aarch64
65
+
66
+ steps:
67
+ - uses: actions/checkout@v4
68
+ - name: Build wheel
69
+ uses: PyO3/maturin-action@v1
70
+ with:
71
+ working-directory: rust/eva_fastwalk
72
+ target: ${{ matrix.target }}
73
+ args: --release --out ../../dist -i python3.10
74
+ - uses: actions/upload-artifact@v4
75
+ with:
76
+ name: wheels-macos-${{ matrix.target }}
77
+ path: dist
78
+
79
+ windows:
80
+ name: Windows wheel
81
+ runs-on: windows-latest
82
+ steps:
83
+ - uses: actions/checkout@v4
84
+ - name: Build wheel
85
+ uses: PyO3/maturin-action@v1
86
+ with:
87
+ working-directory: rust/eva_fastwalk
88
+ target: x64
89
+ args: --release --out ../../dist -i python3.10
90
+ - uses: actions/upload-artifact@v4
91
+ with:
92
+ name: wheels-windows
93
+ path: dist
94
+
95
+ sdist:
96
+ name: Source distribution
97
+ runs-on: ubuntu-latest
98
+ steps:
99
+ - uses: actions/checkout@v4
100
+ - name: Build sdist
101
+ uses: PyO3/maturin-action@v1
102
+ with:
103
+ working-directory: rust/eva_fastwalk
104
+ command: sdist
105
+ args: --out ../../dist
106
+ - uses: actions/upload-artifact@v4
107
+ with:
108
+ name: wheels-sdist
109
+ path: dist
110
+
111
+ publish:
112
+ name: Publish to PyPI
113
+ needs: [linux, macos, windows, sdist]
114
+ runs-on: ubuntu-latest
115
+ environment: pypi
116
+ steps:
117
+ - uses: actions/download-artifact@v4
118
+ with:
119
+ pattern: wheels-*
120
+ path: dist
121
+ merge-multiple: true
122
+ - uses: pypa/gh-action-pypi-publish@release/v1
123
+ with:
124
+ packages-dir: dist
125
+ skip-existing: true
126
+
127
+
128
+ github-release:
129
+ name: Attach files to GitHub Release
130
+ needs: [linux, macos, windows, sdist]
131
+ runs-on: ubuntu-latest
132
+ permissions:
133
+ contents: write
134
+ steps:
135
+ - uses: actions/download-artifact@v4
136
+ with:
137
+ pattern: wheels-*
138
+ path: dist
139
+ merge-multiple: true
140
+ - name: Create/update GitHub Release
141
+ uses: softprops/action-gh-release@v2
142
+ with:
143
+ files: dist/*
144
+ generate_release_notes: true
145
+
@@ -30,12 +30,15 @@ MANIFEST
30
30
  .pytest_cache/
31
31
  .ruff_cache/
32
32
  .coverage
33
+ .hypothesis/
33
34
  htmlcov/
34
35
 
35
36
  # Virtual Environments
36
37
  venv/
37
38
  env/
38
39
  .venv/
40
+ .venv*/
41
+
39
42
 
40
43
  # Rust build artifacts
41
44
  rust/**/target/
@@ -0,0 +1,232 @@
1
+ # Changelog
2
+
3
+ All notable changes to Eva CLI will be documented in this file.
4
+
5
+ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
6
+ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
+
8
+
9
+
10
+ ## [4.1.0] - 2026-08-11
11
+
12
+ ### Added
13
+ - **Agentic Repo Exploration (`eva investigate`):**
14
+ - Added `eva investigate <query> [path]` command for multi-turn, query-driven codebase exploration using tool calling (`list_directory`, `read_file`, `search_code`).
15
+ - Added optional tool-calling capabilities to Provider protocol (`supports_tools`, `TextDelta`/`ToolCall` streaming events, `generate_with_tools`).
16
+ - Implemented streamed tool calling for OpenAI-compatible providers (`groq`, `openrouter`, `opencode_zen`) and `GeminiProvider`.
17
+ - Added upfront provider capability check (`is_tool_capable()`), producing a clear actionable error for non-tool-capable providers (`ollama`, `llamacpp`).
18
+ - Agent loop controller in `src/eva/agent/loop.py` featuring turn limits (`max_turns`), quota accounting per turn (`check_and_increment`), repeated tool call loop detection, and graceful partial answer degradation.
19
+ - Defense-in-depth security: path containment check on every tool call (`Path.resolve()`), sensitive-file denylist (`DENYLIST_PATTERNS`) and `.gitignore` gating, secret redaction (`redact_secrets`), and session-level hash-chained audit logging (`append_investigation_audit`).
20
+ - **Repo-wide context packing (`src/eva/indexing/packer.py`, `src/eva/security/sensitive_files.py`, `src/eva/cli/app.py`):**
21
+ - Added `--repo` flag to `eva ask` to pack entire repositories as plain-text LLM context up to per-provider token budgets.
22
+ - Smart deterministic file ranking prioritizing Python module dependency centrality, shallow directory depth, and file size.
23
+ - Built-in sensitive-file denylist (`DENYLIST_PATTERNS` in `src/eva/security/sensitive_files.py`) excluding `.env`, private keys (`*.pem`, `*.key`), SSH keys (`id_rsa*`, `id_ed25519*`), and credential files independently of `.gitignore` state.
24
+ - User confirmation prompt gating, Rich table summary reports, and `--dry-run` inspection mode.
25
+ - Cryptographic hash-chained audit logging (`action: repo_pack`) for provenance recording of sent repo contexts.
26
+ - **Uniform per-provider context budget lookup (`src/eva/providers/__init__.py`):**
27
+ - Added `get_context_budget(provider_name, config)` returning provider token limits with a conservative default fallback (4000).
28
+
29
+ - **Disk-backed response caching integration (`src/eva/providers/__init__.py`, `src/eva/cli/app.py`):**
30
+ - `dispatch()` now checks and populates the disk cache (backed by `diskcache`) before calling the live provider. Repeated identical requests return instantly from cache.
31
+ - Added `use_cache` parameter to `dispatch()` (default `True`).
32
+ - Added `--no-cache` flag to `eva ask` to bypass the response cache.
33
+ - Error responses (matching `is_ai_error()`) are never written to the cache.
34
+ - **Cache command group (`src/eva/cli/app.py`):**
35
+ - Added `eva cache clear` subcommand to clear all cached responses.
36
+ - **Directory context for ask (`src/eva/cli/app.py`):**
37
+ - Added `--dir` / `-d` option to `eva ask` to include `.gitignore`-aware directory tree context. Supports multiple `--dir` and combined `--dir` + `--file` options with 4000-token budget context trimming.
38
+ - **Git diff explanation command (`src/eva/cli/app.py`, `src/eva/prompts/__init__.py`):**
39
+ - Added `eva changes` command (with `--staged` support) to explain git diffs using dedicated `CHANGES_SYSTEM_PROMPT`.
40
+
41
+ ### Changed
42
+ - **Renamed `eva commit` to `eva commit-message` (`src/eva/cli/app.py`):**
43
+ - Breaking change: renamed CLI command `eva commit` to `eva commit-message` to match documentation. Users scripting against `eva commit` should update their scripts to `eva commit-message`.
44
+ - **Documentation cleanup (`README.md`, `docs/`):**
45
+ - Removed outdated `eva analyse` references across documentation files in favor of `eva analyze`.
46
+
47
+ ### Fixed
48
+ - **`eva-fastwalk` Crate Update (v0.1.1, `rust/eva_fastwalk/`):**
49
+ - Restructured `ALWAYS_IGNORED_DIRS` filtering in `rust/eva_fastwalk/src/lib.rs` so ignore checks apply strictly to directory entries rather than file entries.
50
+ - Bumped version in `rust/eva_fastwalk/Cargo.toml` to `0.1.1`.
51
+ - **Shell Runner Sandboxing (`src/eva/shell/runner.py`):**
52
+ - Updated `execute_shell_command()` to route through `run_sandboxed` with strict environment variable filtering and timeout handling.
53
+ - **Agent Multi-Tool Call Loop Tracking (`src/eva/agent/loop.py`):**
54
+ - Refactored `run_investigation()` signature tracking from single-signature overwrites to turn-level signature list comparison (`last_turn_signatures`), properly identifying multi-tool call loops across turns.
55
+ - **UTF-8 Byte Slicing (`src/eva/indexing/io.py`):**
56
+ - Corrected read limit byte slicing order before UTF-8 decoding to prevent character truncation errors at context limits.
57
+ - **Path Resolution & Fallback Diff Security (`src/eva/workspace/git_ops.py`):**
58
+ - Added target path resolution and containment checks in `apply_diff_python_fallback()`.
59
+ - **Entropy Secret Redaction (`src/eva/security/redaction.py`):**
60
+ - Added URL pattern exclusions (`http://`, `https://`) in high-entropy token detection to avoid false-positive redactions of standard API URLs.
61
+ - **Diagnostics Logging Guard (`src/eva/telemetry/diagnostics.py`):**
62
+ - Replaced function-attribute singleton state with a module-level `_logging_configured` flag for reliable state tracking.
63
+ - **Stack Framework Operator Precedence (`src/eva/indexing/repo_index.py`):**
64
+ - Added explicit parentheses around `conftest.py` and `tests/` directory detection to fix operator evaluation order.
65
+
66
+ ### Removed
67
+ - **Legacy shim cleanup (`src/eva/`):**
68
+ - Removed unused flat compatibility shim files (`config.py`, `cache.py`, `budget.py`, `work_safety.py`, `git_ops.py`, `chat_session.py`, `diagnostics.py`). Code and tests now import directly from standard package locations (`eva.config`, `eva.cache`, `eva.workflows.budget`, `eva.security.work_safety`, `eva.workspace.git_ops`, `eva.workflows.chat_session`, `eva.telemetry.diagnostics`).
69
+
70
+ ## [4.0.0] - 2026-08-10
71
+
72
+ ### Added
73
+ - **PyPI Packaging & Release Workflow for `eva_fastwalk` Extension (`rust/eva_fastwalk/`, `.github/workflows/fastwalk-release.yml`):**
74
+ - Added `rust/eva_fastwalk/pyproject.toml` configured with `maturin` build backend for PyPI distribution package `eva-fastwalk`.
75
+ - Added `license = "MIT"` to `[package]` in `rust/eva_fastwalk/Cargo.toml`.
76
+ - Created `.github/workflows/fastwalk-release.yml` for building multi-platform wheel matrix (Linux x86_64/aarch64, macOS x86_64/aarch64, Windows x64, sdist) and publishing to PyPI via OIDC trusted publishing on `fastwalk-v*` tags.
77
+ - Added `fast` opt-in extra (`eva-fastwalk>=0.1.0,<0.2.0`) under `[project.optional-dependencies]` in `pyproject.toml` to maintain zero-dependency `eva-cli` installs.
78
+ - Updated `install.sh` and `README.md` to document `eva-cli[fast]` installation.
79
+
80
+
81
+
82
+ ### Added
83
+
84
+ - **Shell Completion (`src/eva/cli/app.py`):**
85
+ - Turned shell completion on in Typer CLI app (`add_completion=True`), enabling `--install-completion` and `--show-completion`.
86
+ - Added support and verification for `bash`, `zsh`, and `fish` shell completion.
87
+ - Documented shell completion installation (`eva --install-completion`) in `README.md`.
88
+ - Added unit test suite covering shell completion output generation in `tests/unit/cli/test_cli.py`.
89
+ - **Cross-Platform CI & OS Compatibility (`.github/workflows/ci.yaml`, `src/eva/`):**
90
+ - Extended CI matrix to test across `ubuntu-latest`, `windows-latest`, and `macos-latest` on Python 3.10, 3.11, and 3.12.
91
+ - Fixed cross-platform path handling in `src/eva/workspace/gitignore.py` using `.as_posix()` for `pathspec` pattern matching.
92
+ - Hardened sandboxed subprocess execution in `src/eva/security/sandbox.py` and `src/eva/security/work_safety.py` for Windows system environment variables and `shlex` argument splitting (`posix=(sys.platform != "win32")`).
93
+ - Updated `keyring_backend_available()` in `src/eva/config/config.py` to handle zero-priority backends (`fail.Keyring`) and degrade to `EVA_*_API_KEY` environment variables on headless CI runners.
94
+ - Added explicit unit tests for keyring backend fallback in `tests/unit/config/test_config_keys.py`.
95
+ - Documented cross-platform support and OS limitations in `README.md`.
96
+
97
+
98
+
99
+ ### Fixed
100
+ - **Offline tokenization (`src/eva/indexing/tokenizer.py`):**
101
+ - `count_tokens()` and `trim_context()` no longer crash on restricted-network machines
102
+ (corporate proxy, air-gapped box, CI runner) when tiktoken cannot download
103
+ `cl100k_base.tiktoken` from `openaipublic.blob.core.windows.net`.
104
+ - Broadened exception handling from a narrow set (`ValueError, KeyError, RuntimeError,
105
+ TypeError`) to `Exception`, covering `HTTPError`, `ConnectionError`, `OSError`, and
106
+ any other network or SSL failure that tiktoken may raise.
107
+ - The encoding is now loaded once and cached at module level; degradation logs a single
108
+ `WARNING` message instead of repeating on every call.
109
+ - Graceful fallback: when the encoding cannot be loaded, token counting approximates via
110
+ `len(text) // 4` and trimming approximates via character count × 4 — matching the
111
+ existing fallback logic that was previously unreachable for network errors.
112
+
113
+ ### Added
114
+ - **`EVA_TIKTOKEN_ENCODING_PATH` config/env var (`src/eva/config/config.py`):**
115
+ - New `tiktoken_encoding_path` field in `GeneralConfig` (readable from the
116
+ `EVA_TIKTOKEN_ENCODING_PATH` environment variable or `config.toml`).
117
+ - When set, the tokenizer loads the BPE vocabulary from that local file path
118
+ instead of attempting a network download, enabling fully air-gapped deployments.
119
+ - **Offline tokenizer tests (`tests/unit/indexing/test_tokenizer_offline.py`):**
120
+ - 8 new tests covering: approximation fallback for `count_tokens` and `trim_context`,
121
+ all exception types handled without crash, warning logged exactly once, custom
122
+ encoding path bypasses download, and bad custom path degrades gracefully.
123
+
124
+
125
+
126
+ ### Added
127
+ - **Opt-In Command Allowlist (`allowed_command_prefixes`):**
128
+ - Configured via `allowed_command_prefixes` in `GeneralConfig` (`config.toml`). Empty list defaults to off (denylist-only).
129
+ - CLI management commands: `eva config allow-command <prefix>`, `eva config disallow-command <prefix>`, and `eva config import-allowlist <path>`.
130
+ - Extended `eva config show` to display active allowlist state.
131
+ - **Argv-Based Default Subprocess Execution:**
132
+ - Commands executed in sandbox (and `eva work`) default to `shlex.split` / `shell=False`, preventing shell metacharacter injection.
133
+ - Added `--allow-shell-features` flag to `eva work` for opting into shell features (pipes and redirection).
134
+ - **Safety Check Transparency (`--dry-run-explain`):**
135
+ - Added `--dry-run-explain` flag to `eva work` that generates and prints a full summary table of all safety check results (extraction, blast-radius scan, allowlist check, shlex syntax parsing) before execution.
136
+ - **Security Hardening Documentation:**
137
+ - Updated `SECURITY.md` Section 3 ("Command Execution Hardening & Defense in Depth") detailing the multi-layered safety framework, argv execution trade-offs, and explicit security limitations.
138
+
139
+
140
+
141
+ ### Breaking
142
+ - **Removed `eva.router` and `eva.context` compatibility shim packages.**
143
+ These re-exported names from the canonical modules and have been superseded since v2.2.0.
144
+ - `eva.router` → use `eva.providers`
145
+ - `eva.context` → use `eva.indexing` / `eva.workspace`
146
+
147
+
148
+
149
+ ### Added
150
+ - **Plugin Architecture Subsystem (`src/eva/plugins/`):**
151
+ - Abstract base class `EvaPlugin` (`src/eva/plugins/protocol.py`) defining lifecycle hooks for registering CLI commands (`register_commands`), contributing custom LLM providers (`register_providers`), and registering workflow step hooks (`register_workflow_hooks`).
152
+ - Automatic discovery mechanism (`src/eva/plugins/loader.py`) using Python standard `importlib.metadata.entry_points` (`[project.entry-points."eva.plugins"]`).
153
+ - Fail-soft error handling: broken plugins log warnings and are safely skipped without crashing CLI startup.
154
+ - Included a reference example plugin (`examples/eva-plugin-hello/`) adding a `hello` command.
155
+
156
+ ## [3.0.1] - 2026-08-06
157
+ ### Fixed
158
+ - Added support for custom focus prompts in `eva analyze`.
159
+ - Added `-y`/`--yes` auto-approve flag to `eva workflow run` to prevent piping stalls.
160
+
161
+ ## [3.0.0] - 2026-08-05
162
+
163
+ ### Added
164
+ - **Security Hardening Framework (`src/eva/security/`):**
165
+ - Centralized secret and API-key redaction (`src/eva/security/redaction.py`) combining regex pattern matching for API keys, tokens, and private key blocks with Shannon entropy threshold checks ($H(S) > 3.5$). Redaction is executed **before** any provider network request and before writing to local disk.
166
+ - Cryptographic hash-chained audit log (`src/eva/security/audit.py`) with sequential SHA-256 signatures for tamper detection (`verify_audit_chain()`).
167
+ - Sandboxed execution (`src/eva/security/sandbox.py`) providing a restricted subprocess environment with environment variable stripping, stdin isolation, and execution timeouts. Opt-in via `sandbox_risky_commands = true` in config.
168
+ - **Terminal Replay Subsystem (`eva replay`):**
169
+ - Session execution recorder and player (`src/eva/replay/`). Captures command, output, exit code, duration, and working directory with automatic secret redaction at write time.
170
+ - New commands: `eva replay <session>` and `eva replay --list`.
171
+ - **Opt-In Telemetry (`src/eva/telemetry/`):**
172
+ - Local-only telemetry collector (`src/eva/telemetry/metrics.py`) tracking provider response latency, error rates, and success status only. Zero prompt text or file content collected. Disabled by default; opt-in via `telemetry_enabled = true`. Optional self-hosted HTTP POST export endpoint supported.
173
+ - **Documentation:**
174
+ - Created `SECURITY.md` detailing security mechanisms, redaction patterns, audit chain format, sandbox controls, and vulnerability reporting.
175
+
176
+ ## [2.3.0] - 2026-08-05
177
+
178
+
179
+ ### Added
180
+ - **Declarative Workflow Engine (`eva workflow`):** YAML workflow definitions with approval gates reusing Phase 1 work safety policy (`eva workflow run`, `eva workflow list`, `eva workflow show`). Shipped 3 built-in workflows: `repo_health`, `dependency_audit`, and `security_scan`.
181
+ - **Offline Model Support (`ollama` & `llamacpp`):** Added Ollama and llama.cpp GGUF backends with automatic local fallback when cloud providers are unreachable or quota-exhausted.
182
+ - **Project Understanding (`src/eva/indexing/repo_index.py`):** Automated project stack detection (languages, frameworks, package managers, test frameworks, CI configs) and module-level dependency graph feeding `eva explain` at repo roots.
183
+ - **Session Workspaces (`eva workspace`):** Named session contexts (`eva workspace create`, `switch`, `list`, `note`, `bookmark`, `show`) with secret redaction before writing to disk and strict isolation between workspace names.
184
+
185
+ ## [2.2.0] - 2026-08-05
186
+
187
+ ### Fixed
188
+ - **CRITICAL:** `eva changes` and `eva commit-message` no longer crash when git output contains bracket characters (Rich MarkupError).
189
+ - **BROKEN:** `eva tree <path>`, `eva grep <pattern> <path>`, and `eva find <pattern> <path>` now correctly accept path arguments.
190
+ - `eva doctor` now shows ⚠ for providers with missing API keys instead of a misleading ✔.
191
+ - `eva config status` no longer shows doubled emoji prefixes.
192
+ - Cache keys now include the model name, preventing stale responses when switching models within a provider.
193
+ - Option injection vulnerability in `eva grep` fixed by adding `--` separator before user arguments.
194
+
195
+ ### Changed
196
+ - Streaming responses now show real-time progress (`Receiving... (N chars)`) instead of a static spinner.
197
+ - Provider code refactored: OpenRouter, Groq, and OpenCode Zen now share an `OpenAICompatibleProvider` base class, eliminating ~90% code duplication.
198
+ - `cli.py` split into focused modules: `git_ops.py` for git operations and `chat_session.py` for the interactive REPL.
199
+ - Work safety blocklist hardened against absolute path bypasses, `env`/`command` prefix attacks, `xargs rm`, and interpreter code execution.
200
+
201
+ ### Added
202
+ - Multi-file context support: `eva ask --file a.py --file b.py` now accepts multiple `--file` flags.
203
+ - `--no-cache` flag for `eva ask` to bypass the response cache.
204
+ - `CONTRIBUTING.md` with development setup, architecture overview, and suggested contributions including local model integration.
205
+ - Explicit `__init__.py` for the `context` package.
206
+
207
+ ### Removed
208
+ - Stale `test_gemini.py` scratchpad file that was breaking pytest collection.
209
+
210
+ ## [2.1.0] - 2025-07-01
211
+
212
+ ### Added
213
+ - Provider abstraction with fallback routing across OpenRouter, Groq, Gemini, and OpenCode Zen.
214
+ - Streaming responses with disk-backed caching.
215
+ - Local RPM/RPD budget tracking.
216
+ - `.gitignore`-aware context collection.
217
+ - Safe file-context reads with binary-file and large-file handling.
218
+ - Hardened command generation via `eva work`.
219
+ - Git-aware workflows (`eva changes`, `eva commit-message`).
220
+ - Reviewable patch generation with `eva edit`.
221
+ - Health checks through `eva doctor`.
222
+ - Persistent chat sessions with `eva chat --session`.
223
+
224
+ ## [2.0.0] - 2025-06-01
225
+
226
+ ### Changed
227
+ - Complete rewrite with provider routing and safety model.
228
+
229
+ ## [1.0.0] - 2025-05-01
230
+
231
+ ### Added
232
+ - Initial release with basic AI-powered terminal assistant functionality.
@@ -88,12 +88,12 @@ src/eva/
88
88
 
89
89
  ## Adding a New Provider
90
90
 
91
- 1. Create a new file in `src/eva/router/` (e.g., `ollama_provider.py`).
91
+ 1. Create a new file in `src/eva/providers/` (e.g., `ollama_provider.py`).
92
92
  2. If the provider exposes an OpenAI-compatible API, subclass `OpenAICompatibleProvider` from `openai_compat.py`.
93
93
  3. If it uses a different SDK, implement the `Provider` protocol directly (see `gemini_provider.py` as an example).
94
94
  4. Register the provider at the bottom of your file:
95
95
  ```python
96
- from eva.router import register_provider
96
+ from eva.providers import register_provider
97
97
 
98
98
  register_provider(YourProvider())
99
99
  ```
@@ -1,6 +1,6 @@
1
- Metadata-Version: 2.4
1
+ Metadata-Version: 2.5
2
2
  Name: eva-cli
3
- Version: 3.0.1
3
+ Version: 4.1.0
4
4
  Summary: Command Line Intelligence
5
5
  License-File: LICENSE
6
6
  Requires-Python: >=3.10
@@ -26,6 +26,8 @@ Requires-Dist: pytest-cov<8.0.0,>=5.0.0; extra == 'dev'
26
26
  Requires-Dist: pytest<10.0.0,>=8.0.0; extra == 'dev'
27
27
  Requires-Dist: respx<1.0.0,>=0.21.0; extra == 'dev'
28
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'
29
31
  Description-Content-Type: text/markdown
30
32
 
31
33
 
@@ -34,6 +36,7 @@ Description-Content-Type: text/markdown
34
36
 
35
37
  <p align="center">
36
38
  <a href="https://www.python.org/"><img src="https://img.shields.io/badge/Python-3.10+-3776AB?style=for-the-badge&logo=python&logoColor=white"></a>
39
+ <a href="https://eva-cli.vercel.app/docs"><img src="https://img.shields.io/badge/Docs-eva--cli.vercel.app%2Fdocs-000000?style=for-the-badge&logo=vercel&logoColor=white"></a>
37
40
  <a href="LICENSE"><img src="https://img.shields.io/github/license/rootagi/eva?style=for-the-badge"></a>
38
41
  <a href="https://github.com/rootagi/eva/actions"><img src="https://img.shields.io/github/actions/workflow/status/rootagi/eva/ci.yaml?style=for-the-badge&label=Build"></a>
39
42
  <a href="#usage"><img src="https://img.shields.io/badge/CLI-Terminal-111827?style=for-the-badge&logo=gnubash&logoColor=white"></a>
@@ -41,12 +44,14 @@ Description-Content-Type: text/markdown
41
44
  <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/Status-Active%20Development-F59E0B?style=for-the-badge"></a>
42
45
  </p>
43
46
 
44
- <img src="assets/logo.png" alt="Eva Logo" align="left" width="160" />
47
+ <img src="assets/eva.png" alt="Eva Logo" align="left" width="160" />
45
48
 
46
49
  Eva is a command line intelligence assistant. It uses deterministic local tools for file discovery, tree generation, search, configuration, caching, and quota tracking, while reserving LLM calls for natural-language reasoning, summarization, code review, command generation, and patch generation.
47
50
 
48
51
  The design goal is practical: keep routine terminal work fast and local, "Can't remember the right command... Don't leave CLI just for a single command and simple work insted ask eva directly from your CLI"
49
52
 
53
+ 📖 **Website & Documentation**: Full interactive documentation is available at [eva-cli.vercel.app/docs](https://eva-cli.vercel.app/docs) (or offline in the [`docs/`](docs/) directory).
54
+
50
55
 
51
56
  <br clear="left"/>
52
57
 
@@ -107,6 +112,18 @@ curl -fsSL https://raw.githubusercontent.com/rootagi/eva/main/install.sh | sh
107
112
  uv tool install eva-cli # or: pipx install eva-cli / pip install --user eva-cli
108
113
  ```
109
114
 
115
+ For the Rust-accelerated file walker, once published:
116
+ ```bash
117
+ uv tool install "eva-cli[fast]"
118
+ ```
119
+
120
+
121
+ **Shell completion setup (bash, zsh, fish):**
122
+
123
+ ```bash
124
+ eva --install-completion
125
+ ```
126
+
110
127
  **Or with Docker (no Python required):**
111
128
 
112
129
  ```bash
@@ -175,6 +192,31 @@ Include a directory tree as context:
175
192
  eva ask "Where should I add a new provider?" --dir src/eva
176
193
  ```
177
194
 
195
+ Pack an entire repository as context (up to provider token budget):
196
+
197
+ ```bash
198
+ eva ask "Explain the overall architecture" --repo . --dry-run
199
+ eva ask "Find potential bugs across the codebase" --repo . --yes
200
+ ```
201
+
202
+ Agentic repo exploration (Codex-style multi-turn tool calling):
203
+
204
+ ```bash
205
+ eva investigate "Find how CLI commands are wired and explain the app flow" . --yes
206
+ ```
207
+
208
+ #### `eva investigate` vs `eva ask --repo`
209
+
210
+ | Feature | `eva ask --repo` | `eva investigate` |
211
+ | :--- | :--- | :--- |
212
+ | **Approach** | Single-pass context dump | Multi-turn iterative tool calling |
213
+ | **Context Selection** | Query-blind (dependency centrality, file size) | Query-driven (model decides what to inspect) |
214
+ | **Tool Calling** | None | Iteratively calls `list_directory`, `read_file`, `search_code` |
215
+ | **Token Usage** | Pre-packs files up to token budget | Reads only files needed for the query |
216
+ | **Supported Providers** | All providers | Tool-capable providers (`groq`, `openrouter`, `opencode_zen`, `gemini`) |
217
+
218
+
219
+
178
220
  Explain a file or directory:
179
221
 
180
222
  ```bash
@@ -184,7 +226,7 @@ eva explain src/eva/router
184
226
  Analyze piped output:
185
227
 
186
228
  ```bash
187
- pytest -q | eva analyse "Summarize the failures"
229
+ pytest -q | eva analyze "Summarize the failures"
188
230
  ```
189
231
 
190
232
  Start an interactive chat session:
@@ -237,9 +279,9 @@ eva tree src/eva
237
279
 
238
280
  | Command | Purpose |
239
281
  | --- | --- |
240
- | `eva ask` | Ask a one-shot question, optionally with file or directory context. |
282
+ | `eva ask` | Ask a one-shot question, optionally with file, directory, or repo-wide packed context (`--repo`, `--dry-run`, `--yes`). |
241
283
  | `eva explain` | Explain a file, concept, or repository (with stack detection & module dependency graph). |
242
- | `eva analyse` / `eva analyze` | Analyze piped terminal output. |
284
+ | `eva analyze` | Analyze piped terminal output. |
243
285
  | `eva chat` | Run an interactive chat session, optionally saved and resumed. |
244
286
  | `eva work` | Generate and optionally execute a single safe local command. |
245
287
  | `eva edit` | Generate a unified diff for one or more files. |
@@ -295,6 +337,18 @@ See [`SECURITY.md`](SECURITY.md) for full security documentation.
295
337
 
296
338
  Eva collects **zero** data by default (`telemetry_enabled = false`). When explicitly opted-in via configuration, Eva records only anonymized provider response latency, error types, and success status. Prompt text, code snippets, file contents, and terminal commands are **never** collected. An optional self-hosted export endpoint is supported via `telemetry_export_endpoint`.
297
339
 
340
+ ## Cross-platform support & limitations
341
+
342
+ Eva is tested across Linux (`ubuntu-latest`), macOS (`macos-latest`), and Windows (`windows-latest`):
343
+
344
+ - **Path Handling**: Eva normalizes file paths to POSIX format internally for `.gitignore` pattern matching and diff operations across all operating systems.
345
+ - **Credential Storage**: On Linux/macOS/Windows desktops with a native keyring backend (macOS Keychain, Windows Credential Manager, D-Bus SecretService), `eva config set-key` stores secrets securely in the OS keyring. In headless Linux/CI runners without a D-Bus secret service, keyring access degrades gracefully to provider environment variables (e.g. `EVA_GROQ_API_KEY`).
346
+ - **Shell Execution & Command Safety**:
347
+ - `eva work` and sandboxed subprocess execution adjust argument splitting (`shlex`) for Windows command semantics.
348
+ - POSIX-specific blast-radius protection patterns (e.g. `rm -rf /`, `chmod/chown`, `curl | bash`, `/dev/*` writes) are tailored for Unix shells (`sh`, `bash`, `zsh`). On Windows (`cmd.exe` / `powershell.exe`), equivalent high-risk command prevention relies on interactive confirmation gates and sandbox execution.
349
+ - **Performance Accelerators**: The optional `eva_fastwalk` C/Rust extension accelerates directory tree generation and file discovery when compiled binaries exist for the platform; on platforms without binary wheels, Eva seamlessly falls back to Python standard library directory traversal (`os.walk` / `Path.iterdir`).
350
+
351
+
298
352
 
299
353
  ## Provider behavior
300
354
 
@@ -309,6 +363,49 @@ Configured providers:
309
363
  - Ollama (offline local backend)
310
364
  - llama.cpp (offline GGUF backend)
311
365
 
366
+ ## Plugins
367
+
368
+ Eva CLI features an extensible plugin system. Third-party packages can register CLI commands, contribute custom AI providers, or register workflow step hooks by creating standard Python packages with entry points.
369
+
370
+ ### Writing a Plugin
371
+
372
+ 1. Subclass `EvaPlugin` from `eva.plugins`:
373
+
374
+ ```python
375
+ import typer
376
+ from eva.plugins import EvaPlugin
377
+
378
+
379
+ class MyPlugin(EvaPlugin):
380
+ name = "my-plugin"
381
+ version = "0.1.0"
382
+
383
+ def register_commands(self, app: typer.Typer) -> None:
384
+ @app.command("my-command")
385
+ def my_command():
386
+ """Custom command contributed by plugin."""
387
+ typer.echo("Hello from my plugin!")
388
+
389
+ def register_providers(self) -> None:
390
+ # Register custom LLM provider implementations here
391
+ pass
392
+ ```
393
+
394
+ 2. Expose the plugin in your package's `pyproject.toml` under `[project.entry-points."eva.plugins"]`:
395
+
396
+ ```toml
397
+ [project.entry-points."eva.plugins"]
398
+ my_plugin = "my_package.module:MyPlugin"
399
+ ```
400
+
401
+ 3. Install your package into the environment (`pip install .` or `pip install -e .`). Eva automatically discovers installed plugins via `importlib.metadata.entry_points` on startup.
402
+
403
+ ### Fail-Soft Safety
404
+
405
+ If an installed plugin fails to load or raises an exception during initialization, Eva logs a warning and skips the broken plugin without interrupting CLI operation.
406
+
407
+ See [`examples/eva-plugin-hello`](examples/eva-plugin-hello) for a complete example plugin package.
408
+
312
409
  ## Development
313
410
 
314
411
  Install development dependencies:
@@ -333,6 +430,7 @@ Run the same checks in CI by pushing to a branch or opening a pull request. See
333
430
 
334
431
  ## Project files
335
432
 
433
+ - [`docs`](docs) — documentation suite ([eva-cli.vercel.app/docs](https://eva-cli.vercel.app/docs)).
336
434
  - [`pyproject.toml`](pyproject.toml) — package metadata, dependencies, and tooling.
337
435
  - [`CHANGELOG.md`](CHANGELOG.md) — release history.
338
436
  - [`LICENSE`](LICENSE) — MIT license.