deepseek-harness/docs
Tianyi Cui 05b75abbca refactor(events): document event-domain semantics, drop step-boundary mirror emits
Pin the three-domain rule (session = durable fact log, agent = live runtime
surface, tools = registry/exec): a durable replayable fact is a SessionEvent; a
live interception or transient/live-object signal is an agent/tools Cordis
event. A boundary that is both is mirrored as an agent/* emit ONLY where a live
consumer needs the Agent handle.

Apply it to the boundary twins: drop agent/step-start and agent/step-end (no
production consumer needs the live Agent at a step boundary — consumers read the
durable step/start/step/end session events). Keep agent/turn-start/turn-end (the
stdio UI labels output by agent.id). Tests that observed step boundaries via the
removed emits now observe the durable session events; the pinned behavior is
unchanged.

Conservative subset of the proposed "remove boundary mirror events"
simplification; foundation for the Hooks subsystem's canonical event surface.
2026-06-30 10:32:55 +08:00
..
cookbook feat(tool-todo): add the model-facing todo_write tool 2026-06-29 10:30:52 +08:00
cordis-catalog refactor(events): document event-domain semantics, drop step-boundary mirror emits 2026-06-30 10:32:55 +08:00
core-data-structures feat(tool-todo): add the model-facing todo_write tool 2026-06-29 10:30:52 +08:00
postmortem Fix doc cross-links for the hierarchy; add package-path + shape gates 2026-06-20 23:12:14 +08:00
rfc refactor(events): document event-domain semantics, drop step-boundary mirror emits 2026-06-30 10:32:55 +08:00
AGENTS.md docs(rfc): classify RFCs by kind via path-encoded subdirectories 2026-06-20 22:29:45 +08:00
architecture.md refactor(events): document event-domain semantics, drop step-boundary mirror emits 2026-06-30 10:32:55 +08:00
development.md docs: sync development CI gate docs 2026-06-22 12:54:11 +08:00
module-graph.md feat(tool-todo): add the model-facing todo_write tool 2026-06-29 10:30:52 +08:00