@sightmap/sightmap 0.5.0 → 0.5.1

package/dist/cli/index.js

@@ -1499,9 +1499,9 @@ async function processFile(absPath, relPath, opts, fileResults, diagnostics) {
 
 // src/cli/init/index.ts
 import { resolve as resolve22 } from "path";
-import { mkdir as mkdir4, readFile as readFile13, rm, writeFile as writeFile7 } from "fs/promises";
+import { mkdir as mkdir4, readFile as readFile14, rm, writeFile as writeFile7 } from "fs/promises";
 import { tmpdir } from "os";
-import * as clack2 from "@clack/prompts";
+import * as clack3 from "@clack/prompts";
 
 // src/cli/init/detect/framework.ts
 import { readFile as readFile4, access } from "fs/promises";
@@ -2232,9 +2232,11 @@ function resolveTargets(host, projectDir) {
 }
 
 // src/cli/init/version-pin.ts
+var DEFAULT_LAUNCHER = { pm: "npm", command: "npx", runArgs: ["-y"] };
 function buildSightmapMcpServerDef(opts) {
+  const launcher = opts.launcher ?? DEFAULT_LAUNCHER;
   const args = [
-    "-y",
+    ...launcher.runArgs,
     `@sightmap/mcp@${opts.compatibleMcpVersion}`,
     "--sightmap-dir",
     opts.sightmapDir,
@@ -2242,19 +2244,150 @@ function buildSightmapMcpServerDef(opts) {
     opts.curateRoot
   ];
   if (opts.withBrowser) {
-    args.push("--", "npx", "-y", "@playwright/mcp@latest");
+    args.push("--", launcher.command, ...launcher.runArgs, "@playwright/mcp@latest");
   } else {
     args.push("--curate-only");
   }
   return {
-    command: "npx",
+    command: launcher.command,
     args,
     env: { SIGHTMAP_PLUGIN_VERSION: opts.pluginVersion }
   };
 }
 
+// src/cli/init/smoke-mcp.ts
+import { spawn } from "child_process";
+import * as clack2 from "@clack/prompts";
+import pc2 from "picocolors";
+var DEFAULT_TIMEOUT_MS = 15e3;
+var INITIALIZE_PAYLOAD = {
+  jsonrpc: "2.0",
+  id: 1,
+  method: "initialize",
+  params: {
+    protocolVersion: "2024-11-05",
+    capabilities: {},
+    clientInfo: { name: "sightmap-init-smoke", version: "1.0.0" }
+  }
+};
+async function runSmokeTest(opts) {
+  const startedAt = Date.now();
+  const timeout = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  return new Promise((resolveResult) => {
+    let settled = false;
+    const settle = (r) => {
+      if (settled) return;
+      settled = true;
+      try {
+        child.kill("SIGTERM");
+      } catch {
+      }
+      resolveResult(r);
+    };
+    const child = spawn(opts.serverDef.command, opts.serverDef.args, {
+      cwd: opts.cwd,
+      env: { ...process.env, ...opts.serverDef.env },
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    let stdoutBuf = "";
+    let stderrBuf = "";
+    child.stdout?.on("data", (chunk) => {
+      stdoutBuf += chunk.toString("utf8");
+      let nl;
+      while ((nl = stdoutBuf.indexOf("\n")) !== -1) {
+        const line = stdoutBuf.slice(0, nl).trim();
+        stdoutBuf = stdoutBuf.slice(nl + 1);
+        if (!line) continue;
+        try {
+          const msg = JSON.parse(line);
+          if (msg.id === 1 && msg.result) {
+            settle({ ok: true, latencyMs: Date.now() - startedAt });
+            return;
+          }
+          if (msg.id === 1 && msg.error) {
+            settle({
+              ok: false,
+              reason: `Server returned JSON-RPC error: ${JSON.stringify(msg.error)}`,
+              latencyMs: Date.now() - startedAt
+            });
+            return;
+          }
+        } catch {
+        }
+      }
+    });
+    child.stderr?.on("data", (chunk) => {
+      stderrBuf += chunk.toString("utf8");
+    });
+    child.on("error", (err) => {
+      settle({
+        ok: false,
+        reason: `Failed to spawn: ${err.message}`,
+        latencyMs: Date.now() - startedAt,
+        ...stderrBuf ? { stderr: stderrBuf } : {}
+      });
+    });
+    child.on("exit", (code, signal) => {
+      if (settled) return;
+      settle({
+        ok: false,
+        reason: stdoutBuf.length === 0 && stderrBuf.length === 0 ? `Spawn produced no output and exited (code=${code ?? "?"}, signal=${signal ?? "?"}). This is the silent-stdin bug \u2014 try a different package manager launcher.` : `Process exited before initialize response (code=${code ?? "?"}, signal=${signal ?? "?"})`,
+        latencyMs: Date.now() - startedAt,
+        ...stderrBuf ? { stderr: stderrBuf } : {}
+      });
+    });
+    setTimeout(() => {
+      settle({
+        ok: false,
+        reason: `Timed out after ${timeout}ms waiting for initialize response`,
+        latencyMs: Date.now() - startedAt,
+        ...stderrBuf ? { stderr: stderrBuf } : {}
+      });
+    }, timeout);
+    try {
+      child.stdin?.write(JSON.stringify(INITIALIZE_PAYLOAD) + "\n");
+      child.stdin?.end();
+    } catch (e) {
+      settle({
+        ok: false,
+        reason: `Failed to write initialize payload: ${e.message}`,
+        latencyMs: Date.now() - startedAt
+      });
+    }
+  });
+}
+async function smokeTestMcp(opts) {
+  const spinner3 = clack2.spinner();
+  spinner3.start("Verifying MCP can launch");
+  const result = await runSmokeTest(opts);
+  if (result.ok) {
+    spinner3.stop(`MCP ready (initialized in ${result.latencyMs}ms)`);
+    return;
+  }
+  spinner3.stop("MCP smoke test failed");
+  const cmd = `${opts.serverDef.command} ${opts.serverDef.args.join(" ")}`;
+  const lines = [
+    pc2.bold("Could not start the MCP server."),
+    "",
+    pc2.cyan("Reason:") + " " + result.reason,
+    pc2.cyan("Command:") + " " + pc2.white(cmd)
+  ];
+  if (result.stderr) {
+    lines.push("", pc2.cyan("stderr:"));
+    for (const ln of result.stderr.trim().split("\n").slice(0, 6)) {
+      lines.push("  " + pc2.dim(ln));
+    }
+  }
+  lines.push(
+    "",
+    pc2.dim("The config was written. You can retry by restarting your agent."),
+    pc2.dim("Re-run `npx @sightmap/sightmap init --no-smoke` to skip this check next time.")
+  );
+  clack2.log.warn(lines.join("\n"));
+}
+
 // src/cli/init/framework-setup/package-manager.ts
-import { access as access10 } from "fs/promises";
+import { access as access10, readFile as readFile13 } from "fs/promises";
 import { dirname as dirname4, resolve as resolve21 } from "path";
 async function exists4(p) {
   try {
@@ -2265,6 +2398,9 @@ async function exists4(p) {
   }
 }
 var SIGNALS = [
+  // Bun first — bun.lock can coexist with package-lock.json during migration.
+  { file: "bun.lock", pm: "bun" },
+  { file: "bun.lockb", pm: "bun" },
   { file: "pnpm-lock.yaml", pm: "pnpm" },
   { file: "pnpm-workspace.yaml", pm: "pnpm" },
   { file: "yarn.lock", pm: "yarn" }
@@ -2280,17 +2416,56 @@ async function detectPackageManager(cwd) {
     dir = parent;
   }
 }
+async function detectLauncher(cwd) {
+  const pm = await detectPackageManager(cwd);
+  if (pm === "bun") return { pm, command: "bunx", runArgs: [] };
+  if (pm === "pnpm") return { pm, command: "pnpm", runArgs: ["dlx"] };
+  if (pm === "yarn") {
+    if (await isYarnBerry(cwd)) {
+      return { pm, command: "yarn", runArgs: ["dlx"] };
+    }
+    return { pm: "npm", command: "npx", runArgs: ["-y"] };
+  }
+  return { pm: "npm", command: "npx", runArgs: ["-y"] };
+}
+async function isYarnBerry(cwd) {
+  let dir = resolve21(cwd);
+  while (true) {
+    if (await exists4(resolve21(dir, ".yarnrc.yml"))) return true;
+    const parent = dirname4(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  dir = resolve21(cwd);
+  while (true) {
+    const pkg = resolve21(dir, "package.json");
+    if (await exists4(pkg)) {
+      try {
+        const parsed = JSON.parse(await readFile13(pkg, "utf8"));
+        const pmField = parsed.packageManager ?? "";
+        const match2 = /^yarn@(\d+)\./.exec(pmField);
+        if (match2 && Number(match2[1]) >= 2) return true;
+      } catch {
+      }
+    }
+    const parent = dirname4(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return false;
+}
 
 // src/cli/init/framework-setup/install-adapter.ts
-import { spawn } from "child_process";
+import { spawn as spawn2 } from "child_process";
 var ADD_VERB = {
   pnpm: "add",
   yarn: "add",
-  npm: "install"
+  npm: "install",
+  bun: "add"
 };
 async function installAdapter(opts) {
   await new Promise((resolveP, reject) => {
-    const child = spawn(opts.packageManager, [ADD_VERB[opts.packageManager], opts.packageName], {
+    const child = spawn2(opts.packageManager, [ADD_VERB[opts.packageManager], opts.packageName], {
       cwd: opts.cwd,
       stdio: "inherit"
     });
@@ -2300,12 +2475,13 @@ async function installAdapter(opts) {
 }
 
 // src/cli/init/framework-setup/codegen.ts
-import { spawn as spawn2 } from "child_process";
+import { spawn as spawn3 } from "child_process";
 var REACT_FRAMEWORKS = ["react-vite", "react-cra", "next-app", "next-pages", "react-router-7"];
 var EXEC_VERB = {
   pnpm: ["exec"],
   yarn: ["exec"],
-  npm: ["exec", "--"]
+  npm: ["exec", "--"],
+  bun: ["x"]
 };
 function buildCodegenCommand(opts) {
   if (!REACT_FRAMEWORKS.includes(opts.framework)) return null;
@@ -2316,7 +2492,7 @@ function buildCodegenCommand(opts) {
 }
 async function runCodegen(cwd, cmd) {
   await new Promise((resolveP, reject) => {
-    const child = spawn2(cmd.command, cmd.args, { cwd, stdio: "inherit" });
+    const child = spawn3(cmd.command, cmd.args, { cwd, stdio: "inherit" });
     child.on("error", reject);
     child.on("exit", (code) => code === 0 ? resolveP() : reject(new Error(`codegen exited ${code}`)));
   });
@@ -2473,7 +2649,7 @@ async function runInit(opts) {
     if (typeof chosen === "symbol") return 1;
     if (chosen) {
       opts = { ...opts, cwd: chosen.dir };
-      clack2.log.info(`Targeting workspace: ${chosen.relPath}`);
+      clack3.log.info(`Targeting workspace: ${chosen.relPath}`);
       detect = {
         framework: await detectFramework(opts.cwd),
         hosts: detect.hosts,
@@ -2511,17 +2687,22 @@ async function runInit(opts) {
   await mkdir4(tarballDir, { recursive: true });
   try {
     const tar = await fetchPluginTarball({ destDir: tarballDir, version: "latest" });
+    const launcher = await detectLauncher(opts.cwd);
     const serverDef = buildSightmapMcpServerDef({
       compatibleMcpVersion: tar.compatibleMcpVersion,
       pluginVersion: tar.pluginVersion,
       withBrowser,
       sightmapDir: ".sightmap",
-      curateRoot: ".sightmap"
+      curateRoot: ".sightmap",
+      launcher
     });
     for (const h of hosts) {
       await writeMcpForHost(h, opts.cwd, serverDef);
       await copyPluginAssets({ tarballDir, projectDir: opts.cwd, host: h });
     }
+    if (!opts.noSmoke) {
+      await smokeTestMcp({ serverDef, cwd: opts.cwd });
+    }
   } finally {
     await rm(tarballDir, { recursive: true, force: true });
   }
@@ -2541,19 +2722,19 @@ views: []
     return;
   }
   const pm = await detectPackageManager(opts.cwd);
-  const spinner2 = clack2.spinner();
-  spinner2.start(`Installing @sightmap/react via ${pm}`);
+  const spinner3 = clack3.spinner();
+  spinner3.start(`Installing @sightmap/react via ${pm}`);
   await installAdapter({ cwd: opts.cwd, packageManager: pm, packageName: "@sightmap/react" });
-  spinner2.stop("Installed @sightmap/react");
+  spinner3.stop("Installed @sightmap/react");
   if (!opts.noProvider) {
     await runProviderStep(opts, detect);
   }
   if (!opts.noCodegen) {
     const cmd = buildCodegenCommand({ framework: detect.framework, packageManager: pm });
     if (cmd) {
-      spinner2.start("Running sightmap-react gen");
+      spinner3.start("Running sightmap-react gen");
       await runCodegen(opts.cwd, cmd);
-      spinner2.stop("Scaffolded .sightmap/");
+      spinner3.stop("Scaffolded .sightmap/");
     }
   }
 }
@@ -2568,7 +2749,7 @@ async function runProviderStep(opts, detect) {
     showProviderSnippet(snippet, "We couldn't locate the entry file \u2014 drop these lines into your app's root.");
     return;
   }
-  const source = await readFile13(entry, "utf8");
+  const source = await readFile14(entry, "utf8");
   const result = wrapWithSightmapProvider(source, { framework: detect.framework });
   if (!result.changed) {
     const snippet = renderProviderSnippet({
@@ -2613,7 +2794,7 @@ async function findAppEntry(cwd, framework) {
   for (const rel of candidates[framework]) {
     const abs = resolve22(cwd, rel);
     try {
-      await readFile13(abs, "utf8");
+      await readFile14(abs, "utf8");
       return abs;
     } catch {
     }
@@ -2621,13 +2802,13 @@ async function findAppEntry(cwd, framework) {
   return null;
 }
 async function runExistingCorpusFlow(cwd, viewCount) {
-  const spinner2 = clack2.spinner();
-  spinner2.start("Auditing existing corpus...");
+  const spinner3 = clack3.spinner();
+  spinner3.start("Auditing existing corpus...");
   await runLint({ path: ".sightmap", cwd, json: false, strict: false });
-  spinner2.stop("Audit complete");
+  spinner3.stop("Audit complete");
   const header = `${viewCount} view${viewCount === 1 ? "" : "s"}`;
   const body = formatExistingCorpusReport({ viewCount, diagnostics: [] });
-  clack2.log.message(`${header}
+  clack3.log.message(`${header}
 
 ${body}`);
 }
@@ -2660,7 +2841,7 @@ async function maybePickWorkspace(opts) {
   if (withFramework.length === 0) return null;
   if (opts.yes) {
     if (withFramework.length === 1) return withFramework[0];
-    clack2.log.warn(
+    clack3.log.warn(
       `Found ${withFramework.length} workspaces with a framework. Re-run from one of them, or without -y to pick interactively.`
     );
     return null;
@@ -2774,7 +2955,7 @@ program.command("fmt [path]").description("Canonicalize .sightmap/*.yaml files (
     process.exit(code);
   }
 );
-program.command("init").description("Initialize Sightmap in this project (detects framework + coding agent, writes config).").option("--yes", "accept all defaults (non-interactive)").option("--plugin", "force plugin install path").option("--manual", "force manual install path").option("--host <names>", "comma-separated hosts: claude-code,codex,cursor,opencode").option("--with-browser", "force bundled Playwright + browser tools").option("--curate-only", "force curation-only (skip browser tools)").option("--no-codegen", "skip sightmap-react gen").option("--no-provider", "skip <SightmapProvider> codemod").action(async (opts) => {
+program.command("init").description("Initialize Sightmap in this project (detects framework + coding agent, writes config).").option("--yes", "accept all defaults (non-interactive)").option("--plugin", "force plugin install path").option("--manual", "force manual install path").option("--host <names>", "comma-separated hosts: claude-code,codex,cursor,opencode").option("--with-browser", "force bundled Playwright + browser tools").option("--curate-only", "force curation-only (skip browser tools)").option("--no-codegen", "skip sightmap-react gen").option("--no-provider", "skip <SightmapProvider> codemod").option("--no-smoke", "skip the MCP launch smoke test (CI / headless use)").action(async (opts) => {
   const code = await runInit({
     cwd: program.opts().cwd,
     yes: opts.yes === true,
@@ -2784,7 +2965,8 @@ program.command("init").description("Initialize Sightmap in this project (detect
     ...opts.withBrowser ? { withBrowser: true } : {},
     ...opts.curateOnly ? { curateOnly: true } : {},
     ...opts.codegen === false ? { noCodegen: true } : {},
-    ...opts.provider === false ? { noProvider: true } : {}
+    ...opts.provider === false ? { noProvider: true } : {},
+    ...opts.smoke === false ? { noSmoke: true } : {}
   });
   process.exit(code);
 });