databar 2.0.7__tar.gz → 2.0.8__tar.gz

{databar-2.0.7/src/databar.egg-info → databar-2.0.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: databar
-Version: 2.0.7
+Version: 2.0.8
 Summary: Official Databar.ai Python SDK and CLI — connect to enrichments, waterfalls, and tables via api.databar.ai
 Author-email: "Databar.ai Team" <info@databar.ai>
 License: MIT License

{databar-2.0.7 → databar-2.0.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "databar"
-version = "2.0.7"
+version = "2.0.8"
 description = "Official Databar.ai Python SDK and CLI — connect to enrichments, waterfalls, and tables via api.databar.ai"
 readme = "README.md"
 license = { file = "LICENSE" }

{databar-2.0.7 → databar-2.0.8}/src/databar/__init__.py

@@ -58,7 +58,7 @@ from .models import (
     WaterfallEnrichment,
 )
 
-__version__ = "2.0.7"
+__version__ = "2.0.8"
 __all__ = [
     "DatabarClient",
     # exceptions

{databar-2.0.7 → databar-2.0.8}/src/databar/cli/_onboard.py

@@ -6,7 +6,8 @@ Guides the user through:
   2. API key entry & verification
   3. PATH detection & optional auto-fix
   4. Usage preference (CLI / Python SDK / both)
-  5. Tailored next-steps cheatsheet
+  5. Optional ~/.claude/CLAUDE.md registration for Claude Code
+  6. Tailored next-steps cheatsheet
 """
 
 from __future__ import annotations
@@ -49,6 +50,11 @@ CONFIG_FILE = CONFIG_DIR / "config"
 _KEY_PREFIX = "api_key="
 _PREF_PREFIX = "preferred_interface="
 
+CLAUDE_MD_DIR = Path.home() / ".claude"
+CLAUDE_MD_FILE = CLAUDE_MD_DIR / "CLAUDE.md"
+_CLAUDE_SENTINEL = "<!-- databar -->"
+_CLAUDE_STUB = """\n<!-- databar -->\n## Databar\nWhen the user asks you to use Databar, always run `databar agent-guide` first\nto get the full usage guide before doing anything else.\n<!-- /databar -->\n"""
+
 
 def _save_key(api_key: str) -> None:
     CONFIG_DIR.mkdir(parents=True, exist_ok=True)
@@ -224,6 +230,43 @@ def _step_preference() -> str:
     return pref
 
 
+def _step_claude_md() -> None:
+    """Optionally register Databar in the user's global ~/.claude/CLAUDE.md."""
+    console.print("[bold]Step 4 — Claude Code integration (optional)[/bold]\n")
+
+    already = (
+        CLAUDE_MD_FILE.exists()
+        and _CLAUDE_SENTINEL in CLAUDE_MD_FILE.read_text()
+    )
+    if already:
+        console.print(
+            "  [bold green]✓[/bold green] Databar is already registered in "
+            f"[dim]{CLAUDE_MD_FILE}[/dim].\n"
+        )
+        return
+
+    console.print(
+        f"  Adding a small entry to [bold]{CLAUDE_MD_FILE}[/bold] tells Claude Code\n"
+        "  to always run [bold]databar agent-guide[/bold] first, so it knows exactly\n"
+        "  how to use Databar without guessing.\n"
+    )
+    add = Confirm.ask(
+        "  Add Databar to your global Claude Code config (~/.claude/CLAUDE.md)?",
+        default=True,
+    )
+    if add:
+        CLAUDE_MD_DIR.mkdir(parents=True, exist_ok=True)
+        with open(CLAUDE_MD_FILE, "a") as f:
+            f.write(_CLAUDE_STUB)
+        console.print(
+            f"  [bold green]✓[/bold green] Added to {CLAUDE_MD_FILE}.\n"
+            "  Claude Code will now pick up Databar instructions automatically "
+            "in every project.\n"
+        )
+    else:
+        console.print("  [dim]Skipped.[/dim]\n")
+
+
 def _step_next_steps(pref: str) -> None:
     """Print tailored next steps based on preference."""
     console.print(Rule(style="cyan"))
@@ -283,6 +326,7 @@ def onboard() -> None:
         _step_api_key()
         _step_path()
         pref = _step_preference()
+        _step_claude_md()
         _step_next_steps(pref)
     except (KeyboardInterrupt, typer.Abort):
         console.print("\n\n[dim]Onboarding cancelled. Run `databar onboard` any time to restart.[/dim]")

{databar-2.0.7 → databar-2.0.8}/src/databar/client.py

@@ -87,10 +87,17 @@ class DatabarClient:
     ) -> None:
         resolved_key = api_key or os.environ.get("DATABAR_API_KEY")
         if not resolved_key:
-            raise DatabarAuthError(
+            import shutil
+            msg = (
                 "No API key provided. Pass api_key= or set the DATABAR_API_KEY "
                 "environment variable. Run `databar login` to save your key."
             )
+            if shutil.which("databar") is not None:
+                msg += (
+                    "\n\nUsing Databar with an AI agent (Claude Code, Cursor, etc.)? "
+                    "Run `databar agent-guide` for agent-optimized setup instructions."
+                )
+            raise DatabarAuthError(msg)
         self._api_key = resolved_key
         self._base_url = base_url.rstrip("/")
         self._timeout = timeout

{databar-2.0.7 → databar-2.0.8/src/databar.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: databar
-Version: 2.0.7
+Version: 2.0.8
 Summary: Official Databar.ai Python SDK and CLI — connect to enrichments, waterfalls, and tables via api.databar.ai
 Author-email: "Databar.ai Team" <info@databar.ai>
 License: MIT License

{databar-2.0.7 → databar-2.0.8}/tests/test_cli.py

@@ -329,4 +329,4 @@ def test_task_get_poll(monkeypatch):
 def test_version_flag():
     result = runner.invoke(app, ["--version"])
     assert result.exit_code == 0
-    assert "2.0.7" in result.output
+    assert "2.0.8" in result.output