docbridge 0.10.1 → 0.11.0

package/CHANGELOG.md

@@ -7,6 +7,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.11.0] - 2026-09-30
+
+### Added
+
+- Go is a first-party code language. Configure `include.code.go`, put `@doc`
+  in the doc comment of a package-level `func`, `type`, `const`, or `var`, a
+  receiver method, or an interface method, and link back with `@code`. The
+  bundled `docbridge-go-scanner` worker (same platforms as Swift, Dart, and
+  Rust) uses the Go standard library parser only. Visibility defaults to
+  `exported`; `unexported` opts in unexported names, and a method is exported
+  only when both its name and its receiver or interface type name are.
+  Canonical IDs use `Type.Method` without type parameters. An `@doc` above a
+  `const (` / `var (` / `type (` group keyword or above a spec that declares
+  several names is `unsupported_declaration`. The VS Code extension activates
+  for Go files, and `docbridge init` proposes the conventional `cmd/`,
+  `internal/`, and `pkg/` layout.
+
 ## [0.10.1] - 2026-09-28
 
 ### Fixed
@@ -452,7 +469,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.10.1...HEAD
+[Unreleased]: https://github.com/salan70/docbridge/compare/v0.11.0...HEAD
+[0.11.0]: https://github.com/salan70/docbridge/releases/tag/v0.11.0
 [0.10.1]: https://github.com/salan70/docbridge/releases/tag/v0.10.1
 [0.10.0]: https://github.com/salan70/docbridge/releases/tag/v0.10.0
 [0.9.0]: https://github.com/salan70/docbridge/releases/tag/v0.9.0

package/README.md

@@ -6,7 +6,7 @@
 
 DocBridge keeps Markdown documentation and the code that implements it linked
 in both directions. It validates `@doc` annotations on supported TypeScript,
-Swift, Dart, and Rust declarations against `@code` annotations on Markdown
+Swift, Dart, Rust, and Go declarations against `@code` annotations on Markdown
 headings, so humans and coding agents can find the right counterpart before a
 change drifts.
 
@@ -15,7 +15,7 @@ change drifts.
 - Node.js 22 or later, or Bun 1.1.31 or later
 - A project containing Markdown and supported source files
 
