@nitpicker/core 0.24.0 → 0.25.1

package/lib/validate-search-pattern.d.ts

@@ -0,0 +1,25 @@
+import type { NativeSearchPattern } from './types.js';
+/**
+ * Compiles a `query search-html` pattern and reports whether it matches the
+ * empty string.
+ *
+ * The pattern is a literal, or a regular expression in the syntax of Rust's
+ * `regex` crate: backreferences and look-around are not supported, and
+ * matching runs in time linear in the document. The addon keeps the last
+ * compiled pattern, so a search that follows with the same pattern does not
+ * compile it again; this is for refusing a pattern before the archive is
+ * opened.
+ * @param pattern - The pattern and its flags.
+ * @returns Whether the pattern matches the empty string, which `search-html` rejects
+ *   because it would match at every position of every snapshot.
+ * @throws {Error} With code `InvalidArg` and the regex engine's message if the
+ *   pattern is not valid, uses an unsupported construct, or compiles to more than
+ *   the engine's size limit.
+ * @example
+ * ```ts
+ * validateSearchPattern({ source: 'a+', literal: false, ignoreCase: false, multiLine: false, dotAll: false }); // false
+ * validateSearchPattern({ source: 'a*', literal: false, ignoreCase: false, multiLine: false, dotAll: false }); // true
+ * validateSearchPattern({ source: '(?=a)a', literal: false, ignoreCase: false, multiLine: false, dotAll: false }); // throws
+ * ```
+ */
+export declare function validateSearchPattern(pattern: NativeSearchPattern): boolean;

package/lib/validate-search-pattern.js

