@cyanheads/mcp-ts-core 0.12.8 → 0.13.0

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 (118) hide show
  1. package/AGENTS.md +12 -11
  2. package/CLAUDE.md +12 -11
  3. package/README.md +2 -2
  4. package/biome.json +1 -1
  5. package/changelog/0.12.x/0.12.9.md +36 -0
  6. package/changelog/0.13.x/0.13.0.md +48 -0
  7. package/changelog/template.md +7 -24
  8. package/dist/cli/init.js +2 -2
  9. package/dist/cli/init.js.map +1 -1
  10. package/dist/config/envValue.d.ts +18 -0
  11. package/dist/config/envValue.d.ts.map +1 -0
  12. package/dist/config/envValue.js +35 -0
  13. package/dist/config/envValue.js.map +1 -0
  14. package/dist/config/index.d.ts.map +1 -1
  15. package/dist/config/index.js +5 -7
  16. package/dist/config/index.js.map +1 -1
  17. package/dist/config/parseEnvConfig.d.ts +7 -0
  18. package/dist/config/parseEnvConfig.d.ts.map +1 -1
  19. package/dist/config/parseEnvConfig.js +9 -1
  20. package/dist/config/parseEnvConfig.js.map +1 -1
  21. package/dist/linter/validate.js +2 -2
  22. package/dist/linter/validate.js.map +1 -1
  23. package/dist/mcp-server/transports/http/httpTransport.d.ts.map +1 -1
  24. package/dist/mcp-server/transports/http/httpTransport.js +70 -2
  25. package/dist/mcp-server/transports/http/httpTransport.js.map +1 -1
  26. package/dist/mcp-server/transports/http/landing-page/sections/connect.d.ts.map +1 -1
  27. package/dist/mcp-server/transports/http/landing-page/sections/connect.js +9 -2
  28. package/dist/mcp-server/transports/http/landing-page/sections/connect.js.map +1 -1
  29. package/dist/mcp-server/transports/http/sessionStore.d.ts +10 -2
  30. package/dist/mcp-server/transports/http/sessionStore.d.ts.map +1 -1
  31. package/dist/mcp-server/transports/http/sessionStore.js.map +1 -1
  32. package/dist/services/mirror/sqlite/handle.d.ts.map +1 -1
  33. package/dist/services/mirror/sqlite/handle.js +14 -12
  34. package/dist/services/mirror/sqlite/handle.js.map +1 -1
  35. package/dist/services/mirror/sqlite/sqliteMirrorStore.js +8 -9
  36. package/dist/services/mirror/sqlite/sqliteMirrorStore.js.map +1 -1
  37. package/dist/services/mirror/types.d.ts +5 -1
  38. package/dist/services/mirror/types.d.ts.map +1 -1
  39. package/dist/utils/internal/performance.d.ts +1 -1
  40. package/dist/utils/internal/performance.js +2 -2
  41. package/dist/utils/network/fetchWithTimeout.js +1 -1
  42. package/dist/utils/network/retry.js +1 -1
  43. package/dist/utils/security/idGenerator.d.ts +3 -1
  44. package/dist/utils/security/idGenerator.d.ts.map +1 -1
  45. package/dist/utils/security/idGenerator.js +12 -1
  46. package/dist/utils/security/idGenerator.js.map +1 -1
  47. package/framework-skills/README.md +40 -0
  48. package/{skills → framework-skills}/add-app-tool/SKILL.md +2 -2
  49. package/{skills → framework-skills}/add-resource/SKILL.md +2 -2
  50. package/{skills → framework-skills}/add-service/SKILL.md +2 -2
  51. package/{skills → framework-skills}/add-test/SKILL.md +2 -2
  52. package/{skills → framework-skills}/add-tool/SKILL.md +7 -7
  53. package/{skills → framework-skills}/api-config/SKILL.md +3 -1
  54. package/{skills → framework-skills}/api-context/SKILL.md +3 -3
  55. package/{skills → framework-skills}/api-errors/SKILL.md +2 -1
  56. package/{skills → framework-skills}/api-linter/SKILL.md +4 -4
  57. package/{skills → framework-skills}/api-mirror/SKILL.md +3 -1
  58. package/{skills → framework-skills}/design-mcp-server/SKILL.md +59 -101
  59. package/{skills → framework-skills}/field-test/SKILL.md +10 -5
  60. package/{skills → framework-skills}/git-wrapup/SKILL.md +5 -3
  61. package/{skills → framework-skills}/maintenance/SKILL.md +30 -21
  62. package/{skills → framework-skills}/orchestrations/SKILL.md +2 -2
  63. package/{skills → framework-skills}/orchestrations/workflows/field-test-fix.md +8 -8
  64. package/{skills → framework-skills}/orchestrations/workflows/fix-wrapup-release.md +5 -5
  65. package/{skills → framework-skills}/orchestrations/workflows/greenfield-build.md +11 -11
  66. package/{skills → framework-skills}/orchestrations/workflows/maintenance-release.md +12 -12
  67. package/{skills → framework-skills}/polish-docs-meta/SKILL.md +18 -10
  68. package/{skills → framework-skills}/polish-docs-meta/references/agent-protocol.md +1 -1
  69. package/{skills → framework-skills}/polish-docs-meta/references/package-meta.md +1 -1
  70. package/{skills → framework-skills}/polish-docs-meta/references/readme.md +88 -72
  71. package/{skills → framework-skills}/release-and-publish/SKILL.md +4 -1
  72. package/{skills → framework-skills}/release-pr-review/SKILL.md +2 -2
  73. package/{skills → framework-skills}/report-issue-framework/SKILL.md +25 -25
  74. package/{skills → framework-skills}/report-issue-local/SKILL.md +22 -24
  75. package/{skills → framework-skills}/security-pass/SKILL.md +2 -2
  76. package/{skills → framework-skills}/setup/SKILL.md +10 -8
  77. package/package.json +13 -13
  78. package/scripts/check-framework-antipatterns.ts +1 -1
  79. package/scripts/check-skill-versions.ts +16 -9
  80. package/scripts/check-skills-sync.ts +64 -13
  81. package/scripts/clean-mcpb.ts +3 -3
  82. package/scripts/devcheck.ts +37 -27
  83. package/scripts/lint-packaging.ts +158 -24
  84. package/scripts/list-skills.ts +2 -2
  85. package/templates/.claude-plugin/plugin.json +5 -1
  86. package/templates/.env.example +1 -1
  87. package/templates/.github/CONTRIBUTING.md +4 -5
  88. package/templates/.github/ISSUE_TEMPLATE/bug_report.yml +5 -4
  89. package/templates/.github/ISSUE_TEMPLATE/config.yml +6 -1
  90. package/templates/.github/ISSUE_TEMPLATE/feature_request.yml +1 -2
  91. package/templates/AGENTS.md +16 -15
  92. package/templates/CLAUDE.md +16 -15
  93. package/templates/_.mcpbignore +1 -1
  94. package/templates/changelog/template.md +7 -24
  95. package/templates/package.json +4 -3
  96. package/templates/src/mcp-server/resources/definitions/echo-app-ui.app-resource.ts +1 -1
  97. package/skills/README.md +0 -38
  98. /package/{skills → framework-skills}/add-export/SKILL.md +0 -0
  99. /package/{skills → framework-skills}/add-prompt/SKILL.md +0 -0
  100. /package/{skills → framework-skills}/add-provider/SKILL.md +0 -0
  101. /package/{skills → framework-skills}/api-auth/SKILL.md +0 -0
  102. /package/{skills → framework-skills}/api-canvas/SKILL.md +0 -0
  103. /package/{skills → framework-skills}/api-services/SKILL.md +0 -0
  104. /package/{skills → framework-skills}/api-services/references/graph.md +0 -0
  105. /package/{skills → framework-skills}/api-services/references/llm.md +0 -0
  106. /package/{skills → framework-skills}/api-services/references/speech.md +0 -0
  107. /package/{skills → framework-skills}/api-telemetry/SKILL.md +0 -0
  108. /package/{skills → framework-skills}/api-testing/SKILL.md +0 -0
  109. /package/{skills → framework-skills}/api-utils/SKILL.md +0 -0
  110. /package/{skills → framework-skills}/api-utils/references/formatting.md +0 -0
  111. /package/{skills → framework-skills}/api-utils/references/parsing.md +0 -0
  112. /package/{skills → framework-skills}/api-utils/references/security.md +0 -0
  113. /package/{skills → framework-skills}/api-workers/SKILL.md +0 -0
  114. /package/{skills → framework-skills}/code-simplifier/SKILL.md +0 -0
  115. /package/{skills → framework-skills}/polish-docs-meta/references/server-json.md +0 -0
  116. /package/{skills → framework-skills}/techniques/SKILL.md +0 -0
  117. /package/{skills → framework-skills}/techniques/references/outline-on-overflow.md +0 -0
  118. /package/{skills → framework-skills}/tool-defs-analysis/SKILL.md +0 -0
