fix: enhance symlink error logging and image link

Author: uniyalabhishek

package.json

@@ -58,7 +58,7 @@
     "@docusaurus/types": "3.9.2",
     "@types/plotly.js-basic-dist": "^1.54.4",
     "@types/react-plotly.js": "^2.6.3",
-    "docusaurus-plugin-llms": "^0.2.2",
+    "docusaurus-plugin-llms": "0.2.2",
     "jest": "^29.7.0",
     "ts-jest": "^29.1.1",
     "ts-node": "^10.9.2",

plugins/llms-symlinks.js

@@ -45,7 +45,15 @@ function createSymlinkAwareReader() {
     visited.add(realPath);
 
     const files = [];
-    const entries = await fs.readdir(dir, {withFileTypes: true});
+    let entries;
+    try {
+      entries = await fs.readdir(dir, {withFileTypes: true});
+    } catch (error) {
+      console.warn(
+        `Skipping unreadable directory "${dir}": ${error.message}`,
+      );
+      return [];
+    }
 
     for (const entry of entries) {
       const fullPath = path.join(dir, entry.name);
@@ -382,6 +390,14 @@ module.exports = function llmsSymlinksPlugin(context, options) {
         cleaned = rewritten.join('\n');
       }
 
+      // Transform remaining image links to preserve alt text context for LLMs.
+      // ![alt text](path) -> [Image: alt text]
+      // This removes broken relative paths while keeping semantic information.
+      cleaned = cleaned.replace(
+        /!\[([^\]]*)\]\([^)]+\)/g,
+        (_match, alt) => (alt.trim() ? `[Image: ${alt.trim()}]` : ''),
+      );
+
       // Final cleanup
       cleaned = cleaned
         .replace(/\r\n/g, '\n')