@simonren/quorum 0.9.1 → 0.11.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 (68) hide show
  1. package/README.md +91 -48
  2. package/commands/multi-consult.md +47 -72
  3. package/commands/multi-review.md +68 -99
  4. package/dist/adapters/base.d.ts +53 -70
  5. package/dist/adapters/base.js +21 -79
  6. package/dist/adapters/claude.d.ts +38 -17
  7. package/dist/adapters/claude.js +93 -185
  8. package/dist/adapters/cli-adapter.d.ts +78 -0
  9. package/dist/adapters/cli-adapter.js +220 -0
  10. package/dist/adapters/codex.d.ts +18 -13
  11. package/dist/adapters/codex.js +64 -200
  12. package/dist/adapters/gemini.d.ts +45 -21
  13. package/dist/adapters/gemini.js +81 -152
  14. package/dist/adapters/index.d.ts +8 -5
  15. package/dist/adapters/index.js +7 -8
  16. package/dist/config.d.ts +98 -28
  17. package/dist/config.js +44 -25
  18. package/dist/consult-prompt.d.ts +6 -5
  19. package/dist/consult-prompt.js +48 -23
  20. package/dist/decoders/claude.d.ts +6 -0
  21. package/dist/decoders/claude.js +10 -1
  22. package/dist/doctor.d.ts +20 -0
  23. package/dist/doctor.js +91 -0
  24. package/dist/executor.d.ts +58 -46
  25. package/dist/executor.js +218 -129
  26. package/dist/guards.d.ts +29 -0
  27. package/dist/guards.js +72 -0
  28. package/dist/handoff.d.ts +79 -229
  29. package/dist/handoff.js +411 -402
  30. package/dist/index.d.ts +8 -12
  31. package/dist/index.js +81 -106
  32. package/dist/integrity.d.ts +16 -0
  33. package/dist/integrity.js +49 -0
  34. package/dist/sections.d.ts +22 -0
  35. package/dist/sections.js +31 -0
  36. package/dist/server.d.ts +9 -0
  37. package/dist/server.js +36 -0
  38. package/dist/tools/consult.d.ts +17 -76
  39. package/dist/tools/consult.js +72 -188
  40. package/dist/tools/format.d.ts +35 -0
  41. package/dist/tools/format.js +85 -0
  42. package/dist/tools/review.d.ts +55 -0
  43. package/dist/tools/review.js +120 -0
  44. package/dist/types.d.ts +20 -103
  45. package/dist/types.js +18 -29
  46. package/package.json +7 -4
  47. package/dist/cli/check.d.ts +0 -20
  48. package/dist/cli/check.js +0 -78
  49. package/dist/cli/codex.d.ts +0 -11
  50. package/dist/cli/codex.js +0 -255
  51. package/dist/cli/gemini.d.ts +0 -12
  52. package/dist/cli/gemini.js +0 -253
  53. package/dist/context.d.ts +0 -1538
  54. package/dist/context.js +0 -383
  55. package/dist/decoders/gemini.d.ts +0 -33
  56. package/dist/decoders/gemini.js +0 -58
  57. package/dist/errors.d.ts +0 -46
  58. package/dist/errors.js +0 -198
  59. package/dist/pipeline.d.ts +0 -135
  60. package/dist/pipeline.js +0 -462
  61. package/dist/prompt-v2.d.ts +0 -38
  62. package/dist/prompt-v2.js +0 -391
  63. package/dist/prompt.d.ts +0 -71
  64. package/dist/prompt.js +0 -309
  65. package/dist/schema.d.ts +0 -660
  66. package/dist/schema.js +0 -536
  67. package/dist/tools/feedback.d.ts +0 -91
  68. package/dist/tools/feedback.js +0 -117
