René's URL Explorer Experiment

Title: feat(cloud-sync): add @deepnote/cloud-sync with sync manifest and path modules by tkislan · Pull Request #554 · deepnote/deepnote · GitHub

Open Graph Title: feat(cloud-sync): add @deepnote/cloud-sync with sync manifest and path modules by tkislan · Pull Request #554 · deepnote/deepnote

X Title: feat(cloud-sync): add @deepnote/cloud-sync with sync manifest and path modules by tkislan · Pull Request #554 · deepnote/deepnote

Description: Summary Handling of the .deepnote-sync.json manifest and local path planning lived in packages/cli/src/utils/, where no other package could import them. This adds a Node-only workspace package, @deepnote/cloud-sync (packages/cloud-sync/), that owns both modules; @deepnote/cli now imports them from it. It is the base for extracting the sync engine, app publishing and Streamlit registration, and gives other consumers (e.g. the VS Code extension) a public API for reading the sync manifest. CLI behavior is unchanged: no change to flags, output, exit codes or the manifest format (version: 1). Changes New package packages/cloud-sync: package.json, tsdown.config.ts, README.md and src/index.ts, following the @deepnote/cloud library-package convention. Depends on @deepnote/cloud and zod. Moved with git mv (history is preserved, git log --follow works): sync-manifest.ts, sync-paths.ts and their tests. The only edit to a moved file is sync-manifest.ts importing isErrnoENOENT from ./fs-errors. src/fs-errors.ts: package-local isErrnoENOENT. The CLI's file-resolver.ts stays in the CLI because it imports the CLI's output helpers. Not exported from index.ts. src/index.ts exports exactly the symbols the CLI uses (11 from sync-manifest, 5 from sync-paths); emptySyncManifest, sanitizePathSegment, PROJECT_FILES_DIR_NAME, FolderPathSegment and PlannableProject stay module-internal. CLI: imports, the vi.mock/vi.importActual specifiers in commands/sync.test.ts, the ManifestFileRecord import in utils/publish-mirror.test.ts, and the dependency in packages/cli/package.json. Docs: package lists in AGENTS.md and CONTRIBUTING.md; the package README documents the manifest read API as the supported way to detect and read synced folders. Verification Run on this branch: pnpm typecheck, pnpm biome:check and pnpm prettier:check exit 0. pnpm --filter @deepnote/cloud-sync run build produces dist/index.js, dist/index.cjs and dist/index.d.ts; pnpm --filter '@deepnote/cli...' run build builds @deepnote/cloud-sync before @deepnote/cli. pnpm install --frozen-lockfile accepts the lockfile. Tests (vitest run): 3373 passed, 3 failed. The 3 failures are in packages/cli/src/commands/run.test.ts and fail identically on main without this change. All 35 moved tests and every sync / publish-mirror / publish CLI test pass. packages/cloud-sync/src (non-test) has no import of commander, chalk, ora, @inquirer/prompts, dotenv or @deepnote/cli, and no process. or console. reference. Beyond the spec: fs-errors.test.ts adds 8 tests for the new helper. I confirmed that a mutant requiring instanceof Error fails the plain-object case. pnpm-lock.yaml contains only the new packages/cloud-sync importer and the CLI's link. A newer local pnpm also wanted to add unrelated deprecated: lines to @yuku-* packages; I left those out. Before releasing @deepnote/cli pnpm publish rewrites workspace:* to the exact sibling version, so @deepnote/cloud-sync must be on npm before the first @deepnote/cli release that includes this change: Publish a GitHub Release tagged @deepnote/cloud-sync@0.1.0 (needs release rights and the release environment's NPM_TOKEN). Wait for cd.yml to finish; npm view @deepnote/cloud-sync@0.1.0 version should print 0.1.0. Release @deepnote/cli as usual. If the publish step fails with 403/404, the npm token lacks permission to create new packages in the @deepnote scope and an npm organization owner needs to grant it. 🤖 Generated with Claude Code https://claude.ai/code/session_01NZwreo9KDxDk4VuSXgzmC2 Summary by CodeRabbit New Features Added a reusable package for syncing local folders with Deepnote Cloud and publishing apps, now used by the CLI. Documentation Added package documentation covering installation, configuration, manifest tools, and local-path utilities. Updated repository guides to include the new package.

Open Graph Description: Summary Handling of the .deepnote-sync.json manifest and local path planning lived in packages/cli/src/utils/, where no other package could import them. This adds a Node-only workspace package, @de...

X Description: Summary Handling of the .deepnote-sync.json manifest and local path planning lived in packages/cli/src/utils/, where no other package could import them. This adds a Node-only workspace package, @de...

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

X: @github

direct link

Domain: github.com

Links:

Viewport: width=device-width