@a16njs/engine 0.4.0 → 0.6.0

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.
  */
@@ -11,6 +13,21 @@ export interface ConversionOptions {
     root: string;
     /** If true, only discover without writing */
     dryRun?: boolean;
+    /** Override root for discovery (source plugin) */
+    sourceRoot?: string;
+    /** 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 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.
@@ -47,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
@@ -77,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;AAExB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;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;CA0BrE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,35 +1,61 @@
+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) {
-        this.plugins.set(plugin.id, plugin);
+    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
+     */
+    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,
         }));
     }
     /**
@@ -38,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.
@@ -67,16 +96,52 @@ export class A16nEngine {
         if (!targetPlugin) {
             throw new Error(`Unknown target: ${options.target}`);
         }
-        // Discover from source
-        const discovery = await sourcePlugin.discover(options.root);
-        // Emit to target (pass dryRun to calculate what would be written)
-        const emission = await targetPlugin.emit(discovery.items, options.root, {
+        // 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);
+            }
+        }
+        // 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: [...discovery.warnings, ...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":"AA6DA;;;GAGG;AACH,MAAM,OAAO,UAAU;IACb,OAAO,GAA4B,IAAI,GAAG,EAAE,CAAC;IAErD;;;OAGG;IACH,YAAY,UAAwB,EAAE;QACpC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,cAAc,CAAC,MAAkB;QAC/B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAED;;;OAGG;IACH,WAAW;QACT,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnD,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,MAAM,EAAE,SAAkB;SAC3B,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;;;OAIG;IACH,SAAS,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,QAAgB,EAAE,IAAY;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,OAA0B;QACtC,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACpD,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAEpD,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,mBAAmB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,mBAAmB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACvD,CAAC;QAED,uBAAuB;QACvB,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAE5D,kEAAkE;QAClE,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE;YACtE,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QAEH,OAAO;YACL,UAAU,EAAE,SAAS,CAAC,KAAK;YAC3B,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,QAAQ,EAAE,CAAC,GAAG,SAAS,CAAC,QAAQ,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC;YACvD,WAAW,EAAE,QAAQ,CAAC,WAAW;SAClC,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/path-rewriter.d.ts

@@ -0,0 +1,68 @@
+import type { AgentCustomization, Warning } from '@a16njs/models';
+import type { WrittenFile } from '@a16njs/models';
+/**
+ * A mapping from source-relative paths to target-relative paths.
+ * Used to rewrite path references in content during format conversion.
+ */
+export type PathMapping = Map<string, string>;
+/**
+ * Result of a path rewriting operation.
+ */
+export interface RewriteResult {
+    /** The items with rewritten content (cloned; originals are not mutated) */
+    items: AgentCustomization[];
+    /** Count of replacements made across all items */
+    replacementCount: number;
+}
+/**
+ * Build a mapping from source-relative paths to target-relative paths.
+ *
+ * Given the discovered items (with sourcePaths relative to sourceRoot)
+ * and the written files (with absolute paths under targetRoot), produces
+ * a Map where keys are source-relative paths and values are target-relative paths.
+ *
+ * The mapping is derived from the `sourceItems` array on each WrittenFile,
+ * which links each output file back to the source AgentCustomization(s) that
+ * produced it. This handles merges, extension changes, and directory flattening
+ * naturally because the mapping is derived from actual emit output.
+ *
+ * @param _discovered - Items discovered from the source plugin (unused directly; mapping comes from written.sourceItems)
+ * @param written - Files written (or planned) by the target plugin
+ * @param _sourceRoot - Root directory used for discovery (unused; sourcePaths are already relative)
+ * @param targetRoot - Root directory used for emission
+ * @returns A map of source-relative path to target-relative path
+ */
+export declare function buildMapping(_discovered: AgentCustomization[], written: WrittenFile[], _sourceRoot: string, targetRoot: string): PathMapping;
+/**
+ * Rewrite file path references in item content.
+ *
+ * For each item, every occurrence of a mapped source path in the content
+ * is replaced with the corresponding target path. Replacements are applied
+ * longest-first to prevent partial match corruption (e.g., replacing
+ * "foo/bar.mdc.bak" before "foo/bar.mdc").
+ *
+ * Items are cloned before modification; originals are not mutated.
+ *
+ * @param items - The items whose content should be rewritten
+ * @param mapping - The source-to-target path mapping
+ * @returns Cloned items with rewritten content and replacement count
+ */
+export declare function rewriteContent(items: AgentCustomization[], mapping: PathMapping): RewriteResult;
+/**
+ * Detect orphan path references in item content.
+ *
+ * An "orphan" is a string in content that looks like it could be a
+ * source-format file path (matches known source plugin path prefixes
+ * and file extensions) but is NOT present in the mapping (i.e., it
+ * wasn't converted).
+ *
+ * @param items - The items to scan for orphan references
+ * @param mapping - The source-to-target path mapping
+ * @param sourcePluginPrefixes - Known directory prefixes for the source format
+ *   (e.g., ['.cursor/rules/', '.cursor/skills/'] for cursor plugin)
+ * @param sourceExtensions - Known file extensions for the source format
+ *   (e.g., ['.mdc', '.md'] for cursor plugin)
+ * @returns Warnings about orphan references found
+ */
+export declare function detectOrphans(items: AgentCustomization[], mapping: PathMapping, sourcePluginPrefixes: string[], sourceExtensions: string[]): Warning[];
+//# sourceMappingURL=path-rewriter.d.ts.map

