zefiro 0.9.0 → 0.10.0

package/dist/cli.js

@@ -4,16 +4,15 @@ import {
   getPackageRoot,
   getProjectRoot,
   loadConfig
-} from "./cli-cymqw41r.js";
+} from "./cli-mm7ct90g.js";
 import"./cli-z2krvkcq.js";
 import {
-  dist_default2 as dist_default,
-  dist_default3 as dist_default2,
-  dist_default9 as dist_default3
+  dist_default3 as dist_default,
+  dist_default9 as dist_default2
 } from "./cli-eyd8t0cw.js";
 import {
   runExploration
-} from "./cli-g7n2me6z.js";
+} from "./cli-7hvj61ht.js";
 import {
   banner,
   error,
@@ -24,14 +23,19 @@ import {
   success,
   warn
 } from "./cli-b26q1e27.js";
+import {
+  generateIndexHtml,
+  generateReadme
+} from "./cli-kjyet1n8.js";
 import {
   ensureDir,
   writeFile
 } from "./cli-zvk8gwe4.js";
 import {
-  generateIndexHtml,
-  generateReadme
-} from "./cli-6qr9gvkp.js";
+  buildReportGraph,
+  buildReportSections
+} from "./cli-ewbvvxm8.js";
+import"./cli-5w708rbb.js";
 import {
   __commonJS,
   __require,
@@ -2152,6 +2156,11 @@ function registerExplore(program2) {
       };
       ensureDir(config.outputDir);
       const state = await runExploration(config);
+      const serializableState = {
+        ...state,
+        pages: Object.fromEntries(state.pages)
+      };
+      writeFile(join2(config.outputDir, ".exploration-state.json"), JSON.stringify(serializableState, null, 2));
       const readme = generateReadme(state);
       writeFile(join2(config.outputDir, "README.md"), readme);
       if (opts.report !== false) {
@@ -2175,6 +2184,143 @@ function registerExplore(program2) {
   });
 }
 
