shell-dsl 0.0.24 → 0.0.25

package/dist/cjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "shell-dsl",
-  "version": "0.0.24",
+  "version": "0.0.25",
   "type": "commonjs"
 }

package/dist/cjs/src/fs/memfs-adapter.cjs

@@ -49,11 +49,12 @@ var pathModule = __toESM(require("path"));
 function createVirtualFS(memfs) {
   const { promises: fs } = memfs;
   return {
-    async readFile(path) {
+    readFile: async (path, encoding) => {
       if (path === "/dev/null")
-        return Buffer.alloc(0);
+        return encoding ? "" : Buffer.alloc(0);
       const content = await fs.readFile(path);
-      return Buffer.from(content);
+      const buf = Buffer.from(content);
+      return encoding ? buf.toString(encoding) : buf;
     },
     async readdir(path) {
       const entries = await fs.readdir(path);
@@ -220,4 +221,4 @@ function globToRegex(pattern) {
   return new RegExp(regex);
 }
 
-//# debugId=DF5D9CFE73330B7364756E2164756E21
+//# debugId=EFAFB04E67DC8AE464756E2164756E21

package/dist/cjs/src/fs/memfs-adapter.cjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../../src/fs/memfs-adapter.ts"],
   "sourcesContent": [
-    "import type { IFs } from \"memfs\";\nimport type { VirtualFS, FileStat } from \"../types.cjs\";\nimport * as pathModule from \"path\";\n\nexport function createVirtualFS(memfs: IFs): VirtualFS {\n  const { promises: fs } = memfs;\n\n  return {\n    async readFile(path: string): Promise<Buffer> {\n      if (path === \"/dev/null\") return Buffer.alloc(0);\n      const content = await fs.readFile(path);\n      return Buffer.from(content);\n    },\n\n    async readdir(path: string): Promise<string[]> {\n      const entries = await fs.readdir(path);\n      return entries.map(String);\n    },\n\n    async stat(path: string): Promise<FileStat> {\n      const stats = await fs.stat(path);\n      return {\n        isFile: () => stats.isFile(),\n        isDirectory: () => stats.isDirectory(),\n        size: Number(stats.size),\n        mtime: new Date(stats.mtime),\n      };\n    },\n\n    async exists(path: string): Promise<boolean> {\n      try {\n        await fs.stat(path);\n        return true;\n      } catch {\n        return false;\n      }\n    },\n\n    async writeFile(path: string, data: Buffer | string): Promise<void> {\n      await fs.writeFile(path, data);\n    },\n\n    async appendFile(path: string, data: Buffer | string): Promise<void> {\n      await fs.appendFile(path, data);\n    },\n\n    async mkdir(path: string, opts?: { recursive?: boolean }): Promise<void> {\n      await fs.mkdir(path, opts);\n    },\n\n    async rm(path: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void> {\n      try {\n        const stats = await fs.stat(path);\n        if (stats.isDirectory()) {\n          await fs.rmdir(path, { recursive: opts?.recursive });\n        } else {\n          await fs.unlink(path);\n        }\n      } catch (err) {\n        if (!opts?.force) throw err;\n      }\n    },\n\n    resolve(...paths: string[]): string {\n      return pathModule.resolve(...paths);\n    },\n\n    dirname(path: string): string {\n      return pathModule.dirname(path);\n    },\n\n    basename(path: string): string {\n      return pathModule.basename(path);\n    },\n\n    async glob(pattern: string, opts?: { cwd?: string }): Promise<string[]> {\n      const cwd = opts?.cwd ?? \"/\";\n      return expandGlob(memfs, pattern, cwd);\n    },\n  };\n}\n\nasync function expandGlob(memfs: IFs, pattern: string, cwd: string): Promise<string[]> {\n  const { promises: fs } = memfs;\n\n  // Handle brace expansion first\n  const patterns = expandBraces(pattern);\n  const allMatches: string[] = [];\n\n  for (const pat of patterns) {\n    const matches = await matchPattern(fs, pat, cwd);\n    allMatches.push(...matches);\n  }\n\n  // Remove duplicates and sort\n  return [...new Set(allMatches)].sort();\n}\n\nfunction expandBraces(pattern: string): string[] {\n  const braceMatch = pattern.match(/\\{([^{}]+)\\}/);\n  if (!braceMatch) return [pattern];\n\n  const before = pattern.slice(0, braceMatch.index);\n  const after = pattern.slice(braceMatch.index! + braceMatch[0].length);\n  const options = braceMatch[1]!.split(\",\");\n\n  const results: string[] = [];\n  for (const opt of options) {\n    const expanded = expandBraces(before + opt + after);\n    results.push(...expanded);\n  }\n  return results;\n}\n\nasync function matchPattern(\n  fs: IFs[\"promises\"],\n  pattern: string,\n  cwd: string\n): Promise<string[]> {\n  const parts = pattern.split(\"/\").filter((p) => p !== \"\");\n  const isAbsolute = pattern.startsWith(\"/\");\n  const startDir = isAbsolute ? \"/\" : cwd;\n\n  return matchParts(fs, parts, startDir, isAbsolute);\n}\n\nasync function matchParts(\n  fs: IFs[\"promises\"],\n  parts: string[],\n  currentPath: string,\n  isAbsolute: boolean\n): Promise<string[]> {\n  if (parts.length === 0) {\n    return [currentPath];\n  }\n\n  const [part, ...rest] = parts;\n\n  // Handle ** (recursive glob)\n  if (part === \"**\") {\n    const results: string[] = [];\n\n    // Match current directory\n    const withoutStar = await matchParts(fs, rest, currentPath, isAbsolute);\n    results.push(...withoutStar);\n\n    // Recurse into subdirectories\n    try {\n      const entries = await fs.readdir(currentPath);\n      for (const entry of entries) {\n        const entryPath = pathModule.join(currentPath, String(entry));\n        try {\n          const stat = await fs.stat(entryPath);\n          if (stat.isDirectory()) {\n            const subMatches = await matchParts(fs, parts, entryPath, isAbsolute);\n            results.push(...subMatches);\n          }\n        } catch {\n          // Skip inaccessible entries\n        }\n      }\n    } catch {\n      // Directory not readable\n    }\n\n    return results;\n  }\n\n  // Handle regular glob patterns\n  const regex = globToRegex(part!);\n\n  try {\n    const entries = await fs.readdir(currentPath);\n    const results: string[] = [];\n\n    for (const entry of entries) {\n      const entryName = String(entry);\n      if (regex.test(entryName)) {\n        const entryPath = pathModule.join(currentPath, entryName);\n        if (rest.length === 0) {\n          results.push(entryPath);\n        } else {\n          try {\n            const stat = await fs.stat(entryPath);\n            if (stat.isDirectory()) {\n              const subMatches = await matchParts(fs, rest, entryPath, isAbsolute);\n              results.push(...subMatches);\n            }\n          } catch {\n            // Skip inaccessible entries\n          }\n        }\n      }\n    }\n\n    return results;\n  } catch {\n    return [];\n  }\n}\n\nfunction globToRegex(pattern: string): RegExp {\n  let regex = \"^\";\n  for (let i = 0; i < pattern.length; i++) {\n    const char = pattern[i]!;\n    if (char === \"*\") {\n      regex += \"[^/]*\";\n    } else if (char === \"?\") {\n      regex += \"[^/]\";\n    } else if (char === \"[\") {\n      // Character class\n      let j = i + 1;\n      let classContent = \"\";\n      while (j < pattern.length && pattern[j] !== \"]\") {\n        classContent += pattern[j];\n        j++;\n      }\n      regex += `[${classContent}]`;\n      i = j;\n    } else if (\".+^${}()|\\\\\".includes(char)) {\n      regex += \"\\\\\" + char;\n    } else {\n      regex += char;\n    }\n  }\n  regex += \"$\";\n  return new RegExp(regex);\n}\n"
+    "import type { IFs } from \"memfs\";\nimport type { VirtualFS, FileStat } from \"../types.cjs\";\nimport * as pathModule from \"path\";\n\nexport function createVirtualFS(memfs: IFs): VirtualFS {\n  const { promises: fs } = memfs;\n\n  return {\n    readFile: (async (path: string, encoding?: BufferEncoding): Promise<Buffer | string> => {\n      if (path === \"/dev/null\") return encoding ? \"\" : Buffer.alloc(0);\n      const content = await fs.readFile(path);\n      const buf = Buffer.from(content);\n      return encoding ? buf.toString(encoding) : buf;\n    }) as VirtualFS[\"readFile\"],\n\n    async readdir(path: string): Promise<string[]> {\n      const entries = await fs.readdir(path);\n      return entries.map(String);\n    },\n\n    async stat(path: string): Promise<FileStat> {\n      const stats = await fs.stat(path);\n      return {\n        isFile: () => stats.isFile(),\n        isDirectory: () => stats.isDirectory(),\n        size: Number(stats.size),\n        mtime: new Date(stats.mtime),\n      };\n    },\n\n    async exists(path: string): Promise<boolean> {\n      try {\n        await fs.stat(path);\n        return true;\n      } catch {\n        return false;\n      }\n    },\n\n    async writeFile(path: string, data: Buffer | string): Promise<void> {\n      await fs.writeFile(path, data);\n    },\n\n    async appendFile(path: string, data: Buffer | string): Promise<void> {\n      await fs.appendFile(path, data);\n    },\n\n    async mkdir(path: string, opts?: { recursive?: boolean }): Promise<void> {\n      await fs.mkdir(path, opts);\n    },\n\n    async rm(path: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void> {\n      try {\n        const stats = await fs.stat(path);\n        if (stats.isDirectory()) {\n          await fs.rmdir(path, { recursive: opts?.recursive });\n        } else {\n          await fs.unlink(path);\n        }\n      } catch (err) {\n        if (!opts?.force) throw err;\n      }\n    },\n\n    resolve(...paths: string[]): string {\n      return pathModule.resolve(...paths);\n    },\n\n    dirname(path: string): string {\n      return pathModule.dirname(path);\n    },\n\n    basename(path: string): string {\n      return pathModule.basename(path);\n    },\n\n    async glob(pattern: string, opts?: { cwd?: string }): Promise<string[]> {\n      const cwd = opts?.cwd ?? \"/\";\n      return expandGlob(memfs, pattern, cwd);\n    },\n  };\n}\n\nasync function expandGlob(memfs: IFs, pattern: string, cwd: string): Promise<string[]> {\n  const { promises: fs } = memfs;\n\n  // Handle brace expansion first\n  const patterns = expandBraces(pattern);\n  const allMatches: string[] = [];\n\n  for (const pat of patterns) {\n    const matches = await matchPattern(fs, pat, cwd);\n    allMatches.push(...matches);\n  }\n\n  // Remove duplicates and sort\n  return [...new Set(allMatches)].sort();\n}\n\nfunction expandBraces(pattern: string): string[] {\n  const braceMatch = pattern.match(/\\{([^{}]+)\\}/);\n  if (!braceMatch) return [pattern];\n\n  const before = pattern.slice(0, braceMatch.index);\n  const after = pattern.slice(braceMatch.index! + braceMatch[0].length);\n  const options = braceMatch[1]!.split(\",\");\n\n  const results: string[] = [];\n  for (const opt of options) {\n    const expanded = expandBraces(before + opt + after);\n    results.push(...expanded);\n  }\n  return results;\n}\n\nasync function matchPattern(\n  fs: IFs[\"promises\"],\n  pattern: string,\n  cwd: string\n): Promise<string[]> {\n  const parts = pattern.split(\"/\").filter((p) => p !== \"\");\n  const isAbsolute = pattern.startsWith(\"/\");\n  const startDir = isAbsolute ? \"/\" : cwd;\n\n  return matchParts(fs, parts, startDir, isAbsolute);\n}\n\nasync function matchParts(\n  fs: IFs[\"promises\"],\n  parts: string[],\n  currentPath: string,\n  isAbsolute: boolean\n): Promise<string[]> {\n  if (parts.length === 0) {\n    return [currentPath];\n  }\n\n  const [part, ...rest] = parts;\n\n  // Handle ** (recursive glob)\n  if (part === \"**\") {\n    const results: string[] = [];\n\n    // Match current directory\n    const withoutStar = await matchParts(fs, rest, currentPath, isAbsolute);\n    results.push(...withoutStar);\n\n    // Recurse into subdirectories\n    try {\n      const entries = await fs.readdir(currentPath);\n      for (const entry of entries) {\n        const entryPath = pathModule.join(currentPath, String(entry));\n        try {\n          const stat = await fs.stat(entryPath);\n          if (stat.isDirectory()) {\n            const subMatches = await matchParts(fs, parts, entryPath, isAbsolute);\n            results.push(...subMatches);\n          }\n        } catch {\n          // Skip inaccessible entries\n        }\n      }\n    } catch {\n      // Directory not readable\n    }\n\n    return results;\n  }\n\n  // Handle regular glob patterns\n  const regex = globToRegex(part!);\n\n  try {\n    const entries = await fs.readdir(currentPath);\n    const results: string[] = [];\n\n    for (const entry of entries) {\n      const entryName = String(entry);\n      if (regex.test(entryName)) {\n        const entryPath = pathModule.join(currentPath, entryName);\n        if (rest.length === 0) {\n          results.push(entryPath);\n        } else {\n          try {\n            const stat = await fs.stat(entryPath);\n            if (stat.isDirectory()) {\n              const subMatches = await matchParts(fs, rest, entryPath, isAbsolute);\n              results.push(...subMatches);\n            }\n          } catch {\n            // Skip inaccessible entries\n          }\n        }\n      }\n    }\n\n    return results;\n  } catch {\n    return [];\n  }\n}\n\nfunction globToRegex(pattern: string): RegExp {\n  let regex = \"^\";\n  for (let i = 0; i < pattern.length; i++) {\n    const char = pattern[i]!;\n    if (char === \"*\") {\n      regex += \"[^/]*\";\n    } else if (char === \"?\") {\n      regex += \"[^/]\";\n    } else if (char === \"[\") {\n      // Character class\n      let j = i + 1;\n      let classContent = \"\";\n      while (j < pattern.length && pattern[j] !== \"]\") {\n        classContent += pattern[j];\n        j++;\n      }\n      regex += `[${classContent}]`;\n      i = j;\n    } else if (\".+^${}()|\\\\\".includes(char)) {\n      regex += \"\\\\\" + char;\n    } else {\n      regex += char;\n    }\n  }\n  regex += \"$\";\n  return new RegExp(regex);\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "DF5D9CFE73330B7364756E2164756E21",
+  "mappings": "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",
+  "debugId": "EFAFB04E67DC8AE464756E2164756E21",
   "names": []
 }

package/dist/cjs/src/fs/real-fs.cjs

@@ -129,11 +129,12 @@ class FileSystem {
     }
     return resolved;
   }
-  async readFile(filePath) {
+  async readFile(filePath, encoding) {
     this.checkPermission(filePath, "read");
     const realPath = this.resolveSafePath(filePath);
     const content = await this.underlyingFs.promises.readFile(realPath);
-    return Buffer.from(content);
+    const buf = Buffer.from(content);
+    return encoding ? buf.toString(encoding) : buf;
   }
   async readdir(dirPath) {
     this.checkPermission(dirPath, "read");
@@ -308,4 +309,4 @@ class FileSystem {
   }
 }
 
-//# debugId=FE5125D36453662C64756E2164756E21
+//# debugId=891ABFB98712125464756E2164756E21

package/dist/cjs/src/fs/real-fs.cjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../../src/fs/real-fs.ts"],
   "sourcesContent": [
-    "import * as path from \"path\";\nimport * as nodeFs from \"node:fs/promises\";\nimport type { VirtualFS, FileStat } from \"../types.cjs\";\n\nexport type Permission = \"read-write\" | \"read-only\" | \"excluded\";\nexport type PermissionRules = Record<string, Permission>;\n\n// Minimal interface for the underlying fs (compatible with node:fs and memfs)\nexport interface UnderlyingFS {\n  promises: {\n    readFile(path: string): Promise<Buffer | Uint8Array | string>;\n    readdir(path: string): Promise<string[]>;\n    stat(path: string): Promise<{\n      isFile(): boolean;\n      isDirectory(): boolean;\n      size: number;\n      mtime: Date;\n    }>;\n    writeFile(path: string, data: Buffer | string): Promise<void>;\n    appendFile(path: string, data: Buffer | string): Promise<void>;\n    mkdir(path: string, opts?: { recursive?: boolean }): Promise<string | undefined | void>;\n    rm(path: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void>;\n  };\n}\n\n// Default: use real node:fs\nconst defaultFS: UnderlyingFS = { promises: nodeFs };\n\ninterface CompiledRule {\n  pattern: string;\n  permission: Permission;\n  specificity: number;\n}\n\nexport class FileSystem implements VirtualFS {\n  private readonly mountBase: string | null;\n  private readonly rules: CompiledRule[];\n  protected readonly underlyingFs: UnderlyingFS;\n\n  constructor(mountPath?: string, permissions?: PermissionRules, fs?: UnderlyingFS) {\n    this.mountBase = mountPath ? path.resolve(mountPath) : null;\n    this.rules = this.compileRules(permissions ?? {});\n    this.underlyingFs = fs ?? defaultFS;\n  }\n\n  private compileRules(permissions: PermissionRules): CompiledRule[] {\n    return Object.entries(permissions)\n      .map(([pattern, permission]) => ({\n        pattern,\n        permission,\n        specificity: this.calculateSpecificity(pattern),\n      }))\n      .sort((a, b) => b.specificity - a.specificity); // highest first\n  }\n\n  private calculateSpecificity(pattern: string): number {\n    const segments = pattern.split(\"/\").filter(Boolean);\n    let score = segments.length * 1000; // segment count is primary\n\n    for (const seg of segments) {\n      if (seg === \"**\") score += 0;\n      else if (seg.includes(\"*\")) score += 1;\n      else score += 10; // literal segment\n    }\n    return score;\n  }\n\n  public getPermission(virtualPath: string): Permission {\n    const normalized = virtualPath.replace(/^\\/+/, \"\"); // strip leading slashes\n\n    for (const rule of this.rules) {\n      if (this.matchGlob(rule.pattern, normalized)) {\n        return rule.permission;\n      }\n    }\n    return \"read-write\"; // default\n  }\n\n  private matchGlob(pattern: string, filePath: string): boolean {\n    // Convert glob to regex\n    // ** matches any path segments, * matches within segment\n    const regex = pattern\n      .split(\"/\")\n      .map((seg) => {\n        if (seg === \"**\") return \".*\";\n        return seg.replace(/\\*/g, \"[^/]*\").replace(/\\?/g, \"[^/]\");\n      })\n      .join(\"/\");\n    return new RegExp(`^${regex}$`).test(filePath);\n  }\n\n  public checkPermission(virtualPath: string, operation: \"read\" | \"write\"): void {\n    const perm = this.getPermission(virtualPath);\n\n    if (perm === \"excluded\") {\n      throw new Error(`Access denied: \"${virtualPath}\" is excluded`);\n    }\n    if (operation === \"write\" && perm === \"read-only\") {\n      throw new Error(`Access denied: \"${virtualPath}\" is read-only`);\n    }\n  }\n\n  private resolveSafePath(virtualPath: string): string {\n    if (this.mountBase === null) {\n      return path.resolve(virtualPath);\n    }\n\n    // Check for path traversal by tracking depth\n    const segments = virtualPath.split(\"/\").filter(Boolean);\n    let depth = 0;\n    for (const seg of segments) {\n      if (seg === \"..\") {\n        depth--;\n        if (depth < 0) {\n          throw new Error(`Path traversal blocked: \"${virtualPath}\" escapes mount point`);\n        }\n      } else if (seg !== \".\") {\n        depth++;\n      }\n    }\n\n    const normalized = path.normalize(virtualPath);\n    const relativePath = normalized.startsWith(\"/\") ? normalized.slice(1) : normalized;\n    const realPath = path.join(this.mountBase, relativePath);\n    const resolved = path.resolve(realPath);\n\n    // Double-check containment (defense in depth)\n    if (!resolved.startsWith(this.mountBase + path.sep) && resolved !== this.mountBase) {\n      throw new Error(`Path traversal blocked: \"${virtualPath}\" escapes mount point`);\n    }\n\n    return resolved;\n  }\n\n  // Read operations\n  async readFile(filePath: string): Promise<Buffer> {\n    this.checkPermission(filePath, \"read\");\n    const realPath = this.resolveSafePath(filePath);\n    const content = await this.underlyingFs.promises.readFile(realPath);\n    return Buffer.from(content);\n  }\n\n  async readdir(dirPath: string): Promise<string[]> {\n    this.checkPermission(dirPath, \"read\");\n    const realPath = this.resolveSafePath(dirPath);\n    const entries = await this.underlyingFs.promises.readdir(realPath);\n    return entries.map(String);\n  }\n\n  async stat(filePath: string): Promise<FileStat> {\n    this.checkPermission(filePath, \"read\");\n    const realPath = this.resolveSafePath(filePath);\n    const stats = await this.underlyingFs.promises.stat(realPath);\n    return {\n      isFile: () => stats.isFile(),\n      isDirectory: () => stats.isDirectory(),\n      size: stats.size,\n      mtime: stats.mtime,\n    };\n  }\n\n  async exists(filePath: string): Promise<boolean> {\n    try {\n      this.checkPermission(filePath, \"read\");\n      const realPath = this.resolveSafePath(filePath);\n      await this.underlyingFs.promises.stat(realPath);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  // Write operations\n  async writeFile(filePath: string, data: Buffer | string): Promise<void> {\n    this.checkPermission(filePath, \"write\");\n    const realPath = this.resolveSafePath(filePath);\n    await this.underlyingFs.promises.writeFile(realPath, data);\n  }\n\n  async appendFile(filePath: string, data: Buffer | string): Promise<void> {\n    this.checkPermission(filePath, \"write\");\n    const realPath = this.resolveSafePath(filePath);\n    await this.underlyingFs.promises.appendFile(realPath, data);\n  }\n\n  async mkdir(dirPath: string, opts?: { recursive?: boolean }): Promise<void> {\n    this.checkPermission(dirPath, \"write\");\n    const realPath = this.resolveSafePath(dirPath);\n    await this.underlyingFs.promises.mkdir(realPath, opts);\n  }\n\n  async rm(filePath: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void> {\n    this.checkPermission(filePath, \"write\");\n    const realPath = this.resolveSafePath(filePath);\n    await this.underlyingFs.promises.rm(realPath, opts);\n  }\n\n  // Path utilities (no permission check needed)\n  resolve(...paths: string[]): string {\n    return path.resolve(\"/\", ...paths);\n  }\n\n  dirname(filePath: string): string {\n    return path.dirname(filePath);\n  }\n\n  basename(filePath: string): string {\n    return path.basename(filePath);\n  }\n\n  // Glob with permission filtering\n  async glob(pattern: string, opts?: { cwd?: string }): Promise<string[]> {\n    const cwd = opts?.cwd ?? \"/\";\n    this.checkPermission(cwd, \"read\");\n\n    const matches = await this.expandGlob(pattern, cwd);\n\n    // Filter out excluded paths\n    return matches.filter((p) => this.getPermission(p) !== \"excluded\").sort();\n  }\n\n  // Glob expansion (similar to memfs-adapter implementation)\n  private async expandGlob(pattern: string, cwd: string): Promise<string[]> {\n    // Handle brace expansion first\n    const patterns = this.expandBraces(pattern);\n    const allMatches: string[] = [];\n\n    for (const pat of patterns) {\n      const matches = await this.matchPattern(pat, cwd);\n      allMatches.push(...matches);\n    }\n\n    // Remove duplicates and sort\n    return [...new Set(allMatches)].sort();\n  }\n\n  private expandBraces(pattern: string): string[] {\n    const braceMatch = pattern.match(/\\{([^{}]+)\\}/);\n    if (!braceMatch) return [pattern];\n\n    const before = pattern.slice(0, braceMatch.index);\n    const after = pattern.slice(braceMatch.index! + braceMatch[0].length);\n    const options = braceMatch[1]!.split(\",\");\n\n    const results: string[] = [];\n    for (const opt of options) {\n      const expanded = this.expandBraces(before + opt + after);\n      results.push(...expanded);\n    }\n    return results;\n  }\n\n  private async matchPattern(pattern: string, cwd: string): Promise<string[]> {\n    const parts = pattern.split(\"/\").filter((p) => p !== \"\");\n    const isAbsolute = pattern.startsWith(\"/\");\n    const startDir = isAbsolute ? \"/\" : cwd;\n\n    return this.matchParts(parts, startDir);\n  }\n\n  private async matchParts(parts: string[], currentPath: string): Promise<string[]> {\n    if (parts.length === 0) {\n      return [currentPath];\n    }\n\n    const [part, ...rest] = parts;\n\n    // Handle ** (recursive glob)\n    if (part === \"**\") {\n      const results: string[] = [];\n\n      // Match current directory\n      const withoutStar = await this.matchParts(rest, currentPath);\n      results.push(...withoutStar);\n\n      // Recurse into subdirectories\n      try {\n        const realPath = this.resolveSafePath(currentPath);\n        const entries = await this.underlyingFs.promises.readdir(realPath);\n        for (const entry of entries) {\n          const entryPath = path.posix.join(currentPath, String(entry));\n          try {\n            const entryRealPath = this.resolveSafePath(entryPath);\n            const stat = await this.underlyingFs.promises.stat(entryRealPath);\n            if (stat.isDirectory()) {\n              const subMatches = await this.matchParts(parts, entryPath);\n              results.push(...subMatches);\n            }\n          } catch {\n            // Skip inaccessible entries\n          }\n        }\n      } catch {\n        // Directory not readable\n      }\n\n      return results;\n    }\n\n    // Handle regular glob patterns\n    const regex = this.globToRegex(part!);\n\n    try {\n      const realPath = this.resolveSafePath(currentPath);\n      const entries = await this.underlyingFs.promises.readdir(realPath);\n      const results: string[] = [];\n\n      for (const entry of entries) {\n        const entryName = String(entry);\n        if (regex.test(entryName)) {\n          const entryPath = path.posix.join(currentPath, entryName);\n          if (rest.length === 0) {\n            results.push(entryPath);\n          } else {\n            try {\n              const entryRealPath = this.resolveSafePath(entryPath);\n              const stat = await this.underlyingFs.promises.stat(entryRealPath);\n              if (stat.isDirectory()) {\n                const subMatches = await this.matchParts(rest, entryPath);\n                results.push(...subMatches);\n              }\n            } catch {\n              // Skip inaccessible entries\n            }\n          }\n        }\n      }\n\n      return results;\n    } catch {\n      return [];\n    }\n  }\n\n  private globToRegex(pattern: string): RegExp {\n    let regex = \"^\";\n    for (let i = 0; i < pattern.length; i++) {\n      const char = pattern[i]!;\n      if (char === \"*\") {\n        regex += \"[^/]*\";\n      } else if (char === \"?\") {\n        regex += \"[^/]\";\n      } else if (char === \"[\") {\n        // Character class\n        let j = i + 1;\n        let classContent = \"\";\n        while (j < pattern.length && pattern[j] !== \"]\") {\n          classContent += pattern[j];\n          j++;\n        }\n        regex += `[${classContent}]`;\n        i = j;\n      } else if (\".+^${}()|\\\\\".includes(char)) {\n        regex += \"\\\\\" + char;\n      } else {\n        regex += char;\n      }\n    }\n    regex += \"$\";\n    return new RegExp(regex);\n  }\n}\n"
+    "import * as path from \"path\";\nimport * as nodeFs from \"node:fs/promises\";\nimport type { VirtualFS, FileStat } from \"../types.cjs\";\n\nexport type Permission = \"read-write\" | \"read-only\" | \"excluded\";\nexport type PermissionRules = Record<string, Permission>;\n\n// Minimal interface for the underlying fs (compatible with node:fs and memfs)\nexport interface UnderlyingFS {\n  promises: {\n    readFile(path: string): Promise<Buffer | Uint8Array | string>;\n    readdir(path: string): Promise<string[]>;\n    stat(path: string): Promise<{\n      isFile(): boolean;\n      isDirectory(): boolean;\n      size: number;\n      mtime: Date;\n    }>;\n    writeFile(path: string, data: Buffer | string): Promise<void>;\n    appendFile(path: string, data: Buffer | string): Promise<void>;\n    mkdir(path: string, opts?: { recursive?: boolean }): Promise<string | undefined | void>;\n    rm(path: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void>;\n  };\n}\n\n// Default: use real node:fs\nconst defaultFS: UnderlyingFS = { promises: nodeFs };\n\ninterface CompiledRule {\n  pattern: string;\n  permission: Permission;\n  specificity: number;\n}\n\nexport class FileSystem implements VirtualFS {\n  private readonly mountBase: string | null;\n  private readonly rules: CompiledRule[];\n  protected readonly underlyingFs: UnderlyingFS;\n\n  constructor(mountPath?: string, permissions?: PermissionRules, fs?: UnderlyingFS) {\n    this.mountBase = mountPath ? path.resolve(mountPath) : null;\n    this.rules = this.compileRules(permissions ?? {});\n    this.underlyingFs = fs ?? defaultFS;\n  }\n\n  private compileRules(permissions: PermissionRules): CompiledRule[] {\n    return Object.entries(permissions)\n      .map(([pattern, permission]) => ({\n        pattern,\n        permission,\n        specificity: this.calculateSpecificity(pattern),\n      }))\n      .sort((a, b) => b.specificity - a.specificity); // highest first\n  }\n\n  private calculateSpecificity(pattern: string): number {\n    const segments = pattern.split(\"/\").filter(Boolean);\n    let score = segments.length * 1000; // segment count is primary\n\n    for (const seg of segments) {\n      if (seg === \"**\") score += 0;\n      else if (seg.includes(\"*\")) score += 1;\n      else score += 10; // literal segment\n    }\n    return score;\n  }\n\n  public getPermission(virtualPath: string): Permission {\n    const normalized = virtualPath.replace(/^\\/+/, \"\"); // strip leading slashes\n\n    for (const rule of this.rules) {\n      if (this.matchGlob(rule.pattern, normalized)) {\n        return rule.permission;\n      }\n    }\n    return \"read-write\"; // default\n  }\n\n  private matchGlob(pattern: string, filePath: string): boolean {\n    // Convert glob to regex\n    // ** matches any path segments, * matches within segment\n    const regex = pattern\n      .split(\"/\")\n      .map((seg) => {\n        if (seg === \"**\") return \".*\";\n        return seg.replace(/\\*/g, \"[^/]*\").replace(/\\?/g, \"[^/]\");\n      })\n      .join(\"/\");\n    return new RegExp(`^${regex}$`).test(filePath);\n  }\n\n  public checkPermission(virtualPath: string, operation: \"read\" | \"write\"): void {\n    const perm = this.getPermission(virtualPath);\n\n    if (perm === \"excluded\") {\n      throw new Error(`Access denied: \"${virtualPath}\" is excluded`);\n    }\n    if (operation === \"write\" && perm === \"read-only\") {\n      throw new Error(`Access denied: \"${virtualPath}\" is read-only`);\n    }\n  }\n\n  private resolveSafePath(virtualPath: string): string {\n    if (this.mountBase === null) {\n      return path.resolve(virtualPath);\n    }\n\n    // Check for path traversal by tracking depth\n    const segments = virtualPath.split(\"/\").filter(Boolean);\n    let depth = 0;\n    for (const seg of segments) {\n      if (seg === \"..\") {\n        depth--;\n        if (depth < 0) {\n          throw new Error(`Path traversal blocked: \"${virtualPath}\" escapes mount point`);\n        }\n      } else if (seg !== \".\") {\n        depth++;\n      }\n    }\n\n    const normalized = path.normalize(virtualPath);\n    const relativePath = normalized.startsWith(\"/\") ? normalized.slice(1) : normalized;\n    const realPath = path.join(this.mountBase, relativePath);\n    const resolved = path.resolve(realPath);\n\n    // Double-check containment (defense in depth)\n    if (!resolved.startsWith(this.mountBase + path.sep) && resolved !== this.mountBase) {\n      throw new Error(`Path traversal blocked: \"${virtualPath}\" escapes mount point`);\n    }\n\n    return resolved;\n  }\n\n  // Read operations\n  async readFile(filePath: string): Promise<Buffer>;\n  async readFile(filePath: string, encoding: BufferEncoding): Promise<string>;\n  async readFile(filePath: string, encoding?: BufferEncoding): Promise<Buffer | string> {\n    this.checkPermission(filePath, \"read\");\n    const realPath = this.resolveSafePath(filePath);\n    const content = await this.underlyingFs.promises.readFile(realPath);\n    const buf = Buffer.from(content);\n    return encoding ? buf.toString(encoding) : buf;\n  }\n\n  async readdir(dirPath: string): Promise<string[]> {\n    this.checkPermission(dirPath, \"read\");\n    const realPath = this.resolveSafePath(dirPath);\n    const entries = await this.underlyingFs.promises.readdir(realPath);\n    return entries.map(String);\n  }\n\n  async stat(filePath: string): Promise<FileStat> {\n    this.checkPermission(filePath, \"read\");\n    const realPath = this.resolveSafePath(filePath);\n    const stats = await this.underlyingFs.promises.stat(realPath);\n    return {\n      isFile: () => stats.isFile(),\n      isDirectory: () => stats.isDirectory(),\n      size: stats.size,\n      mtime: stats.mtime,\n    };\n  }\n\n  async exists(filePath: string): Promise<boolean> {\n    try {\n      this.checkPermission(filePath, \"read\");\n      const realPath = this.resolveSafePath(filePath);\n      await this.underlyingFs.promises.stat(realPath);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  // Write operations\n  async writeFile(filePath: string, data: Buffer | string): Promise<void> {\n    this.checkPermission(filePath, \"write\");\n    const realPath = this.resolveSafePath(filePath);\n    await this.underlyingFs.promises.writeFile(realPath, data);\n  }\n\n  async appendFile(filePath: string, data: Buffer | string): Promise<void> {\n    this.checkPermission(filePath, \"write\");\n    const realPath = this.resolveSafePath(filePath);\n    await this.underlyingFs.promises.appendFile(realPath, data);\n  }\n\n  async mkdir(dirPath: string, opts?: { recursive?: boolean }): Promise<void> {\n    this.checkPermission(dirPath, \"write\");\n    const realPath = this.resolveSafePath(dirPath);\n    await this.underlyingFs.promises.mkdir(realPath, opts);\n  }\n\n  async rm(filePath: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void> {\n    this.checkPermission(filePath, \"write\");\n    const realPath = this.resolveSafePath(filePath);\n    await this.underlyingFs.promises.rm(realPath, opts);\n  }\n\n  // Path utilities (no permission check needed)\n  resolve(...paths: string[]): string {\n    return path.resolve(\"/\", ...paths);\n  }\n\n  dirname(filePath: string): string {\n    return path.dirname(filePath);\n  }\n\n  basename(filePath: string): string {\n    return path.basename(filePath);\n  }\n\n  // Glob with permission filtering\n  async glob(pattern: string, opts?: { cwd?: string }): Promise<string[]> {\n    const cwd = opts?.cwd ?? \"/\";\n    this.checkPermission(cwd, \"read\");\n\n    const matches = await this.expandGlob(pattern, cwd);\n\n    // Filter out excluded paths\n    return matches.filter((p) => this.getPermission(p) !== \"excluded\").sort();\n  }\n\n  // Glob expansion (similar to memfs-adapter implementation)\n  private async expandGlob(pattern: string, cwd: string): Promise<string[]> {\n    // Handle brace expansion first\n    const patterns = this.expandBraces(pattern);\n    const allMatches: string[] = [];\n\n    for (const pat of patterns) {\n      const matches = await this.matchPattern(pat, cwd);\n      allMatches.push(...matches);\n    }\n\n    // Remove duplicates and sort\n    return [...new Set(allMatches)].sort();\n  }\n\n  private expandBraces(pattern: string): string[] {\n    const braceMatch = pattern.match(/\\{([^{}]+)\\}/);\n    if (!braceMatch) return [pattern];\n\n    const before = pattern.slice(0, braceMatch.index);\n    const after = pattern.slice(braceMatch.index! + braceMatch[0].length);\n    const options = braceMatch[1]!.split(\",\");\n\n    const results: string[] = [];\n    for (const opt of options) {\n      const expanded = this.expandBraces(before + opt + after);\n      results.push(...expanded);\n    }\n    return results;\n  }\n\n  private async matchPattern(pattern: string, cwd: string): Promise<string[]> {\n    const parts = pattern.split(\"/\").filter((p) => p !== \"\");\n    const isAbsolute = pattern.startsWith(\"/\");\n    const startDir = isAbsolute ? \"/\" : cwd;\n\n    return this.matchParts(parts, startDir);\n  }\n\n  private async matchParts(parts: string[], currentPath: string): Promise<string[]> {\n    if (parts.length === 0) {\n      return [currentPath];\n    }\n\n    const [part, ...rest] = parts;\n\n    // Handle ** (recursive glob)\n    if (part === \"**\") {\n      const results: string[] = [];\n\n      // Match current directory\n      const withoutStar = await this.matchParts(rest, currentPath);\n      results.push(...withoutStar);\n\n      // Recurse into subdirectories\n      try {\n        const realPath = this.resolveSafePath(currentPath);\n        const entries = await this.underlyingFs.promises.readdir(realPath);\n        for (const entry of entries) {\n          const entryPath = path.posix.join(currentPath, String(entry));\n          try {\n            const entryRealPath = this.resolveSafePath(entryPath);\n            const stat = await this.underlyingFs.promises.stat(entryRealPath);\n            if (stat.isDirectory()) {\n              const subMatches = await this.matchParts(parts, entryPath);\n              results.push(...subMatches);\n            }\n          } catch {\n            // Skip inaccessible entries\n          }\n        }\n      } catch {\n        // Directory not readable\n      }\n\n      return results;\n    }\n\n    // Handle regular glob patterns\n    const regex = this.globToRegex(part!);\n\n    try {\n      const realPath = this.resolveSafePath(currentPath);\n      const entries = await this.underlyingFs.promises.readdir(realPath);\n      const results: string[] = [];\n\n      for (const entry of entries) {\n        const entryName = String(entry);\n        if (regex.test(entryName)) {\n          const entryPath = path.posix.join(currentPath, entryName);\n          if (rest.length === 0) {\n            results.push(entryPath);\n          } else {\n            try {\n              const entryRealPath = this.resolveSafePath(entryPath);\n              const stat = await this.underlyingFs.promises.stat(entryRealPath);\n              if (stat.isDirectory()) {\n                const subMatches = await this.matchParts(rest, entryPath);\n                results.push(...subMatches);\n              }\n            } catch {\n              // Skip inaccessible entries\n            }\n          }\n        }\n      }\n\n      return results;\n    } catch {\n      return [];\n    }\n  }\n\n  private globToRegex(pattern: string): RegExp {\n    let regex = \"^\";\n    for (let i = 0; i < pattern.length; i++) {\n      const char = pattern[i]!;\n      if (char === \"*\") {\n        regex += \"[^/]*\";\n      } else if (char === \"?\") {\n        regex += \"[^/]\";\n      } else if (char === \"[\") {\n        // Character class\n        let j = i + 1;\n        let classContent = \"\";\n        while (j < pattern.length && pattern[j] !== \"]\") {\n          classContent += pattern[j];\n          j++;\n        }\n        regex += `[${classContent}]`;\n        i = j;\n      } else if (\".+^${}()|\\\\\".includes(char)) {\n        regex += \"\\\\\" + char;\n      } else {\n        regex += char;\n      }\n    }\n    regex += \"$\";\n    return new RegExp(regex);\n  }\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "FE5125D36453662C64756E2164756E21",
+  "mappings": "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",
+  "debugId": "891ABFB98712125464756E2164756E21",
   "names": []
 }

package/dist/cjs/src/types.cjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../src/types.ts"],
   "sourcesContent": [
-    "// Virtual Filesystem Interface\nexport interface VirtualFS {\n  readFile(path: string): Promise<Buffer>;\n  readdir(path: string): Promise<string[]>;\n  stat(path: string): Promise<FileStat>;\n  exists(path: string): Promise<boolean>;\n\n  writeFile(path: string, data: Buffer | string): Promise<void>;\n  appendFile(path: string, data: Buffer | string): Promise<void>;\n  mkdir(path: string, opts?: { recursive?: boolean }): Promise<void>;\n\n  rm(path: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void>;\n\n  resolve(...paths: string[]): string;\n  dirname(path: string): string;\n  basename(path: string): string;\n  glob(pattern: string, opts?: { cwd?: string }): Promise<string[]>;\n}\n\nexport interface FileStat {\n  isFile(): boolean;\n  isDirectory(): boolean;\n  size: number;\n  mtime: Date;\n}\n\n// Command Interfaces\nexport type Command = (ctx: CommandContext) => Promise<number>;\n\nexport interface CommandContext {\n  args: string[];\n  stdin: Stdin;\n  stdout: Stdout;\n  stderr: Stderr;\n  fs: VirtualFS;\n  cwd: string;\n  env: Record<string, string>;\n  setCwd: (path: string) => void;\n  exec?: (name: string, args: string[]) => Promise<ExecResult>;\n}\n\nexport interface Stdin {\n  stream(): AsyncIterable<Uint8Array>;\n  buffer(): Promise<Buffer>;\n  text(): Promise<string>;\n  lines(): AsyncIterable<string>;\n}\n\nexport interface Stdout {\n  write(chunk: Uint8Array): Promise<void>;\n  writeText(str: string): Promise<void>;\n  isTTY: boolean;\n}\n\nexport interface Stderr {\n  write(chunk: Uint8Array): Promise<void>;\n  writeText(str: string): Promise<void>;\n  isTTY: boolean;\n}\n\nexport interface OutputCollector extends Stdout {\n  close(): void;\n  collect(): Promise<Buffer>;\n  getReadableStream(): AsyncIterable<Uint8Array>;\n}\n\n// Execution Result\nexport interface ExecResult {\n  stdout: Buffer;\n  stderr: Buffer;\n  exitCode: number;\n}\n\n// Shell Configuration\nexport interface ShellConfig {\n  fs: VirtualFS;\n  cwd: string;\n  env: Record<string, string>;\n  commands: Record<string, Command>;\n  isTTY?: boolean;\n}\n\n// Raw escape hatch type\nexport interface RawValue {\n  raw: string;\n}\n\nexport function isRawValue(value: unknown): value is RawValue {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"raw\" in value &&\n    typeof (value as RawValue).raw === \"string\"\n  );\n}\n\n// JS Object Redirection types\nexport type RedirectObject = Buffer | Blob | Response | string;\n\nexport interface RedirectObjectMap {\n  [marker: string]: RedirectObject;\n}\n\nexport function isRedirectObject(value: unknown): value is RedirectObject {\n  return (\n    Buffer.isBuffer(value) ||\n    value instanceof Blob ||\n    value instanceof Response ||\n    typeof value === \"string\"\n  );\n}\n"
+    "// Virtual Filesystem Interface\nexport interface VirtualFS {\n  readFile(path: string): Promise<Buffer>;\n  readFile(path: string, encoding: BufferEncoding): Promise<string>;\n  readdir(path: string): Promise<string[]>;\n  stat(path: string): Promise<FileStat>;\n  exists(path: string): Promise<boolean>;\n\n  writeFile(path: string, data: Buffer | string): Promise<void>;\n  appendFile(path: string, data: Buffer | string): Promise<void>;\n  mkdir(path: string, opts?: { recursive?: boolean }): Promise<void>;\n\n  rm(path: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void>;\n\n  resolve(...paths: string[]): string;\n  dirname(path: string): string;\n  basename(path: string): string;\n  glob(pattern: string, opts?: { cwd?: string }): Promise<string[]>;\n}\n\nexport interface FileStat {\n  isFile(): boolean;\n  isDirectory(): boolean;\n  size: number;\n  mtime: Date;\n}\n\n// Command Interfaces\nexport type Command = (ctx: CommandContext) => Promise<number>;\n\nexport interface CommandContext {\n  args: string[];\n  stdin: Stdin;\n  stdout: Stdout;\n  stderr: Stderr;\n  fs: VirtualFS;\n  cwd: string;\n  env: Record<string, string>;\n  setCwd: (path: string) => void;\n  exec?: (name: string, args: string[]) => Promise<ExecResult>;\n}\n\nexport interface Stdin {\n  stream(): AsyncIterable<Uint8Array>;\n  buffer(): Promise<Buffer>;\n  text(): Promise<string>;\n  lines(): AsyncIterable<string>;\n}\n\nexport interface Stdout {\n  write(chunk: Uint8Array): Promise<void>;\n  writeText(str: string): Promise<void>;\n  isTTY: boolean;\n}\n\nexport interface Stderr {\n  write(chunk: Uint8Array): Promise<void>;\n  writeText(str: string): Promise<void>;\n  isTTY: boolean;\n}\n\nexport interface OutputCollector extends Stdout {\n  close(): void;\n  collect(): Promise<Buffer>;\n  getReadableStream(): AsyncIterable<Uint8Array>;\n}\n\n// Execution Result\nexport interface ExecResult {\n  stdout: Buffer;\n  stderr: Buffer;\n  exitCode: number;\n}\n\n// Shell Configuration\nexport interface ShellConfig {\n  fs: VirtualFS;\n  cwd: string;\n  env: Record<string, string>;\n  commands: Record<string, Command>;\n  isTTY?: boolean;\n}\n\n// Raw escape hatch type\nexport interface RawValue {\n  raw: string;\n}\n\nexport function isRawValue(value: unknown): value is RawValue {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"raw\" in value &&\n    typeof (value as RawValue).raw === \"string\"\n  );\n}\n\n// JS Object Redirection types\nexport type RedirectObject = Buffer | Blob | Response | string;\n\nexport interface RedirectObjectMap {\n  [marker: string]: RedirectObject;\n}\n\nexport function isRedirectObject(value: unknown): value is RedirectObject {\n  return (\n    Buffer.isBuffer(value) ||\n    value instanceof Blob ||\n    value instanceof Response ||\n    typeof value === \"string\"\n  );\n}\n"
   ],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuFO,SAAS,UAAU,CAAC,OAAmC;AAAA,EAC5D,OACE,OAAO,UAAU,YACjB,UAAU,QACV,SAAS,SACT,OAAQ,MAAmB,QAAQ;AAAA;AAWhC,SAAS,gBAAgB,CAAC,OAAyC;AAAA,EACxE,OACE,OAAO,SAAS,KAAK,KACrB,iBAAiB,QACjB,iBAAiB,YACjB,OAAO,UAAU;AAAA;",
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwFO,SAAS,UAAU,CAAC,OAAmC;AAAA,EAC5D,OACE,OAAO,UAAU,YACjB,UAAU,QACV,SAAS,SACT,OAAQ,MAAmB,QAAQ;AAAA;AAWhC,SAAS,gBAAgB,CAAC,OAAyC;AAAA,EACxE,OACE,OAAO,SAAS,KAAK,KACrB,iBAAiB,QACjB,iBAAiB,YACjB,OAAO,UAAU;AAAA;",
   "debugId": "A099C0F37A42BA3264756E2164756E21",
   "names": []
 }

package/dist/mjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "shell-dsl",
-  "version": "0.0.24",
+  "version": "0.0.25",
   "type": "module"
 }

package/dist/mjs/src/fs/memfs-adapter.mjs

@@ -3,11 +3,12 @@ import * as pathModule from "path";
 function createVirtualFS(memfs) {
   const { promises: fs } = memfs;
   return {
-    async readFile(path) {
+    readFile: async (path, encoding) => {
       if (path === "/dev/null")
-        return Buffer.alloc(0);
+        return encoding ? "" : Buffer.alloc(0);
       const content = await fs.readFile(path);
-      return Buffer.from(content);
+      const buf = Buffer.from(content);
+      return encoding ? buf.toString(encoding) : buf;
     },
     async readdir(path) {
       const entries = await fs.readdir(path);
@@ -177,4 +178,4 @@ export {
   createVirtualFS
 };
 
-//# debugId=FECADF24168DA75064756E2164756E21
+//# debugId=12701BFA42EE2D4964756E2164756E21

package/dist/mjs/src/fs/memfs-adapter.mjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../../src/fs/memfs-adapter.ts"],
   "sourcesContent": [
-    "import type { IFs } from \"memfs\";\nimport type { VirtualFS, FileStat } from \"../types.mjs\";\nimport * as pathModule from \"path\";\n\nexport function createVirtualFS(memfs: IFs): VirtualFS {\n  const { promises: fs } = memfs;\n\n  return {\n    async readFile(path: string): Promise<Buffer> {\n      if (path === \"/dev/null\") return Buffer.alloc(0);\n      const content = await fs.readFile(path);\n      return Buffer.from(content);\n    },\n\n    async readdir(path: string): Promise<string[]> {\n      const entries = await fs.readdir(path);\n      return entries.map(String);\n    },\n\n    async stat(path: string): Promise<FileStat> {\n      const stats = await fs.stat(path);\n      return {\n        isFile: () => stats.isFile(),\n        isDirectory: () => stats.isDirectory(),\n        size: Number(stats.size),\n        mtime: new Date(stats.mtime),\n      };\n    },\n\n    async exists(path: string): Promise<boolean> {\n      try {\n        await fs.stat(path);\n        return true;\n      } catch {\n        return false;\n      }\n    },\n\n    async writeFile(path: string, data: Buffer | string): Promise<void> {\n      await fs.writeFile(path, data);\n    },\n\n    async appendFile(path: string, data: Buffer | string): Promise<void> {\n      await fs.appendFile(path, data);\n    },\n\n    async mkdir(path: string, opts?: { recursive?: boolean }): Promise<void> {\n      await fs.mkdir(path, opts);\n    },\n\n    async rm(path: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void> {\n      try {\n        const stats = await fs.stat(path);\n        if (stats.isDirectory()) {\n          await fs.rmdir(path, { recursive: opts?.recursive });\n        } else {\n          await fs.unlink(path);\n        }\n      } catch (err) {\n        if (!opts?.force) throw err;\n      }\n    },\n\n    resolve(...paths: string[]): string {\n      return pathModule.resolve(...paths);\n    },\n\n    dirname(path: string): string {\n      return pathModule.dirname(path);\n    },\n\n    basename(path: string): string {\n      return pathModule.basename(path);\n    },\n\n    async glob(pattern: string, opts?: { cwd?: string }): Promise<string[]> {\n      const cwd = opts?.cwd ?? \"/\";\n      return expandGlob(memfs, pattern, cwd);\n    },\n  };\n}\n\nasync function expandGlob(memfs: IFs, pattern: string, cwd: string): Promise<string[]> {\n  const { promises: fs } = memfs;\n\n  // Handle brace expansion first\n  const patterns = expandBraces(pattern);\n  const allMatches: string[] = [];\n\n  for (const pat of patterns) {\n    const matches = await matchPattern(fs, pat, cwd);\n    allMatches.push(...matches);\n  }\n\n  // Remove duplicates and sort\n  return [...new Set(allMatches)].sort();\n}\n\nfunction expandBraces(pattern: string): string[] {\n  const braceMatch = pattern.match(/\\{([^{}]+)\\}/);\n  if (!braceMatch) return [pattern];\n\n  const before = pattern.slice(0, braceMatch.index);\n  const after = pattern.slice(braceMatch.index! + braceMatch[0].length);\n  const options = braceMatch[1]!.split(\",\");\n\n  const results: string[] = [];\n  for (const opt of options) {\n    const expanded = expandBraces(before + opt + after);\n    results.push(...expanded);\n  }\n  return results;\n}\n\nasync function matchPattern(\n  fs: IFs[\"promises\"],\n  pattern: string,\n  cwd: string\n): Promise<string[]> {\n  const parts = pattern.split(\"/\").filter((p) => p !== \"\");\n  const isAbsolute = pattern.startsWith(\"/\");\n  const startDir = isAbsolute ? \"/\" : cwd;\n\n  return matchParts(fs, parts, startDir, isAbsolute);\n}\n\nasync function matchParts(\n  fs: IFs[\"promises\"],\n  parts: string[],\n  currentPath: string,\n  isAbsolute: boolean\n): Promise<string[]> {\n  if (parts.length === 0) {\n    return [currentPath];\n  }\n\n  const [part, ...rest] = parts;\n\n  // Handle ** (recursive glob)\n  if (part === \"**\") {\n    const results: string[] = [];\n\n    // Match current directory\n    const withoutStar = await matchParts(fs, rest, currentPath, isAbsolute);\n    results.push(...withoutStar);\n\n    // Recurse into subdirectories\n    try {\n      const entries = await fs.readdir(currentPath);\n      for (const entry of entries) {\n        const entryPath = pathModule.join(currentPath, String(entry));\n        try {\n          const stat = await fs.stat(entryPath);\n          if (stat.isDirectory()) {\n            const subMatches = await matchParts(fs, parts, entryPath, isAbsolute);\n            results.push(...subMatches);\n          }\n        } catch {\n          // Skip inaccessible entries\n        }\n      }\n    } catch {\n      // Directory not readable\n    }\n\n    return results;\n  }\n\n  // Handle regular glob patterns\n  const regex = globToRegex(part!);\n\n  try {\n    const entries = await fs.readdir(currentPath);\n    const results: string[] = [];\n\n    for (const entry of entries) {\n      const entryName = String(entry);\n      if (regex.test(entryName)) {\n        const entryPath = pathModule.join(currentPath, entryName);\n        if (rest.length === 0) {\n          results.push(entryPath);\n        } else {\n          try {\n            const stat = await fs.stat(entryPath);\n            if (stat.isDirectory()) {\n              const subMatches = await matchParts(fs, rest, entryPath, isAbsolute);\n              results.push(...subMatches);\n            }\n          } catch {\n            // Skip inaccessible entries\n          }\n        }\n      }\n    }\n\n    return results;\n  } catch {\n    return [];\n  }\n}\n\nfunction globToRegex(pattern: string): RegExp {\n  let regex = \"^\";\n  for (let i = 0; i < pattern.length; i++) {\n    const char = pattern[i]!;\n    if (char === \"*\") {\n      regex += \"[^/]*\";\n    } else if (char === \"?\") {\n      regex += \"[^/]\";\n    } else if (char === \"[\") {\n      // Character class\n      let j = i + 1;\n      let classContent = \"\";\n      while (j < pattern.length && pattern[j] !== \"]\") {\n        classContent += pattern[j];\n        j++;\n      }\n      regex += `[${classContent}]`;\n      i = j;\n    } else if (\".+^${}()|\\\\\".includes(char)) {\n      regex += \"\\\\\" + char;\n    } else {\n      regex += char;\n    }\n  }\n  regex += \"$\";\n  return new RegExp(regex);\n}\n"
+    "import type { IFs } from \"memfs\";\nimport type { VirtualFS, FileStat } from \"../types.mjs\";\nimport * as pathModule from \"path\";\n\nexport function createVirtualFS(memfs: IFs): VirtualFS {\n  const { promises: fs } = memfs;\n\n  return {\n    readFile: (async (path: string, encoding?: BufferEncoding): Promise<Buffer | string> => {\n      if (path === \"/dev/null\") return encoding ? \"\" : Buffer.alloc(0);\n      const content = await fs.readFile(path);\n      const buf = Buffer.from(content);\n      return encoding ? buf.toString(encoding) : buf;\n    }) as VirtualFS[\"readFile\"],\n\n    async readdir(path: string): Promise<string[]> {\n      const entries = await fs.readdir(path);\n      return entries.map(String);\n    },\n\n    async stat(path: string): Promise<FileStat> {\n      const stats = await fs.stat(path);\n      return {\n        isFile: () => stats.isFile(),\n        isDirectory: () => stats.isDirectory(),\n        size: Number(stats.size),\n        mtime: new Date(stats.mtime),\n      };\n    },\n\n    async exists(path: string): Promise<boolean> {\n      try {\n        await fs.stat(path);\n        return true;\n      } catch {\n        return false;\n      }\n    },\n\n    async writeFile(path: string, data: Buffer | string): Promise<void> {\n      await fs.writeFile(path, data);\n    },\n\n    async appendFile(path: string, data: Buffer | string): Promise<void> {\n      await fs.appendFile(path, data);\n    },\n\n    async mkdir(path: string, opts?: { recursive?: boolean }): Promise<void> {\n      await fs.mkdir(path, opts);\n    },\n\n    async rm(path: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void> {\n      try {\n        const stats = await fs.stat(path);\n        if (stats.isDirectory()) {\n          await fs.rmdir(path, { recursive: opts?.recursive });\n        } else {\n          await fs.unlink(path);\n        }\n      } catch (err) {\n        if (!opts?.force) throw err;\n      }\n    },\n\n    resolve(...paths: string[]): string {\n      return pathModule.resolve(...paths);\n    },\n\n    dirname(path: string): string {\n      return pathModule.dirname(path);\n    },\n\n    basename(path: string): string {\n      return pathModule.basename(path);\n    },\n\n    async glob(pattern: string, opts?: { cwd?: string }): Promise<string[]> {\n      const cwd = opts?.cwd ?? \"/\";\n      return expandGlob(memfs, pattern, cwd);\n    },\n  };\n}\n\nasync function expandGlob(memfs: IFs, pattern: string, cwd: string): Promise<string[]> {\n  const { promises: fs } = memfs;\n\n  // Handle brace expansion first\n  const patterns = expandBraces(pattern);\n  const allMatches: string[] = [];\n\n  for (const pat of patterns) {\n    const matches = await matchPattern(fs, pat, cwd);\n    allMatches.push(...matches);\n  }\n\n  // Remove duplicates and sort\n  return [...new Set(allMatches)].sort();\n}\n\nfunction expandBraces(pattern: string): string[] {\n  const braceMatch = pattern.match(/\\{([^{}]+)\\}/);\n  if (!braceMatch) return [pattern];\n\n  const before = pattern.slice(0, braceMatch.index);\n  const after = pattern.slice(braceMatch.index! + braceMatch[0].length);\n  const options = braceMatch[1]!.split(\",\");\n\n  const results: string[] = [];\n  for (const opt of options) {\n    const expanded = expandBraces(before + opt + after);\n    results.push(...expanded);\n  }\n  return results;\n}\n\nasync function matchPattern(\n  fs: IFs[\"promises\"],\n  pattern: string,\n  cwd: string\n): Promise<string[]> {\n  const parts = pattern.split(\"/\").filter((p) => p !== \"\");\n  const isAbsolute = pattern.startsWith(\"/\");\n  const startDir = isAbsolute ? \"/\" : cwd;\n\n  return matchParts(fs, parts, startDir, isAbsolute);\n}\n\nasync function matchParts(\n  fs: IFs[\"promises\"],\n  parts: string[],\n  currentPath: string,\n  isAbsolute: boolean\n): Promise<string[]> {\n  if (parts.length === 0) {\n    return [currentPath];\n  }\n\n  const [part, ...rest] = parts;\n\n  // Handle ** (recursive glob)\n  if (part === \"**\") {\n    const results: string[] = [];\n\n    // Match current directory\n    const withoutStar = await matchParts(fs, rest, currentPath, isAbsolute);\n    results.push(...withoutStar);\n\n    // Recurse into subdirectories\n    try {\n      const entries = await fs.readdir(currentPath);\n      for (const entry of entries) {\n        const entryPath = pathModule.join(currentPath, String(entry));\n        try {\n          const stat = await fs.stat(entryPath);\n          if (stat.isDirectory()) {\n            const subMatches = await matchParts(fs, parts, entryPath, isAbsolute);\n            results.push(...subMatches);\n          }\n        } catch {\n          // Skip inaccessible entries\n        }\n      }\n    } catch {\n      // Directory not readable\n    }\n\n    return results;\n  }\n\n  // Handle regular glob patterns\n  const regex = globToRegex(part!);\n\n  try {\n    const entries = await fs.readdir(currentPath);\n    const results: string[] = [];\n\n    for (const entry of entries) {\n      const entryName = String(entry);\n      if (regex.test(entryName)) {\n        const entryPath = pathModule.join(currentPath, entryName);\n        if (rest.length === 0) {\n          results.push(entryPath);\n        } else {\n          try {\n            const stat = await fs.stat(entryPath);\n            if (stat.isDirectory()) {\n              const subMatches = await matchParts(fs, rest, entryPath, isAbsolute);\n              results.push(...subMatches);\n            }\n          } catch {\n            // Skip inaccessible entries\n          }\n        }\n      }\n    }\n\n    return results;\n  } catch {\n    return [];\n  }\n}\n\nfunction globToRegex(pattern: string): RegExp {\n  let regex = \"^\";\n  for (let i = 0; i < pattern.length; i++) {\n    const char = pattern[i]!;\n    if (char === \"*\") {\n      regex += \"[^/]*\";\n    } else if (char === \"?\") {\n      regex += \"[^/]\";\n    } else if (char === \"[\") {\n      // Character class\n      let j = i + 1;\n      let classContent = \"\";\n      while (j < pattern.length && pattern[j] !== \"]\") {\n        classContent += pattern[j];\n        j++;\n      }\n      regex += `[${classContent}]`;\n      i = j;\n    } else if (\".+^${}()|\\\\\".includes(char)) {\n      regex += \"\\\\\" + char;\n    } else {\n      regex += char;\n    }\n  }\n  regex += \"$\";\n  return new RegExp(regex);\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "FECADF24168DA75064756E2164756E21",
+  "mappings": "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",
+  "debugId": "12701BFA42EE2D4964756E2164756E21",
   "names": []
 }

package/dist/mjs/src/fs/real-fs.mjs

@@ -83,11 +83,12 @@ class FileSystem {
     }
     return resolved;
   }
-  async readFile(filePath) {
+  async readFile(filePath, encoding) {
     this.checkPermission(filePath, "read");
     const realPath = this.resolveSafePath(filePath);
     const content = await this.underlyingFs.promises.readFile(realPath);
-    return Buffer.from(content);
+    const buf = Buffer.from(content);
+    return encoding ? buf.toString(encoding) : buf;
   }
   async readdir(dirPath) {
     this.checkPermission(dirPath, "read");
@@ -265,4 +266,4 @@ export {
   FileSystem
 };
 
-//# debugId=78CB3041E0AD3DDE64756E2164756E21
+//# debugId=48B583F651B4E85F64756E2164756E21

package/dist/mjs/src/fs/real-fs.mjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../../src/fs/real-fs.ts"],
   "sourcesContent": [
-    "import * as path from \"path\";\nimport * as nodeFs from \"node:fs/promises\";\nimport type { VirtualFS, FileStat } from \"../types.mjs\";\n\nexport type Permission = \"read-write\" | \"read-only\" | \"excluded\";\nexport type PermissionRules = Record<string, Permission>;\n\n// Minimal interface for the underlying fs (compatible with node:fs and memfs)\nexport interface UnderlyingFS {\n  promises: {\n    readFile(path: string): Promise<Buffer | Uint8Array | string>;\n    readdir(path: string): Promise<string[]>;\n    stat(path: string): Promise<{\n      isFile(): boolean;\n      isDirectory(): boolean;\n      size: number;\n      mtime: Date;\n    }>;\n    writeFile(path: string, data: Buffer | string): Promise<void>;\n    appendFile(path: string, data: Buffer | string): Promise<void>;\n    mkdir(path: string, opts?: { recursive?: boolean }): Promise<string | undefined | void>;\n    rm(path: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void>;\n  };\n}\n\n// Default: use real node:fs\nconst defaultFS: UnderlyingFS = { promises: nodeFs };\n\ninterface CompiledRule {\n  pattern: string;\n  permission: Permission;\n  specificity: number;\n}\n\nexport class FileSystem implements VirtualFS {\n  private readonly mountBase: string | null;\n  private readonly rules: CompiledRule[];\n  protected readonly underlyingFs: UnderlyingFS;\n\n  constructor(mountPath?: string, permissions?: PermissionRules, fs?: UnderlyingFS) {\n    this.mountBase = mountPath ? path.resolve(mountPath) : null;\n    this.rules = this.compileRules(permissions ?? {});\n    this.underlyingFs = fs ?? defaultFS;\n  }\n\n  private compileRules(permissions: PermissionRules): CompiledRule[] {\n    return Object.entries(permissions)\n      .map(([pattern, permission]) => ({\n        pattern,\n        permission,\n        specificity: this.calculateSpecificity(pattern),\n      }))\n      .sort((a, b) => b.specificity - a.specificity); // highest first\n  }\n\n  private calculateSpecificity(pattern: string): number {\n    const segments = pattern.split(\"/\").filter(Boolean);\n    let score = segments.length * 1000; // segment count is primary\n\n    for (const seg of segments) {\n      if (seg === \"**\") score += 0;\n      else if (seg.includes(\"*\")) score += 1;\n      else score += 10; // literal segment\n    }\n    return score;\n  }\n\n  public getPermission(virtualPath: string): Permission {\n    const normalized = virtualPath.replace(/^\\/+/, \"\"); // strip leading slashes\n\n    for (const rule of this.rules) {\n      if (this.matchGlob(rule.pattern, normalized)) {\n        return rule.permission;\n      }\n    }\n    return \"read-write\"; // default\n  }\n\n  private matchGlob(pattern: string, filePath: string): boolean {\n    // Convert glob to regex\n    // ** matches any path segments, * matches within segment\n    const regex = pattern\n      .split(\"/\")\n      .map((seg) => {\n        if (seg === \"**\") return \".*\";\n        return seg.replace(/\\*/g, \"[^/]*\").replace(/\\?/g, \"[^/]\");\n      })\n      .join(\"/\");\n    return new RegExp(`^${regex}$`).test(filePath);\n  }\n\n  public checkPermission(virtualPath: string, operation: \"read\" | \"write\"): void {\n    const perm = this.getPermission(virtualPath);\n\n    if (perm === \"excluded\") {\n      throw new Error(`Access denied: \"${virtualPath}\" is excluded`);\n    }\n    if (operation === \"write\" && perm === \"read-only\") {\n      throw new Error(`Access denied: \"${virtualPath}\" is read-only`);\n    }\n  }\n\n  private resolveSafePath(virtualPath: string): string {\n    if (this.mountBase === null) {\n      return path.resolve(virtualPath);\n    }\n\n    // Check for path traversal by tracking depth\n    const segments = virtualPath.split(\"/\").filter(Boolean);\n    let depth = 0;\n    for (const seg of segments) {\n      if (seg === \"..\") {\n        depth--;\n        if (depth < 0) {\n          throw new Error(`Path traversal blocked: \"${virtualPath}\" escapes mount point`);\n        }\n      } else if (seg !== \".\") {\n        depth++;\n      }\n    }\n\n    const normalized = path.normalize(virtualPath);\n    const relativePath = normalized.startsWith(\"/\") ? normalized.slice(1) : normalized;\n    const realPath = path.join(this.mountBase, relativePath);\n    const resolved = path.resolve(realPath);\n\n    // Double-check containment (defense in depth)\n    if (!resolved.startsWith(this.mountBase + path.sep) && resolved !== this.mountBase) {\n      throw new Error(`Path traversal blocked: \"${virtualPath}\" escapes mount point`);\n    }\n\n    return resolved;\n  }\n\n  // Read operations\n  async readFile(filePath: string): Promise<Buffer> {\n    this.checkPermission(filePath, \"read\");\n    const realPath = this.resolveSafePath(filePath);\n    const content = await this.underlyingFs.promises.readFile(realPath);\n    return Buffer.from(content);\n  }\n\n  async readdir(dirPath: string): Promise<string[]> {\n    this.checkPermission(dirPath, \"read\");\n    const realPath = this.resolveSafePath(dirPath);\n    const entries = await this.underlyingFs.promises.readdir(realPath);\n    return entries.map(String);\n  }\n\n  async stat(filePath: string): Promise<FileStat> {\n    this.checkPermission(filePath, \"read\");\n    const realPath = this.resolveSafePath(filePath);\n    const stats = await this.underlyingFs.promises.stat(realPath);\n    return {\n      isFile: () => stats.isFile(),\n      isDirectory: () => stats.isDirectory(),\n      size: stats.size,\n      mtime: stats.mtime,\n    };\n  }\n\n  async exists(filePath: string): Promise<boolean> {\n    try {\n      this.checkPermission(filePath, \"read\");\n      const realPath = this.resolveSafePath(filePath);\n      await this.underlyingFs.promises.stat(realPath);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  // Write operations\n  async writeFile(filePath: string, data: Buffer | string): Promise<void> {\n    this.checkPermission(filePath, \"write\");\n    const realPath = this.resolveSafePath(filePath);\n    await this.underlyingFs.promises.writeFile(realPath, data);\n  }\n\n  async appendFile(filePath: string, data: Buffer | string): Promise<void> {\n    this.checkPermission(filePath, \"write\");\n    const realPath = this.resolveSafePath(filePath);\n    await this.underlyingFs.promises.appendFile(realPath, data);\n  }\n\n  async mkdir(dirPath: string, opts?: { recursive?: boolean }): Promise<void> {\n    this.checkPermission(dirPath, \"write\");\n    const realPath = this.resolveSafePath(dirPath);\n    await this.underlyingFs.promises.mkdir(realPath, opts);\n  }\n\n  async rm(filePath: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void> {\n    this.checkPermission(filePath, \"write\");\n    const realPath = this.resolveSafePath(filePath);\n    await this.underlyingFs.promises.rm(realPath, opts);\n  }\n\n  // Path utilities (no permission check needed)\n  resolve(...paths: string[]): string {\n    return path.resolve(\"/\", ...paths);\n  }\n\n  dirname(filePath: string): string {\n    return path.dirname(filePath);\n  }\n\n  basename(filePath: string): string {\n    return path.basename(filePath);\n  }\n\n  // Glob with permission filtering\n  async glob(pattern: string, opts?: { cwd?: string }): Promise<string[]> {\n    const cwd = opts?.cwd ?? \"/\";\n    this.checkPermission(cwd, \"read\");\n\n    const matches = await this.expandGlob(pattern, cwd);\n\n    // Filter out excluded paths\n    return matches.filter((p) => this.getPermission(p) !== \"excluded\").sort();\n  }\n\n  // Glob expansion (similar to memfs-adapter implementation)\n  private async expandGlob(pattern: string, cwd: string): Promise<string[]> {\n    // Handle brace expansion first\n    const patterns = this.expandBraces(pattern);\n    const allMatches: string[] = [];\n\n    for (const pat of patterns) {\n      const matches = await this.matchPattern(pat, cwd);\n      allMatches.push(...matches);\n    }\n\n    // Remove duplicates and sort\n    return [...new Set(allMatches)].sort();\n  }\n\n  private expandBraces(pattern: string): string[] {\n    const braceMatch = pattern.match(/\\{([^{}]+)\\}/);\n    if (!braceMatch) return [pattern];\n\n    const before = pattern.slice(0, braceMatch.index);\n    const after = pattern.slice(braceMatch.index! + braceMatch[0].length);\n    const options = braceMatch[1]!.split(\",\");\n\n    const results: string[] = [];\n    for (const opt of options) {\n      const expanded = this.expandBraces(before + opt + after);\n      results.push(...expanded);\n    }\n    return results;\n  }\n\n  private async matchPattern(pattern: string, cwd: string): Promise<string[]> {\n    const parts = pattern.split(\"/\").filter((p) => p !== \"\");\n    const isAbsolute = pattern.startsWith(\"/\");\n    const startDir = isAbsolute ? \"/\" : cwd;\n\n    return this.matchParts(parts, startDir);\n  }\n\n  private async matchParts(parts: string[], currentPath: string): Promise<string[]> {\n    if (parts.length === 0) {\n      return [currentPath];\n    }\n\n    const [part, ...rest] = parts;\n\n    // Handle ** (recursive glob)\n    if (part === \"**\") {\n      const results: string[] = [];\n\n      // Match current directory\n      const withoutStar = await this.matchParts(rest, currentPath);\n      results.push(...withoutStar);\n\n      // Recurse into subdirectories\n      try {\n        const realPath = this.resolveSafePath(currentPath);\n        const entries = await this.underlyingFs.promises.readdir(realPath);\n        for (const entry of entries) {\n          const entryPath = path.posix.join(currentPath, String(entry));\n          try {\n            const entryRealPath = this.resolveSafePath(entryPath);\n            const stat = await this.underlyingFs.promises.stat(entryRealPath);\n            if (stat.isDirectory()) {\n              const subMatches = await this.matchParts(parts, entryPath);\n              results.push(...subMatches);\n            }\n          } catch {\n            // Skip inaccessible entries\n          }\n        }\n      } catch {\n        // Directory not readable\n      }\n\n      return results;\n    }\n\n    // Handle regular glob patterns\n    const regex = this.globToRegex(part!);\n\n    try {\n      const realPath = this.resolveSafePath(currentPath);\n      const entries = await this.underlyingFs.promises.readdir(realPath);\n      const results: string[] = [];\n\n      for (const entry of entries) {\n        const entryName = String(entry);\n        if (regex.test(entryName)) {\n          const entryPath = path.posix.join(currentPath, entryName);\n          if (rest.length === 0) {\n            results.push(entryPath);\n          } else {\n            try {\n              const entryRealPath = this.resolveSafePath(entryPath);\n              const stat = await this.underlyingFs.promises.stat(entryRealPath);\n              if (stat.isDirectory()) {\n                const subMatches = await this.matchParts(rest, entryPath);\n                results.push(...subMatches);\n              }\n            } catch {\n              // Skip inaccessible entries\n            }\n          }\n        }\n      }\n\n      return results;\n    } catch {\n      return [];\n    }\n  }\n\n  private globToRegex(pattern: string): RegExp {\n    let regex = \"^\";\n    for (let i = 0; i < pattern.length; i++) {\n      const char = pattern[i]!;\n      if (char === \"*\") {\n        regex += \"[^/]*\";\n      } else if (char === \"?\") {\n        regex += \"[^/]\";\n      } else if (char === \"[\") {\n        // Character class\n        let j = i + 1;\n        let classContent = \"\";\n        while (j < pattern.length && pattern[j] !== \"]\") {\n          classContent += pattern[j];\n          j++;\n        }\n        regex += `[${classContent}]`;\n        i = j;\n      } else if (\".+^${}()|\\\\\".includes(char)) {\n        regex += \"\\\\\" + char;\n      } else {\n        regex += char;\n      }\n    }\n    regex += \"$\";\n    return new RegExp(regex);\n  }\n}\n"
+    "import * as path from \"path\";\nimport * as nodeFs from \"node:fs/promises\";\nimport type { VirtualFS, FileStat } from \"../types.mjs\";\n\nexport type Permission = \"read-write\" | \"read-only\" | \"excluded\";\nexport type PermissionRules = Record<string, Permission>;\n\n// Minimal interface for the underlying fs (compatible with node:fs and memfs)\nexport interface UnderlyingFS {\n  promises: {\n    readFile(path: string): Promise<Buffer | Uint8Array | string>;\n    readdir(path: string): Promise<string[]>;\n    stat(path: string): Promise<{\n      isFile(): boolean;\n      isDirectory(): boolean;\n      size: number;\n      mtime: Date;\n    }>;\n    writeFile(path: string, data: Buffer | string): Promise<void>;\n    appendFile(path: string, data: Buffer | string): Promise<void>;\n    mkdir(path: string, opts?: { recursive?: boolean }): Promise<string | undefined | void>;\n    rm(path: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void>;\n  };\n}\n\n// Default: use real node:fs\nconst defaultFS: UnderlyingFS = { promises: nodeFs };\n\ninterface CompiledRule {\n  pattern: string;\n  permission: Permission;\n  specificity: number;\n}\n\nexport class FileSystem implements VirtualFS {\n  private readonly mountBase: string | null;\n  private readonly rules: CompiledRule[];\n  protected readonly underlyingFs: UnderlyingFS;\n\n  constructor(mountPath?: string, permissions?: PermissionRules, fs?: UnderlyingFS) {\n    this.mountBase = mountPath ? path.resolve(mountPath) : null;\n    this.rules = this.compileRules(permissions ?? {});\n    this.underlyingFs = fs ?? defaultFS;\n  }\n\n  private compileRules(permissions: PermissionRules): CompiledRule[] {\n    return Object.entries(permissions)\n      .map(([pattern, permission]) => ({\n        pattern,\n        permission,\n        specificity: this.calculateSpecificity(pattern),\n      }))\n      .sort((a, b) => b.specificity - a.specificity); // highest first\n  }\n\n  private calculateSpecificity(pattern: string): number {\n    const segments = pattern.split(\"/\").filter(Boolean);\n    let score = segments.length * 1000; // segment count is primary\n\n    for (const seg of segments) {\n      if (seg === \"**\") score += 0;\n      else if (seg.includes(\"*\")) score += 1;\n      else score += 10; // literal segment\n    }\n    return score;\n  }\n\n  public getPermission(virtualPath: string): Permission {\n    const normalized = virtualPath.replace(/^\\/+/, \"\"); // strip leading slashes\n\n    for (const rule of this.rules) {\n      if (this.matchGlob(rule.pattern, normalized)) {\n        return rule.permission;\n      }\n    }\n    return \"read-write\"; // default\n  }\n\n  private matchGlob(pattern: string, filePath: string): boolean {\n    // Convert glob to regex\n    // ** matches any path segments, * matches within segment\n    const regex = pattern\n      .split(\"/\")\n      .map((seg) => {\n        if (seg === \"**\") return \".*\";\n        return seg.replace(/\\*/g, \"[^/]*\").replace(/\\?/g, \"[^/]\");\n      })\n      .join(\"/\");\n    return new RegExp(`^${regex}$`).test(filePath);\n  }\n\n  public checkPermission(virtualPath: string, operation: \"read\" | \"write\"): void {\n    const perm = this.getPermission(virtualPath);\n\n    if (perm === \"excluded\") {\n      throw new Error(`Access denied: \"${virtualPath}\" is excluded`);\n    }\n    if (operation === \"write\" && perm === \"read-only\") {\n      throw new Error(`Access denied: \"${virtualPath}\" is read-only`);\n    }\n  }\n\n  private resolveSafePath(virtualPath: string): string {\n    if (this.mountBase === null) {\n      return path.resolve(virtualPath);\n    }\n\n    // Check for path traversal by tracking depth\n    const segments = virtualPath.split(\"/\").filter(Boolean);\n    let depth = 0;\n    for (const seg of segments) {\n      if (seg === \"..\") {\n        depth--;\n        if (depth < 0) {\n          throw new Error(`Path traversal blocked: \"${virtualPath}\" escapes mount point`);\n        }\n      } else if (seg !== \".\") {\n        depth++;\n      }\n    }\n\n    const normalized = path.normalize(virtualPath);\n    const relativePath = normalized.startsWith(\"/\") ? normalized.slice(1) : normalized;\n    const realPath = path.join(this.mountBase, relativePath);\n    const resolved = path.resolve(realPath);\n\n    // Double-check containment (defense in depth)\n    if (!resolved.startsWith(this.mountBase + path.sep) && resolved !== this.mountBase) {\n      throw new Error(`Path traversal blocked: \"${virtualPath}\" escapes mount point`);\n    }\n\n    return resolved;\n  }\n\n  // Read operations\n  async readFile(filePath: string): Promise<Buffer>;\n  async readFile(filePath: string, encoding: BufferEncoding): Promise<string>;\n  async readFile(filePath: string, encoding?: BufferEncoding): Promise<Buffer | string> {\n    this.checkPermission(filePath, \"read\");\n    const realPath = this.resolveSafePath(filePath);\n    const content = await this.underlyingFs.promises.readFile(realPath);\n    const buf = Buffer.from(content);\n    return encoding ? buf.toString(encoding) : buf;\n  }\n\n  async readdir(dirPath: string): Promise<string[]> {\n    this.checkPermission(dirPath, \"read\");\n    const realPath = this.resolveSafePath(dirPath);\n    const entries = await this.underlyingFs.promises.readdir(realPath);\n    return entries.map(String);\n  }\n\n  async stat(filePath: string): Promise<FileStat> {\n    this.checkPermission(filePath, \"read\");\n    const realPath = this.resolveSafePath(filePath);\n    const stats = await this.underlyingFs.promises.stat(realPath);\n    return {\n      isFile: () => stats.isFile(),\n      isDirectory: () => stats.isDirectory(),\n      size: stats.size,\n      mtime: stats.mtime,\n    };\n  }\n\n  async exists(filePath: string): Promise<boolean> {\n    try {\n      this.checkPermission(filePath, \"read\");\n      const realPath = this.resolveSafePath(filePath);\n      await this.underlyingFs.promises.stat(realPath);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  // Write operations\n  async writeFile(filePath: string, data: Buffer | string): Promise<void> {\n    this.checkPermission(filePath, \"write\");\n    const realPath = this.resolveSafePath(filePath);\n    await this.underlyingFs.promises.writeFile(realPath, data);\n  }\n\n  async appendFile(filePath: string, data: Buffer | string): Promise<void> {\n    this.checkPermission(filePath, \"write\");\n    const realPath = this.resolveSafePath(filePath);\n    await this.underlyingFs.promises.appendFile(realPath, data);\n  }\n\n  async mkdir(dirPath: string, opts?: { recursive?: boolean }): Promise<void> {\n    this.checkPermission(dirPath, \"write\");\n    const realPath = this.resolveSafePath(dirPath);\n    await this.underlyingFs.promises.mkdir(realPath, opts);\n  }\n\n  async rm(filePath: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void> {\n    this.checkPermission(filePath, \"write\");\n    const realPath = this.resolveSafePath(filePath);\n    await this.underlyingFs.promises.rm(realPath, opts);\n  }\n\n  // Path utilities (no permission check needed)\n  resolve(...paths: string[]): string {\n    return path.resolve(\"/\", ...paths);\n  }\n\n  dirname(filePath: string): string {\n    return path.dirname(filePath);\n  }\n\n  basename(filePath: string): string {\n    return path.basename(filePath);\n  }\n\n  // Glob with permission filtering\n  async glob(pattern: string, opts?: { cwd?: string }): Promise<string[]> {\n    const cwd = opts?.cwd ?? \"/\";\n    this.checkPermission(cwd, \"read\");\n\n    const matches = await this.expandGlob(pattern, cwd);\n\n    // Filter out excluded paths\n    return matches.filter((p) => this.getPermission(p) !== \"excluded\").sort();\n  }\n\n  // Glob expansion (similar to memfs-adapter implementation)\n  private async expandGlob(pattern: string, cwd: string): Promise<string[]> {\n    // Handle brace expansion first\n    const patterns = this.expandBraces(pattern);\n    const allMatches: string[] = [];\n\n    for (const pat of patterns) {\n      const matches = await this.matchPattern(pat, cwd);\n      allMatches.push(...matches);\n    }\n\n    // Remove duplicates and sort\n    return [...new Set(allMatches)].sort();\n  }\n\n  private expandBraces(pattern: string): string[] {\n    const braceMatch = pattern.match(/\\{([^{}]+)\\}/);\n    if (!braceMatch) return [pattern];\n\n    const before = pattern.slice(0, braceMatch.index);\n    const after = pattern.slice(braceMatch.index! + braceMatch[0].length);\n    const options = braceMatch[1]!.split(\",\");\n\n    const results: string[] = [];\n    for (const opt of options) {\n      const expanded = this.expandBraces(before + opt + after);\n      results.push(...expanded);\n    }\n    return results;\n  }\n\n  private async matchPattern(pattern: string, cwd: string): Promise<string[]> {\n    const parts = pattern.split(\"/\").filter((p) => p !== \"\");\n    const isAbsolute = pattern.startsWith(\"/\");\n    const startDir = isAbsolute ? \"/\" : cwd;\n\n    return this.matchParts(parts, startDir);\n  }\n\n  private async matchParts(parts: string[], currentPath: string): Promise<string[]> {\n    if (parts.length === 0) {\n      return [currentPath];\n    }\n\n    const [part, ...rest] = parts;\n\n    // Handle ** (recursive glob)\n    if (part === \"**\") {\n      const results: string[] = [];\n\n      // Match current directory\n      const withoutStar = await this.matchParts(rest, currentPath);\n      results.push(...withoutStar);\n\n      // Recurse into subdirectories\n      try {\n        const realPath = this.resolveSafePath(currentPath);\n        const entries = await this.underlyingFs.promises.readdir(realPath);\n        for (const entry of entries) {\n          const entryPath = path.posix.join(currentPath, String(entry));\n          try {\n            const entryRealPath = this.resolveSafePath(entryPath);\n            const stat = await this.underlyingFs.promises.stat(entryRealPath);\n            if (stat.isDirectory()) {\n              const subMatches = await this.matchParts(parts, entryPath);\n              results.push(...subMatches);\n            }\n          } catch {\n            // Skip inaccessible entries\n          }\n        }\n      } catch {\n        // Directory not readable\n      }\n\n      return results;\n    }\n\n    // Handle regular glob patterns\n    const regex = this.globToRegex(part!);\n\n    try {\n      const realPath = this.resolveSafePath(currentPath);\n      const entries = await this.underlyingFs.promises.readdir(realPath);\n      const results: string[] = [];\n\n      for (const entry of entries) {\n        const entryName = String(entry);\n        if (regex.test(entryName)) {\n          const entryPath = path.posix.join(currentPath, entryName);\n          if (rest.length === 0) {\n            results.push(entryPath);\n          } else {\n            try {\n              const entryRealPath = this.resolveSafePath(entryPath);\n              const stat = await this.underlyingFs.promises.stat(entryRealPath);\n              if (stat.isDirectory()) {\n                const subMatches = await this.matchParts(rest, entryPath);\n                results.push(...subMatches);\n              }\n            } catch {\n              // Skip inaccessible entries\n            }\n          }\n        }\n      }\n\n      return results;\n    } catch {\n      return [];\n    }\n  }\n\n  private globToRegex(pattern: string): RegExp {\n    let regex = \"^\";\n    for (let i = 0; i < pattern.length; i++) {\n      const char = pattern[i]!;\n      if (char === \"*\") {\n        regex += \"[^/]*\";\n      } else if (char === \"?\") {\n        regex += \"[^/]\";\n      } else if (char === \"[\") {\n        // Character class\n        let j = i + 1;\n        let classContent = \"\";\n        while (j < pattern.length && pattern[j] !== \"]\") {\n          classContent += pattern[j];\n          j++;\n        }\n        regex += `[${classContent}]`;\n        i = j;\n      } else if (\".+^${}()|\\\\\".includes(char)) {\n        regex += \"\\\\\" + char;\n      } else {\n        regex += char;\n      }\n    }\n    regex += \"$\";\n    return new RegExp(regex);\n  }\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "78CB3041E0AD3DDE64756E2164756E21",
+  "mappings": "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",
+  "debugId": "48B583F651B4E85F64756E2164756E21",
   "names": []
 }

package/dist/mjs/src/types.mjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../../src/types.ts"],
   "sourcesContent": [
-    "// Virtual Filesystem Interface\nexport interface VirtualFS {\n  readFile(path: string): Promise<Buffer>;\n  readdir(path: string): Promise<string[]>;\n  stat(path: string): Promise<FileStat>;\n  exists(path: string): Promise<boolean>;\n\n  writeFile(path: string, data: Buffer | string): Promise<void>;\n  appendFile(path: string, data: Buffer | string): Promise<void>;\n  mkdir(path: string, opts?: { recursive?: boolean }): Promise<void>;\n\n  rm(path: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void>;\n\n  resolve(...paths: string[]): string;\n  dirname(path: string): string;\n  basename(path: string): string;\n  glob(pattern: string, opts?: { cwd?: string }): Promise<string[]>;\n}\n\nexport interface FileStat {\n  isFile(): boolean;\n  isDirectory(): boolean;\n  size: number;\n  mtime: Date;\n}\n\n// Command Interfaces\nexport type Command = (ctx: CommandContext) => Promise<number>;\n\nexport interface CommandContext {\n  args: string[];\n  stdin: Stdin;\n  stdout: Stdout;\n  stderr: Stderr;\n  fs: VirtualFS;\n  cwd: string;\n  env: Record<string, string>;\n  setCwd: (path: string) => void;\n  exec?: (name: string, args: string[]) => Promise<ExecResult>;\n}\n\nexport interface Stdin {\n  stream(): AsyncIterable<Uint8Array>;\n  buffer(): Promise<Buffer>;\n  text(): Promise<string>;\n  lines(): AsyncIterable<string>;\n}\n\nexport interface Stdout {\n  write(chunk: Uint8Array): Promise<void>;\n  writeText(str: string): Promise<void>;\n  isTTY: boolean;\n}\n\nexport interface Stderr {\n  write(chunk: Uint8Array): Promise<void>;\n  writeText(str: string): Promise<void>;\n  isTTY: boolean;\n}\n\nexport interface OutputCollector extends Stdout {\n  close(): void;\n  collect(): Promise<Buffer>;\n  getReadableStream(): AsyncIterable<Uint8Array>;\n}\n\n// Execution Result\nexport interface ExecResult {\n  stdout: Buffer;\n  stderr: Buffer;\n  exitCode: number;\n}\n\n// Shell Configuration\nexport interface ShellConfig {\n  fs: VirtualFS;\n  cwd: string;\n  env: Record<string, string>;\n  commands: Record<string, Command>;\n  isTTY?: boolean;\n}\n\n// Raw escape hatch type\nexport interface RawValue {\n  raw: string;\n}\n\nexport function isRawValue(value: unknown): value is RawValue {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"raw\" in value &&\n    typeof (value as RawValue).raw === \"string\"\n  );\n}\n\n// JS Object Redirection types\nexport type RedirectObject = Buffer | Blob | Response | string;\n\nexport interface RedirectObjectMap {\n  [marker: string]: RedirectObject;\n}\n\nexport function isRedirectObject(value: unknown): value is RedirectObject {\n  return (\n    Buffer.isBuffer(value) ||\n    value instanceof Blob ||\n    value instanceof Response ||\n    typeof value === \"string\"\n  );\n}\n"
+    "// Virtual Filesystem Interface\nexport interface VirtualFS {\n  readFile(path: string): Promise<Buffer>;\n  readFile(path: string, encoding: BufferEncoding): Promise<string>;\n  readdir(path: string): Promise<string[]>;\n  stat(path: string): Promise<FileStat>;\n  exists(path: string): Promise<boolean>;\n\n  writeFile(path: string, data: Buffer | string): Promise<void>;\n  appendFile(path: string, data: Buffer | string): Promise<void>;\n  mkdir(path: string, opts?: { recursive?: boolean }): Promise<void>;\n\n  rm(path: string, opts?: { recursive?: boolean; force?: boolean }): Promise<void>;\n\n  resolve(...paths: string[]): string;\n  dirname(path: string): string;\n  basename(path: string): string;\n  glob(pattern: string, opts?: { cwd?: string }): Promise<string[]>;\n}\n\nexport interface FileStat {\n  isFile(): boolean;\n  isDirectory(): boolean;\n  size: number;\n  mtime: Date;\n}\n\n// Command Interfaces\nexport type Command = (ctx: CommandContext) => Promise<number>;\n\nexport interface CommandContext {\n  args: string[];\n  stdin: Stdin;\n  stdout: Stdout;\n  stderr: Stderr;\n  fs: VirtualFS;\n  cwd: string;\n  env: Record<string, string>;\n  setCwd: (path: string) => void;\n  exec?: (name: string, args: string[]) => Promise<ExecResult>;\n}\n\nexport interface Stdin {\n  stream(): AsyncIterable<Uint8Array>;\n  buffer(): Promise<Buffer>;\n  text(): Promise<string>;\n  lines(): AsyncIterable<string>;\n}\n\nexport interface Stdout {\n  write(chunk: Uint8Array): Promise<void>;\n  writeText(str: string): Promise<void>;\n  isTTY: boolean;\n}\n\nexport interface Stderr {\n  write(chunk: Uint8Array): Promise<void>;\n  writeText(str: string): Promise<void>;\n  isTTY: boolean;\n}\n\nexport interface OutputCollector extends Stdout {\n  close(): void;\n  collect(): Promise<Buffer>;\n  getReadableStream(): AsyncIterable<Uint8Array>;\n}\n\n// Execution Result\nexport interface ExecResult {\n  stdout: Buffer;\n  stderr: Buffer;\n  exitCode: number;\n}\n\n// Shell Configuration\nexport interface ShellConfig {\n  fs: VirtualFS;\n  cwd: string;\n  env: Record<string, string>;\n  commands: Record<string, Command>;\n  isTTY?: boolean;\n}\n\n// Raw escape hatch type\nexport interface RawValue {\n  raw: string;\n}\n\nexport function isRawValue(value: unknown): value is RawValue {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"raw\" in value &&\n    typeof (value as RawValue).raw === \"string\"\n  );\n}\n\n// JS Object Redirection types\nexport type RedirectObject = Buffer | Blob | Response | string;\n\nexport interface RedirectObjectMap {\n  [marker: string]: RedirectObject;\n}\n\nexport function isRedirectObject(value: unknown): value is RedirectObject {\n  return (\n    Buffer.isBuffer(value) ||\n    value instanceof Blob ||\n    value instanceof Response ||\n    typeof value === \"string\"\n  );\n}\n"
   ],
-  "mappings": ";AAuFO,SAAS,UAAU,CAAC,OAAmC;AAAA,EAC5D,OACE,OAAO,UAAU,YACjB,UAAU,QACV,SAAS,SACT,OAAQ,MAAmB,QAAQ;AAAA;AAWhC,SAAS,gBAAgB,CAAC,OAAyC;AAAA,EACxE,OACE,OAAO,SAAS,KAAK,KACrB,iBAAiB,QACjB,iBAAiB,YACjB,OAAO,UAAU;AAAA;",
+  "mappings": ";AAwFO,SAAS,UAAU,CAAC,OAAmC;AAAA,EAC5D,OACE,OAAO,UAAU,YACjB,UAAU,QACV,SAAS,SACT,OAAQ,MAAmB,QAAQ;AAAA;AAWhC,SAAS,gBAAgB,CAAC,OAAyC;AAAA,EACxE,OACE,OAAO,SAAS,KAAK,KACrB,iBAAiB,QACjB,iBAAiB,YACjB,OAAO,UAAU;AAAA;",
   "debugId": "9C8E04A91CC7802764756E2164756E21",
   "names": []
 }

package/dist/types/src/fs/real-fs.d.ts

@@ -34,6 +34,7 @@ export declare class FileSystem implements VirtualFS {
     checkPermission(virtualPath: string, operation: "read" | "write"): void;
     private resolveSafePath;
     readFile(filePath: string): Promise<Buffer>;
+    readFile(filePath: string, encoding: BufferEncoding): Promise<string>;
     readdir(dirPath: string): Promise<string[]>;
     stat(filePath: string): Promise<FileStat>;
     exists(filePath: string): Promise<boolean>;

package/dist/types/src/types.d.ts

@@ -1,5 +1,6 @@
 export interface VirtualFS {
     readFile(path: string): Promise<Buffer>;
+    readFile(path: string, encoding: BufferEncoding): Promise<string>;
     readdir(path: string): Promise<string[]>;
     stat(path: string): Promise<FileStat>;
     exists(path: string): Promise<boolean>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shell-dsl",
-  "version": "0.0.24",
+  "version": "0.0.25",
   "description": "A sandboxed shell-style DSL for running scriptable command pipelines in-process without host OS access",
   "author": "ricsam <oss@ricsam.dev>",
   "license": "MIT",