create-hq 6.0.0 → 10.0.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 (336) hide show
  1. package/dist/__tests__/deps.test.d.ts +2 -0
  2. package/dist/__tests__/deps.test.d.ts.map +1 -0
  3. package/dist/__tests__/deps.test.js +176 -0
  4. package/dist/__tests__/deps.test.js.map +1 -0
  5. package/dist/__tests__/platform.test.d.ts +2 -0
  6. package/dist/__tests__/platform.test.d.ts.map +1 -0
  7. package/dist/__tests__/platform.test.js +127 -0
  8. package/dist/__tests__/platform.test.js.map +1 -0
  9. package/dist/__tests__/scaffold.test.d.ts +2 -0
  10. package/dist/__tests__/scaffold.test.d.ts.map +1 -0
  11. package/dist/__tests__/scaffold.test.js +150 -0
  12. package/dist/__tests__/scaffold.test.js.map +1 -0
  13. package/dist/auth.d.ts +32 -0
  14. package/dist/auth.d.ts.map +1 -0
  15. package/dist/auth.js +156 -0
  16. package/dist/auth.js.map +1 -0
  17. package/dist/cloud-sync.d.ts +11 -0
  18. package/dist/cloud-sync.d.ts.map +1 -0
  19. package/dist/cloud-sync.js +25 -0
  20. package/dist/cloud-sync.js.map +1 -0
  21. package/dist/deps.d.ts +32 -2
  22. package/dist/deps.d.ts.map +1 -1
  23. package/dist/deps.js +182 -7
  24. package/dist/deps.js.map +1 -1
  25. package/dist/fetch-template.d.ts +14 -0
  26. package/dist/fetch-template.d.ts.map +1 -0
  27. package/dist/fetch-template.js +136 -0
  28. package/dist/fetch-template.js.map +1 -0
  29. package/dist/index.js +9 -7
  30. package/dist/index.js.map +1 -1
  31. package/dist/packages.d.ts +71 -0
  32. package/dist/packages.d.ts.map +1 -0
  33. package/dist/packages.js +332 -0
  34. package/dist/packages.js.map +1 -0
  35. package/dist/platform.d.ts +9 -0
  36. package/dist/platform.d.ts.map +1 -0
  37. package/dist/platform.js +69 -0
  38. package/dist/platform.js.map +1 -0
  39. package/dist/scaffold.d.ts +3 -2
  40. package/dist/scaffold.d.ts.map +1 -1
  41. package/dist/scaffold.js +109 -290
  42. package/dist/scaffold.js.map +1 -1
  43. package/dist/ui.d.ts +2 -3
  44. package/dist/ui.d.ts.map +1 -1
  45. package/dist/ui.js +90 -44
  46. package/dist/ui.js.map +1 -1
  47. package/package.json +49 -40
  48. package/template/.claude/CLAUDE.md +0 -202
  49. package/template/.claude/commands/checkpoint.md +0 -127
  50. package/template/.claude/commands/cleanup.md +0 -307
  51. package/template/.claude/commands/execute-task.md +0 -440
  52. package/template/.claude/commands/exit-plan.md +0 -41
  53. package/template/.claude/commands/handoff.md +0 -97
  54. package/template/.claude/commands/learn.md +0 -218
  55. package/template/.claude/commands/metrics.md +0 -118
  56. package/template/.claude/commands/newworker.md +0 -162
  57. package/template/.claude/commands/nexttask.md +0 -67
  58. package/template/.claude/commands/prd.md +0 -238
  59. package/template/.claude/commands/reanchor.md +0 -51
  60. package/template/.claude/commands/remember.md +0 -126
  61. package/template/.claude/commands/run-project.md +0 -348
  62. package/template/.claude/commands/run.md +0 -110
  63. package/template/.claude/commands/search-reindex.md +0 -62
  64. package/template/.claude/commands/search.md +0 -100
  65. package/template/.claude/commands/setup.md +0 -381
  66. package/template/.claude/scripts/pure-ralph-loop.ps1 +0 -312
  67. package/template/.claude/scripts/pure-ralph-loop.sh +0 -859
  68. package/template/CHANGELOG.md +0 -220
  69. package/template/LICENSE +0 -21
  70. package/template/MIGRATION.md +0 -259
  71. package/template/README.md +0 -368
  72. package/template/data/journal/.gitkeep +0 -0
  73. package/template/docs/images/ascii-banner-options.md +0 -122
  74. package/template/docs/images/hq-banner.svg +0 -105
  75. package/template/knowledge/Ralph/01-overview.md +0 -71
  76. package/template/knowledge/Ralph/02-core-concepts.md +0 -114
  77. package/template/knowledge/Ralph/03-how-ralph-works.md +0 -184
  78. package/template/knowledge/Ralph/04-back-pressure.md +0 -222
  79. package/template/knowledge/Ralph/05-specifications.md +0 -210
  80. package/template/knowledge/Ralph/06-agents-md.md +0 -222
  81. package/template/knowledge/Ralph/07-implementation.md +0 -316
  82. package/template/knowledge/Ralph/08-economics.md +0 -182
  83. package/template/knowledge/Ralph/09-resources.md +0 -145
  84. package/template/knowledge/Ralph/10-claude-code-workflow.md +0 -212
  85. package/template/knowledge/Ralph/11-team-training-guide.md +0 -383
  86. package/template/knowledge/Ralph/README.md +0 -40
  87. package/template/knowledge/ai-security-framework/CONTRIBUTING.md +0 -139
  88. package/template/knowledge/ai-security-framework/GLOSSARY.md +0 -176
  89. package/template/knowledge/ai-security-framework/LICENSE +0 -21
  90. package/template/knowledge/ai-security-framework/QUICK-START.md +0 -172
  91. package/template/knowledge/ai-security-framework/README.md +0 -232
  92. package/template/knowledge/ai-security-framework/checklists/browser-security.md +0 -301
  93. package/template/knowledge/ai-security-framework/checklists/credential-isolation.md +0 -322
  94. package/template/knowledge/ai-security-framework/checklists/incident-response.md +0 -288
  95. package/template/knowledge/ai-security-framework/checklists/pre-flight.md +0 -249
  96. package/template/knowledge/ai-security-framework/checklists/weekly-audit.md +0 -159
  97. package/template/knowledge/ai-security-framework/configs/audit-logging.md +0 -372
  98. package/template/knowledge/ai-security-framework/configs/kill-switches.md +0 -354
  99. package/template/knowledge/ai-security-framework/docs/01-core-principles.md +0 -256
  100. package/template/knowledge/ai-security-framework/docs/02-threat-landscape.md +0 -326
  101. package/template/knowledge/ai-security-framework/docs/03-security-posture.md +0 -250
  102. package/template/knowledge/ai-security-framework/templates/agents-security.md +0 -233
  103. package/template/knowledge/design-styles/README.md +0 -42
  104. package/template/knowledge/design-styles/american-industrial.md +0 -136
  105. package/template/knowledge/design-styles/ethereal-abstract.md +0 -133
  106. package/template/knowledge/design-styles/liminal-portal.md +0 -111
  107. package/template/knowledge/design-styles/swipes/american-industrial/G-3m4YPW0AADdu2.jpeg +0 -0
  108. package/template/knowledge/design-styles/swipes/american-industrial/G-JJlt5WwAABK3K.png +0 -0
  109. package/template/knowledge/design-styles/swipes/american-industrial/G-JJmj5W0AEbJ-7.png +0 -0
  110. package/template/knowledge/design-styles/swipes/american-industrial/G59fgNuXkAAKLJQ (1).jpeg +0 -0
  111. package/template/knowledge/design-styles/swipes/american-industrial/G59fgNuXkAAKLJQ.jpeg +0 -0
  112. package/template/knowledge/design-styles/swipes/american-industrial/G7fVkn3WEAAM-ST.jpeg +0 -0
  113. package/template/knowledge/design-styles/swipes/american-industrial/G8ECO5JWEAIksyn.png +0 -0
  114. package/template/knowledge/design-styles/swipes/american-industrial/G9-3GQSWoAA8eqZ.png +0 -0
  115. package/template/knowledge/design-styles/swipes/american-industrial/G9xEOqrXkAEZRcs.png +0 -0
  116. package/template/knowledge/design-styles/swipes/american-industrial/G_MVeJrXQAA8sx4.jpeg +0 -0
  117. package/template/knowledge/design-styles/swipes/american-industrial/G_RSkmGXkAAgAVZ.png +0 -0
  118. package/template/knowledge/design-styles/swipes/american-industrial/README.md +0 -31
  119. package/template/knowledge/design-styles/swipes/american-industrial/qyqtg7Dq.png +0 -0
  120. package/template/knowledge/dev-team/README.md +0 -35
  121. package/template/knowledge/dev-team/patterns/README.md +0 -34
  122. package/template/knowledge/dev-team/patterns/frontend/react-best-practices.md +0 -178
  123. package/template/knowledge/dev-team/troubleshooting/README.md +0 -31
  124. package/template/knowledge/dev-team/workflows/README.md +0 -49
  125. package/template/knowledge/hq/checkpoint-schema.json +0 -51
  126. package/template/knowledge/hq/index-md-spec.md +0 -74
  127. package/template/knowledge/hq/thread-schema.md +0 -153
  128. package/template/knowledge/hq-core/checkpoint-schema.json +0 -51
  129. package/template/knowledge/hq-core/index-md-spec.md +0 -74
  130. package/template/knowledge/hq-core/thread-schema.md +0 -153
  131. package/template/knowledge/loom/README.md +0 -51
  132. package/template/knowledge/loom/architecture.md +0 -125
  133. package/template/knowledge/loom/code-style.md +0 -169
  134. package/template/knowledge/loom/llm-proxy.md +0 -132
  135. package/template/knowledge/loom/state-machine.md +0 -131
  136. package/template/knowledge/loom/thread-system.md +0 -117
  137. package/template/knowledge/loom/tools.md +0 -94
  138. package/template/knowledge/loom/weaver.md +0 -96
  139. package/template/knowledge/loom/web-frontend.md +0 -131
  140. package/template/knowledge/projects/README.md +0 -72
  141. package/template/knowledge/projects/templates/README.template.md +0 -28
  142. package/template/knowledge/workers/README.md +0 -195
  143. package/template/knowledge/workers/ralph-loop-pattern.md +0 -157
  144. package/template/knowledge/workers/skill-schema.md +0 -182
  145. package/template/knowledge/workers/state-machine.md +0 -102
  146. package/template/knowledge/workers/templates/base-worker.yaml +0 -73
  147. package/template/knowledge/workers/templates/code-worker.yaml +0 -85
  148. package/template/knowledge/workers/templates/skill.yaml +0 -49
  149. package/template/knowledge/workers/templates/social-worker.yaml +0 -70
  150. package/template/modules/examples/full-manifest.yaml +0 -92
  151. package/template/modules/examples/minimal.yaml +0 -14
  152. package/template/modules/modules.yaml +0 -59
  153. package/template/projects/.gitkeep +0 -0
  154. package/template/projects/incorporate-workers-into-pure-ralph/prd.json +0 -88
  155. package/template/projects/pure-ralph-branch-isolation/README.md +0 -114
  156. package/template/projects/pure-ralph-branch-isolation/prd.json +0 -123
  157. package/template/projects/purist-ralph-loop/README.md +0 -148
  158. package/template/projects/purist-ralph-loop/prd.json +0 -135
  159. package/template/projects/ralph-test/prd.json +0 -50
  160. package/template/prompts/pure-ralph-base.md +0 -551
  161. package/template/settings/.gitkeep +0 -0
  162. package/template/settings/pure-ralph.json +0 -42
  163. package/template/social-content/drafts/INDEX.md +0 -21
  164. package/template/social-content/drafts/linkedin/.gitkeep +0 -1
  165. package/template/social-content/drafts/x/.gitkeep +0 -1
  166. package/template/social-content/images/.gitkeep +0 -1
  167. package/template/starter-projects/code-worker/README.md +0 -97
  168. package/template/starter-projects/code-worker/prd.json +0 -45
  169. package/template/starter-projects/personal-assistant/README.md +0 -42
  170. package/template/starter-projects/personal-assistant/prd.json +0 -43
  171. package/template/starter-projects/social-media/README.md +0 -60
  172. package/template/starter-projects/social-media/prd.json +0 -43
  173. package/template/workers/content-brand/README.md +0 -59
  174. package/template/workers/content-brand/skills/messaging-alignment.md +0 -91
  175. package/template/workers/content-brand/skills/tone-check.md +0 -76
  176. package/template/workers/content-brand/skills/voice-analysis.md +0 -68
  177. package/template/workers/content-brand/worker.yaml +0 -81
  178. package/template/workers/content-legal/README.md +0 -80
  179. package/template/workers/content-legal/skills/claim-substantiation.md +0 -150
  180. package/template/workers/content-legal/skills/compliance-scan.md +0 -123
  181. package/template/workers/content-legal/skills/disclaimer-check.md +0 -146
  182. package/template/workers/content-legal/worker.yaml +0 -118
  183. package/template/workers/content-product/README.md +0 -77
  184. package/template/workers/content-product/skills/claim-verification.md +0 -96
  185. package/template/workers/content-product/skills/feature-accuracy.md +0 -117
  186. package/template/workers/content-product/skills/stats-check.md +0 -128
  187. package/template/workers/content-product/worker.yaml +0 -97
  188. package/template/workers/content-sales/README.md +0 -70
  189. package/template/workers/content-sales/skills/conversion-analysis.md +0 -96
  190. package/template/workers/content-sales/skills/cta-audit.md +0 -107
  191. package/template/workers/content-sales/skills/value-prop-check.md +0 -114
  192. package/template/workers/content-sales/worker.yaml +0 -93
  193. package/template/workers/content-shared/cli.ts +0 -242
  194. package/template/workers/content-shared/index.ts +0 -234
  195. package/template/workers/content-shared/lib/accuracy-analyzer.ts +0 -661
  196. package/template/workers/content-shared/lib/analyze.ts +0 -370
  197. package/template/workers/content-shared/lib/brand-analyzer.ts +0 -526
  198. package/template/workers/content-shared/lib/cms-integration.ts +0 -446
  199. package/template/workers/content-shared/lib/compliance-analyzer.ts +0 -655
  200. package/template/workers/content-shared/lib/conversion-analyzer.ts +0 -555
  201. package/template/workers/content-shared/lib/github-integration.ts +0 -582
  202. package/template/workers/content-shared/lib/output.ts +0 -373
  203. package/template/workers/content-shared/lib/parser.ts +0 -771
  204. package/template/workers/content-shared/lib/priority.ts +0 -439
  205. package/template/workers/content-shared/lib/recommendations.ts +0 -512
  206. package/template/workers/content-shared/lib/reporter.ts +0 -749
  207. package/template/workers/content-shared/lib/restructure.ts +0 -664
  208. package/template/workers/content-shared/lib/scorer.ts +0 -140
  209. package/template/workers/content-shared/lib/types.ts +0 -227
  210. package/template/workers/content-shared/lib/variants.ts +0 -595
  211. package/template/workers/content-shared/package.json +0 -51
  212. package/template/workers/content-shared/pnpm-lock.yaml +0 -39
  213. package/template/workers/content-shared/test/sample-page.json +0 -115
  214. package/template/workers/content-shared/tsconfig.json +0 -20
  215. package/template/workers/dev-team/README.md +0 -166
  216. package/template/workers/dev-team/_template.yaml +0 -70
  217. package/template/workers/dev-team/architect/package.json +0 -27
  218. package/template/workers/dev-team/architect/skills/api-design.md +0 -89
  219. package/template/workers/dev-team/architect/skills/refactor-plan.md +0 -96
  220. package/template/workers/dev-team/architect/skills/system-design.md +0 -100
  221. package/template/workers/dev-team/architect/src/index.ts +0 -49
  222. package/template/workers/dev-team/architect/src/mcp-server.ts +0 -122
  223. package/template/workers/dev-team/architect/src/skills/api-design.ts +0 -316
  224. package/template/workers/dev-team/architect/src/skills/refactor-plan.ts +0 -264
  225. package/template/workers/dev-team/architect/src/skills/system-design.ts +0 -212
  226. package/template/workers/dev-team/architect/tsconfig.json +0 -19
  227. package/template/workers/dev-team/architect/worker.yaml +0 -128
  228. package/template/workers/dev-team/backend-dev/package-lock.json +0 -1252
  229. package/template/workers/dev-team/backend-dev/package.json +0 -27
  230. package/template/workers/dev-team/backend-dev/skills/implement-endpoint.md +0 -70
  231. package/template/workers/dev-team/backend-dev/skills/implement-service.md +0 -62
  232. package/template/workers/dev-team/backend-dev/src/index.ts +0 -51
  233. package/template/workers/dev-team/backend-dev/src/mcp-server.ts +0 -109
  234. package/template/workers/dev-team/backend-dev/src/skills/implement-endpoint.ts +0 -122
  235. package/template/workers/dev-team/backend-dev/src/skills/implement-service.ts +0 -126
  236. package/template/workers/dev-team/backend-dev/tsconfig.json +0 -19
  237. package/template/workers/dev-team/backend-dev/worker.yaml +0 -128
  238. package/template/workers/dev-team/code-reviewer/package-lock.json +0 -1080
  239. package/template/workers/dev-team/code-reviewer/package.json +0 -24
  240. package/template/workers/dev-team/code-reviewer/skills/merge-to-production.md +0 -61
  241. package/template/workers/dev-team/code-reviewer/skills/merge-to-staging.md +0 -54
  242. package/template/workers/dev-team/code-reviewer/skills/request-changes.md +0 -63
  243. package/template/workers/dev-team/code-reviewer/skills/review-pr.md +0 -77
  244. package/template/workers/dev-team/code-reviewer/src/index.ts +0 -56
  245. package/template/workers/dev-team/code-reviewer/src/mcp-server.ts +0 -101
  246. package/template/workers/dev-team/code-reviewer/tsconfig.json +0 -19
  247. package/template/workers/dev-team/code-reviewer/worker.yaml +0 -90
  248. package/template/workers/dev-team/database-dev/package.json +0 -22
  249. package/template/workers/dev-team/database-dev/skills/create-schema.md +0 -48
  250. package/template/workers/dev-team/database-dev/src/index.ts +0 -50
  251. package/template/workers/dev-team/database-dev/src/mcp-server.ts +0 -76
  252. package/template/workers/dev-team/database-dev/tsconfig.json +0 -18
  253. package/template/workers/dev-team/database-dev/worker.yaml +0 -90
  254. package/template/workers/dev-team/frontend-dev/package.json +0 -22
  255. package/template/workers/dev-team/frontend-dev/skills/create-component.md +0 -26
  256. package/template/workers/dev-team/frontend-dev/src/index.ts +0 -50
  257. package/template/workers/dev-team/frontend-dev/src/mcp-server.ts +0 -77
  258. package/template/workers/dev-team/frontend-dev/tsconfig.json +0 -18
  259. package/template/workers/dev-team/frontend-dev/worker.yaml +0 -132
  260. package/template/workers/dev-team/infra-dev/package.json +0 -24
  261. package/template/workers/dev-team/infra-dev/skills/add-monitoring.md +0 -73
  262. package/template/workers/dev-team/infra-dev/skills/configure-deployment.md +0 -80
  263. package/template/workers/dev-team/infra-dev/skills/create-dockerfile.md +0 -62
  264. package/template/workers/dev-team/infra-dev/skills/setup-cicd.md +0 -63
  265. package/template/workers/dev-team/infra-dev/src/index.ts +0 -55
  266. package/template/workers/dev-team/infra-dev/src/mcp-server.ts +0 -82
  267. package/template/workers/dev-team/infra-dev/tsconfig.json +0 -19
  268. package/template/workers/dev-team/infra-dev/worker.yaml +0 -92
  269. package/template/workers/dev-team/knowledge-curator/package.json +0 -24
  270. package/template/workers/dev-team/knowledge-curator/skills/curate-troubleshooting.md +0 -63
  271. package/template/workers/dev-team/knowledge-curator/skills/process-learnings.md +0 -61
  272. package/template/workers/dev-team/knowledge-curator/skills/sync-documentation.md +0 -76
  273. package/template/workers/dev-team/knowledge-curator/skills/update-patterns.md +0 -63
  274. package/template/workers/dev-team/knowledge-curator/src/index.ts +0 -53
  275. package/template/workers/dev-team/knowledge-curator/src/mcp-server.ts +0 -92
  276. package/template/workers/dev-team/knowledge-curator/tsconfig.json +0 -19
  277. package/template/workers/dev-team/knowledge-curator/worker.yaml +0 -80
  278. package/template/workers/dev-team/motion-designer/package.json +0 -22
  279. package/template/workers/dev-team/motion-designer/skills/add-animation.md +0 -25
  280. package/template/workers/dev-team/motion-designer/skills/generate-image.md +0 -36
  281. package/template/workers/dev-team/motion-designer/src/index.ts +0 -63
  282. package/template/workers/dev-team/motion-designer/src/mcp-server.ts +0 -79
  283. package/template/workers/dev-team/motion-designer/tsconfig.json +0 -18
  284. package/template/workers/dev-team/motion-designer/worker.yaml +0 -84
  285. package/template/workers/dev-team/product-planner/queue.json +0 -4
  286. package/template/workers/dev-team/product-planner/worker.yaml +0 -220
  287. package/template/workers/dev-team/project-manager/package-lock.json +0 -1252
  288. package/template/workers/dev-team/project-manager/package.json +0 -27
  289. package/template/workers/dev-team/project-manager/skills/create-prd.md +0 -66
  290. package/template/workers/dev-team/project-manager/skills/next-issue.md +0 -51
  291. package/template/workers/dev-team/project-manager/skills/project-status.md +0 -59
  292. package/template/workers/dev-team/project-manager/skills/update-learnings.md +0 -65
  293. package/template/workers/dev-team/project-manager/src/index.ts +0 -54
  294. package/template/workers/dev-team/project-manager/src/mcp-server.ts +0 -207
  295. package/template/workers/dev-team/project-manager/src/skills/create-prd.ts +0 -86
  296. package/template/workers/dev-team/project-manager/src/skills/next-issue.ts +0 -137
  297. package/template/workers/dev-team/project-manager/src/skills/project-status.ts +0 -131
  298. package/template/workers/dev-team/project-manager/src/skills/update-learnings.ts +0 -94
  299. package/template/workers/dev-team/project-manager/tsconfig.json +0 -19
  300. package/template/workers/dev-team/project-manager/worker.yaml +0 -96
  301. package/template/workers/dev-team/qa-tester/package.json +0 -24
  302. package/template/workers/dev-team/qa-tester/skills/create-demo-account.md +0 -36
  303. package/template/workers/dev-team/qa-tester/skills/run-tests.md +0 -36
  304. package/template/workers/dev-team/qa-tester/skills/write-test.md +0 -27
  305. package/template/workers/dev-team/qa-tester/src/index.ts +0 -61
  306. package/template/workers/dev-team/qa-tester/src/mcp-server.ts +0 -88
  307. package/template/workers/dev-team/qa-tester/tsconfig.json +0 -18
  308. package/template/workers/dev-team/qa-tester/worker.yaml +0 -116
  309. package/template/workers/dev-team/task-executor/package-lock.json +0 -1252
  310. package/template/workers/dev-team/task-executor/package.json +0 -27
  311. package/template/workers/dev-team/task-executor/skills/analyze-issue.md +0 -101
  312. package/template/workers/dev-team/task-executor/skills/execute.md +0 -133
  313. package/template/workers/dev-team/task-executor/skills/report-learnings.md +0 -106
  314. package/template/workers/dev-team/task-executor/skills/validate-completion.md +0 -121
  315. package/template/workers/dev-team/task-executor/src/index.ts +0 -54
  316. package/template/workers/dev-team/task-executor/src/mcp-server.ts +0 -139
  317. package/template/workers/dev-team/task-executor/src/skills/analyze-issue.ts +0 -219
  318. package/template/workers/dev-team/task-executor/src/skills/execute.ts +0 -132
  319. package/template/workers/dev-team/task-executor/src/skills/report-learnings.ts +0 -119
  320. package/template/workers/dev-team/task-executor/src/skills/validate-completion.ts +0 -142
  321. package/template/workers/dev-team/task-executor/tsconfig.json +0 -19
  322. package/template/workers/dev-team/task-executor/worker.yaml +0 -110
  323. package/template/workers/registry.yaml +0 -171
  324. package/template/workers/security-scanner/README.md +0 -73
  325. package/template/workers/security-scanner/skills/pre-deploy-check.md +0 -205
  326. package/template/workers/security-scanner/worker.yaml +0 -26
  327. package/template/workspace/checkpoints/.gitkeep +0 -0
  328. package/template/workspace/content-ideas/inbox.jsonl +0 -0
  329. package/template/workspace/drafts/.gitkeep +0 -0
  330. package/template/workspace/learnings/.gitkeep +0 -3
  331. package/template/workspace/orchestrator/.gitkeep +0 -0
  332. package/template/workspace/ralph-test/COMPLETE.md +0 -18
  333. package/template/workspace/ralph-test/hello.txt +0 -2
  334. package/template/workspace/reports/.gitkeep +0 -0
  335. package/template/workspace/scratch/.gitkeep +0 -0
  336. package/template/workspace/threads/.gitkeep +0 -3
