Files
mxaccessgw/docs/ToolchainLinks.md
Joseph Doherty 51a9dadf62 Align docs with StyleGuide and add CLAUDE.md
- Rename 16 kebab-case docs to PascalCase per StyleGuide
- Move per-language client design docs from docs/ to clients/<lang>/
  alongside their READMEs
- Add ## Related Documentation sections to 15 docs that lacked one
- Fix sentence-case violations in H3 headings (StyleGuide rule)
- Update cross-references in gateway.md, client READMEs, scripts,
  and generate-proto.ps1 helpers to follow the new paths
- Add CLAUDE.md with build/test commands, the source-update
  verification matrix, the parity-first contract, and pointers
  to MXAccess and Galaxy Repository analysis sources

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-30 10:19:22 -04:00

6.2 KiB

Toolchain Links

This machine has the project toolchain installed for gateway, worker, dashboard, protobuf/gRPC contracts, and the planned .NET, Go, Rust, Python, and Java clients.

If a new terminal cannot find a recently installed tool, refresh PATH in PowerShell:

$env:Path = [Environment]::GetEnvironmentVariable('Path','Machine') + ';' + [Environment]::GetEnvironmentVariable('Path','User')

Core Tools

Tool Version Path
Git 2.53.0.windows.2 C:\Program Files\Git\cmd\git.exe
winget 1.28.240 C:\Users\dohertj2\AppData\Local\Microsoft\WindowsApps\winget.exe
SQLCMD 14.0.1000.169 NT C:\Program Files\Microsoft SQL Server\Client SDK\ODBC\130\Tools\Binn\SQLCMD.EXE
SQLite CLI 3.53.0 C:\Users\dohertj2\AppData\Local\Microsoft\WinGet\Links\sqlite3.exe
grpcurl 1.9.3 C:\Users\dohertj2\AppData\Local\Microsoft\WinGet\Links\grpcurl.exe

.NET And Windows Build Tools

Tool Version Path
.NET SDK 10.0.201 C:\Program Files\dotnet\dotnet.exe
.NET runtime 10.0.5 C:\Program Files\dotnet\shared\Microsoft.NETCore.App
ASP.NET Core runtime 10.0.5 C:\Program Files\dotnet\shared\Microsoft.AspNetCore.App
Windows Desktop runtime 10.0.5 C:\Program Files\dotnet\shared\Microsoft.WindowsDesktop.App
MSBuild 17.14.40.60911 C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\MSBuild\Current\Bin\MSBuild.exe
Visual Studio Build Tools 2022 BuildTools C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools
VC tools 14.44.35207 C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Tools\MSVC\14.44.35207
C compiler x64 14.44.35207 C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Tools\MSVC\14.44.35207\bin\Hostx64\x64\cl.exe
Linker x64 14.44.35207 C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Tools\MSVC\14.44.35207\bin\Hostx64\x64\link.exe
C compiler x86 14.44.35207 C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Tools\MSVC\14.44.35207\bin\Hostx64\x86\cl.exe
Linker x86 14.44.35207 C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\VC\Tools\MSVC\14.44.35207\bin\Hostx64\x86\link.exe
LibMan CLI 3.0.71 C:\Users\dohertj2\.dotnet\tools\libman.exe

Reference assemblies:

C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.8
C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.8.1

Environment:

DOTNET_ROOT=C:\Program Files\dotnet

Use dotnet build for SDK-style projects. Use the full MSBuild path above when a .NET Framework or COM interop build needs classic Visual Studio MSBuild.

Go

Tool Version Path
Go 1.26.2 windows/amd64 C:\Program Files\Go\bin\go.exe
protoc-gen-go latest installed by go install C:\Users\dohertj2\go\bin\protoc-gen-go.exe
protoc-gen-go-grpc latest installed by go install C:\Users\dohertj2\go\bin\protoc-gen-go-grpc.exe

Environment:

GOROOT=C:\Program Files\Go
GOPATH=C:\Users\dohertj2\go
Go plugin bin=C:\Users\dohertj2\go\bin

Installed plugin commands:

go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest

Rust

Tool Version Path
rustup 1.29.0 C:\Users\dohertj2\.cargo\bin\rustup.exe
rustc 1.95.0 C:\Users\dohertj2\.cargo\bin\rustc.exe
cargo 1.95.0 C:\Users\dohertj2\.cargo\bin\cargo.exe

Rust uses the MSVC toolchain installed with Visual Studio Build Tools. The default Rust linker smoke test has passed.

User cargo bin:

C:\Users\dohertj2\.cargo\bin

Python

Tool Version Path
Python 3.12.10 C:\Users\dohertj2\AppData\Local\Programs\Python\Python312\python.exe
Python launcher installed C:\Users\dohertj2\AppData\Local\Programs\Python\Launcher\py.exe
pip 26.0.1 Python 3.12 site packages

Installed Python packages:

grpcio==1.80.0
grpcio-tools==1.80.0
protobuf==6.33.6
pytest==9.0.3
pytest-asyncio==1.3.0
click==8.3.3
typer==0.25.0

Java

Tool Version Path
Java runtime Temurin 21.0.10+7 LTS C:\Program Files\Eclipse Adoptium\jdk-21.0.10.7-hotspot\bin\java.exe
Java compiler Temurin 21.0.10+7 LTS C:\Program Files\Eclipse Adoptium\jdk-21.0.10.7-hotspot\bin\javac.exe
Gradle 9.4.1 C:\Tools\gradle-9.4.1\bin\gradle.bat
Maven 3.9.15 C:\Tools\apache-maven-3.9.15\bin\mvn.cmd

Environment:

JAVA_HOME=C:\Program Files\Eclipse Adoptium\jdk-21.0.10.7-hotspot
GRADLE_HOME=C:\Tools\gradle-9.4.1
MAVEN_HOME=C:\Tools\apache-maven-3.9.15

Protobuf And gRPC

Tool Version Path
protoc 34.1 C:\Users\dohertj2\AppData\Local\Microsoft\WinGet\Packages\Google.Protobuf_Microsoft.Winget.Source_8wekyb3d8bbwe\bin\protoc.exe
Buf 1.68.4 C:\Users\dohertj2\AppData\Local\Microsoft\WinGet\Links\buf.exe
grpcurl 1.9.3 C:\Users\dohertj2\AppData\Local\Microsoft\WinGet\Links\grpcurl.exe

Generated code should be reproducible from the shared .proto files. Do not hand-edit generated protobuf or gRPC code.

Project-Specific External References

MXAccess analysis:

C:\Users\dohertj2\Desktop\mxaccess
C:\Users\dohertj2\Desktop\mxaccess\docs\MXAccess-Public-API.md
C:\Users\dohertj2\Desktop\mxaccess\docs\MXAccess-Reverse-Engineering.md

Galaxy Repository SQL notes:

C:\Users\dohertj2\Desktop\lmxopcua\gr
C:\Users\dohertj2\Desktop\lmxopcua\gr\connectioninfo.md
C:\Users\dohertj2\Desktop\lmxopcua\gr\queries

Smoke Checks Performed

These checks passed after installation:

  • dotnet build of a temporary net48 class library.
  • cargo build of a temporary Rust binary using the MSVC linker.
  • go build of a temporary Go module.
  • javac compile of a temporary Java class.
  • Python imports for grpc, grpc_tools, and pytest.