@relayfile/local-mount 0.7.6 → 0.7.7

package/README.md

@@ -30,7 +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.
 
 Behavior:
-- Copies regular files into the mount
+- 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
 - Applies ignore rules from `ignoredPatterns`
 - Marks read-only matches as mode `0o444`
 - Excludes `.git`, `node_modules`, `.npm-cache`, and common build/cache output directories by default. Pass `includeGit: true` to opt the project's `.git` directory back in (see [Including `.git`](#including-git))
@@ -292,6 +292,8 @@ The mount is built by copying files rather than symlinking them. Symlinks would
 
 Source-side symlinks that resolve to regular files inside the project *are* followed when building the mount; the resolved bytes are copied. Symlinks the agent creates inside the mount are skipped on sync-back.
 
+On filesystems that support copy-on-write clones (for example APFS on macOS and btrfs/xfs/zfs on Linux), initial mount creation requests a non-forcing reflink copy. This preserves the distinct inode and copy-on-write semantics required above while avoiding an up-front byte copy when `projectDir` and `mountDir` are on the same filesystem. Unsupported filesystems and cross-device mounts fall back to ordinary copies.
+
 ## Notes
 
 - Requires Node.js 18+

package/dist/mount.js

@@ -1,4 +1,4 @@
-import { chmodSync, copyFileSync, existsSync, lstatSync, mkdirSync, readdirSync, readFileSync, realpathSync, rmSync, statSync, writeFileSync, } from 'node:fs';
+import { chmodSync, constants as fsConstants, copyFileSync, existsSync, lstatSync, mkdirSync, readdirSync, readFileSync, realpathSync, rmSync, statSync, writeFileSync, } from 'node:fs';
 import ignore from 'ignore';
 import path from 'node:path';
 import { startAutoSync, } from './auto-sync.js';
@@ -216,7 +216,7 @@ function copyMountedFile(sourceRoot, mountDir, sourcePath, mountPath, relativePa
     if (!safeSourcePath) {
         return;
     }
-    copyFileSync(safeSourcePath, safeMountPath);
+    copyFileSync(safeSourcePath, safeMountPath, fsConstants.COPYFILE_FICLONE);
     if (isPathMatched(relativePath, readonlyMatcher)) {
         chmodSync(safeMountPath, 0o444);
         return;

package/package.json

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