@neottia/repository-store 0.3.2 → 0.3.4

package/README.md

@@ -24,6 +24,8 @@ Installation downloads the exact native prebuild for the package version, platfo
 
 The stable C Node-API addon is built from architecture-neutral source. Linux uses `renameat2(..., RENAME_NOREPLACE)` and `fsync`. macOS uses `renamex_np(..., RENAME_EXCL)` and `F_FULLFSYNC`. Windows uses `SetFileInformationByHandle(..., FileRenameInfoEx)` without replacement and the Node/Bun `fsyncSync` descriptor barrier; NTFS journals same-volume namespace mutations because Windows does not expose an unprivileged directory-descriptor flush through Node.js. FreeBSD uses exclusive regular-file hard-link publication and `fsync`; because FreeBSD 14 has no no-replace directory rename, the backend uses a complete regular-file authority lease and never applies its move primitive to directories. Repository authority acquisition checks the addon and filesystem capabilities before it creates claim or lease artifacts. FreeBSD UFS1, ZFS, network filesystems, FreeBSD arm64, Bun on FreeBSD, Windows arm64, ReFS, FAT, remote or removable Windows volumes, missing or unloadable addon builds, unavailable native operations, uncertified filesystems, and shared or network filesystems return `UNSUPPORTED_RUNTIME`. Leased canonical and cache operations, including read-only operations, are unavailable in those environments.
 
