Function computeDiff

packages/cli/src/commands/diff.ts:115–209

* Compute the structural diff between two .deepnote files.

(
  path1: string,
  path2: string,
  file1: DeepnoteFile,
  file2: DeepnoteFile,
  options: DiffOptions
)

 * Compute the structural diff between two .deepnote files.
 */
function computeDiff(
  path1: string,
  path2: string,
  file1: DeepnoteFile,
  file2: DeepnoteFile,
  options: DiffOptions
): DiffResult {
  const notebooks1 = new Map(file1.project.notebooks.map(nb => [nb.id, nb]))
  const notebooks2 = new Map(file2.project.notebooks.map(nb => [nb.id, nb]))

  const notebookDiffs: NotebookDiff[] = []
  const summary = {
    notebooksAdded: 0,
    notebooksRemoved: 0,
    notebooksModified: 0,
    notebooksUnchanged: 0,
    blocksAdded: 0,
    blocksRemoved: 0,
    blocksModified: 0,
    blocksUnchanged: 0,
  }

  // Find removed and modified notebooks
  for (const [id, nb1] of notebooks1) {
    const nb2 = notebooks2.get(id)
    if (!nb2) {
      // Notebook removed
      notebookDiffs.push({
        name: nb1.name,
        id,
        status: 'removed',
        blockCount: nb1.blocks.length,
      })
      summary.notebooksRemoved++
      summary.blocksRemoved += nb1.blocks.length
    } else {
      // Notebook exists in both - compare blocks and name
      const blockDiffs = computeBlockDiffs(nb1.blocks, nb2.blocks, options)
      const hasBlockChanges = blockDiffs.some(bd => bd.status !== 'unchanged')
      const wasRenamed = nb1.name !== nb2.name
      const hasChanges = hasBlockChanges || wasRenamed

      if (hasChanges) {
        notebookDiffs.push({
          name: nb2.name,
          ...(wasRenamed && { oldName: nb1.name }),
          id,
          status: 'modified',
          blockDiffs: blockDiffs.filter(bd => bd.status !== 'unchanged'),
        })
        summary.notebooksModified++
      } else {
        notebookDiffs.push({
          name: nb2.name,
          id,
          status: 'unchanged',
        })
        summary.notebooksUnchanged++