ghosttrap-cli 0.3.9__tar.gz → 0.3.11__tar.gz

{ghosttrap_cli-0.3.9 → ghosttrap_cli-0.3.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ghosttrap-cli
-Version: 0.3.9
+Version: 0.3.11
 Summary: Watch for errors streaming from ghosttrap.io
 Project-URL: Homepage, https://github.com/alex-rowley/ghosttrap-cli
 Requires-Python: >=3.10
@@ -48,6 +48,8 @@ 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 last` | Fetch the most recent error and exit (no waiting) |
+| `ghosttrap last --clear` | Fetch the most recent error and skip everything older |
 | `ghosttrap watch` | Stream all errors continuously |
 | `ghosttrap clear` | Skip all outstanding errors |
 

{ghosttrap_cli-0.3.9 → ghosttrap_cli-0.3.11}/README.md

@@ -39,6 +39,8 @@ 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 last` | Fetch the most recent error and exit (no waiting) |
+| `ghosttrap last --clear` | Fetch the most recent error and skip everything older |
 | `ghosttrap watch` | Stream all errors continuously |
 | `ghosttrap clear` | Skip all outstanding errors |
 

{ghosttrap_cli-0.3.9 → ghosttrap_cli-0.3.11}/ghosttrap_cli/cli.py

@@ -17,9 +17,11 @@ KNOWN_SKILL_HASHES = {
     "0f2d2f4105e393fc69084d404d5a8154ba5d97fd23f92810c51345e3dc68e9a0",  # v0.3.0
     "8564b65b8ab5c63283cda1706e30ca62bc4e111d33ba8918220f4b556ad01da1",  # v0.3.1..v0.3.3
     "5759b2e0dc8ca47c3801915fd688cc8da878a7ab8d405f5183ffd7e8c8df4c55",  # v0.3.4..v0.3.7
+    "0651bb4247cf5c68960ff5b63d6a5d0c85ff1ce08e7966ab4823601ff02cf1f4",  # v0.3.9
+    "38810f43867a2a91420cc3dacbc71d2acabd7125596fd5b43f222b49725c9696",  # v0.3.10
 }
 
-__version__ = "0.3.0"
+__version__ = "0.3.11"
 
 GHOSTTRAP_SERVER = "wss://ghosttrap.io/stream/"
 CONFIG_DIR = os.path.expanduser("~/.ghosttrap")
@@ -59,13 +61,13 @@ description: Production error monitoring via ghosttrap.io. Trigger when starting
 # Ghosttrap
 
 Read `~/.ghosttrap/config.json` for state. It contains:
-- `repos`: map of `"owner/repo"` to `{"token": "t_xxx", "sdk_installed": bool, "sdk_version": str, "init_file": str}`
+- `repos`: map keyed by GitHub repo id (stringified int) to `{"github_id": int, "owner": str, "name": str, "token": "t_xxx", "sdk_installed": bool, "sdk_version": str, "init_file": str}`. Older configs may still be keyed by `"owner/name"` — same shape inside.
 - `cursor`: last seen error ID
 
 ## On session start
 
-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`.
+1. Detect the current repo from `git config --get remote.origin.url` (returns `owner/name`).
+2. Find a matching entry in config by looking for one whose `owner`/`name` equals the detected slug. If no match, tell the user to run `ghosttrap setup`. (The owner/name on a config entry auto-refreshes from the server when the repo is renamed or transferred, so always match against the entry's stored owner/name, not the config key.)
 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 --clear` with `run_in_background: true`. The `--clear` flag skips any stale backlog from prior sessions so you only get fresh errors.
 
@@ -77,6 +79,7 @@ Read `~/.ghosttrap/config.json` for state. It contains:
 
 ## Other commands
 
+- `ghosttrap last` — fetch the single most recent error and exit immediately, no waiting. Useful when the user wants to look at the latest error without starting a watch. Add `--clear` to also skip everything older in one shot.
 - `ghosttrap clear` — manually skip outstanding errors without waiting. Useful if the user explicitly wants to drop the queue.
 
 ## Rules
@@ -101,16 +104,35 @@ def _save_config(config):
         json.dump(config, f, indent=2)
 
 
-def _is_known_repo(config, owner, name):
-    return f"{owner}/{name}" in config.get("repos", {})
+def _repo_key(r):
+    gid = r.get("github_id")
+    if gid is not None:
+        return str(gid)
+    return f"{r.get('owner')}/{r.get('name')}"
+
+
+def _is_known_repo(config, repo_entry):
+    return _repo_key(repo_entry) in config.get("repos", {})
 
 
 def _save_repos(config, repos):
     if "repos" not in config:
         config["repos"] = {}
     for r in repos:
-        key = f"{r['owner']}/{r['name']}"
-        config["repos"][key] = {"token": r["token"]}
+        key = _repo_key(r)
+        existing = config["repos"].get(key, {})
+        # Drop any legacy slug-keyed entry now superseded by a github_id key.
+        if r.get("github_id") is not None:
+            legacy_key = f"{r.get('owner')}/{r.get('name')}"
+            if legacy_key in config["repos"] and legacy_key != key:
+                existing = {**config["repos"].pop(legacy_key), **existing}
+        existing.update({
+            "github_id": r.get("github_id"),
+            "owner": r["owner"],
+            "name": r["name"],
+            "token": r["token"],
+        })
+        config["repos"][key] = existing
     _save_config(config)
 
 
@@ -143,7 +165,7 @@ def _find_target_repo(repos):
     cwd_slug = _detect_repo_from_cwd()
     if cwd_slug:
         for r in repos:
-            if f"{r['owner']}/{r['name']}" == cwd_slug:
+            if f"{r.get('owner')}/{r.get('name')}" == cwd_slug:
                 return r
     return repos[0] if repos else None
 
@@ -182,11 +204,14 @@ def get_gh_token():
 
 def _get_repo_token(config):
     """Get the repo token for the current directory from config."""
-    cwd_repo = _detect_repo_from_cwd()
-    if cwd_repo and cwd_repo in config.get("repos", {}):
-        return config["repos"][cwd_repo]["token"]
-    # Fall back to first repo in config
     repos = config.get("repos", {})
+    cwd_repo = _detect_repo_from_cwd()
+    if cwd_repo:
+        for entry in repos.values():
+            if f"{entry.get('owner')}/{entry.get('name')}" == cwd_repo:
+                return entry["token"]
+        if cwd_repo in repos:
+            return repos[cwd_repo]["token"]
     if repos:
         return next(iter(repos.values()))["token"]
     print("error: no repos configured. run 'ghosttrap setup' first.", file=sys.stderr)
@@ -208,9 +233,10 @@ async def _connect_and_handle(server_url, token, config, once=False):
                 repos = event.get("repos", [])
                 print(f"watching {len(repos)} repo(s)", file=sys.stderr)
 
-                new_repos = [r for r in repos if not _is_known_repo(config, r["owner"], r["name"])]
+                new_repos = [r for r in repos if not _is_known_repo(config, r)]
+                # Always sync — picks up renamed/transferred repos by github_id.
+                _save_repos(config, repos)
                 if new_repos:
-                    _save_repos(config, repos)
                     target = _find_target_repo(new_repos)
                     if target:
                         _print_setup_snippet(target)
@@ -218,10 +244,13 @@ async def _connect_and_handle(server_url, token, config, once=False):
                 sdk_latest = event.get("sdk_latest")
                 if sdk_latest:
                     cwd_repo = _detect_repo_from_cwd()
-                    if cwd_repo and cwd_repo in config.get("repos", {}):
-                        installed = config["repos"][cwd_repo].get("sdk_version")
-                        if installed and installed != sdk_latest:
-                            print(f"ghosttrap-sdk {sdk_latest} available (you have {installed})", file=sys.stderr)
+                    if cwd_repo:
+                        for entry in config.get("repos", {}).values():
+                            if f"{entry.get('owner')}/{entry.get('name')}" == cwd_repo:
+                                installed = entry.get("sdk_version")
+                                if installed and installed != sdk_latest:
+                                    print(f"ghosttrap-sdk {sdk_latest} available (you have {installed})", file=sys.stderr)
+                                break
 
                 if not once:
                     print(f"waiting for errors...", file=sys.stderr)
@@ -367,6 +396,46 @@ def clear():
         sys.exit(1)
 
 
+def last(do_clear=False):
+    _require_setup()
+    config = _load_config()
+    _check_cli_version(config)
+    token = _get_repo_token(config)
+    server = GHOSTTRAP_SERVER.replace("wss://", "https://").replace("/stream/", "")
+    url = f"{server}/last/{token}/"
+    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())
+    except Exception as e:
+        print(f"error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+    error = data.get("error")
+    if not error:
+        print("no errors yet", file=sys.stderr)
+        return
+
+    print(json.dumps({"type": "error", "error": error}))
+    sys.stdout.flush()
+
+    print(f"\n{'='*60}", file=sys.stderr)
+    print(f"  {error.get('repo', '?')}", file=sys.stderr)
+    print(f"  {error.get('type', '?')}: {error.get('message', '')}", file=sys.stderr)
+    frames = error.get("frames", [])
+    if frames:
+        f = frames[-1]
+        print(f"  at {f.get('file', '?')}:{f.get('line', '?')} in {f.get('function', '?')}", file=sys.stderr)
+    print(f"{'='*60}", file=sys.stderr)
+
+    if do_clear:
+        try:
+            _advance_cursor(config, token)
+        except Exception as e:
+            print(f"error: {e}", file=sys.stderr)
+            sys.exit(1)
+
+
 def main():
     parser = argparse.ArgumentParser(prog="ghosttrap", description="Watch for errors from ghosttrap.io")
     sub = parser.add_subparsers(dest="command")
@@ -381,6 +450,9 @@ def main():
     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")
 
+    last_parser = sub.add_parser("last", help="Fetch the most recent error then exit")
+    last_parser.add_argument("--clear", action="store_true", help="Also skip remaining outstanding errors")
+
     args = parser.parse_args()
 
     if args.command == "setup":
@@ -406,6 +478,9 @@ def main():
                 print(f"error: {e}", file=sys.stderr)
                 sys.exit(1)
         asyncio.run(peek(args.server, token))
+    elif args.command == "last":
+        _refresh_skill_if_stale()
+        last(do_clear=args.clear)
     else:
         parser.print_help()
         sys.exit(1)

{ghosttrap_cli-0.3.9 → ghosttrap_cli-0.3.11}/ghosttrap_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ghosttrap-cli
-Version: 0.3.9
+Version: 0.3.11
 Summary: Watch for errors streaming from ghosttrap.io
 Project-URL: Homepage, https://github.com/alex-rowley/ghosttrap-cli
 Requires-Python: >=3.10
@@ -48,6 +48,8 @@ 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 last` | Fetch the most recent error and exit (no waiting) |
+| `ghosttrap last --clear` | Fetch the most recent error and skip everything older |
 | `ghosttrap watch` | Stream all errors continuously |
 | `ghosttrap clear` | Skip all outstanding errors |
 

{ghosttrap_cli-0.3.9 → ghosttrap_cli-0.3.11}/pyproject.toml

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