@relayfile/local-mount 0.7.23 → 0.7.25

package/README.md

@@ -21,6 +21,8 @@ const handle = await createMount(projectDir, mountDir, options);
 
 interface MountHandle {
   mountDir: string;
+  initialFileCount?: number;
+  initialMountDurationMs?: number;
   syncBack(opts?: { signal?: AbortSignal; paths?: Iterable<string> }): Promise<number>;
   startAutoSync(opts?: AutoSyncOptions): AutoSyncHandle;
   cleanup(): void;
@@ -28,6 +30,7 @@ interface MountHandle {
 ```
 
 `createMount` returns `Promise<MountHandle>`. The walker yields the event loop between directory entries so consumer-side timers (e.g. an `ora` spinner driven by `setInterval`) keep firing while the mount is being built.
+The returned handle includes initial mount timing and copied-file count metadata so callers can report setup performance.
 
 Behavior:
 - Copies regular files into the mount, requesting a filesystem reflink clone when the source and mount are on a compatible same-volume filesystem and falling back to a byte copy otherwise

package/dist/auto-sync.js

@@ -1,4 +1,4 @@
-import { chmodSync, copyFileSync, existsSync, lstatSync, mkdirSync, readdirSync, readFileSync, realpathSync, rmSync, statSync, } from 'node:fs';
+import { chmodSync, constants as fsConstants, copyFileSync, existsSync, lstatSync, mkdirSync, readdirSync, readFileSync, realpathSync, rmSync, statSync, } from 'node:fs';
 import path from 'node:path';
 import watcher from '@parcel/watcher';
 const STOP_EVENT_SETTLE_MS = 250;
@@ -504,7 +504,7 @@ function doMountToProject(relPosix, state, ctx, mountAbs, projectAbs) {
         updateState(state, relPosix, mountAbs, target);
         return false;
     }
-    copyFileSync(mountAbs, target);
+    copyFileSync(mountAbs, target, fsConstants.COPYFILE_FICLONE);
     updateState(state, relPosix, mountAbs, target);
     return true;
 }
@@ -526,7 +526,7 @@ function doProjectToMount(relPosix, state, ctx, projectAbs, mountAbs, readonly)
         }
         catch { /* best effort */ }
     }
-    copyFileSync(projectAbs, target);
+    copyFileSync(projectAbs, target, fsConstants.COPYFILE_FICLONE);
     if (readonly) {
         try {
             chmodSync(target, 0o444);

package/dist/mount.d.ts

@@ -30,6 +30,8 @@ export interface MountOptions {
 }
 export interface MountHandle {
     mountDir: string;
+    initialFileCount?: number;
+    initialMountDurationMs?: number;
     syncBack(opts?: {
         signal?: AbortSignal;
         paths?: Iterable<string>;

package/dist/mount.js

@@ -60,7 +60,9 @@ export async function createMount(projectDir, mountDir, options) {
     mkdirSync(resolvedMountDir, { recursive: true });
     const realMountDir = realpathSync(resolvedMountDir);
     writeFileSync(path.join(realMountDir, MOUNT_MARKER_FILENAME), MOUNT_MARKER_CONTENT, 'utf8');
-    await walkProjectTree(resolvedProjectDir, resolvedProjectDir, realMountDir, realMountDir, excludeRules, readonlyMatcher, ignoredMatcher);
+    const initialMountStartedAt = Date.now();
+    const initialFileCount = await walkProjectTree(resolvedProjectDir, resolvedProjectDir, realMountDir, realMountDir, excludeRules, readonlyMatcher, ignoredMatcher);
+    const initialMountDurationMs = Date.now() - initialMountStartedAt;
     const readmePath = resolveSafeCopyTarget(realMountDir, path.join(realMountDir, MOUNT_README_FILENAME));
     if (!readmePath) {
         throw new Error('Failed to create mount readme inside mountDir');
@@ -79,6 +81,8 @@ export async function createMount(projectDir, mountDir, options) {
     };
     return {
         mountDir: resolvedMountDir,
+        initialFileCount,
+        initialMountDurationMs,
         async syncBack(opts) {
             let synced = 0;
             const realProjectDir = realpathSync(resolvedProjectDir);
@@ -160,6 +164,7 @@ async function walkProjectTree(projectDir, currentDir, mountDir, currentMountDir
     await yieldToEventLoop();
     const entries = readdirSync(currentDir, { withFileTypes: true });
     let processed = 0;
+    let copiedFiles = 0;
     for (const entry of entries) {
         if (processed > 0 && processed % WALK_YIELD_EVERY === 0) {
             await yieldToEventLoop();
@@ -185,18 +190,23 @@ async function walkProjectTree(projectDir, currentDir, mountDir, currentMountDir
             if (!safeMountDir) {
                 continue;
             }
-            await walkProjectTree(projectDir, absolutePath, mountDir, safeMountDir, excludeRules, readonlyMatcher, ignoredMatcher);
+            copiedFiles += await walkProjectTree(projectDir, absolutePath, mountDir, safeMountDir, excludeRules, readonlyMatcher, ignoredMatcher);
             continue;
         }
         if (entry.isSymbolicLink()) {
-            copySymlinkedFile(projectDir, mountDir, absolutePath, mountPath, relativePath, readonlyMatcher);
+            if (copySymlinkedFile(projectDir, mountDir, absolutePath, mountPath, relativePath, readonlyMatcher)) {
+                copiedFiles += 1;
+            }
             continue;
         }
         if (!entry.isFile()) {
             continue;
         }
-        copyMountedFile(projectDir, mountDir, absolutePath, mountPath, relativePath, readonlyMatcher);
+        if (copyMountedFile(projectDir, mountDir, absolutePath, mountPath, relativePath, readonlyMatcher)) {
+            copiedFiles += 1;
+        }
     }
+    return copiedFiles;
 }
 function yieldToEventLoop() {
     return new Promise((resolve) => setImmediate(resolve));
@@ -209,29 +219,30 @@ function copySymlinkedFile(projectDir, mountDir, sourcePath, mountPath, relative
         resolvedStat = statSync(sourcePath);
     }
     catch {
-        return;
+        return false;
     }
     if (!isPathWithinRoot(realSource, projectDir) || !resolvedStat.isFile()) {
-        return;
+        return false;
     }
-    copyMountedFile(projectDir, mountDir, realSource, mountPath, relativePath, readonlyMatcher, resolvedStat.mode);
+    return copyMountedFile(projectDir, mountDir, realSource, mountPath, relativePath, readonlyMatcher, resolvedStat.mode);
 }
 function copyMountedFile(sourceRoot, mountDir, sourcePath, mountPath, relativePath, readonlyMatcher, sourceMode) {
     const safeMountPath = resolveSafeCopyTarget(mountDir, mountPath);
     if (!safeMountPath) {
-        return;
+        return false;
     }
     const safeSourcePath = resolveVerifiedFilePath(sourceRoot, sourcePath);
     if (!safeSourcePath) {
-        return;
+        return false;
     }
     copyFileSync(safeSourcePath, safeMountPath, fsConstants.COPYFILE_FICLONE);
     if (isPathMatched(relativePath, readonlyMatcher)) {
         chmodSync(safeMountPath, 0o444);
-        return;
+        return true;
     }
     const mode = sourceMode ?? statSync(safeSourcePath).mode;
     chmodSync(safeMountPath, mode & 0o777);
+    return true;
 }
 function ensureDirectory(pathValue) {
     mkdirSync(pathValue, { recursive: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relayfile/local-mount",
-  "version": "0.7.23",
+  "version": "0.7.25",
   "description": "Create a symlink/copy mount of a project directory with .agentignore/.agentreadonly semantics, then launch a CLI inside it and sync writable changes back on exit",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",