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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ghosttrap-cli
-Version: 0.3.9
+Version: 0.3.10
 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.10}/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.10}/ghosttrap_cli/cli.py

@@ -17,6 +17,7 @@ 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
 }
 
 __version__ = "0.3.0"
@@ -77,6 +78,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
@@ -367,6 +369,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 +423,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 +451,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.10}/ghosttrap_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ghosttrap-cli
-Version: 0.3.9
+Version: 0.3.10
 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.10}/pyproject.toml

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