thoughtleaders-cli 0.7.2__py3-none-any.whl → 0.7.4__py3-none-any.whl

{thoughtleaders_cli-0.7.2.dist-info → thoughtleaders_cli-0.7.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: thoughtleaders-cli
-Version: 0.7.2
+Version: 0.7.4
 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

{thoughtleaders_cli-0.7.2.dist-info → thoughtleaders_cli-0.7.4.dist-info}/RECORD

@@ -1,4 +1,4 @@
-tl_cli/__init__.py,sha256=w380YYlqGtwTYG78LJyZu5ljV8MmIBzKLk-R9Kq8Apw,112
+tl_cli/__init__.py,sha256=xK0gP7uGAavYeHM3ixCoYhRg6AEnE_DI83z7_FnnInc,112
 tl_cli/_completions.py,sha256=kOyEUqC26vbYvyXWi513WX8fF73qQLR5WWuRSe_wqyk,164
 tl_cli/_typer_utils.py,sha256=ZiZsCVmEznPvBw-dYbr3tu3zWZ0iN6kjoQmK3gMqD28,860
 tl_cli/config.py,sha256=UV_OYTXuQnAIqbi_oVCXx0hhIdZWR678RRapVv51UwQ,1859
@@ -21,7 +21,7 @@ tl_cli/commands/balance.py,sha256=JHSmKdAUNtd-9zlKZhit9_BmhHXrEk0kQ-oSlQ0Eo6Y,27
 tl_cli/commands/brands.py,sha256=rvYRrhkDhHDlvFpWrf8TtGbBt8KyNxHcVodjjFNpmHY,12443
 tl_cli/commands/bulk_import.py,sha256=d4y1k_lD52LPJcCqXxEmyHIqcIwomZgbjqs1_QxPjeQ,4536
 tl_cli/commands/changelog.py,sha256=D1PtDdHpawTlWqUHjKzVmv9yXLSU915UVmI3dZzEwyA,4241
-tl_cli/commands/channels.py,sha256=EgwTzweKsQEerBTwiWGCP1myCTW3KQFu4Om2j4Htfzk,17217
+tl_cli/commands/channels.py,sha256=ALw2fgJL3w0dpYp3A41OECL0odenhSV16vFA7la7aQI,16878
 tl_cli/commands/credits.py,sha256=2xCht2e420LmaFBKNdKoMz8GlTh31qSWSlJAnVzoZic,7308
 tl_cli/commands/db.py,sha256=rdIQrxT7sdrPEnBbByNHvPr2X6iIg-wb19X9bWYwDRc,5053
 tl_cli/commands/deals.py,sha256=ZK9yneInsC6DXoCPS65oyLoVR0eRW1xdRlEN7oRp1pc,2174
@@ -30,7 +30,7 @@ tl_cli/commands/doctor.py,sha256=KUKglwhMc7B26XXy_3M0LkHu7wqfFO5T0YPHO1SH1VY,902
 tl_cli/commands/matches.py,sha256=K5o6B8FLECp7825dU4W3X8n-wuXvGJz57xpQPXeXQ-0,2886
 tl_cli/commands/proposals.py,sha256=khsjorluIfgrJ22DiwzIAFcYD4JbirjkOBz1KuQ0Sdk,2918
 tl_cli/commands/recommender.py,sha256=DIRvnSbV2TwvVUgA5luGJ7uQUOjHx2CULFsZVaqUYw4,18922
-tl_cli/commands/reports.py,sha256=1QDJN6FrUmWCuvaMxN884_bVdy-l7anBuS2jkCZF1VQ,22543
+tl_cli/commands/reports.py,sha256=WcZWtBVRX49z-1Fw4T5iq_xZqks3QmIXlWVg5iVGs58,26532
 tl_cli/commands/schema.py,sha256=GCBEE4fDatQhVasLKKr7bkGhELRZ0scYm_hUCbDYmuA,5985
 tl_cli/commands/setup.py,sha256=QST6DCSxJHLFNX1UUJHwZ3hTDTnySATaV2Tc2JsdYYY,21920
 tl_cli/commands/snapshots.py,sha256=mWxnZI_UBzbZZHsA3uP0Q7Gt2XsLLoRD5dRNGt-mGUE,3428
@@ -40,14 +40,14 @@ tl_cli/commands/whoami.py,sha256=aUXwBRwh1vAGrvz8CKGfHYtEOKJCIDfwrGesKAwYZMk,786
 tl_cli/output/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tl_cli/output/formatter.py,sha256=pqlKmb2nZ1Z2e1A9m8l5mgVemJinVAP4in1tUzFWHno,22522
 tl_cli/_plugin/.claude-plugin/marketplace.json,sha256=l56PMmyjfGXNGlV30wRyOAe74B6gJNCVNCxgsBbSNxc,446
-tl_cli/_plugin/.claude-plugin/plugin.json,sha256=_Im3uBChUbEhtgMa7p_Efg10yDoSSS0GtrAKAL_E6ME,466
+tl_cli/_plugin/.claude-plugin/plugin.json,sha256=8RBuXpnRetjlzB0k2KrWjRquy_KrutSRFcioWI6r1Lo,466
 tl_cli/_plugin/agents/tl-analyst.md,sha256=6J3X3NANkWg6OOUCvNirkN4ulIk80KSumPncDUBt75E,6761
 tl_cli/_plugin/agents/youtube-comment-classifier.md,sha256=S5lr_htA98FIX0su8FJ2ntiHfbdK8OB2NQKC4lTnQcw,2178
 tl_cli/_plugin/hooks/hooks.json,sha256=FSWibw1xAjA-suFV3fR8btIb2kQ82LQ08otTr-NpmFw,835
 tl_cli/_plugin/hooks/scripts/load-tl-skill.mjs,sha256=EBsyZ-caei-CBJsRtqzJXJs_20O3H22MuVmDpu96umo,805
 tl_cli/_plugin/hooks/scripts/post-usage.sh,sha256=WVvZLkZik6lbeZ20Kh-wgm4JkRFHFN0Uwl4C8S3Y0sY,759
 tl_cli/_plugin/hooks/scripts/pre-check.sh,sha256=E9KeuXy6yeHEBOnOFW4hDW-Et-Dbp1Oh--3WXKfOX78,898
-tl_cli/_plugin/skills/tl/SKILL.md,sha256=fKxHgoe0oX1vFwVFUTzF95h4fq5fAmFlodqZr7cdbeA,58174
+tl_cli/_plugin/skills/tl/SKILL.md,sha256=YDpZ3DtP_HjEfZtC17ELG9kk-OixRXNvRL7VWwrrMXI,59099
 tl_cli/_plugin/skills/tl/references/business-glossary.md,sha256=FCS-qBOGpdJCmHdglRGRjAuTQAtzpxJNpMkEWThuvlI,17779
 tl_cli/_plugin/skills/tl/references/elasticsearch-schema.md,sha256=OpHvixZ8UcZYJd8GdwgumryFyKwPAxj3AvPkl1QreMY,9316
 tl_cli/_plugin/skills/tl/references/firebolt-schema.md,sha256=KagpSWWEWIRfsAWz271PvAqVbSPvWLoogWhCA_XFSZw,10642
@@ -111,8 +111,8 @@ tl_cli/_plugin/skills/tl-top-partnerships/SKILL.md,sha256=hvH05hIaGlc0RfTE0GLBtD
 tl_cli/_plugin/skills/tl-top-partnerships/scripts/top_partnerships.py,sha256=_13W6-HuD_jtl7AWQQcZQ0SQO9qODMymlcL-1s4-VwU,13248
 tl_cli/_plugin/skills/tl-views-guarantee/SKILL.md,sha256=IH7q1WJDWri9TWJMiga1FMGJO_GKSbWwaDS6CVNZ9c0,9270
 tl_cli/_plugin/skills/tl-views-guarantee/scripts/vg.py,sha256=Qp5poinHEqh9374anq0bLtlxj2YL6ipBicaT960-Cws,15825
-thoughtleaders_cli-0.7.2.dist-info/METADATA,sha256=7BN2D4RB5Aq2zWM6krJwjpR6IAFOZczDvjnUeN67q0A,18452
-thoughtleaders_cli-0.7.2.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
-thoughtleaders_cli-0.7.2.dist-info/entry_points.txt,sha256=umZp-1BkGkHDG0bNZXpTXrjwW0HGf9IDFN40eAWuuvg,39
-thoughtleaders_cli-0.7.2.dist-info/licenses/LICENSE,sha256=RUfdfLsn6jygiyrnnVUHt6r4IPwr2rbDm9Kixgtu8fo,1071
-thoughtleaders_cli-0.7.2.dist-info/RECORD,,
+thoughtleaders_cli-0.7.4.dist-info/METADATA,sha256=MPMDYcGN8eGh3eYWdKN3mDoPGz8E5sijXa2c2FpOybI,18452
+thoughtleaders_cli-0.7.4.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+thoughtleaders_cli-0.7.4.dist-info/entry_points.txt,sha256=umZp-1BkGkHDG0bNZXpTXrjwW0HGf9IDFN40eAWuuvg,39
+thoughtleaders_cli-0.7.4.dist-info/licenses/LICENSE,sha256=RUfdfLsn6jygiyrnnVUHt6r4IPwr2rbDm9Kixgtu8fo,1071
+thoughtleaders_cli-0.7.4.dist-info/RECORD,,

tl_cli/__init__.py

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

tl_cli/_plugin/.claude-plugin/plugin.json

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

tl_cli/_plugin/skills/tl/SKILL.md

@@ -15,9 +15,9 @@ If doing a database query, follow this recipe:
 
 * First, run `tl whoami` to confirm the API is working and to find out user metadata and limits.
 * Always read `references/business-glossary.md`
-* If doing a PostgreSQL (pg) query: first read `references/postgres-schema.md`, then run `tl schema pg`
-* If doing an ElasticSearch (es) query: first read `references/elasticsearch-schema.md`, then run `tl schema es`
-* If doing a Firebolt (fb) query: first read `references/firebolt-schema.md`, then run `tl schema fb`
+* If doing a PostgreSQL (pg) query: always first read `references/postgres-schema.md`, then run `tl schema pg`
+* If doing an ElasticSearch (es) query: always first read `references/elasticsearch-schema.md`, then run `tl schema es`
+* If doing a Firebolt (fb) query: always first read `references/firebolt-schema.md`, then run `tl schema fb`
 
 **Process data with shell tools, not your context window.** Don't pull large result sets into your reasoning context just to filter, sort, count, or extract a field - that wastes tokens and slows you down. Pipe `tl … --json` (or `--csv`, or `--toon`) into `jq` (for JSON), `rg` or `duckdb` (for CSV), or `yq` (for YAML) as appropriate, and read only the answer back. Pick the tool by shape:
 
@@ -150,6 +150,8 @@ Unless the user specifically asks for running a specific report or showing the r
 
    If the user says yes (or uses any of the save-trigger phrases, like `save it`, `save the list`, `make a report`, `persist this`, `turn this into a campaign`, `I want to come back to this`), invoke the `tl-save-report` skill — it owns the filter-vs-list decision flow, the FilterSet mapping, and the `tl reports create` / `tl reports save-list` save call. **Don't try to compose the report config yourself**; hand off to the skill.
 
+   **When the user already has specific IDs in hand** — "make a report of these sponsorship IDs", "save these exact channels", or a curated set you just resolved — that is always a **list-style** report: pin the IDs with `tl reports save-list <entity> --ids-file` (or add them to an existing report with `tl bulk-import <entity> -c <report-id>`). **Never** route an explicit-ID request through `tl reports create "<natural-language prompt>"` — the prompt path builds *predicate filters* and pins none of those IDs, so the report comes back showing unrelated records, not the ones the user named. After creating it, confirm the report actually contains those records before sharing the link.
+
    Skip the save offer when the result clearly doesn't fit a report type — a single scalar count, an aggregate roll-up across entity types, view-curve time series, schema introspection output, or anything that isn't a list of channels / brands / videos / sponsorships. A trailing offer on those would just be noise.
 
 Prefer writing shell code, `jq` commands, or `duckdb` commands that fetch or analysise large sets of data instead of analysing it yourself. On Mac and Linux, create temporary files in `/tmp` that can be analysed later in different ways. On Windows, create them in the directory pointed to by the `%TEMP%` environment variable. When coding, do it in Python.
@@ -765,7 +767,7 @@ tl channels similar 29834 msn:no --limit 30                  # non-MSN channels
 tl channels similar 29834 tpp:yes --limit 30                 # TPP (TL-managed) channels only
 tl channels similar 29834 min-subs:1000000 exclude:477487 --limit 15  # client-side filters
 ```
-**Both `tl channels show` and `tl channels similar` accept either a numeric channel ID or a channel name.** Name arguments are case-insensitive partial matches; if more than one active channel matches, the command prints a candidates table (channel_id, subscribers, name) and exits 1 so you can retry with a specific ID. The `msn` filter on `similar` is tri-state: `yes` (only MSN channels — the default), `no` (only non-MSN channels), `both` (no MSN filter). `tl channels look-alike` is a hidden alias for `similar` that matches the internal "look-alike channels" terminology.
+**Both `tl channels show` and `tl channels similar` accept either a numeric channel ID or a channel name.** Name arguments are case-insensitive partial matches; if more than one active channel matches, the command prints a candidates table (channel_id, subscribers, name) and exits 1 so you can retry with a specific ID. The `msn` filter on `similar` is tri-state: `yes` (only MSN channels — the default), `no` (only non-MSN channels), `both` (no MSN filter). `tl channels look-alike` is a hidden alias for `similar` that matches the internal "look-alike channels" terminology. `tl channels show` returns a `tl_url` field — the canonical ThoughtLeaders web-app analysis page for the channel; use it verbatim when linking a user to the channel instead of constructing a URL by hand.
 
 ### "Browse the recommender" (categories, demographics, formats):
 ```bash

tl_cli/commands/channels.py

@@ -64,14 +64,6 @@ def show_cmd(
     client = get_client()
     try:
         data = client.get(f"/channels/{encoded_ref}")
-        for i, r in enumerate(data.get("results", []) if isinstance(data.get("results"), list) else []):
-            renamed = {}
-            for k, v in r.items():
-                if k == "id":
-                    renamed["channel_id"] = v
-                else:
-                    renamed[k] = v
-            data["results"][i] = renamed
         output_single(data, fmt)
         if fmt == "table" and data.get("show_cta"):
             record = data.get("results", data)

tl_cli/commands/reports.py

@@ -22,6 +22,71 @@ REPORT_TYPE_LABELS = {1: "Content", 2: "Brands", 3: "Channels", 8: "Sponsorships
 
 POLL_INTERVAL = 2  # seconds between server polls
 
+# Filterset keys that pin specific entities into a report (the curated-ID
+# lists). A report built from these holds exactly those records; a report built
+# from predicate filters re-evaluates against live data and pins nothing.
+_PIN_ENTITIES = ("channels", "brands", "sponsorships", "articles")
+# Filterset keys that are structural, not user-facing predicate filters.
+_NON_PREDICATE_KEYS = {"keyword_operator", "sort"}
+
+
+def _summarize_report_contents(config: dict) -> dict:
+    """Summarize what a saved report config actually contains.
+
+    Returns the report-type label, a per-entity count of *pinned* IDs (the
+    curated lists that freeze specific channels/brands/sponsorships/articles
+    into the report), and the active predicate-filter keys. Lets a caller —
+    human or agent — catch a filters-vs-pinned-IDs mismatch (or a wholly blank
+    report) before sharing the link: a report built from a natural-language
+    prompt yields predicate filters and pins *nothing*, so "pinned: none" is
+    the tell that it doesn't contain the specific records the user named.
+    """
+    filterset = config.get("filterset") or {}
+    pinned = {
+        entity: len(filterset[entity])
+        for entity in _PIN_ENTITIES
+        if isinstance(filterset.get(entity), list) and filterset[entity]
+    }
+    skip = set(_PIN_ENTITIES) | {f"exclude_{e}" for e in _PIN_ENTITIES} | _NON_PREDICATE_KEYS
+    filters = sorted(
+        key
+        for key, value in filterset.items()
+        if key not in skip and value not in (None, "", [], {}, False)
+    )
+    return {
+        "report_type": REPORT_TYPE_LABELS.get(config.get("report_type"), config.get("report_type")),
+        "pinned": pinned,
+        "filters": filters,
+    }
+
+
+def _render_contents_line(summary: dict) -> str:
+    """One-line human rendering of a `_summarize_report_contents` result."""
+    pinned = summary.get("pinned") or {}
+    pin_str = ", ".join(f"{count} {entity}" for entity, count in pinned.items()) if pinned else "none"
+    filters = summary.get("filters") or []
+    filt_str = ", ".join(filters) if filters else "none"
+    return f"Contents: {summary.get('report_type')} report · pinned: {pin_str} · filters: {filt_str}"
+
+
+def _print_contents_summary(summary: dict) -> None:
+    """Surface a saved report's contents on stderr (safe in every output mode).
+
+    A report with no pinned entities *and* no filters gets a loud warning —
+    that blank/default state is the failure behind "you sent me an empty
+    report". Otherwise a dim one-liner lets the caller confirm the report holds
+    what the user actually asked for.
+    """
+    line = _render_contents_line(summary)
+    if not summary.get("pinned") and not summary.get("filters"):
+        err.print(
+            f"[yellow]⚠ {line}\n"
+            f"  This report has no filters and no pinned entities — it will show "
+            f"a blank/default view.[/yellow]"
+        )
+    else:
+        err.print(f"[dim]{line}[/dim]")
+
 
 @app.callback(invoke_without_command=True)
 def reports(
@@ -330,6 +395,13 @@ def create_report(
     With a prompt, runs the AI Report Builder pipeline (keyword research, config
     generation, review) and saves the resulting campaign.
 
+    Have specific IDs already? A report of *exactly* the channels / brands /
+    sponsorships / articles you already have the IDs for is a different job —
+    use `tl reports save-list <entity> --ids-file` to pin those IDs into a new
+    report, or `tl bulk-import <entity> -c <report-id>` to add them to an
+    existing one. A natural-language prompt here builds *predicate filters* and
+    pins none of those IDs, so the report comes back showing unrelated records.
+
     With --config '<json>' or --config-file <path>, skips the orchestration
     pipeline and saves the provided config directly. Useful when an external
     agent (e.g. the tl-report-builder Claude Code skill) has already produced a
@@ -404,6 +476,13 @@ def create_report(
         report_url = result.get("report_url", "")
         campaign_id = result.get("campaign_id", "")
 
+        # Echo what the report actually contains. Surfaced even under
+        # --yes/--json (the agent path), so a report built from a prompt —
+        # which yields predicate filters and pins no specific IDs — can be
+        # spotted before its link is shared.
+        summary = _summarize_report_contents(config)
+        data["report_contents"] = summary
+
         if toon_output:
             print(toon_encode(data))
         elif json_output:
@@ -422,6 +501,8 @@ def create_report(
             if usage:
                 err.print(f"\n  [dim]{usage.get('credits_charged', 0)} credits · {usage.get('balance_remaining', '?')} remaining[/dim]")
 
+        _print_contents_summary(summary)
+
     except ApiError as e:
         handle_api_error(e)
     finally:
@@ -541,23 +622,26 @@ def save_list_cmd(
     finally:
         client.close()
 
+    summary = _summarize_report_contents(config)
+    data["report_contents"] = summary
+
     if fmt == "toon":
         print(toon_encode(data))
-        return
-    if fmt == "json":
+    elif fmt == "json":
         print(json.dumps(data, indent=2, default=str))
-        return
+    else:
+        results = data.get("results", [{}])
+        result = results[0] if results else {}
+        err.print()
+        err.print("[green bold]Report created![/green bold]")
+        err.print(f"  Campaign ID: {result.get('campaign_id', '?')}")
+        err.print(f"  URL: https://app.thoughtleaders.io{result.get('report_url', '')}")
+        err.print(
+            "\n[dim]Refine columns, widgets, title, or description with "
+            "`tl reports update <id>`.[/dim]"
+        )
 
-    results = data.get("results", [{}])
-    result = results[0] if results else {}
-    err.print()
-    err.print("[green bold]Report created![/green bold]")
-    err.print(f"  Campaign ID: {result.get('campaign_id', '?')}")
-    err.print(f"  URL: https://app.thoughtleaders.io{result.get('report_url', '')}")
-    err.print(
-        "\n[dim]Refine columns, widgets, title, or description with "
-        "`tl reports update <id>`.[/dim]"
-    )
+    _print_contents_summary(summary)
 
 
 @app.command("update")