docbridge 0.6.0 → 0.6.1

package/dist/index.js

@@ -337,7 +337,7 @@ var require_typescript = __commonJS((exports, module) => {
       compareDiagnostics: () => compareDiagnostics,
       compareEmitHelpers: () => compareEmitHelpers,
       compareNumberOfDirectorySeparators: () => compareNumberOfDirectorySeparators,
-      comparePaths: () => comparePaths,
+      comparePaths: () => comparePaths2,
       comparePathsCaseInsensitive: () => comparePathsCaseInsensitive,
       comparePathsCaseSensitive: () => comparePathsCaseSensitive,
       comparePatternKeys: () => comparePatternKeys,
@@ -8840,7 +8840,7 @@ ${lanes.join(`
     function comparePathsCaseInsensitive(a, b) {
       return comparePathsWorker(a, b, compareStringsCaseInsensitive);
     }
-    function comparePaths(a, b, currentDirectory, ignoreCase) {
+    function comparePaths2(a, b, currentDirectory, ignoreCase) {
       if (typeof currentDirectory === "string") {
         a = combinePaths(currentDirectory, a);
         b = combinePaths(currentDirectory, b);
@@ -19607,7 +19607,7 @@ ${lanes.join(`
       if (options.rootDir || options.composite && options.configFilePath) {
         const commonDir = getNormalizedAbsolutePath(getCommonSourceDirectory(options, () => [], host.getCurrentDirectory(), host.getCanonicalFileName), host.getCurrentDirectory());
         const outputPath = getSourceFilePathInNewDirWorker(sourceFile.fileName, options.outDir, host.getCurrentDirectory(), commonDir, host.getCanonicalFileName);
-        if (comparePaths(sourceFile.fileName, outputPath, host.getCurrentDirectory(), !host.useCaseSensitiveFileNames()) === 0)
+        if (comparePaths2(sourceFile.fileName, outputPath, host.getCurrentDirectory(), !host.useCaseSensitiveFileNames()) === 0)
           return false;
       }
       return true;
@@ -41023,7 +41023,7 @@ ${lanes.join(`
     var nodeModulesAtTypes = combinePaths("node_modules", "@types");
     function arePathsEqual(path1, path2, host) {
       const useCaseSensitiveFileNames2 = typeof host.useCaseSensitiveFileNames === "function" ? host.useCaseSensitiveFileNames() : host.useCaseSensitiveFileNames;
-      return comparePaths(path1, path2, !useCaseSensitiveFileNames2) === 0;
+      return comparePaths2(path1, path2, !useCaseSensitiveFileNames2) === 0;
     }
     function getOriginalAndResolvedFileName(fileName, host, traceEnabled) {
       const resolvedFileName = realPath(fileName, host, traceEnabled);
@@ -46147,7 +46147,7 @@ ${lanes.join(`
         return true;
       if (a === undefined || b === undefined)
         return false;
-      return comparePaths(a, b, ignoreCase) === 0;
+      return comparePaths2(a, b, ignoreCase) === 0;
     }
     function countPathComponents(path) {
       let count = 0;
@@ -46363,7 +46363,7 @@ ${lanes.join(`
         const canTryTsExtension = preferTsExtension && hasImplementationTSFileExtension(targetFilePath);
         switch (mode) {
           case 0:
-            if (extensionSwappedTarget && comparePaths(extensionSwappedTarget, pathOrPattern, ignoreCase) === 0 || comparePaths(targetFilePath, pathOrPattern, ignoreCase) === 0 || outputFile && comparePaths(outputFile, pathOrPattern, ignoreCase) === 0 || declarationFile && comparePaths(declarationFile, pathOrPattern, ignoreCase) === 0) {
+            if (extensionSwappedTarget && comparePaths2(extensionSwappedTarget, pathOrPattern, ignoreCase) === 0 || comparePaths2(targetFilePath, pathOrPattern, ignoreCase) === 0 || outputFile && comparePaths2(outputFile, pathOrPattern, ignoreCase) === 0 || declarationFile && comparePaths2(declarationFile, pathOrPattern, ignoreCase) === 0) {
               return { moduleFileToTry: packageName };
             }
             break;
@@ -47927,7 +47927,7 @@ ${lanes.join(`
           const isTargetPlainJs = isPlainJsFile(targetSymbolFile, compilerOptions.checkJs);
           const symbolName2 = symbolToString(source2);
           if (sourceSymbolFile && targetSymbolFile && amalgamatedDuplicates && !isEitherEnum && sourceSymbolFile !== targetSymbolFile) {
-            const firstFile = comparePaths(sourceSymbolFile.path, targetSymbolFile.path) === -1 ? sourceSymbolFile : targetSymbolFile;
+            const firstFile = comparePaths2(sourceSymbolFile.path, targetSymbolFile.path) === -1 ? sourceSymbolFile : targetSymbolFile;
             const secondFile = firstFile === sourceSymbolFile ? targetSymbolFile : sourceSymbolFile;
             const filesDuplicates = getOrUpdate(amalgamatedDuplicates, `${firstFile.path}|${secondFile.path}`, () => ({ firstFile, secondFile, conflictingSymbols: /* @__PURE__ */ new Map }));
             const conflictingSymbolInfo = getOrUpdate(filesDuplicates.conflictingSymbols, symbolName2, () => ({ isBlockScoped: isEitherBlockScoped, firstFileLocations: [], secondFileLocations: [] }));
@@ -102037,7 +102037,7 @@ ${lanes.join(`
       } else {
         const ownOutputFilePath = getOwnEmitOutputFilePath(sourceFile.fileName, host, getOutputExtension(sourceFile.fileName, options));
         const isJsonFile = isJsonSourceFile(sourceFile);
-        const isJsonEmittedToSameLocation = isJsonFile && comparePaths(sourceFile.fileName, ownOutputFilePath, host.getCurrentDirectory(), !host.useCaseSensitiveFileNames()) === 0;
+        const isJsonEmittedToSameLocation = isJsonFile && comparePaths2(sourceFile.fileName, ownOutputFilePath, host.getCurrentDirectory(), !host.useCaseSensitiveFileNames()) === 0;
         const jsFilePath = options.emitDeclarationOnly || isJsonEmittedToSameLocation ? undefined : ownOutputFilePath;
         const sourceMapFilePath = !jsFilePath || isJsonSourceFile(sourceFile) ? undefined : getSourceMapFilePath(jsFilePath, options);
         const declarationFilePath = forceDtsPaths || getEmitDeclarations(options) && !isJsonFile ? getDeclarationEmitOutputFilePath(sourceFile.fileName, host) : undefined;
@@ -102065,7 +102065,7 @@ ${lanes.join(`
         return;
       const isJsonFile = fileExtensionIs(inputFileName, ".json");
       const outputFileName = getOutputJSFileNameWorker(inputFileName, configFile.options, ignoreCase, getCommonSourceDirectory2);
-      return !isJsonFile || comparePaths(inputFileName, outputFileName, Debug.checkDefined(configFile.options.configFilePath), ignoreCase) !== 0 ? outputFileName : undefined;
+      return !isJsonFile || comparePaths2(inputFileName, outputFileName, Debug.checkDefined(configFile.options.configFilePath), ignoreCase) !== 0 ? outputFileName : undefined;
     }
     function getOutputJSFileNameWorker(inputFileName, options, ignoreCase, getCommonSourceDirectory2) {
       return changeExtension(getOutputPathWithoutChangingExt(inputFileName, ignoreCase, options.outDir, getCommonSourceDirectory2), getOutputExtension(inputFileName, options));
@@ -109855,7 +109855,7 @@ ${lanes.join(`
         return false;
       }
       function isSameFile(file1, file2) {
-        return comparePaths(file1, file2, currentDirectory, !host.useCaseSensitiveFileNames()) === 0;
+        return comparePaths2(file1, file2, currentDirectory, !host.useCaseSensitiveFileNames()) === 0;
       }
       function getSymlinkCache() {
         if (host.getSymlinkCache) {
@@ -145523,7 +145523,7 @@ ${newComment.split(`
       if (files) {
         for (let filePath of files) {
           filePath = normalizePath(filePath);
-          if (exclude && comparePaths(filePath, exclude, scriptDirectory, ignoreCase) === 0) {
+          if (exclude && comparePaths2(filePath, exclude, scriptDirectory, ignoreCase) === 0) {
             continue;
           }
           const { name, extension } = getFilenameWithExtensionOption(getBaseFileName(filePath), program, extensionOptions, false);
@@ -145568,16 +145568,16 @@ ${newComment.split(`
     }
     function addCompletionEntriesFromPaths(result, fragment, baseDirectory, extensionOptions, program, host, moduleSpecifierResolutionHost, paths) {
       const getPatternsForKey = (key) => paths[key];
-      const comparePaths2 = (a, b) => {
+      const comparePaths22 = (a, b) => {
         const patternA = tryParsePattern(a);
         const patternB = tryParsePattern(b);
         const lengthA = typeof patternA === "object" ? patternA.prefix.length : a.length;
         const lengthB = typeof patternB === "object" ? patternB.prefix.length : b.length;
         return compareValues(lengthB, lengthA);
       };
-      return addCompletionEntriesFromPathsOrExportsOrImports(result, false, false, fragment, baseDirectory, extensionOptions, program, host, moduleSpecifierResolutionHost, getOwnKeys(paths), getPatternsForKey, comparePaths2);
+      return addCompletionEntriesFromPathsOrExportsOrImports(result, false, false, fragment, baseDirectory, extensionOptions, program, host, moduleSpecifierResolutionHost, getOwnKeys(paths), getPatternsForKey, comparePaths22);
     }
-    function addCompletionEntriesFromPathsOrExportsOrImports(result, isExports, isImports, fragment, baseDirectory, extensionOptions, program, host, moduleSpecifierResolutionHost, keys, getPatternsForKey, comparePaths2) {
+    function addCompletionEntriesFromPathsOrExportsOrImports(result, isExports, isImports, fragment, baseDirectory, extensionOptions, program, host, moduleSpecifierResolutionHost, keys, getPatternsForKey, comparePaths22) {
       let pathResults = [];
       let matchedPath;
       for (const key of keys) {
@@ -145590,12 +145590,12 @@ ${newComment.split(`
           if (!pathPattern)
             continue;
           const isMatch = typeof pathPattern === "object" && isPatternMatch(pathPattern, fragment);
-          const isLongestMatch = isMatch && (matchedPath === undefined || comparePaths2(keyWithoutLeadingDotSlash, matchedPath) === -1);
+          const isLongestMatch = isMatch && (matchedPath === undefined || comparePaths22(keyWithoutLeadingDotSlash, matchedPath) === -1);
           if (isLongestMatch) {
             matchedPath = keyWithoutLeadingDotSlash;
             pathResults = pathResults.filter((r) => !r.matchedPattern);
           }
-          if (typeof pathPattern === "string" || matchedPath === undefined || comparePaths2(keyWithoutLeadingDotSlash, matchedPath) !== 1) {
+          if (typeof pathPattern === "string" || matchedPath === undefined || comparePaths22(keyWithoutLeadingDotSlash, matchedPath) !== 1) {
             pathResults.push({
               matchedPattern: isMatch,
               results: getCompletionsForPathMapping(keyWithoutLeadingDotSlash, patterns, fragment, baseDirectory, extensionOptions, isExports, isImports, program, host, moduleSpecifierResolutionHost).map(({ name, kind, extension }) => nameAndKind(name, kind, extension))
@@ -156337,7 +156337,7 @@ ${options.prefix}` : `
       compareDiagnostics: () => compareDiagnostics,
       compareEmitHelpers: () => compareEmitHelpers,
       compareNumberOfDirectorySeparators: () => compareNumberOfDirectorySeparators,
-      comparePaths: () => comparePaths,
+      comparePaths: () => comparePaths2,
       comparePathsCaseInsensitive: () => comparePathsCaseInsensitive,
       comparePathsCaseSensitive: () => comparePathsCaseSensitive,
       comparePatternKeys: () => comparePatternKeys,
@@ -160561,7 +160561,7 @@ ${options.prefix}` : `
                 return this.writeLog(`TypingWatchers already invoked`);
               if (!fileExtensionIs(f, ".json"))
                 return this.writeLog(`Ignoring files that are not *.json`);
-              if (comparePaths(f, combinePaths(this.projectService.typingsInstaller.globalTypingsCacheLocation, "package.json"), !this.useCaseSensitiveFileNames()))
+              if (comparePaths2(f, combinePaths(this.projectService.typingsInstaller.globalTypingsCacheLocation, "package.json"), !this.useCaseSensitiveFileNames()))
                 return this.writeLog(`Ignoring package.json change at global typings location`);
               this.onTypingInstallerWatchInvoke();
             }, 1, this.projectService.getWatchOptions(this), watchType, this) : (this.writeLog(`Skipping watcher creation at ${path}:: ${getDetailWatchInfo(watchType, this)}`), noopFileWatcher));
@@ -168755,38 +168755,33 @@ Additional information: BADCLIENT: Bad error code, ${badCode} not found in range
 });
 
 // src/cli/index.ts
-import { readFileSync as readFileSync5, statSync as statSync4 } from "node:fs";
+import { readFileSync as readFileSync5, statSync as statSync5 } from "node:fs";
 import { resolve as resolve4 } from "node:path";
 // package.json
 var package_default = {
   name: "docbridge",
-  version: "0.6.0",
+  version: "0.6.1",
   description: "A CLI that links Markdown specifications and code declarations. Runs on Node.js and Bun.",
-  license: "MIT",
-  type: "module",
-  bin: {
-    docbridge: "./dist/index.js"
-  },
-  repository: {
-    type: "git",
-    url: "git+https://github.com/salan70/docbridge.git"
-  },
-  bugs: {
-    url: "https://github.com/salan70/docbridge/issues"
-  },
-  homepage: "https://github.com/salan70/docbridge#readme",
   keywords: [
+    "bun",
+    "cli",
     "documentation",
+    "lsp",
     "markdown",
-    "specification",
-    "cli",
     "node",
-    "bun",
-    "lsp"
+    "specification"
   ],
-  engines: {
-    node: ">=22",
-    bun: ">=1.1.31"
+  homepage: "https://github.com/salan70/docbridge#readme",
+  bugs: {
+    url: "https://github.com/salan70/docbridge/issues"
+  },
+  license: "MIT",
+  repository: {
+    type: "git",
+    url: "git+https://github.com/salan70/docbridge.git"
+  },
+  bin: {
+    docbridge: "./dist/index.js"
   },
   files: [
     "dist",
@@ -168796,6 +168791,7 @@ var package_default = {
     "CHANGELOG.md",
     "LICENSE"
   ],
+  type: "module",
   scripts: {
     docbridge: "bun run src/cli/index.ts",
     check: "bun run src/cli/index.ts check",
@@ -168805,13 +168801,19 @@ var package_default = {
   },
   devDependencies: {
     "@types/bun": "^1.3.14",
+    oxfmt: "0.57.0",
+    oxlint: "1.73.0",
     typescript: "^5.9.0"
+  },
+  engines: {
+    bun: ">=1.1.31",
+    node: ">=22"
   }
 };
 
 // src/core/code-language.ts
-import { existsSync, realpathSync } from "node:fs";
-import { dirname, join as join3, resolve } from "node:path";
+import { accessSync, chmodSync, constants, existsSync, realpathSync, statSync } from "node:fs";
+import { dirname as dirname2, join as join3, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 
 // src/core/glob.ts
@@ -168899,7 +168901,16 @@ function collectFiles(projectRoot, patterns) {
     }
   };
   walk("");
-  return [...matched].sort((left, right) => left < right ? -1 : left > right ? 1 : 0);
+  return [...matched].toSorted(comparePaths);
+}
+function comparePaths(left, right) {
+  if (left < right) {
+    return -1;
+  }
+  if (left > right) {
+    return 1;
+  }
+  return 0;
 }
 function readManagedFile(projectRoot, relativePath) {
   try {
@@ -168956,7 +168967,7 @@ function escapeRegExpChar(char) {
 import { spawnSync } from "node:child_process";
 import { mkdirSync } from "node:fs";
 import { tmpdir } from "node:os";
-import { join as join2 } from "node:path";
+import { dirname, join as join2 } from "node:path";
 function invokeScannerWorker(request, command, run = runScannerWorkerProcess) {
   const processResult = run({
     command,
@@ -168965,7 +168976,7 @@ function invokeScannerWorker(request, command, run = runScannerWorkerProcess) {
   if (!processResult.ok) {
     return {
       ok: false,
-      diagnostic: scannerUnavailableDiagnostic(request.language, processResult.error),
+      diagnostic: scannerUnavailableDiagnostic(request.language, processResult.error, command[0]),
       stderr: processResult.stderr
     };
   }
@@ -169089,16 +169100,30 @@ function isResponseFile(value) {
 function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function scannerUnavailableDiagnostic(language, error) {
+function scannerUnavailableDiagnostic(language, error, executable) {
   const label = languageLabel(language);
   return {
     severity: "error",
     code: "code_scanner_unavailable",
     language,
     target: language,
-    message: `${label} scanner worker is unavailable: ${reasonOf(error)}`
+    message: `${label} scanner worker is unavailable: ${spawnFailureReason(error, executable)}`
   };
 }
+function spawnFailureReason(error, executable) {
+  const reason = reasonOf(error);
+  if (!isExecDenied(error) || executable === undefined) {
+    return reason;
+  }
+  return `${reason}; the scanner is executable but ${dirname(executable)} refuses to ` + `execute it, which a \`noexec\` mount does. Install DocBridge as a project ` + `dependency, or point the installer cache at an exec-capable directory, ` + `instead of running through \`bunx\``;
+}
+function isExecDenied(error) {
+  if (!(error instanceof Error)) {
+    return false;
+  }
+  const code = error.code;
+  return code === "EACCES" || code === "EPERM";
+}
 function scannerFailedDiagnostic(language, reason) {
   const label = languageLabel(language);
   return {
@@ -169531,11 +169556,7 @@ function duplicateLinkDiagnostic(source, target, location, range) {
 }
 
 // src/core/code-language.ts
-var KNOWN_CODE_LANGUAGES = [
-  "typescript",
-  "swift",
-  "dart"
-];
+var KNOWN_CODE_LANGUAGES = ["typescript", "swift", "dart"];
 function isCodeLanguage(value) {
   return KNOWN_CODE_LANGUAGES.includes(value);
 }
@@ -169554,6 +169575,10 @@ function resolveScannerWorkerCommand(language, options = {}) {
   const candidates = scannerExecutableCandidates(language, platformKey, platformSupported, options);
   const found = candidates.find((candidate) => existsSync(candidate));
   if (found !== undefined) {
+    const repair = ensureExecutable(found, options.chmod ?? chmodSync);
+    if (!repair.ok) {
+      return { ok: false, diagnostic: scannerUnavailableDiagnostic2(language, repair.reason) };
+    }
     return { ok: true, command: [found] };
   }
   if (!platformSupported) {
@@ -169578,9 +169603,7 @@ function createScannerWorkerAdapter(language, command, adapterOptions = {}) {
       if (!commandResolution.ok) {
         return {
           ...emptyScan(language, filePath),
-          diagnostics: [
-            fileScopedScannerDiagnostic(commandResolution.diagnostic, filePath)
-          ]
+          diagnostics: [fileScopedScannerDiagnostic(commandResolution.diagnostic, filePath)]
         };
       }
       const result = invokeScannerWorker({
@@ -169618,9 +169641,18 @@ function collectCodeFiles(projectRoot, codeInclude) {
       collected.push({ language, relPath });
     }
   }
-  collected.sort((left, right) => left.relPath < right.relPath ? -1 : left.relPath > right.relPath ? 1 : 0);
+  collected.sort((left, right) => comparePaths2(left.relPath, right.relPath));
   return collected;
 }
+function comparePaths2(left, right) {
+  if (left < right) {
+    return -1;
+  }
+  if (left > right) {
+    return 1;
+  }
+  return 0;
+}
 function scanCodeFiles(projectRoot, files, codeInclude, read, onContent) {
   const codeFiles = [];
   const diagnostics = [];
@@ -169695,6 +169727,40 @@ function scannerExecutableCandidates(language, platformKey, platformSupported, o
     ...platformSupported ? [join3(distRoot, "bin", platformKey, executable)] : []
   ];
 }
+function ensureExecutable(path, chmod) {
+  let mode;
+  try {
+    mode = statSync(path).mode;
+  } catch (error) {
+    return { ok: false, reason: `cannot stat ${path}: ${reasonOf2(error)}` };
+  }
+  if (isExecutableByThisProcess(path)) {
+    return { ok: true };
+  }
+  try {
+    chmod(path, mode | 73);
+  } catch (error) {
+    return {
+      ok: false,
+      reason: `${path} is not executable (mode ${formatMode(mode)}) and the executable ` + `bit could not be restored: ${reasonOf2(error)}; run \`chmod +x ${path}\` ` + `or reinstall DocBridge into a writable location`
+    };
+  }
+  return { ok: true };
+}
+function isExecutableByThisProcess(path) {
+  try {
+    accessSync(path, constants.X_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function formatMode(mode) {
+  return `0${(mode & 4095).toString(8).padStart(3, "0")}`;
+}
+function reasonOf2(error) {
+  return error instanceof Error ? error.message : String(error);
+}
 function isSupportedScannerPlatformKey(platformKey) {
   return SUPPORTED_SCANNER_PLATFORM_KEYS.includes(platformKey);
 }
@@ -169706,7 +169772,7 @@ function scannerRootsFromModuleUrl(moduleUrl) {
   } catch {
     resolved = modulePath;
   }
-  const moduleDir = dirname(resolved);
+  const moduleDir = dirname2(resolved);
   return { distRoot: moduleDir, sourceRoot: resolve(moduleDir, "..", "..") };
 }
 function sourceRootPath() {
@@ -169716,7 +169782,7 @@ function distRootPath() {
   return scannerRootsFromModuleUrl(import.meta.url).distRoot;
 }
 function scannerExecutableName(language) {
-  return language === "swift" ? "speclink-swift-scanner" : "speclink_dart_scanner";
+  return language === "swift" ? "docbridge-swift-scanner" : "docbridge_dart_scanner";
 }
 function scannerUnavailableDiagnostic2(language, reason) {
   const label = language.charAt(0).toUpperCase() + language.slice(1);
@@ -169946,24 +170012,18 @@ function isStringArray(value) {
 
 // src/core/diagnostics.ts
 function sortDiagnostics(diagnostics) {
-  return [...diagnostics].sort(compareDiagnostics);
+  return [...diagnostics].toSorted(compareDiagnostics);
 }
 function summarizeDiagnostics(diagnostics) {
-  return diagnostics.reduce((summary, diagnostic) => {
+  const summary = { errors: 0, warnings: 0 };
+  for (const diagnostic of diagnostics) {
     if (diagnostic.severity === "error") {
-      return {
-        ...summary,
-        errors: summary.errors + 1
-      };
+      summary.errors += 1;
+    } else {
+      summary.warnings += 1;
     }
-    return {
-      ...summary,
-      warnings: summary.warnings + 1
-    };
-  }, {
-    errors: 0,
-    warnings: 0
-  });
+  }
+  return summary;
 }
 function formatDiagnostic(diagnostic) {
   const location = diagnostic.location;
@@ -170056,7 +170116,7 @@ function counterpartsOf(graph, endpoint) {
       resolved.push(doc);
     }
   }
-  return resolved.sort(compareEndpoints);
+  return resolved.toSorted(compareEndpoints);
 }
 function addTo(map, key, value) {
   const existing = map.get(key);
@@ -170328,7 +170388,7 @@ function normalizeChangedPaths(projectRoot, paths) {
 }
 function computeRelated(graph, changedFiles) {
   const changedSet = new Set(changedFiles);
-  const sortedPaths = [...changedSet].sort((left, right) => left.localeCompare(right));
+  const sortedPaths = [...changedSet].toSorted((left, right) => left.localeCompare(right));
   const endpointsByFile = indexEndpointsByFile(graph);
   const files = [];
   for (const filePath of sortedPaths) {
@@ -170717,9 +170777,9 @@ function computeContext(graph, contentByFile, inputFiles) {
       linkedFromByEndpoint.get(counterpart.endpoint)?.add(endpoint.endpoint);
     }
   }
-  const contexts = [...blockByEndpoint.values()].sort(compareBlocks);
+  const contexts = [...blockByEndpoint.values()].toSorted(compareBlocks);
   for (const block of contexts) {
-    block.linkedFrom = [...linkedFromByEndpoint.get(block.endpoint) ?? []].sort((left, right) => left.localeCompare(right));
+    block.linkedFrom = [...linkedFromByEndpoint.get(block.endpoint) ?? []].toSorted((left, right) => left.localeCompare(right));
   }
   return {
     contexts,
@@ -170947,8 +171007,8 @@ function computeGraphResult(options) {
       return docNode(doc, options.contentByFile, options.includeContent);
     }
     return;
-  }).filter((node) => node !== undefined).sort(compareNodes);
-  const pairs = computePairs(includedEdges).sort(comparePairs);
+  }).filter((node) => node !== undefined).toSorted(compareNodes);
+  const pairs = computePairs(includedEdges).toSorted(comparePairs);
   const diagnostics = filterDiagnostics(options.diagnostics, nodes, options.inputFiles);
   const bidirectionalPairs = pairs.filter((pair) => pair.hasDocEdge && pair.hasCodeEdge).length;
   const oneWayEdges = pairs.filter((pair) => pair.hasDocEdge !== pair.hasCodeEdge).length;
@@ -171155,7 +171215,7 @@ function computePairs(edges) {
   return [...byKey.values()];
 }
 function appendDocsOrientedLines(lines, result) {
-  const docs = result.nodes.filter((node) => node.kind === "doc").sort(compareNodes);
+  const docs = result.nodes.filter((node) => node.kind === "doc").toSorted(compareNodes);
   for (const doc of docs) {
     const pairs = result.pairs.filter((pair) => pair.docEndpoint === doc.endpoint);
     if (pairs.length === 0) {
@@ -171168,21 +171228,21 @@ function appendDocsOrientedLines(lines, result) {
       lines.push("");
     }
     lines.push(doc.filePath);
-    for (const pair of pairs.sort(comparePairs)) {
+    for (const pair of pairs.toSorted(comparePairs)) {
       lines.push(`  ${fragmentOf2(pair.docEndpoint)} -> ${pair.codeEndpoint} (${pairStatus(pair)})`);
     }
   }
 }
 function appendScopedLines(lines, result, inputFiles) {
   const inputSet = new Set(inputFiles);
-  const nodes = result.nodes.filter((node) => inputSet.has(node.filePath)).sort(compareNodes);
+  const nodes = result.nodes.filter((node) => inputSet.has(node.filePath)).toSorted(compareNodes);
   for (const node of nodes) {
     if (lines.length > 0) {
       lines.push("");
     }
     lines.push(node.filePath);
     const pairs = result.pairs.filter((pair) => pair.codeEndpoint === node.endpoint || pair.docEndpoint === node.endpoint);
-    for (const pair of pairs.sort(comparePairs)) {
+    for (const pair of pairs.toSorted(comparePairs)) {
       if (node.kind === "doc") {
         lines.push(`  ${fragmentOf2(pair.docEndpoint)} -> ${pair.codeEndpoint} (${pairStatus(pair)})`);
       } else {
@@ -171230,72 +171290,6 @@ function comparePairs(left, right) {
 // src/lsp/server.ts
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 
-// src/lsp/transport.ts
-var HEADER_SEPARATOR = `\r
-\r
-`;
-var CONTENT_LENGTH_HEADER = "content-length";
-function encodeMessage(message) {
-  const body = Buffer.from(JSON.stringify(message), "utf8");
-  const header = Buffer.from(`Content-Length: ${body.byteLength}${HEADER_SEPARATOR}`, "utf8");
-  return Buffer.concat([header, body]);
-}
-
-class MessageReader {
-  buffer = Buffer.alloc(0);
-  append(chunk) {
-    this.buffer = Buffer.concat([this.buffer, Buffer.from(chunk)]);
-  }
-  read() {
-    const messages = [];
-    for (;; ) {
-      const message = this.readOne();
-      if (message === null) {
-        break;
-      }
-      messages.push(message.value);
-    }
-    return messages;
-  }
-  readOne() {
-    const separatorText = HEADER_SEPARATOR;
-    const headerEnd = this.buffer.indexOf(separatorText, 0, "utf8");
-    if (headerEnd === -1) {
-      return null;
-    }
-    const headerText = this.buffer.toString("utf8", 0, headerEnd);
-    const contentLength = parseContentLength(headerText);
-    const bodyStart = headerEnd + separatorText.length;
-    if (this.buffer.byteLength - bodyStart < contentLength) {
-      return null;
-    }
-    const bodyEnd = bodyStart + contentLength;
-    const bodyText = this.buffer.toString("utf8", bodyStart, bodyEnd);
-    this.buffer = this.buffer.subarray(bodyEnd);
-    return { value: JSON.parse(bodyText) };
-  }
-}
-function parseContentLength(headerText) {
-  const lines = headerText.split(`\r
-`);
-  for (const line of lines) {
-    const colonIndex = line.indexOf(":");
-    if (colonIndex === -1) {
-      continue;
-    }
-    const name = line.slice(0, colonIndex).trim().toLowerCase();
-    if (name !== CONTENT_LENGTH_HEADER) {
-      continue;
-    }
-    const value = Number.parseInt(line.slice(colonIndex + 1).trim(), 10);
-    if (Number.isNaN(value) || value < 0) {
-      throw new Error(`Invalid Content-Length header: ${line}`);
-    }
-    return value;
-  }
-  throw new Error("Malformed LSP message: missing Content-Length header.");
-}
-
 // src/lsp/position.ts
 function toLspPosition(position) {
   return { line: position.line - 1, character: position.column - 1 };
@@ -171319,70 +171313,6 @@ function rangeContains(range, position) {
   return true;
 }
 
-// src/lsp/index-lookup.ts
-function buildPositionIndex(graph2) {
-  const byFile = new Map;
-  const add = (range, endpoint) => {
-    if (range === undefined) {
-      return;
-    }
-    addTo2(byFile, endpoint.filePath, { range, endpoint });
-  };
-  for (const symbol of graph2.codeByEndpoint.values()) {
-    add(symbol.nameRange, symbol);
-  }
-  for (const anchor of graph2.docByEndpoint.values()) {
-    add(anchor.headingTextRange, anchor);
-  }
-  return { byFile };
-}
-function endpointAt(index, filePath, position) {
-  const entries = index.byFile.get(filePath);
-  if (entries === undefined) {
-    return;
-  }
-  for (const entry of entries) {
-    if (rangeContains(entry.range, position)) {
-      return entry.endpoint;
-    }
-  }
-  return;
-}
-function addTo2(map, key, value) {
-  const existing = map.get(key);
-  if (existing === undefined) {
-    map.set(key, [value]);
-    return;
-  }
-  existing.push(value);
-}
-
-// src/lsp/navigation.ts
-function definition(state, filePath, position) {
-  return counterpartLocators(state, filePath, position);
-}
-function references(state, filePath, position) {
-  return counterpartLocators(state, filePath, position);
-}
-function counterpartLocators(state, filePath, position) {
-  const element = endpointAt(state.index, filePath, position);
-  if (element === undefined) {
-    return [];
-  }
-  return counterpartsOf(state.graph, element.endpoint).map((counterpart) => ({
-    filePath: counterpart.filePath,
-    range: elementRange(counterpart)
-  }));
-}
-function elementRange(element) {
-  const range = element.kind === "code" ? element.nameRange : element.headingTextRange;
-  if (range !== undefined) {
-    return range;
-  }
-  const { line, column } = element.location;
-  return { start: { line, column }, end: { line, column } };
-}
-
 // src/lsp/diagnostics.ts
 var SOURCE = "docbridge";
 function toLspDiagnostic(diagnostic, lineLengths) {
@@ -171421,6 +171351,44 @@ function rangeFor(diagnostic, lineLengths) {
   return { start: { line: 0, character: 0 }, end: { line: 0, character: 0 } };
 }
 
+// src/lsp/index-lookup.ts
+function buildPositionIndex(graph2) {
+  const byFile = new Map;
+  const add = (range, endpoint) => {
+    if (range === undefined) {
+      return;
+    }
+    addTo2(byFile, endpoint.filePath, { range, endpoint });
+  };
+  for (const symbol of graph2.codeByEndpoint.values()) {
+    add(symbol.nameRange, symbol);
+  }
+  for (const anchor of graph2.docByEndpoint.values()) {
+    add(anchor.headingTextRange, anchor);
+  }
+  return { byFile };
+}
+function endpointAt(index, filePath, position) {
+  const entries = index.byFile.get(filePath);
+  if (entries === undefined) {
+    return;
+  }
+  for (const entry of entries) {
+    if (rangeContains(entry.range, position)) {
+      return entry.endpoint;
+    }
+  }
+  return;
+}
+function addTo2(map, key, value) {
+  const existing = map.get(key);
+  if (existing === undefined) {
+    map.set(key, [value]);
+    return;
+  }
+  existing.push(value);
+}
+
 // src/lsp/hover.ts
 var DIVIDER = `
 
@@ -171486,6 +171454,52 @@ function lineAt(content, line) {
 `)[line - 1] ?? "";
 }
 
+// src/lsp/navigation.ts
+function definition(state, filePath, position) {
+  return counterpartLocators(state, filePath, position);
+}
+function references(state, filePath, position) {
+  return counterpartLocators(state, filePath, position);
+}
+function counterpartLocators(state, filePath, position) {
+  const element = endpointAt(state.index, filePath, position);
+  if (element === undefined) {
+    return [];
+  }
+  return counterpartsOf(state.graph, element.endpoint).map((counterpart) => ({
+    filePath: counterpart.filePath,
+    range: elementRange(counterpart)
+  }));
+}
+function elementRange(element) {
+  const range = element.kind === "code" ? element.nameRange : element.headingTextRange;
+  if (range !== undefined) {
+    return range;
+  }
+  const { line, column } = element.location;
+  return { start: { line, column }, end: { line, column } };
+}
+
+// src/lsp/paths.ts
+import { isAbsolute as isAbsolute2, relative as relative2, resolve as resolve2, sep } from "node:path";
+import { fileURLToPath as fileURLToPath2, pathToFileURL } from "node:url";
+function uriToRelativePath(projectRoot, uri) {
+  let absolute;
+  try {
+    absolute = fileURLToPath2(uri);
+  } catch {
+    return;
+  }
+  const rel = relative2(projectRoot, absolute);
+  if (rel === "" || rel.startsWith("..") || isAbsolute2(rel)) {
+    return;
+  }
+  return rel.split(sep).join("/");
+}
+function relativePathToUri(projectRoot, relPath) {
+  return pathToFileURL(resolve2(projectRoot, relPath)).href;
+}
+
 // src/lsp/project.ts
 class Project {
   projectRoot;
@@ -171570,7 +171584,7 @@ class Project {
         }
       }
     }
-    return all.sort((left, right) => left.relPath < right.relPath ? -1 : left.relPath > right.relPath ? 1 : 0);
+    return all.toSorted((left, right) => comparePaths3(left.relPath, right.relPath));
   }
   readContent(relPath) {
     const overlaid = this.overlay.get(relPath);
@@ -171592,7 +171606,7 @@ class Project {
         paths.add(relPath);
       }
     }
-    return [...paths].sort((left, right) => left < right ? -1 : left > right ? 1 : 0);
+    return [...paths].toSorted(comparePaths3);
   }
   contentFor(relPath, scanDiagnostics) {
     const overlaid = this.overlay.get(relPath);
@@ -171607,6 +171621,15 @@ class Project {
     return read.content;
   }
 }
+function comparePaths3(left, right) {
+  if (left < right) {
+    return -1;
+  }
+  if (left > right) {
+    return 1;
+  }
+  return 0;
+}
 function emptyState() {
   const graph2 = buildLinkGraph([], []);
   return {
@@ -171617,24 +171640,70 @@ function emptyState() {
   };
 }
 
-// src/lsp/paths.ts
-import { isAbsolute as isAbsolute2, relative as relative2, resolve as resolve2, sep } from "node:path";
-import { fileURLToPath as fileURLToPath2, pathToFileURL } from "node:url";
-function uriToRelativePath(projectRoot, uri) {
-  let absolute;
-  try {
-    absolute = fileURLToPath2(uri);
-  } catch {
-    return;
+// src/lsp/transport.ts
+var HEADER_SEPARATOR = `\r
+\r
+`;
+var CONTENT_LENGTH_HEADER = "content-length";
+function encodeMessage(message) {
+  const body = Buffer.from(JSON.stringify(message), "utf8");
+  const header = Buffer.from(`Content-Length: ${body.byteLength}${HEADER_SEPARATOR}`, "utf8");
+  return Buffer.concat([header, body]);
+}
+
+class MessageReader {
+  buffer = Buffer.alloc(0);
+  append(chunk) {
+    this.buffer = Buffer.concat([this.buffer, Buffer.from(chunk)]);
   }
-  const rel = relative2(projectRoot, absolute);
-  if (rel === "" || rel.startsWith("..") || isAbsolute2(rel)) {
-    return;
+  read() {
+    const messages = [];
+    for (;; ) {
+      const message = this.readOne();
+      if (message === null) {
+        break;
+      }
+      messages.push(message.value);
+    }
+    return messages;
+  }
+  readOne() {
+    const separatorText = HEADER_SEPARATOR;
+    const headerEnd = this.buffer.indexOf(separatorText, 0, "utf8");
+    if (headerEnd === -1) {
+      return null;
+    }
+    const headerText = this.buffer.toString("utf8", 0, headerEnd);
+    const contentLength = parseContentLength(headerText);
+    const bodyStart = headerEnd + separatorText.length;
+    if (this.buffer.byteLength - bodyStart < contentLength) {
+      return null;
+    }
+    const bodyEnd = bodyStart + contentLength;
+    const bodyText = this.buffer.toString("utf8", bodyStart, bodyEnd);
+    this.buffer = this.buffer.subarray(bodyEnd);
+    return { value: JSON.parse(bodyText) };
   }
-  return rel.split(sep).join("/");
 }
-function relativePathToUri(projectRoot, relPath) {
-  return pathToFileURL(resolve2(projectRoot, relPath)).href;
+function parseContentLength(headerText) {
+  const lines = headerText.split(`\r
+`);
+  for (const line of lines) {
+    const colonIndex = line.indexOf(":");
+    if (colonIndex === -1) {
+      continue;
+    }
+    const name = line.slice(0, colonIndex).trim().toLowerCase();
+    if (name !== CONTENT_LENGTH_HEADER) {
+      continue;
+    }
+    const value = Number.parseInt(line.slice(colonIndex + 1).trim(), 10);
+    if (Number.isNaN(value) || value < 0) {
+      throw new Error(`Invalid Content-Length header: ${line}`);
+    }
+    return value;
+  }
+  throw new Error("Malformed LSP message: missing Content-Length header.");
 }
 
 // src/lsp/server.ts
@@ -171901,18 +171970,12 @@ function fullChangeText(changes) {
 }
 
 // src/cli/init.ts
-import {
-  cpSync,
-  mkdirSync as mkdirSync2,
-  readFileSync as readFileSync4,
-  statSync as statSync3,
-  writeFileSync
-} from "node:fs";
+import { cpSync, mkdirSync as mkdirSync2, readFileSync as readFileSync4, statSync as statSync4, writeFileSync } from "node:fs";
 import { join as join7, resolve as resolve3 } from "node:path";
 
 // src/core/init-discovery.ts
-import { existsSync as existsSync2, readdirSync as readdirSync2, statSync } from "node:fs";
-import { basename, dirname as dirname2, join as join5 } from "node:path";
+import { existsSync as existsSync2, readdirSync as readdirSync2, statSync as statSync2 } from "node:fs";
+import { basename, dirname as dirname3, join as join5 } from "node:path";
 var HIGH_CONFIDENCE_DIR_NAMES = new Set([
   "docs/specs",
   "specs",
@@ -171975,7 +172038,7 @@ function discoverDocsScope(projectRoot) {
   }
   const grouped = new Map;
   for (const filePath of eligible) {
-    const directory = dirname2(filePath);
+    const directory = dirname3(filePath);
     const existing = grouped.get(directory) ?? [];
     existing.push(filePath);
     grouped.set(directory, existing);
@@ -171985,7 +172048,7 @@ function discoverDocsScope(projectRoot) {
     pattern: `${directory}/**/*.md`,
     score: scoreDocsDirectory(directory),
     fileCount: files.length
-  })).sort((left, right) => right.score !== left.score ? right.score - left.score : left.directory.localeCompare(right.directory));
+  })).toSorted((left, right) => right.score !== left.score ? right.score - left.score : left.directory.localeCompare(right.directory));
   const topScore = candidates[0]?.score ?? 0;
   if (topScore === 0) {
     return {
@@ -172082,7 +172145,7 @@ function collectMarkdownFiles(projectRoot, currentDir = ".") {
     const absolutePath = join5(projectRoot, relPath);
     let stats;
     try {
-      stats = statSync(absolutePath);
+      stats = statSync2(absolutePath);
     } catch {
       continue;
     }
@@ -172094,7 +172157,7 @@ function collectMarkdownFiles(projectRoot, currentDir = ".") {
       files.push(relPath);
     }
   }
-  return files.sort();
+  return files.toSorted();
 }
 function isEligibleDocsFile(filePath) {
   if (EXCLUDED_PROSE_BASENAMES.has(basename(filePath).toLowerCase())) {
@@ -172162,14 +172225,8 @@ function isExcludedCodeFile(filePath, language) {
 }
 
 // src/core/init-plan.ts
-import {
-  existsSync as existsSync3,
-  readdirSync as readdirSync3,
-  readFileSync as readFileSync3,
-  realpathSync as realpathSync2,
-  statSync as statSync2
-} from "node:fs";
-import { dirname as dirname3, join as join6, relative as relative4 } from "node:path";
+import { existsSync as existsSync3, readdirSync as readdirSync3, readFileSync as readFileSync3, realpathSync as realpathSync2, statSync as statSync3 } from "node:fs";
+import { dirname as dirname4, join as join6, relative as relative3 } from "node:path";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
 var CONFIG_FILE_NAME2 = "docbridge.config.json";
 var INIT_SKILL_NAMES = [
@@ -172267,12 +172324,12 @@ function resolvePackageRoot(moduleUrl = import.meta.url) {
   } catch {
     resolved = modulePath;
   }
-  let dir = dirname3(resolved);
+  let dir = dirname4(resolved);
   for (;; ) {
     if (existsSync3(join6(dir, "templates", "skills"))) {
       return dir;
     }
-    const parent = dirname3(dir);
+    const parent = dirname4(dir);
     if (parent === dir) {
       return dir;
     }
@@ -172287,7 +172344,7 @@ function listDistributableSkills(packageRoot) {
   } catch {
     return [];
   }
-  return entries.filter((entry) => entry.startsWith("docbridge-")).filter((entry) => existsSync3(join6(skillsRoot, entry, "SKILL.md"))).sort();
+  return entries.filter((entry) => entry.startsWith("docbridge-")).filter((entry) => existsSync3(join6(skillsRoot, entry, "SKILL.md"))).toSorted();
 }
 function formatInitPlan(plan) {
   const lines = [];
@@ -172409,7 +172466,7 @@ function planSkillOperations(input) {
       }
       operations.push({
         action,
-        path: relative4(input.projectRoot, destinationDir),
+        path: relative3(input.projectRoot, destinationDir),
         reason
       });
     }
@@ -172507,7 +172564,12 @@ function agentDestinations(agentTarget) {
   }
 }
 function formatFileOp(operation) {
-  const label = operation.action === "would-create" ? "would create" : operation.action === "would-overwrite" ? "would overwrite" : operation.action;
+  let label = operation.action;
+  if (operation.action === "would-create") {
+    label = "would create";
+  } else if (operation.action === "would-overwrite") {
+    label = "would overwrite";
+  }
   const reason = operation.reason ? ` (${operation.reason})` : "";
   return `- ${label} ${operation.path}${reason}`;
 }
@@ -172745,7 +172807,7 @@ function resolveProjectRoot(root) {
   const projectRoot = resolve3(root);
   let stats;
   try {
-    stats = statSync3(projectRoot);
+    stats = statSync4(projectRoot);
   } catch {
     throw new InitCliError(`Root path does not exist: ${root}`);
   }
@@ -172968,7 +173030,7 @@ function resolveProjectRoot2(root) {
   const projectRoot = resolve4(root);
   let stats;
   try {
-    stats = statSync4(projectRoot);
+    stats = statSync5(projectRoot);
   } catch {
     throw new CliError(`Root path does not exist: ${root}`);
   }