@@ -0,0 +1,27 @@
+import { nativeBinding } from './native-binding.js';
+/**
+ * Compiles a `query search-html` pattern and reports whether it matches the
+ * empty string.
+ *
+ * The pattern is a literal, or a regular expression in the syntax of Rust's
+ * `regex` crate: backreferences and look-around are not supported, and
+ * matching runs in time linear in the document. The addon keeps the last
+ * compiled pattern, so a search that follows with the same pattern does not
+ * compile it again; this is for refusing a pattern before the archive is
+ * opened.
+ * @param pattern - The pattern and its flags.
+ * @returns Whether the pattern matches the empty string, which `search-html` rejects
+ *   because it would match at every position of every snapshot.
+ * @throws {Error} With code `InvalidArg` and the regex engine's message if the
+ *   pattern is not valid, uses an unsupported construct, or compiles to more than
+ *   the engine's size limit.
+ * @example
+ * ```ts
+ * validateSearchPattern({ source: 'a+', literal: false, ignoreCase: false, multiLine: false, dotAll: false }); // false
+ * validateSearchPattern({ source: 'a*', literal: false, ignoreCase: false, multiLine: false, dotAll: false }); // true
+ * validateSearchPattern({ source: '(?=a)a', literal: false, ignoreCase: false, multiLine: false, dotAll: false }); // throws
+ * ```
+ */
+export function validateSearchPattern(pattern) {
+    return nativeBinding.validateSearchPattern(pattern);
+}

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@nitpicker/core",
-	"version": "0.24.0",
-	"description": "Plugin-based page analysis engine for Nitpicker",
+	"version": "0.25.1",
+	"description": "Native (Rust, Node-API) compute core for Nitpicker",
 	"author": "D-ZERO",
 	"license": "Apache-2.0",
 	"engines": {
@@ -20,23 +20,90 @@
 	],
 	"type": "module",
 	"exports": {
-		".": {
-			"import": "./lib/core.js",
-			"types": "./lib/core.d.ts"
+		"./check-native-executor-config": {
+			"import": "./lib/check-native-executor-config.js",
+			"types": "./lib/check-native-executor-config.d.ts"
+		},
+		"./compute-alias-keys": {
+			"import": "./lib/compute-alias-keys.js",
+			"types": "./lib/compute-alias-keys.d.ts"
+		},
+		"./compute-body-hash": {
+			"import": "./lib/compute-body-hash.js",
+			"types": "./lib/compute-body-hash.d.ts"
+		},
+		"./compute-url-sort-ranks": {
+			"import": "./lib/compute-url-sort-ranks.js",
+			"types": "./lib/compute-url-sort-ranks.d.ts"
+		},
+		"./create-isolated-cluster-run": {
+			"import": "./lib/create-isolated-cluster-run.js",
+			"types": "./lib/create-isolated-cluster-run.d.ts"
+		},
+		"./create-template-classification-run": {
+			"import": "./lib/create-template-classification-run.js",
+			"types": "./lib/create-template-classification-run.d.ts"
+		},
+		"./group-alias-candidates": {
+			"import": "./lib/group-alias-candidates.js",
+			"types": "./lib/group-alias-candidates.d.ts"
+		},
+		"./match-js-license-comment-signal": {
+			"import": "./lib/match-js-license-comment-signal.js",
+			"types": "./lib/match-js-license-comment-signal.d.ts"
+		},
+		"./match-selector-html": {
+			"import": "./lib/match-selector-html.js",
+			"types": "./lib/match-selector-html.d.ts"
+		},
+		"./match-selector-snapshots": {
+			"import": "./lib/match-selector-snapshots.js",
+			"types": "./lib/match-selector-snapshots.d.ts"
+		},
+		"./match-structural-technology-signals": {
+			"import": "./lib/match-structural-technology-signals.js",
+			"types": "./lib/match-structural-technology-signals.d.ts"
+		},
+		"./max-decoded-snapshot-bytes": {
+			"import": "./lib/max-decoded-snapshot-bytes.js",
+			"types": "./lib/max-decoded-snapshot-bytes.d.ts"
+		},
+		"./search-html-document": {
+			"import": "./lib/search-html-document.js",
+			"types": "./lib/search-html-document.d.ts"
+		},
+		"./search-html-snapshots": {
+			"import": "./lib/search-html-snapshots.js",
+			"types": "./lib/search-html-snapshots.d.ts"
+		},
+		"./validate-search-pattern": {
+			"import": "./lib/validate-search-pattern.js",
+			"types": "./lib/validate-search-pattern.d.ts"
+		},
+		"./template-exact-page-limit": {
+			"import": "./lib/template-exact-page-limit.js",
+			"types": "./lib/template-exact-page-limit.d.ts"
+		},
+		"./template-memory-budget": {
+			"import": "./lib/template-memory-budget.js",
+			"types": "./lib/template-memory-budget.d.ts"
+		},
+		"./template-block-sample-size": {
+			"import": "./lib/template-block-sample-size.js",
+			"types": "./lib/template-block-sample-size.d.ts"
+		},
+		"./types": {
+			"import": "./lib/types.js",
+			"types": "./lib/types.d.ts"
 		}
 	},
 	"scripts": {
-		"build": "tsc",
-		"clean": "tsc --build --clean"
+		"build": "node scripts/build-native.mjs && tsc",
+		"clean": "node scripts/build-native.mjs --clean && tsc --build --clean"
 	},
-	"dependencies": {
-		"@d-zero/dealer": "1.14.0",
-		"@d-zero/shared": "0.23.0",
-		"@nitpicker/crawler": "0.24.0",
-		"@nitpicker/types": "0.24.0",
-		"ansi-colors": "4.1.3",
-		"cosmiconfig": "10.0.1",
-		"jsdom": "30.0.1"
+	"optionalDependencies": {
+		"@nitpicker/core-darwin-arm64": "0.25.1",
+		"@nitpicker/core-linux-x64-gnu": "0.25.1"
 	},
-	"gitHead": "840a594573c4abe0aaff1257469b7f2108fcdb19"
+	"gitHead": "fa839178ea8f40e92fc742e0480c6cfbbb8fb01f"
 }

package/lib/core.d.ts

@@ -1,4 +0,0 @@
-export { Nitpicker } from './nitpicker.js';
-export { definePlugin } from './hooks/define-plugin.js';
-export { readPluginLabels } from './read-plugin-labels.js';
-export * from './types.js';

package/lib/core.js

@@ -1,4 +0,0 @@
-export { Nitpicker } from './nitpicker.js';
-export { definePlugin } from './hooks/define-plugin.js';
-export { readPluginLabels } from './read-plugin-labels.js';
-export * from './types.js';

package/lib/discover-analyze-plugins.d.ts

@@ -1,14 +0,0 @@
-import type { Plugin } from './types.js';
-/**
- * Returns the standard set of `@nitpicker/analyze-*` plugins
- * as {@link Plugin} entries with default (empty) settings.
- *
- * This is used as a fallback when no configuration file is found,
- * allowing `nitpicker analyze` to work out of the box without
- * requiring a `.nitpickerrc` file.
- *
- * All analyze plugins are treated as standard packages bundled
- * with the CLI, so no filesystem scanning is necessary.
- * @returns Array of standard analyze plugins with empty settings.
- */
-export declare function discoverAnalyzePlugins(): Plugin[];

package/lib/discover-analyze-plugins.js

@@ -1,32 +0,0 @@
-/**
- * Standard analyze plugin module names bundled with the Nitpicker CLI.
- *
- * These are treated as built-in plugins and always available without
- * explicit configuration.
- */
-const STANDARD_ANALYZE_PLUGINS = [
-    '@nitpicker/analyze-axe',
-    '@nitpicker/analyze-markuplint',
-    '@nitpicker/analyze-search',
-    '@nitpicker/analyze-textlint',
-];
-/**
- * Returns the standard set of `@nitpicker/analyze-*` plugins
- * as {@link Plugin} entries with default (empty) settings.
- *
- * This is used as a fallback when no configuration file is found,
- * allowing `nitpicker analyze` to work out of the box without
- * requiring a `.nitpickerrc` file.
- *
- * All analyze plugins are treated as standard packages bundled
- * with the CLI, so no filesystem scanning is necessary.
- * @returns Array of standard analyze plugins with empty settings.
- */
-export function discoverAnalyzePlugins() {
-    return STANDARD_ANALYZE_PLUGINS.map((moduleName) => ({
-        name: moduleName,
-        module: moduleName,
-        configFilePath: '',
-        settings: {},
-    }));
-}

package/lib/get-table-cache-root.d.ts

@@ -1,18 +0,0 @@
-/**
- * Resolve the storage location for the analyze command's scratch `table`
- * cache (per-page axe results, cleared at the start of every `analyze` run).
- *
- * Defined as a child of {@link getArchiveCacheRoot} so that
- * `NITPICKER_TAR_CACHE_DIR` — which already redirects the tar-extraction
- * cache — consistently redirects this cache too, instead of the two caches
- * silently splitting across different roots.
- * @returns Absolute path to the `table` cache directory. The `Cache` class
- *   creates a further subdirectory under this path named after its `name`
- *   argument.
- * @example
- * ```ts
- * const cache = new Cache('nitpicker-axe', getTableCacheRoot());
- * await cache.clear();
- * ```
- */
-export declare function getTableCacheRoot(): string;

package/lib/get-table-cache-root.js

@@ -1,22 +0,0 @@
-import path from 'node:path';
-import { getArchiveCacheRoot } from '@nitpicker/crawler';
-/**
- * Resolve the storage location for the analyze command's scratch `table`
- * cache (per-page axe results, cleared at the start of every `analyze` run).
- *
- * Defined as a child of {@link getArchiveCacheRoot} so that
- * `NITPICKER_TAR_CACHE_DIR` — which already redirects the tar-extraction
- * cache — consistently redirects this cache too, instead of the two caches
- * silently splitting across different roots.
- * @returns Absolute path to the `table` cache directory. The `Cache` class
- *   creates a further subdirectory under this path named after its `name`
- *   argument.
- * @example
- * ```ts
- * const cache = new Cache('nitpicker-axe', getTableCacheRoot());
- * await cache.clear();
- * ```
- */
-export function getTableCacheRoot() {
-    return path.join(getArchiveCacheRoot(), 'table');
-}

package/lib/hooks/define-plugin.d.ts

@@ -1,68 +0,0 @@
-import type { PluginFactory } from '../types.js';
-/**
- * Identity function that provides full type inference for analyze plugin definitions.
- *
- * This function does **nothing at runtime** - it returns its argument unchanged.
- * Its sole purpose is to give TypeScript enough context to infer the generic
- * parameters `O` (options type) and `T` (column key union) from the plugin
- * implementation, without requiring explicit type annotations at the call site.
- *
- * ## Why an identity function?
- *
- * Without this wrapper, plugin authors would need to manually annotate the
- * `PluginFactory` type with both generic parameters:
- *
- * ```ts
- * // Without definePlugin - verbose and error-prone
- * const factory: PluginFactory<{ lang: string }, 'score' | 'details'> = (options) => { ... };
- * export default factory;
- * ```
- *
- * With `definePlugin`, TypeScript infers everything from the function body:
- *
- * ```ts
- * // With definePlugin - concise and type-safe
- * export default definePlugin(async (options: { lang: string }) => {
- *   return {
- *     label: 'Custom Analysis',
- *     headers: { score: 'Score', details: 'Details' },
- *     async eachPage({ window }) {
- *       return { page: { score: { value: 100 }, details: { value: 'OK' } } };
- *     },
- *   };
- * });
- * ```
- *
- * This pattern is sometimes called a "satisfies helper" or "builder pattern"
- * and is common in TypeScript libraries that need generic inference from
- * function arguments (cf. Zod's `z.object()`, tRPC's `router()`).
- * @template O - Shape of the plugin's settings/options from the config file.
- * @template T - String literal union of column keys contributed by this plugin.
- * @param factory - The plugin factory function to pass through.
- * @returns The same function, unchanged.
- * @example
- * ```ts
- * import { definePlugin } from '@nitpicker/core';
- *
- * type Options = { keywords: string[] };
- *
- * export default definePlugin(async (options: Options) => {
- *   return {
- *     label: 'キーワード検索',
- *     headers: { found: 'Keywords Found', count: 'Match Count' },
- *     async eachPage({ html }) {
- *       const matches = options.keywords.filter(k => html.includes(k));
- *       return {
- *         page: {
- *           found: { value: matches.join(', ') },
- *           count: { value: matches.length },
- *         },
- *       };
- *     },
- *   };
- * });
- * ```
- * @see {@link ../types.ts!PluginFactory} for the function signature being wrapped
- * @see {@link ../types.ts!AnalyzePlugin} for the returned plugin interface
- */
-export declare function definePlugin<O, T extends string = string>(factory: PluginFactory<O, T>): PluginFactory<O, T>;

package/lib/hooks/define-plugin.js

@@ -1,69 +0,0 @@
-/**
- * Identity function that provides full type inference for analyze plugin definitions.
- *
- * This function does **nothing at runtime** - it returns its argument unchanged.
- * Its sole purpose is to give TypeScript enough context to infer the generic
- * parameters `O` (options type) and `T` (column key union) from the plugin
- * implementation, without requiring explicit type annotations at the call site.
- *
- * ## Why an identity function?
- *
- * Without this wrapper, plugin authors would need to manually annotate the
- * `PluginFactory` type with both generic parameters:
- *
- * ```ts
- * // Without definePlugin - verbose and error-prone
- * const factory: PluginFactory<{ lang: string }, 'score' | 'details'> = (options) => { ... };
- * export default factory;
- * ```
- *
- * With `definePlugin`, TypeScript infers everything from the function body:
- *
- * ```ts
- * // With definePlugin - concise and type-safe
- * export default definePlugin(async (options: { lang: string }) => {
- *   return {
- *     label: 'Custom Analysis',
- *     headers: { score: 'Score', details: 'Details' },
- *     async eachPage({ window }) {
- *       return { page: { score: { value: 100 }, details: { value: 'OK' } } };
- *     },
- *   };
- * });
- * ```
- *
- * This pattern is sometimes called a "satisfies helper" or "builder pattern"
- * and is common in TypeScript libraries that need generic inference from
- * function arguments (cf. Zod's `z.object()`, tRPC's `router()`).
- * @template O - Shape of the plugin's settings/options from the config file.
- * @template T - String literal union of column keys contributed by this plugin.
- * @param factory - The plugin factory function to pass through.
- * @returns The same function, unchanged.
- * @example
- * ```ts
- * import { definePlugin } from '@nitpicker/core';
- *
- * type Options = { keywords: string[] };
- *
- * export default definePlugin(async (options: Options) => {
- *   return {
- *     label: 'キーワード検索',
- *     headers: { found: 'Keywords Found', count: 'Match Count' },
- *     async eachPage({ html }) {
- *       const matches = options.keywords.filter(k => html.includes(k));
- *       return {
- *         page: {
- *           found: { value: matches.join(', ') },
- *           count: { value: matches.length },
- *         },
- *       };
- *     },
- *   };
- * });
- * ```
- * @see {@link ../types.ts!PluginFactory} for the function signature being wrapped
- * @see {@link ../types.ts!AnalyzePlugin} for the returned plugin interface
- */
-export function definePlugin(factory) {
-    return factory;
-}

package/lib/import-modules.d.ts

@@ -1,24 +0,0 @@
-import type { AnalyzePlugin, Plugin } from './types.js';
-/**
- * Dynamically imports and initializes all analyze plugin modules.
- *
- * For each plugin in the list:
- * 1. Validates that `plugin.module` starts with `@nitpicker/analyze-`
- * 2. Calls `import(plugin.module)` to load the npm package
- * 3. Invokes the module's default export (a `PluginFactory` factory)
- *    with the plugin's `settings`
- * 4. Returns the resulting `AnalyzePlugin` instance
- *
- * All plugins are loaded in parallel via `Promise.all` for performance.
- *
- * This function is called both in the main thread (for `headers` and `eachUrl`)
- * and inside each Worker thread (for `eachPage`). The Worker-side call is
- * necessary because plugin modules may not be transferable across threads.
- * @param plugins - Array of plugin definitions from the resolved config.
- * @returns Array of initialized `AnalyzePlugin` instances, in the same order.
- * @throws {Error} If any plugin module name does not start with `@nitpicker/analyze-`.
- * @see {@link ./types.ts} for the `PluginFactory` factory function signature
- * @see {@link ./page-analysis-worker.ts} for Worker-side usage
- * @see {@link ./nitpicker.ts!Nitpicker.analyze} for main-thread usage
- */
-export declare function importModules(plugins: Plugin[]): Promise<AnalyzePlugin<string>[]>;

package/lib/import-modules.js

@@ -1,38 +0,0 @@
-/**
- * Allowed prefix for analyze plugin module names.
- * Only modules starting with this prefix are permitted to be dynamically imported.
- */
-const ALLOWED_PREFIX = '@nitpicker/analyze-';
-/**
- * Dynamically imports and initializes all analyze plugin modules.
- *
- * For each plugin in the list:
- * 1. Validates that `plugin.module` starts with `@nitpicker/analyze-`
- * 2. Calls `import(plugin.module)` to load the npm package
- * 3. Invokes the module's default export (a `PluginFactory` factory)
- *    with the plugin's `settings`
- * 4. Returns the resulting `AnalyzePlugin` instance
- *
- * All plugins are loaded in parallel via `Promise.all` for performance.
- *
- * This function is called both in the main thread (for `headers` and `eachUrl`)
- * and inside each Worker thread (for `eachPage`). The Worker-side call is
- * necessary because plugin modules may not be transferable across threads.
- * @param plugins - Array of plugin definitions from the resolved config.
- * @returns Array of initialized `AnalyzePlugin` instances, in the same order.
- * @throws {Error} If any plugin module name does not start with `@nitpicker/analyze-`.
- * @see {@link ./types.ts} for the `PluginFactory` factory function signature
- * @see {@link ./page-analysis-worker.ts} for Worker-side usage
- * @see {@link ./nitpicker.ts!Nitpicker.analyze} for main-thread usage
- */
-export async function importModules(plugins) {
-    const analyzeMods = await Promise.all(plugins.map(async (plugin) => {
-        if (!plugin.module.startsWith(ALLOWED_PREFIX)) {
-            throw new Error(`Unauthorized plugin module: "${plugin.module}". Plugin modules must start with "${ALLOWED_PREFIX}".`);
-        }
-        const mod = await import(plugin.module);
-        const factory = mod.default;
-        return factory(plugin.settings);
-    }));
-    return analyzeMods;
-}

package/lib/load-plugin-settings.d.ts

@@ -1,44 +0,0 @@
-import type { Config, PluginOverrides } from './types.js';
-/**
- * Loads the analyze plugin configuration from the user's config file.
- *
- * Uses cosmiconfig to search the filesystem from `process.cwd()` upward
- * for a Nitpicker configuration file. The external config format
- * (`ConfigJSON` from `@nitpicker/types`) is normalized into the internal
- * {@link Config} model:
- *
- * - `config.plugins.analyze` (object keyed by module name with settings)
- *   is converted to an ordered `Plugin[]` array
- * - Boolean `true` settings are normalized to empty objects `{}`
- * - The config file path is attached to each plugin for relative path resolution
- * @param defaultConfig - Optional partial config to merge as defaults.
- *   Plugin lists are concatenated (defaults first, then discovered plugins).
- * @param pluginOverrides - CLI-specified plugin setting overrides.
- *   Values are shallow-merged into the matching plugin's settings,
- *   with CLI values taking precedence over config-file values.
- * @returns Fully resolved {@link Config} with the `analyze` plugin list.
- * @example
- * ```ts
- * // .nitpickerrc.json
- * // {
- * //   "plugins": {
- * //     "analyze": {
- * //       "@nitpicker/analyze-axe": { "lang": "ja" },
- * //       "@nitpicker/analyze-markuplint": true
- * //     }
- * //   }
- * // }
- *
- * const config = await loadPluginSettings();
- * // config.analyze = [
- * //   { name: '@nitpicker/analyze-axe', module: '@nitpicker/analyze-axe',
- * //     configFilePath: '/path/to/.nitpickerrc.json', settings: { lang: 'ja' } },
- * //   { name: '@nitpicker/analyze-markuplint', module: '@nitpicker/analyze-markuplint',
- * //     configFilePath: '/path/to/.nitpickerrc.json', settings: {} },
- * // ]
- * ```
- * @see {@link ./types.ts!Config} for the output type
- * @see {@link ./types.ts!Plugin} for individual plugin entries
- * @see {@link ./types.ts!PluginOverrides} for CLI override support
- */
-export declare function loadPluginSettings(defaultConfig?: Partial<Config>, pluginOverrides?: PluginOverrides): Promise<Config>;

package/lib/load-plugin-settings.js

@@ -1,125 +0,0 @@
-import { cosmiconfig } from 'cosmiconfig';
-import { discoverAnalyzePlugins } from './discover-analyze-plugins.js';
-/**
- * The cosmiconfig module name used for config file discovery.
- * Searches for: `.nitpickerrc`, `.nitpickerrc.json`, `.nitpickerrc.yaml`,
- * `nitpicker.config.js`, `nitpicker.config.cjs`, or a `"nitpicker"` key
- * in `package.json`.
- */
-const MODULE_NAME = 'nitpicker';
-/**
- * Loads the analyze plugin configuration from the user's config file.
- *
- * Uses cosmiconfig to search the filesystem from `process.cwd()` upward
- * for a Nitpicker configuration file. The external config format
- * (`ConfigJSON` from `@nitpicker/types`) is normalized into the internal
- * {@link Config} model:
- *
- * - `config.plugins.analyze` (object keyed by module name with settings)
- *   is converted to an ordered `Plugin[]` array
- * - Boolean `true` settings are normalized to empty objects `{}`
- * - The config file path is attached to each plugin for relative path resolution
- * @param defaultConfig - Optional partial config to merge as defaults.
- *   Plugin lists are concatenated (defaults first, then discovered plugins).
- * @param pluginOverrides - CLI-specified plugin setting overrides.
- *   Values are shallow-merged into the matching plugin's settings,
- *   with CLI values taking precedence over config-file values.
- * @returns Fully resolved {@link Config} with the `analyze` plugin list.
- * @example
- * ```ts
- * // .nitpickerrc.json
- * // {
- * //   "plugins": {
- * //     "analyze": {
- * //       "@nitpicker/analyze-axe": { "lang": "ja" },
- * //       "@nitpicker/analyze-markuplint": true
- * //     }
- * //   }
- * // }
- *
- * const config = await loadPluginSettings();
- * // config.analyze = [
- * //   { name: '@nitpicker/analyze-axe', module: '@nitpicker/analyze-axe',
- * //     configFilePath: '/path/to/.nitpickerrc.json', settings: { lang: 'ja' } },
- * //   { name: '@nitpicker/analyze-markuplint', module: '@nitpicker/analyze-markuplint',
- * //     configFilePath: '/path/to/.nitpickerrc.json', settings: {} },
- * // ]
- * ```
- * @see {@link ./types.ts!Config} for the output type
- * @see {@link ./types.ts!Plugin} for individual plugin entries
- * @see {@link ./types.ts!PluginOverrides} for CLI override support
- */
-export async function loadPluginSettings(defaultConfig = {}, pluginOverrides = {}) {
-    const explorer = cosmiconfig(MODULE_NAME);
-    const result = await explorer.search();
-    if (!result) {
-        const defaultPlugins = defaultConfig.analyze || [];
-        const plugins = defaultPlugins.length > 0 ? defaultPlugins : discoverAnalyzePlugins();
-        return {
-            analyze: applyPluginOverrides(plugins, pluginOverrides),
-        };
-    }
-    const config = result.config;
-    const { isEmpty, filepath } = result;
-    if (!config || isEmpty) {
-        const defaultPlugins = defaultConfig.analyze || [];
-        const plugins = defaultPlugins.length > 0 ? defaultPlugins : discoverAnalyzePlugins();
-        return {
-            analyze: applyPluginOverrides(plugins, pluginOverrides),
-        };
-    }
-    const analyzePlugins = [];
-    if (config.plugins && config.plugins.analyze) {
-        const moduleNames = Object.keys(config.plugins.analyze);
-        for (const name of moduleNames) {
-            if (!config.plugins.analyze[name]) {
-                continue;
-            }
-            const settings = config.plugins.analyze[name] === true ? {} : config.plugins.analyze[name];
-            analyzePlugins.push({
-                name,
-                module: name,
-                configFilePath: filepath,
-                settings,
-            });
-        }
-    }
-    const mergedPlugins = [...(defaultConfig.analyze || []), ...analyzePlugins];
-    const finalPlugins = mergedPlugins.length > 0 ? mergedPlugins : discoverAnalyzePlugins();
-    return {
-        analyze: applyPluginOverrides(finalPlugins, pluginOverrides),
-    };
-}
-/**
- * Applies CLI-specified overrides to plugin settings.
- *
- * For each plugin in the list, if there is a matching entry in
- * `overrides`, the override values are shallow-merged into the
- * plugin's existing settings. CLI values take precedence over
- * config-file values.
- *
- * **Limitation**: Merging is shallow (one level). Nested objects in
- * the override will replace the entire config-file value, not deep-merge.
- * @param plugins - The plugin list to apply overrides to.
- * @param overrides - CLI-specified plugin setting overrides.
- * @returns A new plugin array with overrides applied.
- */
-function applyPluginOverrides(plugins, overrides) {
-    const overrideKeys = Object.keys(overrides);
-    if (overrideKeys.length === 0) {
-        return plugins;
-    }
-    return plugins.map((plugin) => {
-        const override = overrides[plugin.module];
-        if (!override) {
-            return plugin;
-        }
-        return {
-            ...plugin,
-            settings: {
-                ...plugin.settings,
-                ...override,
-            },
-        };
-    });
-}