Enum IssueRef 

pub enum IssueRef {
    GitHub {
        owner: String,
        repo: String,
        number: u64,
    },
    Linear {
        owner: String,
        repo: String,
        id: String,
    },
    AzureDevOps {
        org: String,
        project: String,
        repo: String,
        id: u64,
    },
    Local {
        project_path: PathBuf,
        display_number: u32,
    },
}

A reference to an issue that identifies a workspace.

Variants

GitHub

A GitHub issue identified by owner, repo, and number.

Fields

owner: String

GitHub organization or user name.

repo: String

Repository name.

number: u64

Issue number.

Linear

A Linear issue identified by its UUID, paired with the GitHub repo that hosts the code for that project.

Fields

owner: String

GitHub organization or user name that hosts the code.

repo: String

Repository name.

id: String

Linear issue UUID.

AzureDevOps

An Azure DevOps work item paired with an Azure Repos git repository.

Fields

org: String

Azure DevOps organization name.

project: String

Azure DevOps project name.

repo: String

Azure Repos git repository name.

id: u64

Work item ID.

Local

A local Centy issue — the repository itself is the source, no remote clone needed.

Fields

project_path: PathBuf

Absolute path to the local project repository.

display_number: u32

Human-readable issue number shown in the branch name.

Implementations

impl IssueRef

pub fn workspace_dir_name(&self) -> String

Directory name used inside the bare clone for this worktree.

pub fn branch_name(&self) -> String

Git branch name for this issue worktree.

pub fn clone_url(&self) -> String

HTTPS clone URL for the repository.

Panics

Always panics for IssueRef::Local — local repos are never cloned.

impl IssueRef

pub fn parse(s: &str) -> Result<Self>

Parse any of the supported input formats:

• https://github.com/owner/repo/issues/42
• worktree://open?owner=X&repo=Y&issue=42
• worktree://open?url=<encoded-github-url>
• worktree://open?owner=X&repo=Y&linear_id=<uuid>
• owner/repo#42
• owner/repo@<linear-uuid>

Errors

Returns an error if s does not match any supported format or if the extracted values (e.g. issue number) are invalid.

pub fn parse_with_options(s: &str) -> Result<(Self, DeepLinkOptions)>

Like [parse] but also returns any DeepLinkOptions embedded in a worktree:// URL (e.g. the editor query param).

Errors

Returns an error if s cannot be parsed as a valid issue reference.

impl IssueRef

pub fn temp_path(&self) -> PathBuf

Path to the worktree checkout.

For Local: ~/worktrees/local/{project_name}/issue-{display_number} For others: ~/worktrees/github/{owner}/{repo}/issue-N

pub fn bare_clone_path(&self) -> PathBuf

Path to the bare clone (or the local repo itself for Local).

Panics

Panics if the home directory cannot be determined.

Trait Implementations

impl Clone for IssueRef

fn clone(&self) -> IssueRef

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for IssueRef

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for IssueRef

fn eq(&self, other: &IssueRef) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for IssueRef

impl StructuralPartialEq for IssueRef