release: cli v3.1.0

Author: barrymichaeldoyle

package.json

@@ -13,6 +13,7 @@
   "devDependencies": {
     "@changesets/cli": "^2.30.0",
     "@types/node": "25.6.0",
+    "esbuild": "0.28.0",
     "knip": "6.4.0",
     "oxfmt": "0.44.0",
     "oxlint": "1.59.0",

packages/cli/CHANGELOG.md

@@ -1,5 +1,17 @@
 # patch-pulse
 
+## 3.1.0
+
+### Minor Changes
+
+- Automatically respect `.gitignore` when scanning for `package.json` files. Directories listed in `.gitignore` (such as `dist/`, `build/`, `.next/`) are now skipped during workspace traversal, preventing false positives from build output.
+
+  A new `includePaths` config option lets you opt specific gitignored directories back into scanning when needed. `ignorePaths` continues to take priority over `includePaths`.
+
+  `patchpulse.json` is now a supported config filename and is the preferred format going forward. `patchpulse.config.json` and `.patchpulserc` variants remain supported.
+
+  Also updated the README example screenshot.
+
 ## 3.0.1
 
 ### Patch Changes

packages/cli/assets/example.png

@@ -0,0 +1,2 @@
+# build output
+dist/

packages/cli/e2e/with-gitignore/fixtures/.gitignore

@@ -0,0 +1,4 @@
+{
+  "name": "with-gitignore-root",
+  "private": true
+}

packages/cli/e2e/with-gitignore/fixtures/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "app",
+  "dependencies": {
+    "react": "^18.2.0"
+  }
+}

packages/cli/e2e/with-gitignore/fixtures/packages/app/package.json

@@ -1,6 +1,6 @@
 {
   "name": "patch-pulse",
-  "version": "3.0.1",
+  "version": "3.1.0",
   "description": "Check for outdated npm dependencies",
   "type": "module",
   "bin": {
@@ -46,7 +46,6 @@
     "test:ui": "vitest --ui"
   },
   "devDependencies": {
-    "@patch-pulse/shared": "workspace:*",
-    "esbuild": "0.25.6"
+    "@patch-pulse/shared": "workspace:*"
   }
 }

packages/cli/package.json

@@ -15,6 +15,7 @@ export const PACKAGE_MANAGERS: readonly PackageManager[] = [
  * The filenames of the configuration files that PatchPulse looks for.
  */
 export const CONFIG_FILENAMES: readonly string[] = [
+  'patchpulse.json',
   'patchpulse.config.json',
   '.patchpulserc.json',
   '.patchpulserc',

packages/cli/src/constant.ts

@@ -1,2 +1,2 @@
 // Auto-generated file - do not edit manually
-export const VERSION = '3.0.0';
+export const VERSION = '3.1.0';

packages/cli/src/gen/version.gen.ts

@@ -6,6 +6,7 @@ import { type PackageManager } from '../types';
 export interface PatchPulseConfig {
   skip?: string[];
   ignorePaths?: string[];
+  includePaths?: string[];
   packageManager?: PackageManager;
   noUpdatePrompt?: boolean;
 }
@@ -111,6 +112,7 @@ export function mergeConfigs(
   const merged: PatchPulseConfig = {
     skip: [],
     ignorePaths: [],
+    includePaths: [],
   };
 
   // Add file config values
@@ -122,6 +124,10 @@ export function mergeConfigs(
     merged.ignorePaths!.push(...fileConfig.ignorePaths);
   }
 
+  if (fileConfig?.includePaths) {
+    merged.includePaths!.push(...fileConfig.includePaths);
+  }
+
   // Add CLI config values (merge instead of override)
   if (cliConfig.skip) {
     merged.skip!.push(...cliConfig.skip);
@@ -131,9 +137,14 @@ export function mergeConfigs(
     merged.ignorePaths!.push(...cliConfig.ignorePaths);
   }
 
+  if (cliConfig.includePaths) {
+    merged.includePaths!.push(...cliConfig.includePaths);
+  }
+
   // Remove duplicates while preserving order
   merged.skip = [...new Set(merged.skip!)];
   merged.ignorePaths = [...new Set(merged.ignorePaths!)];
+  merged.includePaths = [...new Set(merged.includePaths!)];
 
   // Handle packageManager (CLI takes precedence)
   if (cliConfig.packageManager) {
@@ -172,6 +183,12 @@ function validateConfig(config: any): PatchPulseConfig {
     );
   }
 
+  if (config.includePaths && Array.isArray(config.includePaths)) {
+    validated.includePaths = config.includePaths.filter(
+      (item: any) => typeof item === 'string',
+    );
+  }
+
   if (typeof config.packageManager === 'string') {
     validated.packageManager = config.packageManager;
   }
@@ -237,6 +254,41 @@ export function shouldIgnorePath({
   });
 }
 
+/**
+ * Checks if a path is explicitly included via config, overriding gitignore.
+ * ignorePaths still takes priority over includePaths.
+ */
+export function shouldIncludePath({
+  path,
+  config = {},
+}: {
+  path: string;
+  config: PatchPulseConfig | undefined;
+}): boolean {
+  if (!config.includePaths || config.includePaths.length === 0) {
+    return false;
+  }
+
+  const normalizedPath = normalizeConfigPath(path);
+
+  return config.includePaths.some((pattern) => {
+    const normalizedPattern = normalizeConfigPath(pattern);
+
+    if (
+      !hasPatternSyntax(normalizedPattern) &&
+      (normalizedPath === normalizedPattern ||
+        normalizedPath.startsWith(`${normalizedPattern}/`))
+    ) {
+      return true;
+    }
+
+    return matchesPattern({
+      value: normalizedPath,
+      pattern: normalizedPattern,
+    });
+  });
+}
+
 function normalizeConfigPath(path: string): string {
   return path.replace(/\\/g, '/').replace(/^\.\//, '').replace(/\/+$/, '');
 }