@golba98/codexa 1.0.1

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 (226) hide show
  1. package/README.md +320 -0
  2. package/bin/codexa.js +445 -0
  3. package/package.json +45 -0
  4. package/scripts/audit-codexa-capabilities.mjs +466 -0
  5. package/scripts/smoke-terminal-bench.mjs +35 -0
  6. package/src/app.tsx +4561 -0
  7. package/src/appRenderStability.test.ts +131 -0
  8. package/src/commands/handler.test.ts +643 -0
  9. package/src/commands/handler.ts +875 -0
  10. package/src/config/launchArgs.test.ts +158 -0
  11. package/src/config/launchArgs.ts +186 -0
  12. package/src/config/layeredConfig.test.ts +143 -0
  13. package/src/config/layeredConfig.ts +836 -0
  14. package/src/config/persistence.test.ts +110 -0
  15. package/src/config/persistence.ts +311 -0
  16. package/src/config/runtimeConfig.test.ts +218 -0
  17. package/src/config/runtimeConfig.ts +554 -0
  18. package/src/config/settings.test.ts +155 -0
  19. package/src/config/settings.ts +401 -0
  20. package/src/config/toml-serialize.ts +98 -0
  21. package/src/config/trustStore.test.ts +29 -0
  22. package/src/config/trustStore.ts +68 -0
  23. package/src/core/attachments.test.ts +155 -0
  24. package/src/core/attachments.ts +71 -0
  25. package/src/core/auth/codexAuth.test.ts +68 -0
  26. package/src/core/auth/codexAuth.ts +359 -0
  27. package/src/core/cleanupFastFail.test.ts +76 -0
  28. package/src/core/cleanupFastFail.ts +67 -0
  29. package/src/core/clipboard.ts +24 -0
  30. package/src/core/codex.ts +124 -0
  31. package/src/core/codexExecArgs.test.ts +195 -0
  32. package/src/core/codexExecArgs.ts +152 -0
  33. package/src/core/codexLaunch.test.ts +205 -0
  34. package/src/core/codexLaunch.ts +162 -0
  35. package/src/core/codexPrompt.test.ts +252 -0
  36. package/src/core/codexPrompt.ts +428 -0
  37. package/src/core/executables/claudeExecutable.ts +63 -0
  38. package/src/core/executables/codexExecutable.test.ts +212 -0
  39. package/src/core/executables/codexExecutable.ts +159 -0
  40. package/src/core/executables/executableResolver.test.ts +129 -0
  41. package/src/core/executables/executableResolver.ts +138 -0
  42. package/src/core/executables/geminiExecutable.test.ts +116 -0
  43. package/src/core/executables/geminiExecutable.ts +78 -0
  44. package/src/core/executables/pathSanityScan.test.ts +47 -0
  45. package/src/core/githubDiagnostics.test.ts +92 -0
  46. package/src/core/githubDiagnostics.ts +222 -0
  47. package/src/core/hollowResponseFormat.test.ts +58 -0
  48. package/src/core/hollowResponseFormat.ts +39 -0
  49. package/src/core/inputDebug.ts +51 -0
  50. package/src/core/launchContext.test.ts +157 -0
  51. package/src/core/launchContext.ts +266 -0
  52. package/src/core/models/codexCapabilities.test.ts +45 -0
  53. package/src/core/models/codexCapabilities.ts +95 -0
  54. package/src/core/models/codexModelCapabilities.test.ts +246 -0
  55. package/src/core/models/codexModelCapabilities.ts +571 -0
  56. package/src/core/models/modelSpecs.test.ts +283 -0
  57. package/src/core/models/modelSpecs.ts +300 -0
  58. package/src/core/perf/profiler.ts +125 -0
  59. package/src/core/perf/renderDebug.test.ts +230 -0
  60. package/src/core/perf/renderDebug.ts +373 -0
  61. package/src/core/planStorage.test.ts +143 -0
  62. package/src/core/planStorage.ts +141 -0
  63. package/src/core/process/CommandRunner.test.ts +105 -0
  64. package/src/core/process/CommandRunner.ts +269 -0
  65. package/src/core/process/processValidation.ts +101 -0
  66. package/src/core/projectInstructions.test.ts +50 -0
  67. package/src/core/projectInstructions.ts +54 -0
  68. package/src/core/providerLauncher/launcher.test.ts +238 -0
  69. package/src/core/providerLauncher/launcher.ts +203 -0
  70. package/src/core/providerLauncher/registry.test.ts +324 -0
  71. package/src/core/providerLauncher/registry.ts +253 -0
  72. package/src/core/providerLauncher/types.ts +84 -0
  73. package/src/core/providerLauncher/workspaceConfig.test.ts +638 -0
  74. package/src/core/providerLauncher/workspaceConfig.ts +407 -0
  75. package/src/core/providerRuntime/anthropic.test.ts +1120 -0
  76. package/src/core/providerRuntime/anthropic.ts +576 -0
  77. package/src/core/providerRuntime/capabilityProfile.test.ts +311 -0
  78. package/src/core/providerRuntime/capabilityProfile.ts +288 -0
  79. package/src/core/providerRuntime/claudeCodeDiscovery.ts +446 -0
  80. package/src/core/providerRuntime/contextMetadata.test.ts +468 -0
  81. package/src/core/providerRuntime/contextMetadata.ts +409 -0
  82. package/src/core/providerRuntime/gemini.test.ts +437 -0
  83. package/src/core/providerRuntime/gemini.ts +784 -0
  84. package/src/core/providerRuntime/lmstudio.test.ts +168 -0
  85. package/src/core/providerRuntime/lmstudio.ts +118 -0
  86. package/src/core/providerRuntime/local.test.ts +787 -0
  87. package/src/core/providerRuntime/local.ts +754 -0
  88. package/src/core/providerRuntime/models.ts +150 -0
  89. package/src/core/providerRuntime/reasoning.ts +17 -0
  90. package/src/core/providerRuntime/registry.test.ts +233 -0
  91. package/src/core/providerRuntime/registry.ts +203 -0
  92. package/src/core/providerRuntime/types.ts +103 -0
  93. package/src/core/providers/codexJsonStream.test.ts +148 -0
  94. package/src/core/providers/codexJsonStream.ts +305 -0
  95. package/src/core/providers/codexSubprocess.test.ts +68 -0
  96. package/src/core/providers/codexSubprocess.ts +372 -0
  97. package/src/core/providers/codexTranscript.test.ts +284 -0
  98. package/src/core/providers/codexTranscript.ts +695 -0
  99. package/src/core/providers/openaiNative.ts +13 -0
  100. package/src/core/providers/registry.ts +21 -0
  101. package/src/core/providers/types.ts +59 -0
  102. package/src/core/terminal/terminalCapabilities.test.ts +93 -0
  103. package/src/core/terminal/terminalCapabilities.ts +100 -0
  104. package/src/core/terminal/terminalControl.test.ts +75 -0
  105. package/src/core/terminal/terminalControl.ts +147 -0
  106. package/src/core/terminal/terminalSanitize.test.ts +22 -0
  107. package/src/core/terminal/terminalSanitize.ts +147 -0
  108. package/src/core/terminal/terminalSelection.test.ts +42 -0
  109. package/src/core/terminal/terminalSelection.ts +66 -0
  110. package/src/core/terminal/terminalTitle.test.ts +328 -0
  111. package/src/core/terminal/terminalTitle.ts +483 -0
  112. package/src/core/workspaceActivity.test.ts +163 -0
  113. package/src/core/workspaceActivity.ts +380 -0
  114. package/src/core/workspaceGuard.test.ts +151 -0
  115. package/src/core/workspaceGuard.ts +288 -0
  116. package/src/core/workspaceRoot.test.ts +23 -0
  117. package/src/core/workspaceRoot.ts +47 -0
  118. package/src/exec.test.ts +13 -0
  119. package/src/exec.ts +72 -0
  120. package/src/headless/execArgs.test.ts +147 -0
  121. package/src/headless/execArgs.ts +294 -0
  122. package/src/headless/execRunner.test.ts +434 -0
  123. package/src/headless/execRunner.ts +304 -0
  124. package/src/index.test.tsx +618 -0
  125. package/src/index.tsx +296 -0
  126. package/src/session/appSession.test.ts +897 -0
  127. package/src/session/appSession.ts +761 -0
  128. package/src/session/chatLifecycle.test.ts +64 -0
  129. package/src/session/chatLifecycle.ts +951 -0
  130. package/src/session/liveRenderScheduler.test.ts +201 -0
  131. package/src/session/liveRenderScheduler.ts +214 -0
  132. package/src/session/planFlow.test.ts +103 -0
  133. package/src/session/planFlow.ts +149 -0
  134. package/src/session/planTranscript.test.ts +65 -0
  135. package/src/session/planTranscript.ts +15 -0
  136. package/src/session/promptRunSchedule.test.ts +36 -0
  137. package/src/session/promptRunSchedule.ts +26 -0
  138. package/src/session/types.ts +228 -0
  139. package/src/test/runtimeTestUtils.ts +14 -0
  140. package/src/types/react-dom.d.ts +3 -0
  141. package/src/ui/ActionRequiredBlock.tsx +38 -0
  142. package/src/ui/ActivityBars.tsx +68 -0
  143. package/src/ui/ActivityIndicator.test.tsx +58 -0
  144. package/src/ui/ActivityIndicator.tsx +58 -0
  145. package/src/ui/AgentBlock.test.ts +6 -0
  146. package/src/ui/AgentBlock.tsx +130 -0
  147. package/src/ui/AnimatedStatusText.test.ts +16 -0
  148. package/src/ui/AnimatedStatusText.tsx +69 -0
  149. package/src/ui/AppShell.test.tsx +1739 -0
  150. package/src/ui/AppShell.tsx +698 -0
  151. package/src/ui/AttachmentImportPanel.test.tsx +204 -0
  152. package/src/ui/AttachmentImportPanel.tsx +98 -0
  153. package/src/ui/AuthPanel.tsx +113 -0
  154. package/src/ui/BackendPicker.tsx +28 -0
  155. package/src/ui/BottomComposer.test.ts +674 -0
  156. package/src/ui/BottomComposer.tsx +1028 -0
  157. package/src/ui/CodexLogo.tsx +55 -0
  158. package/src/ui/DashCard.tsx +82 -0
  159. package/src/ui/Markdown.test.ts +157 -0
  160. package/src/ui/Markdown.tsx +310 -0
  161. package/src/ui/ModePicker.tsx +27 -0
  162. package/src/ui/ModelPicker.tsx +31 -0
  163. package/src/ui/ModelPickerProviderScope.test.tsx +411 -0
  164. package/src/ui/ModelPickerScreen.test.tsx +99 -0
  165. package/src/ui/ModelPickerScreen.tsx +416 -0
  166. package/src/ui/ModelPickerState.test.tsx +151 -0
  167. package/src/ui/ModelReasoningPicker.test.tsx +447 -0
  168. package/src/ui/ModelReasoningPicker.tsx +458 -0
  169. package/src/ui/Panel.tsx +51 -0
  170. package/src/ui/PermissionsPanel.tsx +78 -0
  171. package/src/ui/PlanActionPicker.tsx +119 -0
  172. package/src/ui/PlanReviewPanel.test.tsx +267 -0
  173. package/src/ui/PlanReviewPanel.tsx +212 -0
  174. package/src/ui/PromptCardBorder.test.tsx +161 -0
  175. package/src/ui/ProviderPicker.test.tsx +289 -0
  176. package/src/ui/ProviderPicker.tsx +321 -0
  177. package/src/ui/ProviderShortcut.test.tsx +143 -0
  178. package/src/ui/ReasoningPicker.tsx +46 -0
  179. package/src/ui/RunFooter.tsx +65 -0
  180. package/src/ui/SelectionPanel.tsx +67 -0
  181. package/src/ui/SettingsPanel.test.tsx +233 -0
  182. package/src/ui/SettingsPanel.tsx +156 -0
  183. package/src/ui/Spinner.tsx +25 -0
  184. package/src/ui/StaticIntroItem.tsx +54 -0
  185. package/src/ui/StaticTranscriptItem.tsx +56 -0
  186. package/src/ui/TextEntryPanel.tsx +139 -0
  187. package/src/ui/ThemePicker.tsx +31 -0
  188. package/src/ui/ThinkingBlock.tsx +100 -0
  189. package/src/ui/Timeline.test.ts +2067 -0
  190. package/src/ui/Timeline.tsx +1472 -0
  191. package/src/ui/TimelineNavigation.test.tsx +201 -0
  192. package/src/ui/TopHeader.test.tsx +239 -0
  193. package/src/ui/TopHeader.tsx +257 -0
  194. package/src/ui/TurnGroup.test.tsx +365 -0
  195. package/src/ui/TurnGroup.tsx +657 -0
  196. package/src/ui/busyStatusAnimation.test.ts +30 -0
  197. package/src/ui/busyStatusAnimation.ts +11 -0
  198. package/src/ui/commandNormalize.test.ts +142 -0
  199. package/src/ui/commandNormalize.ts +66 -0
  200. package/src/ui/diffRenderer.test.ts +102 -0
  201. package/src/ui/diffRenderer.ts +116 -0
  202. package/src/ui/focus.ts +61 -0
  203. package/src/ui/focusFlow.test.tsx +1098 -0
  204. package/src/ui/inputBuffer.test.ts +151 -0
  205. package/src/ui/inputBuffer.ts +203 -0
  206. package/src/ui/layout.test.ts +145 -0
  207. package/src/ui/layout.ts +287 -0
  208. package/src/ui/modeDisplay.test.ts +42 -0
  209. package/src/ui/modeDisplay.ts +52 -0
  210. package/src/ui/outputPipeline.ts +64 -0
  211. package/src/ui/progressEntries.ts +156 -0
  212. package/src/ui/runActivityView.test.ts +89 -0
  213. package/src/ui/runActivityView.ts +37 -0
  214. package/src/ui/runLifecycleView.test.tsx +237 -0
  215. package/src/ui/slashCommands.ts +41 -0
  216. package/src/ui/statusRenderIsolation.test.tsx +654 -0
  217. package/src/ui/terminalAnswerFormat.test.ts +19 -0
  218. package/src/ui/terminalAnswerFormat.ts +128 -0
  219. package/src/ui/textLayout.test.ts +18 -0
  220. package/src/ui/textLayout.ts +338 -0
  221. package/src/ui/theme.tsx +395 -0
  222. package/src/ui/themeFlow.test.ts +53 -0
  223. package/src/ui/themeFlow.ts +41 -0
  224. package/src/ui/timelineMeasure.ts +3088 -0
  225. package/src/ui/timelineMeasureCache.test.ts +986 -0
  226. package/src/ui/useThrottledValue.ts +31 -0
