dug-cli 0.1.0__tar.gz

dug_cli-0.1.0/.github/homebrew/dug-cli.rb

@@ -0,0 +1,31 @@
+# This file lives in a separate repo: github.com/ratishjain12/homebrew-dug
+# Create that repo and put this file at: Formula/dug-cli.rb
+#
+# Users install with:
+#   brew tap ratishjain12/dug
+#   brew install dug-cli
+
+class DugCli < Formula
+  desc "Dig into any bug with full codebase context — zero LLM calls"
+  homepage "https://github.com/ratishjain12/dug"
+  version "0.1.0"
+
+  on_macos do
+    on_arm do
+      url "https://github.com/ratishjain12/dug/releases/download/v#{version}/dug-macos-arm64"
+      sha256 "REPLACE_WITH_ARM64_SHA256"
+    end
+    on_intel do
+      url "https://github.com/ratishjain12/dug/releases/download/v#{version}/dug-macos-amd64"
+      sha256 "REPLACE_WITH_AMD64_SHA256"
+    end
+  end
+
+  def install
+    bin.install Dir["dug-macos-*"].first => "dug"
+  end
+
+  test do
+    system "#{bin}/dug", "--help"
+  end
+end

dug_cli-0.1.0/.github/scoop/dug-cli.json

@@ -0,0 +1,23 @@
+{
+  "version": "0.1.0",
+  "description": "Dig into any bug with full codebase context — zero LLM calls",
+  "homepage": "https://github.com/ratishjain12/dug",
+  "license": "MIT",
+  "architecture": {
+    "64bit": {
+      "url": "https://github.com/ratishjain12/dug/releases/download/v0.1.0/dug-windows-amd64.exe",
+      "hash": "REPLACE_WITH_SHA256"
+    }
+  },
+  "bin": "dug-windows-amd64.exe",
+  "checkver": {
+    "github": "https://github.com/ratishjain12/dug"
+  },
+  "autoupdate": {
+    "architecture": {
+      "64bit": {
+        "url": "https://github.com/ratishjain12/dug/releases/download/v$version/dug-windows-amd64.exe"
+      }
+    }
+  }
+}

