fix: Add --podcasts to news search for MCP parity and release 0.2.3

docs/commands/README.md

@@ -5,7 +5,7 @@ description: Complete generated reference for AskNews CLI commands
 
 # CLI command reference
 
-Generated from AskNews CLI 0.2.2 and AskNews API 0.31.1.
+Generated from AskNews CLI 0.2.3 and AskNews API 0.31.1.
 
 The installed CLI is authoritative. Run `asknews <command> --help` for the exact options in
 your version. Regenerate these pages with `pnpm sync:openapi`.

docs/commands/routes/news.md

@@ -47,6 +47,7 @@ Search enriched real-time or historical news
 | `--continents <value>` | Filter on articles where the content is most related to continents in this list. [query, array<string>, optional, allowed: Africa\|Asia\|Oceania\|Europe\|Middle East\|North America\|South America] |
 | `--sentiment <value>` | Sentiment to filter articles on. [query, string, optional] Choices: negative, neutral, positive. |
 | `--authors <value>` | Authors to filter articles by. [query, array<string>, optional] |
+| `--podcasts <value>` | Control whether podcast transcripts are included alongside news articles. 'include' searches both news and podcasts, 'only' returns only podcasts, and 'none' excludes podcasts. [query, string, optional, default: "include"] Choices: include, only, none. |
 | `--return-type <value>` | Format to return articles in. 'dicts' returns a list of article dictionaries with full metadata. 'string' returns a prompt-optimized string format. String is good for accepting concise input into LLMs, dicts is good for detailed analysis and using large json objects for further processing. [query, string, optional, default: "dicts"] Choices: string, dicts. |
 
 **Examples:**

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emergentmethods/asknews-cli",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "The official AskNews CLI for humans, automation, and agents",
   "type": "module",
   "license": "MIT",

skills/asknews-cli/references/commands/index.md

@@ -1,6 +1,6 @@
 # CLI command reference
 
-Generated from AskNews CLI 0.2.2 and AskNews API 0.31.1.
+Generated from AskNews CLI 0.2.3 and AskNews API 0.31.1.
 
 The installed CLI is authoritative. Run `asknews <command> --help` for the exact options in
 your version. Regenerate these pages with `pnpm sync:openapi`.

skills/asknews-cli/references/commands/news.md

@@ -42,6 +42,7 @@ Search enriched real-time or historical news
 | `--continents <value>` | Filter on articles where the content is most related to continents in this list. [query, array<string>, optional, allowed: Africa\|Asia\|Oceania\|Europe\|Middle East\|North America\|South America] |
 | `--sentiment <value>` | Sentiment to filter articles on. [query, string, optional] Choices: negative, neutral, positive. |
 | `--authors <value>` | Authors to filter articles by. [query, array<string>, optional] |
+| `--podcasts <value>` | Control whether podcast transcripts are included alongside news articles. 'include' searches both news and podcasts, 'only' returns only podcasts, and 'none' excludes podcasts. [query, string, optional, default: "include"] Choices: include, only, none. |
 | `--return-type <value>` | Format to return articles in. 'dicts' returns a list of article dictionaries with full metadata. 'string' returns a prompt-optimized string format. String is good for accepting concise input into LLMs, dicts is good for detailed analysis and using large json objects for further processing. [query, string, optional, default: "dicts"] Choices: string, dicts. |
 
 **Examples:**

skills/asknews-cli/references/task-recipes.md

@@ -34,7 +34,9 @@ The query is a semantic search where keywords are prioritized. Use `--string-gua
 `--entity-guarantee` when a keyword or entity must be present, and `--reverse-string-guarantee` to
 exclude a name or concept. Apply date, language, country, domain, entity, or string filters only
 when justified by the task; inspect `asknews news search --help` for exact syntax and current
-enums. Advanced parameters not exposed here (search method, strategy, geo filters, caching) remain
+enums. Podcast transcripts are included by default; use `--podcasts none` to exclude them or
+`--podcasts only` to search podcasts alone (podcast items have a `domain_url` ending in `.podcast`).
+Advanced parameters not exposed here (search method, strategy, geo filters, caching) remain
 available on `asknews api news search-news`.
 
 When answering from articles:

src/commands/curated.ts

@@ -223,6 +223,10 @@ function registerNews(program: Command): void {
       type: "array",
       itemType: "string",
     },
+    podcasts: {
+      description:
+        "Control whether podcast transcripts are included alongside news articles. 'include' searches both news and podcasts, 'only' returns only podcasts, and 'none' excludes podcasts.",
+    },
     return_type: {
       description:
         "Format to return articles in. 'dicts' returns a list of article dictionaries with full metadata. 'string' returns a prompt-optimized string format. String is good for accepting concise input into LLMs, dicts is good for detailed analysis and using large json objects for further processing.",

test/contract/help-coverage.test.ts

@@ -106,6 +106,7 @@ describe("command help OpenAPI coverage", () => {
         "--continents",
         "--sentiment",
         "--authors",
+        "--podcasts",
         "--return-type",
       ].sort(),
     );