@caplab/read 0.1.0

package/dist/errors/structured.js

@@ -0,0 +1,79 @@
+import * as path from 'node:path';
+export function createFileNotFoundResult(filePath, workspaceRoot) {
+    return {
+        success: false,
+        error: 'file_not_found',
+        path: filePath,
+        relativePath: path.relative(workspaceRoot, filePath),
+    };
+}
+export function createPermissionDeniedResult(filePath, workspaceRoot) {
+    return {
+        success: false,
+        error: 'permission_denied',
+        path: filePath,
+        relativePath: path.relative(workspaceRoot, filePath),
+    };
+}
+export function createBinaryFileResult(filePath, workspaceRoot) {
+    return {
+        success: false,
+        error: 'binary_file',
+        path: filePath,
+        relativePath: path.relative(workspaceRoot, filePath),
+    };
+}
+export function createUnsupportedEncodingResult(filePath, workspaceRoot) {
+    return {
+        success: false,
+        error: 'unsupported_encoding',
+        path: filePath,
+        relativePath: path.relative(workspaceRoot, filePath),
+    };
+}
+export function createPathOutsideWorkspaceResult(filePath, workspaceRoot) {
+    return {
+        success: false,
+        error: 'path_outside_workspace',
+        path: filePath,
+        relativePath: path.relative(workspaceRoot, filePath),
+    };
+}
+export function createSkippedDueToBudgetResult(filePath, workspaceRoot) {
+    return {
+        success: false,
+        error: 'skipped_due_to_budget',
+        path: filePath,
+        relativePath: path.relative(workspaceRoot, filePath),
+    };
+}
+export function createSkippedDueToMaxFilesResult(filePath, workspaceRoot) {
+    return {
+        success: false,
+        error: 'skipped_due_to_max_files',
+        path: filePath,
+        relativePath: path.relative(workspaceRoot, filePath),
+    };
+}
+export function createDirectoryNotFoundResult(dirPath) {
+    return {
+        success: false,
+        error: 'path_not_found',
+        path: dirPath,
+    };
+}
+export function createDirectoryPermissionDeniedResult(dirPath) {
+    return {
+        success: false,
+        error: 'permission_denied',
+        path: dirPath,
+    };
+}
+export function createDirectoryOutsideWorkspaceResult(dirPath) {
+    return {
+        success: false,
+        error: 'path_outside_workspace',
+        path: dirPath,
+    };
+}
+//# sourceMappingURL=structured.js.map

package/dist/errors/structured.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured.js","sourceRoot":"","sources":["../../src/errors/structured.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,MAAM,UAAU,wBAAwB,CAAC,QAAgB,EAAE,aAAqB;IAC9E,OAAO;QACL,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,gBAAgB;QACvB,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC;KACrD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,QAAgB,EAAE,aAAqB;IAClF,OAAO;QACL,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,mBAAmB;QAC1B,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC;KACrD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAgB,EAAE,aAAqB;IAC5E,OAAO;QACL,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,aAAa;QACpB,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC;KACrD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,QAAgB,EAAE,aAAqB;IACrF,OAAO;QACL,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,sBAAsB;QAC7B,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC;KACrD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,QAAgB,EAAE,aAAqB;IACtF,OAAO;QACL,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,wBAAwB;QAC/B,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC;KACrD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,QAAgB,EAAE,aAAqB;IACpF,OAAO;QACL,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,uBAAuB;QAC9B,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC;KACrD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,QAAgB,EAAE,aAAqB;IACtF,OAAO;QACL,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,0BAA0B;QACjC,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC;KACrD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,OAAe;IAC3D,OAAO;QACL,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,gBAAgB;QACvB,IAAI,EAAE,OAAO;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qCAAqC,CAAC,OAAe;IACnE,OAAO;QACL,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,mBAAmB;QAC1B,IAAI,EAAE,OAAO;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qCAAqC,CAAC,OAAe;IACnE,OAAO;QACL,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,wBAAwB;QAC/B,IAAI,EAAE,OAAO;KACd,CAAC;AACJ,CAAC"}

package/dist/factory.d.ts

