DocRefract v0.2.4

DocRefract turns PDF and DOCX comparisons into deterministic content,
format, layout, media, and structure changes that CI can gate.

Install from NuGet.org

dotnet tool install --global DocRefract.Tool --version 0.2.4
docrefract --version

Install without the .NET SDK

Download the archive matching your operating system and CPU, extract
its single top-level directory, and run docrefract (docrefract.exe
on Windows). The six archives cover Windows, Linux, and macOS on x64
and arm64.

30-second example

docrefract demo --out report

Open report/index.html for the offline review or consume
report/diff.json in CI. Exit codes are 0 for pass, 1 for a
prohibited change, and 2 for an input or processing error.

Release integrity

SHA256SUMS covers the NuGet package, notices, all six native
archives, and all seven SPDX SBOMs. Download all 16 assets before
checking the manifest.

What's Changed

Other changes

• fix: resume draft releases by exact tag by @jinyounghub in #8
• Improve post-launch activation and document CI onboarding by @jinyounghub in #10
• Prepare DocRefract v0.2.4 release by @jinyounghub in #11

Full Changelog: v0.2.3...v0.2.4

DocRefract v0.2.3

DocRefract turns PDF and DOCX comparisons into deterministic content,
format, layout, media, and structure changes that CI can gate.

Install from NuGet.org

dotnet tool install --global DocRefract.Tool --version 0.2.3
docrefract --version

Install without the .NET SDK

Download the archive matching your operating system and CPU, extract
its single top-level directory, and run docrefract (docrefract.exe
on Windows). The six archives cover Windows, Linux, and macOS on x64
and arm64.

30-second example

docrefract demo --out report

Open report/index.html for the offline review or consume
report/diff.json in CI. Exit codes are 0 for pass, 1 for a
prohibited change, and 2 for an input or processing error.

Release integrity

SHA256SUMS covers the NuGet package, notices, all six native
archives, and all seven SPDX SBOMs. Download all 16 assets before
checking the manifest.

What's Changed

Other changes

• fix: attest immutable release tags by @jinyounghub in #7

Full Changelog: v0.2.2...v0.2.3

DocRefract v0.1.1

DocRefract turns PDF and DOCX comparisons into deterministic content,
format, layout, media, and structure changes that CI can gate.

Install from this release

Prerequisites: the .NET 10 SDK and GitHub CLI.

gh release download v0.1.1 --repo jinyounghub/docrefract --pattern "DocRefract.Tool.0.1.1.nupkg" --dir .docrefract-packages
dotnet tool install --global DocRefract.Tool --version 0.1.1 --source .docrefract-packages
docrefract --version

If DocRefract is already installed, replace install with update:

dotnet tool update --global DocRefract.Tool --version 0.1.1 --source .docrefract-packages

You can also download the .nupkg asset in a browser and pass its
containing directory to dotnet tool install --source. Open a new
terminal if the docrefract command is not yet on PATH.

30-second example

docrefract baseline.docx candidate.docx --out report --fail-on content,layout,media

Open report/index.html for the offline review or consume
report/diff.json in CI. Exit codes are 0 for pass, 1 for a
prohibited change, and 2 for an input or processing error.

Current boundaries

This early alpha compares like formats only (PDF-to-PDF or
DOCX-to-DOCX). It does not include OCR, exact Word pagination, or a
raster visual-diff fallback, and it is not a hard parser sandbox.

Assets

• DocRefract.Tool.0.1.1.nupkg: installable .NET global tool
• DocRefract.Tool.0.1.1.spdx.json: SPDX SBOM for the packaged runtime payload
• SHA256SUMS: SHA-256 digests for every other release asset
• THIRD_PARTY_NOTICES.md: bundled dependency notices and license references

Download all four assets into one directory before checking SHA256SUMS.

What's Changed

Other changes

• build(deps): bump the github-actions group with 3 updates by @dependabot[bot] in #1
• Bump the dotnet-dependencies group with 3 updates by @dependabot[bot] in #2

New Contributors

• @dependabot[bot] made their first contribution in #1

Full Changelog: v0.1.0...v0.1.1

DocRefract v0.1.0

Superseded by v0.1.1. Use v0.1.1 for the canonical install package, package-centered SBOM, complete checksums, and documented install path.

This was the first public alpha. Its attached SBOM reflects the source checkout rather than the packaged runtime payload and is retained for historical reproducibility.

Full Changelog: https://github.com/jinyounghub/docrefract/commits/v0.1.0