deepseek-harness/docs
Turtle bec6805d6a refactor(session-persistence)!: handle-based seam with a lifecycle-owned write path
The persistence seam is now create/open/stat/list returning per-session
SessionHandles (read/append/flush/close); every log read and write flows
through the owning handle. The seam package exports only the service and
handle contracts, consumer-visible errors, and pure durable-data
validation helpers; each backend owns its complete storage runtime, and
the shared contract suites pin equivalent observable behavior. The
backend routes published sessions' live events by id into the active
write handle; agent-loop only acquires, seeds, and closes the handle.
Resume appends interruptedTurnClosers through its write handle;
session-query owns the revision-keyed cold cache. Legacy-only surfaces
are removed in the same swap: locate/readRaw/supportsRawArtifacts, the
legacy event-shape read migration, zstd torn-frame salvage,
DSH_SESSION_JSONL, and hook transcript_path population; a torn final
zstd frame is discarded whole; the session-list cold blank probe returns
on stat metadata (eventCount derived from the last physical row,
sizeBytes). The WebUI ZIP export serializes the logical log from a read
handle, so both backends export identically.

Refs #3245
2026-09-01 23:19:02 +08:00
..
cookbook fix: complete invariant omission cleanup 2026-08-31 17:10:53 +08:00
cordis-api docs: rebuild the documentation skill and standards (#2983) 2026-08-25 23:47:20 +08:00
cordis-tutorial docs: describe runtime dependency ownership 2026-08-30 02:29:53 +08:00
i18n refactor(bundle): remove the agent spine demo 2026-08-31 11:23:30 +08:00
postmortem docs: rebuild the documentation skill and standards (#2983) 2026-08-25 23:47:20 +08:00
subsystems refactor(session-persistence)!: handle-based seam with a lifecycle-owned write path 2026-09-01 23:19:02 +08:00
user docs: describe runtime dependency ownership 2026-08-30 02:29:53 +08:00
agent-lifecycle.i18n.yaml fix(web): show system prompts in chat 2026-08-25 14:44:08 +08:00
agent-lifecycle.md fix(web): show system prompts in chat 2026-08-25 14:44:08 +08:00
agent-lifecycle.zh.md fix(web): show system prompts in chat 2026-08-25 14:44:08 +08:00
AGENTS.md docs(testing): state the concurrent execution model where tests are written 2026-08-29 15:31:12 +08:00
api-gateway.i18n.yaml docs: describe runtime dependency ownership 2026-08-30 02:29:53 +08:00
api-gateway.md docs: describe runtime dependency ownership 2026-08-30 02:29:53 +08:00
api-gateway.zh.md docs: describe runtime dependency ownership 2026-08-30 02:29:53 +08:00
architecture.i18n.yaml refactor(session-persistence)!: handle-based seam with a lifecycle-owned write path 2026-09-01 23:19:02 +08:00
architecture.md refactor(session-persistence)!: handle-based seam with a lifecycle-owned write path 2026-09-01 23:19:02 +08:00
architecture.zh.md refactor(session-persistence)!: handle-based seam with a lifecycle-owned write path 2026-09-01 23:19:02 +08:00
capability-seams.i18n.yaml docs(doc-graphs): list the experimental Python backend as a codeRuntime implementation 2026-08-31 15:25:26 +08:00
capability-seams.md docs(doc-graphs): list the experimental Python backend as a codeRuntime implementation 2026-08-31 15:25:26 +08:00
capability-seams.zh.md docs(doc-graphs): list the experimental Python backend as a codeRuntime implementation 2026-08-31 15:25:26 +08:00
config-catalog.i18n.yaml refactor(session-persistence)!: handle-based seam with a lifecycle-owned write path 2026-09-01 23:19:02 +08:00
config-catalog.md refactor(session-persistence)!: handle-based seam with a lifecycle-owned write path 2026-09-01 23:19:02 +08:00
config-catalog.zh.md refactor(session-persistence)!: handle-based seam with a lifecycle-owned write path 2026-09-01 23:19:02 +08:00
cordis-primer.i18n.yaml docs: rebuild the documentation skill and standards (#2983) 2026-08-25 23:47:20 +08:00
cordis-primer.md docs: rebuild the documentation skill and standards (#2983) 2026-08-25 23:47:20 +08:00
cordis-primer.zh.md docs: rebuild the documentation skill and standards (#2983) 2026-08-25 23:47:20 +08:00
deepseek-llm-api-wire-extensions.i18n.yaml Revert "Merge pull request #3087 from deepseek-harness/worktree/remove-ignorable-session-events" 2026-08-30 12:26:20 +08:00
deepseek-llm-api-wire-extensions.md Revert "Merge pull request #3087 from deepseek-harness/worktree/remove-ignorable-session-events" 2026-08-30 12:26:20 +08:00
deepseek-llm-api-wire-extensions.zh.md Revert "Merge pull request #3087 from deepseek-harness/worktree/remove-ignorable-session-events" 2026-08-30 12:26:20 +08:00
defensive-patterns.i18n.yaml docs(i18n): localize Chinese internal links 2026-08-18 19:00:37 +08:00
defensive-patterns.md docs: add junction-safe unlink rule to defensive patterns 2026-08-13 15:16:12 +08:00
defensive-patterns.zh.md docs(i18n): localize Chinese internal links 2026-08-18 19:00:37 +08:00
development.i18n.yaml rename code-mode to ptc (PTC mode), except session-persistent vocabulary 2026-08-27 23:14:31 +08:00
development.md rename code-mode to ptc (PTC mode), except session-persistent vocabulary 2026-08-27 23:14:31 +08:00
development.zh.md rename code-mode to ptc (PTC mode), except session-persistent vocabulary 2026-08-27 23:14:31 +08:00
event-producer-consumer.i18n.yaml refactor(session-persistence)!: handle-based seam with a lifecycle-owned write path 2026-09-01 23:19:02 +08:00
event-producer-consumer.md refactor(session-persistence)!: handle-based seam with a lifecycle-owned write path 2026-09-01 23:19:02 +08:00
event-producer-consumer.zh.md refactor(session-persistence)!: handle-based seam with a lifecycle-owned write path 2026-09-01 23:19:02 +08:00
glossary.i18n.yaml docs: rebuild the documentation skill and standards (#2983) 2026-08-25 23:47:20 +08:00
glossary.md docs: rebuild the documentation skill and standards (#2983) 2026-08-25 23:47:20 +08:00
glossary.zh.md docs: rebuild the documentation skill and standards (#2983) 2026-08-25 23:47:20 +08:00
graph-atlas.i18n.yaml refactor(repo): retire top-level examples 2026-08-24 22:02:44 +08:00
graph-atlas.md refactor(repo): retire top-level examples 2026-08-24 22:02:44 +08:00
graph-atlas.zh.md refactor(repo): retire top-level examples 2026-08-24 22:02:44 +08:00
module-graph.i18n.yaml refactor(session-persistence)!: handle-based seam with a lifecycle-owned write path 2026-09-01 23:19:02 +08:00
module-graph.md refactor(session-persistence)!: handle-based seam with a lifecycle-owned write path 2026-09-01 23:19:02 +08:00
module-graph.zh.md refactor(session-persistence)!: handle-based seam with a lifecycle-owned write path 2026-09-01 23:19:02 +08:00
persistence-catalog.i18n.yaml refactor(session-persistence)!: handle-based seam with a lifecycle-owned write path 2026-09-01 23:19:02 +08:00
persistence-catalog.md refactor(session-persistence)!: handle-based seam with a lifecycle-owned write path 2026-09-01 23:19:02 +08:00
persistence-catalog.zh.md refactor(session-persistence)!: handle-based seam with a lifecycle-owned write path 2026-09-01 23:19:02 +08:00
rescope.i18n.yaml docs: rebuild the documentation skill and standards (#2983) 2026-08-25 23:47:20 +08:00
rescope.md docs: rebuild the documentation skill and standards (#2983) 2026-08-25 23:47:20 +08:00
rescope.zh.md docs: rebuild the documentation skill and standards (#2983) 2026-08-25 23:47:20 +08:00
testing.i18n.yaml docs(testing): state the concurrent execution model where tests are written 2026-08-29 15:31:12 +08:00
testing.md docs(testing): state the concurrent execution model where tests are written 2026-08-29 15:31:12 +08:00
testing.zh.md docs(testing): state the concurrent execution model where tests are written 2026-08-29 15:31:12 +08:00
tool-catalog.i18n.yaml Merge remote-tracking branch 'origin/master' into feat/3220-steer-service 2026-09-01 13:46:35 +08:00
tool-catalog.md Merge remote-tracking branch 'origin/master' into feat/3220-steer-service 2026-09-01 13:46:35 +08:00
tool-catalog.zh.md Merge remote-tracking branch 'origin/master' into feat/3220-steer-service 2026-09-01 13:46:35 +08:00
tool-execution-pipeline.i18n.yaml fix: align mode-value prose and stale persistent mentions with the split 2026-08-27 23:14:32 +08:00
tool-execution-pipeline.md rename code-mode to ptc (PTC mode), except session-persistent vocabulary 2026-08-27 23:14:31 +08:00
tool-execution-pipeline.zh.md fix: align mode-value prose and stale persistent mentions with the split 2026-08-27 23:14:32 +08:00
web-styling.i18n.yaml fix(web): per-element elevation tokens and review sync 2026-09-01 19:15:56 +08:00
web-styling.md fix(web): per-element elevation tokens and review sync 2026-09-01 19:15:56 +08:00
web-styling.zh.md fix(web): per-element elevation tokens and review sync 2026-09-01 19:15:56 +08:00