byterover-cli 0.2.1 → 0.3.0

package/dist/infra/cipher/file-system/file-system-service.d.ts

@@ -0,0 +1,105 @@
+import type { EditFileOptions, EditOperation, EditResult, FileContent, FileSystemConfig, GlobOptions, GlobResult, ReadFileOptions, SearchOptions, SearchResult, WriteFileOptions, WriteResult } from '../../../core/domain/cipher/file-system/types.js';
+import type { IFileSystem } from '../../../core/interfaces/cipher/i-file-system.js';
+/**
+ * File system service implementation.
+ * Provides secure, validated file system operations with comprehensive
+ * path validation, size limits, and allow/block list enforcement.
+ */
+export declare class FileSystemService implements IFileSystem {
+    private readonly config;
+    private initialized;
+    private readonly pathValidator;
+    /**
+     * Creates a new file system service
+     * @param config - File system configuration (optional, uses defaults)
+     */
+    constructor(config?: Partial<FileSystemConfig>);
+    /**
+     * Edit a file by replacing strings.
+     */
+    editFile(filePath: string, operation: EditOperation, options?: EditFileOptions): Promise<EditResult>;
+    /**
+     * Find files matching a glob pattern.
+     *
+     * Features:
+     * - Case sensitivity control via `caseSensitive` option
+     * - Gitignore filtering via `respectGitignore` option
+     * - Smart sorting: recent files (within 24h) first, then alphabetical
+     * - Special character handling for paths with glob syntax
+     */
+    globFiles(pattern: string, options?: GlobOptions): Promise<GlobResult>;
+    /**
+     * Initialize the file system service.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Read the contents of a file.
+     */
+    readFile(filePath: string, options?: ReadFileOptions): Promise<FileContent>;
+    /**
+     * Search file contents for a pattern.
+     * Uses native grep commands (ripgrep, system grep) when available for better performance,
+     * falling back to JavaScript implementation when needed.
+     */
+    searchContent(pattern: string, options?: SearchOptions): Promise<SearchResult>;
+    /**
+     * Write content to a file.
+     */
+    writeFile(filePath: string, content: string, options?: WriteFileOptions): Promise<WriteResult>;
+    /**
+     * Builds a human-readable message for glob results.
+     */
+    private buildGlobMessage;
+    /**
+     * Collects context lines before and after a match.
+     */
+    private collectContextLines;
+    /**
+     * Creates a regex from a pattern string.
+     */
+    private createSearchRegex;
+    /**
+     * Ensures the service is initialized.
+     * @throws ServiceNotInitializedError if not initialized
+     */
+    private ensureInitialized;
+    /**
+     * Executes ripgrep (rg) for content search.
+     * Returns null if rg is not available or fails.
+     */
+    private executeRipgrep;
+    /**
+     * Executes system grep for content search.
+     * Returns null if grep is not available or fails.
+     */
+    private executeSystemGrep;
+    /**
+     * Checks if a command is available in the system's PATH.
+     */
+    private isCommandAvailable;
+    /**
+     * Parses output from grep-like commands (filepath:lineNumber:content format).
+     */
+    private parseGrepOutput;
+    /**
+     * JavaScript-based content search implementation.
+     * Used as fallback when native grep commands are unavailable or when context lines are needed.
+     */
+    private searchContentJS;
+    /**
+     * Searches a single file for a regex pattern.
+     */
+    private searchFile;
+    /**
+     * Searches multiple files for a regex pattern.
+     */
+    private searchFiles;
+    /**
+     * Spawns a command and returns its stdout.
+     */
+    private spawnCommand;
+    /**
+     * Throws the appropriate error based on validation error message.
+     */
+    private throwValidationError;
+}