zefiro 0.9.0 → 0.10.0

package/dist/cli-kjyet1n8.js

@@ -0,0 +1,384 @@
+import {
+  topologyToAscii
+} from "./cli-5w708rbb.js";
+
+// src/browser/report.ts
+function generateSectionMarkdown(page, relatedPages, annotations) {
+  const analysis = page.analysis;
+  const lines = [];
+  const name = analysis?.pageName ?? page.title ?? page.slug;
+  lines.push(`# ${name} (\`${page.path}\`)`);
+  lines.push("");
+  if (analysis?.description) {
+    lines.push(`> ${analysis.description}`);
+    lines.push("");
+  }
+  lines.push(`**Route:** \`${page.path}\``);
+  if (analysis?.navigation?.tabs?.length) {
+    lines.push(`**Tabs:** ${analysis.navigation.tabs.join(", ")}`);
+  }
+  lines.push("");
+  lines.push("---");
+  lines.push("");
+  lines.push(`![${name}](../screenshots/${page.slug}/01-default.png)`);
+  lines.push("");
+  if (analysis?.sections) {
+    for (const section of analysis.sections) {
+      lines.push(`## ${section.name}`);
+      lines.push("");
+      if (section.elements?.length) {
+        const hasRequired = section.elements.some((e) => e.required !== undefined);
+        if (hasRequired) {
+          lines.push("| Field | Type | Required | Description |");
+          lines.push("|-------|------|----------|-------------|");
+          for (const el of section.elements) {
+            lines.push(`| ${el.name} | ${el.type} | ${el.required ? "Yes" : "No"} | ${el.description} |`);
+          }
+        } else {
+          lines.push("| Control | Type | Description |");
+          lines.push("|---------|------|-------------|");
+          for (const el of section.elements) {
+            lines.push(`| ${el.name} | ${el.type} | ${el.description} |`);
+          }
+        }
+        lines.push("");
+      }
+      if (section.tableColumns?.length) {
+        lines.push("### Table Columns");
+        lines.push("");
+        lines.push("| Column | Sortable | Description |");
+        lines.push("|--------|----------|-------------|");
+        for (const col of section.tableColumns) {
+          lines.push(`| ${col.name} | ${col.sortable ? "Yes" : "No"} | ${col.description} |`);
+        }
+        lines.push("");
+      }
+      lines.push("---");
+      lines.push("");
+    }
+  }
+  if (analysis?.actions?.length) {
+    lines.push("## Available Actions");
+    lines.push("");
+    for (const action of analysis.actions) {
+      lines.push(`- ${action}`);
+    }
+    lines.push("");
+  }
+  if (analysis?.observations?.length) {
+    lines.push("## Key Behaviors");
+    lines.push("");
+    for (const obs of analysis.observations) {
+      lines.push(`- ${obs}`);
+    }
+    lines.push("");
+  }
+  const related = relatedPages.filter((p) => p.slug !== page.slug);
+  if (related.length > 0) {
+    lines.push("## Related Pages");
+    lines.push("");
+    for (const rp of related) {
+      lines.push(`- [${rp.name}](./${rp.slug}.md)`);
+    }
+    lines.push("");
+  }
+  if (annotations?.length) {
+    lines.push("## Annotations (voice)");
+    lines.push("");
+    for (const ann of annotations) {
+      lines.push(`- "${ann.text}" — ${ann.timestamp}`);
+    }
+    lines.push("");
+  }
+  return lines.join(`
+`);
+}
+function generateReadme(state) {
+  const lines = [];
+  const visited = Array.from(state.pages.values()).filter((p) => p.status === "visited");
+  const errors = Array.from(state.pages.values()).filter((p) => p.status === "error");
+  lines.push("# Application Map");
+  lines.push("");
+  lines.push(`> **Scan Date:** ${new Date(state.startedAt).toISOString().split("T")[0]}`);
+  lines.push(`> **URL:** \`${state.baseUrl}\``);
+  lines.push(`> **Pages Explored:** ${visited.length}`);
+  lines.push("");
+  lines.push("---");
+  lines.push("");
+  lines.push("## Application Structure");
+  lines.push("");
+  lines.push("```");
+  lines.push(`Application (${state.baseUrl})`);
+  if (state.topology.length > 0) {
+    lines.push(topologyToAscii(state.topology));
+  }
+  lines.push("```");
+  lines.push("");
+  lines.push("---");
+  lines.push("");
+  lines.push("## Section Reports");
+  lines.push("");
+  lines.push("| Section | Report | Screenshots |");
+  lines.push("|---------|--------|-------------|");
+  for (const page of visited) {
+    const name = page.analysis?.pageName ?? page.title ?? page.slug;
+    lines.push(`| ${name} | [${page.slug}.md](./sections/${page.slug}.md) | [screenshots/${page.slug}/](./screenshots/${page.slug}/) |`);
+  }
+  lines.push("");
+  lines.push("---");
+  lines.push("");
+  lines.push("## Route Map");
+  lines.push("");
+  lines.push("| Route | Section | Elements | Links |");
+  lines.push("|-------|---------|----------|-------|");
+  for (const page of visited) {
+    const name = page.analysis?.pageName ?? page.title ?? page.slug;
+    lines.push(`| \`${page.path}\` | ${name} | ${page.elements.length} | ${page.outgoingLinks.length} |`);
+  }
+  lines.push("");
+  if (errors.length > 0) {
+    lines.push("---");
+    lines.push("");
+    lines.push("## Errors");
+    lines.push("");
+    for (const page of errors) {
+      lines.push(`- \`${page.url}\`: ${page.error}`);
+    }
+    lines.push("");
+  }
+  lines.push("---");
+  lines.push("");
+  lines.push("## Screenshot Inventory");
+  lines.push("");
+  lines.push(`| Section | Count |`);
+  lines.push(`|---------|-------|`);
+  let total = 0;
+  for (const page of visited) {
+    lines.push(`| ${page.analysis?.pageName ?? page.slug} | 1 |`);
+    total++;
+  }
+  lines.push(`| **Total** | **${total}** |`);
+  lines.push("");
+  return lines.join(`
+`);
+}
+function generateIndexHtml(state) {
+  const visited = Array.from(state.pages.values()).filter((p) => p.status === "visited");
+  const screensData = {};
+  for (const page of visited) {
+    const name = page.analysis?.pageName ?? page.title ?? page.slug;
+    screensData[page.slug] = [{
+      src: page.screenshot,
+      label: name,
+      desc: page.analysis?.description ?? `Page at ${page.path}`
+    }];
+  }
+  const sidebarItems = visited.map((page) => {
+    const name = page.analysis?.pageName ?? page.title ?? page.slug;
+    return `<div class="sidebar-item${visited[0] === page ? " active" : ""}" data-section="${page.slug}" onclick="showSection('${page.slug}')">
+      <span class="icon">\uD83D\uDCC4</span>${name}<span class="count">1</span>
+    </div>`;
+  }).join(`
+      `);
+  const sections = visited.map((page) => {
+    const name = page.analysis?.pageName ?? page.title ?? page.slug;
+    const isFirst = visited[0] === page;
+    return `<div id="sec-${page.slug}" class="flow-section${isFirst ? " active" : ""}">
+      <div class="flow-title">${name}</div>
+      <div class="flow-subtitle">${page.analysis?.description ?? ""}</div>
+      <div class="flow-route">${page.path}</div>
+      <div class="flow-row">
+        <div class="flow-card" onclick="openLightbox('${page.slug}', 0)">
+          <div class="card-thumb" style="background-image:url('${page.screenshot}')">
+            <span class="tag tag-page">Page</span>
+          </div>
+          <div class="card-body">
+            <div class="card-label">${name}</div>
+            <div class="card-desc">${page.analysis?.description ?? ""}</div>
+          </div>
+        </div>
+      </div>
+    </div>`;
+  }).join(`
+    `);
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Application Map</title>
+<style>
+  :root {
+    --bg: #0f1117;
+    --surface: #1a1d27;
+    --surface2: #242837;
+    --border: #2e3348;
+    --text: #e1e4ed;
+    --text-dim: #8b90a5;
+    --accent: #6366f1;
+    --accent-glow: rgba(99,102,241,0.25);
+    --green: #22c55e;
+    --amber: #f59e0b;
+    --red: #ef4444;
+    --cyan: #06b6d4;
+    --pink: #ec4899;
+  }
+  * { margin: 0; padding: 0; box-sizing: border-box; }
+  body {
+    font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif;
+    background: var(--bg); color: var(--text);
+    overflow: hidden; height: 100vh;
+  }
+  .topbar {
+    position: fixed; top: 0; left: 0; right: 0; z-index: 100;
+    height: 56px; background: var(--surface);
+    border-bottom: 1px solid var(--border);
+    display: flex; align-items: center; padding: 0 24px; gap: 16px;
+  }
+  .topbar h1 { font-size: 16px; font-weight: 600; }
+  .topbar .badge {
+    font-size: 11px; padding: 3px 10px; border-radius: 20px;
+    background: var(--accent); color: #fff; font-weight: 500;
+  }
+  .topbar .sep { flex: 1; }
+  .main { display: flex; height: 100vh; padding-top: 56px; }
+  .sidebar {
+    width: 260px; min-width: 260px;
+    background: var(--surface); border-right: 1px solid var(--border);
+    overflow-y: auto; padding: 16px 0;
+  }
+  .sidebar-item {
+    display: flex; align-items: center; gap: 10px;
+    padding: 8px 20px; border-radius: 8px; cursor: pointer;
+    font-size: 13px; color: var(--text-dim); margin: 0 8px 2px;
+  }
+  .sidebar-item:hover { background: var(--surface2); color: var(--text); }
+  .sidebar-item.active { background: var(--accent-glow); color: var(--accent); font-weight: 500; }
+  .sidebar-item .icon { font-size: 16px; width: 20px; text-align: center; }
+  .sidebar-item .count {
+    margin-left: auto; font-size: 11px; background: var(--surface2);
+    padding: 1px 7px; border-radius: 10px; color: var(--text-dim);
+  }
+  .canvas-area { flex: 1; overflow: hidden; }
+  .canvas-scroll { width: 100%; height: 100%; overflow: auto; padding: 40px; }
+  .flow-section { display: none; }
+  .flow-section.active { display: block; }
+  .flow-title { font-size: 24px; font-weight: 700; margin-bottom: 4px; }
+  .flow-subtitle { font-size: 14px; color: var(--text-dim); margin-bottom: 8px; }
+  .flow-route {
+    display: inline-block; font-size: 12px; font-family: monospace;
+    background: var(--surface2); padding: 3px 10px; border-radius: 6px;
+    color: var(--text-dim); margin-bottom: 24px;
+  }
+  .flow-row { display: flex; gap: 16px; flex-wrap: wrap; }
+  .flow-card {
+    width: 320px; background: var(--surface); border: 1px solid var(--border);
+    border-radius: 12px; overflow: hidden; cursor: pointer; transition: border-color 0.15s;
+  }
+  .flow-card:hover { border-color: var(--accent); }
+  .card-thumb {
+    height: 180px; background-size: cover; background-position: top center;
+    position: relative;
+  }
+  .tag {
+    position: absolute; top: 8px; right: 8px;
+    font-size: 10px; padding: 2px 8px; border-radius: 4px;
+    font-weight: 600; text-transform: uppercase;
+  }
+  .tag-page { background: var(--accent); color: #fff; }
+  .tag-modal { background: var(--pink); color: #fff; }
+  .tag-action { background: var(--amber); color: #000; }
+  .card-body { padding: 12px 16px; }
+  .card-label { font-size: 14px; font-weight: 600; margin-bottom: 4px; }
+  .card-desc { font-size: 12px; color: var(--text-dim); }
+  /* Lightbox */
+  .lightbox {
+    display: none; position: fixed; inset: 0; z-index: 200;
+    background: rgba(0,0,0,0.9); align-items: center; justify-content: center;
+  }
+  .lightbox.open { display: flex; }
+  .lightbox img { max-width: 90vw; max-height: 80vh; border-radius: 8px; }
+  .lb-caption {
+    position: fixed; bottom: 40px; left: 50%; transform: translateX(-50%);
+    text-align: center; color: var(--text);
+  }
+  .lb-counter { font-size: 12px; color: var(--text-dim); margin-bottom: 4px; }
+  .lb-label { font-size: 16px; font-weight: 600; }
+  .lb-close {
+    position: fixed; top: 20px; right: 24px; font-size: 24px;
+    color: var(--text-dim); cursor: pointer; z-index: 201;
+  }
+  .lb-nav {
+    position: fixed; top: 50%; font-size: 32px; color: var(--text-dim);
+    cursor: pointer; padding: 20px; z-index: 201;
+  }
+  .lb-prev { left: 10px; }
+  .lb-next { right: 10px; }
+</style>
+</head>
+<body>
+  <div class="topbar">
+    <h1>Application Map</h1>
+    <span class="badge">Zefiro</span>
+    <span class="sep"></span>
+    <span style="font-size:12px;color:var(--text-dim)">${visited.length} pages</span>
+  </div>
+  <div class="main">
+    <div class="sidebar">
+      ${sidebarItems}
+    </div>
+    <div class="canvas-area">
+      <div class="canvas-scroll">
+        ${sections}
+      </div>
+    </div>
+  </div>
+  <div class="lightbox" id="lightbox" onclick="if(event.target===this)closeLightbox()">
+    <span class="lb-close" onclick="closeLightbox()">✕</span>
+    <span class="lb-nav lb-prev" onclick="navLightbox(-1)">‹</span>
+    <img id="lb-img" src="" alt="">
+    <span class="lb-nav lb-next" onclick="navLightbox(1)">›</span>
+    <div class="lb-caption">
+      <div class="lb-counter" id="lb-counter"></div>
+      <div class="lb-label" id="lb-label"></div>
+    </div>
+  </div>
+  <script>
+    const screens = ${JSON.stringify(screensData, null, 2)};
+    let lbSection = null, lbIndex = 0;
+    function showSection(slug) {
+      document.querySelectorAll('.flow-section').forEach(s => s.classList.remove('active'));
+      document.querySelectorAll('.sidebar-item').forEach(s => s.classList.remove('active'));
+      const sec = document.getElementById('sec-' + slug);
+      if (sec) sec.classList.add('active');
+      const item = document.querySelector('[data-section="' + slug + '"]');
+      if (item) item.classList.add('active');
+    }
+    function openLightbox(section, index) {
+      lbSection = section; lbIndex = index;
+      const items = screens[section] || [];
+      if (!items[index]) return;
+      document.getElementById('lb-img').src = items[index].src;
+      document.getElementById('lb-label').textContent = items[index].label;
+      document.getElementById('lb-counter').textContent = (index + 1) + ' / ' + items.length;
+      document.getElementById('lightbox').classList.add('open');
+    }
+    function closeLightbox() {
+      document.getElementById('lightbox').classList.remove('open');
+    }
+    function navLightbox(dir) {
+      const items = screens[lbSection] || [];
+      lbIndex = (lbIndex + dir + items.length) % items.length;
+      openLightbox(lbSection, lbIndex);
+    }
+    document.addEventListener('keydown', e => {
+      if (e.key === 'Escape') closeLightbox();
+      if (e.key === 'ArrowLeft') navLightbox(-1);
+      if (e.key === 'ArrowRight') navLightbox(1);
+    });
+  </script>
+</body>
+</html>`;
+}
+
+export { generateSectionMarkdown, generateReadme, generateIndexHtml };

package/dist/cli-m1ghts25.js

@@ -0,0 +1,133 @@
+import {
+  AgentBrowser,
+  authenticate,
+  error,
+  info,
+  success,
+  verbose
+} from "./cli-b26q1e27.js";
+import {
+  buildTopology,
+  extractHrefsFromElements,
+  generateSectionMarkdown,
+  normalizeUrl,
+  shouldVisit,
+  urlToSlug
+} from "./cli-6qr9gvkp.js";
+import {
+  ensureDir,
+  writeFile
+} from "./cli-zvk8gwe4.js";
+
+// src/browser/explorer.ts
+import { join } from "node:path";
+async function runExploration(config) {
+  const state = {
+    baseUrl: config.baseUrl,
+    startedAt: new Date().toISOString(),
+    pages: new Map,
+    queue: [],
+    topology: []
+  };
+  const browser = new AgentBrowser({
+    session: config.sessionName,
+    headed: config.headed || config.auth.method === "manual"
+  });
+  const visited = new Set;
+  const screenshotsDir = join(config.outputDir, "screenshots");
+  const sectionsDir = join(config.outputDir, "sections");
+  ensureDir(screenshotsDir);
+  ensureDir(sectionsDir);
+  try {
+    await authenticate(browser, config);
+    await browser.setViewport(1440, 900);
+    const startUrl = normalizeUrl(config.baseUrl, config.baseUrl);
+    state.queue.push(startUrl);
+    let pageCount = 0;
+    while (state.queue.length > 0 && pageCount < config.maxPages) {
+      const url = state.queue.shift();
+      const normalized = normalizeUrl(url, config.baseUrl);
+      if (visited.has(normalized))
+        continue;
+      if (!shouldVisit(url, config.baseUrl, config.excludePatterns, visited)) {
+        continue;
+      }
+      visited.add(normalized);
+      const slug = urlToSlug(url, config.baseUrl);
+      info(`[${pageCount + 1}/${config.maxPages}] Exploring: ${url}`);
+      const page = {
+        url: normalized,
+        path: new URL(normalized).pathname,
+        title: "",
+        slug,
+        depth: 0,
+        screenshot: "",
+        elements: [],
+        outgoingLinks: [],
+        status: "pending"
+      };
+      try {
+        await browser.open(url);
+        await browser.waitForLoad(config.waitStrategy, config.waitDelay);
+        const actualUrl = await browser.getUrl();
+        const actualNormalized = normalizeUrl(actualUrl, config.baseUrl);
+        if (actualNormalized !== normalized) {
+          page.url = actualNormalized;
+          page.path = new URL(actualNormalized).pathname;
+          page.slug = urlToSlug(actualUrl, config.baseUrl);
+          if (visited.has(actualNormalized)) {
+            verbose(`  Redirected to already-visited ${actualUrl}, skipping`);
+            continue;
+          }
+          visited.add(actualNormalized);
+        }
+        page.title = await browser.getTitle();
+        const slugDir = join(screenshotsDir, page.slug);
+        ensureDir(slugDir);
+        const screenshotPath = join(slugDir, "01-default.png");
+        await browser.screenshot(screenshotPath);
+        page.screenshot = `screenshots/${page.slug}/01-default.png`;
+        page.elements = await browser.snapshot();
+        const linkRefs = extractHrefsFromElements(page.elements);
+        for (const ref of linkRefs) {
+          try {
+            const href = await browser.getAttribute(ref, "href");
+            if (href) {
+              const linkUrl = normalizeUrl(href, actualUrl);
+              page.outgoingLinks.push(linkUrl);
+              if (shouldVisit(linkUrl, config.baseUrl, config.excludePatterns, visited)) {
+                state.queue.push(linkUrl);
+              }
+            }
+          } catch {}
+        }
+        page.depth = calculateDepth(page.path);
+        const relatedPages = Array.from(state.pages.values()).filter((p) => p.status === "visited").map((p) => ({ slug: p.slug, name: p.analysis?.pageName ?? p.title, path: p.path }));
+        const markdown = generateSectionMarkdown(page, relatedPages);
+        writeFile(join(sectionsDir, `${page.slug}.md`), markdown);
+        page.status = "visited";
+        page.visitedAt = new Date().toISOString();
+        pageCount++;
+        success(`  ${page.title || page.slug} — ${page.elements.length} elements, ${page.outgoingLinks.length} links`);
+      } catch (err) {
+        page.status = "error";
+        page.error = err.message;
+        error(`  Error: ${err.message}`);
+      }
+      state.pages.set(page.url, page);
+    }
+    state.topology = buildTopology(state.pages);
+    state.completedAt = new Date().toISOString();
+    await browser.close();
+  } catch (err) {
+    error(`Exploration failed: ${err.message}`);
+    await browser.close();
+    throw err;
+  }
+  return state;
+}
+function calculateDepth(path) {
+  const segments = path.replace(/^\/|\/$/g, "").split("/").filter(Boolean);
+  return segments.length;
+}
+export { runExploration };

package/dist/cli-mm7ct90g.js

@@ -0,0 +1,110 @@
+import {
+  exports_external
+} from "./cli-z2krvkcq.js";
+
+// src/config/schema.ts
+function nested(shape) {
+  const inner = exports_external.object(shape);
+  return exports_external.preprocess((val) => val ?? {}, inner);
+}
+var PathsSchema = exports_external.object({
+  workingDir: exports_external.string().default(".qai/zefiro"),
+  outputDir: exports_external.string().default("app-report")
+});
+var BrowserSchema = exports_external.object({
+  sessionName: exports_external.string().default("zefiro"),
+  headed: exports_external.boolean().default(false),
+  viewport: exports_external.object({
+    width: exports_external.number().default(1440),
+    height: exports_external.number().default(900)
+  }).default({ width: 1440, height: 900 }),
+  waitStrategy: exports_external.enum(["networkidle", "load", "domcontentloaded"]).default("networkidle"),
+  waitDelay: exports_external.number().default(1500),
+  maxPages: exports_external.number().default(100),
+  pageTimeout: exports_external.number().default(30000),
+  excludePatterns: exports_external.array(exports_external.string()).default([])
+});
+var AuthSchema = exports_external.object({
+  method: exports_external.enum(["state-file", "manual"]).default("manual"),
+  stateFile: exports_external.string().nullable().default(null)
+});
+var QaiConfigSchema = exports_external.object({
+  baseUrl: exports_external.string().nullable().default(null),
+  paths: nested(PathsSchema.shape),
+  browser: nested(BrowserSchema.shape),
+  auth: nested(AuthSchema.shape),
+  contextFile: exports_external.string().default(".qai/zefiro/context.md")
+});
+function defineConfig(config) {
+  return config;
+}
+
+// src/config/loader.ts
+import { existsSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+var CONFIG_DIR = ".qai/zefiro";
+var CONFIG_FILENAMES = ["config.ts", "config.js", "config.mjs"];
+var cachedConfig = null;
+var cachedProjectRoot = null;
+function findConfigDir(startDir) {
+  let dir = resolve(startDir);
+  const root = dirname(dir) === dir ? dir : undefined;
+  while (true) {
+    const candidate = join(dir, CONFIG_DIR);
+    if (existsSync(join(candidate, "agents")) || existsSync(join(candidate, "context.md"))) {
+      return dir;
+    }
+    if (existsSync(candidate)) {
+      return dir;
+    }
+    for (const name of CONFIG_FILENAMES) {
+      if (existsSync(join(candidate, name))) {
+        return dir;
+      }
+    }
+    const parent = dirname(dir);
+    if (parent === dir || dir === root)
+      return null;
+    dir = parent;
+  }
+}
+function getProjectRoot() {
+  if (cachedProjectRoot)
+    return cachedProjectRoot;
+  const found = findConfigDir(process.cwd());
+  cachedProjectRoot = found ?? process.cwd();
+  return cachedProjectRoot;
+}
+function getPackageRoot() {
+  let dir = import.meta.dirname;
+  while (!existsSync(join(dir, "package.json"))) {
+    const parent = dirname(dir);
+    if (parent === dir)
+      return dir;
+    dir = parent;
+  }
+  return dir;
+}
+async function loadConfig() {
+  if (cachedConfig)
+    return cachedConfig;
+  const projectRoot = getProjectRoot();
+  let userConfig = {};
+  const dir = join(projectRoot, CONFIG_DIR);
+  for (const name of CONFIG_FILENAMES) {
+    const configPath = join(dir, name);
+    if (existsSync(configPath)) {
+      try {
+        const fileUrl = pathToFileURL(configPath).href;
+        const mod = await import(fileUrl);
+        userConfig = mod.default ?? mod;
+        break;
+      } catch {}
+    }
+  }
+  cachedConfig = QaiConfigSchema.parse(userConfig);
+  return cachedConfig;
+}
+
+export { defineConfig, CONFIG_DIR, getProjectRoot, getPackageRoot, loadConfig };