thoughtleaders-cli 0.9.22__tar.gz → 0.9.23__tar.gz

{thoughtleaders_cli-0.9.22 → thoughtleaders_cli-0.9.23}/.claude-plugin/plugin.json

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

{thoughtleaders_cli-0.9.22 → thoughtleaders_cli-0.9.23}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: thoughtleaders-cli
-Version: 0.9.22
+Version: 0.9.23
 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.9.22 → thoughtleaders_cli-0.9.23}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "thoughtleaders-cli"
-version = "0.9.22"
+version = "0.9.23"
 description = "ThoughtLeaders CLI — query sponsorship data, channels, brands, and intelligence"
 readme = "README.md"
 license = "MIT"

{thoughtleaders_cli-0.9.22 → thoughtleaders_cli-0.9.23}/skills/tl/SKILL.md

@@ -95,7 +95,7 @@ Other key concepts:
   - Org scoping for sponsorships is profile-mediated: a sponsorship belongs to your org if **either** `advertiser_profile.organization` (brand side) **or** the adspot seller's organization — `ad_spot.publisher` → that user's profile → `organization` (publisher side) — matches yours. Representing the channel does not surface its deals.
 - **MSN** (Media Selling Network) — the ~12k YouTube channels that have opted in to receive sponsorship offers. A channels is in the MSN group if the `channel.media_selling_network_join_date` field is not null.
 - **MBN** (Media Buying Network) — the brand-side counterpart to MSN: brand profiles that have opted in to receive proposed sponsorships. A profile is in the MBN group if the `profile.media_buying_network_join_date` field is not null.
-- **TPP** (ThoughtLeaders Partner Program, a.k.a. "TL channels") — the ~170 channels TL has the closest working relationship with. A channel is in the TPP group if `channel.is_tpp` is True. **Prefer TPP channels when booking**: they respond fastest, are the easiest to close, and don't need an outreach round-trip — treat them as immediately bookable. TPP is a strict subset of MSN, so the same booking rules (one active mention adspot, etc.) apply.
+- **TPP** (ThoughtLeaders Partner Program, a.k.a. "TL channels") — the ~170 channels TL has the closest working relationship with. A channel is in the TPP group if `channel.is_tpp` is True. **Prefer TPP channels when booking**: they respond fastest, are the easiest to close, and don't need an outreach round-trip — treat them as immediately bookable. TPP is a strict subset of MSN, so the same booking rules (one preferred mention adspot, etc.) apply.
 - **`demographics_updated_at`** (on channels) — If non-null, the channel has demographics screenshots on file. If null, no demographics screenshots have been uploaded. Use this to check whether a channel has demographics data from screenshots.
 - **`subscribers`** (on channels) — the channel's subscriber count.
 - **`projected_views`** (on channels) — projected views per video on that channel. Forward-looking estimate. May be null when not yet computed. ⚠️ NOT actual views and NOT ad-industry "impressions" (ads served).
@@ -103,7 +103,7 @@ Other key concepts:
 - **`views_guarantee`** (on sponsorships) — projected/guaranteed impressions for the sponsorship. Numeric.
 - **Sponsorship detail fields** (returned by `tl sponsorships show <id> --json`) — the detail payload includes `integration` (raw int), `publish_count`, `common_name`, `outreach_email`, nested `publisher` (`first_name`, `last_name`, `email`), nested `brand_contact` (`first_name`, `last_name`, `email`), and `brand.organization_name`. Use these when generating IOs, contracts, or outreach.
 - **CPM** has two distinct meanings depending on level — pick the one the user actually wants:
-  - **Channel CPM** = `(adspot.price / channel.projected_views) * 1000` — projected price per thousand projected views. Used for pricing decisions **before** a sponsorship is sold. Available for channels with active adspots via `tl channels show <channel_id>`.
+  - **Channel CPM** = `(adspot.price / channel.projected_views) * 1000` — projected price per thousand projected views. Used for pricing decisions **before** a sponsorship is sold. Available for channels with preferred adspots via `tl channels show <channel_id>`.
   - **Sponsorship CPM** = calculated in either of two ways: if `views` is present, then CPM is `(sponsorship.price / sponsorship.views) × 1000`, meaning realized cost per thousand actual views, computed post-publication. If `views` is null, Compute from the sponsorship's `price` and the channel's `projected_views` fields.
   - Where possible, calculate the correct CPM in a SQL expression.
 - **Sponsorship dates** — each sponsorship has four distinct dates, useful for different queries:

{thoughtleaders_cli-0.9.22 → thoughtleaders_cli-0.9.23}/skills/tl/references/business-glossary.md

