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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nabla-cli
-Version: 0.4.0
+Version: 0.5.0
 Summary: Call-site harvester: scan OpenAI call sites, record real traffic, emit site profiles
 License: MIT
 Requires-Python: >=3.11
@@ -63,19 +63,19 @@ pip install nabla-cli
 
 nabla init         # one-time setup, once per machine
 nabla scan
-nabla record
-nabla profile
+nabla capture
+nabla build
 ```
 
 No flags needed on the happy path: the repo defaults to the current
 directory, `--site` is auto-picked when the repo has exactly one
 supported call site (with more than one, pass `--site <symbol>` — the
-names come from `scan`'s output), `record` writes
-`<site>.recorded.jsonl`, and `profile` finds that file automatically by
+names come from `scan`'s output), `capture` writes
+`<site>.captured.jsonl`, and `build` finds that file automatically by
 the same convention.
 
-If you don't pass `--samples`, `record` looks for
-`<site>.samples.jsonl` and otherwise generates a handful of synthetic
+If you don't pass `--inputs`, `capture` looks for
+`<site>.inputs.jsonl` and otherwise generates a handful of synthetic
 inputs from the site's prompt template (saving them to that file so you
 can edit them and rerun with realistic data). Profiles built on
 generated inputs are marked `generated_samples` in their provenance —
@@ -110,23 +110,23 @@ extract_invoice     app/invoice_extract.py  create json_schema    -
 1 call site found.
 ```
 
-### `nabla record`
+### `nabla capture`
 
 One progress line per sample, then a summary:
 
 ```
-nabla record: sample 1/6 -> 1 capture(s)
-nabla record: sample 2/6 -> 1 capture(s)
+nabla capture: sample 1/6 -> 1 capture(s)
+nabla capture: sample 2/6 -> 1 capture(s)
 ...
-nabla record: 6 examples -> extract_invoice.recorded.jsonl
+captured 6 (prompt, completion) pairs from site extract_invoice -> extract_invoice.captured.jsonl
 ```
 
-`--out` defaults to `<site>.recorded.jsonl` in the current directory (so
-`profile` can find it by the same convention afterward) — pass `--out`
+`--out` defaults to `<site>.captured.jsonl` in the current directory (so
+`build` can find it by the same convention afterward) — pass `--out`
 yourself only to pick a different name or location.
 
-To record your own inputs instead of generated ones, pass `--samples`
-(or create `<site>.samples.jsonl`, which is picked up automatically): a
+To record your own inputs instead of generated ones, pass `--inputs`
+(or create `<site>.inputs.jsonl`, which is picked up automatically): a
 JSONL file, one line per call to record. Each line is
 `{"input_slots": {...}}`, where the keys match the site function's
 keyword arguments (as reported by `scan`):
@@ -139,19 +139,19 @@ keyword arguments (as reported by `scan`):
 nabla runs the site's function once per line, in a subprocess, with its
 OpenAI client rerouted through a local recording proxy.
 
-### `nabla profile`
+### `nabla build`
 
 ```
-nabla profile: goal — "Extract structured invoice fields (total, currency,
+nabla build: goal — "Extract structured invoice fields (total, currency,
 due date) from free-form invoice or receipt text, normalizing
 locale-specific number and date formats."
-nabla profile: wrote extract_invoice.profile.json (site 4f2a9b1c3d8e…, supported=True, 6 examples)
+nabla build: wrote extract_invoice.profile.json (site 4f2a9b1c3d8e…, supported=True, 6 examples)
 ```
 
 `--out` defaults to `<site>.profile.json` in the current directory.
-`--examples` is optional: `profile` looks for `<site>.recorded.jsonl` in
-the current directory — the file `record` just wrote — and you only need
-`--examples <path>` to point it at a different recording. The one LLM
+`--captured` is optional: `build` looks for `<site>.captured.jsonl` in
+the current directory — the file `capture` just wrote — and you only need
+`--captured <path>` to point it at a different recording. The one LLM
 call in this step is goal inference: it reads the reconstructed prompt
 template, the resolved output schema, and the recorded examples, and
 returns a goal description, implicit constraints, and difficulty
@@ -165,16 +165,16 @@ for — it doesn't need to be the provider your target repo already calls.
 
 | Provider | Default model | Role |
 |---|---|---|
-| `openai` | your repo's own model (goal inference uses `gpt-4o-mini`) | Real upstream — `record` calls OpenAI directly with your key, auth passthrough. |
-| `groq` | `openai/gpt-oss-120b` | Stand-in oracle — `record` calls Groq instead of OpenAI. |
-| `gemini` | `gemini-3.5-flash` | Stand-in oracle — `record` calls Gemini instead of OpenAI. |
+| `openai` | your repo's own model (goal inference uses `gpt-4o-mini`) | Real upstream — `capture` calls OpenAI directly with your key, auth passthrough. |
+| `groq` | `openai/gpt-oss-120b` | Stand-in oracle — `capture` calls Groq instead of OpenAI. |
+| `gemini` | `gemini-3.5-flash` | Stand-in oracle — `capture` calls Gemini instead of OpenAI. |
 
 When you pick `groq` or `gemini`, they only stand in for *generating* the
-completions during `record`. The profile's cost/latency baseline always
+completions during `capture`. The profile's cost/latency baseline always
 reports numbers for the target repo's own model — the one your code
 actually calls in production — never the stand-in's.
 
