@a16njs/engine 0.5.0 → 0.6.1

package/dist/workspace.js

@@ -0,0 +1,178 @@
+import * as path from 'path';
+export { LocalWorkspace, toWorkspace } from '@a16njs/models';
+/**
+ * Read-only wrapper around another workspace.
+ * Allows read operations but throws on any write operation.
+ * Useful for dry-run scenarios.
+ *
+ * @example
+ * ```typescript
+ * const ws = new LocalWorkspace('source', '/project');
+ * const readOnly = new ReadOnlyWorkspace(ws);
+ * await readOnly.read('file.md'); // works
+ * await readOnly.write('file.md', 'content'); // throws!
+ * ```
+ */
+export class ReadOnlyWorkspace {
+    underlying;
+    /**
+     * Create a new ReadOnlyWorkspace wrapping another workspace.
+     * @param underlying - The workspace to wrap
+     */
+    constructor(underlying) {
+        this.underlying = underlying;
+    }
+    get id() {
+        return this.underlying.id;
+    }
+    get root() {
+        return this.underlying.root;
+    }
+    resolve(relativePath) {
+        return this.underlying.resolve(relativePath);
+    }
+    exists(relativePath) {
+        return this.underlying.exists(relativePath);
+    }
+    read(relativePath) {
+        return this.underlying.read(relativePath);
+    }
+    async write(_relativePath, _content) {
+        throw new Error('Cannot write to read-only workspace');
+    }
+    readdir(relativePath) {
+        return this.underlying.readdir(relativePath);
+    }
+    async mkdir(_relativePath) {
+        throw new Error('Cannot mkdir in read-only workspace');
+    }
+}
+/**
+ * In-memory workspace for testing.
+ * Stores files in a Map, no filesystem access.
+ *
+ * @example
+ * ```typescript
+ * const ws = new MemoryWorkspace('test');
+ * await ws.write('rules/my-rule.md', '# Rule');
+ * const content = await ws.read('rules/my-rule.md');
+ * const entries = await ws.readdir('rules');
+ * // entries: [{ name: 'my-rule.md', isFile: true, isDirectory: false }]
+ * ```
+ */
+export class MemoryWorkspace {
+    id;
+    root = '/memory';
+    files = new Map();
+    directories = new Set();
+    /**
+     * Create a new MemoryWorkspace.
+     * @param id - Unique identifier for this workspace
+     * @param initialFiles - Optional map of relative paths to file contents
+     */
+    constructor(id, initialFiles) {
+        this.id = id;
+        if (initialFiles) {
+            for (const [filePath, content] of Object.entries(initialFiles)) {
+                this.files.set(this.normalizePath(filePath), content);
+            }
+        }
+    }
+    resolve(relativePath) {
+        const normalized = this.normalizePath(relativePath);
+        if (normalized === '')
+            return this.root;
+        return this.root + '/' + normalized;
+    }
+    async exists(relativePath) {
+        const normalized = this.normalizePath(relativePath);
+        // Check if it's a file
+        if (this.files.has(normalized))
+            return true;
+        // Check if it's an explicit directory
+        if (this.directories.has(normalized))
+            return true;
+        // Check if it's an implicit directory (some file has this as a prefix)
+        if (normalized === '')
+            return true;
+        const prefix = normalized + '/';
+        for (const key of this.files.keys()) {
+            if (key.startsWith(prefix))
+                return true;
+        }
+        return false;
+    }
+    async read(relativePath) {
+        const normalized = this.normalizePath(relativePath);
+        const content = this.files.get(normalized);
+        if (content === undefined) {
+            throw new Error(`File not found: ${relativePath} in workspace ${this.id}`);
+        }
+        return content;
+    }
+    async write(relativePath, content) {
+        const normalized = this.normalizePath(relativePath);
+        this.files.set(normalized, content);
+    }
+    async readdir(relativePath) {
+        const normalized = this.normalizePath(relativePath);
+        // Check directory exists
+        if (!(await this.exists(normalized))) {
+            throw new Error(`Directory not found: ${relativePath} in workspace ${this.id}`);
+        }
+        const prefix = normalized === '' ? '' : normalized + '/';
+        const entries = new Map();
+        // Scan files for entries under this directory
+        for (const key of this.files.keys()) {
+            if (!key.startsWith(prefix))
+                continue;
+            const rest = key.slice(prefix.length);
+            const slashIndex = rest.indexOf('/');
+            if (slashIndex === -1) {
+                // Direct child file
+                entries.set(rest, { name: rest, isFile: true, isDirectory: false });
+            }
+            else {
+                // Subdirectory (from file path)
+                const dirName = rest.slice(0, slashIndex);
+                if (!entries.has(dirName)) {
+                    entries.set(dirName, { name: dirName, isFile: false, isDirectory: true });
+                }
+            }
+        }
+        // Also scan explicit directories
+        for (const dir of this.directories) {
+            if (!dir.startsWith(prefix))
+                continue;
+            const rest = dir.slice(prefix.length);
+            if (rest === '')
+                continue;
+            const slashIndex = rest.indexOf('/');
+            const dirName = slashIndex === -1 ? rest : rest.slice(0, slashIndex);
+            if (!entries.has(dirName)) {
+                entries.set(dirName, { name: dirName, isFile: false, isDirectory: true });
+            }
+        }
+        return Array.from(entries.values());
+    }
+    async mkdir(relativePath) {
+        const normalized = this.normalizePath(relativePath);
+        if (normalized !== '') {
+            this.directories.add(normalized);
+        }
+    }
+    /**
+     * Get all file paths stored in this workspace (for test assertions).
+     * @returns Array of normalized file paths
+     */
+    getAllPaths() {
+        return Array.from(this.files.keys());
+    }
+    /**
+     * Normalize a path to use forward slashes and strip leading slash.
+     */
+    normalizePath(p) {
+        return p.split(path.sep).join('/').replace(/^\//, '');
+    }
+}
+//# sourceMappingURL=workspace.js.map

package/dist/workspace.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a16njs/engine",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "description": "Conversion engine for a16n",
   "license": "AGPL-3.0",
   "author": "Texarkanine",
@@ -31,14 +31,14 @@
     "dist"
   ],
   "dependencies": {
-    "@a16njs/models": "0.9.0"
+    "@a16njs/models": "0.10.1"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
     "typescript": "^5.4.0",
     "vitest": "^2.0.0",
-    "@a16njs/plugin-cursor": "0.9.0",
-    "@a16njs/plugin-claude": "0.9.0"
+    "@a16njs/plugin-cursor": "0.10.1",
+    "@a16njs/plugin-claude": "0.10.1"
   },
   "scripts": {
     "build": "tsc",