helpshelf 0.1.0 → 0.2.0

package/dist/app-crawler-LPVXXFOR.js

@@ -0,0 +1,6 @@
+import {
+  crawlApp
+} from "./chunk-DT7ACGIP.js";
+export {
+  crawlApp
+};

package/dist/chunk-DT7ACGIP.js

@@ -0,0 +1,212 @@
+// src/crawler/app-crawler.ts
+import { chromium } from "playwright-core";
+import { join } from "path";
+import { existsSync } from "fs";
+async function crawlApp(options) {
+  const { url, email, password, snapshot, screenshotDir, maxPages, onProgress } = options;
+  const possiblePaths = [
+    process.env.CHROME_PATH,
+    "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+    `${process.env.HOME}/Library/Caches/ms-playwright/chromium-1208/chrome-mac-arm64/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing`
+  ].filter(Boolean);
+  let execPath;
+  for (const p of possiblePaths) {
+    if (existsSync(p)) {
+      execPath = p;
+      break;
+    }
+  }
+  const browser = await chromium.launch({
+    headless: true,
+    ...execPath ? { executablePath: execPath } : {}
+  });
+  const context = await browser.newContext({
+    viewport: { width: 1280, height: 800 },
+    deviceScaleFactor: 2
+    // Retina screenshots
+  });
+  const page = await context.newPage();
+  const pages = [];
+  const visited = /* @__PURE__ */ new Set();
+  let screenshotCount = 0;
+  try {
+    onProgress("Navigating to app...");
+    await page.goto(url, { waitUntil: "networkidle", timeout: 3e4 });
+    await page.waitForTimeout(1e3);
+    if (email && password) {
+      onProgress("Logging in...");
+      const loggedIn = await attemptLogin(page, email, password, url);
+      if (!loggedIn) {
+        onProgress("Login failed \u2014 continuing as anonymous");
+      } else {
+        onProgress("Logged in successfully");
+        await page.waitForTimeout(2e3);
+      }
+    }
+    onProgress("Discovering navigation...");
+    const navigation = await discoverNavigation(page);
+    const urlsToVisit = buildUrlList(page.url(), navigation, snapshot, maxPages);
+    onProgress(`Found ${urlsToVisit.length} pages to document`);
+    for (let i = 0; i < urlsToVisit.length; i++) {
+      const targetUrl = urlsToVisit[i];
+      const path = new URL(targetUrl).pathname;
+      if (visited.has(path)) continue;
+      visited.add(path);
+      onProgress(`[${i + 1}/${urlsToVisit.length}] Capturing ${path}`);
+      try {
+        await page.goto(targetUrl, { waitUntil: "networkidle", timeout: 15e3 });
+        await page.waitForTimeout(800);
+        const screenshotName = pathToFilename(path) + ".png";
+        const screenshotPath = join(screenshotDir, screenshotName);
+        await page.screenshot({ path: screenshotPath, fullPage: false });
+        screenshotCount++;
+        const capture = await extractPageInfo(page, path, screenshotName);
+        pages.push(capture);
+      } catch (err) {
+        onProgress(`  \u26A0 Skipped ${path}: ${err instanceof Error ? err.message : "timeout"}`);
+      }
+    }
+    const appName = await page.title() || snapshot?.project.name || null;
+    return {
+      baseUrl: url,
+      pages,
+      totalScreenshots: screenshotCount,
+      appName,
+      navigation
+    };
+  } finally {
+    await browser.close();
+  }
+}
+async function attemptLogin(page, email, password, baseUrl) {
+  const currentUrl = page.url();
+  const isLoginPage = currentUrl.includes("login") || currentUrl.includes("signin") || currentUrl.includes("auth");
+  if (!isLoginPage) {
+    for (const loginPath of ["/login", "/signin", "/auth/login", "/auth/signin"]) {
+      try {
+        await page.goto(new URL(loginPath, baseUrl).toString(), { waitUntil: "networkidle", timeout: 1e4 });
+        if (page.url().includes("login") || page.url().includes("signin") || page.url().includes("auth")) break;
+      } catch {
+        continue;
+      }
+    }
+  }
+  try {
+    const emailInput = await page.$('input[type="email"], input[name="email"], input[placeholder*="email" i], input[placeholder*="username" i]');
+    const passwordInput = await page.$('input[type="password"]');
+    if (!emailInput || !passwordInput) return false;
+    await emailInput.fill(email);
+    await passwordInput.fill(password);
+    const submitBtn = await page.$('button[type="submit"], button:has-text("Sign in"), button:has-text("Log in"), button:has-text("Login"), button:has-text("Sign In")');
+    if (submitBtn) {
+      await submitBtn.click();
+      await page.waitForNavigation({ waitUntil: "networkidle", timeout: 1e4 }).catch(() => {
+      });
+      await page.waitForTimeout(2e3);
+    }
+    const afterUrl = page.url();
+    return !afterUrl.includes("login") && !afterUrl.includes("signin");
+  } catch {
+    return false;
+  }
+}
+async function discoverNavigation(page) {
+  const sections = [];
+  try {
+    const navLinks = await page.$$eval(
+      'nav a[href], aside a[href], [role="navigation"] a[href]',
+      (anchors) => anchors.map((a) => ({
+        text: a.textContent?.trim() || "",
+        href: a.getAttribute("href") || ""
+      })).filter((l) => l.text && l.href && !l.href.startsWith("#") && !l.href.startsWith("http"))
+    );
+    if (navLinks.length > 0) {
+      sections.push({
+        label: "Navigation",
+        links: navLinks
+      });
+    }
+  } catch {
+  }
+  return { sections };
+}
+function buildUrlList(currentUrl, navigation, snapshot, maxPages) {
+  const baseUrl = new URL(currentUrl).origin;
+  const urls = /* @__PURE__ */ new Set();
+  urls.add(currentUrl);
+  for (const section of navigation.sections) {
+    for (const link of section.links) {
+      try {
+        const fullUrl = new URL(link.href, baseUrl).toString();
+        urls.add(fullUrl);
+      } catch {
+      }
+    }
+  }
+  if (snapshot) {
+    const pagePaths = /* @__PURE__ */ new Set();
+    for (const route of snapshot.apiRoutes) {
+      if (route.path.startsWith("/api/")) continue;
+      pagePaths.add(route.path);
+    }
+    for (const path of pagePaths) {
+      try {
+        urls.add(new URL(path, baseUrl).toString());
+      } catch {
+      }
+    }
+  }
+  return Array.from(urls).slice(0, maxPages);
+}
+async function extractPageInfo(page, path, screenshot) {
+  const title = await page.title();
+  const headings = await page.$$eval(
+    "h1, h2, h3",
+    (els) => els.map((el) => el.textContent?.trim() || "").filter(Boolean).slice(0, 10)
+  );
+  const elements = await page.$$eval(
+    "button:visible, a:visible, input:visible, select:visible",
+    (els) => els.slice(0, 30).map((el) => ({
+      type: el.tagName.toLowerCase() === "button" ? "button" : el.tagName.toLowerCase() === "a" ? "link" : el.tagName.toLowerCase() === "input" ? "input" : el.tagName.toLowerCase() === "select" ? "select" : "button",
+      text: el.textContent?.trim().slice(0, 100) || "",
+      ariaLabel: el.getAttribute("aria-label")
+    }))
+  );
+  const navItems = await page.$$eval(
+    "nav a, aside a",
+    (els) => els.map((el) => el.textContent?.trim() || "").filter(Boolean)
+  );
+  const category = detectCategory(path);
+  return {
+    url: page.url(),
+    path,
+    title,
+    screenshot,
+    headings,
+    elements,
+    navItems,
+    category
+  };
+}
+function detectCategory(path) {
+  const p = path.toLowerCase();
+  if (p.includes("setting")) return "Settings";
+  if (p.includes("billing") || p.includes("plan") || p.includes("subscription")) return "Billing";
+  if (p.includes("team") || p.includes("member") || p.includes("invite")) return "Team Management";
+  if (p.includes("analytic") || p.includes("stat") || p.includes("report")) return "Analytics";
+  if (p.includes("content") || p.includes("article") || p.includes("doc")) return "Content Management";
+  if (p.includes("integrat") || p.includes("connect") || p.includes("source")) return "Integrations";
+  if (p.includes("widget") || p.includes("floatie") || p.includes("preview")) return "Widget";
+  if (p.includes("announce")) return "Announcements";
+  if (p.includes("help") || p.includes("center")) return "Help Center";
+  if (p.includes("login") || p.includes("signup") || p.includes("auth")) return "Authentication";
+  if (p === "/" || p.includes("dashboard") || p.includes("overview")) return "Getting Started";
+  return "Features";
+}
+function pathToFilename(path) {
+  return (path || "home").replace(/^\//, "").replace(/\//g, "-").replace(/[^a-zA-Z0-9-]/g, "") || "home";
+}
+
+export {
+  crawlApp
+};

package/dist/index.js

@@ -1,28 +1,37 @@
 #!/usr/bin/env node
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
+import {
+  crawlApp
+} from "./chunk-DT7ACGIP.js";
 
 // src/index.ts
 import { Command } from "commander";
 
 // src/commands/scan.ts
-import { resolve, relative as relative4 } from "path";
+import { resolve, join as join8, relative as relative4 } from "path";
 import { writeFileSync, existsSync as existsSync8, mkdirSync } from "fs";
 import chalk from "chalk";
 import ora from "ora";
 
 // src/scanners/project.ts
 import { join, basename } from "path";
-import { readFileSync, existsSync } from "fs";
+import { existsSync } from "fs";
+
+// src/utils/fs.ts
+import { readFileSync } from "fs";
+function readFileSafe(path, encoding = "utf-8") {
+  try {
+    return readFileSync(path, encoding);
+  } catch {
+    return null;
+  }
+}
+
+// src/scanners/project.ts
 function scanProjectMeta(dir) {
   const pkgPath = join(dir, "package.json");
   if (existsSync(pkgPath)) {
     try {
-      const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+      const pkg = JSON.parse(readFileSafe(pkgPath) || "{}");
       return {
         name: pkg.name || basename(dir),
         description: pkg.description || null,
@@ -37,7 +46,7 @@ function scanProjectMeta(dir) {
   const pyprojectPath = join(dir, "pyproject.toml");
   if (existsSync(pyprojectPath)) {
     try {
-      const content = readFileSync(pyprojectPath, "utf-8");
+      const content = readFileSafe(pyprojectPath) || "";
       const nameMatch = content.match(/^name\s*=\s*"([^"]+)"/m);
       const versionMatch = content.match(/^version\s*=\s*"([^"]+)"/m);
       const descMatch = content.match(/^description\s*=\s*"([^"]+)"/m);
@@ -64,7 +73,7 @@ function scanProjectMeta(dir) {
 
 // src/scanners/stack.ts
 import { join as join2 } from "path";
-import { readFileSync as readFileSync2, existsSync as existsSync2 } from "fs";
+import { existsSync as existsSync2 } from "fs";
 function scanStack(dir) {
   const result = {
     framework: null,
@@ -101,7 +110,7 @@ function scanStack(dir) {
   const pkgPath = join2(dir, "package.json");
   if (existsSync2(pkgPath)) {
     try {
-      const pkg = JSON.parse(readFileSync2(pkgPath, "utf-8"));
+      const pkg = JSON.parse(readFileSafe(pkgPath) || "{}");
       const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
       if (allDeps["next"]) {
         result.framework = "next";
@@ -161,7 +170,7 @@ function scanStack(dir) {
   if (result.language === "python") {
     const reqPath = join2(dir, "requirements.txt");
     if (existsSync2(reqPath)) {
-      const reqs = readFileSync2(reqPath, "utf-8").toLowerCase();
+      const reqs = (readFileSafe(reqPath) || "").toLowerCase();
       if (reqs.includes("django")) {
         result.framework = "django";
         result.technologies.push("Django");
@@ -180,7 +189,7 @@ function scanStack(dir) {
 
 // src/scanners/readme.ts
 import { join as join3 } from "path";
-import { readFileSync as readFileSync3, existsSync as existsSync3 } from "fs";
+import { existsSync as existsSync3 } from "fs";
 var README_NAMES = ["README.md", "readme.md", "README.MD", "Readme.md", "README", "readme"];
 function scanReadme(dir) {
   let readmePath = null;
@@ -192,7 +201,8 @@ function scanReadme(dir) {
     }
   }
   if (!readmePath) return null;
-  const content = readFileSync3(readmePath, "utf-8");
+  const content = readFileSafe(readmePath);
+  if (!content) return null;
   return parseMarkdownSections(content);
 }
 function parseMarkdownSections(markdown) {
@@ -235,7 +245,7 @@ function parseMarkdownSections(markdown) {
 
 // src/scanners/api-routes.ts
 import { join as join4, relative } from "path";
-import { readFileSync as readFileSync4, existsSync as existsSync4, readdirSync, statSync } from "fs";
+import { existsSync as existsSync4, readdirSync, statSync } from "fs";
 function scanApiRoutes(dir, stack) {
   const routes = [];
   if (stack.framework === "next") {
@@ -267,7 +277,8 @@ function scanNextAppRoutes(projectDir, appDir, routes) {
     if (!filePath.includes("/api/")) return;
     const relPath = relative(appDir, filePath);
     const routePath = "/" + relPath.replace(/\/route\.(ts|js)$/, "").replace(/\[([^\]]+)\]/g, ":$1");
-    const content = readFileSync4(filePath, "utf-8");
+    const content = readFileSafe(filePath);
+    if (!content) return;
     const methods = extractHttpMethods(content);
     const description = extractRouteDescription(content);
     for (const method of methods) {
@@ -287,7 +298,8 @@ function scanNextPagesRoutes(projectDir, pagesDir, routes) {
     if (!filePath.match(/\.(ts|js|tsx|jsx)$/)) return;
     const relPath = relative(apiDir, filePath);
     const routePath = "/api/" + relPath.replace(/\.(ts|js|tsx|jsx)$/, "").replace(/\[([^\]]+)\]/g, ":$1").replace(/\/index$/, "");
-    const content = readFileSync4(filePath, "utf-8");
+    const content = readFileSafe(filePath);
+    if (!content) return;
     const description = extractRouteDescription(content);
     routes.push({
       method: "ALL",
@@ -305,7 +317,8 @@ function scanExpressRoutes(dir, routes) {
     if (!existsSync4(fullPath)) continue;
     walkDir(fullPath, (filePath) => {
       if (!filePath.match(/\.(ts|js)$/)) return;
-      const content = readFileSync4(filePath, "utf-8");
+      const content = readFileSafe(filePath);
+      if (!content) return;
       let match;
       while ((match = routePattern.exec(content)) !== null) {
         routes.push({
@@ -361,7 +374,7 @@ function walkDir(dir, callback) {
 
 // src/scanners/env-vars.ts
 import { join as join5, relative as relative2 } from "path";
-import { readFileSync as readFileSync5, existsSync as existsSync5, readdirSync as readdirSync2 } from "fs";
+import { existsSync as existsSync5, readdirSync as readdirSync2 } from "fs";
 var PUBLIC_PREFIXES = ["NEXT_PUBLIC_", "VITE_", "NUXT_PUBLIC_", "EXPO_PUBLIC_"];
 function scanEnvVars(dir) {
   const envMap = /* @__PURE__ */ new Map();
@@ -371,7 +384,8 @@ function scanEnvVars(dir) {
     const fullPath = join5(dir, srcDir);
     if (!existsSync5(fullPath)) continue;
     walkSourceFiles(fullPath, (filePath) => {
-      const content = readFileSync5(filePath, "utf-8");
+      const content = readFileSafe(filePath);
+      if (!content) return;
       const relFile = relative2(dir, filePath);
       const processEnvPattern = /process\.env\.([A-Z][A-Z0-9_]*)/g;
       let match;
@@ -392,7 +406,8 @@ function scanEnvVars(dir) {
   for (const config of rootConfigs) {
     const configPath = join5(dir, config);
     if (!existsSync5(configPath)) continue;
-    const content = readFileSync5(configPath, "utf-8");
+    const content = readFileSafe(configPath);
+    if (!content) continue;
     const relFile = config;
     const processEnvPattern = /process\.env\.([A-Z][A-Z0-9_]*)/g;
     let match;
@@ -434,7 +449,9 @@ function parseEnvExample(dir) {
   for (const name of candidates) {
     const path = join5(dir, name);
     if (!existsSync5(path)) continue;
-    const lines = readFileSync5(path, "utf-8").split("\n");
+    const content = readFileSafe(path);
+    if (!content) continue;
+    const lines = content.split("\n");
     let lastComment = "";
     for (const line of lines) {
       const trimmed = line.trim();
@@ -472,7 +489,7 @@ function walkSourceFiles(dir, callback) {
 
 // src/scanners/dependencies.ts
 import { join as join6 } from "path";
-import { readFileSync as readFileSync6, existsSync as existsSync6 } from "fs";
+import { existsSync as existsSync6 } from "fs";
 var CATEGORY_MAP = {
   // Frameworks
   "next": "framework",
@@ -570,7 +587,7 @@ function scanDependencies(dir) {
   const pkgPath = join6(dir, "package.json");
   if (!existsSync6(pkgPath)) return [];
   try {
-    const pkg = JSON.parse(readFileSync6(pkgPath, "utf-8"));
+    const pkg = JSON.parse(readFileSafe(pkgPath) || "{}");
     const deps = [];
     if (pkg.dependencies) {
       for (const [name, version] of Object.entries(pkg.dependencies)) {
@@ -919,34 +936,55 @@ async function scanCommand(options) {
   let readme = null;
   if (options.readme !== false) {
     spinner.start("Parsing README...");
-    readme = scanReadme(projectDir);
-    if (readme) {
-      spinner.succeed(`README: ${chalk.cyan(readme.length + " sections")}`);
-    } else {
-      spinner.warn("No README found");
+    try {
+      readme = scanReadme(projectDir);
+      if (readme) {
+        spinner.succeed(`README: ${chalk.cyan(readme.length + " sections")}`);
+      } else {
+        spinner.warn("No README found");
+      }
+    } catch {
+      spinner.warn("Could not read README (file may be on iCloud or network drive)");
     }
   }
   let apiRoutes = [];
   if (options.api !== false) {
     spinner.start("Detecting API routes...");
-    apiRoutes = scanApiRoutes(projectDir, stack);
-    spinner.succeed(`API routes: ${chalk.cyan(apiRoutes.length + " endpoints")}`);
+    try {
+      apiRoutes = scanApiRoutes(projectDir, stack);
+      spinner.succeed(`API routes: ${chalk.cyan(apiRoutes.length + " endpoints")}`);
+    } catch {
+      spinner.warn("Could not scan API routes");
+    }
   }
   let envVars = [];
   if (options.env !== false) {
     spinner.start("Scanning environment variables...");
-    envVars = scanEnvVars(projectDir);
-    spinner.succeed(`Env vars: ${chalk.cyan(envVars.length + " variables")}`);
+    try {
+      envVars = scanEnvVars(projectDir);
+      spinner.succeed(`Env vars: ${chalk.cyan(envVars.length + " variables")}`);
+    } catch {
+      spinner.warn("Could not scan environment variables");
+    }
   }
   let dependencies = [];
   if (options.deps !== false) {
     spinner.start("Analyzing dependencies...");
-    dependencies = scanDependencies(projectDir);
-    spinner.succeed(`Dependencies: ${chalk.cyan(dependencies.length + " packages")}`);
+    try {
+      dependencies = scanDependencies(projectDir);
+      spinner.succeed(`Dependencies: ${chalk.cyan(dependencies.length + " packages")}`);
+    } catch {
+      spinner.warn("Could not analyze dependencies");
+    }
   }
   spinner.start("Mapping file structure...");
-  const structure = scanFileStructure(projectDir);
-  spinner.succeed(`Structure: ${chalk.cyan(structure.sourceFileCount + " source files")}`);
+  let structure = { topLevel: [], sourceFileCount: 0, keyDirs: [] };
+  try {
+    structure = scanFileStructure(projectDir);
+    spinner.succeed(`Structure: ${chalk.cyan(structure.sourceFileCount + " source files")}`);
+  } catch {
+    spinner.warn("Could not map file structure");
+  }
   spinner.start("Generating FAQ items...");
   const faqs = generateFaqs({ project, stack, readme, apiRoutes, envVars, dependencies });
   spinner.succeed(`FAQs: ${chalk.cyan(faqs.length + " items generated")}`);
@@ -990,6 +1028,50 @@ async function scanCommand(options) {
   log(`   ${chalk.dim("Snapshot:")} ${chalk.underline(relative4(process.cwd(), outputPath))}`);
   log(`   ${chalk.dim("Docs template:")} ${chalk.underline(relative4(process.cwd(), templatePath))}`);
   log(`   ${chalk.dim("Duration:")} ${scanDurationMs}ms`);
+  if (options.url) {
+    log();
+    log(chalk.bold("\u{1F4F8} Capturing screenshots..."));
+    try {
+      const { crawlApp: crawlApp2 } = await import("./app-crawler-LPVXXFOR.js");
+      const screenshotDir = resolve(outputDir, "screenshots");
+      mkdirSync(screenshotDir, { recursive: true });
+      const maxPages = parseInt(options.maxPages || "20", 10);
+      const screenshotSpinner = ora("Launching browser...").start();
+      const result = await crawlApp2({
+        url: options.url,
+        email: options.email,
+        password: options.password,
+        snapshot,
+        screenshotDir,
+        maxPages,
+        onProgress: (msg) => {
+          screenshotSpinner.text = msg;
+        }
+      });
+      screenshotSpinner.succeed(`Captured ${result.totalScreenshots} screenshots from ${result.pages.length} pages`);
+      const manifest = {
+        version: 1,
+        capturedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        baseUrl: result.baseUrl,
+        pages: result.pages.map((p) => ({
+          path: p.path,
+          title: p.title,
+          screenshot: p.screenshot,
+          category: p.category,
+          headings: p.headings,
+          elements: p.elements.length,
+          buttons: p.elements.filter((e) => e.type === "button").map((e) => e.text).filter(Boolean),
+          inputs: p.elements.filter((e) => e.type === "input").length
+        })),
+        navigation: result.navigation
+      };
+      writeFileSync(join8(screenshotDir, "manifest.json"), JSON.stringify(manifest, null, 2));
+      log(`   ${chalk.dim("Screenshots:")} ${chalk.underline(relative4(process.cwd(), screenshotDir))}`);
+    } catch (err) {
+      log(chalk.yellow(`   \u26A0 Screenshots skipped: ${err instanceof Error ? err.message : "browser not available"}`));
+      log(chalk.dim("     Install Playwright with: npx playwright install chromium"));
+    }
+  }
   log();
   log(`   ${chalk.dim("Next steps:")}`);
   log(`   1. Write docs to ${chalk.cyan(".helpshelf/docs/")} (or let your AI agent write them using the template)`);
@@ -1106,7 +1188,7 @@ GUIDELINES:
 
 // src/commands/push.ts
 import { resolve as resolve2, join as join9, basename as basename2 } from "path";
-import { readFileSync as readFileSync8, existsSync as existsSync9, readdirSync as readdirSync5 } from "fs";
+import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, existsSync as existsSync9, readdirSync as readdirSync4, mkdirSync as mkdirSync2 } from "fs";
 import chalk2 from "chalk";
 import ora2 from "ora";
 async function pushCommand(options) {
@@ -1217,10 +1299,10 @@ async function pushCommand(options) {
 }
 function readDocsDirectory(dir) {
   if (!existsSync9(dir)) return [];
-  const files = readdirSync5(dir).filter((f) => f.endsWith(".md"));
+  const files = readdirSync4(dir).filter((f) => f.endsWith(".md"));
   const articles = [];
   for (const file of files) {
-    const content = readFileSync8(join9(dir, file), "utf-8");
+    const content = readFileSync2(join9(dir, file), "utf-8");
     const slug = basename2(file, ".md");
     const { frontmatter, body } = parseFrontmatter(content);
     const title = frontmatter.title || slug.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
@@ -1278,22 +1360,21 @@ function loadConfig() {
   try {
     const configPath = resolve2(".helpshelf/config.json");
     if (!existsSync9(configPath)) return null;
-    return JSON.parse(readFileSync8(configPath, "utf-8"));
+    return JSON.parse(readFileSync2(configPath, "utf-8"));
   } catch {
     return null;
   }
 }
 function saveConfig(config) {
   try {
-    const { writeFileSync: ws, mkdirSync: md } = __require("fs");
-    md(resolve2(".helpshelf"), { recursive: true });
-    ws(resolve2(".helpshelf/config.json"), JSON.stringify(config, null, 2));
+    mkdirSync2(resolve2(".helpshelf"), { recursive: true });
+    writeFileSync2(resolve2(".helpshelf/config.json"), JSON.stringify(config, null, 2));
   } catch {
   }
 }
 
 // src/commands/init.ts
-import { writeFileSync as writeFileSync2, existsSync as existsSync10, mkdirSync as mkdirSync2 } from "fs";
+import { writeFileSync as writeFileSync3, readFileSync as readFileSync3, existsSync as existsSync10, mkdirSync as mkdirSync3 } from "fs";
 import { resolve as resolve3, join as join10 } from "path";
 import chalk3 from "chalk";
 async function initCommand() {
@@ -1303,12 +1384,12 @@ async function initCommand() {
   console.log(chalk3.bold("\u{1F680} Initializing HelpShelf"));
   console.log();
   if (!existsSync10(helpshelfDir)) {
-    mkdirSync2(helpshelfDir, { recursive: true });
+    mkdirSync3(helpshelfDir, { recursive: true });
     console.log(chalk3.green("  \u2713"), "Created .helpshelf/ directory");
   }
   const configPath = join10(helpshelfDir, "config.json");
   if (!existsSync10(configPath)) {
-    writeFileSync2(configPath, JSON.stringify({
+    writeFileSync3(configPath, JSON.stringify({
       siteHash: "",
       apiKey: "",
       autoSync: false
@@ -1317,9 +1398,9 @@ async function initCommand() {
   }
   const gitignorePath = join10(dir, ".gitignore");
   if (existsSync10(gitignorePath)) {
-    const gitignore = __require("fs").readFileSync(gitignorePath, "utf-8");
+    const gitignore = readFileSync3(gitignorePath, "utf-8");
     if (!gitignore.includes(".helpshelf/snapshot.json")) {
-      writeFileSync2(gitignorePath, gitignore.trimEnd() + "\n\n# HelpShelf\n.helpshelf/snapshot.json\n");
+      writeFileSync3(gitignorePath, gitignore.trimEnd() + "\n\n# HelpShelf\n.helpshelf/snapshot.json\n");
       console.log(chalk3.green("  \u2713"), "Added .helpshelf/snapshot.json to .gitignore");
     }
   }
@@ -1332,238 +1413,27 @@ async function initCommand() {
 }
 
 // src/commands/screenshot.ts
-import { resolve as resolve5, join as join12 } from "path";
-import { readFileSync as readFileSync9, existsSync as existsSync12, mkdirSync as mkdirSync3, writeFileSync as writeFileSync4 } from "fs";
+import { resolve as resolve4, join as join11 } from "path";
+import { readFileSync as readFileSync4, existsSync as existsSync11, mkdirSync as mkdirSync4, writeFileSync as writeFileSync4 } from "fs";
 import chalk4 from "chalk";
 import ora3 from "ora";
-
-// src/crawler/app-crawler.ts
-import { chromium } from "playwright-core";
-import { join as join11 } from "path";
-import { existsSync as existsSync11 } from "fs";
-async function crawlApp(options) {
-  const { url, email, password, snapshot, screenshotDir, maxPages, onProgress } = options;
-  const possiblePaths = [
-    process.env.CHROME_PATH,
-    "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
-    `${process.env.HOME}/Library/Caches/ms-playwright/chromium-1208/chrome-mac-arm64/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing`
-  ].filter(Boolean);
-  let execPath;
-  for (const p of possiblePaths) {
-    if (existsSync11(p)) {
-      execPath = p;
-      break;
-    }
-  }
-  const browser = await chromium.launch({
-    headless: true,
-    ...execPath ? { executablePath: execPath } : {}
-  });
-  const context = await browser.newContext({
-    viewport: { width: 1280, height: 800 },
-    deviceScaleFactor: 2
-    // Retina screenshots
-  });
-  const page = await context.newPage();
-  const pages = [];
-  const visited = /* @__PURE__ */ new Set();
-  let screenshotCount = 0;
-  try {
-    onProgress("Navigating to app...");
-    await page.goto(url, { waitUntil: "networkidle", timeout: 3e4 });
-    await page.waitForTimeout(1e3);
-    if (email && password) {
-      onProgress("Logging in...");
-      const loggedIn = await attemptLogin(page, email, password, url);
-      if (!loggedIn) {
-        onProgress("Login failed \u2014 continuing as anonymous");
-      } else {
-        onProgress("Logged in successfully");
-        await page.waitForTimeout(2e3);
-      }
-    }
-    onProgress("Discovering navigation...");
-    const navigation = await discoverNavigation(page);
-    const urlsToVisit = buildUrlList(page.url(), navigation, snapshot, maxPages);
-    onProgress(`Found ${urlsToVisit.length} pages to document`);
-    for (let i = 0; i < urlsToVisit.length; i++) {
-      const targetUrl = urlsToVisit[i];
-      const path = new URL(targetUrl).pathname;
-      if (visited.has(path)) continue;
-      visited.add(path);
-      onProgress(`[${i + 1}/${urlsToVisit.length}] Capturing ${path}`);
-      try {
-        await page.goto(targetUrl, { waitUntil: "networkidle", timeout: 15e3 });
-        await page.waitForTimeout(800);
-        const screenshotName = pathToFilename(path) + ".png";
-        const screenshotPath = join11(screenshotDir, screenshotName);
-        await page.screenshot({ path: screenshotPath, fullPage: false });
-        screenshotCount++;
-        const capture = await extractPageInfo(page, path, screenshotName);
-        pages.push(capture);
-      } catch (err) {
-        onProgress(`  \u26A0 Skipped ${path}: ${err instanceof Error ? err.message : "timeout"}`);
-      }
-    }
-    const appName = await page.title() || snapshot?.project.name || null;
-    return {
-      baseUrl: url,
-      pages,
-      totalScreenshots: screenshotCount,
-      appName,
-      navigation
-    };
-  } finally {
-    await browser.close();
-  }
-}
-async function attemptLogin(page, email, password, baseUrl) {
-  const currentUrl = page.url();
-  const isLoginPage = currentUrl.includes("login") || currentUrl.includes("signin") || currentUrl.includes("auth");
-  if (!isLoginPage) {
-    for (const loginPath of ["/login", "/signin", "/auth/login", "/auth/signin"]) {
-      try {
-        await page.goto(new URL(loginPath, baseUrl).toString(), { waitUntil: "networkidle", timeout: 1e4 });
-        if (page.url().includes("login") || page.url().includes("signin") || page.url().includes("auth")) break;
-      } catch {
-        continue;
-      }
-    }
-  }
-  try {
-    const emailInput = await page.$('input[type="email"], input[name="email"], input[placeholder*="email" i], input[placeholder*="username" i]');
-    const passwordInput = await page.$('input[type="password"]');
-    if (!emailInput || !passwordInput) return false;
-    await emailInput.fill(email);
-    await passwordInput.fill(password);
-    const submitBtn = await page.$('button[type="submit"], button:has-text("Sign in"), button:has-text("Log in"), button:has-text("Login"), button:has-text("Sign In")');
-    if (submitBtn) {
-      await submitBtn.click();
-      await page.waitForNavigation({ waitUntil: "networkidle", timeout: 1e4 }).catch(() => {
-      });
-      await page.waitForTimeout(2e3);
-    }
-    const afterUrl = page.url();
-    return !afterUrl.includes("login") && !afterUrl.includes("signin");
-  } catch {
-    return false;
-  }
-}
-async function discoverNavigation(page) {
-  const sections = [];
-  try {
-    const navLinks = await page.$$eval(
-      'nav a[href], aside a[href], [role="navigation"] a[href]',
-      (anchors) => anchors.map((a) => ({
-        text: a.textContent?.trim() || "",
-        href: a.getAttribute("href") || ""
-      })).filter((l) => l.text && l.href && !l.href.startsWith("#") && !l.href.startsWith("http"))
-    );
-    if (navLinks.length > 0) {
-      sections.push({
-        label: "Navigation",
-        links: navLinks
-      });
-    }
-  } catch {
-  }
-  return { sections };
-}
-function buildUrlList(currentUrl, navigation, snapshot, maxPages) {
-  const baseUrl = new URL(currentUrl).origin;
-  const urls = /* @__PURE__ */ new Set();
-  urls.add(currentUrl);
-  for (const section of navigation.sections) {
-    for (const link of section.links) {
-      try {
-        const fullUrl = new URL(link.href, baseUrl).toString();
-        urls.add(fullUrl);
-      } catch {
-      }
-    }
-  }
-  if (snapshot) {
-    const pagePaths = /* @__PURE__ */ new Set();
-    for (const route of snapshot.apiRoutes) {
-      if (route.path.startsWith("/api/")) continue;
-      pagePaths.add(route.path);
-    }
-    for (const path of pagePaths) {
-      try {
-        urls.add(new URL(path, baseUrl).toString());
-      } catch {
-      }
-    }
-  }
-  return Array.from(urls).slice(0, maxPages);
-}
-async function extractPageInfo(page, path, screenshot) {
-  const title = await page.title();
-  const headings = await page.$$eval(
-    "h1, h2, h3",
-    (els) => els.map((el) => el.textContent?.trim() || "").filter(Boolean).slice(0, 10)
-  );
-  const elements = await page.$$eval(
-    "button:visible, a:visible, input:visible, select:visible",
-    (els) => els.slice(0, 30).map((el) => ({
-      type: el.tagName.toLowerCase() === "button" ? "button" : el.tagName.toLowerCase() === "a" ? "link" : el.tagName.toLowerCase() === "input" ? "input" : el.tagName.toLowerCase() === "select" ? "select" : "button",
-      text: el.textContent?.trim().slice(0, 100) || "",
-      ariaLabel: el.getAttribute("aria-label")
-    }))
-  );
-  const navItems = await page.$$eval(
-    "nav a, aside a",
-    (els) => els.map((el) => el.textContent?.trim() || "").filter(Boolean)
-  );
-  const category = detectCategory(path);
-  return {
-    url: page.url(),
-    path,
-    title,
-    screenshot,
-    headings,
-    elements,
-    navItems,
-    category
-  };
-}
-function detectCategory(path) {
-  const p = path.toLowerCase();
-  if (p.includes("setting")) return "Settings";
-  if (p.includes("billing") || p.includes("plan") || p.includes("subscription")) return "Billing";
-  if (p.includes("team") || p.includes("member") || p.includes("invite")) return "Team Management";
-  if (p.includes("analytic") || p.includes("stat") || p.includes("report")) return "Analytics";
-  if (p.includes("content") || p.includes("article") || p.includes("doc")) return "Content Management";
-  if (p.includes("integrat") || p.includes("connect") || p.includes("source")) return "Integrations";
-  if (p.includes("widget") || p.includes("floatie") || p.includes("preview")) return "Widget";
-  if (p.includes("announce")) return "Announcements";
-  if (p.includes("help") || p.includes("center")) return "Help Center";
-  if (p.includes("login") || p.includes("signup") || p.includes("auth")) return "Authentication";
-  if (p === "/" || p.includes("dashboard") || p.includes("overview")) return "Getting Started";
-  return "Features";
-}
-function pathToFilename(path) {
-  return (path || "home").replace(/^\//, "").replace(/\//g, "-").replace(/[^a-zA-Z0-9-]/g, "") || "home";
-}
-
-// src/commands/screenshot.ts
 async function screenshotCommand(options) {
   console.log();
   console.log(chalk4.bold("\u{1F4F8} HelpShelf Screenshot"));
   console.log(chalk4.dim(`   Target: ${options.url}`));
   console.log();
   let snapshot = null;
-  const snapshotPath = resolve5(options.snapshot || ".helpshelf/snapshot.json");
-  if (existsSync12(snapshotPath)) {
-    snapshot = JSON.parse(readFileSync9(snapshotPath, "utf-8"));
+  const snapshotPath = resolve4(options.snapshot || ".helpshelf/snapshot.json");
+  if (existsSync11(snapshotPath)) {
+    snapshot = JSON.parse(readFileSync4(snapshotPath, "utf-8"));
     console.log(chalk4.dim(`   Using scan data: ${snapshot.apiRoutes.length} routes`));
     console.log();
   } else {
     console.log(chalk4.dim('   No snapshot found \u2014 run "helpshelf scan" first for better route coverage'));
     console.log();
   }
-  const outputDir = resolve5(options.output || ".helpshelf/screenshots");
-  mkdirSync3(outputDir, { recursive: true });
+  const outputDir = resolve4(options.output || ".helpshelf/screenshots");
+  mkdirSync4(outputDir, { recursive: true });
   const maxPages = parseInt(options.maxPages || "20", 10);
   const spinner = ora3("Launching browser...").start();
   try {
@@ -1596,14 +1466,14 @@ async function screenshotCommand(options) {
       navigation: result.navigation
     };
     writeFileSync4(
-      join12(outputDir, "manifest.json"),
+      join11(outputDir, "manifest.json"),
       JSON.stringify(manifest, null, 2)
     );
     console.log();
     console.log(chalk4.green.bold("\u2705 Screenshots captured!"));
     console.log();
     console.log(`   ${chalk4.dim("Output:")} ${outputDir}`);
-    console.log(`   ${chalk4.dim("Manifest:")} ${join12(outputDir, "manifest.json")}`);
+    console.log(`   ${chalk4.dim("Manifest:")} ${join11(outputDir, "manifest.json")}`);
     console.log();
     console.log(`   ${chalk4.dim("Pages:")}`);
     for (const page of result.pages) {
@@ -1622,7 +1492,7 @@ async function screenshotCommand(options) {
 // src/index.ts
 var program = new Command();
 program.name("helpshelf").description("AI-agent toolkit for auto-generating support docs").version("0.1.0");
-program.command("scan").description("Scan your codebase \u2192 snapshot.json + docs-template.json").option("-d, --dir <path>", "Project directory to scan", ".").option("-o, --output <path>", "Output file path", ".helpshelf/snapshot.json").option("--no-readme", "Skip README parsing").option("--no-deps", "Skip dependency analysis").option("--no-api", "Skip API route detection").option("--no-env", "Skip environment variable detection").option("--verbose", "Show detailed scan output").option("--quiet", "Suppress output (for programmatic use)").action(scanCommand);
+program.command("scan").description("Scan your codebase \u2192 snapshot.json + docs-template.json").option("-d, --dir <path>", "Project directory to scan", ".").option("-o, --output <path>", "Output file path", ".helpshelf/snapshot.json").option("--no-readme", "Skip README parsing").option("--no-deps", "Skip dependency analysis").option("--no-api", "Skip API route detection").option("--no-env", "Skip environment variable detection").option("--verbose", "Show detailed scan output").option("--quiet", "Suppress output (for programmatic use)").option("-u, --url <url>", "Also capture screenshots from a running app (e.g., http://localhost:3000)").option("-e, --email <email>", "Login email for screenshot auth").option("-p, --password <password>", "Login password for screenshot auth").option("-m, --max-pages <n>", "Max pages to screenshot", "20").action(scanCommand);
 program.command("screenshot").description("Capture screenshots of your running app's pages").requiredOption("-u, --url <url>", "URL of your running app (e.g., http://localhost:3000)").option("-e, --email <email>", "Login email for authenticated pages").option("-p, --password <password>", "Login password").option("-s, --snapshot <path>", "Path to scan snapshot (for route intelligence)", ".helpshelf/snapshot.json").option("-o, --output <path>", "Output directory for screenshots", ".helpshelf/screenshots").option("-m, --max-pages <n>", "Maximum pages to capture", "20").action(screenshotCommand);
 program.command("push").description("Push docs to HelpShelf (creates account if needed)").option("--email <email>", "HelpShelf account email").option("--domain <domain>", "Your app domain (for help center URL)").option("--docs-dir <path>", "Directory containing markdown docs", ".helpshelf/docs").option("--site <hash>", "Existing HelpShelf site hash").option("--api-key <key>", "Existing HelpShelf API key").option("--api-url <url>", "HelpShelf API URL", "https://app.helpshelf.com").option("--dry-run", "Preview what would be pushed without sending").action(pushCommand);
 program.command("init").description("Initialize HelpShelf in your project").action(initCommand);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "helpshelf",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Scan your codebase and auto-generate support docs for HelpShelf",
   "type": "module",
   "bin": {
@@ -10,7 +10,7 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsup src/index.ts --format esm --dts --clean --external playwright-core",
+    "build": "tsup src/index.ts --format esm --dts --clean --platform node --external playwright-core",
     "dev": "tsup src/index.ts --format esm --watch",
     "lint": "eslint src/",
     "type-check": "tsc --noEmit",
@@ -20,7 +20,7 @@
   "dependencies": {
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
-    "glob": "^11.0.0",
+    "glob": "10",
     "ignore": "^6.0.2",
     "ora": "^8.1.0",
     "playwright-core": "^1.58.1"