-Gemini's free tier has a very low daily quota: expect `record` to pace
+Gemini's free tier has a very low daily quota: expect `capture` to pace
 requests with multi-second delays and to still hit rate limits past a
 handful of samples. `groq` or `openai` handle larger sample sets more
 comfortably.
@@ -198,11 +198,11 @@ work and take priority over it:
 
 - `--site <symbol>` — skip site auto-pick; required once a repo has more
   than one supported call site.
-- `--out <path>` (`record`) — write recorded examples somewhere other than
-  `<site>.recorded.jsonl`.
-- `--examples <path>` (`profile`) — read recorded examples from somewhere
-  other than `<site>.recorded.jsonl`.
-- `--out <path>` (`profile`) — write the profile somewhere other than
+- `--out <path>` (`capture`) — write recorded examples somewhere other than
+  `<site>.captured.jsonl`.
+- `--captured <path>` (`build`) — read recorded examples from somewhere
+  other than `<site>.captured.jsonl`.
+- `--out <path>` (`build`) — write the profile somewhere other than
   `<site>.profile.json`.
 
 ### Environment variables
@@ -216,7 +216,7 @@ highest first:
 
 | Variable | Purpose |
 |---|---|
-| `OPENAI_API_KEY` | Default upstream for `record` (auth passthrough). |
+| `OPENAI_API_KEY` | Default upstream for `capture` (auth passthrough). |
 | `GROQ_API_KEY` / `GEMINI_API_KEY` | That provider's conventional key env, read if `~/.nabla/config.json` has no stored key. |
 | `NABLA_PROVIDER` | Overrides the provider `nabla init` selected. |
 | `NABLA_UPSTREAM_BASE_URL` | Record through any OpenAI-compatible stand-in oracle instead. |
@@ -228,7 +228,7 @@ highest first:
 
 ## Notes
 
-- `record` runs the site's enclosing function in a subprocess per sample,
+- `capture` runs the site's enclosing function in a subprocess per sample,
   with `OPENAI_BASE_URL` pointed at a local recording proxy. If the
   target's tests mock the SDK, the proxy path reports zero traffic
   explicitly instead of writing an empty profile.

{nabla_cli-0.4.0 → nabla_cli-0.5.0}/README.md

@@ -49,19 +49,19 @@ pip install nabla-cli
 
 nabla init         # one-time setup, once per machine
 nabla scan
-nabla record
-nabla profile
+nabla capture
+nabla build
 ```
 
 No flags needed on the happy path: the repo defaults to the current
 directory, `--site` is auto-picked when the repo has exactly one
 supported call site (with more than one, pass `--site <symbol>` — the
-names come from `scan`'s output), `record` writes
-`<site>.recorded.jsonl`, and `profile` finds that file automatically by
+names come from `scan`'s output), `capture` writes
+`<site>.captured.jsonl`, and `build` finds that file automatically by
 the same convention.
 
-If you don't pass `--samples`, `record` looks for
-`<site>.samples.jsonl` and otherwise generates a handful of synthetic
+If you don't pass `--inputs`, `capture` looks for
+`<site>.inputs.jsonl` and otherwise generates a handful of synthetic
 inputs from the site's prompt template (saving them to that file so you
 can edit them and rerun with realistic data). Profiles built on
 generated inputs are marked `generated_samples` in their provenance —
@@ -96,23 +96,23 @@ extract_invoice     app/invoice_extract.py  create json_schema    -
 1 call site found.
 ```
 
-### `nabla record`
+### `nabla capture`
 
 One progress line per sample, then a summary:
 
 ```
-nabla record: sample 1/6 -> 1 capture(s)
-nabla record: sample 2/6 -> 1 capture(s)
+nabla capture: sample 1/6 -> 1 capture(s)
+nabla capture: sample 2/6 -> 1 capture(s)
 ...
-nabla record: 6 examples -> extract_invoice.recorded.jsonl
+captured 6 (prompt, completion) pairs from site extract_invoice -> extract_invoice.captured.jsonl
 ```
 
-`--out` defaults to `<site>.recorded.jsonl` in the current directory (so
-`profile` can find it by the same convention afterward) — pass `--out`
+`--out` defaults to `<site>.captured.jsonl` in the current directory (so
+`build` can find it by the same convention afterward) — pass `--out`
 yourself only to pick a different name or location.
 
-To record your own inputs instead of generated ones, pass `--samples`
-(or create `<site>.samples.jsonl`, which is picked up automatically): a
+To record your own inputs instead of generated ones, pass `--inputs`
+(or create `<site>.inputs.jsonl`, which is picked up automatically): a
 JSONL file, one line per call to record. Each line is
 `{"input_slots": {...}}`, where the keys match the site function's
 keyword arguments (as reported by `scan`):
@@ -125,19 +125,19 @@ keyword arguments (as reported by `scan`):
 nabla runs the site's function once per line, in a subprocess, with its
 OpenAI client rerouted through a local recording proxy.
 
-### `nabla profile`
+### `nabla build`
 
 ```
-nabla profile: goal — "Extract structured invoice fields (total, currency,
+nabla build: goal — "Extract structured invoice fields (total, currency,
 due date) from free-form invoice or receipt text, normalizing
 locale-specific number and date formats."
-nabla profile: wrote extract_invoice.profile.json (site 4f2a9b1c3d8e…, supported=True, 6 examples)
+nabla build: wrote extract_invoice.profile.json (site 4f2a9b1c3d8e…, supported=True, 6 examples)
 ```
 
 `--out` defaults to `<site>.profile.json` in the current directory.
