@golba98/codexa 1.0.2 → 1.0.4

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 (206) hide show
  1. package/README.md +396 -100
  2. package/bin/codexa.js +62 -144
  3. package/package.json +14 -8
  4. package/src/app.tsx +596 -306
  5. package/src/commands/handler.ts +6 -6
  6. package/src/config/buildInfo.ts +2 -2
  7. package/src/config/layeredConfig.ts +1 -1
  8. package/src/config/persistence.ts +10 -0
  9. package/src/config/runtimeConfig.ts +1 -1
  10. package/src/config/settings.ts +8 -16
  11. package/src/config/trustStore.ts +1 -1
  12. package/src/config/updateCheckCache.ts +19 -1
  13. package/src/core/README.md +52 -0
  14. package/src/core/agent/loop.ts +282 -0
  15. package/src/core/agent/protocol.ts +211 -0
  16. package/src/core/agent/tools.ts +414 -0
  17. package/src/core/{codexExecArgs.ts → codex/codexExecArgs.ts} +2 -2
  18. package/src/core/{codexLaunch.ts → codex/codexLaunch.ts} +3 -3
  19. package/src/core/{codexPrompt.ts → codex/codexPrompt.ts} +3 -3
  20. package/src/core/debug/modelStateDebug.ts +34 -0
  21. package/src/core/executables/antigravityExecutable.ts +48 -0
  22. package/src/core/executables/codexExecutable.ts +1 -0
  23. package/src/core/executables/executableResolver.ts +65 -43
  24. package/src/core/perf/renderDebug.ts +10 -6
  25. package/src/core/process/processValidation.ts +9 -5
  26. package/src/core/providerLauncher/launcher.ts +59 -42
  27. package/src/core/providerLauncher/registry.ts +30 -14
  28. package/src/core/providerLauncher/types.ts +11 -9
  29. package/src/core/providerLauncher/workspaceConfig.ts +41 -26
  30. package/src/core/providerRuntime/anthropic.ts +7 -1
  31. package/src/core/providerRuntime/antigravity.ts +305 -0
  32. package/src/core/providerRuntime/claudeCodeDiscovery.ts +268 -22
  33. package/src/core/providerRuntime/claudeCodeDiscoveryDebug.ts +55 -0
  34. package/src/core/providerRuntime/contextMetadata.ts +12 -24
  35. package/src/core/providerRuntime/local.ts +129 -51
  36. package/src/core/providerRuntime/models.ts +22 -11
  37. package/src/core/providerRuntime/registry.ts +58 -31
  38. package/src/core/providerRuntime/types.ts +19 -14
  39. package/src/core/providers/codexSubprocess.ts +2 -2
  40. package/src/core/providers/types.ts +1 -1
  41. package/src/core/{attachments.ts → shared/attachments.ts} +27 -4
  42. package/src/core/{cleanupFastFail.ts → shared/cleanupFastFail.ts} +1 -1
  43. package/src/core/{hollowResponseFormat.ts → shared/hollowResponseFormat.ts} +1 -1
  44. package/src/core/terminal/clearFrameBoundary.ts +814 -0
  45. package/src/core/terminal/frameLock.ts +109 -0
  46. package/src/core/terminal/inkRenderReset.ts +123 -0
  47. package/src/core/terminal/terminalControl.ts +22 -0
  48. package/src/core/terminal/terminalTitle.ts +16 -102
  49. package/src/core/version/channel.ts +23 -0
  50. package/src/core/version/updateCheck.ts +193 -0
  51. package/src/core/{launchContext.ts → workspace/launchContext.ts} +32 -39
  52. package/src/core/{planStorage.ts → workspace/planStorage.ts} +2 -2
  53. package/src/core/{workspaceGuard.ts → workspace/workspaceGuard.ts} +97 -13
  54. package/src/headless/execRunner.ts +2 -2
  55. package/src/index.tsx +43 -89
  56. package/src/session/appSession.ts +10 -7
  57. package/src/session/chatLifecycle.ts +1 -1
  58. package/src/session/liveRenderScheduler.ts +1 -1
  59. package/src/session/types.ts +3 -2
  60. package/src/ui/ActionRequiredBlock.tsx +5 -5
  61. package/src/ui/ActivityBars.tsx +3 -3
  62. package/src/ui/ActivityIndicator.tsx +6 -6
  63. package/src/ui/AgentBlock.tsx +6 -6
  64. package/src/ui/AnimatedStatusText.tsx +1 -1
  65. package/src/ui/AppShell.tsx +670 -719
  66. package/src/ui/AttachmentImportPanel.tsx +8 -8
  67. package/src/ui/AuthPanel.tsx +20 -20
  68. package/src/ui/BottomComposer.tsx +158 -118
  69. package/src/ui/DashCard.tsx +3 -3
  70. package/src/ui/Markdown.tsx +17 -17
  71. package/src/ui/ModelPickerScreen.tsx +222 -42
  72. package/src/ui/ModelReasoningPicker.tsx +15 -15
  73. package/src/ui/Panel.tsx +3 -3
  74. package/src/ui/PlanActionPicker.tsx +6 -6
  75. package/src/ui/PlanReviewPanel.tsx +9 -9
  76. package/src/ui/ProviderPicker.tsx +735 -321
  77. package/src/ui/RunFooter.tsx +3 -3
  78. package/src/ui/RuntimeStatusBar.tsx +108 -0
  79. package/src/ui/SelectionPanel.tsx +8 -4
  80. package/src/ui/SettingsPanel.tsx +9 -9
  81. package/src/ui/Spinner.tsx +1 -1
  82. package/src/ui/TextEntryPanel.tsx +11 -11
  83. package/src/ui/ThinkingBlock.tsx +8 -8
  84. package/src/ui/Timeline.tsx +1625 -1472
  85. package/src/ui/TopHeader.tsx +437 -293
  86. package/src/ui/TranscriptShell.tsx +322 -0
  87. package/src/ui/TurnGroup.tsx +33 -33
  88. package/src/ui/UpdateAvailableCard.tsx +41 -0
  89. package/src/ui/UpdatePromptPanel.tsx +197 -0
  90. package/src/ui/focus.ts +3 -0
  91. package/src/ui/layout.ts +299 -25
  92. package/src/ui/layoutListWindow.ts +145 -0
  93. package/src/ui/logoVariants.ts +103 -0
  94. package/src/ui/modeDisplay.ts +12 -12
  95. package/src/ui/runtimeDisplay.ts +112 -0
  96. package/src/ui/textLayout.ts +15 -4
  97. package/src/ui/theme.tsx +274 -395
  98. package/src/ui/timelineMeasure.ts +218 -136
  99. package/scripts/audit-codexa-capabilities.mjs +0 -466
  100. package/scripts/gen-build-info.mjs +0 -33
  101. package/scripts/smoke-terminal-bench.mjs +0 -35
  102. package/src/appRenderStability.test.ts +0 -131
  103. package/src/commands/handler.test.ts +0 -655
  104. package/src/config/launchArgs.test.ts +0 -189
  105. package/src/config/layeredConfig.test.ts +0 -143
  106. package/src/config/persistence.test.ts +0 -114
  107. package/src/config/runtimeConfig.test.ts +0 -218
  108. package/src/config/settings.test.ts +0 -155
  109. package/src/config/trustStore.test.ts +0 -29
  110. package/src/core/attachments.test.ts +0 -155
  111. package/src/core/auth/codexAuth.test.ts +0 -68
  112. package/src/core/cleanupFastFail.test.ts +0 -76
  113. package/src/core/codex.ts +0 -124
  114. package/src/core/codexExecArgs.test.ts +0 -195
  115. package/src/core/codexLaunch.test.ts +0 -205
  116. package/src/core/codexPrompt.test.ts +0 -252
  117. package/src/core/executables/codexExecutable.test.ts +0 -212
  118. package/src/core/executables/executableResolver.test.ts +0 -129
  119. package/src/core/executables/geminiExecutable.test.ts +0 -116
  120. package/src/core/executables/pathSanityScan.test.ts +0 -47
  121. package/src/core/githubDiagnostics.test.ts +0 -92
  122. package/src/core/hollowResponseFormat.test.ts +0 -58
  123. package/src/core/launchContext.test.ts +0 -157
  124. package/src/core/models/codexCapabilities.test.ts +0 -45
  125. package/src/core/models/codexModelCapabilities.test.ts +0 -246
  126. package/src/core/models/modelSpecs.test.ts +0 -283
  127. package/src/core/perf/renderDebug.test.ts +0 -230
  128. package/src/core/planStorage.test.ts +0 -143
  129. package/src/core/process/CommandRunner.test.ts +0 -105
  130. package/src/core/projectInstructions.test.ts +0 -50
  131. package/src/core/providerLauncher/launcher.test.ts +0 -238
  132. package/src/core/providerLauncher/registry.test.ts +0 -324
  133. package/src/core/providerLauncher/workspaceConfig.test.ts +0 -638
  134. package/src/core/providerRuntime/anthropic.test.ts +0 -1120
  135. package/src/core/providerRuntime/capabilityProfile.test.ts +0 -311
  136. package/src/core/providerRuntime/contextMetadata.test.ts +0 -468
  137. package/src/core/providerRuntime/gemini.test.ts +0 -437
  138. package/src/core/providerRuntime/lmstudio.test.ts +0 -168
  139. package/src/core/providerRuntime/local.test.ts +0 -787
  140. package/src/core/providerRuntime/registry.test.ts +0 -233
  141. package/src/core/providers/codexJsonStream.test.ts +0 -148
  142. package/src/core/providers/codexSubprocess.test.ts +0 -68
  143. package/src/core/providers/codexTranscript.test.ts +0 -284
  144. package/src/core/terminal/startupClear.test.ts +0 -55
  145. package/src/core/terminal/terminalCapabilities.test.ts +0 -93
  146. package/src/core/terminal/terminalControl.test.ts +0 -75
  147. package/src/core/terminal/terminalSanitize.test.ts +0 -22
  148. package/src/core/terminal/terminalSelection.test.ts +0 -42
  149. package/src/core/terminal/terminalTitle.test.ts +0 -328
  150. package/src/core/updateCheck.test.ts +0 -194
  151. package/src/core/updateCheck.ts +0 -172
  152. package/src/core/workspaceActivity.test.ts +0 -163
  153. package/src/core/workspaceGuard.test.ts +0 -151
  154. package/src/core/workspaceRoot.test.ts +0 -23
  155. package/src/exec.test.ts +0 -13
  156. package/src/headless/execArgs.test.ts +0 -147
  157. package/src/headless/execRunner.test.ts +0 -436
  158. package/src/index.test.tsx +0 -620
  159. package/src/session/appSession.test.ts +0 -897
  160. package/src/session/chatLifecycle.test.ts +0 -64
  161. package/src/session/liveRenderScheduler.test.ts +0 -201
  162. package/src/session/planFlow.test.ts +0 -103
  163. package/src/session/planTranscript.test.ts +0 -65
  164. package/src/session/promptRunSchedule.test.ts +0 -36
  165. package/src/ui/ActivityIndicator.test.tsx +0 -58
  166. package/src/ui/AgentBlock.test.ts +0 -6
  167. package/src/ui/AnimatedStatusText.test.ts +0 -16
  168. package/src/ui/AppShell.test.tsx +0 -1776
  169. package/src/ui/AttachmentImportPanel.test.tsx +0 -204
  170. package/src/ui/BottomComposer.test.ts +0 -674
  171. package/src/ui/CodexLogo.tsx +0 -55
  172. package/src/ui/Markdown.test.ts +0 -157
  173. package/src/ui/ModelPickerProviderScope.test.tsx +0 -411
  174. package/src/ui/ModelPickerScreen.test.tsx +0 -99
  175. package/src/ui/ModelPickerState.test.tsx +0 -151
  176. package/src/ui/ModelReasoningPicker.test.tsx +0 -447
  177. package/src/ui/PlanReviewPanel.test.tsx +0 -267
  178. package/src/ui/PromptCardBorder.test.tsx +0 -161
  179. package/src/ui/ProviderPicker.test.tsx +0 -289
  180. package/src/ui/ProviderShortcut.test.tsx +0 -143
  181. package/src/ui/SettingsPanel.test.tsx +0 -233
  182. package/src/ui/StaticTranscriptItem.tsx +0 -56
  183. package/src/ui/Timeline.test.ts +0 -2067
  184. package/src/ui/TimelineNavigation.test.tsx +0 -201
  185. package/src/ui/TopHeader.test.tsx +0 -254
  186. package/src/ui/TurnGroup.test.tsx +0 -365
  187. package/src/ui/busyStatusAnimation.test.ts +0 -30
  188. package/src/ui/commandNormalize.test.ts +0 -142
  189. package/src/ui/diffRenderer.test.ts +0 -102
  190. package/src/ui/focusFlow.test.tsx +0 -1098
  191. package/src/ui/inputBuffer.test.ts +0 -151
  192. package/src/ui/layout.test.ts +0 -146
  193. package/src/ui/modeDisplay.test.ts +0 -42
  194. package/src/ui/runActivityView.test.ts +0 -89
  195. package/src/ui/runLifecycleView.test.tsx +0 -237
  196. package/src/ui/statusRenderIsolation.test.tsx +0 -654
  197. package/src/ui/terminalAnswerFormat.test.ts +0 -19
  198. package/src/ui/textLayout.test.ts +0 -18
  199. package/src/ui/themeFlow.test.ts +0 -53
  200. package/src/ui/timelineMeasureCache.test.ts +0 -986
  201. /package/src/core/{inputDebug.ts → debug/inputDebug.ts} +0 -0
  202. /package/src/core/{clipboard.ts → shared/clipboard.ts} +0 -0
  203. /package/src/core/{githubDiagnostics.ts → shared/githubDiagnostics.ts} +0 -0
  204. /package/src/core/{projectInstructions.ts → workspace/projectInstructions.ts} +0 -0
  205. /package/src/core/{workspaceActivity.ts → workspace/workspaceActivity.ts} +0 -0
  206. /package/src/core/{workspaceRoot.ts → workspace/workspaceRoot.ts} +0 -0
