deepseek-harness/docs
Dudu-0223 853f4d5cfb refactor(subagent): drop host-user authority and split lifecycle publication
Remove the host-user continuation capability and the public residency query,
then separate the seam's public event payloads from its internal lifecycle
control interfaces.

`followup()` now takes the exact live direct parent `Agent` instead of a
`SubagentAuthority` union. No production adapter ever supplied user authority,
so the `UserAuthorityGrant` brand token existed only to stop a forged
discriminant from bypassing the direct-parent check — deleting the branch
retires the token, its mint method, and that attack surface together.

Narrowing `parent` from `Agent | undefined` to `Agent` removes three special
cases, including the path where a parentless epoch dispatched its lifecycle
events unscoped. Scoped-versus-global dispatch is now decided by the event, not
by whether a caller happened to have a parent.

`activationState()` had no caller; `ActivationState`, `ActivationObserver`, and
`ContinuationHost` are package-private.

New `src/lifecycle.ts` owns the contained emitter, the one-shot run observer,
and the Activation observer, while `SubagentRunInfo`/`SubagentRunEndInfo` move
to `src/types.ts` beside the other consumer-facing contracts. Those payloads are
public API — dsh-jsonrpc, hooks-claude, and the package invariant all consume
them — whereas the observer is a contract between two in-package collaborators,
so they no longer share a home merely for both being lifecycle-shaped. The
service keeps ownership of the scope carrier: `scopeTarget()` composes the
service's own context filter, so a narrowed stand-in would silently change
scope filtering.

Also drops now-unused dsh-tasks-local and dsh-tool-tasks dev dependencies, and
corrects the README claim that a pre-residency failure emits a terminal edge —
that path only ever rethrew.
2026-08-02 12:51:08 +08:00
..
cookbook adopt native GitHub stack workflow 2026-08-02 03:17:42 +08:00
cordis-catalog refactor(subagent): drop host-user authority and split lifecycle publication 2026-08-02 12:51:08 +08:00
cordis-tutorial fix(cli): close shared config review gaps 2026-07-30 14:56:39 +08:00
core-data-structures refactor(subagent): drop host-user authority and split lifecycle publication 2026-08-02 12:51:08 +08:00
i18n Merge branch 'worktree-llm-dynamic-config' into worktree-llm-web-config 2026-07-30 15:18:26 +08:00
postmortem Merge fix/web-agent-runtime-context into fix/web-gui-feedback-loop 2026-08-01 22:15:36 +08:00
user Merge branch 'worktree-llm-dynamic-config' into worktree-llm-web-config 2026-07-30 20:15:40 +08:00
agent-lifecycle.md refactor(agent): return request retry action 2026-07-27 21:17:49 +08:00
AGENTS.md docs(notes): archive low-value decision records 2026-07-26 23:06:00 +08:00
architecture.i18n.yaml refactor(subagent): merge continuation control service 2026-08-02 04:34:16 +08:00
architecture.md refactor(subagent): merge continuation control service 2026-08-02 04:34:16 +08:00
architecture.zh.md refactor(subagent): merge continuation control service 2026-08-02 04:34:16 +08:00
capability-seams.md refactor(subagent): merge continuation control service 2026-08-02 04:34:16 +08:00
config-catalog.md docs: regenerate the config catalog source line 2026-08-02 12:51:08 +08:00
cordis-paper.pdf docs: add cordis paper 2026-07-31 15:54:36 +08:00
cordis-primer.i18n.yaml docs(i18n): clarify Cordis and test wording 2026-07-24 14:21:15 +08:00
cordis-primer.md Merge remote-tracking branch 'origin/master' into worktree/pr343-retarget-latest-master 2026-07-23 13:40:29 +08:00
cordis-primer.zh.md docs(i18n): clarify Cordis and test wording 2026-07-24 14:21:15 +08:00
defensive-patterns.i18n.yaml docs(security): include password names in scrub rule 2026-07-28 09:40:33 -07:00
defensive-patterns.md docs(security): include password names in scrub rule 2026-07-28 09:40:33 -07:00
defensive-patterns.zh.md docs(security): include password names in scrub rule 2026-07-28 09:40:33 -07:00
development.i18n.yaml docs: evaluate SPDX conjunctions and read every Python manifest 2026-07-30 19:54:27 -07:00
development.md docs: evaluate SPDX conjunctions and read every Python manifest 2026-07-30 19:54:27 -07:00
development.zh.md docs: evaluate SPDX conjunctions and read every Python manifest 2026-07-30 19:54:27 -07:00
event-producer-consumer.md refactor(subagent): drop host-user authority and split lifecycle publication 2026-08-02 12:51:08 +08:00
glossary.i18n.yaml docs: align Goal Round step cardinality 2026-07-24 12:10:40 +08:00
glossary.md docs: align Goal Round step cardinality 2026-07-24 12:10:40 +08:00
glossary.zh.md docs(i18n): allow zero-step Goal Rounds 2026-07-23 21:13:34 +08:00
graph-atlas.md fix(docs): align catalogs with consolidated CLI 2026-07-30 10:34:21 +08:00
module-graph.md refactor(subagent): merge continuation control service 2026-08-02 04:34:16 +08:00
persistence-catalog.md feat(subagent): continuable background subagents 2026-08-02 04:34:15 +08:00
testing.i18n.yaml Merge remote-tracking branch 'origin/master' into feature/shared-cli-config-foundation 2026-07-30 15:00:42 +08:00
testing.md Merge remote-tracking branch 'origin/master' into feature/shared-cli-config-foundation 2026-07-30 15:00:42 +08:00
testing.zh.md Merge remote-tracking branch 'origin/master' into feature/shared-cli-config-foundation 2026-07-30 15:00:42 +08:00
tool-catalog.md fix(subagent): address codex review round 3 2026-08-02 12:51:08 +08:00
tool-execution-pipeline.md Merge remote-tracking branch 'origin/master' into feat/send-unify 2026-07-23 22:41:45 +08:00
typert-catalog-integration-design.i18n.yaml refactor(cordis): generate catalogs from Typert models 2026-07-29 23:55:12 +08:00
typert-catalog-integration-design.md refactor(cordis): generate catalogs from Typert models 2026-07-29 23:55:12 +08:00
typert-catalog-integration-design.zh.md refactor(cordis): generate catalogs from Typert models 2026-07-29 23:55:12 +08:00
web-styling.i18n.yaml docs: translate remaining non-README documentation 2026-07-26 02:33:29 +08:00
web-styling.md docs: translate remaining non-README documentation 2026-07-26 02:33:29 +08:00
web-styling.zh.md docs: translate remaining non-README documentation 2026-07-26 02:33:29 +08:00