@cyanheads/mcp-ts-core 0.1.0 → 0.1.2

package/templates/CLAUDE.md

@@ -1,13 +1,23 @@
 # Agent Protocol
 
 **Server:** {{PACKAGE_NAME}}
-**Version:** 0.1.0
+**Version:** 0.1.2
 **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core)
 
 > **Read the framework docs first:** `node_modules/@cyanheads/mcp-ts-core/CLAUDE.md` contains the full API reference — builders, Context, error codes, exports, patterns. This file covers server-specific conventions only.
 
 ---
 
+## First Session
+
+> **Remove this section** from CLAUDE.md / AGENTS.md after completing these steps. The skills and conventions below remain — this block is one-time onboarding only.
+
+1. **Read the framework API** — `node_modules/@cyanheads/mcp-ts-core/CLAUDE.md`
+2. **Run the `setup` skill** — read `skills/setup/SKILL.md` and follow its checklist (project orientation, agent protocol file selection, echo definition cleanup, skill sync)
+3. **Design the server** — read `skills/design-mcp-server/SKILL.md` and work through it with the user to map the domain into tools, resources, and services before scaffolding
+
+---
+
 ## Core Rules
 
 - **Logic throws, framework catches.** Tool/resource handlers are pure — throw on failure, no `try/catch`. Plain `Error` is fine; the framework catches, classifies, and formats. Use error factories (`notFound()`, `validationError()`, etc.) when the error code matters.
@@ -173,6 +183,7 @@ src/
 | Files | kebab-case with suffix | `search-docs.tool.ts` |
 | Tool/resource/prompt names | snake_case | `search_docs` |
 | Directories | kebab-case | `src/services/doc-search/` |
+| Descriptions | Single string or template literal, no `+` concatenation | `'Search items by query and filter.'` |
 
 ---
 
@@ -187,6 +198,7 @@ Available skills:
 | Skill | Purpose |
 |:------|:--------|
 | `setup` | Post-init project orientation |
+| `design-mcp-server` | Design tool surface, resources, and services for a new server |
 | `add-tool` | Scaffold a new tool definition |
 | `add-resource` | Scaffold a new resource definition |
 | `add-prompt` | Scaffold a new prompt definition |
@@ -211,12 +223,18 @@ When you complete a skill's checklist, check the boxes and add a completion time
 
 | Command | Purpose |
 |:--------|:--------|