@@ -56,7 +56,7 @@ Maps business terms to database concepts.
 - A channel can have **multiple ad spots** because different people sell the same channel (talent manager, direct, multiple agencies)
 - Ad spots are the **catalogue** — adlinks are **instances** of catalogue items
 - Price/cost on adspot = list/catalog values; price/cost on adlink = actual deal values
-- **Only one active adspot with integration=mention per channel at any time** (MSN rule)
+- **Only one preferred adspot with integration=mention per channel at any time** (MSN rule)
 
 ## Ownership & Accountability
 
@@ -79,7 +79,7 @@ Maps business terms to database concepts.
 - Key data: **who is the contact** to buy the ad from
 - `thoughtleaders_channel.media_selling_network_join_date` = when channel joined MSN
 - `thoughtleaders_channel.is_tpp` = TPP channel — TL's closest partners, a strict subset of MSN. **Prefer when booking**: fastest response, easiest to close. Not a gating flag; not a process barrier.
-- **Rule:** Only one active adspot with `integration=mention` per channel at any time
+- **Rule:** Only one preferred adspot with `integration=mention` per channel at any time
 - MSN quality depends on having current, accurate contact info
 
 ## Channels & Audience

{thoughtleaders_cli-0.9.22 → thoughtleaders_cli-0.9.23}/skills/tl/references/postgres-schema.md

@@ -165,8 +165,9 @@ A channel can have multiple adspots (different sellers: talent manager, direct,
 | `channel_id` | int FK | → `thoughtleaders_channel.id` |
 | `price` | numeric | List/catalogue price |
 | `cost` | numeric | List/catalogue cost |
-| `integration` | int | 1=YouTube Mentions (live reads). Only one active mention-type adspot per channel. |
-| `is_active` | boolean | Active flag |
+| `integration` | int | 1=YouTube Mentions (live reads). Only one preferred mention-type adspot per channel. |
+| `is_preferred` | boolean | The channel's preferred spot, the one new proposals are booked on |
+| `is_active` | boolean | False = deactivated, unusable, kept only for its AdLinks. Client sandboxes never show deactivated spots or their AdLinks |
 | `publisher_id` | int FK | → `auth_user.id` (NOT `thoughtleaders_profile.id` — see gotcha below) |
 
 ### Key columns for the `thoughtleaders_channel` table

{thoughtleaders_cli-0.9.22 → thoughtleaders_cli-0.9.23}/skills/tl-save-report/references/sortable_columns.json

@@ -41,7 +41,7 @@
     {"name": "Avg. Comments", "backend_code": "comments_avg", "sortability": "both", "description": "Average comments per YouTube video."},
     {"name": "Median Evergreenness", "backend_code": "evergreenness_median", "sortability": "both", "description": "Median evergreenness for the channel."},
     {"name": "Avg. Evergreenness", "backend_code": "evergreenness_avg", "sortability": "both", "description": "Average evergreenness for the channel."},
-    {"name": "Latest AdSpot Price", "backend_code": "latest_adspot_price", "sortability": "both", "description": "Price from the latest active AdSpot."},
+    {"name": "Latest AdSpot Price", "backend_code": "latest_adspot_price", "sortability": "both", "description": "Price from the latest preferred AdSpot."},
     {"name": "Subscribers", "backend_code": "subscribers", "sortability": "both", "description": "Channel subscriber count."},
     {"name": "Projected Views", "backend_code": "projected_views", "sortability": "both", "description": "Projected views for the channel's next video."},
     {"name": "Trend", "backend_code": "trend", "sortability": "both", "description": "Growth trend score — higher means faster-growing channel."}

{thoughtleaders_cli-0.9.22 → thoughtleaders_cli-0.9.23}/src/tl_cli/__init__.py

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

{thoughtleaders_cli-0.9.22 → thoughtleaders_cli-0.9.23}/src/tl_cli/commands/channels.py

@@ -71,7 +71,7 @@ def show_cmd(
     csv_output: bool = typer.Option(False, "--csv", help="CSV output (flattens adspots: one row per adspot)"),
     toon_output: bool = typer.Option(False, "--toon", help="TOON output (token-efficient for LLMs)"),
 ) -> None:
-    """Show channel detail by ID or name (includes active adspots).
+    """Show channel detail by ID or name (includes preferred adspots).
 
     Accepts either a numeric channel ID or a partial name. Names that
     match more than one active channel return a 400 with the candidate

{thoughtleaders_cli-0.9.22 → thoughtleaders_cli-0.9.23}/uv.lock

@@ -422,7 +422,7 @@ wheels = [
 
 [[package]]
 name = "thoughtleaders-cli"
-version = "0.9.22"
+version = "0.9.23"
 source = { editable = "." }
 dependencies = [
     { name = "authlib" },