docbridge 0.5.2 → 0.6.0

package/CHANGELOG.md

@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-07-13
+
+### Added
+
+- The npm package now runs on Node.js (>= 22) in addition to Bun: the CLI is
+  built for the Node target with a `#!/usr/bin/env node` shebang, so
+  `npx docbridge` works without installing Bun. Packaging smoke tests exercise
+  the CLI under both runtimes.
+
 ## [0.5.2] - 2026-07-12
 
 ### Fixed
@@ -185,7 +194,8 @@ Initial release of the SpecLink CLI.
 - `speclink check` command with `--root`, `--json`, and `--audit` options.
 - `speclink --version` (alias `-v`) and `speclink --help` (alias `-h`).
 
-[Unreleased]: https://github.com/salan70/docbridge/compare/v0.5.2...HEAD
+[Unreleased]: https://github.com/salan70/docbridge/compare/v0.6.0...HEAD
+[0.6.0]: https://github.com/salan70/docbridge/releases/tag/v0.6.0
 [0.5.2]: https://github.com/salan70/docbridge/releases/tag/v0.5.2
 [0.5.1]: https://github.com/salan70/docbridge/releases/tag/v0.5.1
 [0.5.0]: https://github.com/salan70/docbridge/releases/tag/v0.5.0

package/README.md

@@ -13,10 +13,12 @@ files.
 
 ## Installation
 
-DocBridge is distributed as the `docbridge` npm package and is intended to run
-with Bun:
+DocBridge is distributed as the `docbridge` npm package and runs on Node.js
+(>= 22) and Bun:
 
 ```sh
+npx docbridge check
+# or
 bunx docbridge check
 ```
 
