john-slop/docs/dependencies.md

51 lines
2.3 KiB
Markdown

# Dependency and binary review
Milestone 7 reviewed the locked graph on 2026-09-29 with Rust 1.100.0-nightly
on x86-64 Linux.
## Features and scope
The normal dependency graph contains 135 distinct package names. Direct crates
serve narrow boundaries: Clap parses adapters, Figment/Serde/TOML load typed
configuration, Regex/Globset compile rules and scopes, Miette renders
diagnostics, Walkdir/Zip acquire inputs, Tokio/tower-lsp-server implement the
stdio protocol, and Tempfile/Similar support atomic writes and diffs.
Default features are disabled where they would add unrelated behavior. In
particular, Zip previously enabled AES, Bzip2, Deflate64, LZMA, PPMd, Zstandard,
time, and multiple encoders. John Slop reads unencrypted office/ZIP inputs and
now enables only the zlib-rs Deflate path required by common containers. A
Deflate archive regression test pins that support. This removed 394 lockfile
lines. Regex retains Unicode and performance defaults because configured rules
use Unicode text and case matching; Miette's graphical stack remains isolated
behind `fancy-diagnostics`.
## Security, licenses, and unsafe code
`cargo audit --deny warnings` scanned 179 locked packages against 1,277 RustSec
advisories without a finding. `cargo deny --locked check` passed advisories,
licenses, and sources; it reports seven transitive duplicate-version families
as warnings for ongoing review. [`deny.toml`](../deny.toml) contains the reviewed
license allow-list and rejects wildcard versions, yanked packages, and unknown
registries or Git sources.
A source scan found no first-party Rust `unsafe` blocks. Dependencies may use
unsafe code internally, notably for compression, operating-system integration,
and async/runtime primitives; this review does not claim otherwise. Lockfile,
advisory, source, and license checks remain CI gates because this result changes
when dependencies change.
## Release size baseline
Before release-profile stripping, the all-feature Linux binaries measured:
| Binary | Bytes |
| --- | ---: |
| `john-slop` | 6,209,424 |
| `john-slop-fmt` | 5,835,264 |
| `john-slop-lsp` | 9,375,456 |
These are build-specific engineering measurements, not promised download sizes.
The release procedure records final sizes and emits checksums and an SBOM beside
any distributed binaries.