+// src/commands/push.ts
+import { join as join3 } from "node:path";
+import { readFileSync, existsSync, readdirSync } from "node:fs";
+function loadExplorationState(outputDir, baseUrl) {
+  const sectionsDir = join3(outputDir, "sections");
+  const readmePath = join3(outputDir, "README.md");
+  if (!existsSync(sectionsDir)) {
+    throw new Error(`No sections/ directory found in ${outputDir}. Run 'zefiro explore' first.`);
+  }
+  const statePath = join3(outputDir, ".exploration-state.json");
+  if (existsSync(statePath)) {
+    const raw = JSON.parse(readFileSync(statePath, "utf-8"));
+    const pages = new Map(Object.entries(raw.pages));
+    return { ...raw, pages };
+  }
+  throw new Error(`No exploration state found at ${statePath}.
+` + `Re-run 'zefiro explore' to generate the state file (required for push).`);
+}
+function loadSectionMarkdowns(outputDir) {
+  const sectionsDir = join3(outputDir, "sections");
+  const markdowns = new Map;
+  if (!existsSync(sectionsDir))
+    return markdowns;
+  for (const file of readdirSync(sectionsDir)) {
+    if (file.endsWith(".md")) {
+      const slug = file.replace(/\.md$/, "");
+      markdowns.set(slug, readFileSync(join3(sectionsDir, file), "utf-8"));
+    }
+  }
+  return markdowns;
+}
+function loadScreenshots(outputDir) {
+  const screenshotsDir = join3(outputDir, "screenshots");
+  if (!existsSync(screenshotsDir))
+    return [];
+  const screenshots = [];
+  for (const slugDir of readdirSync(screenshotsDir)) {
+    const fullDir = join3(screenshotsDir, slugDir);
+    try {
+      const files = readdirSync(fullDir);
+      for (let i = 0;i < files.length; i++) {
+        const file = files[i];
+        if (!file.endsWith(".png") && !file.endsWith(".jpg"))
+          continue;
+        const data = readFileSync(join3(fullDir, file)).toString("base64");
+        screenshots.push({
+          sectionSlug: slugDir,
+          filename: file,
+          label: file.replace(/^\d+-/, "").replace(/\.\w+$/, ""),
+          sortOrder: i,
+          data
+        });
+      }
+    } catch {}
+  }
+  return screenshots;
+}
+function registerPush(program2) {
+  program2.command("push").description("Push exploration report to QA Intelligence").option("--output <dir>", "Exploration output directory").option("--key <apiKey>", "App API key (or set QAI_API_KEY)").option("--api-url <url>", "API base URL (or set QAI_API_URL)").option("--commit-sha <sha>", "Git commit SHA to associate with this report").option("--dry-run", "Build payload and show stats without pushing").action(async (opts) => {
+    try {
+      const ctx = await resolveCommandContext(program2);
+      header("zefiro push");
+      const apiKey = opts.key || process.env.QAI_API_KEY;
+      if (!apiKey && !opts.dryRun) {
+        error("Missing API key. Use --key or set QAI_API_KEY environment variable.");
+        info("Get your app API key from the app settings page in QA Intelligence.");
+        process.exit(1);
+      }
+      const apiUrl = opts.apiUrl || process.env.QAI_API_URL || "https://qaligent.space";
+      const outputDir = opts.output ? join3(ctx.paths.projectRoot, opts.output) : ctx.paths.outputDir;
+      info(`Output dir: ${outputDir}`);
+      info(`API URL:    ${apiUrl}`);
+      const baseUrl = ctx.config.baseUrl ?? "http://localhost:3000";
+      const state = loadExplorationState(outputDir, baseUrl);
+      const visitedPages = Array.from(state.pages.values()).filter((p) => p.status === "visited");
+      info(`Pages found: ${visitedPages.length}`);
+      const graph = buildReportGraph(state);
+      info(`Graph: ${graph.nodes.length} nodes, ${graph.edges.length} edges, ${graph.sectionGroups.length} groups`);
+      const markdowns = loadSectionMarkdowns(outputDir);
+      const sections = buildReportSections(visitedPages, markdowns);
+      const screenshots = loadScreenshots(outputDir);
+      info(`Screenshots: ${screenshots.length}`);
+      const readmePath = join3(outputDir, "README.md");
+      const readme = existsSync(readmePath) ? readFileSync(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: opts.commitSha || undefined
+      };
+      if (opts.dryRun) {
+        console.log("");
+        success("Dry run — payload built successfully:");
+        console.log(`  Title:       ${payload.title}`);
+        console.log(`  Sections:    ${payload.sections.length}`);
+        console.log(`  Nodes:       ${payload.graph.nodes.length}`);
+        console.log(`  Edges:       ${payload.graph.edges.length}`);
+        console.log(`  Groups:      ${payload.graph.sectionGroups.length}`);
+        console.log(`  Screenshots: ${payload.screenshots.length}`);
+        console.log(`  Payload size: ~${Math.round(JSON.stringify(payload).length / 1024)}KB`);
+        return;
+      }
+      info("Pushing to QA Intelligence...");
+      const res = await fetch(`${apiUrl}/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();
+        throw new Error(`Push failed (${res.status}): ${body}`);
+      }
+      const result = await res.json();
+      console.log("");
+      success("Report pushed successfully!");
+      console.log("");
+      console.log(`  Version:     v${result.version}`);
+      console.log(`  App ID:      ${result.appId}`);
+      console.log(`  Pushed at:   ${result.pushedAt}`);
+      console.log(`  Sections:    ${result.stats.sections}`);
+      console.log(`  Screenshots: ${result.stats.screenshots}`);
+      console.log(`  Nodes:       ${result.stats.graphNodes}`);
+      console.log(`  Edges:       ${result.stats.graphEdges}`);
+    } catch (err) {
+      error(err.message);
+      process.exit(1);
+    }
+  });
+}
+
 // ../cli-auth/dist/index.js
 import { createHash, randomBytes } from "node:crypto";
 import { createServer } from "node:http";
@@ -2203,8 +2349,8 @@ import { promisify as promisify2 } from "node:util";
 import { execFile as execFile2, execFileSync } from "node:child_process";
 import { promisify as promisify3 } from "node:util";
 import { execFile as execFile3 } from "node:child_process";
-import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
-import { join as join3 } from "node:path";
+import { readFileSync as readFileSync2, writeFileSync, mkdirSync, existsSync as existsSync2 } from "node:fs";
+import { join as join4 } from "node:path";
 import { homedir } from "node:os";
 var __create = Object.create;
 var __getProtoOf = Object.getPrototypeOf;
@@ -2751,16 +2897,16 @@ defineLazyProperty(apps, "browser", () => "browser");
 defineLazyProperty(apps, "browserPrivate", () => "browserPrivate");
 var open_default = open;
 var import_picocolors = __toESM2(require_picocolors2(), 1);
-var AUTH_DIR = join3(homedir(), ".qai");
-var AUTH_FILE = join3(AUTH_DIR, "auth.json");
+var AUTH_DIR = join4(homedir(), ".qai");
+var AUTH_FILE = join4(AUTH_DIR, "auth.json");
 function emptyStore() {
   return { version: 1, sessions: [], activeSessionIndex: -1 };
 }
 function loadStore() {
-  if (!existsSync(AUTH_FILE))
+  if (!existsSync2(AUTH_FILE))
     return emptyStore();
   try {
-    const data = JSON.parse(readFileSync(AUTH_FILE, "utf-8"));
+    const data = JSON.parse(readFileSync2(AUTH_FILE, "utf-8"));
     if (data.version !== 1)
       return emptyStore();
     return data;
@@ -3121,7 +3267,19 @@ var import_picocolors3 = __toESM(require_picocolors(), 1);
 var TOOLS = [
   "zefiro_explore              — explore a web application via BFS",
   "zefiro_read_docs            — read generated documentation",
-  "zefiro_scan_codebase        — scan project test infrastructure"
+  "zefiro_scan_codebase        — scan project test infrastructure",
+  "zefiro_copilot_start        — start an interactive copilot session",
+  "zefiro_copilot_stop         — stop session and generate report",
+  "zefiro_copilot_navigate     — navigate to a URL",
+  "zefiro_copilot_snapshot     — get page accessibility snapshot",
+  "zefiro_copilot_screenshot   — take a screenshot",
+  "zefiro_copilot_click        — click an element",
+  "zefiro_copilot_fill         — fill a form field",
+  "zefiro_copilot_get_links    — extract page links",
+  "zefiro_copilot_record_page  — record current page documentation",
+  "zefiro_copilot_get_session  — get session state",
+  "zefiro_copilot_check_input  — check pending user input",
+  "zefiro_copilot_propose_action — propose action to user"
 ];
 var DESKTOP_CONFIG = JSON.stringify({
   mcpServers: {
@@ -3164,77 +3322,8 @@ function registerMcp(program2) {
 
 // src/commands/init.ts
 import { join as join5 } from "node:path";
-import { readdirSync, readFileSync as readFileSync3, existsSync as existsSync3 } from "node:fs";
+import { readdirSync as readdirSync2, readFileSync as readFileSync3, existsSync as existsSync3 } from "node:fs";
 var import_picocolors5 = __toESM(require_picocolors(), 1);
-
-// src/config/migrate.ts
-import { existsSync as existsSync2, readFileSync as readFileSync2, rmSync, cpSync } from "node:fs";
-import { join as join4 } from "node:path";
-var LEGACY_DIR = ".e2e-ai";
-async function migrateFromLegacy(projectRoot, nonInteractive) {
-  const legacyPath = join4(projectRoot, LEGACY_DIR);
-  const newPath = join4(projectRoot, CONFIG_DIR);
-  if (!existsSync2(legacyPath))
-    return false;
-  if (existsSync2(join4(newPath, "config.ts")) || existsSync2(join4(newPath, "config.js")) || existsSync2(join4(newPath, "config.mjs"))) {
-    return false;
-  }
-  try {
-    info(`Legacy ${LEGACY_DIR}/ detected — migrating to ${CONFIG_DIR}/
-`);
-    ensureDir(newPath);
-    let migrated = 0;
-    for (const name of ["config.ts", "config.js", "config.mjs"]) {
-      const src = join4(legacyPath, name);
-      if (existsSync2(src)) {
-        let content = readFileSync2(src, "utf-8");
-        content = content.replace(/from\s+['"]e2e-ai\/config['"]/g, "from 'zefiro/config'");
-        writeFile(join4(newPath, name), content);
-        migrated++;
-        break;
-      }
-    }
-    const contextSrc = join4(legacyPath, "context.md");
-    if (existsSync2(contextSrc)) {
-      cpSync(contextSrc, join4(newPath, "context.md"));
-      migrated++;
-    }
-    const agentsSrc = join4(legacyPath, "agents");
-    if (existsSync2(agentsSrc)) {
-      cpSync(agentsSrc, join4(newPath, "agents"), { recursive: true });
-      migrated++;
-    }
-    const cacheSrc = join4(legacyPath, "scan-cache");
-    if (existsSync2(cacheSrc)) {
-      cpSync(cacheSrc, join4(newPath, "scan-cache"), { recursive: true });
-      migrated++;
-    }
-    const astSrc = join4(legacyPath, "ast-scan.json");
-    if (existsSync2(astSrc)) {
-      cpSync(astSrc, join4(newPath, "ast-scan.json"));
-      migrated++;
-    }
-    success(`Migrated ${migrated} item(s) from ${LEGACY_DIR}/ to ${CONFIG_DIR}/`);
-    if (!nonInteractive) {
-      const remove = await dist_default({
-        message: `Remove old ${LEGACY_DIR}/ directory?`,
-        default: false
-      });
-      if (remove) {
-        rmSync(legacyPath, { recursive: true, force: true });
-        success(`Removed ${LEGACY_DIR}/`);
-      }
-    }
-    return true;
-  } catch (err) {
-    warn(`Migration from ${LEGACY_DIR}/ failed: ${err instanceof Error ? err.message : err}`);
-    warn(`Continuing with fresh initialization...
-`);
-    return false;
-  }
-}
-
-// src/commands/init.ts
 var SKILLS_TARGET_BASE = ".claude/skills";
 var SKILL_DIRS = ["zefiro", "zefiro-copilot"];
 function registerInit(program2) {
@@ -3244,7 +3333,6 @@ function registerInit(program2) {
       const packageRoot = getPackageRoot();
       const nonInteractive = !!cmdOpts?.nonInteractive;
       header("zefiro init");
-      await migrateFromLegacy(projectRoot, nonInteractive);
       const qaiDir = join5(projectRoot, CONFIG_DIR);
       const isReInit = existsSync3(qaiDir);
       if (isReInit) {
@@ -3288,11 +3376,11 @@ function getDefaultAnswers() {
 async function askConfigQuestions() {
   info(`Configure your zefiro setup:
 `);
-  const baseUrl = await dist_default2({
+  const baseUrl = await dist_default({
     message: "Application base URL (e.g., http://localhost:3000)",
     default: process.env.QAI_BASE_URL ?? ""
   });
-  const authMethod = await dist_default3({
+  const authMethod = await dist_default2({
     message: "Authentication method",
     choices: [
       { name: "Manual (authenticate in headed browser)", value: "manual" },
@@ -3300,7 +3388,7 @@ async function askConfigQuestions() {
     ],
     default: "manual"
   });
-  const outputDir = await dist_default2({
+  const outputDir = await dist_default({
     message: "Output directory for exploration results",
     default: "app-report"
   });
@@ -3383,7 +3471,7 @@ async function copySkillsToLocal(projectRoot, packageRoot, nonInteractive) {
 }
 function collectMarkdownFiles(dir, baseDir) {
   const results = [];
-  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+  for (const entry of readdirSync2(dir, { withFileTypes: true })) {
     const fullPath = join5(dir, entry.name);
     if (entry.isDirectory()) {
       results.push(...collectMarkdownFiles(fullPath, baseDir));
@@ -3408,17 +3496,7 @@ program2.name("zefiro").description("AI-powered application explorer and documen
 });
 registerInit(program2);
 registerExplore(program2);
+registerPush(program2);
 registerAuth(program2);
 registerMcp(program2);
-var userArgs = process.argv.slice(2);
-var commandNames = program2.commands.map((c) => c.name());
-var hasCommand = userArgs.some((a) => commandNames.includes(a));
-var hasFlags = userArgs.some((a) => a.startsWith("-"));
-var cols = process.stdout.columns || 80;
-var rows = process.stdout.rows || 24;
-if (!hasCommand && !hasFlags && process.stdout.isTTY && cols >= 60 && rows >= 20) {
-  const { launchTui } = await import("./App-bh752tgg.js");
-  await launchTui(program2);
-} else {
-  program2.parse();
-}
+program2.parse();

package/dist/explorer-ckk9bkff.js

@@ -0,0 +1,11 @@
+import {
+  runExploration
+} from "./cli-7hvj61ht.js";
+import"./cli-b26q1e27.js";
+import"./cli-kjyet1n8.js";
+import"./cli-zvk8gwe4.js";
+import"./cli-5w708rbb.js";
+import"./cli-wckvcay0.js";
+export {
+  runExploration
+};

package/dist/explorer-svj2p317.js

@@ -0,0 +1,10 @@
+import {
+  runExploration
+} from "./cli-m1ghts25.js";
+import"./cli-b26q1e27.js";
+import"./cli-6qr9gvkp.js";
+import"./cli-zvk8gwe4.js";
+import"./cli-wckvcay0.js";
+export {
+  runExploration
+};

package/dist/graph-builder-ca71yjkc.js

@@ -0,0 +1,10 @@
+import {
+  buildReportGraph,
+  buildReportSections
+} from "./cli-ewbvvxm8.js";
+import"./cli-5w708rbb.js";
+import"./cli-wckvcay0.js";
+export {
+  buildReportSections,
+  buildReportGraph
+};

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   getPackageRoot,
   getProjectRoot,
   loadConfig
-} from "./cli-cymqw41r.js";
+} from "./cli-mm7ct90g.js";
 import"./cli-z2krvkcq.js";
 import"./cli-wckvcay0.js";
 export {