Merge pull request #1 from speakeasy-api/changeset-release/main

ThomasRooney · web-flow · commit 48df1e166205 · 2026-02-25T15:55:09.000Z
chore: version packages
diff --git a/.changeset/fix-embedding-edge-cases.md b/.changeset/fix-embedding-edge-cases.md
diff --git a/.changeset/rename-manifest-file.md b/.changeset/rename-manifest-file.md
diff --git a/.changeset/vector-collapse-dedup.md b/.changeset/vector-collapse-dedup.md
diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
@@ -0,0 +1,15 @@
+# @speakeasy-api/docs-mcp-cli
+
+## 0.2.0
+
+### Minor Changes
+
+- 9998fcd: Add `taxonomy` manifest field with `vector_collapse` option for collapsing content-equivalent search results across variant axes (e.g. the same API operation documented in multiple SDK languages). At search time, results sharing the same content identity are collapsed to the highest-scoring variant. On a realistic 30MB multi-language corpus this improved facet precision by 27%, MRR@5 by 10%, and NDCG@5 by 15%.
+
+### Patch Changes
+
+- df2c538: Rename manifest file from `.docs-mcp.json` to avoid clashes in schemastore
+- Updated dependencies [2d6675d]
+- Updated dependencies [df2c538]
+- Updated dependencies [9998fcd]
+  - @speakeasy-api/docs-mcp-core@0.2.0
diff --git a/packages/cli/package.json b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@speakeasy-api/docs-mcp-cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "CLI toolchain for validating, indexing, and bootstrapping docs-mcp documentation corpora",
   "license": "AGPL-3.0-only",
   "type": "module",
diff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.md
@@ -0,0 +1,12 @@
+# @speakeasy-api/docs-mcp-core
+
+## 0.2.0
+
+### Minor Changes
+
+- 9998fcd: Add `taxonomy` manifest field with `vector_collapse` option for collapsing content-equivalent search results across variant axes (e.g. the same API operation documented in multiple SDK languages). At search time, results sharing the same content identity are collapsed to the highest-scoring variant. On a realistic 30MB multi-language corpus this improved facet precision by 27%, MRR@5 by 10%, and NDCG@5 by 15%.
+
+### Patch Changes
+
+- 2d6675d: Fix edge cases in chunking and embedding: apply a default max chunk size (20,000 chars) when none is configured, recursively split oversized chunks at finer heading levels (h2→h3→…→h6) before falling back to AST node boundary splitting, and truncate oversized embedding inputs to stay within the OpenAI token limit.
+- df2c538: Rename manifest file from `.docs-mcp.json` to avoid clashes in schemastore
diff --git a/packages/core/package.json b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@speakeasy-api/docs-mcp-core",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Core retrieval and indexing primitives for docs-mcp: markdown chunking, hybrid search, and LanceDB integration",
   "license": "AGPL-3.0-only",
   "type": "module",
diff --git a/packages/eval/CHANGELOG.md b/packages/eval/CHANGELOG.md
@@ -0,0 +1,10 @@
+# @speakeasy-api/docs-mcp-eval
+
+## 0.2.0
+
+### Patch Changes
+
+- Updated dependencies [2d6675d]
+- Updated dependencies [df2c538]
+- Updated dependencies [9998fcd]
+  - @speakeasy-api/docs-mcp-core@0.2.0
diff --git a/packages/eval/package.json b/packages/eval/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@speakeasy-api/docs-mcp-eval",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Evaluation and benchmarking harness for docs-mcp search quality metrics",
   "license": "AGPL-3.0-only",
   "type": "module",
diff --git a/packages/playground/CHANGELOG.md b/packages/playground/CHANGELOG.md
@@ -0,0 +1,3 @@
+# @speakeasy-api/docs-mcp-playground
+
+## 0.2.0
diff --git a/packages/playground/package.json b/packages/playground/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@speakeasy-api/docs-mcp-playground",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Interactive web playground for demonstrating and exploring a docs-mcp server",
   "license": "AGPL-3.0-only",
   "type": "module",
diff --git a/packages/server/CHANGELOG.md b/packages/server/CHANGELOG.md
@@ -0,0 +1,14 @@
+# @speakeasy-api/docs-mcp-server
+
+## 0.2.0
+
+### Minor Changes
+
+- 9998fcd: Add `taxonomy` manifest field with `vector_collapse` option for collapsing content-equivalent search results across variant axes (e.g. the same API operation documented in multiple SDK languages). At search time, results sharing the same content identity are collapsed to the highest-scoring variant. On a realistic 30MB multi-language corpus this improved facet precision by 27%, MRR@5 by 10%, and NDCG@5 by 15%.
+
+### Patch Changes
+
+- Updated dependencies [2d6675d]
+- Updated dependencies [df2c538]
+- Updated dependencies [9998fcd]
+  - @speakeasy-api/docs-mcp-core@0.2.0
diff --git a/packages/server/package.json b/packages/server/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@speakeasy-api/docs-mcp-server",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MCP server runtime exposing hybrid search over documentation via HTTP and stdio transports",
   "license": "AGPL-3.0-only",
   "type": "module",

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@speakeasy-api/docs-mcp-cli",`
`3`		`- "version": "0.1.0",`
	`3`	`+ "version": "0.2.0",`
`4`	`4`	`"description": "CLI toolchain for validating, indexing, and bootstrapping docs-mcp documentation corpora",`
`5`	`5`	`"license": "AGPL-3.0-only",`
`6`	`6`	`"type": "module",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@speakeasy-api/docs-mcp-core",`
`3`		`- "version": "0.1.0",`
	`3`	`+ "version": "0.2.0",`
`4`	`4`	`"description": "Core retrieval and indexing primitives for docs-mcp: markdown chunking, hybrid search, and LanceDB integration",`
`5`	`5`	`"license": "AGPL-3.0-only",`
`6`	`6`	`"type": "module",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@speakeasy-api/docs-mcp-eval",`
`3`		`- "version": "0.1.0",`
	`3`	`+ "version": "0.2.0",`
`4`	`4`	`"description": "Evaluation and benchmarking harness for docs-mcp search quality metrics",`
`5`	`5`	`"license": "AGPL-3.0-only",`
`6`	`6`	`"type": "module",`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+# @speakeasy-api/docs-mcp-playground`
	`2`	`+`
	`3`	`+## 0.2.0`