frontmcp 0.0.1 → 0.1.2

package/dist/cli.js

@@ -0,0 +1,392 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * frontmcp - FrontMCP command line interface
+ * Save as bin/frontmcp.ts (compile to JS with shebang preserved) or run with tsx.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const fs_1 = require("fs");
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const COLORS = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    dim: '\x1b[2m',
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    cyan: '\x1b[36m',
+    gray: '\x1b[90m',
+};
+const c = (color, s) => COLORS[color] + s + COLORS.reset;
+function showHelp() {
+    console.log(`
+${c('bold', 'frontmcp')} — FrontMCP command line interface
+
+${c('bold', 'Usage')}
+  frontmcp <command> [options]
+
+${c('bold', 'Commands')}
+  dev                 Start in development mode (tsx --watch <entry>)
+  build               Compile entry with TypeScript (tsc)
+  init                Create or fix a tsconfig.json suitable for FrontMCP
+  doctor              Check Node/npm versions and tsconfig presence
+  help                Show this help message
+
+${c('bold', 'Options')}
+  -o, --out-dir <dir>  Output directory (default: ./dist)
+  -e, --entry <path>   Manually specify entry file path
+
+${c('bold', 'Examples')}
+  frontmcp dev
+  frontmcp build --out-dir build
+  frontmcp init
+  frontmcp doctor
+`);
+}
+function parseArgs(argv) {
+    const out = { _: [] };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === '--out-dir' || a === '-o')
+            out.outDir = argv[++i];
+        else if (a === '--entry' || a === '-e')
+            out.entry = argv[++i];
+        else if (a === '--help' || a === '-h')
+            out.help = true;
+        else
+            out._.push(a);
+    }
+    return out;
+}
+function fileExists(p) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            yield fs_1.promises.access(p, fs.constants.F_OK);
+            return true;
+        }
+        catch (_a) {
+            return false;
+        }
+    });
+}
+function readJSON(jsonPath) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            const buf = yield fs_1.promises.readFile(jsonPath, 'utf8');
+            return JSON.parse(buf);
+        }
+        catch (_a) {
+            return null;
+        }
+    });
+}
+function tryCandidates(base) {
+    const exts = ['', '.ts', '.tsx', '.js', '.mjs', '.cjs'];
+    return exts.map((ext) => base + ext);
+}
+function resolveEntry(cwd, explicit) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (explicit) {
+            const full = path.resolve(cwd, explicit);
+            if (yield fileExists(full))
+                return full;
+            throw new Error(`Entry override not found: ${explicit}`);
+        }
+        // 1) package.json main
+        const pkgPath = path.join(cwd, 'package.json');
+        if (yield fileExists(pkgPath)) {
+            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) {
+                    if (yield fileExists(p))
+                        return p;
+                }
+                // If "main" is a directory-like path, try index.* within it
+                const asDir = path.resolve(cwd, pkg.main);
+                const idxCandidates = tryCandidates(path.join(asDir, 'index'));
+                for (const p of idxCandidates) {
+                    if (yield fileExists(p))
+                        return p;
+                }
+            }
+        }
+        // 2) src/main.ts
+        const fallback = path.join(cwd, 'src', 'main.ts');
+        if (yield fileExists(fallback))
+            return fallback;
+        // 3) Not found
+        const msg = [
+            c('red', 'No entry file found.'),
+            '',
+            'I looked for:',
+            `  • ${pkgPath} with a valid "main" field`,
+            `  • ${path.relative(cwd, fallback)}`,
+            '',
+            'Please create an entry file (e.g. src/main.ts) or set "main" in package.json,',
+            'or run with an explicit path:',
+            `  frontmcp dev --entry src/main.ts`,
+        ].join('\n');
+        throw new Error(msg);
+    });
+}
+function runCmd(cmd, args, opts = {}) {
+    return new Promise((resolve, reject) => {
+        const child = (0, child_process_1.spawn)(cmd, args, Object.assign({ stdio: 'inherit', shell: true }, opts));
+        child.on('close', (code) => (code === 0 ? resolve() : reject(new Error(`${cmd} exited with code ${code}`))));
+        child.on('error', reject);
+    });
+}
+/* --------------------------------- Actions -------------------------------- */
+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', 'hint:')} press Ctrl+C to stop`);
+        yield runCmd('npx', ['-y', 'tsx', '--watch', entry]);
+    });
+}
+function ensureDir(p) {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield fs_1.promises.mkdir(p, { recursive: true });
+    });
+}
+function isTsLike(p) {
+    return /\.tsx?$/i.test(p);
+}
+function runBuild(opts) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const cwd = process.cwd();
+        const entry = yield resolveEntry(cwd, opts.entry);
+        const outDir = path.resolve(cwd, opts.outDir || 'dist');
+        yield ensureDir(outDir);
+        console.log(`${c('cyan', '[build]')} entry: ${path.relative(cwd, entry)}`);
+        console.log(`${c('cyan', '[build]')} outDir: ${path.relative(cwd, outDir)}`);
+        const args = [];
+        args.push('--outDir', outDir);
+        args.push('--skipLibCheck');
+        args.push('--rootDir', path.dirname(entry));
+        if (!isTsLike(entry)) {
+            args.push('--allowJs');
+            console.log(c('yellow', '[build] Entry is not TypeScript; enabling --allowJs'));
+        }
+        const tsconfigPath = path.join(cwd, 'tsconfig.json');
+        if (yield fileExists(tsconfigPath)) {
+            console.log(c('gray', `[build] tsconfig.json detected (project options will be respected where applicable)`));
+        }
+        // Compile the single entry file
+        yield runCmd('npx', ['-y', 'tsc', entry, ...args]);
+        console.log(c('green', '✅ Build completed.'));
+        console.log(c('gray', `Output placed in ${path.relative(cwd, outDir)}`));
+    });
+}
+const RECOMMENDED_TSCONFIG = {
+    compilerOptions: {
+        target: 'ES2020',
+        module: 'CommonJS',
+        moduleResolution: 'Node',
+        strict: true,
+        esModuleInterop: true,
+        resolveJsonModule: true,
+        skipLibCheck: true,
+        sourceMap: true,
+        outDir: 'dist',
+        rootDir: 'src',
+        types: ['node'],
+    },
+    include: ['src/**/*'],
+};
+function deepMerge(base, patch) {
+    var _a;
+    const out = Object.assign({}, base);
+    for (const [k, v] of Object.entries(patch)) {
+        if (v && typeof v === 'object' && !Array.isArray(v)) {
+            out[k] = deepMerge((_a = base[k]) !== null && _a !== void 0 ? _a : {}, v);
+        }
+        else {
+            out[k] = v;
+        }
+    }
+    return out;
+}
+function runInit() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const cwd = process.cwd();
+        const tsconfigPath = path.join(cwd, 'tsconfig.json');
+        const existing = yield readJSON(tsconfigPath);
+        if (!existing) {
+            console.log(c('yellow', 'tsconfig.json not found — creating one.'));
+            yield fs_1.promises.writeFile(tsconfigPath, JSON.stringify(RECOMMENDED_TSCONFIG, null, 2) + '\n', 'utf8');
+            console.log(c('green', '✅ Created tsconfig.json'));
+            return;
+        }
+        // We want to ADD missing recommended fields but NOT override user's existing choices.
+        // So recommended (base) merged with existing (patch) -> existing wins.
+        const fixed = deepMerge(RECOMMENDED_TSCONFIG, existing);
+        yield fs_1.promises.writeFile(tsconfigPath, JSON.stringify(fixed, null, 2) + '\n', 'utf8');
+        console.log(c('green', '✅ tsconfig.json verified/updated'));
+    });
+}
+function cmpSemver(a, b) {
+    const pa = a.split('.').map((n) => parseInt(n, 10) || 0);
+    const pb = b.split('.').map((n) => parseInt(n, 10) || 0);
+    for (let i = 0; i < 3; i++) {
+        if ((pa[i] || 0) > (pb[i] || 0))
+            return 1;
+        if ((pa[i] || 0) < (pb[i] || 0))
+            return -1;
+    }
+    return 0;
+}
+function runDoctor() {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c;
+        const MIN_NODE = '18.0.0';
+        const MIN_NPM = '8.0.0';
+        const cwd = process.cwd();
+        let ok = true;
+        // Node
+        const nodeVer = process.versions.node;
+        if (cmpSemver(nodeVer, MIN_NODE) >= 0) {
+            console.log(`✅ Node ${nodeVer} (min ${MIN_NODE})`);
+        }
+        else {
+            ok = false;
+            console.log(`❌ Node ${nodeVer} — please upgrade to >= ${MIN_NODE}`);
+        }
+        // npm
+        let npmVer = 'unknown';
+        try {
+            npmVer = yield new Promise((resolve, reject) => {
+                var _a;
+                const child = (0, child_process_1.spawn)('npm', ['-v'], { shell: true });
+                let out = '';
+                (_a = child.stdout) === null || _a === void 0 ? void 0 : _a.on('data', (d) => (out += String(d)));
+                child.on('close', () => resolve(out.trim()));
+                child.on('error', reject);
+            });
+            if (cmpSemver(npmVer, MIN_NPM) >= 0) {
+                console.log(`✅ npm ${npmVer} (min ${MIN_NPM})`);
+            }
+            else {
+                ok = false;
+                console.log(`❌ npm ${npmVer} — please upgrade to >= ${MIN_NPM}`);
+            }
+        }
+        catch (_d) {
+            ok = false;
+            console.log('❌ npm not found in PATH');
+        }
+        // tsconfig.json presence
+        const tsconfigPath = path.join(cwd, 'tsconfig.json');
+        if (yield fileExists(tsconfigPath)) {
+            console.log(`✅ tsconfig.json found`);
+        }
+        else {
+            ok = false;
+            console.log(`❌ tsconfig.json not found — run ${c('cyan', 'frontmcp init')}`);
+        }
+        // Entry check (nice to have)
+        try {
+            const entry = yield resolveEntry(cwd);
+            console.log(`✅ entry detected: ${path.relative(cwd, entry)}`);
+        }
+        catch (e) {
+            const firstLine = (_c = (_b = (_a = e === null || e === void 0 ? void 0 : e.message) === null || _a === void 0 ? void 0 : _a.split('\n')) === null || _b === void 0 ? void 0 : _b[0]) !== null && _c !== void 0 ? _c : 'entry not found';
+            console.log(`❌ entry not detected — ${firstLine}`);
+        }
+        if (ok) {
+            console.log(c('green', '\nAll checks passed. You are ready to go!'));
+        }
+        else {
+            console.log(c('yellow', '\nSome checks failed. See above for fixes.'));
+        }
+    });
+}
+/* --------------------------------- Main ----------------------------------- */
+function main() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const argv = process.argv.slice(2);
+        const parsed = parseArgs(argv);
+        const cmd = parsed._[0];
+        if (parsed.help || !cmd) {
+            showHelp();
+            process.exit(0);
+        }
+        try {
+            switch (cmd) {
+                case 'dev':
+                    yield runDev(parsed);
+                    break;
+                case 'build':
+                    parsed.outDir = parsed.outDir || 'dist';
+                    yield runBuild(parsed);
+                    break;
+                case 'init':
+                    yield runInit();
+                    break;
+                case 'doctor':
+                    yield runDoctor();
+                    break;
+                case 'help':
+                    showHelp();
+                    break;
+                default:
+                    console.error(c('red', `Unknown command: ${cmd}`));
+                    showHelp();
+                    process.exitCode = 1;
+            }
+        }
+        catch (err) {
+            console.error('\n' + c('red', err instanceof Error ? err.stack || err.message : String(err)));
+            process.exit(1);
+        }
+    });
+}
+main();

