fix: create a symlink on non-elevated windows in docs test (#4654)

* fix: create a symlink on non-elevated windows in docs test

Windows terminals without Developer Mode or elevation cannot create file
symlinks, so the versions publishing integration test failed with EPERM
before it could reach the non-ordinary-file rejection. Fall back to a
directory junction, which is creatable without elevation and hits the
same rejection path.

* fix: detect docs snapshot reparse points with lstat

Classify entries with lstat instead of the readdir dirent so symlinks and
Windows junctions are rejected regardless of how a runtime classifies
them. This keeps the versions integration test's non-ordinary-file
assertion meaningful on non-elevated Windows, where the fixture can only
create a directory junction.

1 files changed, 14 insertions, 3 deletions

diff --git a/scripts/docs/versions.integration.test.ts b/scripts/docs/versions.integration.test.ts
index 9731d3c0..214bfef9 100644
--- a/scripts/docs/versions.integration.test.ts
+++ b/scripts/docs/versions.integration.test.ts
@@ -100,9 +100,20 @@ describe('documentation release publishing', () => {
       correctedArchivedDocs,
     );
     const linkedPage = resolve(archivedDocsRoot, 'linked.mdx');
-    await symlink('index.mdx', linkedPage);
-    expect(() => runScript(root, ['check'])).toThrow();
-    await rm(linkedPage);
+    if (process.platform === 'win32') {
+      // A normal Windows terminal cannot create file symlinks without Developer
+      // Mode or elevation, but a directory junction is creatable without
+      // either. Link to an empty directory outside the snapshot so the walk
+      // stays finite and only the non-ordinary-file rejection can satisfy the
+      // assertion below.
+      const linkTarget = await mkdtemp(join(tmpdir(), 'herdr-docs-link-'));
+      temporaryDirectories.push(linkTarget);
+      await symlink(linkTarget, linkedPage, 'junction');
+    } else {
+      await symlink('index.mdx', linkedPage);
+    }
+    expect(() => runScript(root, ['check'])).toThrow(/is not an ordinary documentation file/);
+    await rm(linkedPage, { recursive: true, force: true });
     runScript(root, ['check']);
 
     delete archivedManifest.versions[0].commit;