René's URL Explorer Experiment

Title: feat(cli): deepnote sync — ZIP-per-notebook export + inverse-ZIP push (GRN-5421) by jamesbhobbs · Pull Request #451 · deepnote/deepnote · GitHub

Open Graph Title: feat(cli): deepnote sync — ZIP-per-notebook export + inverse-ZIP push (GRN-5421) by jamesbhobbs · Pull Request #451 · deepnote/deepnote

X Title: feat(cli): deepnote sync — ZIP-per-notebook export + inverse-ZIP push (GRN-5421) by jamesbhobbs · Pull Request #451 · deepnote/deepnote

Description: Reworks the deepnote sync CLI (#429, Wojtek's branch) for the export endpoint that shipped, and implements the push direction as the exact inverse of export. Stacked on #429, which is left untouched. This branch is Wojtek's two sync commits rebased onto main (his PR was CONFLICTING) plus two commits on top: the ZIP pull rework, then the inverse-ZIP push. Why #429 was built against the single-document export from the original enablement PR (deepnote-internal #20511). The endpoint that merged — deepnote-internal #20596 — instead returns a ZIP with one .deepnote document per notebook. Every layer assumed one file per project, so that had to be reworked. Two other drifts fixed here: folder.path is now { id, name } segments + isPathComplete (not string[]), and only the documents are deterministic (never the ZIP container), so the content hash is computed over the documents. Pull (commit 1) Layer Change @deepnote/cloud exportProject unzips the export into { filename, content }[] (adds fflate); folder schema/types fixed. sync-paths a directory per project (//, one .deepnote per notebook); .files/ inside it. sync-manifest { dir, notebooks[], contentHash, ... }, hash over the exploded documents. sync command pull writes one file per notebook, deletes files for notebooks removed in the cloud; rename moves the directory. Push (commit 2) — the exact inverse of export Rather than defer push behind an undecided contract, this defines the contract by writing the client for it. Push re-uploads the same ZIP of .deepnote documents the export produced — no re-merge, no re-serialization — to POST /v2/projects/{id}/import, with baseModifiedAt + baseContentHash for lost-update protection. Because the unit is identical in both directions, the baseContentHash question dissolves: both sides hash the exploded documents the same way (algorithm specified in the contract doc). @deepnote/cloud: importProject(files, opts) POSTs a ZIP (application/zip); new uploadProjectFile / deleteProjectFile (real, already-deployed POST/DELETE /v2/files). sync command: local-only edit → import → re-export → write back; 409 → override/skip; empty local project confirmed before delete-all; --all-files uploads changed local files on push (delete-then-upload, since POST /v2/files won't overwrite). POST /v2/projects/{id}/import is not deployed yet. A 404/501 degrades to push-deferred (edit kept, nothing lost), so the client ships safely ahead of the server. 📋 The contract for the server authors packages/cloud/docs/project-import-contract.md is the spec to implement against: ZIP-in reconciliation semantics, the exact canonical content-hash algorithm (so both sides match), params, responses, and errors. The client in this PR is the reference implementation. Testing Full pnpm test: 164 files, 2846 passed, 0 failures (nested worktree + .env parked per the local-env quirk). pnpm typecheck, biome, prettier, cspell all clean. New coverage: ZIP explode; dir-per-project planning; per-notebook pull + deleted-notebook cleanup; push (import ZIP body + base fingerprints, re-export write-back); 409 skip/override; 404 → graceful push-deferred; --all-files upload (delete-then-upload); uploadProjectFile/deleteProjectFile; canonical-hash order-independence. Not yet done: live verification against production (the export ZIP and the import endpoint may not be deployed to api.deepnote.com yet). 🤖 Generated with Claude Code Summary by CodeRabbit New Features Added deepnote sync [dir] to mirror cloud projects locally in both directions. Supports dry runs, conflict handling, pruning, JSON output, renames, and incremental working-directory file synchronization. Detects unchanged content, tracks synchronization state, and helps prevent unintended overwrites. Added cloud operations for listing, exporting, importing, downloading, uploading, and deleting project files. Added safe path handling and file-size safeguards for synchronized files. Documentation Added CLI, cloud API, and sync command reference documentation.

Open Graph Description: Reworks the deepnote sync CLI (#429, Wojtek's branch) for the export endpoint that shipped, and implements the push direction as the exact inverse of export. Stacked on #429, which is left unt...

X Description: Reworks the deepnote sync CLI (#429, Wojtek's branch) for the export endpoint that shipped, and implements the push direction as the exact inverse of export. Stacked on #429, which is left...

Opengraph URL: https://github.com/deepnote/deepnote/pull/451

X: @github

direct link

Domain: github.com

Links:

Viewport: width=device-width