@relayfile/local-mount 0.6.15 → 0.7.0

package/README.md

@@ -14,9 +14,11 @@ npm install @relayfile/local-mount
 
 ### `createMount(projectDir, mountDir, options)`
 
-Builds a mounted copy of `projectDir` at `mountDir` and returns a handle:
+Builds a mounted copy of `projectDir` at `mountDir` and resolves with a handle:
 
 ```ts
+const handle = await createMount(projectDir, mountDir, options);
+
 interface MountHandle {
   mountDir: string;
   syncBack(opts?: { signal?: AbortSignal }): Promise<number>;
@@ -25,6 +27,8 @@ 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.
+
 Behavior:
 - Copies regular files into the mount
 - Applies ignore rules from `ignoredPatterns`

package/dist/launch.js

@@ -7,14 +7,7 @@ import { createMount } from './mount.js';
  * exit code.
  */
 export async function launchOnMount(opts) {
-    const handle = createMount(opts.projectDir, opts.mountDir, {
-        ignoredPatterns: opts.ignoredPatterns ?? [],
-        readonlyPatterns: opts.readonlyPatterns ?? [],
-        excludeDirs: opts.excludeDirs ?? [],
-        agentName: opts.agentName,
-        includeGit: opts.includeGit,
-        includeDefaultExcludeDirs: opts.includeDefaultExcludeDirs,
-    });
+    let handle;
     let syncedCount = 0;
     let finalized = false;
     let autoSync;
@@ -29,6 +22,8 @@ export async function launchOnMount(opts) {
                 autoSyncChanges = autoSync.totalChanges();
                 autoSync = undefined;
             }
+            if (!handle)
+                return;
             const finalSynced = await handle.syncBack({ signal: opts.shutdownSignal });
             syncedCount = autoSyncChanges + finalSynced;
             if (opts.onAfterSync) {
@@ -36,10 +31,18 @@ export async function launchOnMount(opts) {
             }
         }
         finally {
-            handle.cleanup();
+            handle?.cleanup();
         }
     };
     try {
+        handle = await createMount(opts.projectDir, opts.mountDir, {
+            ignoredPatterns: opts.ignoredPatterns ?? [],
+            readonlyPatterns: opts.readonlyPatterns ?? [],
+            excludeDirs: opts.excludeDirs ?? [],
+            agentName: opts.agentName,
+            includeGit: opts.includeGit,
+            includeDefaultExcludeDirs: opts.includeDefaultExcludeDirs,
+        });
         if (opts.onBeforeLaunch) {
             await opts.onBeforeLaunch(handle.mountDir);
         }
@@ -51,9 +54,10 @@ export async function launchOnMount(opts) {
             ...process.env,
             ...(opts.env ?? {}),
         };
+        const mountCwd = handle.mountDir;
         const exitCode = await new Promise((resolve, reject) => {
             const child = spawn(opts.cli, opts.args, {
-                cwd: handle.mountDir,
+                cwd: mountCwd,
                 stdio: 'inherit',
                 env: envVars,
             });

package/dist/mount.d.ts

@@ -41,4 +41,4 @@ export interface MountHandle {
     startAutoSync(opts?: AutoSyncOptions): AutoSyncHandle;
     cleanup(): void;
 }
-export declare function createMount(projectDir: string, mountDir: string, options: MountOptions): MountHandle;
+export declare function createMount(projectDir: string, mountDir: string, options: MountOptions): Promise<MountHandle>;

package/dist/mount.js

@@ -30,7 +30,7 @@ const DEFAULT_ROOT_EXCLUDES = [
 const MOUNT_README_FILENAME = '_MOUNT_README.md';
 const MOUNT_MARKER_FILENAME = '.relayfile-local-mount';
 const MOUNT_MARKER_CONTENT = 'This directory is managed by @relayfile/local-mount. Do not place unrelated files here; the directory will be deleted when the mount is torn down.\n';
-export function createMount(projectDir, mountDir, options) {
+export async function createMount(projectDir, mountDir, options) {
     const resolvedProjectDir = realpathSync(projectDir);
     const resolvedMountDir = path.resolve(mountDir);
     const readonlyPatterns = [...options.readonlyPatterns];
@@ -60,7 +60,7 @@ export function createMount(projectDir, mountDir, options) {
     mkdirSync(resolvedMountDir, { recursive: true });
     const realMountDir = realpathSync(resolvedMountDir);
     writeFileSync(path.join(realMountDir, MOUNT_MARKER_FILENAME), MOUNT_MARKER_CONTENT, 'utf8');
-    walkProjectTree(resolvedProjectDir, resolvedProjectDir, realMountDir, realMountDir, excludeRules, readonlyMatcher, ignoredMatcher);
+    await walkProjectTree(resolvedProjectDir, resolvedProjectDir, realMountDir, realMountDir, excludeRules, readonlyMatcher, ignoredMatcher);
     const readmePath = resolveSafeCopyTarget(realMountDir, path.join(realMountDir, MOUNT_README_FILENAME));
     if (!readmePath) {
         throw new Error('Failed to create mount readme inside mountDir');
@@ -143,9 +143,19 @@ function assertMountDirSafeToRemove(mountDir, projectDir) {
             `Only directories previously created by createMount can be reused as mountDir.`);
     }
 }
-function walkProjectTree(projectDir, currentDir, mountDir, currentMountDir, excludeRules, readonlyMatcher, ignoredMatcher) {
+// Yield often enough that a consumer's setInterval (e.g. an `ora` spinner) can
+// tick during init even on flat directories with thousands of entries. The
+// goal is not throughput; it is keeping the parent event loop unblocked.
+const WALK_YIELD_EVERY = 64;
+async function walkProjectTree(projectDir, currentDir, mountDir, currentMountDir, excludeRules, readonlyMatcher, ignoredMatcher) {
+    await yieldToEventLoop();
     const entries = readdirSync(currentDir, { withFileTypes: true });
+    let processed = 0;
     for (const entry of entries) {
+        if (processed > 0 && processed % WALK_YIELD_EVERY === 0) {
+            await yieldToEventLoop();
+        }
+        processed += 1;
         const absolutePath = path.join(currentDir, entry.name);
         const relativePath = normalizeRelativePosix(path.relative(projectDir, absolutePath));
         if (!relativePath || relativePath.startsWith('..')) {
@@ -166,7 +176,7 @@ function walkProjectTree(projectDir, currentDir, mountDir, currentMountDir, excl
             if (!safeMountDir) {
                 continue;
             }
-            walkProjectTree(projectDir, absolutePath, mountDir, safeMountDir, excludeRules, readonlyMatcher, ignoredMatcher);
+            await walkProjectTree(projectDir, absolutePath, mountDir, safeMountDir, excludeRules, readonlyMatcher, ignoredMatcher);
             continue;
         }
         if (entry.isSymbolicLink()) {
@@ -179,6 +189,9 @@ function walkProjectTree(projectDir, currentDir, mountDir, currentMountDir, excl
         copyMountedFile(projectDir, mountDir, absolutePath, mountPath, relativePath, readonlyMatcher);
     }
 }
+function yieldToEventLoop() {
+    return new Promise((resolve) => setImmediate(resolve));
+}
 function copySymlinkedFile(projectDir, mountDir, sourcePath, mountPath, relativePath, readonlyMatcher) {
     let realSource;
     let resolvedStat;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relayfile/local-mount",
-  "version": "0.6.15",
+  "version": "0.7.0",
   "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",