Rendered from docs/process/obligations/0210-no-fixture-holds-the-symlink-case-of-new-worktree-sh-and-a-bare-name-of-two-dots-leaves-a-branch-behind.md in the Headwater corpus. Every document on this half of the site is typed by the taxonomy the descriptor names: corpus.json.

Project process. These notes record how Headwater itself is built and run. You do not need them to use Headwater. Back to the specification

No fixture holds the symlink case of new-worktree.sh, and a bare name of two dots leaves a branch behind

Context

The verifier of PR #1061 (#848) in run 20260924-0411 found two gaps in contributor tooling. The product owner ruled both Record.

Obligation

The symlink case has no fixture. The script resolves the main checkout with pwd -P. If that call drops to a plain pwd, the suite stays green.

A name of two dots leaves a branch. --name .. passes the bare-name check. Git then fails to add the worktree, and the branch the call created stays behind.

Discharge

The first gap discharges when a fixture runs the script through a symlinked path and fails with plain pwd. The second discharges when --name .. is refused before any branch exists, and a case holds that.