Function resolvePathToDeepnoteFile

packages/cli/src/utils/file-resolver.ts:85–122

(
  path: string | undefined,
  options: ResolveDeepnoteFileOptions = {}
)

 * @throws FileResolutionError if no .deepnote file found or file is invalid
 */
export async function resolvePathToDeepnoteFile(
  path: string | undefined,
  options: ResolveDeepnoteFileOptions = {}
): Promise<ResolvedFile> {
  // If no path provided, search current directory
  if (!path) {
    debug('No path provided, searching current directory for .deepnote files')
    return findDeepnoteFileInDirectory(process.cwd(), options)
  }

  const absolutePath = resolve(process.cwd(), path)
  debug(`Resolved path: ${absolutePath}`)

  const fileStat = await stat(absolutePath).catch((err: unknown) => {
    const code = (err as NodeJS.ErrnoException | undefined)?.code
    // Only treat ENOENT/ENOTDIR as "not found", rethrow other errors (permission denied, I/O failures)
    if (code === 'ENOENT' || code === 'ENOTDIR') return null
    throw err
  })
  if (!fileStat) {
    const suggestion = await suggestSimilarFiles(path)
    throw new FileResolutionError(`File not found: ${absolutePath}${suggestion}`)
  }

  // If it's a directory, find first .deepnote file in it
  if (fileStat.isDirectory()) {
    debug(`Path is a directory, searching for .deepnote files in: ${absolutePath}`)
    return findDeepnoteFileInDirectory(absolutePath, options)
  }

  const ext = extname(absolutePath).toLowerCase()
  if (ext !== '.deepnote') {
    const hint = getSupportedFileHint(ext)
    throw new FileResolutionError(`Unsupported file type: ${ext || '(no extension)'}\n\n${hint}`)
  }

  return { absolutePath }
}

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