@cyanheads/gdelt-mcp-server 0.1.6 → 0.1.7

package/CLAUDE.md

@@ -1,8 +1,8 @@
 # Developer Protocol
 
 **Server:** gdelt-mcp-server
-**Version:** 0.1.6
-**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.9.16`
+**Version:** 0.1.7
+**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.9.21`
 **Engines:** Bun ≥1.3.0, Node ≥24.0.0
 **MCP SDK:** `@modelcontextprotocol/sdk` ^1.29.0
 **Zod:** ^4.4.3
@@ -279,6 +279,7 @@ Available skills:
 | `git-wrapup` | Land working-tree changes as a versioned commit + annotated tag — version bump, changelog, verify, tag. Local only. |
 | `release-and-publish` | Push + npm + MCP Registry + GH Release + Docker. Picks up from `git-wrapup` |
 | `maintenance` | Investigate changelogs, adopt upstream changes, sync skills to agent dirs |
+| `orchestrations` | Chain task skills into a gated multi-phase pipeline — build-out, QA-fix, update-ship — when you can spawn sub-agents |
 | `report-issue-framework` | File a bug or feature request against `@cyanheads/mcp-ts-core` via `gh` CLI |
 | `report-issue-local` | File a bug or feature request against this server's own repo via `gh` CLI |
 | `api-auth` | Auth modes, scopes, JWT/OAuth |
@@ -286,12 +287,16 @@ Available skills:
 | `api-config` | AppConfig, parseConfig, env vars |
 | `api-context` | Context interface, logger, state, progress |
 | `api-errors` | McpError, JsonRpcErrorCode, error patterns |
+| `api-linter` | Definition linter rule catalog — invoked by `bun run lint:mcp` and `devcheck` |
 | `api-services` | LLM, Speech, Graph services |
 | `api-testing` | createMockContext, test patterns |
 | `api-utils` | Formatting, parsing, security, pagination, scheduling, telemetry helpers |
 | `api-telemetry` | OTel catalog: spans, metrics, completion logs, env config, cardinality rules |
+| `api-mirror` | MirrorService: persistent SQLite-backed local mirror of bulk upstream datasets — `defineMirror()`, `sqliteMirrorStore()`, sync state machine, FTS5 |
 | `api-workers` | Cloudflare Workers runtime |
 
+**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.
+
 When you complete a skill's checklist, check the boxes and add a completion timestamp at the end (e.g., `Completed: 2026-03-11`).
 
 ---
@@ -314,6 +319,7 @@ When you complete a skill's checklist, check the boxes and add a completion time
 | `bun run start:http` | Production mode (HTTP) |
 | `bun run changelog:build` | Regenerate `CHANGELOG.md` from `changelog/*.md` |
 | `bun run changelog:check` | Verify `CHANGELOG.md` is in sync (used by devcheck) |
+| `bun run release:github` | Create GitHub Release from current tag (title + optional .mcpb attach) |
 | `bun run bundle` | Build and pack as `.mcpb` for one-click Claude Desktop install |
 
 ---

package/README.md

@@ -7,7 +7,7 @@
 
 <div align="center">
 
