@cyanheads/cyanheads-mcp-server 0.3.0 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (7) hide show
  1. package/AGENTS.md +7 -3
  2. package/CLAUDE.md +7 -3
  3. package/README.md +1 -1
  4. package/changelog/0.3.x/0.3.1.md +22 -0
  5. package/manifest.json +1 -1
  6. package/package.json +3 -2
  7. package/server.json +3 -3
package/AGENTS.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # Developer Protocol
2
2
 
3
3
  **Server:** cyanheads-mcp-server
4
- **Version:** 0.3.0
5
- **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.9.16`
4
+ **Version:** 0.3.1
5
+ **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.9.21`
6
6
  **Engines:** Bun ≥1.3.0, Node ≥24.0.0
7
7
  **MCP SDK:** `@modelcontextprotocol/sdk` ^1.29.0
8
8
  **Zod:** ^4.4.3
@@ -270,8 +270,8 @@ Available skills:
270
270
  | `polish-docs-meta` | Finalize docs, README, metadata, and agent protocol for shipping |
271
271
  | `git-wrapup` | Land working-tree changes as a versioned commit + annotated tag — version bump, changelog, verify, tag. Local only. |
272
272
  | `release-and-publish` | Push + npm + MCP Registry + GH Release + Docker. Picks up from `git-wrapup` |
273
- | `migrate-mcp-ts-template` | One-time migration of an existing project to the current framework template |
274
273
  | `maintenance` | Investigate changelogs, adopt upstream changes, sync skills to agent dirs |
274
+ | `orchestrations` | Chain task skills into a gated multi-phase pipeline — build-out, QA-fix, update-ship — when you can spawn sub-agents |
275
275
  | `report-issue-framework` | File a bug or feature request against `@cyanheads/mcp-ts-core` via `gh` CLI |
276
276
  | `report-issue-local` | File a bug or feature request against this server's own repo via `gh` CLI |
277
277
  | `api-auth` | Auth modes, scopes, JWT/OAuth |
@@ -280,12 +280,15 @@ Available skills:
280
280
  | `api-context` | Context interface, logger, state, progress |
281
281
  | `api-errors` | McpError, JsonRpcErrorCode, error patterns |
282
282
  | `api-linter` | Definition linter rule catalog — invoked by `bun run lint:mcp` and `devcheck` |
283
+ | `api-mirror` | MirrorService: persistent, self-refreshing local mirror of a bulk upstream dataset (embedded SQLite + FTS5) |
283
284
  | `api-services` | LLM, Speech, Graph services |
284
285
  | `api-testing` | createMockContext, test patterns |
285
286
  | `api-utils` | Formatting, parsing, security, pagination, scheduling, telemetry helpers |
286
287
  | `api-telemetry` | OTel catalog: spans, metrics, completion logs, env config, cardinality rules |
287
288
  | `api-workers` | Cloudflare Workers runtime |
288
289
 
290
+ **Chaining skills into pipelines.** When the user wants a multi-phase effort — build this server out, QA-and-fix the surface, update-and-ship — *and you can spawn sub-agents*, `skills/orchestrations/SKILL.md` sequences the task skills above into a gated pipeline with verification at each step. Read it to drive the run. Optional: skip it if you can't orchestrate sub-agents, and ignore it entirely if you were *spawned* as one — you've already been scoped to a single phase.
291
+
289
292
  When you complete a skill's checklist, check the boxes and add a completion timestamp at the end (e.g., `Completed: 2026-03-11`).
290
293
 
291
294
  ---
@@ -309,6 +312,7 @@ When you complete a skill's checklist, check the boxes and add a completion time
309
312
  | `npm run start:http` | Production mode (HTTP) |
310
313
  | `npm run changelog:build` | Regenerate `CHANGELOG.md` from `changelog/*.md` |
311
314
  | `npm run changelog:check` | Verify `CHANGELOG.md` is in sync (used by devcheck) |
315
+ | `npm run release:github` | Create GitHub Release from annotated tag (title format: `v<VERSION>: <subject>`) |
312
316
  | `npm run bundle` | Build and pack as `.mcpb` for one-click Claude Desktop install |
313
317
 
314
318
  ---
package/CLAUDE.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # Developer Protocol
2
2
 
3
3
  **Server:** cyanheads-mcp-server
4
- **Version:** 0.3.0
5
- **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.9.16`
4
+ **Version:** 0.3.1
5
+ **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.9.21`
6
6
  **Engines:** Bun ≥1.3.0, Node ≥24.0.0
