@wrongstack/tools 0.313.0 → 0.313.1

package/dist/e2e.js

@@ -1,479 +1,8 @@
-// src/e2e.ts
-import { open, readdir } from "node:fs/promises";
-import * as path2 from "node:path";
-
-// src/_util.ts
-import * as fsp from "node:fs/promises";
-import * as path from "node:path";
-import * as Core from "@wrongstack/core/utils";
-function resolvePath(input, ctx) {
-  return path.isAbsolute(input) ? path.normalize(input) : path.resolve(ctx.workingDir ?? ctx.cwd, input);
-}
-function allowedRoots(ctx) {
-  return [path.resolve(ctx.projectRoot), path.resolve(Core.wstackGlobalRoot())];
-}
-function isInsideAny(target, roots) {
-  return roots.some((root) => {
-    const rel = path.relative(root, target);
-    return rel === "" || !rel.startsWith("..") && !path.isAbsolute(rel);
-  });
-}
-function ensureInsideRoot(absPath, ctx) {
-  const target = path.resolve(absPath);
-  if (ctx.allowOutsideProjectRoot) return target;
-  if (isInsideAny(target, allowedRoots(ctx))) return target;
-  throw new Error(`Path "${absPath}" is outside project root "${path.resolve(ctx.projectRoot)}"`);
-}
-function safeResolve(input, ctx) {
-  return ensureInsideRoot(resolvePath(input, ctx), ctx);
-}
-async function resolveRealInsideRoot(absPath, ctx) {
-  if (ctx.allowOutsideProjectRoot) return absPath;
-  const realRoots = await Promise.all(
-    allowedRoots(ctx).map((r) => fsp.realpath(r).catch(() => path.resolve(r)))
-  );
-  let probe = absPath;
-  const pendingTail = [];
-  for (; ; ) {
-    let real;
-    try {
-      real = await fsp.realpath(probe);
-    } catch (err) {
-      if (err.code === "ENOENT") {
-        const parent = path.dirname(probe);
-        if (parent === probe) return absPath;
-        pendingTail.unshift(path.basename(probe));
-        probe = parent;
-        continue;
-      }
-      throw err;
-    }
-    const candidate = pendingTail.length > 0 ? path.join(real, ...pendingTail) : real;
-    if (isInsideAny(candidate, realRoots)) {
-      return candidate;
-    }
-    throw new Error(
-      `Path "${absPath}" resolves through a symlink outside project root "${realRoots[0]}"`
-    );
-  }
-}
-async function safeResolveReal(input, ctx) {
-  const abs = safeResolve(input, ctx);
-  return await resolveRealInsideRoot(abs, ctx);
-}
-
-// src/e2e.ts
-async function readBoundedText(filePath, maxBytes) {
-  let handle;
-  try {
-    handle = await open(filePath, "r");
-    const info = await handle.stat();
-    if (!info.isFile() || info.size > maxBytes) return void 0;
-    const buffer = Buffer.alloc(info.size);
-    const { bytesRead } = await handle.read(buffer, 0, buffer.length, 0);
-    return buffer.subarray(0, bytesRead).toString("utf8");
-  } catch {
-    return void 0;
-  } finally {
-    await handle?.close().catch(() => void 0);
-  }
-}
-var CONFIG_NAMES = /* @__PURE__ */ new Map([
-  ["playwright.config.ts", "playwright"],
-  ["playwright.config.js", "playwright"],
-  ["playwright.config.mts", "playwright"],
-  ["playwright.config.mjs", "playwright"],
-  ["playwright.config.cts", "playwright"],
-  ["playwright.config.cjs", "playwright"],
-  ["cypress.config.ts", "cypress"],
-  ["cypress.config.js", "cypress"],
-  ["cypress.config.mts", "cypress"],
-  ["cypress.config.mjs", "cypress"],
-  ["cypress.config.cts", "cypress"],
-  ["cypress.config.cjs", "cypress"],
-  ["cypress.json", "cypress"]
-]);
-var SKIP_DIRECTORIES = /* @__PURE__ */ new Set([
-  ".git",
-  ".hg",
-  ".svn",
-  ".wrongstack",
-  "node_modules",
-  "dist",
-  "build",
-  "coverage",
-  "coverage-html",
-  "playwright-report",
-  "test-results",
-  ".next"
-]);
-var MAX_SCAN_DIRECTORIES = 4e3;
-var MAX_PACKAGE_BYTES = 512 * 1024;
-var MAX_CONFIG_BYTES = 512 * 1024;
-var MAX_SPEC_SAMPLES = 20;
-function relativePath(root, target) {
-  const value = path2.relative(root, target) || ".";
-  return value.split(path2.sep).join("/");
-}
-function escapeRegExp(value) {
-  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-function staticString(source, property) {
-  const key = escapeRegExp(property);
-  const direct = source.match(
-    new RegExp(`(?:['"]?${key}['"]?)\\s*:\\s*(['"\\x60])([^'"\\x60\\r\\n]*)\\1`)
-  );
-  if (direct?.[2] && !direct[2].includes("${")) return direct[2];
-  const sameLineFallback = source.match(
-    new RegExp(`(?:['"]?${key}['"]?)\\s*:[^\\r\\n]{0,300}?(['"\\x60])([^'"\\x60\\r\\n]*)\\1`)
-  );
-  return sameLineFallback?.[2] && !sameLineFallback[2].includes("${") ? sameLineFallback[2] : void 0;
-}
-function staticNumber(source, property) {
-  const key = escapeRegExp(property);
-  const match = source.match(new RegExp(`(?:['"]?${key}['"]?)\\s*:\\s*(\\d{2,5})\\b`));
-  return match?.[1] ? Number.parseInt(match[1], 10) : void 0;
-}
-function serverHints(framework, source) {
-  if (framework === "playwright" && /\bwebServer\s*:/.test(source)) {
-    const command = staticString(source, "command");
-    const url = staticString(source, "url");
-    const port = staticNumber(source, "port");
-    return [
-      {
-        kind: "managed",
-        ...command ? { command } : {},
-        ...url ? { url } : {},
-        ...port ? { port } : {},
-        source: "static-config",
-        incomplete: !command || !url && !port
-      }
-    ];
-  }
-  const baseUrl = staticString(source, "baseURL") ?? staticString(source, "baseUrl");
-  return baseUrl ? [{ kind: "attach", url: baseUrl, source: "static-config", incomplete: false }] : [];
-}
-function configuredSpecPattern(framework, source) {
-  if (framework === "playwright") {
-    const testDir = staticString(source, "testDir") ?? "./tests";
-    return `${testDir.replace(/\/$/, "")}/**/*.{spec,test}.{js,jsx,ts,tsx,mjs,cjs}`;
-  }
-  return staticString(source, "specPattern") ?? "cypress/{e2e,integration}/**/*.cy.{js,jsx,ts,tsx,mjs,cjs}";
-}
-async function scanWorkspace(root, maxDepth, signal) {
-  const result = {
-    configs: [],
-    packageFiles: [],
-    scannedDirectories: 0,
-    truncated: false
-  };
-  const queue = [{ directory: root, depth: 0 }];
-  while (queue.length > 0) {
-    signal.throwIfAborted();
-    const current = queue.shift();
-    if (!current) break;
-    result.scannedDirectories += 1;
-    if (result.scannedDirectories > MAX_SCAN_DIRECTORIES) {
-      result.truncated = true;
-      break;
-    }
-    let entries;
-    try {
-      entries = await readdir(current.directory, { withFileTypes: true });
-    } catch {
-      continue;
-    }
-    for (const entry of entries) {
-      signal.throwIfAborted();
-      const absolutePath = path2.join(current.directory, entry.name);
-      if (entry.isFile()) {
-        if (entry.name === "package.json") result.packageFiles.push(absolutePath);
-        const framework = CONFIG_NAMES.get(entry.name);
-        if (framework) result.configs.push({ framework, absolutePath });
-      } else if (entry.isDirectory() && current.depth < maxDepth && !SKIP_DIRECTORIES.has(entry.name) && !entry.name.startsWith("coverage-") && !entry.name.startsWith("cov-")) {
-        queue.push({ directory: absolutePath, depth: current.depth + 1 });
-      }
-    }
-  }
-  return result;
-}
-async function readPackageInfo(packagePath) {
-  try {
-    const raw = await readBoundedText(packagePath, MAX_PACKAGE_BYTES);
-    if (raw === void 0) return void 0;
-    const parsed = JSON.parse(raw);
-    const scripts = parsed.scripts && typeof parsed.scripts === "object" ? Object.fromEntries(
-      Object.entries(parsed.scripts).filter(
-        (entry) => typeof entry[1] === "string"
-      )
-    ) : {};
-    const dependencies = /* @__PURE__ */ new Set();
-    for (const field of ["dependencies", "devDependencies", "optionalDependencies"]) {
-      const value = parsed[field];
-      if (!value || typeof value !== "object") continue;
-      for (const name of Object.keys(value)) dependencies.add(name);
-    }
-    const declared = typeof parsed.packageManager === "string" ? parsed.packageManager.split("@")[0] ?? "" : "";
-    const packageManager = ["pnpm", "npm", "yarn", "bun"].includes(declared) ? declared : void 0;
-    return { path: packagePath, scripts, dependencies, packageManager };
-  } catch {
-    return void 0;
-  }
-}
-function frameworkFromPackage(info) {
-  const found = /* @__PURE__ */ new Set();
-  if (info.dependencies.has("@playwright/test") || info.dependencies.has("playwright")) {
-    found.add("playwright");
-  }
-  if (info.dependencies.has("cypress")) found.add("cypress");
-  for (const command of Object.values(info.scripts)) {
-    if (/\bplaywright(?:\.cmd)?\b/i.test(command)) found.add("playwright");
-    if (/\bcypress(?:\.cmd)?\b/i.test(command)) found.add("cypress");
-  }
-  return [...found];
-}
-async function detectPackageManager(projectRoot, scanRoot, declared) {
-  if (declared) return declared;
-  let directory = projectRoot;
-  while (true) {
-    const names = /* @__PURE__ */ new Set();
-    try {
-      for (const entry of await readdir(directory)) names.add(entry);
-    } catch {
-    }
-    if (names.has("pnpm-lock.yaml")) return "pnpm";
-    if (names.has("yarn.lock")) return "yarn";
-    if (names.has("bun.lock") || names.has("bun.lockb")) return "bun";
-    if (names.has("package-lock.json") || names.has("npm-shrinkwrap.json")) return "npm";
-    if (directory === scanRoot) break;
-    const parent = path2.dirname(directory);
-    const relativeParent = path2.relative(scanRoot, parent);
-    if (parent === directory || relativeParent.startsWith("..") || path2.isAbsolute(relativeParent)) {
-      break;
-    }
-    directory = parent;
-  }
-  return "npm";
-}
-function matchingScripts(info, framework) {
-  if (!info) return [];
-  const matcher = framework === "playwright" ? /\bplaywright(?:\.cmd)?\b/i : /\bcypress(?:\.cmd)?\b/i;
-  return Object.entries(info.scripts).filter(([, command]) => matcher.test(command)).map(([name]) => name).sort((a, b) => {
-    const preferred = ["test:e2e", "e2e", "e2e:test"];
-    const ai = preferred.indexOf(a);
-    const bi = preferred.indexOf(b);
-    if (ai !== -1 || bi !== -1) return (ai === -1 ? 99 : ai) - (bi === -1 ? 99 : bi);
-    return a.localeCompare(b);
-  });
-}
-function executionPlan(framework, manager, root, configPath, scripts) {
-  const script = scripts[0];
-  if (script) {
-    return {
-      command: manager,
-      args: ["run", script],
-      cwd: root,
-      source: "package-script",
-      script
-    };
-  }
-  const runnerArgs = framework === "playwright" ? ["playwright", "test"] : ["cypress", "run"];
-  if (configPath) {
-    runnerArgs.push(framework === "playwright" ? "--config" : "--config-file", configPath);
-  }
-  return {
-    command: manager === "bun" ? "bunx" : manager,
-    args: manager === "bun" ? runnerArgs : manager === "npm" ? ["exec", "--", ...runnerArgs] : ["exec", ...runnerArgs],
-    cwd: root,
-    source: "framework-default"
-  };
-}
-function isSpec(framework, filename) {
-  if (framework === "cypress") return /\.cy\.(?:[cm]?[jt]sx?)$/i.test(filename);
-  return /\.(?:spec|test)\.(?:[cm]?[jt]sx?)$/i.test(filename);
-}
-async function collectSpecs(root, framework, testDirectory, signal) {
-  const roots = testDirectory ? [path2.resolve(root, testDirectory)] : framework === "cypress" ? [path2.join(root, "cypress", "e2e"), path2.join(root, "cypress", "integration")] : [path2.join(root, "tests")];
-  const samples = [];
-  let count = 0;
-  let scanned = 0;
-  const queue = [...roots];
-  while (queue.length > 0) {
-    signal.throwIfAborted();
-    const directory = queue.shift();
-    if (!directory) break;
-    scanned += 1;
-    if (scanned > MAX_SCAN_DIRECTORIES) return { count, samples, truncated: true };
-    let entries;
-    try {
-      entries = await readdir(directory, { withFileTypes: true });
-    } catch {
-      continue;
-    }
-    for (const entry of entries) {
-      signal.throwIfAborted();
-      const target = path2.join(directory, entry.name);
-      if (entry.isDirectory() && !SKIP_DIRECTORIES.has(entry.name)) queue.push(target);
-      else if (entry.isFile() && isSpec(framework, entry.name)) {
-        count += 1;
-        if (samples.length < MAX_SPEC_SAMPLES) samples.push(relativePath(root, target));
-      }
-    }
-  }
-  return { count, samples, truncated: count > samples.length };
-}
-async function readConfig(configPath) {
-  if (!configPath) return "";
-  return await readBoundedText(configPath, MAX_CONFIG_BYTES) ?? "";
-}
-function nearestPackage(projectRoot, packagesByDirectory, scanRoot) {
-  let directory = projectRoot;
-  while (true) {
-    const found = packagesByDirectory.get(directory);
-    if (found) return found;
-    if (directory === scanRoot) return void 0;
-    const parent = path2.dirname(directory);
-    if (parent === directory || relativePath(scanRoot, parent).startsWith("..")) return void 0;
-    directory = parent;
-  }
-}
-async function discoverE2EProjects(root, options) {
-  const maxDepth = Math.max(0, Math.min(options.maxDepth ?? 5, 8));
-  const scan = await scanWorkspace(root, maxDepth, options.signal);
-  const packages = (await Promise.all(scan.packageFiles.map(readPackageInfo))).filter(
-    (info) => Boolean(info)
-  );
-  const packagesByDirectory = new Map(packages.map((info) => [path2.dirname(info.path), info]));
-  const candidates = /* @__PURE__ */ new Map();
-  for (const config of scan.configs) {
-    if (options.framework && options.framework !== "all" && config.framework !== options.framework) {
-      continue;
-    }
-    const projectRoot = path2.dirname(config.absolutePath);
-    candidates.set(`${config.framework}:${projectRoot}`, {
-      framework: config.framework,
-      root: projectRoot,
-      configPath: config.absolutePath
-    });
-  }
-  for (const info of packages) {
-    const projectRoot = path2.dirname(info.path);
-    for (const framework of frameworkFromPackage(info)) {
-      if (options.framework && options.framework !== "all" && framework !== options.framework)
-        continue;
-      const key = `${framework}:${projectRoot}`;
-      if (!candidates.has(key)) candidates.set(key, { framework, root: projectRoot });
-    }
-  }
-  const projects = [];
-  for (const candidate of candidates.values()) {
-    options.signal.throwIfAborted();
-    const info = nearestPackage(candidate.root, packagesByDirectory, root);
-    const source = await readConfig(candidate.configPath);
-    const scripts = matchingScripts(info, candidate.framework);
-    const manager = await detectPackageManager(candidate.root, root, info?.packageManager);
-    const testDirectory = candidate.framework === "playwright" ? staticString(source, "testDir") : void 0;
-    const resolvedTestDirectory = testDirectory ? path2.resolve(candidate.root, testDirectory) : void 0;
-    const relativeTestDirectory = resolvedTestDirectory ? path2.relative(root, resolvedTestDirectory) : void 0;
-    const unsafeTestDirectory = Boolean(
-      relativeTestDirectory && (relativeTestDirectory.startsWith("..") || path2.isAbsolute(relativeTestDirectory))
-    );
-    const specs = options.includeSpecs === false || unsafeTestDirectory ? { count: 0, samples: [], truncated: false } : await collectSpecs(candidate.root, candidate.framework, testDirectory, options.signal);
-    const warnings = [];
-    if (!candidate.configPath)
-      warnings.push("Framework dependency or script found without a config file.");
-    if (candidate.configPath && !source) {
-      warnings.push("Config could not be read or exceeded the static inspection limit.");
-    }
-    if (unsafeTestDirectory) {
-      warnings.push(
-        "Configured testDir resolves outside the requested discovery root and was not scanned."
-      );
-    }
-    const hints = serverHints(candidate.framework, source);
-    if (hints.some((hint) => hint.incomplete)) {
-      warnings.push("Configured server contains dynamic values; only static hints are shown.");
-    }
-    projects.push({
-      framework: candidate.framework,
-      root: relativePath(root, candidate.root),
-      ...candidate.configPath ? { configPath: relativePath(root, candidate.configPath) } : {},
-      ...info ? { packagePath: relativePath(root, info.path) } : {},
-      packageManager: manager,
-      evidence: [
-        ...candidate.configPath ? [`config:${relativePath(root, candidate.configPath)}`] : [],
-        ...info?.dependencies.has(
-          candidate.framework === "playwright" ? "@playwright/test" : "cypress"
-        ) ? [`dependency:${candidate.framework === "playwright" ? "@playwright/test" : "cypress"}`] : [],
-        ...scripts.map((script) => `script:${script}`)
-      ],
-      scripts,
-      serverHints: hints,
-      specPattern: configuredSpecPattern(candidate.framework, source),
-      specCount: specs.count,
-      specSamples: specs.samples,
-      specsTruncated: specs.truncated,
-      execution: executionPlan(
-        candidate.framework,
-        manager,
-        relativePath(root, candidate.root),
-        candidate.configPath ? relativePath(candidate.root, candidate.configPath) : void 0,
-        scripts
-      ),
-      warnings
-    });
-  }
-  projects.sort((a, b) => a.root.localeCompare(b.root) || a.framework.localeCompare(b.framework));
-  return {
-    root,
-    projects,
-    scannedDirectories: scan.scannedDirectories,
-    scanTruncated: scan.truncated,
-    warnings: scan.truncated ? [`Discovery stopped after ${MAX_SCAN_DIRECTORIES} directories; narrow cwd or maxDepth.`] : []
-  };
-}
-var e2ePlanTool = {
-  name: "e2e_plan",
-  category: "Code Quality",
-  description: "Discover Playwright and Cypress projects and preview bounded E2E execution plans without loading configs or starting processes.",
-  usageHint: "Use before running browser E2E tests. The result identifies authoritative configs, package scripts, static server hints, specs, and exact argv. This tool never imports project config or executes commands.",
-  permission: "auto",
-  mutating: false,
-  riskTier: "safe",
-  capabilities: ["fs.read"],
-  icon: "test",
-  timeoutMs: 3e4,
-  inputSchema: {
-    type: "object",
-    properties: {
-      cwd: { type: "string", description: "Directory inside the project to inspect." },
-      framework: {
-        type: "string",
-        enum: ["all", "playwright", "cypress"],
-        description: "Optional framework filter; defaults to all."
-      },
-      maxDepth: {
-        type: "integer",
-        minimum: 0,
-        maximum: 8,
-        description: "Maximum workspace discovery depth; defaults to 5."
-      },
-      includeSpecs: {
-        type: "boolean",
-        description: "Count and sample specs; defaults to true."
-      }
-    }
-  },
-  async execute(input, ctx, opts) {
-    const root = await safeResolveReal(input.cwd ?? ".", ctx);
-    return discoverE2EProjects(root, {
-      framework: input.framework,
-      maxDepth: input.maxDepth,
-      includeSpecs: input.includeSpecs,
-      signal: opts.signal
-    });
-  }
-};
+import {
+  discoverE2EProjects,
+  e2ePlanTool
+} from "./chunk-JRJJX3L5.js";
+import "./chunk-D33S4RQG.js";
 export {
   discoverE2EProjects,
   e2ePlanTool