vexp-cli 3.3.0 → 3.3.1

package/dist/agent-config.js

@@ -2074,8 +2074,9 @@ export function configureZcodeMcp(workspaceRoot, binaryPath) {
 export function zcodeUserConfigPath() {
     return path.join(os.homedir(), ".zcode", "cli", "config.json");
 }
-/** Does this UserPromptSubmit entry belong to us? Ours runs the vexp binary's `prompt-hint`. */
-function isVexpZcodeHookEntry(h) {
+/** Does this UserPromptSubmit entry belong to us? Ours runs the vexp binary's `prompt-hint`.
+ *  Exported for doctor, which must recognise the entry exactly as setup does. */
+export function isVexpZcodeHookEntry(h) {
     if (!h || typeof h !== "object")
         return false;
     const hks = h.hooks;

package/dist/cloud-sync.js

@@ -0,0 +1,98 @@
+/**
+ * Cloud-synced workspace detection for doctor.
+ *
+ * Field report (2026-09-28, macOS, ZCode): the project lived under
+ * ~/Library/Mobile Documents/com~apple~CloudDocs, i.e. in iCloud Drive.
+ * Every file there is uploaded as it changes, .vexp/index.db included: a live
+ * SQLite database (plus its -wal and -shm) that the daemon rewrites on every
+ * index pass and every ledger row. On one machine that is sync traffic for
+ * nothing; opened from a second machine the sync client merges nothing and
+ * leaves "index (conflicted copy).db" files, or a database whose WAL and main
+ * file come from two different writers. Nothing in doctor said where the
+ * project was. Pure: the caller passes the platform, home and environment,
+ * so every rule is testable on any host.
+ */
+import * as path from "path";
+/** The provider macOS names its File Provider folders after
+ *  (~/Library/CloudStorage/<Provider>-<account>). */
+const CLOUD_STORAGE_PROVIDERS = [
+    [/^dropbox/i, "Dropbox"],
+    [/^onedrive/i, "OneDrive"],
+    [/^googledrive/i, "Google Drive"],
+    [/^box/i, "Box"],
+];
+/** `dir` itself or a folder under it; case-folded where the platform's
+ *  default filesystem is (APFS/HFS+ on macOS, NTFS on Windows). */
+function isUnder(child, dir, platform) {
+    const p = platform === "win32" ? path.win32 : path.posix;
+    const fold = platform === "win32" || platform === "darwin";
+    const a = fold ? p.resolve(dir).toLowerCase() : p.resolve(dir);
+    const b = fold ? p.resolve(child).toLowerCase() : p.resolve(child);
+    const rel = p.relative(a, b);
+    return rel === "" || (rel !== ".." && !rel.startsWith(".." + p.sep) && !p.isAbsolute(rel));
+}
+/**
+ * The sync service that holds `root`, with the synced folder it was found
+ * under, or null. Only folders whose whole content a sync client uploads:
+ * iCloud Drive and the macOS File Provider folders, the OneDrive folders
+ * Windows exports as environment variables, and ~/Dropbox anywhere.
+ */
+export function cloudSyncProvider(root, ctx) {
+    const p = ctx.platform === "win32" ? path.win32 : path.posix;
+    if (!root || !ctx.home)
+        return null;
+    if (ctx.platform === "darwin") {
+        const icloud = p.join(ctx.home, "Library", "Mobile Documents");
+        if (isUnder(root, icloud, ctx.platform)) {
+            return { provider: "iCloud Drive", folder: icloud };
+        }
+        // With "Desktop & Documents Folders" on, com~apple~CloudDocs/Desktop
+        // and /Documents are symlinks to the real ~/Desktop and ~/Documents, so
+        // a project there is spelled ~/Desktop/... by process.cwd() and by
+        // realpath alike, and never matches the Mobile Documents prefix (the
+        // field report's path went through CloudDocs/Desktop, 2026-09-28).
+        for (const dir of ctx.icloudLinked ?? []) {
+            if (dir && isUnder(root, dir, ctx.platform))
+                return { provider: "iCloud Drive", folder: dir };
+        }
+        const storage = p.join(ctx.home, "Library", "CloudStorage");
+        // The first component under CloudStorage is the provider's folder;
+        // CloudStorage itself is only their parent.
+        // Sliced, not path.relative'd: the case-folded match above may have
+        // matched a root spelled in another case than home.
+        const first = isUnder(root, storage, ctx.platform) ? p.resolve(root).slice(p.resolve(storage).length + 1).split(p.sep)[0] : "";
+        if (first) {
+            const known = CLOUD_STORAGE_PROVIDERS.find(([re]) => re.test(first));
+            const provider = known ? known[1] : first.split("-")[0] || "a cloud storage provider";
+            return { provider, folder: p.join(storage, first) };
+        }
+    }
+    if (ctx.platform === "win32") {
+        for (const key of ["OneDrive", "OneDriveConsumer", "OneDriveCommercial"]) {
+            const dir = envValue(ctx.env, key);
+            if (dir && p.isAbsolute(dir) && isUnder(root, dir, ctx.platform))
+                return { provider: "OneDrive", folder: dir };
+        }
+    }
+    const dropbox = p.join(ctx.home, "Dropbox");
+    if (isUnder(root, dropbox, ctx.platform))
+        return { provider: "Dropbox", folder: dropbox };
+    return null;
+}
+/** Windows environment keys are case-insensitive; a plain object here is not. */
+function envValue(env, key) {
+    if (env[key])
+        return env[key];
+    const hit = Object.keys(env).find((k) => k.toLowerCase() === key.toLowerCase());
+    return hit ? env[hit] : undefined;
+}
+/** The WARN text for a workspace inside a synced folder; null otherwise. */
+export function cloudSyncNotice(root, ctx) {
+    const hit = cloudSyncProvider(root, ctx);
+    if (!hit)
+        return null;
+    return (`workspace is inside ${hit.provider} (${hit.folder}), which syncs every file in it, including .vexp/index.db: ` +
+        "a live SQLite database vexp rewrites continuously. On one machine this costs sync traffic; opened from a second " +
+        "machine, the sync client can produce conflicted copies of the database. Move the project out of the synced folder " +
+        "(e.g. ~/Repos) and run 'vexp setup' there.");
+}