Files
deepseek-harness/docs/upgrade-guide/v0.2.1-rc.3/generated-worktree-names/guide.md
T

1.6 KiB

kind, description
kind description
upgrade-guide Generated worktree names replace the worktree- prefix and full UUID suffix with dsh- and Session-derived names.

Update consumers of generated worktree names

English | 中文

Change

In v0.2.1-rc.3, omitting name from create_worktree or ctx.worktrees.create generates worktree-<UUID> by default. The next release generates dsh-<first eight UUID digits from the Session id>-<four random hexadecimal digits>, such as dsh-6b1f02c4-9a3e. A Session id without a UUID gets dsh-<eight random hexadecimal digits>.

Scripts and ignore rules that require the worktree- prefix or a full UUID suffix need updating. Explicit names, the configured checkout pool, and existing checkout directories and branches are unchanged. The namePrefix setting remains available, but it controls only the prefix, not the suffix format.

Migration

  1. Update scripts and ignore rules that recognize generated names. Prefer the returned path and branch fields over reconstructing them from the old pattern; the worktree service reference describes these fields.
  2. To retain the old prefix, set config.namePrefix to worktree- in the existing @deepseek-ai/dsh-experimental-worktree configuration row. This does not restore the full UUID suffix. Supply an explicit name when an integration requires a particular complete name.
  3. Create a worktree with name omitted, inspect its returned branch and path, and confirm that the updated automation recognizes it. Existing worktrees require no renaming or data migration.