nabla-cli 0.4.0__tar.gz → 0.4.1__tar.gz

{nabla_cli-0.4.0 → nabla_cli-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nabla-cli
-Version: 0.4.0
+Version: 0.4.1
 Summary: Call-site harvester: scan OpenAI call sites, record real traffic, emit site profiles
 License: MIT
 Requires-Python: >=3.11

{nabla_cli-0.4.0 → nabla_cli-0.4.1}/nabla/__init__.py

@@ -1,3 +1,3 @@
 """nabla — call-site harvester CLI (pre-Phase-0)."""
 
-__version__ = "0.4.0"
+__version__ = "0.4.1"

nabla_cli-0.4.1/nabla/branding.py

@@ -0,0 +1,74 @@
+"""nabla terminal branding: the ∇ logo and startup banner.
+
+The banner prints only on a real terminal — piped output, tests, and
+--json consumers never see it. Block glyphs render via the Windows
+console's UTF-16 writer, so no legacy-codepage fallback is needed on an
+interactive console.
+"""
+
+from __future__ import annotations
+
+from rich.console import Console
+from rich.text import Text
+
+from . import __version__
+
+# Uniform thick strokes like the wordmark: solid bar, solid diagonals,
+# single-block apex. Terminal cells are ~2:1 tall, so 6 rows x 11 cols
+# reads close to the mark's near-equilateral proportions.
+_LOGO = [
+    "█▀▀▀▀▀▀▀▀▀█",
+    " █       █",
+    "  █     █",
+    "   █   █",
+    "    █ █",
+    "     █",
+]
+
+_BRAND_STYLE = "bold cyan"
+
+
+def banner_lines() -> list[tuple[str, str, str]]:
+    """(logo_line, tagline, tagline_style) triples; outer rows have no tagline."""
+    taglines = [
+        ("", ""),
+        ("nabla", "bold"),
+        (f"v{__version__} · OpenAI call-site harvester", ""),
+        ("scan · record · profile", "cyan"),
+        ("", ""),
+        ("", ""),
+    ]
+    return [(logo, text, style) for logo, (text, style) in zip(_LOGO, taglines)]
+
+
+def _compose(reveal: int | None = None, with_taglines: bool = True) -> Text:
+    frame = Text()
+    for logo_line, tagline, tag_style in banner_lines():
+        segment = logo_line if reveal is None else logo_line[:reveal]
+        frame.append(f"  {segment:<14}", style=_BRAND_STYLE)
+        if with_taglines and tagline:
+            frame.append(tagline, style=tag_style)
+        frame.append("\n")
+    return frame
+
+
+def print_banner(console: Console | None = None, animate: bool = False) -> None:
+    console = console or Console()
+    if not console.is_terminal:
+        return
+    console.print()
+    if animate:
+        import time
+
+        from rich.live import Live
+
+        width = max(len(line) for line, _, _ in banner_lines())
+        with Live(console=console, refresh_per_second=60, transient=False) as live:
+            # The mark draws itself in, left to right; the words arrive last.
+            for cut in range(width + 1):
+                live.update(_compose(reveal=cut, with_taglines=False))
+                time.sleep(0.028)
+            live.update(_compose())
+    else:
+        console.print(_compose(), end="")
+    console.print()

{nabla_cli-0.4.0 → nabla_cli-0.4.1}/nabla/cli.py

@@ -191,15 +191,41 @@ def main(argv: list[str] | None = None) -> int:
     return commands[args.command](args)
 
 
+def _clipboard_text() -> str:
+    """Windows clipboard contents (CF_UNICODETEXT), or "" on any failure."""
+    try:
+        import ctypes
+
+        CF_UNICODETEXT = 13
+        user32, kernel32 = ctypes.windll.user32, ctypes.windll.kernel32
+        if not user32.OpenClipboard(0):
+            return ""
+        try:
+            handle = user32.GetClipboardData(CF_UNICODETEXT)
+            if not handle:
+                return ""
+            locked = kernel32.GlobalLock(handle)
+            if not locked:
+                return ""
+            try:
+                return ctypes.c_wchar_p(locked).value or ""
+            finally:
+                kernel32.GlobalUnlock(handle)
+        finally:
+            user32.CloseClipboard()
+    except Exception:
+        return ""
+
+
 def _read_api_key(prompt: str) -> str:
     """Read a secret with visible masking: one `*` per character, backspace
-    supported, pasting shows a `*` per pasted character — so the user can
-    see that their input (typed or pasted) actually arrived. Falls back to
-    fully hidden input where character-level reading isn't available."""
+    supported, and Ctrl+V pastes from the clipboard (classic consoles don't
+    translate Ctrl+V into keystrokes, which silently swallowed pastes).
+    Falls back to fully hidden input where character reading isn't available."""
     if sys.platform == "win32" and sys.stdin.isatty():
         import msvcrt
 
-        print(prompt, end="", flush=True)
+        print(f"{prompt}(paste with Ctrl+V or right-click) ", end="", flush=True)
         chars: list[str] = []
         while True:
             ch = msvcrt.getwch()
@@ -208,7 +234,13 @@ def _read_api_key(prompt: str) -> str:
                 break
             if ch == "\x03":  # Ctrl+C
                 raise KeyboardInterrupt
-            if ch == "\b":
+            if ch == "\x16":  # Ctrl+V — classic console gives us the raw control char
+                pasted = _clipboard_text().strip()
+                for c in pasted:
+                    if c >= " ":
+                        chars.append(c)
+                print("*" * len(pasted), end="", flush=True)
+            elif ch == "\b":
                 if chars:
                     chars.pop()
                     print("\b \b", end="", flush=True)
@@ -222,7 +254,7 @@ def _read_api_key(prompt: str) -> str:
 def _cmd_init(args) -> int:
     from .ui import RAIL, rail, rail_end, rail_ok, rail_start, select
 
-    print_banner(_out)
+    print_banner(_out, animate=True)
     rail_start(_out, "nabla init")
     rail(_out)
 
@@ -395,7 +427,7 @@ def _resolve_site(args, sites):
     if len(supported) == 1:
         site = supported[0]
         from .ui import rail
-        rail(_out, f"using site {site.symbol} (the only supported call site)", style="dim")
+        rail(_out, f"using site {site.symbol} (the only supported call site)")
         return site, None
 
     candidates = supported or sites
@@ -442,8 +474,7 @@ def _cmd_record(args) -> int:
     else:
         conventional = Path(f"{site.symbol}.samples.jsonl")
         if conventional.exists():
-            rail(_out, f"using {conventional} (found by convention; pass --samples to override)",
-                 style="dim")
+            rail(_out, f"using {conventional} (found by convention; pass --samples to override)")
             source = RecordSource(kind="samples", samples_file=str(conventional))
         else:
             source, err = _generate_samples_source(args, site, conventional)
@@ -471,6 +502,13 @@ def _cmd_record(args) -> int:
     except ZeroTrafficError as exc:
         _fail(f"nabla record: {exc}")
         return 1
+    except RuntimeError as exc:
+        message = str(exc)
+        _fail(f"nabla record: {message[:400]}")
+        if "invalid_api_key" in message or "Invalid API Key" in message or "401" in message:
+            _warn("the configured provider rejected your API key — rerun `nabla init` "
+                  "and paste it again (the input shows one * per character, including pastes)")
+        return 1
     out = args.out or f"{site.symbol}.recorded.jsonl"
     with open(out, "w", encoding="utf-8") as f:
         for ex in examples:
@@ -545,7 +583,7 @@ def _cmd_profile(args) -> int:
             print(f"nabla profile: no recorded examples found ({conventional} or recorded.jsonl). "
                   f"Run first: {record_cmd}", file=sys.stderr)
             return 2
-        rail(_out, f"using {examples_path}", style="dim")
+        rail(_out, f"using {examples_path}")
 
     examples, recorded_from = [], "samples"
     for line in Path(examples_path).read_text(encoding="utf-8").splitlines():

{nabla_cli-0.4.0 → nabla_cli-0.4.1}/nabla/recorder.py

@@ -415,9 +415,13 @@ def _run_site_in_subprocess(site: RawSite, repo_path: str, input_slots: dict, en
     timeout = int(os.environ.get("NABLA_SAMPLE_TIMEOUT", "300"))
     proc = subprocess.run(args, cwd=repo_path, env=env, capture_output=True, text=True, timeout=timeout)
     if proc.returncode != 0:
+        # The last stderr lines carry the actual exception; the rest is
+        # traceback scaffolding that buries it.
+        lines = [l for l in (proc.stderr or proc.stdout or "").splitlines() if l.strip()]
+        detail = " | ".join(lines[-2:]) if lines else "no output"
         raise RuntimeError(
             f"Sample invocation of {site.symbol!r} in {site.file!r} failed "
-            f"(exit {proc.returncode}): {proc.stderr.strip() or proc.stdout.strip()}"
+            f"(exit {proc.returncode}): {detail}"
         )
 
 

{nabla_cli-0.4.0 → nabla_cli-0.4.1}/nabla/ui.py

@@ -110,8 +110,9 @@ def select(console: Console, label: str, options: list[tuple[str, str]],
                 row.append(f"  {_POINTER} {_ON} ", style="cyan")
                 row.append(f"{name:<{name_width}}", style="bold cyan")
             else:
+                # Unselected is quieter, never grey — grey reads as disabled.
                 row.append(f"    {_OFF} ", style="dim")
-                row.append(f"{name:<{name_width}}", style="dim")
+                row.append(f"{name:<{name_width}}")
             row.append(f"   {desc}", style="dim")
             console.print(row)
         lines_drawn = len(options) + 1

{nabla_cli-0.4.0 → nabla_cli-0.4.1}/nabla_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nabla-cli
-Version: 0.4.0
+Version: 0.4.1
 Summary: Call-site harvester: scan OpenAI call sites, record real traffic, emit site profiles
 License: MIT
 Requires-Python: >=3.11

{nabla_cli-0.4.0 → nabla_cli-0.4.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nabla-cli"
-version = "0.4.0"
+version = "0.4.1"
 description = "Call-site harvester: scan OpenAI call sites, record real traffic, emit site profiles"
 readme = "README.md"
 license = { text = "MIT" }

nabla_cli-0.4.0/nabla/branding.py

@@ -1,56 +0,0 @@
-"""nabla terminal branding: the ∇ logo and startup banner.
-
-The banner prints only on a real terminal — piped output, tests, and
---json consumers never see it. Block glyphs render via the Windows
-console's UTF-16 writer, so no legacy-codepage fallback is needed on an
-interactive console.
-"""
-
-from __future__ import annotations
-
-from rich.console import Console
-from rich.text import Text
-
-from . import __version__
-
-# Proportioned after the wordmark: tall triangle, heavy top bar,
-# strokes converging to a centered apex.
-_LOGO = [
-    "▛▀▀▀▀▀▀▀▀▀▜",
-    "▚         ▞",
-    " ▚       ▞",
-    "  ▚     ▞",
-    "   ▚   ▞",
-    "    ▚ ▞",
-    "     ▀",
-]
-
-_BRAND_STYLE = "bold cyan"
-
-
-def banner_lines() -> list[tuple[str, str]]:
-    """(logo_line, tagline) pairs; taglines are empty on the outer rows."""
-    taglines = [
-        "",
-        "",
-        "nabla",
-        f"v{__version__} · OpenAI call-site harvester",
-        "scan · record · profile",
-        "",
-        "",
-    ]
-    return list(zip(_LOGO, taglines))
-
-
-def print_banner(console: Console | None = None) -> None:
-    console = console or Console()
-    if not console.is_terminal:
-        return
-    console.print()
-    for logo_line, tagline in banner_lines():
-        row = Text()
-        row.append(f"  {logo_line:<14}", style=_BRAND_STYLE)
-        if tagline:
-            row.append(tagline, style="bold" if tagline == "nabla" else "dim")
-        console.print(row)
-    console.print()