Skip to content

Track worktree path/root resolution fixes across bd commands #3124

@osamu2001

Description

@osamu2001

Summary

Track the small, reviewable fixes that make Beads behave consistently when commands are run from git worktrees.

The goal is to ensure that worktree execution resolves the shared Beads state from the main repository when appropriate, instead of assuming a local ./.beads or worktree-local repo root.

Background

A number of commands still have command-specific assumptions about:

  • local ./.beads
  • worktree root vs main repo root
  • hooks/config/doctor checks using relative paths that only work in non-worktree repos

These PRs intentionally split the work into focused units so each behavior can be reviewed independently without bundling unrelated cleanup.

PRs in this tracking set

Expected outcome

After these land, worktree usage should be more consistent across:

  • bd init --force
  • bd reset
  • bd bootstrap
  • bd hooks install
  • bd config validate
  • bd preflight
  • bd doctor
  • bd rename-prefix

Scope boundary

This issue is only for the targeted worktree path/root resolution fixes above.

It does not bundle larger design changes or unrelated cleanup. The split is intentional to keep review complexity low while preserving a shared review context.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions