eva-cli 3.0.0__tar.gz → 4.0.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 (167) hide show
  1. {eva_cli-3.0.0 → eva_cli-4.0.0}/.github/workflows/ci.yaml +12 -2
  2. eva_cli-4.0.0/.github/workflows/fastwalk-release.yml +121 -0
  3. {eva_cli-3.0.0 → eva_cli-4.0.0}/.gitignore +3 -0
  4. eva_cli-4.0.0/CHANGELOG.md +171 -0
  5. {eva_cli-3.0.0 → eva_cli-4.0.0}/CONTRIBUTING.md +2 -2
  6. {eva_cli-3.0.0 → eva_cli-4.0.0}/PKG-INFO +72 -3
  7. {eva_cli-3.0.0 → eva_cli-4.0.0}/README.md +69 -2
  8. eva_cli-4.0.0/SECURITY.md +100 -0
  9. eva_cli-4.0.0/assets/eva.png +0 -0
  10. eva_cli-4.0.0/examples/eva-plugin-hello/README.md +21 -0
  11. eva_cli-4.0.0/examples/eva-plugin-hello/eva_plugin_hello.py +18 -0
  12. eva_cli-4.0.0/examples/eva-plugin-hello/pyproject.toml +16 -0
  13. {eva_cli-3.0.0 → eva_cli-4.0.0}/install.sh +4 -4
  14. {eva_cli-3.0.0 → eva_cli-4.0.0}/pyproject.toml +5 -1
  15. {eva_cli-3.0.0 → eva_cli-4.0.0}/rust/eva_fastwalk/Cargo.toml +2 -0
  16. eva_cli-4.0.0/rust/eva_fastwalk/pyproject.toml +24 -0
  17. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/__init__.py +1 -1
  18. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/cli/app.py +130 -8
  19. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/config/config.py +6 -4
  20. eva_cli-4.0.0/src/eva/indexing/tokenizer.py +131 -0
  21. eva_cli-4.0.0/src/eva/plugins/__init__.py +11 -0
  22. eva_cli-4.0.0/src/eva/plugins/loader.py +102 -0
  23. eva_cli-4.0.0/src/eva/plugins/protocol.py +45 -0
  24. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/security/__init__.py +6 -0
  25. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/security/sandbox.py +33 -2
  26. eva_cli-4.0.0/src/eva/security/work_safety.py +166 -0
  27. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/workflows/budget.py +39 -16
  28. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/workspace/gitignore.py +1 -1
  29. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/test_basic.py +8 -6
  30. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/cli/test_cli.py +15 -0
  31. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/cli/test_cli_commands.py +12 -1
  32. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/config/test_config_keys.py +32 -0
  33. eva_cli-4.0.0/tests/unit/indexing/test_tokenizer_offline.py +117 -0
  34. eva_cli-4.0.0/tests/unit/plugins/__init__.py +1 -0
  35. eva_cli-4.0.0/tests/unit/plugins/test_plugins.py +272 -0
  36. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/providers/test_providers.py +6 -0
  37. eva_cli-4.0.0/tests/unit/security/test_allowlist_cli.py +77 -0
  38. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/security/test_sandbox.py +12 -0
  39. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/security/test_work_safety.py +55 -0
  40. eva_cli-4.0.0/tests/unit/test_compatibility_imports.py +15 -0
  41. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/workflows/test_workflow_engine.py +21 -0
  42. eva_cli-3.0.0/CHANGELOG.md +0 -79
  43. eva_cli-3.0.0/SECURITY.md +0 -77
  44. eva_cli-3.0.0/assets/logo.png +0 -0
  45. eva_cli-3.0.0/src/eva/context/__init__.py +0 -19
  46. eva_cli-3.0.0/src/eva/context/finder.py +0 -5
  47. eva_cli-3.0.0/src/eva/context/gitignore.py +0 -5
  48. eva_cli-3.0.0/src/eva/context/io.py +0 -5
  49. eva_cli-3.0.0/src/eva/context/tokenizer.py +0 -5
  50. eva_cli-3.0.0/src/eva/context/tree.py +0 -5
  51. eva_cli-3.0.0/src/eva/indexing/tokenizer.py +0 -37
  52. eva_cli-3.0.0/src/eva/plugins/__init__.py +0 -3
  53. eva_cli-3.0.0/src/eva/router/__init__.py +0 -25
  54. eva_cli-3.0.0/src/eva/router/gemini_provider.py +0 -5
  55. eva_cli-3.0.0/src/eva/router/groq_provider.py +0 -5
  56. eva_cli-3.0.0/src/eva/router/openai_compat.py +0 -5
  57. eva_cli-3.0.0/src/eva/router/opencode_zen_provider.py +0 -5
  58. eva_cli-3.0.0/src/eva/router/openrouter_provider.py +0 -5
  59. eva_cli-3.0.0/src/eva/security/work_safety.py +0 -85
  60. eva_cli-3.0.0/tests/unit/test_compatibility_imports.py +0 -25
  61. {eva_cli-3.0.0 → eva_cli-4.0.0}/.github/workflows/release.yml +0 -0
  62. {eva_cli-3.0.0 → eva_cli-4.0.0}/.pre-commit-config.yaml +0 -0
  63. {eva_cli-3.0.0 → eva_cli-4.0.0}/Dockerfile +0 -0
  64. {eva_cli-3.0.0 → eva_cli-4.0.0}/LICENSE +0 -0
  65. {eva_cli-3.0.0 → eva_cli-4.0.0}/assets/demo.gif +0 -0
  66. {eva_cli-3.0.0 → eva_cli-4.0.0}/assets/demo2.gif +0 -0
  67. {eva_cli-3.0.0 → eva_cli-4.0.0}/assets/demo3.gif +0 -0
  68. {eva_cli-3.0.0 → eva_cli-4.0.0}/assets/demo4.gif +0 -0
  69. {eva_cli-3.0.0 → eva_cli-4.0.0}/assets/demo5.gif +0 -0
  70. {eva_cli-3.0.0 → eva_cli-4.0.0}/rust/eva_fastwalk/Cargo.lock +0 -0
  71. {eva_cli-3.0.0 → eva_cli-4.0.0}/rust/eva_fastwalk/src/lib.rs +0 -0
  72. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/budget.py +0 -0
  73. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/cache/__init__.py +0 -0
  74. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/cache/cache.py +0 -0
  75. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/cache.py +0 -0
  76. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/chat_session.py +0 -0
  77. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/cli/__init__.py +0 -0
  78. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/cli.py +0 -0
  79. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/config/__init__.py +0 -0
  80. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/config.py +0 -0
  81. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/diagnostics.py +0 -0
  82. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/git_ops.py +0 -0
  83. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/indexing/__init__.py +0 -0
  84. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/indexing/finder.py +0 -0
  85. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/indexing/io.py +0 -0
  86. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/indexing/repo_index.py +0 -0
  87. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/indexing/tree.py +0 -0
  88. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/prompts/__init__.py +0 -0
  89. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/providers/__init__.py +0 -0
  90. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/providers/gemini_provider.py +0 -0
  91. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/providers/groq_provider.py +0 -0
  92. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/providers/llamacpp_provider.py +0 -0
  93. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/providers/ollama_provider.py +0 -0
  94. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/providers/openai_compat.py +0 -0
  95. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/providers/opencode_zen_provider.py +0 -0
  96. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/providers/openrouter_provider.py +0 -0
  97. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/replay/__init__.py +0 -0
  98. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/replay/player.py +0 -0
  99. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/replay/recorder.py +0 -0
  100. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/security/audit.py +0 -0
  101. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/security/redaction.py +0 -0
  102. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/shell/__init__.py +0 -0
  103. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/shell/runner.py +0 -0
  104. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/telemetry/__init__.py +0 -0
  105. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/telemetry/diagnostics.py +0 -0
  106. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/telemetry/metrics.py +0 -0
  107. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/ui/formatter.py +0 -0
  108. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/ui/streaming.py +0 -0
  109. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/work_safety.py +0 -0
  110. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/workflows/__init__.py +0 -0
  111. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/workflows/builtins/dependency_audit.yaml +0 -0
  112. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/workflows/builtins/repo_health.yaml +0 -0
  113. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/workflows/builtins/security_scan.yaml +0 -0
  114. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/workflows/chat_session.py +0 -0
  115. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/workflows/engine.py +0 -0
  116. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/workspace/__init__.py +0 -0
  117. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/workspace/git_ops.py +0 -0
  118. {eva_cli-3.0.0 → eva_cli-4.0.0}/src/eva/workspace/session.py +0 -0
  119. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/conftest.py +0 -0
  120. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/fixtures/golden/patches/sample1_expected.diff +0 -0
  121. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/fixtures/golden/patches/sample1_fenced.txt +0 -0
  122. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/fixtures/golden/prompts/analyze_system_prompt.txt +0 -0
  123. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/fixtures/golden/prompts/ask_system_prompt.txt +0 -0
  124. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/fixtures/golden/prompts/chat_system_prompt.txt +0 -0
  125. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/fixtures/golden/prompts/commit_system_prompt.txt +0 -0
  126. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/fixtures/golden/prompts/edit_system_prompt.txt +0 -0
  127. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/fixtures/golden/prompts/explain_system_prompt.txt +0 -0
  128. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/fixtures/golden/prompts/work_system_prompt.txt +0 -0
  129. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/__init__.py +0 -0
  130. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/cache/__init__.py +0 -0
  131. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/cache/test_cache.py +0 -0
  132. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/cli/__init__.py +0 -0
  133. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/cli/test_cli_coverage.py +0 -0
  134. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/cli/test_cli_more.py +0 -0
  135. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/config/__init__.py +0 -0
  136. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/config/test_config.py +0 -0
  137. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/golden/__init__.py +0 -0
  138. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/golden/test_golden_patches.py +0 -0
  139. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/golden/test_golden_prompts.py +0 -0
  140. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/indexing/__init__.py +0 -0
  141. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/indexing/test_indexing.py +0 -0
  142. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/indexing/test_indexing_more.py +0 -0
  143. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/indexing/test_repo_index.py +0 -0
  144. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/providers/__init__.py +0 -0
  145. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/providers/test_offline_providers.py +0 -0
  146. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/providers/test_provider_coverage.py +0 -0
  147. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/providers/test_provider_errors.py +0 -0
  148. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/providers/test_providers_more.py +0 -0
  149. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/replay/test_replay.py +0 -0
  150. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/security/__init__.py +0 -0
  151. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/security/test_audit_chain.py +0 -0
  152. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/security/test_redaction.py +0 -0
  153. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/security/test_safety_audit.py +0 -0
  154. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/shell/__init__.py +0 -0
  155. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/shell/test_shell.py +0 -0
  156. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/telemetry/__init__.py +0 -0
  157. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/telemetry/test_metrics.py +0 -0
  158. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/telemetry/test_telemetry.py +0 -0
  159. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/ui/__init__.py +0 -0
  160. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/ui/test_ui.py +0 -0
  161. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/workflows/__init__.py +0 -0
  162. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/workflows/test_chat_session.py +0 -0
  163. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/workflows/test_workflows.py +0 -0
  164. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/workspace/__init__.py +0 -0
  165. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/workspace/test_git_ops.py +0 -0
  166. {eva_cli-3.0.0 → eva_cli-4.0.0}/tests/unit/workspace/test_session_workspace.py +0 -0
  167. {eva_cli-3.0.0 → eva_cli-4.0.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,121 @@
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
+
26
+ jobs:
27
+ linux:
28
+ name: Linux wheels (${{ matrix.target }})
29
+ runs-on: ${{ matrix.runner }}
30
+ strategy:
31
+ fail-fast: false
32
+ matrix:
33
+ include:
34
+ - runner: ubuntu-latest
35
+ target: x86_64
36
+ - runner: ubuntu-24.04-arm
37
+ target: aarch64
38
+ steps:
39
+ - uses: actions/checkout@v4
40
+ - name: Build wheel
41
+ uses: PyO3/maturin-action@v1
42
+ with:
43
+ working-directory: rust/eva_fastwalk
44
+ target: ${{ matrix.target }}
45
+ args: --release --out ../../dist -i python3.10
46
+ manylinux: auto
47
+ - uses: actions/upload-artifact@v4
48
+ with:
49
+ name: wheels-linux-${{ matrix.target }}
50
+ path: dist
51
+
52
+ macos:
53
+ name: macOS wheels (${{ matrix.target }})
54
+ runs-on: ${{ matrix.runner }}
55
+ strategy:
56
+ fail-fast: false
57
+ matrix:
58
+ include:
59
+ - runner: macos-13 # Intel
60
+ target: x86_64
61
+ - runner: macos-14 # Apple Silicon
62
+ target: aarch64
63
+ steps:
64
+ - uses: actions/checkout@v4
65
+ - name: Build wheel
66
+ uses: PyO3/maturin-action@v1
67
+ with:
68
+ working-directory: rust/eva_fastwalk
69
+ target: ${{ matrix.target }}
70
+ args: --release --out ../../dist -i python3.10
71
+ - uses: actions/upload-artifact@v4
72
+ with:
73
+ name: wheels-macos-${{ matrix.target }}
74
+ path: dist
75
+
76
+ windows:
77
+ name: Windows wheel
78
+ runs-on: windows-latest
79
+ steps:
80
+ - uses: actions/checkout@v4
81
+ - name: Build wheel
82
+ uses: PyO3/maturin-action@v1
83
+ with:
84
+ working-directory: rust/eva_fastwalk
85
+ target: x64
86
+ args: --release --out ../../dist -i python3.10
87
+ - uses: actions/upload-artifact@v4
88
+ with:
89
+ name: wheels-windows
90
+ path: dist
91
+
92
+ sdist:
93
+ name: Source distribution
94
+ runs-on: ubuntu-latest
95
+ steps:
96
+ - uses: actions/checkout@v4
97
+ - name: Build sdist
98
+ uses: PyO3/maturin-action@v1
99
+ with:
100
+ working-directory: rust/eva_fastwalk
101
+ command: sdist
102
+ args: --out ../../dist
103
+ - uses: actions/upload-artifact@v4
104
+ with:
105
+ name: wheels-sdist
106
+ path: dist
107
+
108
+ publish:
109
+ name: Publish to PyPI
110
+ needs: [linux, macos, windows, sdist]
111
+ runs-on: ubuntu-latest
112
+ environment: pypi
113
+ steps:
114
+ - uses: actions/download-artifact@v4
115
+ with:
116
+ pattern: wheels-*
117
+ path: dist
118
+ merge-multiple: true
119
+ - uses: pypa/gh-action-pypi-publish@release/v1
120
+ with:
121
+ packages-dir: dist
@@ -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,171 @@
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
+ ## [4.0.0] - 2026-08-10
10
+
11
+ ### Added
12
+ - **PyPI Packaging & Release Workflow for `eva_fastwalk` Extension (`rust/eva_fastwalk/`, `.github/workflows/fastwalk-release.yml`):**
13
+ - Added `rust/eva_fastwalk/pyproject.toml` configured with `maturin` build backend for PyPI distribution package `eva-fastwalk`.
14
+ - Added `license = "MIT"` to `[package]` in `rust/eva_fastwalk/Cargo.toml`.
15
+ - 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.
16
+ - 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.
17
+ - Updated `install.sh` and `README.md` to document `eva-cli[fast]` installation.
18
+
19
+
20
+
21
+ ### Added
22
+
23
+ - **Shell Completion (`src/eva/cli/app.py`):**
24
+ - Turned shell completion on in Typer CLI app (`add_completion=True`), enabling `--install-completion` and `--show-completion`.
25
+ - Added support and verification for `bash`, `zsh`, and `fish` shell completion.
26
+ - Documented shell completion installation (`eva --install-completion`) in `README.md`.
27
+ - Added unit test suite covering shell completion output generation in `tests/unit/cli/test_cli.py`.
28
+ - **Cross-Platform CI & OS Compatibility (`.github/workflows/ci.yaml`, `src/eva/`):**
29
+ - Extended CI matrix to test across `ubuntu-latest`, `windows-latest`, and `macos-latest` on Python 3.10, 3.11, and 3.12.
30
+ - Fixed cross-platform path handling in `src/eva/workspace/gitignore.py` using `.as_posix()` for `pathspec` pattern matching.
31
+ - 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")`).
32
+ - 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.
33
+ - Added explicit unit tests for keyring backend fallback in `tests/unit/config/test_config_keys.py`.
34
+ - Documented cross-platform support and OS limitations in `README.md`.
35
+
36
+
37
+
38
+ ### Fixed
39
+ - **Offline tokenization (`src/eva/indexing/tokenizer.py`):**
40
+ - `count_tokens()` and `trim_context()` no longer crash on restricted-network machines
41
+ (corporate proxy, air-gapped box, CI runner) when tiktoken cannot download
42
+ `cl100k_base.tiktoken` from `openaipublic.blob.core.windows.net`.
43
+ - Broadened exception handling from a narrow set (`ValueError, KeyError, RuntimeError,
44
+ TypeError`) to `Exception`, covering `HTTPError`, `ConnectionError`, `OSError`, and
45
+ any other network or SSL failure that tiktoken may raise.
46
+ - The encoding is now loaded once and cached at module level; degradation logs a single
47
+ `WARNING` message instead of repeating on every call.
48
+ - Graceful fallback: when the encoding cannot be loaded, token counting approximates via
49
+ `len(text) // 4` and trimming approximates via character count × 4 — matching the
50
+ existing fallback logic that was previously unreachable for network errors.
51
+
52
+ ### Added
53
+ - **`EVA_TIKTOKEN_ENCODING_PATH` config/env var (`src/eva/config/config.py`):**
54
+ - New `tiktoken_encoding_path` field in `GeneralConfig` (readable from the
55
+ `EVA_TIKTOKEN_ENCODING_PATH` environment variable or `config.toml`).
56
+ - When set, the tokenizer loads the BPE vocabulary from that local file path
57
+ instead of attempting a network download, enabling fully air-gapped deployments.
58
+ - **Offline tokenizer tests (`tests/unit/indexing/test_tokenizer_offline.py`):**
59
+ - 8 new tests covering: approximation fallback for `count_tokens` and `trim_context`,
60
+ all exception types handled without crash, warning logged exactly once, custom
61
+ encoding path bypasses download, and bad custom path degrades gracefully.
62
+
63
+
64
+
65
+ ### Added
66
+ - **Opt-In Command Allowlist (`allowed_command_prefixes`):**
67
+ - Configured via `allowed_command_prefixes` in `GeneralConfig` (`config.toml`). Empty list defaults to off (denylist-only).
68
+ - CLI management commands: `eva config allow-command <prefix>`, `eva config disallow-command <prefix>`, and `eva config import-allowlist <path>`.
69
+ - Extended `eva config show` to display active allowlist state.
70
+ - **Argv-Based Default Subprocess Execution:**
71
+ - Commands executed in sandbox (and `eva work`) default to `shlex.split` / `shell=False`, preventing shell metacharacter injection.
72
+ - Added `--allow-shell-features` flag to `eva work` for opting into shell features (pipes and redirection).
73
+ - **Safety Check Transparency (`--dry-run-explain`):**
74
+ - 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.
75
+ - **Security Hardening Documentation:**
76
+ - 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.
77
+
78
+
79
+
80
+ ### Breaking
81
+ - **Removed `eva.router` and `eva.context` compatibility shim packages.**
82
+ These re-exported names from the canonical modules and have been superseded since v2.2.0.
83
+ - `eva.router` → use `eva.providers`
84
+ - `eva.context` → use `eva.indexing` / `eva.workspace`
85
+
86
+
87
+
88
+ ### Added
89
+ - **Plugin Architecture Subsystem (`src/eva/plugins/`):**
90
+ - 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`).
91
+ - Automatic discovery mechanism (`src/eva/plugins/loader.py`) using Python standard `importlib.metadata.entry_points` (`[project.entry-points."eva.plugins"]`).
92
+ - Fail-soft error handling: broken plugins log warnings and are safely skipped without crashing CLI startup.
93
+ - Included a reference example plugin (`examples/eva-plugin-hello/`) adding a `hello` command.
94
+
95
+ ## [3.0.1] - 2026-08-06
96
+ ### Fixed
97
+ - Added support for custom focus prompts in `eva analyze`.
98
+ - Added `-y`/`--yes` auto-approve flag to `eva workflow run` to prevent piping stalls.
99
+
100
+ ## [3.0.0] - 2026-08-05
101
+
102
+ ### Added
103
+ - **Security Hardening Framework (`src/eva/security/`):**
104
+ - 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.
105
+ - Cryptographic hash-chained audit log (`src/eva/security/audit.py`) with sequential SHA-256 signatures for tamper detection (`verify_audit_chain()`).
106
+ - 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.
107
+ - **Terminal Replay Subsystem (`eva replay`):**
108
+ - Session execution recorder and player (`src/eva/replay/`). Captures command, output, exit code, duration, and working directory with automatic secret redaction at write time.
109
+ - New commands: `eva replay <session>` and `eva replay --list`.
110
+ - **Opt-In Telemetry (`src/eva/telemetry/`):**
111
+ - 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.
112
+ - **Documentation:**
113
+ - Created `SECURITY.md` detailing security mechanisms, redaction patterns, audit chain format, sandbox controls, and vulnerability reporting.
114
+
115
+ ## [2.3.0] - 2026-08-05
116
+
117
+
118
+ ### Added
119
+ - **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`.
120
+ - **Offline Model Support (`ollama` & `llamacpp`):** Added Ollama and llama.cpp GGUF backends with automatic local fallback when cloud providers are unreachable or quota-exhausted.
121
+ - **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.
122
+ - **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.
123
+
124
+ ## [2.2.0] - 2026-08-05
125
+
126
+ ### Fixed
127
+ - **CRITICAL:** `eva changes` and `eva commit-message` no longer crash when git output contains bracket characters (Rich MarkupError).
128
+ - **BROKEN:** `eva tree <path>`, `eva grep <pattern> <path>`, and `eva find <pattern> <path>` now correctly accept path arguments.
129
+ - `eva doctor` now shows ⚠ for providers with missing API keys instead of a misleading ✔.
130
+ - `eva config status` no longer shows doubled emoji prefixes.
131
+ - Cache keys now include the model name, preventing stale responses when switching models within a provider.
132
+ - Option injection vulnerability in `eva grep` fixed by adding `--` separator before user arguments.
133
+
134
+ ### Changed
135
+ - Streaming responses now show real-time progress (`Receiving... (N chars)`) instead of a static spinner.
136
+ - Provider code refactored: OpenRouter, Groq, and OpenCode Zen now share an `OpenAICompatibleProvider` base class, eliminating ~90% code duplication.
137
+ - `cli.py` split into focused modules: `git_ops.py` for git operations and `chat_session.py` for the interactive REPL.
138
+ - Work safety blocklist hardened against absolute path bypasses, `env`/`command` prefix attacks, `xargs rm`, and interpreter code execution.
139
+
140
+ ### Added
141
+ - Multi-file context support: `eva ask --file a.py --file b.py` now accepts multiple `--file` flags.
142
+ - `--no-cache` flag for `eva ask` to bypass the response cache.
143
+ - `CONTRIBUTING.md` with development setup, architecture overview, and suggested contributions including local model integration.
144
+ - Explicit `__init__.py` for the `context` package.
145
+
146
+ ### Removed
147
+ - Stale `test_gemini.py` scratchpad file that was breaking pytest collection.
148
+
149
+ ## [2.1.0] - 2025-07-01
150
+
151
+ ### Added
152
+ - Provider abstraction with fallback routing across OpenRouter, Groq, Gemini, and OpenCode Zen.
153
+ - Streaming responses with disk-backed caching.
154
+ - Local RPM/RPD budget tracking.
155
+ - `.gitignore`-aware context collection.
156
+ - Safe file-context reads with binary-file and large-file handling.
157
+ - Hardened command generation via `eva work`.
158
+ - Git-aware workflows (`eva changes`, `eva commit-message`).
159
+ - Reviewable patch generation with `eva edit`.
160
+ - Health checks through `eva doctor`.
161
+ - Persistent chat sessions with `eva chat --session`.
162
+
163
+ ## [2.0.0] - 2025-06-01
164
+
165
+ ### Changed
166
+ - Complete rewrite with provider routing and safety model.
167
+
168
+ ## [1.0.0] - 2025-05-01
169
+
170
+ ### Added
171
+ - 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
1
  Metadata-Version: 2.4
2
2
  Name: eva-cli
3
- Version: 3.0.0
3
+ Version: 4.0.0
4
4
  Summary: Command Line Intelligence
5
5
  License-File: LICENSE
6
6
  Requires-Python: >=3.10
@@ -26,9 +26,11 @@ 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
- [Uploading README.md…]()
33
+
32
34
  # Eva CLI
33
35
 
34
36
 
@@ -41,7 +43,7 @@ Description-Content-Type: text/markdown
41
43
  <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/Status-Active%20Development-F59E0B?style=for-the-badge"></a>
42
44
  </p>
43
45
 
44
- <img src="assets/logo.png" alt="Eva Logo" align="left" width="160" />
46
+ <img src="assets/eva.png" alt="Eva Logo" align="left" width="160" />
45
47
 
46
48
  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
49
 
@@ -107,6 +109,18 @@ curl -fsSL https://raw.githubusercontent.com/rootagi/eva/main/install.sh | sh
107
109
  uv tool install eva-cli # or: pipx install eva-cli / pip install --user eva-cli
108
110
  ```
109
111
 
112
+ For the Rust-accelerated file walker, once published:
113
+ ```bash
114
+ uv tool install "eva-cli[fast]"
115
+ ```
116
+
117
+
118
+ **Shell completion setup (bash, zsh, fish):**
119
+
120
+ ```bash
121
+ eva --install-completion
122
+ ```
123
+
110
124
  **Or with Docker (no Python required):**
111
125
 
112
126
  ```bash
@@ -295,6 +309,18 @@ See [`SECURITY.md`](SECURITY.md) for full security documentation.
295
309
 
296
310
  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
311
 
312
+ ## Cross-platform support & limitations
313
+
314
+ Eva is tested across Linux (`ubuntu-latest`), macOS (`macos-latest`), and Windows (`windows-latest`):
315
+
316
+ - **Path Handling**: Eva normalizes file paths to POSIX format internally for `.gitignore` pattern matching and diff operations across all operating systems.
317
+ - **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`).
318
+ - **Shell Execution & Command Safety**:
319
+ - `eva work` and sandboxed subprocess execution adjust argument splitting (`shlex`) for Windows command semantics.
320
+ - 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.
321
+ - **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`).
322
+
323
+
298
324
 
