@hivehub/rulebook 5.7.0 → 5.8.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 (599) hide show
  1. package/.claude/commands/analysis.md +35 -35
  2. package/.claude/commands/continue.md +33 -33
  3. package/.claude/commands/rulebook-decision-create.md +55 -55
  4. package/.claude/commands/rulebook-decision-list.md +15 -15
  5. package/.claude/commands/rulebook-knowledge-add.md +41 -41
  6. package/.claude/commands/rulebook-knowledge-list.md +15 -15
  7. package/.claude/commands/rulebook-memory-save.md +48 -48
  8. package/.claude/commands/rulebook-memory-search.md +47 -47
  9. package/.claude/commands/rulebook-task-apply.md +67 -67
  10. package/.claude/commands/rulebook-task-archive.md +94 -94
  11. package/.claude/commands/rulebook-task-create.md +93 -93
  12. package/.claude/commands/rulebook-task-list.md +42 -42
  13. package/.claude/commands/rulebook-task-show.md +52 -52
  14. package/.claude/commands/rulebook-task-validate.md +53 -53
  15. package/.claude-plugin/marketplace.json +28 -28
  16. package/.claude-plugin/plugin.json +8 -8
  17. package/README.md +86 -0
  18. package/dist/cli/commands/claude.d.ts +17 -0
  19. package/dist/cli/commands/claude.d.ts.map +1 -0
  20. package/dist/cli/commands/claude.js +56 -0
  21. package/dist/cli/commands/claude.js.map +1 -0
  22. package/dist/cli/commands/init.d.ts.map +1 -1
  23. package/dist/cli/commands/init.js +18 -2
  24. package/dist/cli/commands/init.js.map +1 -1
  25. package/dist/cli/commands/update.d.ts.map +1 -1
  26. package/dist/cli/commands/update.js +6 -1
  27. package/dist/cli/commands/update.js.map +1 -1
  28. package/dist/cli/prompts.d.ts +13 -0
  29. package/dist/cli/prompts.d.ts.map +1 -1
  30. package/dist/cli/prompts.js +106 -0
  31. package/dist/cli/prompts.js.map +1 -1
  32. package/dist/core/claude/claude-mcp.d.ts +9 -0
  33. package/dist/core/claude/claude-mcp.d.ts.map +1 -1
  34. package/dist/core/claude/claude-mcp.js +30 -0
  35. package/dist/core/claude/claude-mcp.js.map +1 -1
  36. package/dist/core/claude/claude-settings-manager.d.ts +12 -0
  37. package/dist/core/claude/claude-settings-manager.d.ts.map +1 -1
  38. package/dist/core/claude/claude-settings-manager.js +59 -3
  39. package/dist/core/claude/claude-settings-manager.js.map +1 -1
  40. package/dist/core/detect/detector.d.ts +8 -1
  41. package/dist/core/detect/detector.d.ts.map +1 -1
  42. package/dist/core/detect/detector.js +225 -0
  43. package/dist/core/detect/detector.js.map +1 -1
  44. package/dist/core/detect/library-registry.d.ts +40 -0
  45. package/dist/core/detect/library-registry.d.ts.map +1 -0
  46. package/dist/core/detect/library-registry.js +239 -0
  47. package/dist/core/detect/library-registry.js.map +1 -0
  48. package/dist/core/generators/generator.d.ts +1 -0
  49. package/dist/core/generators/generator.d.ts.map +1 -1
  50. package/dist/core/generators/generator.js +37 -0
  51. package/dist/core/generators/generator.js.map +1 -1
  52. package/dist/core/generators/rules-generator.d.ts +1 -5
  53. package/dist/core/generators/rules-generator.d.ts.map +1 -1
  54. package/dist/core/generators/rules-generator.js +40 -1
  55. package/dist/core/generators/rules-generator.js.map +1 -1
  56. package/dist/index.js +12 -0
  57. package/dist/index.js.map +1 -1
  58. package/dist/mcp/rulebook-server.js +0 -0
  59. package/dist/types.d.ts +13 -0
  60. package/dist/types.d.ts.map +1 -1
  61. package/package.json +23 -22
  62. package/templates/agents/accessibility-reviewer.md +43 -43
  63. package/templates/agents/api-designer.md +42 -42
  64. package/templates/agents/architect.md +51 -51
  65. package/templates/agents/build-engineer.md +36 -36
  66. package/templates/agents/code-reviewer.md +47 -47
  67. package/templates/agents/compiler/codegen-debugger.md +34 -34
  68. package/templates/agents/compiler/stdlib-engineer.md +28 -28
  69. package/templates/agents/compiler/test-coverage-guardian.md +31 -31
  70. package/templates/agents/database-architect.md +41 -41
  71. package/templates/agents/devops-engineer.md +42 -42
  72. package/templates/agents/docs-writer.md +38 -38
  73. package/templates/agents/game-engine/cpp-core-expert.md +35 -35
  74. package/templates/agents/game-engine/render-engineer.md +22 -22
  75. package/templates/agents/game-engine/shader-engineer.md +38 -38
  76. package/templates/agents/game-engine/systems-integration.md +43 -43
  77. package/templates/agents/generic/code-reviewer.md +41 -41
  78. package/templates/agents/generic/docs-writer.md +25 -25
  79. package/templates/agents/generic/project-manager.md +36 -36
  80. package/templates/agents/generic/researcher.md +34 -34
  81. package/templates/agents/generic/test-engineer.md +41 -41
  82. package/templates/agents/i18n-engineer.md +42 -42
  83. package/templates/agents/implementer.md +42 -42
  84. package/templates/agents/migration-engineer.md +42 -42
  85. package/templates/agents/mobile/platform-specialist.md +22 -22
  86. package/templates/agents/mobile/ui-engineer.md +22 -22
  87. package/templates/agents/performance-engineer.md +49 -49
  88. package/templates/agents/project-manager.md +215 -0
  89. package/templates/agents/quality-gatekeeper.md +205 -0
  90. package/templates/agents/refactoring-agent.md +41 -41
  91. package/templates/agents/researcher.md +38 -38
  92. package/templates/agents/security-reviewer.md +40 -40
  93. package/templates/agents/team-lead.md +37 -37
  94. package/templates/agents/tester.md +48 -48
  95. package/templates/agents/ux-reviewer.md +43 -43
  96. package/templates/agents/web-app/api-designer.md +22 -22
  97. package/templates/agents/web-app/backend-engineer.md +30 -30
  98. package/templates/agents/web-app/database-engineer.md +22 -22
  99. package/templates/agents/web-app/frontend-engineer.md +29 -29
  100. package/templates/agents/web-app/security-reviewer.md +32 -32
  101. package/templates/ci/rulebook-review.yml +26 -26
  102. package/templates/claude-workflows/bugfix.js +94 -0
  103. package/templates/claude-workflows/feature-pipeline.js +88 -0
  104. package/templates/claude-workflows/release-gate.js +64 -0
  105. package/templates/claude-workflows/review-fanout.js +118 -0
  106. package/templates/claude-workflows/rulebook-driver.js +343 -0
  107. package/templates/claude-workflows/spec-author.js +133 -0
  108. package/templates/cli/AIDER.md +49 -49
  109. package/templates/cli/AMAZON_Q.md +25 -25
  110. package/templates/cli/AUGGIE.md +32 -32
  111. package/templates/cli/CLAUDE.md +117 -117
  112. package/templates/cli/CLINE.md +99 -99
  113. package/templates/cli/CODEBUDDY.md +20 -20
  114. package/templates/cli/CODEIUM.md +20 -20
  115. package/templates/cli/CODEX.md +21 -21
  116. package/templates/cli/CONTINUE.md +34 -34
  117. package/templates/cli/CURSOR_CLI.md +62 -62
  118. package/templates/cli/FACTORY.md +18 -18
  119. package/templates/cli/GEMINI.md +35 -35
  120. package/templates/cli/KILOCODE.md +18 -18
  121. package/templates/cli/_GENERIC_TEMPLATE.md +29 -29
  122. package/templates/commands/rulebook-decision-create.md +55 -55
  123. package/templates/commands/rulebook-decision-list.md +15 -15
  124. package/templates/commands/rulebook-knowledge-add.md +41 -41
  125. package/templates/commands/rulebook-knowledge-list.md +15 -15
  126. package/templates/commands/rulebook-memory-save.md +48 -48
  127. package/templates/commands/rulebook-memory-search.md +47 -47
  128. package/templates/commands/rulebook-task-apply.md +67 -67
  129. package/templates/commands/rulebook-task-archive.md +94 -94
  130. package/templates/commands/rulebook-task-create.md +93 -93
  131. package/templates/commands/rulebook-task-list.md +42 -42
  132. package/templates/commands/rulebook-task-show.md +52 -52
  133. package/templates/commands/rulebook-task-validate.md +53 -53
  134. package/templates/compact-context/_default.md +23 -23
  135. package/templates/compact-context/cpp.md +26 -26
  136. package/templates/compact-context/go.md +26 -26
  137. package/templates/compact-context/python.md +26 -26
  138. package/templates/compact-context/rust.md +28 -28
  139. package/templates/compact-context/typescript.md +29 -29
  140. package/templates/core/AGENTS_OVERRIDE.md +16 -16
  141. package/templates/core/AGENT_AUTOMATION.md +296 -296
  142. package/templates/core/CLAUDE_MD_v2.md +90 -90
  143. package/templates/core/DAG.md +304 -304
  144. package/templates/core/DECISIONS.md +38 -38
  145. package/templates/core/DOCUMENTATION_RULES.md +36 -36
  146. package/templates/core/KNOWLEDGE.md +49 -49
  147. package/templates/core/MULTI_AGENT.md +74 -74
  148. package/templates/core/PLANS.md +28 -28
  149. package/templates/core/QUALITY_ENFORCEMENT.md +68 -68
  150. package/templates/core/RULEBOOK.md +1947 -1947
  151. package/templates/core/TIER1_PROHIBITIONS.md +154 -154
  152. package/templates/core/TOKEN_OPTIMIZATION.md +49 -49
  153. package/templates/git/CI_CD_PATTERNS.md +661 -661
  154. package/templates/git/GITHUB_ACTIONS.md +728 -728
  155. package/templates/git/GITLAB_CI.md +730 -730
  156. package/templates/git/GIT_WORKFLOW.md +1192 -1192
  157. package/templates/git/SECRETS_MANAGEMENT.md +585 -585
  158. package/templates/hooks/COMMIT_MSG.md +530 -530
  159. package/templates/hooks/POST_CHECKOUT.md +546 -546
  160. package/templates/hooks/PREPARE_COMMIT_MSG.md +619 -619
  161. package/templates/hooks/PRE_COMMIT.md +414 -414
  162. package/templates/hooks/PRE_PUSH.md +601 -601
  163. package/templates/hooks/check-context-and-handoff.sh +16 -6
  164. package/templates/hooks/update-check.ps1 +84 -0
  165. package/templates/hooks/update-check.sh +103 -0
  166. package/templates/ides/CONTINUE_RULES.md +16 -16
  167. package/templates/ides/COPILOT_INSTRUCTIONS.md +23 -23
  168. package/templates/ides/GEMINI_RULES.md +17 -17
  169. package/templates/ides/WINDSURF_RULES.md +14 -14
  170. package/templates/languages/C.md +333 -333
  171. package/templates/languages/CPP.md +743 -743
  172. package/templates/languages/CSHARP.md +417 -417
  173. package/templates/languages/ELIXIR.md +454 -454
  174. package/templates/languages/ERLANG.md +361 -361
  175. package/templates/languages/GO.md +645 -645
  176. package/templates/languages/HASKELL.md +177 -177
  177. package/templates/languages/JAVA.md +607 -607
  178. package/templates/languages/JAVASCRIPT.md +631 -631
  179. package/templates/languages/JULIA.md +97 -97
  180. package/templates/languages/KOTLIN.md +511 -511
  181. package/templates/languages/LISP.md +100 -100
  182. package/templates/languages/LUA.md +74 -74
  183. package/templates/languages/OBJECTIVEC.md +90 -90
  184. package/templates/languages/PHP.md +416 -416
  185. package/templates/languages/PYTHON.md +682 -682
  186. package/templates/languages/RUBY.md +421 -421
  187. package/templates/languages/RUST.md +477 -477
  188. package/templates/languages/SAS.md +73 -73
  189. package/templates/languages/SCALA.md +348 -348
  190. package/templates/languages/SOLIDITY.md +580 -580
  191. package/templates/languages/SQL.md +137 -137
  192. package/templates/languages/SWIFT.md +466 -466
  193. package/templates/languages/TYPESCRIPT.md +591 -591
  194. package/templates/languages/ZIG.md +265 -265
  195. package/templates/libraries/go/ECHO.md +18 -0
  196. package/templates/libraries/go/GIN.md +18 -0
  197. package/templates/libraries/go/GORM.md +18 -0
  198. package/templates/libraries/python/DJANGO.md +18 -0
  199. package/templates/libraries/python/FASTAPI.md +18 -0
  200. package/templates/libraries/python/FLASK.md +17 -0
  201. package/templates/libraries/python/PYDANTIC.md +17 -0
  202. package/templates/libraries/python/PYTEST.md +17 -0
  203. package/templates/libraries/python/SQLALCHEMY.md +17 -0
  204. package/templates/libraries/rust/ACTIX.md +17 -0
  205. package/templates/libraries/rust/AXUM.md +18 -0
  206. package/templates/libraries/rust/SERDE.md +16 -0
  207. package/templates/libraries/rust/SQLX.md +17 -0
  208. package/templates/libraries/rust/TOKIO.md +16 -0
  209. package/templates/libraries/typescript/ANGULAR.md +17 -0
  210. package/templates/libraries/typescript/DRIZZLE.md +16 -0
  211. package/templates/libraries/typescript/EXPRESS.md +17 -0
  212. package/templates/libraries/typescript/HEROUI.md +16 -0
  213. package/templates/libraries/typescript/JEST.md +17 -0
  214. package/templates/libraries/typescript/NESTJS.md +17 -0
  215. package/templates/libraries/typescript/NEXT.md +18 -0
  216. package/templates/libraries/typescript/PRISMA.md +16 -0
  217. package/templates/libraries/typescript/RADIX.md +16 -0
  218. package/templates/libraries/typescript/REACT.md +18 -0
  219. package/templates/libraries/typescript/SHADCN.md +16 -0
  220. package/templates/libraries/typescript/SVELTE.md +16 -0
  221. package/templates/libraries/typescript/TAILWIND.md +16 -0
  222. package/templates/libraries/typescript/TRPC.md +16 -0
  223. package/templates/libraries/typescript/VITEST.md +17 -0
  224. package/templates/libraries/typescript/VUE.md +17 -0
  225. package/templates/libraries/typescript/ZOD.md +17 -0
  226. package/templates/modules/ATLASSIAN.md +255 -255
  227. package/templates/modules/CONTEXT7.md +54 -54
  228. package/templates/modules/FIGMA.md +267 -267
  229. package/templates/modules/GITHUB_MCP.md +64 -64
  230. package/templates/modules/GRAFANA.md +328 -328
  231. package/templates/modules/MEMORY.md +126 -126
  232. package/templates/modules/NOTION.md +247 -247
  233. package/templates/modules/PLAYWRIGHT.md +90 -90
  234. package/templates/modules/RULEBOOK_MCP.md +208 -208
  235. package/templates/modules/SERENA.md +337 -337
  236. package/templates/modules/SUPABASE.md +223 -223
  237. package/templates/modules/SYNAP.md +69 -69
  238. package/templates/modules/VECTORIZER.md +63 -63
  239. package/templates/modules/sequential-thinking.md +42 -42
  240. package/templates/rules/consult-analysis-before-implementing.md +23 -23
  241. package/templates/rules/cpp.md +46 -46
  242. package/templates/rules/csharp.md +44 -44
  243. package/templates/rules/diagnostic-first.md +39 -39
  244. package/templates/rules/fail-twice-escalate.md +46 -46
  245. package/templates/rules/follow-task-sequence.md +36 -36
  246. package/templates/rules/git-safety.md +29 -29
  247. package/templates/rules/go.md +40 -40
  248. package/templates/rules/incremental-implementation.md +56 -56
  249. package/templates/rules/incremental-tests.md +29 -29
  250. package/templates/rules/java.md +43 -43
  251. package/templates/rules/javascript.md +39 -39
  252. package/templates/rules/knowledge-base-usage.md +41 -41
  253. package/templates/rules/multi-agent-teams.md +75 -75
  254. package/templates/rules/no-deferred.md +31 -31
  255. package/templates/rules/no-shortcuts.md +30 -30
  256. package/templates/rules/python.md +43 -43
  257. package/templates/rules/research-first.md +30 -30
  258. package/templates/rules/respect-handoff-trigger.md +41 -41
  259. package/templates/rules/rust.md +40 -40
  260. package/templates/rules/sequential-editing.md +21 -21
  261. package/templates/rules/session-workflow.md +24 -24
  262. package/templates/rules/task-decomposition.md +32 -32
  263. package/templates/rules/typescript.md +40 -40
  264. package/templates/skills/cli/aider/SKILL.md +59 -59
  265. package/templates/skills/cli/amazon-q/SKILL.md +35 -35
  266. package/templates/skills/cli/auggie/SKILL.md +42 -42
  267. package/templates/skills/cli/claude/SKILL.md +42 -42
  268. package/templates/skills/cli/cline/SKILL.md +42 -42
  269. package/templates/skills/cli/codebuddy/SKILL.md +30 -30
  270. package/templates/skills/cli/codeium/SKILL.md +30 -30
  271. package/templates/skills/cli/codex/SKILL.md +31 -31
  272. package/templates/skills/cli/continue/SKILL.md +44 -44
  273. package/templates/skills/cli/cursor-cli/SKILL.md +38 -38
  274. package/templates/skills/cli/factory/SKILL.md +28 -28
  275. package/templates/skills/cli/gemini/SKILL.md +45 -45
  276. package/templates/skills/cli/kilocode/SKILL.md +28 -28
  277. package/templates/skills/core/agent-automation/SKILL.md +194 -194
  278. package/templates/skills/core/dag/SKILL.md +314 -314
  279. package/templates/skills/core/documentation-rules/SKILL.md +46 -46
  280. package/templates/skills/core/quality-enforcement/SKILL.md +78 -78
  281. package/templates/skills/core/rulebook/SKILL.md +176 -176
  282. package/templates/skills/core/rulebook-terse/SKILL.md +116 -116
  283. package/templates/skills/core/rulebook-terse-commit/SKILL.md +96 -96
  284. package/templates/skills/core/rulebook-terse-review/SKILL.md +112 -112
  285. package/templates/skills/dev/accessibility/SKILL.md +17 -17
  286. package/templates/skills/dev/analysis/SKILL.md +19 -19
  287. package/templates/skills/dev/api-design/SKILL.md +15 -15
  288. package/templates/skills/dev/architect/SKILL.md +17 -17
  289. package/templates/skills/dev/build-fix/SKILL.md +17 -17
  290. package/templates/skills/dev/db-design/SKILL.md +15 -15
  291. package/templates/skills/dev/debug/SKILL.md +16 -16
  292. package/templates/skills/dev/deploy/SKILL.md +17 -17
  293. package/templates/skills/dev/docs/SKILL.md +17 -17
  294. package/templates/skills/dev/handoff/SKILL.md +27 -27
  295. package/templates/skills/dev/migrate/SKILL.md +15 -15
  296. package/templates/skills/dev/perf/SKILL.md +17 -17
  297. package/templates/skills/dev/refactor/SKILL.md +17 -17
  298. package/templates/skills/dev/research/SKILL.md +14 -14
  299. package/templates/skills/dev/review/SKILL.md +18 -18
  300. package/templates/skills/dev/security-audit/SKILL.md +17 -17
  301. package/templates/skills/dev/spec/SKILL.md +65 -0
  302. package/templates/skills/ides/copilot/SKILL.md +47 -47
  303. package/templates/skills/ides/cursor/SKILL.md +53 -53
  304. package/templates/skills/ides/jetbrains-ai/SKILL.md +45 -45
  305. package/templates/skills/ides/replit/SKILL.md +46 -46
  306. package/templates/skills/ides/tabnine/SKILL.md +39 -39
  307. package/templates/skills/ides/vscode/SKILL.md +50 -50
  308. package/templates/skills/ides/windsurf/SKILL.md +46 -46
  309. package/templates/skills/ides/zed/SKILL.md +42 -42
  310. package/templates/skills/languages/c/SKILL.md +343 -343
  311. package/templates/skills/languages/cpp/SKILL.md +753 -753
  312. package/templates/skills/languages/csharp/SKILL.md +427 -427
  313. package/templates/skills/languages/elixir/SKILL.md +464 -464
  314. package/templates/skills/languages/erlang/SKILL.md +371 -371
  315. package/templates/skills/languages/go/SKILL.md +655 -655
  316. package/templates/skills/languages/haskell/SKILL.md +187 -187
  317. package/templates/skills/languages/java/SKILL.md +617 -617
  318. package/templates/skills/languages/javascript/SKILL.md +641 -641
  319. package/templates/skills/languages/julia/SKILL.md +107 -107
  320. package/templates/skills/languages/kotlin/SKILL.md +521 -521
  321. package/templates/skills/languages/lisp/SKILL.md +110 -110
  322. package/templates/skills/languages/lua/SKILL.md +84 -84
  323. package/templates/skills/languages/objectivec/SKILL.md +100 -100
  324. package/templates/skills/languages/php/SKILL.md +426 -426
  325. package/templates/skills/languages/python/SKILL.md +692 -692
  326. package/templates/skills/languages/ruby/SKILL.md +431 -431
  327. package/templates/skills/languages/rust/SKILL.md +487 -487
  328. package/templates/skills/languages/sas/SKILL.md +83 -83
  329. package/templates/skills/languages/scala/SKILL.md +358 -358
  330. package/templates/skills/languages/solidity/SKILL.md +590 -590
  331. package/templates/skills/languages/sql/SKILL.md +147 -147
  332. package/templates/skills/languages/swift/SKILL.md +476 -476
  333. package/templates/skills/languages/typescript/SKILL.md +302 -302
  334. package/templates/skills/languages/zig/SKILL.md +275 -275
  335. package/templates/skills/modules/atlassian/SKILL.md +265 -265
  336. package/templates/skills/modules/context7/SKILL.md +64 -64
  337. package/templates/skills/modules/figma/SKILL.md +277 -277
  338. package/templates/skills/modules/github-mcp/SKILL.md +74 -74
  339. package/templates/skills/modules/grafana/SKILL.md +338 -338
  340. package/templates/skills/modules/memory/SKILL.md +73 -73
  341. package/templates/skills/modules/notion/SKILL.md +257 -257
  342. package/templates/skills/modules/playwright/SKILL.md +100 -100
  343. package/templates/skills/modules/rulebook-mcp/SKILL.md +166 -166
  344. package/templates/skills/modules/serena/SKILL.md +347 -347
  345. package/templates/skills/modules/supabase/SKILL.md +233 -233
  346. package/templates/skills/modules/synap/SKILL.md +79 -79
  347. package/templates/skills/modules/vectorizer/SKILL.md +73 -73
  348. package/dist/agents/ralph-parser.d.ts +0 -91
  349. package/dist/agents/ralph-parser.d.ts.map +0 -1
  350. package/dist/agents/ralph-parser.js +0 -415
  351. package/dist/agents/ralph-parser.js.map +0 -1
  352. package/dist/cli/commands/analysis.d.ts +0 -8
  353. package/dist/cli/commands/analysis.d.ts.map +0 -1
  354. package/dist/cli/commands/analysis.js +0 -78
  355. package/dist/cli/commands/analysis.js.map +0 -1
  356. package/dist/cli/commands/compress.d.ts +0 -18
  357. package/dist/cli/commands/compress.d.ts.map +0 -1
  358. package/dist/cli/commands/compress.js +0 -100
  359. package/dist/cli/commands/compress.js.map +0 -1
  360. package/dist/cli/commands/ralph.d.ts +0 -45
  361. package/dist/cli/commands/ralph.d.ts.map +0 -1
  362. package/dist/cli/commands/ralph.js +0 -694
  363. package/dist/cli/commands/ralph.js.map +0 -1
  364. package/dist/cli/docs-prompts.d.ts +0 -3
  365. package/dist/cli/docs-prompts.d.ts.map +0 -1
  366. package/dist/cli/docs-prompts.js +0 -45
  367. package/dist/cli/docs-prompts.js.map +0 -1
  368. package/dist/core/agent-manager.d.ts +0 -69
  369. package/dist/core/agent-manager.d.ts.map +0 -1
  370. package/dist/core/agent-manager.js +0 -476
  371. package/dist/core/agent-manager.js.map +0 -1
  372. package/dist/core/agent-template-engine.d.ts +0 -51
  373. package/dist/core/agent-template-engine.d.ts.map +0 -1
  374. package/dist/core/agent-template-engine.js +0 -291
  375. package/dist/core/agent-template-engine.js.map +0 -1
  376. package/dist/core/analysis-manager.d.ts +0 -56
  377. package/dist/core/analysis-manager.d.ts.map +0 -1
  378. package/dist/core/analysis-manager.js +0 -218
  379. package/dist/core/analysis-manager.js.map +0 -1
  380. package/dist/core/auto-fixer.d.ts +0 -14
  381. package/dist/core/auto-fixer.d.ts.map +0 -1
  382. package/dist/core/auto-fixer.js +0 -207
  383. package/dist/core/auto-fixer.js.map +0 -1
  384. package/dist/core/changelog-generator.d.ts +0 -44
  385. package/dist/core/changelog-generator.d.ts.map +0 -1
  386. package/dist/core/changelog-generator.js +0 -222
  387. package/dist/core/changelog-generator.js.map +0 -1
  388. package/dist/core/claude-mcp.d.ts +0 -59
  389. package/dist/core/claude-mcp.d.ts.map +0 -1
  390. package/dist/core/claude-mcp.js +0 -220
  391. package/dist/core/claude-mcp.js.map +0 -1
  392. package/dist/core/claude-md-generator.d.ts +0 -52
  393. package/dist/core/claude-md-generator.d.ts.map +0 -1
  394. package/dist/core/claude-md-generator.js +0 -104
  395. package/dist/core/claude-md-generator.js.map +0 -1
  396. package/dist/core/claude-settings-manager.d.ts +0 -44
  397. package/dist/core/claude-settings-manager.d.ts.map +0 -1
  398. package/dist/core/claude-settings-manager.js +0 -191
  399. package/dist/core/claude-settings-manager.js.map +0 -1
  400. package/dist/core/cli-bridge.d.ts +0 -113
  401. package/dist/core/cli-bridge.d.ts.map +0 -1
  402. package/dist/core/cli-bridge.js +0 -1094
  403. package/dist/core/cli-bridge.js.map +0 -1
  404. package/dist/core/compact-context-manager.d.ts +0 -34
  405. package/dist/core/compact-context-manager.d.ts.map +0 -1
  406. package/dist/core/compact-context-manager.js +0 -60
  407. package/dist/core/compact-context-manager.js.map +0 -1
  408. package/dist/core/complexity-detector.d.ts +0 -36
  409. package/dist/core/complexity-detector.d.ts.map +0 -1
  410. package/dist/core/complexity-detector.js +0 -334
  411. package/dist/core/complexity-detector.js.map +0 -1
  412. package/dist/core/compress/compressor.d.ts +0 -60
  413. package/dist/core/compress/compressor.d.ts.map +0 -1
  414. package/dist/core/compress/compressor.js +0 -232
  415. package/dist/core/compress/compressor.js.map +0 -1
  416. package/dist/core/compress/discover.d.ts +0 -19
  417. package/dist/core/compress/discover.d.ts.map +0 -1
  418. package/dist/core/compress/discover.js +0 -100
  419. package/dist/core/compress/discover.js.map +0 -1
  420. package/dist/core/compress/validator.d.ts +0 -47
  421. package/dist/core/compress/validator.d.ts.map +0 -1
  422. package/dist/core/compress/validator.js +0 -131
  423. package/dist/core/compress/validator.js.map +0 -1
  424. package/dist/core/config-manager.d.ts +0 -86
  425. package/dist/core/config-manager.d.ts.map +0 -1
  426. package/dist/core/config-manager.js +0 -621
  427. package/dist/core/config-manager.js.map +0 -1
  428. package/dist/core/coverage-checker.d.ts +0 -14
  429. package/dist/core/coverage-checker.d.ts.map +0 -1
  430. package/dist/core/coverage-checker.js +0 -176
  431. package/dist/core/coverage-checker.js.map +0 -1
  432. package/dist/core/cursor-mdc-generator.d.ts +0 -30
  433. package/dist/core/cursor-mdc-generator.d.ts.map +0 -1
  434. package/dist/core/cursor-mdc-generator.js +0 -98
  435. package/dist/core/cursor-mdc-generator.js.map +0 -1
  436. package/dist/core/decision-manager.d.ts +0 -25
  437. package/dist/core/decision-manager.d.ts.map +0 -1
  438. package/dist/core/decision-manager.js +0 -183
  439. package/dist/core/decision-manager.js.map +0 -1
  440. package/dist/core/dependency-checker.d.ts +0 -21
  441. package/dist/core/dependency-checker.d.ts.map +0 -1
  442. package/dist/core/dependency-checker.js +0 -247
  443. package/dist/core/dependency-checker.js.map +0 -1
  444. package/dist/core/detector.d.ts +0 -27
  445. package/dist/core/detector.d.ts.map +0 -1
  446. package/dist/core/detector.js +0 -1763
  447. package/dist/core/detector.js.map +0 -1
  448. package/dist/core/docs-generator.d.ts +0 -9
  449. package/dist/core/docs-generator.d.ts.map +0 -1
  450. package/dist/core/docs-generator.js +0 -531
  451. package/dist/core/docs-generator.js.map +0 -1
  452. package/dist/core/doctor.d.ts +0 -19
  453. package/dist/core/doctor.d.ts.map +0 -1
  454. package/dist/core/doctor.js +0 -229
  455. package/dist/core/doctor.js.map +0 -1
  456. package/dist/core/generator.d.ts +0 -56
  457. package/dist/core/generator.d.ts.map +0 -1
  458. package/dist/core/generator.js +0 -1193
  459. package/dist/core/generator.js.map +0 -1
  460. package/dist/core/github-issues-importer.d.ts +0 -82
  461. package/dist/core/github-issues-importer.d.ts.map +0 -1
  462. package/dist/core/github-issues-importer.js +0 -161
  463. package/dist/core/github-issues-importer.js.map +0 -1
  464. package/dist/core/gitignore-generator.d.ts +0 -13
  465. package/dist/core/gitignore-generator.d.ts.map +0 -1
  466. package/dist/core/gitignore-generator.js +0 -307
  467. package/dist/core/gitignore-generator.js.map +0 -1
  468. package/dist/core/health-scorer.d.ts +0 -61
  469. package/dist/core/health-scorer.d.ts.map +0 -1
  470. package/dist/core/health-scorer.js +0 -638
  471. package/dist/core/health-scorer.js.map +0 -1
  472. package/dist/core/iteration-tracker.d.ts +0 -85
  473. package/dist/core/iteration-tracker.d.ts.map +0 -1
  474. package/dist/core/iteration-tracker.js +0 -295
  475. package/dist/core/iteration-tracker.js.map +0 -1
  476. package/dist/core/knowledge-manager.d.ts +0 -24
  477. package/dist/core/knowledge-manager.d.ts.map +0 -1
  478. package/dist/core/knowledge-manager.js +0 -173
  479. package/dist/core/knowledge-manager.js.map +0 -1
  480. package/dist/core/learn-manager.d.ts +0 -29
  481. package/dist/core/learn-manager.d.ts.map +0 -1
  482. package/dist/core/learn-manager.js +0 -159
  483. package/dist/core/learn-manager.js.map +0 -1
  484. package/dist/core/mcp-reference-generator.d.ts +0 -13
  485. package/dist/core/mcp-reference-generator.d.ts.map +0 -1
  486. package/dist/core/mcp-reference-generator.js +0 -66
  487. package/dist/core/mcp-reference-generator.js.map +0 -1
  488. package/dist/core/minimal-scaffolder.d.ts +0 -8
  489. package/dist/core/minimal-scaffolder.d.ts.map +0 -1
  490. package/dist/core/minimal-scaffolder.js +0 -51
  491. package/dist/core/minimal-scaffolder.js.map +0 -1
  492. package/dist/core/modern-console.d.ts +0 -98
  493. package/dist/core/modern-console.d.ts.map +0 -1
  494. package/dist/core/modern-console.js +0 -556
  495. package/dist/core/modern-console.js.map +0 -1
  496. package/dist/core/multi-tool-generator.d.ts +0 -59
  497. package/dist/core/multi-tool-generator.d.ts.map +0 -1
  498. package/dist/core/multi-tool-generator.js +0 -157
  499. package/dist/core/multi-tool-generator.js.map +0 -1
  500. package/dist/core/override-manager.d.ts +0 -23
  501. package/dist/core/override-manager.d.ts.map +0 -1
  502. package/dist/core/override-manager.js +0 -82
  503. package/dist/core/override-manager.js.map +0 -1
  504. package/dist/core/plans-manager.d.ts +0 -46
  505. package/dist/core/plans-manager.d.ts.map +0 -1
  506. package/dist/core/plans-manager.js +0 -158
  507. package/dist/core/plans-manager.js.map +0 -1
  508. package/dist/core/prd-generator.d.ts +0 -48
  509. package/dist/core/prd-generator.d.ts.map +0 -1
  510. package/dist/core/prd-generator.js +0 -233
  511. package/dist/core/prd-generator.js.map +0 -1
  512. package/dist/core/ralph-manager.d.ts +0 -163
  513. package/dist/core/ralph-manager.d.ts.map +0 -1
  514. package/dist/core/ralph-manager.js +0 -555
  515. package/dist/core/ralph-manager.js.map +0 -1
  516. package/dist/core/ralph-parallel.d.ts +0 -55
  517. package/dist/core/ralph-parallel.d.ts.map +0 -1
  518. package/dist/core/ralph-parallel.js +0 -201
  519. package/dist/core/ralph-parallel.js.map +0 -1
  520. package/dist/core/ralph-plan-checkpoint.d.ts +0 -58
  521. package/dist/core/ralph-plan-checkpoint.d.ts.map +0 -1
  522. package/dist/core/ralph-plan-checkpoint.js +0 -154
  523. package/dist/core/ralph-plan-checkpoint.js.map +0 -1
  524. package/dist/core/ralph-scripts.d.ts +0 -12
  525. package/dist/core/ralph-scripts.d.ts.map +0 -1
  526. package/dist/core/ralph-scripts.js +0 -50
  527. package/dist/core/ralph-scripts.js.map +0 -1
  528. package/dist/core/review-manager.d.ts +0 -74
  529. package/dist/core/review-manager.d.ts.map +0 -1
  530. package/dist/core/review-manager.js +0 -371
  531. package/dist/core/review-manager.js.map +0 -1
  532. package/dist/core/rules-generator.d.ts +0 -73
  533. package/dist/core/rules-generator.d.ts.map +0 -1
  534. package/dist/core/rules-generator.js +0 -202
  535. package/dist/core/rules-generator.js.map +0 -1
  536. package/dist/core/skills-manager.d.ts +0 -126
  537. package/dist/core/skills-manager.d.ts.map +0 -1
  538. package/dist/core/skills-manager.js +0 -654
  539. package/dist/core/skills-manager.js.map +0 -1
  540. package/dist/core/state-writer.d.ts +0 -35
  541. package/dist/core/state-writer.d.ts.map +0 -1
  542. package/dist/core/state-writer.js +0 -81
  543. package/dist/core/state-writer.js.map +0 -1
  544. package/dist/core/task-manager.d.ts +0 -127
  545. package/dist/core/task-manager.d.ts.map +0 -1
  546. package/dist/core/task-manager.js +0 -607
  547. package/dist/core/task-manager.js.map +0 -1
  548. package/dist/core/telemetry.d.ts +0 -29
  549. package/dist/core/telemetry.d.ts.map +0 -1
  550. package/dist/core/telemetry.js +0 -57
  551. package/dist/core/telemetry.js.map +0 -1
  552. package/dist/core/validator.d.ts +0 -21
  553. package/dist/core/validator.d.ts.map +0 -1
  554. package/dist/core/validator.js +0 -177
  555. package/dist/core/validator.js.map +0 -1
  556. package/dist/core/version-bumper.d.ts +0 -19
  557. package/dist/core/version-bumper.d.ts.map +0 -1
  558. package/dist/core/version-bumper.js +0 -180
  559. package/dist/core/version-bumper.js.map +0 -1
  560. package/dist/core/watcher.d.ts +0 -9
  561. package/dist/core/watcher.d.ts.map +0 -1
  562. package/dist/core/watcher.js +0 -22
  563. package/dist/core/watcher.js.map +0 -1
  564. package/dist/core/workflow-generator.d.ts +0 -15
  565. package/dist/core/workflow-generator.d.ts.map +0 -1
  566. package/dist/core/workflow-generator.js +0 -391
  567. package/dist/core/workflow-generator.js.map +0 -1
  568. package/dist/hooks/terse-activate.d.ts +0 -59
  569. package/dist/hooks/terse-activate.d.ts.map +0 -1
  570. package/dist/hooks/terse-activate.js +0 -149
  571. package/dist/hooks/terse-activate.js.map +0 -1
  572. package/dist/hooks/terse-config.d.ts +0 -51
  573. package/dist/hooks/terse-config.d.ts.map +0 -1
  574. package/dist/hooks/terse-config.js +0 -130
  575. package/dist/hooks/terse-config.js.map +0 -1
  576. package/dist/hooks/terse-mode-tracker.d.ts +0 -78
  577. package/dist/hooks/terse-mode-tracker.d.ts.map +0 -1
  578. package/dist/hooks/terse-mode-tracker.js +0 -213
  579. package/dist/hooks/terse-mode-tracker.js.map +0 -1
  580. package/dist/memory/hnsw-index.d.ts +0 -68
  581. package/dist/memory/hnsw-index.d.ts.map +0 -1
  582. package/dist/memory/hnsw-index.js +0 -544
  583. package/dist/memory/hnsw-index.js.map +0 -1
  584. package/dist/memory/memory-cache.d.ts +0 -33
  585. package/dist/memory/memory-cache.d.ts.map +0 -1
  586. package/dist/memory/memory-cache.js +0 -85
  587. package/dist/memory/memory-cache.js.map +0 -1
  588. package/dist/memory/memory-search.d.ts +0 -42
  589. package/dist/memory/memory-search.d.ts.map +0 -1
  590. package/dist/memory/memory-search.js +0 -180
  591. package/dist/memory/memory-search.js.map +0 -1
  592. package/dist/memory/memory-store.d.ts +0 -84
  593. package/dist/memory/memory-store.d.ts.map +0 -1
  594. package/dist/memory/memory-store.js +0 -566
  595. package/dist/memory/memory-store.js.map +0 -1
  596. package/dist/memory/memory-vectorizer.d.ts +0 -29
  597. package/dist/memory/memory-vectorizer.d.ts.map +0 -1
  598. package/dist/memory/memory-vectorizer.js +0 -199
  599. package/dist/memory/memory-vectorizer.js.map +0 -1