@@ -117,30 +117,13 @@ security: false
117
117
  in that unrelated item's metadata.
118
118
 
119
119
  TAG ANNOTATIONS — the annotated tag body renders as the GitHub Release body
120
- via `gh release create --notes-from-tag`. The tag is a derivative of this
121
- changelog entry — a condensed, scannable version, not a copy. Format:
122
-
123
- <theme — omit version number, GitHub prepends it>
124
- ← blank line
125
- <1-2 sentence context: what this release does>
126
- ← blank line
127
- Dependency bumps: ← section header
128
- ← blank line
129
- - `@cyanheads/mcp-ts-core` ^0.9.1 → ^0.9.6 ← bullet
130
- ← blank line
131
- Changed: ← only sections with entries
132
- ← blank line
133
- - `format()` output includes `query` in text mode
134
- ← blank line
135
- Added:
136
- ← blank line
137
- - `manifest.json` scaffolded for MCPB bundle support
138
- - Install badges (Claude Desktop, Cursor, VS Code)
139
- ← blank line
140
- <N> tests pass; `bun run devcheck` clean. ← footer
141
-
142
- Never a flat comma-separated string. Always structured markdown with
143
- sections. The tag must scan well as a rendered GitHub Release page.
120
+ via `gh release create --notes-from-tag`. It is a condensed digest of this
121
+ entry, never a copy, and its format is owned by the `release-and-publish`
122
+ skill (step 4, "Create the annotated tag"): the entry's `summary:` as the
123
+ theme line without the version, flat headline bullets — no Keep-a-Changelog
124
+ section headers, no gates line — at most one deps line, issue backlinks,
125
+ and the changelog link last. In release-PR mode the `git-wrapup` skill
126
+ authors that digest as the PR body's `## Changes` and the tag copies it.
144
127
  -->
