doc2mcp 0.1.18 → 0.1.19

package/dist/index.js

@@ -2,7 +2,7 @@
 
 // src/index.ts
 import { Command } from "commander";
-import pc7 from "picocolors";
+import pc8 from "picocolors";
 
 // src/commands/account.ts
 import pc from "picocolors";
@@ -77,7 +77,7 @@ async function runWhoami() {
 import { createInterface } from "readline/promises";
 import { stdin as input, stdout as output } from "process";
 import ora2 from "ora";
-import pc6 from "picocolors";
+import pc7 from "picocolors";
 
 // src/api.ts
 import pc2 from "picocolors";
@@ -139,13 +139,85 @@ function printError(error) {
 `);
 }
 
+// src/markdown.ts
+import pc3 from "picocolors";
+var LINK = /\[([^\]]+)\]\(([^)]+)\)/g;
+var INLINE_CODE = /`([^`]+)`/g;
+var BOLD = /\*\*([^*]+)\*\*/g;
+var ITALIC = /(^|[^*])\*([^*\n]+)\*/g;
+var HEADING = /^(#{1,6})\s+(.*)$/;
+var BULLET = /^(\s*)[-*]\s+(.*)$/;
+var ORDERED = /^(\s*)(\d+)\.\s+(.*)$/;
+var FENCE = /^```(\w*)\s*$/;
+var BLOCKQUOTE = /^>\s?(.*)$/;
+function renderInline(text) {
+  let out = text.replace(
+    LINK,
+    (_m, label, url) => `${pc3.cyan(pc3.underline(label))} ${pc3.dim(`(${url})`)}`
+  );
+  out = out.replace(INLINE_CODE, (_m, code) => pc3.yellow(code));
+  out = out.replace(BOLD, (_m, bold) => pc3.bold(bold));
+  out = out.replace(
+    ITALIC,
+    (_m, prefix, italic) => `${prefix}${pc3.italic(italic)}`
+  );
+  return out;
+}
+function renderMarkdown(markdown) {
+  const lines = markdown.split("\n");
+  const out = [];
+  let inCode = false;
+  for (const line of lines) {
+    const fence = line.match(FENCE);
+    if (fence) {
+      if (inCode) {
+        out.push(pc3.dim("    \u2514\u2500\u2500\u2500\u2500\u2500\u2500"));
+        inCode = false;
+      } else {
+        const lang = fence[1] || "code";
+        out.push(pc3.dim(`    \u250C\u2500\u2500\u2500\u2500\u2500\u2500 ${lang}`));
+        inCode = true;
+      }
+      continue;
+    }
+    if (inCode) {
+      out.push(`    ${pc3.green(line)}`);
+      continue;
+    }
+    const heading = line.match(HEADING);
+    if (heading) {
+      out.push(pc3.bold(pc3.cyan(renderInline(heading[2] ?? ""))));
+      continue;
+    }
+    const ordered = line.match(ORDERED);
+    if (ordered) {
+      out.push(
+        `${ordered[1] ?? ""}${pc3.cyan(`${ordered[2] ?? ""}.`)} ${renderInline(ordered[3] ?? "")}`
+      );
+      continue;
+    }
+    const bullet = line.match(BULLET);
+    if (bullet) {
+      out.push(`${bullet[1] ?? ""}${pc3.cyan("\u2022")} ${renderInline(bullet[2] ?? "")}`);
+      continue;
+    }
+    const quote = line.match(BLOCKQUOTE);
+    if (quote) {
+      out.push(`${pc3.dim("\u2502")} ${pc3.dim(renderInline(quote[1] ?? ""))}`);
+      continue;
+    }
+    out.push(renderInline(line));
+  }
+  return out.join("\n");
+}
+
 // src/commands/convert.ts
-import pc5 from "picocolors";
+import pc6 from "picocolors";
 
 // src/commands/login.ts
 import open from "open";
 import ora from "ora";
-import pc3 from "picocolors";
+import pc4 from "picocolors";
 function sleep(ms) {
   return new Promise((resolve) => {
     setTimeout(resolve, ms);
@@ -163,13 +235,13 @@ async function runLogin() {
     spinner.stop();
     process.stdout.write(
       `
-${pc3.cyan("Open this link to authorize:")}
-${pc3.bold(start.verifyUrl)}
+${pc4.cyan("Open this link to authorize:")}
+${pc4.bold(start.verifyUrl)}
 
 `
     );
     process.stdout.write(
-      `${pc3.dim("Code:")} ${pc3.bold(start.userCode)}  ${pc3.dim("(also shown in browser)")}
+      `${pc4.dim("Code:")} ${pc4.bold(start.userCode)}  ${pc4.dim("(also shown in browser)")}
 
 `
     );
@@ -177,7 +249,7 @@ ${pc3.bold(start.verifyUrl)}
       await open(start.verifyUrl);
     } catch {
       process.stdout.write(
-        `${pc3.yellow("Could not auto-open browser. Open the link manually.")}
+        `${pc4.yellow("Could not auto-open browser. Open the link manually.")}
 
 `
       );
@@ -203,7 +275,7 @@ ${pc3.bold(start.verifyUrl)}
           user: poll.user
         });
         process.stdout.write(
-          `${pc3.green("Logged in as")} ${poll.user.email}
+          `${pc4.green("Logged in as")} ${poll.user.email}
 `
         );
         return;
@@ -238,7 +310,7 @@ async function ensureLoggedIn() {
 
 // src/commands/install.ts
 import { confirm, multiselect } from "@clack/prompts";
-import pc4 from "picocolors";
+import pc5 from "picocolors";
 
 // src/installers/detect.ts
 import { access } from "fs/promises";
@@ -425,8 +497,8 @@ async function promptInstall(install) {
     }
     await installToClient(client.id, client.configPath, install);
     process.stdout.write(
-      `${pc4.green("Installed")} ${client.label}
-${pc4.dim(client.configPath)}
+      `${pc5.green("Installed")} ${client.label}
+${pc5.dim(client.configPath)}
 `
     );
   }
@@ -436,7 +508,7 @@ async function runInstallCommand(projectId) {
     await ensureLoggedIn();
     const detail = await apiFetch(`/api/cli/projects/${projectId}`);
     if (!detail.install) {
-      process.stderr.write(`${pc4.red("Project is not ready or missing install bundle.")}
+      process.stderr.write(`${pc5.red("Project is not ready or missing install bundle.")}
 `);
       process.exitCode = 1;
       return;
@@ -457,18 +529,18 @@ function sleep2(ms) {
 function printStatus(detail) {
   const { project } = detail;
   process.stdout.write(
-    `\r${pc5.cyan("Status:")} ${project.status.padEnd(12)} ${pc5.dim(project.name)}`
+    `\r${pc6.cyan("Status:")} ${project.status.padEnd(12)} ${pc6.dim(project.name)}`
   );
 }
 async function convertUrlToProject(sourceUrl, options = { offerInstall: true }) {
   await ensureLoggedIn();
-  process.stdout.write(`${pc5.bold("Converting")} ${sourceUrl}
+  process.stdout.write(`${pc6.bold("Converting")} ${sourceUrl}
 `);
   const created = await apiFetch("/api/cli/convert", {
     method: "POST",
     body: JSON.stringify({ sourceUrl })
   });
-  process.stdout.write(`${pc5.dim("Project:")} ${created.id}
+  process.stdout.write(`${pc6.dim("Project:")} ${created.id}
 `);
   let delayMs = 2e3;
   const terminal = /* @__PURE__ */ new Set(["ready", "error"]);
@@ -490,29 +562,29 @@ async function convertUrlToProject(sourceUrl, options = { offerInstall: true })
   if (finalDetail.project.status === "error") {
     const lastLog = finalDetail.project.logs.at(-1);
     process.stderr.write(
-      `${pc5.red("Conversion failed.")}${lastLog ? ` ${lastLog.message}` : ""}
+      `${pc6.red("Conversion failed.")}${lastLog ? ` ${lastLog.message}` : ""}
 `
     );
     process.exitCode = 1;
     return null;
   }
   if (!finalDetail.mcp || !finalDetail.install) {
-    process.stderr.write(`${pc5.red("MCP ready but missing install bundle.")}
+    process.stderr.write(`${pc6.red("MCP ready but missing install bundle.")}
 `);
     process.exitCode = 1;
     return null;
   }
   process.stdout.write(`
-${pc5.green("MCP ready")}
+${pc6.green("MCP ready")}
 `);
-  process.stdout.write(`${pc5.bold("Server:")} ${finalDetail.mcp.serverName}
+  process.stdout.write(`${pc6.bold("Server:")} ${finalDetail.mcp.serverName}
 `);
-  process.stdout.write(`${pc5.bold("URL:")} ${finalDetail.mcp.url}
+  process.stdout.write(`${pc6.bold("URL:")} ${finalDetail.mcp.url}
 `);
-  process.stdout.write(`${pc5.bold("Token:")} ${finalDetail.mcp.token}
+  process.stdout.write(`${pc6.bold("Token:")} ${finalDetail.mcp.token}
 `);
   process.stdout.write(
-    `${pc5.dim("Also listed in the doc2mcp marketplace when ready.")}
+    `${pc6.dim("Also listed in the doc2mcp marketplace when ready.")}
 `
   );
   if (options.offerInstall) {
@@ -533,16 +605,16 @@ async function runList() {
     await ensureLoggedIn();
     const data = await apiFetch("/api/cli/projects");
     if (data.projects.length === 0) {
-      process.stdout.write(`${pc5.dim("No projects yet.")}
+      process.stdout.write(`${pc6.dim("No projects yet.")}
 `);
       return;
     }
     for (const project of data.projects) {
       process.stdout.write(
-        `${pc5.bold(project.name)} ${pc5.dim(`[${project.status}]`)} ${project.source}
+        `${pc6.bold(project.name)} ${pc6.dim(`[${project.status}]`)} ${project.source}
 `
       );
-      process.stdout.write(`  ${pc5.dim(project.id)} ${project.sourceUrl ?? ""}
+      process.stdout.write(`  ${pc6.dim(project.id)} ${project.sourceUrl ?? ""}
 `);
     }
   } catch (error) {
@@ -584,27 +656,27 @@ async function pickExistingProject() {
   const ready = await listReadyProjects();
   if (ready.length === 0) {
     process.stdout.write(
-      `${pc6.yellow("No ready MCP projects yet.")} Paste a docs URL to create one.
+      `${pc7.yellow("No ready MCP projects yet.")} Paste a docs URL to create one.
 `
     );
     return null;
   }
-  process.stdout.write(`${pc6.dim("Ready MCPs")}
+  process.stdout.write(`${pc7.dim("Ready MCPs")}
 `);
   ready.forEach((p, index) => {
     process.stdout.write(
-      `  ${pc6.cyan(String(index + 1).padStart(2, " "))}. ${pc6.bold(p.name)} ${pc6.dim(p.sourceUrl ?? p.id)}
+      `  ${pc7.cyan(String(index + 1).padStart(2, " "))}. ${pc7.bold(p.name)} ${pc7.dim(p.sourceUrl ?? p.id)}
 `
     );
   });
   const choice = await readLine(
-    `${pc6.bold(">")} choose number, paste URL, or paste project id: `
+    `${pc7.bold(">")} choose number, paste URL, or paste project id: `
   );
   if (!choice) {
     return null;
   }
   if (isDocsUrl(choice)) {
-    return await convertUrlToProject(choice, { offerInstall: false });
+    return await convertUrlToProject(choice, { offerInstall: true });
   }
   const chosenIndex = Number(choice);
   if (Number.isInteger(chosenIndex) && chosenIndex > 0) {
@@ -618,23 +690,21 @@ async function pickExistingProject() {
 async function resolveProject(target) {
   if (target) {
     if (isDocsUrl(target)) {
-      return await convertUrlToProject(target, { offerInstall: false });
+      return await convertUrlToProject(target, { offerInstall: true });
     }
     return await apiFetch(`/api/cli/projects/${target}`);
   }
-  process.stdout.write(`${pc6.bold("doc2mcp chat")}
-`);
   process.stdout.write(
-    `${pc6.dim("Paste a docs URL to create a new MCP, paste a project id, or press Enter to choose existing.")}
+    `${pc7.dim("Paste a docs URL to create a new MCP, a project id, or press Enter to pick an existing one.")}
 
 `
   );
-  const first = await readLine(`${pc6.bold(">")} docs url or project id: `);
+  const first = await readLine(`${pc7.cyan("\u203A")} docs url or project id: `);
   if (!first) {
     return await pickExistingProject();
   }
   if (isDocsUrl(first)) {
-    return await convertUrlToProject(first, { offerInstall: false });
+    return await convertUrlToProject(first, { offerInstall: true });
   }
   return await apiFetch(`/api/cli/projects/${first}`);
 }
@@ -669,26 +739,24 @@ async function askDocs(mcp, question) {
 }
 function renderAnswer(answer) {
   process.stdout.write(`
-${pc6.cyan("\u256D\u2500 doc2mcp")}
+${pc7.green("\u25CF")} ${pc7.bold("doc2mcp")}
+
 `);
-  for (const line of answer.answer.trim().split("\n")) {
-    process.stdout.write(`${pc6.cyan("\u2502")} ${line}
+  process.stdout.write(`${renderMarkdown(answer.answer.trim())}
 `);
-  }
   if (answer.sources && answer.sources.length > 0) {
-    process.stdout.write(`${pc6.cyan("\u2502")}
-${pc6.cyan("\u2502")} ${pc6.dim("Sources:")}
+    process.stdout.write(`
+${pc7.dim("Sources")}
 `);
     for (const source of answer.sources.slice(0, 6)) {
       process.stdout.write(
-        `${pc6.cyan("\u2502")} ${pc6.dim("\u2022")} ${source.title} ${pc6.dim(source.url)}
+        `  ${pc7.cyan("\u2022")} ${source.title}
+    ${pc7.dim(source.url)}
 `
       );
     }
   }
-  process.stdout.write(`${pc6.cyan("\u2570")}
-
-`);
+  process.stdout.write("\n");
 }
 async function answerOnce(mcp, question) {
   const spinner = ora2("Thinking\u2026").start();
@@ -710,7 +778,7 @@ async function runChat(target, options = {}) {
     }
     if (!detail.mcp) {
       process.stderr.write(
-        `${pc6.red("That project is not ready yet.")} Check: ${pc6.bold("doc2mcp list")}
+        `${pc7.red("That project is not ready yet.")} Check: ${pc7.bold("doc2mcp list")}
 `
       );
       process.exitCode = 1;
@@ -721,21 +789,23 @@ async function runChat(target, options = {}) {
       await answerOnce(mcp, options.message);
       return;
     }
+    const title = ` doc2mcp chat \xB7 ${detail.project.name} `;
+    const bar = "\u2500".repeat(title.length);
+    process.stdout.write(`
+${pc7.cyan(`\u256D${bar}\u256E`)}
+`);
+    process.stdout.write(`${pc7.cyan("\u2502")}${pc7.bold(title)}${pc7.cyan("\u2502")}
+`);
+    process.stdout.write(`${pc7.cyan(`\u2570${bar}\u256F`)}
+`);
     process.stdout.write(
-      `
-${pc6.cyan("\u256D\u2500")} ${pc6.bold(`Chatting with ${detail.project.name}`)}
-`
-    );
-    process.stdout.write(
-      `${pc6.cyan("\u2502")} ${pc6.dim("Ask anything about these docs. Type /exit to leave.")}
+      `${pc7.dim("Ask anything about these docs. Type /exit to quit.")}
+
 `
     );
-    process.stdout.write(`${pc6.cyan("\u2570")}
-
-`);
     let active = true;
     while (active) {
-      const question = await readLine(`${pc6.bold(">")} `);
+      const question = await readLine(`${pc7.cyan("\u203A")} `);
       if (question === null) {
         active = false;
         break;
@@ -750,8 +820,11 @@ ${pc6.cyan("\u256D\u2500")} ${pc6.bold(`Chatting with ${detail.project.name}`)}
       }
       await answerOnce(mcp, trimmed);
     }
-    process.stdout.write(`${pc6.dim("Bye \u2014 your docs MCP stays live for your editor.")}
-`);
+    process.stdout.write(
+      `
+${pc7.dim("Bye \u2014 your docs MCP stays live for your editor.")}
+`
+    );
   } catch (error) {
     printError(error);
     process.exitCode = 1;
@@ -760,7 +833,7 @@ ${pc6.cyan("\u256D\u2500")} ${pc6.bold(`Chatting with ${detail.project.name}`)}
 
 // src/index.ts
 var program = new Command();
-program.name("doc2mcp").description("Generate documentation MCP servers from your terminal").version("0.1.18", "-v, --version", "Print the installed CLI version");
+program.name("doc2mcp").description("Generate documentation MCP servers from your terminal").version("0.1.19", "-v, --version", "Print the installed CLI version");
 program.command("login").description("Authorize the CLI via browser").action(async () => {
   await runLogin();
 });
@@ -791,7 +864,7 @@ program.argument("[url]", "Documentation URL to convert").action(async (url) =>
     }
   } catch {
     process.stderr.write(
-      `${pc7.red("Error:")} Invalid URL. Example: doc2mcp https://docs.example.com
+      `${pc8.red("Error:")} Invalid URL. Example: doc2mcp https://docs.example.com
 `
     );
     process.exitCode = 1;
@@ -801,7 +874,7 @@ program.argument("[url]", "Documentation URL to convert").action(async (url) =>
 });
 program.parseAsync(process.argv).catch((error) => {
   const message = error instanceof Error ? error.message : "Unknown error";
-  process.stderr.write(`${pc7.red("Error:")} ${message}
+  process.stderr.write(`${pc8.red("Error:")} ${message}
 `);
   process.exit(1);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "doc2mcp",
-  "version": "0.1.18",
+  "version": "0.1.19",
   "description": "Turn any documentation site into a hosted MCP server from your terminal — for Cursor, Claude, VS Code, Windsurf, and OpenAI agents.",
   "type": "module",
   "bin": {