github-issue-tower-defence-management 1.54.0 → 1.56.0

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

@@ -100,6 +100,7 @@ describe('ConvertCheckboxToIssueInStoryIssueUseCase', () => {
         cacheUsed: boolean;
         urlOfStoryView: string;
         storyObjectMap: StoryObjectMap;
+        manager: string;
       };
       expectedThrowError?: Error;
       expectedCreateNewIssueCalls: [
@@ -122,6 +123,7 @@ describe('ConvertCheckboxToIssueInStoryIssueUseCase', () => {
           cacheUsed: false,
           urlOfStoryView: 'https://example.com',
           storyObjectMap: basicStoryObjectMap,
+          manager: 'manager',
         },
         expectedCreateNewIssueCalls: [],
         expectedUpdateIssueCalls: [],
@@ -136,6 +138,7 @@ describe('ConvertCheckboxToIssueInStoryIssueUseCase', () => {
           cacheUsed: true,
           urlOfStoryView: 'https://example.com',
           storyObjectMap: basicStoryObjectMap,
+          manager: 'manager',
         },
         expectedCreateNewIssueCalls: [
           [
@@ -143,7 +146,7 @@ describe('ConvertCheckboxToIssueInStoryIssueUseCase', () => {
             'repo',
             'Task 1',
             '- Parent issue: https://github.com/org/repo/issues/123',
-            [],
+            ['manager'],
             [],
           ],
           [
@@ -151,7 +154,7 @@ describe('ConvertCheckboxToIssueInStoryIssueUseCase', () => {
             'repo',
             'Task 2',
             '- Parent issue: https://github.com/org/repo/issues/123',
-            [],
+            ['manager'],
             [],
           ],
           [
@@ -159,7 +162,7 @@ describe('ConvertCheckboxToIssueInStoryIssueUseCase', () => {
             'repo',
             'Task 3',
             '- Parent issue: https://github.com/org/repo/issues/456',
-            [],
+            ['manager'],
             [],
           ],
           [
@@ -167,7 +170,7 @@ describe('ConvertCheckboxToIssueInStoryIssueUseCase', () => {
             'repo',
             'Task 4',
             '- Parent issue: https://github.com/org/repo/issues/456',
-            [],
+            ['manager'],
             [],
           ],
         ],
@@ -278,6 +281,7 @@ describe('ConvertCheckboxToIssueInStoryIssueUseCase', () => {
           cacheUsed: false,
           urlOfStoryView: 'https://example.com',
           storyObjectMap: regularStoryObjectMap,
+          manager: 'manager',
         },
         expectedCreateNewIssueCalls: [],
         expectedUpdateIssueCalls: [],
@@ -292,6 +296,7 @@ describe('ConvertCheckboxToIssueInStoryIssueUseCase', () => {
           cacheUsed: false,
           urlOfStoryView: 'https://example.com',
           storyObjectMap: basicStoryObjectMap,
+          manager: 'manager',
         },
         expectedThrowError: new Error('Story issue not found: Story 1'),
         expectedCreateNewIssueCalls: [],
@@ -318,6 +323,7 @@ describe('ConvertCheckboxToIssueInStoryIssueUseCase', () => {
           cacheUsed: false,
           urlOfStoryView: 'https://example.com',
           storyObjectMap: basicStoryObjectMap,
+          manager: 'manager',
         },
         expectedCreateNewIssueCalls: [],
         expectedUpdateIssueCalls: [],
@@ -332,6 +338,7 @@ describe('ConvertCheckboxToIssueInStoryIssueUseCase', () => {
           cacheUsed: false,
           urlOfStoryView: 'https://example.com',
           storyObjectMap: basicStoryObjectMap,
+          manager: 'manager',
         },
         expectedCreateNewIssueCalls: [
           [
@@ -339,7 +346,7 @@ describe('ConvertCheckboxToIssueInStoryIssueUseCase', () => {
             'repo',
             'Task 1',
             '- Parent issue: https://github.com/org/repo/issues/123',
-            [],
+            ['manager'],
             [],
           ],
           [
@@ -347,7 +354,7 @@ describe('ConvertCheckboxToIssueInStoryIssueUseCase', () => {
             'repo',
             'Task 2',
             '- Parent issue: https://github.com/org/repo/issues/123',
-            [],
+            ['manager'],
             [],
           ],
           [
@@ -355,7 +362,7 @@ describe('ConvertCheckboxToIssueInStoryIssueUseCase', () => {
             'repo',
             'Task 3',
             '- Parent issue: https://github.com/org/repo/issues/456',
-            [],
+            ['manager'],
             [],
           ],
           [
@@ -363,7 +370,7 @@ describe('ConvertCheckboxToIssueInStoryIssueUseCase', () => {
             'repo',
             'Task 4',
             '- Parent issue: https://github.com/org/repo/issues/456',
-            [],
+            ['manager'],
             [],
           ],
         ],
@@ -489,6 +496,7 @@ describe('ConvertCheckboxToIssueInStoryIssueUseCase', () => {
           cacheUsed: false,
           urlOfStoryView: 'https://example.com',
           storyObjectMap: new Map([['Story 1', basicStoryObject1]]),
+          manager: 'manager',
         },
         expectedCreateNewIssueCalls: [
           [
@@ -496,7 +504,7 @@ describe('ConvertCheckboxToIssueInStoryIssueUseCase', () => {
             'repo',
             'Task 1',
             '- Parent issue: https://github.com/org/repo/issues/123',
-            [],
+            ['manager'],
             [],
           ],
         ],
@@ -565,6 +573,7 @@ describe('ConvertCheckboxToIssueInStoryIssueUseCase', () => {
               },
             ],
           ]),
+          manager: 'manager',
         },
         expectedCreateNewIssueCalls: [],
         expectedUpdateIssueCalls: [
@@ -597,6 +606,7 @@ Some description without checkboxes`,
           cacheUsed: false,
           urlOfStoryView: 'https://example.com',
           storyObjectMap: basicStoryObjectMap,
+          manager: 'manager',
         },
         expectedCreateNewIssueCalls: [
           [
@@ -604,7 +614,7 @@ Some description without checkboxes`,
             'repo',
             'Task 1',
             '- Parent issue: https://github.com/org/repo/issues/123',
-            [],
+            ['manager'],
             [],
           ],
           [
@@ -612,7 +622,7 @@ Some description without checkboxes`,
             'repo',
             'Task 2 for `Story 1 #123`',
             '- Parent issue: https://github.com/org/repo/issues/123',
-            [],
+            ['manager'],
             [],
           ],
           [
@@ -620,7 +630,7 @@ Some description without checkboxes`,
             'repo',
             'Task 3',
             '- Parent issue: https://github.com/org/repo/issues/456',
-            [],
+            ['manager'],
             [],
           ],
           [
@@ -628,7 +638,7 @@ Some description without checkboxes`,
             'repo',
             'Task 4',
             '- Parent issue: https://github.com/org/repo/issues/456',
-            [],
+            ['manager'],
             [],
           ],
         ],
@@ -787,6 +797,7 @@ Some description without checkboxes`,
               },
             ],
           ]),
+          manager: 'manager',
         },
         expectedCreateNewIssueCalls: [
           [
@@ -794,7 +805,7 @@ Some description without checkboxes`,
             'repoA',
             'Task 1',
             '- Parent issue: https://github.com/org/repo/issues/123',
-            [],
+            ['manager'],
             [],
           ],
           [
@@ -802,7 +813,7 @@ Some description without checkboxes`,
             'repoB',
             'Task 2',
             '- Parent issue: https://github.com/org/repo/issues/456',
-            [],
+            ['manager'],
             [],
           ],
         ],

package/src/domain/usecases/ConvertCheckboxToIssueInStoryIssueUseCase.ts

@@ -4,6 +4,7 @@ import { Project } from '../entities/Project';
 import { StoryObjectMap } from '../entities/StoryObjectMap';
 import { encodeForURI } from './utils';
 import { ICEBOX_STATUS_NAME } from '../entities/WorkflowStatus';
+import { Member } from '../entities/Member';
 
 export class ConvertCheckboxToIssueInStoryIssueUseCase {
   constructor(
@@ -19,6 +20,7 @@ export class ConvertCheckboxToIssueInStoryIssueUseCase {
     cacheUsed: boolean;
     urlOfStoryView: string;
     storyObjectMap: StoryObjectMap;
+    manager: Member['name'];
   }): Promise<void> => {
     const story = input.project.story;
     if (!story) {
@@ -74,7 +76,7 @@ export class ConvertCheckboxToIssueInStoryIssueUseCase {
           freshStoryIssue.repo,
           issueTitle,
           newIssueBody,
-          [],
+          [input.manager],
           [],
         );
         const newIssueUrl = `https://github.com/${freshStoryIssue.org}/${freshStoryIssue.repo}/issues/${newIssueNumber}`;

package/src/domain/usecases/HandleScheduledEventUseCase.ts

@@ -366,6 +366,7 @@ ${JSON.stringify(e)}
       cacheUsed,
       urlOfStoryView: input.urlOfStoryView,
       storyObjectMap: storyObjectMap,
+      manager: input.manager,
     });
     await this.changeStatusByStoryColorUseCase.run({
       project,

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

@@ -6,6 +6,7 @@ import {
 import { ProjectRepository } from './adapter-interfaces/ProjectRepository';
 import { LocalCommandRunner } from './adapter-interfaces/LocalCommandRunner';
 import { ClaudeRepository } from './adapter-interfaces/ClaudeRepository';
+import { ClaudeTokenUsageRepository } from './adapter-interfaces/ClaudeTokenUsageRepository';
 import { Issue } from '../entities/Issue';
 import { Project } from '../entities/Project';
 import { StoryObjectMap } from '../entities/StoryObjectMap';
@@ -92,6 +93,7 @@ describe('StartPreparationUseCase', () => {
   >;
   let mockClaudeRepository: Mocked<Pick<ClaudeRepository, 'getUsage'>>;
   let mockLocalCommandRunner: Mocked<LocalCommandRunner>;
+  let mockClaudeTokenUsageRepository: Mocked<ClaudeTokenUsageRepository>;
   let mockProject: Project;
   beforeEach(() => {
     jest.resetAllMocks();
@@ -114,11 +116,17 @@ describe('StartPreparationUseCase', () => {
     mockLocalCommandRunner = {
       runCommand: jest.fn(),
     };
+    mockClaudeTokenUsageRepository = {
+      ensureObservable: jest.fn().mockResolvedValue(undefined),
+      getAvailableTokenUsages: jest.fn().mockResolvedValue([]),
+      proxyBaseUrl: jest.fn().mockReturnValue('http://127.0.0.1:8787'),
+    };
     useCase = new StartPreparationUseCase(
       mockProjectRepository,
       mockIssueRepository,
       mockClaudeRepository,
       mockLocalCommandRunner,
+      mockClaudeTokenUsageRepository,
     );
   });
   it('should run aw command for awaiting workspace issues', async () => {
@@ -2516,4 +2524,304 @@ describe('StartPreparationUseCase', () => {
       url: 'https://github.com/user/repo/issues/2',
     });
   });
+
+  it('should pass CLAUDE_CODE_OAUTH_TOKEN and ANTHROPIC_BASE_URL to runCommand when tokens are available', async () => {
+    const awaitingIssue = createMockIssue({
+      url: 'url1',
+      title: 'Issue 1',
+      labels: ['category:impl'],
+      status: 'Awaiting Workspace',
+      number: 1,
+      itemId: 'item-1',
+    });
+    mockProjectRepository.getByUrl.mockResolvedValue(mockProject);
+    mockIssueRepository.getStoryObjectMap.mockResolvedValue(
+      createMockStoryObjectMap([awaitingIssue]),
+    );
+    mockLocalCommandRunner.runCommand.mockResolvedValue({
+      stdout: '',
+      stderr: '',
+      exitCode: 0,
+    });
+    mockClaudeTokenUsageRepository.getAvailableTokenUsages.mockResolvedValue([
+      { token: 'token-a', fiveHourUtilization: 0, blocked: false },
+    ]);
+
+    await useCase.run({
+      projectUrl: 'https://github.com/user/repo',
+      defaultAgentName: 'agent1',
+      defaultLlmModelName: 'claude-opus',
+      defaultLlmAgentName: null,
+      configFilePath: '/path/to/config.yml',
+      maximumPreparingIssuesCount: null,
+      utilizationPercentageThreshold: 90,
+      allowedIssueAuthors: null,
+      codexHomeCandidates: null,
+      allowIssueCacheMinutes: 0,
+    });
+
+    expect(
+      mockClaudeTokenUsageRepository.getAvailableTokenUsages.mock.calls,
+    ).toHaveLength(1);
+    expect(
+      mockClaudeTokenUsageRepository.ensureObservable.mock.calls,
+    ).toHaveLength(1);
+    expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
+    expect(mockLocalCommandRunner.runCommand.mock.calls[0][2]).toEqual({
+      env: {
+        CLAUDE_CODE_OAUTH_TOKEN: 'token-a',
+        ANTHROPIC_BASE_URL: 'http://127.0.0.1:8787',
+      },
+    });
+  });
+
+  it('should rotate Claude OAuth tokens round-robin across multiple awaiting issues', async () => {
+    const awaitingIssues: Issue[] = [
+      createMockIssue({
+        url: 'url1',
+        title: 'Issue 1',
+        labels: ['category:impl'],
+        status: 'Awaiting Workspace',
+        number: 1,
+        itemId: 'item-1',
+      }),
+      createMockIssue({
+        url: 'url2',
+        title: 'Issue 2',
+        labels: ['category:impl'],
+        status: 'Awaiting Workspace',
+        number: 2,
+        itemId: 'item-2',
+      }),
+      createMockIssue({
+        url: 'url3',
+        title: 'Issue 3',
+        labels: ['category:impl'],
+        status: 'Awaiting Workspace',
+        number: 3,
+        itemId: 'item-3',
+      }),
+    ];
+    mockProjectRepository.getByUrl.mockResolvedValue(mockProject);
+    mockIssueRepository.getStoryObjectMap.mockResolvedValue(
+      createMockStoryObjectMap(awaitingIssues),
+    );
+    mockLocalCommandRunner.runCommand.mockResolvedValue({
+      stdout: '',
+      stderr: '',
+      exitCode: 0,
+    });
+    mockClaudeTokenUsageRepository.getAvailableTokenUsages.mockResolvedValue([
+      { token: 'token-a', fiveHourUtilization: 0, blocked: false },
+      { token: 'token-b', fiveHourUtilization: 0, blocked: false },
+    ]);
+
+    await useCase.run({
+      projectUrl: 'https://github.com/user/repo',
+      defaultAgentName: 'agent1',
+      defaultLlmModelName: 'claude-opus',
+      defaultLlmAgentName: null,
+      configFilePath: '/path/to/config.yml',
+      maximumPreparingIssuesCount: null,
+      utilizationPercentageThreshold: 90,
+      allowedIssueAuthors: null,
+      codexHomeCandidates: null,
+      allowIssueCacheMinutes: 0,
+    });
+
+    expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(3);
+    expect(mockLocalCommandRunner.runCommand.mock.calls[0][2]).toMatchObject({
+      env: {
+        CLAUDE_CODE_OAUTH_TOKEN: 'token-a',
+        ANTHROPIC_BASE_URL: 'http://127.0.0.1:8787',
+      },
+    });
+    expect(mockLocalCommandRunner.runCommand.mock.calls[1][2]).toMatchObject({
+      env: {
+        CLAUDE_CODE_OAUTH_TOKEN: 'token-b',
+        ANTHROPIC_BASE_URL: 'http://127.0.0.1:8787',
+      },
+    });
+    expect(mockLocalCommandRunner.runCommand.mock.calls[2][2]).toMatchObject({
+      env: {
+        CLAUDE_CODE_OAUTH_TOKEN: 'token-a',
+        ANTHROPIC_BASE_URL: 'http://127.0.0.1:8787',
+      },
+    });
+  });
+
+  it('should not inject env when no tokens are available', async () => {
+    const awaitingIssue = createMockIssue({
+      url: 'url1',
+      title: 'Issue 1',
+      labels: ['category:impl'],
+      status: 'Awaiting Workspace',
+      number: 1,
+      itemId: 'item-1',
+    });
+    mockProjectRepository.getByUrl.mockResolvedValue(mockProject);
+    mockIssueRepository.getStoryObjectMap.mockResolvedValue(
+      createMockStoryObjectMap([awaitingIssue]),
+    );
+    mockLocalCommandRunner.runCommand.mockResolvedValue({
+      stdout: '',
+      stderr: '',
+      exitCode: 0,
+    });
+    mockClaudeTokenUsageRepository.getAvailableTokenUsages.mockResolvedValue(
+      [],
+    );
+
+    await useCase.run({
+      projectUrl: 'https://github.com/user/repo',
+      defaultAgentName: 'agent1',
+      defaultLlmModelName: 'claude-opus',
+      defaultLlmAgentName: null,
+      configFilePath: '/path/to/config.yml',
+      maximumPreparingIssuesCount: null,
+      utilizationPercentageThreshold: 90,
+      allowedIssueAuthors: null,
+      codexHomeCandidates: null,
+      allowIssueCacheMinutes: 0,
+    });
+
+    expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
+    expect(mockLocalCommandRunner.runCommand.mock.calls[0][2]).toBeUndefined();
+    expect(
+      mockClaudeTokenUsageRepository.ensureObservable.mock.calls,
+    ).toHaveLength(0);
+  });
+
+  it('should pick the least-utilized token first', async () => {
+    const awaitingIssue = createMockIssue({
+      url: 'url1',
+      title: 'Issue 1',
+      labels: ['category:impl'],
+      status: 'Awaiting Workspace',
+      number: 1,
+      itemId: 'item-1',
+    });
+    mockProjectRepository.getByUrl.mockResolvedValue(mockProject);
+    mockIssueRepository.getStoryObjectMap.mockResolvedValue(
+      createMockStoryObjectMap([awaitingIssue]),
+    );
+    mockLocalCommandRunner.runCommand.mockResolvedValue({
+      stdout: '',
+      stderr: '',
+      exitCode: 0,
+    });
+    mockClaudeTokenUsageRepository.getAvailableTokenUsages.mockResolvedValue([
+      { token: 'token-high', fiveHourUtilization: 80, blocked: false },
+      { token: 'token-low', fiveHourUtilization: 10, blocked: false },
+    ]);
+
+    await useCase.run({
+      projectUrl: 'https://github.com/user/repo',
+      defaultAgentName: 'agent1',
+      defaultLlmModelName: 'claude-opus',
+      defaultLlmAgentName: null,
+      configFilePath: '/path/to/config.yml',
+      maximumPreparingIssuesCount: null,
+      utilizationPercentageThreshold: 90,
+      allowedIssueAuthors: null,
+      codexHomeCandidates: null,
+      allowIssueCacheMinutes: 0,
+    });
+
+    expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
+    expect(mockLocalCommandRunner.runCommand.mock.calls[0][2]).toEqual({
+      env: {
+        CLAUDE_CODE_OAUTH_TOKEN: 'token-low',
+        ANTHROPIC_BASE_URL: 'http://127.0.0.1:8787',
+      },
+    });
+  });
+
+  it('should exclude blocked tokens from rotation', async () => {
+    const awaitingIssue = createMockIssue({
+      url: 'url1',
+      title: 'Issue 1',
+      labels: ['category:impl'],
+      status: 'Awaiting Workspace',
+      number: 1,
+      itemId: 'item-1',
+    });
+    mockProjectRepository.getByUrl.mockResolvedValue(mockProject);
+    mockIssueRepository.getStoryObjectMap.mockResolvedValue(
+      createMockStoryObjectMap([awaitingIssue]),
+    );
+    mockLocalCommandRunner.runCommand.mockResolvedValue({
+      stdout: '',
+      stderr: '',
+      exitCode: 0,
+    });
+    mockClaudeTokenUsageRepository.getAvailableTokenUsages.mockResolvedValue([
+      { token: 'token-blocked', fiveHourUtilization: 5, blocked: true },
+      { token: 'token-ok', fiveHourUtilization: 50, blocked: false },
+    ]);
+
+    await useCase.run({
+      projectUrl: 'https://github.com/user/repo',
+      defaultAgentName: 'agent1',
+      defaultLlmModelName: 'claude-opus',
+      defaultLlmAgentName: null,
+      configFilePath: '/path/to/config.yml',
+      maximumPreparingIssuesCount: null,
+      utilizationPercentageThreshold: 90,
+      allowedIssueAuthors: null,
+      codexHomeCandidates: null,
+      allowIssueCacheMinutes: 0,
+    });
+
+    expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
+    expect(mockLocalCommandRunner.runCommand.mock.calls[0][2]).toEqual({
+      env: {
+        CLAUDE_CODE_OAUTH_TOKEN: 'token-ok',
+        ANTHROPIC_BASE_URL: 'http://127.0.0.1:8787',
+      },
+    });
+  });
+
+  it('should not inject env when every available token is blocked', async () => {
+    const awaitingIssue = createMockIssue({
+      url: 'url1',
+      title: 'Issue 1',
+      labels: ['category:impl'],
+      status: 'Awaiting Workspace',
+      number: 1,
+      itemId: 'item-1',
+    });
+    mockProjectRepository.getByUrl.mockResolvedValue(mockProject);
+    mockIssueRepository.getStoryObjectMap.mockResolvedValue(
+      createMockStoryObjectMap([awaitingIssue]),
+    );
+    mockLocalCommandRunner.runCommand.mockResolvedValue({
+      stdout: '',
+      stderr: '',
+      exitCode: 0,
+    });
+    mockClaudeTokenUsageRepository.getAvailableTokenUsages.mockResolvedValue([
+      { token: 'token-a', fiveHourUtilization: 5, blocked: true },
+      { token: 'token-b', fiveHourUtilization: 8, blocked: true },
+    ]);
+
+    await useCase.run({
+      projectUrl: 'https://github.com/user/repo',
+      defaultAgentName: 'agent1',
+      defaultLlmModelName: 'claude-opus',
+      defaultLlmAgentName: null,
+      configFilePath: '/path/to/config.yml',
+      maximumPreparingIssuesCount: null,
+      utilizationPercentageThreshold: 90,
+      allowedIssueAuthors: null,
+      codexHomeCandidates: null,
+      allowIssueCacheMinutes: 0,
+    });
+
+    expect(
+      mockClaudeTokenUsageRepository.ensureObservable.mock.calls,
+    ).toHaveLength(0);
+    expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
+    expect(mockLocalCommandRunner.runCommand.mock.calls[0][2]).toBeUndefined();
+  });
 });

package/src/domain/usecases/StartPreparationUseCase.ts

@@ -2,6 +2,8 @@ import { IssueRepository } from './adapter-interfaces/IssueRepository';
 import { ProjectRepository } from './adapter-interfaces/ProjectRepository';
 import { LocalCommandRunner } from './adapter-interfaces/LocalCommandRunner';
 import { ClaudeRepository } from './adapter-interfaces/ClaudeRepository';
+import { ClaudeTokenUsageRepository } from './adapter-interfaces/ClaudeTokenUsageRepository';
+import { ClaudeTokenUsage } from '../entities/ClaudeTokenUsage';
 import {
   AWAITING_WORKSPACE_STATUS_NAME,
   PREPARATION_STATUS_NAME,
@@ -22,8 +24,15 @@ export class StartPreparationUseCase {
     >,
     private readonly claudeRepository: Pick<ClaudeRepository, 'getUsage'>,
     private readonly localCommandRunner: LocalCommandRunner,
+    private readonly claudeTokenUsageRepository: ClaudeTokenUsageRepository,
   ) {}
 
+  private selectRotationTokens = (tokenUsages: ClaudeTokenUsage[]): string[] =>
+    tokenUsages
+      .filter((usage) => !usage.blocked)
+      .sort((a, b) => a.fiveHourUtilization - b.fiveHourUtilization)
+      .map((usage) => usage.token);
+
   run = async (params: {
     projectUrl: string;
     defaultAgentName: string;
@@ -84,6 +93,20 @@ export class StartPreparationUseCase {
         );
       }
     }
+
+    const tokenUsages =
+      await this.claudeTokenUsageRepository.getAvailableTokenUsages();
+    let rotationTokens: string[] | null = null;
+    let proxyBaseUrl: string | null = null;
+    if (tokenUsages.length > 0) {
+      const ranked = this.selectRotationTokens(tokenUsages);
+      if (ranked.length > 0) {
+        await this.claudeTokenUsageRepository.ensureObservable();
+        rotationTokens = ranked;
+        proxyBaseUrl = this.claudeTokenUsageRepository.proxyBaseUrl();
+      }
+    }
+
     const project = await this.projectRepository.getByUrl(params.projectUrl);
     const storyObjectMap = await this.issueRepository.getStoryObjectMap(
       project,
@@ -271,7 +294,20 @@ export class StartPreparationUseCase {
           ];
         awArgs.push('--codexHome', codexHome);
       }
-      await this.localCommandRunner.runCommand('aw', awArgs);
+      let spawnEnv: Record<string, string> | undefined;
+      if (rotationTokens !== null && proxyBaseUrl !== null) {
+        const selected =
+          rotationTokens[startedInThisRunCount % rotationTokens.length];
+        spawnEnv = {
+          CLAUDE_CODE_OAUTH_TOKEN: selected,
+          ANTHROPIC_BASE_URL: proxyBaseUrl,
+        };
+      }
+      await this.localCommandRunner.runCommand(
+        'aw',
+        awArgs,
+        spawnEnv ? { env: spawnEnv } : undefined,
+      );
       startedInThisRunCount++;
       updatedCurrentPreparationIssueCount++;
     }

package/src/domain/usecases/adapter-interfaces/ClaudeTokenUsageRepository.ts

@@ -0,0 +1,7 @@
+import { ClaudeTokenUsage } from '../../entities/ClaudeTokenUsage';
+
+export interface ClaudeTokenUsageRepository {
+  ensureObservable(): Promise<void>;
+  getAvailableTokenUsages(): Promise<ClaudeTokenUsage[]>;
+  proxyBaseUrl(): string;
+}

package/src/domain/usecases/adapter-interfaces/LocalCommandRunner.ts

@@ -1,7 +1,12 @@
+export interface LocalCommandRunnerOptions {
+  env?: Record<string, string>;
+}
+
 export interface LocalCommandRunner {
   runCommand(
     program: string,
     args: string[],
+    options?: LocalCommandRunnerOptions,
   ): Promise<{
     stdout: string;
     stderr: string;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapter/entry-points/cli/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EACL,UAAU,EACV,cAAc,EACd,wBAAwB,EACxB,YAAY,EACZ,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAiEzB,eAAO,MAAM,OAAO,SAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapter/entry-points/cli/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EACL,UAAU,EACV,cAAc,EACd,wBAAwB,EACxB,YAAY,EACZ,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAkEzB,eAAO,MAAM,OAAO,SAAgB,CAAC"}

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

@@ -12,6 +12,7 @@ export type ConfigFile = {
     projectName?: string;
     preparationProcessCheckCommand?: string;
     codexHomeCandidates?: string[];
+    claudeCodeOauthTokenListJsonPath?: string;
     awLogDirectoryPath?: string;
     awLogStaleThresholdMinutes?: number;
 };