Function findDeepnoteFileInDirectory

packages/cli/src/utils/file-resolver.ts:127–160

* Find the first .deepnote file in a directory (sorted alphabetically).

(
  dirPath: string,
  options: ResolveDeepnoteFileOptions
)

 * Find the first .deepnote file in a directory (sorted alphabetically).
 */
async function findDeepnoteFileInDirectory(
  dirPath: string,
  options: ResolveDeepnoteFileOptions
): Promise<ResolvedFile> {
  const entries = await readdir(dirPath, { withFileTypes: true }).catch((err: unknown) => {
    const code = (err as NodeJS.ErrnoException | undefined)?.code
    if (code === 'ENOENT') {
      throw new FileResolutionError(`Directory not found: ${dirPath}`)
    }
    throw err
  })

  // Filter for actual files (not directories) with .deepnote extension
  const deepnoteFiles = entries
    .filter(entry => entry.isFile() && entry.name.toLowerCase().endsWith('.deepnote'))
    .map(entry => entry.name)
    .sort()

  if (deepnoteFiles.length === 0) {
    const defaultMessage = `No .deepnote files found in: ${dirPath}\n\nCreate a .deepnote file or specify a path to one.`
    throw new FileResolutionError(options.noFilesFoundMessage ?? defaultMessage)
  }

  const selectedFile = deepnoteFiles[0]
  const absolutePath = resolve(dirPath, selectedFile)

  debug(`Auto-selected .deepnote file: ${absolutePath}`)

  if (deepnoteFiles.length > 1) {
    debug(`Note: ${deepnoteFiles.length} .deepnote files found, using first alphabetically: ${selectedFile}`)
  }

  return { absolutePath }
}

/**
 * Suggest similar files if the specified file doesn't exist.