claude-jacked 0.2.9__py3-none-any.whl → 0.3.1__py3-none-any.whl

{claude_jacked-0.2.9.dist-info → claude_jacked-0.3.1.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: claude-jacked
-Version: 0.2.9
-Summary: Cross-machine semantic search for Claude Code sessions
+Version: 0.3.1
+Summary: Smart reviewers, commands, and session search for Claude Code
 Project-URL: Homepage, https://github.com/jackneil/claude-jacked
 Project-URL: Repository, https://github.com/jackneil/claude-jacked
 Project-URL: Issues, https://github.com/jackneil/claude-jacked/issues
@@ -19,25 +19,34 @@ Classifier: Programming Language :: Python :: 3.12
 Requires-Python: >=3.10
 Requires-Dist: click>=8.0.0
 Requires-Dist: python-dotenv>=1.0.0
-Requires-Dist: qdrant-client>=1.7.0
 Requires-Dist: rich>=13.0.0
+Provides-Extra: all
+Requires-Dist: anthropic>=0.40.0; extra == 'all'
+Requires-Dist: qdrant-client>=1.7.0; extra == 'all'
 Provides-Extra: dev
+Requires-Dist: anthropic>=0.40.0; extra == 'dev'
 Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
 Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: qdrant-client>=1.7.0; extra == 'dev'
+Provides-Extra: search
+Requires-Dist: qdrant-client>=1.7.0; extra == 'search'
+Provides-Extra: security
+Requires-Dist: anthropic>=0.40.0; extra == 'security'
 Description-Content-Type: text/markdown
 
 # claude-jacked
 
-**Never lose your Claude Code work again.** Search past conversations, share solutions with your team, and get AI-powered code reviews—all from within Claude Code.
+**Smart reviewers, quick commands, and session search for Claude Code.** Catch bugs before they ship, search past conversations, and auto-approve safe commands — all from within Claude Code.
 
 ---
 
 ## What You Get
 
-- **Find past solutions instantly** — "How did I fix that login bug last month?" Just ask, and get the answer.
-- **Work from any computer** — Start on your desktop, continue on your laptop. Your history follows you.
-- **Share knowledge with your team** — Your teammate already solved this problem. Find their solution in seconds.
 - **Catch mistakes before they ship** — Built-in reviewers check for security issues, complexity, and common bugs.
+- **Quick commands** — `/dc`, `/pr`, `/learn`, `/redo`, `/techdebt`, `/audit-rules` for common workflows.
+- **Find past solutions instantly** — Search past Claude sessions by meaning, not keywords. *(requires [search] extra)*
+- **Work from any computer** — Start on your desktop, continue on your laptop. *(requires [search] extra)*
+- **Auto-approve safe commands** — Security gatekeeper evaluates bash commands so you only get interrupted for risky ones. *(requires [security] extra)*
 - **Sound notifications** — Get audio alerts when Claude needs your attention or finishes a task.
 
 ---
@@ -49,6 +58,7 @@ Description-Content-Type: text/markdown
 - [Using the Session Search](#using-the-session-search)
 - [Working with Your Team](#working-with-your-team)
 - [Built-in Reviewers and Commands](#built-in-reviewers-and-commands)
+- [Security Gatekeeper](#security-gatekeeper)
 - [Sound Notifications](#sound-notifications)
 - [Uninstall](#uninstall)
 - [Common Issues](#common-issues)
@@ -58,50 +68,82 @@ Description-Content-Type: text/markdown
 
 ## Quick Start
 
-### Option 1: Let Claude Install It For You
+### Option 1: Let Claude Install It
 
-Copy this into Claude Code and it will handle everything:
+Copy this into Claude Code and it will walk you through the options:
 
 ```
-Install claude-jacked for me. Walk me through each step and help me set up Qdrant Cloud.
+Install claude-jacked for me. Use AskUserQuestion to ask me which features I want:
+
+1. First check if pipx and jacked are already installed
+2. Ask me which install tier I want:
+   - BASE: Smart reviewers, commands (/dc, /pr, /learn, etc.), behavioral rules
+   - SEARCH: Everything above + session search across machines (requires Qdrant Cloud ~$30/mo)
+   - SECURITY: Everything above + auto-approve safe bash commands (fewer permission prompts)
+   - ALL: Everything
+3. Install based on my choice:
+   - BASE: pipx install claude-jacked && jacked install
+   - SEARCH: pipx install "claude-jacked[search]" && jacked install
+   - SECURITY: pipx install "claude-jacked[security]" && jacked install --security
+   - ALL: pipx install "claude-jacked[all]" && jacked install --security
+4. If I chose SEARCH or ALL, help me set up Qdrant Cloud credentials
+5. Verify with: jacked --help
 ```
 
-### Option 2: One-Line Install
+### Option 2: Manual Install
 
-**Mac/Linux:**
+**Core (reviewers, commands, behavioral rules):**
 ```bash
-curl -sSL https://raw.githubusercontent.com/jackneil/claude-jacked/master/install.sh | bash
+pipx install claude-jacked
+jacked install
 ```
 
-**Windows (in Git Bash):**
+**Add session search (optional):**
 ```bash
-curl -sSL https://raw.githubusercontent.com/jackneil/claude-jacked/master/install.sh | bash
+pipx install "claude-jacked[search]"
+jacked install
+# Then set up Qdrant Cloud credentials (see below)
 ```
 
-After installing, you'll need to set up a free cloud database (Qdrant) to store your session history. The installer will guide you through this, or ask Claude to help: `"Help me set up Qdrant Cloud for jacked"`
-
-### Option 3: Manual Install
-
+**Add security gatekeeper (optional):**
 ```bash
-pipx install claude-jacked
-jacked install
+pipx install "claude-jacked[security]"
+jacked install --security
 ```
 
-Then follow the [cloud database setup](#cloud-database-setup-qdrant) instructions below.
+**Everything:**
+```bash
+pipx install "claude-jacked[all]"
+jacked install --security
+```
 
 ---
 
 ## What's Included
 
-When you run `jacked install`, you get:
+### Base (`pip install claude-jacked`)
 
 | Feature | What It Does |
 |---------|--------------|
-| **Session Search** | Find any past Claude conversation by describing what you were working on |
 | **10 Smart Reviewers** | AI assistants that check your code for bugs, security issues, and complexity |
-| **Quick Commands** | `/dc` for code review, `/pr` for pull request help |
+| **Quick Commands** | `/dc`, `/pr`, `/learn`, `/redo`, `/techdebt`, `/audit-rules` |
+| **Behavioral Rules** | Auto-triggers for jacked commands, lesson tracking, plan-first workflow |
+| **Sound Notifications** | Audio alerts when Claude needs input or finishes (via `--sounds`) |
+
+### Search Extra (`pip install "claude-jacked[search]"`)
+
+| Feature | What It Does |
+|---------|--------------|
+| **Session Search** | Find any past Claude conversation by describing what you were working on |
+| **Cross-Machine Sync** | Start on desktop, continue on laptop — your history follows you |
 | **Team Sharing** | Search your teammates' sessions (with their permission) |
 
+### Security Extra (`pip install "claude-jacked[security]"`)
+
+| Feature | What It Does |
+|---------|--------------|
+| **Security Gatekeeper** | Auto-approves safe bash commands, blocks dangerous ones, asks you about ambiguous ones |
+
 ---
 
 ## Using the Session Search
@@ -188,7 +230,11 @@ Type these directly in Claude Code:
 | Command | What It Does |
 |---------|--------------|
 | `/dc` | **Double-check** — Reviews your recent work for bugs, security issues, and problems |
-| `/pr` | **Pull Request** — Helps organize your changes and create a clean PR |
+| `/pr` | **Pull Request** — Checks PR status, creates/updates PRs with proper issue linking |
+| `/learn` | **Learn** — Distills a lesson from the current session into a CLAUDE.md rule |
+| `/redo` | **Redo** — Scraps the current approach and re-implements cleanly with full hindsight |
+| `/techdebt` | **Tech Debt** — Scans for TODOs, oversized files, missing tests, dead code |
+| `/audit-rules` | **Audit Rules** — Checks CLAUDE.md for duplicates, contradictions, stale rules |
 
 ### Smart Reviewers
 
@@ -208,6 +254,58 @@ Use the double-check reviewer to review what we just built
 
 ---
 
+## Security Gatekeeper
+
+The security gatekeeper is a PreToolUse hook that intercepts every bash command Claude runs and decides whether to auto-approve it or ask you first.
+
+### How It Works
+
+A 4-tier evaluation chain, fastest first:
+
+| Tier | Speed | What It Does |
+|------|-------|--------------|
+| **Deny patterns** | <1ms | Blocks dangerous commands (sudo, rm -rf /, disk wipe, etc.) |
+| **Permission rules** | <1ms | Checks commands already approved in your Claude settings |
+| **Local allowlist** | <1ms | Matches safe patterns (git, pytest, linting, docker, etc.) |
+| **LLM evaluation** | ~2s | Sends ambiguous commands to Haiku for safety evaluation |
+
+About 90% of commands resolve in under 2 milliseconds. The LLM tier also reads the contents of referenced Python/SQL/shell scripts and evaluates what the code actually does.
+
+### Install / Uninstall
+
+The security gatekeeper is opt-in. To enable it:
+
+```bash
+pip install "claude-jacked[security]"
+jacked install --security
+```
+
+To remove just the security hook:
+```bash
+jacked uninstall --security
+```
+
+### Debug Logging
+
+```bash
+# Always-on log (decisions only)
+cat ~/.claude/hooks-debug.log
+
+# Verbose debug mode
+export JACKED_HOOK_DEBUG=1
+```
+
+### Faster LLM Evaluation
+
+If you have an Anthropic API key, the gatekeeper uses the SDK directly (~2s) instead of the CLI fallback (~8s):
+
+```bash
+pip install anthropic               # or: pip install claude-jacked[security]
+export ANTHROPIC_API_KEY="sk-..."
+```
+
+---
+
 ## Sound Notifications
 
 Get audio alerts so you don't have to watch the terminal:
@@ -277,6 +375,8 @@ Help me fix jacked path issues on Windows
 
 ## Cloud Database Setup (Qdrant)
 
+> **This is only needed if you installed the `[search]` extra.** The base install works fine without Qdrant.
+
 The session search feature stores your conversations in a cloud database so you can access them from any computer.
 
 ### Why Qdrant?
@@ -288,10 +388,11 @@ The session search feature stores your conversations in a cloud database so you
 
 ### Setting Up Qdrant Cloud
 
-1. Go to [cloud.qdrant.io](https://cloud.qdrant.io) and create an account
-2. Create a new cluster (the paid tier ~$30/month is required for the search features)
-3. Copy your cluster URL and API key
-4. Add them to your shell profile:
+1. Install the search extra: `pip install "claude-jacked[search]"`
+2. Go to [cloud.qdrant.io](https://cloud.qdrant.io) and create an account
+3. Create a new cluster (the paid tier ~$30/month is required for the search features)
+4. Copy your cluster URL and API key
+5. Add them to your shell profile:
 
 **Mac/Linux** — Add to `~/.bashrc` or `~/.zshrc`:
 ```bash
@@ -301,7 +402,7 @@ export QDRANT_CLAUDE_SESSIONS_API_KEY="your-api-key"
 
 **Windows** — Add to your environment variables, or add to `~/.bashrc` in Git Bash.
 
-5. Restart your terminal and run:
+6. Restart your terminal and run:
 ```bash
 jacked backfill    # Index your existing sessions
 jacked status      # Verify it's working
@@ -343,13 +444,16 @@ jacked delete <session_id>         # Remove from index
 jacked cleardb                     # Delete all your data
 
 # Setup
-jacked install                     # Install hooks, agents, commands
+jacked install                     # Install agents, commands, rules
+jacked install --search            # Also add session indexing hook
+jacked install --security          # Also add security gatekeeper hook
 jacked install --sounds            # Also add sound notifications
 jacked uninstall                   # Remove from Claude Code
 jacked uninstall --sounds          # Remove only sounds
-jacked backfill                    # Index all existing sessions
+jacked uninstall --security        # Remove only security hook
+jacked backfill                    # Index all existing sessions (requires [search])
 jacked backfill --force            # Re-index everything
-jacked status                      # Check connectivity
+jacked status                      # Check connectivity (requires [search])
 jacked configure --show            # Show current config
 ```
 
@@ -371,6 +475,8 @@ jacked configure --show            # Show current config
 | `JACKED_TEAMMATE_WEIGHT` | 0.8 | How much to weight teammate results |
 | `JACKED_OTHER_REPO_WEIGHT` | 0.7 | How much to weight other repos |
 | `JACKED_TIME_DECAY_HALFLIFE_WEEKS` | 35 | How fast old sessions lose relevance |
+| `JACKED_HOOK_DEBUG` | (unset) | Set to `1` for verbose security hook logging |
+| `ANTHROPIC_API_KEY` | (unset) | Enables fast (~2s) LLM evaluation in security hook |
 
 </details>
 
@@ -437,16 +543,32 @@ jacked configure --show            # Show current config
 <details>
 <summary><strong>Hook Configuration</strong></summary>
 
-The `jacked install` command adds this to `~/.claude/settings.json`:
+The `jacked install` command adds hooks to `~/.claude/settings.json` based on installed extras:
 
 ```json
+// With [search] extra installed:
 {
   "hooks": {
     "Stop": [{
       "matcher": "",
       "hooks": [{
         "type": "command",
-        "command": "jacked index --repo \"$CLAUDE_PROJECT_DIR\""
+        "command": "jacked index --repo \"$CLAUDE_PROJECT_DIR\"",
+        "async": true
+      }]
+    }]
+  }
+}
+
+// With --security flag:
+{
+  "hooks": {
+    "PreToolUse": [{
+      "matcher": "Bash",
+      "hooks": [{
+        "type": "command",
+        "command": "python /path/to/security_gatekeeper.py",
+        "timeout": 30
       }]
     }]
   }
@@ -461,26 +583,48 @@ The `jacked install` command adds this to `~/.claude/settings.json`:
 Copy this into Claude Code for a guided installation:
 
 ```
-Install claude-jacked for me. First check what's already set up, then help me with anything missing:
-
-DIAGNOSTIC PHASE (run these first to see current state):
-- Detect my operating system
-- Check if pipx is installed: pipx --version
-- Check if jacked CLI is installed: jacked --version
-- Check if Qdrant credentials are set: echo $QDRANT_CLAUDE_SESSIONS_ENDPOINT
-- Check if hook is installed: look in ~/.claude/settings.json for "jacked index"
-
-WINDOWS EXTRA CHECK (Git Bash doesn't inherit Windows System Environment):
-- If env vars NOT visible in bash, check Windows:
-  powershell.exe -Command "[System.Environment]::GetEnvironmentVariable('QDRANT_CLAUDE_SESSIONS_ENDPOINT', 'User')"
-
-SETUP PHASE (only do steps that are missing):
-1. If no pipx: pip install pipx && pipx ensurepath
-2. If jacked not installed: pipx install claude-jacked && jacked install
-3. If no Qdrant credentials: walk me through cloud.qdrant.io setup
-4. If no indexed sessions: jacked backfill
-
-VERIFY: jacked status && jacked configure --show
+Install claude-jacked for me. Use the AskUserQuestion tool to guide me through options.
+
+PHASE 1 - DIAGNOSTICS:
+- Detect OS (Windows/Mac/Linux)
+- Check: pipx --version (if missing: pip install pipx && pipx ensurepath)
+- Check: jacked --version (to see if already installed)
+- Check ~/.claude/settings.json for existing hooks
+
+PHASE 2 - ASK USER PREFERENCES:
+Use AskUserQuestion with these options:
+
+Question: "Which jacked features do you want?"
+Options:
+- BASE (Recommended): Smart reviewers (/dc, /pr, /learn, /redo, /techdebt), 10 agents, behavioral rules. No external services needed.
+- SEARCH: Everything in BASE + search past Claude sessions across machines. Requires Qdrant Cloud (~$30/mo).
+- SECURITY: Everything in BASE + auto-approve safe bash commands. Fewer permission prompts, uses Anthropic API.
+- ALL: Everything. Requires Qdrant Cloud + Anthropic API key for fastest security evaluation.
+
+PHASE 3 - INSTALL:
+Based on user choice:
+- BASE: pipx install claude-jacked && jacked install
+- SEARCH: pipx install "claude-jacked[search]" && jacked install
+- SECURITY: pipx install "claude-jacked[security]" && jacked install --security
+- ALL: pipx install "claude-jacked[all]" && jacked install --security
+
+PHASE 4 - POST-INSTALL (if SEARCH or ALL):
+Help user set up Qdrant Cloud:
+1. Go to cloud.qdrant.io, create account
+2. Create cluster (paid tier required)
+3. Copy endpoint URL and API key
+4. Add to shell profile:
+   export QDRANT_CLAUDE_SESSIONS_ENDPOINT="https://..."
+   export QDRANT_CLAUDE_SESSIONS_API_KEY="..."
+5. Restart terminal
+6. Run: jacked backfill
+
+PHASE 5 - VERIFY:
+- jacked --help (should show all commands)
+- jacked configure --show (if SEARCH installed)
+
+WINDOWS NOTE: If env vars not visible in Git Bash, check Windows system env vars:
+powershell.exe -Command "[System.Environment]::GetEnvironmentVariable('QDRANT_CLAUDE_SESSIONS_ENDPOINT', 'User')"
 ```
 
 </details>

{claude_jacked-0.2.9.dist-info → claude_jacked-0.3.1.dist-info}/RECORD

@@ -1,5 +1,5 @@
-jacked/__init__.py,sha256=aVi7IpwXTJWSR8wBe4GHbAB4QlWyWvCobMQZ165Ytk8,609
-jacked/cli.py,sha256=1N-2jz6k8clXSR0Fpn-8sI-Cxd7JUQGdFp-GchcXq5s,48037
+jacked/__init__.py,sha256=-nf4gLXaGd9gIAXz2-AaiIdFt1gZbXGDalP0jHTTOFo,1276
+jacked/cli.py,sha256=Uw4Dk0GjMgVzA7vc6w6wBfNeCr3CjbcyeyR9PJvrGbg,51636
 jacked/client.py,sha256=7N4GdjcG8OXfmjUfprlUOJTkyrPyqF1OBstAsplNSa8,18151
 jacked/config.py,sha256=DeC1no5rFsvlb6JaU2PzLyyhI4DaJrxrsfqVugWuC4Q,8606
 jacked/index_write_tracker.py,sha256=E1zVqyZTQdHenp_vXL-gWPvLBo18Ar703_0MI9Cst8U,8679
@@ -23,11 +23,11 @@ jacked/data/commands/learn.md,sha256=FoD-qKsQSpEayFNP997dyUfV4UJgs8LiojYIWnzOSvA
 jacked/data/commands/pr.md,sha256=1orTbDnL4ky2bk5VXm5j66hGybTrNWVTyAPxx_uMggU,193
 jacked/data/commands/redo.md,sha256=4NnCKKi10ybEOHdFObN1aVNaFGOt63eoluwDJUzUFxg,4242
 jacked/data/commands/techdebt.md,sha256=jSdfMN1Kvz6vmsnWw9sCMFpKA8r87e9nDHrE-qsMwG8,3861
-jacked/data/prompts/security_gatekeeper.txt,sha256=4PN1wyWPVpo7hvfAYfRcoh2dJNSgkP7mdVlG3u0y56Y,4049
+jacked/data/hooks/security_gatekeeper.py,sha256=nhiT4X-8zBhjG-i1hKgQzoXNE3NOnekTYGDlns72iXk,14083
 jacked/data/rules/jacked_behaviors.md,sha256=x1qzdj3DLmkhv5TVAdNyIpAdjBGz7IUdXSrko94LOOw,1449
 jacked/data/skills/jacked/SKILL.md,sha256=IEMp-PfWlu5rmS1R5HHblUX1CGwzno2gtO4yQ2cMAg4,5488
-claude_jacked-0.2.9.dist-info/METADATA,sha256=no8uRxGSchoV3iGalGjj3YA4MczQB8Z0BvLyV_n4pFw,16597
-claude_jacked-0.2.9.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-claude_jacked-0.2.9.dist-info/entry_points.txt,sha256=52JDhetd7OsE9iJryGrQIL3PWhum_QCeLuTeQ9-CTqQ,43
-claude_jacked-0.2.9.dist-info/licenses/LICENSE,sha256=m8NmsH7P5G4VH3VyHWPQUTl2weuNTh1-eaH0RbUcn3k,1066
-claude_jacked-0.2.9.dist-info/RECORD,,
+claude_jacked-0.3.1.dist-info/METADATA,sha256=dCRRqhE9GYB3Z9wl8PdUYDYr2-o5jXCTQAt1Bnuew0Q,22091
+claude_jacked-0.3.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+claude_jacked-0.3.1.dist-info/entry_points.txt,sha256=52JDhetd7OsE9iJryGrQIL3PWhum_QCeLuTeQ9-CTqQ,43
+claude_jacked-0.3.1.dist-info/licenses/LICENSE,sha256=m8NmsH7P5G4VH3VyHWPQUTl2weuNTh1-eaH0RbUcn3k,1066
+claude_jacked-0.3.1.dist-info/RECORD,,

jacked/__init__.py

@@ -1,22 +1,42 @@
 """
-Claude Jacked - Cross-machine semantic search for Claude Code sessions.
+Claude Jacked - Smart reviewers, commands, and session search for Claude Code.
 
-This package provides tools to index, search, and retrieve context from past
-Claude Code sessions, enabling seamless context sharing across machines.
+Base install provides agents, commands, and behavioral rules.
+Install extras for additional features:
+  pip install "claude-jacked[search]"    — session search via Qdrant
+  pip install "claude-jacked[security]"  — security gatekeeper hook
+  pip install "claude-jacked[all]"       — everything
 """
 
-__version__ = "0.2.1"
+__version__ = "0.3.1"
+
+
+def _qdrant_available() -> bool:
+    """Check if qdrant-client is installed."""
+    try:
+        import qdrant_client  # noqa: F401
+        return True
+    except ImportError:
+        return False
+
+
+def __getattr__(name: str):
+    """Lazy imports for backwards compat — only works if [search] extra installed."""
+    _search_classes = {
+        "SmartForkConfig": "jacked.config",
+        "QdrantSessionClient": "jacked.client",
+        "SessionIndexer": "jacked.indexer",
+        "SessionSearcher": "jacked.searcher",
+        "SessionRetriever": "jacked.retriever",
+    }
+    if name in _search_classes:
+        import importlib
+        module = importlib.import_module(_search_classes[name])
+        return getattr(module, name)
+    raise AttributeError(f"module 'jacked' has no attribute {name!r}")
 
-from jacked.config import SmartForkConfig
-from jacked.client import QdrantSessionClient
-from jacked.indexer import SessionIndexer
-from jacked.searcher import SessionSearcher
-from jacked.retriever import SessionRetriever
 
 __all__ = [
-    "SmartForkConfig",
-    "QdrantSessionClient",
-    "SessionIndexer",
-    "SessionSearcher",
-    "SessionRetriever",
+    "__version__",
+    "_qdrant_available",
 ]