victorzhong0110/dsh-outcome-loop

dsh-outcome-loop

Task outcome ledger & acceptance plugin for DeepSeek Harness (DSH) · 任务结果账本与验收插件

Know whether a task was actually completed — with near-zero extra tokens and mechanically re-checkable evidence — and keep the result as a portable, user-owned record.

dsh-outcome-loop is a local-first, user-owned, vendor-neutral task outcome ledger and acceptance plugin for DSH. It organizes one DSH session's goal, constraints, acceptance criteria, execution evidence, user feedback, cost, and final result into a re-auditable task record.

• Stops "the model said done" from being mistaken for "the task is done": acceptance is based on mechanical evidence — tests, build, lint, exit codes, file state, diagnostics, git scope;
• Zero extra model cost by default: no extra LLM calls, no model-visible tools, no system-prompt injection;
• Local by default, offline by default: all result data lives in your own DSH storage backend;
• User owns and controls the data: inspect, delete, or export — with a preview + redaction gate before any export;
• Separates success, failure, unknown, stale evidence, user acceptance and user abandonment — an unknown is never silently converted into a success.

Interview oral (3 minutes)

One-page whiteboard script (no ADR binder): docs/ORAL-3MIN.md. Covers problem → data/control plane → non-negotiables → proof we are not cosplaying Datadog.

Quick start

Install

# From source
pnpm install
pnpm build
pnpm pack   # produces dsh-outcome-loop-<version>.tgz

# Install into a DSH profile
dsh plugin --profile <name> add ./dsh-outcome-loop-0.1.0-beta.8.tgz

Prerequisite — storageDomain (real-host verified): the plugin requires the storageDomain service, which the official dsh-base bundle does not provide (only upper bundles such as @deepseek-ai/dsh-web-app do; the web profile already has it). On a bare/headless profile, add it once:

dsh plugin --profile <name> add @deepseek-ai/dsh-storage-domain@0.1.0-rc.8
# then append to ~/.dsh/profiles/<name>/cordis.patch.yml:
# - insert:
#     - id: storage
#       name: "@deepseek-ai/dsh-storage"
#     - id: storage-json
#       name: "@deepseek-ai/dsh-storage-json"
#       config:
#         root: !!js dshHomePath("storages")
#     - id: storage-domain
#       name: "@deepseek-ai/dsh-storage-domain"
#       config:
#         backend: json

Without it the profile boot fails loud with waiting for service: storageDomain (fail-loud by design; see COMPATIBILITY.md §4 for the verified lifecycle: add → dump-config → boot → real /outcome commands → restart-read → uninstall).