// TECHNICAL MANUAL :: CLI PIPELINE & MULTI-CALL SETUP
Justified Scrubber Integration Manual (v1.1.0)
Justified Scrubber compiles to a single static C++17 executable (justified-scrubber.exe on Windows, justified-scrubber on Linux/macOS) with zero external runtime dependencies and PE-engraved Justified Systems attribution.
1. Checksum Verification & One-Command Multi-Call Setup
Verify the release archive digest against SHA256SUMS.txt, then run --install-aliases once to self-provision j-tr, j-trl, j-id, and j-idl (NTFS hardlinks on Windows, symlinks on POSIX) in the executable's directory:
# Windows x64 (PowerShell) Get-FileHash .\justified-scrubber.exe -Algorithm SHA256 .\justified-scrubber.exe --install-aliases # Linux x86_64 (Precompiled Static ELF) tar -xzf justified-scrubber-v1.1.0-linux-x64.tar.gz sha256sum -c SHA256SUMS.txt chmod +x ./justified-scrubber ./justified-scrubber --install-aliases # macOS Apple Silicon (arm64) & Intel (x86_64) tar -xzf justified-scrubber-v1.1.0-macos-src.tar.gz shasum -a 256 -c SHA256SUMS.txt ./build_clang.sh ./justified-scrubber --install-aliases
2. CLI Flags & Precedence Cascade
Configuration resolves in strict order: (1) CLI Flags → (2) Environment Variables (JSCRUB_ACTION, JSCRUB_LOG) → (3) Binary Stem (j-tr, j-trl, j-id, j-idl) → (4) Default (Terminate, Log OFF).
| Flag / Alias | Behavior |
|---|---|
-r / --redact / j-tr |
Terminate mode: overwrites secrets in-place with 0x00 and emits [J-TR]. |
-t / --tag / j-id |
Identify mode: preserves secret inline inside << markers for local review. |
-l / --log[=PATH] |
Emits zero-secret NDJSON audit ticks ({"tick":1,"action":"J-TR","family":"AWS","offset":42,"len":20}) to stderr or PATH. |
--check |
Deterministic exit-code gate: exits 1 if one or more secrets are intercepted, or 0 if clean. |
-q / --quiet |
Suppresses stdout stream emission (pair with --check for silent Git pre-commit hooks and CI gates). |
--tokens-file=PATH |
Ingests newline-delimited tokens or KEY=VALUE .env secrets into the static 128-token trie and overwrites the read buffer with 0x00 before scanning—keeping secrets out of OS argv telemetry. |
--correlate |
Emits ephemeral per-session OS-salted ARX correlation tags ([J-TR:AWS:4F2A]) so repeated credentials can be traced without exposing raw secret bytes. |
-- |
Launches as a child process, sanitizing both stdout and stderr concurrently and forwarding the child's exact exit code. |
--install-aliases |
Creates j-tr, j-trl, j-id, and j-idl hardlinks/symlinks alongside the primary binary. |
--ndjson |
Preserves JSON object keys and structural syntax, scanning string values only. |
--custom-tokens=A,B |
Loads up to 128 literal tokens (max 128 bytes each) and zeros the argv slice immediately after trie compilation. |
--healthcheck |
Verifies automaton state compilation and ARX seal, emitting HEALTHY with exit code 0. |
3. Universal Cross-OS Workflows & Local Probe Execution
# 1. Wrap any CLI command or AI agent tool (sanitizes BOTH stdout and stderr) j-tr -- terraform apply j-tr --correlate -- kubectl get secret -o yaml # 2. One-line Git pre-commit secret blocker (exits 1 if secrets detected) git diff --cached | justified-scrubber --check -q # 3. Guard streams using project .env values without exposing secrets in argv cat app.log | justified-scrubber --tokens-file=.env # 4. Two-stage local inspection followed by safe external sharing cat deploy.log | j-id > reviewed.log cat reviewed.log | j-tr > external_share.log # 5. Running the included OS-entropy empirical verification suite (Python 3 stdlib only) python tests/probe_11_scrubber_fuzzing.py python tests/probe_12_scrubber_saturation.py python tests/probe_13_characterization_envelope.py