feat: add full snapshots and stronger restore

Author: GeminiLight

.github/workflows/publish-python.yml

@@ -113,12 +113,12 @@ jobs:
           echo "::notice::Skipped PyPI upload. Configure PYPI_API_TOKEN or run this workflow with publish_to_pypi=true after setting up PyPI Trusted Publishing."
 
       - name: Publish to npm registry
-        if: ${{ env.NPM_TOKEN != '' && inputs.publish_to_npm == 'true' }}
+        if: ${{ env.NPM_TOKEN != '' && (github.event_name == 'release' || inputs.publish_to_npm == 'true') }}
         run: |
           echo "//registry.npmjs.org/:_authToken=${NPM_TOKEN}" > ~/.npmrc
           npm publish dist/cc-branch-*.tgz --access public
 
       - name: Report npm skip
-        if: ${{ env.NPM_TOKEN == '' || inputs.publish_to_npm != 'true' }}
+        if: ${{ env.NPM_TOKEN == '' || (github.event_name != 'release' && inputs.publish_to_npm != 'true') }}
         run: |
-          echo "::notice::Skipped npm registry upload. Configure NPM_TOKEN and run this workflow with publish_to_npm=true to publish cc-branch to npm."
+          echo "::notice::Skipped npm registry upload. Configure NPM_TOKEN; workflow_dispatch also requires publish_to_npm=true."

CHANGELOG.md

@@ -5,6 +5,17 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.4.0] - 2026-06-14
+
+### Added
+- Added file-level workspace snapshots with `cc-branch snapshot create --include-files`, restore preview file diffs, and `snapshot restore --state-only`.
+- Added `cc-branch session restore --session-id` and matching Web API support for binding a specific agent-native session.
+- Added remote agent selection to the desktop/Web SSH Add Project flow.
+- Added automatic npm registry publishing on GitHub release events when `NPM_TOKEN` is configured.
+
+### Changed
+- Workspace snapshot file capture now prunes heavy runtime/build directories and enforces bounded file-size and total-size limits.
+
 ## [1.3.0] - 2026-06-14
 
 ### Added
@@ -62,6 +73,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Tmux and direct-layout workspace execution, SSH targets, opener integrations, diagnostics, and local project index.
 - Desktop release packaging with bundled backend sidecar and GitHub release verification.
 
+[1.4.0]: https://github.com/GeminiLight/cc-branch/releases/tag/v1.4.0
 [1.3.0]: https://github.com/GeminiLight/cc-branch/releases/tag/v1.3.0
 [1.1.5]: https://github.com/GeminiLight/cc-branch/releases/tag/v1.1.5
 [1.1.4]: https://github.com/GeminiLight/cc-branch/releases/tag/v1.1.4

apps/desktop/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cc-branch/desktop",
   "private": true,
-  "version": "1.3.0",
+  "version": "1.4.0",
   "type": "module",
   "scripts": {
     "tauri": "tauri",

apps/desktop/src-tauri/Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "cc-branch"
-version = "1.3.0"
+version = "1.4.0"
 description = "CC Branch Desktop App"
 authors = ["GeminiLight"]
 license = "MIT"

apps/desktop/src-tauri/Cargo.toml

@@ -1,7 +1,7 @@
 {
   "$schema": "https://schema.tauri.app/config/2",
   "productName": "CC Branch",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "identifier": "com.gemini-light.cc-branch",
   "build": {
     "frontendDist": "../../web/dist",

apps/desktop/src-tauri/tauri.conf.json

@@ -1,7 +1,7 @@
 {
   "name": "@cc-branch/apps",
   "private": true,
-  "version": "1.3.0",
+  "version": "1.4.0",
   "type": "module",
   "scripts": {
     "dev": "cd web && npm run dev",

apps/package-lock.json

@@ -1,7 +1,7 @@
 {
   "name": "@cc-branch/web",
   "private": true,
-  "version": "1.3.0",
+  "version": "1.4.0",
   "type": "module",
   "scripts": {
     "dev": "vite",

apps/package.json

@@ -474,7 +474,7 @@ describe("HTTPClient workspace scope", () => {
     const client = new HTTPClient();
     await client.getAgentBus({ projectPath: "/tmp/demo", target: "dev:planner" });
     await client.markAgentInboxRead({ projectPath: "/tmp/demo" }, "dev:planner");
-    await client.restoreSessions({ projectPath: "/tmp/demo" });
+    await client.restoreSessions({ projectPath: "/tmp/demo" }, { sessionId: "session-1", dryRun: true });
 
     expect(fetchMock).toHaveBeenNthCalledWith(
       1,
@@ -496,7 +496,7 @@ describe("HTTPClient workspace scope", () => {
       {
         method: "POST",
         headers: { "Content-Type": "application/json" },
-        body: "{}",
+        body: JSON.stringify({ session_id: "session-1", dry_run: true }),
       },
     );
   });
@@ -535,8 +535,8 @@ describe("HTTPClient workspace scope", () => {
 
     const client = new HTTPClient();
     await client.getSnapshots({ projectPath: "/tmp/demo" });
-    await client.createSnapshot({ projectPath: "/tmp/demo" }, "after-change");
-    await client.restoreSnapshot({ projectPath: "/tmp/demo" }, "snap-1");
+    await client.createSnapshot({ projectPath: "/tmp/demo" }, "after-change", { includeFiles: true });
+    await client.restoreSnapshot({ projectPath: "/tmp/demo" }, "snap-1", { restoreFiles: false });
     await client.getWorktrees({ projectPath: "/tmp/demo" });
     await client.setupWorktree({ projectPath: "/tmp/demo" }, { target: "dev:planner", branch: "cc-branch/dev-planner" });
     await client.finishWorktree({ projectPath: "/tmp/demo" }, "dev:planner");
@@ -545,11 +545,11 @@ describe("HTTPClient workspace scope", () => {
     expect(fetchMock).toHaveBeenNthCalledWith(1, "/api/snapshots?project_path=%2Ftmp%2Fdemo", { signal: undefined });
     expect(fetchMock).toHaveBeenNthCalledWith(2, "/api/snapshots/create?project_path=%2Ftmp%2Fdemo", expect.objectContaining({
       method: "POST",
-      body: JSON.stringify({ name: "after-change" }),
+      body: JSON.stringify({ name: "after-change", include_files: true }),
     }));
     expect(fetchMock).toHaveBeenNthCalledWith(3, "/api/snapshots/restore?project_path=%2Ftmp%2Fdemo", expect.objectContaining({
       method: "POST",
-      body: JSON.stringify({ id: "snap-1" }),
+      body: JSON.stringify({ id: "snap-1", restore_files: false }),
     }));
     expect(fetchMock).toHaveBeenNthCalledWith(4, "/api/worktrees?project_path=%2Ftmp%2Fdemo", { signal: undefined });
     expect(fetchMock).toHaveBeenNthCalledWith(5, "/api/worktrees/setup?project_path=%2Ftmp%2Fdemo", expect.objectContaining({