7
7
  **MCP SDK:** `@modelcontextprotocol/sdk` ^1.29.0
8
8
  **Zod:** ^4.4.3
@@ -270,8 +270,8 @@ Available skills:
270
270
  | `polish-docs-meta` | Finalize docs, README, metadata, and agent protocol for shipping |
271
271
  | `git-wrapup` | Land working-tree changes as a versioned commit + annotated tag — version bump, changelog, verify, tag. Local only. |
272
272
  | `release-and-publish` | Push + npm + MCP Registry + GH Release + Docker. Picks up from `git-wrapup` |
273
- | `migrate-mcp-ts-template` | One-time migration of an existing project to the current framework template |
274
273
  | `maintenance` | Investigate changelogs, adopt upstream changes, sync skills to agent dirs |
274
+ | `orchestrations` | Chain task skills into a gated multi-phase pipeline — build-out, QA-fix, update-ship — when you can spawn sub-agents |
275
275
  | `report-issue-framework` | File a bug or feature request against `@cyanheads/mcp-ts-core` via `gh` CLI |
276
276
  | `report-issue-local` | File a bug or feature request against this server's own repo via `gh` CLI |
277
277
  | `api-auth` | Auth modes, scopes, JWT/OAuth |
@@ -280,12 +280,15 @@ Available skills:
280
280
  | `api-context` | Context interface, logger, state, progress |
281
281
  | `api-errors` | McpError, JsonRpcErrorCode, error patterns |
282
282
  | `api-linter` | Definition linter rule catalog — invoked by `bun run lint:mcp` and `devcheck` |
283
+ | `api-mirror` | MirrorService: persistent, self-refreshing local mirror of a bulk upstream dataset (embedded SQLite + FTS5) |
283
284
  | `api-services` | LLM, Speech, Graph services |
284
285
  | `api-testing` | createMockContext, test patterns |
285
286
  | `api-utils` | Formatting, parsing, security, pagination, scheduling, telemetry helpers |
286
287
  | `api-telemetry` | OTel catalog: spans, metrics, completion logs, env config, cardinality rules |
287
288
  | `api-workers` | Cloudflare Workers runtime |
288
289
 
290
+ **Chaining skills into pipelines.** When the user wants a multi-phase effort — build this server out, QA-and-fix the surface, update-and-ship — *and you can spawn sub-agents*, `skills/orchestrations/SKILL.md` sequences the task skills above into a gated pipeline with verification at each step. Read it to drive the run. Optional: skip it if you can't orchestrate sub-agents, and ignore it entirely if you were *spawned* as one — you've already been scoped to a single phase.
291
+
289
292
  When you complete a skill's checklist, check the boxes and add a completion timestamp at the end (e.g., `Completed: 2026-03-11`).
290
293
 
291
294
  ---
@@ -309,6 +312,7 @@ When you complete a skill's checklist, check the boxes and add a completion time
309
312
  | `npm run start:http` | Production mode (HTTP) |
310
313
  | `npm run changelog:build` | Regenerate `CHANGELOG.md` from `changelog/*.md` |
311
314
  | `npm run changelog:check` | Verify `CHANGELOG.md` is in sync (used by devcheck) |
315
+ | `npm run release:github` | Create GitHub Release from annotated tag (title format: `v<VERSION>: <subject>`) |
312
316
  | `npm run bundle` | Build and pack as `.mcpb` for one-click Claude Desktop install |
313
317
 
314
318
  ---
package/README.md CHANGED
@@ -7,7 +7,7 @@
7
7
 
8
8
  <div align="center">
9
9
 
