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:
- Every observed child run has settled.
- 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.
Acknowledgement commits only after the real ToolRuntime pipeline returns a
successful top-level result that still contains the plugin's complete evidence
block. A post-execute policy that blocks or replaces that content leaves the
run pending, and nested transport calls are rejected because their output is
not direct evidence in the parent agent's 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
- Work normally in goal mode and delegate background reviews as needed.
- If goal completion is denied, call
goal_quiescence_status.
- Wait for each
running run to settle.
- Call
goal_quiescence_ack with each returned runId; inspect the terminal
output it returns.
- 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 and after blocked, replaced, or nested
acknowledgements, verifies the child output reaches the final acknowledgement
tool result, covers failed children with no terminal output, and finally
completes the unchanged goal revision.
pnpm test
pnpm check
pnpm run smoke:package
The package smoke test installs the packed artifact into an isolated temporary
DSH home, boots the real Web profile on DSH 0.1.6-alpha.2, and verifies that
both goal-quiescence tools are registered. Its JSON result records the package
SHA-256, DSH version, Node version, profile, tool names, and HTTP status.
