trajrl 0.1.0__tar.gz

trajrl-0.1.0/PKG-INFO

@@ -0,0 +1,134 @@
+Metadata-Version: 2.4
+Name: trajrl
+Version: 0.1.0
+Summary: CLI for TrajectoryRL, Bittensor subnet 11 — agent-friendly access to live validator, miner, and evaluation data.
+License-Expression: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: typer>=0.9
+Requires-Dist: httpx>=0.25
+Requires-Dist: rich>=13.0
+
+# trajrl
+
+CLI for the [TrajectoryRL subnet](https://trajrl.com) (Bittensor SN11). Query live validator, miner, and evaluation data from the terminal.
+
+Designed for AI agents (Claude Code, Cursor) and humans alike — outputs JSON when piped, Rich tables when interactive.
+
+## Install
+
+```bash
+pip install trajrl
+```
+
+## Commands
+
+```
+trajrl status                       # Network health overview
+trajrl validators                   # List all validators
+trajrl scores <validator_hotkey>    # Per-miner scores from a validator
+trajrl miner <hotkey>               # Miner detail + diagnostics
+trajrl pack <hotkey> <pack_hash>    # Pack evaluation detail
+trajrl submissions [--failed]       # Recent pack submissions
+trajrl logs [--type cycle|miner]    # Eval log archives
+```
+
+### Global Options
+
+Every command accepts:
+
+| Option | Description |
+|--------|-------------|
+| `--json` / `-j` | Force JSON output (auto-enabled when stdout is piped) |
+| `--base-url URL` | Override API base (default: `https://trajrl.com`, env: `TRAJRL_BASE_URL`) |
+
+## Usage Examples
+
+### Quick network check
+
+```bash
+trajrl status
+```
+```
+╭──────────────────── Network Status ────────────────────╮
+│   Validators: 7 total, 7 active (seen <1h)             │
+│   LLM Models: zhipu/glm-5 (3), chutes/GLM-5-TEE (3)    │
+│   Latest Eval: 7h ago                                  │
+│   Submissions: 65 passed, 35 failed (last batch)       │
+╰────────────────────────────────────────────────────────╯
+```
+
+### List validators
+
+```bash
+trajrl validators
+```
+```
+ Hotkey         UID  Version  LLM Model              Last Eval   Last Seen
+ 5Cd6h…sn11     29  0.2.7    chutes/zai-org/GLM-5…   7h ago      2m ago
+ 5EcgNd…797f   221  0.2.7    zhipu/glm-5             10h ago     6m ago
+ ...
+```
+
+### Inspect a miner
+
+```bash
+trajrl miner 5HMgR6LnNqUAtaKRwa6bLF4Vy4KBf7TaxCLehyff9mWPhSHt
+```
+
+Shows rank, qualification status, cost, scenario breakdown, per-validator reports, recent submissions, and ban records.
+
+### View failed submissions
+
+```bash
+trajrl submissions --failed
+```
+
+### Filter eval logs
+
+```bash
+trajrl logs --type cycle --limit 5
+trajrl logs --validator 5Cd6h... --type miner
+trajrl logs --eval-id 20260324_000340
+```
+
+### JSON output for agents
+
+Pipe to any tool — JSON is automatic:
+
+```bash
+trajrl validators | jq '.validators[].hotkey'
+trajrl scores 5Cd6h... --json | python3 -c "
+  import sys, json
+  d = json.load(sys.stdin)
+  for e in d['entries'][:5]:
+      print(f\"{e['minerHotkey'][:12]}  qual={e['qualified']}  cost={e['costUsd']}\")
+"
+```
+
+Force JSON in an interactive terminal:
+
+```bash
+trajrl miner 5HMgR6... --json
+```
+
+## API Reference
+
+All data comes from the [TrajectoryRL Public API](https://trajrl.com) — read-only, no authentication required.
+
+| Endpoint | CLI Command |
+|----------|-------------|
+| `GET /api/validators` | `trajrl validators` |
+| `GET /api/scores/by-validator?validator=` | `trajrl scores <hotkey>` |
+| `GET /api/miners/:hotkey` | `trajrl miner <hotkey>` |
+| `GET /api/miners/:hotkey/packs/:hash` | `trajrl pack <hotkey> <hash>` |
+| `GET /api/submissions` | `trajrl submissions` |
+| `GET /api/eval-logs` | `trajrl logs` |
+
+## Development
+
+```bash
+git clone <repo> && cd trajrl
+pip install -e .
+trajrl --help
+```

trajrl-0.1.0/README.md

@@ -0,0 +1,123 @@
+# trajrl
+
+CLI for the [TrajectoryRL subnet](https://trajrl.com) (Bittensor SN11). Query live validator, miner, and evaluation data from the terminal.
+
+Designed for AI agents (Claude Code, Cursor) and humans alike — outputs JSON when piped, Rich tables when interactive.
+
+## Install
+
+```bash
+pip install trajrl
+```
+
+## Commands
+
+```
+trajrl status                       # Network health overview
+trajrl validators                   # List all validators
+trajrl scores <validator_hotkey>    # Per-miner scores from a validator
+trajrl miner <hotkey>               # Miner detail + diagnostics
+trajrl pack <hotkey> <pack_hash>    # Pack evaluation detail
+trajrl submissions [--failed]       # Recent pack submissions
+trajrl logs [--type cycle|miner]    # Eval log archives
+```
+
+### Global Options
+
+Every command accepts:
+
+| Option | Description |
+|--------|-------------|
+| `--json` / `-j` | Force JSON output (auto-enabled when stdout is piped) |
+| `--base-url URL` | Override API base (default: `https://trajrl.com`, env: `TRAJRL_BASE_URL`) |
+
+## Usage Examples
+
+### Quick network check
+
+```bash
+trajrl status
+```
+```
+╭──────────────────── Network Status ────────────────────╮
+│   Validators: 7 total, 7 active (seen <1h)             │
+│   LLM Models: zhipu/glm-5 (3), chutes/GLM-5-TEE (3)    │
+│   Latest Eval: 7h ago                                  │
+│   Submissions: 65 passed, 35 failed (last batch)       │
+╰────────────────────────────────────────────────────────╯
+```
+
+### List validators
+
+```bash
+trajrl validators
+```
+```
+ Hotkey         UID  Version  LLM Model              Last Eval   Last Seen
+ 5Cd6h…sn11     29  0.2.7    chutes/zai-org/GLM-5…   7h ago      2m ago
+ 5EcgNd…797f   221  0.2.7    zhipu/glm-5             10h ago     6m ago
+ ...
+```
+
+### Inspect a miner
+
+```bash
+trajrl miner 5HMgR6LnNqUAtaKRwa6bLF4Vy4KBf7TaxCLehyff9mWPhSHt
+```
+
+Shows rank, qualification status, cost, scenario breakdown, per-validator reports, recent submissions, and ban records.
+
+### View failed submissions
+
+```bash
+trajrl submissions --failed
+```
+
+### Filter eval logs
+
+```bash
+trajrl logs --type cycle --limit 5
+trajrl logs --validator 5Cd6h... --type miner
+trajrl logs --eval-id 20260324_000340
+```
+
+### JSON output for agents
+
+Pipe to any tool — JSON is automatic:
+
+```bash
+trajrl validators | jq '.validators[].hotkey'
+trajrl scores 5Cd6h... --json | python3 -c "
+  import sys, json
+  d = json.load(sys.stdin)
+  for e in d['entries'][:5]:
+      print(f\"{e['minerHotkey'][:12]}  qual={e['qualified']}  cost={e['costUsd']}\")
+"
+```
+
+Force JSON in an interactive terminal:
+
+```bash
+trajrl miner 5HMgR6... --json
+```
+
+## API Reference
+
+All data comes from the [TrajectoryRL Public API](https://trajrl.com) — read-only, no authentication required.
+
+| Endpoint | CLI Command |
+|----------|-------------|
+| `GET /api/validators` | `trajrl validators` |
+| `GET /api/scores/by-validator?validator=` | `trajrl scores <hotkey>` |
+| `GET /api/miners/:hotkey` | `trajrl miner <hotkey>` |
+| `GET /api/miners/:hotkey/packs/:hash` | `trajrl pack <hotkey> <hash>` |
+| `GET /api/submissions` | `trajrl submissions` |
+| `GET /api/eval-logs` | `trajrl logs` |
+
+## Development
+
+```bash
+git clone <repo> && cd trajrl
+pip install -e .
+trajrl --help
+```

trajrl-0.1.0/pyproject.toml

@@ -0,0 +1,19 @@
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "trajrl"
+version = "0.1.0"
+description = "CLI for TrajectoryRL, Bittensor subnet 11 — agent-friendly access to live validator, miner, and evaluation data."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+dependencies = [
+    "typer>=0.9",
+    "httpx>=0.25",
+    "rich>=13.0",
+]
+
+[project.scripts]
+trajrl = "trajrl.cli:app"

trajrl-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

trajrl-0.1.0/trajrl/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

trajrl-0.1.0/trajrl/api.py

@@ -0,0 +1,85 @@
+"""Typed HTTP client for the TrajectoryRL public API."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from typing import Any
+
+import httpx
+
+DEFAULT_BASE_URL = "https://trajrl.com"
+_TIMEOUT = 30.0
+
+
+@dataclass
+class TrajRLClient:
+    base_url: str = DEFAULT_BASE_URL
+    _client: httpx.Client = field(init=False, repr=False)
+
+    def __post_init__(self) -> None:
+        self._client = httpx.Client(
+            base_url=self.base_url.rstrip("/"),
+            timeout=_TIMEOUT,
+            headers={"Accept": "application/json"},
+        )
+
+    # -- endpoints ---------------------------------------------------------
+
+    def validators(self) -> dict[str, Any]:
+        """GET /api/validators"""
+        return self._get("/api/validators")
+
+    def scores_by_validator(self, validator: str) -> dict[str, Any]:
+        """GET /api/scores/by-validator?validator=<hotkey>"""
+        return self._get("/api/scores/by-validator", params={"validator": validator})
+
+    def miner(self, hotkey: str) -> dict[str, Any]:
+        """GET /api/miners/:hotkey"""
+        return self._get(f"/api/miners/{hotkey}")
+
+    def pack(self, hotkey: str, pack_hash: str) -> dict[str, Any]:
+        """GET /api/miners/:hotkey/packs/:packHash"""
+        return self._get(f"/api/miners/{hotkey}/packs/{pack_hash}")
+
+    def submissions(self, limit: int | None = None) -> dict[str, Any]:
+        """GET /api/submissions"""
+        return self._get("/api/submissions", params=_compact({"limit": limit}))
+
+    def eval_logs(
+        self,
+        *,
+        validator: str | None = None,
+        miner: str | None = None,
+        log_type: str | None = None,
+        eval_id: str | None = None,
+        pack_hash: str | None = None,
+        from_date: str | None = None,
+        to_date: str | None = None,
+        limit: int | None = None,
+        offset: int | None = None,
+    ) -> dict[str, Any]:
+        """GET /api/eval-logs"""
+        params = _compact({
+            "validator": validator,
+            "miner": miner,
+            "type": log_type,
+            "eval_id": eval_id,
+            "pack_hash": pack_hash,
+            "from": from_date,
+            "to": to_date,
+            "limit": limit,
+            "offset": offset,
+        })
+        return self._get("/api/eval-logs", params=params)
+
+    # -- internal ----------------------------------------------------------
+
+    def _get(self, path: str, params: dict | None = None) -> dict[str, Any]:
+        resp = self._client.get(path, params=params)
+        resp.raise_for_status()
+        return resp.json()
+
+
+def _compact(d: dict) -> dict:
+    """Remove None values from a dict."""
+    return {k: v for k, v in d.items() if v is not None}

trajrl-0.1.0/trajrl/cli.py

@@ -0,0 +1,151 @@
+"""trajrl — CLI for the TrajectoryRL subnet."""
+
+from __future__ import annotations
+
+import json
+import sys
+from typing import Annotated, Optional
+
+import typer
+
+from trajrl.api import TrajRLClient
+from trajrl import display as fmt
+
+app = typer.Typer(
+    name="trajrl",
+    help="CLI for the TrajectoryRL subnet — query live validator, miner, and evaluation data.",
+    no_args_is_help=True,
+    pretty_exceptions_enable=False,
+)
+
+# -- shared option defaults ------------------------------------------------
+
+_json_opt = typer.Option("--json", "-j", help="Force JSON output (auto when piped).")
+_base_url_opt = typer.Option("--base-url", help="API base URL.", envvar="TRAJRL_BASE_URL")
+
+
+def _client(base_url: str) -> TrajRLClient:
+    return TrajRLClient(base_url=base_url)
+
+
+def _want_json(flag: bool) -> bool:
+    return flag or not sys.stdout.isatty()
+
+
+def _print_json(data: dict) -> None:
+    print(json.dumps(data, indent=2, ensure_ascii=False))
+
+
+# -- commands --------------------------------------------------------------
+
+@app.command()
+def status(
+    json_output: Annotated[bool, _json_opt] = False,
+    base_url: Annotated[str, _base_url_opt] = "https://trajrl.com",
+) -> None:
+    """Network health overview — validators, submissions, models."""
+    client = _client(base_url)
+    vali_data = client.validators()
+    subs_data = client.submissions()
+    if _want_json(json_output):
+        _print_json({"validators": vali_data, "submissions": subs_data})
+    else:
+        fmt.display_status(vali_data, subs_data)
+
+
+@app.command()
+def validators(
+    json_output: Annotated[bool, _json_opt] = False,
+    base_url: Annotated[str, _base_url_opt] = "https://trajrl.com",
+) -> None:
+    """List all validators with heartbeat status and LLM model."""
+    data = _client(base_url).validators()
+    if _want_json(json_output):
+        _print_json(data)
+    else:
+        fmt.display_validators(data)
+
+
+@app.command()
+def scores(
+    validator: Annotated[str, typer.Argument(help="Validator SS58 hotkey.")],
+    json_output: Annotated[bool, _json_opt] = False,
+    base_url: Annotated[str, _base_url_opt] = "https://trajrl.com",
+) -> None:
+    """Per-miner evaluation scores from a specific validator."""
+    data = _client(base_url).scores_by_validator(validator)
+    if _want_json(json_output):
+        _print_json(data)
+    else:
+        fmt.display_scores(data)
+
+
+@app.command()
+def miner(
+    hotkey: Annotated[str, typer.Argument(help="Miner SS58 hotkey.")],
+    json_output: Annotated[bool, _json_opt] = False,
+    base_url: Annotated[str, _base_url_opt] = "https://trajrl.com",
+) -> None:
+    """Detailed evaluation data for a specific miner."""
+    data = _client(base_url).miner(hotkey)
+    if _want_json(json_output):
+        _print_json(data)
+    else:
+        fmt.display_miner(data)
+
+
+@app.command()
+def pack(
+    hotkey: Annotated[str, typer.Argument(help="Miner SS58 hotkey.")],
+    pack_hash: Annotated[str, typer.Argument(help="Pack SHA-256 hash.")],
+    json_output: Annotated[bool, _json_opt] = False,
+    base_url: Annotated[str, _base_url_opt] = "https://trajrl.com",
+) -> None:
+    """Evaluation data for a specific miner's pack."""
+    data = _client(base_url).pack(hotkey, pack_hash)
+    if _want_json(json_output):
+        _print_json(data)
+    else:
+        fmt.display_pack(data)
+
+
+@app.command()
+def submissions(
+    failed: Annotated[bool, typer.Option("--failed", help="Show only failed submissions.")] = False,
+    json_output: Annotated[bool, _json_opt] = False,
+    base_url: Annotated[str, _base_url_opt] = "https://trajrl.com",
+) -> None:
+    """Recent pack submissions (passed and failed)."""
+    data = _client(base_url).submissions()
+    if failed:
+        data["submissions"] = [s for s in data.get("submissions", []) if s.get("evalStatus") == "failed"]
+    if _want_json(json_output):
+        _print_json(data)
+    else:
+        fmt.display_submissions(data, failed_only=failed)
+
+
+@app.command()
+def logs(
+    validator: Annotated[Optional[str], typer.Option("--validator", "-v", help="Filter by validator hotkey.")] = None,
+    miner_key: Annotated[Optional[str], typer.Option("--miner", "-m", help="Filter by miner hotkey.")] = None,
+    log_type: Annotated[Optional[str], typer.Option("--type", "-t", help="Log type: 'miner' or 'cycle'.")] = None,
+    eval_id: Annotated[Optional[str], typer.Option("--eval-id", help="Filter by eval cycle ID.")] = None,
+    pack_hash: Annotated[Optional[str], typer.Option("--pack-hash", help="Filter by pack hash.")] = None,
+    limit: Annotated[int, typer.Option("--limit", "-l", help="Max results to return.")] = 50,
+    json_output: Annotated[bool, _json_opt] = False,
+    base_url: Annotated[str, _base_url_opt] = "https://trajrl.com",
+) -> None:
+    """Evaluation log archives uploaded by validators."""
+    data = _client(base_url).eval_logs(
+        validator=validator,
+        miner=miner_key,
+        log_type=log_type,
+        eval_id=eval_id,
+        pack_hash=pack_hash,
+        limit=limit,
+    )
+    if _want_json(json_output):
+        _print_json(data)
+    else:
+        fmt.display_logs(data)

trajrl-0.1.0/trajrl/display.py

@@ -0,0 +1,370 @@
+"""Rich formatters for TTY output."""
+
+from __future__ import annotations
+
+from datetime import datetime, timezone
+from typing import Any
+
+from rich.console import Console
+from rich.panel import Panel
+from rich.table import Table
+
+console = Console()
+
+
+# -- helpers ---------------------------------------------------------------
+
+def trunc(hotkey: str | None, n: int = 6) -> str:
+    """Truncate a hotkey: 5Cd6ht…sn11"""
+    if not hotkey:
+        return "—"
+    if len(hotkey) <= n + 4:
+        return hotkey
+    return f"{hotkey[:n]}…{hotkey[-4:]}"
+
+
+def relative_time(ts: str | None) -> str:
+    """ISO/Postgres timestamp → '2h ago'."""
+    if not ts:
+        return "—"
+    try:
+        # handle both ISO 8601 and postgres timestamp formats
+        clean = ts.replace("+00", "+00:00").replace(" ", "T")
+        if not clean.endswith("Z") and "+" not in clean[10:]:
+            clean += "+00:00"
+        dt = datetime.fromisoformat(clean.replace("Z", "+00:00"))
+        delta = datetime.now(timezone.utc) - dt
+        secs = int(delta.total_seconds())
+        if secs < 0:
+            return "just now"
+        if secs < 60:
+            return f"{secs}s ago"
+        if secs < 3600:
+            return f"{secs // 60}m ago"
+        if secs < 86400:
+            return f"{secs // 3600}h ago"
+        return f"{secs // 86400}d ago"
+    except (ValueError, TypeError):
+        return str(ts)
+
+
+def qual(v: bool | None) -> str:
+    if v is None:
+        return "—"
+    return "[green]\\u2713[/]" if v else "[red]\\u2717[/]"
+
+
+def cost(v: float | None) -> str:
+    if v is None:
+        return "—"
+    return f"${v:.4f}"
+
+
+def score_fmt(v: float | None) -> str:
+    if v is None:
+        return "—"
+    return f"{v:.2f}"
+
+
+def size_fmt(b: int | None) -> str:
+    if not b:
+        return "—"
+    if b < 1024:
+        return f"{b}B"
+    if b < 1024 * 1024:
+        return f"{b // 1024}KB"
+    return f"{b / (1024 * 1024):.1f}MB"
+
+
+# -- command displays ------------------------------------------------------
+
+def display_status(validators_data: dict, submissions_data: dict) -> None:
+    valis = validators_data.get("validators", [])
+    subs = submissions_data.get("submissions", [])
+
+    now = datetime.now(timezone.utc)
+    active = 0
+    latest_eval: str | None = None
+    models: dict[str, int] = {}
+    for v in valis:
+        # count active (seen < 1h)
+        if v.get("lastSeen"):
+            try:
+                clean = v["lastSeen"].replace("+00", "+00:00").replace(" ", "T")
+                if not clean.endswith("Z") and "+" not in clean[10:]:
+                    clean += "+00:00"
+                dt = datetime.fromisoformat(clean.replace("Z", "+00:00"))
+                if (now - dt).total_seconds() < 3600:
+                    active += 1
+            except (ValueError, TypeError):
+                pass
+        # latest eval
+        le = v.get("lastEvalAt")
+        if le and (latest_eval is None or le > latest_eval):
+            latest_eval = le
+        # models
+        m = v.get("llmModel")
+        if m:
+            models[m] = models.get(m, 0) + 1
+
+    passed = sum(1 for s in subs if s.get("evalStatus") == "passed")
+    failed = sum(1 for s in subs if s.get("evalStatus") == "failed")
+
+    model_str = ", ".join(f"{m} ({c})" for m, c in sorted(models.items(), key=lambda x: -x[1]))
+
+    lines = [
+        f"  Validators: {len(valis)} total, {active} active (seen <1h)",
+        f"  LLM Models: {model_str or '—'}",
+        f"  Latest Eval: {relative_time(latest_eval)}",
+        f"  Submissions: {passed} passed, {failed} failed (last batch)",
+    ]
+    console.print(Panel("\n".join(lines), title="Network Status", border_style="cyan"))
+
+
+def display_validators(data: dict) -> None:
+    valis = data.get("validators", [])
+    table = Table(title=f"Validators ({len(valis)})")
+    table.add_column("Hotkey", style="cyan")
+    table.add_column("UID", justify="right")
+    table.add_column("Version")
+    table.add_column("LLM Model")
+    table.add_column("Last Eval")
+    table.add_column("Last Seen")
+    for v in valis:
+        table.add_row(
+            trunc(v.get("hotkey")),
+            str(v.get("uid", "—")),
+            v.get("version") or "—",
+            v.get("llmModel") or "—",
+            relative_time(v.get("lastEvalAt")),
+            relative_time(v.get("lastSeen")),
+        )
+    console.print(table)
+
+
+def display_scores(data: dict) -> None:
+    entries = data.get("entries", [])
+    vali = data.get("validator", "")
+    table = Table(title=f"Scores from {trunc(vali)} ({len(entries)} miners)")
+    table.add_column("Miner", style="cyan")
+    table.add_column("UID", justify="right")
+    table.add_column("Qual", justify="center")
+    table.add_column("Cost", justify="right")
+    table.add_column("Score", justify="right")
+    table.add_column("Weight", justify="right")
+    table.add_column("Scenarios")
+    table.add_column("Rejected")
+    for e in entries:
+        sc = e.get("scenarioScores") or {}
+        passed = sum(1 for s in sc.values() if isinstance(s, dict) and s.get("qualified"))
+        total = len(sc)
+        sc_str = f"{passed}/{total}" if total else "—"
+
+        rej = ""
+        if e.get("rejected"):
+            stage = e.get("rejectionStage") or ""
+            rej = f"[red]{stage}[/]"
+
+        table.add_row(
+            trunc(e.get("minerHotkey")),
+            str(e.get("uid") if e.get("uid") is not None else "—"),
+            qual(e.get("qualified")),
+            cost(e.get("costUsd")),
+            score_fmt(e.get("score")),
+            score_fmt(e.get("weight")),
+            sc_str,
+            rej or "—",
+        )
+    console.print(table)
+
+
+def display_miner(data: dict) -> None:
+    hk = data.get("hotkey", "")
+    uid = data.get("uid")
+    rank = data.get("rank")
+
+    header_parts = [
+        f"Rank: {rank or '—'}",
+        f"Qualified: {'yes' if data.get('qualified') else 'no'}",
+        f"Cost: {cost(data.get('totalCostUsd'))}",
+        f"Score: {score_fmt(data.get('score'))}",
+    ]
+    detail_parts = [
+        f"Confidence: {data.get('confidence', '—')}",
+        f"Coverage: {data.get('coverage', '—')}",
+        f"Active: {'yes' if data.get('isActive') else 'no'}",
+        f"Banned: {'yes' if data.get('isBanned') else 'no'}",
+    ]
+    pack_parts = [
+        f"Pack: {trunc(data.get('packHash'), 10)}",
+        f"Winner: {'yes' if data.get('isWinner') else 'no'}",
+        f"Bootstrap: {'yes' if data.get('isBootstrap') else 'no'}",
+    ]
+
+    lines = [
+        "  " + " | ".join(header_parts),
+        "  " + " | ".join(detail_parts),
+        "  " + " | ".join(pack_parts),
+    ]
+
+    # ban info
+    ban = data.get("banRecord")
+    if ban and ban.get("failedPackCount", 0) > 0:
+        lines.append(f"  [red]Ban Record: {ban['failedPackCount']} failed packs[/]")
+        for fp in ban.get("failedPacks", [])[:3]:
+            reason = (fp.get("reason") or "")[:80]
+            lines.append(f"    - {trunc(fp.get('pack_hash'), 10)}: {reason}…")
+
+    console.print(Panel(
+        "\n".join(lines),
+        title=f"Miner {trunc(hk)} (UID {uid or '—'})",
+        border_style="cyan",
+    ))
+
+    # scenario summary
+    scenarios = data.get("scenarioSummary", [])
+    if scenarios:
+        st = Table(title="Scenario Summary")
+        st.add_column("Name")
+        st.add_column("Avg Cost", justify="right")
+        st.add_column("Avg Score", justify="right")
+        st.add_column("Qualified")
+        st.add_column("Validators", justify="right")
+        for s in scenarios:
+            st.add_row(
+                s.get("name", "—"),
+                cost(s.get("avgCost")),
+                score_fmt(s.get("avgScore")),
+                f"{s.get('qualCount', 0)}/{s.get('validatorCount', 0)}",
+                str(s.get("validatorCount", "—")),
+            )
+        console.print(st)
+
+    # per-validator
+    validators = data.get("validators", [])
+    if validators:
+        vt = Table(title="Validator Reports")
+        vt.add_column("Validator", style="cyan")
+        vt.add_column("Qual", justify="center")
+        vt.add_column("Cost", justify="right")
+        vt.add_column("Score", justify="right")
+        vt.add_column("Block", justify="right")
+        vt.add_column("Reported")
+        vt.add_column("Rejected")
+        for v in validators:
+            rej = ""
+            if v.get("rejected"):
+                rej = f"[red]{v.get('rejectionStage', '')}[/]"
+            vt.add_row(
+                trunc(v.get("hotkey")),
+                qual(v.get("qualified")),
+                cost(v.get("costUsd")),
+                score_fmt(v.get("score")),
+                str(v.get("blockHeight") or "—"),
+                relative_time(v.get("createdAt")),
+                rej or "—",
+            )
+        console.print(vt)
+
+    # recent submissions
+    subs = data.get("recentSubmissions", [])
+    if subs:
+        st2 = Table(title="Recent Submissions")
+        st2.add_column("Pack Hash", style="cyan")
+        st2.add_column("Status")
+        st2.add_column("Reason")
+        st2.add_column("Submitted")
+        for s in subs:
+            status = s.get("evalStatus", "—")
+            style = "green" if status == "passed" else "red"
+            reason = (s.get("evalReason") or "—")[:60]
+            st2.add_row(
+                trunc(s.get("packHash"), 10),
+                f"[{style}]{status}[/]",
+                reason,
+                relative_time(s.get("submittedAt")),
+            )
+        console.print(st2)
+
+
+def display_pack(data: dict) -> None:
+    ph = data.get("packHash", "")
+    summary = data.get("summary", {})
+
+    lines = [
+        f"  Status: {data.get('evalStatus', '—')}",
+        f"  Miner: {trunc(data.get('minerHotkey'))} (UID {data.get('minerUid', '—')})",
+        f"  Qualified: {qual(summary.get('qualified'))}  ({summary.get('qualifiedCount', 0)}/{summary.get('validatorCount', 0)} validators)",
+        f"  Best Cost: {cost(summary.get('bestCost'))}  |  Avg Cost: {cost(summary.get('avgCost'))}",
+    ]
+    if data.get("evalReason"):
+        lines.append(f"  [red]Reason: {data['evalReason']}[/]")
+
+    console.print(Panel("\n".join(lines), title=f"Pack {trunc(ph, 10)}", border_style="cyan"))
+
+    validators = data.get("validators", [])
+    if validators:
+        for v in validators:
+            vt = Table(title=f"Validator {trunc(v.get('hotkey'))}")
+            vt.add_column("Scenario")
+            vt.add_column("Cost", justify="right")
+            vt.add_column("Score", justify="right")
+            vt.add_column("Qualified", justify="center")
+            for sc in v.get("scenarios", []):
+                vt.add_row(
+                    sc.get("name", "—"),
+                    cost(sc.get("cost")),
+                    score_fmt(sc.get("score")),
+                    qual(sc.get("qualified")),
+                )
+            console.print(vt)
+
+
+def display_submissions(data: dict, failed_only: bool = False) -> None:
+    subs = data.get("submissions", [])
+    if failed_only:
+        subs = [s for s in subs if s.get("evalStatus") == "failed"]
+
+    label = "Failed Submissions" if failed_only else f"Submissions ({len(subs)})"
+    table = Table(title=label)
+    table.add_column("Miner", style="cyan")
+    table.add_column("Pack Hash", style="cyan")
+    table.add_column("Status")
+    table.add_column("Reason", max_width=50)
+    table.add_column("Submitted")
+    for s in subs:
+        status = s.get("evalStatus", "—")
+        style = "green" if status == "passed" else "red"
+        table.add_row(
+            trunc(s.get("minerHotkey")),
+            trunc(s.get("packHash"), 10),
+            f"[{style}]{status}[/]",
+            (s.get("evalReason") or "—")[:50],
+            relative_time(s.get("submittedAt")),
+        )
+    console.print(table)
+
+
+def display_logs(data: dict) -> None:
+    logs = data.get("logs", [])
+    table = Table(title=f"Eval Logs ({len(logs)})")
+    table.add_column("Eval ID")
+    table.add_column("Type")
+    table.add_column("Validator", style="cyan")
+    table.add_column("Miner", style="cyan")
+    table.add_column("Pack Hash")
+    table.add_column("Size", justify="right")
+    table.add_column("GCS URL", max_width=50)
+    table.add_column("Created")
+    for log in logs:
+        table.add_row(
+            log.get("evalId", "—"),
+            log.get("logType", "—"),
+            trunc(log.get("validatorHotkey")),
+            trunc(log.get("minerHotkey")),
+            trunc(log.get("packHash"), 10),
+            size_fmt(log.get("sizeBytes")),
+            (log.get("gcsUrl") or "—")[-50:],
+            relative_time(log.get("createdAt")),
+        )
+    console.print(table)

trajrl-0.1.0/trajrl.egg-info/PKG-INFO

@@ -0,0 +1,134 @@
+Metadata-Version: 2.4
+Name: trajrl
+Version: 0.1.0
+Summary: CLI for TrajectoryRL, Bittensor subnet 11 — agent-friendly access to live validator, miner, and evaluation data.
+License-Expression: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: typer>=0.9
+Requires-Dist: httpx>=0.25
+Requires-Dist: rich>=13.0
+
+# trajrl
+
+CLI for the [TrajectoryRL subnet](https://trajrl.com) (Bittensor SN11). Query live validator, miner, and evaluation data from the terminal.
+
+Designed for AI agents (Claude Code, Cursor) and humans alike — outputs JSON when piped, Rich tables when interactive.
+
+## Install
+
+```bash
+pip install trajrl
+```
+
+## Commands
+
+```
+trajrl status                       # Network health overview
+trajrl validators                   # List all validators
+trajrl scores <validator_hotkey>    # Per-miner scores from a validator
+trajrl miner <hotkey>               # Miner detail + diagnostics
+trajrl pack <hotkey> <pack_hash>    # Pack evaluation detail
+trajrl submissions [--failed]       # Recent pack submissions
+trajrl logs [--type cycle|miner]    # Eval log archives
+```
+
+### Global Options
+
+Every command accepts:
+
+| Option | Description |
+|--------|-------------|
+| `--json` / `-j` | Force JSON output (auto-enabled when stdout is piped) |
+| `--base-url URL` | Override API base (default: `https://trajrl.com`, env: `TRAJRL_BASE_URL`) |
+
+## Usage Examples
+
+### Quick network check
+
+```bash
+trajrl status
+```
+```
+╭──────────────────── Network Status ────────────────────╮
+│   Validators: 7 total, 7 active (seen <1h)             │
+│   LLM Models: zhipu/glm-5 (3), chutes/GLM-5-TEE (3)    │
+│   Latest Eval: 7h ago                                  │
+│   Submissions: 65 passed, 35 failed (last batch)       │
+╰────────────────────────────────────────────────────────╯
+```
+
+### List validators
+
+```bash
+trajrl validators
+```
+```
+ Hotkey         UID  Version  LLM Model              Last Eval   Last Seen
+ 5Cd6h…sn11     29  0.2.7    chutes/zai-org/GLM-5…   7h ago      2m ago
+ 5EcgNd…797f   221  0.2.7    zhipu/glm-5             10h ago     6m ago
+ ...
+```
+
+### Inspect a miner
+
+```bash
+trajrl miner 5HMgR6LnNqUAtaKRwa6bLF4Vy4KBf7TaxCLehyff9mWPhSHt
+```
+
+Shows rank, qualification status, cost, scenario breakdown, per-validator reports, recent submissions, and ban records.
+
+### View failed submissions
+
+```bash
+trajrl submissions --failed
+```
+
+### Filter eval logs
+
+```bash
+trajrl logs --type cycle --limit 5
+trajrl logs --validator 5Cd6h... --type miner
+trajrl logs --eval-id 20260324_000340
+```
+
+### JSON output for agents
+
+Pipe to any tool — JSON is automatic:
+
+```bash
+trajrl validators | jq '.validators[].hotkey'
+trajrl scores 5Cd6h... --json | python3 -c "
+  import sys, json
+  d = json.load(sys.stdin)
+  for e in d['entries'][:5]:
+      print(f\"{e['minerHotkey'][:12]}  qual={e['qualified']}  cost={e['costUsd']}\")
+"
+```
+
+Force JSON in an interactive terminal:
+
+```bash
+trajrl miner 5HMgR6... --json
+```
+
+## API Reference
+
+All data comes from the [TrajectoryRL Public API](https://trajrl.com) — read-only, no authentication required.
+
+| Endpoint | CLI Command |
+|----------|-------------|
+| `GET /api/validators` | `trajrl validators` |
+| `GET /api/scores/by-validator?validator=` | `trajrl scores <hotkey>` |
+| `GET /api/miners/:hotkey` | `trajrl miner <hotkey>` |
+| `GET /api/miners/:hotkey/packs/:hash` | `trajrl pack <hotkey> <hash>` |
+| `GET /api/submissions` | `trajrl submissions` |
+| `GET /api/eval-logs` | `trajrl logs` |
+
+## Development
+
+```bash
+git clone <repo> && cd trajrl
+pip install -e .
+trajrl --help
+```

trajrl-0.1.0/trajrl.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+README.md
+pyproject.toml
+trajrl/__init__.py
+trajrl/api.py
+trajrl/cli.py
+trajrl/display.py
+trajrl.egg-info/PKG-INFO
+trajrl.egg-info/SOURCES.txt
+trajrl.egg-info/dependency_links.txt
+trajrl.egg-info/entry_points.txt
+trajrl.egg-info/requires.txt
+trajrl.egg-info/top_level.txt

trajrl-0.1.0/trajrl.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

trajrl-0.1.0/trajrl.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+trajrl = trajrl.cli:app

trajrl-0.1.0/trajrl.egg-info/requires.txt

@@ -0,0 +1,3 @@
+typer>=0.9
+httpx>=0.25
+rich>=13.0

trajrl-0.1.0/trajrl.egg-info/top_level.txt

@@ -0,0 +1 @@
+trajrl