@@ -0,0 +1,267 @@
1
+ import assert from "node:assert/strict";
2
+ import test from "node:test";
3
+ import React from "react";
4
+ import { PassThrough } from "node:stream";
5
+ import { Box, Text, render } from "ink";
6
+ import { PlanActionPicker } from "./PlanActionPicker.js";
7
+ import { normalizePlanReviewMarkdown } from "../core/planStorage.js";
8
+ import {
9
+ buildPlanReviewDisplayRows,
10
+ buildPlanReviewRows,
11
+ PlanReviewPanel,
12
+ } from "./PlanReviewPanel.js";
13
+ import { ThemeProvider } from "./theme.js";
14
+
15
+ class TestInput extends PassThrough {
16
+ readonly isTTY = true;
17
+
18
+ setRawMode(): this {
19
+ return this;
20
+ }
21
+
22
+ override resume(): this {
23
+ return this;
24
+ }
25
+
26
+ override pause(): this {
27
+ return this;
28
+ }
29
+
30
+ ref(): this {
31
+ return this;
32
+ }
33
+
34
+ unref(): this {
35
+ return this;
36
+ }
37
+ }
38
+
39
+ class TestOutput extends PassThrough {
40
+ readonly isTTY = true;
41
+ columns = 80;
42
+ rows = 24;
43
+ }
44
+
45
+ function stripAnsi(value: string): string {
46
+ return value.replace(/\u001B\[[0-?]*[ -/]*[@-~]/g, "");
47
+ }
48
+
49
+ function sleep(ms = 50): Promise<void> {
50
+ return new Promise((resolve) => setTimeout(resolve, ms));
51
+ }
52
+
53
+ async function renderPlanPanel(planText: string, cols = 80): Promise<string> {
54
+ const stdin = new TestInput();
55
+ const stdout = new TestOutput();
56
+ stdout.columns = cols;
57
+ let output = "";
58
+
59
+ stdout.on("data", (chunk) => {
60
+ output += chunk.toString();
61
+ });
62
+
63
+ const instance = render(
64
+ <ThemeProvider theme="purple">
65
+ <PlanReviewPanel
66
+ planText={planText}
67
+ cols={cols}
68
+ workspaceRoot="C:\\Development\\Project"
69
+ />
70
+ </ThemeProvider>,
71
+ {
72
+ stdin: stdin as unknown as NodeJS.ReadStream,
73
+ stdout: stdout as unknown as NodeJS.WriteStream,
74
+ stderr: stdout as unknown as NodeJS.WriteStream,
75
+ debug: true,
76
+ exitOnCtrlC: false,
77
+ patchConsole: false,
78
+ },
79
+ );
80
+
81
+ await sleep(80);
82
+ instance.cleanup();
83
+ await sleep(20);
84
+ return stripAnsi(output);
85
+ }
86
+
87
+ function createInkHarness(node: React.ReactElement) {
88
+ const stdin = new TestInput();
89
+ const stdout = new TestOutput();
90
+ let output = "";
91
+
92
+ stdout.on("data", (chunk) => {
93
+ output += chunk.toString();
94
+ });
95
+
96
+ const instance = render(node, {
97
+ stdin: stdin as unknown as NodeJS.ReadStream,
98
+ stdout: stdout as unknown as NodeJS.WriteStream,
99
+ stderr: stdout as unknown as NodeJS.WriteStream,
100
+ debug: true,
101
+ exitOnCtrlC: false,
102
+ patchConsole: false,
103
+ });
104
+
105
+ return {
106
+ stdin,
107
+ getOutput() {
108
+ return stripAnsi(output);
109
+ },
110
+ async cleanup() {
111
+ instance.cleanup();
112
+ await sleep(20);
113
+ },
114
+ };
115
+ }
116
+
117
+ function makeLongPlan(itemCount = 40): string {
118
+ return [
119
+ "Files:",
120
+ ...Array.from({ length: itemCount }, (_, index) =>
121
+ `- src/file-${index + 1}.ts Description for item ${index + 1}.`,
122
+ ),
123
+ "",
124
+ "Steps:",
125
+ ...Array.from({ length: itemCount }, (_, index) =>
126
+ `${index + 1}. Complete implementation step ${index + 1}.`,
127
+ ),
128
+ ].join("\n");
129
+ }
130
+
131
+ function PlanActionHarness() {
132
+ const [selection, setSelection] = React.useState("none");
133
+ const [cancelCount, setCancelCount] = React.useState(0);
134
+
135
+ return (
136
+ <ThemeProvider theme="purple">
137
+ <Box flexDirection="column">
138
+ <PlanActionPicker
139
+ onSelect={(value) => setSelection(value)}
140
+ onCancel={() => setCancelCount((count) => count + 1)}
141
+ />
142
+ <Text>{`selection:${selection}`}</Text>
143
+ <Text>{`cancel:${cancelCount}`}</Text>
144
+ </Box>
145
+ </ThemeProvider>
146
+ );
147
+ }
148
+
149
+ test("plan review markdown normalization converts bold section labels into headings", () => {
150
+ const normalized = normalizePlanReviewMarkdown("**Files**\n- src/app.tsx\n\n**Steps**\n1. Wire the panel");
151
+
152
+ assert.match(normalized, /## Files/);
153
+ assert.match(normalized, /## Steps/);
154
+ assert.doesNotMatch(normalized, /\*\*Files\*\*/);
155
+ assert.doesNotMatch(normalized, /\*\*Steps\*\*/);
156
+ });
157
+
158
+ test("plan review rows hide workspace-root filesystem details", () => {
159
+ const rows = buildPlanReviewRows(
160
+ "**Files**\n- C:\\Development\\Project\\src\\app.tsx\n\nSteps:\n1. Keep the saved plan internal.",
161
+ "C:\\Development\\Project",
162
+ );
163
+ const joined = JSON.stringify(rows);
164
+
165
+ assert.match(joined, /src\/app\.tsx/);
166
+ assert.doesNotMatch(joined, /C:\\\\Development/);
167
+ assert.doesNotMatch(joined, /Path:/);
168
+ });
169
+
170
+ test("plan review display rows wrap long lines inside the panel width", () => {
171
+ const longText = "This line should wrap cleanly inside the review panel instead of clipping horizontally past the right border where it would become unreadable.";
172
+ const semanticRows = buildPlanReviewRows(`Files:\n- src/core/board.py ${longText}`);
173
+ const displayRows = buildPlanReviewDisplayRows(semanticRows, 34);
174
+ const joined = displayRows.map((row) => row.text).join("\n");
175
+
176
+ assert.match(joined, /This line/);
177
+ assert.match(joined, /should wrap cleanly/);
178
+ assert.match(joined, /instead of clipping/);
179
+ assert.ok(
180
+ displayRows.every((row) => row.text.length <= 34),
181
+ "wrapped rows should stay within the requested content width",
182
+ );
183
+ });
184
+
185
+ test("plan review panel renders the full long plan instead of a clipped row range", async () => {
186
+ const output = await renderPlanPanel(makeLongPlan(40), 100);
187
+
188
+ assert.match(output, /Plan/);
189
+ assert.match(output, /src\/file-1\.ts/);
190
+ assert.match(output, /src\/file-20\.ts/);
191
+ assert.match(output, /src\/file-40\.ts/);
192
+ assert.match(output, /40\. Complete implementation step 40\./);
193
+ assert.doesNotMatch(output, /Plan \d+[-–]\d+ of \d+/);
194
+ assert.doesNotMatch(output, /PageUp\/PageDown scroll plan/);
195
+ assert.doesNotMatch(output, /C:\\Development/);
196
+ });
197
+
198
+ test("plan action picker keeps simple menu navigation and enter selection", async () => {
199
+ const harness = createInkHarness(<PlanActionHarness />);
200
+
201
+ try {
202
+ await sleep(80);
203
+ harness.stdin.write("u");
204
+ await sleep(80);
205
+
206
+ const output = harness.getOutput();
207
+ assert.match(output, /Plan ready/);
208
+ assert.match(output, /\[I\] Implement changes/);
209
+ assert.match(output, /\[U\] Update plan/);
210
+ assert.doesNotMatch(output, /╭── Plan ready/);
211
+ assert.doesNotMatch(output, /I\s\sImplement changes/);
212
+ assert.doesNotMatch(output, /U\s\sUpdate plan/);
213
+ assert.doesNotMatch(output, /Cancel/);
214
+ assert.doesNotMatch(output, /Request changes/);
215
+ assert.doesNotMatch(output, /Add constraints/);
216
+ assert.doesNotMatch(output, /type a decision/);
217
+ assert.match(output, /selection:revise/);
218
+ } finally {
219
+ await harness.cleanup();
220
+ }
221
+ });
222
+
223
+ test("plan action picker supports focused hotkeys and escape cancellation", async () => {
224
+ const harness = createInkHarness(<PlanActionHarness />);
225
+
226
+ try {
227
+ await sleep(80);
228
+ harness.stdin.write("u");
229
+ await sleep(80);
230
+ harness.stdin.write("\u001b");
231
+ await sleep(80);
232
+
233
+ const output = harness.getOutput();
234
+ assert.match(output, /selection:revise/);
235
+ assert.match(output, /cancel:1/);
236
+ } finally {
237
+ await harness.cleanup();
238
+ }
239
+ });
240
+
241
+ test("plan action picker implements with hotkey", async () => {
242
+ const harness = createInkHarness(<PlanActionHarness />);
243
+ try {
244
+ await sleep(80);
245
+ harness.stdin.write("i");
246
+ await sleep(80);
247
+ const output = harness.getOutput();
248
+ assert.match(output, /selection:implement/);
249
+ } finally {
250
+ await harness.cleanup();
251
+ }
252
+ });
253
+
254
+ test("plan action picker selects focused action with enter", async () => {
255
+ const harness = createInkHarness(<PlanActionHarness />);
256
+ try {
257
+ await sleep(80);
258
+ harness.stdin.write("\u001b[B");
259
+ await sleep(80);
260
+ harness.stdin.write("\r");
261
+ await sleep(80);
262
+ const output = harness.getOutput();
263
+ assert.match(output, /selection:revise/);
264
+ } finally {
265
+ await harness.cleanup();
266
+ }
267
+ });
@@ -0,0 +1,212 @@
1
+ import { useMemo } from "react";
2
+ import { Box, Text } from "ink";
3
+ import { normalizePlanReviewMarkdown } from "../core/planStorage.js";
4
+ import { getUsableShellWidth } from "./layout.js";
5
+ import { parseMarkdown } from "./Markdown.js";
6
+ import { getTextWidth } from "./textLayout.js";
7
+ import { useTheme } from "./theme.js";
8
+
9
+ // ─── Types ────────────────────────────────────────────────────────────────────
10
+
11
+ type InlinePart =
12
+ | { kind: "text"; text: string }
13
+ | { kind: "code"; text: string }
14
+ | { kind: "bold"; text: string };
15
+
16
+ type PlanReviewRow =
17
+ | { type: "blank" }
18
+ | { type: "header"; text: string }
19
+ | { type: "bullet"; marker: string; text: string }
20
+ | { type: "text"; text: string };
21
+
22
+ type PlanReviewDisplayRow = {
23
+ text: string;
24
+ tone: "text" | "muted";
25
+ bold?: boolean;
26
+ };
27
+
28
+ function inlinePartsToText(parts: InlinePart[]): string {
29
+ return parts.map((part) => part.text).join("");
30
+ }
31
+
32
+ // ─── Helpers ─────────────────────────────────────────────────────────────────
33
+
34
+ export function buildPlanReviewRows(planText: string, workspaceRoot?: string | null): PlanReviewRow[] {
35
+ const normalized = normalizePlanReviewMarkdown(planText, workspaceRoot);
36
+ const segments = parseMarkdown(normalized);
37
+ const rows: PlanReviewRow[] = [];
38
+
39
+ for (const segment of segments) {
40
+ if (rows.length > 0) rows.push({ type: "blank" });
41
+
42
+ if (segment.type === "header") {
43
+ rows.push({ type: "header", text: inlinePartsToText(segment.parts as InlinePart[]) });
44
+ continue;
45
+ }
46
+
47
+ if (segment.type === "list") {
48
+ for (const item of segment.items) {
49
+ rows.push({
50
+ type: "bullet",
51
+ marker: segment.ordered ? `${item.num}.` : "•",
52
+ text: inlinePartsToText(item.parts as InlinePart[]),
53
+ });
54
+ }
55
+ continue;
56
+ }
57
+
58
+ if (segment.type === "para") {
59
+ for (const line of segment.lines) {
60
+ const text = inlinePartsToText(line as InlinePart[]).trim();
61
+ if (text) rows.push({ type: "text", text });
62
+ }
63
+ continue;
64
+ }
65
+
66
+ if (segment.type === "code") {
67
+ for (const line of segment.lines) {
68
+ rows.push({ type: "text", text: line });
69
+ }
70
+ }
71
+ }
72
+
73
+ return rows.filter((row, index) => !(row.type === "blank" && rows[index - 1]?.type === "blank"));
74
+ }
75
+
76
+ function padVisual(text: string, width: number): string {
77
+ const currentWidth = getTextWidth(text);
78
+ if (currentWidth >= width) return text;
79
+ return `${text}${" ".repeat(width - currentWidth)}`;
80
+ }
81
+
82
+ function splitLongWord(word: string, width: number): string[] {
83
+ const chunks: string[] = [];
84
+ let current = "";
85
+
86
+ for (const char of Array.from(word)) {
87
+ if (current && getTextWidth(current + char) > width) {
88
+ chunks.push(current);
89
+ current = char;
90
+ } else {
91
+ current += char;
92
+ }
93
+ }
94
+
95
+ if (current) chunks.push(current);
96
+ return chunks;
97
+ }
98
+
99
+ function wrapReviewText(text: string, width: number): string[] {
100
+ const safeWidth = Math.max(1, width);
101
+ const words = text.trim().split(/\s+/).filter(Boolean);
102
+ const rows: string[] = [];
103
+ let current = "";
104
+
105
+ for (const word of words) {
106
+ if (getTextWidth(word) > safeWidth) {
107
+ if (current) {
108
+ rows.push(current);
109
+ current = "";
110
+ }
111
+ rows.push(...splitLongWord(word, safeWidth));
112
+ continue;
113
+ }
114
+
115
+ const candidate = current ? `${current} ${word}` : word;
116
+ if (getTextWidth(candidate) <= safeWidth) {
117
+ current = candidate;
118
+ } else {
119
+ if (current) rows.push(current);
120
+ current = word;
121
+ }
122
+ }
123
+
124
+ if (current) rows.push(current);
125
+ return rows.length > 0 ? rows : [""];
126
+ }
127
+
128
+ export function buildPlanReviewDisplayRows(rows: PlanReviewRow[], width: number): PlanReviewDisplayRow[] {
129
+ const displayRows: PlanReviewDisplayRow[] = [];
130
+
131
+ for (const row of rows) {
132
+ if (row.type === "blank") {
133
+ displayRows.push({ text: " ", tone: "muted" });
134
+ continue;
135
+ }
136
+
137
+ if (row.type === "header") {
138
+ for (const line of wrapReviewText(row.text, width)) {
139
+ displayRows.push({ text: line || " ", tone: "text", bold: true });
140
+ }
141
+ continue;
142
+ }
143
+
144
+ if (row.type === "bullet") {
145
+ const markerWidth = Math.max(2, getTextWidth(row.marker) + 1);
146
+ const bodyWidth = Math.max(1, width - markerWidth);
147
+ const wrapped = wrapReviewText(row.text, bodyWidth);
148
+
149
+ wrapped.forEach((line, index) => {
150
+ displayRows.push({
151
+ text: `${index === 0 ? `${row.marker} ` : " ".repeat(markerWidth)}${line || " "}`,
152
+ tone: "text",
153
+ });
154
+ });
155
+ continue;
156
+ }
157
+
158
+ for (const line of wrapReviewText(row.text, width)) {
159
+ displayRows.push({ text: line || " ", tone: "text" });
160
+ }
161
+ }
162
+
163
+ return displayRows;
164
+ }
165
+
166
+ function buildTopBorder(width: number, title: string): { title: string; fill: string } {
167
+ const prefixWidth = 3;
168
+ const titleWidth = getTextWidth(title);
169
+ const suffixWidth = 1;
170
+ const fillCount = Math.max(1, width - prefixWidth - titleWidth - suffixWidth);
171
+ return { title, fill: "─".repeat(fillCount) };
172
+ }
173
+
174
+ // ─── Component ────────────────────────────────────────────────────────────────
175
+
176
+ export function PlanReviewPanel({
177
+ planText,
178
+ cols,
179
+ workspaceRoot,
180
+ }: {
181
+ planText: string;
182
+ cols: number;
183
+ workspaceRoot?: string | null;
184
+ }) {
185
+ const theme = useTheme();
186
+ const panelCols = Math.min(Math.max(20, getUsableShellWidth(cols) - 4), 96);
187
+ const contentWidth = Math.max(1, panelCols - 4);
188
+ const rows = useMemo(() => buildPlanReviewRows(planText, workspaceRoot), [planText, workspaceRoot]);
189
+ const displayRows = useMemo(() => buildPlanReviewDisplayRows(rows, contentWidth), [rows, contentWidth]);
190
+ const topBorder = useMemo(() => buildTopBorder(panelCols, "Plan "), [panelCols]);
191
+
192
+ return (
193
+ <Box width="100%" flexDirection="column" paddingX={2}>
194
+ <Text wrap="truncate">
195
+ <Text color={theme.BORDER_SUBTLE}>{"╭─ "}</Text>
196
+ <Text color={theme.TEXT} bold>{topBorder.title}</Text>
197
+ <Text color={theme.BORDER_SUBTLE}>{topBorder.fill}</Text>
198
+ <Text color={theme.BORDER_SUBTLE}>{"╮"}</Text>
199
+ </Text>
200
+ {displayRows.map((row, index) => (
201
+ <Text key={index} wrap="truncate">
202
+ <Text color={theme.BORDER_SUBTLE}>{"│ "}</Text>
203
+ <Text color={row.tone === "muted" ? theme.MUTED : theme.TEXT} bold={row.bold}>
204
+ {padVisual(row.text, contentWidth)}
205
+ </Text>
206
+ <Text color={theme.BORDER_SUBTLE}>{" │"}</Text>
207
+ </Text>
208
+ ))}
209
+ <Text wrap="truncate" color={theme.BORDER_SUBTLE}>{`╰${"─".repeat(Math.max(1, panelCols - 2))}╯`}</Text>
210
+ </Box>
211
+ );
212
+ }
@@ -0,0 +1,161 @@
1
+ import assert from "node:assert/strict";
2
+ import test from "node:test";
3
+ import React from "react";
4
+ import { PassThrough } from "node:stream";
5
+ import { render } from "ink";
6
+ import type { RunEvent, UserPromptEvent } from "../session/types.js";
7
+ import { TEST_RUNTIME } from "../test/runtimeTestUtils.js";
8
+ import { ThemeProvider } from "./theme.js";
9
+ import { TurnGroup } from "./TurnGroup.js";
10
+
11
+ class TestInput extends PassThrough {
12
+ readonly isTTY = true;
13
+
14
+ setRawMode(): this {
15
+ return this;
16
+ }
17
+
18
+ override resume(): this {
19
+ return this;
20
+ }
21
+
22
+ override pause(): this {
23
+ return this;
24
+ }
25
+
26
+ ref(): this {
27
+ return this;
28
+ }
29
+
30
+ unref(): this {
31
+ return this;
32
+ }
33
+ }
34
+
35
+ class TestOutput extends PassThrough {
36
+ readonly isTTY = true;
37
+ columns = 120;
38
+ rows = 40;
39
+ }
40
+
41
+ function stripAnsi(value: string): string {
42
+ return value.replace(/\u001B\[[0-?]*[ -/]*[@-~]/g, "");
43
+ }
44
+
45
+ function sleep(ms = 50): Promise<void> {
46
+ return new Promise((resolve) => setTimeout(resolve, ms));
47
+ }
48
+
49
+ function makeRunningRun(turnId: number): RunEvent {
50
+ return {
51
+ id: 2,
52
+ type: "run",
53
+ createdAt: 2,
54
+ startedAt: 2,
55
+ durationMs: null,
56
+ backendId: "codex-subprocess",
57
+ backendLabel: "Codexa",
58
+ runtime: TEST_RUNTIME,
59
+ prompt: "Do work",
60
+ progressEntries: [],
61
+ status: "running",
62
+ summary: "Running",
63
+ truncatedOutput: false,
64
+ toolActivities: [],
65
+ activity: [],
66
+ touchedFileCount: 0,
67
+ errorMessage: null,
68
+ turnId,
69
+ };
70
+ }
71
+
72
+ function makeUser(turnId: number): UserPromptEvent {
73
+ return {
74
+ id: 1,
75
+ type: "user",
76
+ createdAt: 1,
77
+ prompt: "Do work",
78
+ turnId,
79
+ };
80
+ }
81
+
82
+ function renderTurnGroup(node: React.ReactElement) {
83
+ const stdin = new TestInput();
84
+ const stdout = new TestOutput();
85
+ let output = "";
86
+ stdout.on("data", (chunk) => {
87
+ output += chunk.toString();
88
+ });
89
+ const instance = render(node, {
90
+ stdin: stdin as unknown as NodeJS.ReadStream,
91
+ stdout: stdout as unknown as NodeJS.WriteStream,
92
+ stderr: stdout as unknown as NodeJS.WriteStream,
93
+ debug: true,
94
+ exitOnCtrlC: false,
95
+ });
96
+
97
+ return {
98
+ instance,
99
+ readOutput: () => stripAnsi(output),
100
+ resetOutput: () => {
101
+ output = "";
102
+ },
103
+ };
104
+ }
105
+
106
+ test("prompt card top border stays closed at the top-right corner across rerenders", async () => {
107
+ const turnId = 14;
108
+ const user = makeUser(turnId);
109
+ const run = makeRunningRun(turnId);
110
+
111
+ const harness = renderTurnGroup(
112
+ <ThemeProvider theme="purple">
113
+ <TurnGroup
114
+ cols={80}
115
+ turnIndex={1}
116
+ user={user}
117
+ run={run}
118
+ assistant={null}
119
+ opacity="active"
120
+ question={null}
121
+ runPhase="thinking"
122
+ streamPreviewRows={8}
123
+ streamMode="assistant-first"
124
+ />
125
+ </ThemeProvider>,
126
+ );
127
+
128
+ await sleep();
129
+ let frame = harness.readOutput();
130
+ let topBorder = frame.split("\n").find((line) => line.includes("╭── PROMPT"));
131
+ assert.ok(topBorder, "expected prompt top border line");
132
+ assert.match(topBorder!, /──╮$/);
133
+ assert.doesNotMatch(topBorder!, / ──╮$/);
134
+
135
+ harness.resetOutput();
136
+ harness.instance.rerender(
137
+ <ThemeProvider theme="purple">
138
+ <TurnGroup
139
+ cols={56}
140
+ turnIndex={1}
141
+ user={user}
142
+ run={run}
143
+ assistant={null}
144
+ opacity="active"
145
+ question={null}
146
+ runPhase="thinking"
147
+ streamPreviewRows={8}
148
+ streamMode="assistant-first"
149
+ />
150
+ </ThemeProvider>,
151
+ );
152
+
153
+ await sleep();
154
+ frame = harness.readOutput();
155
+ topBorder = frame.split("\n").find((line) => line.includes("╭── PROMPT"));
156
+ assert.ok(topBorder, "expected prompt top border line after resize rerender");
157
+ assert.match(topBorder!, /──╮$/);
158
+ assert.doesNotMatch(topBorder!, / ──╮$/);
159
+
160
+ harness.instance.unmount();
161
+ });