root/fusion
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(FN-4622): complete Step 7 — docs and changeset

Browse Source 
Fusion-Task-Id: FN-4622
Fusion-Task-Lineage: 10ab809f-32ef-4a1e-921e-4f8ae4161323
This commit is contained in:
Fusion (runfusion.ai)
2026-05-15 18:51:06 -07:00
committed by gsxdsm
parent dfc291f8c0
commit 9ac503fc0f
2 changed files with 6 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
.changeset/fn-4622-worktree-backend.md Normal file
View File

@@ -0,0 +1,5 @@
---
"@runfusion/fusion": minor
---
Add a settings-driven WorktreeBackend abstraction with native git as default and opt-in worktrunk create fallback behavior.

2
docs/architecture.md
View File

@@ -645,7 +645,7 @@ Guardrails: this routine does **not** retry merges, does **not** apply to mixed/
### Worktree and naming helpers ### Worktree and naming helpers
- `WorktreePool` (`worktree-pool.ts`) — idle worktree reuse - `WorktreePool` (`worktree-pool.ts`) — idle worktree reuse
- `WorktreeBackend` (`worktree-backend.ts`) — abstraction for worktree operations used by `acquireTaskWorktree`. `native` (default) preserves existing `git worktree add` behavior (including sibling-branch retry semantics). `resolveWorktreeBackend(settings)` selects `worktrunk` when `settings.worktrunk?.enabled === true`; `worktrunk.onFailure` controls fail-hard vs fallback-native create behavior. The current `worktrunk` backend is a scaffold (placeholder `--help` shell-out and typed failure mapping); real CLI subcommand mapping lands in FN-4623. - `WorktreeBackend` (`worktree-backend.ts`) — abstraction for worktree operations used by `acquireTaskWorktree`. `native` (default) preserves existing `git worktree` behavior (including sibling-branch retry semantics), while `resolveWorktreeBackend(settings)` selects `worktrunk` when `settings.worktrunk?.enabled === true`. `worktrunk.onFailure` controls fail-hard vs fallback-native create behavior and emits `worktree:worktrunk-*` run-audit events for create/fallback paths.
- `WorktreeNames` (`worktree-names.ts`) — deterministic worktree/branch naming - `WorktreeNames` (`worktree-names.ts`) — deterministic worktree/branch naming
### Observability and reflection ### Observability and reflection