From 4518a3aaa942dfd83feaa9448188c79bea0b7193 Mon Sep 17 00:00:00 2001
From: digua <i@digua.me>
Date: Sat, 18 Jul 2026 15:12:22 +0800
Subject: [PATCH] docs(data): explain skipped-file cleanup policy

Clarify that skipped files can leave unique data on either side, so cleanup records intentionally remain unchanged and deletion performs the final active-path safety check.
---
 packages/node-runtime/src/data-dir-switch.ts | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/node-runtime/src/data-dir-switch.ts b/packages/node-runtime/src/data-dir-switch.ts
index 273e3621..7d8f0d34 100644
--- a/packages/node-runtime/src/data-dir-switch.ts
+++ b/packages/node-runtime/src/data-dir-switch.ts
@@ -261,6 +261,7 @@ export function runPendingDataDirMigration(
 
   deps.writeUserDataDir(pending.to)
 
+  // Skipped files may leave unique data in either directory, so cleanup records stay unchanged; deletion revalidates active paths.
   if (pending.migrate && path.resolve(pending.from) !== path.resolve(pending.to) && stats.skipped === 0) {
     deps.recordPendingCleanup?.(pending.from, pending.to)
   } else if (stats.skipped > 0) {