145
128
 
146
129
  ## Added
@@ -24,6 +24,7 @@
24
24
  "rebuild": "bun run scripts/clean.ts && bun run scripts/build.ts",
25
25
  "clean": "bun run scripts/clean.ts",
26
26
  "devcheck": "bun run scripts/devcheck.ts",
27
+ "audit:fix": "bun audit fix",
27
28
  "audit:refresh": "rm -f bun.lock && bun install && bun audit",
28
29
  "tree": "bun run scripts/tree.ts",
29
30
  "list-skills": "bun run scripts/list-skills.ts",
@@ -53,7 +54,7 @@
53
54
  "license": "Apache-2.0",
54
55
  "packageManager": "bun@1.4.0",
55
56
  "engines": {
56
- "bun": ">=1.3.0",
57
+ "bun": ">=1.4.0",
57
58
  "node": ">=24.0.0"
58
59
  },
59
60
  "publishConfig": {
@@ -65,9 +66,9 @@
65
66
  "zod": "{{ZOD_VERSION}}"
66
67
  },
67
68
  "devDependencies": {
68
- "@biomejs/biome": "2.5.12",
69
+ "@biomejs/biome": "2.5.13",
69
70
  "@socketsecurity/bun-security-scanner": "^1.1.2",
70
- "@types/node": "26.4.0",
71
+ "@types/node": "26.5.1",
71
72
  "@vitest/coverage-istanbul": "4.1.11",
72
73
  "depcheck": "^1.4.7",
73
74
  "fast-check": "^4.9.0",
@@ -67,7 +67,7 @@ const APP_HTML = `<!DOCTYPE html>
67
67
  applyDocumentTheme,
68
68
  applyHostFonts,
69
69
  applyHostStyleVariables,
70
- } from "https://unpkg.com/@modelcontextprotocol/ext-apps@1/app-with-deps";
70
+ } from "https://unpkg.com/@modelcontextprotocol/ext-apps@2/app-with-deps";
71
71
 
72
72
  const app = new App({ name: "Echo App", version: "1.0.0" });
73
73
  const messageEl = document.getElementById("message");
package/skills/README.md DELETED
@@ -1,38 +0,0 @@
1
- # Skills
2
-
3
- Agent Skills for `@cyanheads/mcp-ts-core`. Each subdirectory contains a `SKILL.md` following the [Agent Skills specification](https://agentskills.io/specification).
4
-
5
- ## Three-Tier Distribution
6
-
7
- Skills flow through three locations. Each tier has a distinct role:
8
-
9
- | Tier | Location | Written by | Purpose |
10
- |:-----|:---------|:-----------|:--------|
11
- | 1. Package | `node_modules/@cyanheads/mcp-ts-core/skills/` | `npm publish` / `bun publish` | Canonical source. Ships with the package. |
12
- | 2. Project | `skills/` (project root) | `@cyanheads/mcp-ts-core init` CLI | Project's source of truth. Committed to git. Server-specific skills live here too. |
13
- | 3. Agent | `.claude/skills/`, `.codex/skills/`, etc. | The agent itself | Agent's working copy. Synced from project `skills/`. Checklists are checked here. |
14
-
15
- ### Flow
16
-
17
- ```text
18
- npm publish init CLI agent sync
19
- [package skills/] ──────────> [project skills/] ──────────> [.claude/skills/]
20
- │
21
- ├── core skills (from package)
22
- └── server-specific skills (added by devs)
23
- ```
24
-
25
- ## Audience
26
-
27
- Each skill declares `metadata.audience` in its SKILL.md frontmatter:
28
-
29
- - **`external`** — For consumers building MCP servers. Copied to project `skills/` by `init`.
30
- - **`internal`** — For core package developers. Stays in `node_modules`, not copied.
31
-
32
- ## Versioning
33
-
34
- Skills declare `metadata.version` in frontmatter. When `init` is re-run after `bun update`, it compares versions and updates skills where the package version is newer. To pin a skill and prevent updates, bump its local `metadata.version` above the package's.
35
-
36
- ## Adding Server-Specific Skills
37
-
38
- Create a new directory in `skills/` with a `SKILL.md` following the same format. The agent will pick it up on next sync. Use the core skills as examples for structure and checklist conventions.
File without changes
File without changes