@@ -1,694 +0,0 @@
1
- import chalk from 'chalk';
2
- import { writeFile, ensureDir } from '../../utils/file-system.js';
3
- import path from 'path';
4
- /**
5
- * Build prompt for AI agent from user story context
6
- */
7
- export function ralphBuildPrompt(task, prd, contextHistory, plansContext) {
8
- const criteria = (task.acceptanceCriteria || []).map((c) => `- ${c}`).join('\n');
9
- return [
10
- `You are working on project: ${prd?.project || 'unknown'}`,
11
- ``,
12
- plansContext ? `## Session Context (PLANS.md)\n${plansContext}\n` : '',
13
- contextHistory && contextHistory !== 'No iteration history available.'
14
- ? `## Iteration History\n${contextHistory}\n`
15
- : '',
16
- `## Current Task: ${task.title}`,
17
- `ID: ${task.id}`,
18
- ``,
19
- `## Description`,
20
- task.description,
21
- ``,
22
- `## Acceptance Criteria`,
23
- criteria,
24
- ``,
25
- task.notes ? `## Notes\n${task.notes}\n` : '',
26
- `## Instructions`,
27
- `1. Implement the changes described above`,
28
- `2. Ensure all acceptance criteria are met`,
29
- `3. Run quality checks: type-check, lint, tests`,
30
- `4. Fix any issues found by quality checks`,
31
- `5. When done, summarize what was changed`,
32
- ]
33
- .filter(Boolean)
34
- .join('\n');
35
- }
36
- /**
37
- * Execute AI agent and capture output
38
- */
39
- export async function ralphExecuteAgent(tool, prompt, cwd, spawn) {
40
- const toolCommands = {
41
- claude: {
42
- cmd: 'claude',
43
- args: ['-p', '--dangerously-skip-permissions', '--verbose'],
44
- stdinPrompt: true,
45
- },
46
- amp: { cmd: 'amp', args: ['-p', prompt], stdinPrompt: false },
47
- gemini: { cmd: 'gemini', args: ['-p', prompt], stdinPrompt: false },
48
- };
49
- const config = toolCommands[tool] || toolCommands.claude;
50
- return new Promise((resolve, reject) => {
51
- let output = '';
52
- let errorOutput = '';
53
- const proc = spawn(config.cmd, config.args, {
54
- cwd,
55
- shell: true,
56
- stdio: ['pipe', 'pipe', 'pipe'],
57
- env: { ...process.env },
58
- });
59
- if (config.stdinPrompt && proc.stdin) {
60
- proc.stdin.write(prompt);
61
- proc.stdin.end();
62
- }
63
- proc.stdout?.on('data', (data) => {
64
- const text = data.toString();
65
- output += text;
66
- process.stdout.write(text);
67
- });
68
- proc.stderr?.on('data', (data) => {
69
- errorOutput += data.toString();
70
- });
71
- proc.on('close', (code) => {
72
- if (code === 0 || output.length > 0) {
73
- resolve(output || errorOutput);
74
- }
75
- else {
76
- reject(new Error(`Agent ${tool} exited with code ${code}: ${errorOutput.slice(0, 500)}`));
77
- }
78
- });
79
- proc.on('error', (err) => {
80
- reject(new Error(`Failed to start ${tool}: ${err.message}`));
81
- });
82
- setTimeout(() => {
83
- proc.kill('SIGTERM');
84
- resolve(output || 'Agent execution timed out after 10 minutes');
85
- }, 600000);
86
- });
87
- }
88
- /**
89
- * Run quality gates and return results
90
- */
91
- export async function ralphRunQualityGates(cwd, spawn) {
92
- const runGate = (cmd, args) => {
93
- return new Promise((resolve) => {
94
- const proc = spawn(cmd, args, {
95
- cwd,
96
- shell: true,
97
- stdio: ['pipe', 'pipe', 'pipe'],
98
- });
99
- proc.on('close', (code) => {
100
- resolve(code === 0);
101
- });
102
- proc.on('error', () => {
103
- resolve(false);
104
- });
105
- setTimeout(() => {
106
- proc.kill('SIGTERM');
107
- resolve(false);
108
- }, 120000);
109
- });
110
- };
111
- const { detectMonorepo } = await import('../../core/detector.js');
112
- const monorepo = await detectMonorepo(cwd).catch(() => ({
113
- detected: false,
114
- tool: null,
115
- packages: [],
116
- }));
117
- let testCmd = ['npm', ['test']];
118
- if (monorepo.detected) {
119
- if (monorepo.tool === 'turborepo')
120
- testCmd = ['turbo', ['run', 'test']];
121
- else if (monorepo.tool === 'nx')
122
- testCmd = ['nx', ['run-many', '--target=test']];
123
- }
124
- const [typeCheck, lint, tests] = await Promise.all([
125
- runGate('npm', ['run', 'type-check']),
126
- runGate('npm', ['run', 'lint']),
127
- runGate(testCmd[0], testCmd[1]),
128
- ]);
129
- return {
130
- type_check: typeCheck,
131
- lint: lint,
132
- tests: tests,
133
- coverage_met: tests,
134
- };
135
- }
136
- /**
137
- * Create git branch from PRD branchName
138
- */
139
- export async function ralphCreateBranch(cwd, branchName) {
140
- const { readFileSync } = await import('fs');
141
- const { spawn } = await import('child_process');
142
- try {
143
- const gitHeadPath = path.join(cwd, '.git', 'HEAD');
144
- const head = readFileSync(gitHeadPath, 'utf8').trim();
145
- const currentBranch = head.replace('ref: refs/heads/', '');
146
- if (currentBranch === branchName) {
147
- return;
148
- }
149
- }
150
- catch {
151
- return;
152
- }
153
- await new Promise((resolve) => {
154
- const proc = spawn('git', ['checkout', '-B', branchName], {
155
- cwd,
156
- shell: true,
157
- stdio: 'pipe',
158
- });
159
- proc.on('close', () => resolve());
160
- proc.on('error', () => resolve());
161
- });
162
- }
163
- /**
164
- * Commit changes after successful iteration
165
- */
166
- export async function ralphGitCommit(cwd, task, iteration, spawn) {
167
- await new Promise((resolve) => {
168
- const proc = spawn('git', ['add', '-A'], { cwd, shell: true, stdio: 'pipe' });
169
- proc.on('close', () => resolve());
170
- proc.on('error', () => resolve());
171
- });
172
- const hasChanges = await new Promise((resolve) => {
173
- let output = '';
174
- const proc = spawn('git', ['diff', '--cached', '--stat'], {
175
- cwd,
176
- shell: true,
177
- stdio: ['pipe', 'pipe', 'pipe'],
178
- });
179
- proc.stdout?.on('data', (data) => {
180
- output += data.toString();
181
- });
182
- proc.on('close', () => resolve(output.trim().length > 0));
183
- proc.on('error', () => resolve(false));
184
- });
185
- if (!hasChanges) {
186
- return undefined;
187
- }
188
- const commitMsg = `ralph(${task.id}): ${task.title}\n\nIteration ${iteration} - Ralph autonomous loop`;
189
- const commitHash = await new Promise((resolve) => {
190
- let output = '';
191
- const proc = spawn('git', ['commit', '-m', commitMsg], {
192
- cwd,
193
- shell: true,
194
- stdio: ['pipe', 'pipe', 'pipe'],
195
- });
196
- proc.stdout?.on('data', (data) => {
197
- output += data.toString();
198
- });
199
- proc.on('close', (code) => {
200
- if (code === 0) {
201
- const hashMatch = output.match(/\[[\w/.-]+ ([a-f0-9]+)\]/);
202
- resolve(hashMatch ? hashMatch[1] : undefined);
203
- }
204
- else {
205
- resolve(undefined);
206
- }
207
- });
208
- proc.on('error', () => resolve(undefined));
209
- });
210
- return commitHash;
211
- }
212
- export async function ralphInitCommand() {
213
- const oraModule = await import('ora');
214
- const ora = oraModule.default;
215
- const spinner = ora('Initializing Ralph autonomous loop...').start();
216
- try {
217
- const cwd = process.cwd();
218
- const { Logger } = await import('../../core/logger.js');
219
- const { RalphManager } = await import('../../core/ralph-manager.js');
220
- const { PRDGenerator } = await import('../../core/prd-generator.js');
221
- const { createConfigManager } = await import('../../core/config-manager.js');
222
- const logger = new Logger(cwd);
223
- const configManager = createConfigManager(cwd);
224
- const config = await configManager.loadConfig();
225
- const ralphManager = new RalphManager(cwd, logger);
226
- const prdGenerator = new PRDGenerator(cwd, logger);
227
- const maxIterations = config.ralph?.maxIterations || 10;
228
- const tool = (config.ralph?.tool || 'claude');
229
- await ralphManager.initialize(maxIterations, tool);
230
- const prd = await prdGenerator.generatePRD(path.basename(cwd));
231
- const prdPath = path.join(cwd, '.rulebook', 'ralph', 'prd.json');
232
- await writeFile(prdPath, JSON.stringify(prd, null, 2));
233
- spinner.succeed(`Ralph initialized: ${prd.userStories.length} user stories loaded`);
234
- console.log(`\n 📋 PRD: ${prdPath}`);
235
- console.log(` 🔄 Max iterations: ${maxIterations}`);
236
- console.log(` 🤖 AI Tool: ${tool}`);
237
- console.log(`\n Run: ${chalk.bold('rulebook ralph run')}\n`);
238
- }
239
- catch (error) {
240
- spinner.fail('Ralph initialization failed');
241
- console.error(chalk.red(String(error)));
242
- process.exit(1);
243
- }
244
- }
245
- export async function ralphRunCommand(options) {
246
- const oraModule = await import('ora');
247
- const ora = oraModule.default;
248
- const spinner = ora('Starting Ralph autonomous loop...').start();
249
- try {
250
- const cwd = process.cwd();
251
- const { Logger } = await import('../../core/logger.js');
252
- const { RalphManager } = await import('../../core/ralph-manager.js');
253
- const { RalphParser } = await import('../../agents/ralph-parser.js');
254
- const { createConfigManager } = await import('../../core/config-manager.js');
255
- const { IterationTracker } = await import('../../core/iteration-tracker.js');
256
- const childProcess = await import('child_process');
257
- const logger = new Logger(cwd);
258
- const configManager = createConfigManager(cwd);
259
- const config = await configManager.loadConfig();
260
- const ralphManager = new RalphManager(cwd, logger);
261
- const maxIterations = options.maxIterations || config.ralph?.maxIterations || 10;
262
- const tool = options.tool || config.ralph?.tool || 'claude';
263
- const parallelWorkers = options.parallel ??
264
- (config.ralph?.parallel?.enabled ? config.ralph.parallel.maxWorkers : undefined);
265
- const planCheckpointConfig = {
266
- enabled: options.planFirst ?? config.ralph?.planCheckpoint?.enabled ?? false,
267
- autoApproveAfterSeconds: config.ralph?.planCheckpoint?.autoApproveAfterSeconds ?? 0,
268
- requireApprovalForStories: config.ralph?.planCheckpoint?.requireApprovalForStories ?? 'all',
269
- };
270
- const compressionConfig = config.ralph?.contextCompression;
271
- const compressionEnabled = compressionConfig?.enabled !== false;
272
- const compressionRecentCount = compressionConfig?.recentCount ?? 3;
273
- const compressionThreshold = compressionConfig?.threshold ?? 5;
274
- const iterationTracker = new IterationTracker(cwd, logger);
275
- await iterationTracker.initialize();
276
- await ralphManager.initialize(maxIterations, tool);
277
- const prd = await ralphManager.loadPRD();
278
- if (prd?.branchName) {
279
- await ralphCreateBranch(cwd, prd.branchName);
280
- }
281
- let interrupted = false;
282
- const handleInterrupt = async () => {
283
- interrupted = true;
284
- spinner.warn('Pausing after current iteration...');
285
- await ralphManager.pause();
286
- };
287
- process.on('SIGINT', handleInterrupt);
288
- await ralphManager.refreshTaskCount();
289
- if (parallelWorkers && parallelWorkers > 1) {
290
- spinner.text = `Ralph parallel mode (${parallelWorkers} workers)...`;
291
- const batches = await ralphManager.getParallelBatches(parallelWorkers);
292
- spinner.stop();
293
- console.log(chalk.bold.cyan(`\n Parallel mode: ${batches.length} batch(es), max ${parallelWorkers} workers\n`));
294
- let iterationCount = 0;
295
- for (const batch of batches) {
296
- if (interrupted)
297
- break;
298
- console.log(chalk.bold(` ── Batch: ${batch.map((s) => s.id).join(', ')} (${batch.length} stories) ──`));
299
- const batchResults = await Promise.allSettled(batch.map(async (task) => {
300
- iterationCount++;
301
- const localIteration = iterationCount;
302
- const startTime = Date.now();
303
- let contextHistory = '';
304
- if (compressionEnabled) {
305
- contextHistory = await iterationTracker.buildCompressedContext(compressionRecentCount, compressionThreshold);
306
- }
307
- let plansContext = '';
308
- try {
309
- const { readPlans, plansExists } = await import('../../core/plans-manager.js');
310
- if (plansExists(cwd)) {
311
- const plans = await readPlans(cwd);
312
- if (plans?.context && plans.context.trim()) {
313
- plansContext = plans.context.trim();
314
- }
315
- }
316
- }
317
- catch {
318
- // PLANS.md injection is optional
319
- }
320
- const prompt = ralphBuildPrompt(task, prd, contextHistory, plansContext);
321
- let agentOutput = '';
322
- try {
323
- agentOutput = await ralphExecuteAgent(tool, prompt, cwd, childProcess.spawn);
324
- }
325
- catch (agentError) {
326
- agentOutput = `Error executing agent: ${agentError.message || agentError}`;
327
- }
328
- const qualityResults = await ralphRunQualityGates(cwd, childProcess.spawn);
329
- const executionTime = Date.now() - startTime;
330
- const parsed = RalphParser.parseAgentOutput(agentOutput, localIteration, task.id, task.title, tool);
331
- const allGatesPass = qualityResults.type_check &&
332
- qualityResults.lint &&
333
- qualityResults.tests &&
334
- qualityResults.coverage_met;
335
- const passCount = Object.values(qualityResults).filter(Boolean).length;
336
- const status = allGatesPass
337
- ? 'success'
338
- : passCount >= 2
339
- ? 'partial'
340
- : 'failed';
341
- let gitCommit;
342
- if (allGatesPass) {
343
- gitCommit = await ralphGitCommit(cwd, task, localIteration, childProcess.spawn);
344
- await ralphManager.markStoryComplete(task.id);
345
- console.log(chalk.green(` [parallel] Story ${task.id} completed`));
346
- }
347
- else {
348
- console.log(chalk.yellow(` [parallel] Story ${task.id} not completed (quality gates failed)`));
349
- }
350
- const result = {
351
- iteration: localIteration,
352
- timestamp: new Date().toISOString(),
353
- task_id: task.id,
354
- task_title: task.title,
355
- status,
356
- ai_tool: tool,
357
- execution_time_ms: executionTime,
358
- quality_checks: qualityResults,
359
- output_summary: parsed.output_summary || `Iteration ${localIteration}: ${task.title}`,
360
- git_commit: gitCommit,
361
- learnings: parsed.learnings,
362
- errors: parsed.errors,
363
- metadata: {
364
- context_loss_count: parsed.metadata.context_loss_count,
365
- parsed_completion: parsed.metadata.parsed_completion,
366
- },
367
- };
368
- await ralphManager.recordIteration(result);
369
- return result;
370
- }));
371
- for (const [i, result] of batchResults.entries()) {
372
- if (result.status === 'rejected') {
373
- const story = batch[i];
374
- console.log(chalk.red(` [parallel] Story ${story.id} threw: ${result.reason}`));
375
- }
376
- }
377
- const currentStatus = await ralphManager.getStatus();
378
- if (currentStatus?.paused)
379
- break;
380
- }
381
- process.removeListener('SIGINT', handleInterrupt);
382
- const stats = await ralphManager.getTaskStats();
383
- console.log(`\n Parallel run complete: ${stats.completed}/${stats.total} tasks completed`);
384
- console.log(` Iterations: ${iterationCount}`);
385
- if (interrupted) {
386
- console.log(chalk.yellow(` Paused by user. Resume: ${chalk.bold('rulebook ralph resume')}`));
387
- }
388
- console.log(`\n View history: ${chalk.bold('rulebook ralph history')}\n`);
389
- return;
390
- }
391
- spinner.text = 'Ralph loop running (Ctrl+C to pause)...';
392
- let iterationCount = 0;
393
- while (ralphManager.canContinue() && !interrupted) {
394
- iterationCount++;
395
- const task = await ralphManager.getNextTask();
396
- if (!task) {
397
- break;
398
- }
399
- spinner.stop();
400
- console.log(chalk.bold.cyan(`\n ── Iteration ${iterationCount}: ${task.title} ──\n`));
401
- const startTime = Date.now();
402
- if (planCheckpointConfig.enabled) {
403
- const checkpoint = await ralphManager.runCheckpoint(task, tool, planCheckpointConfig);
404
- if (!checkpoint.proceed) {
405
- console.log(chalk.yellow(` Plan rejected for ${task.id}. Skipping implementation.`));
406
- if (checkpoint.feedback) {
407
- console.log(chalk.gray(` Feedback: ${checkpoint.feedback}`));
408
- }
409
- spinner.start('Preparing next iteration...');
410
- continue;
411
- }
412
- }
413
- let contextHistory = '';
414
- if (compressionEnabled) {
415
- contextHistory = await iterationTracker.buildCompressedContext(compressionRecentCount, compressionThreshold);
416
- }
417
- let plansContext = '';
418
- try {
419
- const { readPlans, plansExists } = await import('../../core/plans-manager.js');
420
- if (plansExists(cwd)) {
421
- const plans = await readPlans(cwd);
422
- if (plans?.context && plans.context.trim()) {
423
- plansContext = plans.context.trim();
424
- }
425
- }
426
- }
427
- catch {
428
- // PLANS.md injection is optional — skip on error
429
- }
430
- const prompt = ralphBuildPrompt(task, prd, contextHistory, plansContext);
431
- let agentOutput = '';
432
- try {
433
- agentOutput = await ralphExecuteAgent(tool, prompt, cwd, childProcess.spawn);
434
- }
435
- catch (agentError) {
436
- agentOutput = `Error executing agent: ${agentError.message || agentError}`;
437
- console.log(chalk.red(` Agent error: ${agentError.message || agentError}`));
438
- }
439
- spinner.start('Running quality gates...');
440
- const qualityResults = await ralphRunQualityGates(cwd, childProcess.spawn);
441
- spinner.stop();
442
- const gateIcon = (pass) => (pass ? chalk.green('✓') : chalk.red('✗'));
443
- console.log(` ${gateIcon(qualityResults.type_check)} type-check`);
444
- console.log(` ${gateIcon(qualityResults.lint)} lint`);
445
- console.log(` ${gateIcon(qualityResults.tests)} tests`);
446
- console.log(` ${gateIcon(qualityResults.coverage_met)} coverage`);
447
- const executionTime = Date.now() - startTime;
448
- const parsed = RalphParser.parseAgentOutput(agentOutput, iterationCount, task.id, task.title, tool);
449
- const allGatesPass = qualityResults.type_check &&
450
- qualityResults.lint &&
451
- qualityResults.tests &&
452
- qualityResults.coverage_met;
453
- const passCount = Object.values(qualityResults).filter(Boolean).length;
454
- const status = allGatesPass
455
- ? 'success'
456
- : passCount >= 2
457
- ? 'partial'
458
- : 'failed';
459
- let gitCommit;
460
- if (allGatesPass) {
461
- gitCommit = await ralphGitCommit(cwd, task, iterationCount, childProcess.spawn);
462
- await ralphManager.markStoryComplete(task.id);
463
- console.log(chalk.green(`\n ✅ Story ${task.id} completed`));
464
- }
465
- else {
466
- console.log(chalk.yellow(`\n ⚠ Story ${task.id} not completed (quality gates failed)`));
467
- }
468
- const result = {
469
- iteration: iterationCount,
470
- timestamp: new Date().toISOString(),
471
- task_id: task.id,
472
- task_title: task.title,
473
- status,
474
- ai_tool: tool,
475
- execution_time_ms: executionTime,
476
- quality_checks: qualityResults,
477
- output_summary: parsed.output_summary || `Iteration ${iterationCount}: ${task.title}`,
478
- git_commit: gitCommit,
479
- learnings: parsed.learnings,
480
- errors: parsed.errors,
481
- metadata: {
482
- context_loss_count: parsed.metadata.context_loss_count,
483
- parsed_completion: parsed.metadata.parsed_completion,
484
- },
485
- };
486
- await ralphManager.recordIteration(result);
487
- spinner.start('Preparing next iteration...');
488
- }
489
- process.removeListener('SIGINT', handleInterrupt);
490
- const stats = await ralphManager.getTaskStats();
491
- spinner.succeed(`Ralph loop complete: ${stats.completed}/${stats.total} tasks completed`);
492
- console.log(`\n ✅ Iterations: ${iterationCount}`);
493
- console.log(` 📊 Completed: ${stats.completed}/${stats.total}`);
494
- if (interrupted) {
495
- console.log(chalk.yellow(` ⏸ Paused by user. Resume: ${chalk.bold('rulebook ralph resume')}`));
496
- }
497
- console.log(`\n View history: ${chalk.bold('rulebook ralph history')}\n`);
498
- }
499
- catch (error) {
500
- spinner.fail('Ralph loop failed');
501
- console.error(chalk.red(String(error)));
502
- process.exit(1);
503
- }
504
- }
505
- export async function ralphStatusCommand() {
506
- const oraModule = await import('ora');
507
- const ora = oraModule.default;
508
- const spinner = ora('Loading Ralph status...').start();
509
- try {
510
- const cwd = process.cwd();
511
- const { Logger } = await import('../../core/logger.js');
512
- const { RalphManager } = await import('../../core/ralph-manager.js');
513
- const logger = new Logger(cwd);
514
- const ralphManager = new RalphManager(cwd, logger);
515
- const status = await ralphManager.getStatus();
516
- if (!status) {
517
- spinner.fail('Ralph not initialized');
518
- console.log(`\n Run: ${chalk.bold('rulebook ralph init')}\n`);
519
- return;
520
- }
521
- spinner.stop();
522
- const { createConfigManager } = await import('../../core/config-manager.js');
523
- const configManager = createConfigManager(cwd);
524
- const cfg = await configManager.loadConfig();
525
- const agentsMode = cfg.agentsMode ?? 'full';
526
- console.log(`\n ${chalk.bold('Ralph Loop Status')}`);
527
- console.log(` Iteration: ${status.current_iteration}/${status.max_iterations}`);
528
- console.log(` Tasks: ${status.completed_tasks}/${status.total_tasks}`);
529
- console.log(` Status: ${status.paused ? chalk.yellow('PAUSED') : chalk.green('RUNNING')}`);
530
- console.log(` AI Tool: ${status.tool}`);
531
- console.log(` Started: ${new Date(status.started_at).toLocaleString()}`);
532
- console.log(` Agents Mode: ${agentsMode === 'lean' ? chalk.cyan('lean') : chalk.gray('full')} (rulebook mode set lean|full)`);
533
- console.log();
534
- }
535
- catch (error) {
536
- spinner.fail('Failed to load status');
537
- console.error(chalk.red(String(error)));
538
- process.exit(1);
539
- }
540
- }
541
- export async function ralphHistoryCommand(options) {
542
- const oraModule = await import('ora');
543
- const ora = oraModule.default;
544
- const spinner = ora('Loading iteration history...').start();
545
- try {
546
- const cwd = process.cwd();
547
- const { Logger } = await import('../../core/logger.js');
548
- const { IterationTracker } = await import('../../core/iteration-tracker.js');
549
- const logger = new Logger(cwd);
550
- const tracker = new IterationTracker(cwd, logger);
551
- const limit = options.limit || 10;
552
- const history = await tracker.getHistory(limit);
553
- if (history.length === 0) {
554
- spinner.fail('No iteration history found');
555
- return;
556
- }
557
- spinner.stop();
558
- console.log(`\n ${chalk.bold('Recent Iterations')} (${history.length})\n`);
559
- for (const iter of history) {
560
- const statusIcon = iter.status === 'success'
561
- ? chalk.green('✓')
562
- : iter.status === 'partial'
563
- ? chalk.yellow('◐')
564
- : chalk.red('✗');
565
- console.log(` ${statusIcon} Iteration ${iter.iteration}: ${iter.task_title}`);
566
- console.log(` Status: ${iter.status} | Duration: ${(iter.duration_ms || 0) / 1000}s`);
567
- console.log(` Checks: type=${iter.quality_checks.type_check ? '✓' : '✗'} lint=${iter.quality_checks.lint ? '✓' : '✗'} tests=${iter.quality_checks.tests ? '✓' : '✗'}`);
568
- if (iter.git_commit) {
569
- console.log(` Commit: ${iter.git_commit}`);
570
- }
571
- console.log();
572
- }
573
- const stats = await tracker.getStatistics();
574
- console.log(` ${chalk.bold('Statistics')}`);
575
- console.log(` Total: ${stats.total_iterations} | Success: ${stats.successful_iterations} | Failed: ${stats.failed_iterations}`);
576
- console.log(` Success rate: ${(stats.success_rate * 100).toFixed(1)}%`);
577
- console.log(` Avg duration: ${stats.average_duration_ms}ms\n`);
578
- }
579
- catch (error) {
580
- spinner.fail('Failed to load history');
581
- console.error(chalk.red(String(error)));
582
- process.exit(1);
583
- }
584
- }
585
- export async function ralphPauseCommand() {
586
- const oraModule = await import('ora');
587
- const ora = oraModule.default;
588
- const spinner = ora('Pausing Ralph loop...').start();
589
- try {
590
- const cwd = process.cwd();
591
- const { Logger } = await import('../../core/logger.js');
592
- const { RalphManager } = await import('../../core/ralph-manager.js');
593
- const logger = new Logger(cwd);
594
- const ralphManager = new RalphManager(cwd, logger);
595
- const status = await ralphManager.getStatus();
596
- if (!status) {
597
- spinner.fail('Ralph not initialized');
598
- console.log(`\n Run: ${chalk.bold('rulebook ralph init')}\n`);
599
- return;
600
- }
601
- await ralphManager.pause();
602
- spinner.succeed('Ralph loop paused');
603
- console.log(`\n Resume with: ${chalk.bold('rulebook ralph resume')}\n`);
604
- }
605
- catch (error) {
606
- spinner.fail('Failed to pause');
607
- console.error(chalk.red(String(error)));
608
- process.exit(1);
609
- }
610
- }
611
- export async function ralphResumeCommand() {
612
- const oraModule = await import('ora');
613
- const ora = oraModule.default;
614
- const spinner = ora('Resuming Ralph loop...').start();
615
- try {
616
- const cwd = process.cwd();
617
- const { Logger } = await import('../../core/logger.js');
618
- const { RalphManager } = await import('../../core/ralph-manager.js');
619
- const logger = new Logger(cwd);
620
- const ralphManager = new RalphManager(cwd, logger);
621
- const status = await ralphManager.getStatus();
622
- if (!status) {
623
- spinner.fail('Ralph not initialized');
624
- console.log(`\n Run: ${chalk.bold('rulebook ralph init')}\n`);
625
- return;
626
- }
627
- await ralphManager.resume();
628
- spinner.succeed('Ralph loop resumed');
629
- console.log(`\n Continue loop: ${chalk.bold('rulebook ralph run')}\n`);
630
- }
631
- catch (error) {
632
- spinner.fail('Failed to resume');
633
- console.error(chalk.red(String(error)));
634
- process.exit(1);
635
- }
636
- }
637
- export async function ralphImportIssuesCommand(options) {
638
- const oraModule = await import('ora');
639
- const ora = oraModule.default;
640
- try {
641
- const { checkGhCliAvailable, fetchGithubIssues, convertIssueToStory, mergeStoriesIntoExistingPrd, } = await import('../../core/github-issues-importer.js');
642
- const ghAvailable = await checkGhCliAvailable();
643
- if (!ghAvailable) {
644
- console.error(chalk.red('GitHub CLI (gh) is not installed. Install it from: https://cli.github.com'));
645
- return;
646
- }
647
- const spinner = ora('Fetching GitHub issues...').start();
648
- const issues = await fetchGithubIssues({
649
- label: options.label,
650
- milestone: options.milestone,
651
- limit: options.limit ?? 20,
652
- });
653
- if (issues.length === 0) {
654
- spinner.info('No open issues found matching the given filters.');
655
- return;
656
- }
657
- spinner.text = `Converting ${issues.length} issues to Ralph stories...`;
658
- const cwd = process.cwd();
659
- let existingPrd = null;
660
- try {
661
- const { RalphManager } = await import('../../core/ralph-manager.js');
662
- const { Logger } = await import('../../core/logger.js');
663
- const logger = new Logger(cwd);
664
- const manager = new RalphManager(cwd, logger);
665
- existingPrd = await manager.loadPRD();
666
- }
667
- catch {
668
- // PRD not initialized — will create a new one
669
- }
670
- const newStories = issues.map((issue) => convertIssueToStory(issue));
671
- const { prd: mergedPrd, result } = mergeStoriesIntoExistingPrd(existingPrd, newStories);
672
- if (options.dryRun) {
673
- spinner.stop();
674
- console.log(chalk.yellow(`Dry run — would import ${result.imported} stories, update ${result.updated}, skip ${result.skipped}`));
675
- console.log('');
676
- for (const story of mergedPrd.userStories) {
677
- const marker = story.passes ? chalk.green('[PASS]') : chalk.gray('[ ]');
678
- console.log(` ${marker} ${story.id}: ${story.title}`);
679
- }
680
- return;
681
- }
682
- const prdPath = path.join(cwd, '.rulebook', 'ralph', 'prd.json');
683
- await ensureDir(path.join(cwd, '.rulebook', 'ralph'));
684
- await writeFile(prdPath, JSON.stringify(mergedPrd, null, 2));
685
- spinner.succeed(`Imported ${result.imported} new stories, updated ${result.updated} existing, ${result.skipped} skipped`);
686
- console.log(`\n PRD saved to: ${prdPath}`);
687
- console.log(` Total stories: ${mergedPrd.userStories.length}\n`);
688
- }
689
- catch (error) {
690
- console.error(chalk.red(`Failed to import GitHub issues: ${String(error)}`));
691
- process.exit(1);
692
- }
693
- }
694
- //# sourceMappingURL=ralph.js.map