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
package/dist/ui.js CHANGED
@@ -1,16 +1,85 @@
1
1
  import chalk from "chalk";
2
- export function banner() {
2
+ import ora from "ora";
3
+ // ─── ASCII Art Banner ────────────────────────────────────────────────────────
4
+ export function banner(installerVersion, hqVersion) {
5
+ const d = chalk.dim;
6
+ const w = chalk.bold.white;
7
+ const c = chalk.white; // city
3
8
  console.log();
4
- console.log(chalk.bold.white(" ██ ██ ██████ "));
5
- console.log(chalk.bold.white(" ██ ██ ██ ██ "));
6
- console.log(chalk.bold.white(" ███████ ██ ██ "));
7
- console.log(chalk.bold.white(" ██ ██ ██ ▄▄ ██ "));
8
- console.log(chalk.bold.white(" ██ ██ ██████ "));
9
- console.log(chalk.dim(" ▀▀ "));
9
+ console.log(c(" ^"));
10
+ console.log(c(" _______ ^^^"));
11
+ console.log(c(" |xxxxxxx| _^^^^^_"));
12
+ console.log(c(" |xxxxxxx| | [][] |"));
13
+ console.log(c(" ______xxxxx| |[][][] |"));
14
+ console.log(c(" |++++++|xxxx| | [][][]|") + w(" ██╗ ██╗ ██████╗"));
15
+ console.log(c(" |++++++|xxxx| |[][][] |") + w(" ██║ ██║██╔═══██╗"));
16
+ console.log(c(" |++++++|_________ [][]|") + w(" ███████║██║ ██║"));
17
+ console.log(c(" |++++++|=|=|=|=|=| [] |") + w(" ██╔══██║██║▄▄ ██║"));
18
+ console.log(c(" |++++++|=|=|=|=|=|[][]|") + w(" ██║ ██║╚██████╔╝"));
19
+ console.log(c("________|++HH++| _HHHH__| |______") + d("╚═╝ ╚═╝ ╚══▀▀═╝"));
20
+ console.log(c(" _______________ ______________ ______________"));
21
+ console.log(c("_____________ ___________ __________________ ____________"));
10
22
  console.log();
11
- console.log(chalk.dim(" Personal OS for AI Workers") + chalk.dim(" v6.0.0"));
23
+ console.log(d(" Personal OS for AI Workers"));
12
24
  console.log();
25
+ const parts = [];
26
+ if (installerVersion) {
27
+ parts.push(d(`create-hq v${installerVersion}`));
28
+ }
29
+ if (hqVersion) {
30
+ parts.push(chalk.cyan(`HQ template ${hqVersion}`));
31
+ }
32
+ if (parts.length > 0) {
33
+ console.log(" " + parts.join(d(" · ")));
34
+ console.log();
35
+ }
13
36
  }
37
+ // ─── Step Status Tracking ────────────────────────────────────────────────────
38
+ const spinners = new Map();
39
+ export function stepStatus(label, status) {
40
+ switch (status) {
41
+ case "pending":
42
+ console.log(chalk.dim(" [ ] ") + chalk.dim(label));
43
+ break;
44
+ case "running": {
45
+ // Stop any existing spinner for this label
46
+ const existing = spinners.get(label);
47
+ if (existing)
48
+ existing.stop();
49
+ const spinner = ora({
50
+ text: chalk.white(label),
51
+ prefixText: " ",
52
+ spinner: "dots",
53
+ color: "cyan",
54
+ }).start();
55
+ spinners.set(label, spinner);
56
+ break;
57
+ }
58
+ case "done": {
59
+ const s = spinners.get(label);
60
+ if (s) {
61
+ s.succeed(chalk.white(label));
62
+ spinners.delete(label);
63
+ }
64
+ else {
65
+ console.log(chalk.green(" [✓] ") + chalk.white(label));
66
+ }
67
+ break;
68
+ }
69
+ case "failed": {
70
+ const sf = spinners.get(label);
71
+ if (sf) {
72
+ sf.fail(chalk.white(label));
73
+ spinners.delete(label);
74
+ }
75
+ else {
76
+ console.log(chalk.red(" [✗] ") + chalk.white(label));
77
+ }
78
+ break;
79
+ }
80
+ }
81
+ }
82
+ // ─── Basic Output Helpers ────────────────────────────────────────────────────
14
83
  export function success(msg) {
15
84
  console.log(chalk.green(" ✓") + " " + msg);
16
85
  }
@@ -24,43 +93,20 @@ export function step(msg) {
24
93
  console.log(chalk.cyan(" →") + " " + msg);
25
94
  }
26
95
  export function nextSteps(dir) {
96
+ const W = 48;
97
+ const line = "─".repeat(W);
98
+ const pad = (text, len) => text + " ".repeat(Math.max(0, len - text.length));
99
+ const row = (text) => chalk.dim(" │") + pad(text, W) + chalk.dim("│");
27
100
  console.log();
28
- console.log(chalk.bold(" All done! Next steps:"));
29
- console.log();
30
- console.log(chalk.white(` cd ${dir}`));
31
- console.log(chalk.white(" claude"));
32
- console.log(chalk.white(" /setup") +
33
- chalk.dim(" ← interactive wizard to personalize your HQ"));
34
- console.log();
35
- }
36
- export function upgradeSummary(added, skipped) {
37
- console.log();
38
- console.log(chalk.bold(" Upgrade Summary"));
39
- console.log(chalk.dim(" ─────────────────────────────────────"));
40
- console.log(chalk.green(` Added: ${added.length} new file${added.length !== 1 ? "s" : ""}`));
41
- console.log(chalk.dim(` Skipped: ${skipped.length} existing file${skipped.length !== 1 ? "s" : ""} (not overwritten)`));
42
- if (added.length > 0) {
43
- console.log();
44
- console.log(chalk.dim(" New files added:"));
45
- for (const file of added.slice(0, 20)) {
46
- console.log(chalk.green(` + ${file}`));
47
- }
48
- if (added.length > 20) {
49
- console.log(chalk.dim(` ... and ${added.length - 20} more`));
50
- }
51
- }
52
- console.log();
53
- }
54
- export function upgradeNextSteps(dir) {
55
- console.log();
56
- console.log(chalk.bold(" Upgrade complete! Next steps:"));
57
- console.log();
58
- if (dir !== ".") {
59
- console.log(chalk.white(` cd ${dir}`));
60
- }
61
- console.log(chalk.white(" claude"));
62
- console.log(chalk.dim(" Your existing files (CLAUDE.md, workers/, projects/) are untouched."));
63
- console.log(chalk.dim(" New template files have been added alongside your existing setup."));
101
+ console.log(chalk.dim(" ┌" + line + "┐"));
102
+ console.log(row(chalk.bold.white(" All done! Your HQ is ready.")));
103
+ console.log(chalk.dim(" ├" + line + "┤"));
104
+ console.log(row(""));
105
+ console.log(row(` cd ${dir}`));
106
+ console.log(row(" claude"));
107
+ console.log(row(" /setup " + chalk.dim("← personalize your HQ")));
108
+ console.log(row(""));
109
+ console.log(chalk.dim(" └" + line + "┘"));
64
110
  console.log();
65
111
  }
66
112
  //# sourceMappingURL=ui.js.map
package/dist/ui.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"ui.js","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"ui.js","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,40 +1,49 @@
1
- {
2
- "name": "create-hq",
3
- "version": "6.0.0",
4
- "description": "Create a new HQ — Personal OS for AI Workers",
5
- "bin": {
6
- "create-hq": "./dist/index.js"
7
- },
8
- "files": [
9
- "dist",
10
- "template"
11
- ],
12
- "scripts": {
13
- "build": "tsc",
14
- "typecheck": "tsc --noEmit",
15
- "clean": "rm -rf dist",
16
- "prepack": "node -e \"require('fs').cpSync('../../template','./template',{recursive:true})\"",
17
- "postpack": "node -e \"require('fs').rmSync('./template',{recursive:true,force:true})\""
18
- },
19
- "dependencies": {
20
- "chalk": "^5.3.0",
21
- "commander": "^12.1.0",
22
- "fs-extra": "^11.2.0"
23
- },
24
- "devDependencies": {
25
- "@types/fs-extra": "^11.0.4",
26
- "@types/node": "^22.0.0",
27
- "typescript": "^5.7.0"
28
- },
29
- "engines": {
30
- "node": ">=18.0.0"
31
- },
32
- "repository": {
33
- "type": "git",
34
- "url": "https://github.com/indigoai-us/hq.git",
35
- "directory": "packages/create-hq"
36
- },
37
- "keywords": ["hq", "ai", "workers", "claude", "personal-os"],
38
- "license": "MIT",
39
- "type": "module"
40
- }
1
+ {
2
+ "name": "create-hq",
3
+ "version": "10.0.0",
4
+ "description": "Create a new HQ — Personal OS for AI Workers",
5
+ "bin": {
6
+ "create-hq": "./dist/index.js"
7
+ },
8
+ "files": [
9
+ "dist"
10
+ ],
11
+ "scripts": {
12
+ "build": "tsc",
13
+ "typecheck": "tsc --noEmit",
14
+ "clean": "rm -rf dist",
15
+ "prepack": "tsc",
16
+ "test": "vitest run",
17
+ "test:containers": "vitest run test/container.test.ts"
18
+ },
19
+ "dependencies": {
20
+ "chalk": "^5.3.0",
21
+ "commander": "^12.1.0",
22
+ "fs-extra": "^11.2.0",
23
+ "ora": "^8.1.0"
24
+ },
25
+ "devDependencies": {
26
+ "@types/fs-extra": "^11.0.4",
27
+ "@types/node": "^22.0.0",
28
+ "@vitest/coverage-v8": "^4.1.2",
29
+ "typescript": "^5.7.0",
30
+ "vitest": "^4.1.2"
31
+ },
32
+ "engines": {
33
+ "node": ">=18.0.0"
34
+ },
35
+ "repository": {
36
+ "type": "git",
37
+ "url": "https://github.com/indigoai-us/hq.git",
38
+ "directory": "packages/create-hq"
39
+ },
40
+ "keywords": [
41
+ "hq",
42
+ "ai",
43
+ "workers",
44
+ "claude",
45
+ "personal-os"
46
+ ],
47
+ "license": "MIT",
48
+ "type": "module"
49
+ }
@@ -1,202 +0,0 @@
1
- # HQ - Personal OS for AI Workers
2
-
3
- Personal OS for orchestrating work across companies, workers, and AI.
4
-
5
- ## Key Files
6
-
7
- - `INDEX.md` - Root directory map, recent threads, workers (start here)
8
- - `USER-GUIDE.md` - Commands, workers, typical session
9
- - `agents.md` - Your profile, preferences, companies (load for writing/communication tasks)
10
- - `workers/registry.yaml` - Worker index
11
-
12
- ## INDEX.md System
13
-
14
- Hierarchical INDEX.md files provide a navigable map of HQ. Read parent INDEX before diving into subdirectories.
15
-
16
- **Key indexes:** `projects/INDEX.md`, `workspace/orchestrator/INDEX.md`, `companies/*/knowledge/INDEX.md`, `workers/*/INDEX.md`, `knowledge/INDEX.md`, `workspace/reports/INDEX.md`
17
-
18
- **Spec:** `knowledge/hq-core/index-md-spec.md`
19
- **Rebuild all:** `/cleanup --reindex`
20
- **Auto-updated by:** `/checkpoint`, `/handoff`, `/reanchor`, `/prd`, `/run-project`, `/newworker`, content commands
21
-
22
- ## Structure
23
-
24
- ```
25
- HQ/
26
- ├── .claude/commands/ # Slash commands (17, visibility: public|private in frontmatter)
27
- ├── agents.md # Your profile
28
- ├── companies/ # Company-scoped resources (optional)
29
- │ └── {company}/ # settings/, data/, knowledge/
30
- ├── knowledge/ # HQ-level (Ralph, workers, security, projects)
31
- ├── projects/ # Project PRDs
32
- ├── workers/ # Worker definitions
33
- │ ├── dev-team/ # 12 code workers
34
- │ └── content-*/ # 5 content workers
35
- ├── social-content/ # Content drafts
36
- │ └── drafts/ # x/, linkedin/
37
- └── workspace/
38
- ├── checkpoints/ # Manual saves
39
- ├── threads/ # Auto-saved sessions
40
- ├── orchestrator/ # Project state
41
- ├── learnings/ # Task insights (event log)
42
- └── content-ideas/ # Idea capture
43
- ```
44
-
45
- ## Workers
46
-
47
- Workers are autonomous agents with defined skills. They *do things*.
48
-
49
- | Type | Purpose | Examples |
50
- |------|---------|----------|
51
- | CodeWorker | Implement features, fix bugs | dev-team/* |
52
- | ContentWorker | Draft content, maintain voice | content-brand, content-sales |
53
- | SocialWorker | Post to platforms | x-worker |
54
- | ResearchWorker | Analysis, market research | analyst |
55
- | OpsWorker | Reports, automation | cfo-worker |
56
-
57
- **Run a worker:** `/run {worker} {skill}`
58
-
59
- **Build a worker:** `/newworker`
60
-
61
- ## Commands
62
-
63
- ### Session Management
64
- | Command | Purpose |
65
- |---------|---------|
66
- | `/checkpoint` | Save state + context status |
67
- | `/handoff` | Prepare for fresh session |
68
- | `/reanchor` | Pause and realign |
69
- | `/nexttask` | Find next thing to work on |
70
- | `/remember` | Capture learnings as rules in relevant files |
71
- | `/learn` | Auto-capture and classify learnings from task execution |
72
-
73
- ### Projects
74
- | Command | Purpose |
75
- |---------|---------|
76
- | `/prd` | Generate PRD through discovery |
77
- | `/run-project` | Execute project via Ralph loop |
78
- | `/execute-task` | Run single task with workers |
79
-
80
- ### Workers
81
- | Command | Purpose |
82
- |---------|---------|
83
- | `/run` | List/execute workers |
84
- | `/newworker` | Create new worker |
85
- | `/metrics` | View execution metrics |
86
-
87
- ### System
88
- | Command | Purpose |
89
- |---------|---------|
90
- | `/search` | Semantic + full-text search across HQ (qmd-powered) |
91
- | `/search-reindex` | Reindex and re-embed HQ for qmd search |
92
- | `/cleanup` | Audit and clean HQ |
93
- | `/setup` | Interactive setup wizard |
94
- | `/exit-plan` | Force exit from plan mode |
95
-
96
- ## Knowledge Repos
97
-
98
- Knowledge folders can be their own git repos, symlinked into HQ. This enables independent versioning, sharing, and publishing per knowledge base.
99
-
100
- **Convention:** Repos live in `repos/public/` or `repos/private/`. Symlinks in `knowledge/` and `companies/*/knowledge` point to them. The symlinks are tracked by HQ git; the repo contents are gitignored.
101
-
102
- **Reading/searching:** Transparent. `qmd`, `Glob`, `Grep`, `Read` all follow symlinks.
103
-
104
- **Committing knowledge changes:** Changes show in `git status` of the *target repo* (not HQ). To commit:
105
- 1. `cd` to the symlink target (e.g. `repos/public/knowledge-ralph/`)
106
- 2. `git add`, `git commit`, `git push` in that repo
107
-
108
- **Adding new knowledge:** Create repo in `repos/{public|private}/knowledge-{name}`, symlink into the appropriate knowledge path.
109
-
110
- ## Search (qmd)
111
-
112
- HQ can be indexed with [qmd](https://github.com/tobi/qmd) for local semantic + full-text search.
113
-
114
- **When to search:** Before any planning, research, or context-gathering task, search HQ first with `qmd` to find relevant knowledge, workers, skills, and prior work.
115
-
116
- **Commands (run via Bash tool):**
117
- - `qmd search "<query>" --json -n 10` — BM25 keyword search (fast, default)
118
- - `qmd vsearch "<query>" --json -n 10` — semantic/conceptual search
119
- - `qmd query "<query>" --json -n 10` — hybrid BM25 + vector + re-ranking (best quality, slower)
120
-
121
- **Slash commands:** `/search <query>`, `/search-reindex`
122
-
123
- ### Search rules (all commands/skills must follow)
124
-
125
- | Need | Tool | Example |
126
- |------|------|---------|
127
- | Find HQ content by topic | `qmd search` or `qmd vsearch` | "Find knowledge about API integration" |
128
- | Find files by path pattern | `Glob` | `workers/*/worker.yaml`, `projects/*/prd.json` |
129
- | Search code in `repos/` | `Grep` | Pattern matching in source code |
130
- | Validate structured files | `grep` in Bash | Checking YAML fields, git branch filtering |
131
-
132
- **Never use Grep/Glob to search HQ content by topic.** That's what qmd does. Commands and skills that scan HQ for related context must use `qmd vsearch` (semantic) or `qmd search` (keyword), not Grep.
133
-
134
- ## Learned Rules
135
-
136
- <!-- Max 20. Overflow removed (rule still lives in its source file). -->
137
- <!-- Auto-managed by /learn. Manual: /remember -->
138
-
139
- (none yet — rules accumulate as the system runs)
140
-
141
- ## Learning System
142
-
143
- Learnings are rules injected directly into the files they govern:
144
- - Worker rules → `worker.yaml` `instructions:` block
145
- - Command rules → command `.md` `## Rules` section
146
- - Knowledge rules → relevant knowledge file
147
- - Global rules → this file `## Learned Rules`
148
-
149
- - `/learn` captures and classifies learnings automatically after task execution
150
- - `/remember` delegates to `/learn` — user corrections always promote to Tier 1
151
-
152
- Event log: `workspace/learnings/*.json` (append-only, for analysis/dedup).
153
-
154
- ## Auto-Learn (Build Activities)
155
-
156
- When building HQ infrastructure (new workers, knowledge bases, commands, projects), auto-capture structural changes so future sessions know what exists:
157
-
158
- **Triggers:**
159
- - `/newworker` completes → `/learn` with scope: global, rule: "Worker {id} exists at {path} for {purpose}"
160
- - `/prd` completes → `/learn` with scope: global, rule: "Project {name} exists with {N} stories targeting {repo}"
161
- - New knowledge files created → `/learn` with scope: global, rule: "Knowledge {topic} available at {path}"
162
- - New command created → `/learn` with scope: global, rule: "Command /{name} available for {purpose}"
163
-
164
- **Why:** Fresh sessions load CLAUDE.md but don't scan every directory. Learned rules act as an index of what has been built, preventing re-creation of existing resources and enabling discovery.
165
-
166
- **Also:** After any structural change, run `qmd update 2>/dev/null || true` to keep search current.
167
-
168
- ## Auto-Checkpoint (PostToolsHook)
169
-
170
- After completing any of these actions, automatically save thread state to `workspace/threads/`:
171
-
172
- **Triggers:**
173
- - Worker skill completion (via `/run`)
174
- - Git commit
175
- - File generation (reports, social drafts)
176
- - Significant file edits in project repos
177
-
178
- **Thread Format:** See `knowledge/hq-core/thread-schema.md`
179
-
180
- **Why:** Prevents lost work, enables session resumption, provides audit trail.
181
-
182
- **How:** After a triggering action, capture git state + summary and write to `workspace/threads/T-{timestamp}-{slug}.json`
183
-
184
- **Knowledge repos:** When edits touch knowledge files (symlinked to `repos/`), commit those changes to the knowledge repo — not HQ git. See "Knowledge Repos" section above for commit instructions.
185
-
186
- ## Auto-Handoff (Context Limit)
187
-
188
- When context usage reaches 70% (remaining drops to 30%), automatically run `/handoff`.
189
-
190
- **Rules:**
191
- - Check context status line — when `remaining_percentage` ≤ 30, trigger handoff
192
- - Before handoff, finish current atomic task (don't interrupt mid-edit)
193
- - Notify user: "Context at {X}% remaining. Running /handoff to preserve continuity."
194
- - Run `/handoff` with summary of remaining work
195
- - This overrides manual handoff — don't wait for user to request it
196
-
197
- ## Core Principles
198
-
199
- 1. **Infrastructure scales, effort doesn't** - Build reusable systems
200
- 2. **Workers should grow smarter** - Capture learnings in knowledge bases
201
- 3. **Context is precious** - Checkpoint often, don't let work evaporate
202
- 4. **Ship, then iterate** - Working > perfect
@@ -1,127 +0,0 @@
1
- ---
2
- description: Save checkpoint and check context status
3
- allowed-tools: Write, Bash, Read
4
- argument-hint: [task-id]
5
- visibility: public
6
- ---
7
-
8
- # /checkpoint - Save Progress
9
-
10
- Save current work state as a thread to survive context loss.
11
-
12
- **Task ID (optional):** $ARGUMENTS
13
-
14
- ## Process
15
-
16
- 1. **Generate thread ID** if not provided
17
- - Format: `T-{YYYYMMDD}-{HHMMSS}-{slug}`
18
- - Derive slug from recent work (e.g., `mrr-report`, `email-fix`)
19
-
20
- 2. **Capture git state**
21
- ```bash
22
- git rev-parse --abbrev-ref HEAD # branch
23
- git remote get-url origin 2>/dev/null # remote
24
- git rev-parse --short HEAD # current commit
25
- git log --oneline -5 # recent commits
26
- git diff --name-only HEAD~3 # recently touched files
27
- git status --porcelain # dirty check
28
- ```
29
-
30
- 3. **Capture knowledge repo git states**
31
- Knowledge folders are separate git repos (symlinked). For any knowledge path in files_touched, capture its repo state:
32
- ```bash
33
- # For each knowledge repo with changes:
34
- for symlink in knowledge/public/* knowledge/private/* companies/*/knowledge; do
35
- [ -L "$symlink" ] || continue
36
- repo_dir=$(cd "$symlink" && git rev-parse --show-toplevel 2>/dev/null) || continue
37
- dirty=$(cd "$repo_dir" && git status --porcelain)
38
- [ -z "$dirty" ] && continue
39
- echo "$symlink: $(cd "$repo_dir" && git rev-parse --short HEAD) (dirty)"
40
- done
41
- ```
42
- Include dirty knowledge repos in the thread JSON under `git.knowledge_repos`.
43
-
44
- 4. **Gather session state**
45
- - Summarize what was accomplished
46
- - List files touched
47
- - Identify next steps
48
-
49
- 5. **Write thread** to `workspace/threads/{thread_id}.json` (include knowledge_repos from step 3):
50
- ```json
51
- {
52
- "thread_id": "T-20260123-143052-mrr-report",
53
- "version": 1,
54
- "created_at": "ISO8601",
55
- "updated_at": "ISO8601",
56
-
57
- "workspace_root": "~/Documents/HQ",
58
- "cwd": "current/working/dir",
59
-
60
- "git": {
61
- "branch": "main",
62
- "remote_url": "git@github.com:...",
63
- "initial_commit": "abc1234",
64
- "current_commit": "def5678",
65
- "commits_made": ["hash: message"],
66
- "dirty": false,
67
- "knowledge_repos": {
68
- "knowledge-acme": {"commit": "abc1234", "dirty": true},
69
- "knowledge-ralph": {"commit": "def5678", "dirty": false}
70
- }
71
- },
72
-
73
- "worker": {
74
- "id": "worker-id or null",
75
- "skill": "skill-name or null",
76
- "state": "completed"
77
- },
78
-
79
- "conversation_summary": "1-2 sentence summary",
80
- "files_touched": ["relative/paths"],
81
- "next_steps": ["remaining tasks"],
82
-
83
- "metadata": {
84
- "title": "Human-readable title",
85
- "tags": ["searchable", "tags"]
86
- }
87
- }
88
- ```
89
-
90
- 6. **Also write legacy checkpoint** to `workspace/checkpoints/{task-id}.json` for backward compat
91
-
92
- 7. **Update INDEX.md files**
93
- - Regenerate `INDEX.md` at HQ root with current:
94
- - Workers from `workers/registry.yaml`
95
- - Recent threads from `workspace/threads/`
96
- - Update timestamp
97
- - Regenerate `workspace/threads/INDEX.md` (all threads, full table)
98
- - Check files_touched for any `companies/*/knowledge/` paths — if found, regenerate that company's `knowledge/INDEX.md`
99
- - See `knowledge/public/hq-core/index-md-spec.md` for INDEX format
100
-
101
- 8. **Report**
102
- ```
103
- Thread saved: workspace/threads/{thread_id}.json
104
-
105
- Summary: {summary}
106
- Git: {branch} @ {commit} ({dirty ? "dirty" : "clean"})
107
- Files: {count} files touched
108
- Next: {next_steps or "Work complete"}
109
-
110
- To hand off to fresh session: /handoff
111
- ```
112
-
113
- ## Thread vs Checkpoint
114
-
115
- | Feature | Thread (new) | Checkpoint (legacy) |
116
- |---------|--------------|---------------------|
117
- | Git context | Full (branch, commits, dirty) | Minimal |
118
- | Worker state | Captured | Not captured |
119
- | Location | workspace/threads/ | workspace/checkpoints/ |
120
- | Format | Rich JSON | Simple JSON |
121
-
122
- ## Notes
123
-
124
- - Threads ensure work survives context clears
125
- - Run frequently during long sessions
126
- - If session feels long, suggest `/handoff`
127
- - Threads are searchable via `/search`