@wrongstack/tools 0.287.0 → 0.291.0

package/dist/codebase-index/writer.d.ts

@@ -1,4 +1,4 @@
-import type { FileMeta, IndexStats, Ref, SearchResult, Symbol as IndexSymbol, SymbolKind, SymbolLang } from './schema.js';
+import type { FileMeta, IndexStats, Ref, SearchResult, Symbol as IndexSymbol, SymbolKind, SymbolLang, CodeMapGraph } from './schema.js';
 /**
  * Resolve the per-project index directory. By default it lives under the
  * global project dir (`~/.wrongstack/projects/<hash>/codebase-index`),
@@ -15,6 +15,39 @@ export declare function resolveIndexDir(projectRoot: string, override?: string):
 export declare function codebaseIndexDirOverride(ctx: {
     meta?: Record<string, unknown>;
 }): string | undefined;
+/**
+ * Warm-connection pool for IndexStore instances.
+ *
+ * Each (projectRoot, indexDir) pair gets one persisted IndexStore. Every read
+ * operation (search, stats, graph) acquires the store from the pool instead of
+ * opening a fresh SQLite connection, re-parsing the schema, and re-preparing
+ * statements. The connection stays warm between calls — only warm-up cost is
+ * paid once per project per process lifetime.
+ *
+ * In WAL mode, readers coexist with the writer connection, so a single pooled
+ * connection handles both reads and writes safely. The caller is responsible
+ * for serializing writes (the host's promise-chain mutex does this); the pool
+ * itself has no lock because the worker processes one message at a time.
+ */
+export declare class StorePool {
+    private readonly stores;
+    private key;
+    /** Borrow a store. Creates it on first access for this key. */
+    acquire(projectRoot: string, opts?: {
+        indexDir?: string | undefined;
+    }): IndexStore;
+    /** Return the store to the pool. The connection stays warm for subsequent
+     * operations on the same (projectRoot, indexDir). */
+    release(_store: IndexStore): void;
+    /** Close every pooled connection and drain the pool. Call on shutdown. */
+    closeAll(): void;
+    /** Remove one store from the pool. Used by tests that need isolation. */
+    evict(projectRoot: string, indexDir?: string): void;
+    /** True when the pool holds a connection for the given key. */
+    has(projectRoot: string, indexDir?: string): boolean;
+}
+/** Process-wide singleton pool. */
+export declare const indexStorePool: StorePool;
 export declare class IndexStore {
     private db;
     /** Absolute path to this project's index directory. */
@@ -115,6 +148,8 @@ export declare class IndexStore {
     getMaxSymbolId(): number;
     getStats(): IndexStats;
     setLastIndexed(ts: number): void;
+    getMetadata(key: string): string | undefined;
+    setMetadata(key: string, value: string): void;
     clearAll(): void;
     /**
      * Insert cross-references for a given source symbol id.
@@ -184,6 +219,30 @@ export declare class IndexStore {
      */
     findRefsFrom(symbolId: number): Ref[];
     private sizeBytes;
+    /**
+     * Derive a monorepo package name from an absolute file path.
+     * Handles both `packages/<name>/...` (workspace) and `src/<name>/...` layouts.
+     * Returns `undefined` for files outside any recognisable package structure.
+     */
+    private static derivePackage;
+    private static packageFromImport;
+    private static resolveRelativeImport;
+    /**
+     * Package-level graph: each workspace package is a node; edges are derived
+     * from cross-package symbol references (a symbol in package A references a
+     * symbol resolved in package B). Node metadata includes symbol/file counts.
+     */
+    getPackageGraph(): CodeMapGraph;
+    /**
+     * File-level graph for a single package: each file is a node; edges are
+     * derived from cross-file symbol references within the package.
+     */
+    getFileGraph(packageFilter: string): CodeMapGraph;
+    /**
+     * Symbol-level graph for a single file: each symbol is a node; edges are
+     * derived from intra-file and cross-file symbol references (who calls whom).
+     */
+    getSymbolGraph(fileFilter: string): CodeMapGraph;
     close(): void;
 }
 //# sourceMappingURL=writer.d.ts.map

package/dist/codebase-index/writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/codebase-index/writer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/codebase-index/writer.ts"],"names":[],"mappings":"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"}

package/dist/e2e.js

@@ -0,0 +1,477 @@
+// 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";
+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 assertRealInsideRoot(absPath, ctx) {
+  if (ctx.allowOutsideProjectRoot) return;
+  const realRoots = await Promise.all(
+    allowedRoots(ctx).map((r) => fsp.realpath(r).catch(() => path.resolve(r)))
+  );
+  let probe = absPath;
+  for (; ; ) {
+    let real;
+    try {
+      real = await fsp.realpath(probe);
+    } catch (err) {
+      if (err.code === "ENOENT") {
+        const parent = path.dirname(probe);
+        if (parent === probe) return;
+        probe = parent;
+        continue;
+      }
+      throw err;
+    }
+    if (isInsideAny(real, realRoots)) return;
+    throw new Error(
+      `Path "${absPath}" resolves through a symlink outside project root "${realRoots[0]}"`
+    );
+  }
+}
+async function safeResolveReal(input, ctx) {
+  const abs = safeResolve(input, ctx);
+  await assertRealInsideRoot(abs, ctx);
+  return abs;
+}
+
+// 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
+    });
+  }
+};
+export {
+  discoverE2EProjects,
+  e2ePlanTool
+};
+//# sourceMappingURL=e2e.js.map