gsxdsm 4fee2c1324 FN-5671: add branch-strategy selection to new task creation ...

Add branch-strategy based task branch handling from modal through task creation routes.

- add branch strategy dropdown + validation in New Task modal and TaskForm, including required branch-name handling for existing/custom-new modes
- send structured branchSelection payload from dashboard API client and cover UI/API behavior with new tests
- add server-side branch selection mode parsing, auto-new branch derivation (fusion/<task-id>-<slug>), and response updates when auto branch is generated
- update engine/worktree and dashboard route tests plus dashboard guide documentation
- add a changeset for @runfusion/fusion patch release

Files changed:
 .changeset/fn-5671-branch-strategy-dropdown.md     |  7 ++
 docs/dashboard-guide.md                            | 16 +++++
 packages/dashboard/app/__tests__/api-tasks.test.ts | 21 ++++++
 packages/dashboard/app/api/legacy.ts               |  9 +++
 packages/dashboard/app/components/NewTaskModal.css |  8 +++
 packages/dashboard/app/components/NewTaskModal.tsx | 41 +++++++++---
 packages/dashboard/app/components/TaskForm.tsx     | 30 ++++++++-
 .../app/components/__tests__/NewTaskModal.test.tsx | 77 +++++++++++++++++++---
 .../src/__tests__/branch-selection.test.ts         | 13 ++++
 .../dashboard/src/__tests__/routes-tasks.test.ts   | 72 ++++++++++++++++++++
 packages/dashboard/src/routes/branch-selection.ts  | 45 ++++++++-----
 .../src/routes/register-task-workflow-routes.ts    | 22 +++++--
 .../engine/src/__tests__/worktree-pool.test.ts     | 41 ++++++++++++
 packages/engine/src/worktree-pool.ts               |  2 +-
 14 files changed, 361 insertions(+), 43 deletions(-)

Fusion-Task-Id: FN-5671
Fusion-Task-Lineage: 7f2e7b68-050d-4a2c-af0b-cb895de35576

2026-05-29 09:44:17 -07:00

..

activity-feed-theme-styling.test.ts

refactor(dashboard): split monolithic styles.css into per-component files

2026-04-24 19:39:20 -07:00

activity-log-mobile-layout.test.ts

fix(engine-tests): eliminate temp-dir leak and raise subprocess guard for concurrent workspace runs

2026-05-22 20:20:42 -07:00

agent-css-classes.test.ts

test(dashboard): convert remaining skipped tests to passing stubs

2026-05-19 20:29:59 -07:00

agent-runs-ui.test.ts

Agent run fixes

2026-05-09 17:05:43 -07:00

api-auth.test.ts

feat(FN-3281): ship review revisions and dashboard/plugin integration updates

2026-05-08 17:17:59 -07:00

api-git.test.ts

feat(FN-5585): add planning branch controls to planning mode modal

2026-05-25 16:32:57 -07:00

api-missions.test.ts

feat(FN-4640): complete Step 6 — dashboard sandbox audit surface

2026-05-15 16:19:42 -07:00

api-node.test.ts

feat(FN-4029): expose database health in API and store contracts

2026-05-12 07:47:10 -07:00

api-projects.test.ts

feat(FN-3504): add path mapping API with core contracts, routes, client hel

2026-05-07 18:47:08 -07:00

api-settings.test.ts

feat(FN-3166): remove dashboard roadmap backend and add reports plugin scaf

2026-05-09 10:31:04 -07:00

api-skills.test.ts

chore: consolidate test files into __tests__/ dirs and clean stray engine artifacts

2026-04-24 19:39:20 -07:00

api-tasks.test.ts

FN-5671: add branch-strategy selection to new task creation

2026-05-29 09:44:17 -07:00

App.boot-gate.test.tsx

feat(FN-4779): merge fusion/fn-4779

2026-05-16 12:49:57 -07:00

App.shell-onboarding.test.tsx

