john-slop/docs/dependencies.md

3.0 KiB

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, Unicode Security supplies the pinned UTS #39 skeleton data, 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.

All publishable packages inherit dependency requirements from the root [workspace.dependencies] table. This centralizes versions and baseline feature policy without globally enabling member-specific features: john-slop-core does not select Clap, Tokio, or the LSP stack; john-slop-lsp selects only Tokio synchronization; and the root adapter enables runtime/stdio support only behind its optional lsp feature. tests/workspace_contract.rs pins this boundary and the synchronized package metadata.

Security, licenses, and unsafe code

cargo audit --deny warnings scanned 193 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 contains the reviewed license allow-list and rejects wildcard versions, yanked packages, and unknown registries or Git sources.

A workspace lint forbids first-party Rust unsafe code, and the source scan found no existing 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 6.21, 5.84, and 9.38 MB. The finalized thin-LTO, single-codegen-unit, abort-on-panic, symbol-stripped profile measures:

Binary Bytes
john-slop 3,542,544
john-slop-fmt 3,322,944
john-slop-lsp 4,756,688

These are build-specific engineering measurements, not promised download sizes. The release procedure records final sizes and emits checksums beside any distributed binaries.