dsh-goal-quiescence

dsh-goal-quiescence

Do not complete a Harness goal while observed subagent evidence is still
running or has not been explicitly returned to the goal agent.

dsh-goal-quiescence is a community plugin for DeepSeek Harness. It addresses
the goal-mode failure reported in DeepSeek Harness Discussion #284: a parent can call
update_goal(action=complete) while background reviewers are still running,
after which their result can arrive too late to affect the completed goal.

What it enforces

For every subagent run observed after the plugin has loaded under an active
goal, the plugin records the public subagent/start and subagent/end
lifecycle pair. It then denies update_goal(action=complete) until:

1. Every observed child run has settled.
2. The goal agent calls goal_quiescence_ack for every settled run. That tool
   returns the run's terminal assistant output as its own tool result, making
   the evidence visible in the parent agent's current context.

goal_quiescence_status gives a bounded list of the runs that still block
completion. The plugin does not schedule, cancel, or retry children, and it
does not replace Harness goal mode.

Install

pnpm install
pnpm pack
dsh plugin --profile web add ./dsh-goal-quiescence-<version>.tgz

The bundled patch enables the plugin. It requires the normal Harness goal,
subagent, and tools services provided by the Web profile.

Completion flow

1. Work normally in goal mode and delegate background reviews as needed.
2. If goal completion is denied, call goal_quiescence_status.
3. Wait for each running run to settle.
4. Call goal_quiescence_ack with each returned runId; inspect the terminal
   output it returns.
5. Resolve any reported finding, then call update_goal(action=complete).

Guarantees and boundaries

The gate is a process-local lifecycle policy. It covers runs that begin after
the plugin is loaded and completion attempts made through the model-facing
update_goal tool. The policy deliberately does not claim to be an atomic core
transaction: direct service calls, a process restart, or a child that began
before plugin activation are outside its observable boundary. A core lifecycle
permit would be needed for an end-to-end atomic guarantee.

Within that boundary, acknowledgement is not a metadata checkbox: the
acknowledgement tool returns the saved terminal output into the parent agent's
tool context before it releases completion. This prevents the specific
"settled but unseen" state from being treated as complete.

Verification

The integration test mounts the real Harness ToolRuntime, GoalService, and
SubagentRuntime. It starts a real runtime lifecycle through a deferred
provider, proves completion is denied while the child is running, proves it is
still denied after settlement but before acknowledgement, verifies the child
output reaches the acknowledgement tool result, and finally completes the
unchanged goal revision.

pnpm test
pnpm check