feat(FN-3403): add shell multi-profile support with connection manager onbo

2026-05-07 18:35:45 -07:00

auth.test.ts

feat(FN-3406): add shell context hook plumbing for dashboard

2026-05-07 23:21:05 -07:00

board-mobile-corner-rendering.test.ts

fix(engine-tests): eliminate temp-dir leak and raise subprocess guard for concurrent workspace runs

2026-05-22 20:20:42 -07:00

board-tablet-overflow.test.ts

feat(FN-5569): merge fusion/fn-5569

2026-05-23 20:24:18 -07:00

browser-layout-smoke-fixture.test.ts

feat(FN-4999): fix completion handoff limbo and run context isolation

2026-05-18 05:35:14 -07:00

build-output-setup.ts

test(FN-2343): harden build-output contract coverage

2026-04-23 13:29:23 -07:00

build-output.test.ts

test(FN-4916): complete Step 3 — add theme link regression coverage

2026-05-17 10:37:54 -07:00

chat-tool-calls-mobile-layout.test.ts

fix(engine-tests): eliminate temp-dir leak and raise subprocess guard for concurrent workspace runs

2026-05-22 20:20:42 -07:00

column-fixed-width.test.ts

feat(FN-5569): merge fusion/fn-5569

2026-05-23 20:24:18 -07:00

component-css-no-raw-rgba.test.ts

feat(FN-5126): replace hardcoded rgba shadow with design token in DesktopLa

2026-05-20 14:28:45 -07:00

dashboard-component-color-tokenization.test.ts

feat(FN-4016): convert hardcoded rgba colors to CSS token variables across

2026-05-11 10:54:26 -07:00

dashboard-footer-mobile-layout.test.ts

fix(engine-tests): eliminate temp-dir leak and raise subprocess guard for concurrent workspace runs

2026-05-22 20:20:42 -07:00

detail-body-mobile-overflow.test.ts

fix(engine-tests): eliminate temp-dir leak and raise subprocess guard for concurrent workspace runs

2026-05-22 20:20:42 -07:00

dev-server-layout-css.test.ts

refactor(dashboard): split monolithic styles.css into per-component files

2026-04-24 19:39:20 -07:00

executor-status-bar-theme.test.ts

fix(engine-tests): eliminate temp-dir leak and raise subprocess guard for concurrent workspace runs

2026-05-22 20:20:42 -07:00

footer-safe-layout.test.ts

fix(engine-tests): eliminate temp-dir leak and raise subprocess guard for concurrent workspace runs

2026-05-22 20:20:42 -07:00

git-manager-theme-styling.test.ts

refactor(dashboard): split monolithic styles.css into per-component files

2026-04-24 19:39:20 -07:00

index-html-theme-link.test.ts

feat(FN-5488): merge fusion/fn-5488

2026-05-22 10:37:21 -07:00

insight-model-selector.test.tsx

feat(insights): add collapsible model selector to InsightsView with gear trigger

2026-05-07 14:09:39 -07:00

lazy-loaded-views-docs.test.ts

test(FN-5098): complete Step 6 — update lazy-view inventory docs

2026-05-19 01:59:22 -07:00

mission-planning-modals-mobile.test.ts

feat(FN-3976): restore shared mobile bottom spacing contract with regressio

2026-05-10 23:36:10 -07:00

mobile-bottom-bars-keyboard-layout.test.ts

FN-5673: keep mobile nav and footer pinned when keyboard opens

2026-05-29 09:32:22 -07:00

mobile-feature-access-regression.test.tsx

fix(engine-tests): eliminate temp-dir leak and raise subprocess guard for concurrent workspace runs

2026-05-22 20:20:42 -07:00

mobile-header-controls.test.ts

fix(engine-tests): eliminate temp-dir leak and raise subprocess guard for concurrent workspace runs

2026-05-22 20:20:42 -07:00

mobile-input-font-size.test.ts

feat(FN-5569): merge fusion/fn-5569