-`--examples` is optional: `profile` looks for `<site>.recorded.jsonl` in
-the current directory — the file `record` just wrote — and you only need
-`--examples <path>` to point it at a different recording. The one LLM
+`--captured` is optional: `build` looks for `<site>.captured.jsonl` in
+the current directory — the file `capture` just wrote — and you only need
+`--captured <path>` to point it at a different recording. The one LLM
 call in this step is goal inference: it reads the reconstructed prompt
 template, the resolved output schema, and the recorded examples, and
 returns a goal description, implicit constraints, and difficulty
@@ -151,16 +151,16 @@ for — it doesn't need to be the provider your target repo already calls.
 
 | Provider | Default model | Role |
 |---|---|---|
-| `openai` | your repo's own model (goal inference uses `gpt-4o-mini`) | Real upstream — `record` calls OpenAI directly with your key, auth passthrough. |
-| `groq` | `openai/gpt-oss-120b` | Stand-in oracle — `record` calls Groq instead of OpenAI. |
-| `gemini` | `gemini-3.5-flash` | Stand-in oracle — `record` calls Gemini instead of OpenAI. |
+| `openai` | your repo's own model (goal inference uses `gpt-4o-mini`) | Real upstream — `capture` calls OpenAI directly with your key, auth passthrough. |
+| `groq` | `openai/gpt-oss-120b` | Stand-in oracle — `capture` calls Groq instead of OpenAI. |
+| `gemini` | `gemini-3.5-flash` | Stand-in oracle — `capture` calls Gemini instead of OpenAI. |
 
 When you pick `groq` or `gemini`, they only stand in for *generating* the
-completions during `record`. The profile's cost/latency baseline always
+completions during `capture`. The profile's cost/latency baseline always
 reports numbers for the target repo's own model — the one your code
 actually calls in production — never the stand-in's.
 
-Gemini's free tier has a very low daily quota: expect `record` to pace
+Gemini's free tier has a very low daily quota: expect `capture` to pace
 requests with multi-second delays and to still hit rate limits past a
 handful of samples. `groq` or `openai` handle larger sample sets more
 comfortably.
@@ -184,11 +184,11 @@ work and take priority over it:
 
 - `--site <symbol>` — skip site auto-pick; required once a repo has more
   than one supported call site.
-- `--out <path>` (`record`) — write recorded examples somewhere other than
-  `<site>.recorded.jsonl`.
-- `--examples <path>` (`profile`) — read recorded examples from somewhere
-  other than `<site>.recorded.jsonl`.
-- `--out <path>` (`profile`) — write the profile somewhere other than
+- `--out <path>` (`capture`) — write recorded examples somewhere other than
+  `<site>.captured.jsonl`.
+- `--captured <path>` (`build`) — read recorded examples from somewhere
+  other than `<site>.captured.jsonl`.
+- `--out <path>` (`build`) — write the profile somewhere other than
   `<site>.profile.json`.
 
 ### Environment variables
@@ -202,7 +202,7 @@ highest first:
 
 | Variable | Purpose |
 |---|---|
-| `OPENAI_API_KEY` | Default upstream for `record` (auth passthrough). |
+| `OPENAI_API_KEY` | Default upstream for `capture` (auth passthrough). |
 | `GROQ_API_KEY` / `GEMINI_API_KEY` | That provider's conventional key env, read if `~/.nabla/config.json` has no stored key. |
 | `NABLA_PROVIDER` | Overrides the provider `nabla init` selected. |
 | `NABLA_UPSTREAM_BASE_URL` | Record through any OpenAI-compatible stand-in oracle instead. |
@@ -214,7 +214,7 @@ highest first:
 
 ## Notes
 
-- `record` runs the site's enclosing function in a subprocess per sample,
+- `capture` runs the site's enclosing function in a subprocess per sample,
   with `OPENAI_BASE_URL` pointed at a local recording proxy. If the
   target's tests mock the SDK, the proxy path reports zero traffic
   explicitly instead of writing an empty profile.

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

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

nabla_cli-0.5.0/nabla/branding.py

