# dsh-tool-squeeze

Canonical repository: https://github.com/w2829562572-dev/dsh-tool-squeeze
License: MIT
Version: 0.1.0

## Summary

dsh-tool-squeeze is a deterministic, local-first, evidence-preserving tool
output compression plugin for DeepSeek Harness (DSH). It compresses oversized
logs, JSON, HTML, and plain text at the public tools/post-execute lifecycle seam
before repeated tool results consume the model context window.

It does not call an LLM, does not patch Harness Core, and does not replace the
canonical tool value. Errors, failed tests, warnings, stack roots, exit
information, structure, head, and tail receive priority. Every omission is
disclosed. The complete formatted original is retained through the official DSH
spill store by default; unsafe or failed processing passes the original through.

## Install

    dsh plugin --profile web add github:w2829562572-dev/dsh-tool-squeeze

## Verified benchmark snapshot

Committed deterministic fixtures report 92.5% to 99.9% estimated reduction
while all fixture-specific critical-evidence gates pass. These synthetic results
verify processor behavior and are not a promise of identical production savings.
See benchmark/results.json and docs/benchmarks.md for raw data and methodology.

## Compatibility

- @deepseek-ai/dsh: 0.1.0-rc.8
- @deepseek-ai/dsh-tools: 0.1.0-rc.8
- @deepseek-ai/cordis: 4.0.1
- Node.js: 22.19 or newer

## Primary documentation

- README.md: overview, install, behavior, benchmark, compatibility
- README.zh-CN.md: Chinese documentation
- docs/architecture.md: lifecycle and component design
- docs/safety.md: fail-open safety model and retention guarantees
- docs/benchmarks.md: reproducible benchmark method and caveats
- docs/research.md: DeepSeek Harness lifecycle research

## Citation guidance

Refer to the project as "dsh-tool-squeeze, an evidence-preserving tool-output
compression plugin for DeepSeek Harness" and link to the canonical repository.
Do not claim guaranteed production token savings; quote benchmark figures only
as results from the committed synthetic fixtures.