2026-05-23 20:24:18 -07:00

mobile-nav-bar-css.test.ts

fix(engine-tests): eliminate temp-dir leak and raise subprocess guard for concurrent workspace runs

2026-05-22 20:20:42 -07:00

mobile-planning-input-font-size.test.ts

feat(FN-5569): merge fusion/fn-5569

2026-05-23 20:24:18 -07:00

mobile-scripts.test.ts

feat(FN-1093): add mobile build, PWA, and live reload workflow

2026-04-07 23:25:34 -07:00

mobile-scroll-snap.test.ts

feat(FN-5569): merge fusion/fn-5569

2026-05-23 20:24:18 -07:00

no-legacy-public.test.ts

feat(KB-168): remove legacy public/ directory and server fallback

2026-03-28 16:30:23 -04:00

onboarding-overlay-layering.test.ts

fix(self-healing): use slim listTasks in maintenance recover loops

2026-04-24 22:25:57 -07:00

pwa.test.ts

feat(FN-5488): merge fusion/fn-5488

2026-05-22 10:37:21 -07:00

quick-chat-mobile-keyboard-layout.test.ts

fix(engine-tests): eliminate temp-dir leak and raise subprocess guard for concurrent workspace runs

2026-05-22 20:20:42 -07:00

quick-chat-session-dropdown.test.ts

feat(FN-4611): add themed quick chat session dropdown

2026-05-15 10:05:46 -07:00

quick-chat-tool-calls-mobile-layout.test.ts

fix(engine-tests): eliminate temp-dir leak and raise subprocess guard for concurrent workspace runs

2026-05-22 20:20:42 -07:00

quick-entry-expanded-height.test.tsx

feat(FN-3186): add priority control to quick-entry box

2026-05-02 02:54:26 -07:00

settings-mobile-wrap.test.ts

FN-5668: preserve word-boundary wrapping in mobile settings text

2026-05-29 08:20:28 -07:00

setup-wizard-modal-layout.test.ts

refactor(dashboard): split monolithic styles.css into per-component files

2026-04-24 19:39:20 -07:00

shell-host.test.ts

feat(FN-3407): normalize shell host bootstrap

2026-05-07 23:21:05 -07:00

shell-native.test.ts

feat(FN-3409): add shell regression matrix for mobile, desktop, and dashboa

2026-05-08 01:57:55 -07:00

ShellContext.test.tsx

feat(FN-3400): add native shell connection handoff, plugin management CLI/l

2026-05-06 05:29:56 -07:00

sse-bus.test.ts

feat(FN-4921): merge fusion/fn-4921

2026-05-17 19:11:59 -07:00

status-colors-theme.test.ts

feat(FN-4757): complete Step 3 — wire PrPanel and remove PrSection

2026-05-17 03:28:21 -07:00

swUpdate.test.ts

feat(FN-3730): add action-gate reload endpoint for reloadable exempt-tools

2026-05-08 07:38:50 -07:00

tablet-header-controls.test.tsx

feat(FN-4940): merge fusion/fn-4940

2026-05-17 15:11:48 -07:00

task-detail-modal-tablet-width.test.ts

Recovery: re-land tablet TaskDetailModal width onto main

2026-05-28 19:45:27 -07:00

terminal-input.test.ts

refactor(dashboard): split monolithic styles.css into per-component files

2026-04-24 19:39:20 -07:00

terminal-mobile-header-row.test.ts

fix(dashboard): keep mobile terminal header on a single row

2026-04-30 21:26:54 -07:00

terminal-mobile-keyboard-layout.test.ts

feat(FN-5569): merge fusion/fn-5569

2026-05-23 20:24:18 -07:00

text-token-canonicalization.test.ts

test(FN-4286): use css fixture in text token regression guard

2026-05-13 10:00:00 -07:00

versionCheck.test.ts

feat(FN-4921): merge fusion/fn-4921

2026-05-17 19:11:59 -07:00