-| `bun run build` | Compile TypeScript |
-| `bun run devcheck` | Lint + format + typecheck |
-| `bun run test` | Run tests |
-| `bun run format` | Auto-fix formatting |
-| `bun run dev:stdio` | Dev mode (stdio) |
-| `bun run dev:http` | Dev mode (HTTP) |
+| `npm run build` | Compile TypeScript |
+| `npm run clean` | Remove build artifacts |
+| `bun run devcheck` | Lint + format + typecheck + security |
+| `bun run tree` | Generate directory structure doc |
+| `npm run format` | Auto-fix formatting |
+| `npm test` | Run tests |
+| `npm run dev:stdio` | Dev mode (stdio) |
+| `npm run dev:http` | Dev mode (HTTP) |
+| `npm run start:stdio` | Production mode (stdio) |
+| `npm run start:http` | Production mode (HTTP) |
+
+**Bun requirement:** `devcheck` and `tree` scripts use Bun-specific APIs (`spawn` from `'bun'`). Install [Bun](https://bun.sh) to run them. All other commands work with any Node-compatible package manager.
 
 ---
 
@@ -239,6 +257,6 @@ import { getMyService } from '@/services/my-domain/my-service.js';
 - [ ] JSDoc `@fileoverview` + `@module` on every file
 - [ ] `ctx.log` for logging, `ctx.state` for storage
 - [ ] Handlers throw on failure — error factories or plain `Error`, no try/catch
-- [ ] Registered in `src/index.ts` arrays
+- [ ] Registered in `createApp()` arrays (directly or via barrel exports)
 - [ ] Tests use `createMockContext()` from `@cyanheads/mcp-ts-core/testing`
 - [ ] `bun run devcheck` passes

package/templates/_tsconfig.json

@@ -1,28 +1,8 @@
 {
+  "extends": "@cyanheads/mcp-ts-core/tsconfig.base.json",
   "compilerOptions": {
-    "target": "ESNext",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "strict": true,
-    "noUncheckedIndexedAccess": true,
-    "verbatimModuleSyntax": true,
-    "moduleDetection": "force",
-    "esModuleInterop": true,
-    "allowSyntheticDefaultImports": true,
-    "outDir": "dist",
     "rootDir": "src",
-    "declaration": true,
-    "sourceMap": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "lib": ["ESNext"],
-    "types": ["node"],
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "noImplicitReturns": true,
-    "noFallthroughCasesInSwitch": true,
-    "resolveJsonModule": true,
-    "allowJs": false,
+    "outDir": "dist",
     "baseUrl": ".",
     "paths": {
       "@/*": ["src/*"]

package/templates/biome.template.json

@@ -1,43 +1,3 @@
 {
-  "$schema": "https://biomejs.dev/schemas/1.9.0/schema.json",
-  "vcs": {
-    "enabled": true,
-    "clientKind": "git",
-    "useIgnoreFile": true
-  },
-  "formatter": {
-    "enabled": true,
-    "indentStyle": "space",
-    "indentWidth": 2,
-    "lineWidth": 100,
-    "lineEnding": "lf"
-  },
-  "javascript": {
-    "formatter": {
-      "quoteStyle": "single",
-      "trailingCommas": "all",
-      "semicolons": "always",
-      "arrowParentheses": "always",
-      "bracketSpacing": true
-    }
-  },
-  "linter": {
-    "enabled": true,
-    "rules": {
-      "recommended": true,
-      "correctness": {
-        "noUnusedVariables": "error",
-        "noUnusedFunctionParameters": "error",
-        "noUnusedImports": "error"
-      },
-      "style": {
-        "useConst": "error"
-      },
-      "suspicious": {
-        "noExplicitAny": "warn",
-        "noVar": "error",
-        "useAwait": "warn"
-      }
-    }
-  }
+  "extends": ["@cyanheads/mcp-ts-core/biome"]
 }

package/templates/package.json

@@ -1,27 +1,49 @@
 {
   "name": "{{PACKAGE_NAME}}",
   "version": "0.1.0",
+  "description": "",
   "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/"
+  ],
   "scripts": {
-    "build": "tsc && tsc-alias",
-    "devcheck": "biome check . && tsc --noEmit",
-    "format": "biome check --fix .",
+    "build": "tsx scripts/build.ts",
+    "rebuild": "tsx scripts/clean.ts && tsx scripts/build.ts",
+    "clean": "tsx scripts/clean.ts",
+    "devcheck": "bun run scripts/devcheck.ts",
+    "tree": "bun run scripts/tree.ts",
+    "format": "biome check --write --unsafe .",
     "test": "vitest run",
-    "dev:stdio": "tsx src/index.ts",
-    "dev:http": "MCP_TRANSPORT_TYPE=http tsx src/index.ts",
+    "dev:stdio": "tsx --watch src/index.ts",
+    "dev:http": "MCP_TRANSPORT_TYPE=http tsx --watch src/index.ts",
     "start:stdio": "node dist/index.js",
     "start:http": "MCP_TRANSPORT_TYPE=http node dist/index.js"
   },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol"
+  ],
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
   "dependencies": {
     "@cyanheads/mcp-ts-core": "^0.1.0",
-    "zod": "^4.3.6"
+    "pino-pretty": "^13.1.3"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.0",
-    "@types/node": "^25.0.0",
-    "tsc-alias": "^1.8.0",
+    "@biomejs/biome": "^2.4.7",
+    "@types/node": "^25.5.0",
+    "ignore": "^7.0.5",
+    "tsc-alias": "^1.8.16",
     "tsx": "^4.19.0",
-    "typescript": "^5.9.0",
-    "vitest": "^4.0.0"
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.0"
   }
 }

package/templates/vitest.config.ts

@@ -1,12 +1,14 @@
-import { defineConfig } from 'vitest/config';
+import { defineConfig, mergeConfig } from 'vitest/config';
+import coreConfig from '@cyanheads/mcp-ts-core/vitest.config';
 
-export default defineConfig({
-  resolve: {
-    alias: { '@/': new URL('./src/', import.meta.url).pathname },
-  },
-  test: {
-    globals: false,
-    environment: 'node',
-    include: ['src/**/*.test.ts', 'tests/**/*.test.ts'],
-  },
-});
+export default mergeConfig(
+  coreConfig,
+  defineConfig({
+    resolve: {
+      alias: { '@/': new URL('./src/', import.meta.url).pathname },
+    },
+    test: {
+      include: ['src/**/*.test.ts', 'tests/**/*.test.ts'],
+    },
+  }),
+);