@@ -0,0 +1,94 @@
+"""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 · capture · build", "cyan"),
+        ("", ""),
+        ("", ""),
+    ]
+    return [(logo, text, style) for logo, (text, style) in zip(_LOGO, taglines)]
+
+
+def _compose(mask: set[tuple[int, int]] | None = None, with_taglines: bool = True) -> Text:
+    frame = Text()
+    for r, (logo_line, tagline, tag_style) in enumerate(banner_lines()):
+        if mask is None:
+            segment = logo_line
+        else:
+            segment = "".join(
+                ch if ch == " " or (r, c) in mask else " "
+                for c, ch in enumerate(logo_line)
+            )
+        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 _stroke_frames() -> list[set[tuple[int, int]]]:
+    """Reveal order that traces the mark like a pen: the top bar sweeps
+    left to right, then the two diagonals descend together to the apex."""
+    frames: list[set[tuple[int, int]]] = []
+    mask: set[tuple[int, int]] = set()
+    top_cells = [(0, c) for c, ch in enumerate(_LOGO[0]) if ch != " "]
+    for i in range(0, len(top_cells), 2):
+        mask.update(top_cells[i:i + 2])
+        frames.append(set(mask))
+    for r in range(1, len(_LOGO)):
+        mask.update((r, c) for c, ch in enumerate(_LOGO[r]) if ch != " ")
+        frames.append(set(mask))
+    return frames
+
+
+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
+
+        with Live(console=console, refresh_per_second=30, transient=False) as live:
+            for mask in _stroke_frames():
+                live.update(_compose(mask=mask, with_taglines=False))
+                time.sleep(0.09)
+            time.sleep(0.18)
+            live.update(_compose())
+    else:
+        console.print(_compose(), end="")
+    console.print()

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

@@ -48,8 +48,8 @@ def _build_parser() -> argparse.ArgumentParser:
             "typical flow (run from inside the target repo):\n"
             "  nabla init      one-time setup\n"
             "  nabla scan      find call sites\n"
-            "  nabla record    capture traffic (inputs auto-generated if none given)\n"
-            "  nabla profile   write the site profile\n"
+            "  nabla capture   intercept real traffic through a site\n"
+            "  nabla build     assemble the site profile artifact\n"
         ),
     )
     parser.add_argument("--version", action="version", version=f"nabla {__version__}")
@@ -82,14 +82,15 @@ def _build_parser() -> argparse.ArgumentParser:
     p_scan.add_argument("--json", action="store_true", help="machine-readable output")
 
     p_record = sub.add_parser(
-        "record",
-        help="capture (prompt, completion) pairs",
+        "capture",
+        aliases=["record"],
+        help="intercept (prompt, completion) pairs through a call site",
         formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog=(
             "examples:\n"
-            "  nabla record                       auto: pick site, generate inputs\n"
-            "  nabla record --samples inputs.jsonl\n"
-            "  nabla record path/to/repo --site extract_invoice --samples inputs.jsonl\n"
+            "  nabla capture                      auto: pick site, generate inputs\n"
+            "  nabla capture --inputs inputs.jsonl\n"
+            "  nabla capture path/to/repo --site extract_invoice --inputs inputs.jsonl\n"
         ),
     )
     p_record.add_argument("repo", nargs="?", default=".", help="path to target repo (default: current directory)")
@@ -98,24 +99,27 @@ def _build_parser() -> argparse.ArgumentParser:
         help="site symbol (auto-picked when omitted and the repo has exactly one supported call site)",
     )
     p_record.add_argument(
-        "--samples",
-        help="JSONL sample inputs (default: <site>.samples.jsonl if present, else auto-generated)",
+        "--inputs", "--samples", dest="samples",
+        help="JSONL inputs to run through the site (default: <site>.inputs.jsonl if present, "
+             "else auto-generated)",
     )
     p_record.add_argument("--logs", help="JSONL of past request/response pairs")
     p_record.add_argument("--proxy-cmd", help="command to run under the recording proxy")
-    p_record.add_argument("--num-samples", type=int, default=5,
-                          help="how many inputs to auto-generate when no samples are given (default: 5)")
+    p_record.add_argument("--num-samples", type=int, default=None,
+                          help="how many inputs to auto-generate when none are given "
+                               "(default: asked interactively, or 5 when not a terminal)")
     p_record.add_argument("--out", default=None,
-                          help="output JSONL (default: <site>.recorded.jsonl)")
+                          help="output JSONL (default: <site>.captured.jsonl)")
 
     p_profile = sub.add_parser(
-        "profile",
-        help="assemble site_profile.json",
+        "build",
+        aliases=["profile"],
+        help="assemble the site profile artifact",
         formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog=(
             "examples:\n"
-            "  nabla profile                      auto: pick site, find <site>.recorded.jsonl\n"
-            "  nabla profile path/to/repo --site extract_invoice --examples recorded.jsonl\n"
+            "  nabla build                        auto: pick site, find <site>.captured.jsonl\n"
+            "  nabla build path/to/repo --site extract_invoice --captured captured.jsonl\n"
         ),
     )
     p_profile.add_argument("repo", nargs="?", default=".", help="path to target repo (default: current directory)")
@@ -123,8 +127,8 @@ def _build_parser() -> argparse.ArgumentParser:
         "--site",
         help="site symbol (auto-picked when omitted and the repo has exactly one supported call site)",
     )
-    p_profile.add_argument("--examples",
-                           help="recorded JSONL from `nabla record` (default: <site>.recorded.jsonl)")
+    p_profile.add_argument("--captured", "--examples", dest="examples",
+                           help="captured JSONL from `nabla capture` (default: <site>.captured.jsonl)")
     p_profile.add_argument("--out", default=None,
                            help="output path (default: <site>.profile.json)")
 
@@ -185,21 +189,49 @@ def main(argv: list[str] | None = None) -> int:
     commands = {
         "init": _cmd_init,
         "scan": _cmd_scan,
-        "record": _cmd_record,
-        "profile": _cmd_profile,
+        "capture": _cmd_record,
+        "record": _cmd_record,    # legacy alias
+        "build": _cmd_profile,
+        "profile": _cmd_profile,  # legacy alias
     }
     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 +240,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 +260,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)
 
@@ -358,7 +396,7 @@ def _cmd_scan(args) -> int:
     noun = "call site" if len(rows) == 1 else "call sites"
     _out.print(f"{len(rows)} {noun} found — {supported_count} harvestable.", markup=False)
     if supported_count:
-        _next_step("nabla record" + (f" {args.repo}" if args.repo != "." else ""))
+        _next_step("nabla capture" + (f" {args.repo}" if args.repo != "." else ""))
     if _unconfigured():
         _warn("tip: run `nabla init` once to set up a provider — `nabla record` "
               "and `nabla profile` need one")
@@ -370,10 +408,10 @@ def _rerun_command(args, symbol: str) -> str:
     carrying over whichever other flags were already given."""
     parts = ["nabla", args.command, args.repo, "--site", symbol]
     for flag, attr in (
-        ("--samples", "samples"),
+        ("--inputs", "samples"),
         ("--logs", "logs"),
         ("--proxy-cmd", "proxy_cmd"),
-        ("--examples", "examples"),
+        ("--captured", "examples"),
     ):
         value = getattr(args, attr, None)
         if value:
