@litmers/cursorflow-orchestrator 0.1.20 → 0.1.26

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 (224) hide show
  1. package/CHANGELOG.md +9 -0
  2. package/commands/cursorflow-clean.md +19 -0
  3. package/commands/cursorflow-runs.md +59 -0
  4. package/commands/cursorflow-stop.md +55 -0
  5. package/dist/cli/clean.js +171 -0
  6. package/dist/cli/clean.js.map +1 -1
  7. package/dist/cli/index.js +7 -0
  8. package/dist/cli/index.js.map +1 -1
  9. package/dist/cli/init.js +1 -1
  10. package/dist/cli/init.js.map +1 -1
  11. package/dist/cli/logs.js +83 -42
  12. package/dist/cli/logs.js.map +1 -1
  13. package/dist/cli/monitor.d.ts +7 -0
  14. package/dist/cli/monitor.js +1007 -189
  15. package/dist/cli/monitor.js.map +1 -1
  16. package/dist/cli/prepare.js +4 -3
  17. package/dist/cli/prepare.js.map +1 -1
  18. package/dist/cli/resume.js +188 -236
  19. package/dist/cli/resume.js.map +1 -1
  20. package/dist/cli/run.js +8 -3
  21. package/dist/cli/run.js.map +1 -1
  22. package/dist/cli/runs.d.ts +5 -0
  23. package/dist/cli/runs.js +214 -0
  24. package/dist/cli/runs.js.map +1 -0
  25. package/dist/cli/setup-commands.js +0 -0
  26. package/dist/cli/signal.js +1 -1
  27. package/dist/cli/signal.js.map +1 -1
  28. package/dist/cli/stop.d.ts +5 -0
  29. package/dist/cli/stop.js +215 -0
  30. package/dist/cli/stop.js.map +1 -0
  31. package/dist/cli/tasks.d.ts +10 -0
  32. package/dist/cli/tasks.js +165 -0
  33. package/dist/cli/tasks.js.map +1 -0
  34. package/dist/core/auto-recovery.d.ts +212 -0
  35. package/dist/core/auto-recovery.js +737 -0
  36. package/dist/core/auto-recovery.js.map +1 -0
  37. package/dist/core/failure-policy.d.ts +156 -0
  38. package/dist/core/failure-policy.js +488 -0
  39. package/dist/core/failure-policy.js.map +1 -0
  40. package/dist/core/orchestrator.d.ts +15 -2
  41. package/dist/core/orchestrator.js +392 -15
  42. package/dist/core/orchestrator.js.map +1 -1
  43. package/dist/core/reviewer.d.ts +2 -0
  44. package/dist/core/reviewer.js +2 -0
  45. package/dist/core/reviewer.js.map +1 -1
  46. package/dist/core/runner.d.ts +33 -10
  47. package/dist/core/runner.js +321 -146
  48. package/dist/core/runner.js.map +1 -1
  49. package/dist/services/logging/buffer.d.ts +67 -0
  50. package/dist/services/logging/buffer.js +309 -0
  51. package/dist/services/logging/buffer.js.map +1 -0
  52. package/dist/services/logging/console.d.ts +89 -0
  53. package/dist/services/logging/console.js +169 -0
  54. package/dist/services/logging/console.js.map +1 -0
  55. package/dist/services/logging/file-writer.d.ts +71 -0
  56. package/dist/services/logging/file-writer.js +516 -0
  57. package/dist/services/logging/file-writer.js.map +1 -0
  58. package/dist/services/logging/formatter.d.ts +39 -0
  59. package/dist/services/logging/formatter.js +227 -0
  60. package/dist/services/logging/formatter.js.map +1 -0
  61. package/dist/services/logging/index.d.ts +11 -0
  62. package/dist/services/logging/index.js +30 -0
  63. package/dist/services/logging/index.js.map +1 -0
  64. package/dist/services/logging/parser.d.ts +31 -0
  65. package/dist/services/logging/parser.js +222 -0
  66. package/dist/services/logging/parser.js.map +1 -0
  67. package/dist/services/process/index.d.ts +59 -0
  68. package/dist/services/process/index.js +257 -0
  69. package/dist/services/process/index.js.map +1 -0
  70. package/dist/types/agent.d.ts +20 -0
  71. package/dist/types/agent.js +6 -0
  72. package/dist/types/agent.js.map +1 -0
  73. package/dist/types/config.d.ts +65 -0
  74. package/dist/types/config.js +6 -0
  75. package/dist/types/config.js.map +1 -0
  76. package/dist/types/events.d.ts +125 -0
  77. package/dist/types/events.js +6 -0
  78. package/dist/types/events.js.map +1 -0
  79. package/dist/types/index.d.ts +12 -0
  80. package/dist/types/index.js +37 -0
  81. package/dist/types/index.js.map +1 -0
  82. package/dist/types/lane.d.ts +43 -0
  83. package/dist/types/lane.js +6 -0
  84. package/dist/types/lane.js.map +1 -0
  85. package/dist/types/logging.d.ts +71 -0
  86. package/dist/types/logging.js +16 -0
  87. package/dist/types/logging.js.map +1 -0
  88. package/dist/types/review.d.ts +17 -0
  89. package/dist/types/review.js +6 -0
  90. package/dist/types/review.js.map +1 -0
  91. package/dist/types/run.d.ts +32 -0
  92. package/dist/types/run.js +6 -0
  93. package/dist/types/run.js.map +1 -0
  94. package/dist/types/task.d.ts +71 -0
  95. package/dist/types/task.js +6 -0
  96. package/dist/types/task.js.map +1 -0
  97. package/dist/ui/components.d.ts +134 -0
  98. package/dist/ui/components.js +389 -0
  99. package/dist/ui/components.js.map +1 -0
  100. package/dist/ui/log-viewer.d.ts +49 -0
  101. package/dist/ui/log-viewer.js +449 -0
  102. package/dist/ui/log-viewer.js.map +1 -0
  103. package/dist/utils/checkpoint.d.ts +87 -0
  104. package/dist/utils/checkpoint.js +317 -0
  105. package/dist/utils/checkpoint.js.map +1 -0
  106. package/dist/utils/config.d.ts +4 -0
  107. package/dist/utils/config.js +11 -2
  108. package/dist/utils/config.js.map +1 -1
  109. package/dist/utils/cursor-agent.js.map +1 -1
  110. package/dist/utils/dependency.d.ts +74 -0
  111. package/dist/utils/dependency.js +420 -0
  112. package/dist/utils/dependency.js.map +1 -0
  113. package/dist/utils/doctor.js +10 -5
  114. package/dist/utils/doctor.js.map +1 -1
  115. package/dist/utils/enhanced-logger.d.ts +10 -33
  116. package/dist/utils/enhanced-logger.js +94 -9
  117. package/dist/utils/enhanced-logger.js.map +1 -1
  118. package/dist/utils/git.d.ts +121 -0
  119. package/dist/utils/git.js +322 -2
  120. package/dist/utils/git.js.map +1 -1
  121. package/dist/utils/health.d.ts +91 -0
  122. package/dist/utils/health.js +556 -0
  123. package/dist/utils/health.js.map +1 -0
  124. package/dist/utils/lock.d.ts +95 -0
  125. package/dist/utils/lock.js +332 -0
  126. package/dist/utils/lock.js.map +1 -0
  127. package/dist/utils/log-buffer.d.ts +17 -0
  128. package/dist/utils/log-buffer.js +14 -0
  129. package/dist/utils/log-buffer.js.map +1 -0
  130. package/dist/utils/log-constants.d.ts +23 -0
  131. package/dist/utils/log-constants.js +28 -0
  132. package/dist/utils/log-constants.js.map +1 -0
  133. package/dist/utils/log-formatter.d.ts +9 -0
  134. package/dist/utils/log-formatter.js +113 -70
  135. package/dist/utils/log-formatter.js.map +1 -1
  136. package/dist/utils/log-service.d.ts +19 -0
  137. package/dist/utils/log-service.js +47 -0
  138. package/dist/utils/log-service.js.map +1 -0
  139. package/dist/utils/logger.d.ts +46 -27
  140. package/dist/utils/logger.js +82 -60
  141. package/dist/utils/logger.js.map +1 -1
  142. package/dist/utils/process-manager.d.ts +21 -0
  143. package/dist/utils/process-manager.js +138 -0
  144. package/dist/utils/process-manager.js.map +1 -0
  145. package/dist/utils/retry.d.ts +121 -0
  146. package/dist/utils/retry.js +374 -0
  147. package/dist/utils/retry.js.map +1 -0
  148. package/dist/utils/run-service.d.ts +88 -0
  149. package/dist/utils/run-service.js +412 -0
  150. package/dist/utils/run-service.js.map +1 -0
  151. package/dist/utils/state.d.ts +58 -2
  152. package/dist/utils/state.js +306 -3
  153. package/dist/utils/state.js.map +1 -1
  154. package/dist/utils/task-service.d.ts +82 -0
  155. package/dist/utils/task-service.js +348 -0
  156. package/dist/utils/task-service.js.map +1 -0
  157. package/dist/utils/types.d.ts +2 -272
  158. package/dist/utils/types.js +16 -0
  159. package/dist/utils/types.js.map +1 -1
  160. package/package.json +38 -23
  161. package/scripts/ai-security-check.js +0 -1
  162. package/scripts/local-security-gate.sh +0 -0
  163. package/scripts/monitor-lanes.sh +94 -0
  164. package/scripts/patches/test-cursor-agent.js +0 -1
  165. package/scripts/release.sh +0 -0
  166. package/scripts/setup-security.sh +0 -0
  167. package/scripts/stream-logs.sh +72 -0
  168. package/scripts/verify-and-fix.sh +0 -0
  169. package/src/cli/clean.ts +180 -0
  170. package/src/cli/index.ts +7 -0
  171. package/src/cli/init.ts +1 -1
  172. package/src/cli/logs.ts +79 -42
  173. package/src/cli/monitor.ts +1815 -899
  174. package/src/cli/prepare.ts +4 -3
  175. package/src/cli/resume.ts +220 -277
  176. package/src/cli/run.ts +9 -3
  177. package/src/cli/runs.ts +212 -0
  178. package/src/cli/setup-commands.ts +0 -0
  179. package/src/cli/signal.ts +1 -1
  180. package/src/cli/stop.ts +209 -0
  181. package/src/cli/tasks.ts +154 -0
  182. package/src/core/auto-recovery.ts +909 -0
  183. package/src/core/failure-policy.ts +592 -0
  184. package/src/core/orchestrator.ts +1131 -675
  185. package/src/core/reviewer.ts +4 -0
  186. package/src/core/runner.ts +388 -162
  187. package/src/services/logging/buffer.ts +326 -0
  188. package/src/services/logging/console.ts +193 -0
  189. package/src/services/logging/file-writer.ts +526 -0
  190. package/src/services/logging/formatter.ts +268 -0
  191. package/src/services/logging/index.ts +16 -0
  192. package/src/services/logging/parser.ts +232 -0
  193. package/src/services/process/index.ts +261 -0
  194. package/src/types/agent.ts +24 -0
  195. package/src/types/config.ts +79 -0
  196. package/src/types/events.ts +156 -0
  197. package/src/types/index.ts +29 -0
  198. package/src/types/lane.ts +56 -0
  199. package/src/types/logging.ts +96 -0
  200. package/src/types/review.ts +20 -0
  201. package/src/types/run.ts +37 -0
  202. package/src/types/task.ts +79 -0
  203. package/src/ui/components.ts +430 -0
  204. package/src/ui/log-viewer.ts +485 -0
  205. package/src/utils/checkpoint.ts +374 -0
  206. package/src/utils/config.ts +11 -2
  207. package/src/utils/cursor-agent.ts +1 -1
  208. package/src/utils/dependency.ts +482 -0
  209. package/src/utils/doctor.ts +11 -5
  210. package/src/utils/enhanced-logger.ts +108 -49
  211. package/src/utils/git.ts +374 -2
  212. package/src/utils/health.ts +596 -0
  213. package/src/utils/lock.ts +346 -0
  214. package/src/utils/log-buffer.ts +28 -0
  215. package/src/utils/log-constants.ts +26 -0
  216. package/src/utils/log-formatter.ts +120 -37
  217. package/src/utils/log-service.ts +49 -0
  218. package/src/utils/logger.ts +100 -51
  219. package/src/utils/process-manager.ts +100 -0
  220. package/src/utils/retry.ts +413 -0
  221. package/src/utils/run-service.ts +433 -0
  222. package/src/utils/state.ts +369 -3
  223. package/src/utils/task-service.ts +370 -0
  224. package/src/utils/types.ts +2 -315