@@ -1,253 +0,0 @@
1
- /**
2
- * Gemini CLI Wrapper
3
- *
4
- * Uses Google's Gemini CLI in non-interactive mode (gemini -p)
5
- * Reference: https://github.com/google-gemini/gemini-cli
6
- * Package: @google/gemini-cli
7
- */
8
- import { spawn } from 'child_process';
9
- import { existsSync } from 'fs';
10
- import { build7SectionPrompt, buildDeveloperInstructions, buildRetryPrompt, isValidFeedbackOutput } from '../prompt.js';
11
- import { createTimeoutError, createCliNotFoundError, getSuggestion } from '../errors.js';
12
- // Activity-based timeout: reset on output, kill on silence
13
- const INACTIVITY_TIMEOUT_MS = 120000; // 2 min of no output = timeout
14
- const MAX_TIMEOUT_MS = 3600000; // 60 min absolute max (edge case safety)
15
- const MAX_RETRIES = 2;
16
- const MAX_BUFFER_SIZE = 1024 * 1024; // 1MB max buffer to prevent memory issues
17
- /**
18
- * Run Gemini CLI with the given request
19
- */
20
- export async function runGeminiReview(request) {
21
- // Validate workingDir exists before running
22
- if (!existsSync(request.workingDir)) {
23
- return {
24
- success: false,
25
- error: {
26
- type: 'cli_error',
27
- cli: 'gemini',
28
- exitCode: -1,
29
- stderr: `Working directory does not exist: ${request.workingDir}`
30
- },
31
- suggestion: 'Check that the working directory path is correct',
32
- model: 'gemini'
33
- };
34
- }
35
- return runWithRetry(request, 0);
36
- }
37
- /**
38
- * Run Gemini with retry logic
39
- */
40
- async function runWithRetry(request, attempt, previousError, previousOutput) {
41
- try {
42
- // Build the prompt (use retry prompt if this is a retry)
43
- const basePrompt = attempt === 0
44
- ? build7SectionPrompt(request)
45
- : buildRetryPrompt(request, attempt + 1, previousError, previousOutput);
46
- const developerInstructions = buildDeveloperInstructions('gemini');
47
- // Combine developer instructions with the prompt
48
- // Gemini CLI doesn't have a separate system instruction flag in non-interactive mode
49
- const fullPrompt = `${developerInstructions}\n\n---\n\n${basePrompt}`;
50
- // Run the CLI
51
- const result = await runGeminiCli(fullPrompt, request.workingDir);
52
- // Check for CLI errors
53
- if (result.exitCode !== 0) {
54
- // Check for specific error patterns in stderr
55
- if (result.stderr.toLowerCase().includes('rate limit') ||
56
- result.stderr.toLowerCase().includes('quota')) {
57
- return {
58
- success: false,
59
- error: {
60
- type: 'rate_limit',
61
- cli: 'gemini',
62
- retryAfterMs: parseRetryAfter(result.stderr)
63
- },
64
- suggestion: 'Wait and retry, or use /codex-review instead',
65
- model: 'gemini'
66
- };
67
- }
68
- if (result.stderr.toLowerCase().includes('unauthorized') ||
69
- result.stderr.toLowerCase().includes('authentication') ||
70
- result.stderr.toLowerCase().includes('api key') ||
71
- result.stderr.includes('401') ||
72
- result.stderr.includes('403')) {
73
- return {
74
- success: false,
75
- error: {
76
- type: 'auth_error',
77
- cli: 'gemini',
78
- message: result.stderr
79
- },
80
- suggestion: 'Run `gemini` and follow the authentication prompts, or set GEMINI_API_KEY',
81
- model: 'gemini'
82
- };
83
- }
84
- return {
85
- success: false,
86
- error: {
87
- type: 'cli_error',
88
- cli: 'gemini',
89
- exitCode: result.exitCode,
90
- stderr: result.stderr
91
- },
92
- model: 'gemini'
93
- };
94
- }
95
- // Check for buffer truncation warning
96
- if (result.truncated) {
97
- return {
98
- success: false,
99
- error: {
100
- type: 'cli_error',
101
- cli: 'gemini',
102
- exitCode: 0,
103
- stderr: 'Output exceeded maximum buffer size (1MB) and was truncated'
104
- },
105
- suggestion: 'Try reviewing a smaller scope with --focus',
106
- model: 'gemini'
107
- };
108
- }
109
- // Validate the response structure
110
- if (!isValidFeedbackOutput(result.stdout)) {
111
- if (attempt < MAX_RETRIES) {
112
- // Retry with history
113
- return runWithRetry(request, attempt + 1, 'Output missing required sections (Agreements, Disagreements, Additions, Alternatives, Risk Assessment)', result.stdout);
114
- }
115
- // Max retries reached, return invalid response error
116
- return {
117
- success: false,
118
- error: {
119
- type: 'invalid_response',
120
- cli: 'gemini',
121
- rawOutput: result.stdout
122
- },
123
- suggestion: getSuggestion({ type: 'invalid_response', cli: 'gemini', rawOutput: result.stdout }),
124
- model: 'gemini'
125
- };
126
- }
127
- return {
128
- success: true,
129
- feedback: result.stdout,
130
- model: 'gemini'
131
- };
132
- }
133
- catch (error) {
134
- const err = error;
135
- // Handle CLI not found (ENOENT for the gemini binary itself)
136
- if (err.code === 'ENOENT') {
137
- return {
138
- success: false,
139
- error: createCliNotFoundError('gemini'),
140
- suggestion: getSuggestion(createCliNotFoundError('gemini')),
141
- model: 'gemini'
142
- };
143
- }
144
- if (err.message === 'TIMEOUT' || err.message === 'MAX_TIMEOUT') {
145
- const isMaxTimeout = err.message === 'MAX_TIMEOUT';
146
- const timeoutMs = isMaxTimeout ? MAX_TIMEOUT_MS : INACTIVITY_TIMEOUT_MS;
147
- return {
148
- success: false,
149
- error: createTimeoutError('gemini', timeoutMs),
150
- suggestion: isMaxTimeout
151
- ? 'Task exceeded 60 minute maximum. Try a smaller scope.'
152
- : 'No output for 2 minutes. Process may be hung. Try a smaller scope or use --focus.',
153
- model: 'gemini'
154
- };
155
- }
156
- // Generic error
157
- return {
158
- success: false,
159
- error: {
160
- type: 'cli_error',
161
- cli: 'gemini',
162
- exitCode: -1,
163
- stderr: err.message
164
- },
165
- model: 'gemini'
166
- };
167
- }
168
- }
169
- /**
170
- * Execute the Gemini CLI in non-interactive mode
171
- *
172
- * Uses: gemini --yolo --include-directories <workingDir> "<prompt>"
173
- */
174
- function runGeminiCli(prompt, workingDir) {
175
- return new Promise((resolve, reject) => {
176
- // Build CLI arguments for non-interactive execution
177
- // Use positional prompt (not deprecated -p flag) and --yolo for auto-approval
178
- const args = [
179
- '--yolo',
180
- '--model', 'gemini-3.1-pro-preview',
181
- '--include-directories', workingDir,
182
- prompt
183
- ];
184
- const proc = spawn('gemini', args, {
185
- cwd: workingDir,
186
- stdio: ['ignore', 'pipe', 'pipe'],
187
- env: { ...process.env }
188
- });
189
- let stdout = '';
190
- let stderr = '';
191
- let truncated = false;
192
- let inactivityTimer;
193
- // Max timeout - absolute cap (60 min)
194
- const maxTimer = setTimeout(() => {
195
- proc.kill('SIGTERM');
196
- reject(new Error('MAX_TIMEOUT'));
197
- }, MAX_TIMEOUT_MS);
198
- // Activity-based timeout - reset on any output
199
- const resetInactivityTimer = () => {
200
- clearTimeout(inactivityTimer);
201
- inactivityTimer = setTimeout(() => {
202
- proc.kill('SIGTERM');
203
- reject(new Error('TIMEOUT'));
204
- }, INACTIVITY_TIMEOUT_MS);
205
- };
206
- // Start inactivity timer
207
- resetInactivityTimer();
208
- proc.stdout.on('data', (data) => {
209
- resetInactivityTimer(); // Still streaming = reset timer
210
- if (stdout.length < MAX_BUFFER_SIZE) {
211
- stdout += data.toString();
212
- if (stdout.length > MAX_BUFFER_SIZE) {
213
- stdout = stdout.slice(0, MAX_BUFFER_SIZE);
214
- truncated = true;
215
- }
216
- }
217
- });
218
- proc.stderr.on('data', (data) => {
219
- resetInactivityTimer(); // Still streaming = reset timer
220
- if (stderr.length < MAX_BUFFER_SIZE) {
221
- stderr += data.toString();
222
- if (stderr.length > MAX_BUFFER_SIZE) {
223
- stderr = stderr.slice(0, MAX_BUFFER_SIZE);
224
- }
225
- }
226
- });
227
- proc.on('close', (code) => {
228
- clearTimeout(inactivityTimer);
229
- clearTimeout(maxTimer);
230
- resolve({
231
- stdout,
232
- stderr,
233
- exitCode: code ?? -1,
234
- truncated
235
- });
236
- });
237
- proc.on('error', (err) => {
238
- clearTimeout(inactivityTimer);
239
- clearTimeout(maxTimer);
240
- reject(err);
241
- });
242
- });
243
- }
244
- /**
245
- * Parse retry-after duration from error message
246
- */
247
- function parseRetryAfter(errorMessage) {
248
- const match = errorMessage.match(/retry[- ]?after[:\s]+(\d+)/i);
249
- if (match) {
250
- return parseInt(match[1]) * 1000; // Convert to ms
251
- }
252
- return undefined;
253
- }