299
325
  ## Provider behavior
300
326
 
@@ -309,6 +335,49 @@ Configured providers:
309
335
  - Ollama (offline local backend)
310
336
  - llama.cpp (offline GGUF backend)
311
337
 
338
+ ## Plugins
339
+
340
+ 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.
341
+
342
+ ### Writing a Plugin
343
+
344
+ 1. Subclass `EvaPlugin` from `eva.plugins`:
345
+
346
+ ```python
347
+ import typer
348
+ from eva.plugins import EvaPlugin
349
+
350
+
351
+ class MyPlugin(EvaPlugin):
352
+ name = "my-plugin"
353
+ version = "0.1.0"
354
+
355
+ def register_commands(self, app: typer.Typer) -> None:
356
+ @app.command("my-command")
357
+ def my_command():
358
+ """Custom command contributed by plugin."""
359
+ typer.echo("Hello from my plugin!")
360
+
361
+ def register_providers(self) -> None:
362
+ # Register custom LLM provider implementations here
363
+ pass
364
+ ```
365
+
366
+ 2. Expose the plugin in your package's `pyproject.toml` under `[project.entry-points."eva.plugins"]`:
367
+
368
+ ```toml
369
+ [project.entry-points."eva.plugins"]
370
+ my_plugin = "my_package.module:MyPlugin"
371
+ ```
372
+
373
+ 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.
374
+
375
+ ### Fail-Soft Safety
376
+
377
+ 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.
378
+
379
+ See [`examples/eva-plugin-hello`](examples/eva-plugin-hello) for a complete example plugin package.
380
+
312
381
  ## Development
