feat(domain): add agentrun creation and spec initialization to adopted branches

[arielshad]

Summary

Adds AgentRun creation and spec directory initialization to AdoptBranchUseCase, enabling adopted features to participate in the full agent execution lifecycle (start, resume, reject iterations).

Fixes: Adopted branches can now be started, resumed after interruption, and process rejection feedback - previously these operations failed with "No agent run found" error.

Changes

Core Implementation

• AdoptBranchUseCase (packages/core/src/application/use-cases/features/adopt-branch.use-case.ts):
  • Inject IAgentRunRepository and ISpecInitializerService dependencies
  • Create AgentRun record before Feature creation with correct initialization (status=pending, agentType from settings, threadId generated)
  • Initialize spec directory conditionally (only if none exists) to preserve existing spec work
  • Link Feature and AgentRun via feature.agentRunId field
  • Set Feature.lifecycle to Review (if PR exists) or Maintain (if no PR)

Test Coverage

• Unit tests (tests/unit/use-cases/features/adopt-branch.use-case.test.ts):

  • 36 tests covering AgentRun creation, spec initialization, feature linking, and edge cases
  • Validates existing spec directory preservation
  • Tests settings integration for agent type and model ID
  • Confirms lifecycle determination based on PR status

• Integration tests (tests/integration/features/adopt-flow.integration.test.ts):

  • 7 tests validating end-to-end adopt → start → resume flow
  • Confirms AgentRun support enables full agent lifecycle for adopted features
  • Tests rejection feedback processing
  • Validates spec directory initialization and reuse

Evidence

The following evidence was captured to prove task completion:

• AdoptBranchUseCase unit tests — 36 tests passing, verifying AgentRun creation, spec directory initialization, and feature linking (task-1,task-2,task-3,task-4,task-5,task-6,task-7,task-8,task-9,task-10)
  See: specs/071-adopted-branch-agent-runs/evidence/adopt-branch-unit-tests.txt
• Adopt flow integration tests — 7 tests passing, validating adopt → start → resume flow with AgentRun support (task-11)
  See: specs/071-adopted-branch-agent-runs/evidence/adopt-integration-tests.txt
• Implementation summary showing all success criteria met: AgentRun creation, spec directory initialization, feature linking, and test coverage (task-12)
• Key implementation code snippets from AdoptBranchUseCase showing AgentRun creation logic, conditional spec initialization, and persistence order (task-1,task-2,task-3,task-4,task-5,task-6,task-7)

Testing

# Unit tests for AdoptBranchUseCase
pnpm test tests/unit/use-cases/features/adopt-branch.use-case.test.ts

# Integration tests for adopt flow
pnpm test tests/integration/features/adopt-flow.integration.test.ts

# All tests
pnpm test

Related

• Spec: specs/071-adopted-branch-agent-runs/spec.yaml
• Feature: Adopted Branch Agent Runs (feat(web): add AllAgentTypes story for FeatureNode agent type icons #71)
• Size: M (Medium - 1-2 days)

🤖 Generated with Claude Code

[github-actions]

Dev Release Published

Artifact	Version	Install
npm	1.130.0-pr417.355b6bd	npm install -g @shepai/cli@1.130.0-pr417.355b6bd

---

_{Published from commit 4a28b28 | View CI}