npm-cli-gh-issue-preparator 1.0.3 → 1.1.0

package/.github/workflows/test.yml

@@ -24,6 +24,8 @@ jobs:
 
       - name: Run tests
         run: npm run test
+        env:
+          GH_TOKEN: ${{ secrets.GH_TOKEN }}
 
       - name: Upload test results
         uses: actions/upload-artifact@v6

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [1.1.0](https://github.com/HiromiShikata/npm-cli-gh-issue-preparator/compare/v1.0.4...v1.1.0) (2026-01-12)
+
+
+### Features
+
+* **core:** add Claude usage repository for OAuth API integration ([57ab791](https://github.com/HiromiShikata/npm-cli-gh-issue-preparator/commit/57ab7914f9574a4e6746183457e643dac47f7261))
+
+## [1.0.4](https://github.com/HiromiShikata/npm-cli-gh-issue-preparator/compare/v1.0.3...v1.0.4) (2026-01-10)
+
+
+### Bug Fixes
+
+* **ci:** add GH_TOKEN to test workflow and fix test expectations ([86dbac0](https://github.com/HiromiShikata/npm-cli-gh-issue-preparator/commit/86dbac0bd66e0806531a26338b225ddec22c7826))
+
 ## [1.0.3](https://github.com/HiromiShikata/npm-cli-gh-issue-preparator/compare/v1.0.2...v1.0.3) (2025-12-14)
 
 

package/bin/adapter/repositories/OauthAPIClaudeRepository.js

@@ -0,0 +1,133 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OauthAPIClaudeRepository = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const isCredentialsFile = (value) => {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    return true;
+};
+const isUsageResponse = (value) => {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    return true;
+};
+class OauthAPIClaudeRepository {
+    constructor() {
+        this.credentialsPath = path.join(os.homedir(), '.claude', '.credentials.json');
+    }
+    getAccessToken() {
+        if (!fs.existsSync(this.credentialsPath)) {
+            throw new Error(`Claude credentials file not found at ${this.credentialsPath}. Please login to Claude Code first using: claude login`);
+        }
+        const fileContent = fs.readFileSync(this.credentialsPath, 'utf-8');
+        const credentials = JSON.parse(fileContent);
+        if (!isCredentialsFile(credentials)) {
+            throw new Error('Invalid credentials file format');
+        }
+        const accessToken = credentials.claudeAiOauth?.accessToken;
+        if (!accessToken) {
+            throw new Error('No access token found in credentials file');
+        }
+        return accessToken;
+    }
+    async getUsage() {
+        const accessToken = this.getAccessToken();
+        const response = await fetch('https://api.anthropic.com/api/oauth/usage', {
+            method: 'GET',
+            headers: {
+                Accept: 'application/json, text/plain, */*',
+                'Content-Type': 'application/json',
+                'User-Agent': 'claude-code/2.0.32',
+                Authorization: `Bearer ${accessToken}`,
+                'anthropic-beta': 'oauth-2025-04-20',
+            },
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Claude API error: ${errorText}`);
+        }
+        const responseData = await response.json();
+        if (!isUsageResponse(responseData)) {
+            throw new Error('Invalid API response format');
+        }
+        if (responseData.error) {
+            throw new Error(`API error: ${responseData.error}`);
+        }
+        const usages = [];
+        if (responseData.five_hour?.utilization !== undefined) {
+            usages.push({
+                hour: 5,
+                utilizationPercentage: responseData.five_hour.utilization,
+                resetsAt: responseData.five_hour.resets_at
+                    ? new Date(responseData.five_hour.resets_at)
+                    : new Date(),
+            });
+        }
+        if (responseData.seven_day?.utilization !== undefined) {
+            usages.push({
+                hour: 168,
+                utilizationPercentage: responseData.seven_day.utilization,
+                resetsAt: responseData.seven_day.resets_at
+                    ? new Date(responseData.seven_day.resets_at)
+                    : new Date(),
+            });
+        }
+        if (responseData.seven_day_opus?.utilization !== undefined) {
+            usages.push({
+                hour: 168,
+                utilizationPercentage: responseData.seven_day_opus.utilization,
+                resetsAt: responseData.seven_day_opus.resets_at
+                    ? new Date(responseData.seven_day_opus.resets_at)
+                    : new Date(),
+            });
+        }
+        if (responseData.seven_day_sonnet?.utilization !== undefined) {
+            usages.push({
+                hour: 168,
+                utilizationPercentage: responseData.seven_day_sonnet.utilization,
+                resetsAt: responseData.seven_day_sonnet.resets_at
+                    ? new Date(responseData.seven_day_sonnet.resets_at)
+                    : new Date(),
+            });
+        }
+        return usages;
+    }
+}
+exports.OauthAPIClaudeRepository = OauthAPIClaudeRepository;
+//# sourceMappingURL=OauthAPIClaudeRepository.js.map

package/bin/adapter/repositories/OauthAPIClaudeRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OauthAPIClaudeRepository.js","sourceRoot":"","sources":["../../../src/adapter/repositories/OauthAPIClaudeRepository.ts"],"names":[],"mappings":"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"}

package/bin/domain/entities/ClaudeWindowUsage.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ClaudeWindowUsage.js.map

package/bin/domain/entities/ClaudeWindowUsage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClaudeWindowUsage.js","sourceRoot":"","sources":["../../../src/domain/entities/ClaudeWindowUsage.ts"],"names":[],"mappings":""}

package/bin/domain/usecases/adapter-interfaces/ClaudeRepository.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ClaudeRepository.js.map

package/bin/domain/usecases/adapter-interfaces/ClaudeRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClaudeRepository.js","sourceRoot":"","sources":["../../../../src/domain/usecases/adapter-interfaces/ClaudeRepository.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "npm-cli-gh-issue-preparator",
-  "version": "1.0.3",
+  "version": "1.1.0",
   "description": "",
   "main": "bin/index.js",
   "scripts": {

package/renovate.json

@@ -11,12 +11,6 @@
   "branchConcurrentLimit": 2,
   "ignorePaths": ["**/generated/*", "**/_gen/*"],
   "packageRules": [
-    {
-      "matchPackagePatterns": ["*"],
-      "matchUpdateTypes": ["minor", "patch"],
-      "groupName": "all non-major dependencies",
-      "groupSlug": "all-minor-patch"
-    },
     {
       "matchPackageNames": ["eslint"],
       "allowedVersions": "<9.0.0"
@@ -32,6 +26,10 @@
     {
       "matchPackageNames": ["eslint-plugin-unused-imports"],
       "allowedVersions": "<4.0.0"
+    },
+    {
+      "matchPackageNames": ["@google/clasp"],
+      "allowedVersions": "3.1.0"
     }
   ]
 }

package/src/adapter/repositories/GitHubIssueRepository.test.ts

@@ -270,6 +270,123 @@ describe('GitHubIssueRepository', () => {
       expect(issues).toEqual([]);
     });
 
+    it('should skip items with content but undefined url', async () => {
+      mockFetch.mockResolvedValueOnce({
+        ok: true,
+        json: jest.fn().mockResolvedValue({
+          data: {
+            organization: {
+              projectV2: {
+                items: {
+                  totalCount: 2,
+                  pageInfo: {
+                    endCursor: null,
+                    hasNextPage: false,
+                  },
+                  nodes: [
+                    {
+                      id: 'item-with-undefined-url',
+                      content: {
+                        url: undefined,
+                        title: 'Item Without URL',
+                        number: 1,
+                        labels: {
+                          nodes: [],
+                        },
+                      },
+                      fieldValues: {
+                        nodes: [
+                          {
+                            name: 'Done',
+                            field: {
+                              name: 'Status',
+                            },
+                          },
+                        ],
+                      },
+                    },
+                    {
+                      id: 'valid-issue',
+                      content: {
+                        url: 'https://github.com/owner/repo/issues/5',
+                        title: 'Valid Issue',
+                        number: 5,
+                        labels: {
+                          nodes: [],
+                        },
+                      },
+                      fieldValues: {
+                        nodes: [
+                          {
+                            name: 'Done',
+                            field: {
+                              name: 'Status',
+                            },
+                          },
+                        ],
+                      },
+                    },
+                  ],
+                },
+              },
+            },
+          },
+        }),
+      });
+
+      const issues = await repository.getAllOpened(mockProject);
+
+      expect(issues).toHaveLength(1);
+      expect(issues[0].id).toBe('valid-issue');
+    });
+
+    it('should handle items with null labels nodes', async () => {
+      mockFetch.mockResolvedValueOnce({
+        ok: true,
+        json: jest.fn().mockResolvedValue({
+          data: {
+            organization: {
+              projectV2: {
+                items: {
+                  totalCount: 1,
+                  pageInfo: {
+                    endCursor: null,
+                    hasNextPage: false,
+                  },
+                  nodes: [
+                    {
+                      id: 'issue-no-labels',
+                      content: {
+                        url: 'https://github.com/owner/repo/issues/10',
+                        title: 'Issue Without Labels',
+                        number: 10,
+                        labels: null,
+                      },
+                      fieldValues: {
+                        nodes: [
+                          {
+                            name: 'Done',
+                            field: {
+                              name: 'Status',
+                            },
+                          },
+                        ],
+                      },
+                    },
+                  ],
+                },
+              },
+            },
+          },
+        }),
+      });
+
+      const issues = await repository.getAllOpened(mockProject);
+
+      expect(issues).toHaveLength(1);
+      expect(issues[0].labels).toEqual([]);
+    });
+
     it('should handle issue without Status field', async () => {
       mockFetch.mockResolvedValueOnce({
         ok: true,
@@ -343,6 +460,10 @@ describe('GitHubIssueRepository', () => {
             organization: {
               projectV2: {
                 fields: {
+                  pageInfo: {
+                    hasNextPage: false,
+                    endCursor: null,
+                  },
                   nodes: [
                     {
                       id: 'field-1',
@@ -400,6 +521,10 @@ describe('GitHubIssueRepository', () => {
             organization: {
               projectV2: {
                 fields: {
+                  pageInfo: {
+                    hasNextPage: false,
+                    endCursor: null,
+                  },
                   nodes: [
                     {
                       id: 'field-1',
@@ -453,6 +578,10 @@ describe('GitHubIssueRepository', () => {
             organization: {
               projectV2: {
                 fields: {
+                  pageInfo: {
+                    hasNextPage: false,
+                    endCursor: null,
+                  },
                   nodes: [
                     {
                       id: 'field-1',
@@ -525,6 +654,10 @@ describe('GitHubIssueRepository', () => {
             organization: {
               projectV2: {
                 fields: {
+                  pageInfo: {
+                    hasNextPage: false,
+                    endCursor: null,
+                  },
                   nodes: [
                     {
                       id: 'field-1',
@@ -560,6 +693,10 @@ describe('GitHubIssueRepository', () => {
             organization: {
               projectV2: {
                 fields: {
+                  pageInfo: {
+                    hasNextPage: false,
+                    endCursor: null,
+                  },
                   nodes: [
                     {
                       id: 'field-1',
@@ -600,6 +737,10 @@ describe('GitHubIssueRepository', () => {
             organization: {
               projectV2: {
                 fields: {
+                  pageInfo: {
+                    hasNextPage: false,
+                    endCursor: null,
+                  },
                   nodes: [
                     {
                       id: 'field-1',
@@ -642,6 +783,10 @@ describe('GitHubIssueRepository', () => {
             organization: {
               projectV2: {
                 fields: {
+                  pageInfo: {
+                    hasNextPage: false,
+                    endCursor: null,
+                  },
                   nodes: [
                     {
                       id: 'field-1',
@@ -682,6 +827,10 @@ describe('GitHubIssueRepository', () => {
             user: {
               projectV2: {
                 fields: {
+                  pageInfo: {
+                    hasNextPage: false,
+                    endCursor: null,
+                  },
                   nodes: [
                     {
                       id: 'field-1',
@@ -1032,5 +1181,60 @@ describe('GitHubIssueRepository', () => {
 
       expect(result).toBeNull();
     });
+
+    it('should handle issue with null labels in get method', async () => {
+      mockFetch.mockResolvedValueOnce({
+        ok: true,
+        json: jest.fn().mockResolvedValue({
+          data: {
+            organization: {
+              projectV2: {
+                items: {
+                  totalCount: 1,
+                  pageInfo: {
+                    endCursor: null,
+                    hasNextPage: false,
+                  },
+                  nodes: [
+                    {
+                      id: 'issue-null-labels',
+                      content: {
+                        url: 'https://github.com/owner/repo/issues/1',
+                        title: 'Issue With Null Labels',
+                        number: 1,
+                        labels: null,
+                      },
+                      fieldValues: {
+                        nodes: [
+                          {
+                            name: 'Done',
+                            field: {
+                              name: 'Status',
+                            },
+                          },
+                        ],
+                      },
+                    },
+                  ],
+                },
+              },
+            },
+          },
+        }),
+      });
+
+      const result = await repository.get(
+        'https://github.com/owner/repo/issues/1',
+        mockProject,
+      );
+
+      expect(result).toEqual({
+        id: 'issue-null-labels',
+        url: 'https://github.com/owner/repo/issues/1',
+        title: 'Issue With Null Labels',
+        labels: [],
+        status: 'Done',
+      });
+    });
   });
 });

package/src/adapter/repositories/OauthAPIClaudeRepository.test.ts

@@ -0,0 +1,346 @@
+const mockExistsSync = jest.fn();
+const mockReadFileSync = jest.fn();
+const mockHomedir = jest.fn();
+
+jest.mock('fs', () => ({
+  existsSync: mockExistsSync,
+  readFileSync: mockReadFileSync,
+}));
+
+jest.mock('os', () => ({
+  homedir: mockHomedir,
+}));
+
+import { OauthAPIClaudeRepository } from './OauthAPIClaudeRepository';
+import * as path from 'path';
+
+describe('OauthAPIClaudeRepository', () => {
+  let repository: OauthAPIClaudeRepository;
+  let mockFetch: jest.Mock;
+
+  beforeEach(() => {
+    mockHomedir.mockReturnValue('/home/testuser');
+    mockFetch = jest.fn();
+    global.fetch = mockFetch;
+    jest.clearAllMocks();
+  });
+
+  const credentialsPath = path.join(
+    '/home/testuser',
+    '.claude',
+    '.credentials.json',
+  );
+
+  describe('getUsage', () => {
+    it('should fetch usage data from Claude API', async () => {
+      mockExistsSync.mockReturnValue(true);
+      mockReadFileSync.mockReturnValue(
+        JSON.stringify({
+          claudeAiOauth: {
+            accessToken: 'test-access-token',
+          },
+        }),
+      );
+
+      mockFetch.mockResolvedValueOnce({
+        ok: true,
+        json: jest.fn().mockResolvedValue({
+          five_hour: {
+            utilization: 25.5,
+            resets_at: '2026-01-12T10:00:00Z',
+          },
+          seven_day: {
+            utilization: 50.0,
+            resets_at: '2026-01-15T00:00:00Z',
+          },
+        }),
+      });
+
+      repository = new OauthAPIClaudeRepository();
+      const usages = await repository.getUsage();
+
+      expect(usages).toHaveLength(2);
+      expect(usages[0]).toEqual({
+        hour: 5,
+        utilizationPercentage: 25.5,
+        resetsAt: new Date('2026-01-12T10:00:00Z'),
+      });
+      expect(usages[1]).toEqual({
+        hour: 168,
+        utilizationPercentage: 50.0,
+        resetsAt: new Date('2026-01-15T00:00:00Z'),
+      });
+
+      expect(mockFetch).toHaveBeenCalledWith(
+        'https://api.anthropic.com/api/oauth/usage',
+        expect.objectContaining({
+          method: 'GET',
+          headers: {
+            Accept: 'application/json, text/plain, */*',
+            'Content-Type': 'application/json',
+            'User-Agent': 'claude-code/2.0.32',
+            Authorization: 'Bearer test-access-token',
+            'anthropic-beta': 'oauth-2025-04-20',
+          },
+        }),
+      );
+    });
+
+    it('should include opus and sonnet usage when available', async () => {
+      mockExistsSync.mockReturnValue(true);
+      mockReadFileSync.mockReturnValue(
+        JSON.stringify({
+          claudeAiOauth: {
+            accessToken: 'test-access-token',
+          },
+        }),
+      );
+
+      mockFetch.mockResolvedValueOnce({
+        ok: true,
+        json: jest.fn().mockResolvedValue({
+          five_hour: {
+            utilization: 10.0,
+            resets_at: '2026-01-12T10:00:00Z',
+          },
+          seven_day: {
+            utilization: 20.0,
+            resets_at: '2026-01-15T00:00:00Z',
+          },
+          seven_day_opus: {
+            utilization: 30.0,
+            resets_at: '2026-01-16T00:00:00Z',
+          },
+          seven_day_sonnet: {
+            utilization: 40.0,
+            resets_at: '2026-01-17T00:00:00Z',
+          },
+        }),
+      });
+
+      repository = new OauthAPIClaudeRepository();
+      const usages = await repository.getUsage();
+
+      expect(usages).toHaveLength(4);
+      expect(usages[2]).toEqual({
+        hour: 168,
+        utilizationPercentage: 30.0,
+        resetsAt: new Date('2026-01-16T00:00:00Z'),
+      });
+      expect(usages[3]).toEqual({
+        hour: 168,
+        utilizationPercentage: 40.0,
+        resetsAt: new Date('2026-01-17T00:00:00Z'),
+      });
+    });
+
+    it('should throw error when credentials file not found', async () => {
+      mockExistsSync.mockReturnValue(false);
+
+      repository = new OauthAPIClaudeRepository();
+
+      await expect(repository.getUsage()).rejects.toThrow(
+        `Claude credentials file not found at ${credentialsPath}`,
+      );
+    });
+
+    it('should throw error when access token is missing', async () => {
+      mockExistsSync.mockReturnValue(true);
+      mockReadFileSync.mockReturnValue(
+        JSON.stringify({
+          claudeAiOauth: {},
+        }),
+      );
+
+      repository = new OauthAPIClaudeRepository();
+
+      await expect(repository.getUsage()).rejects.toThrow(
+        'No access token found in credentials file',
+      );
+    });
+
+    it('should throw error when credentials file has invalid format', async () => {
+      mockExistsSync.mockReturnValue(true);
+      mockReadFileSync.mockReturnValue('null');
+
+      repository = new OauthAPIClaudeRepository();
+
+      await expect(repository.getUsage()).rejects.toThrow(
+        'Invalid credentials file format',
+      );
+    });
+
+    it('should throw error when API response is not ok', async () => {
+      mockExistsSync.mockReturnValue(true);
+      mockReadFileSync.mockReturnValue(
+        JSON.stringify({
+          claudeAiOauth: {
+            accessToken: 'test-access-token',
+          },
+        }),
+      );
+
+      mockFetch.mockResolvedValueOnce({
+        ok: false,
+        text: jest.fn().mockResolvedValue('API Error'),
+      });
+
+      repository = new OauthAPIClaudeRepository();
+
+      await expect(repository.getUsage()).rejects.toThrow(
+        'Claude API error: API Error',
+      );
+    });
+
+    it('should throw error when API returns error in response', async () => {
+      mockExistsSync.mockReturnValue(true);
+      mockReadFileSync.mockReturnValue(
+        JSON.stringify({
+          claudeAiOauth: {
+            accessToken: 'test-access-token',
+          },
+        }),
+      );
+
+      mockFetch.mockResolvedValueOnce({
+        ok: true,
+        json: jest.fn().mockResolvedValue({
+          error: 'Invalid token',
+        }),
+      });
+
+      repository = new OauthAPIClaudeRepository();
+
+      await expect(repository.getUsage()).rejects.toThrow(
+        'API error: Invalid token',
+      );
+    });
+
+    it('should throw error when API response format is invalid', async () => {
+      mockExistsSync.mockReturnValue(true);
+      mockReadFileSync.mockReturnValue(
+        JSON.stringify({
+          claudeAiOauth: {
+            accessToken: 'test-access-token',
+          },
+        }),
+      );
+
+      mockFetch.mockResolvedValueOnce({
+        ok: true,
+        json: jest.fn().mockResolvedValue(null),
+      });
+
+      repository = new OauthAPIClaudeRepository();
+
+      await expect(repository.getUsage()).rejects.toThrow(
+        'Invalid API response format',
+      );
+    });
+
+    it('should return empty array when no usage data available', async () => {
+      mockExistsSync.mockReturnValue(true);
+      mockReadFileSync.mockReturnValue(
+        JSON.stringify({
+          claudeAiOauth: {
+            accessToken: 'test-access-token',
+          },
+        }),
+      );
+
+      mockFetch.mockResolvedValueOnce({
+        ok: true,
+        json: jest.fn().mockResolvedValue({}),
+      });
+
+      repository = new OauthAPIClaudeRepository();
+      const usages = await repository.getUsage();
+
+      expect(usages).toHaveLength(0);
+    });
+
+    it('should handle missing resets_at by using current date', async () => {
+      mockExistsSync.mockReturnValue(true);
+      mockReadFileSync.mockReturnValue(
+        JSON.stringify({
+          claudeAiOauth: {
+            accessToken: 'test-access-token',
+          },
+        }),
+      );
+
+      const beforeTest = new Date();
+
+      mockFetch.mockResolvedValueOnce({
+        ok: true,
+        json: jest.fn().mockResolvedValue({
+          five_hour: {
+            utilization: 25.5,
+          },
+        }),
+      });
+
+      repository = new OauthAPIClaudeRepository();
+      const usages = await repository.getUsage();
+
+      const afterTest = new Date();
+
+      expect(usages).toHaveLength(1);
+      expect(usages[0].hour).toBe(5);
+      expect(usages[0].utilizationPercentage).toBe(25.5);
+      expect(usages[0].resetsAt.getTime()).toBeGreaterThanOrEqual(
+        beforeTest.getTime(),
+      );
+      expect(usages[0].resetsAt.getTime()).toBeLessThanOrEqual(
+        afterTest.getTime(),
+      );
+    });
+
+    it('should handle missing resets_at for all window types', async () => {
+      mockExistsSync.mockReturnValue(true);
+      mockReadFileSync.mockReturnValue(
+        JSON.stringify({
+          claudeAiOauth: {
+            accessToken: 'test-access-token',
+          },
+        }),
+      );
+
+      const beforeTest = new Date();
+
+      mockFetch.mockResolvedValueOnce({
+        ok: true,
+        json: jest.fn().mockResolvedValue({
+          five_hour: {
+            utilization: 10.0,
+          },
+          seven_day: {
+            utilization: 20.0,
+          },
+          seven_day_opus: {
+            utilization: 30.0,
+          },
+          seven_day_sonnet: {
+            utilization: 40.0,
+          },
+        }),
+      });
+
+      repository = new OauthAPIClaudeRepository();
+      const usages = await repository.getUsage();
+
+      const afterTest = new Date();
+
+      expect(usages).toHaveLength(4);
+
+      for (const usage of usages) {
+        expect(usage.resetsAt.getTime()).toBeGreaterThanOrEqual(
+          beforeTest.getTime(),
+        );
+        expect(usage.resetsAt.getTime()).toBeLessThanOrEqual(
+          afterTest.getTime(),
+        );
+      }
+    });
+  });
+});

package/src/adapter/repositories/OauthAPIClaudeRepository.ts

@@ -0,0 +1,143 @@
+import { ClaudeRepository } from '../../domain/usecases/adapter-interfaces/ClaudeRepository';
+import { ClaudeWindowUsage } from '../../domain/entities/ClaudeWindowUsage';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+
+type CredentialsFile = {
+  claudeAiOauth?: {
+    accessToken?: string;
+  };
+};
+
+type UsageWindow = {
+  utilization?: number;
+  resets_at?: string;
+};
+
+type UsageResponse = {
+  five_hour?: UsageWindow;
+  seven_day?: UsageWindow;
+  seven_day_opus?: UsageWindow;
+  seven_day_sonnet?: UsageWindow;
+  error?: string;
+};
+
+const isCredentialsFile = (value: unknown): value is CredentialsFile => {
+  if (typeof value !== 'object' || value === null) return false;
+  return true;
+};
+
+const isUsageResponse = (value: unknown): value is UsageResponse => {
+  if (typeof value !== 'object' || value === null) return false;
+  return true;
+};
+
+export class OauthAPIClaudeRepository implements ClaudeRepository {
+  private readonly credentialsPath: string;
+
+  constructor() {
+    this.credentialsPath = path.join(
+      os.homedir(),
+      '.claude',
+      '.credentials.json',
+    );
+  }
+
+  private getAccessToken(): string {
+    if (!fs.existsSync(this.credentialsPath)) {
+      throw new Error(
+        `Claude credentials file not found at ${this.credentialsPath}. Please login to Claude Code first using: claude login`,
+      );
+    }
+
+    const fileContent = fs.readFileSync(this.credentialsPath, 'utf-8');
+    const credentials: unknown = JSON.parse(fileContent);
+
+    if (!isCredentialsFile(credentials)) {
+      throw new Error('Invalid credentials file format');
+    }
+
+    const accessToken = credentials.claudeAiOauth?.accessToken;
+
+    if (!accessToken) {
+      throw new Error('No access token found in credentials file');
+    }
+
+    return accessToken;
+  }
+
+  async getUsage(): Promise<ClaudeWindowUsage[]> {
+    const accessToken = this.getAccessToken();
+
+    const response = await fetch('https://api.anthropic.com/api/oauth/usage', {
+      method: 'GET',
+      headers: {
+        Accept: 'application/json, text/plain, */*',
+        'Content-Type': 'application/json',
+        'User-Agent': 'claude-code/2.0.32',
+        Authorization: `Bearer ${accessToken}`,
+        'anthropic-beta': 'oauth-2025-04-20',
+      },
+    });
+
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(`Claude API error: ${errorText}`);
+    }
+
+    const responseData: unknown = await response.json();
+
+    if (!isUsageResponse(responseData)) {
+      throw new Error('Invalid API response format');
+    }
+
+    if (responseData.error) {
+      throw new Error(`API error: ${responseData.error}`);
+    }
+
+    const usages: ClaudeWindowUsage[] = [];
+
+    if (responseData.five_hour?.utilization !== undefined) {
+      usages.push({
+        hour: 5,
+        utilizationPercentage: responseData.five_hour.utilization,
+        resetsAt: responseData.five_hour.resets_at
+          ? new Date(responseData.five_hour.resets_at)
+          : new Date(),
+      });
+    }
+
+    if (responseData.seven_day?.utilization !== undefined) {
+      usages.push({
+        hour: 168,
+        utilizationPercentage: responseData.seven_day.utilization,
+        resetsAt: responseData.seven_day.resets_at
+          ? new Date(responseData.seven_day.resets_at)
+          : new Date(),
+      });
+    }
+
+    if (responseData.seven_day_opus?.utilization !== undefined) {
+      usages.push({
+        hour: 168,
+        utilizationPercentage: responseData.seven_day_opus.utilization,
+        resetsAt: responseData.seven_day_opus.resets_at
+          ? new Date(responseData.seven_day_opus.resets_at)
+          : new Date(),
+      });
+    }
+
+    if (responseData.seven_day_sonnet?.utilization !== undefined) {
+      usages.push({
+        hour: 168,
+        utilizationPercentage: responseData.seven_day_sonnet.utilization,
+        resetsAt: responseData.seven_day_sonnet.resets_at
+          ? new Date(responseData.seven_day_sonnet.resets_at)
+          : new Date(),
+      });
+    }
+
+    return usages;
+  }
+}

package/src/domain/entities/ClaudeWindowUsage.ts

@@ -0,0 +1,5 @@
+export type ClaudeWindowUsage = {
+  hour: number;
+  utilizationPercentage: number;
+  resetsAt: Date;
+};

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

@@ -67,7 +67,7 @@ describe('StartPreparationUseCase', () => {
     expect(mockIssueRepository.update.mock.calls[0][1]).toBe(mockProject);
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
     expect(mockLocalCommandRunner.runCommand.mock.calls[0][0]).toBe(
-      'aw https://github.com/user/repo url1 impl',
+      'aw url1 impl https://github.com/user/repo',
     );
   });
   it('should assign workspace to awaiting issues', async () => {
@@ -100,18 +100,13 @@ describe('StartPreparationUseCase', () => {
       preparationStatus: 'Preparation',
       defaultAgentName: 'agent1',
     });
-    expect(mockIssueRepository.update.mock.calls).toHaveLength(2);
+    expect(mockIssueRepository.update.mock.calls).toHaveLength(1);
     expect(mockIssueRepository.update.mock.calls[0][0]).toMatchObject({
-      id: '1',
-      status: 'Preparation',
-    });
-    expect(mockIssueRepository.update.mock.calls[0][1]).toBe(mockProject);
-    expect(mockIssueRepository.update.mock.calls[1][0]).toMatchObject({
       id: '2',
       status: 'Preparation',
     });
-    expect(mockIssueRepository.update.mock.calls[1][1]).toBe(mockProject);
-    expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(2);
+    expect(mockIssueRepository.update.mock.calls[0][1]).toBe(mockProject);
+    expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
   });
   it('should not assign workspace if maximum preparing issues reached', async () => {
     const preparationIssues: Issue[] = Array.from({ length: 6 }, (_, i) => ({
@@ -147,4 +142,45 @@ describe('StartPreparationUseCase', () => {
     expect(issue7UpdateCalls).toHaveLength(0);
     expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(0);
   });
+  it('should handle defensive break when pop returns undefined', async () => {
+    const awaitingIssue: Issue = {
+      id: '1',
+      url: 'url1',
+      title: 'Issue 1',
+      labels: [],
+      status: 'Awaiting Workspace',
+    };
+    let popCallCount = 0;
+    const issuesWithMockedPop: Issue[] = [awaitingIssue, awaitingIssue];
+    const mockedPop = jest.fn((): Issue | undefined => {
+      popCallCount++;
+      if (popCallCount === 1) {
+        return awaitingIssue;
+      }
+      return undefined;
+    });
+    Object.defineProperty(issuesWithMockedPop, 'pop', { value: mockedPop });
+    Object.defineProperty(issuesWithMockedPop, 'filter', {
+      value: () => issuesWithMockedPop,
+    });
+    const allIssues: Issue[] = [];
+    Object.defineProperty(allIssues, 'filter', {
+      value: jest.fn(() => issuesWithMockedPop),
+    });
+    mockProjectRepository.getByUrl.mockResolvedValue(mockProject);
+    mockIssueRepository.getAllOpened.mockResolvedValueOnce(allIssues);
+    mockLocalCommandRunner.runCommand.mockResolvedValue({
+      stdout: '',
+      stderr: '',
+      exitCode: 0,
+    });
+    await useCase.run({
+      projectUrl: 'https://github.com/user/repo',
+      awaitingWorkspaceStatus: 'Awaiting Workspace',
+      preparationStatus: 'Preparation',
+      defaultAgentName: 'agent1',
+    });
+    expect(mockIssueRepository.update.mock.calls).toHaveLength(1);
+    expect(mockLocalCommandRunner.runCommand.mock.calls).toHaveLength(1);
+  });
 });

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

@@ -0,0 +1,5 @@
+import { ClaudeWindowUsage } from '../../entities/ClaudeWindowUsage';
+
+export interface ClaudeRepository {
+  getUsage(): Promise<ClaudeWindowUsage[]>;
+}

package/types/adapter/repositories/OauthAPIClaudeRepository.d.ts

@@ -0,0 +1,9 @@
+import { ClaudeRepository } from '../../domain/usecases/adapter-interfaces/ClaudeRepository';
+import { ClaudeWindowUsage } from '../../domain/entities/ClaudeWindowUsage';
+export declare class OauthAPIClaudeRepository implements ClaudeRepository {
+    private readonly credentialsPath;
+    constructor();
+    private getAccessToken;
+    getUsage(): Promise<ClaudeWindowUsage[]>;
+}
+//# sourceMappingURL=OauthAPIClaudeRepository.d.ts.map

package/types/adapter/repositories/OauthAPIClaudeRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OauthAPIClaudeRepository.d.ts","sourceRoot":"","sources":["../../../src/adapter/repositories/OauthAPIClaudeRepository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,2DAA2D,CAAC;AAC7F,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAkC5E,qBAAa,wBAAyB,YAAW,gBAAgB;IAC/D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;;IAUzC,OAAO,CAAC,cAAc;IAuBhB,QAAQ,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;CAyE/C"}

package/types/domain/entities/ClaudeWindowUsage.d.ts

@@ -0,0 +1,6 @@
+export type ClaudeWindowUsage = {
+    hour: number;
+    utilizationPercentage: number;
+    resetsAt: Date;
+};
+//# sourceMappingURL=ClaudeWindowUsage.d.ts.map

package/types/domain/entities/ClaudeWindowUsage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClaudeWindowUsage.d.ts","sourceRoot":"","sources":["../../../src/domain/entities/ClaudeWindowUsage.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB,EAAE,MAAM,CAAC;IAC9B,QAAQ,EAAE,IAAI,CAAC;CAChB,CAAC"}

package/types/domain/usecases/adapter-interfaces/ClaudeRepository.d.ts

@@ -0,0 +1,5 @@
+import { ClaudeWindowUsage } from '../../entities/ClaudeWindowUsage';
+export interface ClaudeRepository {
+    getUsage(): Promise<ClaudeWindowUsage[]>;
+}
+//# sourceMappingURL=ClaudeRepository.d.ts.map

package/types/domain/usecases/adapter-interfaces/ClaudeRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClaudeRepository.d.ts","sourceRoot":"","sources":["../../../../src/domain/usecases/adapter-interfaces/ClaudeRepository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAErE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;CAC1C"}