echo-guard 0.1.0__tar.gz

echo_guard-0.1.0/.gitignore

@@ -0,0 +1,3 @@
+.venv/
+venv/
+.DS_STORE

echo_guard-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jeremy Wizenfeld
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

echo_guard-0.1.0/PKG-INFO

@@ -0,0 +1,244 @@
+Metadata-Version: 2.4
+Name: echo-guard
+Version: 0.1.0
+Summary: Semantic linting CLI that detects codebase redundancy created by AI coding agents
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: datasketch>=1.6.0
+Requires-Dist: duckdb>=0.9.0
+Requires-Dist: numpy>=1.24.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: scikit-learn>=1.3.0
+Requires-Dist: tree-sitter>=0.22.0
+Requires-Dist: typer>=0.9.0
+Requires-Dist: watchdog>=3.0.0
+Provides-Extra: all
+Requires-Dist: tree-sitter-c>=0.21.0; extra == 'all'
+Requires-Dist: tree-sitter-cpp>=0.21.0; extra == 'all'
+Requires-Dist: tree-sitter-go>=0.21.0; extra == 'all'
+Requires-Dist: tree-sitter-java>=0.21.0; extra == 'all'
+Requires-Dist: tree-sitter-javascript>=0.21.0; extra == 'all'
+Requires-Dist: tree-sitter-python>=0.21.0; extra == 'all'
+Requires-Dist: tree-sitter-ruby>=0.21.0; extra == 'all'
+Requires-Dist: tree-sitter-rust>=0.21.0; extra == 'all'
+Requires-Dist: tree-sitter-typescript>=0.21.0; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: pre-commit>=3.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Provides-Extra: languages
+Requires-Dist: tree-sitter-c>=0.21.0; extra == 'languages'
+Requires-Dist: tree-sitter-cpp>=0.21.0; extra == 'languages'
+Requires-Dist: tree-sitter-go>=0.21.0; extra == 'languages'
+Requires-Dist: tree-sitter-java>=0.21.0; extra == 'languages'
+Requires-Dist: tree-sitter-javascript>=0.21.0; extra == 'languages'
+Requires-Dist: tree-sitter-python>=0.21.0; extra == 'languages'
+Requires-Dist: tree-sitter-ruby>=0.21.0; extra == 'languages'
+Requires-Dist: tree-sitter-rust>=0.21.0; extra == 'languages'
+Requires-Dist: tree-sitter-typescript>=0.21.0; extra == 'languages'
+Provides-Extra: mcp
+Requires-Dist: mcp[cli]>=1.0.0; extra == 'mcp'
+Description-Content-Type: text/markdown
+
+# Echo Guard
+
+**Semantic linting CLI that detects codebase redundancy created by AI coding agents.**
+
+AI agents (Claude Code, Cursor, Copilot) write what's asked without knowing what already exists elsewhere in the repo. Echo Guard catches these duplicates — functionally identical code scattered across modules — before they become legacy debt.
+
+Works across 9 languages. Detects cross-language redundancy. Zero cloud dependency — everything runs locally.
+
+## Installation
+
+```bash
+pip install echo-guard
+```
+
+For all 9 language grammars (recommended):
+
+```bash
+pip install "echo-guard[languages]"
+```
+
+Without `[languages]`, only Python is available.
+
+## Quick Start
+
+```bash
+# Interactive setup — auto-detects languages, configures, indexes, and scans
+echo-guard setup
+
+# Or do it manually:
+echo-guard index          # index your codebase (~6s for a medium repo)
+echo-guard scan           # scan for redundancies (HIGH + MEDIUM shown)
+echo-guard scan -v        # include LOW-severity findings too
+```
+
+## How It Works
+
+Echo Guard uses a 4-stage pipeline:
+
+| Stage                      | What it does                                                                                                                                                                                                | Complexity |
+| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
+| **1. AST fingerprinting**  | Tree-sitter parses every function, normalizes the AST (strips names, comments, literals), and hashes it. Exact structural clones are caught instantly.                                                      | O(n)       |
+| **2. Signature filtering** | Extracts metadata (param count, return type, call count) to eliminate 90%+ of candidates before heavy computation.                                                                                          | O(n)       |
+| **3. LSH + TF-IDF**        | Locality Sensitive Hashing groups similar code vectors into buckets. TF-IDF with subword tokenization runs cosine similarity only on bucket neighbors. Catches semantic duplicates — even across languages. | O(n\*k)    |
+| **4. Intent filtering**    | Domain-noun extraction, antonym detection, UI wrapper recognition, per-service boilerplate exclusion, and cross-language threshold gating. Removes false positives without losing signal.                   | O(n)       |
+
+The index is stored locally in DuckDB (`.echo-guard/index.duckdb`). Nothing leaves your machine.
+
+## Supported Languages
+
+| Language   | Extensions                    |
+| ---------- | ----------------------------- |
+| Python     | `.py`                         |
+| JavaScript | `.js`, `.jsx`, `.mjs`, `.cjs` |
+| TypeScript | `.ts`, `.tsx`                 |
+| Go         | `.go`                         |
+| Rust       | `.rs`                         |
+| Java       | `.java`                       |
+| Ruby       | `.rb`                         |
+| C          | `.c`, `.h`                    |
+| C++        | `.cpp`, `.cc`, `.cxx`, `.hpp` |
+
+Cross-language detection works: a Python `validate_email()` will match a Go `ValidateEmail()` or a JS `validateEmail()`.
+
+## CLI Reference
+
+| Command                     | Description                                                              |
+| --------------------------- | ------------------------------------------------------------------------ |
+| `echo-guard setup`          | Interactive setup wizard — auto-detects repo, configures, indexes, scans |
+| `echo-guard scan`           | Scan for redundant code (HIGH + MEDIUM by default)                       |
+| `echo-guard scan -v`        | Include LOW-severity findings                                            |
+| `echo-guard index`          | Index all functions in the repo                                          |
+| `echo-guard check FILES...` | Check specific files against the index (fast path for pre-commit)        |
+| `echo-guard watch`          | Watch repo and auto-check on file save                                   |
+| `echo-guard health`         | Compute codebase health score (0-100)                                    |
+| `echo-guard stats`          | Show index statistics                                                    |
+| `echo-guard install-hook`   | Install git pre-commit hook                                              |
+| `echo-guard init`           | Create default `.echoguard.yml`                                          |
+| `echo-guard languages`      | List supported languages                                                 |
+| `echo-guard clear-index`    | Clear the index                                                          |
+
+### Key options
+
+- `-t, --threshold FLOAT` — Similarity threshold 0.0-1.0 (default: 0.50)
+- `-o, --output FORMAT` — Output format: `rich` (default), `json`, `compact`
+- `-v, --verbose` — Include LOW-severity findings (hidden by default)
+- `-d, --diff` — Show side-by-side diff for each match
+- `--no-graph` — Disable dependency graph routing
+
+## Severity Levels
+
+| Level      | Similarity | What it means                                                                       | Default behavior  |
+| ---------- | ---------- | ----------------------------------------------------------------------------------- | ----------------- |
+| **HIGH**   | 95-100%    | Near-exact clones. Copy-pasted code with minimal changes.                           | Shown, fails CI   |
+| **MEDIUM** | 80-94%     | Strong semantic match. Same logic, different variable names or minor restructuring. | Shown             |
+| **LOW**    | 50-79%     | Structural similarity. May be intentional patterns or real duplication.             | Hidden (use `-v`) |
+
+The default report shows only HIGH + MEDIUM.
+
+## Configuration
+
+Create `.echoguard.yml` in your repo root (or run `echo-guard setup`):
+
+```yaml
+threshold: 0.50
+min_function_lines: 3
+max_function_lines: 500
+languages:
+  - python
+  - javascript
+  - typescript
+fail_on: high # high, medium, low, none
+enable_dep_graph: true
+
+# Monorepo service boundaries (auto-detected if not set)
+# service_boundaries:
+#   - services/worker
+#   - services/dashboard
+```
+
+### `.echoguardignore`
+
+Gitignore-style file to exclude paths from scanning:
+
+```gitignore
+docs/
+tests/
+*_generated.py
+vendor/
+```
+
+### Recommended configs
+
+**Small project** (< 500 functions):
+
+```yaml
+threshold: 0.50
+fail_on: high
+enable_dep_graph: false
+```
+
+**Large monorepo** (3K+ functions):
+
+```yaml
+threshold: 0.60
+min_function_lines: 4
+fail_on: high
+enable_dep_graph: true
+service_boundaries:
+  - services/api
+  - services/worker
+```
+
+**First-time setup** (advisory mode):
+
+```yaml
+threshold: 0.50
+fail_on: none
+```
+
+## CI Integration
+
+Echo Guard exits non-zero when findings exceed the configured `fail_on` severity.
+
+```yaml
+# GitHub Actions
+- name: Check for redundant code
+  run: |
+    pip install "echo-guard[languages]"
+    echo-guard index
+    echo-guard scan
+```
+
+```bash
+# Pre-commit hook (installed automatically)
+echo-guard install-hook
+```
+
+## MCP Server (Claude Code Integration)
+
+Echo Guard includes an MCP server so Claude Code can check for existing code before writing new functions:
+
+```bash
+# Add to Claude Code
+claude mcp add echo-guard -- python -m echo_guard.mcp_server
+```
+
+| Tool                    | Description                                                           |
+| ----------------------- | --------------------------------------------------------------------- |
+| `check_before_write`    | Pass proposed code, get back existing matches with import suggestions |
+| `search_functions`      | Search the index by function name, keyword, or language               |
+| `suggest_refactor`      | Get full context for consolidating two redundant functions            |
+| `get_index_stats`       | Index statistics and dependency graph info                            |
+| `get_codebase_clusters` | View how the codebase is organized by domain                          |
+
+## Privacy
+
+Echo Guard runs entirely on your machine. No code, metrics, or telemetry are sent anywhere. The index (`.echo-guard/index.duckdb`) contains function metadata from your repo — add it to your `.gitignore`.
+
+## License
+
+[MIT](LICENSE)

