@orkestrel/scaffold 0.0.74 → 0.0.75

package/dist/src/server/index.cjs

@@ -1776,7 +1776,8 @@ function stageInventory(checkout, path = _src_core.HOST_INVENTORY_PATH) {
 * @returns The anchor, or `undefined` when the path is not a physical directory.
 *
 * @remarks
-* Device and inode rather than the path, because the path is the thing that can
+* Native bigint device and inode values preserve the filesystem identity without
+* numeric rounding. Device and inode rather than the path, because the path can
 * be swapped underneath a write. An anchor captured before a mutation and
 * checked again after it proves the directory written into sits where the
 * inspected one sat, not that it is the one that was inspected.
@@ -1785,11 +1786,12 @@ function stageInventory(checkout, path = _src_core.HOST_INVENTORY_PATH) {
 * ```ts
 * import { readAnchor } from '@orkestrel/scaffold/server'
 *
-* readAnchor('/tmp/project') // { path: '/tmp/project', device: 1, inode: 2 }
+* const anchor = readAnchor(process.cwd())
+* anchor !== undefined && typeof anchor.device === 'bigint' && typeof anchor.inode === 'bigint' // true for a physical directory
 * ```
 */
 function readAnchor(path) {
-	const status = (0, _orkestrel_contract.attempt)(() => (0, node_fs.lstatSync)(path));
+	const status = (0, _orkestrel_contract.attempt)(() => (0, node_fs.lstatSync)(path, { bigint: true }));
 	if (!status.success || !status.value.isDirectory() || status.value.isSymbolicLink()) return;
 	return {
 		path,
@@ -1798,7 +1800,7 @@ function readAnchor(path) {
 	};
 }
 /**
-* Tests whether a captured directory is still the same directory.
+* Tests whether a path still holds the captured directory identity.
 *
 * @param anchor - The identity captured earlier.
 * @returns True if the path still holds a physical directory of that exact device and