@@ -0,0 +1,3 @@
+import type { WorkspaceReader, WorkspaceReaderOptions } from './types/public.js';
+export declare function createWorkspaceReader(options: WorkspaceReaderOptions): Promise<WorkspaceReader>;
+//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAsF,MAAM,mBAAmB,CAAC;AASrK,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC,CA2FrG"}

package/dist/factory.js

@@ -0,0 +1,89 @@
+import { validateWorkspaceRoot, resolvePath, getRelativePath } from './path/resolver.js';
+import { validatePathBoundary } from './path/guard.js';
+import { listDirectory as listDirectoryImpl } from './fs/directory.js';
+import { readFileWithBudget } from './fs/reader.js';
+import { readMultipleFiles } from './read/multi-file.js';
+import { fileSearch as fileSearchImpl } from './search/adapter.js';
+export async function createWorkspaceReader(options) {
+    const config = await validateWorkspaceRoot(options.workspaceRoot);
+    if (!config) {
+        throw new Error('Invalid workspace root: path does not exist or is not a directory');
+    }
+    // Apply overrides from options
+    const workspaceConfig = {
+        ...config,
+        maxBytes: options.maxBytes ?? config.maxBytes,
+        maxLines: options.maxLines ?? config.maxLines,
+        maxFiles: options.maxFiles ?? config.maxFiles,
+        maxTotalBytes: options.maxTotalBytes ?? config.maxTotalBytes,
+        maxEntries: options.maxEntries ?? config.maxEntries,
+        maxSearchResults: options.maxSearchResults ?? config.maxSearchResults,
+    };
+    return {
+        async listDirectory(path, options) {
+            const absolutePath = resolvePath(path, workspaceConfig.workspaceRoot);
+            const boundaryCheck = await validatePathBoundary(absolutePath, workspaceConfig.workspaceRoot);
+            if (!boundaryCheck.valid) {
+                if (boundaryCheck.error === 'not_found') {
+                    return {
+                        success: false,
+                        error: 'path_not_found',
+                        path: absolutePath,
+                    };
+                }
+                if (boundaryCheck.error === 'permission_denied') {
+                    return {
+                        success: false,
+                        error: 'permission_denied',
+                        path: absolutePath,
+                    };
+                }
+                return {
+                    success: false,
+                    error: 'path_outside_workspace',
+                    path: absolutePath,
+                };
+            }
+            return listDirectoryImpl(absolutePath, workspaceConfig.workspaceRoot, options ?? {});
+        },
+        async readFile(path, options) {
+            const absolutePath = resolvePath(path, workspaceConfig.workspaceRoot);
+            const boundaryCheck = await validatePathBoundary(absolutePath, workspaceConfig.workspaceRoot);
+            if (!boundaryCheck.valid) {
+                if (boundaryCheck.error === 'not_found') {
+                    return {
+                        success: false,
+                        error: 'file_not_found',
+                        path: absolutePath,
+                        relativePath: getRelativePath(absolutePath, workspaceConfig.workspaceRoot),
+                    };
+                }
+                if (boundaryCheck.error === 'permission_denied') {
+                    return {
+                        success: false,
+                        error: 'permission_denied',
+                        path: absolutePath,
+                        relativePath: getRelativePath(absolutePath, workspaceConfig.workspaceRoot),
+                    };
+                }
+                return {
+                    success: false,
+                    error: 'path_outside_workspace',
+                    path: absolutePath,
+                    relativePath: getRelativePath(absolutePath, workspaceConfig.workspaceRoot),
+                };
+            }
+            const maxBytes = options?.maxBytes ?? workspaceConfig.maxBytes;
+            const maxLines = options?.maxLines ?? workspaceConfig.maxLines;
+            const encoding = options?.encoding;
+            return readFileWithBudget(absolutePath, maxBytes, maxLines, encoding, workspaceConfig.workspaceRoot);
+        },
+        async readMultipleFiles(paths, options) {
+            return readMultipleFiles(paths, workspaceConfig, options ?? {});
+        },
+        fileSearch(query, options) {
+            return fileSearchImpl(query, workspaceConfig, options ?? {});
+        },
+    };
+}
+//# sourceMappingURL=factory.js.map

package/dist/factory.js.map

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

package/dist/fs/binary.d.ts

