Files
deepseek-harness/docs/experimental-persistence-catalog.md
T
Yichen Jiang fc43a2d507 feat(forge): add the pull request panel and worktree Sessions
The forge panel shows the pull requests a Session created or pushed in a
right-sidebar tab, with a Session header button and branch label, and lets
a new Session start in its own Git worktree from the New Session options
row. The forge bundle ships the panel with the forge registry, the GitHub
provider, the Session bindings, and an isolated worktree service.

The panel listens to the agent-controller/admission stage. It holds the
first message of a Session with a worktree request while it creates and
enters the worktree as Agent maintenance, and refuses messages while the
worktree the Session works in is gone. A failed or stopped creation
returns the message to the composer: the card above the composer shows the
failure, sending again retries with a new branch name, and Continue
without a worktree withdraws the request. A removed worktree can be
checked out again or left for the source checkout. A message that enters
without admission still gets its worktree at the first step proposal.
2026-10-20 11:49:51 +08:00

2.1 KiB

Experimental Plugin Record Catalog

English | 中文

These current-source PluginRecordMap declarations describe ignorable, log-only records owned by experimental packages. Payload annotations link to their owning source without expanding referenced types. Records stay outside the known-event set, persistence schema fingerprints, and compatibility history; format migrations retain them on a best-effort basis.

Run pnpm run gen-persistence-catalog to regenerate both persistence catalogs, their language pairs, and associated artifacts. pnpm run verify-persistence-catalog checks all generated files.

Shared Session event declarations and resolved schemas appear in the Session persistence event catalog.

Record Owner Purpose Payload and source
plugin:client-ui-forge/worktree @deepseek-ai/dsh-experimental-client-ui-forge A request, withdrawal, or creation of the worktree a Session starts in. WorktreeRecord · packages/experimental/client-ui-forge/src/types.ts
plugin:forge-session/binding @deepseek-ai/dsh-experimental-forge-session A caller or discovery action that binds, restores, or hides one change request. BindingRecord · packages/experimental/forge-session/src/types.ts
plugin:translator/request @deepseek-ai/dsh-experimental-translator Provider-independent translation input, retained before dispatch. TranslationRequestRecord · packages/experimental/translator/src/types.ts
plugin:translator/result @deepseek-ai/dsh-experimental-translator Successful translation, retained before it is returned to the consumer. TranslationResultRecord · packages/experimental/translator/src/types.ts