gitforest 0.1.0 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (183) hide show
  1. package/LICENSE +21 -0
  2. package/package.json +24 -4
  3. package/src/github/auth.ts +3 -3
  4. package/src/utils/debug.ts +4 -4
  5. package/.bunignore +0 -7
  6. package/.github/workflows/ci.yml +0 -73
  7. package/CLAUDE.md +0 -111
  8. package/CONTRIBUTING.md +0 -145
  9. package/bun.lock +0 -267
  10. package/bunfig.toml +0 -15
  11. package/cli +0 -0
  12. package/docs/ai/IMPROVEMENT_PLAN.md +0 -341
  13. package/docs/ai/VERIFICATION_REPORT.md +0 -87
  14. package/docs/ai/architecture.md +0 -169
  15. package/docs/ai/checks/check-2025-12-02-tests.md +0 -40
  16. package/docs/ai/checks/check-2025-12-02.md +0 -55
  17. package/docs/ai/checks/test-verification-report.md +0 -85
  18. package/docs/ai/implementation-guide.md +0 -776
  19. package/docs/ai/research/gitty-codebase-analysis.md +0 -221
  20. package/docs/ai/tickets/GENERAL-sitrep.md +0 -30
  21. package/docs/ai/tickets/TASK-database-tests-sitrep.md +0 -25
  22. package/docs/ai/tickets/TASK-deprecated-functions-sitrep.md +0 -28
  23. package/docs/ai/tickets/TASK-detail-modal-sitrep.md +0 -28
  24. package/docs/ai/tickets/TASK-filter-overlay-sitrep.md +0 -24
  25. package/docs/ai/tickets/TASK-github-service-sitrep.md +0 -32
  26. package/docs/ai/tickets/TASK-github-token-sitrep.md +0 -51
  27. package/docs/ai/tickets/TASK-hascommits-sitrep.md +0 -35
  28. package/docs/ai/tickets/TASK-keybindings-sitrep.md +0 -26
  29. package/docs/ai/tickets/TASK-layout-sitrep.md +0 -25
  30. package/docs/ai/tickets/TASK-markdown-sitrep.md +0 -28
  31. package/docs/ai/tickets/TASK-project-item-sitrep.md +0 -79
  32. package/docs/ai/tickets/TASK-sitrep.md +0 -28
  33. package/docs/ai/tickets/TASK-state-sitrep.md +0 -26
  34. package/docs/ai/tickets/TASK-types-sitrep.md +0 -25
  35. package/docs/ai/tickets/TASK-unified-item-fix-sitrep.md +0 -26
  36. package/docs/ai/tickets/TKT-001-sitrep.md +0 -24
  37. package/docs/ai/tickets/TKT-002-sitrep.md +0 -25
  38. package/docs/ai/tickets/TKT-003-git-service-refactoring-complete.md +0 -46
  39. package/docs/ai/tickets/TKT-003-git-service-refactoring-plan.md +0 -135
  40. package/docs/ai/tickets/TKT-003-sitrep.md +0 -26
  41. package/docs/ai/tickets/TKT-004-sitrep.md +0 -27
  42. package/docs/ai/tickets/TKT-005-sitrep.md +0 -25
  43. package/docs/ai/tickets/TKT-006-sitrep.md +0 -26
  44. package/docs/ai/tickets/TKT-007-sitrep.md +0 -30
  45. package/docs/ai/tickets/TKT-008-sitrep.md +0 -32
  46. package/docs/ai/tickets/TKT-009-sitrep.md +0 -27
  47. package/docs/ai/tickets/TKT-010-sitrep.md +0 -27
  48. package/docs/ai/tickets/TKT-011-sitrep.md +0 -26
  49. package/docs/ai/tickets/TKT-012-sitrep.md +0 -25
  50. package/docs/ai/tickets/sitreps/TASK-actions-sitrep.md +0 -28
  51. package/docs/ai/tickets/sitreps/TASK-actions-test-sitrep.md +0 -25
  52. package/docs/ai/tickets/sitreps/TASK-app-integration-sitrep.md +0 -25
  53. package/docs/ai/tickets/sitreps/TASK-background-fetch-sitrep.md +0 -24
  54. package/docs/ai/tickets/sitreps/TASK-background-fetch-test-sitrep.md +0 -29
  55. package/docs/ai/tickets/sitreps/TASK-batch-tests-sitrep.md +0 -29
  56. package/docs/ai/tickets/sitreps/TASK-bun-test-sitrep.md +0 -26
  57. package/docs/ai/tickets/sitreps/TASK-cache-tests-sitrep.md +0 -30
  58. package/docs/ai/tickets/sitreps/TASK-cli-tests-sitrep.md +0 -28
  59. package/docs/ai/tickets/sitreps/TASK-clone-error-handling-sitrep.md +0 -26
  60. package/docs/ai/tickets/sitreps/TASK-commands-tests-sitrep.md +0 -25
  61. package/docs/ai/tickets/sitreps/TASK-component-tests-1-sitrep.md +0 -30
  62. package/docs/ai/tickets/sitreps/TASK-configloader-tests-sitrep.md +0 -25
  63. package/docs/ai/tickets/sitreps/TASK-confirm-dialog-test-sitrep.md +0 -29
  64. package/docs/ai/tickets/sitreps/TASK-coverage-sitrep.md +0 -95
  65. package/docs/ai/tickets/sitreps/TASK-database-tests-summary.md +0 -61
  66. package/docs/ai/tickets/sitreps/TASK-error-boundary-sitrep.md +0 -30
  67. package/docs/ai/tickets/sitreps/TASK-error-tests-sitrep.md +0 -27
  68. package/docs/ai/tickets/sitreps/TASK-errors-tests-sitrep.md +0 -25
  69. package/docs/ai/tickets/sitreps/TASK-extract-reducer-sitrep.md +0 -27
  70. package/docs/ai/tickets/sitreps/TASK-filter-overlay-test-sitrep.md +0 -25
  71. package/docs/ai/tickets/sitreps/TASK-final-verification-sitrep.md +0 -28
  72. package/docs/ai/tickets/sitreps/TASK-fix-all-tests-sitrep.md +0 -25
  73. package/docs/ai/tickets/sitreps/TASK-fix-hooks-sitrep.md +0 -26
  74. package/docs/ai/tickets/sitreps/TASK-fix-remaining-tests-sitrep.md +0 -25
  75. package/docs/ai/tickets/sitreps/TASK-fix-test-failures-sitrep.md +0 -26
  76. package/docs/ai/tickets/sitreps/TASK-fix-tests-sitrep.md +0 -24
  77. package/docs/ai/tickets/sitreps/TASK-formatters-tests-sitrep.md +0 -25
  78. package/docs/ai/tickets/sitreps/TASK-git-timeouts-sitrep.md +0 -29
  79. package/docs/ai/tickets/sitreps/TASK-github-cache-test-sitrep.md +0 -25
  80. package/docs/ai/tickets/sitreps/TASK-githubcli-tests-sitrep.md +0 -24
  81. package/docs/ai/tickets/sitreps/TASK-gitstatus-tests-sitrep.md +0 -24
  82. package/docs/ai/tickets/sitreps/TASK-hooks-isolation-sitrep.md +0 -27
  83. package/docs/ai/tickets/sitreps/TASK-keybindings-tests-sitrep.md +0 -25
  84. package/docs/ai/tickets/sitreps/TASK-layout-tests-sitrep.md +0 -25
  85. package/docs/ai/tickets/sitreps/TASK-mock-factories-sitrep.md +0 -27
  86. package/docs/ai/tickets/sitreps/TASK-modal-tests-sitrep.md +0 -32
  87. package/docs/ai/tickets/sitreps/TASK-processbatch-fix-sitrep.md +0 -27
  88. package/docs/ai/tickets/sitreps/TASK-projectlist-tests-sitrep.md +0 -30
  89. package/docs/ai/tickets/sitreps/TASK-projectutils-tests-sitrep.md +0 -25
  90. package/docs/ai/tickets/sitreps/TASK-scanner-tests-sitrep.md +0 -29
  91. package/docs/ai/tickets/sitreps/TASK-select-all-sitrep.md +0 -25
  92. package/docs/ai/tickets/sitreps/TASK-shell-error-handling-sitrep.md +0 -27
  93. package/docs/ai/tickets/sitreps/TASK-store-tests-sitrep.md +0 -25
  94. package/docs/ai/tickets/sitreps/TASK-test-fixes-sitrep.md +0 -26
  95. package/docs/ai/tickets/sitreps/TASK-test-summary-sitrep.md +0 -25
  96. package/docs/ai/tickets/sitreps/TASK-test-verification-sitrep.md +0 -27
  97. package/docs/ai/tickets/sitreps/TASK-testsuite-sitrep.md +0 -75
  98. package/docs/ai/tickets/sitreps/TASK-unified-reducer-tests-sitrep.md +0 -29
  99. package/docs/ai/tickets/sitreps/TASK-unified-repos-test-sitrep.md +0 -29
  100. package/docs/ai/tickets/sitreps/TASK-unified-tests-sitrep.md +0 -25
  101. package/docs/ai/tickets/sitreps/TASK-useprojects-tests-sitrep.md +0 -25
  102. package/docs/ai/tickets/sitreps/TASK-utility-tests-sitrep.md +0 -32
  103. package/docs/ai/tickets/sitreps/TKT-003-git-service-refactoring-sitrep.md +0 -64
  104. package/docs/ai/tkt-001-fix-database-error.md +0 -217
  105. package/docs/ai/ui-enhancement-plan.md +0 -562
  106. package/test/integration/app.isolated.tsx +0 -240
  107. package/test/integration/cli-commands.test.ts +0 -287
  108. package/test/integration/cli-validation.test.ts +0 -264
  109. package/test/integration/git-operations.test.ts +0 -218
  110. package/test/integration/scanner.test.ts +0 -228
  111. package/test/preload.ts +0 -18
  112. package/test/unit/cli/commands.test.ts +0 -13
  113. package/test/unit/cli/formatters.test.ts +0 -1116
  114. package/test/unit/cli/github-commands.test.ts +0 -12
  115. package/test/unit/components/CloneDialog.test.tsx +0 -240
  116. package/test/unit/components/ColumnHeader.test.tsx +0 -128
  117. package/test/unit/components/CommandPalette.test.tsx +0 -355
  118. package/test/unit/components/ConfirmDialog.test.tsx +0 -111
  119. package/test/unit/components/ErrorBoundary.test.tsx +0 -139
  120. package/test/unit/components/FilterBar.test.tsx +0 -43
  121. package/test/unit/components/FilterOptionsOverlay.test.tsx +0 -197
  122. package/test/unit/components/HelpOverlay.test.tsx +0 -90
  123. package/test/unit/components/Layout.test.tsx +0 -328
  124. package/test/unit/components/MarkdownRenderer.test.tsx +0 -45
  125. package/test/unit/components/ProgressBar.test.tsx +0 -138
  126. package/test/unit/components/ProjectItem.test.tsx +0 -182
  127. package/test/unit/components/ProjectList.test.tsx +0 -311
  128. package/test/unit/components/RepoDetailModal.test.tsx +0 -445
  129. package/test/unit/components/StatusBar.test.tsx +0 -112
  130. package/test/unit/components/UnifiedProjectItem.test.tsx +0 -618
  131. package/test/unit/components/ViewModeIndicator.test.tsx +0 -137
  132. package/test/unit/components/test-utils.tsx +0 -63
  133. package/test/unit/config/loader.test.ts +0 -692
  134. package/test/unit/db/database.test.ts +0 -978
  135. package/test/unit/db/index.test.ts +0 -314
  136. package/test/unit/fixtures/setup.ts +0 -186
  137. package/test/unit/git/commands-untested.test.ts +0 -205
  138. package/test/unit/git/commands.test.ts +0 -269
  139. package/test/unit/git/operations.test.ts +0 -322
  140. package/test/unit/git/status.test.ts +0 -219
  141. package/test/unit/github/auth.test.ts +0 -317
  142. package/test/unit/github/cache.test.ts +0 -1028
  143. package/test/unit/github/cli.test.ts +0 -135
  144. package/test/unit/github/unified.test.ts +0 -1201
  145. package/test/unit/graceful-shutdown.test.ts +0 -83
  146. package/test/unit/hooks/useBackgroundFetch.test.tsx +0 -239
  147. package/test/unit/hooks/useConfirmDialogActions.test.tsx +0 -81
  148. package/test/unit/hooks/useKeyBindings.isolated.ts +0 -715
  149. package/test/unit/hooks/useProjects.test.tsx +0 -186
  150. package/test/unit/hooks/useUnifiedRepos-simple.test.tsx +0 -115
  151. package/test/unit/hooks/useUnifiedRepos.test.tsx +0 -177
  152. package/test/unit/mocks/config.ts +0 -109
  153. package/test/unit/mocks/git-service.ts +0 -274
  154. package/test/unit/mocks/github-service.ts +0 -250
  155. package/test/unit/mocks/index.ts +0 -72
  156. package/test/unit/mocks/project.ts +0 -148
  157. package/test/unit/mocks/state-mocks.ts +0 -187
  158. package/test/unit/mocks/unified.ts +0 -169
  159. package/test/unit/operations/batch.test.ts +0 -216
  160. package/test/unit/operations/commands.test.ts +0 -550
  161. package/test/unit/scanner/errors.test.ts +0 -297
  162. package/test/unit/scanner/index.test.ts +0 -1011
  163. package/test/unit/scanner/markers.test.ts +0 -150
  164. package/test/unit/scanner/submodules.test.ts +0 -99
  165. package/test/unit/services/git-errors.test.ts +0 -190
  166. package/test/unit/services/git.test.ts +0 -442
  167. package/test/unit/services/github-errors.test.ts +0 -293
  168. package/test/unit/services/github.test.ts +0 -200
  169. package/test/unit/state/actions.test.ts +0 -217
  170. package/test/unit/state/reducer.test.ts +0 -745
  171. package/test/unit/state/store.test.tsx +0 -711
  172. package/test/unit/types/commands.test.ts +0 -220
  173. package/test/unit/types/schema.test.ts +0 -179
  174. package/test/unit/utils/array.test.ts +0 -73
  175. package/test/unit/utils/debug.test.ts +0 -23
  176. package/test/unit/utils/errors.test.ts +0 -295
  177. package/test/unit/utils/markdown.test.ts +0 -163
  178. package/test/unit/utils/project-utils.test.ts +0 -756
  179. package/test/unit/utils/rate-limiter.test.ts +0 -256
  180. package/test/unit/utils/retry.test.ts +0 -165
  181. package/test/unit/utils/strip-ansi.ts +0 -13
  182. package/test/unit/utils/timeout.test.ts +0 -93
  183. package/tsconfig.json +0 -29