-Prebuilt Swift, Dart, and Rust scanners are included for supported macOS and
+Prebuilt Swift, Dart, Rust, and Go scanners are included for supported macOS and
 Linux platforms. See [Releases](https://github.com/salan70/docbridge/releases)
 for packaged-platform details.
 

package/dist/bin/darwin-arm64/SHA256SUMS

@@ -1,3 +1,4 @@
-82a7bc7c1da1307a9e1f3a5a8fc0e8f82a72edb26c7293f6661a14d02448f11b  docbridge-swift-scanner
-1e7589065ce96bc1241458f6acc3b5d44a0a03866cbdf9125702cda84efcf267  docbridge_dart_scanner
+5db695997d6c32f0fd69722d43aabacd38b0ca67ce46f3f80160aff132d9b5d1  docbridge-swift-scanner
+f0218c70949d7fae587d0e208cf9e959ff51fae4bceb7d60b92325c65723af37  docbridge_dart_scanner
 7fc3e6842b3e1bf425b8fd63e241eee7e64875f16be7ba8d1ae4a25baa7f2338  docbridge-rust-scanner
+2779c979bd91996bd0075afbed097fe7c9e2bf71ec331073a09b305e6a8ac510  docbridge-go-scanner

package/dist/bin/linux-x64/SHA256SUMS

@@ -1,3 +1,4 @@
-f034659c6d4a146b09ac5b59571015517aa3aa541ec81a8d55eeb4ac696d1815  docbridge-swift-scanner
-889403d7aee074e966e4112d761e97a1536f12ad4e76d93503ac31bd5ca7e3c7  docbridge_dart_scanner
+ce42be3326a3c7fa127709edbca34056f9e5eda8af3dba1623b51a1c41050328  docbridge-swift-scanner
+b75b14006ca792ed3ca8faf7ceee9e4d33c895f27dd416b640818cf8a4bdd9c8  docbridge_dart_scanner
 e0da7b8cc6ee23704f5fe8514cc309f0bb60380c77b55e3bc5ed113abd1f3478  docbridge-rust-scanner
+4b8b52ff6c806bdd7096afcce59fb05dcdf1cb27a3c5f0ffc8f1908a01085194  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: f034659c6d4a146b09ac5b59571015517aa3aa541ec81a8d55eeb4ac696d1815
+sha256: ce42be3326a3c7fa127709edbca34056f9e5eda8af3dba1623b51a1c41050328

package/dist/index.js

@@ -175581,7 +175581,7 @@ import { join as join14, resolve as resolve4 } from "node:path";
 // package.json
 var package_default = {
   name: "docbridge",
-  version: "0.10.1",
+  version: "0.11.0",
   description: "A CLI that links Markdown specifications and code declarations. Runs on Node.js and Bun.",
   keywords: [
     "bun",
@@ -175787,7 +175787,8 @@ var KNOWN_CODE_LANGUAGES = [
   "typescript",
   "swift",
   "dart",
-  "rust"
+  "rust",
+  "go"
 ];
 function isCodeLanguage(value) {
   return KNOWN_CODE_LANGUAGES.includes(value);
@@ -175842,13 +175843,15 @@ var LANGUAGE_SUFFIX = {
   typescript: ".ts",
   swift: ".swift",
   dart: ".dart",
-  rust: ".rs"
+  rust: ".rs",
+  go: ".go"
 };
 var LANGUAGE_VISIBILITY = {
   typescript: ["public", "protected", "private"],
   swift: ["public", "open", "internal"],
   dart: ["public"],
-  rust: ["pub", "private"]
+  rust: ["pub", "private"],
+  go: ["exported", "unexported"]
 };
 function loadConfig(projectRoot) {
   let rawText;
@@ -176959,7 +176962,8 @@ var FENCE_LANGUAGE = {
   typescript: "ts",
   swift: "swift",
   dart: "dart",
-  rust: "rust"
+  rust: "rust",
+  go: "go"
 };
 var NESTED_BLOCK_COMMENTS = new Set(["swift", "dart", "rust"]);
 function withoutLeadingComments(text, language) {
@@ -178026,7 +178030,8 @@ var SUPPORTED_SCANNER_PLATFORM_KEYS = ["darwin-arm64", "linux-x64"];
 var SCANNER_EXECUTABLE_NAMES = {
   swift: "docbridge-swift-scanner",
   dart: "docbridge_dart_scanner",
-  rust: "docbridge-rust-scanner"
+  rust: "docbridge-rust-scanner",
+  go: "docbridge-go-scanner"
 };
 function scannerPlatformKey() {
   return `${process.platform}-${process.arch}`;
@@ -178075,6 +178080,12 @@ function scannerExecutableCandidates(language, platformKey, platformSupported, o
       ...platformSupported ? [join5(distRoot, "bin", platformKey, executable)] : []
     ];
   }
+  if (language === "go") {
+    return [
+      join5(sourceRoot, "packages/go-scanner/bin", executable),
+      ...platformSupported ? [join5(distRoot, "bin", platformKey, executable)] : []
+    ];
+  }
   return [
     join5(sourceRoot, "packages/dart-scanner/bin", executable),
     ...platformSupported ? [join5(distRoot, "bin", platformKey, executable)] : []
@@ -178188,7 +178199,7 @@ var common_output_schema_default = {
         target: { type: "string" },
         language: {
           type: "string",
-          enum: ["typescript", "swift", "dart", "rust"]
+          enum: ["typescript", "swift", "dart", "rust", "go"]
         },
         source: { type: "string" },
         message: { type: "string" },
@@ -178208,7 +178219,7 @@ var scanner_worker_schema_default = {
   $defs: {
     language: {
       type: "string",
-      enum: ["typescript", "swift", "dart", "rust"]
+      enum: ["typescript", "swift", "dart", "rust", "go"]
     },
     codeSymbol: {
       type: "object",
@@ -178560,7 +178571,8 @@ var builtInAdapters = {
   typescript: typeScriptAdapter,
   swift: createScannerWorkerAdapter("swift", () => resolveScannerWorkerCommand("swift")),
   dart: createScannerWorkerAdapter("dart", () => resolveScannerWorkerCommand("dart")),
-  rust: createScannerWorkerAdapter("rust", () => resolveScannerWorkerCommand("rust"))
+  rust: createScannerWorkerAdapter("rust", () => resolveScannerWorkerCommand("rust")),
+  go: createScannerWorkerAdapter("go", () => resolveScannerWorkerCommand("go"))
 };
 function emptyScan(language, filePath) {
   return {
@@ -180643,11 +180655,13 @@ var TYPESCRIPT_PATTERNS = [
 var SWIFT_PATTERNS = ["Sources/**/*.swift", "*/Sources/**/*.swift"];
 var DART_PATTERNS = ["lib/**/*.dart"];
 var RUST_PATTERNS = ["src/**/*.rs", "*/src/**/*.rs"];
+var GO_PATTERNS = ["*.go", "cmd/**/*.go", "internal/**/*.go", "pkg/**/*.go"];
 var LANGUAGE_PATTERNS = {
   typescript: TYPESCRIPT_PATTERNS,
   swift: SWIFT_PATTERNS,
   dart: DART_PATTERNS,
-  rust: RUST_PATTERNS
+  rust: RUST_PATTERNS,
+  go: GO_PATTERNS
 };
 function discoverRepository(projectRoot) {
   return {
@@ -180854,6 +180868,11 @@ function isExcludedCodeFile(filePath, language) {
       return true;
     }
   }
+  if (language === "go") {
+    if (lower.endsWith("_test.go") || segments.includes("vendor") || segments.includes("testdata")) {
+      return true;
+    }
+  }
   if (segments.some((segment) => ["generated", "gen", ".dart_tool", "build"].includes(segment.toLowerCase()))) {
     return true;
   }
@@ -181609,6 +181628,9 @@ function fenceLanguage(language) {
   if (language === "rust") {
     return "rust";
   }
+  if (language === "go") {
+    return "go";
+  }
   return "ts";
 }
 function codeFence(content) {

package/docs/user/configuration.md

@@ -33,15 +33,20 @@ Declare documentation patterns and at least one supported code language:
 }
 ```
 
-Supported language keys are `typescript`, `swift`, `dart`, and `rust`. A project can
-enable more than one language, each with its own patterns.
+Supported language keys are `typescript`, `swift`, `dart`, `rust`, and `go`. A
+project can enable more than one language, each with its own patterns.
 
 Each language accepts an optional `visibility` array. Omitting it uses the
 scanner default: TypeScript `public` and `protected` members, Swift `public`
-and `open`, Dart `public` only, Rust unrestricted `pub`. A declaration
-excluded by visibility is not an endpoint; an `@doc` on one is
+and `open`, Dart `public` only, Rust unrestricted `pub`, Go `exported`. A
+declaration excluded by visibility is not an endpoint; an `@doc` on one is
 `unsupported_declaration`. See `docbridge docs show linking` for the
-per-language rules, including Dart's leading-underscore privacy.
+per-language rules, including Dart's leading-underscore privacy and Go's
+exported-name rule for methods.
+
+The configuration has no `exclude` list and no glob negation. Narrow the
+positive patterns instead; for Go, `cmd/**/*.go` and `internal/**/*.go` scan
+fewer files than `**/*.go`, but `_test.go` files under them are still scanned.
 
 <!-- @code src/shared/glob.ts#collectFiles -->
 

package/docs/user/getting-started.md

@@ -1,5 +1,5 @@
 ---
-description: Set up DocBridge in an existing TypeScript, Swift, Dart, or Rust project.
+description: Set up DocBridge in an existing TypeScript, Swift, Dart, Rust, or Go project.
 ---
 
 # Getting Started

package/docs/user/linking.md

@@ -72,6 +72,13 @@ void login(String email, String password) {}
 pub fn login(email: &str, password: &str) {}
 ```
 
+```go
+// Login starts the login flow.
+//
+// @doc docs/auth.md#login-flow
+func Login(email, password string) error { return nil }
+```
+
 Paths are relative to the configured root. An annotation on an unsupported or
 visibility-excluded declaration produces `unsupported_declaration`; the same
 declaration without an annotation is ignored.
@@ -114,6 +121,25 @@ to include non-`pub` items. Trait definitions and implementations, macros,
 constants, statics, unions, and extern blocks are not endpoints. IDs use `::`
 qualification, such as `TypingEngine::advance`.
 
+### Go declarations
+
+Supported forms are package-level functions, types (including aliases),
+constants, and variables, plus receiver methods and interface methods. The
+annotation goes in the declaration's doc comment, as `//` lines or one
+`/* */` block. Visibility defaults to `exported`; configure `unexported` to
+include unexported names. A method counts as exported only when both its name
+and its receiver or interface type name are exported. IDs use `.`
+qualification without type parameters, such as `AuthService.Login` and
+`List.Push` for `func (l *List[T]) Push`.
+
+Inside a `const (`, `var (`, or `type (` group, annotate the individual spec;
+an `@doc` in the comment above the group keyword, or above a spec that
+declares several names (`var a, b int`), is `unsupported_declaration` because
+it cannot name one endpoint. Struct fields, embedded fields, the `package`
+clause, imports, `init`, and `_` are not endpoints. The scanner is syntactic:
+`_test.go` files and `//go:build`-constrained files are scanned whenever the
+patterns match them.
+
 <!-- @code src/scan/markdown/markdown.ts#scanMarkdown -->
 
 ## Documentation to code

package/docs/user/troubleshooting.md

@@ -30,7 +30,7 @@ delete it. See [Linking](linking.md) for its format.
 
 ## Scanner errors
 
-Swift, Dart, and Rust use packaged scanner workers. A
+Swift, Dart, Rust, and Go use packaged scanner workers. A
 `code_scanner_unavailable` diagnostic usually means the installed package
 lacks a binary for the current platform or the binary cannot execute.
 Reinstall the package first. If the platform is not supported, run DocBridge
@@ -41,7 +41,7 @@ converting it into a broken link. Check that the source parses with the
 project's own toolchain, then reproduce with the smallest configured file
 set.
 
-`code_parse_error` means a TypeScript, Swift, Dart, or Rust source file has a
+`code_parse_error` means a TypeScript, Swift, Dart, Rust, or Go source file has a
 syntax error. The diagnostic points at the first error the language's parser
 found and includes the parser's message. DocBridge extracts no links or symbols
 from that file, so fix the syntax before judging link diagnostics that involve

package/package.json

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

package/schemas/common-output.schema.json

@@ -44,7 +44,7 @@
         "target": { "type": "string" },
         "language": {
           "type": "string",
-          "enum": ["typescript", "swift", "dart", "rust"]
+          "enum": ["typescript", "swift", "dart", "rust", "go"]
         },
         "source": { "type": "string" },
         "message": { "type": "string" },

package/schemas/context-output.schema.json

@@ -35,7 +35,7 @@
           },
           "language": {
             "type": "string",
-            "enum": ["typescript", "swift", "dart", "rust"],
+            "enum": ["typescript", "swift", "dart", "rust", "go"],
             "description": "Code language for code context blocks."
           },
           "startLine": {

package/schemas/docbridge.schema.json

@@ -21,7 +21,8 @@
             "typescript": { "$ref": "#/$defs/typescriptEntry" },
             "swift": { "$ref": "#/$defs/swiftEntry" },
             "dart": { "$ref": "#/$defs/dartEntry" },
-            "rust": { "$ref": "#/$defs/rustEntry" }
+            "rust": { "$ref": "#/$defs/rustEntry" },
+            "go": { "$ref": "#/$defs/goEntry" }
           }
         },
         "docs": {
@@ -123,6 +124,28 @@
           }
         }
       }
+    },
+    "goEntry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["patterns"],
+      "properties": {
+        "patterns": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "string",
+            "pattern": "\\.go$"
+          }
+        },
+        "visibility": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["exported", "unexported"]
+          }
+        }
+      }
     }
   }
 }

package/schemas/graph-output.schema.json

@@ -31,7 +31,7 @@
           },
           "language": {
             "type": "string",
-            "enum": ["typescript", "swift", "dart", "rust"],
+            "enum": ["typescript", "swift", "dart", "rust", "go"],
             "description": "Code language for code nodes."
           },
           "location": { "$ref": "common-output.schema.json#/$defs/location" },

package/schemas/scanner-worker.schema.json

@@ -7,7 +7,7 @@
   "$defs": {
     "language": {
       "type": "string",
-      "enum": ["typescript", "swift", "dart", "rust"]
+      "enum": ["typescript", "swift", "dart", "rust", "go"]
     },
     "codeSymbol": {
       "type": "object",