Function handleDescribePath

projects/electron/src/modules/code/files.ts:542–686

(params: DescribePathParams)

// ============================================================================

async function handleDescribePath(params: DescribePathParams): Promise<DescribePathResponse> {
    const {
        path: targetPath,
        readContents = false,
        maxReadSize,
        showHidden = false,
    } = params

    logger.info("[Files:describePath] Describing path", JSON.stringify({ targetPath, readContents, maxReadSize, showHidden }))

    // Check existence
    if (!fs.existsSync(targetPath)) {
        return { type: "not_found", path: targetPath }
    }

    let stats: fs.Stats
    try {
        stats = fs.lstatSync(targetPath)
    } catch (err) {
        return {
            type: "error",
            path: targetPath,
            message: err instanceof Error ? err.message : "Failed to stat path",
        }
    }

    const mode = stats.mode

    // Handle directory
    if (stats.isDirectory()) {
        const entries: PathEntry[] = []

        try {
            const rawEntries = fs.readdirSync(targetPath, { withFileTypes: true })

            for (const entry of rawEntries) {
                // Skip hidden unless requested
                if (!showHidden && entry.name.startsWith(".")) continue

                const fullPath = path.join(targetPath, entry.name)
                let entrySize = 0
                let entryMode = 0

                try {
                    const entryStat = fs.statSync(fullPath)
                    entrySize = entryStat.size
                    entryMode = entryStat.mode
                } catch (err) {
                    logger.debug('[Files] Error statting entry, skipping:', err)
                    continue  // Skip entries we can't stat
                }

                entries.push({
                    name: entry.name,
                    path: fullPath,
                    isDir: entry.isDirectory(),
                    isSymlink: entry.isSymbolicLink(),
                    size: entrySize,