frontmcp 0.1.5 → 0.1.7

package/dist/cli.js

@@ -71,7 +71,7 @@ ${c('bold', 'Usage')}
   frontmcp <command> [options]
 
 ${c('bold', 'Commands')}
-  dev                 Start in development mode (tsx --watch <entry>)
+  dev                 Start in development mode (tsx --watch <entry> + async type-check)
   build               Compile entry with TypeScript (tsc)
   init                Create or fix a tsconfig.json suitable for FrontMCP
   doctor              Check Node/npm versions and tsconfig requirements
@@ -151,14 +151,16 @@ function resolveEntry(cwd, explicit) {
             const pkg = yield readJSON(pkgPath);
             if (pkg && typeof pkg.main === 'string' && pkg.main.trim()) {
                 const mainCandidates = tryCandidates(path.resolve(cwd, pkg.main));
-                for (const p of mainCandidates)
+                for (const p of mainCandidates) {
                     if (yield fileExists(p))
                         return p;
+                }
                 const asDir = path.resolve(cwd, pkg.main);
                 const idxCandidates = tryCandidates(path.join(asDir, 'index'));
-                for (const p of idxCandidates)
+                for (const p of idxCandidates) {
                     if (yield fileExists(p))
                         return p;
+                }
             }
         }
         const fallback = path.join(cwd, 'src', 'main.ts');
