Function setupProject

packages/cli/src/commands/run.ts:261–356

* Common project setup: resolve path, parse/convert file, validate requirements. * Shared by both runDeepnoteProject and dryRunDeepnoteProject. * * Supports multiple file formats: * - .deepnote - Native format (no conversion) * - .ipynb - Jupyter Notebook (auto-converted) * - .py - Percent or

(path: string | undefined, options: RunOptions)

 * - .qmd - Quarto document (auto-converted)
 */
async function setupProject(path: string | undefined, options: RunOptions): Promise<ProjectSetup> {
  const isMachineOutput = options.output !== undefined

  let file: DeepnoteFile
  let absolutePath: string
  let convertedFile: LoadedRunnableFile
  let workingDirectory: string

  if (!path && options.prompt) {
    file = createPromptOnlyFile(options.prompt)
    absolutePath = join(process.cwd(), 'prompt.deepnote')
    workingDirectory = options.cwd ?? process.cwd()
    convertedFile = { file, originalPath: absolutePath, format: 'deepnote', wasConverted: true }
    if (!isMachineOutput) {
      log(getChalk().dim('Running agent block...'))
    }
  } else {
    if (!path) {
      throw new Error('A file path is required when --prompt is not provided')
    }
    convertedFile = await resolveAndConvertToDeepnote(path)
    const { originalPath, wasConverted, format } = convertedFile
    file = convertedFile.file
    absolutePath = originalPath
    workingDirectory = options.cwd ?? dirname(absolutePath)
    if (!isMachineOutput) {
      if (wasConverted) {
        log(getChalk().dim(`Converting ${format} file: ${absolutePath}...`))
      } else {
        log(getChalk().dim(`Parsing ${absolutePath}...`))
      }
    }
  }

  // Sibling-init resolution only applies to native .deepnote files (handled inside the shared helper).
  const resolved = await resolveAndComposeInitIfNeeded(convertedFile)
  file = resolved.file
  emitInitResolverWarnings(resolved.warnings, isMachineOutput)

  if (path && options.prompt) {
    const lastNotebook = file.project.notebooks[file.project.notebooks.length - 1]
    if (lastNotebook) {
      lastNotebook.blocks.push(createAgentBlock(options.prompt, lastNotebook.blocks.length))
    } else {
      throw new Error('Cannot append prompt: file contains no notebooks')
    }
  }

  dotenv.config({ path: join(workingDirectory, DEFAULT_ENV_FILE), quiet: true })

  const pythonEnv = await resolvePythonExecutable(options.python ?? detectDefaultPython())

  const inputs = parseInputs(options.input)

  // Parse integrations file (if it exists)
  const integrationsFilePath = getDefaultIntegrationsFilePath(workingDirectory)
  const parsedIntegrations = await parseIntegrationsFile(integrationsFilePath)