@buildinternet/releases-skills 0.38.0 → 0.39.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buildinternet/releases-skills",
-  "version": "0.38.0",
+  "version": "0.39.0",
   "description": "Agent skills bundled with the Releases CLI. Markdown playbooks for changelog ingest, discovery, and analysis.",
   "type": "module",
   "license": "MIT",

package/skills/releases-cli/references/admin.md

@@ -66,11 +66,15 @@ releases admin source update my-blog --type feed                # change adapter
 releases admin source update my-blog --no-feed-url              # clear stored feed URL
 releases admin source update my-blog --markdown-url https://example.com/changelog.md
 releases admin source update my-blog --primary                  # mark as org's primary changelog
+releases admin source update my-blog --kind sdk                 # classify (platform|sdk|mobile|desktop|docs|integration|tool)
+releases admin source update my-blog --no-kind                  # clear; falls back to parent product's kind
 releases admin source update my-blog --slug new-slug --confirm-slug-change
 ```
 
 Slug renames require `--confirm-slug-change` because they break existing web links.
 
+`--kind` sets the source's taxonomy. In **release feeds** and **search release hits**, a source with no kind of its own inherits its parent product's kind — so filtering by `kind=sdk` returns content from any source that's either marked SDK or sits under an SDK product. In **catalog listings** and **source lists** (`releases list`, `admin product list`, `search` catalog hits), the filter matches the row's *own* kind field directly with no inheritance — so the same `kind=sdk` filter only returns rows explicitly classified as SDK.
+
 ### Fetch
 
 ```bash
@@ -139,14 +143,20 @@ Products group sources under multi-product orgs (e.g. Vercel → Next.js, Turbor
 
 ```bash
 releases admin product create "Next.js" --org vercel --url https://nextjs.org
+releases admin product create "Stripe Node" --org stripe --kind sdk
 releases admin product list vercel
+releases admin product list openai --kind sdk           # filter by taxonomy
 releases admin product update nextjs --description "React framework for production"
+releases admin product update stripe-node --kind sdk    # classify
+releases admin product update stripe-node --no-kind     # clear
 releases admin product tag add nextjs react
 releases admin product alias add nextjs nextjs.org
 releases admin product delete nextjs          # sources become unlinked, not deleted
 releases admin product adopt nextjs --into vercel   # convert an org into a product
 ```
 
+`--kind` on a product is inherited by its sources (when the source has no kind of its own) on content-oriented surfaces. Use it to classify a whole multi-source product family (e.g. "Stripe's SDKs are all kind=sdk") instead of stamping every source individually.
+
 ## Releases
 
 ```bash

package/skills/releases-cli/references/reader.md

@@ -10,6 +10,7 @@ Unified search across organizations, the catalog (products + standalone sources)
 releases search "authentication"
 releases search "vercel" --type releases --limit 5
 releases search "react" --type catalog
+releases search "stripe" --kind sdk         # taxonomy filter
 releases search "breaking change" --json
 ```
 
@@ -18,7 +19,8 @@ Flags:
 - `--type <orgs|catalog|releases>` — narrow to one section (default: all three). `products` is accepted as a deprecated alias for `catalog`.
 - `--limit <n>` — max results per section (default: 10).
 - `--mode <lexical|semantic|hybrid>` — pick the release-retrieval strategy. Server default is hybrid; pass `lexical` for pure FTS ranking.
-- `--json` — machine output. Release hits include a `kind: "release" | "changelog_chunk"` discriminator. Catalog hits include `kind: "product" | "source"` so you can route a click to either a product page or a standalone source.
+- `--kind <platform|sdk|mobile|desktop|docs|integration|tool>` — taxonomy filter. Release hits match `COALESCE(source.kind, product.kind)` (a source with no kind inherits from its product); catalog hits match the row's own kind directly.
+- `--json` — machine output. Release hits include a `kind: "release" | "changelog_chunk"` discriminator. Catalog hits include `entryType: "product" | "source"` (the entity discriminator) plus an optional `kind` field carrying the taxonomy classification.
 
 Catalog hits also include the response field `catalog`. Older API deploys will still send the deprecated `products` alias instead — the CLI reads either, but new code should consume `catalog`.
 
@@ -55,6 +57,7 @@ releases list --product nextjs         # filter by product (prod_… or slug)
 releases list --query shadcn           # name / slug / url substring
 releases list --has-feed               # sources with a discovered feed URL
 releases list --category ai            # filter by category
+releases list --kind sdk               # filter by taxonomy (platform|sdk|mobile|desktop|docs|integration|tool)
 releases list --json                   # machine-readable output
 releases list --json --compact         # lightweight JSON (id, slug, name, type, org, date)
 releases list --json --limit 20 --page 2  # pagination (server-side)