@timetotest/cli 0.2.3 → 0.3.0

package/dist/src/lib/local-tools/code/list-directory.js

@@ -0,0 +1,276 @@
+/**
+ * list_directory tool - List directory contents with filtering options.
+ * Supports glob pattern filtering, recursive listing, and hidden file filtering.
+ *
+ * Security: Implements path validation to prevent directory traversal (TR-5).
+ */
+import * as fs from "fs/promises";
+import * as path from "path";
+// Default max depth for recursive listing to prevent excessive traversal
+const DEFAULT_MAX_DEPTH = 10;
+// Maximum number of entries to return to prevent memory issues
+const MAX_ENTRIES = 1000;
+/**
+ * Validate and resolve a directory path to prevent directory traversal.
+ * Returns the resolved absolute path if valid, or an error.
+ *
+ * Security (TR-5):
+ * - All paths normalized and validated against project root
+ * - Reject paths containing `..` that escape root
+ * - Use `path.resolve()` and check prefix
+ */
+function validatePath(dirPath, workingDirectory) {
+    // Normalize the working directory to absolute path
+    const rootDir = path.resolve(workingDirectory);
+    // Resolve the requested path relative to working directory
+    const resolvedPath = path.resolve(rootDir, dirPath);
+    // Security check: ensure resolved path is within root directory
+    // Use path.sep to ensure we're checking directory boundaries properly
+    const normalizedRoot = rootDir.endsWith(path.sep)
+        ? rootDir
+        : rootDir + path.sep;
+    const normalizedResolved = resolvedPath + path.sep;
+    if (!normalizedResolved.startsWith(normalizedRoot) &&
+        resolvedPath !== rootDir) {
+        return {
+            valid: false,
+            error: "Path validation failed: access denied",
+        };
+    }
+    return { valid: true, resolvedPath };
+}
+/**
+ * Check if a filename matches a glob pattern.
+ * Supports basic glob patterns: *, ?, and character classes [abc].
+ */
+function matchesGlobPattern(filename, pattern) {
+    // Convert glob pattern to regex
+    let regexPattern = pattern
+        // Escape special regex characters except glob wildcards
+        .replace(/[.+^${}()|[\]\\]/g, "\\$&")
+        // Convert glob * to regex .*
+        .replace(/\*/g, ".*")
+        // Convert glob ? to regex .
+        .replace(/\?/g, ".");
+    // Create regex with case-insensitive matching for cross-platform compatibility
+    const regex = new RegExp(`^${regexPattern}$`, "i");
+    return regex.test(filename);
+}
+/**
+ * Check if a file/directory name is hidden (starts with .).
+ */
+function isHidden(name) {
+    return name.startsWith(".");
+}
+/**
+ * Get file/directory stats and create a DirectoryEntry.
+ */
+async function createDirectoryEntry(entryPath, name) {
+    try {
+        const stats = await fs.stat(entryPath);
+        const entry = {
+            name,
+            type: stats.isDirectory() ? "directory" : "file",
+        };
+        // Add size for files
+        if (!stats.isDirectory()) {
+            entry.size = stats.size;
+        }
+        // Add modification time
+        entry.modified = stats.mtime.toISOString();
+        return entry;
+    }
+    catch {
+        // Skip entries we can't stat (permission issues, etc.)
+        return null;
+    }
+}
+/**
+ * Recursively list directory contents.
+ */
+async function listDirectoryRecursive(dirPath, rootDir, options) {
+    // Check depth limit
+    if (options.currentDepth > options.maxDepth) {
+        return;
+    }
+    // Check entry limit
+    if (options.entries.length >= MAX_ENTRIES) {
+        return;
+    }
+    try {
+        const items = await fs.readdir(dirPath);
+        for (const item of items) {
+            // Check entry limit
+            if (options.entries.length >= MAX_ENTRIES) {
+                return;
+            }
+            // Skip hidden files if not included
+            if (!options.includeHidden && isHidden(item)) {
+                continue;
+            }
+            const fullPath = path.join(dirPath, item);
+            // Calculate relative path from base for display
+            const relativePath = options.basePath === "."
+                ? item
+                : path.join(path.relative(path.resolve(rootDir, options.basePath), dirPath), item);
+            // Apply pattern filter if specified
+            if (options.pattern && !matchesGlobPattern(item, options.pattern)) {
+                // For directories, still recurse even if name doesn't match pattern
+                // (files inside might match)
+                try {
+                    const stats = await fs.stat(fullPath);
+                    if (stats.isDirectory()) {
+                        await listDirectoryRecursive(fullPath, rootDir, {
+                            ...options,
+                            currentDepth: options.currentDepth + 1,
+                        });
+                    }
+                }
+                catch {
+                    // Skip on error
+                }
+                continue;
+            }
+            const entry = await createDirectoryEntry(fullPath, relativePath);
+            if (entry) {
+                options.entries.push(entry);
+                // Recurse into directories
+                if (entry.type === "directory") {
+                    await listDirectoryRecursive(fullPath, rootDir, {
+                        ...options,
+                        currentDepth: options.currentDepth + 1,
+                    });
+                }
+            }
+        }
+    }
+    catch {
+        // Skip directories we can't read
+    }
+}
+/**
+ * List directory contents with filtering options.
+ *
+ * @param args - ListDirectoryArgs containing path and filtering options
+ * @param context - CodeContext with working directory
+ * @returns ListDirectoryResult with directory entries
+ */
+export async function listDirectory(args, context) {
+    const { path: dirPath = ".", pattern, recursive = false, include_hidden = false, max_depth, } = args;
+    // Validate path to prevent directory traversal
+    const pathValidation = validatePath(dirPath, context.workingDirectory);
+    if (!pathValidation.valid) {
+        return {
+            success: false,
+            path: dirPath,
+            entries: [],
+            total_count: 0,
+            error: pathValidation.error,
+        };
+    }
+    const resolvedPath = pathValidation.resolvedPath;
+    try {
+        // Check if path exists and is a directory
+        const stats = await fs.stat(resolvedPath);
+        if (!stats.isDirectory()) {
+            return {
+                success: false,
+                path: dirPath,
+                entries: [],
+                total_count: 0,
+                error: "Path is not a directory",
+            };
+        }
+        const entries = [];
+        if (recursive) {
+            // Recursive listing
+            const effectiveMaxDepth = max_depth ?? DEFAULT_MAX_DEPTH;
+            await listDirectoryRecursive(resolvedPath, context.workingDirectory, {
+                pattern,
+                includeHidden: include_hidden,
+                maxDepth: effectiveMaxDepth,
+                currentDepth: 0,
+                entries,
+                basePath: dirPath,
+            });
+        }
+        else {
+            // Non-recursive listing
+            const items = await fs.readdir(resolvedPath);
+            for (const item of items) {
+                // Check entry limit
+                if (entries.length >= MAX_ENTRIES) {
+                    break;
+                }
+                // Skip hidden files if not included
+                if (!include_hidden && isHidden(item)) {
+                    continue;
+                }
+                // Apply pattern filter if specified
+                if (pattern && !matchesGlobPattern(item, pattern)) {
+                    continue;
+                }
+                const fullPath = path.join(resolvedPath, item);
+                const entry = await createDirectoryEntry(fullPath, item);
+                if (entry) {
+                    entries.push(entry);
+                }
+            }
+        }
+        // Sort entries: directories first, then alphabetically
+        entries.sort((a, b) => {
+            if (a.type !== b.type) {
+                return a.type === "directory" ? -1 : 1;
+            }
+            return a.name.localeCompare(b.name);
+        });
+        return {
+            success: true,
+            path: dirPath,
+            entries,
+            total_count: entries.length,
+        };
+    }
+    catch (error) {
+        // Handle specific error types without exposing sensitive info (TR-5)
+        if (error instanceof Error) {
+            const nodeError = error;
+            if (nodeError.code === "ENOENT") {
+                return {
+                    success: false,
+                    path: dirPath,
+                    entries: [],
+                    total_count: 0,
+                    error: "Directory not found",
+                };
+            }
+            if (nodeError.code === "EACCES") {
+                return {
+                    success: false,
+                    path: dirPath,
+                    entries: [],
+                    total_count: 0,
+                    error: "Permission denied",
+                };
+            }
+            if (nodeError.code === "ENOTDIR") {
+                return {
+                    success: false,
+                    path: dirPath,
+                    entries: [],
+                    total_count: 0,
+                    error: "Path is not a directory",
+                };
+            }
+        }
+        // Generic error without exposing details (TR-5)
+        return {
+            success: false,
+            path: dirPath,
+            entries: [],
+            total_count: 0,
+            error: "Failed to list directory",
+        };
+    }
+}
+//# sourceMappingURL=list-directory.js.map

