@loguro/mcp 1.1.0 → 1.2.0

package/dist/index.js

@@ -19560,6 +19560,263 @@ class StdioServerTransport {
 import { existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
+
+// src/docs-catalog.ts
+var DOCS_CATALOG = [
+  { path: "/docs/getting-started", title: "Getting Started", section: "General" },
+  { path: "/docs/query-syntax", title: "Query Syntax", section: "General" },
+  { path: "/docs/alerting", title: "Alerting", section: "General" },
+  { path: "/docs/integrations", title: "Integrations", section: "General" },
+  { path: "/docs/cli/install", title: "Install", section: "CLI" },
+  { path: "/docs/cli/getting-started", title: "Getting Started", section: "CLI" },
+  { path: "/docs/cli/auth", title: "Auth", section: "CLI" },
+  { path: "/docs/cli/project-link", title: "Project Link", section: "CLI" },
+  { path: "/docs/cli/commands", title: "Commands", section: "CLI" },
+  { path: "/docs/cli/querying", title: "Querying", section: "CLI" },
+  { path: "/docs/cli/query-syntax", title: "Query Syntax", section: "CLI" },
+  { path: "/docs/cli/investigate", title: "Investigate", section: "CLI" },
+  { path: "/docs/cli/visualizations", title: "Visualizations", section: "CLI" },
+  { path: "/docs/cli/replay", title: "Replay", section: "CLI" },
+  { path: "/docs/cli/alerts", title: "Alerts", section: "CLI" },
+  { path: "/docs/cli/integrations", title: "Integrations", section: "CLI" },
+  { path: "/docs/cli/share", title: "Share", section: "CLI" },
+  { path: "/docs/cli/account", title: "Account", section: "CLI" },
+  { path: "/docs/commands/count", title: "--count", section: "Commands" },
+  { path: "/docs/commands/top", title: "--top", section: "Commands" },
+  { path: "/docs/commands/unique", title: "--unique", section: "Commands" },
+  { path: "/docs/commands/rate", title: "--rate", section: "Commands" },
+  { path: "/docs/commands/diff", title: "--diff", section: "Commands" },
+  { path: "/docs/commands/downloads", title: "--downloads", section: "Commands" },
+  { path: "/docs/commands/replay", title: "--replay", section: "Commands" },
+  { path: "/docs/commands/live", title: "--live", section: "Commands" },
+  { path: "/docs/commands/group", title: "--group", section: "Commands" },
+  { path: "/docs/commands/alerts", title: "--alerts", section: "Commands" },
+  { path: "/docs/commands/views", title: "--views", section: "Commands" },
+  { path: "/docs/commands/keys", title: "--keys", section: "Commands" },
+  { path: "/docs/commands/channels", title: "--channels", section: "Commands" },
+  { path: "/docs/commands/embed-status", title: "--embed::status", section: "Commands" },
+  { path: "/docs/commands/billing", title: "--billing", section: "Commands" },
+  { path: "/docs/commands/usage", title: "--usage", section: "Commands" },
+  { path: "/docs/commands/integrations-config", title: "--integrations::config", section: "Commands" },
+  { path: "/docs/commands/send", title: "--send", section: "Commands" },
+  { path: "/docs/commands/tasks", title: "--task", section: "Commands" },
+  { path: "/docs/commands/slow", title: "--slow", section: "Commands" },
+  { path: "/docs/commands/sample", title: "--sample", section: "Commands" },
+  { path: "/docs/commands/memory", title: "--memory", section: "Commands" },
+  { path: "/docs/commands/chart", title: "--chart", section: "Commands" },
+  { path: "/docs/commands/timeline", title: "--timeline", section: "Commands" },
+  { path: "/docs/commands/notifications", title: "--notifications", section: "Commands" },
+  { path: "/docs/commands/severity", title: "--severity", section: "Commands" },
+  { path: "/docs/commands/separate-message", title: "--separate::message", section: "Commands" },
+  { path: "/docs/commands/no-group", title: "--no-group", section: "Commands" },
+  { path: "/docs/commands/hashtag", title: "#view", section: "Commands" },
+  { path: "/docs/commands/investigate", title: "--investigate", section: "Commands" },
+  { path: "/docs/commands/explain", title: "--explain", section: "Commands" },
+  { path: "/docs/commands/notes", title: "--notes", section: "Commands" },
+  { path: "/docs/commands/share", title: "--share:md", section: "Commands" },
+  { path: "/docs/commands/slack", title: "--slack", section: "Commands" },
+  { path: "/docs/commands/trace", title: "--trace:full", section: "Commands" },
+  { path: "/docs/features/saved-views", title: "Saved Views", section: "Features" },
+  { path: "/docs/features/log-export", title: "Log Export", section: "Features" },
+  { path: "/docs/features/embed-widgets", title: "Embed Widgets", section: "Features" },
+  { path: "/docs/features/replay", title: "Replay", section: "Features" },
+  { path: "/docs/features/issue-tracker", title: "Issue Tracker", section: "Features" },
+  { path: "/docs/features/messaging", title: "Messaging", section: "Features" },
+  { path: "/docs/features/heartbeat", title: "Heartbeat", section: "Features" },
+  { path: "/docs/features/memory", title: "Memory", section: "Features" },
+  { path: "/docs/mcp/setup", title: "Setup", section: "MCP" },
+  { path: "/docs/mcp/auth", title: "Auth", section: "MCP" },
+  { path: "/docs/mcp/config", title: "Config", section: "MCP" },
+  { path: "/docs/mcp/tools", title: "Tools", section: "MCP" },
+  { path: "/docs/mcp/clients", title: "Clients", section: "MCP" },
+  { path: "/docs/mcp/vs-cli", title: "MCP vs CLI", section: "MCP" },
+  { path: "/docs/tui/getting-started", title: "Getting Started", section: "TUI" },
+  { path: "/docs/tui/views", title: "Views", section: "TUI" },
+  { path: "/docs/tui/keymap", title: "Keymap", section: "TUI" },
+  { path: "/docs/tui/search", title: "Search", section: "TUI" },
+  { path: "/docs/tui/alerts", title: "Alerts", section: "TUI" },
+  { path: "/docs/tui/saved-views", title: "Saved Views", section: "TUI" },
+  { path: "/docs/tui/docs-browser", title: "Docs Browser", section: "TUI" },
+  { path: "/docs/tui/health-badge", title: "Health Badge", section: "TUI" },
+  { path: "/docs/tui/troubleshooting", title: "Troubleshooting", section: "TUI" },
+  { path: "/docs/web-analytics/getting-started", title: "Getting Started", section: "Web Analytics" },
+  { path: "/docs/web-analytics/install", title: "Install", section: "Web Analytics" },
+  { path: "/docs/web-analytics/events", title: "Events", section: "Web Analytics" },
+  { path: "/docs/web-analytics/pageviews", title: "Pageviews", section: "Web Analytics" },
+  { path: "/docs/web-analytics/identity", title: "Identity", section: "Web Analytics" },
+  { path: "/docs/web-analytics/privacy", title: "Privacy", section: "Web Analytics" },
+  { path: "/docs/web-analytics/api-reference", title: "API Reference", section: "Web Analytics" },
+  { path: "/docs/web-analytics/troubleshooting", title: "Troubleshooting", section: "Web Analytics" }
+];
+
+// src/docs.ts
+var DOCS_BASE_URL = (process.env.LOGURO_DOCS_BASE_URL ?? "https://logu.ro").replace(/\/$/, "");
+var CACHE_TTL_MS = 15 * 60 * 1000;
+var FETCH_TIMEOUT_MS = 1e4;
+var USER_AGENT = `loguro-mcp-docs/1.0.0 (node/${process.version})`;
+var cache = new Map;
+var allFetchedAt = 0;
+function extractHeadings(md) {
+  const out = [];
+  for (const line of md.split(`
+`)) {
+    const m = line.match(/^(#{1,6})\s+(.+?)\s*$/);
+    if (m)
+      out.push(m[2].trim());
+  }
+  return out;
+}
+function isFresh(entry) {
+  return Date.now() - entry.fetchedAt < CACHE_TTL_MS;
+}
+async function fetchDoc(path, force = false) {
+  const cached2 = cache.get(path);
+  if (!force && cached2 && isFresh(cached2))
+    return cached2;
+  const url = `${DOCS_BASE_URL}${path}.md`;
+  const res = await fetch(url, {
+    headers: { "User-Agent": USER_AGENT, Accept: "text/markdown,text/plain,*/*" },
+    signal: AbortSignal.timeout(FETCH_TIMEOUT_MS)
+  });
+  if (!res.ok) {
+    throw new Error(`Failed to fetch ${url}: HTTP ${res.status}`);
+  }
+  const body = await res.text();
+  const entry = {
+    path,
+    body,
+    headings: extractHeadings(body),
+    fetchedAt: Date.now()
+  };
+  cache.set(path, entry);
+  return entry;
+}
+async function fetchAllDocs() {
+  if (Date.now() - allFetchedAt < CACHE_TTL_MS)
+    return;
+  await Promise.all(DOCS_CATALOG.map((entry) => fetchDoc(entry.path).catch((err) => {
+    process.stderr.write(`docs: failed to fetch ${entry.path}: ${err.message}
+`);
+  })));
+  allFetchedAt = Date.now();
+}
+function listDocs(section) {
+  const filtered = section ? DOCS_CATALOG.filter((e) => e.section.toLowerCase() === section.toLowerCase()) : DOCS_CATALOG;
+  return filtered.map((e) => {
+    const cached2 = cache.get(e.path);
+    return cached2 ? { ...e, headings: cached2.headings } : { ...e };
+  });
+}
+function listSections() {
+  const counts = new Map;
+  for (const e of DOCS_CATALOG)
+    counts.set(e.section, (counts.get(e.section) ?? 0) + 1);
+  return [...counts.entries()].map(([section, count]) => ({ section, count }));
+}
+function tokens(s) {
+  return s.toLowerCase().split(/\s+/).filter(Boolean);
+}
+function countOccurrences(haystack, needle) {
+  if (!needle)
+    return 0;
+  let count = 0;
+  let i = 0;
+  const lc = haystack.toLowerCase();
+  while ((i = lc.indexOf(needle, i)) !== -1) {
+    count++;
+    i += needle.length;
+  }
+  return count;
+}
+function buildSnippet(body, query, max = 280) {
+  const lc = body.toLowerCase();
+  const idx = lc.indexOf(query.toLowerCase());
+  if (idx === -1) {
+    return body.slice(0, max).trim() + (body.length > max ? "…" : "");
+  }
+  const start = Math.max(0, idx - 80);
+  const end = Math.min(body.length, idx + query.length + 200);
+  const prefix = start > 0 ? "…" : "";
+  const suffix = end < body.length ? "…" : "";
+  return prefix + body.slice(start, end).replace(/\s+/g, " ").trim() + suffix;
+}
+async function searchDocs(query, limit = 5) {
+  await fetchAllDocs();
+  const q = query.trim().toLowerCase();
+  const qTokens = tokens(q);
+  if (!q)
+    return [];
+  const hits = [];
+  for (const entry of DOCS_CATALOG) {
+    const cached2 = cache.get(entry.path);
+    const titleLc = entry.title.toLowerCase();
+    const sectionLc = entry.section.toLowerCase();
+    const matchedIn = new Set;
+    let score = 0;
+    const matchedHeadings = [];
+    if (titleLc.includes(q)) {
+      score += 50;
+      matchedIn.add("title");
+    } else {
+      for (const t of qTokens)
+        if (titleLc.includes(t)) {
+          score += 15;
+          matchedIn.add("title");
+        }
+    }
+    if (sectionLc.includes(q)) {
+      score += 10;
+      matchedIn.add("section");
+    }
+    if (cached2) {
+      for (const h of cached2.headings) {
+        const hLc = h.toLowerCase();
+        if (hLc.includes(q)) {
+          score += 20;
+          matchedIn.add("heading");
+          matchedHeadings.push(h);
+        } else {
+          for (const t of qTokens) {
+            if (hLc.includes(t)) {
+              score += 5;
+              matchedIn.add("heading");
+              if (!matchedHeadings.includes(h))
+                matchedHeadings.push(h);
+            }
+          }
+        }
+      }
+      const bodyOccurrences = countOccurrences(cached2.body, q);
+      if (bodyOccurrences > 0) {
+        score += Math.min(bodyOccurrences, 10);
+        matchedIn.add("body");
+      } else {
+        for (const t of qTokens) {
+          const occ = countOccurrences(cached2.body, t);
+          if (occ > 0) {
+            score += Math.min(occ, 5) * 0.5;
+            matchedIn.add("body");
+          }
+        }
+      }
+    }
+    if (score > 0) {
+      hits.push({
+        path: entry.path,
+        title: entry.title,
+        section: entry.section,
+        score,
+        matchedIn: [...matchedIn],
+        snippet: cached2 ? buildSnippet(cached2.body, q) : "",
+        matchedHeadings
+      });
+    }
+  }
+  hits.sort((a, b) => b.score - a.score);
+  return hits.slice(0, limit);
+}
+
+// src/index.ts
 function loadCliAuth() {
   const xdg = process.env.XDG_CONFIG_HOME;
   const base = xdg && xdg.length > 0 ? xdg : join(homedir(), ".config");
@@ -19589,7 +19846,7 @@ if (!TOKEN) {
   process.stderr.write("Error: no PAT found. Run `loguro login` first, or set LOGURO_TOKEN env var.\n");
   process.exit(1);
 }
-var USER_AGENT = `loguro-mcp/1.0.0 (node/${process.version})`;
+var USER_AGENT2 = `loguro-mcp/1.0.0 (node/${process.version})`;
 var REQUEST_TIMEOUT_MS = 15000;
 function buildQS(params) {
   const qs = new URLSearchParams;
@@ -19610,7 +19867,7 @@ async function logsRequest(project, params) {
   const res = await fetch(url, {
     headers: {
       Authorization: `Bearer ${TOKEN}`,
-      "User-Agent": USER_AGENT,
+      "User-Agent": USER_AGENT2,
       Accept: "application/json"
     },
     signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
@@ -19630,7 +19887,7 @@ async function logsSubRequest(project, subPath, params, method = "GET") {
     method,
     headers: {
       Authorization: `Bearer ${TOKEN}`,
-      "User-Agent": USER_AGENT,
+      "User-Agent": USER_AGENT2,
       Accept: "application/json"
     },
     signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
@@ -19647,7 +19904,7 @@ async function apiRequest(method, path, body) {
     method,
     headers: {
       Authorization: `Bearer ${TOKEN}`,
-      "User-Agent": USER_AGENT,
+      "User-Agent": USER_AGENT2,
       Accept: "application/json",
       ...body !== undefined ? { "Content-Type": "application/json" } : {}
     },
@@ -20314,7 +20571,7 @@ server.tool("check_investigated", "Batch check which fingerprints have cached AI
     method: "POST",
     headers: {
       Authorization: `Bearer ${TOKEN}`,
-      "User-Agent": USER_AGENT,
+      "User-Agent": USER_AGENT2,
       Accept: "application/json",
       "Content-Type": "application/json"
     },
@@ -20327,5 +20584,36 @@ server.tool("check_investigated", "Batch check which fingerprints have cached AI
   const data = await res.json();
   return jsonResult(data, `Cached investigations: ${data.investigated?.length ?? 0}/${fingerprints.length}`);
 });
+server.tool("list_docs", "Browse the Loguro documentation catalog. Returns titles + paths grouped by section. Call without args to see everything; pass `section` to filter. Use `read_doc` to fetch full content of a page.", {
+  section: exports_external.string().optional().describe("Filter by section: General, CLI, Commands, Features, MCP, TUI, Web Analytics")
+}, async ({ section }) => {
+  const docs = listDocs(section);
+  const sections = listSections();
+  const grouped = {};
+  for (const d of docs) {
+    if (!grouped[d.section])
+      grouped[d.section] = [];
+    grouped[d.section].push({ path: d.path, title: d.title, headings: d.headings });
+  }
+  const summary = section ? `${docs.length} page(s) in section "${section}"` : `${docs.length} pages across ${sections.length} sections: ${sections.map((s) => `${s.section} (${s.count})`).join(", ")}`;
+  return jsonResult({ sections, docs: grouped }, summary);
+});
+server.tool("search_docs", "Search Loguro documentation by keyword. Fetches all docs on first call (cached 15min), then scores matches across title, section, headings, and body. Returns top hits with snippets. Use this when you don't know which page covers a topic.", {
+  query: exports_external.string().min(1).describe("Search terms — natural words, not regex. E.g. 'how do alerts work', 'PAT token', 'context filter'."),
+  limit: exports_external.number().min(1).max(20).default(5).describe("Max results (default 5)")
+}, async ({ query, limit }) => {
+  const hits = await searchDocs(query, limit);
+  const summary = hits.length === 0 ? `No matches for "${query}"` : `Top ${hits.length} hit(s) for "${query}" — best: ${hits[0].title} (${hits[0].section}) score=${hits[0].score}`;
+  return jsonResult({ query, hits }, summary);
+});
+server.tool("read_doc", "Fetch the full markdown body of a documentation page by its path (e.g. '/docs/cli/alerts'). Use after `search_docs` or `list_docs` to read a specific page end-to-end.", {
+  path: exports_external.string().describe("Doc path starting with /docs/ — e.g. /docs/mcp/setup"),
+  refresh: exports_external.boolean().default(false).describe("Bypass the 15min cache and refetch from logu.ro")
+}, async ({ path, refresh }) => {
+  const normalized = path.startsWith("/") ? path : "/" + path;
+  const doc2 = await fetchDoc(normalized, refresh);
+  const summary = `${normalized} (${doc2.body.length} chars, ${doc2.headings.length} heading(s))`;
+  return jsonResult({ path: normalized, headings: doc2.headings, body: doc2.body, fetchedAt: new Date(doc2.fetchedAt).toISOString() }, summary);
+});
 var transport = new StdioServerTransport;
 await server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loguro/mcp",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "MCP server for Loguro — query logs from Claude Code, Cursor, and other MCP-compatible AI tools. Reuses the CLI's saved auth (zero config).",
   "keywords": [
     "loguro",