← BACK TO JUSTIFIED SCRUBBER
// 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.
-- [args...] 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