dsh-session-git

English | 中文

dsh-session-git is a plugin for
DeepSeek Harness. It
treats a conversation as lineage: fork from a completed turn, open the
child, and draw the family tree in the session header. The source session
is left unchanged. The plugin does not rewind workspace files and does not
merge logs.

Compatible with DeepSeek Harness 0.1.0-rc.5 fork semantics (locked in
src/policy/host-boundary.ts). Smoked on CLI 0.1.0-rc.6. After a
harness upgrade, run pnpm test; if host-boundary fails, stop shipping.

Problem

The official API already supports fork({ sessionId, atSeq }). The Web UI
only exposes that cut on the current transcript tail and as “latest
turn” in the sidebar. There is no way to branch from an earlier completed
turn, and the official sidebar stays flat on purpose.

Need a disk time machine? Install a rewind plugin. Do not ask this package
to undo an edit.

Solution

The plugin adds product UI on top of the official fork RPC:

• pick a completed turn in the header, then fork at that exact turn/end
  seq;
• on earlier turns (when the turnTail chain is free), offer “Branch from
  here”;
• show a read-only parent chip and a family-tree popover;
• never archive, cancel, or prompt the source.

flowchart LR
    A[Completed turn N] --> B[executeFork]
    B --> C["session.fork atSeq = turn/end"]
    C --> D[Rename child title best-effort]
    D --> E[open child]
    E --> F[Family tree from sidebar parentId]

Features

• Header Branch from turn: lists completed turn/end seqs in the
  loaded window. The trigger itself does not fork.
• Historical turnTail button on earlier completed turns. The latest
  turn keeps the official Branch control. The plugin registers at
  priority: 50 so official produced-files keep the chain when they match.
• Family tree in the same popover: missing (archived) parents become
  placeholders; origin: subagent is not treated as a Git branch.
• Parent chip opens the parent session.
• Overlapping forks of the same source are refused (error.in-flight).
• Failures always have a messageKey. Product copy never says rewind /
  undo.

Requirements

• Node.js ^22.19.0 || >=24
• A DeepSeek Harness web profile. The browser half uses conversation
  slots and is not intended for headless profiles.

Installation

The supported install is a prebuilt GitHub Release tarball. It already
contains lib/. dsh plugin add forwards to pnpm, so no local clone,
no allowBuilds, and no npm registry package.

dsh plugin --profile web add https://github.com/JUANWANG-BUAA/dsh-session-git/releases/latest/download/dsh-session-git.tgz
dsh --profile web --dump-config | grep session-git

You should see a # == dsh-session-git layer. Start Web without a debug
DSH_HOME:

env -u DSH_HOME dsh --profile web

Pin a released version:

dsh plugin --profile web add https://github.com/JUANWANG-BUAA/dsh-session-git/releases/download/v0.1.0/dsh-session-git-0.1.0.tgz

From this repository

pnpm install
pnpm run build
dsh plugin --profile web add "$(pwd)"

Git (builds on install)

Pin a commit you have verified. pnpm ≥ 10 refuses build scripts until you
allow this package in that profile
($DSH_HOME/profiles/web/pnpm-workspace.yaml):

dsh plugin --profile web add github:JUANWANG-BUAA/dsh-session-git#<commit-sha>

allowBuilds:
  dsh-session-git: true

Treat allowBuilds as permission to run this package’s scripts on your
machine. Only allow sources you trust. Prefer the Release tarball above.

Local tarball

pnpm pack
dsh plugin --profile web add ./dsh-session-git-0.1.0.tgz

The tarball already contains lib/client.js. prepare skips the rebuild
when tsdown.config.ts is absent.

Usage

1. Open a conversation with at least one completed turn.
2. Use Branch from turn in the header and pick a cut. Or, on an
   earlier turn with no produced-files row, use Branch from here.
3. The child opens with history up to that turn (including standalone
   events after the cut until the next turn/start, such as a title
   change). The source is unchanged.
4. On the child, Parent and the family tree navigate back to the
   source.

Source
  Turn 1  — header picker / historical turnTail
  Turn 2  — header picker / historical turnTail
  Turn 3 (latest) — official Branch only

Uninstall

dsh plugin --profile web remove dsh-session-git
dsh --profile web --dump-config | grep session-git

The UI disappears. Forked children remain ordinary sessions;
parentSession stays in the log. Official Branch is unchanged.

Configuration

- id: session-git
  name: dsh-session-git
  config:
    turnTail: true           # false: hide historical turnTail; header picker stays
    prefillComposer: false   # accepted then ignored; the child is never prefilled

The complete option list, with defaults and validation, is the package
Config schema (src/index.ts).

Web boot currently creates client entries as loader.create({ name })
without forwarding host yaml, so the browser half keeps turnTail on
unless a future boot starts passing config. Unit tests cover the off path.

Limitations

• The family tree is projected from sidebar SessionSummary (parentId,
  title, running, blank, updatedAt). seedLength is not in the summary,
  so v0.1 does not show “cut at seq N”.
• Archived or out-of-workspace parents render as placeholders.
• The tree lives in this plugin’s popover. The official sidebar stays flat.
• When a turn has produced files, official deliverables occupy the
  turnTail chain; use the header picker for that cut.
• Child titles follow the official (1) / （n） increment. Two forks
  from the same source can share a title. The tree does not label the cut.
• session.fork copies the current workspace, not files as of that
  turn. This plugin does not rewind files.
• The blank hero has no conversation header, so the picker is absent there
  as well.
• Branch event diff and family-tree export are deferred to 0.2.0.

Development

git clone git@github.com:JUANWANG-BUAA/dsh-session-git.git
cd dsh-session-git
pnpm install
pnpm run check:ci

check:ci runs lint, typecheck against types/ci.d.ts, unit and client
tests, and a build. Optional pnpm run bootstrap clones or builds a
sibling DeepSeek Harness checkout so pnpm run check uses the real
client .d.ts files.

pnpm test is policy tests (node:test) plus jsdom component tests
(vitest). 0.1 has no diff helpers.

Git installs run prepare. Packed tarballs skip the rebuild when
tsdown.config.ts is omitted from files. Cutting a GitHub Release is
documented in CONTRIBUTING.md; this package is not
published to npm.

Contributing · Security · License

• CONTRIBUTING.md
• SECURITY.md
• MIT © 2026 JUANWANG-BUAA