package/dist/src/lib/local-tools/code/list-directory.js.map

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

package/dist/src/lib/local-tools/code/read-file.js

@@ -0,0 +1,301 @@
+/**
+ * read_file tool - Read file contents with optional line range.
+ * Returns content with line numbers and language detection.
+ *
+ * Security: Implements path validation to prevent directory traversal (TR-5).
+ */
+import * as fs from "fs/promises";
+import * as path from "path";
+// Maximum file size to read (1MB default as per TR-5)
+const MAX_FILE_SIZE = 1024 * 1024;
+// Language detection map based on file extensions
+const EXTENSION_TO_LANGUAGE = {
+    // JavaScript/TypeScript
+    ".js": "javascript",
+    ".jsx": "javascript",
+    ".ts": "typescript",
+    ".tsx": "typescript",
+    ".mjs": "javascript",
+    ".cjs": "javascript",
+    ".mts": "typescript",
+    ".cts": "typescript",
+    // Python
+    ".py": "python",
+    ".pyw": "python",
+    ".pyi": "python",
+    // Web
+    ".html": "html",
+    ".htm": "html",
+    ".css": "css",
+    ".scss": "scss",
+    ".sass": "sass",
+    ".less": "less",
+    // Data formats
+    ".json": "json",
+    ".yaml": "yaml",
+    ".yml": "yaml",
+    ".xml": "xml",
+    ".toml": "toml",
+    // Shell
+    ".sh": "bash",
+    ".bash": "bash",
+    ".zsh": "zsh",
+    ".fish": "fish",
+    ".ps1": "powershell",
+    ".bat": "batch",
+    ".cmd": "batch",
+    // Other languages
+    ".go": "go",
+    ".rs": "rust",
+    ".rb": "ruby",
+    ".php": "php",
+    ".java": "java",
+    ".kt": "kotlin",
+    ".kts": "kotlin",
+    ".scala": "scala",
+    ".c": "c",
+    ".h": "c",
+    ".cpp": "cpp",
+    ".hpp": "cpp",
+    ".cc": "cpp",
+    ".cxx": "cpp",
+    ".cs": "csharp",
+    ".swift": "swift",
+    ".r": "r",
+    ".R": "r",
+    ".lua": "lua",
+    ".pl": "perl",
+    ".pm": "perl",
+    ".ex": "elixir",
+    ".exs": "elixir",
+    ".erl": "erlang",
+    ".hrl": "erlang",
+    ".clj": "clojure",
+    ".cljs": "clojure",
+    ".hs": "haskell",
+    ".ml": "ocaml",
+    ".mli": "ocaml",
+    ".fs": "fsharp",
+    ".fsx": "fsharp",
+    ".dart": "dart",
+    ".vue": "vue",
+    ".svelte": "svelte",
+    // Config/Docs
+    ".md": "markdown",
+    ".mdx": "markdown",
+    ".rst": "restructuredtext",
+    ".txt": "text",
+    ".ini": "ini",
+    ".cfg": "ini",
+    ".conf": "ini",
+    ".env": "dotenv",
+    ".gitignore": "gitignore",
+    ".dockerignore": "dockerignore",
+    ".editorconfig": "editorconfig",
+    // SQL
+    ".sql": "sql",
+    // GraphQL
+    ".graphql": "graphql",
+    ".gql": "graphql",
+    // Makefile
+    Makefile: "makefile",
+    makefile: "makefile",
+    // Dockerfile
+    Dockerfile: "dockerfile",
+    dockerfile: "dockerfile",
+};
+/**
+ * Detect language from file extension.
+ */
+function detectLanguage(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    const basename = path.basename(filePath);
+    // Check for special filenames first (Makefile, Dockerfile)
+    if (EXTENSION_TO_LANGUAGE[basename]) {
+        return EXTENSION_TO_LANGUAGE[basename];
+    }
+    return EXTENSION_TO_LANGUAGE[ext];
+}
+/**
+ * Validate and resolve a file path to prevent directory traversal.
+ * Returns the resolved absolute path if valid, or throws an error.
+ *
+ * Security (TR-5):
+ * - All paths normalized and validated against project root
+ * - Reject paths containing `..` that escape root
+ * - Use `path.resolve()` and check prefix
+ */
+function validatePath(filePath, workingDirectory) {
+    // Normalize the working directory to absolute path
+    const rootDir = path.resolve(workingDirectory);
+    // Resolve the requested path relative to working directory
+    const resolvedPath = path.resolve(rootDir, filePath);
+    // Security check: ensure resolved path is within root directory
+    // Use path.sep to ensure we're checking directory boundaries properly
+    const normalizedRoot = rootDir.endsWith(path.sep)
+        ? rootDir
+        : rootDir + path.sep;
+    const normalizedResolved = resolvedPath + path.sep;
+    if (!normalizedResolved.startsWith(normalizedRoot) &&
+        resolvedPath !== rootDir) {
+        return {
+            valid: false,
+            error: "Path validation failed: access denied",
+        };
+    }
+    return { valid: true, resolvedPath };
+}
+/**
+ * Format content with line numbers.
+ */
+function formatWithLineNumbers(lines, startLine, showLineNumbers) {
+    if (!showLineNumbers) {
+        return lines.join("\n");
+    }
+    const endLine = startLine + lines.length - 1;
+    const maxLineNumWidth = String(endLine).length;
+    return lines
+        .map((line, index) => {
+        const lineNum = startLine + index;
+        const paddedLineNum = String(lineNum).padStart(maxLineNumWidth, " ");
+        return `${paddedLineNum} | ${line}`;
+    })
+        .join("\n");
+}
+/**
+ * Read file contents with optional line range.
+ *
+ * @param args - ReadFileArgs containing path and optional line range
+ * @param context - CodeContext with working directory
+ * @returns ReadFileResult with file content and metadata
+ */
+export async function readFile(args, context) {
+    const { path: filePath, start_line, end_line, show_line_numbers = true } = args;
+    // Validate path to prevent directory traversal
+    const pathValidation = validatePath(filePath, context.workingDirectory);
+    if (!pathValidation.valid) {
+        return {
+            success: false,
+            path: filePath,
+            content: "",
+            total_lines: 0,
+            start_line: 0,
+            end_line: 0,
+            error: pathValidation.error,
+        };
+    }
+    const resolvedPath = pathValidation.resolvedPath;
+    try {
+        // Check if file exists and get stats
+        const stats = await fs.stat(resolvedPath);
+        // Ensure it's a file, not a directory
+        if (stats.isDirectory()) {
+            return {
+                success: false,
+                path: filePath,
+                content: "",
+                total_lines: 0,
+                start_line: 0,
+                end_line: 0,
+                error: "Path is a directory, not a file",
+            };
+        }
+        // Check file size limit (TR-5: Max file size limit for reading - 1MB default)
+        if (stats.size > MAX_FILE_SIZE) {
+            return {
+                success: false,
+                path: filePath,
+                content: "",
+                total_lines: 0,
+                start_line: 0,
+                end_line: 0,
+                error: `File exceeds maximum size limit of ${MAX_FILE_SIZE / 1024 / 1024}MB`,
+            };
+        }
+        // Read file content
+        const content = await fs.readFile(resolvedPath, "utf-8");
+        const allLines = content.split("\n");
+        const totalLines = allLines.length;
+        // Detect language from extension
+        const language = detectLanguage(filePath);
+        // Calculate line range (1-indexed, inclusive)
+        let effectiveStartLine = start_line ?? 1;
+        let effectiveEndLine = end_line ?? totalLines;
+        // Validate and clamp line numbers
+        if (effectiveStartLine < 1) {
+            effectiveStartLine = 1;
+        }
+        if (effectiveEndLine > totalLines) {
+            effectiveEndLine = totalLines;
+        }
+        if (effectiveStartLine > totalLines) {
+            effectiveStartLine = totalLines;
+        }
+        if (effectiveEndLine < effectiveStartLine) {
+            effectiveEndLine = effectiveStartLine;
+        }
+        // Extract requested lines (convert to 0-indexed for array slice)
+        const selectedLines = allLines.slice(effectiveStartLine - 1, effectiveEndLine);
+        // Format content with optional line numbers
+        const formattedContent = formatWithLineNumbers(selectedLines, effectiveStartLine, show_line_numbers);
+        return {
+            success: true,
+            path: filePath,
+            content: formattedContent,
+            total_lines: totalLines,
+            start_line: effectiveStartLine,
+            end_line: effectiveEndLine,
+            language,
+        };
+    }
+    catch (error) {
+        // Handle specific error types without exposing file contents (TR-5)
+        if (error instanceof Error) {
+            const nodeError = error;
+            if (nodeError.code === "ENOENT") {
+                return {
+                    success: false,
+                    path: filePath,
+                    content: "",
+                    total_lines: 0,
+                    start_line: 0,
+                    end_line: 0,
+                    error: "File not found",
+                };
+            }
+            if (nodeError.code === "EACCES") {
+                return {
+                    success: false,
+                    path: filePath,
+                    content: "",
+                    total_lines: 0,
+                    start_line: 0,
+                    end_line: 0,
+                    error: "Permission denied",
+                };
+            }
+            if (nodeError.code === "EISDIR") {
+                return {
+                    success: false,
+                    path: filePath,
+                    content: "",
+                    total_lines: 0,
+                    start_line: 0,
+                    end_line: 0,
+                    error: "Path is a directory, not a file",
+                };
+            }
+        }
+        // Generic error without exposing details (TR-5: Never include file contents in error messages)
+        return {
+            success: false,
+            path: filePath,
+            content: "",
+            total_lines: 0,
+            start_line: 0,
+            end_line: 0,
+            error: "Failed to read file",
+        };
+    }
+}
+//# sourceMappingURL=read-file.js.map

package/dist/src/lib/local-tools/code/read-file.js.map

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