+`diagnoseRepositoryPlatform(root)` reports the runtime tuple, loaded backend, filesystem type and locality, and active checks for no-replace publication, hard links, stable identity, and durability. The probe uses a private temporary directory below `root`, removes it on every path, and does not create repository authority artifacts. The `neottia doctor` command renders this report and supports deterministic JSON output.
+
 ## Canonical files
 
 ```ts

package/dist/diagnostics.d.ts

@@ -0,0 +1,33 @@
+import { type RepositoryRuntime } from './internal/platform-backend.js';
+export interface RepositoryPlatformCheck {
+    readonly id: 'platform' | 'architecture' | 'runtime' | 'native-backend' | 'filesystem-type' | 'filesystem-local' | 'filesystem-writable' | 'atomic-no-replace' | 'hard-links' | 'stable-identity' | 'file-durability' | 'directory-durability';
+    readonly status: 'pass' | 'fail';
+    readonly message: string;
+    readonly reason?: 'UNSUPPORTED_PLATFORM' | 'UNSUPPORTED_ARCHITECTURE' | 'UNSUPPORTED_RUNTIME' | 'NATIVE_ADDON_UNAVAILABLE' | 'FILESYSTEM_UNCERTIFIED' | 'FILESYSTEM_NON_LOCAL' | 'FILESYSTEM_READ_ONLY' | 'ATOMIC_NO_REPLACE_UNAVAILABLE' | 'HARD_LINKS_UNAVAILABLE' | 'STABLE_IDENTITY_UNAVAILABLE' | 'FILE_DURABILITY_UNAVAILABLE' | 'DIRECTORY_DURABILITY_UNAVAILABLE';
+    readonly remediation?: string;
+}
+export interface RepositoryPlatformDiagnostics {
+    readonly schemaVersion: 1;
+    readonly status: 'pass' | 'fail';
+    readonly runtime: {
+        readonly name: RepositoryRuntime;
+        readonly version: string;
+        readonly platform: NodeJS.Platform;
+        readonly architecture: string;
+    };
+    readonly backend: {
+        readonly available: boolean;
+        readonly id: string | null;
+        readonly leaseArtifact: 'directory' | 'file' | null;
+        readonly filesystemRequirement: string | null;
+    };
+    readonly filesystem: {
+        readonly type: string | null;
+        readonly local: boolean | null;
+        readonly writable: boolean | null;
+    };
+    readonly durabilityModel: string | null;
+    readonly checks: readonly RepositoryPlatformCheck[];
+}
+export declare function diagnoseRepositoryPlatform(root: string): Promise<RepositoryPlatformDiagnostics>;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAIA,OAAO,EAML,KAAK,iBAAiB,EACvB,MAAM,gCAAgC,CAAC;AAGxC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,EACP,UAAU,GACV,cAAc,GACd,SAAS,GACT,gBAAgB,GAChB,iBAAiB,GACjB,kBAAkB,GAClB,qBAAqB,GACrB,mBAAmB,GACnB,YAAY,GACZ,iBAAiB,GACjB,iBAAiB,GACjB,sBAAsB,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EACZ,sBAAsB,GACtB,0BAA0B,GAC1B,qBAAqB,GACrB,0BAA0B,GAC1B,wBAAwB,GACxB,sBAAsB,GACtB,sBAAsB,GACtB,+BAA+B,GAC/B,wBAAwB,GACxB,6BAA6B,GAC7B,6BAA6B,GAC7B,kCAAkC,CAAC;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAGD,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;QACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;QACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;KAC/B,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;QAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,QAAQ,CAAC,aAAa,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAAC;QACpD,QAAQ,CAAC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;KAC/C,CAAC;IACF,QAAQ,CAAC,UAAU,EAAE;QACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;QAC/B,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;KACnC,CAAC;IACF,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,SAAS,uBAAuB,EAAE,CAAC;CACrD;AAYD,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,6BAA6B,CAAC,CA+KrG"}

package/dist/diagnostics.js

@@ -0,0 +1,230 @@
+import { constants } from 'node:fs';
+import { link, lstat, mkdtemp, open, readFile, realpath, rm, unlink, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { currentRepositoryRuntime, repositoryPlatformTupleSupport, requireRepositoryPlatformBackend, } from './internal/platform-backend.js';
+export async function diagnoseRepositoryPlatform(root) {
+    const runtime = currentRepositoryRuntime();
+    const tuple = repositoryPlatformTupleSupport(process.platform, process.arch, runtime);
+    const checks = [];
+    checks.push(check('platform', tuple.platformKnown, `Platform ${process.platform} has a certified Repository Store backend.`, 'UNSUPPORTED_PLATFORM', `Platform ${process.platform} is not certified for Repository Store.`, 'Use Linux, macOS, Windows Server, or FreeBSD as listed in the support matrix.'));
+    checks.push(check('architecture', tuple.architectureCertified, `Architecture ${process.arch} is certified on ${process.platform}.`, 'UNSUPPORTED_ARCHITECTURE', `Architecture ${process.arch} is not certified on ${process.platform}.`, 'Use a certified architecture from the Repository Store support matrix.'));
+    checks.push(check('runtime', tuple.runtimeCertified, `Runtime ${runtime} is certified on ${process.platform}-${process.arch}.`, 'UNSUPPORTED_RUNTIME', `Runtime ${runtime} is not certified on ${process.platform}-${process.arch}.`, 'Use a runtime listed for this platform tuple in the Repository Store support matrix.'));
+    let backend;
+    if (tuple.certified) {
+        try {
+            backend = requireRepositoryPlatformBackend();
+        }
+        catch {
+        }
+    }
+    checks.push(check('native-backend', backend !== undefined, 'The native Repository Store backend loaded and passed its integrity receipt check.', 'NATIVE_ADDON_UNAVAILABLE', 'The native Repository Store backend is unavailable or failed its integrity check.', 'Reinstall @neottia/repository-store, or install the C++17 source-build prerequisites and reinstall.'));
+    let inspection;
+    let probe;
+    if (backend !== undefined) {
+        try {
+            const canonicalRoot = await realpath(root);
+            const metadata = await lstat(canonicalRoot);
+            if (!metadata.isDirectory() || metadata.isSymbolicLink())
+                throw new Error('Diagnostic root is not a directory.');
+            inspection = backend.filesystem.inspectLocalPath?.(canonicalRoot);
+            if (inspection !== undefined)
+                probe = await runActiveProbes(canonicalRoot, backend);
+        }
+        catch {
+        }
+    }
+    checks.push(check('filesystem-type', inspection?.certified === true, `Filesystem ${inspection?.filesystemType ?? 'unknown'} is certified for this platform.`, 'FILESYSTEM_UNCERTIFIED', `Filesystem ${inspection?.filesystemType ?? 'unknown'} is not certified for this platform.`, backend?.filesystemRequirement ?? 'Use a certified local filesystem from the Repository Store support matrix.'));
+    checks.push(check('filesystem-local', inspection?.local === true, 'The target is on a local filesystem.', 'FILESYSTEM_NON_LOCAL', 'The target is not on a certified local filesystem.', 'Move the repository to a local filesystem. Network and shared filesystems are unsupported.'));
+    checks.push(check('filesystem-writable', inspection?.writable === true && probe?.temporaryArea === true, 'The target filesystem is writable and the private diagnostic area was removed.', 'FILESYSTEM_READ_ONLY', 'The target filesystem is read-only or does not permit a private diagnostic area.', 'Use a writable repository on a certified local filesystem.'));
+    checks.push(capabilityCheck('atomic-no-replace', inspection?.atomicNoReplace === true && probe?.atomicNoReplace === true, 'Atomic no-replace publication succeeded and refused an existing destination.', 'ATOMIC_NO_REPLACE_UNAVAILABLE', 'Atomic no-replace publication is unavailable.', 'Use the certified filesystem and native backend for this platform.'));
+    checks.push(capabilityCheck('hard-links', inspection?.hardLinks === true && probe?.hardLinks === true, 'Same-filesystem regular-file hard links preserve the source bytes.', 'HARD_LINKS_UNAVAILABLE', 'Required regular-file hard links are unavailable.', 'Use a certified local filesystem with regular-file hard-link support.'));
+    checks.push(capabilityCheck('stable-identity', inspection?.stableIdentity === true && probe?.stableIdentity === true, 'Descriptor and path metadata expose one stable filesystem identity.', 'STABLE_IDENTITY_UNAVAILABLE', 'Stable filesystem identity is unavailable.', 'Use a certified filesystem that exposes stable device and file identities.'));
+    checks.push(capabilityCheck('file-durability', inspection?.durability === true && probe?.fileDurability === true, 'The platform file durability barrier completed.', 'FILE_DURABILITY_UNAVAILABLE', 'The required file durability barrier is unavailable.', 'Use the certified filesystem and runtime durability support for this platform.'));
+    checks.push(capabilityCheck('directory-durability', inspection?.durability === true && probe?.directoryDurability === true, process.platform === 'win32'
+        ? 'NTFS journaling provides the certified namespace durability model.'
+        : 'The platform directory durability barrier completed.', 'DIRECTORY_DURABILITY_UNAVAILABLE', 'The required namespace durability model is unavailable.', 'Use the certified filesystem and namespace durability model for this platform.'));
+    const frozenChecks = Object.freeze(checks.map((result) => Object.freeze(result)));
+    return Object.freeze({
+        schemaVersion: 1,
+        status: frozenChecks.some((result) => result.status === 'fail') ? 'fail' : 'pass',
+        runtime: Object.freeze({
+            name: runtime,
+            version: runtime === 'bun' ? (process.versions.bun ?? process.version) : process.version,
+            platform: process.platform,
+            architecture: process.arch,
+        }),
+        backend: Object.freeze({
+            available: backend !== undefined,
+            id: backend?.id ?? null,
+            leaseArtifact: backend?.leaseArtifact ?? null,
+            filesystemRequirement: backend?.filesystemRequirement ?? null,
+        }),
+        filesystem: Object.freeze({
+            type: inspection?.filesystemType ?? null,
+            local: inspection?.local ?? null,
+            writable: inspection?.writable ?? null,
+        }),
+        durabilityModel: durabilityModel(backend),
+        checks: frozenChecks,
+    });
+}
+function check(id, passed, passedMessage, reason, failedMessage, remediation) {
+    return passed
+        ? { id, status: 'pass', message: passedMessage }
+        : { id, status: 'fail', message: failedMessage, reason, remediation };
+}
+function capabilityCheck(id, passed, passedMessage, reason, failedMessage, remediation) {
+    return check(id, passed, passedMessage, reason, failedMessage, remediation);
+}
+async function runActiveProbes(root, backend) {
+    let temporary;
+    let temporaryIdentity;
+    let result = failedActiveProbes();
+    try {
+        temporary = await mkdtemp(join(root, '.neottia-doctor-'));
+        temporaryIdentity = await lstat(temporary, { bigint: true });
+        if (!temporaryIdentity.isDirectory() || temporaryIdentity.isSymbolicLink()) {
+            throw new Error('Private diagnostic area identity is invalid.');
+        }
+        const [hardLinks, identity] = await probeHardLinks(temporary);
+        const atomicNoReplace = await probeAtomicNoReplace(temporary, backend);
+        const fileDurability = await probeFileDurability(temporary, backend);
+        const directoryDurability = process.platform === 'win32' ? true : await probeDirectoryDurability(temporary, backend);
+        result = {
+            temporaryArea: true,
+            atomicNoReplace,
+            hardLinks,
+            stableIdentity: identity,
+            fileDurability,
+            directoryDurability,
+        };
+    }
+    catch {
+        result = failedActiveProbes();
+    }
+    if (temporary === undefined || temporaryIdentity === undefined)
+        return result;
+    const removed = await removeOwnedTemporaryArea(temporary, temporaryIdentity);
+    return removed ? result : { ...result, temporaryArea: false };
+}
+function failedActiveProbes() {
+    return {
+        temporaryArea: false,
+        atomicNoReplace: false,
+        hardLinks: false,
+        stableIdentity: false,
+        fileDurability: false,
+        directoryDurability: false,
+    };
+}
+async function removeOwnedTemporaryArea(path, expected) {
+    try {
+        const current = await lstat(path, { bigint: true });
+        if (!current.isDirectory() || current.isSymbolicLink() || !sameBigIntIdentity(expected, current))
+            return false;
+        await rm(path, { recursive: true, force: false });
+        return await lstat(path).then(() => false, (error) => hasCode(error, 'ENOENT'));
+    }
+    catch {
+        return false;
+    }
+}
+async function probeHardLinks(root) {
+    const source = join(root, 'link-source');
+    const destination = join(root, 'link-destination');
+    const bytes = Buffer.from('neottia-platform-diagnostic\n');
+    await writeFile(source, bytes, { flag: 'wx', mode: 0o600 });
+    try {
+        await link(source, destination);
+        const handle = await open(source, 'r');
+        try {
+            const [sourceState, destinationState, descriptorState, linkedBytes] = await Promise.all([
+                lstat(source, { bigint: true }),
+                lstat(destination, { bigint: true }),
+                handle.stat({ bigint: true }),
+                readFile(destination),
+            ]);
+            const hardLinks = sourceState.nlink >= 2n && destinationState.nlink >= 2n && linkedBytes.equals(bytes);
+            const stableIdentity = sameBigIntIdentity(descriptorState, sourceState) && sameBigIntIdentity(descriptorState, destinationState);
+            return [hardLinks, stableIdentity];
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    catch {
+        return [false, false];
+    }
+    finally {
+        await unlink(destination).catch(() => undefined);
+        await unlink(source).catch(() => undefined);
+    }
+}
+async function probeAtomicNoReplace(root, backend) {
+    const source = join(root, 'publication-source');
+    const destination = join(root, 'publication-destination');
+    const sourceBytes = Buffer.from('source\n');
+    const destinationBytes = Buffer.from('destination\n');
+    await writeFile(source, sourceBytes, { flag: 'wx', mode: 0o600 });
+    await writeFile(destination, destinationBytes, { flag: 'wx', mode: 0o600 });
+    let refused = false;
+    try {
+        backend.publication.renameNoReplace(source, destination);
+    }
+    catch (error) {
+        refused = hasCode(error, 'EEXIST');
+    }
+    if (!refused)
+        return false;
+    if (!(await readFile(source)).equals(sourceBytes) || !(await readFile(destination)).equals(destinationBytes))
+        return false;
+    await unlink(destination);
+    backend.publication.renameNoReplace(source, destination);
+    const published = await readFile(destination);
+    const sourceMissing = await lstat(source).then(() => false, (error) => hasCode(error, 'ENOENT'));
+    return sourceMissing && published.equals(sourceBytes);
+}
+async function probeFileDurability(root, backend) {
+    const path = join(root, 'durability-file');
+    await writeFile(path, 'durability\n', { flag: 'wx', mode: 0o600 });
+    const handle = await open(path, process.platform === 'win32' ? 'r+' : 'r');
+    try {
+        backend.durability.syncDescriptor(handle.fd);
+        return true;
+    }
+    catch {
+        return false;
+    }
+    finally {
+        await handle.close();
+    }
+}
+async function probeDirectoryDurability(root, backend) {
+    const handle = await open(root, constants.O_RDONLY | constants.O_DIRECTORY);
+    try {
+        backend.durability.syncDescriptor(handle.fd);
+        return true;
+    }
+    catch {
+        return false;
+    }
+    finally {
+        await handle.close();
+    }
+}
+function sameBigIntIdentity(left, right) {
+    return left.dev === right.dev && left.ino === right.ino;
+}
+function hasCode(error, code) {
+    return error instanceof Error && 'code' in error && error.code === code;
+}
+function durabilityModel(backend) {
+    if (backend === undefined)
+        return null;
+    if (backend.platform === 'darwin')
+        return 'F_FULLFSYNC for managed files and directories';
+    if (backend.platform === 'win32')
+        return 'fsyncSync for managed files and NTFS journaling for namespace mutations';
+    return 'fsync for managed files and directories';
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export { diagnoseRepositoryPlatform, type RepositoryPlatformCheck, type RepositoryPlatformDiagnostics, } from './diagnostics.js';
 export { CacheSyncError, DurabilityError, LeaseContentionError, PathSafetyError, RecoveryError, RepositoryStoreConfigError, RepositoryStoreError, ResourceLimitError, StaleRevisionError, UnsupportedRuntimeError, type RepositoryStoreErrorCategory, type RepositoryStoreErrorCode, } from './errors.js';
 export { readManagedFile, scanManagedFiles, type ManagedFile, type ScanManagedFilesOptions } from './files.js';
 export { withRepositoryLease, type OperationControl, type RepositoryLease, type RepositoryLeaseOptions, } from './lease.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,0BAA0B,EAC1B,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,KAAK,4BAA4B,EACjC,KAAK,wBAAwB,GAC9B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,KAAK,WAAW,EAAE,KAAK,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC/G,OAAO,EACL,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,sBAAsB,GAC5B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EACL,8BAA8B,EAC9B,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AACzE,YAAY,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,0BAA0B,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,GACnC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,0BAA0B,EAC1B,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,KAAK,4BAA4B,EACjC,KAAK,wBAAwB,GAC9B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,KAAK,WAAW,EAAE,KAAK,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC/G,OAAO,EACL,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,sBAAsB,GAC5B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EACL,8BAA8B,EAC9B,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AACzE,YAAY,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -1,3 +1,4 @@
+export { diagnoseRepositoryPlatform, } from './diagnostics.js';
 export { CacheSyncError, DurabilityError, LeaseContentionError, PathSafetyError, RecoveryError, RepositoryStoreConfigError, RepositoryStoreError, ResourceLimitError, StaleRevisionError, UnsupportedRuntimeError, } from './errors.js';
 export { readManagedFile, scanManagedFiles } from './files.js';
 export { withRepositoryLease, } from './lease.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,0BAA0B,EAC1B,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,GAGxB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAkD,MAAM,YAAY,CAAC;AAC/G,OAAO,EACL,mBAAmB,GAIpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAoB,MAAM,aAAa,CAAC;AACrE,OAAO,EACL,8BAA8B,EAC9B,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,GAIrB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAqB,MAAM,eAAe,CAAC;AACvE,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,mBAAmB,CAAC;AAO3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAU1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,0BAA0B,GAG3B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,0BAA0B,EAC1B,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,GAGxB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAkD,MAAM,YAAY,CAAC;AAC/G,OAAO,EACL,mBAAmB,GAIpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAoB,MAAM,aAAa,CAAC;AACrE,OAAO,EACL,8BAA8B,EAC9B,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,GAIrB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAqB,MAAM,eAAe,CAAC;AACvE,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,mBAAmB,CAAC;AAO3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAU1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/internal/platform-backend.d.ts

@@ -1,8 +1,19 @@
 export interface ExactPublicationBackend {
     renameNoReplace(source: string, destination: string): void;
 }
+export interface LocalPathInspection {
+    readonly filesystemType: string;
+    readonly certified: boolean;
+    readonly local: boolean;
+    readonly writable: boolean;
+    readonly hardLinks: boolean;
+    readonly stableIdentity: boolean;
+    readonly atomicNoReplace: boolean;
+    readonly durability: boolean;
+}
 export interface LocalFilesystemBackend {
     supportsLocalPath(path: string): boolean;
+    inspectLocalPath?(path: string): LocalPathInspection;
 }
 export interface DurabilityBackend {
     syncDescriptor(descriptor: number): void;
@@ -16,9 +27,18 @@ export interface RepositoryPlatformBackend {
     readonly filesystem: LocalFilesystemBackend;
     readonly durability: DurabilityBackend;
 }
+export type RepositoryRuntime = 'node' | 'bun';
+export interface RepositoryPlatformTupleSupport {
+    readonly platformKnown: boolean;
+    readonly architectureCertified: boolean;
+    readonly runtimeCertified: boolean;
+    readonly certified: boolean;
+}
 export declare function requireRepositoryPlatformBackend(): RepositoryPlatformBackend;
 export declare function platformRenameNoReplace(backend: RepositoryPlatformBackend, source: string, destination: string): void;
 export declare function assertPlatformFilesystem(backend: RepositoryPlatformBackend, path: string): void;
 export declare function setRepositoryPlatformBackendForTests(backend: RepositoryPlatformBackend | null | undefined): void;
 export declare function isCertifiedRepositoryPlatform(platform: NodeJS.Platform, architecture: string): boolean;
+export declare function repositoryPlatformTupleSupport(platform: NodeJS.Platform, architecture: string, runtime: RepositoryRuntime): RepositoryPlatformTupleSupport;
+export declare function currentRepositoryRuntime(): RepositoryRuntime;
 //# sourceMappingURL=platform-backend.d.ts.map

package/dist/internal/platform-backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform-backend.d.ts","sourceRoot":"","sources":["../../src/internal/platform-backend.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,uBAAuB;IACtC,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5D;AAGD,MAAM,WAAW,sBAAsB;IACrC,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1C;AAGD,MAAM,WAAW,iBAAiB;IAChC,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C;AAGD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IACnC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,aAAa,EAAE,WAAW,GAAG,MAAM,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,uBAAuB,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,sBAAsB,CAAC;IAC5C,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;CACxC;AAqDD,wBAAgB,gCAAgC,IAAI,yBAAyB,CA6B5E;AAGD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,yBAAyB,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAQrH;AAGD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAO/F;AAGD,wBAAgB,oCAAoC,CAAC,OAAO,EAAE,yBAAyB,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAEhH;AAGD,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAEtG"}
+{"version":3,"file":"platform-backend.d.ts","sourceRoot":"","sources":["../../src/internal/platform-backend.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,uBAAuB;IACtC,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5D;AAGD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAGD,MAAM,WAAW,sBAAsB;IACrC,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACzC,gBAAgB,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAAC;CACtD;AAGD,MAAM,WAAW,iBAAiB;IAChC,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C;AAGD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IACnC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,aAAa,EAAE,WAAW,GAAG,MAAM,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,uBAAuB,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,sBAAsB,CAAC;IAC5C,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;CACxC;AAWD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,KAAK,CAAC;AAE/C,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAkDD,wBAAgB,gCAAgC,IAAI,yBAAyB,CAmC5E;AAGD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,yBAAyB,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAQrH;AAGD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAO/F;AAGD,wBAAgB,oCAAoC,CAAC,OAAO,EAAE,yBAAyB,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAEhH;AAGD,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAEtG;AAGD,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,iBAAiB,GACzB,8BAA8B,CAWhC;AAED,wBAAgB,wBAAwB,IAAI,iBAAiB,CAE5D"}

package/dist/internal/platform-backend.js

@@ -8,6 +8,7 @@ const backendDefinitions = {
         id: 'linux-node-api',
         platform: 'linux',
         architectures: ['x64', 'arm64'],
+        runtimes: ['node', 'bun'],
         filesystemRequirement: 'a certified Linux local filesystem',
         leaseArtifact: 'directory',
     },
@@ -15,6 +16,7 @@ const backendDefinitions = {
         id: 'macos-node-api',
         platform: 'darwin',
         architectures: ['x64', 'arm64'],
+        runtimes: ['node', 'bun'],
         filesystemRequirement: 'a local APFS filesystem with certified publication and durability capabilities',
         leaseArtifact: 'directory',
     },
@@ -22,6 +24,7 @@ const backendDefinitions = {
         id: 'windows-node-api',
         platform: 'win32',
         architectures: ['x64'],
+        runtimes: ['node', 'bun'],
         filesystemRequirement: 'a local NTFS filesystem with stable identity and hard-link capabilities',
         leaseArtifact: 'directory',
     },
@@ -29,6 +32,7 @@ const backendDefinitions = {
         id: 'freebsd-node-api',
         platform: 'freebsd',
         architectures: ['x64'],
+        runtimes: ['node'],
         filesystemRequirement: 'a local UFS2 filesystem with regular-file hard links and directory fsync',
         leaseArtifact: 'file',
     },
@@ -43,8 +47,9 @@ export function requireRepositoryPlatformBackend() {
         throw unsupported('Repository platform backend is disabled for this operation.');
     }
     const definition = selectBackendDefinition(process.platform, process.arch);
-    if (definition === undefined)
-        throw unsupported(`Repository filesystem operations are unsupported on ${process.platform}.`);
+    const runtime = currentRepositoryRuntime();
+    if (definition === undefined || !definition.runtimes.includes(runtime))
+        throw unsupported(`Repository filesystem operations are unsupported on ${runtime} ${process.platform}-${process.arch}.`);
     if (loadedBackend !== undefined)
         return loadedBackend;
     if (loadFailure !== undefined)
@@ -56,7 +61,10 @@ export function requireRepositoryPlatformBackend() {
         loadedBackend = Object.freeze({
             ...definition,
             publication: Object.freeze({ renameNoReplace: nativeModule.renameNoReplace.bind(nativeModule) }),
-            filesystem: Object.freeze({ supportsLocalPath: nativeModule.supportsLocalPath.bind(nativeModule) }),
+            filesystem: Object.freeze({
+                supportsLocalPath: nativeModule.supportsLocalPath.bind(nativeModule),
+                inspectLocalPath: (path) => validateLocalPathInspection(nativeModule.inspectLocalPath(path)),
+            }),
             durability: Object.freeze({
                 syncDescriptor: definition.platform === 'win32' ? fsyncSync : nativeModule.syncDescriptor.bind(nativeModule),
             }),
@@ -94,6 +102,21 @@ export function setRepositoryPlatformBackendForTests(backend) {
 export function isCertifiedRepositoryPlatform(platform, architecture) {
     return selectBackendDefinition(platform, architecture) !== undefined;
 }
+export function repositoryPlatformTupleSupport(platform, architecture, runtime) {
+    const definition = backendDefinitions[platform];
+    const platformKnown = definition !== undefined;
+    const architectureCertified = definition?.architectures.includes(architecture) === true;
+    const runtimeCertified = definition?.runtimes.includes(runtime) === true;
+    return Object.freeze({
+        platformKnown,
+        architectureCertified,
+        runtimeCertified,
+        certified: platformKnown && architectureCertified && runtimeCertified,
+    });
+}
+export function currentRepositoryRuntime() {
+    return typeof process.versions.bun === 'string' ? 'bun' : 'node';
+}
 function selectBackendDefinition(platform, architecture) {
     const definition = backendDefinitions[platform];
     return definition?.architectures.includes(architecture) === true ? definition : undefined;
@@ -104,11 +127,40 @@ function loadNativeModule() {
     const candidate = require(verifyNativeAddonIntegrity(packageRoot));
     if (typeof candidate.platform !== 'string' ||
         typeof candidate.renameNoReplace !== 'function' ||
+        typeof candidate.inspectLocalPath !== 'function' ||
         typeof candidate.supportsLocalPath !== 'function' ||
         typeof candidate.syncDescriptor !== 'function')
         throw new Error('Native addon does not expose the complete platform backend contract.');
     return candidate;
 }
+function validateLocalPathInspection(value) {
+    if (typeof value !== 'object' || value === null)
+        throw new Error('Native filesystem inspection is malformed.');
+    const candidate = value;
+    const booleanFields = [
+        'certified',
+        'local',
+        'writable',
+        'hardLinks',
+        'stableIdentity',
+        'atomicNoReplace',
+        'durability',
+    ];
+    if (typeof candidate.filesystemType !== 'string' ||
+        candidate.filesystemType.length === 0 ||
+        booleanFields.some((field) => typeof candidate[field] !== 'boolean'))
+        throw new Error('Native filesystem inspection is malformed.');
+    return Object.freeze({
+        filesystemType: candidate.filesystemType,
+        certified: candidate.certified,
+        local: candidate.local,
+        writable: candidate.writable,
+        hardLinks: candidate.hardLinks,
+        stableIdentity: candidate.stableIdentity,
+        atomicNoReplace: candidate.atomicNoReplace,
+        durability: candidate.durability,
+    });
+}
 function hasCode(error, code) {
     return typeof error === 'object' && error !== null && 'code' in error && error.code === code;
 }

package/dist/internal/platform-backend.js.map

@@ -1 +1 @@
-{"version":3,"file":"platform-backend.js","sourceRoot":"","sources":["../../src/internal/platform-backend.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"platform-backend.js","sourceRoot":"","sources":["../../src/internal/platform-backend.ts"],"names":[],"mappings":"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"}

package/native/backend.cc

@@ -83,6 +83,42 @@ napi_value RenameNoReplace(napi_env env, napi_callback_info info) {
   return undefined;
 }
 
+void SetBooleanProperty(napi_env env, napi_value object, const char* name, bool value) {
+  napi_value property;
+  napi_get_boolean(env, value, &property);
+  napi_set_named_property(env, object, name, property);
+}
+
+napi_value InspectLocalPath(napi_env env, napi_callback_info info) {
+  size_t argc = 1;
+  napi_value argv[1];
+  napi_get_cb_info(env, info, &argc, argv, nullptr, nullptr);
+  std::string path;
+  if (argc != 1 || !ReadPath(env, argv[0], &path)) {
+    napi_throw_type_error(env, nullptr, "inspectLocalPath requires one path");
+    return nullptr;
+  }
+  neottia::repository_store::LocalPathInspection inspection;
+  const int error = neottia::repository_store::InspectLocalPath(path.c_str(), &inspection);
+  if (error != 0) {
+    ThrowErrno(env, error);
+    return nullptr;
+  }
+  napi_value result;
+  napi_create_object(env, &result);
+  napi_value filesystem_type;
+  napi_create_string_utf8(env, inspection.filesystem_type.c_str(), NAPI_AUTO_LENGTH, &filesystem_type);
+  napi_set_named_property(env, result, "filesystemType", filesystem_type);
+  SetBooleanProperty(env, result, "certified", inspection.certified);
+  SetBooleanProperty(env, result, "local", inspection.local);
+  SetBooleanProperty(env, result, "writable", inspection.writable);
+  SetBooleanProperty(env, result, "hardLinks", inspection.hard_links);
+  SetBooleanProperty(env, result, "stableIdentity", inspection.stable_identity);
+  SetBooleanProperty(env, result, "atomicNoReplace", inspection.atomic_no_replace);
+  SetBooleanProperty(env, result, "durability", inspection.durability);
+  return result;
+}
+
 napi_value SupportsLocalPath(napi_env env, napi_callback_info info) {
   size_t argc = 1;
   napi_value argv[1];
@@ -129,6 +165,9 @@ napi_value Initialize(napi_env env, napi_value exports) {
   napi_value rename_function;
   napi_create_function(env, "renameNoReplace", NAPI_AUTO_LENGTH, RenameNoReplace, nullptr, &rename_function);
   napi_set_named_property(env, exports, "renameNoReplace", rename_function);
+  napi_value inspect_function;
+  napi_create_function(env, "inspectLocalPath", NAPI_AUTO_LENGTH, InspectLocalPath, nullptr, &inspect_function);
+  napi_set_named_property(env, exports, "inspectLocalPath", inspect_function);
   napi_value supports_function;
   napi_create_function(env, "supportsLocalPath", NAPI_AUTO_LENGTH, SupportsLocalPath, nullptr, &supports_function);
   napi_set_named_property(env, exports, "supportsLocalPath", supports_function);

package/native/freebsd_backend.cc

@@ -1,7 +1,6 @@
 #include "platform_backend.h"
 
 #include <cerrno>
-#include <cstring>
 #include <fcntl.h>
 #include <sys/mount.h>
 #include <sys/stat.h>
@@ -27,6 +26,7 @@ int SupportsRequiredDurability(const char* path, bool* supported) {
     *supported = false;
     return 0;
   }
+  if (sync_error == 0 && close_error == 0) *supported = true;
   return sync_error != 0 ? sync_error : close_error;
 }
 
@@ -60,13 +60,13 @@ int RenameNoReplace(const char* source, const char* destination) {
   return unlink_error;
 }
 
-int SupportsLocalPath(const char* path, bool* supported) {
-  *supported = false;
+int InspectLocalPath(const char* path, LocalPathInspection* inspection) {
   struct statfs filesystem;
   if (statfs(path, &filesystem) != 0) return errno;
-  if (std::strcmp(filesystem.f_fstypename, "ufs") != 0 || (filesystem.f_flags & MNT_LOCAL) == 0 ||
-      (filesystem.f_flags & MNT_RDONLY) != 0)
-    return 0;
+  inspection->filesystem_type = filesystem.f_fstypename;
+  inspection->local = (filesystem.f_flags & MNT_LOCAL) != 0;
+  inspection->writable = (filesystem.f_flags & MNT_RDONLY) == 0;
+  if (inspection->filesystem_type != "ufs" || !inspection->local || !inspection->writable) return 0;
 
   // FreeBSD reports st_birthtim.tv_sec == -1 for UFS1 and reads the stored
   // birth time for UFS2. This rejects UFS1 without reading the backing device.
@@ -74,8 +74,25 @@ int SupportsLocalPath(const char* path, bool* supported) {
   if (lstat(path, &state) != 0) return errno;
   if (state.st_birthtim.tv_sec == -1) return 0;
 
-  *supported = true;
-  return SupportsRequiredDurability(path, supported);
+  inspection->certified = true;
+  inspection->hard_links = true;
+  inspection->stable_identity = true;
+  inspection->atomic_no_replace = true;
+  bool durability = false;
+  const int durability_error = SupportsRequiredDurability(path, &durability);
+  if (durability_error != 0) return durability_error;
+  inspection->durability = durability;
+  return 0;
+}
+
+int SupportsLocalPath(const char* path, bool* supported) {
+  LocalPathInspection inspection;
+  const int error = InspectLocalPath(path, &inspection);
+  if (error != 0) return error;
+  *supported = inspection.filesystem_type == "ufs" && inspection.local && inspection.writable &&
+               inspection.hard_links && inspection.stable_identity && inspection.atomic_no_replace &&
+               inspection.durability;
+  return 0;
 }
 
 int SyncDescriptor(int descriptor) { return Sync(descriptor); }

package/native/linux_backend.cc

@@ -4,11 +4,56 @@
 #include <fcntl.h>
 #include <linux/fs.h>
 #include <linux/magic.h>
-#include <stdio.h>
+#include <cstdio>
+#include <sys/statvfs.h>
 #include <sys/vfs.h>
 #include <unistd.h>
 
 namespace neottia::repository_store {
+namespace {
+
+constexpr long kCifsMagic = 0xff534d42L;
+constexpr long kCephMagic = 0x00c36400L;
+constexpr long kNinePMagic = 0x01021997L;
+
+const char* FilesystemType(long type) {
+  switch (type) {
+    case EXT4_SUPER_MAGIC:
+      return "ext4";
+    case XFS_SUPER_MAGIC:
+      return "xfs";
+    case BTRFS_SUPER_MAGIC:
+      return "btrfs";
+    case TMPFS_MAGIC:
+      return "tmpfs";
+    case OVERLAYFS_SUPER_MAGIC:
+      return "overlay";
+    case NFS_SUPER_MAGIC:
+      return "nfs";
+    case SMB_SUPER_MAGIC:
+      return "smb";
+    case kCifsMagic:
+      return "cifs";
+    case kCephMagic:
+      return "ceph";
+    case kNinePMagic:
+      return "9p";
+    default:
+      return nullptr;
+  }
+}
+
+bool IsCertifiedFilesystem(long type) {
+  return type == EXT4_SUPER_MAGIC || type == XFS_SUPER_MAGIC || type == BTRFS_SUPER_MAGIC || type == TMPFS_MAGIC ||
+         type == OVERLAYFS_SUPER_MAGIC;
+}
+
+bool IsKnownRemoteFilesystem(long type) {
+  return type == NFS_SUPER_MAGIC || type == SMB_SUPER_MAGIC || type == kCifsMagic || type == kCephMagic ||
+         type == kNinePMagic;
+}
+
+}  // namespace
 
 const char* Platform() { return "linux"; }
 
@@ -17,20 +62,34 @@ int RenameNoReplace(const char* source, const char* destination) {
   return errno;
 }
 
-int SupportsLocalPath(const char* path, bool* supported) {
+int InspectLocalPath(const char* path, LocalPathInspection* inspection) {
   struct statfs state;
   if (statfs(path, &state) != 0) return errno;
-  switch (state.f_type) {
-    case EXT4_SUPER_MAGIC:
-    case XFS_SUPER_MAGIC:
-    case BTRFS_SUPER_MAGIC:
-    case TMPFS_MAGIC:
-    case OVERLAYFS_SUPER_MAGIC:
-      *supported = true;
-      break;
-    default:
-      *supported = false;
+  const char* name = FilesystemType(state.f_type);
+  if (name == nullptr) {
+    char value[32];
+    std::snprintf(value, sizeof(value), "0x%lx", static_cast<unsigned long>(state.f_type));
+    inspection->filesystem_type = value;
+  } else {
+    inspection->filesystem_type = name;
   }
+  const bool certified = IsCertifiedFilesystem(state.f_type);
+  inspection->certified = certified;
+  inspection->local = !IsKnownRemoteFilesystem(state.f_type);
+  inspection->writable = (state.f_flags & ST_RDONLY) == 0;
+  inspection->hard_links = certified;
+  inspection->stable_identity = certified;
+  inspection->atomic_no_replace = certified;
+  inspection->durability = certified;
+  return 0;
+}
+
+int SupportsLocalPath(const char* path, bool* supported) {
+  LocalPathInspection inspection;
+  const int error = InspectLocalPath(path, &inspection);
+  if (error != 0) return error;
+  *supported = inspection.local && inspection.writable && inspection.hard_links && inspection.stable_identity &&
+               inspection.atomic_no_replace && inspection.durability;
   return 0;
 }
 

package/native/macos_backend.cc

@@ -3,7 +3,6 @@
 #include <cerrno>
 #include <cstddef>
 #include <cstdint>
-#include <cstring>
 #include <fcntl.h>
 #include <stdio.h>
 #include <sys/attr.h>
@@ -30,6 +29,7 @@ int SupportsRequiredDurability(const char* path, bool* supported) {
     sync_result = fcntl(descriptor, F_FULLFSYNC, 0);
   } while (sync_result != 0 && errno == EINTR);
   if (sync_result == 0) {
+    *supported = true;
     const int close_result = close(descriptor);
     return close_result == 0 ? 0 : errno;
   }
@@ -51,13 +51,14 @@ int RenameNoReplace(const char* source, const char* destination) {
   return errno;
 }
 
-int SupportsLocalPath(const char* path, bool* supported) {
+int InspectLocalPath(const char* path, LocalPathInspection* inspection) {
   struct statfs state;
   if (statfs(path, &state) != 0) return errno;
-  if (std::strcmp(state.f_fstypename, "apfs") != 0 || (state.f_flags & MNT_LOCAL) == 0) {
-    *supported = false;
-    return 0;
-  }
+  inspection->filesystem_type = state.f_fstypename;
+  inspection->certified = inspection->filesystem_type == "apfs";
+  inspection->local = (state.f_flags & MNT_LOCAL) != 0;
+  inspection->writable = (state.f_flags & MNT_RDONLY) == 0;
+  if (inspection->filesystem_type != "apfs" || !inspection->local || !inspection->writable) return 0;
 
   struct attrlist attributes = {};
   attributes.bitmapcount = ATTR_BIT_MAP_COUNT;
@@ -65,12 +66,26 @@ int SupportsLocalPath(const char* path, bool* supported) {
   CapabilityBuffer buffer = {};
   if (getattrlist(path, &attributes, &buffer, sizeof(buffer), 0) != 0) return errno;
 
-  const std::uint32_t required_format = VOL_CAP_FMT_PERSISTENTOBJECTIDS | VOL_CAP_FMT_HARDLINKS;
-  const std::uint32_t required_interfaces = VOL_CAP_INT_RENAME_EXCL;
-  *supported = HasCapability(buffer.capabilities, VOL_CAPABILITIES_FORMAT, required_format) &&
-               HasCapability(buffer.capabilities, VOL_CAPABILITIES_INTERFACES, required_interfaces);
-  if (!*supported) return 0;
-  return SupportsRequiredDurability(path, supported);
+  inspection->stable_identity = HasCapability(
+      buffer.capabilities, VOL_CAPABILITIES_FORMAT, VOL_CAP_FMT_PERSISTENTOBJECTIDS);
+  inspection->hard_links = HasCapability(buffer.capabilities, VOL_CAPABILITIES_FORMAT, VOL_CAP_FMT_HARDLINKS);
+  inspection->atomic_no_replace =
+      HasCapability(buffer.capabilities, VOL_CAPABILITIES_INTERFACES, VOL_CAP_INT_RENAME_EXCL);
+  bool durability = false;
+  const int durability_error = SupportsRequiredDurability(path, &durability);
+  if (durability_error != 0) return durability_error;
+  inspection->durability = durability;
+  return 0;
+}
+
+int SupportsLocalPath(const char* path, bool* supported) {
+  LocalPathInspection inspection;
+  const int error = InspectLocalPath(path, &inspection);
+  if (error != 0) return error;
+  *supported = inspection.filesystem_type == "apfs" && inspection.local && inspection.writable &&
+               inspection.hard_links && inspection.stable_identity && inspection.atomic_no_replace &&
+               inspection.durability;
+  return 0;
 }
 
 int SyncDescriptor(int descriptor) {

package/native/platform_backend.h

@@ -1,13 +1,30 @@
 #pragma once
 
+#include <string>
+
 namespace neottia::repository_store {
 
+/** Observable filesystem properties used by platform diagnostics. */
+struct LocalPathInspection {
+  std::string filesystem_type;
+  bool certified = false;
+  bool local = false;
+  bool writable = false;
+  bool hard_links = false;
+  bool stable_identity = false;
+  bool atomic_no_replace = false;
+  bool durability = false;
+};
+
 /** Returns the Node.js platform identifier implemented by this binary. */
 const char* Platform();
 
 /** Moves source to destination without replacing an existing destination. */
 int RenameNoReplace(const char* source, const char* destination);
 
+/** Inspects the filesystem properties required by Repository Store. */
+int InspectLocalPath(const char* path, LocalPathInspection* inspection);
+
 /** Reports whether path resides on a certified local filesystem. */
 int SupportsLocalPath(const char* path, bool* supported);
 

package/native/unsupported_backend.cc

@@ -18,6 +18,11 @@ const char* Platform() {
 
 int RenameNoReplace(const char*, const char*) { return ENOSYS; }
 
+int InspectLocalPath(const char*, LocalPathInspection* inspection) {
+  inspection->filesystem_type = "unknown";
+  return 0;
+}
+
 int SupportsLocalPath(const char*, bool* supported) {
   *supported = false;
   return 0;

package/native/windows_backend.cc

@@ -85,6 +85,16 @@ bool IsNtfs(const wchar_t* filesystem_name) {
   return _wcsicmp(filesystem_name, L"NTFS") == 0;
 }
 
+int Utf8Text(const wchar_t* value, std::string* output) {
+  const int required = WideCharToMultiByte(CP_UTF8, WC_ERR_INVALID_CHARS, value, -1, nullptr, 0, nullptr, nullptr);
+  if (required == 0) return WindowsError(GetLastError());
+  std::vector<char> buffer(static_cast<std::size_t>(required));
+  if (WideCharToMultiByte(CP_UTF8, WC_ERR_INVALID_CHARS, value, -1, buffer.data(), required, nullptr, nullptr) == 0)
+    return WindowsError(GetLastError());
+  output->assign(buffer.data());
+  return 0;
+}
+
 }  // namespace
 
 const char* Platform() { return "win32"; }
@@ -143,32 +153,43 @@ int RenameNoReplace(const char* source, const char* destination) {
   return 0;
 }
 
-int SupportsLocalPath(const char* path, bool* supported) {
-  *supported = false;
+int InspectLocalPath(const char* path, LocalPathInspection* inspection) {
   std::wstring absolute;
   int error = AbsolutePath(path, &absolute);
   if (error != 0) return error;
 
   const std::wstring extended = ExtendedPath(absolute);
   const DWORD attributes = GetFileAttributesW(extended.c_str());
-  if (attributes == INVALID_FILE_ATTRIBUTES)
-    return WindowsError(GetLastError());
-  if ((attributes & FILE_ATTRIBUTE_REPARSE_POINT) != 0) return 0;
+  if (attributes == INVALID_FILE_ATTRIBUTES) return WindowsError(GetLastError());
+  const bool reparse_point = (attributes & FILE_ATTRIBUTE_REPARSE_POINT) != 0;
 
   wchar_t volume_path[MAX_PATH + 1] = {};
-  if (!GetVolumePathNameW(absolute.c_str(), volume_path, MAX_PATH + 1))
-    return WindowsError(GetLastError());
-  if (GetDriveTypeW(volume_path) != DRIVE_FIXED) return 0;
+  if (!GetVolumePathNameW(absolute.c_str(), volume_path, MAX_PATH + 1)) return WindowsError(GetLastError());
+  inspection->local = GetDriveTypeW(volume_path) == DRIVE_FIXED;
 
   DWORD filesystem_flags = 0;
   wchar_t filesystem_name[MAX_PATH + 1] = {};
-  if (!GetVolumeInformationW(volume_path, nullptr, 0, nullptr, nullptr,
-                             &filesystem_flags, filesystem_name, MAX_PATH + 1))
+  if (!GetVolumeInformationW(volume_path, nullptr, 0, nullptr, nullptr, &filesystem_flags, filesystem_name,
+                             MAX_PATH + 1))
     return WindowsError(GetLastError());
-  const DWORD required =
-      FILE_SUPPORTS_HARD_LINKS | FILE_SUPPORTS_OPEN_BY_FILE_ID;
-  *supported =
-      IsNtfs(filesystem_name) && (filesystem_flags & required) == required;
+  error = Utf8Text(filesystem_name, &inspection->filesystem_type);
+  if (error != 0) return error;
+  inspection->writable = (filesystem_flags & FILE_READ_ONLY_VOLUME) == 0;
+  const bool ntfs = IsNtfs(filesystem_name);
+  inspection->certified = ntfs;
+  inspection->hard_links = ntfs && (filesystem_flags & FILE_SUPPORTS_HARD_LINKS) != 0 && !reparse_point;
+  inspection->stable_identity = ntfs && (filesystem_flags & FILE_SUPPORTS_OPEN_BY_FILE_ID) != 0 && !reparse_point;
+  inspection->atomic_no_replace = ntfs && !reparse_point;
+  inspection->durability = ntfs && inspection->local && inspection->writable && !reparse_point;
+  return 0;
+}
+
+int SupportsLocalPath(const char* path, bool* supported) {
+  LocalPathInspection inspection;
+  const int error = InspectLocalPath(path, &inspection);
+  if (error != 0) return error;
+  *supported = inspection.local && inspection.writable && inspection.hard_links && inspection.stable_identity &&
+               inspection.atomic_no_replace && inspection.durability;
   return 0;
 }
 

package/native-prebuilds.json

@@ -1,9 +1,9 @@
 {
   "schemaVersion": 1,
   "packageName": "@neottia/repository-store",
-  "packageVersion": "0.3.2",
-  "releaseTag": "@neottia/repository-store@0.3.2",
-  "sourceCommit": "8adbaf09c095d3a3d2ce2411ae4c39f739ed042e",
+  "packageVersion": "0.3.4",
+  "releaseTag": "@neottia/repository-store@0.3.4",
+  "sourceCommit": "d09bfe64c32a180a05720e7ec4884f470ad2354a",
   "signature": {
     "format": "sigstore-bundle-v0.3",
     "certificateIssuer": "https://token.actions.githubusercontent.com",
@@ -15,12 +15,12 @@
     {
       "platform": "darwin",
       "architecture": "arm64",
-      "name": "repository-store-native-v0.3.2-darwin-arm64.node",
-      "bundle": "repository-store-native-v0.3.2-darwin-arm64.node.sigstore.json",
-      "attestation": "repository-store-native-v0.3.2-darwin-arm64.node.intoto.jsonl",
-      "sha256": "8ecf2ccb75de2239921f00a761d58c96d9d7a04669b976c2a4638f4186a5dee0",
-      "size": 54160,
-      "sourceCommit": "8adbaf09c095d3a3d2ce2411ae4c39f739ed042e",
+      "name": "repository-store-native-v0.3.4-darwin-arm64.node",
+      "bundle": "repository-store-native-v0.3.4-darwin-arm64.node.sigstore.json",
+      "attestation": "repository-store-native-v0.3.4-darwin-arm64.node.intoto.jsonl",
+      "sha256": "7ec4246c48feb76e2f217b4fbeace0684931592e419adfda32d39203d3693c5a",
+      "size": 54800,
+      "sourceCommit": "d09bfe64c32a180a05720e7ec4884f470ad2354a",
       "signature": {
         "format": "sigstore-bundle-v0.3",
         "certificateIssuer": "https://token.actions.githubusercontent.com",
@@ -32,12 +32,12 @@
     {
       "platform": "darwin",
       "architecture": "x64",
-      "name": "repository-store-native-v0.3.2-darwin-x64.node",
-      "bundle": "repository-store-native-v0.3.2-darwin-x64.node.sigstore.json",
-      "attestation": "repository-store-native-v0.3.2-darwin-x64.node.intoto.jsonl",
-      "sha256": "0110e6131d1439edbca16f2a505e773863ec155c1efe1b3f7637ebcfaa704f31",
-      "size": 20816,
-      "sourceCommit": "8adbaf09c095d3a3d2ce2411ae4c39f739ed042e",
+      "name": "repository-store-native-v0.3.4-darwin-x64.node",
+      "bundle": "repository-store-native-v0.3.4-darwin-x64.node.sigstore.json",
+      "attestation": "repository-store-native-v0.3.4-darwin-x64.node.intoto.jsonl",
+      "sha256": "2f6bfedfa4d082fb0287a6a74159e0f7e79f7132f33440364753510dd1171825",
+      "size": 21456,
+      "sourceCommit": "d09bfe64c32a180a05720e7ec4884f470ad2354a",
       "signature": {
         "format": "sigstore-bundle-v0.3",
         "certificateIssuer": "https://token.actions.githubusercontent.com",
@@ -49,12 +49,12 @@
     {
       "platform": "freebsd",
       "architecture": "x64",
-      "name": "repository-store-native-v0.3.2-freebsd-x64.node",
-      "bundle": "repository-store-native-v0.3.2-freebsd-x64.node.sigstore.json",
-      "attestation": "repository-store-native-v0.3.2-freebsd-x64.node.intoto.jsonl",
-      "sha256": "fa2e280a1a5de100520971df8750de4022ec53feedf1526929217b4124345af2",
-      "size": 18320,
-      "sourceCommit": "8adbaf09c095d3a3d2ce2411ae4c39f739ed042e",
+      "name": "repository-store-native-v0.3.4-freebsd-x64.node",
+      "bundle": "repository-store-native-v0.3.4-freebsd-x64.node.sigstore.json",
+      "attestation": "repository-store-native-v0.3.4-freebsd-x64.node.intoto.jsonl",
+      "sha256": "3b0f225e517daa651ca0c029d076dca7bcb62cca00fac080686d111850aa0aff",
+      "size": 20528,
+      "sourceCommit": "d09bfe64c32a180a05720e7ec4884f470ad2354a",
       "signature": {
         "format": "sigstore-bundle-v0.3",
         "certificateIssuer": "https://token.actions.githubusercontent.com",
@@ -66,12 +66,12 @@
     {
       "platform": "linux",
       "architecture": "arm64",
-      "name": "repository-store-native-v0.3.2-linux-arm64.node",
-      "bundle": "repository-store-native-v0.3.2-linux-arm64.node.sigstore.json",
-      "attestation": "repository-store-native-v0.3.2-linux-arm64.node.intoto.jsonl",
-      "sha256": "ed2d95b726fecbab782a5e677ed5109f8230e2d5efb921dfe0c6d64c5e9e0c2e",
-      "size": 71856,
-      "sourceCommit": "8adbaf09c095d3a3d2ce2411ae4c39f739ed042e",
+      "name": "repository-store-native-v0.3.4-linux-arm64.node",
+      "bundle": "repository-store-native-v0.3.4-linux-arm64.node.sigstore.json",
+      "attestation": "repository-store-native-v0.3.4-linux-arm64.node.intoto.jsonl",
+      "sha256": "15d56b396fc6aa506cd2db99ef6b24fb4440d8ae06996ca4e875e9942206d830",
+      "size": 72344,
+      "sourceCommit": "d09bfe64c32a180a05720e7ec4884f470ad2354a",
       "signature": {
         "format": "sigstore-bundle-v0.3",
         "certificateIssuer": "https://token.actions.githubusercontent.com",
@@ -83,12 +83,12 @@
     {
       "platform": "linux",
       "architecture": "x64",
-      "name": "repository-store-native-v0.3.2-linux-x64.node",
-      "bundle": "repository-store-native-v0.3.2-linux-x64.node.sigstore.json",
-      "attestation": "repository-store-native-v0.3.2-linux-x64.node.intoto.jsonl",
-      "sha256": "c9f10cb643d67d5afd801ebb7eb52497a9ee501db202302a7b6289b815d3ab14",
-      "size": 17608,
-      "sourceCommit": "8adbaf09c095d3a3d2ce2411ae4c39f739ed042e",
+      "name": "repository-store-native-v0.3.4-linux-x64.node",
+      "bundle": "repository-store-native-v0.3.4-linux-x64.node.sigstore.json",
+      "attestation": "repository-store-native-v0.3.4-linux-x64.node.intoto.jsonl",
+      "sha256": "7530d936f33fab7eab4f358184533f4187b85d2d2ae20aade386b482643cfb71",
+      "size": 22192,
+      "sourceCommit": "d09bfe64c32a180a05720e7ec4884f470ad2354a",
       "signature": {
         "format": "sigstore-bundle-v0.3",
         "certificateIssuer": "https://token.actions.githubusercontent.com",
@@ -100,12 +100,12 @@
     {
       "platform": "win32",
       "architecture": "x64",
-      "name": "repository-store-native-v0.3.2-win32-x64.node",
-      "bundle": "repository-store-native-v0.3.2-win32-x64.node.sigstore.json",
-      "attestation": "repository-store-native-v0.3.2-win32-x64.node.intoto.jsonl",
-      "sha256": "584ad5e39cb2c6377bdae671bab32cca15aa197250fd3c299ae249d363f187dc",
-      "size": 138240,
-      "sourceCommit": "8adbaf09c095d3a3d2ce2411ae4c39f739ed042e",
+      "name": "repository-store-native-v0.3.4-win32-x64.node",
+      "bundle": "repository-store-native-v0.3.4-win32-x64.node.sigstore.json",
+      "attestation": "repository-store-native-v0.3.4-win32-x64.node.intoto.jsonl",
+      "sha256": "45a2560788f0067afa944a6155d7965280f29910dfce446b34e1710c4af3581b",
+      "size": 141312,
+      "sourceCommit": "d09bfe64c32a180a05720e7ec4884f470ad2354a",
       "signature": {
         "format": "sigstore-bundle-v0.3",
         "certificateIssuer": "https://token.actions.githubusercontent.com",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neottia/repository-store",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "Crash-recoverable repository-local canonical file and disposable SQLite storage primitives",
   "author": "Dragos Cirjan",
   "license": "MIT",
@@ -70,7 +70,7 @@
     "install": "node scripts/install-native.mjs",
     "test": "pnpm run test:installer && pnpm run test:node && pnpm run test:bun && pnpm run test:cross-runtime",
     "test:installer": "vitest run --root ../.. packages/repository-store/scripts/native-prebuild.spec.mjs",
-    "test:node": "pnpm run build && vitest run --root ../.. packages/repository-store/src/internal/native-integrity.spec.ts packages/repository-store/src/repository-store.spec.ts packages/repository-store/src/sqlite/cache.spec.ts packages/repository-store/src/sqlite/node-adapter.spec.ts",
+    "test:node": "pnpm run build && vitest run --root ../.. packages/repository-store/src/diagnostics.spec.ts packages/repository-store/src/internal/native-integrity.spec.ts packages/repository-store/src/repository-store.spec.ts packages/repository-store/src/sqlite/cache.spec.ts packages/repository-store/src/sqlite/node-adapter.spec.ts",
     "test:bun": "pnpm run build && bun test ./src/sqlite/bun-adapter.bun.test.ts ./src/publication.bun.test.ts",
     "test:cross-runtime": "pnpm run build && vitest run --root ../.. packages/repository-store/src/sqlite/cross-runtime.spec.ts",
     "typecheck": "tsc --noEmit"