kandev/docs/plans/bitbucket-plugin/task-12d-host-native-task-link-parity.md

id, title, status, wave, depends_on, plan, spec, decision

id	title	status	wave	depends_on	plan	spec	decision
12d-host-native-task-link-parity	Use the host-native task change-request link dialog	completed	3d	12c-exact-code-host-ui-parity	plan.md	../../specs/integrations/requirements/bitbucket-plugin.md	../../decisions/2026-08-06-plugin-code-host-dashboard-parity.md

Task 12d: Use the host-native task change-request link dialog

Confirmed root cause

TaskActionRegistration.run() supplied verified task context but no native linking surface. The Bitbucket plugin therefore used host.openModal() and hand-built a form whose width, description placement, footer, validation, success handling, mobile presentation, and icon differed from TaskGitHubPRDialog. Existing tests asserted only action invocation and modal presence. The real plugin also registered “Link Bitbucket Pull Request” even though the fixture and built-in submenu items name only their target.

Implementation

1. Extract GitHub's one-input link form into a provider-neutral host component with native inline errors, Cancel/Save footer, submitting state, toast, and close behavior.
2. Add an additive host.openTaskLinkDialog() contract that mounts that exact component in host-owned dialog geometry; refactor GitHub to consume the shared form first.
3. Propagate registered plugin icon names into both task-card and task-switcher Link menus instead of substituting a generic link glyph.
4. Register Bitbucket as Bitbucket Pull Request, submit its parsed reference through the authenticated pullrequests.link action, and remove its copied link form.
5. Update the in-tree fixture and desktop/mobile E2E to prove native anatomy, validation, action invocation, close-on-success, toast, icon, and menu copy.

Mobile contract

• Entry remains the visible task actions menu and its existing Link submenu.
• Nearest exemplar is TaskGitHubPRDialog; Bitbucket uses the same dialog instead of a plugin-only bottom drawer so behavior and focus return remain identical.
• One dialog owns scrolling; input and footer actions remain touch reachable without document horizontal overflow.

Validation

cd apps && pnpm --filter @kandev/web exec vitest run \
  components/integrations/task-change-request-link-form.test.tsx \
  components/task/task-github-pr-dialog.test.tsx \
  components/plugins/plugin-modal-host.test.tsx \
  components/kanban-card-menu-items.test.tsx \
  lib/plugins/host-api.test.ts
cd ../kdlbs-kandev-plugin-bitbucket && npm test
cd ../kandev-2/apps/web && pnpm e2e:run e2e/tests/plugins/bitbucket-plugin-contract.spec.ts

Acceptance

• Both Link menus show a Bitbucket brand icon and Bitbucket Pull Request.
• GitHub and Bitbucket render the same form anatomy and interaction states.
• Invalid input stays open with inline error; success links once, closes, and toasts.
• Desktop and mobile E2E complete the same user outcome with no overflow.
• Full current-worktree review records any unrelated blockers before merge readiness.