@@ -395,7 +433,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
@@ -417,7 +455,7 @@ def _resolve_site(args, sites):
 def _cmd_record(args) -> int:
     from .ui import make_progress, rail, rail_end, rail_ok, rail_start
 
-    rail_start(_out, "nabla record")
+    rail_start(_out, "nabla capture")
     sites = scan(args.repo)
     site, err = _resolve_site(args, sites)
     if err is not None:
@@ -440,13 +478,17 @@ def _cmd_record(args) -> int:
     elif args.proxy_cmd:
         source = RecordSource(kind="proxy", proxy_command=args.proxy_cmd.split())
     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")
+        conventional = next(
+            (p for p in (Path(f"{site.symbol}.inputs.jsonl"),
+                         Path(f"{site.symbol}.samples.jsonl"))  # legacy name
+             if p.exists()),
+            None,
+        )
+        if conventional is not None:
+            rail(_out, f"using {conventional} (found by convention; pass --inputs to override)")
             source = RecordSource(kind="samples", samples_file=str(conventional))
         else:
-            source, err = _generate_samples_source(args, site, conventional)
+            source, err = _generate_samples_source(args, site, Path(f"{site.symbol}.inputs.jsonl"))
             if err is not None:
                 return err
             source_kind = "generated_samples"
@@ -469,23 +511,30 @@ def _cmd_record(args) -> int:
         else:
             examples = record(site, source, args.repo)
     except ZeroTrafficError as exc:
-        _fail(f"nabla record: {exc}")
+        _fail(f"nabla capture: {exc}")
+        return 1
+    except RuntimeError as exc:
+        message = str(exc)
+        _fail(f"nabla capture: {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"
+    out = args.out or f"{site.symbol}.captured.jsonl"
     with open(out, "w", encoding="utf-8") as f:
         for ex in examples:
             f.write(json.dumps({**ex.to_dict(), "_source_kind": source_kind or source.kind}) + "\n")
     rail(_out)
-    rail_ok(_out, f"recorded {len(examples)} (prompt, completion) pairs from "
+    rail_ok(_out, f"captured {len(examples)} (prompt, completion) pairs from "
                   f"site {site.symbol} -> {out}")
     if source_kind == "generated_samples":
-        rail(_out, f"inputs were synthetic — edit {site.symbol}.samples.jsonl with real "
+        rail(_out, f"inputs were synthetic — edit {site.symbol}.inputs.jsonl with real "
                    "data and rerun for a higher-fidelity harvest", style="yellow")
     rail(_out)
     if args.out is None and args.site is None:
-        rail_end(_out, f"next: nabla profile{'' if args.repo == '.' else ' ' + args.repo}")
+        rail_end(_out, f"next: nabla build{'' if args.repo == '.' else ' ' + args.repo}")
     else:
-        rail_end(_out, f"next: nabla profile {args.repo} --site {site.symbol} --examples {out}")
+        rail_end(_out, f"next: nabla build {args.repo} --site {site.symbol} --captured {out}")
     return 0
 
 
@@ -497,14 +546,27 @@ def _generate_samples_source(args, site, out_path: Path):
     from .prompt_recon import reconstruct
     from .samplegen import SampleGenError, generate_samples
 
+    n = args.num_samples
+    if n is None:
+        if _out.is_terminal and sys.stdin.isatty():
+            from .ui import select
+            options = [
+                ("5", "quick look — fastest, fewest credits"),
+                ("10", "balanced — decent goal inference"),
+                ("20", "handoff floor — slowest, most credits"),
+            ]
+            n = int(options[select(_out, "Synthetic inputs", options)][0])
+        else:
+            n = 5
+
     template = reconstruct(site, args.repo)
     schema, _ = resolve_schema(site, args.repo)
     try:
-        items = generate_samples(template, schema, args.num_samples)
+        items = generate_samples(template, schema, n)
     except (SampleGenError, InduceError) as exc:
         print(
-            f"nabla record: cannot auto-generate sample inputs: {exc}\n"
-            'pass --samples FILE with your own inputs (JSONL, one {"input_slots": {...}} '
+            f"nabla capture: cannot auto-generate inputs: {exc}\n"
+            'pass --inputs FILE with your own (JSONL, one {"input_slots": {...}} '
             "object per line), or run `nabla init` to configure a provider",
             file=sys.stderr,
         )
@@ -522,7 +584,7 @@ def _cmd_profile(args) -> int:
     from .schema_resolver import resolve_schema as _resolve
     from .ui import rail, rail_end, rail_ok, rail_start
 
-    rail_start(_out, "nabla profile")
+    rail_start(_out, "nabla build")
     sites = scan(args.repo)
     site, err = _resolve_site(args, sites)
     if err is not None:
@@ -532,20 +594,19 @@ def _cmd_profile(args) -> int:
 
     examples_path = args.examples
     if examples_path is None:
-        conventional = Path(f"{site.symbol}.recorded.jsonl")
-        legacy = Path("recorded.jsonl")
-        if conventional.exists():
-            examples_path = str(conventional)
-        elif legacy.exists():
-            examples_path = str(legacy)
-        else:
-            record_cmd = f"nabla record {args.repo}"
+        candidates = [Path(f"{site.symbol}.captured.jsonl"),
+                      Path(f"{site.symbol}.recorded.jsonl"),  # legacy names
+                      Path("recorded.jsonl")]
+        found = next((p for p in candidates if p.exists()), None)
+        if found is None:
+            capture_cmd = f"nabla capture {args.repo}"
             if args.site:
-                record_cmd += f" --site {site.symbol}"
-            print(f"nabla profile: no recorded examples found ({conventional} or recorded.jsonl). "
-                  f"Run first: {record_cmd}", file=sys.stderr)
+                capture_cmd += f" --site {site.symbol}"
+            print(f"nabla build: no captured pairs found ({candidates[0]}). "
+                  f"Run first: {capture_cmd}", file=sys.stderr)
             return 2
-        rail(_out, f"using {examples_path}", style="dim")
+        examples_path = str(found)
+        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.5.0}/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}"
         )
 
 