10
- [![Version](https://img.shields.io/badge/Version-0.3.0-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/cyanheads-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.29.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/@cyanheads/cyanheads-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/cyanheads-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^6.0.3-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-%3E=1.3.0-blueviolet.svg?style=flat-square)](https://bun.sh/)
10
+ [![Version](https://img.shields.io/badge/Version-0.3.1-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/cyanheads-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.29.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/@cyanheads/cyanheads-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/cyanheads-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^6.0.3-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-%3E=1.3.0-blueviolet.svg?style=flat-square)](https://bun.sh/)
11
11
 
12
12
  </div>
13
13
 
package/changelog/0.3.x/0.3.1.md ADDED
@@ -0,0 +1,22 @@
1
+ ---
2
+ summary: "Adopt @cyanheads/mcp-ts-core 0.9.21 — request-context fix, secret-stripping in fetchWithTimeout, fail-fast withRetry"
3
+ breaking: false
4
+ ---
5
+
6
+ # 0.3.1 — 2026-06-02
7
+
8
+ ## Changed
9
+
10
+ - **`@cyanheads/mcp-ts-core`** `^0.9.16` → `^0.9.21` — picks up three framework improvements:
11
+ - **HTTP transport per-request log context** — per-request logs and traces now carry fresh `requestId` + `traceId`/`spanId` instead of the frozen boot context.
12
+ - **`fetchWithTimeout`** strips query-string secrets (e.g. `?api_key=…`) from error messages and logs before surfacing them.
13
+ - **`withRetry`** fails fast on non-retryable errors; `ctx.fail` auto-populates the `retryable` flag on the thrown error.
14
+ - **`scripts/devcheck.ts`** extended with skill-version and other checks from the updated framework template.
15
+ - **`scripts/release-github.ts`** and **`scripts/check-skill-versions.ts`** added (new framework scripts).
16
+ - **Skills** (`add-tool`, `add-service`, `api-canvas`, `api-context`, `api-linter`, `api-utils`, `design-mcp-server`, `release-and-publish`) updated to 0.9.21 framework surface; **`skills/api-mirror/`** and **`skills/orchestrations/`** added (new in 0.9.19+).
17
+
18
+ ## Dependency bumps
19
+
20
+ - `@cyanheads/mcp-ts-core` ^0.9.16 → ^0.9.21
21
+ - `vitest` ^4.1.7 → ^4.1.8
22
+ - `tsx` ^4.22.3 → ^4.22.4
package/manifest.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "manifest_version": "0.3",
3
3
  "name": "cyanheads-mcp-server",
4
- "version": "0.3.0",
4
+ "version": "0.3.1",
5
5
  "description": "Fleet discovery for the cyanheads MCP ecosystem — semantic search + install snippets.",
6
6
  "author": { "name": "cyanheads" },
7
7
  "repository": {
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@cyanheads/cyanheads-mcp-server",
3
3
  "mcpName": "io.github.cyanheads/cyanheads-mcp-server",
4
- "version": "0.3.0",
4
+ "version": "0.3.1",
5
5
  "description": "Fleet discovery for the cyanheads MCP ecosystem — semantic search + install snippets.",
6
6
  "type": "module",
7
7
  "main": "dist/index.js",
@@ -41,6 +41,7 @@
41
41
  "publish-mcp": "mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish",
42
42
  "changelog:build": "tsx scripts/build-changelog.ts",
43
43
  "changelog:check": "tsx scripts/build-changelog.ts --check",
44
+ "release:github": "tsx scripts/release-github.ts",
44
45
  "test": "vitest run",
45
46
  "start": "node dist/index.js",
46
47
  "start:stdio": "MCP_TRANSPORT_TYPE=stdio node dist/index.js",
@@ -70,7 +71,7 @@
70
71
  "access": "public"
71
72
  },
72
73
  "dependencies": {
73
- "@cyanheads/mcp-ts-core": "^0.9.16",
74
+ "@cyanheads/mcp-ts-core": "^0.9.21",
74
75
  "@huggingface/transformers": "4.2.0",
75
76
  "pino-pretty": "^13.1.3",
76
77
  "zod": "^4.4.3"
package/server.json CHANGED
@@ -6,7 +6,7 @@
6
6
  "url": "https://github.com/cyanheads/cyanheads-mcp-server",
7
7
  "source": "github"
8
8
  },
9
- "version": "0.3.0",
9
+ "version": "0.3.1",
10
10
  "remotes": [
11
11
  {
12
12
  "type": "streamable-http",
@@ -19,7 +19,7 @@
19
19
  "registryBaseUrl": "https://registry.npmjs.org",
20
20
  "identifier": "@cyanheads/cyanheads-mcp-server",
21
21
  "runtimeHint": "node",
22
- "version": "0.3.0",
22
+ "version": "0.3.1",
23
23
  "packageArguments": [
24
24
  { "type": "positional", "value": "run" },
25
25
  { "type": "positional", "value": "start:stdio" }
@@ -68,7 +68,7 @@
68
68
  "registryBaseUrl": "https://registry.npmjs.org",
69
69
  "identifier": "@cyanheads/cyanheads-mcp-server",
70
70
  "runtimeHint": "node",
71
- "version": "0.3.0",
71
+ "version": "0.3.1",
72
72
  "packageArguments": [
73
73
  { "type": "positional", "value": "run" },
74
74
  { "type": "positional", "value": "start:http" }