@@ -1,620 +0,0 @@
1
- import assert from "node:assert/strict";
2
- import test from "node:test";
3
- import React from "react";
4
- import { EventEmitter } from "node:events";
5
- import { readFileSync } from "node:fs";
6
- import type { RenderOptions } from "ink";
7
- import { startApp } from "./index.js";
8
-
9
- const TITLE_SEQUENCE_PATTERN = /\x1b\](?:0|2);[^\x07]*(?:\x07|\x1b\\)/g;
10
-
11
- class MockStdout extends EventEmitter {
12
- isTTY = true;
13
- columns = 120;
14
- rows = 40;
15
- writes = "";
16
- clearCalls = 0;
17
-
18
- write(chunk: string): boolean {
19
- this.writes += chunk;
20
- return true;
21
- }
22
- }
23
-
24
- class MockStderr {
25
- writes = "";
26
-
27
- write(chunk: string): boolean {
28
- this.writes += chunk;
29
- return true;
30
- }
31
- }
32
-
33
- function flushMicrotasks(): Promise<void> {
34
- return new Promise((resolve) => setImmediate(resolve));
35
- }
36
-
37
- function createSupportedHarness(options: {
38
- inkInstance?: {
39
- lastOutput: string;
40
- lastOutputToRender: string;
41
- lastOutputHeight: number;
42
- calculateLayoutCalls: number;
43
- onRenderCalls: number;
44
- unsubscribeResizeCalls: number;
45
- throttledLogCancelCalls: number;
46
- rootOnRenderCancelCalls: number;
47
- onRenderCancelCalls: number;
48
- calculateLayout: () => void;
49
- onRender: (() => void) & { cancel: () => void };
50
- unsubscribeResize: () => void;
51
- throttledLog: { cancel: () => void };
52
- rootNode: { onRender: { cancel: () => void } };
53
- } | null;
54
- } = {}) {
55
- const stdout = new MockStdout();
56
- const stderr = new MockStderr();
57
- const registeredHandlers: Array<() => void> = [];
58
- let renderCalls = 0;
59
- let cleanupCalls = 0;
60
- let renderOptions: RenderOptions | undefined;
61
- let resolveExitPromise = () => {};
62
- const waitUntilExitPromise = new Promise<void>((resolve) => {
63
- resolveExitPromise = resolve;
64
- });
65
-
66
- return {
67
- stdout,
68
- stderr,
69
- registeredHandlers,
70
- getCleanupCalls: () => cleanupCalls,
71
- getRenderCalls: () => renderCalls,
72
- getRenderOptions: () => renderOptions,
73
- resolveExit() {
74
- resolveExitPromise();
75
- registeredHandlers[0]?.();
76
- },
77
- deps: {
78
- stdin: { isTTY: true },
79
- stdout,
80
- stderr,
81
- env: {},
82
- platform: "linux" as const,
83
- renderApp(_node: React.ReactElement, options?: RenderOptions) {
84
- renderCalls += 1;
85
- renderOptions = options;
86
- return {
87
- clear() {
88
- stdout.clearCalls += 1;
89
- },
90
- cleanup() {
91
- cleanupCalls += 1;
92
- },
93
- waitUntilExit() {
94
- return waitUntilExitPromise;
95
- },
96
- };
97
- },
98
- registerExitHandler(handler: () => void) {
99
- registeredHandlers.push(handler);
100
- },
101
- resolveInkInstanceForStdout() {
102
- return options.inkInstance ?? null;
103
- },
104
- },
105
- };
106
- }
107
-
108
- function createFakeInkInstance() {
109
- const fake = {
110
- lastOutput: "previous-frame",
111
- lastOutputToRender: "previous-frame-to-render",
112
- lastOutputHeight: 12,
113
- calculateLayoutCalls: 0,
114
- onRenderCalls: 0,
115
- unsubscribeResizeCalls: 0,
116
- throttledLogCancelCalls: 0,
117
- rootOnRenderCancelCalls: 0,
118
- onRenderCancelCalls: 0,
119
- calculateLayout() {
120
- fake.calculateLayoutCalls += 1;
121
- },
122
- onRender: Object.assign(
123
- () => {
124
- fake.onRenderCalls += 1;
125
- },
126
- {
127
- cancel() {
128
- fake.onRenderCancelCalls += 1;
129
- },
130
- },
131
- ),
132
- unsubscribeResize() {
133
- fake.unsubscribeResizeCalls += 1;
134
- },
135
- throttledLog: {
136
- cancel() {
137
- fake.throttledLogCancelCalls += 1;
138
- },
139
- },
140
- rootNode: {
141
- onRender: {
142
- cancel() {
143
- fake.rootOnRenderCancelCalls += 1;
144
- },
145
- },
146
- },
147
- };
148
-
149
- return fake;
150
- }
151
-
152
- test("strict VT mode refuses unsupported terminals without writing bracketed paste sequences", () => {
153
- let stdoutWrites = "";
154
- let stderrWrites = "";
155
- let renderCalled = false;
156
- let exitHandlerRegistered = false;
157
-
158
- const result = startApp({
159
- stdin: { isTTY: true },
160
- stdout: {
161
- isTTY: true,
162
- columns: 120,
163
- rows: 40,
164
- on() {
165
- return this;
166
- },
167
- off() {
168
- return this;
169
- },
170
- write(chunk: string) {
171
- stdoutWrites += chunk;
172
- return true;
173
- },
174
- },
175
- stderr: {
176
- write(chunk: string) {
177
- stderrWrites += chunk;
178
- return true;
179
- },
180
- },
181
- env: { CODEXA_REQUIRE_VT: "1" },
182
- platform: "win32",
183
- renderApp(_node: React.ReactElement) {
184
- renderCalled = true;
185
- return {
186
- clear() {},
187
- cleanup() {},
188
- waitUntilExit() {
189
- return Promise.resolve();
190
- },
191
- };
192
- },
193
- registerExitHandler() {
194
- exitHandlerRegistered = true;
195
- },
196
- });
197
-
198
- assert.deepEqual(result, { started: false, exitCode: 1 });
199
- assert.equal(renderCalled, false);
200
- assert.equal(exitHandlerRegistered, false);
201
- assert.equal(stdoutWrites, "");
202
- assert.doesNotMatch(stderrWrites, /\?2004[hl]/);
203
- assert.match(stderrWrites, /VT control sequences/i);
204
- });
205
-
206
- test("uncertain Windows VT support warns but continues without stdout probing", () => {
207
- let stdoutWrites = "";
208
- let stderrWrites = "";
209
- let renderCalled = false;
210
- const registeredHandlers: Array<() => void> = [];
211
-
212
- const result = startApp({
213
- stdin: { isTTY: true },
214
- stdout: {
215
- isTTY: true,
216
- columns: 120,
217
- rows: 40,
218
- on() {
219
- return this;
220
- },
221
- off() {
222
- return this;
223
- },
224
- write(chunk: string) {
225
- stdoutWrites += chunk;
226
- return true;
227
- },
228
- },
229
- stderr: {
230
- write(chunk: string) {
231
- stderrWrites += chunk;
232
- return true;
233
- },
234
- },
235
- env: {},
236
- platform: "win32",
237
- renderApp(_node: React.ReactElement) {
238
- renderCalled = true;
239
- return {
240
- clear() {},
241
- cleanup() {},
242
- waitUntilExit() {
243
- return Promise.resolve();
244
- },
245
- };
246
- },
247
- registerExitHandler(handler) {
248
- registeredHandlers.push(handler);
249
- },
250
- });
251
-
252
- assert.deepEqual(result, { started: true, exitCode: 0 });
253
- assert.equal(renderCalled, true);
254
- assert.match(stderrWrites, /will continue/i);
255
- assert.doesNotMatch(stdoutWrites, /\x1b(?:\[6n|\[>c|\[c|c)/);
256
-
257
- registeredHandlers[0]?.();
258
- });
259
-
260
- test("launch diagnostics report TTY state only behind debug flag", () => {
261
- let stderrWrites = "";
262
- let renderCalled = false;
263
- const registeredHandlers: Array<() => void> = [];
264
-
265
- const result = startApp({
266
- stdin: { isTTY: true },
267
- stdout: {
268
- isTTY: true,
269
- columns: 120,
270
- rows: 40,
271
- on() {
272
- return this;
273
- },
274
- off() {
275
- return this;
276
- },
277
- write() {
278
- return true;
279
- },
280
- },
281
- stderr: {
282
- isTTY: true,
283
- write(chunk: string) {
284
- stderrWrites += chunk;
285
- return true;
286
- },
287
- },
288
- env: { CODEXA_DEBUG_LAUNCH: "1", WT_SESSION: "test-session" },
289
- platform: "win32",
290
- argv: ["--model", "gpt-test"],
291
- renderApp(_node: React.ReactElement) {
292
- renderCalled = true;
293
- return {
294
- clear() {},
295
- cleanup() {},
296
- waitUntilExit() {
297
- return Promise.resolve();
298
- },
299
- };
300
- },
301
- registerExitHandler(handler) {
302
- registeredHandlers.push(handler);
303
- },
304
- });
305
-
306
- assert.deepEqual(result, { started: true, exitCode: 0 });
307
- assert.equal(renderCalled, true);
308
- assert.match(stderrWrites, /\[codexa:launch\]/);
309
- assert.match(stderrWrites, /"stdinIsTTY":true/);
310
- assert.match(stderrWrites, /"stdoutIsTTY":true/);
311
- assert.match(stderrWrites, /"stderrIsTTY":true/);
312
- registeredHandlers[0]?.();
313
- });
314
-
315
- test("enforces a single render root while active", async () => {
316
- const harness = createSupportedHarness();
317
-
318
- const first = startApp(harness.deps);
319
- const second = startApp(harness.deps);
320
-
321
- assert.deepEqual(first, { started: true, exitCode: 0 });
322
- assert.deepEqual(second, { started: true, exitCode: 0 });
323
- assert.equal(harness.getRenderCalls(), 1);
324
- assert.deepEqual(harness.getRenderOptions()?.kittyKeyboard, {
325
- mode: "auto",
326
- flags: ["disambiguateEscapeCodes"],
327
- });
328
-
329
- harness.resolveExit();
330
- await flushMicrotasks();
331
- });
332
-
333
- test("resize recovery preserves the viewport after invalid dimensions", async () => {
334
- const harness = createSupportedHarness();
335
-
336
- startApp(harness.deps);
337
- assert.equal(harness.stdout.clearCalls, 0);
338
-
339
- harness.stdout.columns = 1;
340
- harness.stdout.rows = 1;
341
- harness.stdout.emit("resize");
342
-
343
- harness.stdout.columns = 120;
344
- harness.stdout.rows = 40;
345
- harness.stdout.emit("resize");
346
-
347
- // onResize does not erase the viewport or scrollback.
348
- assert.equal(harness.stdout.clearCalls, 0);
349
- assert.doesNotMatch(harness.stdout.writes, /\x1b\[\?1000h/);
350
- assert.doesNotMatch(harness.stdout.writes, /\x1b\[\?1006h/);
351
- assert.match(harness.stdout.writes, /\x1b\[\?2004h/);
352
- const writesAfterStart = harness.stdout.writes.indexOf("\x1b[?2004h") + "\x1b[?2004h".length;
353
- assert.doesNotMatch(harness.stdout.writes.slice(writesAfterStart), /\x1b\[2J|\x1b\[3J/);
354
-
355
- // After the debounce fires, recovery still avoids clear() and ANSI clears.
356
- await new Promise((resolve) => setTimeout(resolve, 200));
357
- assert.equal(harness.stdout.clearCalls, 0);
358
- assert.doesNotMatch(harness.stdout.writes.slice(writesAfterStart), /\x1b\[2J|\x1b\[3J/);
359
-
360
- harness.resolveExit();
361
- await flushMicrotasks();
362
- });
363
-
364
- test("resize repaint does not erase terminal scrollback buffer", async () => {
365
- const harness = createSupportedHarness();
366
- startApp(harness.deps);
367
-
368
- // Startup intentionally clears scrollback (\x1b[3J) so the app opens into a
369
- // clean screen. Verify it IS written exactly once during startup.
370
- assert.match(harness.stdout.writes, /\x1b\[3J/, "startup must erase scrollback for clean open");
371
-
372
- // Capture offset so we can inspect only post-startup writes.
373
- const startupEnd = harness.stdout.writes.length;
374
-
375
- harness.stdout.columns = 80;
376
- harness.stdout.emit("resize");
377
-
378
- await new Promise((resolve) => setTimeout(resolve, 200));
379
-
380
- // Normal valid resize is a soft repaint and must not call Ink.clear().
381
- assert.equal(harness.stdout.clearCalls, 0, "normal resize must not call clear()");
382
-
383
- // Post-resize writes must not contain full/viewport clear sequences.
384
- const resizeWrites = harness.stdout.writes.slice(startupEnd);
385
- assert.doesNotMatch(resizeWrites, /\x1b\[3J/, "scrollback must not be erased on resize");
386
- assert.doesNotMatch(resizeWrites, /\x1b\[2J/, "normal resize must not clear the viewport");
387
-
388
- harness.resolveExit();
389
- await flushMicrotasks();
390
- });
391
-
392
- test("normal app render writes do not clear the terminal after startup", async () => {
393
- const harness = createSupportedHarness();
394
- startApp(harness.deps);
395
-
396
- const writesAfterStartup = harness.stdout.writes.slice(
397
- harness.stdout.writes.indexOf("\x1b[?2004h") + "\x1b[?2004h".length,
398
- );
399
- assert.equal(harness.stdout.clearCalls, 0);
400
- assert.doesNotMatch(harness.stdout.writes, /\x1b\[\?1000h|\x1b\[\?1006h/);
401
- assert.doesNotMatch(writesAfterStartup, /\x1b\[2J|\x1b\[3J/);
402
-
403
- harness.resolveExit();
404
- await flushMicrotasks();
405
- });
406
-
407
- test("startup writes safe fallback title before repaint and workspace title before Ink render setup", async () => {
408
- const harness = createSupportedHarness();
409
- startApp(harness.deps);
410
-
411
- // Startup now writes a full transcript clear: viewport + scrollback + cursor home.
412
- const repaintIndex = harness.stdout.writes.indexOf("\x1b[2J\x1b[3J\x1b[H");
413
- const firstTitleIndex = harness.stdout.writes.indexOf("\x1b]0;");
414
- const postRepaintTitleIndex = harness.stdout.writes.indexOf("\x1b]0;", repaintIndex + 1);
415
- const bracketedPasteIndex = harness.stdout.writes.indexOf("\x1b[?2004h");
416
-
417
- assert.ok(repaintIndex >= 0, "startup repaint should be written");
418
- assert.ok(firstTitleIndex >= 0, "fallback title should be written");
419
- assert.ok(firstTitleIndex < repaintIndex, "safe fallback title should be written before startup repaint");
420
- assert.ok(postRepaintTitleIndex > repaintIndex, "workspace title should be written after startup repaint");
421
- assert.ok(bracketedPasteIndex > postRepaintTitleIndex, "workspace title should be written before bracketed paste/render setup");
422
- assert.match(harness.stdout.writes, /\x1b\]0;[^\x07]+\x07\x1b\]2;[^\x07]+\x07/);
423
- assert.doesNotMatch(harness.stdout.writes, /\x1b\](?:0|2);[a-zA-Z]:[\\/]/);
424
-
425
- harness.resolveExit();
426
- await flushMicrotasks();
427
- });
428
-
429
- test("soft-repaints when resize occurs without invalid dimensions", async () => {
430
- const harness = createSupportedHarness();
431
- startApp(harness.deps);
432
-
433
- const writesBefore = harness.stdout.writes;
434
-
435
- // Emit a resize at valid dimensions (no invalid transition)
436
- harness.stdout.columns = 80;
437
- harness.stdout.emit("resize");
438
-
439
- // No writes happen immediately.
440
- const immediateWrites = harness.stdout.writes.slice(writesBefore.length);
441
- assert.equal(immediateWrites, "");
442
-
443
- // After debounce fires, valid resize still avoids terminal clear writes.
444
- await new Promise((resolve) => setTimeout(resolve, 200));
445
- assert.equal(harness.stdout.clearCalls, 0);
446
- const delayedWrites = harness.stdout.writes.slice(writesBefore.length);
447
- assert.doesNotMatch(delayedWrites, /\x1b\[2J|\x1b\[3J/);
448
-
449
- harness.resolveExit();
450
- await flushMicrotasks();
451
- });
452
-
453
- test("post-startup resize does not force Ink internals or blank cached output", async () => {
454
- const inkInstance = createFakeInkInstance();
455
- const harness = createSupportedHarness({ inkInstance });
456
- startApp(harness.deps);
457
-
458
- assert.equal(inkInstance.unsubscribeResizeCalls, 1, "startup still disables Ink's competing resize listener");
459
-
460
- const initialLastOutput = inkInstance.lastOutput;
461
- const initialLastOutputToRender = inkInstance.lastOutputToRender;
462
- const initialLastOutputHeight = inkInstance.lastOutputHeight;
463
- const startupEnd = harness.stdout.writes.length;
464
-
465
- harness.stdout.columns = 15;
466
- harness.stdout.rows = 8;
467
- harness.stdout.emit("resize");
468
-
469
- harness.stdout.columns = 100;
470
- harness.stdout.rows = 32;
471
- harness.stdout.emit("resize");
472
-
473
- await new Promise((resolve) => setTimeout(resolve, 200));
474
-
475
- assert.equal(harness.stdout.clearCalls, 0);
476
- assert.doesNotMatch(harness.stdout.writes.slice(startupEnd), /\x1b\[2J|\x1b\[3J/);
477
- assert.equal(inkInstance.lastOutput, initialLastOutput);
478
- assert.equal(inkInstance.lastOutputToRender, initialLastOutputToRender);
479
- assert.equal(inkInstance.lastOutputHeight, initialLastOutputHeight);
480
- assert.equal(inkInstance.calculateLayoutCalls, 0);
481
- assert.equal(inkInstance.onRenderCalls, 0);
482
- assert.equal(inkInstance.throttledLogCancelCalls, 0);
483
- assert.equal(inkInstance.rootOnRenderCancelCalls, 0);
484
- assert.equal(inkInstance.onRenderCancelCalls, 0);
485
-
486
- harness.resolveExit();
487
- await flushMicrotasks();
488
- });
489
-
490
- test("removes resize listener and restores bracketed paste on cleanup", async () => {
491
- const harness = createSupportedHarness();
492
-
493
- startApp(harness.deps);
494
- assert.equal(harness.stdout.listenerCount("resize"), 1);
495
- assert.equal(harness.registeredHandlers.length, 1);
496
-
497
- // Cleanup is deferred via registerExitHandler (index 0)
498
- harness.registeredHandlers[0]!();
499
- assert.equal(harness.stdout.listenerCount("resize"), 0);
500
- assert.equal(harness.getCleanupCalls(), 1);
501
- // Verify mouse reporting is not enabled during default startup.
502
- assert.doesNotMatch(harness.stdout.writes, /\x1b\[\?1000h/);
503
- assert.doesNotMatch(harness.stdout.writes, /\x1b\[\?1002h/);
504
- assert.doesNotMatch(harness.stdout.writes, /\x1b\[\?1003h/);
505
- assert.doesNotMatch(harness.stdout.writes, /\x1b\[\?1006h/);
506
- assert.doesNotMatch(harness.stdout.writes, /\x1b\[\?1015h/);
507
- assert.match(harness.stdout.writes, /\x1b\[\?2004h/);
508
- // Verify defensive disable sequences were written during cleanup.
509
- assert.match(harness.stdout.writes, /\x1b\[\?1000l/);
510
- assert.match(harness.stdout.writes, /\x1b\[\?1002l/);
511
- assert.match(harness.stdout.writes, /\x1b\[\?1003l/);
512
- assert.match(harness.stdout.writes, /\x1b\[\?1006l/);
513
- assert.match(harness.stdout.writes, /\x1b\[\?1015l/);
514
- assert.match(harness.stdout.writes, /\x1b\[\?2004l/);
515
-
516
- // Resolving after explicit cleanup should be idempotent.
517
- harness.resolveExit();
518
- await flushMicrotasks();
519
- });
520
-
521
- test("treats sub-viewport dimensions as invalid and defers repaint", async () => {
522
- const harness = createSupportedHarness();
523
- startApp(harness.deps);
524
-
525
- // Reset counters after initial render
526
- harness.stdout.clearCalls = 0;
527
- harness.stdout.writes = "";
528
-
529
- // Emit resize with medium-invalid dims (pass old <=1 check but fail MIN_VIEWPORT threshold)
530
- harness.stdout.columns = 15;
531
- harness.stdout.rows = 8;
532
- harness.stdout.emit("resize");
533
-
534
- // Should NOT write scrollback clear — dims are invalid, content preserved
535
- assert.equal(harness.stdout.clearCalls, 0);
536
-
537
- // Debounce fires but dims are still invalid — repaint is skipped
538
- await new Promise((resolve) => setTimeout(resolve, 200));
539
- assert.equal(harness.stdout.clearCalls, 0);
540
-
541
- // Now recover to valid dims
542
- harness.stdout.columns = 120;
543
- harness.stdout.rows = 40;
544
- harness.stdout.emit("resize");
545
-
546
- // After debounce, recovery still preserves the old frame and avoids clear().
547
- await new Promise((resolve) => setTimeout(resolve, 200));
548
- assert.equal(harness.stdout.clearCalls, 0);
549
- assert.doesNotMatch(harness.stdout.writes, /\x1b\[2J|\x1b\[3J/);
550
-
551
- harness.resolveExit();
552
- await flushMicrotasks();
553
- });
554
-
555
- test("debounced repaint fires after rapid resizes to identical dimensions", async () => {
556
- const harness = createSupportedHarness();
557
- startApp(harness.deps);
558
-
559
- // Reset counters after initial render
560
- harness.stdout.clearCalls = 0;
561
- harness.stdout.writes = "";
562
-
563
- try {
564
- // Emit two resizes to identical valid dims in quick succession — simulates
565
- // max→standard where the final dims match what React already rendered.
566
- // The debounce should collapse both into a single repaint.
567
- harness.stdout.columns = 100;
568
- harness.stdout.rows = 35;
569
- harness.stdout.emit("resize");
570
- harness.stdout.emit("resize");
571
-
572
- // No writes happen immediately.
573
-
574
- assert.equal(harness.stdout.clearCalls, 0);
575
-
576
- // Wait for the 150ms debounce to fire
577
- await new Promise((resolve) => setTimeout(resolve, 200));
578
-
579
- // Valid resize remains a soft repaint, even when rapid events collapse.
580
- assert.equal(harness.stdout.clearCalls, 0);
581
- assert.equal(harness.stdout.writes.replace(TITLE_SEQUENCE_PATTERN, ""), "");
582
- } finally {
583
- harness.resolveExit();
584
- await flushMicrotasks();
585
- }
586
- });
587
-
588
- test("scheduled soft repaint does not call renderHandle.clear when inkInstance is null", async () => {
589
- const harness = createSupportedHarness();
590
- startApp(harness.deps);
591
-
592
- // Reset counters after initial render
593
- harness.stdout.clearCalls = 0;
594
- harness.stdout.writes = "";
595
-
596
- // Emit a normal resize — triggers scheduleRepaint (no immediate writes)
597
- harness.stdout.columns = 80;
598
- harness.stdout.emit("resize");
599
-
600
- // Immediately after resize: no writes and no renderHandle.clear() yet
601
- assert.equal(harness.stdout.clearCalls, 0);
602
- assert.equal(harness.stdout.writes, "");
603
-
604
- // Wait for the 150ms debounce to fire
605
- await new Promise((resolve) => setTimeout(resolve, 200));
606
-
607
- // In test mocks inkInstance is null; normal valid resize should still avoid
608
- // the fallback clear path.
609
- assert.equal(harness.stdout.clearCalls, 0);
610
- assert.equal(harness.stdout.writes.replace(TITLE_SEQUENCE_PATTERN, ""), "");
611
-
612
- harness.resolveExit();
613
- await flushMicrotasks();
614
- });
615
-
616
- test("render startup does not introduce alternate-screen mode", () => {
617
- const source = readFileSync(new URL("./index.tsx", import.meta.url), "utf8");
618
- assert.doesNotMatch(source, /write\([^)]*1049h/);
619
- assert.doesNotMatch(source, /const\s+\w+\s*=\s*["'`][^"'`]*1049h/);
620
- });