@@ -460,7 +464,7 @@ def _record_samples(site: RawSite, source: RecordSource, repo_path: str,
                 _run_site_in_subprocess(site, repo_path, input_slots, env)
             except (RuntimeError, subprocess.TimeoutExpired) as exc:
                 failures.append((i, str(exc)))
-                print(f"nabla record: sample {i + 1}/{total} FAILED: {str(exc)[:300]}",
+                print(f"nabla capture: sample {i + 1}/{total} FAILED: {str(exc)[:300]}",
                       file=sys.stderr)
                 continue
             with proxy._lock:
@@ -470,7 +474,7 @@ def _record_samples(site: RawSite, source: RecordSource, repo_path: str,
             if on_progress is not None:
                 on_progress(i + 1, total)
             else:
-                print(f"nabla record: sample {i + 1}/{total} -> {len(new_captures)} capture(s)",
+                print(f"nabla capture: sample {i + 1}/{total} -> {len(new_captures)} capture(s)",
                       file=sys.stderr)
     finally:
         proxy.stop()
@@ -480,7 +484,7 @@ def _record_samples(site: RawSite, source: RecordSource, repo_path: str,
             f"all {len(failures)} sample invocations failed; first error: {failures[0][1]}"
         )
     if failures:
-        print(f"nabla record: {len(failures)}/{total} samples failed and were skipped",
+        print(f"nabla capture: {len(failures)}/{total} samples failed and were skipped",
               file=sys.stderr)
     return examples
 

{nabla_cli-0.4.0 → nabla_cli-0.5.0}/nabla/samplegen.py

@@ -1,10 +1,10 @@
-"""Synthetic sample-input generation for `nabla record` when no --samples
-file is given.
+"""Synthetic input generation for `nabla capture` when no --inputs file
+is given.
 
 The site's statically recovered prompt template, slots, system prompt, and
 output schema are enough context for the configured provider to invent a
 handful of plausible inputs. The CLI always writes generated inputs to
-<site>.samples.jsonl so the user can inspect, edit, and rerun with real
+<site>.inputs.jsonl so the user can inspect, edit, and rerun with real
 data; profiles built from them carry provenance "generated_samples",
 never "samples".
 
@@ -52,7 +52,7 @@ def generate_samples(template: PromptTemplate, schema: dict[str, Any] | None,
     if not slot_names:
         raise SampleGenError(
             "site has no reconstructable input slots — cannot generate sample "
-            "inputs; pass --samples with your own JSONL instead"
+            "inputs; pass --inputs with your own JSONL instead"
         )
 
     model = model or os.environ.get("NABLA_SAMPLEGEN_MODEL") \
@@ -113,6 +113,6 @@ def _parse_samples(raw: str, slot_names: list[str], n: int) -> list[dict]:
     if not items:
         raise SampleGenError(
             "sample generation produced no items covering every slot "
-            f"({slot_names}); pass --samples with your own JSONL instead"
+            f"({slot_names}); pass --inputs with your own JSONL instead"
         )
     return items

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

@@ -18,7 +18,7 @@ from __future__ import annotations
 import sys
 
 from rich.console import Console
-from rich.progress import Progress, ProgressColumn, TextColumn
+from rich.progress import Progress, TextColumn
 from rich.text import Text
 
 RAIL = "│"
@@ -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
@@ -141,30 +142,18 @@ def select(console: Console, label: str, options: list[tuple[str, str]],
 
 
 # ---------------------------------------------------------------------------
-# Progress: the ∇ bar
+# Progress
 # ---------------------------------------------------------------------------
 
-class NablaBar(ProgressColumn):
-    """A bar that fills with the nabla glyph — brand as instrument."""
-
-    def __init__(self, width: int = 28):
-        super().__init__()
-        self.width = width
-
-    def render(self, task) -> Text:
-        total = task.total or 1
-        filled = int(self.width * min(task.completed / total, 1.0))
-        bar = Text()
-        bar.append("∇" * filled, style="cyan")
-        bar.append("·" * (self.width - filled), style="dim")
-        return bar
-
-
 def make_progress(console: Console, unit: str = "samples") -> Progress:
+    from rich.progress import BarColumn, SpinnerColumn, TimeElapsedColumn
+
     return Progress(
         TextColumn(RAIL, style="dim"),
-        NablaBar(),
-        TextColumn(f"{{task.completed}}/{{task.total}} {unit}", style="dim"),
+        SpinnerColumn(spinner_name="dots", style="cyan"),
+        BarColumn(bar_width=28, style="dim", complete_style="cyan", finished_style="green"),
+        TextColumn(f"{{task.completed}}/{{task.total}} {unit}"),
+        TimeElapsedColumn(),
         console=console,
         transient=True,
     )

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nabla-cli
-Version: 0.4.0
+Version: 0.5.0
 Summary: Call-site harvester: scan OpenAI call sites, record real traffic, emit site profiles
 License: MIT
 Requires-Python: >=3.11
@@ -63,19 +63,19 @@ pip install nabla-cli
 
 nabla init         # one-time setup, once per machine
 nabla scan
-nabla record
-nabla profile
+nabla capture
+nabla build
 ```
 
 No flags needed on the happy path: the repo defaults to the current
 directory, `--site` is auto-picked when the repo has exactly one
 supported call site (with more than one, pass `--site <symbol>` — the
-names come from `scan`'s output), `record` writes
-`<site>.recorded.jsonl`, and `profile` finds that file automatically by
+names come from `scan`'s output), `capture` writes
+`<site>.captured.jsonl`, and `build` finds that file automatically by
 the same convention.
 
-If you don't pass `--samples`, `record` looks for
-`<site>.samples.jsonl` and otherwise generates a handful of synthetic
+If you don't pass `--inputs`, `capture` looks for
+`<site>.inputs.jsonl` and otherwise generates a handful of synthetic
 inputs from the site's prompt template (saving them to that file so you
 can edit them and rerun with realistic data). Profiles built on
 generated inputs are marked `generated_samples` in their provenance —
@@ -110,23 +110,23 @@ extract_invoice     app/invoice_extract.py  create json_schema    -
 1 call site found.
 ```
 
-### `nabla record`
+### `nabla capture`
 
 One progress line per sample, then a summary:
 
 ```
-nabla record: sample 1/6 -> 1 capture(s)
-nabla record: sample 2/6 -> 1 capture(s)
+nabla capture: sample 1/6 -> 1 capture(s)
+nabla capture: sample 2/6 -> 1 capture(s)
 ...
-nabla record: 6 examples -> extract_invoice.recorded.jsonl
+captured 6 (prompt, completion) pairs from site extract_invoice -> extract_invoice.captured.jsonl
 ```
 
-`--out` defaults to `<site>.recorded.jsonl` in the current directory (so
-`profile` can find it by the same convention afterward) — pass `--out`
+`--out` defaults to `<site>.captured.jsonl` in the current directory (so
+`build` can find it by the same convention afterward) — pass `--out`
 yourself only to pick a different name or location.
 
-To record your own inputs instead of generated ones, pass `--samples`
-(or create `<site>.samples.jsonl`, which is picked up automatically): a
+To record your own inputs instead of generated ones, pass `--inputs`
+(or create `<site>.inputs.jsonl`, which is picked up automatically): a
 JSONL file, one line per call to record. Each line is
 `{"input_slots": {...}}`, where the keys match the site function's
 keyword arguments (as reported by `scan`):
@@ -139,19 +139,19 @@ keyword arguments (as reported by `scan`):
 nabla runs the site's function once per line, in a subprocess, with its
 OpenAI client rerouted through a local recording proxy.
 
-### `nabla profile`
+### `nabla build`
 
 ```
-nabla profile: goal — "Extract structured invoice fields (total, currency,
+nabla build: goal — "Extract structured invoice fields (total, currency,
 due date) from free-form invoice or receipt text, normalizing
 locale-specific number and date formats."
-nabla profile: wrote extract_invoice.profile.json (site 4f2a9b1c3d8e…, supported=True, 6 examples)
+nabla build: wrote extract_invoice.profile.json (site 4f2a9b1c3d8e…, supported=True, 6 examples)
 ```
 
 `--out` defaults to `<site>.profile.json` in the current directory.
-`--examples` is optional: `profile` looks for `<site>.recorded.jsonl` in
-the current directory — the file `record` just wrote — and you only need
-`--examples <path>` to point it at a different recording. The one LLM
+`--captured` is optional: `build` looks for `<site>.captured.jsonl` in
+the current directory — the file `capture` just wrote — and you only need
+`--captured <path>` to point it at a different recording. The one LLM
 call in this step is goal inference: it reads the reconstructed prompt
 template, the resolved output schema, and the recorded examples, and
 returns a goal description, implicit constraints, and difficulty
@@ -165,16 +165,16 @@ for — it doesn't need to be the provider your target repo already calls.
 
 | Provider | Default model | Role |
 |---|---|---|
-| `openai` | your repo's own model (goal inference uses `gpt-4o-mini`) | Real upstream — `record` calls OpenAI directly with your key, auth passthrough. |
-| `groq` | `openai/gpt-oss-120b` | Stand-in oracle — `record` calls Groq instead of OpenAI. |
-| `gemini` | `gemini-3.5-flash` | Stand-in oracle — `record` calls Gemini instead of OpenAI. |
+| `openai` | your repo's own model (goal inference uses `gpt-4o-mini`) | Real upstream — `capture` calls OpenAI directly with your key, auth passthrough. |
+| `groq` | `openai/gpt-oss-120b` | Stand-in oracle — `capture` calls Groq instead of OpenAI. |
+| `gemini` | `gemini-3.5-flash` | Stand-in oracle — `capture` calls Gemini instead of OpenAI. |
 
 When you pick `groq` or `gemini`, they only stand in for *generating* the
-completions during `record`. The profile's cost/latency baseline always
+completions during `capture`. The profile's cost/latency baseline always
 reports numbers for the target repo's own model — the one your code
 actually calls in production — never the stand-in's.
 
-Gemini's free tier has a very low daily quota: expect `record` to pace
+Gemini's free tier has a very low daily quota: expect `capture` to pace
 requests with multi-second delays and to still hit rate limits past a
 handful of samples. `groq` or `openai` handle larger sample sets more
 comfortably.
@@ -198,11 +198,11 @@ work and take priority over it:
 
 - `--site <symbol>` — skip site auto-pick; required once a repo has more
   than one supported call site.
-- `--out <path>` (`record`) — write recorded examples somewhere other than
-  `<site>.recorded.jsonl`.
-- `--examples <path>` (`profile`) — read recorded examples from somewhere
-  other than `<site>.recorded.jsonl`.
-- `--out <path>` (`profile`) — write the profile somewhere other than
+- `--out <path>` (`capture`) — write recorded examples somewhere other than
+  `<site>.captured.jsonl`.
+- `--captured <path>` (`build`) — read recorded examples from somewhere
+  other than `<site>.captured.jsonl`.
+- `--out <path>` (`build`) — write the profile somewhere other than
   `<site>.profile.json`.
 
 ### Environment variables
@@ -216,7 +216,7 @@ highest first:
 
 | Variable | Purpose |
 |---|---|
-| `OPENAI_API_KEY` | Default upstream for `record` (auth passthrough). |
+| `OPENAI_API_KEY` | Default upstream for `capture` (auth passthrough). |
 | `GROQ_API_KEY` / `GEMINI_API_KEY` | That provider's conventional key env, read if `~/.nabla/config.json` has no stored key. |
 | `NABLA_PROVIDER` | Overrides the provider `nabla init` selected. |
 | `NABLA_UPSTREAM_BASE_URL` | Record through any OpenAI-compatible stand-in oracle instead. |
@@ -228,7 +228,7 @@ highest first:
 
 ## Notes
 
-- `record` runs the site's enclosing function in a subprocess per sample,
+- `capture` runs the site's enclosing function in a subprocess per sample,
   with `OPENAI_BASE_URL` pointed at a local recording proxy. If the
   target's tests mock the SDK, the proxy path reports zero traffic
   explicitly instead of writing an empty profile.

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

@@ -1,6 +1,6 @@
 [project]
 name = "nabla-cli"
-version = "0.4.0"
+version = "0.5.0"
 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_cli-0.5.0}/tests/test_cli_ux.py

@@ -123,7 +123,7 @@ def test_record_no_source_generation_failure_mentions_samples(monkeypatch, capsy
 
     assert rc == 1
     err = capsys.readouterr().err
-    assert "--samples" in err
+    assert "--inputs" in err
     assert "provider unavailable" in err
 
 
@@ -179,7 +179,7 @@ def test_record_help_includes_examples(capsys):
     assert exc.value.code == 0
     out = capsys.readouterr().out
     assert "examples:" in out
-    assert "nabla record" in out
+    assert "nabla capture" in out
 
 
 # ---------------------------------------------------------------------------
@@ -203,10 +203,10 @@ def test_record_auto_names_output_by_symbol(tmp_path, monkeypatch, capsys):
     rc = main(["record", str(repo), "--samples", str(samples)])
 
     assert rc == 0
-    out_file = tmp_path / "extract_receipt.recorded.jsonl"
+    out_file = tmp_path / "extract_receipt.captured.jsonl"
     assert out_file.exists()
     stdout = capsys.readouterr().out
-    assert "extract_receipt.recorded.jsonl" in stdout
+    assert "extract_receipt.captured.jsonl" in stdout
 
 
 def test_record_generates_samples_when_none_given(tmp_path, monkeypatch, capsys):
@@ -223,16 +223,16 @@ def test_record_generates_samples_when_none_given(tmp_path, monkeypatch, capsys)
     rc = main(["record", str(repo), "--num-samples", "3"])
 
     assert rc == 0
-    samples_file = tmp_path / "extract_receipt.samples.jsonl"
+    samples_file = tmp_path / "extract_receipt.inputs.jsonl"
     assert samples_file.exists()
     assert len(samples_file.read_text(encoding="utf-8").splitlines()) == 3
-    recorded = tmp_path / "extract_receipt.recorded.jsonl"
+    recorded = tmp_path / "extract_receipt.captured.jsonl"
     lines = [json.loads(x) for x in recorded.read_text(encoding="utf-8").splitlines()]
     assert len(lines) == 3
     assert all(line["_source_kind"] == "generated_samples" for line in lines)
     stdout = capsys.readouterr().out
     assert "generated 3 synthetic inputs" in stdout
-    assert "next: nabla profile" in stdout
+    assert "next: nabla build" in stdout
 
 
 def test_record_prefers_conventional_samples_file(tmp_path, monkeypatch, capsys):
@@ -253,7 +253,7 @@ def test_record_prefers_conventional_samples_file(tmp_path, monkeypatch, capsys)
     stdout = capsys.readouterr().out
     assert "found by convention" in stdout
     lines = [json.loads(x) for x in
-             (tmp_path / "extract_receipt.recorded.jsonl").read_text(encoding="utf-8").splitlines()]
+             (tmp_path / "extract_receipt.captured.jsonl").read_text(encoding="utf-8").splitlines()]
     assert lines and all(line["_source_kind"] == "samples" for line in lines)
 
 
@@ -293,7 +293,7 @@ def test_profile_without_recorded_file_exits_2_with_record_command(tmp_path, mon
 
     assert rc == 2
     err = capsys.readouterr().err
-    assert "nabla record" in err
+    assert "nabla capture" in err
 
 
 def test_bare_scan_defaults_to_cwd(tmp_path, monkeypatch, capsys):

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()