package/dist/path-rewriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-rewriter.d.ts","sourceRoot":"","sources":["../src/path-rewriter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAElE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,2EAA2E;IAC3E,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,kDAAkD;IAClD,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,kBAAkB,EAAE,EACjC,OAAO,EAAE,WAAW,EAAE,EACtB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,WAAW,CAoBb;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,kBAAkB,EAAE,EAC3B,OAAO,EAAE,WAAW,GACnB,aAAa,CAgDf;AASD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,kBAAkB,EAAE,EAC3B,OAAO,EAAE,WAAW,EACpB,oBAAoB,EAAE,MAAM,EAAE,EAC9B,gBAAgB,EAAE,MAAM,EAAE,GACzB,OAAO,EAAE,CAmCX"}

package/dist/path-rewriter.js

@@ -0,0 +1,144 @@
+import * as path from 'path';
+import { WarningCode } from '@a16njs/models';
+/**
+ * Build a mapping from source-relative paths to target-relative paths.
+ *
+ * Given the discovered items (with sourcePaths relative to sourceRoot)
+ * and the written files (with absolute paths under targetRoot), produces
+ * a Map where keys are source-relative paths and values are target-relative paths.
+ *
+ * The mapping is derived from the `sourceItems` array on each WrittenFile,
+ * which links each output file back to the source AgentCustomization(s) that
+ * produced it. This handles merges, extension changes, and directory flattening
+ * naturally because the mapping is derived from actual emit output.
+ *
+ * @param _discovered - Items discovered from the source plugin (unused directly; mapping comes from written.sourceItems)
+ * @param written - Files written (or planned) by the target plugin
+ * @param _sourceRoot - Root directory used for discovery (unused; sourcePaths are already relative)
+ * @param targetRoot - Root directory used for emission
+ * @returns A map of source-relative path to target-relative path
+ */
+export function buildMapping(_discovered, written, _sourceRoot, targetRoot) {
+    const mapping = new Map();
+    for (const file of written) {
+        // Compute target-relative path using POSIX separators for consistency
+        const targetRelative = path.relative(targetRoot, file.path).split(path.sep).join('/');
+        // Map each source item's sourcePath to this target path
+        if (file.sourceItems) {
+            for (const sourceItem of file.sourceItems) {
+                if (sourceItem.sourcePath) {
+                    // Normalize to POSIX separators
+                    const normalizedSourcePath = sourceItem.sourcePath.split(path.sep).join('/');
+                    mapping.set(normalizedSourcePath, targetRelative);
+                }
+            }
+        }
+    }
+    return mapping;
+}
+/**
+ * Rewrite file path references in item content.
+ *
+ * For each item, every occurrence of a mapped source path in the content
+ * is replaced with the corresponding target path. Replacements are applied
+ * longest-first to prevent partial match corruption (e.g., replacing
+ * "foo/bar.mdc.bak" before "foo/bar.mdc").
+ *
+ * Items are cloned before modification; originals are not mutated.
+ *
+ * @param items - The items whose content should be rewritten
+ * @param mapping - The source-to-target path mapping
+ * @returns Cloned items with rewritten content and replacement count
+ */
+export function rewriteContent(items, mapping) {
+    if (mapping.size === 0) {
+        // No mapping → return clones with no changes
+        return {
+            items: items.map((item) => ({ ...item })),
+            replacementCount: 0,
+        };
+    }
+    // Sort replacements longest-first to prevent partial match corruption
+    const sortedEntries = Array.from(mapping.entries()).sort((a, b) => b[0].length - a[0].length);
+    let totalReplacements = 0;
+    const rewrittenItems = items.map((item) => {
+        // Clone the item (shallow clone is sufficient since we only modify content)
+        const clone = { ...item };
+        let content = clone.content;
+        // NOTE: Replacements are applied sequentially. This is safe because source
+        // and target paths use different plugin directory prefixes, so a target path
+        // won't match a subsequent source key.
+        for (const [sourcePath, targetPath] of sortedEntries) {
+            // Count occurrences before replacement
+            let count = 0;
+            let idx = 0;
+            while ((idx = content.indexOf(sourcePath, idx)) !== -1) {
+                count++;
+                idx += sourcePath.length;
+            }
+            if (count > 0) {
+                // Use split+join for exact string replacement (no regex escaping needed)
+                content = content.split(sourcePath).join(targetPath);
+                totalReplacements += count;
+            }
+        }
+        clone.content = content;
+        return clone;
+    });
+    return {
+        items: rewrittenItems,
+        replacementCount: totalReplacements,
+    };
+}
+/**
+ * Escape a string for use in a RegExp.
+ */
+function escapeRegExp(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Detect orphan path references in item content.
+ *
+ * An "orphan" is a string in content that looks like it could be a
+ * source-format file path (matches known source plugin path prefixes
+ * and file extensions) but is NOT present in the mapping (i.e., it
+ * wasn't converted).
+ *
+ * @param items - The items to scan for orphan references
+ * @param mapping - The source-to-target path mapping
+ * @param sourcePluginPrefixes - Known directory prefixes for the source format
+ *   (e.g., ['.cursor/rules/', '.cursor/skills/'] for cursor plugin)
+ * @param sourceExtensions - Known file extensions for the source format
+ *   (e.g., ['.mdc', '.md'] for cursor plugin)
+ * @returns Warnings about orphan references found
+ */
+export function detectOrphans(items, mapping, sourcePluginPrefixes, sourceExtensions) {
+    if (sourcePluginPrefixes.length === 0 || sourceExtensions.length === 0) {
+        return [];
+    }
+    const warnings = [];
+    const mappedPaths = new Set(mapping.keys());
+    const seen = new Set();
+    // Build a regex that matches: <prefix><non-whitespace-path><extension>
+    // e.g., .cursor/rules/some-file.mdc
+    const escapedPrefixes = sourcePluginPrefixes.map(escapeRegExp).join('|');
+    const escapedExtensions = sourceExtensions.map(escapeRegExp).join('|');
+    const pattern = new RegExp(`(?:${escapedPrefixes})[^\\s)\\]}>,"']+(?:${escapedExtensions})`, 'g');
+    for (const item of items) {
+        const matches = item.content.matchAll(pattern);
+        for (const match of matches) {
+            const foundPath = match[0];
+            const key = `${item.sourcePath ?? ''}::${foundPath}`;
+            if (!mappedPaths.has(foundPath) && !seen.has(key)) {
+                seen.add(key);
+                warnings.push({
+                    code: WarningCode.OrphanPathRef,
+                    message: `Orphan path reference: '${foundPath}' is not in the conversion set`,
+                    sources: item.sourcePath ? [item.sourcePath] : undefined,
+                });
+            }
+        }
+    }
+    return warnings;
+}
+//# sourceMappingURL=path-rewriter.js.map

package/dist/path-rewriter.js.map

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

package/dist/plugin-discovery.d.ts

@@ -0,0 +1,64 @@
+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[];
+//# 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,CAiChD"}