@@ -1,27 +0,0 @@
1
- {
2
- "name": "@hq/backend-dev",
3
- "version": "1.0.0",
4
- "description": "API implementation, business logic, and server-side integrations",
5
- "main": "dist/index.js",
6
- "bin": {
7
- "backend-dev": "dist/index.js"
8
- },
9
- "scripts": {
10
- "build": "tsc",
11
- "typecheck": "tsc --noEmit",
12
- "dev": "ts-node src/index.ts",
13
- "mcp": "node dist/mcp-server.js"
14
- },
15
- "keywords": ["hq", "worker", "backend", "api", "nodejs"],
16
- "author": "",
17
- "license": "ISC",
18
- "dependencies": {
19
- "@modelcontextprotocol/sdk": "^1.0.0",
20
- "commander": "^12.1.0"
21
- },
22
- "devDependencies": {
23
- "@types/node": "^22.10.0",
24
- "typescript": "^5.7.2",
25
- "ts-node": "^10.9.2"
26
- }
27
- }
@@ -1,70 +0,0 @@
1
- # implement-endpoint
2
-
3
- Create a new API endpoint based on specification.
4
-
5
- ## Arguments
6
-
7
- `$ARGUMENTS` = `--spec <method path>` (required, e.g., "POST /api/users")
8
-
9
- Optional:
10
- - `--repo <path>` - Target repository
11
- - `--types <file>` - TypeScript types file to use
12
-
13
- ## Process
14
-
15
- 1. **Parse Specification**
16
- - Extract HTTP method
17
- - Extract path and parameters
18
- - Identify resource and action
19
-
20
- 2. **Analyze Existing Patterns**
21
- - Find API routes in repo
22
- - Match naming conventions
23
- - Identify auth patterns
24
-
25
- 3. **Generate Implementation**
26
- - Route handler
27
- - Input validation
28
- - Business logic call
29
- - Response formatting
30
- - Error handling
31
-
32
- 4. **Add Tests**
33
- - Unit test for handler
34
- - Integration test if applicable
35
-
36
- 5. **Present for Approval**
37
- - Show generated code
38
- - Get human approval
39
-
40
- ## Output
41
-
42
- New files:
43
- - `src/app/api/{resource}/route.ts` (Next.js) or
44
- - `src/routes/{resource}.ts` (Express)
45
-
46
- Test files:
47
- - `src/app/api/{resource}/route.test.ts`
48
-
49
- ## Example
50
-
51
- ```bash
52
- node dist/index.js implement-endpoint --spec "POST /api/auth/login" --repo repos/my-app
53
-
54
- # Output:
55
- # === Implementing: POST /api/auth/login ===
56
- #
57
- # Pattern detected: Next.js App Router
58
- #
59
- # Will create:
60
- # src/app/api/auth/login/route.ts
61
- # src/app/api/auth/login/route.test.ts
62
- #
63
- # Implementation:
64
- # - Validate email/password input
65
- # - Call AuthService.login()
66
- # - Return user + token
67
- # - Handle errors (400, 401, 500)
68
- #
69
- # [Approve? y/n/modify]
70
- ```
@@ -1,62 +0,0 @@
1
- # implement-service
2
-
3
- Create a service/business logic layer.
4
-
5
- ## Arguments
6
-
7
- `$ARGUMENTS` = `--name <ServiceName>` (required)
8
-
9
- Optional:
10
- - `--repo <path>` - Target repository
11
- - `--methods <list>` - Comma-separated method names
12
-
13
- ## Process
14
-
15
- 1. **Analyze Requirements**
16
- - Parse service name
17
- - Infer domain from name
18
- - Identify dependencies
19
-
20
- 2. **Check Existing Services**
21
- - Find service patterns
22
- - Match conventions
23
- - Identify shared utilities
24
-
25
- 3. **Generate Service**
26
- - Class/module structure
27
- - Method implementations
28
- - Dependency injection
29
- - Type definitions
30
-
31
- 4. **Add Tests**
32
- - Unit tests per method
33
- - Mock dependencies
34
-
35
- 5. **Present for Approval**
36
-
37
- ## Output
38
-
39
- New files:
40
- - `src/services/{name}.ts`
41
- - `src/services/{name}.test.ts`
42
-
43
- ## Example
44
-
45
- ```bash
46
- node dist/index.js implement-service --name "UserService" --methods "create,findById,update,delete"
47
-
48
- # Output:
49
- # === Implementing: UserService ===
50
- #
51
- # Methods:
52
- # - create(data: CreateUserInput): Promise<User>
53
- # - findById(id: string): Promise<User | null>
54
- # - update(id: string, data: UpdateUserInput): Promise<User>
55
- # - delete(id: string): Promise<void>
56
- #
57
- # Dependencies:
58
- # - Database (Prisma/Drizzle)
59
- # - EmailService (optional)
60
- #
61
- # [Approve? y/n/modify]
62
- ```
@@ -1,51 +0,0 @@
1
- #!/usr/bin/env node
2
- import { Command } from 'commander';
3
- import { implementEndpoint } from './skills/implement-endpoint';
4
- import { implementService } from './skills/implement-service';
5
-
6
- const program = new Command();
7
-
8
- program
9
- .name('backend-dev')
10
- .description('API implementation, business logic, and server-side integrations')
11
- .version('1.0.0');
12
-
13
- program
14
- .command('implement-endpoint')
15
- .description('Create a new API endpoint')
16
- .requiredOption('--spec <spec>', 'Endpoint spec (e.g., "POST /api/users")')
17
- .option('--repo <path>', 'Target repository')
18
- .option('--types <file>', 'TypeScript types file')
19
- .action(async (options) => {
20
- await implementEndpoint(options);
21
- });
22
-
23
- program
24
- .command('implement-service')
25
- .description('Create a service/business logic layer')
26
- .requiredOption('--name <name>', 'Service name')
27
- .option('--repo <path>', 'Target repository')
28
- .option('--methods <list>', 'Comma-separated method names')
29
- .action(async (options) => {
30
- await implementService(options);
31
- });
32
-
33
- program
34
- .command('add-middleware')
35
- .description('Add Express/Next.js middleware')
36
- .requiredOption('--name <name>', 'Middleware name')
37
- .option('--repo <path>', 'Target repository')
38
- .action(async (options) => {
39
- console.log('add-middleware not yet implemented');
40
- });
41
-
42
- program
43
- .command('fix-backend-bug')
44
- .description('Fix server-side bug')
45
- .requiredOption('--issue <description>', 'Bug description')
46
- .option('--repo <path>', 'Target repository')
47
- .action(async (options) => {
48
- console.log('fix-backend-bug not yet implemented');
49
- });
50
-
51
- program.parse();
@@ -1,109 +0,0 @@
1
- #!/usr/bin/env node
2
- import { Server } from '@modelcontextprotocol/sdk/server/index.js';
3
- import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
4
- import {
5
- CallToolRequestSchema,
6
- ListToolsRequestSchema,
7
- } from '@modelcontextprotocol/sdk/types.js';
8
-
9
- const server = new Server(
10
- { name: 'backend-dev', version: '1.0.0' },
11
- { capabilities: { tools: {} } }
12
- );
13
-
14
- server.setRequestHandler(ListToolsRequestSchema, async () => {
15
- return {
16
- tools: [
17
- {
18
- name: 'implement_endpoint',
19
- description: 'Create a new API endpoint',
20
- inputSchema: {
21
- type: 'object',
22
- properties: {
23
- spec: { type: 'string', description: 'Endpoint spec (e.g., "POST /api/users")' },
24
- repo: { type: 'string', description: 'Target repository' },
25
- types: { type: 'string', description: 'TypeScript types file' },
26
- },
27
- required: ['spec'],
28
- },
29
- },
30
- {
31
- name: 'implement_service',
32
- description: 'Create a service/business logic layer',
33
- inputSchema: {
34
- type: 'object',
35
- properties: {
36
- name: { type: 'string', description: 'Service name' },
37
- repo: { type: 'string', description: 'Target repository' },
38
- methods: { type: 'string', description: 'Comma-separated method names' },
39
- },
40
- required: ['name'],
41
- },
42
- },
43
- {
44
- name: 'add_middleware',
45
- description: 'Add Express/Next.js middleware',
46
- inputSchema: {
47
- type: 'object',
48
- properties: {
49
- name: { type: 'string', description: 'Middleware name' },
50
- repo: { type: 'string', description: 'Target repository' },
51
- },
52
- required: ['name'],
53
- },
54
- },
55
- {
56
- name: 'fix_backend_bug',
57
- description: 'Fix server-side bug',
58
- inputSchema: {
59
- type: 'object',
60
- properties: {
61
- issue: { type: 'string', description: 'Bug description' },
62
- repo: { type: 'string', description: 'Target repository' },
63
- },
64
- required: ['issue'],
65
- },
66
- },
67
- ],
68
- };
69
- });
70
-
71
- server.setRequestHandler(CallToolRequestSchema, async (request) => {
72
- const { name, arguments: args } = request.params;
73
-
74
- try {
75
- switch (name) {
76
- case 'implement_endpoint': {
77
- const { implementEndpoint } = await import('./skills/implement-endpoint');
78
- const result = await captureOutput(() => implementEndpoint(args as any));
79
- return { content: [{ type: 'text', text: result }] };
80
- }
81
- case 'implement_service': {
82
- const { implementService } = await import('./skills/implement-service');
83
- const result = await captureOutput(() => implementService(args as any));
84
- return { content: [{ type: 'text', text: result }] };
85
- }
86
- default:
87
- return { content: [{ type: 'text', text: `Tool ${name} not yet implemented` }] };
88
- }
89
- } catch (error) {
90
- const message = error instanceof Error ? error.message : String(error);
91
- return { content: [{ type: 'text', text: `Error: ${message}` }], isError: true };
92
- }
93
- });
94
-
95
- async function captureOutput(fn: () => Promise<any>): Promise<string> {
96
- const logs: string[] = [];
97
- const orig = { log: console.log, error: console.error };
98
- console.log = (...args) => logs.push(args.join(' '));
99
- console.error = (...args) => logs.push(`ERROR: ${args.join(' ')}`);
100
- try { await fn(); } finally { Object.assign(console, orig); }
101
- return logs.join('\n');
102
- }
103
-
104
- async function main() {
105
- const transport = new StdioServerTransport();
106
- await server.connect(transport);
107
- }
108
-
109
- main().catch(console.error);
@@ -1,122 +0,0 @@
1
- import * as fs from 'fs';
2
- import * as path from 'path';
3
-
4
- interface ImplementEndpointOptions {
5
- spec: string;
6
- repo?: string;
7
- types?: string;
8
- }
9
-
10
- export async function implementEndpoint(options: ImplementEndpointOptions): Promise<void> {
11
- const { spec, repo, types } = options;
12
-
13
- // Parse spec: "POST /api/users"
14
- const [method, endpoint] = spec.split(' ');
15
- const segments = endpoint.replace('/api/', '').split('/');
16
- const resource = segments[0];
17
-
18
- console.log(`\n=== Implementing: ${spec} ===\n`);
19
-
20
- // Detect framework
21
- let framework = 'unknown';
22
- if (repo) {
23
- if (fs.existsSync(path.join(repo, 'src/app/api'))) {
24
- framework = 'nextjs-app-router';
25
- } else if (fs.existsSync(path.join(repo, 'src/pages/api'))) {
26
- framework = 'nextjs-pages-router';
27
- } else if (fs.existsSync(path.join(repo, 'src/routes'))) {
28
- framework = 'express';
29
- }
30
- console.log(`Pattern detected: ${framework}`);
31
- }
32
-
33
- // Generate file paths
34
- const routePath = framework === 'nextjs-app-router'
35
- ? `src/app/api/${segments.join('/')}/route.ts`
36
- : `src/routes/${resource}.ts`;
37
-
38
- const testPath = routePath.replace('.ts', '.test.ts');
39
-
40
- console.log('\nWill create:');
41
- console.log(` ${routePath}`);
42
- console.log(` ${testPath}`);
43
-
44
- // Generate implementation
45
- const code = generateEndpointCode(method, endpoint, resource, framework);
46
-
47
- console.log('\n' + '-'.repeat(40));
48
- console.log('\nGenerated code:\n');
49
- console.log(code);
50
-
51
- console.log('\n[Human approval required]');
52
- console.log('Approve implementation? [y/n/modify]');
53
-
54
- // In production, would write files after approval
55
- console.log('\nOn approval, files will be written and tests run.');
56
- }
57
-
58
- function generateEndpointCode(method: string, endpoint: string, resource: string, framework: string): string {
59
- const Resource = resource.charAt(0).toUpperCase() + resource.slice(1);
60
-
61
- if (framework === 'nextjs-app-router') {
62
- return `import { NextRequest, NextResponse } from 'next/server';
63
- import { z } from 'zod';
64
- import { ${resource}Service } from '@/services/${resource}';
65
-
66
- const ${method.toLowerCase()}Schema = z.object({
67
- // Define request body schema
68
- });
69
-
70
- export async function ${method}(request: NextRequest) {
71
- try {
72
- const body = await request.json();
73
- const validated = ${method.toLowerCase()}Schema.parse(body);
74
-
75
- const result = await ${resource}Service.${method.toLowerCase()}(validated);
76
-
77
- return NextResponse.json(result, { status: ${method === 'POST' ? 201 : 200} });
78
- } catch (error) {
79
- if (error instanceof z.ZodError) {
80
- return NextResponse.json(
81
- { error: 'Validation failed', details: error.errors },
82
- { status: 400 }
83
- );
84
- }
85
-
86
- console.error('${method} ${endpoint} error:', error);
87
- return NextResponse.json(
88
- { error: 'Internal server error' },
89
- { status: 500 }
90
- );
91
- }
92
- }
93
- `;
94
- }
95
-
96
- // Express/generic
97
- return `import { Router, Request, Response, NextFunction } from 'express';
98
- import { z } from 'zod';
99
- import { ${resource}Service } from '../services/${resource}';
100
-
101
- const router = Router();
102
-
103
- const ${method.toLowerCase()}Schema = z.object({
104
- // Define request body schema
105
- });
106
-
107
- router.${method.toLowerCase()}('${endpoint}', async (req: Request, res: Response, next: NextFunction) => {
108
- try {
109
- const validated = ${method.toLowerCase()}Schema.parse(req.body);
110
- const result = await ${resource}Service.${method.toLowerCase()}(validated);
111
- res.status(${method === 'POST' ? 201 : 200}).json(result);
112
- } catch (error) {
113
- if (error instanceof z.ZodError) {
114
- return res.status(400).json({ error: 'Validation failed', details: error.errors });
115
- }
116
- next(error);
117
- }
118
- });
119
-
120
- export default router;
121
- `;
122
- }
@@ -1,126 +0,0 @@
1
- import * as fs from 'fs';
2
- import * as path from 'path';
3
-
4
- interface ImplementServiceOptions {
5
- name: string;
6
- repo?: string;
7
- methods?: string;
8
- }
9
-
10
- export async function implementService(options: ImplementServiceOptions): Promise<void> {
11
- const { name, repo, methods } = options;
12
-
13
- const methodList = methods ? methods.split(',').map(m => m.trim()) : ['create', 'findById', 'update', 'delete'];
14
-
15
- console.log(`\n=== Implementing: ${name} ===\n`);
16
-
17
- // Analyze dependencies
18
- const domain = name.replace('Service', '').toLowerCase();
19
- const Domain = domain.charAt(0).toUpperCase() + domain.slice(1);
20
-
21
- console.log('Methods:');
22
- for (const method of methodList) {
23
- const signature = getMethodSignature(method, Domain);
24
- console.log(` - ${method}${signature}`);
25
- }
26
-
27
- // Detect database
28
- let db = 'unknown';
29
- if (repo) {
30
- if (fs.existsSync(path.join(repo, 'prisma/schema.prisma'))) {
31
- db = 'prisma';
32
- } else if (fs.existsSync(path.join(repo, 'drizzle.config.ts'))) {
33
- db = 'drizzle';
34
- }
35
- console.log(`\nDatabase: ${db}`);
36
- }
37
-
38
- console.log('\nDependencies:');
39
- console.log(` - Database (${db})`);
40
- console.log(' - Logger');
41
-
42
- // Generate code
43
- const code = generateServiceCode(name, Domain, methodList, db);
44
-
45
- console.log('\n' + '-'.repeat(40));
46
- console.log('\nGenerated code:\n');
47
- console.log(code);
48
-
49
- console.log('\n[Human approval required]');
50
- console.log('Approve implementation? [y/n/modify]');
51
- }
52
-
53
- function getMethodSignature(method: string, domain: string): string {
54
- switch (method) {
55
- case 'create':
56
- return `(data: Create${domain}Input): Promise<${domain}>`;
57
- case 'findById':
58
- return `(id: string): Promise<${domain} | null>`;
59
- case 'findAll':
60
- return `(options?: FindOptions): Promise<${domain}[]>`;
61
- case 'update':
62
- return `(id: string, data: Update${domain}Input): Promise<${domain}>`;
63
- case 'delete':
64
- return `(id: string): Promise<void>`;
65
- default:
66
- return `(...args: unknown[]): Promise<unknown>`;
67
- }
68
- }
69
-
70
- function generateServiceCode(name: string, domain: string, methods: string[], db: string): string {
71
- const prismaClient = db === 'prisma' ? `import { prisma } from '@/lib/prisma';` : '';
72
-
73
- const methodImplementations = methods.map(method => {
74
- switch (method) {
75
- case 'create':
76
- return ` async create(data: Create${domain}Input): Promise<${domain}> {
77
- ${db === 'prisma' ? `return prisma.${domain.toLowerCase()}.create({ data });` : `// TODO: implement create`}
78
- }`;
79
- case 'findById':
80
- return ` async findById(id: string): Promise<${domain} | null> {
81
- ${db === 'prisma' ? `return prisma.${domain.toLowerCase()}.findUnique({ where: { id } });` : `// TODO: implement findById`}
82
- }`;
83
- case 'findAll':
84
- return ` async findAll(options?: { skip?: number; take?: number }): Promise<${domain}[]> {
85
- ${db === 'prisma' ? `return prisma.${domain.toLowerCase()}.findMany(options);` : `// TODO: implement findAll`}
86
- }`;
87
- case 'update':
88
- return ` async update(id: string, data: Update${domain}Input): Promise<${domain}> {
89
- ${db === 'prisma' ? `return prisma.${domain.toLowerCase()}.update({ where: { id }, data });` : `// TODO: implement update`}
90
- }`;
91
- case 'delete':
92
- return ` async delete(id: string): Promise<void> {
93
- ${db === 'prisma' ? `await prisma.${domain.toLowerCase()}.delete({ where: { id } });` : `// TODO: implement delete`}
94
- }`;
95
- default:
96
- return ` async ${method}(...args: unknown[]): Promise<unknown> {
97
- // TODO: implement ${method}
98
- throw new Error('Not implemented');
99
- }`;
100
- }
101
- }).join('\n\n');
102
-
103
- return `${prismaClient}
104
-
105
- export interface ${domain} {
106
- id: string;
107
- createdAt: Date;
108
- updatedAt: Date;
109
- // Add entity fields
110
- }
111
-
112
- export interface Create${domain}Input {
113
- // Add create fields
114
- }
115
-
116
- export interface Update${domain}Input {
117
- // Add update fields
118
- }
119
-
120
- class ${name} {
121
- ${methodImplementations}
122
- }
123
-
124
- export const ${domain.toLowerCase()}Service = new ${name}();
125
- `;
126
- }
@@ -1,19 +0,0 @@
1
- {
2
- "compilerOptions": {
3
- "target": "ES2022",
4
- "module": "commonjs",
5
- "lib": ["ES2022"],
6
- "outDir": "./dist",
7
- "rootDir": "./src",
8
- "strict": true,
9
- "esModuleInterop": true,
10
- "skipLibCheck": true,
11
- "forceConsistentCasingInFileNames": true,
12
- "resolveJsonModule": true,
13
- "declaration": true,
14
- "declarationMap": true,
15
- "sourceMap": true
16
- },
17
- "include": ["src/**/*"],
18
- "exclude": ["node_modules", "dist"]
19
- }