@mknightzzz/stw 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 (250) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +277 -0
  3. package/dist/agentic-fallback.d.ts +3 -0
  4. package/dist/agentic-fallback.js +32 -0
  5. package/dist/agentic-fallback.js.map +1 -0
  6. package/dist/agentic-prompt.d.ts +2 -0
  7. package/dist/agentic-prompt.js +68 -0
  8. package/dist/agentic-prompt.js.map +1 -0
  9. package/dist/agentic-runtime.d.ts +48 -0
  10. package/dist/agentic-runtime.js +149 -0
  11. package/dist/agentic-runtime.js.map +1 -0
  12. package/dist/agentic-types.d.ts +37 -0
  13. package/dist/agentic-types.js +2 -0
  14. package/dist/agentic-types.js.map +1 -0
  15. package/dist/agents.d.ts +7 -0
  16. package/dist/agents.js +2 -0
  17. package/dist/agents.js.map +1 -0
  18. package/dist/assignments.d.ts +7 -0
  19. package/dist/assignments.js +125 -0
  20. package/dist/assignments.js.map +1 -0
  21. package/dist/checkpoint.d.ts +35 -0
  22. package/dist/checkpoint.js +78 -0
  23. package/dist/checkpoint.js.map +1 -0
  24. package/dist/circuit-breaker.d.ts +17 -0
  25. package/dist/circuit-breaker.js +65 -0
  26. package/dist/circuit-breaker.js.map +1 -0
  27. package/dist/claim.d.ts +6 -0
  28. package/dist/claim.js +135 -0
  29. package/dist/claim.js.map +1 -0
  30. package/dist/clarity-gate.d.ts +12 -0
  31. package/dist/clarity-gate.js +83 -0
  32. package/dist/clarity-gate.js.map +1 -0
  33. package/dist/cli.d.ts +2 -0
  34. package/dist/cli.js +38 -0
  35. package/dist/cli.js.map +1 -0
  36. package/dist/command-dispatch.d.ts +45 -0
  37. package/dist/command-dispatch.js +206 -0
  38. package/dist/command-dispatch.js.map +1 -0
  39. package/dist/command-parser.d.ts +11 -0
  40. package/dist/command-parser.js +101 -0
  41. package/dist/command-parser.js.map +1 -0
  42. package/dist/commands/clean.d.ts +10 -0
  43. package/dist/commands/clean.js +133 -0
  44. package/dist/commands/clean.js.map +1 -0
  45. package/dist/commands/execution.d.ts +2 -0
  46. package/dist/commands/execution.js +327 -0
  47. package/dist/commands/execution.js.map +1 -0
  48. package/dist/commands/go.d.ts +2 -0
  49. package/dist/commands/go.js +197 -0
  50. package/dist/commands/go.js.map +1 -0
  51. package/dist/commands/helpers.d.ts +44 -0
  52. package/dist/commands/helpers.js +231 -0
  53. package/dist/commands/helpers.js.map +1 -0
  54. package/dist/commands/idea.d.ts +2 -0
  55. package/dist/commands/idea.js +89 -0
  56. package/dist/commands/idea.js.map +1 -0
  57. package/dist/commands/init.d.ts +2 -0
  58. package/dist/commands/init.js +94 -0
  59. package/dist/commands/init.js.map +1 -0
  60. package/dist/commands/integration.d.ts +7 -0
  61. package/dist/commands/integration.js +139 -0
  62. package/dist/commands/integration.js.map +1 -0
  63. package/dist/commands/maintenance.d.ts +2 -0
  64. package/dist/commands/maintenance.js +301 -0
  65. package/dist/commands/maintenance.js.map +1 -0
  66. package/dist/commands/run.d.ts +2 -0
  67. package/dist/commands/run.js +356 -0
  68. package/dist/commands/run.js.map +1 -0
  69. package/dist/commands/setup.d.ts +2 -0
  70. package/dist/commands/setup.js +198 -0
  71. package/dist/commands/setup.js.map +1 -0
  72. package/dist/commands/spec.d.ts +2 -0
  73. package/dist/commands/spec.js +35 -0
  74. package/dist/commands/spec.js.map +1 -0
  75. package/dist/commands/stats.d.ts +2 -0
  76. package/dist/commands/stats.js +80 -0
  77. package/dist/commands/stats.js.map +1 -0
  78. package/dist/commands/task-ops.d.ts +2 -0
  79. package/dist/commands/task-ops.js +406 -0
  80. package/dist/commands/task-ops.js.map +1 -0
  81. package/dist/config.d.ts +18 -0
  82. package/dist/config.js +338 -0
  83. package/dist/config.js.map +1 -0
  84. package/dist/cost.d.ts +30 -0
  85. package/dist/cost.js +167 -0
  86. package/dist/cost.js.map +1 -0
  87. package/dist/crash-recovery.d.ts +9 -0
  88. package/dist/crash-recovery.js +42 -0
  89. package/dist/crash-recovery.js.map +1 -0
  90. package/dist/diagnostic.d.ts +48 -0
  91. package/dist/diagnostic.js +328 -0
  92. package/dist/diagnostic.js.map +1 -0
  93. package/dist/doctor.d.ts +31 -0
  94. package/dist/doctor.js +225 -0
  95. package/dist/doctor.js.map +1 -0
  96. package/dist/drift.d.ts +11 -0
  97. package/dist/drift.js +57 -0
  98. package/dist/drift.js.map +1 -0
  99. package/dist/git-utils.d.ts +20 -0
  100. package/dist/git-utils.js +206 -0
  101. package/dist/git-utils.js.map +1 -0
  102. package/dist/gitlab.d.ts +54 -0
  103. package/dist/gitlab.js +101 -0
  104. package/dist/gitlab.js.map +1 -0
  105. package/dist/idea.d.ts +35 -0
  106. package/dist/idea.js +251 -0
  107. package/dist/idea.js.map +1 -0
  108. package/dist/import-resolution.d.ts +13 -0
  109. package/dist/import-resolution.js +111 -0
  110. package/dist/import-resolution.js.map +1 -0
  111. package/dist/inbox-renderer.d.ts +2 -0
  112. package/dist/inbox-renderer.js +67 -0
  113. package/dist/inbox-renderer.js.map +1 -0
  114. package/dist/init.d.ts +105 -0
  115. package/dist/init.js +235 -0
  116. package/dist/init.js.map +1 -0
  117. package/dist/llm-reviewer.d.ts +14 -0
  118. package/dist/llm-reviewer.js +109 -0
  119. package/dist/llm-reviewer.js.map +1 -0
  120. package/dist/lock.d.ts +26 -0
  121. package/dist/lock.js +76 -0
  122. package/dist/lock.js.map +1 -0
  123. package/dist/logger.d.ts +24 -0
  124. package/dist/logger.js +40 -0
  125. package/dist/logger.js.map +1 -0
  126. package/dist/math-utils.d.ts +2 -0
  127. package/dist/math-utils.js +7 -0
  128. package/dist/math-utils.js.map +1 -0
  129. package/dist/mechanical-review.d.ts +30 -0
  130. package/dist/mechanical-review.js +76 -0
  131. package/dist/mechanical-review.js.map +1 -0
  132. package/dist/merge.d.ts +83 -0
  133. package/dist/merge.js +363 -0
  134. package/dist/merge.js.map +1 -0
  135. package/dist/parallel.d.ts +35 -0
  136. package/dist/parallel.js +214 -0
  137. package/dist/parallel.js.map +1 -0
  138. package/dist/plan-validation.d.ts +19 -0
  139. package/dist/plan-validation.js +253 -0
  140. package/dist/plan-validation.js.map +1 -0
  141. package/dist/planner-prompt.d.ts +33 -0
  142. package/dist/planner-prompt.js +244 -0
  143. package/dist/planner-prompt.js.map +1 -0
  144. package/dist/planner.d.ts +29 -0
  145. package/dist/planner.js +511 -0
  146. package/dist/planner.js.map +1 -0
  147. package/dist/poller.d.ts +34 -0
  148. package/dist/poller.js +91 -0
  149. package/dist/poller.js.map +1 -0
  150. package/dist/progress.d.ts +34 -0
  151. package/dist/progress.js +122 -0
  152. package/dist/progress.js.map +1 -0
  153. package/dist/prompt-builder.d.ts +51 -0
  154. package/dist/prompt-builder.js +481 -0
  155. package/dist/prompt-builder.js.map +1 -0
  156. package/dist/provider.d.ts +14 -0
  157. package/dist/provider.js +278 -0
  158. package/dist/provider.js.map +1 -0
  159. package/dist/question-handler.d.ts +18 -0
  160. package/dist/question-handler.js +154 -0
  161. package/dist/question-handler.js.map +1 -0
  162. package/dist/question-triage.d.ts +31 -0
  163. package/dist/question-triage.js +175 -0
  164. package/dist/question-triage.js.map +1 -0
  165. package/dist/repo-detection.d.ts +8 -0
  166. package/dist/repo-detection.js +18 -0
  167. package/dist/repo-detection.js.map +1 -0
  168. package/dist/retry-context.d.ts +2 -0
  169. package/dist/retry-context.js +196 -0
  170. package/dist/retry-context.js.map +1 -0
  171. package/dist/router.d.ts +18 -0
  172. package/dist/router.js +137 -0
  173. package/dist/router.js.map +1 -0
  174. package/dist/run-artifact-types.d.ts +43 -0
  175. package/dist/run-artifact-types.js +2 -0
  176. package/dist/run-artifact-types.js.map +1 -0
  177. package/dist/run-summary.d.ts +14 -0
  178. package/dist/run-summary.js +347 -0
  179. package/dist/run-summary.js.map +1 -0
  180. package/dist/run-sync.d.ts +11 -0
  181. package/dist/run-sync.js +110 -0
  182. package/dist/run-sync.js.map +1 -0
  183. package/dist/run.d.ts +26 -0
  184. package/dist/run.js +150 -0
  185. package/dist/run.js.map +1 -0
  186. package/dist/scope-expansion.d.ts +10 -0
  187. package/dist/scope-expansion.js +117 -0
  188. package/dist/scope-expansion.js.map +1 -0
  189. package/dist/scope.d.ts +4 -0
  190. package/dist/scope.js +37 -0
  191. package/dist/scope.js.map +1 -0
  192. package/dist/scorecard.d.ts +18 -0
  193. package/dist/scorecard.js +128 -0
  194. package/dist/scorecard.js.map +1 -0
  195. package/dist/spec-templates.d.ts +2 -0
  196. package/dist/spec-templates.js +285 -0
  197. package/dist/spec-templates.js.map +1 -0
  198. package/dist/spec-validator.d.ts +8 -0
  199. package/dist/spec-validator.js +144 -0
  200. package/dist/spec-validator.js.map +1 -0
  201. package/dist/status.d.ts +68 -0
  202. package/dist/status.js +261 -0
  203. package/dist/status.js.map +1 -0
  204. package/dist/storage.d.ts +9 -0
  205. package/dist/storage.js +35 -0
  206. package/dist/storage.js.map +1 -0
  207. package/dist/task-executor-completion.d.ts +12 -0
  208. package/dist/task-executor-completion.js +67 -0
  209. package/dist/task-executor-completion.js.map +1 -0
  210. package/dist/task-executor-fallback.d.ts +20 -0
  211. package/dist/task-executor-fallback.js +12 -0
  212. package/dist/task-executor-fallback.js.map +1 -0
  213. package/dist/task-executor.d.ts +34 -0
  214. package/dist/task-executor.js +521 -0
  215. package/dist/task-executor.js.map +1 -0
  216. package/dist/task-graph.d.ts +11 -0
  217. package/dist/task-graph.js +226 -0
  218. package/dist/task-graph.js.map +1 -0
  219. package/dist/task-pipeline-helpers.d.ts +45 -0
  220. package/dist/task-pipeline-helpers.js +160 -0
  221. package/dist/task-pipeline-helpers.js.map +1 -0
  222. package/dist/task-review.d.ts +51 -0
  223. package/dist/task-review.js +410 -0
  224. package/dist/task-review.js.map +1 -0
  225. package/dist/transitions.d.ts +13 -0
  226. package/dist/transitions.js +104 -0
  227. package/dist/transitions.js.map +1 -0
  228. package/dist/types.d.ts +405 -0
  229. package/dist/types.js +101 -0
  230. package/dist/types.js.map +1 -0
  231. package/dist/utils.d.ts +1 -0
  232. package/dist/utils.js +23 -0
  233. package/dist/utils.js.map +1 -0
  234. package/dist/validation.d.ts +19 -0
  235. package/dist/validation.js +73 -0
  236. package/dist/validation.js.map +1 -0
  237. package/dist/worker-response.d.ts +12 -0
  238. package/dist/worker-response.js +60 -0
  239. package/dist/worker-response.js.map +1 -0
  240. package/dist/worker-runner.d.ts +19 -0
  241. package/dist/worker-runner.js +347 -0
  242. package/dist/worker-runner.js.map +1 -0
  243. package/dist/worktree-cleanup.d.ts +44 -0
  244. package/dist/worktree-cleanup.js +325 -0
  245. package/dist/worktree-cleanup.js.map +1 -0
  246. package/dist/worktree.d.ts +22 -0
  247. package/dist/worktree.js +213 -0
  248. package/dist/worktree.js.map +1 -0
  249. package/examples/spec.md +58 -0
  250. package/package.json +66 -0
