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