projscan 0.10.0 → 0.12.0

package/dist/core/monorepo.js

@@ -0,0 +1,270 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import fg from 'fast-glob';
+/**
+ * Detect monorepo workspaces. Covers the three setups that account for the
+ * vast majority of JS/TS monorepos: npm/yarn workspaces (package.json
+ * `workspaces`), pnpm (pnpm-workspace.yaml), and the Nx/Turbo/Lerna fallback
+ * (their files exist but they typically piggy-back on package.json
+ * workspaces or rely on a `packages/` convention).
+ *
+ * Returns kind 'none' for non-monorepos. Always includes the workspace root
+ * package itself if it has its own package.json with a name.
+ */
+export async function detectWorkspaces(rootPath) {
+    // Read root package.json (may not exist for Python-only repos).
+    const rootPkg = await readPackageJson(path.join(rootPath, 'package.json'));
+    // 1) pnpm has its own manifest. Prefer it when present.
+    const pnpmManifest = path.join(rootPath, 'pnpm-workspace.yaml');
+    if (await fileExists(pnpmManifest)) {
+        const patterns = await readPnpmPackages(pnpmManifest);
+        const packages = await collectPackages(rootPath, patterns, rootPkg);
+        return { kind: 'pnpm', packages, source: 'pnpm-workspace.yaml' };
+    }
+    // 2) npm / yarn workspaces in package.json.
+    if (rootPkg) {
+        const patterns = readNpmYarnPatterns(rootPkg);
+        if (patterns && patterns.length > 0) {
+            const packages = await collectPackages(rootPath, patterns, rootPkg);
+            // Distinguish yarn from npm if a yarn.lock is present - affects nothing
+            // about discovery, just labelling.
+            const kind = (await fileExists(path.join(rootPath, 'yarn.lock')))
+                ? 'yarn'
+                : 'npm';
+            return { kind, packages, source: 'package.json#workspaces' };
+        }
+    }
+    // 3) Lerna - its config has an explicit `packages` field with globs.
+    const lernaPath = path.join(rootPath, 'lerna.json');
+    if (await fileExists(lernaPath)) {
+        const patterns = (await readJsonField(lernaPath, 'packages')) ?? ['packages/*'];
+        const packages = await collectPackages(rootPath, patterns, rootPkg);
+        if (packages.length > 0) {
+            return { kind: 'lerna', packages, source: 'lerna.json#packages' };
+        }
+    }
+    // 4) Nx - workspaceLayout supplies appsDir/libsDir; project.json files
+    // anywhere identify packages. Older Nx variants used workspace.json (a
+    // single file enumerating projects); we read its `projects` map too.
+    const nxJsonPath = path.join(rootPath, 'nx.json');
+    if (await fileExists(nxJsonPath)) {
+        const nxPackages = await collectNxPackages(rootPath, nxJsonPath);
+        if (nxPackages.length > 0 || rootPkg) {
+            const merged = rootPkg ? [rootPackageOnly(rootPkg), ...nxPackages] : nxPackages;
+            merged.sort((a, b) => a.relativePath.localeCompare(b.relativePath));
+            return { kind: 'nx', packages: merged, source: 'nx.json + project.json scan' };
+        }
+    }
+    // 5) Turbo - turbo.json defines task pipelines, NOT workspace layout.
+    // Turbo always rides on top of npm/yarn/pnpm workspaces (handled above).
+    // If we get here with a turbo.json but no workspace declaration, treat it
+    // as a marker and fall back to the packages/* convention so we still
+    // surface something useful.
+    if (await fileExists(path.join(rootPath, 'turbo.json'))) {
+        const packages = await collectPackages(rootPath, ['packages/*', 'apps/*'], rootPkg);
+        if (packages.length > 0) {
+            return { kind: 'turbo', packages, source: 'turbo.json (fallback glob)' };
+        }
+    }
+    // Single-package repo (or non-JS).
+    return { kind: 'none', packages: rootPkg ? [rootPackageOnly(rootPkg)] : [] };
+}
+async function readPackageJson(absPath) {
+    try {
+        const raw = await fs.readFile(absPath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function readNpmYarnPatterns(pkg) {
+    if (!pkg.workspaces)
+        return null;
+    if (Array.isArray(pkg.workspaces))
+        return pkg.workspaces;
+    if (Array.isArray(pkg.workspaces.packages))
+        return pkg.workspaces.packages;
+    return null;
+}
+async function readPnpmPackages(manifestPath) {
+    // Tiny YAML subset reader: pnpm-workspace.yaml is just `packages:` followed
+    // by a YAML list. Avoiding a full YAML dep keeps the install size small.
+    let content;
+    try {
+        content = await fs.readFile(manifestPath, 'utf-8');
+    }
+    catch {
+        return [];
+    }
+    const patterns = [];
+    const lines = content.split('\n');
+    let inPackages = false;
+    for (const raw of lines) {
+        const line = raw.trimEnd();
+        if (line.startsWith('packages:')) {
+            inPackages = true;
+            continue;
+        }
+        if (inPackages) {
+            // List item: `  - 'pattern'` or `  - "pattern"` or `  - pattern`.
+            const m = /^\s*-\s*['"]?([^'"\n]+?)['"]?\s*$/.exec(line);
+            if (m) {
+                patterns.push(m[1]);
+            }
+            else if (line.length > 0 && !line.startsWith(' ') && !line.startsWith('\t')) {
+                // New top-level key - packages section ended.
+                inPackages = false;
+            }
+        }
+    }
+    return patterns;
+}
+async function collectPackages(rootPath, patterns, rootPkg) {
+    // Each pattern is typically `packages/*`. Resolve to package.json files.
+    const pkgManifests = patterns.map((p) => `${trimTrailingSlash(p)}/package.json`);
+    const matches = await fg(pkgManifests, {
+        cwd: rootPath,
+        onlyFiles: true,
+        ignore: ['**/node_modules/**'],
+    });
+    const packages = [];
+    for (const rel of matches) {
+        const abs = path.join(rootPath, rel);
+        const pkg = await readPackageJson(abs);
+        if (!pkg)
+            continue;
+        const dir = path.posix.dirname(rel.split(path.sep).join('/'));
+        packages.push({
+            name: pkg.name ?? path.posix.basename(dir),
+            relativePath: dir,
+            version: pkg.version,
+            isRoot: false,
+        });
+    }
+    if (rootPkg && rootPkg.name) {
+        packages.unshift(rootPackageOnly(rootPkg));
+    }
+    packages.sort((a, b) => a.relativePath.localeCompare(b.relativePath));
+    return packages;
+}
+function rootPackageOnly(rootPkg) {
+    return {
+        name: rootPkg.name ?? '<root>',
+        relativePath: '',
+        version: rootPkg.version,
+        isRoot: true,
+    };
+}
+function trimTrailingSlash(p) {
+    return p.endsWith('/') ? p.slice(0, -1) : p;
+}
+async function fileExists(absPath) {
+    try {
+        await fs.access(absPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Read a JSON file and return one named field (or undefined). Best-effort. */
+async function readJsonField(absPath, field) {
+    try {
+        const raw = await fs.readFile(absPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        const v = parsed[field];
+        return v;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Discover Nx workspace packages.
+ *
+ * Modern Nx (16+) puts a `project.json` next to every project. Older Nx
+ * (<= 15) maintains a single `workspace.json` listing them. We try both:
+ * scan for project.json files first (covers anything modern), then read
+ * workspace.json's `projects` map and treat its directories as packages.
+ *
+ * `nx.json#workspaceLayout` provides default `appsDir` / `libsDir` hints
+ * that we use to scope the project.json scan. When unspecified Nx defaults
+ * to "apps" and "libs"; we honor that.
+ */
+async function collectNxPackages(rootPath, nxJsonPath) {
+    const layout = (await readJsonField(nxJsonPath, 'workspaceLayout')) ?? {};
+    const appsDir = (layout.appsDir ?? 'apps').replace(/\/+$/, '');
+    const libsDir = (layout.libsDir ?? 'libs').replace(/\/+$/, '');
+    const found = new Map();
+    // 1) Scan for project.json files. Look in the layout dirs first, then in
+    // a wider `**/project.json` search bounded by reasonable globs.
+    const patterns = Array.from(new Set([
+        `${appsDir}/**/project.json`,
+        `${libsDir}/**/project.json`,
+        'packages/**/project.json',
+    ]));
+    const matches = await fg(patterns, {
+        cwd: rootPath,
+        onlyFiles: true,
+        ignore: ['**/node_modules/**'],
+        deep: 4,
+    });
+    for (const rel of matches) {
+        const projectJsonPath = path.join(rootPath, rel);
+        const name = (await readJsonField(projectJsonPath, 'name')) ?? path.posix.basename(path.posix.dirname(rel.split(path.sep).join('/')));
+        const dir = path.posix.dirname(rel.split(path.sep).join('/'));
+        if (!found.has(dir)) {
+            found.set(dir, { name, relativePath: dir, isRoot: false });
+        }
+    }
+    // 2) Older Nx: read workspace.json projects map.
+    const workspaceJsonPath = path.join(rootPath, 'workspace.json');
+    if (await fileExists(workspaceJsonPath)) {
+        const projects = (await readJsonField(workspaceJsonPath, 'projects')) ?? {};
+        for (const [name, val] of Object.entries(projects)) {
+            const root = typeof val === 'string' ? val : val.root;
+            if (!root)
+                continue;
+            const dir = root.replace(/\/+$/, '');
+            if (!found.has(dir)) {
+                found.set(dir, { name, relativePath: dir, isRoot: false });
+            }
+        }
+    }
+    return [...found.values()];
+}
+/**
+ * Given a file's project-relative path, return the workspace package whose
+ * `relativePath` is its longest matching prefix. Used to filter hotspots /
+ * coupling rows by --package.
+ */
+export function findPackageForFile(workspaces, filePath) {
+    let best = null;
+    for (const pkg of workspaces.packages) {
+        if (pkg.isRoot)
+            continue;
+        const prefix = pkg.relativePath ? pkg.relativePath + '/' : '';
+        if (filePath === pkg.relativePath || filePath.startsWith(prefix)) {
+            if (!best || pkg.relativePath.length > best.relativePath.length)
+                best = pkg;
+        }
+    }
+    // Fall back to root package if nothing more specific matched.
+    if (!best) {
+        const root = workspaces.packages.find((p) => p.isRoot);
+        return root ?? null;
+    }
+    return best;
+}
+/** Filter helper for callers passing --package <name>. */
+export function filterFilesByPackage(workspaces, packageName, files) {
+    const pkg = workspaces.packages.find((p) => p.name === packageName);
+    if (!pkg)
+        return [];
+    if (pkg.isRoot)
+        return files;
+    const prefix = pkg.relativePath + '/';
+    return files.filter((f) => f === pkg.relativePath || f.startsWith(prefix));
+}
+//# sourceMappingURL=monorepo.js.map

package/dist/core/monorepo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monorepo.js","sourceRoot":"","sources":["../../src/core/monorepo.ts"],"names":[],"mappings":"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"}

package/dist/core/outdatedDetector.d.ts

@@ -1,9 +1,20 @@
-import type { OutdatedReport } from '../types.js';
+import type { OutdatedReport, WorkspaceInfo } from '../types.js';
+export interface OutdatedOptions {
+    /** When provided, scan each workspace package's package.json individually. */
+    workspaces?: WorkspaceInfo;
+    /** When provided alongside workspaces, restrict to a single package by name. */
+    workspaceFilter?: string;
+}
 /**
  * Offline outdated check - compares the version declared in package.json
  * to the version installed under node_modules/<pkg>/package.json.
  *
+ * In a monorepo (caller supplies workspaces), each package's package.json is
+ * scanned. Each result entry carries the workspace it came from. Installed
+ * versions still resolve through the root node_modules (npm/yarn/pnpm hoisting
+ * makes that the right place to look in 95% of installs).
+ *
  * Does not hit the npm registry. `latest` is filled in only when a node_modules
  * install exists; the drift calculation uses installed vs declared.
  */
-export declare function detectOutdated(rootPath: string): Promise<OutdatedReport>;
+export declare function detectOutdated(rootPath: string, options?: OutdatedOptions): Promise<OutdatedReport>;

package/dist/core/outdatedDetector.js

@@ -5,10 +5,58 @@ import { drift as semverDrift } from '../utils/semver.js';
  * Offline outdated check - compares the version declared in package.json
  * to the version installed under node_modules/<pkg>/package.json.
  *
+ * In a monorepo (caller supplies workspaces), each package's package.json is
+ * scanned. Each result entry carries the workspace it came from. Installed
+ * versions still resolve through the root node_modules (npm/yarn/pnpm hoisting
+ * makes that the right place to look in 95% of installs).
+ *
  * Does not hit the npm registry. `latest` is filled in only when a node_modules
  * install exists; the drift calculation uses installed vs declared.
  */
-export async function detectOutdated(rootPath) {
+export async function detectOutdated(rootPath, options = {}) {
+    const ws = options.workspaces;
+    const isMonorepo = ws !== undefined && ws.kind !== 'none' && ws.packages.length > 1;
+    if (!isMonorepo) {
+        // Single-package path: read root package.json only.
+        return await scanSinglePackage(rootPath, undefined);
+    }
+    // Monorepo path: scan each package's manifest, attribute results.
+    const nodeModules = path.join(rootPath, 'node_modules');
+    const nodeModulesExists = await pathExists(nodeModules);
+    const allPackages = [];
+    const byWorkspace = [];
+    for (const wp of ws.packages) {
+        if (options.workspaceFilter && wp.name !== options.workspaceFilter)
+            continue;
+        const pkgDir = wp.relativePath ? path.join(rootPath, wp.relativePath) : rootPath;
+        const pkgManifest = path.join(pkgDir, 'package.json');
+        const pkgEntries = await readManifestEntries(pkgManifest);
+        const pkgResults = [];
+        for (const [name, declared, scope] of pkgEntries) {
+            let installed = null;
+            if (nodeModulesExists)
+                installed = await readInstalledVersion(nodeModules, name);
+            pkgResults.push({
+                name,
+                declared,
+                installed,
+                latest: installed,
+                drift: semverDrift(declared, installed),
+                scope,
+                workspace: wp.name,
+            });
+        }
+        allPackages.push(...pkgResults);
+        byWorkspace.push({ workspace: wp.name, relativePath: wp.relativePath, total: pkgResults.length });
+    }
+    return {
+        available: true,
+        totalPackages: allPackages.length,
+        packages: allPackages,
+        byWorkspace,
+    };
+}
+async function scanSinglePackage(rootPath, workspaceName) {
     const pkgPath = path.join(rootPath, 'package.json');
     let raw;
     try {
@@ -22,9 +70,9 @@ export async function detectOutdated(rootPath) {
             packages: [],
         };
     }
-    let pkg;
+    let pkgJson;
     try {
-        pkg = JSON.parse(raw);
+        pkgJson = JSON.parse(raw);
     }
     catch {
         return {
@@ -34,29 +82,25 @@ export async function detectOutdated(rootPath) {
             packages: [],
         };
     }
-    const dependencies = (pkg.dependencies ?? {});
-    const devDependencies = (pkg.devDependencies ?? {});
-    const entries = [
-        ...Object.entries(dependencies).map(([n, v]) => [n, v, 'dependency']),
-        ...Object.entries(devDependencies).map(([n, v]) => [n, v, 'devDependency']),
-    ];
+    const entries = manifestEntriesFromParsed(pkgJson);
     const nodeModules = path.join(rootPath, 'node_modules');
     const nodeModulesExists = await pathExists(nodeModules);
     const packages = [];
     for (const [name, declared, scope] of entries) {
         let installed = null;
-        if (nodeModulesExists) {
+        if (nodeModulesExists)
             installed = await readInstalledVersion(nodeModules, name);
-        }
-        const drift = semverDrift(declared, installed);
-        packages.push({
+        const entry = {
             name,
             declared,
             installed,
-            latest: installed, // without registry lookup, installed is the best we know
-            drift,
+            latest: installed,
+            drift: semverDrift(declared, installed),
             scope,
-        });
+        };
+        if (workspaceName)
+            entry.workspace = workspaceName;
+        packages.push(entry);
     }
     return {
         available: true,
@@ -64,6 +108,32 @@ export async function detectOutdated(rootPath) {
         packages,
     };
 }
+function manifestEntriesFromParsed(pkg) {
+    const dependencies = (pkg.dependencies ?? {});
+    const devDependencies = (pkg.devDependencies ?? {});
+    return [
+        ...Object.entries(dependencies).map(([n, v]) => [n, v, 'dependency']),
+        ...Object.entries(devDependencies).map(([n, v]) => [n, v, 'devDependency']),
+    ];
+}
+/** Read deps/devDeps from a package.json. Returns [] if file unreadable/invalid (used in monorepo iteration where one bad workspace shouldn't fail the whole scan). */
+async function readManifestEntries(pkgPath) {
+    let raw;
+    try {
+        raw = await fs.readFile(pkgPath, 'utf-8');
+    }
+    catch {
+        return [];
+    }
+    let pkg;
+    try {
+        pkg = JSON.parse(raw);
+    }
+    catch {
+        return [];
+    }
+    return manifestEntriesFromParsed(pkg);
+}
 async function pathExists(p) {
     try {
         await fs.access(p);

package/dist/core/outdatedDetector.js.map

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

package/dist/core/prDiff.d.ts

@@ -0,0 +1,43 @@
+import { type CodeGraph } from './codeGraph.js';
+import type { PrDiffReport } from '../types.js';
+export interface PrDiffOptions {
+    /** Base ref (branch, tag, sha). Default: origin/main, falling back to main. */
+    base?: string;
+    /** Head ref. Default: HEAD. */
+    head?: string;
+}
+/**
+ * Compute a structural diff between two refs by building a CodeGraph for each
+ * side and comparing exports / imports / call sites / cyclomatic complexity /
+ * fan-in.
+ *
+ * Strategy: stand up a throwaway git worktree at the base ref, scan it like
+ * any other project, build its graph, then diff against the head graph
+ * (caller passes head graph in or the function builds one from `rootPath`).
+ *
+ * This is "structural diff", not text diff: agents reviewing PRs care about
+ * "what's the new export surface" and "which call sites disappeared", not
+ * "what whitespace changed on line 42."
+ */
+export declare function computePrDiff(rootPath: string, options?: PrDiffOptions): Promise<PrDiffReport>;
+/** Pure function - exported for unit testing without a real git repo. */
+export declare function diffGraphs(baseRef: string, baseSha: string | null, headRef: string, headSha: string | null, baseGraph: CodeGraph, headGraph: CodeGraph): PrDiffReport;
+/**
+ * Pair removed/added export names that look like renames. A pair counts as a
+ * rename when it's the best-scoring match on both sides AND the similarity
+ * exceeds a threshold. Each name participates in at most one pair (greedy by
+ * descending score). Whatever isn't paired stays in the +/- lists.
+ *
+ * Similarity blends two signals (each in [0,1]): normalized Levenshtein
+ * distance and longest-common-affix fraction. Threshold of 0.6 chosen to
+ * pair "fooBar" → "fooBaz" and "Widget" → "WidgetThing" without pairing
+ * unrelated names like "save" → "load".
+ */
+import type { ExportRename } from '../types.js';
+interface RenameSplit {
+    renames: ExportRename[];
+    removedAfter: string[];
+    addedAfter: string[];
+}
+export declare function detectRenames(removed: string[], added: string[]): RenameSplit;
+export {};