npm - zefiro - Versions diffs - 0.9.0 → 0.10.0 - Mend

zefiro 0.9.0 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (15) hide show

package/README.md +5 -14
package/dist/cli-5w708rbb.js +167 -0
package/dist/cli-7hvj61ht.js +150 -0
package/dist/cli-ewbvvxm8.js +145 -0
package/dist/cli-kjyet1n8.js +384 -0
package/dist/cli-m1ghts25.js +133 -0
package/dist/cli-mm7ct90g.js +110 -0
package/dist/cli.js +180 -102
package/dist/explorer-ckk9bkff.js +11 -0
package/dist/explorer-svj2p317.js +10 -0
package/dist/graph-builder-ca71yjkc.js +10 -0
package/dist/index.js +1 -1
package/dist/mcp.js +241 -46
package/dist/report-wh0mnnxb.js +12 -0
package/package.json +2 -6

package/dist/mcp.js CHANGED Viewed

@@ -36,18 +36,20 @@ import {
   AgentBrowser,
   authenticate
 } from "./cli-b26q1e27.js";
+import {
+  generateIndexHtml,
+  generateReadme,
+  generateSectionMarkdown
+} from "./cli-kjyet1n8.js";
 import {
   ensureDir,
   writeFile
 } from "./cli-zvk8gwe4.js";
 import {
   buildTopology,
-  generateIndexHtml,
-  generateReadme,
-  generateSectionMarkdown,
   normalizeUrl,
   urlToSlug
-} from "./cli-6qr9gvkp.js";
+} from "./cli-5w708rbb.js";
 import {
   __commonJS,
   __require,
@@ -17936,18 +17938,72 @@ function broadcastState() {
 function startCompanionServer(mode, port = 0) {
   state = createCompanionState(mode);
   return new Promise((resolvePromise, reject) => {
+    const startTime = Date.now();
     const httpServer = createServer((req, res) => {
-      if (req.url === "/" || req.url === "/companion") {
+      const url = req.url?.split("?")[0];
+      const cors = { "Access-Control-Allow-Origin": "*" };
+      if (url === "/" || url === "/companion") {
         const htmlPath = resolve(uiDir, "companion.html");
         if (existsSync2(htmlPath)) {
-          res.writeHead(200, { "Content-Type": "text/html", "Access-Control-Allow-Origin": "*" });
+          res.writeHead(200, { "Content-Type": "text/html; charset=utf-8", ...cors });
           res.end(readFileSync2(htmlPath));
         } else {
-          res.writeHead(200, { "Content-Type": "text/html", "Access-Control-Allow-Origin": "*" });
+          res.writeHead(200, { "Content-Type": "text/html", ...cors });
           res.end("<html><body><h1>Companion UI not found</h1></body></html>");
         }
         return;
       }
+      if (url === "/logo.svg") {
+        const svgPath = resolve(uiDir, "logo.svg");
+        if (existsSync2(svgPath)) {
+          res.writeHead(200, { "Content-Type": "image/svg+xml", ...cors });
+          res.end(readFileSync2(svgPath));
+        } else {
+          res.writeHead(404);
+          res.end("Not found");
+        }
+        return;
+      }
+      if (url === "/health") {
+        res.writeHead(200, { "Content-Type": "application/json", ...cors });
+        res.end(JSON.stringify({ status: "ok", uptime: Math.floor((Date.now() - startTime) / 1000) }));
+        return;
+      }
+      if (url === "/track" && req.method === "POST") {
+        let body = "";
+        req.on("data", (chunk) => {
+          body += chunk.toString();
+        });
+        req.on("end", () => {
+          try {
+            const data = JSON.parse(body);
+            const entry = {
+              action: data.action ?? "unknown",
+              timestamp: new Date().toISOString(),
+              result: data.result,
+              source: data.source ?? "agent"
+            };
+            state.actionLog.push(entry);
+            if (state.actionLog.length > 100)
+              state.actionLog = state.actionLog.slice(-100);
+            if (data.url) {
+              state.currentPage = { url: data.url, title: data.title ?? data.url };
+            }
+            broadcastState();
+            res.writeHead(200, { "Content-Type": "application/json", ...cors });
+            res.end(JSON.stringify({ success: true, tracked_at: entry.timestamp }));
+          } catch {
+            res.writeHead(400, { "Content-Type": "application/json", ...cors });
+            res.end(JSON.stringify({ error: "Invalid JSON" }));
+          }
+        });
+        return;
+      }
+      if (url === "/track" && req.method === "OPTIONS") {
+        res.writeHead(204, { ...cors, "Access-Control-Allow-Methods": "POST", "Access-Control-Allow-Headers": "Content-Type" });
+        res.end();
+        return;
+      }
       res.writeHead(404);
       res.end("Not found");
     });
@@ -18075,24 +18131,19 @@ import { homedir } from "node:os";
 import { spawn } from "node:child_process";
 // src/copilot/overlay-download.ts
-import { createWriteStream, mkdirSync, existsSync as existsSync3, chmodSync } from "node:fs";
-import { join as join3 } from "node:path";
-import { pipeline as pipeline2 } from "node:stream/promises";
 import { createHash } from "node:crypto";
+import { chmodSync, createWriteStream, existsSync as existsSync3, mkdirSync } from "node:fs";
 import { readFile, unlink } from "node:fs/promises";
+import { join as join3 } from "node:path";
 import { createInterface } from "node:readline";
 import { Readable } from "node:stream";
+import { pipeline as pipeline2 } from "node:stream/promises";
 var OVERLAY_VERSION = "0.1.0";
-var GITHUB_REPO = "anthropics/qa-intelligence";
+var GITHUB_REPO = "davide97g/qaligent";
 function resolveArch() {
-  switch (process.arch) {
-    case "arm64":
-      return "aarch64";
-    case "x64":
-      return "x86_64";
-    default:
-      return null;
-  }
+  if (process.arch === "arm64")
+    return "aarch64";
+  return null;
 }
 async function confirm(message) {
   if (!process.stdin.isTTY)
@@ -18152,7 +18203,7 @@ async function downloadOverlay(binDir, options) {
   const arch = resolveArch();
   if (!arch) {
     if (!options?.silent) {
-      console.log(`  Unsupported architecture: ${process.arch}`);
+      console.log("  Native overlay is only available on Apple Silicon Macs (M1/M2/M3/M4).");
     }
     return false;
   }
@@ -18259,27 +18310,31 @@ async function handleCopilotStart(params) {
   const cwd = process.cwd();
   const outputDir = params.outputDir ? join5(cwd, params.outputDir) : join5(cwd, "copilot-report");
   const session = createSession(params.baseUrl, mode, outputDir);
-  const browser = new AgentBrowser({
-    session: `copilot-${session.id}`,
-    headed: params.headed ?? true
-  });
-  browsers.set(session.id, browser);
-  if (params.authState) {
-    const config = {
-      baseUrl: params.baseUrl,
-      outputDir,
-      maxPages: params.maxPages ?? 100,
-      excludePatterns: [],
-      headed: params.headed ?? true,
-      waitStrategy: "networkidle",
-      waitDelay: 1500,
-      pageTimeout: 30000,
-      auth: { method: "state-file", stateFile: params.authState },
-      sessionName: `copilot-${session.id}`
-    };
-    await authenticate(browser, config);
+  if (params.browser !== "chrome") {
+    const browser = new AgentBrowser({
+      session: `copilot-${session.id}`,
+      headed: params.headed ?? true
+    });
+    browsers.set(session.id, browser);
+    if (params.authState) {
+      const config = {
+        baseUrl: params.baseUrl,
+        outputDir,
+        maxPages: params.maxPages ?? 100,
+        excludePatterns: [],
+        headed: params.headed ?? true,
+        waitStrategy: "networkidle",
+        waitDelay: 1500,
+        pageTimeout: 30000,
+        auth: { method: "state-file", stateFile: params.authState },
+        sessionName: `copilot-${session.id}`
+      };
+      await authenticate(browser, config);
+    }
+    await browser.setViewport(1440, 900);
+    await browser.open(params.baseUrl);
+    await browser.waitForLoad("networkidle", 1500);
   }
-  await browser.setViewport(1440, 900);
   const companion = await startCompanionServer(mode, 0);
   session.companionPort = companion.port;
   const overlayBin = await resolveOverlayBinary({ silent: true });
@@ -18288,8 +18343,6 @@ async function handleCopilotStart(params) {
     if (child?.pid)
       session.overlayPid = child.pid;
   }
-  await browser.open(params.baseUrl);
-  await browser.waitForLoad("networkidle", 1500);
   logAction(session, `copilot_start: ${params.baseUrl} (mode: ${mode})`);
   syncAction(`copilot_start: ${params.baseUrl} (mode: ${mode})`);
   return {
@@ -18297,7 +18350,8 @@ async function handleCopilotStart(params) {
     mode: session.mode,
     base_url: params.baseUrl,
     output_dir: outputDir,
-    companion_url: `http://localhost:${companion.port}`
+    companion_url: `http://localhost:${companion.port}`,
+    browser: params.browser ?? "playwright"
   };
 }
 async function handleCopilotStop(params) {
@@ -18432,6 +18486,7 @@ async function handleCopilotRecordPage(params) {
       path: new URL(normalizedUrl).pathname,
       title,
       slug: params.slug,
+      stableId: `page:${params.slug}`,
       depth: new URL(normalizedUrl).pathname.split("/").filter(Boolean).length,
       screenshot: `screenshots/${params.slug}/default.png`,
       elements: [],
@@ -18499,6 +18554,21 @@ async function handleCopilotProposeAction(params) {
     message: "Proposal sent to companion UI. Call copilot_check_input to get the result."
   };
 }
+async function handleCopilotTrack(params) {
+  const session = getSession(params.session_id);
+  if (!session)
+    throw new Error(`Session not found: ${params.session_id}`);
+  logAction(session, params.action, params.result);
+  syncAction(params.action, params.result);
+  if (params.url) {
+    updateCurrentPage(params.url, params.title ?? params.url);
+  }
+  return {
+    success: true,
+    action: params.action,
+    tracked_at: new Date().toISOString()
+  };
+}
 // src/mcp.ts
 var SERVER_INSTRUCTIONS = `
@@ -18515,6 +18585,7 @@ It produces markdown documentation organized as a knowledge network, with an int
 1. **Explore.** \`zefiro_explore({ baseUrl: "http://localhost:3000" })\` — BFS exploration of the application
 2. **Read.** \`zefiro_read_docs()\` — read the generated documentation (README or specific sections)
+3. **Push.** \`zefiro_push({ apiKey: "..." })\` — push report to QA Intelligence (builds graph automatically)
 ## Output Structure
@@ -18530,6 +18601,7 @@ app-report/
 - \`zefiro_explore\` — explore a web application via BFS, generating documentation and screenshots
 - \`zefiro_read_docs\` — read generated documentation (README or specific section files)
+- \`zefiro_push\` — push exploration report to QA Intelligence (auto-builds graph with stable IDs)
 - \`zefiro_scan_codebase\` — scan project for test files, configs, and path aliases (static analysis helper)
 ## Copilot — Interactive Browser Co-Pilot
@@ -18556,8 +18628,16 @@ Use these tools when the user asks to explore, map, or document a running web ap
 - \`zefiro_copilot_get_session\` — Get session state (explored pages, stats)
 - \`zefiro_copilot_check_input\` — Read pending human input (voice/text)
 - \`zefiro_copilot_propose_action\` — ASSIST mode: propose action for approval
+- \`zefiro_copilot_track\` — Chrome Bridge: sync an external browser action to the session log
+### Chrome Bridge Mode
+Use \`browser: "chrome"\` with \`copilot_start\` to track actions from an external browser (e.g., Claude-in-Chrome).
+1. \`zefiro_copilot_start({ baseUrl, mode: "assist", browser: "chrome" })\` — starts companion only
+2. Open the \`companion_url\` in your browser
+3. Use Claude-in-Chrome tools to browse; call \`zefiro_copilot_track\` after each action
+4. \`zefiro_copilot_stop\` — generates report
 `.trim();
-var server = new McpServer({ name: "zefiro", version: "0.7.4" }, { instructions: SERVER_INSTRUCTIONS });
+var server = new McpServer({ name: "zefiro", version: "0.10.0" }, { instructions: SERVER_INSTRUCTIONS });
 server.registerTool("zefiro_explore", {
   title: "Explore Application",
   description: "Explore a web application using browser automation (BFS). " + "Visits pages, takes screenshots, and generates markdown documentation. " + "Requires agent-browser to be installed globally.",
@@ -18569,8 +18649,8 @@ server.registerTool("zefiro_explore", {
   })
 }, async ({ baseUrl, maxPages, outputDir, headed }) => {
   try {
-    const { runExploration } = await import("./explorer-g6bmbak1.js");
-    const { generateReadme: generateReadme2, generateIndexHtml: generateIndexHtml2 } = await import("./report-sdtah1f4.js");
+    const { runExploration } = await import("./explorer-ckk9bkff.js");
+    const { generateReadme: generateReadme2, generateIndexHtml: generateIndexHtml2 } = await import("./report-wh0mnnxb.js");
     const { writeFile: writeFile2, ensureDir: ensureDir2 } = await import("./fs-9dhtxzmg.js");
     const cwd = process.cwd();
     const outDir = outputDir ? join6(cwd, outputDir) : join6(cwd, "app-report");
@@ -18588,6 +18668,8 @@ server.registerTool("zefiro_explore", {
       sessionName: "zefiro"
     };
     const state2 = await runExploration(config);
+    const serializableState = { ...state2, pages: Object.fromEntries(state2.pages) };
+    writeFile2(join6(outDir, ".exploration-state.json"), JSON.stringify(serializableState, null, 2));
     const readme = generateReadme2(state2);
     writeFile2(join6(outDir, "README.md"), readme);
     const html = generateIndexHtml2(state2);
@@ -18674,12 +18756,107 @@ server.registerTool("zefiro_scan_codebase", {
     return { content: [{ type: "text", text: `Error scanning codebase: ${err.message}` }], isError: true };
   }
 });
+server.registerTool("zefiro_push", {
+  title: "Push Report",
+  description: "Push the exploration report to QA Intelligence. " + "Builds a graph from the exploration state, encodes screenshots, and pushes to the API. " + "Requires a prior zefiro_explore run and an API key.",
+  inputSchema: exports_external.object({
+    apiKey: exports_external.string().describe("App API key for QA Intelligence"),
+    apiUrl: exports_external.string().optional().describe("API base URL (default: https://qaligent.space)"),
+    outputDir: exports_external.string().optional().describe("Exploration output directory (default: app-report)"),
+    commitSha: exports_external.string().optional().describe("Git commit SHA to associate")
+  })
+}, async ({ apiKey, apiUrl, outputDir, commitSha }) => {
+  try {
+    const { buildReportGraph, buildReportSections } = await import("./graph-builder-ca71yjkc.js");
+    const cwd = process.cwd();
+    const outDir = outputDir ? join6(cwd, outputDir) : join6(cwd, "app-report");
+    const url = apiUrl ?? "https://qaligent.space";
+    const statePath = join6(outDir, ".exploration-state.json");
+    if (!existsSync5(statePath)) {
+      return {
+        content: [{ type: "text", text: "No exploration state found. Run zefiro_explore first." }],
+        isError: true
+      };
+    }
+    const raw = JSON.parse(readFileSync3(statePath, "utf-8"));
+    const pages = new Map(Object.entries(raw.pages));
+    const state2 = { ...raw, pages };
+    const visitedPages = Array.from(pages.values()).filter((p) => p.status === "visited");
+    const graph = buildReportGraph(state2);
+    const sectionsDir = join6(outDir, "sections");
+    const markdowns = new Map;
+    if (existsSync5(sectionsDir)) {
+      for (const file of readdirSync2(sectionsDir)) {
+        if (file.endsWith(".md")) {
+          markdowns.set(file.replace(/\.md$/, ""), readFileSync3(join6(sectionsDir, file), "utf-8"));
+        }
+      }
+    }
+    const sections = buildReportSections(visitedPages, markdowns);
+    const screenshotsDir = join6(outDir, "screenshots");
+    const screenshots = [];
+    if (existsSync5(screenshotsDir)) {
+      for (const slugDir of readdirSync2(screenshotsDir)) {
+        const fullDir = join6(screenshotsDir, slugDir);
+        try {
+          const files = readdirSync2(fullDir);
+          for (let i = 0;i < files.length; i++) {
+            const file = files[i];
+            if (!file.endsWith(".png") && !file.endsWith(".jpg"))
+              continue;
+            screenshots.push({
+              sectionSlug: slugDir,
+              filename: file,
+              label: file.replace(/^\d+-/, "").replace(/\.\w+$/, ""),
+              sortOrder: i,
+              data: readFileSync3(join6(fullDir, file)).toString("base64")
+            });
+          }
+        } catch {}
+      }
+    }
+    const readmePath = join6(outDir, "README.md");
+    const readme = existsSync5(readmePath) ? readFileSync3(readmePath, "utf-8") : `# Application Map
+${visitedPages.length} pages explored.`;
+    const payload = {
+      title: `Zefiro Scan — ${new Date().toISOString().split("T")[0]}`,
+      readme,
+      sections,
+      graph,
+      screenshots,
+      commitSha: commitSha || undefined
+    };
+    const res = await fetch(`${url}/api/v2/push-report`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${apiKey}`
+      },
+      body: JSON.stringify(payload)
+    });
+    if (!res.ok) {
+      const body = await res.text();
+      return { content: [{ type: "text", text: `Push failed (${res.status}): ${body}` }], isError: true };
+    }
+    const result = await res.json();
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify(result, null, 2)
+      }]
+    };
+  } catch (err) {
+    return { content: [{ type: "text", text: `Error pushing report: ${err.message}` }], isError: true };
+  }
+});
 server.registerTool("zefiro_copilot_start", {
   title: "Start Copilot Session",
   description: "Start an interactive copilot session. Launches a browser and creates a session. " + "Returns a session_id to use with all other copilot tools.",
   inputSchema: exports_external.object({
     baseUrl: exports_external.string().describe("Base URL of the application (e.g., http://localhost:3000)"),
     mode: exports_external.enum(["auto", "assist", "manual"]).optional().describe("Copilot mode: auto (AI drives), assist (AI proposes, human approves), manual (human drives)"),
+    browser: exports_external.enum(["playwright", "chrome"]).optional().describe('Browser engine: "playwright" (default, launches new browser) or "chrome" (companion-only, use with Claude-in-Chrome)'),
     headed: exports_external.boolean().optional().describe("Show browser window (default: true)"),
     authState: exports_external.string().optional().describe("Path to Playwright auth state JSON file"),
     outputDir: exports_external.string().optional().describe("Output directory for report (default: copilot-report)")
@@ -18877,6 +19054,24 @@ server.registerTool("zefiro_copilot_propose_action", {
     return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
   }
 });
+server.registerTool("zefiro_copilot_track", {
+  title: "Track Chrome Action",
+  description: "Track a browser action performed via external browser (e.g., Claude-in-Chrome). " + "Syncs the action to the companion UI and session log. Use after each chrome tool call.",
+  inputSchema: exports_external.object({
+    session_id: exports_external.string().describe("Session ID"),
+    action: exports_external.string().describe('Description of the action (e.g., "navigate: https://example.com", "click: Submit button")'),
+    url: exports_external.string().optional().describe("Current page URL after the action (updates companion page display)"),
+    title: exports_external.string().optional().describe("Current page title"),
+    result: exports_external.string().optional().describe("Action result or details")
+  })
+}, async (params) => {
+  try {
+    const result = await handleCopilotTrack(params);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+  } catch (err) {
+    return { content: [{ type: "text", text: `Error: ${err.message}` }], isError: true };
+  }
+});
 async function main() {
   const transport = new StdioServerTransport;
   await server.connect(transport);

package/dist/report-wh0mnnxb.js ADDED Viewed

@@ -0,0 +1,12 @@
+import {
+  generateIndexHtml,
+  generateReadme,
+  generateSectionMarkdown
+} from "./cli-kjyet1n8.js";
+import"./cli-5w708rbb.js";
+import"./cli-wckvcay0.js";
+export {
+  generateSectionMarkdown,
+  generateReadme,
+  generateIndexHtml
+};

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "zefiro",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "type": "module",
   "bin": {
     "zefiro": "./dist/cli.js",
@@ -29,20 +29,16 @@
   "devDependencies": {
     "@inquirer/prompts": "^8.3.0",
     "@qai/cli-auth": "workspace:*",
+    "@types/ws": "^8.18.1",
     "@types/node": "^24.0.14",
-    "@types/react": "^18",
     "bun-types": "^1.3.11",
     "commander": "^13.1.0",
-    "ink": "^5",
-    "ink-text-input": "^6",
     "picocolors": "^1.1.1",
-    "react": "^18",
     "typescript": "^5.8.3",
     "zod": "^4.0.5"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.1",
-    "@types/ws": "^8.18.1",
     "ws": "^8.20.0"
   }
 }