Orchestrata Ultimate / RTM / 064-git-worktree-tools

RTM: 064-git-worktree-tools

Requirement to symbol to test rows for 064-git-worktree-tools: Git Worktree Tools.

At a glance

Item Value
Requirement IDs 54
Traced from src/ 50 (92.6%)
Untraced 4
Cited from tests/ 0 (0.0%)
Traced in src/ but not cited from tests/ 50

Reading this matrix

This matrix lists each of the 54 requirement IDs of spec 064-git-worktree-tools with the src/ symbols that cite it and the tests that cite it. 50 of them (92.6%) have at least one citing symbol and 4 have none.

0 requirements are also cited from tests/, and 50 are traced in code but never named by a test. A test citation is a @traces on a test function; it shows intent to cover, not that the test runs or reaches the symbol.

Rows showing none in the symbols column are the gaps to close first. The densest untraced groups are REQ-064-* (4).

Requirement to symbols to tests

Requirement Symbols in src/ Tests citing it
REQ-064-001 (FR-001) Tool must accept worktree path as required parameter orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403 none
REQ-064-002 (FR-002) Tool must validate path exists on filesystem orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403
orchestrata_ultimate/tools/worktree_tools _enter_existing L597
none
REQ-064-003 (FR-003) Tool must verify path is a registered git worktree orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403
orchestrata_ultimate/tools/worktree_tools _enter_existing L597
none
REQ-064-004 (FR-004) Tool must update session working directory context (in-tool session_id... orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403
orchestrata_ultimate/tools/worktree_tools _get_state L161
none
REQ-064-005 (FR-005) Tool must return worktree metadata on success orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403
orchestrata_ultimate/tools/worktree_tools WorktreeInfo L108
none
REQ-064-006 (FR-006) Tool must support both absolute and relative paths orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403 none
REQ-064-007 (FR-007) Tool must accept optional branch parameter for creation orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403 none
REQ-064-008 (FR-008) Tool must accept create flag to enable worktree creation orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403 none
REQ-064-009 (FR-009) Tool must support create_branch flag for branch creation orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403 none
REQ-064-010 (FR-010) Tool must support start_point for new branch creation orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403 none
REQ-064-011 (FR-011) Relative paths must be resolved relative to the anchor directory orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403 none
REQ-064-012 (FR-012) Path resolution must handle .. and . components orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403 none
REQ-064-013 (FR-013) Resolved paths must be normalized (no redundant separators) orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403 none
REQ-064-014 (FR-014) Tool must reject paths outside repository structure orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403
orchestrata_ultimate/tools/worktree_tools _check_bounds L359
orchestrata_ultimate/tools/worktree_tools _resolve_path L334
none
REQ-064-015 (FR-015) Tool must verify the path is a registered worktree of the parent repo (via... orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403
orchestrata_ultimate/tools/worktree_tools list_worktrees L253
none
REQ-064-016 (FR-016) Tool must verify worktree is listed in git worktree list orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403
orchestrata_ultimate/tools/worktree_tools _enter_existing L597
orchestrata_ultimate/tools/worktree_tools list_worktrees L253
none
REQ-064-017 (FR-017) Tool must handle both main worktree and auxiliary worktrees orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403
orchestrata_ultimate/tools/worktree_tools list_worktrees L253
none
REQ-064-018 (FR-018) Tool must detect and report locked worktrees orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403
orchestrata_ultimate/tools/worktree_tools _block_to_info L233
orchestrata_ultimate/tools/worktree_tools _enter_existing L597
none
REQ-064-019 (FR-019, 1st occurrence) Tool must store previous worktree info for potential restoration orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403 none
REQ-064-020 (FR-019, 2nd occurrence) Tool must update the tracked branch context orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403 none
REQ-064-021 (FR-020) Tool must update worktree path in session state orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403 none
REQ-064-022 (FR-021) Tool must preserve other session state during transition — **not... none none
REQ-064-023 (FR-022) Tool must determine parent repository path orchestrata_ultimate/tools/worktree_tools ExitWorktreeTool L766
orchestrata_ultimate/tools/worktree_tools _list_with_fallback L946
none
REQ-064-024 (FR-023) Tool must validate main worktree is accessible orchestrata_ultimate/tools/worktree_tools ExitWorktreeTool L766 none
REQ-064-025 (FR-024) Tool must update session CWD to main repository orchestrata_ultimate/tools/worktree_tools ExitWorktreeTool L766 none
REQ-064-026 (FR-025) Tool must clear worktree-specific context orchestrata_ultimate/tools/worktree_tools ExitWorktreeTool L766 none
REQ-064-027 (FR-026) Tool must be idempotent when already in main worktree orchestrata_ultimate/tools/worktree_tools ExitWorktreeTool L766 none
REQ-064-028 (FR-027) Tool must return main worktree metadata on success orchestrata_ultimate/tools/worktree_tools ExitWorktreeTool L766 none
REQ-064-029 (FR-028) Tool must check for uncommitted changes before exit orchestrata_ultimate/tools/worktree_tools ExitWorktreeTool L766 none
REQ-064-030 (FR-029) Tool must support stash uncommitted changes option orchestrata_ultimate/tools/worktree_tools ExitWorktreeTool L766 none
REQ-064-031 (FR-030) Tool must support force exit option orchestrata_ultimate/tools/worktree_tools ExitWorktreeTool L766 none
REQ-064-032 (FR-031) Tool must warn user of uncommitted changes (via the UNCOMMITTED_CHANGES... orchestrata_ultimate/tools/worktree_tools ExitWorktreeTool L766
orchestrata_ultimate/tools/worktree_tools _list_with_fallback L946
none
REQ-064-033 (FR-032) Tool must locate the parent repository (via git worktree list, not manual... orchestrata_ultimate/tools/worktree_tools ExitWorktreeTool L766 none
REQ-064-034 (FR-033) Tool must handle both gitdir and gitdir: <prefix> .git-file formats —... none none
REQ-064-035 (FR-034) Tool must work when called from a nested directory (git itself walks up from... orchestrata_ultimate/tools/worktree_tools ExitWorktreeTool L766 none
REQ-064-036 (FR-035) Tool must create worktree directory orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403
orchestrata_ultimate/tools/worktree_tools _create L639
none
REQ-064-037 (FR-036) Tool must execute git worktree add command orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403
orchestrata_ultimate/tools/worktree_tools _create L639
none
REQ-064-038 (FR-037) Tool must create branch if specified and doesn't exist orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403
orchestrata_ultimate/tools/worktree_tools _create L639
none
REQ-064-039 (FR-038) Tool must support specifying start point for new branch none none
REQ-064-040 (FR-039) Tool must handle branch from remote tracking — **not... none none
REQ-064-041 (FR-040) Tool must reject an existing populated target directory orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403
orchestrata_ultimate/tools/worktree_tools _create L639
none
REQ-064-042 (FR-041) Tool must reject duplicate worktree for existing branch orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403
orchestrata_ultimate/tools/worktree_tools _create L639
none
REQ-064-043 (FR-042) Tool must validate branch name format orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403
orchestrata_ultimate/tools/worktree_tools _create L639
orchestrata_ultimate/tools/worktree_tools _validate_branch_name L377
none
REQ-064-044 (FR-043) Tool must validate target path format orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403 none
REQ-064-045 (FR-044) Tool must execute git worktree list orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403
orchestrata_ultimate/tools/worktree_tools list_worktrees L253
none
REQ-064-046 (FR-045) Tool must parse output to extract worktree info orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403
orchestrata_ultimate/tools/worktree_tools _split_porcelain_blocks L203
orchestrata_ultimate/tools/worktree_tools list_worktrees L253
none
REQ-064-047 (FR-046) Tool must enrich with branch and HEAD information orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403
orchestrata_ultimate/tools/worktree_tools _block_to_info L233
orchestrata_ultimate/tools/worktree_tools list_worktrees L253
none
REQ-064-048 (FR-047) Tool must identify the main worktree orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403
orchestrata_ultimate/tools/worktree_tools list_worktrees L253
none
REQ-064-049 (FR-048) Tool must return a list with a single entry for a single-worktree repo orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403
orchestrata_ultimate/tools/worktree_tools list_worktrees L253
none
REQ-064-SEC-001 main/master/develop/HEAD are protected by default and cannot have worktrees... orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403
orchestrata_ultimate/tools/worktree_tools _create L639
orchestrata_ultimate/tools/worktree_tools _is_protected L390
none
REQ-064-SEC-002 Protected branches are configurable via the caller-supplied protected_branches parameter orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403
orchestrata_ultimate/tools/worktree_tools _create L639
orchestrata_ultimate/tools/worktree_tools _is_protected L390
none
REQ-064-SEC-003 Protected-branch matching supports glob patterns (*, ?, [abc]) via fnmatch orchestrata_ultimate/tools/worktree_tools EnterWorktreeTool L403
orchestrata_ultimate/tools/worktree_tools _create L639
orchestrata_ultimate/tools/worktree_tools _is_protected L390
none
REQ-064-EXT-001 exit_worktree supports remove=true to delete the exited worktree via `git worktree... orchestrata_ultimate/tools/worktree_tools ExitWorktreeTool L766 none
REQ-064-EXT-002 exit_worktree supports prune=true to garbage-collect abandoned/orphaned worktree... orchestrata_ultimate/tools/worktree_tools ExitWorktreeTool L766 none