@@ -219,22 +221,61 @@ function sanitizeForNpm(name) {
 /* ------------------------ Self-version detection -------------------------- */
 function getSelfVersion() {
     return __awaiter(this, void 0, void 0, function* () {
-        return '0.1.5';
+        const binPath = process.argv[1] || __filename;
+        const candidates = [
+            path.resolve(path.dirname(binPath), '../package.json'),
+            path.resolve(path.dirname(binPath), '../../package.json'),
+        ];
+        for (const p of candidates) {
+            const j = yield readJSON(p);
+            if (j === null || j === void 0 ? void 0 : j.version)
+                return j.version;
+        }
+        return '0.0.0';
     });
 }
 /* --------------------------------- Actions -------------------------------- */
+function isTsLike(p) {
+    return /\.tsx?$/i.test(p);
+}
+function killQuiet(proc) {
+    try {
+        proc && proc.kill('SIGINT');
+    }
+    catch (_a) { }
+}
 function runDev(opts) {
     return __awaiter(this, void 0, void 0, function* () {
         const cwd = process.cwd();
         const entry = yield resolveEntry(cwd, opts.entry);
         console.log(`${c('cyan', '[dev]')} using entry: ${path.relative(cwd, entry)}`);
+        console.log(`${c('gray', '[dev]')} starting ${c('bold', 'tsx --watch')} and ${c('bold', 'tsc --noEmit --watch')} (async type-checker)`);
         console.log(`${c('gray', 'hint:')} press Ctrl+C to stop`);
-        yield runCmd('npx', ['-y', 'tsx', '--watch', entry]);
+        // Start tsx watcher (app run)
+        const app = (0, child_process_1.spawn)('npx', ['-y', 'tsx', '--watch', entry], { stdio: 'inherit', shell: true });
+        // Start tsc in watch mode for async type-checking (non-blocking)
+        const checker = (0, child_process_1.spawn)('npx', ['-y', 'tsc', '--noEmit', '--pretty', '--watch'], { stdio: 'inherit', shell: true });
+        const cleanup = () => {
+            killQuiet(checker);
+            killQuiet(app);
+        };
+        process.on('SIGINT', () => {
+            cleanup();
+            process.exit(0);
+        });
+        yield new Promise((resolve, reject) => {
+            app.on('close', (_code) => {
+                // When app exits, stop checker too.
+                cleanup();
+                resolve();
+            });
+            app.on('error', (err) => {
+                cleanup();
+                reject(err);
+            });
+        });
     });
 }
-function isTsLike(p) {
-    return /\.tsx?$/i.test(p);
-}
 function runBuild(opts) {
     return __awaiter(this, void 0, void 0, function* () {
         const cwd = process.cwd();
@@ -273,7 +314,7 @@ const RECOMMENDED_TSCONFIG = {
         module: REQUIRED_DECORATOR_FIELDS.module,
         emitDecoratorMetadata: REQUIRED_DECORATOR_FIELDS.emitDecoratorMetadata,
         experimentalDecorators: REQUIRED_DECORATOR_FIELDS.experimentalDecorators,
-        moduleResolution: 'node',
+        moduleResolution: 'NodeNext',
         strict: true,
         esModuleInterop: true,
         resolveJsonModule: true,
@@ -465,19 +506,19 @@ function upsertPackageJson(cwd, nameOverride, selfVersion) {
                 npm: '>=10',
             },
             dependencies: {
-                '@frontmcp/sdk': 'latest',
+                '@frontmcp/sdk': '^0.1.3',
                 zod: '^3.23.8',
                 'reflect-metadata': '^0.2.2',
             },
             devDependencies: {
-                frontmcp: selfVersion, // exact version used by npx
+                frontmcp: selfVersion, // exact CLI version used by npx
                 tsx: '^4.20.6',
                 typescript: '^5.5.3',
             },
         };
         if (!existing) {
             yield writeJSON(pkgPath, base);
-            console.log(c('green', '✅ Created package.json (pinned tsx/typescript/zod/reflect-metadata, exact frontmcp)'));
+            console.log(c('green', '✅ Created package.json (pinned versions + exact frontmcp)'));
             return;
         }
         const merged = Object.assign(Object.assign({}, base), existing);
@@ -486,12 +527,8 @@ function upsertPackageJson(cwd, nameOverride, selfVersion) {
         merged.type = existing.type || base.type;
         merged.scripts = Object.assign(Object.assign(Object.assign({}, base.scripts), (existing.scripts || {})), { dev: (_b = (_a = existing.scripts) === null || _a === void 0 ? void 0 : _a.dev) !== null && _b !== void 0 ? _b : base.scripts.dev, build: (_d = (_c = existing.scripts) === null || _c === void 0 ? void 0 : _c.build) !== null && _d !== void 0 ? _d : base.scripts.build, inspect: (_f = (_e = existing.scripts) === null || _e === void 0 ? void 0 : _e.inspect) !== null && _f !== void 0 ? _f : base.scripts.inspect, doctor: (_h = (_g = existing.scripts) === null || _g === void 0 ? void 0 : _g.doctor) !== null && _h !== void 0 ? _h : base.scripts.doctor });
         merged.engines = Object.assign(Object.assign({}, (existing.engines || {})), { node: ((_j = existing.engines) === null || _j === void 0 ? void 0 : _j.node) || base.engines.node, npm: ((_k = existing.engines) === null || _k === void 0 ? void 0 : _k.npm) || base.engines.npm });
-        merged.dependencies = Object.assign(Object.assign(Object.assign({}, base.dependencies), (existing.dependencies || {})), { 
-            // ensure pins
-            zod: '^3.23.8', 'reflect-metadata': '^0.2.2' });
-        merged.devDependencies = Object.assign(Object.assign(Object.assign({}, base.devDependencies), (existing.devDependencies || {})), { 
-            // ensure pins
-            frontmcp: selfVersion, tsx: '^4.20.6', typescript: '^5.5.3' });
+        merged.dependencies = Object.assign(Object.assign(Object.assign({}, base.dependencies), (existing.dependencies || {})), { zod: '^3.23.8', 'reflect-metadata': '^0.2.2' });
+        merged.devDependencies = Object.assign(Object.assign(Object.assign({}, base.devDependencies), (existing.devDependencies || {})), { frontmcp: selfVersion, tsx: '^4.20.6', typescript: '^5.5.3' });
         yield writeJSON(pkgPath, merged);
         console.log(c('green', '✅ Updated package.json (ensured exact frontmcp and pinned versions)'));
     });
@@ -541,9 +578,9 @@ import { z } from 'zod';
 const AddTool = tool({
   name: 'add',
   description: 'Add two numbers',
-  inputSchema: z.object({ a: z.number(), b: z.number() }),
-  outputSchema: z.object({ result: z.number() }),
-})((input, _ctx) => {
+  inputSchema: { a: z.number(), b: z.number() },
+  outputSchema: { result: z.number() },
+})(async (input, _ctx) => {
   return { result: input.a + input.b };
 });
 
@@ -573,7 +610,7 @@ function runCreate(projectArg) {
         process.chdir(targetDir);
         // 1) tsconfig
         yield runInit(targetDir);
-        // 2) package.json (with pinned deps and exact frontmcp version)
+        // 2) package.json (pinned deps + exact CLI version)
         const selfVersion = yield getSelfVersion();
         yield upsertPackageJson(targetDir, pkgName, selfVersion);
         // 3) files
@@ -583,7 +620,7 @@ function runCreate(projectArg) {
         console.log('\nNext steps:');
         console.log(`  1) cd ${folder}`);
         console.log('  2) npm install');
-        console.log('  3) npm run dev     ', c('gray', '# starts tsx watcher via frontmcp dev'));
+        console.log('  3) npm run dev     ', c('gray', '# tsx watcher + async tsc type-check'));
         console.log('  4) npm run inspect ', c('gray', '# launch MCP Inspector'));
         console.log('  5) npm run build   ', c('gray', '# compile with tsc via frontmcp build'));
     });
@@ -617,7 +654,7 @@ function main() {
                     yield runInspector();
                     break;
                 case 'create': {
-                    const projectName = parsed._[1]; // require a name
+                    const projectName = parsed._[1];
                     yield runCreate(projectName);
                     break;
                 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frontmcp",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "FrontMCP command line interface",
   "main": "dist/index.js",
   "bin": {
@@ -12,15 +12,15 @@
     "prepare": "npm run build"
   },
   "dependencies": {
-    "@frontmcp/sdk": "0.1.3",
-    "@frontmcp/core": "0.1.3",
-    "@frontmcp/plugins": "0.1.3",
-    "@frontmcp/adapters": "0.1.3",
-    "tsx": "^4.20.6",
+    "@frontmcp/sdk": "^0.1.3",
+    "@frontmcp/core": "^0.1.3",
+    "@frontmcp/plugins": "^0.1.3",
+    "@frontmcp/adapters": "^0.1.3",
+    "tsx": "^4.16.0",
     "typescript": "^5.5.3"
   },
   "devDependencies": {
-    "@types/node": "20.19.9",
+    "@types/node": "^20.11.30",
     "@modelcontextprotocol/inspector": "^0.17.2"
   }
 }

package/src/cli.ts

@@ -7,7 +7,7 @@
 import * as fs from 'fs';
 import {promises as fsp} from 'fs';
 import * as path from 'path';
-import {spawn} from 'child_process';
+import {spawn, ChildProcess} from 'child_process';
 
 /* ----------------------------- Types & Helpers ---------------------------- */
 
@@ -42,7 +42,7 @@ ${c('bold', 'Usage')}
   frontmcp <command> [options]
 
 ${c('bold', 'Commands')}
-  dev                 Start in development mode (tsx --watch <entry>)
+  dev                 Start in development mode (tsx --watch <entry> + async type-check)
   build               Compile entry with TypeScript (tsc)
   init                Create or fix a tsconfig.json suitable for FrontMCP
   doctor              Check Node/npm versions and tsconfig requirements
@@ -109,17 +109,23 @@ async function resolveEntry(cwd: string, explicit?: string): Promise<string> {
     if (await fileExists(full)) return full;
     throw new Error(`Entry override not found: ${explicit}`);
   }
+
   const pkgPath = path.join(cwd, 'package.json');
   if (await fileExists(pkgPath)) {
     const pkg = await readJSON<any>(pkgPath);
     if (pkg && typeof pkg.main === 'string' && pkg.main.trim()) {
       const mainCandidates = tryCandidates(path.resolve(cwd, pkg.main));
-      for (const p of mainCandidates) if (await fileExists(p)) return p;
+      for (const p of mainCandidates) {
+        if (await fileExists(p)) return p;
+      }
       const asDir = path.resolve(cwd, pkg.main);
       const idxCandidates = tryCandidates(path.join(asDir, 'index'));
-      for (const p of idxCandidates) if (await fileExists(p)) return p;
+      for (const p of idxCandidates) {
+        if (await fileExists(p)) return p;
+      }
     }
   }
+
   const fallback = path.join(cwd, 'src', 'main.ts');
   if (await fileExists(fallback)) return fallback;
 
@@ -177,21 +183,62 @@ function sanitizeForNpm(name: string): string {
 /* ------------------------ Self-version detection -------------------------- */
 
 async function getSelfVersion(): Promise<string> {
-  return '0.1.5';
+  const binPath = process.argv[1] || __filename;
+  const candidates = [
+    path.resolve(path.dirname(binPath), '../package.json'),
+    path.resolve(path.dirname(binPath), '../../package.json'),
+  ];
+  for (const p of candidates) {
+    const j = await readJSON<any>(p);
+    if (j?.version) return j.version;
+  }
+  return '0.0.0';
 }
 
 /* --------------------------------- Actions -------------------------------- */
 
+function isTsLike(p: string): boolean {
+  return /\.tsx?$/i.test(p);
+}
+
+function killQuiet(proc?: ChildProcess) {
+  try { proc && proc.kill('SIGINT'); } catch {}
+}
+
 async function runDev(opts: ParsedArgs): Promise<void> {
   const cwd = process.cwd();
   const entry = await resolveEntry(cwd, opts.entry);
+
   console.log(`${c('cyan', '[dev]')} using entry: ${path.relative(cwd, entry)}`);
+  console.log(`${c('gray', '[dev]')} starting ${c('bold', 'tsx --watch')} and ${c('bold', 'tsc --noEmit --watch')} (async type-checker)`);
   console.log(`${c('gray', 'hint:')} press Ctrl+C to stop`);
-  await runCmd('npx', ['-y', 'tsx', '--watch', entry]);
-}
 
-function isTsLike(p: string): boolean {
-  return /\.tsx?$/i.test(p);
+  // Start tsx watcher (app run)
+  const app = spawn('npx', ['-y', 'tsx', '--watch', entry], {stdio: 'inherit', shell: true});
+  // Start tsc in watch mode for async type-checking (non-blocking)
+  const checker = spawn('npx', ['-y', 'tsc', '--noEmit', '--pretty', '--watch'], {stdio: 'inherit', shell: true});
+
+  const cleanup = () => {
+    killQuiet(checker);
+    killQuiet(app);
+  };
+
+  process.on('SIGINT', () => {
+    cleanup();
+    process.exit(0);
+  });
+
+  await new Promise<void>((resolve, reject) => {
+    app.on('close', (_code) => {
+      // When app exits, stop checker too.
+      cleanup();
+      resolve();
+    });
+    app.on('error', (err) => {
+      cleanup();
+      reject(err);
+    });
+  });
 }
 
 async function runBuild(opts: ParsedArgs): Promise<void> {
@@ -239,7 +286,7 @@ const RECOMMENDED_TSCONFIG = {
     emitDecoratorMetadata: REQUIRED_DECORATOR_FIELDS.emitDecoratorMetadata,
     experimentalDecorators: REQUIRED_DECORATOR_FIELDS.experimentalDecorators,
 
-    moduleResolution: 'node',
+    moduleResolution: 'NodeNext',
     strict: true,
     esModuleInterop: true,
     resolveJsonModule: true,
@@ -428,12 +475,12 @@ async function upsertPackageJson(cwd: string, nameOverride: string | undefined,
       npm: '>=10',
     },
     dependencies: {
-      '@frontmcp/sdk': 'latest',
+      '@frontmcp/sdk': '^0.1.3',
       zod: '^3.23.8',
       'reflect-metadata': '^0.2.2',
     },
     devDependencies: {
-      frontmcp: selfVersion,       // exact version used by npx
+      frontmcp: selfVersion,       // exact CLI version used by npx
       tsx: '^4.20.6',
       typescript: '^5.5.3',
     },
@@ -441,7 +488,7 @@ async function upsertPackageJson(cwd: string, nameOverride: string | undefined,
 
   if (!existing) {
     await writeJSON(pkgPath, base);
-    console.log(c('green', '✅ Created package.json (pinned tsx/typescript/zod/reflect-metadata, exact frontmcp)'));
+    console.log(c('green', '✅ Created package.json (pinned versions + exact frontmcp)'));
     return;
   }
 
@@ -469,7 +516,6 @@ async function upsertPackageJson(cwd: string, nameOverride: string | undefined,
   merged.dependencies = {
     ...base.dependencies,
     ...(existing.dependencies || {}),
-    // ensure pins
     zod: '^3.23.8',
     'reflect-metadata': '^0.2.2',
   };
@@ -477,7 +523,6 @@ async function upsertPackageJson(cwd: string, nameOverride: string | undefined,
   merged.devDependencies = {
     ...base.devDependencies,
     ...(existing.devDependencies || {}),
-    // ensure pins
     frontmcp: selfVersion,
     tsx: '^4.20.6',
     typescript: '^5.5.3',
@@ -533,9 +578,9 @@ import { z } from 'zod';
 const AddTool = tool({
   name: 'add',
   description: 'Add two numbers',
-  inputSchema: z.object({ a: z.number(), b: z.number() }),
-  outputSchema: z.object({ result: z.number() }),
-})((input, _ctx) => {
+  inputSchema: { a: z.number(), b: z.number() },
+  outputSchema: { result: z.number() },
+})(async (input, _ctx) => {
   return { result: input.a + input.b };
 });
 
@@ -569,7 +614,7 @@ async function runCreate(projectArg?: string): Promise<void> {
   // 1) tsconfig
   await runInit(targetDir);
 
-  // 2) package.json (with pinned deps and exact frontmcp version)
+  // 2) package.json (pinned deps + exact CLI version)
   const selfVersion = await getSelfVersion();
   await upsertPackageJson(targetDir, pkgName, selfVersion);
 
@@ -581,7 +626,7 @@ async function runCreate(projectArg?: string): Promise<void> {
   console.log('\nNext steps:');
   console.log(`  1) cd ${folder}`);
   console.log('  2) npm install');
-  console.log('  3) npm run dev     ', c('gray', '# starts tsx watcher via frontmcp dev'));
+  console.log('  3) npm run dev     ', c('gray', '# tsx watcher + async tsc type-check'));
   console.log('  4) npm run inspect ', c('gray', '# launch MCP Inspector'));
   console.log('  5) npm run build   ', c('gray', '# compile with tsc via frontmcp build'));
 }
@@ -617,7 +662,7 @@ async function main(): Promise<void> {
         await runInspector();
         break;
       case 'create': {
-        const projectName = parsed._[1]; // require a name
+        const projectName = parsed._[1];
         await runCreate(projectName);
         break;
       }