echo_guard-0.1.0/README.md

@@ -0,0 +1,201 @@
+# Echo Guard
+
+**Semantic linting CLI that detects codebase redundancy created by AI coding agents.**
+
+AI agents (Claude Code, Cursor, Copilot) write what's asked without knowing what already exists elsewhere in the repo. Echo Guard catches these duplicates — functionally identical code scattered across modules — before they become legacy debt.
+
+Works across 9 languages. Detects cross-language redundancy. Zero cloud dependency — everything runs locally.
+
+## Installation
+
+```bash
+pip install echo-guard
+```
+
+For all 9 language grammars (recommended):
+
+```bash
+pip install "echo-guard[languages]"
+```
+
+Without `[languages]`, only Python is available.
+
+## Quick Start
+
+```bash
+# Interactive setup — auto-detects languages, configures, indexes, and scans
+echo-guard setup
+
+# Or do it manually:
+echo-guard index          # index your codebase (~6s for a medium repo)
+echo-guard scan           # scan for redundancies (HIGH + MEDIUM shown)
+echo-guard scan -v        # include LOW-severity findings too
+```
+
+## How It Works
+
+Echo Guard uses a 4-stage pipeline:
+
+| Stage                      | What it does                                                                                                                                                                                                | Complexity |
+| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
+| **1. AST fingerprinting**  | Tree-sitter parses every function, normalizes the AST (strips names, comments, literals), and hashes it. Exact structural clones are caught instantly.                                                      | O(n)       |
+| **2. Signature filtering** | Extracts metadata (param count, return type, call count) to eliminate 90%+ of candidates before heavy computation.                                                                                          | O(n)       |
+| **3. LSH + TF-IDF**        | Locality Sensitive Hashing groups similar code vectors into buckets. TF-IDF with subword tokenization runs cosine similarity only on bucket neighbors. Catches semantic duplicates — even across languages. | O(n\*k)    |
+| **4. Intent filtering**    | Domain-noun extraction, antonym detection, UI wrapper recognition, per-service boilerplate exclusion, and cross-language threshold gating. Removes false positives without losing signal.                   | O(n)       |
+
+The index is stored locally in DuckDB (`.echo-guard/index.duckdb`). Nothing leaves your machine.
+
+## Supported Languages
+
+| Language   | Extensions                    |
+| ---------- | ----------------------------- |
+| Python     | `.py`                         |
+| JavaScript | `.js`, `.jsx`, `.mjs`, `.cjs` |
+| TypeScript | `.ts`, `.tsx`                 |
+| Go         | `.go`                         |
+| Rust       | `.rs`                         |
+| Java       | `.java`                       |
+| Ruby       | `.rb`                         |
+| C          | `.c`, `.h`                    |
+| C++        | `.cpp`, `.cc`, `.cxx`, `.hpp` |
+
+Cross-language detection works: a Python `validate_email()` will match a Go `ValidateEmail()` or a JS `validateEmail()`.
+
+## CLI Reference
+
+| Command                     | Description                                                              |
+| --------------------------- | ------------------------------------------------------------------------ |
+| `echo-guard setup`          | Interactive setup wizard — auto-detects repo, configures, indexes, scans |
+| `echo-guard scan`           | Scan for redundant code (HIGH + MEDIUM by default)                       |
+| `echo-guard scan -v`        | Include LOW-severity findings                                            |
+| `echo-guard index`          | Index all functions in the repo                                          |
+| `echo-guard check FILES...` | Check specific files against the index (fast path for pre-commit)        |
+| `echo-guard watch`          | Watch repo and auto-check on file save                                   |
+| `echo-guard health`         | Compute codebase health score (0-100)                                    |
+| `echo-guard stats`          | Show index statistics                                                    |
+| `echo-guard install-hook`   | Install git pre-commit hook                                              |
+| `echo-guard init`           | Create default `.echoguard.yml`                                          |
+| `echo-guard languages`      | List supported languages                                                 |
+| `echo-guard clear-index`    | Clear the index                                                          |
+
+### Key options
+
+- `-t, --threshold FLOAT` — Similarity threshold 0.0-1.0 (default: 0.50)
+- `-o, --output FORMAT` — Output format: `rich` (default), `json`, `compact`
+- `-v, --verbose` — Include LOW-severity findings (hidden by default)
+- `-d, --diff` — Show side-by-side diff for each match
+- `--no-graph` — Disable dependency graph routing
+
+## Severity Levels
+
+| Level      | Similarity | What it means                                                                       | Default behavior  |
+| ---------- | ---------- | ----------------------------------------------------------------------------------- | ----------------- |
+| **HIGH**   | 95-100%    | Near-exact clones. Copy-pasted code with minimal changes.                           | Shown, fails CI   |
+| **MEDIUM** | 80-94%     | Strong semantic match. Same logic, different variable names or minor restructuring. | Shown             |
+| **LOW**    | 50-79%     | Structural similarity. May be intentional patterns or real duplication.             | Hidden (use `-v`) |
+
+The default report shows only HIGH + MEDIUM.
+
+## Configuration
+
+Create `.echoguard.yml` in your repo root (or run `echo-guard setup`):
+
+```yaml
+threshold: 0.50
+min_function_lines: 3
+max_function_lines: 500
+languages:
+  - python
+  - javascript
+  - typescript
+fail_on: high # high, medium, low, none
+enable_dep_graph: true
+
+# Monorepo service boundaries (auto-detected if not set)
+# service_boundaries:
+#   - services/worker
+#   - services/dashboard
+```
+
+### `.echoguardignore`
+
+Gitignore-style file to exclude paths from scanning:
+
+```gitignore
+docs/
+tests/
+*_generated.py
+vendor/
+```
+
+### Recommended configs
+
+**Small project** (< 500 functions):
+
+```yaml
+threshold: 0.50
+fail_on: high
+enable_dep_graph: false
+```
+
+**Large monorepo** (3K+ functions):
+
+```yaml
+threshold: 0.60
+min_function_lines: 4
+fail_on: high
+enable_dep_graph: true
+service_boundaries:
+  - services/api
+  - services/worker
+```
+
+**First-time setup** (advisory mode):
+
+```yaml
+threshold: 0.50
+fail_on: none
+```
+
+## CI Integration
+
+Echo Guard exits non-zero when findings exceed the configured `fail_on` severity.
+
+```yaml
+# GitHub Actions
+- name: Check for redundant code
+  run: |
+    pip install "echo-guard[languages]"
+    echo-guard index
+    echo-guard scan
+```
+
+```bash
+# Pre-commit hook (installed automatically)
+echo-guard install-hook
+```
+
+## MCP Server (Claude Code Integration)
+
+Echo Guard includes an MCP server so Claude Code can check for existing code before writing new functions:
+
+```bash
+# Add to Claude Code
+claude mcp add echo-guard -- python -m echo_guard.mcp_server
+```
+
+| Tool                    | Description                                                           |
+| ----------------------- | --------------------------------------------------------------------- |
+| `check_before_write`    | Pass proposed code, get back existing matches with import suggestions |
+| `search_functions`      | Search the index by function name, keyword, or language               |
+| `suggest_refactor`      | Get full context for consolidating two redundant functions            |
+| `get_index_stats`       | Index statistics and dependency graph info                            |
+| `get_codebase_clusters` | View how the codebase is organized by domain                          |
+
+## Privacy
+
+Echo Guard runs entirely on your machine. No code, metrics, or telemetry are sent anywhere. The index (`.echo-guard/index.duckdb`) contains function metadata from your repo — add it to your `.gitignore`.
+
+## License
+
+[MIT](LICENSE)

echo_guard-0.1.0/echo_guard/__init__.py

@@ -0,0 +1,6 @@
+"""Echo Guard - Semantic linting for AI-generated code redundancy.
+
+Supports: Python, JavaScript, TypeScript, Go, Rust, Java, Ruby, C, C++
+"""
+
+__version__ = "0.2.0"