@a16njs/engine 0.0.1

package/README.md

@@ -0,0 +1,79 @@
+# @a16njs/engine
+
+Conversion engine for a16n. Orchestrates plugins to convert between tools.
+
+## Installation
+
+```bash
+npm install @a16njs/engine
+```
+
+## Usage
+
+```typescript
+import { A16nEngine } from '@a16njs/engine';
+import cursorPlugin from '@a16njs/plugin-cursor';
+import claudePlugin from '@a16njs/plugin-claude';
+
+// Create engine with plugins
+const engine = new A16nEngine([cursorPlugin, claudePlugin]);
+
+// Convert from Cursor to Claude
+const result = await engine.convert({
+  source: 'cursor',
+  target: 'claude',
+  root: './my-project',
+});
+
+console.log(`Discovered: ${result.discovered.length} items`);
+console.log(`Written: ${result.written.length} files`);
+console.log(`Warnings: ${result.warnings.length}`);
+
+// Dry run (no writes)
+const dryResult = await engine.convert({
+  source: 'cursor',
+  target: 'claude',
+  root: './my-project',
+  dryRun: true,
+});
+
+// Discover only
+const discovery = await engine.discover('cursor', './my-project');
+console.log(`Found: ${discovery.items.length} customizations`);
+
+// List plugins
+const plugins = engine.listPlugins();
+plugins.forEach(p => console.log(`${p.id}: ${p.name}`));
+```
+
+## API
+
+### `new A16nEngine(plugins)`
+
+Create an engine with the given plugins.
+
+### `engine.convert(options)`
+
+Convert customizations from source to target format.
+
+Options:
+- `source` - Source plugin ID
+- `target` - Target plugin ID  
+- `root` - Project root directory
+- `dryRun` - If true, only discover without writing
+
+### `engine.discover(pluginId, root)`
+
+Discover customizations using a specific plugin.
+
+### `engine.listPlugins()`
+
+List all registered plugins.
+
+### `engine.getPlugin(id)`
+
+Get a plugin by ID.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,78 @@
+import type { A16nPlugin, AgentCustomization, DiscoveryResult, Warning, WrittenFile, CustomizationType } from '@a16njs/models';
+/**
+ * Options for a conversion operation.
+ */
+export interface ConversionOptions {
+    /** Source plugin ID */
+    source: string;
+    /** Target plugin ID */
+    target: string;
+    /** Project root directory */
+    root: string;
+    /** If true, only discover without writing */
+    dryRun?: boolean;
+}
+/**
+ * Result of a conversion operation.
+ */
+export interface ConversionResult {
+    /** Items discovered from source */
+    discovered: AgentCustomization[];
+    /** Files written to target */
+    written: WrittenFile[];
+    /** Warnings from discovery and emission */
+    warnings: Warning[];
+    /** Items that couldn't be represented by target */
+    unsupported: AgentCustomization[];
+}
+/**
+ * Information about a registered plugin.
+ */
+export interface PluginInfo {
+    id: string;
+    name: string;
+    supports: CustomizationType[];
+    source: 'bundled' | 'installed';
+}
+/**
+ * The a16n conversion engine.
+ * Orchestrates plugins to discover and emit agent customizations.
+ */
+export declare class A16nEngine {
+    private plugins;
+    /**
+     * Create a new engine with the given plugins.
+     * @param plugins - Plugins to register
+     */
+    constructor(plugins?: A16nPlugin[]);
+    /**
+     * Register a plugin with the engine.
+     * @param plugin - The plugin to register
+     */
+    registerPlugin(plugin: A16nPlugin): void;
+    /**
+     * List all registered plugins.
+     * @returns Array of plugin info
+     */
+    listPlugins(): PluginInfo[];
+    /**
+     * Get a plugin by its ID.
+     * @param id - The plugin ID
+     * @returns The plugin or undefined if not found
+     */
+    getPlugin(id: string): A16nPlugin | undefined;
+    /**
+     * Discover customizations using a specific plugin.
+     * @param pluginId - The plugin to use for discovery
+     * @param root - The project root to scan
+     * @returns Discovery result with items and warnings
+     */
+    discover(pluginId: string, root: string): Promise<DiscoveryResult>;
+    /**
+     * Convert customizations from one format to another.
+     * @param options - Conversion options
+     * @returns Conversion result with discovered items, written files, and warnings
+     */
+    convert(options: ConversionOptions): Promise<ConversionResult>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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,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;CACnC;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;CAiCrE"}

package/dist/index.js

@@ -0,0 +1,90 @@
+/**
+ * The a16n conversion engine.
+ * Orchestrates plugins to discover and emit agent customizations.
+ */
+export class A16nEngine {
+    plugins = new Map();
+    /**
+     * Create a new engine with the given plugins.
+     * @param plugins - Plugins to register
+     */
+    constructor(plugins = []) {
+        for (const plugin of plugins) {
+            this.registerPlugin(plugin);
+        }
+    }
+    /**
+     * Register a plugin with the engine.
+     * @param plugin - The plugin to register
+     */
+    registerPlugin(plugin) {
+        this.plugins.set(plugin.id, plugin);
+    }
+    /**
+     * 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',
+        }));
+    }
+    /**
+     * Get a plugin by its ID.
+     * @param id - The plugin ID
+     * @returns The plugin or undefined if not found
+     */
+    getPlugin(id) {
+        return this.plugins.get(id);
+    }
+    /**
+     * Discover customizations using a specific plugin.
+     * @param pluginId - The plugin to use for discovery
+     * @param root - The project root to scan
+     * @returns Discovery result with items and warnings
+     */
+    async discover(pluginId, root) {
+        const plugin = this.getPlugin(pluginId);
+        if (!plugin) {
+            throw new Error(`Unknown plugin: ${pluginId}`);
+        }
+        return plugin.discover(root);
+    }
+    /**
+     * Convert customizations from one format to another.
+     * @param options - Conversion options
+     * @returns Conversion result with discovered items, written files, and warnings
+     */
+    async convert(options) {
+        const sourcePlugin = this.getPlugin(options.source);
+        const targetPlugin = this.getPlugin(options.target);
+        if (!sourcePlugin) {
+            throw new Error(`Unknown source: ${options.source}`);
+        }
+        if (!targetPlugin) {
+            throw new Error(`Unknown target: ${options.target}`);
+        }
+        // Discover from source
+        const discovery = await sourcePlugin.discover(options.root);
+        if (options.dryRun) {
+            return {
+                discovered: discovery.items,
+                written: [],
+                warnings: discovery.warnings,
+                unsupported: [],
+            };
+        }
+        // Emit to target
+        const emission = await targetPlugin.emit(discovery.items, options.root);
+        return {
+            discovered: discovery.items,
+            written: emission.written,
+            warnings: [...discovery.warnings, ...emission.warnings],
+            unsupported: emission.unsupported,
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA+CA;;;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,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,OAAO;gBACL,UAAU,EAAE,SAAS,CAAC,KAAK;gBAC3B,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,SAAS,CAAC,QAAQ;gBAC5B,WAAW,EAAE,EAAE;aAChB,CAAC;QACJ,CAAC;QAED,iBAAiB;QACjB,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAExE,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"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@a16njs/engine",
+  "version": "0.0.1",
+  "description": "Conversion engine for a16n",
+  "license": "AGPL-3.0",
+  "author": "Texarkanine",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Texarkanine/a16n.git",
+    "directory": "packages/engine"
+  },
+  "homepage": "https://github.com/Texarkanine/a16n#readme",
+  "bugs": {
+    "url": "https://github.com/Texarkanine/a16n/issues"
+  },
+  "keywords": [
+    "a16n",
+    "engine",
+    "conversion"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rimraf dist *.tsbuildinfo",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@a16njs/models": "workspace:*"
+  },
+  "devDependencies": {
+    "@a16njs/plugin-cursor": "workspace:*",
+    "@a16njs/plugin-claude": "workspace:*",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^2.0.0"
+  }
+}