feat(web): add interactive feature reparenting and auto-rebase on parent completion

[arielshad]

Summary

Extends the feature dependency system (spec 041) with two capabilities:

1. Interactive canvas reparenting — drag-to-connect via React Flow handles to set/change a feature's parent dependency, with edge deletion to unparent. Includes optimistic UI, cycle detection, cross-repo validation, and lifecycle guards.
2. Auto-rebase of child branches — when a parent feature reaches post-implementation lifecycle (Implementation/Review/Maintain), all blocked child feature branches are automatically rebased onto the parent branch using the existing smart rebase + agent-powered conflict resolution infrastructure.

Spec: specs/084-feature-dependency-rebase/

Changes

Domain & Application Layer

• ReparentFeatureUseCase — new use case validating same-repo, cycle detection, and lifecycle guards (rejects Done/Archived). Adjusts child lifecycle to Blocked when reparented under a pre-implementation parent, and unblocks when parent is post-implementation.
• CheckAndUnblockFeaturesUseCase — extended to orchestrate auto-rebase of unblocked children onto the parent branch before agent spawn. Each child rebase is independent; failures are isolated and recorded in the activity timeline.
• IGitPrService.rebaseOnBranch(cwd, featureBranch, targetBranch) — new interface method for rebasing onto an arbitrary branch (parent feature branch), implemented in the git PR service.

Presentation Layer (Web)

• FeaturesCanvas — enables nodesConnectable={true}, implements onConnect for reparenting and onEdgesDelete for unparenting, with toast feedback for validation errors.
• useGraphState — new reparentFeature() mutation with optimistic update + beginMutation/endMutation guards.
• DependencyEdge — selectable, deletable edges with hover delete affordance and keyboard support.
• reparent-feature server action — calls ReparentFeatureUseCase via DI string token alias.

DI Container

• Registers ReparentFeatureUseCase class token + 'ReparentFeatureUseCase' string alias for web server action access.
• Injects rebase dependencies into CheckAndUnblockFeaturesUseCase.

Test Plan

• Unit tests for ReparentFeatureUseCase (19 tests): success, cycle detection, cross-repo rejection, lifecycle guards, unparent, lifecycle state adjustment
• Unit tests for GitPrService.rebaseOnBranch (13 tests)
• Unit tests for CheckAndUnblockFeaturesUseCase auto-rebase orchestration (16 tests)
• Integration tests for canvas reparenting via control center (24 tests)
• Integration tests for feature-parent.repository, sqlite-feature-repository.find-by-branch, and git-pr.service.rebase-sync
• Full unit suite green: 5402 tests / 383 files in 35.99s
• Full integration suite green: 581 tests / 50 files in 32.67s
• Lint, typecheck, format, and build all green locally
• Manually verified canvas rendering with real data in dev server (see Evidence)

Evidence

App screenshots (running dev server, port 3001)

Full canvas view — feature nodes (Merge Diff Viewer, Bug Fix Mode, Prototype Exploration, Telegram & WhatsApp, Policy-Driven Supply Chain) connected via dependency edges to the cli repo group node. Proves canvas reparenting infrastructure works in the actual app with real data (task-11):

Feature node with connection handle — close-up showing the source connection handle (blue + circle on the right edge) visible on hover. Proves FR-1 (drag-to-connect handles enabled) and task-13 (isConnectable={true} + handle visibility on hover):

Edge interaction layer — canvas view showing dependency edges between repo and feature nodes. Proves FR-4 edge deletion infrastructure rendered with selectable edges in real app context (task-12):

Main control center page — http://localhost:3001/ with FeaturesCanvas integrated. Proves the canvas with reparenting capabilities loads in the real app routing context (task-11):

Test runs

• Unit tests — 72 feature-specific tests across 4 files: ReparentFeatureUseCase (19), GitPrService.rebaseOnBranch (13), CheckAndUnblockFeaturesUseCase Auto-Rebase (16), Control Center Integration (24). Full suite: 383 files / 5402 tests passing in 40.85s. See evidence/unit-test-results.txt.
• Integration tests — 50 files / 581 tests passing in 20.12s including feature-parent.repository (14), sqlite-feature-repository.find-by-branch (6), and git-pr.service.rebase-sync (16). See evidence/integration-test-results.txt.

Related

• Builds on spec 041 (feature dependencies) — parentId, Blocked lifecycle, dependency edges
• Builds on spec 080 (smart rebase) — RebaseFeatureOnMainUseCase, stash, ConflictResolutionService

Built with Shep 🐑 Shep Bot

[github-actions]

Dev Release Published

Artifact	Version	Install
npm	1.177.0-pr538.aa9ace4	npm install -g @shepai/[email protected]

---

_{Published from commit 4f84518 | View CI}

[github-actions]

Dev Release Published

Artifact	Version	Install
npm	1.177.0-pr538.cd394e5	npm install -g @shepai/[email protected]

---

_{Published from commit 68a28ff | View CI}