zefiro 0.8.1 → 0.10.0

package/dist/cli.js

@@ -4,32 +4,38 @@ 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-7hvj61ht.js";
 import {
   banner,
   error,
   header,
   info,
   require_picocolors,
-  runExploration,
   setVerbose,
   success,
   warn
-} from "./cli-qb5kgwe4.js";
+} from "./cli-b26q1e27.js";
+import {
+  generateIndexHtml,
+  generateReadme
+} from "./cli-kjyet1n8.js";
 import {
   ensureDir,
   writeFile
 } from "./cli-zvk8gwe4.js";
 import {
-  generateIndexHtml,
-  generateReadme
-} from "./cli-07avh830.js";
+  buildReportGraph,
+  buildReportSections
+} from "./cli-ewbvvxm8.js";
+import"./cli-5w708rbb.js";
 import {
   __commonJS,
   __require,
@@ -2150,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) {
@@ -2173,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";
@@ -2201,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;
@@ -2749,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;
@@ -3119,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: {
@@ -3162,78 +3322,10 @@ 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 = ".claude/skills/zefiro";
+var SKILLS_TARGET_BASE = ".claude/skills";
+var SKILL_DIRS = ["zefiro", "zefiro-copilot"];
 function registerInit(program2) {
   program2.command("init").description("Initialize zefiro configuration for your project").option("--non-interactive", "Skip interactive prompts, use defaults").action(async (cmdOpts) => {
     try {
@@ -3241,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) {
@@ -3285,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" },
@@ -3297,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"
   });
@@ -3331,44 +3422,56 @@ ${qaiBlock}
   success(`Environment variables written to .env`);
 }
 async function copySkillsToLocal(projectRoot, packageRoot, nonInteractive) {
-  const sourceDir = join5(packageRoot, "skills", "zefiro");
-  const targetDir = join5(projectRoot, SKILLS_TARGET);
-  if (!existsSync3(sourceDir)) {
+  const sourceBase = join5(packageRoot, "skills");
+  const targetBase = join5(projectRoot, SKILLS_TARGET_BASE);
+  if (!existsSync3(sourceBase)) {
     warn("Could not read package skills directory");
     return 0;
   }
-  const files = collectMarkdownFiles(sourceDir, sourceDir);
-  if (files.length === 0)
+  let totalSourceFiles = [];
+  let totalExistingFiles = 0;
+  for (const skillDir of SKILL_DIRS) {
+    const sourceDir = join5(sourceBase, skillDir);
+    if (!existsSync3(sourceDir))
+      continue;
+    const files = collectMarkdownFiles(sourceDir, sourceDir);
+    for (const f of files)
+      totalSourceFiles.push({ dir: skillDir, relPath: f });
+  }
+  if (totalSourceFiles.length === 0)
     return 0;
-  const targetExists = existsSync3(targetDir);
-  if (targetExists) {
-    const existingFiles = collectMarkdownFiles(targetDir, targetDir);
-    if (existingFiles.length > 0) {
-      if (nonInteractive) {
-        info(`Skill files already exist in ${SKILLS_TARGET}/, skipping`);
-        return 0;
-      }
-      const { confirm } = await import("./index-0yaea7f8.js");
-      const overwrite = await confirm({
-        message: `Update skills to latest version? (${files.length} files, currently ${existingFiles.length} in ${SKILLS_TARGET}/)`,
-        default: true
-      });
-      if (!overwrite) {
-        info("Skipping skill copy");
-        return 0;
-      }
+  for (const skillDir of SKILL_DIRS) {
+    const targetDir = join5(targetBase, skillDir);
+    if (existsSync3(targetDir)) {
+      totalExistingFiles += collectMarkdownFiles(targetDir, targetDir).length;
+    }
+  }
+  if (totalExistingFiles > 0) {
+    if (nonInteractive) {
+      info(`Skill files already exist in ${SKILLS_TARGET_BASE}/, skipping`);
+      return 0;
+    }
+    const { confirm } = await import("./index-0yaea7f8.js");
+    const overwrite = await confirm({
+      message: `Update skills to latest version? (${totalSourceFiles.length} files, currently ${totalExistingFiles} in ${SKILLS_TARGET_BASE}/)`,
+      default: true
+    });
+    if (!overwrite) {
+      info("Skipping skill copy");
+      return 0;
     }
   }
-  for (const relPath of files) {
-    const content = readFileSync3(join5(sourceDir, relPath), "utf-8");
-    writeFile(join5(targetDir, relPath), content);
+  for (const { dir, relPath } of totalSourceFiles) {
+    const content = readFileSync3(join5(sourceBase, dir, relPath), "utf-8");
+    writeFile(join5(targetBase, dir, relPath), content);
   }
-  success(`Skills copied to ${SKILLS_TARGET}/ (${files.length} files)`);
-  return files.length;
+  const skillNames = SKILL_DIRS.join(", ");
+  success(`Skills copied to ${SKILLS_TARGET_BASE}/ [${skillNames}] (${totalSourceFiles.length} files)`);
+  return totalSourceFiles.length;
 }
 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));
@@ -3393,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-g6bmbak1.js

@@ -0,0 +1,10 @@
+import {
+  runExploration
+} from "./cli-g7n2me6z.js";
+import"./cli-b26q1e27.js";
+import"./cli-zvk8gwe4.js";
+import"./cli-6qr9gvkp.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 {