@@ -1,219 +0,0 @@
1
- /**
2
- * Tests for git status module
3
- */
4
-
5
- import { describe, test, expect, beforeEach, afterEach } from "bun:test";
6
- import { getGitStatus, getQuickStatus, parseGitStatusPorcelain } from "../../../src/git/status.ts";
7
- import { createTempDir, cleanupTempDir, createMockGitRepo } from "../fixtures/setup.ts";
8
- import { writeFile } from "fs/promises";
9
- import { join } from "path";
10
- import { $ } from "bun";
11
-
12
- describe("Git Status", () => {
13
- let tempDir: string;
14
-
15
- beforeEach(() => {
16
- tempDir = createTempDir("git-status");
17
- });
18
-
19
- afterEach(() => {
20
- cleanupTempDir(tempDir);
21
- });
22
-
23
- describe("parseGitStatusPorcelain", () => {
24
- test("parses clean status", () => {
25
- const output = "";
26
-
27
- const result = parseGitStatusPorcelain(output);
28
-
29
- expect(result).toEqual({
30
- modifiedCount: 0,
31
- stagedCount: 0,
32
- untrackedCount: 0,
33
- hasUnstagedChanges: false,
34
- hasStagedChanges: false,
35
- hasUntrackedFiles: false,
36
- });
37
- });
38
-
39
- test("parses modified files", () => {
40
- const output = " M file1.txt\n M file2.txt\n?? file3.txt";
41
-
42
- const result = parseGitStatusPorcelain(output);
43
-
44
- expect(result).toEqual({
45
- modifiedCount: 2,
46
- stagedCount: 0,
47
- untrackedCount: 1,
48
- hasUnstagedChanges: true,
49
- hasStagedChanges: false,
50
- hasUntrackedFiles: true,
51
- });
52
- });
53
-
54
- test("parses staged files", () => {
55
- const output = "A file1.txt\nA file2.txt\n M file3.txt";
56
-
57
- const result = parseGitStatusPorcelain(output);
58
-
59
- expect(result).toEqual({
60
- modifiedCount: 1,
61
- stagedCount: 2,
62
- untrackedCount: 0,
63
- hasUnstagedChanges: true,
64
- hasStagedChanges: true,
65
- hasUntrackedFiles: false,
66
- });
67
- });
68
-
69
- test("handles complex status", () => {
70
- const output = `MM src/app.ts
71
- A src/new.ts
72
- ?? src/temp.txt
73
- D src/old.ts
74
- `;
75
-
76
- const result = parseGitStatusPorcelain(output);
77
-
78
- expect(result).toEqual({
79
- modifiedCount: 2,
80
- stagedCount: 2,
81
- untrackedCount: 1,
82
- hasUnstagedChanges: true,
83
- hasStagedChanges: true,
84
- hasUntrackedFiles: true,
85
- });
86
- });
87
-
88
- test("handles empty lines", () => {
89
- const output = "\n\n\n";
90
-
91
- const result = parseGitStatusPorcelain(output);
92
-
93
- expect(result).toEqual({
94
- modifiedCount: 0,
95
- stagedCount: 0,
96
- untrackedCount: 0,
97
- hasUnstagedChanges: false,
98
- hasStagedChanges: false,
99
- hasUntrackedFiles: false,
100
- });
101
- });
102
- });
103
-
104
- describe("getQuickStatus", () => {
105
- test("returns clean status for clean repo", async () => {
106
- const repoPath = await createMockGitRepo(tempDir, "clean");
107
-
108
- const result = await getQuickStatus(repoPath);
109
-
110
- expect(result.isDirty).toBe(false);
111
- expect(result.hasRemote).toBe(false);
112
- });
113
-
114
- test("detects dirty repo", async () => {
115
- const repoPath = await createMockGitRepo(tempDir, "dirty");
116
-
117
- // Create untracked file
118
- await writeFile(join(repoPath, "untracked.txt"), "content");
119
-
120
- const result = await getQuickStatus(repoPath);
121
-
122
- expect(result.isDirty).toBe(true);
123
- expect(result.hasRemote).toBe(false);
124
- });
125
-
126
- test("handles repo with remote", async () => {
127
- const repoPath = await createMockGitRepo(tempDir, "with-remote");
128
-
129
- // Add a remote
130
- await writeFile(join(repoPath, "test.txt"), "content");
131
-
132
- const result = await getQuickStatus(repoPath);
133
-
134
- expect(result.isDirty).toBe(true);
135
- expect(result.hasRemote).toBe(false); // No actual remote added
136
- });
137
- });
138
-
139
- describe("getGitStatus", () => {
140
- test("returns status for clean repo", async () => {
141
- const repoPath = await createMockGitRepo(tempDir, "clean-status");
142
-
143
- const status = await getGitStatus(repoPath);
144
-
145
- expect(status.hasUnstagedChanges).toBe(false);
146
- expect(status.hasStagedChanges).toBe(false);
147
- expect(status.hasUntrackedFiles).toBe(false);
148
- expect(status.modifiedCount).toBe(0);
149
- expect(status.stagedCount).toBe(0);
150
- expect(status.untrackedCount).toBe(0);
151
- expect(status.currentBranch).toBe("master"); // Git default is master
152
- expect(status.trackingBranch).toBeNull();
153
- expect(status.unpushedCommits).toBe(0);
154
- expect(status.unpulledCommits).toBe(0);
155
- expect(status.hasRemote).toBe(false);
156
- expect(status.remoteUrl).toBeNull();
157
- expect(status.hasCommits).toBe(true);
158
- expect(status.isDirty).toBe(false);
159
- expect(status.isAhead).toBe(false);
160
- expect(status.isBehind).toBe(false);
161
- expect(status.isOutOfSync).toBe(false);
162
- expect(status.lastLocalCommit).toBeInstanceOf(Date);
163
- expect(status.lastRemoteActivity).toBeNull();
164
- });
165
-
166
- test("returns status for dirty repo", async () => {
167
- const repoPath = await createMockGitRepo(tempDir, "dirty-status");
168
-
169
- // Create initial file and commit it
170
- await writeFile(join(repoPath, "base.txt"), "base content");
171
- await $`git -C ${repoPath} add base.txt`.quiet();
172
- await $`git -C ${repoPath} commit -m "Initial commit"`.quiet();
173
-
174
- // Create various changes
175
- await writeFile(join(repoPath, "modified.txt"), "content");
176
- await writeFile(join(repoPath, "staged.txt"), "content");
177
- await writeFile(join(repoPath, "untracked.txt"), "content");
178
-
179
- // Stage one file
180
- await $`git -C ${repoPath} add staged.txt`.quiet();
181
-
182
- const status = await getGitStatus(repoPath);
183
-
184
- expect(status.hasStagedChanges).toBe(true); // staged.txt is staged
185
- expect(status.hasUntrackedFiles).toBe(true); // untracked.txt is untracked
186
- expect(status.stagedCount).toBe(1); // staged.txt
187
- expect(status.untrackedCount).toBe(2); // modified.txt and untracked.txt
188
- expect(status.isDirty).toBe(true);
189
- });
190
-
191
- test("handles repo with tracking branch", async () => {
192
- const repoPath = await createMockGitRepo(tempDir, "tracking-status");
193
-
194
- // Add a remote to simulate tracking
195
- await writeFile(join(repoPath, "test.txt"), "content");
196
-
197
- const status = await getGitStatus(repoPath);
198
-
199
- // Should have tracking branch if remote exists
200
- // Note: This test may need adjustment based on actual git setup
201
- expect(status.currentBranch).toBeTruthy();
202
- expect(status.hasCommits).toBe(true);
203
- expect(status.lastLocalCommit).toBeInstanceOf(Date);
204
- });
205
-
206
- test("handles empty repo", async () => {
207
- // Create empty repo without commits
208
- const emptyRepoPath = join(tempDir, "empty");
209
- await $`mkdir -p ${emptyRepoPath}`.quiet();
210
- await writeFile(join(emptyRepoPath, "test.txt"), "content");
211
-
212
- const status = await getGitStatus(emptyRepoPath);
213
-
214
- // Should handle gracefully
215
- expect(status.currentBranch).toBeTruthy();
216
- expect(status.hasCommits).toBe(false);
217
- });
218
- });
219
- });
@@ -1,317 +0,0 @@
1
- import { describe, test, expect, beforeEach, afterEach } from "bun:test";
2
-
3
- import {
4
- getToken,
5
- setToken,
6
- getTokenAsync,
7
- isAuthenticated,
8
- isAuthenticatedAsync,
9
- isGhInstalled,
10
- logout,
11
- getAuthStatus,
12
- ensureAuthenticated,
13
- } from "../../../src/github/auth.ts";
14
-
15
- describe("GitHub Auth Module", () => {
16
- // Store original env
17
- const originalGithubToken = process.env.GITHUB_TOKEN;
18
- const originalGhToken = process.env.GH_TOKEN;
19
-
20
- beforeEach(() => {
21
- // Clean env
22
- delete process.env.GITHUB_TOKEN;
23
- delete process.env.GH_TOKEN;
24
- process.env.GITTY_IGNORE_GH = "true";
25
- });
26
-
27
- afterEach(() => {
28
- // Restore env
29
- if (originalGithubToken !== undefined) {
30
- process.env.GITHUB_TOKEN = originalGithubToken;
31
- } else {
32
- delete process.env.GITHUB_TOKEN;
33
- }
34
- if (originalGhToken !== undefined) {
35
- process.env.GH_TOKEN = originalGhToken;
36
- } else {
37
- delete process.env.GH_TOKEN;
38
- }
39
- });
40
-
41
- describe("getToken (sync)", () => {
42
- test("returns GITHUB_TOKEN from environment", () => {
43
- process.env.GITHUB_TOKEN = "ghp_test123456789012345678901234567890ab";
44
- expect(getToken()).toBe("ghp_test123456789012345678901234567890ab");
45
- });
46
-
47
- test("treats empty env token as missing", () => {
48
- process.env.GITHUB_TOKEN = "";
49
- expect(getToken()).toBeNull();
50
- });
51
-
52
- test("returns GH_TOKEN from environment if GITHUB_TOKEN not set", () => {
53
- process.env.GH_TOKEN = "ghp_test123456789012345678901234567890cd";
54
- expect(getToken()).toBe("ghp_test123456789012345678901234567890cd");
55
- });
56
-
57
- test("prefers GITHUB_TOKEN over GH_TOKEN", () => {
58
- process.env.GITHUB_TOKEN = "ghp_github_token";
59
- process.env.GH_TOKEN = "ghp_gh_token";
60
- expect(getToken()).toBe("ghp_github_token");
61
- });
62
-
63
- test("returns null when no token in env", () => {
64
- // Synchronous getToken only checks env, not gh CLI
65
- expect(getToken()).toBeNull();
66
- });
67
- });
68
-
69
- describe("setToken", () => {
70
- test("sets GITHUB_TOKEN in environment", () => {
71
- setToken("ghp_my_new_token");
72
- expect(process.env.GITHUB_TOKEN).toBe("ghp_my_new_token");
73
- });
74
-
75
- test("token is retrievable via getToken after setting", () => {
76
- setToken("ghp_set_and_get_token");
77
- expect(getToken()).toBe("ghp_set_and_get_token");
78
- });
79
-
80
- test("overwrites existing token", () => {
81
- process.env.GITHUB_TOKEN = "ghp_old_token";
82
- setToken("ghp_new_token");
83
- expect(getToken()).toBe("ghp_new_token");
84
- });
85
- });
86
-
87
- describe("getTokenAsync", () => {
88
- test("returns GITHUB_TOKEN from environment", async () => {
89
- process.env.GITHUB_TOKEN = "ghp_async_test_token";
90
- const token = await getTokenAsync();
91
- expect(token).toBe("ghp_async_test_token");
92
- });
93
-
94
- test("treats empty env token as missing (async)", async () => {
95
- process.env.GITHUB_TOKEN = "";
96
- const token = await getTokenAsync();
97
- expect(token).toBeNull();
98
- });
99
-
100
- test("returns GH_TOKEN if GITHUB_TOKEN not set", async () => {
101
- process.env.GH_TOKEN = "ghp_async_gh_token";
102
- const token = await getTokenAsync();
103
- expect(token).toBe("ghp_async_gh_token");
104
- });
105
-
106
- test("prefers env token over gh CLI", async () => {
107
- process.env.GITHUB_TOKEN = "ghp_env_token";
108
- const token = await getTokenAsync();
109
- // Should return env token without calling gh CLI
110
- expect(token).toBe("ghp_env_token");
111
- });
112
- });
113
-
114
- describe("isAuthenticated (sync)", () => {
115
- test("returns true when GITHUB_TOKEN is set", () => {
116
- process.env.GITHUB_TOKEN = "ghp_testtoken";
117
- expect(isAuthenticated()).toBe(true);
118
- });
119
-
120
- test("returns true when GH_TOKEN is set", () => {
121
- process.env.GH_TOKEN = "ghp_testtoken";
122
- expect(isAuthenticated()).toBe(true);
123
- });
124
-
125
- test("returns false when no token in env", () => {
126
- expect(isAuthenticated()).toBe(false);
127
- });
128
- });
129
-
130
- describe("isAuthenticatedAsync", () => {
131
- test("returns true when GITHUB_TOKEN is set", async () => {
132
- process.env.GITHUB_TOKEN = "ghp_testtoken";
133
- expect(await isAuthenticatedAsync()).toBe(true);
134
- });
135
-
136
- test("returns true when GH_TOKEN is set", async () => {
137
- process.env.GH_TOKEN = "ghp_testtoken";
138
- expect(await isAuthenticatedAsync()).toBe(true);
139
- });
140
- });
141
-
142
- describe("isGhInstalled", () => {
143
- test("returns boolean", async () => {
144
- const result = await isGhInstalled();
145
- expect(typeof result).toBe("boolean");
146
- });
147
-
148
- // Note: This test depends on whether gh is installed on the test machine
149
- // In CI, gh might not be installed, so we just check it doesn't throw
150
- test("does not throw", async () => {
151
- const result = await isGhInstalled();
152
- expect(typeof result).toBe("boolean");
153
- });
154
- });
155
-
156
- describe("logout", () => {
157
- test("clears GITHUB_TOKEN from environment", async () => {
158
- process.env.GITHUB_TOKEN = "ghp_testtoken";
159
- await logout();
160
- expect(process.env.GITHUB_TOKEN).toBeUndefined();
161
- });
162
-
163
- test("clears GH_TOKEN from environment", async () => {
164
- process.env.GH_TOKEN = "ghp_testtoken";
165
- await logout();
166
- expect(process.env.GH_TOKEN).toBeUndefined();
167
- });
168
-
169
- test("returns success even when not logged in", async () => {
170
- const result = await logout();
171
- expect(result.success).toBe(true);
172
- });
173
- });
174
-
175
- describe("getAuthStatus", () => {
176
- test("returns authenticated: false when no token", async () => {
177
- const status = await getAuthStatus();
178
- // This might return true if gh CLI is logged in on the test machine
179
- // So we just check it returns a valid structure
180
- expect(status).toHaveProperty("authenticated");
181
- expect(typeof status.authenticated).toBe("boolean");
182
- });
183
-
184
- test("returns source: env when using env token", async () => {
185
- // Only test this if we have a valid token that works
186
- const existingToken = originalGithubToken ?? originalGhToken;
187
- if (existingToken) {
188
- process.env.GITHUB_TOKEN = existingToken;
189
- const status = await getAuthStatus();
190
- if (status.authenticated) {
191
- expect(status.source).toBe("env");
192
- }
193
- }
194
- });
195
- });
196
-
197
- describe("ensureAuthenticated", () => {
198
- test("returns token when GITHUB_TOKEN is set", async () => {
199
- process.env.GITHUB_TOKEN = "ghp_ensure_test_token";
200
- const token = await ensureAuthenticated(true); // silent mode
201
- expect(token).toBe("ghp_ensure_test_token");
202
- });
203
-
204
- test("returns null in silent mode when no token", async () => {
205
- const token = await ensureAuthenticated(true);
206
- // Will be null if no env token and gh CLI not logged in
207
- // Just check it doesn't throw
208
- expect(token === null || typeof token === "string").toBe(true);
209
- });
210
- });
211
- });
212
-
213
- describe("Token validation patterns", () => {
214
- // Test the token patterns used in the service
215
- const patterns = [
216
- /^ghp_[a-zA-Z0-9]{36}$/, // Personal access tokens (new)
217
- /^github_pat_[a-zA-Z0-9]{22}_[a-zA-Z0-9]{59}$/, // Fine-grained PATs
218
- /^gho_[a-zA-Z0-9]{35,40}$/, // OAuth tokens (flexible length)
219
- /^ghs_[a-zA-Z0-9]{36}$/, // GitHub App tokens
220
- /^ghr_[a-zA-Z0-9]{36}$/, // Refresh tokens
221
- /^[a-f0-9]{40}$/, // Classic tokens (40 hex chars)
222
- ];
223
-
224
- function validateToken(token: string): boolean {
225
- return patterns.some(pattern => pattern.test(token));
226
- }
227
-
228
- test("validates personal access token (ghp_)", () => {
229
- expect(validateToken("ghp_123456789012345678901234567890123456")).toBe(true);
230
- });
231
-
232
- test("validates fine-grained PAT (github_pat_)", () => {
233
- const fineGrainedPat = "github_pat_" + "a".repeat(22) + "_" + "b".repeat(59);
234
- expect(validateToken(fineGrainedPat)).toBe(true);
235
- });
236
-
237
- test("validates OAuth token (gho_)", () => {
238
- expect(validateToken("gho_12345678901234567890123456789012345")).toBe(true);
239
- expect(validateToken("gho_1234567890123456789012345678901234567890")).toBe(true);
240
- });
241
-
242
- test("validates GitHub App token (ghs_)", () => {
243
- expect(validateToken("ghs_123456789012345678901234567890123456")).toBe(true);
244
- });
245
-
246
- test("validates refresh token (ghr_)", () => {
247
- expect(validateToken("ghr_123456789012345678901234567890123456")).toBe(true);
248
- });
249
-
250
- test("validates classic token (40 hex)", () => {
251
- expect(validateToken("1234567890abcdef1234567890abcdef12345678")).toBe(true);
252
- });
253
-
254
- test("rejects invalid tokens", () => {
255
- expect(validateToken("invalid")).toBe(false);
256
- expect(validateToken("ghp_tooshort")).toBe(false);
257
- expect(validateToken("")).toBe(false);
258
- expect(validateToken("ghp_")).toBe(false);
259
- expect(validateToken("not_a_token_at_all")).toBe(false);
260
- });
261
-
262
- test("rejects tokens with wrong prefix length", () => {
263
- // ghp_ needs exactly 36 chars after prefix
264
- expect(validateToken("ghp_12345")).toBe(false);
265
- expect(validateToken("ghp_" + "a".repeat(35))).toBe(false);
266
- expect(validateToken("ghp_" + "a".repeat(37))).toBe(false);
267
- });
268
- });
269
-
270
- describe("Auth module integration", () => {
271
- const originalGithubToken = process.env.GITHUB_TOKEN;
272
- const originalGhToken = process.env.GH_TOKEN;
273
-
274
- afterEach(() => {
275
- if (originalGithubToken !== undefined) {
276
- process.env.GITHUB_TOKEN = originalGithubToken;
277
- } else {
278
- delete process.env.GITHUB_TOKEN;
279
- }
280
- if (originalGhToken !== undefined) {
281
- process.env.GH_TOKEN = originalGhToken;
282
- } else {
283
- delete process.env.GH_TOKEN;
284
- }
285
- });
286
-
287
- test("full flow: set token, check auth, get token", () => {
288
- delete process.env.GITHUB_TOKEN;
289
- delete process.env.GH_TOKEN;
290
-
291
- // Initially not authenticated (via env)
292
- expect(isAuthenticated()).toBe(false);
293
-
294
- // Set token
295
- setToken("ghp_integration_test_token_123456789012");
296
-
297
- // Now authenticated
298
- expect(isAuthenticated()).toBe(true);
299
-
300
- // Can retrieve token
301
- expect(getToken()).toBe("ghp_integration_test_token_123456789012");
302
- });
303
-
304
- test("async flow: set token, check auth async, get token async", async () => {
305
- delete process.env.GITHUB_TOKEN;
306
- delete process.env.GH_TOKEN;
307
-
308
- // Set token
309
- setToken("ghp_async_integration_test_1234567890");
310
-
311
- // Check async auth
312
- expect(await isAuthenticatedAsync()).toBe(true);
313
-
314
- // Get token async
315
- expect(await getTokenAsync()).toBe("ghp_async_integration_test_1234567890");
316
- });
317
- });