feat(cli): Add workspace storage purge command

[cameroncooke]

Adds an explicit xcodebuildmcp purge command for reviewing and cleaning XcodeBuildMCP-managed workspace storage. The new command supports report, dry-run, delete, and interactive flows, keeps DerivedData cleanup opt-in, and revalidates deletion candidates under workspace filesystem locks before removing anything.

The storage model stays conservative: existing lifecycle cleanup remains narrow, while this command gives users a deliberate path to inspect and clean logs, result bundles, state transients, and explicitly selected DerivedData.

Local validation could not run in this environment because node is missing from PATH, which also blocked the pre-commit hook. CI should be used as the validation source for this draft.

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Autofix Details

Bugbot Autofix prepared a fix for the issue found in the latest run.

• ✅ Fixed: Older-than ignores stale contents
  • Changed effectiveMtimeMs calculation to use descendant mtime instead of Math.max with directory mtime, ensuring directories with stale contents but fresh metadata are correctly identified as purge candidates.

Or push these changes by commenting:

@cursor push bcbb0e215b

Preview (bcbb0e215b)

diff --git a/src/utils/purge-storage/planning.ts b/src/utils/purge-storage/planning.ts
--- a/src/utils/purge-storage/planning.ts
+++ b/src/utils/purge-storage/planning.ts
@@ -130,8 +130,7 @@
   }
 
   const scan = await scanPath(params.candidatePath);
-  const effectiveMtimeMs =
-    scan.latestMtimeMs === null ? stat.mtimeMs : Math.max(stat.mtimeMs, scan.latestMtimeMs);
+  const effectiveMtimeMs = scan.latestMtimeMs ?? stat.mtimeMs;
 
   const retentionReason = shouldKeepForRetention({
     mtimeMs: effectiveMtimeMs,

_{You can send follow-ups to the cloud agent here.}

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Autofix Details

Bugbot Autofix prepared a fix for the issue found in the latest run.

• ✅ Fixed: Invalid workspace dirs crash purge
  • Added filtering in listWorkspaceKeys to skip relative path segment directory names (., .., empty) with warnings before they reach normalizeWorkspaceKey validation.

Or push these changes by commenting:

@cursor push 1fe59e7789

Preview (1fe59e7789)

diff --git a/src/utils/purge-storage/enumerate.ts b/src/utils/purge-storage/enumerate.ts
--- a/src/utils/purge-storage/enumerate.ts
+++ b/src/utils/purge-storage/enumerate.ts
@@ -191,6 +191,12 @@
       );
       continue;
     }
+    if (entry.name === '.' || entry.name === '..' || entry.name.trim() === '') {
+      warnings.push(
+        warningForPath(entryPath, 'workspace key is a relative path segment and was skipped'),
+      );
+      continue;
+    }
     if (entry.isSymbolicLink()) {
       warnings.push(warningForPath(entryPath, 'workspace symbolic link skipped'));
       continue;

_{You can send follow-ups to the cloud agent here.}

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/xcodebuildmcp@469

commit: 0c602d0

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit c6e5e29. Configure here.}