package/dist/index.js

@@ -0,0 +1,2 @@
+"use strict";
+console.log('Happy developing ✨');

package/package.json

@@ -1,9 +1,25 @@
 {
   "name": "frontmcp",
-  "version": "0.0.1",
-  "description": "",
-  "main": "index.js",
+  "version": "0.1.2",
+  "description": "FrontMCP command line interface",
+  "main": "dist/index.js",
+  "bin": {
+    "frontmcp": "dist/cli.js"
+  },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "build": "tsc",
+    "dev": "tsx src/cli.ts",
+    "prepare": "npm run build"
+  },
+  "dependencies": {
+    "@frontmcp/sdk": "0.1.2",
+    "@frontmcp/core": "0.1.2",
+    "@frontmcp/plugins": "0.1.2",
+    "@frontmcp/adapters": "0.1.2",
+    "tsx": "^4.20.6",
+    "typescript": "^5.5.3"
+  },
+  "devDependencies": {
+    "@types/node": "20.19.9"
   }
 }

package/src/cli.ts

@@ -0,0 +1,359 @@
+#!/usr/bin/env node
+/**
+ * frontmcp - FrontMCP command line interface
+ * Save as bin/frontmcp.ts (compile to JS with shebang preserved) or run with tsx.
+ */
+
+import * as fs from 'fs';
+import {promises as fsp} from 'fs';
+import * as path from 'path';
+import {spawn} from 'child_process';
+
+/* ----------------------------- Types & Helpers ---------------------------- */
+
+type Command = 'dev' | 'build' | 'init' | 'doctor' | 'help';
+
+interface ParsedArgs {
+  _: string[];
+  outDir?: string;
+  entry?: string;
+  help?: boolean;
+}
+
+const COLORS = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  cyan: '\x1b[36m',
+  gray: '\x1b[90m',
+} as const;
+
+const c = (color: keyof typeof COLORS, s: string) => COLORS[color] + s + COLORS.reset;
+
+function showHelp(): void {
+  console.log(`
+${c('bold', 'frontmcp')} — FrontMCP command line interface
+
+${c('bold', 'Usage')}
+  frontmcp <command> [options]
+
+${c('bold', 'Commands')}
+  dev                 Start in development mode (tsx --watch <entry>)
+  build               Compile entry with TypeScript (tsc)
+  init                Create or fix a tsconfig.json suitable for FrontMCP
+  doctor              Check Node/npm versions and tsconfig presence
+  help                Show this help message
+
+${c('bold', 'Options')}
+  -o, --out-dir <dir>  Output directory (default: ./dist)
+  -e, --entry <path>   Manually specify entry file path
+
+${c('bold', 'Examples')}
+  frontmcp dev
+  frontmcp build --out-dir build
+  frontmcp init
+  frontmcp doctor
+`);
+}
+
+function parseArgs(argv: string[]): ParsedArgs {
+  const out: ParsedArgs = {_: []};
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '--out-dir' || a === '-o') out.outDir = argv[++i];
+    else if (a === '--entry' || a === '-e') out.entry = argv[++i];
+    else if (a === '--help' || a === '-h') out.help = true;
+    else out._.push(a);
+  }
+  return out;
+}
+
+async function fileExists(p: string): Promise<boolean> {
+  try {
+    await fsp.access(p, fs.constants.F_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function readJSON<T = any>(jsonPath: string): Promise<T | null> {
+  try {
+    const buf = await fsp.readFile(jsonPath, 'utf8');
+    return JSON.parse(buf) as T;
+  } catch {
+    return null;
+  }
+}
+
+function tryCandidates(base: string): string[] {
+  const exts = ['', '.ts', '.tsx', '.js', '.mjs', '.cjs'];
+  return exts.map((ext) => base + ext);
+}
+
+async function resolveEntry(cwd: string, explicit?: string): Promise<string> {
+  if (explicit) {
+    const full = path.resolve(cwd, explicit);
+    if (await fileExists(full)) return full;
+    throw new Error(`Entry override not found: ${explicit}`);
+  }
+
+  // 1) package.json main
+  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;
+      }
+      // If "main" is a directory-like path, try index.* within it
+      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;
+      }
+    }
+  }
+
+  // 2) src/main.ts
+  const fallback = path.join(cwd, 'src', 'main.ts');
+  if (await fileExists(fallback)) return fallback;
+
+  // 3) Not found
+  const msg = [
+    c('red', 'No entry file found.'),
+    '',
+    'I looked for:',
+    `  • ${pkgPath} with a valid "main" field`,
+    `  • ${path.relative(cwd, fallback)}`,
+    '',
+    'Please create an entry file (e.g. src/main.ts) or set "main" in package.json,',
+    'or run with an explicit path:',
+    `  frontmcp dev --entry src/main.ts`,
+  ].join('\n');
+  throw new Error(msg);
+}
+
+function runCmd(cmd: string, args: string[], opts: { cwd?: string } = {}): Promise<void> {
+  return new Promise((resolve, reject) => {
+    const child = spawn(cmd, args, {stdio: 'inherit', shell: true, ...opts});
+    child.on('close', (code) => (code === 0 ? resolve() : reject(new Error(`${cmd} exited with code ${code}`))));
+    child.on('error', reject);
+  });
+}
+
+/* --------------------------------- Actions -------------------------------- */
+
+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', 'hint:')} press Ctrl+C to stop`);
+  await runCmd('npx', ['-y', 'tsx', '--watch', entry]);
+}
+
+async function ensureDir(p: string): Promise<void> {
+  await fsp.mkdir(p, {recursive: true});
+}
+
+function isTsLike(p: string): boolean {
+  return /\.tsx?$/i.test(p);
+}
+
+async function runBuild(opts: ParsedArgs): Promise<void> {
+  const cwd = process.cwd();
+  const entry = await resolveEntry(cwd, opts.entry);
+  const outDir = path.resolve(cwd, opts.outDir || 'dist');
+  await ensureDir(outDir);
+
+  console.log(`${c('cyan', '[build]')} entry: ${path.relative(cwd, entry)}`);
+  console.log(`${c('cyan', '[build]')} outDir: ${path.relative(cwd, outDir)}`);
+
+  const args: string[] = [];
+  args.push('--outDir', outDir);
+  args.push('--skipLibCheck');
+  args.push('--rootDir', path.dirname(entry));
+
+  if (!isTsLike(entry)) {
+    args.push('--allowJs');
+    console.log(c('yellow', '[build] Entry is not TypeScript; enabling --allowJs'));
+  }
+
+  const tsconfigPath = path.join(cwd, 'tsconfig.json');
+  if (await fileExists(tsconfigPath)) {
+    console.log(c('gray', `[build] tsconfig.json detected (project options will be respected where applicable)`));
+  }
+
+  // Compile the single entry file
+  await runCmd('npx', ['-y', 'tsc', entry, ...args]);
+  console.log(c('green', '✅ Build completed.'));
+  console.log(c('gray', `Output placed in ${path.relative(cwd, outDir)}`));
+}
+
+const RECOMMENDED_TSCONFIG = {
+  compilerOptions: {
+    target: 'ES2020',
+    module: 'CommonJS',
+    moduleResolution: 'Node',
+    strict: true,
+    esModuleInterop: true,
+    resolveJsonModule: true,
+    skipLibCheck: true,
+    sourceMap: true,
+    outDir: 'dist',
+    rootDir: 'src',
+    types: ['node'],
+  },
+  include: ['src/**/*'],
+} as const;
+
+function deepMerge<T extends Record<string, any>, U extends Record<string, any>>(base: T, patch: U): T & U {
+  const out: Record<string, any> = {...base};
+  for (const [k, v] of Object.entries(patch)) {
+    if (v && typeof v === 'object' && !Array.isArray(v)) {
+      out[k] = deepMerge(base[k] ?? {}, v as Record<string, any>);
+    } else {
+      out[k] = v;
+    }
+  }
+  return out as T & U;
+}
+
+async function runInit(): Promise<void> {
+  const cwd = process.cwd();
+  const tsconfigPath = path.join(cwd, 'tsconfig.json');
+  const existing = await readJSON<Record<string, any>>(tsconfigPath);
+
+  if (!existing) {
+    console.log(c('yellow', 'tsconfig.json not found — creating one.'));
+    await fsp.writeFile(tsconfigPath, JSON.stringify(RECOMMENDED_TSCONFIG, null, 2) + '\n', 'utf8');
+    console.log(c('green', '✅ Created tsconfig.json'));
+    return;
+  }
+
+  // We want to ADD missing recommended fields but NOT override user's existing choices.
+  // So recommended (base) merged with existing (patch) -> existing wins.
+  const fixed = deepMerge(RECOMMENDED_TSCONFIG as any, existing);
+  await fsp.writeFile(tsconfigPath, JSON.stringify(fixed, null, 2) + '\n', 'utf8');
+  console.log(c('green', '✅ tsconfig.json verified/updated'));
+}
+
+function cmpSemver(a: string, b: string): number {
+  const pa = a.split('.').map((n) => parseInt(n, 10) || 0);
+  const pb = b.split('.').map((n) => parseInt(n, 10) || 0);
+  for (let i = 0; i < 3; i++) {
+    if ((pa[i] || 0) > (pb[i] || 0)) return 1;
+    if ((pa[i] || 0) < (pb[i] || 0)) return -1;
+  }
+  return 0;
+}
+
+async function runDoctor(): Promise<void> {
+  const MIN_NODE = '18.0.0';
+  const MIN_NPM = '8.0.0';
+  const cwd = process.cwd();
+
+  let ok = true;
+
+  // Node
+  const nodeVer = process.versions.node;
+  if (cmpSemver(nodeVer, MIN_NODE) >= 0) {
+    console.log(`✅ Node ${nodeVer} (min ${MIN_NODE})`);
+  } else {
+    ok = false;
+    console.log(`❌ Node ${nodeVer} — please upgrade to >= ${MIN_NODE}`);
+  }
+
+  // npm
+  let npmVer = 'unknown';
+  try {
+    npmVer = await new Promise<string>((resolve, reject) => {
+      const child = spawn('npm', ['-v'], {shell: true});
+      let out = '';
+      child.stdout?.on('data', (d) => (out += String(d)));
+      child.on('close', () => resolve(out.trim()));
+      child.on('error', reject);
+    });
+    if (cmpSemver(npmVer, MIN_NPM) >= 0) {
+      console.log(`✅ npm ${npmVer} (min ${MIN_NPM})`);
+    } else {
+      ok = false;
+      console.log(`❌ npm ${npmVer} — please upgrade to >= ${MIN_NPM}`);
+    }
+  } catch {
+    ok = false;
+    console.log('❌ npm not found in PATH');
+  }
+
+  // tsconfig.json presence
+  const tsconfigPath = path.join(cwd, 'tsconfig.json');
+  if (await fileExists(tsconfigPath)) {
+    console.log(`✅ tsconfig.json found`);
+  } else {
+    ok = false;
+    console.log(`❌ tsconfig.json not found — run ${c('cyan', 'frontmcp init')}`);
+  }
+
+  // Entry check (nice to have)
+  try {
+    const entry = await resolveEntry(cwd);
+    console.log(`✅ entry detected: ${path.relative(cwd, entry)}`);
+  } catch (e: any) {
+    const firstLine = (e?.message as string | undefined)?.split('\n')?.[0] ?? 'entry not found';
+    console.log(`❌ entry not detected — ${firstLine}`);
+  }
+
+  if (ok) {
+    console.log(c('green', '\nAll checks passed. You are ready to go!'));
+  } else {
+    console.log(c('yellow', '\nSome checks failed. See above for fixes.'));
+  }
+}
+
+/* --------------------------------- Main ----------------------------------- */
+
+async function main(): Promise<void> {
+  const argv = process.argv.slice(2);
+  const parsed = parseArgs(argv);
+  const cmd = parsed._[0] as Command | undefined;
+
+  if (parsed.help || !cmd) {
+    showHelp();
+    process.exit(0);
+  }
+
+  try {
+    switch (cmd) {
+      case 'dev':
+        await runDev(parsed);
+        break;
+      case 'build':
+        parsed.outDir = parsed.outDir || 'dist';
+        await runBuild(parsed);
+        break;
+      case 'init':
+        await runInit();
+        break;
+      case 'doctor':
+        await runDoctor();
+        break;
+      case 'help':
+        showHelp();
+        break;
+      default:
+        console.error(c('red', `Unknown command: ${cmd}`));
+        showHelp();
+        process.exitCode = 1;
+    }
+  } catch (err: any) {
+    console.error('\n' + c('red', err instanceof Error ? err.stack || err.message : String(err)));
+    process.exit(1);
+  }
+}
+
+main();

