dsh-negative-ledger

In the development and operation of coding agents, agents often repeatedly attempt known failed tool calls or file operations, leading to wasted time and inefficiency. Traditional tools lack persistent recording and intelligent updating for failure paths, preventing effective learning from mistakes. The dsh-negative-ledger plugin serves as a negative-knowledge ledger, specifically recording all disproven paths such as failed commands, missing files, rejected approaches, and unavailable APIs.

Each record includes evidence like exit codes or file states, and automatically invalidates or confirms based on environmental evidence changes. When an agent encounters the same fingerprint (e.g., identical command and working directory), the plugin provides warnings or denies the attempt, avoiding repeated errors. It supports SQLite and JSONL backends, ensures transactional consistency, and enables multi-agent sharing for enhanced reliability.

This tool is ideal for coding agent developers, AI agent builders, and engineers using the DeepSeek Harness framework. It enables agents to manage failure attempts intelligently, reducing resource waste and making it a practical choice for building robust agent systems.