Skip to content

pathdoc 0.1.1

Latest

Choose a tag to compare

@github-actions github-actions released this 16 Sep 22:54
· 1 commit to main since this release

A read-only auditor for the Windows PATH. It reports which directories are on PATH
in the order Windows actually resolves them, which entries are dead or duplicated, and
which executables are shadowing which.

It never writes, and it never touches the network.

Install

With Rust:

cargo install --git https://github.com/chamal-code/pathdoc pathdoc-cli --locked

Or download pathdoc-0.1.1-x86_64-pc-windows-msvc.zip below, extract it, and run pathdoc.exe. It is
self-contained: no runtime to install and no installer. Windows x64 only, because it
reads the registry and file attributes through Windows APIs and does not compile for
other targets.

Verify the download

The binary is unsigned, so SmartScreen will warn the first time you run it, usually
"Windows protected your PC" with the real button behind More info. That is the
absence of a signature rather than the detection of anything, and it cannot be fixed
without a code-signing certificate.

Get-FileHash .\pathdoc-0.1.1-x86_64-pc-windows-msvc.zip -Algorithm SHA256

Compare the result against SHA256SUMS.txt below. The zip also carries both licence
files and the README, so the licence travels with the binary as Apache-2.0 requires.

For automated use

--json emits a versioned contract, currently schemaVersion 4. Exit codes are 0
clean, 1 actionable findings reported, 2 fatal. Shadowing and shell masking are
always reported and never gate the exit code. Read capabilities before treating an
empty list as "nothing found" rather than "not computed".

Version 0.x deliberately: roadmap items that would change the JSON contract are
still outstanding, so 0.x is the accurate claim and 1.0.0 would promise a
stability nobody has decided to offer.