@rajat-rastogi/maestro 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (175) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +254 -0
  3. package/defaults/agents/documentation.txt +18 -0
  4. package/defaults/agents/implementation.txt +16 -0
  5. package/defaults/agents/quality.txt +19 -0
  6. package/defaults/agents/simplification.txt +19 -0
  7. package/defaults/agents/testing.txt +16 -0
  8. package/defaults/config +46 -0
  9. package/defaults/plan-tips.md +50 -0
  10. package/defaults/prompts/finalize.txt +14 -0
  11. package/defaults/prompts/hint_analysis.txt +38 -0
  12. package/defaults/prompts/plan_create.txt +36 -0
  13. package/defaults/prompts/review_first.txt +37 -0
  14. package/defaults/prompts/review_second.txt +36 -0
  15. package/defaults/prompts/task.txt +23 -0
  16. package/dist/backend/backend.d.ts +29 -0
  17. package/dist/backend/backend.d.ts.map +1 -0
  18. package/dist/backend/backend.js +9 -0
  19. package/dist/backend/backend.js.map +1 -0
  20. package/dist/backend/claude.d.ts +12 -0
  21. package/dist/backend/claude.d.ts.map +1 -0
  22. package/dist/backend/claude.js +155 -0
  23. package/dist/backend/claude.js.map +1 -0
  24. package/dist/backend/copilot.d.ts +11 -0
  25. package/dist/backend/copilot.d.ts.map +1 -0
  26. package/dist/backend/copilot.js +110 -0
  27. package/dist/backend/copilot.js.map +1 -0
  28. package/dist/backend/factory.d.ts +4 -0
  29. package/dist/backend/factory.d.ts.map +1 -0
  30. package/dist/backend/factory.js +13 -0
  31. package/dist/backend/factory.js.map +1 -0
  32. package/dist/config/configserver.d.ts +9 -0
  33. package/dist/config/configserver.d.ts.map +1 -0
  34. package/dist/config/configserver.js +141 -0
  35. package/dist/config/configserver.js.map +1 -0
  36. package/dist/config/dump.d.ts +2 -0
  37. package/dist/config/dump.d.ts.map +1 -0
  38. package/dist/config/dump.js +24 -0
  39. package/dist/config/dump.js.map +1 -0
  40. package/dist/config/loader.d.ts +11 -0
  41. package/dist/config/loader.d.ts.map +1 -0
  42. package/dist/config/loader.js +119 -0
  43. package/dist/config/loader.js.map +1 -0
  44. package/dist/config/prompts.d.ts +19 -0
  45. package/dist/config/prompts.d.ts.map +1 -0
  46. package/dist/config/prompts.js +128 -0
  47. package/dist/config/prompts.js.map +1 -0
  48. package/dist/config/reset.d.ts +3 -0
  49. package/dist/config/reset.d.ts.map +1 -0
  50. package/dist/config/reset.js +23 -0
  51. package/dist/config/reset.js.map +1 -0
  52. package/dist/config/template.d.ts +5 -0
  53. package/dist/config/template.d.ts.map +1 -0
  54. package/dist/config/template.js +11 -0
  55. package/dist/config/template.js.map +1 -0
  56. package/dist/config/types.d.ts +35 -0
  57. package/dist/config/types.d.ts.map +1 -0
  58. package/dist/config/types.js +42 -0
  59. package/dist/config/types.js.map +1 -0
  60. package/dist/config/write.d.ts +5 -0
  61. package/dist/config/write.d.ts.map +1 -0
  62. package/dist/config/write.js +59 -0
  63. package/dist/config/write.js.map +1 -0
  64. package/dist/dashboard/assets/config.html +1012 -0
  65. package/dist/dashboard/assets/dashboard.html +871 -0
  66. package/dist/dashboard/assets/help.html +657 -0
  67. package/dist/dashboard/assets.d.ts +2 -0
  68. package/dist/dashboard/assets.d.ts.map +1 -0
  69. package/dist/dashboard/assets.js +5 -0
  70. package/dist/dashboard/assets.js.map +1 -0
  71. package/dist/dashboard/event-bus.d.ts +11 -0
  72. package/dist/dashboard/event-bus.d.ts.map +1 -0
  73. package/dist/dashboard/event-bus.js +4 -0
  74. package/dist/dashboard/event-bus.js.map +1 -0
  75. package/dist/dashboard/replay-parser.d.ts +6 -0
  76. package/dist/dashboard/replay-parser.d.ts.map +1 -0
  77. package/dist/dashboard/replay-parser.js +56 -0
  78. package/dist/dashboard/replay-parser.js.map +1 -0
  79. package/dist/dashboard/server.d.ts +14 -0
  80. package/dist/dashboard/server.d.ts.map +1 -0
  81. package/dist/dashboard/server.js +178 -0
  82. package/dist/dashboard/server.js.map +1 -0
  83. package/dist/dashboard/watcher.d.ts +17 -0
  84. package/dist/dashboard/watcher.d.ts.map +1 -0
  85. package/dist/dashboard/watcher.js +73 -0
  86. package/dist/dashboard/watcher.js.map +1 -0
  87. package/dist/executor/hints.d.ts +21 -0
  88. package/dist/executor/hints.d.ts.map +1 -0
  89. package/dist/executor/hints.js +102 -0
  90. package/dist/executor/hints.js.map +1 -0
  91. package/dist/executor/task.d.ts +19 -0
  92. package/dist/executor/task.d.ts.map +1 -0
  93. package/dist/executor/task.js +119 -0
  94. package/dist/executor/task.js.map +1 -0
  95. package/dist/executor/validation.d.ts +18 -0
  96. package/dist/executor/validation.d.ts.map +1 -0
  97. package/dist/executor/validation.js +73 -0
  98. package/dist/executor/validation.js.map +1 -0
  99. package/dist/git/branch.d.ts +23 -0
  100. package/dist/git/branch.d.ts.map +1 -0
  101. package/dist/git/branch.js +64 -0
  102. package/dist/git/branch.js.map +1 -0
  103. package/dist/git/commit.d.ts +21 -0
  104. package/dist/git/commit.d.ts.map +1 -0
  105. package/dist/git/commit.js +37 -0
  106. package/dist/git/commit.js.map +1 -0
  107. package/dist/git/diff.d.ts +15 -0
  108. package/dist/git/diff.d.ts.map +1 -0
  109. package/dist/git/diff.js +26 -0
  110. package/dist/git/diff.js.map +1 -0
  111. package/dist/git/git.d.ts +9 -0
  112. package/dist/git/git.d.ts.map +1 -0
  113. package/dist/git/git.js +20 -0
  114. package/dist/git/git.js.map +1 -0
  115. package/dist/git/gitignore.d.ts +2 -0
  116. package/dist/git/gitignore.d.ts.map +1 -0
  117. package/dist/git/gitignore.js +66 -0
  118. package/dist/git/gitignore.js.map +1 -0
  119. package/dist/git/worktree.d.ts +3 -0
  120. package/dist/git/worktree.d.ts.map +1 -0
  121. package/dist/git/worktree.js +17 -0
  122. package/dist/git/worktree.js.map +1 -0
  123. package/dist/main.d.ts +3 -0
  124. package/dist/main.d.ts.map +1 -0
  125. package/dist/main.js +212 -0
  126. package/dist/main.js.map +1 -0
  127. package/dist/orchestrator/orchestrator.d.ts +21 -0
  128. package/dist/orchestrator/orchestrator.d.ts.map +1 -0
  129. package/dist/orchestrator/orchestrator.js +218 -0
  130. package/dist/orchestrator/orchestrator.js.map +1 -0
  131. package/dist/plan/creator.d.ts +27 -0
  132. package/dist/plan/creator.d.ts.map +1 -0
  133. package/dist/plan/creator.js +251 -0
  134. package/dist/plan/creator.js.map +1 -0
  135. package/dist/plan/parser.d.ts +11 -0
  136. package/dist/plan/parser.d.ts.map +1 -0
  137. package/dist/plan/parser.js +151 -0
  138. package/dist/plan/parser.js.map +1 -0
  139. package/dist/plan/types.d.ts +23 -0
  140. package/dist/plan/types.d.ts.map +1 -0
  141. package/dist/plan/types.js +2 -0
  142. package/dist/plan/types.js.map +1 -0
  143. package/dist/plan/updater.d.ts +16 -0
  144. package/dist/plan/updater.d.ts.map +1 -0
  145. package/dist/plan/updater.js +59 -0
  146. package/dist/plan/updater.js.map +1 -0
  147. package/dist/progress/colors.d.ts +9 -0
  148. package/dist/progress/colors.d.ts.map +1 -0
  149. package/dist/progress/colors.js +39 -0
  150. package/dist/progress/colors.js.map +1 -0
  151. package/dist/progress/logger.d.ts +17 -0
  152. package/dist/progress/logger.d.ts.map +1 -0
  153. package/dist/progress/logger.js +101 -0
  154. package/dist/progress/logger.js.map +1 -0
  155. package/dist/progress/notify.d.ts +2 -0
  156. package/dist/progress/notify.d.ts.map +1 -0
  157. package/dist/progress/notify.js +37 -0
  158. package/dist/progress/notify.js.map +1 -0
  159. package/dist/progress/timestamp.d.ts +5 -0
  160. package/dist/progress/timestamp.d.ts.map +1 -0
  161. package/dist/progress/timestamp.js +13 -0
  162. package/dist/progress/timestamp.js.map +1 -0
  163. package/dist/review/agents.d.ts +18 -0
  164. package/dist/review/agents.d.ts.map +1 -0
  165. package/dist/review/agents.js +43 -0
  166. package/dist/review/agents.js.map +1 -0
  167. package/dist/review/pipeline.d.ts +36 -0
  168. package/dist/review/pipeline.d.ts.map +1 -0
  169. package/dist/review/pipeline.js +210 -0
  170. package/dist/review/pipeline.js.map +1 -0
  171. package/dist/sea.d.ts +19 -0
  172. package/dist/sea.d.ts.map +1 -0
  173. package/dist/sea.js +41 -0
  174. package/dist/sea.js.map +1 -0
  175. package/package.json +57 -0