dug_cli-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,132 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write   # needed to create GitHub Release and upload assets
+
+jobs:
+  # -----------------------------------------------------------------------
+  # 1. Publish to PyPI
+  # -----------------------------------------------------------------------
+  pypi:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v3
+        with:
+          version: "latest"
+
+      - name: Build
+        run: uv build
+
+      - name: Publish
+        run: uv publish
+        env:
+          UV_PUBLISH_TOKEN: ${{ secrets.PYPI_TOKEN }}
+
+  # -----------------------------------------------------------------------
+  # 2. Build standalone binaries with PyInstaller
+  # -----------------------------------------------------------------------
+  binaries:
+    name: Build binary — ${{ matrix.target }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: macos-14          # Apple Silicon (arm64)
+            target: macos-arm64
+            bin: dug
+
+          - os: macos-13          # Intel (amd64)
+            target: macos-amd64
+            bin: dug
+
+          - os: ubuntu-latest
+            target: linux-amd64
+            bin: dug
+
+          - os: windows-latest
+            target: windows-amd64
+            bin: dug.exe
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v3
+        with:
+          version: "latest"
+
+      - name: Install dependencies + PyInstaller
+        # Install base deps only (no sentence-transformers/openai/torch)
+        run: uv pip install --system -e "." pyinstaller
+
+      - name: Build binary
+        # Exclude heavy ML packages — they auto-install on first use instead
+        run: >
+          pyinstaller
+          --onefile
+          --name dug
+          --collect-submodules dug
+          --hidden-import=dug.__main__
+          --exclude-module torch
+          --exclude-module transformers
+          --exclude-module sentence_transformers
+          --exclude-module tokenizers
+          --exclude-module scipy
+          --exclude-module sklearn
+          --exclude-module openai
+          src/dug/__main__.py
+
+      - name: Rename binary with target suffix
+        shell: bash
+        run: |
+          mkdir -p release
+          cp dist/${{ matrix.bin }} release/dug-${{ matrix.target }}${{ matrix.os == 'windows-latest' && '.exe' || '' }}
+
+      - name: Upload binary artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: binary-${{ matrix.target }}
+          path: release/
+
+  # -----------------------------------------------------------------------
+  # 3. Create GitHub Release with all assets
+  # -----------------------------------------------------------------------
+  release:
+    name: Create GitHub Release
+    needs: [pypi, binaries]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v3
+
+      - name: Build wheel for release assets
+        run: uv build
+
+      - name: Download all binaries
+        uses: actions/download-artifact@v4
+        with:
+          pattern: binary-*
+          merge-multiple: true
+          path: release/
+
+      - name: Show release assets
+        run: ls -lh release/ dist/
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          name: ${{ github.ref_name }}
+          generate_release_notes: true
+          files: |
+            dist/*.whl
+            dist/*.tar.gz
+            release/*

dug_cli-0.1.0/.github/workflows/update-homebrew.yml

@@ -0,0 +1,51 @@
+name: Update Homebrew Formula
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  update-formula:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Get release assets and compute SHA256
+        id: hashes
+        run: |
+          TAG="${{ github.event.release.tag_name }}"
+          VERSION="${TAG#v}"
+
+          ARM64_URL="https://github.com/ratishjain12/dug/releases/download/${TAG}/dug-macos-arm64"
+          AMD64_URL="https://github.com/ratishjain12/dug/releases/download/${TAG}/dug-macos-amd64"
+
+          ARM64_SHA=$(curl -fsSL "$ARM64_URL" | sha256sum | cut -d' ' -f1)
+          AMD64_SHA=$(curl -fsSL "$AMD64_URL" | sha256sum | cut -d' ' -f1)
+
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          echo "arm64_sha=$ARM64_SHA" >> $GITHUB_OUTPUT
+          echo "amd64_sha=$AMD64_SHA" >> $GITHUB_OUTPUT
+
+      - name: Checkout homebrew-dug repo
+        uses: actions/checkout@v4
+        with:
+          repository: ratishjain12/homebrew-dug
+          token: ${{ secrets.HOMEBREW_TAP_TOKEN }}
+          path: homebrew-dug
+
+      - name: Update formula
+        run: |
+          cd homebrew-dug
+          sed -i "s/version \".*\"/version \"${{ steps.hashes.outputs.version }}\"/" Formula/dug-cli.rb
+          sed -i "s/REPLACE_WITH_ARM64_SHA256/${{ steps.hashes.outputs.arm64_sha }}/" Formula/dug-cli.rb
+          sed -i "s/REPLACE_WITH_AMD64_SHA256/${{ steps.hashes.outputs.amd64_sha }}/" Formula/dug-cli.rb
+          # Also update existing sha256 lines
+          sed -i "/on_arm/,/end/{s/sha256 \".*\"/sha256 \"${{ steps.hashes.outputs.arm64_sha }}\"/}" Formula/dug-cli.rb
+          sed -i "/on_intel/,/end/{s/sha256 \".*\"/sha256 \"${{ steps.hashes.outputs.amd64_sha }}\"/}" Formula/dug-cli.rb
+
+      - name: Commit and push
+        run: |
+          cd homebrew-dug
+          git config user.name "ratishjain12"
+          git config user.email "ratishjain6@gmail.com"
+          git add Formula/dug-cli.rb
+          git diff --staged --quiet || git commit -m "Update dug-cli to ${{ github.event.release.tag_name }}"
+          git push

dug_cli-0.1.0/.gitignore

@@ -0,0 +1,16 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# dug local index — machine-specific, never commit
+.dug/
+
+# uv lockfile — not needed for a CLI tool's consumers
+uv.lock

dug_cli-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12

dug_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Ratish Jain
+
+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.

dug_cli-0.1.0/PKG-INFO

@@ -0,0 +1,178 @@
+Metadata-Version: 2.4
+Name: dug-cli
+Version: 0.1.0
+Summary: Dig into any bug with full codebase context — zero LLM calls
+Project-URL: Homepage, https://github.com/ratishjain12/dug
+Project-URL: Repository, https://github.com/ratishjain12/dug
+Project-URL: Bug Tracker, https://github.com/ratishjain12/dug/issues
+Author-email: Ratish Jain <ratishjain6@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: claude,cli,code-search,debugging,developer-tools
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Debuggers
+Requires-Python: >=3.10
+Requires-Dist: click
+Requires-Dist: lancedb
+Requires-Dist: networkx
+Requires-Dist: tree-sitter-java
+Requires-Dist: tree-sitter-javascript
+Requires-Dist: tree-sitter-python
+Requires-Dist: tree-sitter-typescript>=0.23.2
+Requires-Dist: tree-sitter>=0.22
+Requires-Dist: watchdog
+Provides-Extra: all
+Requires-Dist: openai; extra == 'all'
+Requires-Dist: sentence-transformers; extra == 'all'
+Provides-Extra: local
+Requires-Dist: sentence-transformers; extra == 'local'
+Provides-Extra: openai
+Requires-Dist: openai; extra == 'openai'
+Description-Content-Type: text/markdown
+
+# dug
+
+**Dig into any bug with full codebase context — zero LLM calls.**
+
+[![PyPI version](https://img.shields.io/pypi/v/dug-cli)](https://pypi.org/project/dug-cli/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue)](https://pypi.org/project/dug-cli/)
+
+`dug` takes a bug report or stack trace and generates a structured [Claude Code](https://claude.ai/code) prompt that includes the exact files, functions, and context needed to fix it — using grep, AST parsing, and a local vector index with **no API calls and no LLM required**.
+
+---
+
+## Install
+
+```sh
+# Recommended
+pipx install dug-cli
+
+# macOS (Homebrew)
+brew tap ratishjain12/dug
+brew install dug-cli
+
+# One-liner (Linux / macOS)
+curl -fsSL https://raw.githubusercontent.com/ratishjain12/dug/main/install.sh | sh
+
+# Inside a virtualenv
+pip install dug-cli
+```
+
+---
+
+## Quick start
+
+```sh
+# 1. Run once in your repo root to build the index
+cd /your/project
+dug init
+
+# 2. Paste any bug report or stack trace
+dug "NullPointerException in UserService.authenticate at line 42"
+
+# dug prints a ready-to-paste Claude Code prompt with ranked file context
+```
+
+**Sample output:**
+
+```
+You are a senior engineer debugging this issue:
+
+  NullPointerException in UserService.authenticate at line 42
+
+Relevant files (ranked by relevance):
+
+1. src/auth/UserService.java:35
+   authenticate() — modified 2 commits ago
+   ...
+
+2. src/config/AppConfig.java:12
+   loadConfig() — error pattern match
+   ...
+
+[full function bodies + graph context follow]
+```
+
+---
+
+## How it works
+
+`dug` builds a **local knowledge base** the first time you run `dug init`:
+
+| Layer | What it builds | Used for |
+|---|---|---|
+| Structural graph | File → Symbol → Commit nodes (networkx) | Import chains, recent changes |
+| Semantic index | Function embeddings in LanceDB (sentence-transformers) | Meaning-level matches |
+| History log | Past bug→fix pairs | Learning from outcomes |
+
+At query time, three signals are combined into a ranked list:
+
+- **Structural score** — imports your error file, was modified in a related commit
+- **Semantic score** — cosine similarity between bug text and function bodies
+- **History boost** — similar past bugs pointed here
+
+The index stays fresh via git hooks (`post-commit`, `post-checkout`) and an optional file watcher.
+
+---
+
+## Commands
+
+| Command | What it does |
+|---|---|
+| `dug init` | Index the current repo (builds graph + embeddings) |
+| `dug "error text"` | Generate a Claude Code prompt for the bug |
+| `dug update` | Re-index files changed since last commit |
+| `dug watch` | Watch for file saves and re-index in real time |
+| `dug stats` | Show index size (nodes, edges, chunks) |
+| `dug config` | View / edit configuration |
+| `dug feedback good` | Mark last query as helpful (improves future results) |
+| `dug feedback bad` | Mark last query as unhelpful |
+
+### Options
+
+```sh
+dug init --local          # Use local embeddings (default, no API key needed)
+dug init --openai         # Use OpenAI text-embedding-3-small (needs OPENAI_API_KEY)
+dug "error" --files 3     # Limit to top 3 files in prompt
+dug "error" --no-history  # Skip learning loop context
+```
+
+---
+
+## Configuration
+
+`dug init` creates `.dug/config.json` in the repo root. You can also edit it with `dug config set <key> <value>`.
+
+```json
+{
+  "embedding_mode": "local",
+  "languages": ["python", "java", "typescript", "javascript"],
+  "max_files_in_prompt": 5,
+  "git_history_depth": 50,
+  "exclude_test_files": true
+}
+```
+
+`.dug/` is automatically added to `.gitignore` — it's machine-specific and never committed.
+
+---
+
+## Contributing
+
+```sh
+git clone https://github.com/ratishjain12/dug
+cd dug
+uv sync
+uv run dug init   # index the dug repo itself
+uv run dug "your bug here"
+```
+
+Requires Python 3.10+ and [uv](https://docs.astral.sh/uv/).

dug_cli-0.1.0/README.md

@@ -0,0 +1,139 @@
+# dug
+
+**Dig into any bug with full codebase context — zero LLM calls.**
+
+[![PyPI version](https://img.shields.io/pypi/v/dug-cli)](https://pypi.org/project/dug-cli/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue)](https://pypi.org/project/dug-cli/)
+
+`dug` takes a bug report or stack trace and generates a structured [Claude Code](https://claude.ai/code) prompt that includes the exact files, functions, and context needed to fix it — using grep, AST parsing, and a local vector index with **no API calls and no LLM required**.
+
+---
+
+## Install
+
+```sh
+# Recommended
+pipx install dug-cli
+
+# macOS (Homebrew)
+brew tap ratishjain12/dug
+brew install dug-cli
+
+# One-liner (Linux / macOS)
+curl -fsSL https://raw.githubusercontent.com/ratishjain12/dug/main/install.sh | sh
+
+# Inside a virtualenv
+pip install dug-cli
+```
+
+---
+
+## Quick start
+
+```sh
+# 1. Run once in your repo root to build the index
+cd /your/project
+dug init
+
+# 2. Paste any bug report or stack trace
+dug "NullPointerException in UserService.authenticate at line 42"
+
+# dug prints a ready-to-paste Claude Code prompt with ranked file context
+```
+
+**Sample output:**
+
+```
+You are a senior engineer debugging this issue:
+
+  NullPointerException in UserService.authenticate at line 42
+
+Relevant files (ranked by relevance):
+
+1. src/auth/UserService.java:35
+   authenticate() — modified 2 commits ago
+   ...
+
+2. src/config/AppConfig.java:12
+   loadConfig() — error pattern match
+   ...
+
+[full function bodies + graph context follow]
+```
+
+---
+
+## How it works
+
+`dug` builds a **local knowledge base** the first time you run `dug init`:
+
+| Layer | What it builds | Used for |
+|---|---|---|
+| Structural graph | File → Symbol → Commit nodes (networkx) | Import chains, recent changes |
+| Semantic index | Function embeddings in LanceDB (sentence-transformers) | Meaning-level matches |
+| History log | Past bug→fix pairs | Learning from outcomes |
+
+At query time, three signals are combined into a ranked list:
+
+- **Structural score** — imports your error file, was modified in a related commit
+- **Semantic score** — cosine similarity between bug text and function bodies
+- **History boost** — similar past bugs pointed here
+
+The index stays fresh via git hooks (`post-commit`, `post-checkout`) and an optional file watcher.
+
+---
+
+## Commands
+
+| Command | What it does |
+|---|---|
+| `dug init` | Index the current repo (builds graph + embeddings) |
+| `dug "error text"` | Generate a Claude Code prompt for the bug |
+| `dug update` | Re-index files changed since last commit |
+| `dug watch` | Watch for file saves and re-index in real time |
+| `dug stats` | Show index size (nodes, edges, chunks) |
+| `dug config` | View / edit configuration |
+| `dug feedback good` | Mark last query as helpful (improves future results) |
+| `dug feedback bad` | Mark last query as unhelpful |
+
+### Options
+
+```sh
+dug init --local          # Use local embeddings (default, no API key needed)
+dug init --openai         # Use OpenAI text-embedding-3-small (needs OPENAI_API_KEY)
+dug "error" --files 3     # Limit to top 3 files in prompt
+dug "error" --no-history  # Skip learning loop context
+```
+
+---
+
+## Configuration
+
+`dug init` creates `.dug/config.json` in the repo root. You can also edit it with `dug config set <key> <value>`.
+
+```json
+{
+  "embedding_mode": "local",
+  "languages": ["python", "java", "typescript", "javascript"],
+  "max_files_in_prompt": 5,
+  "git_history_depth": 50,
+  "exclude_test_files": true
+}
+```
+
+`.dug/` is automatically added to `.gitignore` — it's machine-specific and never committed.
+
+---
+
+## Contributing
+
+```sh
+git clone https://github.com/ratishjain12/dug
+cd dug
+uv sync
+uv run dug init   # index the dug repo itself
+uv run dug "your bug here"
+```
+
+Requires Python 3.10+ and [uv](https://docs.astral.sh/uv/).