313
382
 
314
383
  Install development dependencies:
@@ -1,4 +1,4 @@
1
- [Uploading README.md…]()
1
+
2
2
  # Eva CLI
3
3
 
4
4
 
@@ -11,7 +11,7 @@
11
11
  <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/Status-Active%20Development-F59E0B?style=for-the-badge"></a>
12
12
  </p>
13
13
 
14
- <img src="assets/logo.png" alt="Eva Logo" align="left" width="160" />
14
+ <img src="assets/eva.png" alt="Eva Logo" align="left" width="160" />
15
15
 
16
16
  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.
17
17
 
@@ -77,6 +77,18 @@ curl -fsSL https://raw.githubusercontent.com/rootagi/eva/main/install.sh | sh
77
77
  uv tool install eva-cli # or: pipx install eva-cli / pip install --user eva-cli
78
78
  ```
79
79
 
80
+ For the Rust-accelerated file walker, once published:
81
+ ```bash
82
+ uv tool install "eva-cli[fast]"
83
+ ```
84
+
85
+
86
+ **Shell completion setup (bash, zsh, fish):**
87
+
88
+ ```bash
89
+ eva --install-completion
90
+ ```
91
+
80
92
  **Or with Docker (no Python required):**
81
93
 
82
94
  ```bash
@@ -265,6 +277,18 @@ See [`SECURITY.md`](SECURITY.md) for full security documentation.
265
277
 
