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.
- {eva_cli-3.0.1 → eva_cli-4.1.0}/.github/workflows/ci.yaml +12 -2
- eva_cli-4.1.0/.github/workflows/fastwalk-release.yml +145 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/.gitignore +3 -0
- eva_cli-4.1.0/CHANGELOG.md +232 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/CONTRIBUTING.md +2 -2
- {eva_cli-3.0.1 → eva_cli-4.1.0}/PKG-INFO +104 -6
- {eva_cli-3.0.1 → eva_cli-4.1.0}/README.md +100 -4
- eva_cli-4.1.0/SECURITY.md +100 -0
- eva_cli-4.1.0/assets/eva.png +0 -0
- eva_cli-4.1.0/docs/README.md +19 -0
- eva_cli-4.1.0/docs/architecture.md +94 -0
- eva_cli-4.1.0/docs/command-reference.md +197 -0
- eva_cli-4.1.0/docs/configuration.md +140 -0
- eva_cli-4.1.0/docs/index.md +83 -0
- eva_cli-4.1.0/docs/plugins.md +92 -0
- eva_cli-4.1.0/docs/provider-behavior.md +60 -0
- eva_cli-4.1.0/docs/security-model.md +117 -0
- eva_cli-4.1.0/examples/eva-plugin-hello/README.md +21 -0
- eva_cli-4.1.0/examples/eva-plugin-hello/eva_plugin_hello.py +18 -0
- eva_cli-4.1.0/examples/eva-plugin-hello/pyproject.toml +16 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/install.sh +4 -4
- {eva_cli-3.0.1 → eva_cli-4.1.0}/pyproject.toml +5 -1
- {eva_cli-3.0.1 → eva_cli-4.1.0}/rust/eva_fastwalk/Cargo.toml +3 -1
- eva_cli-4.1.0/rust/eva_fastwalk/pyproject.toml +24 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/rust/eva_fastwalk/src/lib.rs +5 -3
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/__init__.py +1 -1
- eva_cli-4.1.0/src/eva/agent/__init__.py +12 -0
- eva_cli-4.1.0/src/eva/agent/loop.py +251 -0
- eva_cli-4.1.0/src/eva/agent/tools.py +174 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/cli/app.py +341 -10
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/config/config.py +7 -4
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/indexing/__init__.py +3 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/indexing/io.py +1 -2
- eva_cli-4.1.0/src/eva/indexing/packer.py +237 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/indexing/repo_index.py +1 -1
- eva_cli-4.1.0/src/eva/indexing/tokenizer.py +131 -0
- eva_cli-4.1.0/src/eva/plugins/__init__.py +11 -0
- eva_cli-4.1.0/src/eva/plugins/loader.py +102 -0
- eva_cli-4.1.0/src/eva/plugins/protocol.py +45 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/prompts/__init__.py +5 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/providers/__init__.py +111 -0
- eva_cli-4.1.0/src/eva/providers/gemini_provider.py +156 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/providers/llamacpp_provider.py +4 -2
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/providers/ollama_provider.py +4 -2
- eva_cli-4.1.0/src/eva/providers/openai_compat.py +146 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/security/__init__.py +9 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/security/audit.py +21 -1
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/security/redaction.py +3 -3
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/security/sandbox.py +33 -2
- eva_cli-4.1.0/src/eva/security/sensitive_files.py +31 -0
- eva_cli-4.1.0/src/eva/security/work_safety.py +166 -0
- eva_cli-4.1.0/src/eva/shell/runner.py +11 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/telemetry/diagnostics.py +4 -2
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/workflows/budget.py +39 -16
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/workspace/git_ops.py +14 -3
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/workspace/gitignore.py +1 -2
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/conftest.py +6 -0
- eva_cli-4.1.0/tests/fixtures/golden/prompts/changes_system_prompt.txt +3 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/test_basic.py +12 -10
- eva_cli-4.1.0/tests/unit/agent/test_loop.py +116 -0
- eva_cli-4.1.0/tests/unit/agent/test_tools.py +53 -0
- eva_cli-4.1.0/tests/unit/cli/test_ask_repo.py +97 -0
- eva_cli-4.1.0/tests/unit/cli/test_changes_command.py +51 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/cli/test_cli.py +15 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/cli/test_cli_commands.py +56 -1
- eva_cli-4.1.0/tests/unit/cli/test_investigate.py +68 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/config/test_config_keys.py +32 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/golden/test_golden_prompts.py +7 -0
- eva_cli-4.1.0/tests/unit/indexing/test_packer.py +72 -0
- eva_cli-4.1.0/tests/unit/indexing/test_tokenizer_offline.py +117 -0
- eva_cli-4.1.0/tests/unit/plugins/__init__.py +1 -0
- eva_cli-4.1.0/tests/unit/plugins/test_plugins.py +272 -0
- eva_cli-4.1.0/tests/unit/providers/test_context_budget.py +26 -0
- eva_cli-4.1.0/tests/unit/providers/test_dispatch_caching.py +102 -0
- eva_cli-4.1.0/tests/unit/providers/test_gemini_tools.py +58 -0
- eva_cli-4.1.0/tests/unit/providers/test_openai_compat_tools.py +72 -0
- eva_cli-4.1.0/tests/unit/providers/test_provider_tools_protocol.py +42 -0
- eva_cli-4.1.0/tests/unit/providers/test_repo_caching.py +33 -0
- eva_cli-4.1.0/tests/unit/security/test_allowlist_cli.py +77 -0
- eva_cli-4.1.0/tests/unit/security/test_audit.py +29 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/security/test_sandbox.py +12 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/security/test_work_safety.py +55 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/telemetry/test_telemetry.py +3 -0
- eva_cli-4.1.0/tests/unit/test_compatibility_imports.py +31 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/workflows/test_workflow_engine.py +19 -4
- eva_cli-3.0.1/CHANGELOG.md +0 -84
- eva_cli-3.0.1/SECURITY.md +0 -77
- eva_cli-3.0.1/assets/logo.png +0 -0
- eva_cli-3.0.1/src/eva/budget.py +0 -31
- eva_cli-3.0.1/src/eva/cache.py +0 -19
- eva_cli-3.0.1/src/eva/chat_session.py +0 -5
- eva_cli-3.0.1/src/eva/config.py +0 -35
- eva_cli-3.0.1/src/eva/context/__init__.py +0 -19
- eva_cli-3.0.1/src/eva/context/finder.py +0 -5
- eva_cli-3.0.1/src/eva/context/gitignore.py +0 -5
- eva_cli-3.0.1/src/eva/context/io.py +0 -5
- eva_cli-3.0.1/src/eva/context/tokenizer.py +0 -5
- eva_cli-3.0.1/src/eva/context/tree.py +0 -5
- eva_cli-3.0.1/src/eva/diagnostics.py +0 -9
- eva_cli-3.0.1/src/eva/git_ops.py +0 -15
- eva_cli-3.0.1/src/eva/indexing/tokenizer.py +0 -37
- eva_cli-3.0.1/src/eva/plugins/__init__.py +0 -3
- eva_cli-3.0.1/src/eva/providers/gemini_provider.py +0 -72
- eva_cli-3.0.1/src/eva/providers/openai_compat.py +0 -57
- eva_cli-3.0.1/src/eva/router/__init__.py +0 -25
- eva_cli-3.0.1/src/eva/router/gemini_provider.py +0 -5
- eva_cli-3.0.1/src/eva/router/groq_provider.py +0 -5
- eva_cli-3.0.1/src/eva/router/openai_compat.py +0 -5
- eva_cli-3.0.1/src/eva/router/opencode_zen_provider.py +0 -5
- eva_cli-3.0.1/src/eva/router/openrouter_provider.py +0 -5
- eva_cli-3.0.1/src/eva/security/work_safety.py +0 -85
- eva_cli-3.0.1/src/eva/shell/runner.py +0 -6
- eva_cli-3.0.1/src/eva/work_safety.py +0 -21
- eva_cli-3.0.1/tests/unit/test_compatibility_imports.py +0 -25
- {eva_cli-3.0.1 → eva_cli-4.1.0}/.github/workflows/release.yml +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/.pre-commit-config.yaml +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/Dockerfile +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/LICENSE +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/assets/demo.gif +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/assets/demo2.gif +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/assets/demo3.gif +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/assets/demo4.gif +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/assets/demo5.gif +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/rust/eva_fastwalk/Cargo.lock +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/cache/__init__.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/cache/cache.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/cli/__init__.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/cli.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/config/__init__.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/indexing/finder.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/indexing/tree.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/providers/groq_provider.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/providers/opencode_zen_provider.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/providers/openrouter_provider.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/replay/__init__.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/replay/player.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/replay/recorder.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/shell/__init__.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/telemetry/__init__.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/telemetry/metrics.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/ui/formatter.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/ui/streaming.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/workflows/__init__.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/workflows/builtins/dependency_audit.yaml +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/workflows/builtins/repo_health.yaml +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/workflows/builtins/security_scan.yaml +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/workflows/chat_session.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/workflows/engine.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/workspace/__init__.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/src/eva/workspace/session.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/fixtures/golden/patches/sample1_expected.diff +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/fixtures/golden/patches/sample1_fenced.txt +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/fixtures/golden/prompts/analyze_system_prompt.txt +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/fixtures/golden/prompts/ask_system_prompt.txt +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/fixtures/golden/prompts/chat_system_prompt.txt +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/fixtures/golden/prompts/commit_system_prompt.txt +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/fixtures/golden/prompts/edit_system_prompt.txt +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/fixtures/golden/prompts/explain_system_prompt.txt +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/fixtures/golden/prompts/work_system_prompt.txt +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/__init__.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/cache/__init__.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/cache/test_cache.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/cli/__init__.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/cli/test_cli_coverage.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/cli/test_cli_more.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/config/__init__.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/config/test_config.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/golden/__init__.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/golden/test_golden_patches.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/indexing/__init__.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/indexing/test_indexing.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/indexing/test_indexing_more.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/indexing/test_repo_index.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/providers/__init__.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/providers/test_offline_providers.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/providers/test_provider_coverage.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/providers/test_provider_errors.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/providers/test_providers.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/providers/test_providers_more.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/replay/test_replay.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/security/__init__.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/security/test_audit_chain.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/security/test_redaction.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/security/test_safety_audit.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/shell/__init__.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/shell/test_shell.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/telemetry/__init__.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/telemetry/test_metrics.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/ui/__init__.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/ui/test_ui.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/workflows/__init__.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/workflows/test_chat_session.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/workflows/test_workflows.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/workspace/__init__.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/workspace/test_git_ops.py +0 -0
- {eva_cli-3.0.1 → eva_cli-4.1.0}/tests/unit/workspace/test_session_workspace.py +0 -0
- {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:
|
|
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
|
+
|
|
@@ -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/
|
|
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.
|
|
96
|
+
from eva.providers import register_provider
|
|
97
97
|
|
|
98
98
|
register_provider(YourProvider())
|
|
99
99
|
```
|
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
Metadata-Version: 2.
|
|
1
|
+
Metadata-Version: 2.5
|
|
2
2
|
Name: eva-cli
|
|
3
|
-
Version:
|
|
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/
|
|
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
|
|
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
|
|
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
|
|
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.
|