@@ -24,8 +26,7 @@ The current release is
 [v0.5.0](https://github.com/salan70/docbridge/releases/tag/v0.5.0), published
 as `docbridge@0.5.0` on npm.
 
-The npm package is Bun-only; Node.js runtime compatibility is not part of the
-initial distribution. The package includes prebuilt Swift and Dart scanner
+The package includes prebuilt Swift and Dart scanner
 binaries for `darwin-arm64` and `linux-x64`. TypeScript and Markdown checks run
 without scanner binaries. Configured Swift or Dart projects on unsupported
 platforms report `code_scanner_unavailable` and name the supported platform

package/dist/bin/darwin-arm64/SHA256SUMS

@@ -1,2 +1,2 @@
-d77294651a19f091422cc25d67131abfcf4de06d56a7e06116fed66a1ddf4097  speclink-swift-scanner
-9874f1a3e29f2c4ebf2ccd23d9d91e5bf74c9e6b0ca00a117b265418f7f12eb9  speclink_dart_scanner
+3906f1b665d3af642c6c46f7ac0c066dee93f8724a5dd139955becc7dac62d4f  speclink-swift-scanner
+33711635bbf663db5497ae88ee0f9ae181cdefdff67fce021986c106d4327f67  speclink_dart_scanner

package/dist/bin/linux-x64/SHA256SUMS

@@ -1,2 +1,2 @@
-762934bad01b5a33a6b14ff22b579dcb03169436fb01a6a672ab30719c70c294  speclink-swift-scanner
+72d604680e80c5eb6c30d778dcd9d6b70e45b7a9da907723b5fd36b6a77ef882  speclink-swift-scanner
 cfc22c423afaa1e42bef7c0c6b7de42fa54a3e11ca5baad518cd19e0c9c1258d  speclink_dart_scanner

package/dist/index.js

@@ -1,5 +1,5 @@
-#!/usr/bin/env bun
-// @bun
+#!/usr/bin/env node
+import { createRequire } from "node:module";
 var __create = Object.create;
 var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
@@ -31,7 +31,7 @@ var __toESM = (mod, isNodeMode, target) => {
   return to;
 };
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
-var __require = import.meta.require;
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // node_modules/typescript/lib/typescript.js
 var require_typescript = __commonJS((exports, module) => {
@@ -4391,17 +4391,17 @@ m2: ${this.mapper2.__debugToString().split(`
         }
         let BoxCharacter;
         ((BoxCharacter2) => {
-          BoxCharacter2["lr"] = "\u2500";
-          BoxCharacter2["ud"] = "\u2502";
-          BoxCharacter2["dr"] = "\u256D";
-          BoxCharacter2["dl"] = "\u256E";
-          BoxCharacter2["ul"] = "\u256F";
-          BoxCharacter2["ur"] = "\u2570";
-          BoxCharacter2["udr"] = "\u251C";
-          BoxCharacter2["udl"] = "\u2524";
-          BoxCharacter2["dlr"] = "\u252C";
-          BoxCharacter2["ulr"] = "\u2534";
-          BoxCharacter2["udlr"] = "\u256B";
+          BoxCharacter2["lr"] = "─";
+          BoxCharacter2["ud"] = "│";
+          BoxCharacter2["dr"] = "╭";
+          BoxCharacter2["dl"] = "╮";
+          BoxCharacter2["ul"] = "╯";
+          BoxCharacter2["ur"] = "╰";
+          BoxCharacter2["udr"] = "├";
+          BoxCharacter2["udl"] = "┤";
+          BoxCharacter2["dlr"] = "┬";
+          BoxCharacter2["ulr"] = "┴";
+          BoxCharacter2["udlr"] = "╫";
         })(BoxCharacter || (BoxCharacter = {}));
         let Connection;
         ((Connection2) => {
@@ -4652,7 +4652,7 @@ m2: ${this.mapper2.__debugToString().split(`
           for (let column = 0;column < columnCount; column++) {
             for (let lane = 0;lane < lanes.length; lane++) {
               const connector = connectors[column][lane];
-              const fill2 = connector & 4 ? "\u2500" : " ";
+              const fill2 = connector & 4 ? "─" : " ";
               const node = grid[column][lane];
               if (!node) {
                 if (column < columnCount - 1) {
@@ -4666,7 +4666,7 @@ m2: ${this.mapper2.__debugToString().split(`
                 }
               }
               writeLane(lane, getBoxCharacter(connector));
-              writeLane(lane, connector & 8 && column < columnCount - 1 && !grid[column + 1][lane] ? "\u2500" : " ");
+              writeLane(lane, connector & 8 && column < columnCount - 1 && !grid[column + 1][lane] ? "─" : " ");
             }
           }
           return `
@@ -4680,27 +4680,27 @@ ${lanes.join(`
         function getBoxCharacter(connector) {
           switch (connector) {
             case 3:
-              return "\u2502";
+              return "│";
             case 12:
-              return "\u2500";
+              return "─";
             case 5:
-              return "\u256F";
+              return "╯";
             case 9:
-              return "\u2570";
+              return "╰";
             case 6:
-              return "\u256E";
+              return "╮";
             case 10:
-              return "\u256D";
+              return "╭";
             case 7:
-              return "\u2524";
+              return "┤";
             case 11:
-              return "\u251C";
+              return "├";
             case 13:
-              return "\u2534";
+              return "┴";
             case 14:
-              return "\u252C";
+              return "┬";
             case 15:
-              return "\u256B";
+              return "╫";
           }
           return " ";
         }
@@ -11766,7 +11766,7 @@ ${lanes.join(`
         Object.defineProperty(scanner2, "__debugShowCurrentPositionInText", {
           get: () => {
             const text2 = scanner2.getText();
-            return text2.slice(0, scanner2.getTokenFullStart()) + "\u2551" + text2.slice(scanner2.getTokenFullStart());
+            return text2.slice(0, scanner2.getTokenFullStart()) + "║" + text2.slice(scanner2.getTokenFullStart());
           }
         });
       }
@@ -19270,7 +19270,7 @@ ${lanes.join(`
       "`": "\\`",
       "\u2028": "\\u2028",
       "\u2029": "\\u2029",
-      "\x85": "\\u0085",
+      "…": "\\u0085",
       "\r\n": "\\r\\n"
     }));
     function encodeUtf16EscapeSequence(charCode) {
@@ -113100,7 +113100,7 @@ ${lanes.join(`
       return contains(screenStartingMessageCodes, diagnostic.code) ? newLine + newLine : newLine;
     }
     function getLocaleTimeString(system) {
-      return !system.now ? (/* @__PURE__ */ new Date()).toLocaleTimeString() : system.now().toLocaleTimeString("en-US", { timeZone: "UTC" }).replace("\u202F", " ");
+      return !system.now ? (/* @__PURE__ */ new Date()).toLocaleTimeString() : system.now().toLocaleTimeString("en-US", { timeZone: "UTC" }).replace(" ", " ");
     }
     function createWatchStatusReporter(system, pretty) {
       return pretty ? (diagnostic, newLine, options) => {
@@ -168755,13 +168755,13 @@ Additional information: BADCLIENT: Bad error code, ${badCode} not found in range
 });
 
 // src/cli/index.ts
-import { readFileSync as readFileSync5, statSync as statSync4 } from "fs";
-import { resolve as resolve4 } from "path";
+import { readFileSync as readFileSync5, statSync as statSync4 } from "node:fs";
+import { resolve as resolve4 } from "node:path";
 // package.json
 var package_default = {
   name: "docbridge",
-  version: "0.5.2",
-  description: "A Bun CLI that links Markdown specifications and code declarations.",
+  version: "0.6.0",
+  description: "A CLI that links Markdown specifications and code declarations. Runs on Node.js and Bun.",
   license: "MIT",
   type: "module",
   bin: {
@@ -168780,10 +168780,12 @@ var package_default = {
     "markdown",
     "specification",
     "cli",
+    "node",
     "bun",
     "lsp"
   ],
   engines: {
+    node: ">=22",
     bun: ">=1.1.31"
   },
   files: [
@@ -168808,13 +168810,13 @@ var package_default = {
 };
 
 // src/core/code-language.ts
-import { existsSync, realpathSync } from "fs";
-import { dirname, join as join3, resolve } from "path";
-import { fileURLToPath } from "url";
+import { existsSync, realpathSync } from "node:fs";
+import { dirname, join as join3, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
 
 // src/core/glob.ts
-import { lstatSync, readFileSync, readdirSync } from "fs";
-import { join } from "path";
+import { lstatSync, readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
 var IGNORED_SEGMENTS = new Set(["node_modules", ".git"]);
 function validateGlobPattern(pattern) {
   if (pattern.length === 0) {
@@ -168951,9 +168953,10 @@ function escapeRegExpChar(char) {
 }
 
 // src/core/scanner-worker.ts
-import { mkdirSync } from "fs";
-import { tmpdir } from "os";
-import { join as join2 } from "path";
+import { spawnSync } from "node:child_process";
+import { mkdirSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join as join2 } from "node:path";
 function invokeScannerWorker(request, command, run = runScannerWorkerProcess) {
   const processResult = run({
     command,
@@ -169009,21 +169012,32 @@ function runScannerWorkerProcess(input) {
   try {
     const moduleCachePath = clangModuleCachePath();
     mkdirSync(moduleCachePath, { recursive: true });
-    const result = Bun.spawnSync({
-      cmd: input.command,
+    const [executable = "", ...args] = input.command;
+    const result = spawnSync(executable, args, {
       env: {
-        ...Bun.env,
+        ...process.env,
         CLANG_MODULE_CACHE_PATH: moduleCachePath
       },
-      stdin: new TextEncoder().encode(input.stdin),
-      stdout: "pipe",
-      stderr: "pipe"
+      input: input.stdin,
+      encoding: "utf8",
+      maxBuffer: 1024 * 1024 * 1024
     });
+    const stderr = result.stderr ?? "";
+    if (result.error !== undefined) {
+      return { ok: false, error: result.error, stderr };
+    }
+    if (result.status === null) {
+      return {
+        ok: false,
+        error: new Error(`worker terminated by signal ${result.signal ?? "unknown"}`),
+        stderr
+      };
+    }
     return {
       ok: true,
-      exitCode: result.exitCode,
-      stdout: new TextDecoder().decode(result.stdout),
-      stderr: new TextDecoder().decode(result.stderr)
+      exitCode: result.status,
+      stdout: result.stdout ?? "",
+      stderr
     };
   } catch (error) {
     return { ok: false, error, stderr: "" };
@@ -169716,8 +169730,8 @@ function scannerUnavailableDiagnostic2(language, reason) {
 }
 
 // src/core/config.ts
-import { readFileSync as readFileSync2 } from "fs";
-import { join as join4 } from "path";
+import { readFileSync as readFileSync2 } from "node:fs";
+import { join as join4 } from "node:path";
 var CONFIG_FILE_NAME = "docbridge.config.json";
 var EMPTY_CONFIG = {
   include: { code: {}, docs: [] }
@@ -170299,7 +170313,7 @@ function flushDanglingWith(pending, diagnostics, message) {
 }
 
 // src/core/related.ts
-import { isAbsolute, relative } from "path";
+import { isAbsolute, relative } from "node:path";
 function normalizeChangedPaths(projectRoot, paths) {
   const normalized = new Set;
   for (const raw of paths) {
@@ -170607,7 +170621,7 @@ function relationshipDiagnostic(code, source, target, message, link) {
 var MAX_SECTION_LENGTH = 2000;
 var TRUNCATION_MARKER = `
 
-\u2026`;
+…`;
 var atxHeadingPattern2 = /^ {0,3}(#{1,6})(?:[ \t]+.*)?$/;
 var fenceOpenPattern2 = /^ {0,3}(?:`{3,}|~{3,})/;
 function extractDocSection(content, headingLine) {
@@ -171214,7 +171228,7 @@ function comparePairs(left, right) {
 }
 
 // src/lsp/server.ts
-import { fileURLToPath as fileURLToPath3 } from "url";
+import { fileURLToPath as fileURLToPath3 } from "node:url";
 
 // src/lsp/transport.ts
 var HEADER_SEPARATOR = `\r
@@ -171604,8 +171618,8 @@ function emptyState() {
 }
 
 // src/lsp/paths.ts
-import { isAbsolute as isAbsolute2, relative as relative2, resolve as resolve2, sep } from "path";
-import { fileURLToPath as fileURLToPath2, pathToFileURL } from "url";
+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 {
@@ -171893,12 +171907,12 @@ import {
   readFileSync as readFileSync4,
   statSync as statSync3,
   writeFileSync
-} from "fs";
-import { join as join7, resolve as resolve3 } from "path";
+} 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 "fs";
-import { basename, dirname as dirname2, join as join5 } from "path";
+import { existsSync as existsSync2, readdirSync as readdirSync2, statSync } from "node:fs";
+import { basename, dirname as dirname2, join as join5 } from "node:path";
 var HIGH_CONFIDENCE_DIR_NAMES = new Set([
   "docs/specs",
   "specs",
@@ -172154,9 +172168,9 @@ import {
   readFileSync as readFileSync3,
   realpathSync as realpathSync2,
   statSync as statSync2
-} from "fs";
-import { dirname as dirname3, join as join6, relative as relative4 } from "path";
-import { fileURLToPath as fileURLToPath4 } from "url";
+} from "node:fs";
+import { dirname as dirname3, join as join6, relative as relative4 } from "node:path";
+import { fileURLToPath as fileURLToPath4 } from "node:url";
 var CONFIG_FILE_NAME2 = "docbridge.config.json";
 var INIT_SKILL_NAMES = [
   "docbridge-adopt",
@@ -173137,8 +173151,8 @@ function run(argv, io = {
     return 1;
   }
 }
-if (import.meta.main) {
-  process.exitCode = run(Bun.argv.slice(2));
+if (__require.main == __require.module) {
+  process.exitCode = run(process.argv.slice(2));
 }
 export {
   run,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "docbridge",
-  "version": "0.5.2",
-  "description": "A Bun CLI that links Markdown specifications and code declarations.",
+  "version": "0.6.0",
+  "description": "A CLI that links Markdown specifications and code declarations. Runs on Node.js and Bun.",
   "license": "MIT",
   "type": "module",
   "bin": {
@@ -20,10 +20,12 @@
     "markdown",
     "specification",
     "cli",
+    "node",
     "bun",
     "lsp"
   ],
   "engines": {
+    "node": ">=22",
     "bun": ">=1.1.31"
   },
   "files": [