@@ -0,0 +1,4 @@
+import type { EncodingDetectionResult } from '../types/internal.js';
+export declare function detectEncoding(filePath: string): Promise<EncodingDetectionResult>;
+export declare function isBinaryFile(filePath: string, encoding: 'utf-8' | 'utf-16le' | 'utf-16be'): Promise<boolean>;
+//# sourceMappingURL=binary.d.ts.map

package/dist/fs/binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.d.ts","sourceRoot":"","sources":["../../src/fs/binary.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAIpE,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAYvF;AA2CD,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAiClH"}

package/dist/fs/binary.js

@@ -0,0 +1,79 @@
+import * as fs from 'node:fs/promises';
+const SNIFF_CHUNK_SIZE = 8192;
+export async function detectEncoding(filePath) {
+    try {
+        const handle = await fs.open(filePath, 'r');
+        const buffer = Buffer.alloc(SNIFF_CHUNK_SIZE);
+        const { bytesRead } = await handle.read(buffer, 0, SNIFF_CHUNK_SIZE, 0);
+        await handle.close();
+        const data = buffer.subarray(0, bytesRead);
+        return detectEncodingFromBuffer(data);
+    }
+    catch {
+        return { encoding: 'unknown', bom: false };
+    }
+}
+function detectEncodingFromBuffer(buffer) {
+    if (buffer.length < 2) {
+        return { encoding: 'utf-8', bom: false };
+    }
+    // Check for BOM
+    if (buffer[0] === 0xEF && buffer[1] === 0xBB && buffer[2] === 0xBF) {
+        return { encoding: 'utf-8', bom: true };
+    }
+    if (buffer[0] === 0xFF && buffer[1] === 0xFE) {
+        return { encoding: 'utf-16le', bom: true };
+    }
+    if (buffer[0] === 0xFE && buffer[1] === 0xFF) {
+        return { encoding: 'utf-16be', bom: true };
+    }
+    // Detect UTF-16 without BOM by looking for null bytes
+    let nullByteCount = 0;
+    for (let i = 0; i < Math.min(buffer.length, 100); i++) {
+        if (buffer[i] === 0) {
+            nullByteCount++;
+        }
+    }
+    // If we see many null bytes, it's likely UTF-16
+    if (nullByteCount > 10) {
+        // Determine LE vs BE by looking at pattern
+        if (buffer[0] === 0 && buffer[1] !== 0) {
+            return { encoding: 'utf-16be', bom: false };
+        }
+        if (buffer[0] !== 0 && buffer[1] === 0) {
+            return { encoding: 'utf-16le', bom: false };
+        }
+    }
+    // Default to UTF-8
+    return { encoding: 'utf-8', bom: false };
+}
+export async function isBinaryFile(filePath, encoding) {
+    try {
+        const handle = await fs.open(filePath, 'r');
+        const buffer = Buffer.alloc(SNIFF_CHUNK_SIZE);
+        const { bytesRead } = await handle.read(buffer, 0, SNIFF_CHUNK_SIZE, 0);
+        await handle.close();
+        const data = buffer.subarray(0, bytesRead);
+        if (encoding === 'utf-8' || encoding === 'utf-16le' || encoding === 'utf-16be') {
+            // For supported encodings, decode and check for null bytes in decoded text space
+            const decoder = new TextDecoder(encoding, { fatal: false });
+            const decoded = decoder.decode(data, { stream: true });
+            // Check for null bytes in decoded text
+            if (decoded.includes('\0')) {
+                return true;
+            }
+            return false;
+        }
+        // For unsupported encodings, use null-byte heuristic on raw bytes
+        for (let i = 0; i < data.length; i++) {
+            if (data[i] === 0) {
+                return true;
+            }
+        }
+        return false;
+    }
+    catch {
+        return true;
+    }
+}
+//# sourceMappingURL=binary.js.map

package/dist/fs/binary.js.map

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

package/dist/fs/directory.d.ts

@@ -0,0 +1,3 @@
+import type { DirectoryResult, ListDirectoryOptions } from '../types/public.js';
+export declare function listDirectory(dirPath: string, workspaceRoot: string, options?: ListDirectoryOptions): Promise<DirectoryResult>;
+//# sourceMappingURL=directory.d.ts.map

package/dist/fs/directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory.d.ts","sourceRoot":"","sources":["../../src/fs/directory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAkB,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAahG,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,eAAe,CAAC,CA6H1B"}

