docbridge 0.13.1 → 0.14.0

package/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.14.0] - 2026-10-08
+
+### Changed
+
+- A heading anchor keeps `_`, as GitHub's heading slugs do. Before, `_` became
+  `-`, so `### title_definitions` gave `#title-definitions`; it now gives
+  `#title_definitions`. A link written with the old `-` form now produces
+  `doc_anchor_not_found`; change it to match the heading, such as
+  `#title_definitions`.
+
 ## [0.13.1] - 2026-10-06
 
 ### Fixed
@@ -558,7 +568,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.13.1...HEAD
+[Unreleased]: https://github.com/salan70/docbridge/compare/v0.14.0...HEAD
+[0.14.0]: https://github.com/salan70/docbridge/releases/tag/v0.14.0
 [0.13.1]: https://github.com/salan70/docbridge/releases/tag/v0.13.1
 [0.13.0]: https://github.com/salan70/docbridge/releases/tag/v0.13.0
 [0.12.0]: https://github.com/salan70/docbridge/releases/tag/v0.12.0

package/dist/bin/darwin-arm64/SHA256SUMS

@@ -1,4 +1,4 @@
-41027ff70b494c96a27c0a4e373a070b47222323d0fb8941f4e694eeaa2f2ad9  docbridge-swift-scanner
-42e6858926db804a07efc8b370b0744e9b23c691b8a363461e5286115c7950ef  docbridge_dart_scanner
+2db42ddea8060f988cea4933696e73d652ae5b807a8e8ff00249375faf2b0be4  docbridge-swift-scanner
+f3da86ea5a0c1c92fa1e1f077251bec490e294d257b09cd03a46c8ce382aad19  docbridge_dart_scanner
 7fc3e6842b3e1bf425b8fd63e241eee7e64875f16be7ba8d1ae4a25baa7f2338  docbridge-rust-scanner
-720b5a88fda4a2ffd10660bae19dd5070989fbe5c9463421a180f17bb50b7915  docbridge-go-scanner
+1646b06856b0420acdcb82d1692b7afea83fe2b7666adeb6412c99782dfc8cae  docbridge-go-scanner

package/dist/bin/linux-x64/SHA256SUMS

@@ -1,4 +1,4 @@
-3f2005f4df20fcf6001111724eac5a9ece412edb5457e3450bd67420e85ba8e3  docbridge-swift-scanner
+0c023cfacede26a217a62420f9da1206b93c228122a3685469685a3db89f7735  docbridge-swift-scanner
 b75b14006ca792ed3ca8faf7ceee9e4d33c895f27dd416b640818cf8a4bdd9c8  docbridge_dart_scanner
 e0da7b8cc6ee23704f5fe8514cc309f0bb60380c77b55e3bc5ed113abd1f3478  docbridge-rust-scanner
-2b8820630246507cdaca9de288dc8a0eb5d870db36287cf8ffd6ec31ce13b328  docbridge-go-scanner
+5b8aee5b85a38679875c473b2dc32f021f022cba242785bb0fd94ee6fda0a6bf  docbridge-go-scanner

package/dist/bin/linux-x64/docbridge-swift-scanner

@@ -1,4 +1,4 @@
 [diffend] Oversized file quarantined before diffing.
 name: package/dist/bin/linux-x64/docbridge-swift-scanner
 size: 40932352 bytes
-sha256: 3f2005f4df20fcf6001111724eac5a9ece412edb5457e3450bd67420e85ba8e3
+sha256: 0c023cfacede26a217a62420f9da1206b93c228122a3685469685a3db89f7735

package/dist/index.js

@@ -175581,7 +175581,7 @@ import { join as join15, resolve as resolve5 } from "node:path";
 // package.json
 var package_default = {
   name: "docbridge",
-  version: "0.13.1",
+  version: "0.14.0",
   description: "A CLI that links Markdown specifications and code declarations. Runs on Node.js and Bun.",
   keywords: [
     "bun",
@@ -177597,24 +177597,13 @@ function manifestLink(source, target, entry, side) {
 }
 
 // src/shared/cancelable.ts
-function deferred() {
-  let settle;
-  const promise = new Promise((resolve2, reject) => {
-    settle = { resolve: resolve2, reject };
-  });
-  return {
-    promise,
-    resolve: (value) => settle?.resolve(value),
-    reject: (error) => settle?.reject(error)
-  };
-}
 function settledCancelable(value) {
   return { promise: Promise.resolve(value), cancel: () => {
     return;
   } };
 }
 function mapCancelable(task, map) {
-  const mapped = deferred();
+  const mapped = Promise.withResolvers();
   let cancelled = false;
   task.promise.then((value) => {
     if (cancelled) {
@@ -177640,7 +177629,7 @@ function isAbortError(error) {
   return error instanceof Error && error.name === "AbortError";
 }
 function cancelableSequence(body) {
-  const outcome = deferred();
+  const outcome = Promise.withResolvers();
   let cancelled = false;
   let running;
   const step = async (next) => {
@@ -178539,7 +178528,7 @@ function workerTimeoutMs(fileCount) {
   return 30000 + 1000 * fileCount;
 }
 function runScannerWorkerProcess(input) {
-  const run = deferred();
+  const run = Promise.withResolvers();
   let settled = false;
   let timer;
   let grace;
@@ -179495,7 +179484,7 @@ function stripClosingHashes(text) {
 }
 function toAnchor(headingText) {
   const lowered = headingText.toLowerCase();
-  const replaced = lowered.replace(/[^\p{L}\p{N}]+/gu, "-");
+  const replaced = lowered.replace(/[^\p{L}\p{N}_]+/gu, "-");
   return replaced.replace(/^-+/, "").replace(/-+$/, "");
 }
 function matchCodeComment(line, filePath, lineNumber) {

package/docs/user/linking.md

@@ -255,8 +255,9 @@ Use the scanner-produced canonical symbol ID exactly.
 ## Heading anchors and reciprocity
 
 DocBridge creates anchors from ATX headings only. It lowercases the heading,
-collapses runs of whitespace and punctuation to `-`, preserves Unicode letters
-and numbers, and removes leading and trailing hyphens. `## Login Spec (v2)` is
+collapses runs of whitespace and punctuation other than `_` to `-`, keeps `_`
+as GitHub's heading slugs do, preserves Unicode letters and numbers, and removes
+leading and trailing hyphens. `## Login Spec (v2)` is
 `#login-spec-v2`.
 
 Empty headings have no anchor; a `@code` annotation attached to an empty

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docbridge",
-  "version": "0.13.1",
+  "version": "0.14.0",
   "description": "A CLI that links Markdown specifications and code declarations. Runs on Node.js and Bun.",
   "keywords": [
     "bun",