@a16njs/engine 0.5.0 → 0.6.1

package/dist/index.d.ts

@@ -1,4 +1,6 @@
-import type { A16nPlugin, AgentCustomization, DiscoveryResult, Warning, WrittenFile, CustomizationType } from '@a16njs/models';
+import type { A16nPlugin, AgentCustomization, DiscoveryResult, Warning, WrittenFile, CustomizationType, Workspace } from '@a16njs/models';
+import { type PluginDiscoveryOptions } from './plugin-discovery.js';
+import { type ContentTransformation } from './transformation.js';
 /**
  * Options for a conversion operation.
  */
@@ -7,25 +9,25 @@ export interface ConversionOptions {
     source: string;
     /** Target plugin ID */
     target: string;
-    /** Project root directory (used as default for both source and target) */
+    /** Project root directory */
     root: string;
     /** If true, only discover without writing */
     dryRun?: boolean;
-    /**
-     * Override root directory for discovery (reading).
-     * When set, discover() uses this instead of `root`.
-     */
+    /** Override root for discovery (source plugin) */
     sourceRoot?: string;
-    /**
-     * Override root directory for emission (writing).
-     * When set, emit() uses this instead of `root`.
-     */
+    /** Override root for emission (target plugin) */
     targetRoot?: string;
+    /** Workspace for source discovery (takes precedence over sourceRoot/root) */
+    sourceWorkspace?: Workspace;
+    /** Workspace for target emission (takes precedence over targetRoot/root) */
+    targetWorkspace?: Workspace;
     /**
-     * If true, rewrite file path references in content so they point
-     * to the target-format paths instead of source-format paths.
+     * If true, rewrite path references in content during conversion.
+     * @deprecated Use `transformations: [new PathRewritingTransformation()]` instead.
      */
     rewritePathRefs?: boolean;
+    /** Content transformations to apply between discovery and emission */
+    transformations?: ContentTransformation[];
 }
 /**
  * Git-ignore change information.
@@ -62,22 +64,44 @@ export interface PluginInfo {
     supports: CustomizationType[];
     source: 'bundled' | 'installed';
 }
+/**
+ * Result of discovering and registering plugins.
+ */
+export interface DiscoverAndRegisterResult {
+    /** Plugin IDs that were successfully registered */
+    registered: string[];
+    /** Plugin IDs that were skipped (already registered) */
+    skipped: string[];
+    /** Errors encountered during discovery */
+    errors: Array<{
+        packageName: string;
+        error: string;
+    }>;
+}
 /**
  * The a16n conversion engine.
  * Orchestrates plugins to discover and emit agent customizations.
  */
 export declare class A16nEngine {
-    private plugins;
+    private registry;
+    private loader;
     /**
      * Create a new engine with the given plugins.
-     * @param plugins - Plugins to register
+     * @param plugins - Plugins to register (registered as 'bundled')
      */
     constructor(plugins?: A16nPlugin[]);
     /**
      * Register a plugin with the engine.
      * @param plugin - The plugin to register
+     * @param source - Whether the plugin is bundled or installed
+     */
+    registerPlugin(plugin: A16nPlugin, source?: 'bundled' | 'installed'): void;
+    /**
+     * Discover and register installed plugins from node_modules.
+     * @param options - Plugin discovery options
+     * @returns Result with registered, skipped, and error info
      */
-    registerPlugin(plugin: A16nPlugin): void;
+    discoverAndRegisterPlugins(options?: PluginDiscoveryOptions): Promise<DiscoverAndRegisterResult>;
     /**
      * List all registered plugins.
      * @returns Array of plugin info
@@ -92,10 +116,10 @@ export declare class A16nEngine {
     /**
      * Discover customizations using a specific plugin.
      * @param pluginId - The plugin to use for discovery
-     * @param root - The project root to scan
+     * @param rootOrWorkspace - The project root path or Workspace to scan
      * @returns Discovery result with items and warnings
      */
-    discover(pluginId: string, root: string): Promise<DiscoveryResult>;
+    discover(pluginId: string, rootOrWorkspace: string | Workspace): Promise<DiscoveryResult>;
     /**
      * Convert customizations from one format to another.
      * @param options - Conversion options

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,OAAO,EACP,WAAW,EACX,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AAsBxB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC;IACnC,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,8BAA8B;IAC9B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,2CAA2C;IAC3C,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,mDAAmD;IACnD,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC;CACjC;AAED;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAsC;IAErD;;;OAGG;gBACS,OAAO,GAAE,UAAU,EAAO;IAMtC;;;OAGG;IACH,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAIxC;;;OAGG;IACH,WAAW,IAAI,UAAU,EAAE;IAS3B;;;;OAIG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI7C;;;;;OAKG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAQxE;;;;OAIG;IACG,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAmFrE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,54 +1,61 @@
-import { buildMapping, rewriteContent, detectOrphans } from './path-rewriter.js';
-/**
- * Well-known directory prefixes and file extensions for each plugin.
- * Used by detectOrphans() to identify source-format path references.
- */
-const PLUGIN_PATH_PATTERNS = {
-    cursor: {
-        prefixes: ['.cursor/rules/', '.cursor/skills/', '.cursor/commands/'],
-        extensions: ['.mdc', '.md'],
-    },
-    claude: {
-        prefixes: ['.claude/rules/', '.claude/skills/'],
-        extensions: ['.md'],
-    },
-    a16n: {
-        prefixes: ['.a16n/'],
-        extensions: ['.md', '.json'],
-    },
-};
+import { PluginRegistry } from './plugin-registry.js';
+import { PluginLoader, PluginConflictStrategy } from './plugin-loader.js';
+import { LocalWorkspace } from './workspace.js';
+import { PathRewritingTransformation, } from './transformation.js';
 /**
  * The a16n conversion engine.
  * Orchestrates plugins to discover and emit agent customizations.
  */
 export class A16nEngine {
-    plugins = new Map();
+    registry = new PluginRegistry();
+    loader;
     /**
      * Create a new engine with the given plugins.
-     * @param plugins - Plugins to register
+     * @param plugins - Plugins to register (registered as 'bundled')
      */
     constructor(plugins = []) {
+        this.loader = new PluginLoader(PluginConflictStrategy.PREFER_BUNDLED);
         for (const plugin of plugins) {
-            this.registerPlugin(plugin);
+            this.registerPlugin(plugin, 'bundled');
         }
     }
     /**
      * Register a plugin with the engine.
      * @param plugin - The plugin to register
+     * @param source - Whether the plugin is bundled or installed
+     */
+    registerPlugin(plugin, source = 'bundled') {
+        this.registry.register({ plugin, source });
+    }
+    /**
+     * Discover and register installed plugins from node_modules.
+     * @param options - Plugin discovery options
+     * @returns Result with registered, skipped, and error info
      */
-    registerPlugin(plugin) {
-        this.plugins.set(plugin.id, plugin);
+    async discoverAndRegisterPlugins(options) {
+        const candidates = await this.loader.loadInstalled(options);
+        const resolved = this.loader.resolveConflicts(this.registry, candidates);
+        const registered = [];
+        for (const reg of resolved.loaded) {
+            this.registry.register(reg);
+            registered.push(reg.plugin.id);
+        }
+        return {
+            registered,
+            skipped: resolved.skipped.map((s) => s.plugin.id),
+            errors: resolved.errors,
+        };
     }
     /**
      * List all registered plugins.
      * @returns Array of plugin info
      */
     listPlugins() {
-        return Array.from(this.plugins.values()).map((p) => ({
-            id: p.id,
-            name: p.name,
-            supports: p.supports,
-            source: 'bundled',
+        return this.registry.list().map((r) => ({
+            id: r.plugin.id,
+            name: r.plugin.name,
+            supports: r.plugin.supports,
+            source: r.source,
         }));
     }
     /**
@@ -57,20 +64,23 @@ export class A16nEngine {
      * @returns The plugin or undefined if not found
      */
     getPlugin(id) {
-        return this.plugins.get(id);
+        return this.registry.getPlugin(id);
     }
     /**
      * Discover customizations using a specific plugin.
      * @param pluginId - The plugin to use for discovery
-     * @param root - The project root to scan
+     * @param rootOrWorkspace - The project root path or Workspace to scan
      * @returns Discovery result with items and warnings
      */
-    async discover(pluginId, root) {
+    async discover(pluginId, rootOrWorkspace) {
         const plugin = this.getPlugin(pluginId);
         if (!plugin) {
             throw new Error(`Unknown plugin: ${pluginId}`);
         }
-        return plugin.discover(root);
+        const workspace = typeof rootOrWorkspace === 'string'
+            ? new LocalWorkspace('discover', rootOrWorkspace)
+            : rootOrWorkspace;
+        return plugin.discover(workspace);
     }
     /**
      * Convert customizations from one format to another.
@@ -86,55 +96,52 @@ export class A16nEngine {
         if (!targetPlugin) {
             throw new Error(`Unknown target: ${options.target}`);
         }
-        // Resolve split roots: sourceRoot for discover, targetRoot for emit
-        const effectiveSourceRoot = options.sourceRoot ?? options.root;
-        const effectiveTargetRoot = options.targetRoot ?? options.root;
-        // Discover from source
-        const discovery = await sourcePlugin.discover(effectiveSourceRoot);
-        const allWarnings = [...discovery.warnings];
-        if (options.rewritePathRefs && discovery.items.length > 0) {
-            // Two-pass emit approach:
-            // Pass 1: Dry-run emit to get target paths for building the mapping
-            const dryEmission = await targetPlugin.emit(discovery.items, effectiveTargetRoot, {
-                dryRun: true,
-            });
-            allWarnings.push(...dryEmission.warnings);
-            // Build source→target path mapping from the dry-run results
-            const mapping = buildMapping(discovery.items, dryEmission.written, effectiveSourceRoot, effectiveTargetRoot);
-            // Rewrite content in discovered items
-            const rewriteResult = rewriteContent(discovery.items, mapping);
-            // Detect orphan references
-            const sourcePatterns = PLUGIN_PATH_PATTERNS[options.source];
-            if (sourcePatterns) {
-                const orphanWarnings = detectOrphans(rewriteResult.items, mapping, sourcePatterns.prefixes, sourcePatterns.extensions);
-                allWarnings.push(...orphanWarnings);
-            }
-            // Pass 2: Real emit with rewritten items
-            const emission = await targetPlugin.emit(rewriteResult.items, effectiveTargetRoot, {
-                dryRun: options.dryRun,
-            });
-            // Deduplicate: add only emission warnings not already present from dry-run
-            const existingMessages = new Set(allWarnings.map((w) => w.message));
-            for (const w of emission.warnings) {
-                if (!existingMessages.has(w.message)) {
-                    allWarnings.push(w);
-                }
+        // Resolve source and target roots/workspaces
+        // Priority: explicit workspace > explicit root override > default root
+        const discoverRoot = options.sourceRoot ?? options.root;
+        const emitRoot = options.targetRoot ?? options.root;
+        const sourceWorkspace = options.sourceWorkspace
+            ?? new LocalWorkspace('source', discoverRoot);
+        const targetWorkspace = options.targetWorkspace
+            ?? new LocalWorkspace('target', emitRoot);
+        // Discover from source using workspace
+        const discovery = await sourcePlugin.discover(sourceWorkspace);
+        // Collect warnings
+        const warnings = [...discovery.warnings];
+        // Build transformations list
+        const transformations = options.transformations
+            ? [...options.transformations]
+            : [];
+        // Backward compatibility: rewritePathRefs maps to PathRewritingTransformation
+        if (options.rewritePathRefs && !transformations.some((t) => t.id === 'path-rewriting')) {
+            transformations.push(new PathRewritingTransformation());
+        }
+        // Apply transformation pipeline
+        let itemsToEmit = discovery.items;
+        if (transformations.length > 0) {
+            for (const transformation of transformations) {
+                const transformContext = {
+                    items: itemsToEmit,
+                    sourcePlugin,
+                    targetPlugin,
+                    sourceRoot: sourceWorkspace.root,
+                    targetRoot: targetWorkspace.root,
+                    trialEmit: (items) => targetPlugin.emit(items, targetWorkspace, { dryRun: true }),
+                };
+                const result = await transformation.transform(transformContext);
+                itemsToEmit = result.items;
+                warnings.push(...result.warnings);
             }
-            return {
-                discovered: discovery.items,
-                written: emission.written,
-                warnings: allWarnings,
-                unsupported: emission.unsupported,
-            };
         }
-        // Standard single-pass emit (no rewriting)
-        const emission = await targetPlugin.emit(discovery.items, effectiveTargetRoot, {
+        // Single emission at the end using workspace
+        const emission = await targetPlugin.emit(itemsToEmit, targetWorkspace, {
             dryRun: options.dryRun,
         });
+        warnings.push(...emission.warnings);
         return {
             discovered: discovery.items,
             written: emission.written,
-            warnings: [...allWarnings, ...emission.warnings],
+            warnings,
             unsupported: emission.unsupported,
         };
     }

package/dist/index.js.map

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

package/dist/plugin-discovery.d.ts

@@ -0,0 +1,78 @@
+import type { A16nPlugin } from '@a16njs/models';
+/**
+ * Options for controlling where plugin discovery searches.
+ */
+export interface PluginDiscoveryOptions {
+    /** Custom search paths to scan for plugins. If omitted, uses getDefaultSearchPaths(). */
+    searchPaths?: string[];
+}
+/**
+ * Result of a plugin discovery scan.
+ */
+export interface PluginDiscoveryResult {
+    /** Successfully loaded and validated plugins. */
+    plugins: A16nPlugin[];
+    /** Packages that were found but failed to load or validate. */
+    errors: PluginLoadError[];
+}
+/**
+ * Describes a plugin package that was found but could not be loaded.
+ */
+export interface PluginLoadError {
+    /** The npm package name (e.g. "a16n-plugin-foo"). */
+    packageName: string;
+    /** Human-readable description of what went wrong. */
+    error: string;
+}
+/**
+ * Scan search paths for installed `a16n-plugin-*` packages, dynamically import
+ * each one, validate its default export, and return the valid plugins along
+ * with error info for any that failed.
+ *
+ * @param options - Optional search path overrides
+ * @returns Discovered plugins and any load errors
+ */
+export declare function discoverInstalledPlugins(options?: PluginDiscoveryOptions): Promise<PluginDiscoveryResult>;
+/**
+ * Type-guard that checks whether an unknown value satisfies the A16nPlugin interface.
+ *
+ * Validates presence and types of: id (string), name (string), supports (array),
+ * discover (function), emit (function).
+ *
+ * @param obj - The value to check
+ * @returns True if obj is a valid A16nPlugin
+ */
+export declare function isValidPlugin(obj: unknown): obj is A16nPlugin;
+/**
+ * Compute the default search paths for plugin discovery.
+ *
+ * Returns paths where `a16n-plugin-*` packages might be installed:
+ * - The global npm `node_modules` directory (derived from this package's location)
+ * - The local `node_modules` in the current working directory
+ *
+ * In a global install, the engine lives inside node_modules:
+ *   .../lib/node_modules/@a16njs/engine/dist/plugin-discovery.js
+ * so walking up finds the node_modules parent directly.
+ *
+ * In a monorepo (e.g. pnpm workspace), the engine lives at:
+ *   <root>/packages/engine/dist/plugin-discovery.js
+ * so we also check for a node_modules child directory at each level.
+ *
+ * @returns Array of directory paths to scan
+ */
+export declare function getDefaultSearchPaths(): string[];
+/**
+ * Derive the global `node_modules` directory from `process.argv[1]`.
+ *
+ * When a CLI binary is installed globally (including via `npm link`),
+ * `process.argv[1]` points to `PREFIX/bin/<cmd>`. From that we can derive
+ * `PREFIX/lib/node_modules` (Unix) or `PREFIX/node_modules` (Windows).
+ *
+ * This handles the case where the engine is symlinked from a monorepo
+ * and `import.meta.url` resolves to the real path rather than the global
+ * `node_modules` tree.
+ *
+ * @returns The global node_modules path, or null if it cannot be determined
+ */
+export declare function getGlobalNodeModulesFromArgv1(): string | null;
+//# sourceMappingURL=plugin-discovery.d.ts.map

package/dist/plugin-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-discovery.d.ts","sourceRoot":"","sources":["../src/plugin-discovery.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,yFAAyF;IACzF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,iDAAiD;IACjD,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,+DAA+D;IAC/D,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;CACf;AAKD;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,qBAAqB,CAAC,CAyDhC;AAwBD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,UAAU,CAY7D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAuChD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,6BAA6B,IAAI,MAAM,GAAG,IAAI,CAsB7D"}

package/dist/plugin-discovery.js

@@ -0,0 +1,203 @@
+import * as fs from 'fs/promises';
+import { statSync } from 'fs';
+import * as path from 'path';
+import { pathToFileURL, fileURLToPath } from 'url';
+/** Pattern used to match plugin package directory names. */
+const PLUGIN_PREFIX = 'a16n-plugin-';
+/**
+ * Scan search paths for installed `a16n-plugin-*` packages, dynamically import
+ * each one, validate its default export, and return the valid plugins along
+ * with error info for any that failed.
+ *
+ * @param options - Optional search path overrides
+ * @returns Discovered plugins and any load errors
+ */
+export async function discoverInstalledPlugins(options) {
+    const searchPaths = options?.searchPaths ?? getDefaultSearchPaths();
+    const plugins = [];
+    const errors = [];
+    const seenPluginIds = new Set();
+    for (const searchPath of searchPaths) {
+        // Read directory entries; skip if path doesn't exist
+        let entries;
+        try {
+            entries = await fs.readdir(searchPath);
+        }
+        catch {
+            // Non-existent or unreadable path — skip silently
+            continue;
+        }
+        // Filter for directories matching the plugin naming convention
+        const pluginDirs = entries.filter((name) => name.startsWith(PLUGIN_PREFIX));
+        for (const dirName of pluginDirs) {
+            const pkgPath = path.join(searchPath, dirName);
+            try {
+                // Resolve entry point from package.json main field, falling back to index.js
+                const entryFile = await resolvePluginEntry(pkgPath);
+                const moduleUrl = pathToFileURL(entryFile).href;
+                const mod = await import(moduleUrl);
+                // Extract default export (handles both `export default` and CJS interop)
+                const candidate = mod.default ?? mod;
+                if (isValidPlugin(candidate)) {
+                    if (seenPluginIds.has(candidate.id)) {
+                        errors.push({
+                            packageName: dirName,
+                            error: `Duplicate plugin id: ${candidate.id} — already discovered`,
+                        });
+                    }
+                    else {
+                        seenPluginIds.add(candidate.id);
+                        plugins.push(candidate);
+                    }
+                }
+                else {
+                    errors.push({
+                        packageName: dirName,
+                        error: `Invalid plugin export: missing or incorrect required fields (id, name, supports, discover, emit)`,
+                    });
+                }
+            }
+            catch (err) {
+                errors.push({
+                    packageName: dirName,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+    }
+    return { plugins, errors };
+}
+/**
+ * Resolve the JavaScript entry point for a plugin package directory.
+ *
+ * Reads the `main` field from the package's `package.json` if it exists,
+ * otherwise falls back to `index.js` at the package root.
+ *
+ * @param pkgPath - Absolute path to the plugin package directory
+ * @returns Absolute path to the entry JavaScript file
+ */
+async function resolvePluginEntry(pkgPath) {
+    try {
+        const raw = await fs.readFile(path.join(pkgPath, 'package.json'), 'utf-8');
+        const pkg = JSON.parse(raw);
+        if (typeof pkg.main === 'string' && pkg.main.length > 0) {
+            return path.resolve(pkgPath, pkg.main);
+        }
+    }
+    catch {
+        // No package.json or unreadable — fall through to default
+    }
+    return path.join(pkgPath, 'index.js');
+}
+/**
+ * Type-guard that checks whether an unknown value satisfies the A16nPlugin interface.
+ *
+ * Validates presence and types of: id (string), name (string), supports (array),
+ * discover (function), emit (function).
+ *
+ * @param obj - The value to check
+ * @returns True if obj is a valid A16nPlugin
+ */
+export function isValidPlugin(obj) {
+    if (obj == null || typeof obj !== 'object') {
+        return false;
+    }
+    const candidate = obj;
+    return (typeof candidate.id === 'string' &&
+        typeof candidate.name === 'string' &&
+        Array.isArray(candidate.supports) &&
+        typeof candidate.discover === 'function' &&
+        typeof candidate.emit === 'function');
+}
+/**
+ * Compute the default search paths for plugin discovery.
+ *
+ * Returns paths where `a16n-plugin-*` packages might be installed:
+ * - The global npm `node_modules` directory (derived from this package's location)
+ * - The local `node_modules` in the current working directory
+ *
+ * In a global install, the engine lives inside node_modules:
+ *   .../lib/node_modules/@a16njs/engine/dist/plugin-discovery.js
+ * so walking up finds the node_modules parent directly.
+ *
+ * In a monorepo (e.g. pnpm workspace), the engine lives at:
+ *   <root>/packages/engine/dist/plugin-discovery.js
+ * so we also check for a node_modules child directory at each level.
+ *
+ * @returns Array of directory paths to scan
+ */
+export function getDefaultSearchPaths() {
+    const paths = [];
+    const thisFile = fileURLToPath(import.meta.url);
+    let dir = path.dirname(thisFile);
+    while (dir !== path.dirname(dir)) {
+        // Global install: this file is inside a node_modules tree
+        if (path.basename(dir) === 'node_modules') {
+            paths.push(dir);
+            break;
+        }
+        // Monorepo / local dev: check for a sibling node_modules directory.
+        // Don't stop — keep walking up to find all ancestor node_modules
+        // (e.g. packages/engine/node_modules AND root/node_modules).
+        const siblingNodeModules = path.join(dir, 'node_modules');
+        try {
+            const stat = statSync(siblingNodeModules);
+            if (stat.isDirectory()) {
+                paths.push(siblingNodeModules);
+            }
+        }
+        catch {
+            // Directory doesn't exist, keep walking
+        }
+        dir = path.dirname(dir);
+    }
+    // Global node_modules derived from process.argv[1] (handles npm link / symlink installs)
+    const argv1Global = getGlobalNodeModulesFromArgv1();
+    if (argv1Global && !paths.includes(argv1Global)) {
+        paths.push(argv1Global);
+    }
+    // Local node_modules in cwd
+    const localNodeModules = path.join(process.cwd(), 'node_modules');
+    if (!paths.includes(localNodeModules)) {
+        paths.push(localNodeModules);
+    }
+    return paths;
+}
+/**
+ * Derive the global `node_modules` directory from `process.argv[1]`.
+ *
+ * When a CLI binary is installed globally (including via `npm link`),
+ * `process.argv[1]` points to `PREFIX/bin/<cmd>`. From that we can derive
+ * `PREFIX/lib/node_modules` (Unix) or `PREFIX/node_modules` (Windows).
+ *
+ * This handles the case where the engine is symlinked from a monorepo
+ * and `import.meta.url` resolves to the real path rather than the global
+ * `node_modules` tree.
+ *
+ * @returns The global node_modules path, or null if it cannot be determined
+ */
+export function getGlobalNodeModulesFromArgv1() {
+    const argv1 = process.argv[1];
+    if (!argv1)
+        return null;
+    const binDir = path.dirname(argv1);
+    if (path.basename(binDir) !== 'bin')
+        return null;
+    const prefixDir = path.dirname(binDir);
+    // Unix: PREFIX/lib/node_modules
+    const libNm = path.join(prefixDir, 'lib', 'node_modules');
+    try {
+        if (statSync(libNm).isDirectory())
+            return libNm;
+    }
+    catch { /* not found */ }
+    // Windows / alternate layout: PREFIX/node_modules
+    const directNm = path.join(prefixDir, 'node_modules');
+    try {
+        if (statSync(directNm).isDirectory())
+            return directNm;
+    }
+    catch { /* not found */ }
+    return null;
+}
+//# sourceMappingURL=plugin-discovery.js.map