github-issue-tower-defence-management 1.68.0 → 1.69.0

package/src/domain/usecases/StartPreparationUseCase.test.ts

@@ -153,6 +153,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
     expect(mockIssueRepository.updateStatus.mock.calls).toHaveLength(1);
     expect(mockIssueRepository.updateStatus.mock.calls[0][0]).toBe(mockProject);
@@ -217,6 +218,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
     expect(mockLocalCommandRunner.runCommand.mock.calls[0]).toEqual([
@@ -273,6 +275,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
     expect(mockLocalCommandRunner.runCommand.mock.calls[0]).toEqual([
@@ -320,6 +323,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(0);
     expect(mockIssueRepository.updateStatus.mock.calls).toHaveLength(0);
@@ -368,6 +372,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(0);
     expect(mockIssueRepository.updateStatus.mock.calls).toHaveLength(0);
@@ -415,6 +420,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(0);
     expect(mockIssueRepository.updateStatus.mock.calls).toHaveLength(0);
@@ -480,6 +486,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
     expect(mockIssueRepository.closePullRequest).toHaveBeenCalledWith(
       newerPR.url,
@@ -568,6 +575,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
     expect(mockIssueRepository.closePullRequest).toHaveBeenCalledWith(
       newerPR.url,
@@ -630,6 +638,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(0);
     expect(mockIssueRepository.updateStatus.mock.calls).toHaveLength(0);
@@ -673,6 +682,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
     // Both awaiting issues should be updated (forward iteration: url1 first, then url2)
     expect(mockIssueRepository.updateStatus.mock.calls).toHaveLength(2);
@@ -729,6 +739,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
     // Loop doesn't run because we're already at max (6 >= 6)
     expect(mockIssueRepository.updateStatus.mock.calls).toHaveLength(0);
@@ -763,6 +774,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
     expect(mockLocalCommandRunner.runCommand.mock.calls[0]).toEqual([
@@ -807,6 +819,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
     expect(mockLocalCommandRunner.runCommand.mock.calls[0]).toEqual([
@@ -851,6 +864,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
     expect(mockLocalCommandRunner.runCommand.mock.calls[0]).toEqual([
@@ -895,6 +909,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
     expect(mockLocalCommandRunner.runCommand.mock.calls[0]).toEqual([
@@ -939,6 +954,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
     expect(mockLocalCommandRunner.runCommand.mock.calls[0]).toEqual([
@@ -983,6 +999,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
     expect(mockLocalCommandRunner.runCommand.mock.calls[0]).toEqual([
@@ -1030,6 +1047,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
     expect(consoleErrorSpy).toHaveBeenCalledWith(
       'No LLM model configured for issue url1. Provide --defaultLlmModelName or add an llm-model: label.',
@@ -1077,6 +1095,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
     expect(consoleErrorSpy).toHaveBeenCalledWith(
       'No LLM model configured for issue url1. Provide --defaultLlmModelName or add an llm-model: label.',
@@ -1126,6 +1145,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
     // No issues are in 'Awaiting Workspace' status, so no updates should happen
     expect(mockIssueRepository.updateStatus.mock.calls).toHaveLength(0);
@@ -1160,6 +1180,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
     expect(mockIssueRepository.updateStatus.mock.calls).toHaveLength(3);
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(3);
@@ -1193,6 +1214,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
     expect(mockIssueRepository.updateStatus.mock.calls).toHaveLength(6);
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(6);
@@ -1249,6 +1271,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(12);
@@ -1314,6 +1337,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(12);
@@ -1377,6 +1401,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockIssueRepository.updateStatus.mock.calls).toHaveLength(2);
@@ -1424,6 +1449,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockIssueRepository.updateStatus.mock.calls).toHaveLength(1);
@@ -1478,6 +1504,7 @@ describe('StartPreparationUseCase', () => {
         allowedIssueAuthors: null,
         codexHomeCandidates: null,
         allowIssueCacheMinutes: 0,
+        labelsAsLlmAgentName: null,
       });
 
       expect(mockIssueRepository.updateStatus.mock.calls).toHaveLength(1);
@@ -1535,6 +1562,7 @@ describe('StartPreparationUseCase', () => {
         allowedIssueAuthors: null,
         codexHomeCandidates: null,
         allowIssueCacheMinutes: 0,
+        labelsAsLlmAgentName: null,
       });
 
       expect(mockIssueRepository.updateStatus.mock.calls).toHaveLength(1);
@@ -1582,6 +1610,7 @@ describe('StartPreparationUseCase', () => {
         allowedIssueAuthors: null,
         codexHomeCandidates: null,
         allowIssueCacheMinutes: 0,
+        labelsAsLlmAgentName: null,
       });
 
       expect(mockIssueRepository.updateStatus.mock.calls).toHaveLength(1);
@@ -1629,6 +1658,7 @@ describe('StartPreparationUseCase', () => {
         allowedIssueAuthors: null,
         codexHomeCandidates: null,
         allowIssueCacheMinutes: 0,
+        labelsAsLlmAgentName: null,
       });
 
       expect(mockIssueRepository.updateStatus.mock.calls).toHaveLength(1);
@@ -1676,6 +1706,7 @@ describe('StartPreparationUseCase', () => {
         allowedIssueAuthors: null,
         codexHomeCandidates: null,
         allowIssueCacheMinutes: 0,
+        labelsAsLlmAgentName: null,
       });
 
       expect(mockIssueRepository.updateStatus.mock.calls).toHaveLength(1);
@@ -1729,6 +1760,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: ['user1', 'user2'],
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockIssueRepository.updateStatus.mock.calls).toHaveLength(1);
@@ -1776,6 +1808,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockIssueRepository.updateStatus.mock.calls).toHaveLength(2);
@@ -1821,6 +1854,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: ['user1', 'user2'],
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockIssueRepository.updateStatus.mock.calls).toHaveLength(1);
@@ -1860,6 +1894,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: ['user1'],
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockIssueRepository.updateStatus.mock.calls).toHaveLength(0);
@@ -1896,6 +1931,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
@@ -1943,6 +1979,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: [],
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
@@ -1990,6 +2027,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: ['.codex-dev1'],
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
@@ -2057,6 +2095,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: ['.codex-dev1', '.codex-dev2'],
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(3);
@@ -2121,6 +2160,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockIssueRepository.updateStatus.mock.calls).toHaveLength(1);
@@ -2179,6 +2219,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockIssueRepository.updateStatus.mock.calls).toHaveLength(0);
@@ -2206,6 +2247,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 5,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockIssueRepository.getStoryObjectMap).toHaveBeenCalledWith(
@@ -2252,6 +2294,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockIssueRepository.updateStatus.mock.calls).toHaveLength(1);
@@ -2301,6 +2344,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(
@@ -2386,6 +2430,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(3);
@@ -2442,6 +2487,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
@@ -2512,6 +2558,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
@@ -2573,6 +2620,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
@@ -2637,6 +2685,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(
@@ -2704,6 +2753,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(
@@ -2811,6 +2861,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(3);
@@ -2868,6 +2919,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(3);
@@ -2929,6 +2981,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
@@ -2990,6 +3043,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
@@ -3051,6 +3105,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
@@ -3115,6 +3170,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(
@@ -3161,6 +3217,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(
@@ -3225,6 +3282,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
@@ -3289,6 +3347,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
@@ -3353,6 +3412,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
@@ -3417,6 +3477,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
@@ -3489,6 +3550,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
@@ -3561,6 +3623,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
@@ -3638,6 +3701,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(2);
@@ -3705,6 +3769,7 @@ describe('StartPreparationUseCase', () => {
       allowedIssueAuthors: null,
       codexHomeCandidates: null,
       allowIssueCacheMinutes: 0,
+      labelsAsLlmAgentName: null,
     });
 
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
@@ -3715,6 +3780,139 @@ describe('StartPreparationUseCase', () => {
       },
     });
   });
+
+  describe('agent selection precedence', () => {
+    const runWithIssueLabels = async (params: {
+      labels: string[];
+      defaultAgentName: string;
+      defaultLlmAgentName: string | null;
+      labelsAsLlmAgentName: string[] | null;
+    }): Promise<string> => {
+      const awaitingIssues: Issue[] = [
+        createMockIssue({
+          url: 'url1',
+          title: 'Issue 1',
+          labels: params.labels,
+          status: 'Awaiting Workspace',
+        }),
+      ];
+      mockProjectRepository.getByUrl.mockResolvedValue(mockProject);
+      mockIssueRepository.getStoryObjectMap.mockResolvedValue(
+        createMockStoryObjectMap(awaitingIssues),
+      );
+      mockLocalCommandRunner.runCommand.mockResolvedValue({
+        stdout: '',
+        stderr: '',
+        exitCode: 0,
+      });
+      await useCase.run({
+        projectUrl: 'https://github.com/user/repo',
+        defaultAgentName: params.defaultAgentName,
+        defaultLlmModelName: 'claude-opus',
+        defaultLlmAgentName: params.defaultLlmAgentName,
+        configFilePath: '/path/to/config.yml',
+        maximumPreparingIssuesCount: null,
+        utilizationPercentageThreshold: 90,
+        allowedIssueAuthors: null,
+        codexHomeCandidates: null,
+        allowIssueCacheMinutes: 0,
+        labelsAsLlmAgentName: params.labelsAsLlmAgentName,
+      });
+      expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
+      const awArgs = mockLocalCommandRunner.runCommand.mock.calls[0][1];
+      return awArgs[1];
+    };
+
+    it('selects explicit llm-agent: label over labelsAsLlmAgentName mapping', async () => {
+      const selectedAgent = await runWithIssueLabels({
+        labels: ['llm-agent:explicit-agent', 'story', 'category:impl'],
+        defaultAgentName: 'default-agent',
+        defaultLlmAgentName: 'default-llm-agent',
+        labelsAsLlmAgentName: ['story'],
+      });
+      expect(selectedAgent).toBe('explicit-agent');
+    });
+
+    it('uses the label name as the agent name when an issue label is listed in labelsAsLlmAgentName, over category: label', async () => {
+      const selectedAgent = await runWithIssueLabels({
+        labels: ['story', 'category:impl'],
+        defaultAgentName: 'default-agent',
+        defaultLlmAgentName: 'default-llm-agent',
+        labelsAsLlmAgentName: ['story'],
+      });
+      expect(selectedAgent).toBe('story');
+    });
+
+    it('matches labelsAsLlmAgentName entries exactly including colons in the label name', async () => {
+      const selectedAgent = await runWithIssueLabels({
+        labels: ['story:body-condition', 'category:impl'],
+        defaultAgentName: 'default-agent',
+        defaultLlmAgentName: 'default-llm-agent',
+        labelsAsLlmAgentName: ['story', 'story:body-condition'],
+      });
+      expect(selectedAgent).toBe('story:body-condition');
+    });
+
+    it('falls through to category: label when no llm-agent: label and no issue label is in labelsAsLlmAgentName', async () => {
+      const selectedAgent = await runWithIssueLabels({
+        labels: ['unrelated-label', 'category:impl'],
+        defaultAgentName: 'default-agent',
+        defaultLlmAgentName: 'default-llm-agent',
+        labelsAsLlmAgentName: ['story'],
+      });
+      expect(selectedAgent).toBe('impl');
+    });
+
+    it('falls through to defaultLlmAgentName when no llm-agent:, no labelsAsLlmAgentName match, and no category: label', async () => {
+      const selectedAgent = await runWithIssueLabels({
+        labels: ['unrelated-label'],
+        defaultAgentName: 'default-agent',
+        defaultLlmAgentName: 'default-llm-agent',
+        labelsAsLlmAgentName: ['story'],
+      });
+      expect(selectedAgent).toBe('default-llm-agent');
+    });
+
+    it('falls through to defaultAgentName when no llm-agent:, no labelsAsLlmAgentName match, no category: label, and no defaultLlmAgentName', async () => {
+      const selectedAgent = await runWithIssueLabels({
+        labels: ['unrelated-label'],
+        defaultAgentName: 'default-agent',
+        defaultLlmAgentName: null,
+        labelsAsLlmAgentName: ['story'],
+      });
+      expect(selectedAgent).toBe('default-agent');
+    });
+
+    it('ignores labels that are not listed in labelsAsLlmAgentName', async () => {
+      const selectedAgent = await runWithIssueLabels({
+        labels: ['untracked-label'],
+        defaultAgentName: 'default-agent',
+        defaultLlmAgentName: 'default-llm-agent',
+        labelsAsLlmAgentName: ['story'],
+      });
+      expect(selectedAgent).toBe('default-llm-agent');
+    });
+
+    it('ignores labels that are not listed in labelsAsLlmAgentName when other entries are present', async () => {
+      const selectedAgent = await runWithIssueLabels({
+        labels: ['untracked-label', 'another-untracked-label'],
+        defaultAgentName: 'default-agent',
+        defaultLlmAgentName: 'default-llm-agent',
+        labelsAsLlmAgentName: ['story', 'story:body-condition'],
+      });
+      expect(selectedAgent).toBe('default-llm-agent');
+    });
+
+    it('does not affect selection when labelsAsLlmAgentName is null and only category: label is present', async () => {
+      const selectedAgent = await runWithIssueLabels({
+        labels: ['category:impl'],
+        defaultAgentName: 'default-agent',
+        defaultLlmAgentName: 'default-llm-agent',
+        labelsAsLlmAgentName: null,
+      });
+      expect(selectedAgent).toBe('impl');
+    });
+  });
 });
 
 describe('StartPreparationUseCase.buildRotationOrder', () => {

package/src/domain/usecases/StartPreparationUseCase.ts

@@ -217,6 +217,7 @@ export class StartPreparationUseCase {
     allowedIssueAuthors: string[] | null;
     codexHomeCandidates: string[] | null;
     allowIssueCacheMinutes: number;
+    labelsAsLlmAgentName: string[] | null;
   }): Promise<{ rotationOrder: RotationOrderEntry[] | null }> => {
     const tokenUsages =
       await this.claudeTokenUsageRepository.getAvailableTokenUsages();
@@ -321,11 +322,20 @@ export class StartPreparationUseCase {
       ) {
         continue;
       }
+      const mappedAgentFromLabel =
+        params.labelsAsLlmAgentName !== null
+          ? issue.labels.find((label: string) =>
+              params.labelsAsLlmAgentName !== null
+                ? params.labelsAsLlmAgentName.includes(label)
+                : false,
+            )
+          : undefined;
       const agent =
         issue.labels
           .find((label: string) => label.startsWith('llm-agent:'))
           ?.replace('llm-agent:', '')
           .trim() ||
+        mappedAgentFromLabel ||
         issue.labels
           .find((label: string) => label.startsWith('category:'))
           ?.replace('category:', '')

package/types/adapter/entry-points/cli/projectConfig.d.ts

@@ -15,6 +15,7 @@ export type ConfigFile = {
     claudeCodeOauthTokenListJsonPath?: string;
     awLogDirectoryPath?: string;
     awLogStaleThresholdMinutes?: number;
+    labelsAsLlmAgentName?: string[];
 };
 export declare const isRecord: (value: unknown) => value is Record<string, unknown>;
 export declare const loadConfigFile: (configFilePath: string) => ConfigFile;

package/types/adapter/entry-points/cli/projectConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projectConfig.d.ts","sourceRoot":"","sources":["../../../../src/adapter/entry-points/cli/projectConfig.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,UAAU,GAAG;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,8BAA8B,CAAC,EAAE,MAAM,CAAC;IACxC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,iCAAiC,CAAC,EAAE,MAAM,CAAC;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B,CAAC,EAAE,MAAM,CAAC;IACxC,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,gCAAgC,CAAC,EAAE,MAAM,CAAC;IAC1C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC,CAAC;AAoCF,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CACH,CAAC;AAEvE,eAAO,MAAM,cAAc,GAAI,gBAAgB,MAAM,KAAG,UAkDvD,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,QAAQ,MAAM,KAAG,UAsDzD,CAAC;AAEF,eAAO,MAAM,YAAY,GACvB,YAAY,UAAU,EACtB,cAAc,UAAU,EACxB,iBAAiB,UAAU,KAC1B,UA2DD,CAAC;AAkBH,eAAO,MAAM,kBAAkB,GAC7B,YAAY,MAAM,EAClB,OAAO,MAAM,KACZ,OAAO,CAAC,MAAM,GAAG,IAAI,CA0DvB,CAAC"}
+{"version":3,"file":"projectConfig.d.ts","sourceRoot":"","sources":["../../../../src/adapter/entry-points/cli/projectConfig.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,UAAU,GAAG;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,8BAA8B,CAAC,EAAE,MAAM,CAAC;IACxC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,iCAAiC,CAAC,EAAE,MAAM,CAAC;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B,CAAC,EAAE,MAAM,CAAC;IACxC,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,gCAAgC,CAAC,EAAE,MAAM,CAAC;IAC1C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CACjC,CAAC;AAoCF,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CACH,CAAC;AAEvE,eAAO,MAAM,cAAc,GAAI,gBAAgB,MAAM,KAAG,UAmDvD,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,QAAQ,MAAM,KAAG,UAsDzD,CAAC;AAEF,eAAO,MAAM,YAAY,GACvB,YAAY,UAAU,EACtB,cAAc,UAAU,EACxB,iBAAiB,UAAU,KAC1B,UA+DD,CAAC;AAkBH,eAAO,MAAM,kBAAkB,GAC7B,YAAY,MAAM,EAClB,OAAO,MAAM,KACZ,OAAO,CAAC,MAAM,GAAG,IAAI,CA0DvB,CAAC"}

package/types/domain/usecases/HandleScheduledEventUseCase.d.ts

@@ -77,6 +77,7 @@ export declare class HandleScheduledEventUseCase {
             awLogDirectoryPath?: string;
             awLogStaleThresholdMinutes?: number;
             awaitingQualityCheckStatus?: string | null;
+            labelsAsLlmAgentName?: string[] | null;
         } | null;
         notifyFinishedPreparation?: {
             awaitingQualityCheckStatusName?: string | null;