package/dist/init.js ADDED
@@ -0,0 +1,235 @@
1
+ import { existsSync, readFileSync } from 'node:fs';
2
+ import { join } from 'node:path';
3
+ import { execFileSync } from 'node:child_process';
4
+ const GLM_5_MODELS = {
5
+ strong: 'z-ai/glm-5',
6
+ medium: 'z-ai/glm-5',
7
+ cheap: 'z-ai/glm-5',
8
+ reader: 'z-ai/glm-5',
9
+ };
10
+ const GLM_5_PRICING = {
11
+ 'z-ai/glm-5': {
12
+ model: 'z-ai/glm-5',
13
+ input_cost_per_mtok: 0.5,
14
+ output_cost_per_mtok: 0.5,
15
+ },
16
+ };
17
+ const GLM_51_MODELS = {
18
+ strong: 'z-ai/glm-5.1',
19
+ medium: 'z-ai/glm-5.1',
20
+ cheap: 'z-ai/glm-5.1',
21
+ reader: 'z-ai/glm-5.1',
22
+ };
23
+ const GLM_51_PRICING = {
24
+ 'z-ai/glm-5.1': {
25
+ model: 'z-ai/glm-5.1',
26
+ input_cost_per_mtok: 1.26,
27
+ output_cost_per_mtok: 3.96,
28
+ },
29
+ };
30
+ const MINIMAX_MODELS = {
31
+ strong: 'minimax/minimax-m2.5',
32
+ medium: 'minimax/minimax-m2.5',
33
+ cheap: 'minimax/minimax-m2.5',
34
+ reader: 'minimax/minimax-m2.5',
35
+ };
36
+ const MINIMAX_PRICING = {
37
+ 'minimax/minimax-m2.5': {
38
+ model: 'minimax/minimax-m2.5',
39
+ input_cost_per_mtok: 0.5,
40
+ output_cost_per_mtok: 2.5,
41
+ },
42
+ };
43
+ const ANTHROPIC_MODELS = {
44
+ strong: 'anthropic/claude-sonnet-4-6',
45
+ medium: 'anthropic/claude-sonnet-4-6',
46
+ cheap: 'anthropic/claude-haiku-4-5',
47
+ reader: 'anthropic/claude-haiku-4-5',
48
+ };
49
+ const ANTHROPIC_PRICING = {
50
+ 'anthropic/claude-sonnet-4-6': {
51
+ model: 'anthropic/claude-sonnet-4-6',
52
+ input_cost_per_mtok: 3.0,
53
+ output_cost_per_mtok: 15.0,
54
+ },
55
+ 'anthropic/claude-haiku-4-5': {
56
+ model: 'anthropic/claude-haiku-4-5',
57
+ input_cost_per_mtok: 0.8,
58
+ output_cost_per_mtok: 4.0,
59
+ },
60
+ };
61
+ const MIXED_MODELS = {
62
+ strong: 'anthropic/claude-sonnet-4-6',
63
+ medium: 'minimax/minimax-m2.5',
64
+ cheap: 'z-ai/glm-5',
65
+ reader: 'z-ai/glm-5',
66
+ };
67
+ const MIXED_PRICING = {
68
+ ...GLM_5_PRICING,
69
+ ...MINIMAX_PRICING,
70
+ ...ANTHROPIC_PRICING,
71
+ };
72
+ export const PRESETS = {
73
+ glm5: { models: GLM_5_MODELS, pricing: GLM_5_PRICING },
74
+ glm51: { models: GLM_51_MODELS, pricing: GLM_51_PRICING },
75
+ minimax: { models: MINIMAX_MODELS, pricing: MINIMAX_PRICING },
76
+ anthropic: { models: ANTHROPIC_MODELS, pricing: ANTHROPIC_PRICING },
77
+ mixed: { models: MIXED_MODELS, pricing: MIXED_PRICING },
78
+ };
79
+ export function detectBackends() {
80
+ const result = { opencode: false, claude: false };
81
+ try {
82
+ execFileSync('which', ['opencode'], { stdio: 'ignore' });
83
+ result.opencode = true;
84
+ }
85
+ catch {
86
+ result.opencode = false;
87
+ }
88
+ try {
89
+ execFileSync('which', ['claude'], { stdio: 'ignore' });
90
+ result.claude = true;
91
+ }
92
+ catch {
93
+ result.claude = false;
94
+ }
95
+ return result;
96
+ }
97
+ export function detectRepo(repoRoot) {
98
+ const detectedFiles = [];
99
+ let type = 'unknown';
100
+ let testCommand = null;
101
+ let lintCommand = null;
102
+ if (existsSync(join(repoRoot, 'package.json'))) {
103
+ detectedFiles.push('package.json');
104
+ type = 'nodejs';
105
+ const pkg = readPackageJson(repoRoot);
106
+ testCommand = extractNodeTestCommand(pkg);
107
+ lintCommand = extractNodeLintCommand(pkg);
108
+ }
109
+ if (existsSync(join(repoRoot, 'Cargo.toml'))) {
110
+ detectedFiles.push('Cargo.toml');
111
+ if (type === 'unknown') {
112
+ type = 'rust';
113
+ testCommand = 'cargo test';
114
+ lintCommand = 'cargo clippy';
115
+ }
116
+ }
117
+ if (existsSync(join(repoRoot, 'go.mod'))) {
118
+ detectedFiles.push('go.mod');
119
+ if (type === 'unknown') {
120
+ type = 'go';
121
+ testCommand = 'go test ./...';
122
+ lintCommand = 'golint ./...';
123
+ }
124
+ }
125
+ if (existsSync(join(repoRoot, 'pyproject.toml'))) {
126
+ detectedFiles.push('pyproject.toml');
127
+ if (type === 'unknown') {
128
+ type = 'python';
129
+ testCommand = 'pytest';
130
+ lintCommand = 'ruff check .';
131
+ }
132
+ }
133
+ else if (existsSync(join(repoRoot, 'requirements.txt'))) {
134
+ detectedFiles.push('requirements.txt');
135
+ if (type === 'unknown') {
136
+ type = 'python';
137
+ testCommand = 'pytest';
138
+ lintCommand = 'ruff check .';
139
+ }
140
+ }
141
+ return { type, testCommand, lintCommand, detectedFiles };
142
+ }
143
+ function readPackageJson(repoRoot) {
144
+ try {
145
+ const content = readFileSync(join(repoRoot, 'package.json'), 'utf-8');
146
+ return JSON.parse(content);
147
+ }
148
+ catch {
149
+ return null;
150
+ }
151
+ }
152
+ function extractNodeTestCommand(pkg) {
153
+ if (!pkg?.scripts)
154
+ return null;
155
+ if (pkg.scripts.test)
156
+ return 'npm test';
157
+ if (pkg.scripts['test:unit'])
158
+ return 'npm run test:unit';
159
+ return null;
160
+ }
161
+ function extractNodeLintCommand(pkg) {
162
+ if (!pkg?.scripts)
163
+ return null;
164
+ if (pkg.scripts.lint)
165
+ return 'npm run lint';
166
+ return null;
167
+ }
168
+ export function generateConfig(repoRoot, options) {
169
+ const presetName = options?.preset ?? 'minimax';
170
+ const preset = PRESETS[presetName];
171
+ const provider = options?.provider ?? 'openrouter';
172
+ const models = { ...preset.models, ...options?.models };
173
+ const backend = options?.backend ?? 'opencode';
174
+ const maxRunUsd = options?.maxRunUsd ?? 50.0;
175
+ const pricing = preset.pricing;
176
+ const primaryModel = models.strong;
177
+ const primaryPricing = pricing[primaryModel] ?? Object.values(pricing)[0];
178
+ return {
179
+ providers: {
180
+ openrouter: {
181
+ api_key_env: 'OPENROUTER_API_KEY',
182
+ base_url: 'https://openrouter.ai/api/v1',
183
+ models,
184
+ },
185
+ },
186
+ models: {
187
+ [presetName]: {
188
+ provider,
189
+ model: primaryModel,
190
+ tier: 'strong',
191
+ input_cost_per_mtok: primaryPricing.input_cost_per_mtok,
192
+ output_cost_per_mtok: primaryPricing.output_cost_per_mtok,
193
+ },
194
+ },
195
+ routing_policy: {
196
+ require_plan_approval: true,
197
+ provider_preferences: {
198
+ strong: [provider],
199
+ medium: [provider],
200
+ cheap: [provider],
201
+ reader: [provider],
202
+ },
203
+ },
204
+ defaults: {
205
+ poll_interval_seconds: 60,
206
+ api_timeout_seconds: 120,
207
+ task_timeout_minutes: 30,
208
+ max_concurrent_workers: 1,
209
+ max_retries: 2,
210
+ max_questions_per_task: 3,
211
+ execution_mode: 'conservative',
212
+ retry_context: 'full',
213
+ planner_max_retries: 2,
214
+ planner_fallback_models: buildPlannerFallbacks(models),
215
+ agentic: {
216
+ default_backend: backend,
217
+ },
218
+ },
219
+ budget: {
220
+ max_run_usd: maxRunUsd,
221
+ max_task_usd: 10.0,
222
+ warn_threshold_pct: 80,
223
+ on_exceed: 'pause',
224
+ },
225
+ pricing,
226
+ };
227
+ }
228
+ function buildPlannerFallbacks(models) {
229
+ const primary = models.strong;
230
+ const candidates = [models.medium, models.cheap].filter((m) => typeof m === 'string' && m !== primary);
231
+ // Deduplicate while preserving order
232
+ return [...new Set(candidates)];
233
+ }
234
+ export { GLM_5_MODELS, GLM_5_PRICING, MINIMAX_MODELS, MINIMAX_PRICING, ANTHROPIC_MODELS, ANTHROPIC_PRICING, MIXED_MODELS, MIXED_PRICING, };
235
+ //# sourceMappingURL=init.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ import { type ReviewerValidationResult } from './prompt-builder.js';
2
+ import type { StwConfig, Task } from './types.js';
3
+ export type ReviewDecision = 'complete' | 'revise' | 'reject' | 'escalate';
4
+ export interface ReviewResult {
5
+ decision: ReviewDecision;
6
+ reasons: string[];
7
+ usage?: {
8
+ input_tokens: number;
9
+ output_tokens: number;
10
+ };
11
+ model?: string;
12
+ latency_ms?: number;
13
+ }
14
+ export declare function reviewTask(task: Task, config: StwConfig, diff: string, validationResult: ReviewerValidationResult, taskDir: string, worktreePath?: string): Promise<ReviewResult>;
@@ -0,0 +1,109 @@
1
+ import { join } from 'node:path';
2
+ import { buildReviewerPrompt } from './prompt-builder.js';
3
+ import { callProvider } from './provider.js';
4
+ import { routeTask } from './router.js';
5
+ import { writeJson } from './storage.js';
6
+ export async function reviewTask(task, config, diff, validationResult, taskDir, worktreePath) {
7
+ if (!validationResult.passed) {
8
+ const result = {
9
+ decision: 'revise',
10
+ reasons: getValidationFailureReasons(validationResult),
11
+ };
12
+ writeJson(join(taskDir, 'review.json'), result);
13
+ return result;
14
+ }
15
+ const route = routeTask({
16
+ risk: task.risk,
17
+ task_type: task.task_type,
18
+ model_tier: task.model_tier,
19
+ }, config);
20
+ const providerConfig = config.providers[task.provider_hint ?? route.provider];
21
+ if (!providerConfig) {
22
+ throw new Error(`Provider not configured: ${task.provider_hint ?? route.provider}`);
23
+ }
24
+ const prompt = buildReviewerPrompt({
25
+ repoRoot: worktreePath ?? process.cwd(),
26
+ task,
27
+ taskDir,
28
+ diff,
29
+ validationResult,
30
+ });
31
+ const apiTimeoutMs = config.defaults.api_timeout_seconds * 1000;
32
+ const maxRetries = config.defaults.max_retries ?? 2;
33
+ // Hard ceiling: enough for all retries + backoff + generous margin
34
+ const hardTimeoutMs = apiTimeoutMs * (maxRetries + 1) * 2 + 30_000;
35
+ const providerPromise = callProvider({
36
+ model: route.model,
37
+ messages: [{ role: 'user', content: prompt }],
38
+ timeout_ms: apiTimeoutMs,
39
+ response_format: 'json',
40
+ }, providerConfig, config.defaults, 'reader', config);
41
+ let hardTimer;
42
+ const hardTimeoutPromise = new Promise((_, reject) => {
43
+ hardTimer = setTimeout(() => reject(new Error(`LLM review hard timeout after ${hardTimeoutMs}ms`)), hardTimeoutMs);
44
+ });
45
+ let response;
46
+ try {
47
+ response = await Promise.race([providerPromise, hardTimeoutPromise]);
48
+ }
49
+ finally {
50
+ clearTimeout(hardTimer);
51
+ }
52
+ if (!response.content) {
53
+ throw new Error('Reviewer returned empty/null response content');
54
+ }
55
+ const result = parseReviewResult(response.content);
56
+ result.usage = response.usage;
57
+ result.model = response.model;
58
+ result.latency_ms = response.latency_ms;
59
+ writeJson(join(taskDir, 'review.json'), result);
60
+ return result;
61
+ }
62
+ function getValidationFailureReasons(validationResult) {
63
+ const reasons = validationResult.checks
64
+ .filter((check) => !check.passed)
65
+ .map((check) => `Validation failed: ${check.command} (exit ${check.exit_code})`);
66
+ return reasons.length > 0 ? reasons : ['Validation failed'];
67
+ }
68
+ function stripCodeFences(content) {
69
+ const trimmed = content.trim();
70
+ if (trimmed.startsWith('```')) {
71
+ const firstNewline = trimmed.indexOf('\n');
72
+ const lastFence = trimmed.lastIndexOf('```');
73
+ if (lastFence > firstNewline) {
74
+ return trimmed.slice(firstNewline + 1, lastFence).trim();
75
+ }
76
+ }
77
+ return trimmed;
78
+ }
79
+ function parseReviewResult(rawContent) {
80
+ const cleaned = stripCodeFences(rawContent);
81
+ let parsed;
82
+ try {
83
+ parsed = JSON.parse(cleaned);
84
+ }
85
+ catch (error) {
86
+ throw new Error(`Reviewer response was not valid JSON: ${getErrorMessage(error)}`);
87
+ }
88
+ if (typeof parsed !== 'object' || parsed === null) {
89
+ throw new Error('Reviewer response must be an object');
90
+ }
91
+ const candidate = parsed;
92
+ if (!isReviewDecision(candidate.decision)) {
93
+ throw new Error(`Reviewer response decision is invalid: ${String(candidate.decision)}`);
94
+ }
95
+ if (!Array.isArray(candidate.reasons) || candidate.reasons.some((reason) => typeof reason !== 'string')) {
96
+ throw new Error('Reviewer response reasons must be an array of strings');
97
+ }
98
+ return {
99
+ decision: candidate.decision,
100
+ reasons: candidate.reasons,
101
+ };
102
+ }
103
+ function isReviewDecision(value) {
104
+ return value === 'complete' || value === 'revise' || value === 'reject' || value === 'escalate';
105
+ }
106
+ function getErrorMessage(error) {
107
+ return error instanceof Error ? error.message : String(error);
108
+ }
109
+ //# sourceMappingURL=llm-reviewer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"llm-reviewer.js","sourceRoot":"","sources":["../src/llm-reviewer.ts"],"names":[],"mappings":"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"}
package/dist/lock.d.ts ADDED
@@ -0,0 +1,26 @@
1
+ export interface LockData {
2
+ pid: number;
3
+ hostname: string;
4
+ run_id: string;
5
+ timestamp: string;
6
+ }
7
+ export interface Lock {
8
+ data: LockData;
9
+ isStale: boolean;
10
+ }
11
+ export interface LockResult {
12
+ acquired: boolean;
13
+ existingLock?: Lock;
14
+ }
15
+ export declare function readLock(stwRoot: string): Lock | null;
16
+ export declare function acquireLock(stwRoot: string, runId: string): LockResult;
17
+ export declare function releaseLock(stwRoot: string): void;
18
+ export declare function isLockStale(stwRoot: string): boolean;
19
+ export declare function forceUnlock(stwRoot: string): void;
20
+ export interface RunLockState {
21
+ lock: Lock | null;
22
+ hasLiveLock: boolean;
23
+ hasStaleLock: boolean;
24
+ lockedRunId: string | null;
25
+ }
26
+ export declare function getRunLockState(stwRoot: string, runId: string): RunLockState;
package/dist/lock.js ADDED
@@ -0,0 +1,76 @@
1
+ import { existsSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';
2
+ import { join } from 'node:path';
3
+ import { hostname } from 'node:os';
4
+ import { pid } from 'node:process';
5
+ export function readLock(stwRoot) {
6
+ const lockPath = join(stwRoot, 'lock');
7
+ if (!existsSync(lockPath)) {
8
+ return null;
9
+ }
10
+ try {
11
+ const raw = readFileSync(lockPath, 'utf-8');
12
+ const data = JSON.parse(raw);
13
+ const stale = !isProcessAlive(data.pid);
14
+ return { data, isStale: stale };
15
+ }
16
+ catch {
17
+ return null;
18
+ }
19
+ }
20
+ function isProcessAlive(targetPid) {
21
+ try {
22
+ process.kill(targetPid, 0);
23
+ return true;
24
+ }
25
+ catch {
26
+ return false;
27
+ }
28
+ }
29
+ export function acquireLock(stwRoot, runId) {
30
+ const existing = readLock(stwRoot);
31
+ if (existing && !existing.isStale) {
32
+ return { acquired: false, existingLock: existing };
33
+ }
34
+ if (existing && existing.isStale) {
35
+ unlinkSync(join(stwRoot, 'lock'));
36
+ }
37
+ const lockPath = join(stwRoot, 'lock');
38
+ const data = {
39
+ pid: pid,
40
+ hostname: hostname(),
41
+ run_id: runId,
42
+ timestamp: new Date().toISOString(),
43
+ };
44
+ writeFileSync(lockPath, JSON.stringify(data, null, 2) + '\n', 'utf-8');
45
+ return { acquired: true };
46
+ }
47
+ export function releaseLock(stwRoot) {
48
+ const lockPath = join(stwRoot, 'lock');
49
+ if (existsSync(lockPath)) {
50
+ unlinkSync(lockPath);
51
+ }
52
+ }
53
+ export function isLockStale(stwRoot) {
54
+ const lock = readLock(stwRoot);
55
+ if (!lock)
56
+ return false;
57
+ return lock.isStale;
58
+ }
59
+ export function forceUnlock(stwRoot) {
60
+ const lockPath = join(stwRoot, 'lock');
61
+ if (existsSync(lockPath)) {
62
+ unlinkSync(lockPath);
63
+ }
64
+ }
65
+ export function getRunLockState(stwRoot, runId) {
66
+ const lock = readLock(stwRoot);
67
+ const lockedRunId = lock?.data.run_id ?? null;
68
+ const isForRun = lockedRunId === runId;
69
+ return {
70
+ lock,
71
+ hasLiveLock: Boolean(lock && !lock.isStale && isForRun),
72
+ hasStaleLock: Boolean(lock && lock.isStale && isForRun),
73
+ lockedRunId,
74
+ };
75
+ }
76
+ //# sourceMappingURL=lock.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lock.js","sourceRoot":"","sources":["../src/lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC9E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAmBnC,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACvC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAa,CAAC;QACzC,MAAM,KAAK,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,SAAiB;IACvC,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,KAAa;IACxD,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QAClC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC;IACrD,CAAC;IACD,IAAI,QAAQ,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACjC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACvC,MAAM,IAAI,GAAa;QACrB,GAAG,EAAE,GAAG;QACR,QAAQ,EAAE,QAAQ,EAAE;QACpB,MAAM,EAAE,KAAK;QACb,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;IAEF,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IACvE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACvC,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,UAAU,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,OAAO,IAAI,CAAC,OAAO,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACvC,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,UAAU,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AASD,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,KAAa;IAC5D,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,WAAW,GAAG,IAAI,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC;IAC9C,MAAM,QAAQ,GAAG,WAAW,KAAK,KAAK,CAAC;IAEvC,OAAO;QACL,IAAI;QACJ,WAAW,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,QAAQ,CAAC;QACvD,YAAY,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,IAAI,QAAQ,CAAC;QACvD,WAAW;KACZ,CAAC;AACJ,CAAC"}
@@ -0,0 +1,24 @@
1
+ export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
2
+ export interface LogEntry {
3
+ ts: string;
4
+ level: LogLevel;
5
+ run_id: string;
6
+ task_id?: string;
7
+ phase?: string;
8
+ provider?: string;
9
+ model?: string;
10
+ correlation_id?: string;
11
+ message: string;
12
+ data?: Record<string, unknown>;
13
+ }
14
+ export interface Logger {
15
+ debug(message: string, data?: Record<string, unknown>): void;
16
+ info(message: string, data?: Record<string, unknown>): void;
17
+ warn(message: string, data?: Record<string, unknown>): void;
18
+ error(message: string, data?: Record<string, unknown>): void;
19
+ withTask(taskId: string): Logger;
20
+ withPhase(phase: string): Logger;
21
+ withProvider(provider: string, model: string): Logger;
22
+ withCorrelationId(correlationId: string): Logger;
23
+ }
24
+ export declare function createLogger(logPath: string, runId: string): Logger;
package/dist/logger.js ADDED
@@ -0,0 +1,40 @@
1
+ import { appendFileSync } from 'node:fs';
2
+ function makeEntry(level, runId, message, data, overrides) {
3
+ return {
4
+ ts: new Date().toISOString(),
5
+ level,
6
+ run_id: runId,
7
+ message,
8
+ data,
9
+ ...overrides,
10
+ };
11
+ }
12
+ function writeLog(logPath, entry) {
13
+ appendFileSync(logPath, JSON.stringify(entry) + '\n', 'utf-8');
14
+ }
15
+ export function createLogger(logPath, runId) {
16
+ return _createLogger(logPath, runId, {});
17
+ }
18
+ function _createLogger(logPath, runId, ctx) {
19
+ const base = (level, message, data) => {
20
+ const entry = makeEntry(level, runId, message, data, {
21
+ task_id: ctx.taskId,
22
+ phase: ctx.phase,
23
+ provider: ctx.provider,
24
+ model: ctx.model,
25
+ correlation_id: ctx.correlationId,
26
+ });
27
+ writeLog(logPath, entry);
28
+ };
29
+ return {
30
+ debug: (msg, data) => base('debug', msg, data),
31
+ info: (msg, data) => base('info', msg, data),
32
+ warn: (msg, data) => base('warn', msg, data),
33
+ error: (msg, data) => base('error', msg, data),
34
+ withTask: (taskId) => _createLogger(logPath, runId, { ...ctx, taskId }),
35
+ withPhase: (phase) => _createLogger(logPath, runId, { ...ctx, phase }),
36
+ withProvider: (provider, model) => _createLogger(logPath, runId, { ...ctx, provider, model }),
37
+ withCorrelationId: (correlationId) => _createLogger(logPath, runId, { ...ctx, correlationId }),
38
+ };
39
+ }
40
+ //# sourceMappingURL=logger.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AA4BzC,SAAS,SAAS,CAChB,KAAe,EACf,KAAa,EACb,OAAe,EACf,IAA8B,EAC9B,SAA6B;IAE7B,OAAO;QACL,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,KAAK;QACL,MAAM,EAAE,KAAK;QACb,OAAO;QACP,IAAI;QACJ,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,OAAe,EAAE,KAAe;IAChD,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,KAAa;IACzD,OAAO,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;AAC3C,CAAC;AAUD,SAAS,aAAa,CAAC,OAAe,EAAE,KAAa,EAAE,GAAkB;IACvE,MAAM,IAAI,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,IAA8B,EAAE,EAAE;QAChF,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE;YACnD,OAAO,EAAE,GAAG,CAAC,MAAM;YACnB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,cAAc,EAAE,GAAG,CAAC,aAAa;SAClC,CAAC,CAAC;QACH,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC3B,CAAC,CAAC;IAEF,OAAO;QACL,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC;QAC9C,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC;QAC5C,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC;QAC5C,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC;QAC9C,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,CAAC;QACvE,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,GAAG,EAAE,KAAK,EAAE,CAAC;QACtE,YAAY,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QAC7F,iBAAiB,EAAE,CAAC,aAAa,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,GAAG,EAAE,aAAa,EAAE,CAAC;KAC/F,CAAC;AACJ,CAAC"}
@@ -0,0 +1,2 @@
1
+ export declare function add(a: number, b: number): number;
2
+ export declare function multiply(a: number, b: number): number;
@@ -0,0 +1,7 @@
1
+ export function add(a, b) {
2
+ return a + b;
3
+ }
4
+ export function multiply(a, b) {
5
+ return a * b;
6
+ }
7
+ //# sourceMappingURL=math-utils.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"math-utils.js","sourceRoot":"","sources":["../src/math-utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,GAAG,CAAC,CAAS,EAAE,CAAS;IACtC,OAAO,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,CAAS,EAAE,CAAS;IAC3C,OAAO,CAAC,GAAG,CAAC,CAAC;AACf,CAAC"}
@@ -0,0 +1,30 @@
1
+ export interface MechanicalReviewResult {
2
+ passed: boolean;
3
+ checks: {
4
+ tests: {
5
+ passed: boolean;
6
+ output: string;
7
+ };
8
+ typecheck: {
9
+ passed: boolean;
10
+ output: string;
11
+ };
12
+ scope: {
13
+ passed: boolean;
14
+ declared: string[];
15
+ undeclared: string[];
16
+ };
17
+ };
18
+ }
19
+ export interface MechanicalReviewOptions {
20
+ cwd: string;
21
+ declaredScope: string[];
22
+ baseBranch?: string;
23
+ excludeCommands?: string[];
24
+ }
25
+ export declare function checkScopeCompliance(declaredScope: string[], changedFiles: string[]): {
26
+ passed: boolean;
27
+ declared: string[];
28
+ undeclared: string[];
29
+ };
30
+ export declare function runMechanicalReview(options: MechanicalReviewOptions): Promise<MechanicalReviewResult>;