-[![Version](https://img.shields.io/badge/Version-0.1.6-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/gdelt-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/gdelt-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/gdelt-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-v1.3.0-blueviolet.svg?style=flat-square)](https://bun.sh/)
+[![Version](https://img.shields.io/badge/Version-0.1.7-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/gdelt-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/gdelt-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/gdelt-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-v1.3.0-blueviolet.svg?style=flat-square)](https://bun.sh/)
 
 </div>
 
@@ -169,7 +169,7 @@ A public instance is available at `https://gdelt.caseyjhand.com/mcp` — no inst
 ```json
 {
   "mcpServers": {
-    "gdelt": {
+    "gdelt-mcp-server": {
       "type": "streamable-http",
       "url": "https://gdelt.caseyjhand.com/mcp"
     }
@@ -184,7 +184,7 @@ Add the following to your MCP client configuration file.
 ```json
 {
   "mcpServers": {
-    "gdelt": {
+    "gdelt-mcp-server": {
       "type": "stdio",
       "command": "bunx",
       "args": ["@cyanheads/gdelt-mcp-server@latest"],
@@ -202,7 +202,7 @@ Or with npx (no Bun required):
 ```json
 {
   "mcpServers": {
-    "gdelt": {
+    "gdelt-mcp-server": {
       "type": "stdio",
       "command": "npx",
       "args": ["-y", "@cyanheads/gdelt-mcp-server@latest"],
@@ -220,7 +220,7 @@ Or with Docker:
 ```json
 {
   "mcpServers": {
-    "gdelt": {
+    "gdelt-mcp-server": {
       "type": "stdio",
       "command": "docker",
       "args": [

package/changelog/0.1.x/0.1.7.md

@@ -0,0 +1,21 @@
+---
+summary: "mcp-ts-core 0.9.21: per-request log context fix, secret-stripping in fetchWithTimeout, withRetry fail-fast on non-retryable errors; updated scripts and synced skills"
+breaking: false
+security: false
+---
+
+# 0.1.7 — 2026-06-02
+
+## Changed
+
+- **HTTP transport log context** — per-request logs and traces now carry fresh request + trace/span IDs instead of the frozen boot context (framework fix in `@cyanheads/mcp-ts-core` 0.9.17).
+- **`fetchWithTimeout` secret redaction** — query-string secrets (e.g. `?api_key=`) are stripped from error messages and logs (framework fix in `@cyanheads/mcp-ts-core` 0.9.18).
+- **`withRetry` fail-fast** — non-retryable errors bypass the retry loop immediately; `ctx.fail` auto-populates the `retryable` flag (framework fix in `@cyanheads/mcp-ts-core` 0.9.19).
+- **Client config key** — README client-configuration examples renamed from `"gdelt"` to `"gdelt-mcp-server"` (matches the package name convention).
+- **Scripts** — added `scripts/release-github.ts` (GitHub Release automation) and `scripts/check-skill-versions.ts`; updated `scripts/devcheck.ts` to include skill-version gating.
+- **Skills** — 8 updated skills (add-service, add-tool, api-canvas, api-context, api-linter, api-utils, design-mcp-server, release-and-publish) + new api-mirror and orchestrations skills synced from framework.
+
+## Dependencies
+
+- `@cyanheads/mcp-ts-core` ^0.9.16 → ^0.9.21
+- `vitest` ^4.1.7 → ^4.1.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyanheads/gdelt-mcp-server",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Search and analyze global news coverage and US television transcripts via the GDELT Project's real-time APIs via MCP. STDIO or Streamable HTTP.",
   "mcpName": "io.github.cyanheads/gdelt-mcp-server",
   "type": "module",
@@ -36,6 +36,7 @@
     "test": "bunx vitest run",
     "start:stdio": "MCP_TRANSPORT_TYPE=stdio bun ./dist/index.js",
     "start:http": "MCP_TRANSPORT_TYPE=http bun ./dist/index.js",
+    "release:github": "bun run scripts/release-github.ts",
     "publish-mcp": "mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish"
   },
   "keywords": [
@@ -84,7 +85,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@cyanheads/mcp-ts-core": "^0.9.16",
+    "@cyanheads/mcp-ts-core": "^0.9.21",
     "pino-pretty": "^13.1.3",
     "zod": "^4.4.3"
   },
@@ -95,6 +96,6 @@
     "ignore": "^7.0.5",
     "tsc-alias": "^1.8.17",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.7"
+    "vitest": "^4.1.8"
   }
 }

package/server.json

@@ -6,7 +6,7 @@
     "url": "https://github.com/cyanheads/gdelt-mcp-server",
     "source": "github"
   },
-  "version": "0.1.6",
+  "version": "0.1.7",
   "remotes": [
     {
       "type": "streamable-http",
@@ -19,7 +19,7 @@
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@cyanheads/gdelt-mcp-server",
       "runtimeHint": "node",
-      "version": "0.1.6",
+      "version": "0.1.7",
       "packageArguments": [
         {
           "type": "positional",
@@ -48,7 +48,7 @@
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@cyanheads/gdelt-mcp-server",
       "runtimeHint": "node",
-      "version": "0.1.6",
+      "version": "0.1.7",
       "packageArguments": [
         {
           "type": "positional",