@@ -0,0 +1,11 @@
1
+ import { EventEmitter } from 'events';
2
+ import { Phase } from '../progress/colors.js';
3
+ export interface LogEvent {
4
+ ts: string;
5
+ phase: Phase | 'header' | 'signal' | 'info';
6
+ text: string;
7
+ level: 'log' | 'header' | 'signal' | 'error' | 'warn' | 'info' | 'debug';
8
+ }
9
+ export declare class EventBus extends EventEmitter {
10
+ }
11
+ //# sourceMappingURL=event-bus.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../src/dashboard/event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAE9C,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAC1E;AAED,qBAAa,QAAS,SAAQ,YAAY;CAAG"}
@@ -0,0 +1,4 @@
1
+ import { EventEmitter } from 'events';
2
+ export class EventBus extends EventEmitter {
3
+ }
4
+ //# sourceMappingURL=event-bus.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../../src/dashboard/event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAUtC,MAAM,OAAO,QAAS,SAAQ,YAAY;CAAG"}
@@ -0,0 +1,6 @@
1
+ import { LogEvent } from './event-bus.js';
2
+ export declare function parseProgressFile(filePath: string): {
3
+ events: LogEvent[];
4
+ planContent: string;
5
+ };
6
+ //# sourceMappingURL=replay-parser.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"replay-parser.d.ts","sourceRoot":"","sources":["../../src/dashboard/replay-parser.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI1C,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAsD/F"}
@@ -0,0 +1,56 @@
1
+ import * as fs from 'fs';
2
+ import * as path from 'path';
3
+ const SIGNAL_WORDS = ['PLAN_COMPLETE', 'REVIEW_DONE', 'ALL_TASKS_DONE'];
4
+ export function parseProgressFile(filePath) {
5
+ const content = fs.readFileSync(filePath, 'utf8');
6
+ const lines = content.split('\n');
7
+ const events = [];
8
+ // Extract plan file from "starting maestro loop: path/to/plan.md (max N iterations)"
9
+ let planContent = '';
10
+ const planFileMatch = content.match(/^starting maestro loop: (.+?\.md) \(/m);
11
+ if (planFileMatch) {
12
+ const cwd = path.dirname(path.dirname(path.dirname(path.resolve(filePath))));
13
+ const fullPath = path.join(cwd, planFileMatch[1]);
14
+ try {
15
+ planContent = fs.readFileSync(fullPath, 'utf8');
16
+ }
17
+ catch {
18
+ try {
19
+ planContent = fs.readFileSync(path.join(path.dirname(fullPath), 'completed', path.basename(fullPath)), 'utf8');
20
+ }
21
+ catch { /* not found */ }
22
+ }
23
+ }
24
+ let currentPhase = 'info';
25
+ for (const raw of lines) {
26
+ const line = raw.trimEnd();
27
+ if (!line)
28
+ continue;
29
+ const tsMatch = line.match(/^(\[\d{2}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}\]) (.*)/);
30
+ if (tsMatch) {
31
+ events.push({ ts: tsMatch[1], text: tsMatch[2], phase: currentPhase, level: 'log' });
32
+ continue;
33
+ }
34
+ if (line.startsWith('---')) {
35
+ const t = line.toLowerCase();
36
+ if (t.includes('task iteration'))
37
+ currentPhase = 'task';
38
+ else if (t.includes('claude review') || t.includes('claude eval'))
39
+ currentPhase = 'claude_eval';
40
+ else if (t.includes('review'))
41
+ currentPhase = 'review';
42
+ else
43
+ currentPhase = 'info';
44
+ events.push({ ts: '', text: line, phase: 'warn', level: 'header' });
45
+ continue;
46
+ }
47
+ if (SIGNAL_WORDS.some(s => line.includes(s))) {
48
+ currentPhase = 'info';
49
+ events.push({ ts: '', text: line, phase: 'signal', level: 'signal' });
50
+ continue;
51
+ }
52
+ events.push({ ts: '', text: line, phase: currentPhase, level: 'info' });
53
+ }
54
+ return { events, planContent };
55
+ }
56
+ //# sourceMappingURL=replay-parser.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"replay-parser.js","sourceRoot":"","sources":["../../src/dashboard/replay-parser.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ import { EventBus } from './event-bus.js';
2
+ export declare class DashboardServer {
3
+ private clients;
4
+ private history;
5
+ private planFile;
6
+ private planContent;
7
+ private sessionId;
8
+ private server;
9
+ private watcher;
10
+ private replayMode;
11
+ start(port: number, eventBus: EventBus | null, planFile: string, watchDirs: string[], replayMode?: boolean): void;
12
+ stop(): void;
13
+ }
14
+ //# sourceMappingURL=server.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/dashboard/server.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAY,MAAM,gBAAgB,CAAC;AAIpD,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,UAAU,CAAS;IAE3B,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,UAAU,UAAQ,GAAG,IAAI;IA8J/G,IAAI,IAAI,IAAI;CAab"}
@@ -0,0 +1,178 @@
1
+ import * as http from 'http';
2
+ import * as fs from 'fs';
3
+ import { SessionWatcher } from './watcher.js';
4
+ import { readEmbeddedHtml } from './assets.js';
5
+ export class DashboardServer {
6
+ clients = new Set();
7
+ history = [];
8
+ planFile = '';
9
+ planContent = ''; // cached so we can serve after the file is moved to completed/
10
+ sessionId = `session-${Date.now()}`;
11
+ server = null;
12
+ watcher = null;
13
+ replayMode = false;
14
+ start(port, eventBus, planFile, watchDirs, replayMode = false) {
15
+ this.planFile = planFile;
16
+ this.replayMode = replayMode;
17
+ // Always start watcher when dirs are provided (required for replay mode)
18
+ if (watchDirs.length > 0) {
19
+ this.watcher = new SessionWatcher(watchDirs);
20
+ this.watcher.start();
21
+ }
22
+ // Subscribe to live events only when an EventBus is provided
23
+ if (eventBus) {
24
+ eventBus.on('log', (event) => {
25
+ this.history.push(event);
26
+ if (this.history.length > 5000) {
27
+ this.history.splice(0, 1000);
28
+ }
29
+ const data = `data: ${JSON.stringify(event)}\n\n`;
30
+ for (const client of this.clients) {
31
+ try {
32
+ client.write(data);
33
+ }
34
+ catch {
35
+ this.clients.delete(client);
36
+ }
37
+ }
38
+ });
39
+ }
40
+ this.server = http.createServer((req, res) => {
41
+ const url = req.url ?? '/';
42
+ const method = req.method ?? 'GET';
43
+ if (method !== 'GET') {
44
+ res.writeHead(405);
45
+ res.end();
46
+ return;
47
+ }
48
+ if (url === '/') {
49
+ let html;
50
+ try {
51
+ html = readEmbeddedHtml();
52
+ }
53
+ catch {
54
+ res.writeHead(500, { 'Content-Type': 'text/plain' });
55
+ res.end('Dashboard HTML not found. Run npm run build first.');
56
+ return;
57
+ }
58
+ // Inject replay mode flag before </head> so it is set before the IIFE script runs.
59
+ // Do NOT inject before </body>: that places the <script> after the IIFE </script>,
60
+ // so when the IIFE checks typeof window.__REPLAY_MODE__ the variable is not yet defined.
61
+ if (this.replayMode) {
62
+ html = html.replace('</head>', '<script>window.__REPLAY_MODE__=true;<\/script>\n</head>');
63
+ }
64
+ res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
65
+ res.end(html);
66
+ return;
67
+ }
68
+ if (url === '/events') {
69
+ res.writeHead(200, {
70
+ 'Content-Type': 'text/event-stream',
71
+ 'Cache-Control': 'no-cache',
72
+ 'Connection': 'keep-alive',
73
+ 'Access-Control-Allow-Origin': '*',
74
+ });
75
+ res.write('\n');
76
+ // Replay history to late-joining clients (live mode only)
77
+ for (const event of this.history) {
78
+ res.write(`data: ${JSON.stringify(event)}\n\n`);
79
+ }
80
+ this.clients.add(res);
81
+ req.on('close', () => {
82
+ this.clients.delete(res);
83
+ });
84
+ return;
85
+ }
86
+ if (url === '/sessions') {
87
+ const sessions = this.watcher
88
+ ? this.watcher.getSessions()
89
+ : [{ id: this.sessionId, active: true, planFile: this.planFile }];
90
+ res.writeHead(200, {
91
+ 'Content-Type': 'application/json',
92
+ 'Access-Control-Allow-Origin': '*',
93
+ });
94
+ res.end(JSON.stringify(sessions));
95
+ return;
96
+ }
97
+ if (url === '/plan') {
98
+ if (!this.planFile) {
99
+ res.writeHead(404, { 'Content-Type': 'text/plain' });
100
+ res.end('No plan file');
101
+ return;
102
+ }
103
+ try {
104
+ const content = fs.readFileSync(this.planFile, 'utf8');
105
+ this.planContent = content; // keep cache fresh
106
+ res.writeHead(200, { 'Content-Type': 'text/plain; charset=utf-8' });
107
+ res.end(content);
108
+ }
109
+ catch {
110
+ // File may have been moved to completed/ — serve the last cached content
111
+ if (this.planContent) {
112
+ res.writeHead(200, { 'Content-Type': 'text/plain; charset=utf-8' });
113
+ res.end(this.planContent);
114
+ }
115
+ else {
116
+ res.writeHead(404, { 'Content-Type': 'text/plain' });
117
+ res.end('Plan file not found');
118
+ }
119
+ }
120
+ return;
121
+ }
122
+ // Replay endpoint: parse a progress file by session id and return events as JSON
123
+ if (url.startsWith('/replay')) {
124
+ const params = new URL(url, 'http://localhost').searchParams;
125
+ const id = params.get('id');
126
+ if (!id) {
127
+ res.writeHead(400, { 'Content-Type': 'text/plain' });
128
+ res.end('Missing id parameter');
129
+ return;
130
+ }
131
+ const session = this.watcher?.getSessions().find(s => s.id === id);
132
+ if (!session) {
133
+ res.writeHead(404, { 'Content-Type': 'text/plain' });
134
+ res.end('Session not found');
135
+ return;
136
+ }
137
+ import('./replay-parser.js').then(({ parseProgressFile }) => {
138
+ try {
139
+ const result = parseProgressFile(session.progressFile);
140
+ res.writeHead(200, {
141
+ 'Content-Type': 'application/json',
142
+ 'Access-Control-Allow-Origin': '*',
143
+ });
144
+ res.end(JSON.stringify(result));
145
+ }
146
+ catch {
147
+ res.writeHead(500, { 'Content-Type': 'text/plain' });
148
+ res.end('Failed to parse progress file');
149
+ }
150
+ }).catch(() => {
151
+ res.writeHead(500, { 'Content-Type': 'text/plain' });
152
+ res.end('Internal error');
153
+ });
154
+ return;
155
+ }
156
+ res.writeHead(404, { 'Content-Type': 'text/plain' });
157
+ res.end('Not found');
158
+ });
159
+ this.server.listen(port, () => {
160
+ // Server started
161
+ });
162
+ }
163
+ stop() {
164
+ this.watcher?.stop();
165
+ for (const client of this.clients) {
166
+ try {
167
+ client.end();
168
+ }
169
+ catch {
170
+ // ignore
171
+ }
172
+ }
173
+ this.clients.clear();
174
+ this.server?.close();
175
+ this.server = null;
176
+ }
177
+ }
178
+ //# sourceMappingURL=server.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/dashboard/server.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,17 @@
1
+ export interface Session {
2
+ id: string;
3
+ planName: string;
4
+ progressFile: string;
5
+ active: boolean;
6
+ }
7
+ export declare class SessionWatcher {
8
+ private watchDirs;
9
+ private sessions;
10
+ private watchers;
11
+ constructor(watchDirs: string[]);
12
+ start(): void;
13
+ stop(): void;
14
+ getSessions(): Session[];
15
+ private scanDir;
16
+ }
17
+ //# sourceMappingURL=watcher.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/dashboard/watcher.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,cAAc;IAIb,OAAO,CAAC,SAAS;IAH7B,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,QAAQ,CAAsB;gBAElB,SAAS,EAAE,MAAM,EAAE;IAEvC,KAAK,IAAI,IAAI;IAiBb,IAAI,IAAI,IAAI;IAWZ,WAAW,IAAI,OAAO,EAAE;IAIxB,OAAO,CAAC,OAAO;CA6BhB"}
@@ -0,0 +1,73 @@
1
+ import * as fs from 'fs';
2
+ import * as path from 'path';
3
+ export class SessionWatcher {
4
+ watchDirs;
5
+ sessions = new Map();
6
+ watchers = [];
7
+ constructor(watchDirs) {
8
+ this.watchDirs = watchDirs;
9
+ }
10
+ start() {
11
+ for (const dir of this.watchDirs) {
12
+ this.scanDir(dir);
13
+ const progressDir = path.join(dir, '.maestro', 'progress');
14
+ try {
15
+ const watcher = fs.watch(progressDir, { persistent: false }, (_event, filename) => {
16
+ if (filename && filename.startsWith('progress-') && filename.endsWith('.txt')) {
17
+ this.scanDir(dir);
18
+ }
19
+ });
20
+ this.watchers.push(watcher);
21
+ }
22
+ catch {
23
+ // Directory may not exist yet; skip watching
24
+ }
25
+ }
26
+ }
27
+ stop() {
28
+ for (const w of this.watchers) {
29
+ try {
30
+ w.close();
31
+ }
32
+ catch {
33
+ // ignore
34
+ }
35
+ }
36
+ this.watchers = [];
37
+ }
38
+ getSessions() {
39
+ return Array.from(this.sessions.values());
40
+ }
41
+ scanDir(dir) {
42
+ const progressDir = path.join(dir, '.maestro', 'progress');
43
+ let files;
44
+ try {
45
+ files = fs.readdirSync(progressDir);
46
+ }
47
+ catch {
48
+ return;
49
+ }
50
+ const fiveMinutesAgo = Date.now() - 5 * 60 * 1000;
51
+ for (const file of files) {
52
+ if (!file.startsWith('progress-') || !file.endsWith('.txt'))
53
+ continue;
54
+ const fullPath = path.join(progressDir, file);
55
+ let stat;
56
+ try {
57
+ stat = fs.statSync(fullPath);
58
+ }
59
+ catch {
60
+ continue;
61
+ }
62
+ const planName = file.replace(/^progress-/, '').replace(/\.txt$/, '');
63
+ const id = `${dir}::${planName}`;
64
+ this.sessions.set(id, {
65
+ id,
66
+ planName,
67
+ progressFile: fullPath,
68
+ active: stat.mtimeMs > fiveMinutesAgo,
69
+ });
70
+ }
71
+ }
72
+ }
73
+ //# sourceMappingURL=watcher.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"watcher.js","sourceRoot":"","sources":["../../src/dashboard/watcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAS7B,MAAM,OAAO,cAAc;IAIL;IAHZ,QAAQ,GAAyB,IAAI,GAAG,EAAE,CAAC;IAC3C,QAAQ,GAAmB,EAAE,CAAC;IAEtC,YAAoB,SAAmB;QAAnB,cAAS,GAAT,SAAS,CAAU;IAAG,CAAC;IAE3C,KAAK;QACH,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAClB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;YAC3D,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;oBAChF,IAAI,QAAQ,IAAI,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;wBAC9E,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;oBACpB,CAAC;gBACH,CAAC,CAAC,CAAC;gBACH,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC9B,CAAC;YAAC,MAAM,CAAC;gBACP,6CAA6C;YAC/C,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI;QACF,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,CAAC,CAAC,KAAK,EAAE,CAAC;YACZ,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;IACrB,CAAC;IAED,WAAW;QACT,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;IAEO,OAAO,CAAC,GAAW;QACzB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;QAC3D,IAAI,KAAe,CAAC;QACpB,IAAI,CAAC;YACH,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QAED,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;QAClD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAAE,SAAS;YACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YAC9C,IAAI,IAAc,CAAC;YACnB,IAAI,CAAC;gBACH,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC/B,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YACtE,MAAM,EAAE,GAAG,GAAG,GAAG,KAAK,QAAQ,EAAE,CAAC;YACjC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE;gBACpB,EAAE;gBACF,QAAQ;gBACR,YAAY,EAAE,QAAQ;gBACtB,MAAM,EAAE,IAAI,CAAC,OAAO,GAAG,cAAc;aACtC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}
@@ -0,0 +1,21 @@
1
+ import { Plan, Task } from '../plan/types.js';
2
+ import { ValidationResult } from './validation.js';
3
+ import { Logger } from '../progress/logger.js';
4
+ import { AIProvider } from '../backend/backend.js';
5
+ import { Config } from '../config/types.js';
6
+ export interface ValidationHint {
7
+ title: string;
8
+ explanation: string;
9
+ suggestion: string;
10
+ }
11
+ /**
12
+ * Analyze a validation failure using the configured AI provider to determine whether
13
+ * the failure is caused by a structural problem in the plan document.
14
+ *
15
+ * Returns a ValidationHint if the AI identifies a plan problem, or null if:
16
+ * - The AI determines it is a normal code bug / transient error
17
+ * - The AI call fails for any reason (auth, spawn, parse)
18
+ */
19
+ export declare function analyzeValidationFailure(results: ValidationResult[], plan: Plan, task: Task, backend: AIProvider, config: Config, logger: Logger): Promise<ValidationHint | null>;
20
+ export declare function displayHint(logger: Logger, hint: ValidationHint): void;
21
+ //# sourceMappingURL=hints.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hints.d.ts","sourceRoot":"","sources":["../../src/executor/hints.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAI5C,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAoDD;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,gBAAgB,EAAE,EAC3B,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAyBhC;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CActE"}
@@ -0,0 +1,102 @@
1
+ import * as fs from 'fs';
2
+ import { loadPrompt } from '../config/prompts.js';
3
+ import { expandTemplate } from '../config/template.js';
4
+ const PROGRESS_TAIL_LINES = 60;
5
+ function readLastLines(filePath, n) {
6
+ try {
7
+ const content = fs.readFileSync(filePath, 'utf8');
8
+ const lines = content.split('\n');
9
+ return lines.slice(-n).join('\n');
10
+ }
11
+ catch {
12
+ return '';
13
+ }
14
+ }
15
+ function buildValidationErrorText(results) {
16
+ const parts = [];
17
+ for (const result of results) {
18
+ if (result.passed)
19
+ continue;
20
+ parts.push(`Command: ${result.command} (exit ${result.exitCode})`);
21
+ if (result.stdout)
22
+ parts.push(`stdout: ${result.stdout.slice(0, 800)}`);
23
+ if (result.stderr)
24
+ parts.push(`stderr: ${result.stderr.slice(0, 800)}`);
25
+ parts.push('');
26
+ }
27
+ return parts.join('\n').trim();
28
+ }
29
+ function extractJsonBlock(text) {
30
+ const match = /```json\s*([\s\S]*?)```/.exec(text);
31
+ return match ? match[1] ?? null : null;
32
+ }
33
+ function parseAIResponse(rawText) {
34
+ const trimmed = rawText.trim();
35
+ if (!trimmed || trimmed.includes('NO_PLAN_ISSUE'))
36
+ return null;
37
+ const jsonBlock = extractJsonBlock(trimmed);
38
+ if (!jsonBlock)
39
+ return null;
40
+ let parsed;
41
+ try {
42
+ parsed = JSON.parse(jsonBlock);
43
+ }
44
+ catch {
45
+ return null;
46
+ }
47
+ const h = parsed;
48
+ if (typeof h['title'] === 'string' &&
49
+ typeof h['explanation'] === 'string' &&
50
+ typeof h['suggestion'] === 'string') {
51
+ return { title: h['title'], explanation: h['explanation'], suggestion: h['suggestion'] };
52
+ }
53
+ return null;
54
+ }
55
+ /**
56
+ * Analyze a validation failure using the configured AI provider to determine whether
57
+ * the failure is caused by a structural problem in the plan document.
58
+ *
59
+ * Returns a ValidationHint if the AI identifies a plan problem, or null if:
60
+ * - The AI determines it is a normal code bug / transient error
61
+ * - The AI call fails for any reason (auth, spawn, parse)
62
+ */
63
+ export async function analyzeValidationFailure(results, plan, task, backend, config, logger) {
64
+ try {
65
+ logger.log('Analyzing failure with AI...', 'task');
66
+ const progressTail = readLastLines(logger.getProgressFilePath(), PROGRESS_TAIL_LINES);
67
+ const prompt = expandTemplate(loadPrompt('hint_analysis', config), {
68
+ TASK_INDEX: task.index,
69
+ TASK_TITLE: task.title,
70
+ PLAN_CONTENT: plan.lines.join('\n'),
71
+ VALIDATION_ERRORS: buildValidationErrorText(results),
72
+ PROGRESS_TAIL: progressTail || '(no progress log available)',
73
+ });
74
+ const collectedLines = [];
75
+ await backend.run(prompt, (line) => {
76
+ if (line.type === 'text' || line.type === 'result') {
77
+ if (line.text.trim())
78
+ collectedLines.push(line.text);
79
+ }
80
+ });
81
+ return parseAIResponse(collectedLines.join('\n'));
82
+ }
83
+ catch {
84
+ return null; // graceful fallback — never block the main error
85
+ }
86
+ }
87
+ export function displayHint(logger, hint) {
88
+ const width = 54;
89
+ const border = '═'.repeat(width);
90
+ logger.warn(`╔══ MAESTRO TIP ${border.slice(15)}╗`);
91
+ logger.warn(` ${hint.title}`);
92
+ logger.warn('');
93
+ for (const line of hint.explanation.split('\n')) {
94
+ logger.warn(` ${line}`);
95
+ }
96
+ logger.warn('');
97
+ for (const line of hint.suggestion.split('\n')) {
98
+ logger.warn(` ${line}`);
99
+ }
100
+ logger.warn(`╚${'═'.repeat(width + 2)}╝`);
101
+ }
102
+ //# sourceMappingURL=hints.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hints.js","sourceRoot":"","sources":["../../src/executor/hints.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,19 @@
1
+ import { Config } from '../config/types.js';
2
+ import { AIProvider } from '../backend/backend.js';
3
+ import { Logger } from '../progress/logger.js';
4
+ import { Plan, Task } from '../plan/types.js';
5
+ export interface TaskExecutorOptions {
6
+ config: Config;
7
+ backend: AIProvider;
8
+ logger: Logger;
9
+ defaultBranch: string;
10
+ progressFilePath: string;
11
+ cwd: string;
12
+ }
13
+ export declare class TaskExecutor {
14
+ private readonly opts;
15
+ constructor(opts: TaskExecutorOptions);
16
+ executeTask(plan: Plan, task: Task): Promise<void>;
17
+ private runTaskSession;
18
+ }
19
+ //# sourceMappingURL=task.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/executor/task.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAU9C,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,UAAU,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,mBAAmB;IAEhD,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;YAgF1C,cAAc;CA6B7B"}