package/dist/fs/directory.js

@@ -0,0 +1,127 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { normalizePath } from '../path/normalizer.js';
+function minimatch(str, pattern) {
+    // Simple glob pattern matcher supporting * and ?
+    const regexPattern = pattern
+        .replace(/\./g, '\\.')
+        .replace(/\*/g, '.*')
+        .replace(/\?/g, '.');
+    const regex = new RegExp(`^${regexPattern}$`);
+    return regex.test(str);
+}
+export async function listDirectory(dirPath, workspaceRoot, options = {}) {
+    try {
+        const stats = await fs.stat(dirPath);
+        if (!stats.isDirectory()) {
+            return {
+                success: false,
+                error: 'path_not_found',
+                path: dirPath,
+            };
+        }
+        const entries = [];
+        const maxDepth = options.maxDepth ?? Infinity;
+        const includeHidden = options.includeHidden ?? false;
+        const includePatterns = options.include ?? [];
+        const excludePatterns = options.exclude ?? [];
+        const maxEntries = options.maxEntries ?? 1000;
+        async function collectEntries(currentPath, currentDepth) {
+            if (currentDepth > maxDepth) {
+                return;
+            }
+            try {
+                const dirents = await fs.readdir(currentPath, { withFileTypes: true });
+                for (const dirent of dirents) {
+                    const fullPath = path.join(currentPath, dirent.name);
+                    const relativePath = path.relative(workspaceRoot, fullPath);
+                    const normalizedRelativePath = normalizePath(relativePath);
+                    // Skip hidden files unless includeHidden is true
+                    if (!includeHidden && dirent.name.startsWith('.')) {
+                        continue;
+                    }
+                    // Apply exclude patterns (apply to both files and directories)
+                    if (excludePatterns.length > 0) {
+                        const matchesExclude = excludePatterns.some(pattern => minimatch(normalizedRelativePath, pattern));
+                        if (matchesExclude) {
+                            continue;
+                        }
+                    }
+                    // For files, apply include patterns
+                    if (dirent.isFile()) {
+                        if (includePatterns.length > 0) {
+                            const matchesInclude = includePatterns.some(pattern => minimatch(normalizedRelativePath, pattern));
+                            if (!matchesInclude) {
+                                continue;
+                            }
+                        }
+                        const entry = {
+                            path: normalizePath(fullPath),
+                            relativePath: normalizedRelativePath,
+                            type: 'file',
+                        };
+                        // Get size for files
+                        try {
+                            const fileStats = await fs.stat(fullPath);
+                            entry.size = fileStats.size;
+                        }
+                        catch {
+                            // Ignore stat errors
+                        }
+                        entries.push(entry);
+                    }
+                    // Always recurse into directories to find nested files
+                    if (dirent.isDirectory()) {
+                        // Add directory entry if it matches include patterns or if no include patterns
+                        if (includePatterns.length === 0 || includePatterns.some(pattern => minimatch(normalizedRelativePath, pattern))) {
+                            const entry = {
+                                path: normalizePath(fullPath),
+                                relativePath: normalizedRelativePath,
+                                type: 'directory',
+                            };
+                            entries.push(entry);
+                        }
+                        await collectEntries(fullPath, currentDepth + 1);
+                    }
+                }
+            }
+            catch (error) {
+                if (error.code === 'EACCES' || error.code === 'EPERM') {
+                    // Skip directories we can't access
+                }
+                else {
+                    throw error;
+                }
+            }
+        }
+        await collectEntries(dirPath, 0);
+        // Sort by normalized path (deterministic)
+        entries.sort((a, b) => a.relativePath.localeCompare(b.relativePath));
+        // Cap to maxEntries
+        const truncated = entries.length > maxEntries;
+        const finalEntries = entries.slice(0, maxEntries);
+        return {
+            success: true,
+            entries: finalEntries,
+            truncated,
+        };
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return {
+                success: false,
+                error: 'path_not_found',
+                path: dirPath,
+            };
+        }
+        if (error.code === 'EACCES' || error.code === 'EPERM') {
+            return {
+                success: false,
+                error: 'permission_denied',
+                path: dirPath,
+            };
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=directory.js.map

package/dist/fs/directory.js.map

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

package/dist/fs/reader.d.ts

@@ -0,0 +1,3 @@
+import type { FileReadResult } from '../types/public.js';
+export declare function readFileWithBudget(filePath: string, maxBytes: number, maxLines: number, encoding?: 'utf-8' | 'utf-16le' | 'utf-16be' | 'auto', workspaceRoot?: string): Promise<FileReadResult>;
+//# sourceMappingURL=reader.d.ts.map

package/dist/fs/reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../../src/fs/reader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,EACrD,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,cAAc,CAAC,CA8GzB"}

package/dist/fs/reader.js

@@ -0,0 +1,109 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { detectEncoding, isBinaryFile } from './binary.js';
+export async function readFileWithBudget(filePath, maxBytes, maxLines, encoding, workspaceRoot) {
+    const getRelativePath = () => {
+        if (workspaceRoot) {
+            const relative = path.relative(workspaceRoot, filePath);
+            // Normalize to forward slashes for consistency
+            return relative.split(path.sep).join('/');
+        }
+        return path.basename(filePath);
+    };
+    try {
+        const stats = await fs.stat(filePath);
+        if (!stats.isFile()) {
+            return {
+                success: false,
+                error: 'file_not_found',
+                path: filePath,
+                relativePath: getRelativePath(),
+            };
+        }
+        // Detect encoding if auto
+        let finalEncoding;
+        if (encoding === 'auto' || !encoding) {
+            const detection = await detectEncoding(filePath);
+            if (detection.encoding === 'unknown') {
+                return {
+                    success: false,
+                    error: 'unsupported_encoding',
+                    path: filePath,
+                    relativePath: getRelativePath(),
+                };
+            }
+            finalEncoding = detection.encoding;
+        }
+        else {
+            finalEncoding = encoding;
+        }
+        // Check if binary
+        const isBinary = await isBinaryFile(filePath, finalEncoding);
+        if (isBinary) {
+            return {
+                success: false,
+                error: 'binary_file',
+                path: filePath,
+                relativePath: getRelativePath(),
+            };
+        }
+        // Read file with budgets
+        const handle = await fs.open(filePath, 'r');
+        const buffer = Buffer.alloc(maxBytes);
+        const { bytesRead } = await handle.read(buffer, 0, maxBytes, 0);
+        await handle.close();
+        const data = buffer.subarray(0, bytesRead);
+        // Use fatal: true when reading full file to catch encoding errors
+        // Use fatal: false when truncated to handle multibyte sequence cuts
+        const decoder = new TextDecoder(finalEncoding, { fatal: bytesRead === stats.size });
+        let content;
+        try {
+            content = decoder.decode(data);
+        }
+        catch (decodeError) {
+            return {
+                success: false,
+                error: 'unsupported_encoding',
+                path: filePath,
+                relativePath: getRelativePath(),
+            };
+        }
+        // Count lines and apply line limit
+        const lines = content.split('\n');
+        const truncatedLines = lines.length > maxLines;
+        const finalContent = truncatedLines ? lines.slice(0, maxLines).join('\n') : content;
+        const linesRead = Math.min(lines.length, maxLines);
+        const truncatedBytes = bytesRead === maxBytes && stats.size > maxBytes;
+        return {
+            success: true,
+            path: filePath,
+            relativePath: getRelativePath(),
+            content: finalContent,
+            encoding: finalEncoding,
+            truncatedBytes,
+            truncatedLines,
+            bytesRead,
+            linesRead,
+        };
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return {
+                success: false,
+                error: 'file_not_found',
+                path: filePath,
+                relativePath: getRelativePath(),
+            };
+        }
+        if (error.code === 'EACCES' || error.code === 'EPERM') {
+            return {
+                success: false,
+                error: 'permission_denied',
+                path: filePath,
+                relativePath: getRelativePath(),
+            };
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=reader.js.map

package/dist/fs/reader.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export type { WorkspaceReaderOptions, ListDirectoryOptions, DirectoryResult, DirectoryEntry, ReadFileOptions, FileReadResult, ReadMultipleFilesOptions, MultiFileResult, FileSearchOptions, WorkspaceReader, } from "./types/public.js";
+export { createWorkspaceReader } from "./factory.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,YAAY,EACX,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,eAAe,EACf,cAAc,EACd,wBAAwB,EACxB,eAAe,EACf,iBAAiB,EACjB,eAAe,GACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+// Public API exports for @caplab/read
+export { createWorkspaceReader } from "./factory.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAetC,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC"}

package/dist/output/formatter.d.ts

@@ -0,0 +1,4 @@
+import type { FileReadResult, DirectoryEntry } from '../types/public.js';
+export declare function formatFileReadResult(path: string, relativePath: string, content: string, encoding: string, truncatedBytes: boolean, truncatedLines: boolean, bytesRead: number, linesRead: number): FileReadResult;
+export declare function formatDirectoryEntry(path: string, relativePath: string, type: 'file' | 'directory', size?: number): DirectoryEntry;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/output/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/output/formatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzE,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,OAAO,EACvB,cAAc,EAAE,OAAO,EACvB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,cAAc,CAYhB;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,GAAG,WAAW,EAC1B,IAAI,CAAC,EAAE,MAAM,GACZ,cAAc,CAOhB"}

package/dist/output/formatter.js

@@ -0,0 +1,22 @@
+export function formatFileReadResult(path, relativePath, content, encoding, truncatedBytes, truncatedLines, bytesRead, linesRead) {
+    return {
+        success: true,
+        path,
+        relativePath,
+        content,
+        encoding,
+        truncatedBytes,
+        truncatedLines,
+        bytesRead,
+        linesRead,
+    };
+}
+export function formatDirectoryEntry(path, relativePath, type, size) {
+    return {
+        path,
+        relativePath,
+        type,
+        size,
+    };
+}
+//# sourceMappingURL=formatter.js.map

package/dist/output/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../../src/output/formatter.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,oBAAoB,CAClC,IAAY,EACZ,YAAoB,EACpB,OAAe,EACf,QAAgB,EAChB,cAAuB,EACvB,cAAuB,EACvB,SAAiB,EACjB,SAAiB;IAEjB,OAAO;QACL,OAAO,EAAE,IAAI;QACb,IAAI;QACJ,YAAY;QACZ,OAAO;QACP,QAAQ;QACR,cAAc;QACd,cAAc;QACd,SAAS;QACT,SAAS;KACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,IAAY,EACZ,YAAoB,EACpB,IAA0B,EAC1B,IAAa;IAEb,OAAO;QACL,IAAI;QACJ,YAAY;QACZ,IAAI;QACJ,IAAI;KACL,CAAC;AACJ,CAAC"}

package/dist/output/truncation.d.ts

@@ -0,0 +1,5 @@
+export declare function markTruncation(content: string, maxBytes: number, maxLines: number, bytesRead: number, fileSize: number): {
+    truncatedBytes: boolean;
+    truncatedLines: boolean;
+};
+//# sourceMappingURL=truncation.d.ts.map

package/dist/output/truncation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncation.d.ts","sourceRoot":"","sources":["../../src/output/truncation.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf;IAAE,cAAc,EAAE,OAAO,CAAC;IAAC,cAAc,EAAE,OAAO,CAAA;CAAE,CAOtD"}

package/dist/output/truncation.js

@@ -0,0 +1,7 @@
+export function markTruncation(content, maxBytes, maxLines, bytesRead, fileSize) {
+    const truncatedBytes = bytesRead === maxBytes && fileSize > maxBytes;
+    const lines = content.split('\n');
+    const truncatedLines = lines.length > maxLines;
+    return { truncatedBytes, truncatedLines };
+}
+//# sourceMappingURL=truncation.js.map

package/dist/output/truncation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncation.js","sourceRoot":"","sources":["../../src/output/truncation.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAC5B,OAAe,EACf,QAAgB,EAChB,QAAgB,EAChB,SAAiB,EACjB,QAAgB;IAEhB,MAAM,cAAc,GAAG,SAAS,KAAK,QAAQ,IAAI,QAAQ,GAAG,QAAQ,CAAC;IAErE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC;IAE/C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC;AAC5C,CAAC"}

package/dist/path/guard.d.ts

@@ -0,0 +1,5 @@
+export declare function validatePathBoundary(absolutePath: string, workspaceRoot: string): Promise<{
+    valid: boolean;
+    error?: 'not_found' | 'permission_denied';
+}>;
+//# sourceMappingURL=guard.d.ts.map