package/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "es2016",
+    "module": "commonjs",
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "outDir": "dist"
+  },
+  "include": [
+    "src"
+  ]
+}

package/.idea/copilot.data.migration.agent.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="AgentMigrationStateService">
-    <option name="migrationStatus" value="COMPLETED" />
-  </component>
-</project>

package/.idea/copilot.data.migration.ask.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="AskMigrationStateService">
-    <option name="migrationStatus" value="COMPLETED" />
-  </component>
-</project>

package/.idea/copilot.data.migration.ask2agent.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="Ask2AgentMigrationStateService">
-    <option name="migrationStatus" value="COMPLETED" />
-  </component>
-</project>

package/.idea/copilot.data.migration.edit.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="EditMigrationStateService">
-    <option name="migrationStatus" value="COMPLETED" />
-  </component>
-</project>

package/.idea/mcp.iml

@@ -1,12 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<module type="WEB_MODULE" version="4">
-  <component name="NewModuleRootManager">
-    <content url="file://$MODULE_DIR$">
-      <excludeFolder url="file://$MODULE_DIR$/.tmp" />
-      <excludeFolder url="file://$MODULE_DIR$/temp" />
-      <excludeFolder url="file://$MODULE_DIR$/tmp" />
-    </content>
-    <orderEntry type="inheritedJdk" />
-    <orderEntry type="sourceFolder" forTests="false" />
-  </component>
-</module>

package/.idea/modules.xml

@@ -1,8 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="ProjectModuleManager">
-    <modules>
-      <module fileurl="file://$PROJECT_DIR$/.idea/mcp.iml" filepath="$PROJECT_DIR$/.idea/mcp.iml" />
-    </modules>
-  </component>
-</project>

package/.idea/vcs.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="VcsDirectoryMappings">
-    <mapping directory="$PROJECT_DIR$" vcs="Git" />
-  </component>
-</project>