thoughtleaders-cli 0.6.9__tar.gz → 0.6.11__tar.gz

{thoughtleaders_cli-0.6.9 → thoughtleaders_cli-0.6.11}/.claude-plugin/plugin.json

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

{thoughtleaders_cli-0.6.9 → thoughtleaders_cli-0.6.11}/AGENTS.md

@@ -95,6 +95,7 @@ The version string is defined in three files and all three must be updated toget
 ## Coding
 
 * Do not reference internal architecture of the ThoughtLeaders app in comments or skills. Specifially: do not reference internal table names, field names, API endpoints, Python modules or functions (including the sanitizer).
+* Do not let server implementation details into skill files (anything under `skills/`). Skills describe *what the CLI does* from the user's seat — observable command surface, inputs, outputs, examples. Do not say "the server enforces X", "the API validates Y on its side", "the backend rejects Z" — those are mechanism notes that drift the moment the server changes. State the user-visible behaviour ("unknown keys come back as 400") without naming where it's enforced.
 * Place all imports at the start of the Python module file
 
 # Git commit rules

{thoughtleaders_cli-0.6.9 → thoughtleaders_cli-0.6.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: thoughtleaders-cli
-Version: 0.6.9
+Version: 0.6.11
 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
@@ -125,9 +125,10 @@ tl brands show Nike
 # Run a saved report
 tl reports run 42
 
-# Comments on a sponsorship
-tl comments list 12345
-tl comments add 12345 "Looks good"
+# Comments — available on sponsorships, channels, brands, and uploads
+tl sponsorships comment-list 12345
+tl sponsorships comment-add 12345 "Looks good"
+tl channels comment-add 7890 "Strong recent winners"
 
 # Show information about the logged-in user
 tl whoami

{thoughtleaders_cli-0.6.9 → thoughtleaders_cli-0.6.11}/README.md

@@ -98,9 +98,10 @@ tl brands show Nike
 # Run a saved report
 tl reports run 42
 
-# Comments on a sponsorship
-tl comments list 12345
-tl comments add 12345 "Looks good"
+# Comments — available on sponsorships, channels, brands, and uploads
+tl sponsorships comment-list 12345
+tl sponsorships comment-add 12345 "Looks good"
+tl channels comment-add 7890 "Strong recent winners"
 
 # Show information about the logged-in user
 tl whoami

{thoughtleaders_cli-0.6.9 → thoughtleaders_cli-0.6.11}/agents/tl-analyst.md

@@ -64,7 +64,7 @@ tl db pg "SELECT a.id, a.send_date, a.publish_status, b.name AS brand, ch.channe
           ORDER BY a.send_date
           LIMIT 100 OFFSET 0"
 ```
-Then suggest `tl comments add <id> "..."` for each.
+Then suggest `tl sponsorships comment-add <id> "..."` for each.
 
 ### Multi-step research (mix raw + similarity)
 "Find channels similar to the ones Nike sponsors and compare their pricing"

{thoughtleaders_cli-0.6.9 → thoughtleaders_cli-0.6.11}/docs/architecture.md

@@ -56,8 +56,9 @@ All data commands use explicit subcommands: `list`, `show`, `create`/`add`. Runn
 | `tl brands similar <brand>` | Find similar brands (similarity search, 25 credits) |
 | `tl snapshots channel <id>` | Channel metrics over time (Firebolt channel_metrics) |
 | `tl snapshots video <id> --channel <id>` | Video view curve (Firebolt article_metrics, --channel required) |
-| `tl comments list <adlink-id>` | List comments on a sponsorship (free) |
-| `tl comments add <adlink-id> "message"` | Add a comment (free) |
+| `tl <entity> comment-list <id>` | List comments on a sponsorship/channel/brand/upload (free) |
+| `tl <entity> comment-add <id> "message"` | Add a comment (free) |
+| `tl <entity> comment-edit <comment-id> "message"` | Edit one of your own comments (author or superuser; free) |
 
 ### Raw database access (escape hatch for joins / aggregations / complex filters)
 
@@ -180,7 +181,7 @@ tools: [Bash, Read]
 
 What the agent does:
 - **Multi-step research**: "Find channels similar to the ones Nike sponsors and compare their pricing" → `tl brands show Nike --json` → extract initial channel IDs → `tl channels similar <initial-id> --json` for each (enriched with cpm) → union + dedupe → compile comparison table
-- **Cross-resource analysis**: "Show me deal slippage and add comments" → `tl sponsorships status:pending send-date-end:2026-03 --json` → identify slipping sponsorships → `tl comments add <id> "flagged for slippage"` for each
+- **Cross-resource analysis**: "Show me deal slippage and add comments" → `tl sponsorships status:pending send-date-end:2026-03 --json` → identify slipping sponsorships → `tl sponsorships comment-add <id> "flagged for slippage"` for each
 - **Report comparison**: "Compare my Q1 report to Q4" → `tl reports run <id> --since 2026-01 --until 2026-03 --json` → `tl reports run <id> --since 2025-10 --until 2025-12 --json` → synthesize
 - **Discovery workflows**: "What's my best performing brand this quarter" → `tl sponsorships status:sold purchase-date-start:2026-01 --json` → aggregate by brand → `tl brands show <top_brand> --json` → full picture
 - **Credit-aware**: checks balance before multi-query workflows, estimates total cost, asks user to confirm if expensive
@@ -315,7 +316,7 @@ tl-cli/
 │   │   ├── brands.py                 # tl brands (show/history/similar)
 │   │   ├── snapshots.py              # tl snapshots (Firebolt metrics)
 │   │   ├── reports.py                # tl reports / tl reports run
-│   │   ├── comments.py               # tl comments (list/add)
+│   │   ├── _comments_common.py       # comment-list/add/edit subcommands shared across entity apps
 │   │   ├── db.py                     # tl db pg|fb|es (raw read-only queries)
 │   │   ├── schema.py                 # tl schema pg|fb|es (live schema docs)
 │   │   ├── describe.py               # tl describe list/show (schema/filter/pricing discovery)
@@ -394,8 +395,9 @@ Most CLI endpoints can reuse existing views/utilities rather than being built fr
 | **`GET /api/cli/v1/snapshots/video/<id>`** | `api/v2/article-history` (`ArticleHistoryView`) — already queries Firebolt `article_metrics` with pagination, enforces `channel_id:article_id` format. | Direct reuse — already enforces channel_id requirement |
 | **`GET /api/cli/v1/reports`** | `api/campaigns` (`CampaignViewSet.list`) — returns user's saved campaigns with ownership filtering | Filter to user's campaigns, add CLI envelope |
 | **`GET /api/cli/v1/reports/<id>/run`** | `api/campaigns/<id>` detail + the view's existing data loading via `load_campaign_data()` in `data_api_utils.py` — campaigns store their filter config, which gets passed to the appropriate data view (SponsorshipsView, ArticlesView, ThoughtleadersView) | Load campaign config → dispatch to appropriate existing view → wrap results |
-| **`GET /api/cli/v1/comments/<adlink_id>`** | `api/comments/adlink/<id>` (`CommentsView` GET) — already paginated with read status | Add CLI envelope |
-| **`POST /api/cli/v1/comments/<adlink_id>`** | `api/comments/adlink/<id>` (`CommentsView` POST) — creates comment | Pass through |
+| **`GET /api/cli/v1/<entity_type>/<entity_id>/comments`** | Same query against the `Comment` table; entity_type ∈ {sponsorship, channel, brand, upload} | List comments scoped to caller's organization |
+| **`POST /api/cli/v1/<entity_type>/<entity_id>/comments`** | Insert into `Comment` with the matching FK column | Create comment for the named entity |
+| **`PATCH /api/cli/v1/comment/<comment_id>`** | Update `Comment.content` after author/superuser check | Edit a single comment by ID |
 | **`GET /api/cli/v1/whoami`** | New — reads Profile, Organization, brands M2M | New (joins Profile → User, Organization → Plan, Profile.brands → ChannelList) |
 | **`GET /api/cli/v1/balance`** | New — reads `CliCreditAccount` | New (simple model read) |
 | **`GET /api/cli/v1/describe`** | New — static metadata | New (hardcoded resource definitions) |
@@ -563,7 +565,7 @@ Build each command + its server endpoint together:
 11. `tl snapshots video abc --channel 12345` returns view curve
 12. `tl reports` lists saved reports (free)
 13. `tl reports run 789` executes saved report (credits based on results)
-14. `tl comments list 12345` lists comments (free)
+14. `tl sponsorships comment-list 12345` lists comments (free) — same shape under `tl channels`, `tl brands`, `tl uploads`
 15. `tl sponsorships create --channel 1 --brand 2` creates proposal (free)
 16. `tl setup claude` installs plugin
 17. Claude Code skill triggers on data questions, uses `tl describe` for discovery

{thoughtleaders_cli-0.6.9 → thoughtleaders_cli-0.6.11}/pyproject.toml

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

{thoughtleaders_cli-0.6.9 → thoughtleaders_cli-0.6.11}/skills/tl/SKILL.md

@@ -141,7 +141,7 @@ Prefer writing Python code, shell code, or `jq` commands that fetche or analysis
 tl sponsorships list [filters...]      # Sponsorships — list curve, mult 1.0
 tl sponsorships show <id>              # Sponsorship detail (2 credits)
 tl sponsorships create --channel <id> --brand <id>  # Create proposal (free)
-tl sponsorships update <id> '<json>'   # Update whitelisted fields (2 credits) — only `publish_status` editable; non-full-access users can only edit sponsorships in their own org
+tl sponsorships update <id> '<json>'   # Update a sponsorship (2 credits)
 tl deals list [filters...]             # Shortcut: agreed-upon sponsorships (status:deal); same curve as sponsorships list
 tl deals show <id>                     # Deal detail (2 credits)
 tl matches list [filters...]           # Shortcut: possible brand-channel pairings (status:match); same curve
@@ -153,7 +153,7 @@ tl proposals create --channel <id> --brand <id>  # Create proposal (free)
 tl uploads list [filters...]           # Video uploads from ES — list curve, mult 1.0
 tl uploads show <id>                   # Upload detail (2 credits)
 tl channels show <id-or-name>          # Channel detail (2 credits; accepts numeric ID or name) — for channel search use raw SQL on thoughtleaders_channel
-tl channels update <id> '<json>'       # Update whitelisted demographic fields (2 credits; full-access only)
+tl channels update <id> '<json>'       # Update a channel (2 credits)
 tl channels history <id-or-name>       # Sponsorship history (5 credits/result, linear)
 tl channels similar <id-or-name>       # Similarity recommender (25 credits flat; Intelligence plan)
 tl brands show <id-or-name>            # Brand detail (1 credit)
@@ -169,40 +169,24 @@ tl recommender top-brands "<tag>"      # Top brands (deduped from profiles) load
 tl recommender inspect-channel <ref>   # Show a channel's similarity-profile breakdown (25 credits; Intelligence)
 tl recommender inspect-brand <ref>     # Show a brand profile's ideal similarity-profile breakdown (25 credits; Intelligence)
 tl recommender similar-to-profile <id> # Channels closest to a brand profile's ideal profile (25 credits; Intelligence)
-tl snapshots channel <id>              # Channel metrics over time — list curve, mult 1.2 (Firebolt-backed)
-tl snapshots video <id> --channel <id> # Video view curve — list curve, mult 1.2 (--channel required!)
-tl reports                             # List saved reports — list curve, mult 1.3
+tl snapshots channel <id>              # Channel metrics over time (Firebolt-backed)
+tl snapshots video <id> --channel <id> # Video view curve (--channel required!)
+tl reports                             # List saved reports
 tl reports run <id>                    # Run a saved report (credits vary)
-tl comments list <adlink-id>           # List comments — list curve, mult 1.0
-tl comments add <adlink-id> "msg"      # Add comment (free)
+tl <entity> comment-list <id>          # List comments on a sponsorship/channel/brand/upload
+tl <entity> comment-add <id> "msg"     # Add a comment (free)
+tl <entity> comment-edit <comment-id> "msg"  # Edit own comment (author or superuser; free)
 ```
 
-**"List curve"** above means non-linear pricing: `cost = 1 + mult × 0.126 × n^1.2`. The flat 1-credit setup applies to every list call; the `mult` reflects per-resource complexity. `tl db {pg,fb,es}` shares the same curve at mult=1.4. Concrete totals:
-
-| Rows | mult=1.0 (comments, uploads, sponsorships) | mult=1.2 (snapshots) | mult=1.3 (reports) | mult=1.4 (db.pg / db.fb / db.es) |
-|---:|---:|---:|---:|---:|
-| 1 | 1 | 1 | 1 | 1 |
-| 10 | 3 | 3 | 4 | 4 |
-| 50 | 15 | 18 | 19 | 20 |
-| 100 | 33 | 39 | 42 | 45 |
-| 200 | 74 | 88 | 96 | 103 |
-| 500 | 219 | 263 | 285 | 307 |
-
-The marginal per-row cost is exactly proportional to `mult` — a 1.4× resource costs 1.4× the row part of a 1.0× resource at any size. Splitting a 500-row pull into ten 50-row calls saves ~30% but burns 10 setup floors instead of 1; "narrow the query" is almost always the better move than "fragment the pagination."
+**Credit costs are server-authoritative — run `tl describe` (overview) or `tl describe show <resource>` (one resource) to see the current rates and multipliers for every endpoint. Do not memorise rate values — they change.**
 
 ### Updating records
 
-A narrow write surface is exposed for two resources. Each command takes the record id and a single JSON object with the fields to change; the server enforces a hard-coded field whitelist and rejects anything else with a 400. Each call costs 2 credits.
-
 ```bash
 tl sponsorships update <id> '<json>'   # Edit a sponsorship (adlink)
 tl channels update <id> '<json>'       # Edit a channel
 ```
 
-**Sponsorships** — only `publish_status` is editable. Accepts either an int code or a status label (`proposed`, `pending`, `sold`, `matched`, `outreach`, `proposal_approved`, `advertiser_reject`, `publisher_reject`, `agency_reject`, `unavailable`). Non-full-access users may only update sponsorships tied to their own organization (either through `creator_profile` or through the channel's `publication`). Trying to edit a sponsorship outside the user's org returns 403.
-
-**Channels** — only the demographic fields are editable: `demographic_usa_share` and `demographic_male_share` (integers 0–100), `demographic_age` / `demographic_device` / `demographic_geo` (JSON objects with numeric values). Requires full-access permission; non-full-access users get a 403. The `demographics_updated_at` timestamp is refreshed automatically when any whitelisted demographic field changes.
-
 Examples:
 ```bash
 tl sponsorships update 98765 '{"publish_status": "sold"}'
@@ -212,7 +196,7 @@ tl channels update 12345 '{"demographic_geo": {"US": 60, "UK": 12, "CA": 8}}'
 tl channels update 12345 '{"demographic_male_share": 55, "demographic_usa_share": 70}'
 ```
 
-Anything outside these whitelists — price, cost, owner, channel name, etc. — is not editable through the CLI and must be done in the app or by a human with DB access.
+Each call costs 2 credits. If a request is rejected with a 400, the response body names the offending key — read it and retry with a smaller body. If the user wants to edit something the API rejects, the change has to be made in the app or by a human with DB access.
 
 ### Raw queries (`tl db`)
 
@@ -336,8 +320,6 @@ See [references/business-glossary.md](references/business-glossary.md) for reven
 | Arbitrary read-only `SELECT` on Postgres | **Available** via `tl db pg`. | SELECT-only, mandatory `LIMIT ≤ 500` + `OFFSET`, only certain SQL forms are allowed. See `references/postgres-schema.md`. |
 | Cross-reference helpers ("channels proposed to brand X", "channels sponsored by MBN brands in last N days") | **Available** via `tl db pg`. | Write the join: `thoughtleaders_adlink` ↔ `adspot` ↔ `channel` ↔ `profile` ↔ `profile_brands` ↔ `brand`. Filter by `publish_status` for proposed/sold and by date range as needed. See `references/postgres-schema.md` for the exact column names. |
 | **AdLink INSERT** with custom price/cost/owner/`weighted_price`/`created_where` | **Unavailable** — `tl sponsorships create` exists but only creates a free *proposal* between a channel and a brand. The `tl db pg` sanitizer accepts SELECT only — no INSERT/UPDATE. | Done in the app or by a human with DB access. |
-| **AdLink UPDATE** of any field other than `publish_status` (price, cost, owner, send_date, …) | **Unavailable** — `tl sponsorships update` only accepts `publish_status` and only for sponsorships in the user's org (full-access bypasses the org check). | Done in the app or by a human with DB access. |
-| **Channel UPDATE** of any field other than the demographic fields (`demographic_usa_share`, `demographic_male_share`, `demographic_age`, `demographic_device`, `demographic_geo`) | **Unavailable** — `tl channels update` only accepts those fields, and only for full-access users. | Done in the app or by a human with DB access. |
 | Pre-insert validation queries (joining `adspot ↔ channel ↔ profile ↔ org` to confirm MSN, integration=1, persona, plan) | **Available** via `tl db pg`. | One SELECT joining the four tables. Use `thoughtleaders_channel.media_selling_network_join_date IS NOT NULL` for MSN, `thoughtleaders_adspot.integration = 1` for mention adspots, `thoughtleaders_profile.persona` for the persona code (see persona constants in `references/postgres-schema.md`). |
 | Firebolt cross-table or join queries; filtering on non-indexed columns in WHERE | **Unavailable** — not accepted. | Fetch a wider slice keyed on `channel_id` (and optionally `id`), filter the rest in `jq`/Python. |
 | ES `query_string`, `regexp`, `wildcard`, `fuzzy`, `more_like_this`, parent/child joins; any `script_*`; multiple aggregations in one body | **Unavailable** — not accepted. | Rewrite using `term`/`terms`/`match`/`bool`/`nested`. For multi-agg dashboards, run multiple `tl db es` calls and combine client-side. For "similar"-style queries, try `tl channels similar` / `tl brands similar` (server-implemented similarity search). |

{thoughtleaders_cli-0.6.9 → thoughtleaders_cli-0.6.11}/src/tl_cli/__init__.py

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

{thoughtleaders_cli-0.6.9 → thoughtleaders_cli-0.6.11}/src/tl_cli/client/http.py

@@ -29,6 +29,9 @@ class TLClient:
     def post(self, path: str, json_body: dict | None = None) -> dict:
         return self._request("POST", path, json_body=json_body)
 
+    def patch(self, path: str, json_body: dict | None = None) -> dict:
+        return self._request("PATCH", path, json_body=json_body)
+
     def _request(
         self,
         method: str,

thoughtleaders_cli-0.6.11/src/tl_cli/commands/_comments_common.py

@@ -0,0 +1,106 @@
+"""Shared helpers for entity comment subcommands.
+
+Each entity (sponsorships, channels, brands, uploads) exposes
+`comment-add`, `comment-list`, and `comment-edit` subcommands that
+delegate to these helpers. Comments are free (no credits charged).
+
+The server-side endpoints are:
+    GET/POST /<entity_type>/<entity_id>/comments
+    PATCH    /comment/<comment_id>
+"""
+
+import typer
+
+from tl_cli.client.errors import ApiError, handle_api_error
+from tl_cli.client.http import get_client
+from tl_cli.output.formatter import detect_format, output, output_single
+
+COLUMNS = ["comment_id", "author", "text", "created_at"]
+
+
+def list_comments(entity_type: str, entity_id: str, json_output: bool, toon_output: bool) -> None:
+    fmt = detect_format(json_output, False, False, toon_output)
+    client = get_client()
+    try:
+        data = client.get(f"/{entity_type}/{entity_id}/comments")
+        for r in data.get("results", []):
+            r["comment_id"] = r.pop("id", None)
+        output(
+            data,
+            fmt,
+            columns=COLUMNS,
+            title=f"Comments on {entity_type} {entity_id}",
+        )
+    except ApiError as e:
+        handle_api_error(e)
+    finally:
+        client.close()
+
+
+def add_comment(entity_type: str, entity_id: str, message: str, json_output: bool, toon_output: bool) -> None:
+    fmt = detect_format(json_output, False, False, toon_output)
+    client = get_client()
+    try:
+        data = client.post(f"/{entity_type}/{entity_id}/comments", json_body={"text": message})
+        for r in data.get("results", []):
+            r["comment_id"] = r.pop("id", None)
+        output_single(data, fmt)
+    except ApiError as e:
+        handle_api_error(e)
+    finally:
+        client.close()
+
+
+def edit_comment(comment_id: int, message: str, json_output: bool, toon_output: bool) -> None:
+    fmt = detect_format(json_output, False, False, toon_output)
+    client = get_client()
+    try:
+        data = client.patch(f"/comment/{comment_id}", json_body={"text": message})
+        for r in data.get("results", []):
+            r["comment_id"] = r.pop("id", None)
+        output_single(data, fmt)
+    except ApiError as e:
+        handle_api_error(e)
+    finally:
+        client.close()
+
+
+def register_comment_commands(app: typer.Typer, entity_type: str, entity_label: str) -> None:
+    """Register comment-list / comment-add / comment-edit subcommands on `app`.
+
+    `entity_type` matches the server URL segment (sponsorship / channel /
+    brand / upload). `entity_label` is the user-facing word shown in help
+    text (e.g. "sponsorship", "channel").
+    """
+
+    @app.command("comment-list")
+    def comment_list(
+        entity_id: str = typer.Argument(..., help=f"{entity_label.capitalize()} ID"),
+        json_output: bool = typer.Option(False, "--json", help="JSON output"),
+        toon_output: bool = typer.Option(False, "--toon", help="TOON output (token-efficient for LLMs)"),
+    ) -> None:
+        f"""List comments on a {entity_label} (free, no credits)."""
+        list_comments(entity_type, entity_id, json_output, toon_output)
+
+    @app.command("comment-add")
+    def comment_add(
+        entity_id: str = typer.Argument(..., help=f"{entity_label.capitalize()} ID"),
+        message: str = typer.Argument(..., help="Comment text"),
+        json_output: bool = typer.Option(False, "--json", help="JSON output"),
+        toon_output: bool = typer.Option(False, "--toon", help="TOON output (token-efficient for LLMs)"),
+    ) -> None:
+        f"""Add a comment to a {entity_label} (free, no credits)."""
+        add_comment(entity_type, entity_id, message, json_output, toon_output)
+
+    @app.command("comment-edit")
+    def comment_edit(
+        comment_id: int = typer.Argument(..., help="Comment ID"),
+        message: str = typer.Argument(..., help="New comment text"),
+        json_output: bool = typer.Option(False, "--json", help="JSON output"),
+        toon_output: bool = typer.Option(False, "--toon", help="TOON output (token-efficient for LLMs)"),
+    ) -> None:
+        """Edit an existing comment (free, no credits).
+
+        Only the comment's author can edit it (superusers can edit any comment).
+        """
+        edit_comment(comment_id, message, json_output, toon_output)

{thoughtleaders_cli-0.6.9 → thoughtleaders_cli-0.6.11}/src/tl_cli/commands/brands.py

@@ -8,10 +8,12 @@ from rich.console import Console
 
 from tl_cli.client.errors import ApiError, handle_api_error
 from tl_cli.client.http import get_client
+from tl_cli.commands._comments_common import register_comment_commands
 from tl_cli.hints import detail_hint
 from tl_cli.output.formatter import detect_format, output, output_single
 
 app = typer.Typer(help="Brand intelligence (detail, sponsorship history, channel mentions)")
+register_comment_commands(app, "brand", "brand")
 
 
 @app.callback(invoke_without_command=True)

{thoughtleaders_cli-0.6.9 → thoughtleaders_cli-0.6.11}/src/tl_cli/commands/channels.py

@@ -8,11 +8,13 @@ from rich.console import Console
 
 from tl_cli.client.errors import ApiError, handle_api_error
 from tl_cli.client.http import get_client
+from tl_cli.commands._comments_common import register_comment_commands
 from tl_cli.filters import parse_filters
 from tl_cli.hints import detail_hint
 from tl_cli.output.formatter import detect_format, output, output_single
 
 app = typer.Typer(help="YouTube channels (detail, history, and similar-channel recommendations)")
+register_comment_commands(app, "channel", "channel")
 
 # Columns for the `similar` endpoint result table. The server enriches every
 # row so the user can size up each suggestion without follow-up queries.
@@ -236,19 +238,13 @@ def history_cmd(
 @app.command("update")
 def update_cmd(
     channel_id: int = typer.Argument(..., help="Channel ID (numeric)"),
-    fields: str = typer.Argument(..., help='JSON object of fields to update, e.g. \'{"demographic_male_share": 62}\''),
+    fields: str = typer.Argument(..., help='JSON object of fields to update'),
     json_output: bool = typer.Option(False, "--json", help="JSON output"),
     toon_output: bool = typer.Option(False, "--toon", help="TOON output (token-efficient for LLMs)"),
 ) -> None:
-    """Update whitelisted channel fields (demographics; full-access only).
+    """Update a channel.
 
-    Editable fields: demographic_usa_share, demographic_male_share,
-    demographic_age, demographic_device, demographic_geo. The
-    demographics_updated_at timestamp is refreshed automatically.
-
-    Examples:
-        tl channels update 12345 '{"demographic_male_share": 62}'
-        tl channels update 12345 '{"demographic_geo": {"US": 60, "UK": 12}}'
+    Unknown fields are rejected with a 400 listing the offending key.
     """
     fmt = detect_format(json_output, False, False, toon_output)
     try:

{thoughtleaders_cli-0.6.9 → thoughtleaders_cli-0.6.11}/src/tl_cli/commands/sponsorships.py

@@ -8,6 +8,7 @@ from rich.console import Console
 
 from tl_cli.client.errors import handle_api_error, ApiError
 from tl_cli.client.http import get_client
+from tl_cli.commands._comments_common import register_comment_commands
 from tl_cli.filters import parse_filters
 from tl_cli.hints import detail_hint
 from tl_cli.output.formatter import detect_format, output, output_single
@@ -197,19 +198,13 @@ def create_cmd(
 @app.command("update")
 def update_cmd(
     sponsorship_id: int = typer.Argument(..., help="Sponsorship (adlink) ID"),
-    fields: str = typer.Argument(..., help='JSON object of fields to update, e.g. \'{"publish_status": "sold"}\''),
+    fields: str = typer.Argument(..., help='JSON object of fields to update'),
     json_output: bool = typer.Option(False, "--json", help="JSON output"),
     toon_output: bool = typer.Option(False, "--toon", help="TOON output (token-efficient for LLMs)"),
 ) -> None:
-    """Update whitelisted sponsorship fields.
+    """Update a sponsorship.
 
-    Editable fields: publish_status (int code or status label, e.g. 'sold',
-    'pending', 'matched'). Non-full-access users may only update sponsorships
-    tied to their own organization.
-
-    Examples:
-        tl sponsorships update 98765 '{"publish_status": "sold"}'
-        tl sponsorships update 98765 '{"publish_status": 3}'
+    Unknown fields are rejected with a 400 listing the offending key.
     """
     fmt = detect_format(json_output, False, False, toon_output)
     try:
@@ -229,3 +224,6 @@ def update_cmd(
         handle_api_error(e)
     finally:
         client.close()
+
+
+register_comment_commands(app, "sponsorship", "sponsorship")

{thoughtleaders_cli-0.6.9 → thoughtleaders_cli-0.6.11}/src/tl_cli/commands/uploads.py

@@ -4,10 +4,12 @@ import typer
 
 from tl_cli.client.errors import ApiError, handle_api_error
 from tl_cli.client.http import get_client
+from tl_cli.commands._comments_common import register_comment_commands
 from tl_cli.filters import parse_filters
 from tl_cli.output.formatter import detect_format, output, output_single
 
 app = typer.Typer(help="Video uploads (YouTube content from Elasticsearch)")
+register_comment_commands(app, "upload", "upload")
 
 
 @app.callback(invoke_without_command=True)

{thoughtleaders_cli-0.6.9 → thoughtleaders_cli-0.6.11}/src/tl_cli/main.py

@@ -17,7 +17,6 @@ from tl_cli.commands.balance import app as balance_app
 from tl_cli.commands.changelog import changelog_command
 from tl_cli.commands.brands import app as brands_app
 from tl_cli.commands.channels import app as channels_app
-from tl_cli.commands.comments import app as comments_app
 from tl_cli.commands.db import app as db_app
 from tl_cli.commands.deals import app as deals_app
 from tl_cli.commands.matches import app as matches_app
@@ -94,7 +93,6 @@ app.add_typer(brands_app, name="brands")
 app.add_typer(recommender_app, name="recommender")
 app.add_typer(snapshots_app, name="snapshots")
 app.add_typer(reports_app, name="reports")
-app.add_typer(comments_app, name="comments")
 app.add_typer(db_app, name="db")
 
 # Discoverability

thoughtleaders_cli-0.6.9/src/tl_cli/commands/comments.py

@@ -1,63 +0,0 @@
-"""tl comments — List and add comments on sponsorships."""
-
-import typer
-
-from tl_cli.client.errors import ApiError, handle_api_error
-from tl_cli.client.http import get_client
-from tl_cli.output.formatter import detect_format, output, output_single
-
-app = typer.Typer(help="Comments on sponsorships (free, no credits)")
-
-
-@app.command("list")
-def list_cmd(
-    adlink_id: int = typer.Argument(..., help="Sponsorship (adlink) ID"),
-    json_output: bool = typer.Option(False, "--json", help="JSON output"),
-    toon_output: bool = typer.Option(False, "--toon", help="TOON output (token-efficient for LLMs)"),
-) -> None:
-    """List comments on a sponsorship (free, no credits).
-
-    Examples:
-        tl comments list 12345
-    """
-    fmt = detect_format(json_output, False, False, toon_output)
-
-    client = get_client()
-    try:
-        data = client.get(f"/comments/{adlink_id}")
-        for r in data.get("results", []):
-            r["comment_id"] = r.pop("id", None)
-        output(
-            data,
-            fmt,
-            columns=["comment_id", "author", "text", "created_at"],
-            title=f"Comments on Sponsorship #{adlink_id}",
-        )
-    except ApiError as e:
-        handle_api_error(e)
-    finally:
-        client.close()
-
-
-@app.command("add")
-def add_comment(
-    adlink_id: int = typer.Argument(..., help="Sponsorship (adlink) ID"),
-    message: str = typer.Argument(..., help="Comment text"),
-    json_output: bool = typer.Option(False, "--json", help="JSON output"),
-    toon_output: bool = typer.Option(False, "--toon", help="TOON output (token-efficient for LLMs)"),
-) -> None:
-    """Add a comment to a sponsorship (free, no credits).
-
-    Examples:
-        tl comments add 12345 "Looks good, ready to send"
-    """
-    fmt = detect_format(json_output, False, False, toon_output)
-
-    client = get_client()
-    try:
-        data = client.post(f"/comments/{adlink_id}", json_body={"text": message})
-        output_single(data, fmt)
-    except ApiError as e:
-        handle_api_error(e)
-    finally:
-        client.close()