feat(tools): pypi + producthunt tools (T-0018, T-0019)

Author: jadb

docs/stories/052-tool-pypi.md

@@ -0,0 +1,32 @@
+# 052 - Tool: pypi
+
+**Persona:** [CLI User](../personas/cli-user.md),
+[AI Coding Assistant](../personas/ai-coding-assistant.md)
+
+## Goal
+
+Fetch Python package metadata and latest changelog entry from PyPI for a given
+package name, returning structured data ready for scripting or display.
+
+## Stories
+
+- As a CLI user, I run `ibr tool pypi --param package=requests` to retrieve
+  name, latest version, description, license, homepage, requires-python, author,
+  and last release date.
+- As a CLI user, I also get the latest changelog/release notes entry when the
+  project description includes one.
+- As a CLI user, omitting `package` produces a non-zero exit with a clear error.
+
+## Acceptance Criteria
+
+- Navigates to `https://pypi.org/project/<package>/`.
+- Extracts: `name`, `version`, `description`, `license`, `homepage`,
+  `requires_python`, `author`, `last_release_date`.
+- Extracts latest changelog entry when present in project description.
+- Missing required param `package` → non-zero exit with "Missing required param: package".
+- Exit code 0 on successful extraction; stdout contains "Task execution completed".
+
+## E2E Coverage
+
+- `test/e2e/cli-tool-vcr.test.js` — VCR: exits 0, no config errors; required
+  param validation.

docs/stories/053-tool-producthunt.md

@@ -0,0 +1,30 @@
+# 053 - Tool: producthunt
+
+**Persona:** [CLI User](../personas/cli-user.md),
+[AI Coding Assistant](../personas/ai-coding-assistant.md)
+
+## Goal
+
+Search Product Hunt for products matching a query and extract structured data
+(name, tagline, upvote count, URL, maker) for each result.
+
+## Stories
+
+- As a CLI user, I run `ibr tool producthunt --param query=notion` to retrieve
+  a list of products with names, taglines, upvote counts, URLs, and makers.
+- As a CLI user, I pass `--param max_results=10` to control how many products
+  are returned (default 5).
+- As a CLI user, omitting `query` produces a non-zero exit with a clear error.
+
+## Acceptance Criteria
+
+- Navigates to `https://www.producthunt.com/search?q=<query>`.
+- Extracts up to `max_results` (default 5) products per run.
+- Each extracted item contains: `name`, `tagline`, `upvotes`, `url`, `maker`.
+- Missing required param `query` → non-zero exit with "Missing required param: query".
+- Exit code 0 on successful extraction; stdout contains "Task execution completed".
+
+## E2E Coverage
+
+- `test/e2e/cli-tool-vcr.test.js` — VCR: exits 0, no config errors; required
+  param validation.

test/e2e/cassettes/tool-producthunt.json

@@ -0,0 +1,4 @@
+[
+  "{\"url\":\"{SERVER_URL}/tool-results.html\",\"instructions\":[{\"name\":\"extract\",\"prompt\":\"extract product search results with name, tagline, upvotes, url, and maker\"}]}",
+  "[{\"name\":\"Notion\",\"tagline\":\"The all-in-one workspace\",\"upvotes\":4821,\"url\":\"https://www.producthunt.com/posts/notion-2\",\"maker\":\"Ivan Zhao\"},{\"name\":\"Notion AI\",\"tagline\":\"AI built right into your workspace\",\"upvotes\":3102,\"url\":\"https://www.producthunt.com/posts/notion-ai\",\"maker\":\"Ivan Zhao\"}]"
+]

test/e2e/cassettes/tool-pypi.json

@@ -0,0 +1,4 @@
+[
+  "{\"url\":\"{SERVER_URL}/tool-results.html\",\"instructions\":[{\"name\":\"extract\",\"prompt\":\"extract package info: name, version, description, license, homepage, requires_python, author, last_release_date\"}]}",
+  "[{\"name\":\"requests\",\"version\":\"2.31.0\",\"description\":\"Python HTTP for Humans.\",\"license\":\"Apache 2.0\",\"homepage\":\"https://requests.readthedocs.io\",\"requires_python\":\">=3.7\",\"author\":\"Kenneth Reitz\",\"last_release_date\":\"2023-05-22\"}]"
+]

tools/producthunt.yaml

@@ -0,0 +1,14 @@
+name: producthunt
+description: Search Product Hunt for products and extract name, tagline, upvotes, URL, and maker
+params:
+  - name: query
+    description: Product name or keyword to search for
+    required: true
+  - name: max_results
+    description: Maximum number of products to extract
+    default: "5"
+url: "https://www.producthunt.com/search?q={{query}}"
+instructions:
+  - wait for the search results to load
+  - extract up to {{max_results}} products from the results list
+  - for each product extract name, tagline, upvote count, product URL, and maker name

tools/pypi.yaml

@@ -0,0 +1,13 @@
+name: pypi
+description: Fetch Python package metadata and latest changelog from PyPI
+params:
+  - name: package
+    description: PyPI package name (e.g. requests, flask)
+    required: true
+url: "https://pypi.org/project/{{package}}/"
+instructions:
+  - wait for the page to load
+  - extract the package name, latest version, short description, license,
+    homepage URL, requires-python version, author, and last release date
+  - if a changelog or release notes section exists in the project description,
+    extract the latest entry