thoughtleaders-cli 0.6.19__tar.gz → 0.6.20__tar.gz

{thoughtleaders_cli-0.6.19 → thoughtleaders_cli-0.6.20}/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "tl-cli",
-  "version": "0.6.19",
+  "version": "0.6.20",
   "description": "ThoughtLeaders CLI — query sponsorship deals, channels, brands, uploads, and intelligence from the terminal",
   "author": {
     "name": "ThoughtLeaders",

{thoughtleaders_cli-0.6.19 → thoughtleaders_cli-0.6.20}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: thoughtleaders-cli
-Version: 0.6.19
+Version: 0.6.20
 Summary: ThoughtLeaders CLI — query sponsorship data, channels, brands, and intelligence
 Project-URL: Homepage, https://thoughtleaders.io
 Project-URL: Repository, https://github.com/ThoughtLeaders-io/thoughtleaders-cli
@@ -20,6 +20,7 @@ Requires-Python: >=3.12
 Requires-Dist: authlib>=1.3
 Requires-Dist: httpx>=0.27
 Requires-Dist: keyring>=25.0
+Requires-Dist: pyyaml>=6.0
 Requires-Dist: rich>=13.0
 Requires-Dist: toon-format==0.9.0b1
 Requires-Dist: typer>=0.16

{thoughtleaders_cli-0.6.19 → thoughtleaders_cli-0.6.20}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "thoughtleaders-cli"
-version = "0.6.19"
+version = "0.6.20"
 description = "ThoughtLeaders CLI — query sponsorship data, channels, brands, and intelligence"
 readme = "README.md"
 license = "MIT"
@@ -36,6 +36,7 @@ dependencies = [
     # the beta, but uv refuses pre-releases under `>=` when a stable exists.
     # An exact pin is the one form uv will resolve without `--prerelease=allow`.
     "toon-format==0.9.0b1",
+    "pyyaml>=6.0",
 ]
 
 [project.scripts]

{thoughtleaders_cli-0.6.19 → thoughtleaders_cli-0.6.20}/src/tl_cli/__init__.py

@@ -1,3 +1,3 @@
 """ThoughtLeaders CLI — query sponsorship data, channels, brands, and intelligence."""
 
-__version__ = "0.6.19"
+__version__ = "0.6.20"

{thoughtleaders_cli-0.6.19 → thoughtleaders_cli-0.6.20}/src/tl_cli/commands/schema.py

@@ -1,10 +1,14 @@
 """tl schema — Show raw-db schema documentation for `tl db pg|fb|es`."""
 
 import json
+import re
 
 import typer
+import yaml
 from rich.console import Console
 from rich.markdown import Markdown
+from rich.text import Text
+from rich.tree import Tree
 
 from tl_cli.client.errors import ApiError, handle_api_error
 from tl_cli.client.http import get_client
@@ -12,6 +16,68 @@ from tl_cli.client.http import get_client
 app = typer.Typer(help="Show schema documentation for raw db queries (`tl db pg|fb|es`)")
 console = Console()
 
+# Pulls the YAML body out of the server's ```yaml … ``` fenced block. Any
+# non-YAML preface (e.g. error / empty-set markdown) won't match and is
+# rendered through the markdown fallback path.
+_YAML_FENCE_RE = re.compile(r'```yaml\n(.*?)\n```', re.DOTALL)
+
+
+def _try_render_yaml_tree(content: str) -> bool:
+    """Render the YAML schema as a Rich Tree, one tree per table.
+
+    Returns True if rendering succeeded. Returns False on any failure
+    (no fence, parse error, unexpected shape) so the caller falls back
+    to plain markdown rendering.
+    """
+    match = _YAML_FENCE_RE.search(content)
+    if not match:
+        return False
+    try:
+        data = yaml.safe_load(match.group(1))
+    except yaml.YAMLError:
+        return False
+    if not isinstance(data, dict) or not data:
+        return False
+
+    rendered = False
+    for table_name, fields in data.items():
+        if not isinstance(fields, dict):
+            continue
+        rendered = True
+
+        # Table-level metadata sits alongside columns under `__`-prefixed
+        # keys; surface them in the tree label, never as children.
+        table_comment = fields.get('__comment')
+        primary_index = fields.get('__primary_index')
+        label = Text()
+        label.append(str(table_name), style='bold cyan')
+        if table_comment:
+            label.append(f'  — {table_comment}', style='italic dim')
+        if primary_index:
+            label.append(f'  — primary index {primary_index}', style='italic dim')
+
+        tree = Tree(label, guide_style='dim')
+        for fname, fval in fields.items():
+            if isinstance(fname, str) and fname.startswith('__'):
+                continue
+            if isinstance(fval, dict):
+                ftype = str(fval.get('type', '?'))
+                fcomment = fval.get('comment')
+            else:
+                ftype = str(fval)
+                fcomment = None
+            line = Text()
+            line.append(str(fname), style='yellow')
+            line.append(': ')
+            line.append(ftype, style='green')
+            if fcomment:
+                line.append(f'  — {fcomment}', style='dim')
+            tree.add(line)
+        console.print(tree)
+        console.print()
+
+    return rendered
+
 
 def _show(db: str, json_output: bool, table: str | None = None) -> None:
     client = get_client()
@@ -23,6 +89,12 @@ def _show(db: str, json_output: bool, table: str | None = None) -> None:
             return
         content = data.get("content", "")
         if console.is_terminal:
+            # PG/FB output is a fenced YAML mapping; render as a Rich Tree
+            # for terminals. ES is still markdown prose, and error / empty
+            # responses also have no fence — both fall through to the
+            # markdown renderer.
+            if db in ("pg", "fb") and _try_render_yaml_tree(content):
+                return
             console.print(Markdown(content))
         else:
             print(content)