@@ -0,0 +1,449 @@
1
+ "use strict";
2
+ /**
3
+ * Interactive Log Viewer
4
+ *
5
+ * Provides scrollable, filterable, real-time log viewing with:
6
+ * - Free scrolling (up/down, page up/down, home/end)
7
+ * - Auto-scroll toggle (new logs vs. current position)
8
+ * - Lane filtering (tab to cycle, numbers for direct select)
9
+ * - Importance filtering
10
+ * - Text search
11
+ * - Readable format toggle
12
+ */
13
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
14
+ if (k2 === undefined) k2 = k;
15
+ var desc = Object.getOwnPropertyDescriptor(m, k);
16
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
17
+ desc = { enumerable: true, get: function() { return m[k]; } };
18
+ }
19
+ Object.defineProperty(o, k2, desc);
20
+ }) : (function(o, m, k, k2) {
21
+ if (k2 === undefined) k2 = k;
22
+ o[k2] = m[k];
23
+ }));
24
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
25
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
26
+ }) : function(o, v) {
27
+ o["default"] = v;
28
+ });
29
+ var __importStar = (this && this.__importStar) || (function () {
30
+ var ownKeys = function(o) {
31
+ ownKeys = Object.getOwnPropertyNames || function (o) {
32
+ var ar = [];
33
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
34
+ return ar;
35
+ };
36
+ return ownKeys(o);
37
+ };
38
+ return function (mod) {
39
+ if (mod && mod.__esModule) return mod;
40
+ var result = {};
41
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
42
+ __setModuleDefault(result, mod);
43
+ return result;
44
+ };
45
+ })();
46
+ Object.defineProperty(exports, "__esModule", { value: true });
47
+ exports.LogViewer = void 0;
48
+ exports.startLogViewer = startLogViewer;
49
+ const readline = __importStar(require("readline"));
50
+ const path = __importStar(require("path"));
51
+ const logger = __importStar(require("../utils/logger"));
52
+ const buffer_1 = require("../services/logging/buffer");
53
+ const logging_1 = require("../types/logging");
54
+ const formatter_1 = require("../services/logging/formatter");
55
+ class LogViewer {
56
+ runDir;
57
+ runId;
58
+ logBuffer;
59
+ state;
60
+ pageSize;
61
+ renderInterval = null;
62
+ constructor(runDir) {
63
+ this.runDir = runDir;
64
+ this.runId = path.basename(runDir);
65
+ this.logBuffer = new buffer_1.LogBufferService(runDir);
66
+ this.state = {
67
+ scrollOffset: 0,
68
+ autoScroll: true,
69
+ laneFilter: null,
70
+ importanceFilter: null,
71
+ searchQuery: null,
72
+ searchMode: false,
73
+ searchInput: '',
74
+ readableFormat: false,
75
+ };
76
+ // 화면 높이 - 헤더/푸터 (6줄)
77
+ this.pageSize = (process.stdout.rows || 24) - 6;
78
+ }
79
+ /**
80
+ * 뷰어 시작
81
+ */
82
+ start() {
83
+ // 화면 초기화
84
+ this.setupTerminal();
85
+ // 로그 스트리밍 시작
86
+ this.logBuffer.startStreaming();
87
+ // 새 로그 이벤트
88
+ this.logBuffer.on('update', () => {
89
+ if (this.state.autoScroll) {
90
+ this.scrollToBottom();
91
+ this.logBuffer.acknowledgeNewEntries();
92
+ }
93
+ this.render();
94
+ });
95
+ // 키 입력 처리
96
+ this.setupKeyHandlers();
97
+ // 정기적 렌더링 (100ms) - 화면 크기 변화 대응 및 실시간성 유지
98
+ this.renderInterval = setInterval(() => {
99
+ this.render();
100
+ }, 100);
101
+ // 초기 렌더링
102
+ this.render();
103
+ }
104
+ /**
105
+ * 뷰어 종료
106
+ */
107
+ stop() {
108
+ if (this.renderInterval) {
109
+ clearInterval(this.renderInterval);
110
+ }
111
+ this.logBuffer.stopStreaming();
112
+ this.cleanupTerminal();
113
+ }
114
+ // ─────────────────────────────────────────────────────────────
115
+ // Key Handlers
116
+ // ─────────────────────────────────────────────────────────────
117
+ setupKeyHandlers() {
118
+ readline.emitKeypressEvents(process.stdin);
119
+ if (process.stdin.isTTY) {
120
+ process.stdin.setRawMode(true);
121
+ }
122
+ process.stdin.on('keypress', (str, key) => {
123
+ if (this.state.searchMode) {
124
+ this.handleSearchKey(str, key);
125
+ }
126
+ else {
127
+ this.handleNormalKey(str, key);
128
+ }
129
+ });
130
+ }
131
+ handleNormalKey(str, key) {
132
+ if (!key && !str)
133
+ return;
134
+ const keyName = key?.name;
135
+ // Quit
136
+ if (keyName === 'q' || (key?.ctrl && keyName === 'c')) {
137
+ this.stop();
138
+ process.exit(0);
139
+ }
140
+ // Scroll
141
+ if (keyName === 'up' || str === 'k') {
142
+ this.scrollUp(1);
143
+ }
144
+ else if (keyName === 'down' || str === 'j') {
145
+ this.scrollDown(1);
146
+ }
147
+ else if (keyName === 'pageup' || (key?.ctrl && keyName === 'u')) {
148
+ this.scrollUp(this.pageSize);
149
+ }
150
+ else if (keyName === 'pagedown' || (key?.ctrl && keyName === 'd')) {
151
+ this.scrollDown(this.pageSize);
152
+ }
153
+ else if (keyName === 'home' || str === 'g') {
154
+ this.scrollToTop();
155
+ }
156
+ else if (keyName === 'end' || str === 'G') {
157
+ this.scrollToBottom();
158
+ this.state.autoScroll = true;
159
+ }
160
+ // Auto-scroll toggle
161
+ else if (str === 'a' || str === 'A') {
162
+ this.state.autoScroll = !this.state.autoScroll;
163
+ if (this.state.autoScroll) {
164
+ this.scrollToBottom();
165
+ this.logBuffer.acknowledgeNewEntries();
166
+ }
167
+ }
168
+ // Lane filter
169
+ else if (keyName === 'tab') {
170
+ this.cycleLaneFilter();
171
+ }
172
+ else if (str && str >= '0' && str <= '9') {
173
+ this.selectLaneByNumber(parseInt(str, 10));
174
+ }
175
+ // Importance filter
176
+ else if (str === 'f' || str === 'F') {
177
+ this.cycleImportanceFilter();
178
+ }
179
+ // Readable format toggle
180
+ else if (str === 'r' || str === 'R') {
181
+ this.state.readableFormat = !this.state.readableFormat;
182
+ }
183
+ // Search
184
+ else if (str === '/') {
185
+ this.state.searchMode = true;
186
+ this.state.searchInput = '';
187
+ }
188
+ // Clear filters
189
+ else if (keyName === 'escape') {
190
+ this.clearFilters();
191
+ }
192
+ this.render();
193
+ }
194
+ handleSearchKey(str, key) {
195
+ if (!key)
196
+ return;
197
+ if (key.name === 'return') {
198
+ // 검색 실행
199
+ this.state.searchQuery = this.state.searchInput || null;
200
+ this.state.searchMode = false;
201
+ this.state.scrollOffset = 0;
202
+ }
203
+ else if (key.name === 'escape') {
204
+ // 검색 취소
205
+ this.state.searchMode = false;
206
+ this.state.searchInput = '';
207
+ }
208
+ else if (key.name === 'backspace') {
209
+ this.state.searchInput = this.state.searchInput.slice(0, -1);
210
+ }
211
+ else if (str && str.length === 1 && !key.ctrl && !key.meta) {
212
+ this.state.searchInput += str;
213
+ }
214
+ this.render();
215
+ }
216
+ // ─────────────────────────────────────────────────────────────
217
+ // Scroll Methods
218
+ // ─────────────────────────────────────────────────────────────
219
+ scrollUp(lines) {
220
+ this.state.autoScroll = false;
221
+ this.state.scrollOffset = Math.max(0, this.state.scrollOffset - lines);
222
+ }
223
+ scrollDown(lines) {
224
+ const totalCount = this.getFilteredCount();
225
+ const maxOffset = Math.max(0, totalCount - this.pageSize);
226
+ this.state.scrollOffset = Math.min(maxOffset, this.state.scrollOffset + lines);
227
+ // 맨 아래에 도달하면 자동 스크롤 ON
228
+ if (this.state.scrollOffset >= maxOffset) {
229
+ this.state.autoScroll = true;
230
+ this.logBuffer.acknowledgeNewEntries();
231
+ }
232
+ }
233
+ scrollToTop() {
234
+ this.state.autoScroll = false;
235
+ this.state.scrollOffset = 0;
236
+ }
237
+ scrollToBottom() {
238
+ const totalCount = this.getFilteredCount();
239
+ this.state.scrollOffset = Math.max(0, totalCount - this.pageSize);
240
+ this.logBuffer.acknowledgeNewEntries();
241
+ }
242
+ // ─────────────────────────────────────────────────────────────
243
+ // Filter Methods
244
+ // ─────────────────────────────────────────────────────────────
245
+ cycleLaneFilter() {
246
+ const lanes = this.logBuffer.getLanes();
247
+ if (!this.state.laneFilter) {
248
+ // null -> first lane
249
+ this.state.laneFilter = lanes[0] || null;
250
+ }
251
+ else {
252
+ const currentIndex = lanes.indexOf(this.state.laneFilter);
253
+ if (currentIndex === -1 || currentIndex === lanes.length - 1) {
254
+ // last lane or not found -> null (all)
255
+ this.state.laneFilter = null;
256
+ }
257
+ else {
258
+ this.state.laneFilter = lanes[currentIndex + 1];
259
+ }
260
+ }
261
+ this.state.scrollOffset = 0;
262
+ if (this.state.autoScroll) {
263
+ this.scrollToBottom();
264
+ }
265
+ }
266
+ selectLaneByNumber(num) {
267
+ const lanes = this.logBuffer.getLanes();
268
+ if (num === 0) {
269
+ this.state.laneFilter = null; // All
270
+ }
271
+ else if (num <= lanes.length) {
272
+ this.state.laneFilter = lanes[num - 1];
273
+ }
274
+ this.state.scrollOffset = 0;
275
+ if (this.state.autoScroll) {
276
+ this.scrollToBottom();
277
+ }
278
+ }
279
+ cycleImportanceFilter() {
280
+ const levels = [
281
+ null,
282
+ logging_1.LogImportance.CRITICAL,
283
+ logging_1.LogImportance.HIGH,
284
+ logging_1.LogImportance.MEDIUM,
285
+ logging_1.LogImportance.LOW,
286
+ logging_1.LogImportance.INFO,
287
+ logging_1.LogImportance.DEBUG
288
+ ];
289
+ const currentIndex = levels.indexOf(this.state.importanceFilter);
290
+ this.state.importanceFilter = levels[(currentIndex + 1) % levels.length];
291
+ this.state.scrollOffset = 0;
292
+ if (this.state.autoScroll) {
293
+ this.scrollToBottom();
294
+ }
295
+ }
296
+ clearFilters() {
297
+ this.state.laneFilter = null;
298
+ this.state.importanceFilter = null;
299
+ this.state.searchQuery = null;
300
+ this.state.scrollOffset = 0;
301
+ if (this.state.autoScroll) {
302
+ this.scrollToBottom();
303
+ }
304
+ }
305
+ getFilteredCount() {
306
+ return this.logBuffer.getTotalCount({
307
+ lane: this.state.laneFilter || undefined,
308
+ importance: this.state.importanceFilter || undefined,
309
+ search: this.state.searchQuery || undefined,
310
+ });
311
+ }
312
+ // ─────────────────────────────────────────────────────────────
313
+ // Rendering
314
+ // ─────────────────────────────────────────────────────────────
315
+ setupTerminal() {
316
+ process.stdout.write('\x1b[?1049h'); // Alternative screen
317
+ process.stdout.write('\x1b[?25l'); // Hide cursor
318
+ console.clear();
319
+ }
320
+ cleanupTerminal() {
321
+ process.stdout.write('\x1b[?25h'); // Show cursor
322
+ process.stdout.write('\x1b[?1049l'); // Restore screen
323
+ }
324
+ render() {
325
+ const { gray, cyan, yellow, reset } = logger.COLORS;
326
+ const width = process.stdout.columns || 80;
327
+ const height = process.stdout.rows || 24;
328
+ this.pageSize = height - 6;
329
+ // 데이터 조회
330
+ const entries = this.logBuffer.getEntries({
331
+ offset: this.state.scrollOffset,
332
+ limit: this.pageSize,
333
+ filter: { lane: this.state.laneFilter || undefined, importance: this.state.importanceFilter || undefined, search: this.state.searchQuery || undefined },
334
+ });
335
+ const totalCount = this.getFilteredCount();
336
+ const newCount = this.logBuffer.getNewEntriesCount();
337
+ const bufferState = this.logBuffer.getState();
338
+ // 출력 버퍼
339
+ let output = '';
340
+ // 커서 위치 초기화
341
+ output += '\x1b[H';
342
+ // 헤더
343
+ const line = '━'.repeat(width);
344
+ output += `${cyan}${line}${reset}\n`;
345
+ output += `${cyan}📜 Log Viewer - ${this.runId}${reset}`;
346
+ output += ' '.repeat(Math.max(0, width - 30 - this.runId.length));
347
+ output += `${gray}[F] Filter [/] Search${reset}\n`;
348
+ output += `${cyan}${line}${reset}\n`;
349
+ // 상태 바
350
+ const laneLabel = this.state.laneFilter || 'All Lanes';
351
+ const filterLabel = this.state.importanceFilter || 'none';
352
+ const autoLabel = this.state.autoScroll ? 'ON' : 'OFF';
353
+ const liveIndicator = bufferState.isStreaming ? '🔴 LIVE' : '⚫ STOPPED';
354
+ const readableLabel = this.state.readableFormat ? 'ON' : 'OFF';
355
+ output += `View: [${yellow}${laneLabel}${reset}] `;
356
+ output += `Entries: ${totalCount} `;
357
+ output += `Filter: ${filterLabel} `;
358
+ output += `Readable: ${readableLabel} `;
359
+ output += `${liveIndicator} (Auto-scroll: ${autoLabel})`;
360
+ // 새 로그 카운터 (자동 스크롤 OFF 시)
361
+ if (!this.state.autoScroll && newCount > 0) {
362
+ output += ` ${yellow}▼ +${newCount} new${reset}`;
363
+ }
364
+ // 우측 정렬을 위한 공백 채우기
365
+ const statusLineLen = stripAnsi(output.split('\n').pop() || '').length;
366
+ output += ' '.repeat(Math.max(0, width - statusLineLen));
367
+ output += '\n';
368
+ output += `${cyan}${line}${reset}\n`;
369
+ // 로그 라인
370
+ for (let i = 0; i < this.pageSize; i++) {
371
+ const entry = entries[i];
372
+ if (entry) {
373
+ output += this.formatLogEntry(entry, width) + '\x1b[K\n';
374
+ }
375
+ else {
376
+ output += '\x1b[K\n';
377
+ }
378
+ }
379
+ // 검색 모드
380
+ if (this.state.searchMode) {
381
+ output += `${cyan}Search: ${reset}${this.state.searchInput}█\x1b[K\n`;
382
+ }
383
+ else {
384
+ output += `${cyan}${line}${reset}\x1b[K\n`;
385
+ }
386
+ // 푸터
387
+ const footer = `${gray}[↑/↓/PgUp/PgDn] Scroll [Tab] Lane [A] Auto-scroll [F] Filter [R] Readable [/] Search [Q] Quit${reset}`;
388
+ output += footer;
389
+ output += '\x1b[K'; // 현재 라인 끝까지 지우기
390
+ // 화면 출력
391
+ process.stdout.write(output);
392
+ }
393
+ formatLogEntry(entry, width) {
394
+ const { gray, reset } = logger.COLORS;
395
+ // Use readable format if enabled
396
+ if (this.state.readableFormat) {
397
+ const msgType = (entry.type || entry.level);
398
+ return (0, formatter_1.formatReadableEntry)(entry.timestamp, entry.laneName, msgType, entry.message, { showLane: true, maxWidth: width - 30 });
399
+ }
400
+ const ts = entry.timestamp.toLocaleTimeString('en-US', { hour12: false });
401
+ const lanePad = entry.laneName.substring(0, 12).padEnd(12);
402
+ const levelPad = entry.level.toUpperCase().padEnd(6);
403
+ const levelColor = this.getLevelColor(entry.level);
404
+ // 메시지 길이 제한 (ANSI 코드 제외한 실제 너비 고려)
405
+ const prefix = `[${ts}] [${lanePad}] [${levelPad}] `;
406
+ const prefixLen = prefix.length;
407
+ const maxMsgLen = Math.max(20, width - prefixLen);
408
+ // ANSI 코드 제거 후 길이 계산
409
+ const cleanMsg = stripAnsi(entry.message);
410
+ const msg = cleanMsg.length > maxMsgLen
411
+ ? cleanMsg.substring(0, maxMsgLen - 3) + '...'
412
+ : entry.message; // 원본 메시지 사용 (색상 유지 위해)
413
+ return `${gray}[${ts}]${reset} ${entry.laneColor}[${lanePad}]${reset} ${levelColor}[${levelPad}]${reset} ${msg}`;
414
+ }
415
+ getLevelColor(level) {
416
+ const colors = {
417
+ error: '\x1b[31m', // red
418
+ stderr: '\x1b[31m', // red
419
+ warn: '\x1b[33m', // yellow
420
+ warning: '\x1b[33m', // yellow
421
+ info: '\x1b[36m', // cyan
422
+ stdout: '\x1b[37m', // white
423
+ tool: '\x1b[35m', // magenta
424
+ result: '\x1b[32m', // green
425
+ debug: '\x1b[90m', // gray
426
+ };
427
+ return colors[level.toLowerCase()] || '\x1b[37m';
428
+ }
429
+ }
430
+ exports.LogViewer = LogViewer;
431
+ /**
432
+ * ANSI 코드 제거 유틸리티
433
+ */
434
+ function stripAnsi(str) {
435
+ return str.replace(/\x1b\[[0-9;]*m/g, '');
436
+ }
437
+ /**
438
+ * LogViewer 실행 함수 (CLI 진입점)
439
+ */
440
+ async function startLogViewer(runDir) {
441
+ const viewer = new LogViewer(runDir);
442
+ // 종료 핸들러
443
+ process.on('SIGINT', () => {
444
+ viewer.stop();
445
+ process.exit(0);
446
+ });
447
+ viewer.start();
448
+ }
449
+ //# sourceMappingURL=log-viewer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"log-viewer.js","sourceRoot":"","sources":["../../src/ui/log-viewer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,87 @@
1
+ /**
2
+ * Checkpoint and recovery system for CursorFlow
3
+ */
4
+ import { LaneState } from './types';
5
+ export interface GitState {
6
+ branch: string | null;
7
+ commit: string | null;
8
+ uncommittedChanges: boolean;
9
+ changedFiles: string[];
10
+ }
11
+ export interface Checkpoint {
12
+ id: string;
13
+ timestamp: number;
14
+ laneName: string;
15
+ laneState: LaneState;
16
+ gitState: GitState | null;
17
+ taskIndex: number;
18
+ description?: string;
19
+ }
20
+ export interface CheckpointOptions {
21
+ /** Directory to store checkpoints */
22
+ checkpointDir?: string;
23
+ /** Maximum number of checkpoints to keep per lane */
24
+ maxCheckpoints?: number;
25
+ /** Description of the checkpoint */
26
+ description?: string;
27
+ }
28
+ /**
29
+ * Get checkpoint directory for a lane
30
+ */
31
+ export declare function getCheckpointDir(laneDir: string): string;
32
+ /**
33
+ * Create a checkpoint for a lane
34
+ */
35
+ export declare function createCheckpoint(laneName: string, laneDir: string, worktreeDir: string | null, options?: CheckpointOptions): Promise<Checkpoint>;
36
+ /**
37
+ * List all checkpoints for a lane
38
+ */
39
+ export declare function listCheckpoints(laneDir: string): Checkpoint[];
40
+ /**
41
+ * Get a specific checkpoint
42
+ */
43
+ export declare function getCheckpoint(laneDir: string, checkpointId: string): Checkpoint | null;
44
+ /**
45
+ * Get the latest checkpoint for a lane
46
+ */
47
+ export declare function getLatestCheckpoint(laneDir: string): Checkpoint | null;
48
+ /**
49
+ * Restore lane state from a checkpoint
50
+ */
51
+ export declare function restoreFromCheckpoint(checkpoint: Checkpoint, laneDir: string, options?: {
52
+ restoreGitState?: boolean;
53
+ worktreeDir?: string;
54
+ }): Promise<{
55
+ success: boolean;
56
+ warnings: string[];
57
+ }>;
58
+ /**
59
+ * Delete a checkpoint
60
+ */
61
+ export declare function deleteCheckpoint(laneDir: string, checkpointId: string): boolean;
62
+ /**
63
+ * Auto-checkpoint decorator - creates checkpoints before critical operations
64
+ */
65
+ export declare function withAutoCheckpoint<T extends (...args: any[]) => Promise<any>>(fn: T, options: {
66
+ getLaneDir: (...args: Parameters<T>) => string;
67
+ getLaneName: (...args: Parameters<T>) => string;
68
+ getWorktreeDir?: (...args: Parameters<T>) => string | null;
69
+ description?: string;
70
+ }): T;
71
+ /**
72
+ * Find the best checkpoint to recover from after a failure
73
+ */
74
+ export declare function findRecoveryCheckpoint(laneDir: string, targetTaskIndex?: number): Checkpoint | null;
75
+ /**
76
+ * Checkpoint statistics for monitoring
77
+ */
78
+ export interface CheckpointStats {
79
+ totalCheckpoints: number;
80
+ oldestTimestamp: number | null;
81
+ newestTimestamp: number | null;
82
+ totalSizeBytes: number;
83
+ }
84
+ /**
85
+ * Get checkpoint statistics for a lane
86
+ */
87
+ export declare function getCheckpointStats(laneDir: string): CheckpointStats;