266
278
  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`.
267
279
 
280
+ ## Cross-platform support & limitations
281
+
282
+ Eva is tested across Linux (`ubuntu-latest`), macOS (`macos-latest`), and Windows (`windows-latest`):
283
+
284
+ - **Path Handling**: Eva normalizes file paths to POSIX format internally for `.gitignore` pattern matching and diff operations across all operating systems.
285
+ - **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`).
286
+ - **Shell Execution & Command Safety**:
287
+ - `eva work` and sandboxed subprocess execution adjust argument splitting (`shlex`) for Windows command semantics.
288
+ - 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.
289
+ - **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`).
290
+
291
+
268
292
 
269
293
  ## Provider behavior
270
294
 
@@ -279,6 +303,49 @@ Configured providers:
279
303
  - Ollama (offline local backend)
280
304
  - llama.cpp (offline GGUF backend)
281
305
 
306
+ ## Plugins
307
+
308
+ 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.
309
+
310
+ ### Writing a Plugin
311
+
312
+ 1. Subclass `EvaPlugin` from `eva.plugins`:
313
+
314
+ ```python
315
+ import typer
316
+ from eva.plugins import EvaPlugin
317
+
318
+
319
+ class MyPlugin(EvaPlugin):
320
+ name = "my-plugin"
321
+ version = "0.1.0"
322
+
323
+ def register_commands(self, app: typer.Typer) -> None:
324
+ @app.command("my-command")
325
+ def my_command():
326
+ """Custom command contributed by plugin."""
327
+ typer.echo("Hello from my plugin!")
328
+
329
+ def register_providers(self) -> None:
330
+ # Register custom LLM provider implementations here
331
+ pass
332
+ ```
333
+
334
+ 2. Expose the plugin in your package's `pyproject.toml` under `[project.entry-points."eva.plugins"]`:
335
+
336
+ ```toml
337
+ [project.entry-points."eva.plugins"]
338
+ my_plugin = "my_package.module:MyPlugin"
339
+ ```
340
+
341
+ 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.
342
+
343
+ ### Fail-Soft Safety
344
+
345
+ 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.
346
+
347
+ See [`examples/eva-plugin-hello`](examples/eva-plugin-hello) for a complete example plugin package.
348
+
282
349
  ## Development
283
350
 
284
351
  Install development dependencies: