ghosttrap-cli 0.3.6__tar.gz → 0.3.8__tar.gz

{ghosttrap_cli-0.3.6 → ghosttrap_cli-0.3.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ghosttrap-cli
-Version: 0.3.6
+Version: 0.3.8
 Summary: Watch for errors streaming from ghosttrap.io
 Project-URL: Homepage, https://github.com/alex-rowley/ghosttrap-cli
 Requires-Python: >=3.10
@@ -47,7 +47,9 @@ Your app needs [ghosttrap-sdk](https://github.com/alex-rowley/ghosttrap-sdk) to
 |---------|-------------|
 | `ghosttrap setup` | Claim a repo, install the Claude Code skill |
 | `ghosttrap peek` | Wait for the next error, print it, exit |
+| `ghosttrap peek --clear` | Skip outstanding errors, then wait for the next one |
 | `ghosttrap watch` | Stream all errors continuously |
+| `ghosttrap clear` | Skip all outstanding errors |
 
 ## How it works
 

{ghosttrap_cli-0.3.6 → ghosttrap_cli-0.3.8}/README.md

@@ -38,7 +38,9 @@ Your app needs [ghosttrap-sdk](https://github.com/alex-rowley/ghosttrap-sdk) to
 |---------|-------------|
 | `ghosttrap setup` | Claim a repo, install the Claude Code skill |
 | `ghosttrap peek` | Wait for the next error, print it, exit |
+| `ghosttrap peek --clear` | Skip outstanding errors, then wait for the next one |
 | `ghosttrap watch` | Stream all errors continuously |
+| `ghosttrap clear` | Skip all outstanding errors |
 
 ## How it works
 

{ghosttrap_cli-0.3.6 → ghosttrap_cli-0.3.8}/ghosttrap_cli/cli.py

@@ -59,14 +59,18 @@ Read `~/.ghosttrap/config.json` for state. It contains:
 1. Detect the current repo from `git config --get remote.origin.url`.
 2. Look it up in the config. If the repo isn't there, tell the user to run `ghosttrap setup`.
 3. If `sdk_installed` is false or missing: install the SDK (`pip install ghosttrap-sdk`), wire `ghosttrap.init("<token>")` into the app startup. For Django projects, also add `"ghosttrap.django.GhostTrapApp"` to INSTALLED_APPS (re-attaches logging handler after Django's dictConfig) and `"ghosttrap.django.GhostTrapMiddleware"` to MIDDLEWARE (catches unhandled view exceptions). The SDK auto-hooks into Celery task_failure if Celery is installed, and attaches a logging handler for logger.exception() calls. Use whatever pattern the project already uses for configuration (env vars, settings files, hardcoded — match the existing style). Then update the config: set `sdk_installed: true`, `sdk_version`, `init_file` to record what you did.
-4. Run `ghosttrap peek` with `run_in_background: true`.
+4. Run `ghosttrap peek --clear` with `run_in_background: true`. The `--clear` flag skips any stale backlog from prior sessions so you only get fresh errors.
 
 ## When peek returns
 
-1. **Immediately restart peek** in the background before doing anything else — this ensures you're listening for the next error while you work on the current one.
+1. **Immediately restart peek** in the background before doing anything else — this ensures you're listening for the next error while you work on the current one. Use plain `ghosttrap peek` here (no `--clear`) — you only want to skip backlog at session start.
 2. Read the JSON output: `error.repo`, `error.type`, `error.message`, `error.traceback` (list of strings), `error.frames` (list of `{file, line, function, code}`).
 3. Open the file from the last frame, diagnose, fix.
 
+## Other commands
+
+- `ghosttrap clear` — manually skip outstanding errors without waiting. Useful if the user explicitly wants to drop the queue.
+
 ## Rules
 
 - Always `run_in_background: true` for peek — it blocks.
@@ -251,6 +255,15 @@ def _write_skill():
         f.write(SKILL_CONTENT)
 
 
+def _refresh_skill_if_stale():
+    if not os.path.exists(SKILL_FILE):
+        return
+    with open(SKILL_FILE) as f:
+        if f.read() != SKILL_CONTENT:
+            _write_skill()
+            print("ghosttrap skill file updated", file=sys.stderr)
+
+
 async def setup(server_url, token):
     config = _load_config()
 
@@ -314,25 +327,30 @@ async def peek(server_url, token):
             await asyncio.sleep(60)
 
 
+def _advance_cursor(config, token):
+    since = config.get("cursor", 0)
+    server = GHOSTTRAP_SERVER.replace("wss://", "https://").replace("/stream/", "")
+    url = f"{server}/latest/{token}/?since={since}"
+    req = urllib.request.Request(url, headers={"User-Agent": "ghosttrap-cli"})
+    with urllib.request.urlopen(req, timeout=10) as resp:
+        data = json.loads(resp.read())
+        latest_id = data.get("latest_id", 0)
+        pending = data.get("pending", 0)
+        config["cursor"] = latest_id
+        _save_config(config)
+        return pending
+
+
 def clear():
     _require_setup()
     config = _load_config()
     token = _get_repo_token(config)
-    since = config.get("cursor", 0)
-    server = GHOSTTRAP_SERVER.replace("wss://", "https://").replace("/stream/", "")
-    url = f"{server}/latest/{token}/?since={since}"
     try:
-        req = urllib.request.Request(url, headers={"User-Agent": "ghosttrap-cli"})
-        with urllib.request.urlopen(req, timeout=10) as resp:
-            data = json.loads(resp.read())
-            latest_id = data.get("latest_id", 0)
-            pending = data.get("pending", 0)
-            config["cursor"] = latest_id
-            _save_config(config)
-            if pending:
-                print(f"cleared {pending} error(s)", file=sys.stderr)
-            else:
-                print(f"nothing to clear", file=sys.stderr)
+        pending = _advance_cursor(config, token)
+        if pending:
+            print(f"cleared {pending} error(s)", file=sys.stderr)
+        else:
+            print(f"nothing to clear", file=sys.stderr)
     except Exception as e:
         print(f"error: {e}", file=sys.stderr)
         sys.exit(1)
@@ -350,6 +368,7 @@ def main():
 
     peek_parser = sub.add_parser("peek", help="Wait for the next error then exit")
     peek_parser.add_argument("--server", default=GHOSTTRAP_SERVER, help="WebSocket server URL")
+    peek_parser.add_argument("--clear", action="store_true", help="Skip outstanding errors before waiting")
 
     args = parser.parse_args()
 
@@ -360,13 +379,21 @@ def main():
         clear()
     elif args.command == "watch":
         _require_setup()
+        _refresh_skill_if_stale()
         config = _load_config()
         token = _get_repo_token(config)
         asyncio.run(watch(args.server, token))
     elif args.command == "peek":
         _require_setup()
+        _refresh_skill_if_stale()
         config = _load_config()
         token = _get_repo_token(config)
+        if args.clear:
+            try:
+                _advance_cursor(config, token)
+            except Exception as e:
+                print(f"error: {e}", file=sys.stderr)
+                sys.exit(1)
         asyncio.run(peek(args.server, token))
     else:
         parser.print_help()

{ghosttrap_cli-0.3.6 → ghosttrap_cli-0.3.8}/ghosttrap_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ghosttrap-cli
-Version: 0.3.6
+Version: 0.3.8
 Summary: Watch for errors streaming from ghosttrap.io
 Project-URL: Homepage, https://github.com/alex-rowley/ghosttrap-cli
 Requires-Python: >=3.10
@@ -47,7 +47,9 @@ Your app needs [ghosttrap-sdk](https://github.com/alex-rowley/ghosttrap-sdk) to
 |---------|-------------|
 | `ghosttrap setup` | Claim a repo, install the Claude Code skill |
 | `ghosttrap peek` | Wait for the next error, print it, exit |
+| `ghosttrap peek --clear` | Skip outstanding errors, then wait for the next one |
 | `ghosttrap watch` | Stream all errors continuously |
+| `ghosttrap clear` | Skip all outstanding errors |
 
 ## How it works
 

{ghosttrap_cli-0.3.6 → ghosttrap_cli-0.3.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ghosttrap-cli"
-version = "0.3.6"
+version = "0.3.8"
 description = "Watch for errors streaming from ghosttrap.io"
 readme = "README.md"
 requires-python = ">=3.10"