@happier-dev/stack 0.1.0-preview.74.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (439) hide show
  1. package/README.md +501 -0
  2. package/bin/hstack.mjs +348 -0
  3. package/docs/codex-mcp-resume.md +129 -0
  4. package/docs/edison.md +74 -0
  5. package/docs/forking-and-branding.md +189 -0
  6. package/docs/happy-development.md +22 -0
  7. package/docs/isolated-linux-vm.md +243 -0
  8. package/docs/menubar.md +244 -0
  9. package/docs/mobile-ios.md +322 -0
  10. package/docs/monorepo-migration.md +20 -0
  11. package/docs/paths-and-env.md +154 -0
  12. package/docs/remote-access.md +43 -0
  13. package/docs/server-flavors.md +147 -0
  14. package/docs/stacks.md +330 -0
  15. package/docs/tauri.md +60 -0
  16. package/docs/worktrees-and-forks.md +133 -0
  17. package/extras/swiftbar/auth-login.sh +29 -0
  18. package/extras/swiftbar/git-cache-refresh.sh +122 -0
  19. package/extras/swiftbar/hstack-term.sh +133 -0
  20. package/extras/swiftbar/hstack.5s.sh +296 -0
  21. package/extras/swiftbar/hstack.sh +35 -0
  22. package/extras/swiftbar/icons/happy-green.png +0 -0
  23. package/extras/swiftbar/icons/happy-orange.png +0 -0
  24. package/extras/swiftbar/icons/happy-red.png +0 -0
  25. package/extras/swiftbar/icons/logo-white.png +0 -0
  26. package/extras/swiftbar/install.sh +265 -0
  27. package/extras/swiftbar/lib/git.sh +629 -0
  28. package/extras/swiftbar/lib/icons.sh +92 -0
  29. package/extras/swiftbar/lib/render.sh +999 -0
  30. package/extras/swiftbar/lib/system.sh +244 -0
  31. package/extras/swiftbar/lib/utils.sh +717 -0
  32. package/extras/swiftbar/set-interval.sh +65 -0
  33. package/extras/swiftbar/set-server-flavor.sh +61 -0
  34. package/extras/swiftbar/wt-pr.sh +140 -0
  35. package/node_modules/@happier-dev/cli-common/README.md +6 -0
  36. package/node_modules/@happier-dev/cli-common/dist/index.d.ts +4 -0
  37. package/node_modules/@happier-dev/cli-common/dist/index.d.ts.map +1 -0
  38. package/node_modules/@happier-dev/cli-common/dist/index.js +4 -0
  39. package/node_modules/@happier-dev/cli-common/dist/index.js.map +1 -0
  40. package/node_modules/@happier-dev/cli-common/dist/links/index.d.ts +18 -0
  41. package/node_modules/@happier-dev/cli-common/dist/links/index.d.ts.map +1 -0
  42. package/node_modules/@happier-dev/cli-common/dist/links/index.js +25 -0
  43. package/node_modules/@happier-dev/cli-common/dist/links/index.js.map +1 -0
  44. package/node_modules/@happier-dev/cli-common/dist/links.d.ts +2 -0
  45. package/node_modules/@happier-dev/cli-common/dist/links.d.ts.map +1 -0
  46. package/node_modules/@happier-dev/cli-common/dist/links.js +2 -0
  47. package/node_modules/@happier-dev/cli-common/dist/links.js.map +1 -0
  48. package/node_modules/@happier-dev/cli-common/dist/update/index.d.ts +67 -0
  49. package/node_modules/@happier-dev/cli-common/dist/update/index.d.ts.map +1 -0
  50. package/node_modules/@happier-dev/cli-common/dist/update/index.js +259 -0
  51. package/node_modules/@happier-dev/cli-common/dist/update/index.js.map +1 -0
  52. package/node_modules/@happier-dev/cli-common/dist/workspaces/index.d.ts +17 -0
  53. package/node_modules/@happier-dev/cli-common/dist/workspaces/index.d.ts.map +1 -0
  54. package/node_modules/@happier-dev/cli-common/dist/workspaces/index.js +80 -0
  55. package/node_modules/@happier-dev/cli-common/dist/workspaces/index.js.map +1 -0
  56. package/node_modules/@happier-dev/cli-common/package.json +26 -0
  57. package/package.json +77 -0
  58. package/scripts/auth.mjs +1829 -0
  59. package/scripts/auth_copy_from_pglite_lock_in_use.integration.test.mjs +90 -0
  60. package/scripts/auth_copy_from_runCapture.integration.test.mjs +447 -0
  61. package/scripts/auth_help_cmd.test.mjs +28 -0
  62. package/scripts/auth_login_flow_in_tty.test.mjs +100 -0
  63. package/scripts/auth_login_force_default.test.mjs +66 -0
  64. package/scripts/auth_login_guided_server_no_expo.test.mjs +126 -0
  65. package/scripts/auth_login_method_override.test.mjs +67 -0
  66. package/scripts/auth_login_print_includes_configure_links.test.mjs +99 -0
  67. package/scripts/auth_status_server_validation.integration.test.mjs +140 -0
  68. package/scripts/build.mjs +266 -0
  69. package/scripts/bundleWorkspaceDeps.mjs +38 -0
  70. package/scripts/bundleWorkspaceDeps.test.mjs +77 -0
  71. package/scripts/ci.mjs +135 -0
  72. package/scripts/ci.test.mjs +50 -0
  73. package/scripts/cli-link.mjs +57 -0
  74. package/scripts/completion.mjs +395 -0
  75. package/scripts/contrib.mjs +333 -0
  76. package/scripts/daemon.mjs +1160 -0
  77. package/scripts/daemon.status_scope.test.mjs +51 -0
  78. package/scripts/daemon_cmd.mjs +26 -0
  79. package/scripts/daemon_dist_guard.test.mjs +171 -0
  80. package/scripts/daemon_invalid_auth_reseed_stack_name.integration.test.mjs +608 -0
  81. package/scripts/daemon_server_scoped_state.test.mjs +49 -0
  82. package/scripts/daemon_start_verification.integration.test.mjs +296 -0
  83. package/scripts/dev.mjs +545 -0
  84. package/scripts/doctor.mjs +340 -0
  85. package/scripts/doctor_cmd.test.mjs +22 -0
  86. package/scripts/doctor_ui_index_missing.test.mjs +37 -0
  87. package/scripts/eas.mjs +367 -0
  88. package/scripts/eas_platform_parsing.test.mjs +63 -0
  89. package/scripts/edison.mjs +1848 -0
  90. package/scripts/env.mjs +149 -0
  91. package/scripts/env_cmd.test.mjs +118 -0
  92. package/scripts/exit_cleanup_kills_detached_children_on_crash.integration.test.mjs +80 -0
  93. package/scripts/happier.mjs +82 -0
  94. package/scripts/import.mjs +1327 -0
  95. package/scripts/init.mjs +464 -0
  96. package/scripts/install.mjs +550 -0
  97. package/scripts/lint.mjs +177 -0
  98. package/scripts/menubar.mjs +202 -0
  99. package/scripts/migrate.mjs +318 -0
  100. package/scripts/mobile.mjs +353 -0
  101. package/scripts/mobile_dev_client.mjs +87 -0
  102. package/scripts/monorepo.mjs +2234 -0
  103. package/scripts/monorepo_port.apply.integration.test.mjs +680 -0
  104. package/scripts/monorepo_port.conflicts.integration.test.mjs +454 -0
  105. package/scripts/monorepo_port.validation.integration.test.mjs +486 -0
  106. package/scripts/orchestrated_stack_auth_flow.test.mjs +134 -0
  107. package/scripts/orchestrated_stack_auth_flow_resolve_port.test.mjs +98 -0
  108. package/scripts/orchestrated_stack_auth_flow_webapp_url.test.mjs +119 -0
  109. package/scripts/pack.mjs +257 -0
  110. package/scripts/pack.test.mjs +68 -0
  111. package/scripts/pglite_lock.integration.test.mjs +152 -0
  112. package/scripts/provision/linux-ubuntu-e2e.sh +132 -0
  113. package/scripts/provision/linux-ubuntu-review-pr.sh +66 -0
  114. package/scripts/provision/macos-lima-happy-vm.sh +192 -0
  115. package/scripts/provision/macos-lima-hstack-e2e.sh +100 -0
  116. package/scripts/release.mjs +53 -0
  117. package/scripts/release_binary_smoke.integration.test.mjs +138 -0
  118. package/scripts/review.mjs +1752 -0
  119. package/scripts/review_pr.mjs +435 -0
  120. package/scripts/run.mjs +561 -0
  121. package/scripts/run_script_with_stack_env.restart_port_reuse.test.mjs +30 -0
  122. package/scripts/self.mjs +465 -0
  123. package/scripts/self_host.mjs +9 -0
  124. package/scripts/self_host_binary_smoke.integration.test.mjs +74 -0
  125. package/scripts/self_host_runtime.mjs +883 -0
  126. package/scripts/self_host_runtime.test.mjs +82 -0
  127. package/scripts/self_host_systemd.real.integration.test.mjs +367 -0
  128. package/scripts/server_flavor.mjs +148 -0
  129. package/scripts/service.mjs +868 -0
  130. package/scripts/service_mode_help.test.mjs +27 -0
  131. package/scripts/setup.mjs +1324 -0
  132. package/scripts/setup_non_interactive_flag.test.mjs +60 -0
  133. package/scripts/setup_pr.mjs +605 -0
  134. package/scripts/setup_pr_orchestrated_auth_flow_util_import.test.mjs +117 -0
  135. package/scripts/stack/command_arguments.mjs +91 -0
  136. package/scripts/stack/copy_auth_from_stack.mjs +111 -0
  137. package/scripts/stack/delegated_script_commands.mjs +92 -0
  138. package/scripts/stack/help_text.mjs +110 -0
  139. package/scripts/stack/port_reservation.mjs +74 -0
  140. package/scripts/stack/repo_checkout_resolution.mjs +31 -0
  141. package/scripts/stack/run_script_with_stack_env.mjs +634 -0
  142. package/scripts/stack/stack_daemon_command.mjs +219 -0
  143. package/scripts/stack/stack_delegated_help.mjs +81 -0
  144. package/scripts/stack/stack_environment.mjs +151 -0
  145. package/scripts/stack/stack_environment.sanitization.test.mjs +75 -0
  146. package/scripts/stack/stack_happier_passthrough_command.mjs +63 -0
  147. package/scripts/stack/stack_info_snapshot.mjs +167 -0
  148. package/scripts/stack/stack_mobile_install_command.mjs +61 -0
  149. package/scripts/stack/stack_resume_command.mjs +76 -0
  150. package/scripts/stack/stack_stop_command.mjs +34 -0
  151. package/scripts/stack/stack_workspace_command.mjs +83 -0
  152. package/scripts/stack/transient_repo_overrides.mjs +29 -0
  153. package/scripts/stack.mjs +2388 -0
  154. package/scripts/stack_archive_cmd.integration.test.mjs +31 -0
  155. package/scripts/stack_audit_fix_light_env.test.mjs +129 -0
  156. package/scripts/stack_background_pinned_stack_json.test.mjs +81 -0
  157. package/scripts/stack_copy_auth_server_scoped.test.mjs +243 -0
  158. package/scripts/stack_daemon_cmd.integration.test.mjs +484 -0
  159. package/scripts/stack_eas_help.test.mjs +72 -0
  160. package/scripts/stack_editor_workspace_monorepo_root.test.mjs +102 -0
  161. package/scripts/stack_env_cmd.test.mjs +107 -0
  162. package/scripts/stack_guided_login_bundle_error_parse.test.mjs +20 -0
  163. package/scripts/stack_guided_login_inner_invocation.test.mjs +46 -0
  164. package/scripts/stack_happy_cmd.integration.test.mjs +263 -0
  165. package/scripts/stack_info_snapshot_running_status.test.mjs +186 -0
  166. package/scripts/stack_interactive_monorepo_group.test.mjs +128 -0
  167. package/scripts/stack_monorepo_defaults.test.mjs +31 -0
  168. package/scripts/stack_monorepo_repo_dev_token.test.mjs +32 -0
  169. package/scripts/stack_monorepo_server_light_from_happy_spec.test.mjs +37 -0
  170. package/scripts/stack_new_name_normalize_cmd.test.mjs +38 -0
  171. package/scripts/stack_pr_name_normalize_cmd.test.mjs +84 -0
  172. package/scripts/stack_resume_cmd.integration.test.mjs +134 -0
  173. package/scripts/stack_server_flavors_defaults.test.mjs +64 -0
  174. package/scripts/stack_shorthand_cmd.integration.test.mjs +74 -0
  175. package/scripts/stack_stop_sweeps_legacy_infra_without_kind.integration.test.mjs +44 -0
  176. package/scripts/stack_stop_sweeps_when_runtime_missing.integration.test.mjs +42 -0
  177. package/scripts/stack_stop_sweeps_when_runtime_stale.integration.test.mjs +50 -0
  178. package/scripts/stack_wt_list.test.mjs +117 -0
  179. package/scripts/start_ui_required_default.test.mjs +63 -0
  180. package/scripts/stop.mjs +190 -0
  181. package/scripts/stopStackWithEnv_no_autosweep_when_runtime_missing.integration.test.mjs +95 -0
  182. package/scripts/swiftbar_git_monorepo_cmd.test.mjs +75 -0
  183. package/scripts/swiftbar_render_monorepo_wt_actions.integration.test.mjs +116 -0
  184. package/scripts/swiftbar_utils_cmd.test.mjs +92 -0
  185. package/scripts/swiftbar_wt_pr_backcompat.test.mjs +162 -0
  186. package/scripts/systemd_unit_info.test.mjs +24 -0
  187. package/scripts/tailscale.mjs +490 -0
  188. package/scripts/test_ci.mjs +36 -0
  189. package/scripts/test_cmd.mjs +274 -0
  190. package/scripts/test_cmd.test.mjs +133 -0
  191. package/scripts/test_integration.mjs +33 -0
  192. package/scripts/testkit/auth_testkit.mjs +121 -0
  193. package/scripts/testkit/doctor_testkit.mjs +68 -0
  194. package/scripts/testkit/monorepo_port_testkit.mjs +157 -0
  195. package/scripts/testkit/stack_archive_command_testkit.mjs +55 -0
  196. package/scripts/testkit/stack_new_monorepo_testkit.mjs +83 -0
  197. package/scripts/testkit/stack_script_command_testkit.mjs +27 -0
  198. package/scripts/testkit/stack_stop_sweeps_testkit.mjs +172 -0
  199. package/scripts/testkit/worktrees_monorepo_testkit.mjs +53 -0
  200. package/scripts/tools.mjs +70 -0
  201. package/scripts/tui.mjs +914 -0
  202. package/scripts/tui_stopStackForTuiExit_no_autosweep.integration.test.mjs +95 -0
  203. package/scripts/typecheck.mjs +178 -0
  204. package/scripts/ui_gateway.mjs +247 -0
  205. package/scripts/uninstall.mjs +179 -0
  206. package/scripts/utils/auth/credentials_paths.mjs +181 -0
  207. package/scripts/utils/auth/credentials_paths.test.mjs +187 -0
  208. package/scripts/utils/auth/daemon_gate.mjs +66 -0
  209. package/scripts/utils/auth/daemon_gate.test.mjs +116 -0
  210. package/scripts/utils/auth/decode_jwt_payload_unsafe.mjs +16 -0
  211. package/scripts/utils/auth/dev_key.mjs +163 -0
  212. package/scripts/utils/auth/files.mjs +56 -0
  213. package/scripts/utils/auth/guided_pr_auth.mjs +86 -0
  214. package/scripts/utils/auth/guided_stack_web_login.mjs +56 -0
  215. package/scripts/utils/auth/handy_master_secret.mjs +42 -0
  216. package/scripts/utils/auth/interactive_stack_auth.mjs +70 -0
  217. package/scripts/utils/auth/login_ux.mjs +105 -0
  218. package/scripts/utils/auth/orchestrated_stack_auth_flow.mjs +291 -0
  219. package/scripts/utils/auth/sources.mjs +28 -0
  220. package/scripts/utils/auth/stable_scope_id.mjs +91 -0
  221. package/scripts/utils/auth/stable_scope_id.test.mjs +51 -0
  222. package/scripts/utils/auth/stack_guided_login.mjs +438 -0
  223. package/scripts/utils/cli/arg_values.mjs +23 -0
  224. package/scripts/utils/cli/arg_values.test.mjs +43 -0
  225. package/scripts/utils/cli/args.mjs +17 -0
  226. package/scripts/utils/cli/cli.mjs +24 -0
  227. package/scripts/utils/cli/cli_registry.mjs +440 -0
  228. package/scripts/utils/cli/cwd_scope.mjs +158 -0
  229. package/scripts/utils/cli/cwd_scope.test.mjs +154 -0
  230. package/scripts/utils/cli/flags.mjs +17 -0
  231. package/scripts/utils/cli/log_forwarder.mjs +157 -0
  232. package/scripts/utils/cli/normalize.mjs +16 -0
  233. package/scripts/utils/cli/prereqs.mjs +103 -0
  234. package/scripts/utils/cli/prereqs.test.mjs +33 -0
  235. package/scripts/utils/cli/progress.mjs +141 -0
  236. package/scripts/utils/cli/smoke_help.mjs +44 -0
  237. package/scripts/utils/cli/verbosity.mjs +11 -0
  238. package/scripts/utils/cli/wizard.mjs +139 -0
  239. package/scripts/utils/cli/wizard_promptSelect.test.mjs +44 -0
  240. package/scripts/utils/cli/wizard_prompt_worktree_source_lazy.test.mjs +132 -0
  241. package/scripts/utils/cli/wizard_worktree_slug.test.mjs +33 -0
  242. package/scripts/utils/crypto/tokens.mjs +14 -0
  243. package/scripts/utils/dev/daemon.mjs +232 -0
  244. package/scripts/utils/dev/daemon_watch_resilience.test.mjs +224 -0
  245. package/scripts/utils/dev/expo_dev.buildEnv.test.mjs +35 -0
  246. package/scripts/utils/dev/expo_dev.mjs +478 -0
  247. package/scripts/utils/dev/expo_dev.test.mjs +89 -0
  248. package/scripts/utils/dev/expo_dev_restart_port_reservation.test.mjs +120 -0
  249. package/scripts/utils/dev/expo_dev_verbose_logs.test.mjs +60 -0
  250. package/scripts/utils/dev/server.mjs +180 -0
  251. package/scripts/utils/dev_auth_key.mjs +7 -0
  252. package/scripts/utils/edison/git_roots.mjs +30 -0
  253. package/scripts/utils/edison/git_roots.test.mjs +49 -0
  254. package/scripts/utils/env/config.mjs +52 -0
  255. package/scripts/utils/env/dotenv.mjs +32 -0
  256. package/scripts/utils/env/dotenv.test.mjs +32 -0
  257. package/scripts/utils/env/env.mjs +130 -0
  258. package/scripts/utils/env/env_file.mjs +98 -0
  259. package/scripts/utils/env/env_file.test.mjs +49 -0
  260. package/scripts/utils/env/env_local.mjs +25 -0
  261. package/scripts/utils/env/load_env_file.mjs +34 -0
  262. package/scripts/utils/env/read.mjs +30 -0
  263. package/scripts/utils/env/sandbox.mjs +13 -0
  264. package/scripts/utils/env/scrub_env.mjs +69 -0
  265. package/scripts/utils/env/scrub_env.test.mjs +102 -0
  266. package/scripts/utils/env/values.mjs +13 -0
  267. package/scripts/utils/expo/command.mjs +65 -0
  268. package/scripts/utils/expo/expo.mjs +139 -0
  269. package/scripts/utils/expo/expo_state_running.test.mjs +48 -0
  270. package/scripts/utils/expo/metro_ports.mjs +101 -0
  271. package/scripts/utils/expo/metro_ports.test.mjs +35 -0
  272. package/scripts/utils/fs/atomic_dir_swap.mjs +55 -0
  273. package/scripts/utils/fs/atomic_dir_swap.test.mjs +54 -0
  274. package/scripts/utils/fs/file_has_content.mjs +10 -0
  275. package/scripts/utils/fs/fs.mjs +11 -0
  276. package/scripts/utils/fs/json.mjs +25 -0
  277. package/scripts/utils/fs/ops.mjs +29 -0
  278. package/scripts/utils/fs/package_json.mjs +8 -0
  279. package/scripts/utils/fs/tail.mjs +12 -0
  280. package/scripts/utils/git/dev_checkout.mjs +127 -0
  281. package/scripts/utils/git/dev_checkout.test.mjs +115 -0
  282. package/scripts/utils/git/git.mjs +67 -0
  283. package/scripts/utils/git/parse_name_status_z.mjs +21 -0
  284. package/scripts/utils/git/refs.mjs +26 -0
  285. package/scripts/utils/git/worktrees.mjs +323 -0
  286. package/scripts/utils/git/worktrees_monorepo.test.mjs +60 -0
  287. package/scripts/utils/git/worktrees_pathstyle.test.mjs +53 -0
  288. package/scripts/utils/llm/assist.mjs +260 -0
  289. package/scripts/utils/llm/codex_exec.mjs +61 -0
  290. package/scripts/utils/llm/codex_exec.test.mjs +46 -0
  291. package/scripts/utils/llm/hstack_runner.mjs +59 -0
  292. package/scripts/utils/llm/tools.mjs +56 -0
  293. package/scripts/utils/llm/tools.test.mjs +67 -0
  294. package/scripts/utils/menubar/swiftbar.mjs +121 -0
  295. package/scripts/utils/menubar/swiftbar.test.mjs +85 -0
  296. package/scripts/utils/mobile/config.mjs +35 -0
  297. package/scripts/utils/mobile/dev_client_links.mjs +59 -0
  298. package/scripts/utils/mobile/identifiers.mjs +46 -0
  299. package/scripts/utils/mobile/identifiers.test.mjs +41 -0
  300. package/scripts/utils/mobile/ios_xcodeproj_patch.mjs +128 -0
  301. package/scripts/utils/mobile/ios_xcodeproj_patch.test.mjs +131 -0
  302. package/scripts/utils/net/bind_mode.mjs +39 -0
  303. package/scripts/utils/net/dns.mjs +10 -0
  304. package/scripts/utils/net/lan_ip.mjs +24 -0
  305. package/scripts/utils/net/ports.mjs +110 -0
  306. package/scripts/utils/net/tcp_forward.mjs +162 -0
  307. package/scripts/utils/net/url.mjs +30 -0
  308. package/scripts/utils/net/url.test.mjs +29 -0
  309. package/scripts/utils/paths/canonical_home.mjs +15 -0
  310. package/scripts/utils/paths/canonical_home.test.mjs +28 -0
  311. package/scripts/utils/paths/localhost_host.mjs +112 -0
  312. package/scripts/utils/paths/localhost_host.test.mjs +58 -0
  313. package/scripts/utils/paths/paths.mjs +302 -0
  314. package/scripts/utils/paths/paths_env_win32.test.mjs +36 -0
  315. package/scripts/utils/paths/paths_monorepo.test.mjs +58 -0
  316. package/scripts/utils/paths/paths_server_flavors.test.mjs +50 -0
  317. package/scripts/utils/paths/runtime.mjs +41 -0
  318. package/scripts/utils/pglite_lock.mjs +107 -0
  319. package/scripts/utils/proc/commands.mjs +33 -0
  320. package/scripts/utils/proc/exit_cleanup.mjs +57 -0
  321. package/scripts/utils/proc/happy_monorepo_deps.mjs +37 -0
  322. package/scripts/utils/proc/happy_monorepo_deps.test.mjs +89 -0
  323. package/scripts/utils/proc/ownership.mjs +217 -0
  324. package/scripts/utils/proc/ownership_killProcessGroupOwnedByStack.test.mjs +216 -0
  325. package/scripts/utils/proc/ownership_listPidsWithEnvNeedles.test.mjs +88 -0
  326. package/scripts/utils/proc/package_scripts.mjs +38 -0
  327. package/scripts/utils/proc/package_scripts.test.mjs +58 -0
  328. package/scripts/utils/proc/parallel.mjs +25 -0
  329. package/scripts/utils/proc/pids.mjs +11 -0
  330. package/scripts/utils/proc/pm.mjs +478 -0
  331. package/scripts/utils/proc/pm_spawn.integration.test.mjs +131 -0
  332. package/scripts/utils/proc/pm_stack_cache_env.test.mjs +313 -0
  333. package/scripts/utils/proc/proc.mjs +331 -0
  334. package/scripts/utils/proc/proc.test.mjs +85 -0
  335. package/scripts/utils/proc/terminate.mjs +69 -0
  336. package/scripts/utils/proc/terminate.test.mjs +54 -0
  337. package/scripts/utils/proc/watch.mjs +63 -0
  338. package/scripts/utils/review/augment_runner_integration.test.mjs +105 -0
  339. package/scripts/utils/review/base_ref.mjs +82 -0
  340. package/scripts/utils/review/base_ref.test.mjs +89 -0
  341. package/scripts/utils/review/chunks.mjs +55 -0
  342. package/scripts/utils/review/chunks.test.mjs +107 -0
  343. package/scripts/utils/review/detached_worktree.mjs +61 -0
  344. package/scripts/utils/review/detached_worktree.test.mjs +61 -0
  345. package/scripts/utils/review/findings.mjs +278 -0
  346. package/scripts/utils/review/findings.test.mjs +203 -0
  347. package/scripts/utils/review/head_slice.mjs +132 -0
  348. package/scripts/utils/review/head_slice.test.mjs +117 -0
  349. package/scripts/utils/review/instructions/deep.md +20 -0
  350. package/scripts/utils/review/prompts.mjs +279 -0
  351. package/scripts/utils/review/prompts.test.mjs +77 -0
  352. package/scripts/utils/review/run_reviewers_safe.mjs +12 -0
  353. package/scripts/utils/review/run_reviewers_safe.test.mjs +45 -0
  354. package/scripts/utils/review/runners/augment.mjs +91 -0
  355. package/scripts/utils/review/runners/augment.test.mjs +64 -0
  356. package/scripts/utils/review/runners/claude.mjs +92 -0
  357. package/scripts/utils/review/runners/claude.test.mjs +47 -0
  358. package/scripts/utils/review/runners/coderabbit.mjs +105 -0
  359. package/scripts/utils/review/runners/coderabbit.test.mjs +32 -0
  360. package/scripts/utils/review/runners/codex.mjs +129 -0
  361. package/scripts/utils/review/runners/codex.test.mjs +115 -0
  362. package/scripts/utils/review/slice_mode.mjs +20 -0
  363. package/scripts/utils/review/slice_mode.test.mjs +69 -0
  364. package/scripts/utils/review/sliced_runner.mjs +39 -0
  365. package/scripts/utils/review/sliced_runner.test.mjs +57 -0
  366. package/scripts/utils/review/slices.mjs +140 -0
  367. package/scripts/utils/review/slices.test.mjs +41 -0
  368. package/scripts/utils/review/targets.mjs +23 -0
  369. package/scripts/utils/review/targets.test.mjs +31 -0
  370. package/scripts/utils/review/tool_home_seed.mjs +106 -0
  371. package/scripts/utils/review/tool_home_seed.test.mjs +124 -0
  372. package/scripts/utils/review/uncommitted_ops.mjs +77 -0
  373. package/scripts/utils/review/uncommitted_ops.test.mjs +117 -0
  374. package/scripts/utils/sandbox/review_pr_sandbox.mjs +105 -0
  375. package/scripts/utils/server/apply_server_light_env_defaults.mjs +14 -0
  376. package/scripts/utils/server/flavor_scripts.mjs +138 -0
  377. package/scripts/utils/server/flavor_scripts.test.mjs +115 -0
  378. package/scripts/utils/server/infra/happy_server_infra.mjs +444 -0
  379. package/scripts/utils/server/mobile_api_url.mjs +60 -0
  380. package/scripts/utils/server/mobile_api_url.test.mjs +58 -0
  381. package/scripts/utils/server/port.mjs +55 -0
  382. package/scripts/utils/server/prisma_import.mjs +36 -0
  383. package/scripts/utils/server/prisma_import.test.mjs +78 -0
  384. package/scripts/utils/server/server.mjs +109 -0
  385. package/scripts/utils/server/ui_build_check.mjs +37 -0
  386. package/scripts/utils/server/ui_build_check.test.mjs +70 -0
  387. package/scripts/utils/server/ui_env.mjs +13 -0
  388. package/scripts/utils/server/ui_env.test.mjs +57 -0
  389. package/scripts/utils/server/urls.mjs +100 -0
  390. package/scripts/utils/server/validate.mjs +60 -0
  391. package/scripts/utils/server/validate.test.mjs +76 -0
  392. package/scripts/utils/service/autostart_darwin.mjs +198 -0
  393. package/scripts/utils/service/autostart_darwin.test.mjs +49 -0
  394. package/scripts/utils/service/autostart_darwin_keepalive.test.mjs +19 -0
  395. package/scripts/utils/stack/cli_identities.mjs +29 -0
  396. package/scripts/utils/stack/context.mjs +19 -0
  397. package/scripts/utils/stack/dirs.mjs +26 -0
  398. package/scripts/utils/stack/editor_workspace.mjs +126 -0
  399. package/scripts/utils/stack/interactive_stack_config.mjs +266 -0
  400. package/scripts/utils/stack/interactive_stack_config.port_validation.test.mjs +93 -0
  401. package/scripts/utils/stack/interactive_stack_config.remote_validation.test.mjs +122 -0
  402. package/scripts/utils/stack/interactive_stack_config.stack_name_validation.test.mjs +76 -0
  403. package/scripts/utils/stack/interactive_stack_config_testkit.mjs +18 -0
  404. package/scripts/utils/stack/names.mjs +27 -0
  405. package/scripts/utils/stack/names.test.mjs +26 -0
  406. package/scripts/utils/stack/pr_stack_name.mjs +16 -0
  407. package/scripts/utils/stack/runtime_state.mjs +88 -0
  408. package/scripts/utils/stack/stacks.mjs +40 -0
  409. package/scripts/utils/stack/startup.mjs +370 -0
  410. package/scripts/utils/stack/startup_server_light_dirs.test.mjs +119 -0
  411. package/scripts/utils/stack/startup_server_light_generate.test.mjs +20 -0
  412. package/scripts/utils/stack/startup_server_light_legacy.test.mjs +79 -0
  413. package/scripts/utils/stack/startup_server_light_testkit.mjs +106 -0
  414. package/scripts/utils/stack/stop.mjs +284 -0
  415. package/scripts/utils/stack_context.mjs +1 -0
  416. package/scripts/utils/stack_runtime_state.mjs +1 -0
  417. package/scripts/utils/stacks.mjs +1 -0
  418. package/scripts/utils/tailscale/ip.mjs +116 -0
  419. package/scripts/utils/tauri/stack_overrides.mjs +22 -0
  420. package/scripts/utils/test/collect_test_files.mjs +29 -0
  421. package/scripts/utils/time/get_today_ymd.mjs +7 -0
  422. package/scripts/utils/tui/cleanup.mjs +38 -0
  423. package/scripts/utils/ui/ansi.mjs +47 -0
  424. package/scripts/utils/ui/browser.mjs +31 -0
  425. package/scripts/utils/ui/browser.test.mjs +56 -0
  426. package/scripts/utils/ui/clipboard.mjs +38 -0
  427. package/scripts/utils/ui/layout.mjs +44 -0
  428. package/scripts/utils/ui/qr.mjs +17 -0
  429. package/scripts/utils/ui/terminal_launcher.mjs +129 -0
  430. package/scripts/utils/ui/text.mjs +16 -0
  431. package/scripts/utils/update/auto_update_notice.mjs +93 -0
  432. package/scripts/utils/validate.mjs +5 -0
  433. package/scripts/where.mjs +138 -0
  434. package/scripts/worktrees.mjs +2174 -0
  435. package/scripts/worktrees_archive_cmd.integration.test.mjs +228 -0
  436. package/scripts/worktrees_cursor_monorepo_root.test.mjs +23 -0
  437. package/scripts/worktrees_list_specs_no_recurse.test.mjs +32 -0
  438. package/scripts/worktrees_monorepo_testkit.test.mjs +29 -0
  439. package/scripts/worktrees_monorepo_use_group.test.mjs +41 -0
@@ -0,0 +1,331 @@
1
+ import { spawn } from 'node:child_process';
2
+ import { createWriteStream } from 'node:fs';
3
+
4
+ function nextLineBreakIndex(s) {
5
+ const n = s.indexOf('\n');
6
+ const r = s.indexOf('\r');
7
+ if (n < 0) return r;
8
+ if (r < 0) return n;
9
+ return Math.min(n, r);
10
+ }
11
+
12
+ function consumeLineBreak(buf) {
13
+ if (buf.startsWith('\r\n')) return buf.slice(2);
14
+ if (buf.startsWith('\n') || buf.startsWith('\r')) return buf.slice(1);
15
+ return buf;
16
+ }
17
+
18
+ function writeWithPrefix(stream, prefix, bufState, chunk) {
19
+ const s = chunk.toString();
20
+ bufState.buf += s;
21
+ while (true) {
22
+ const idx = nextLineBreakIndex(bufState.buf);
23
+ if (idx < 0) break;
24
+ const line = bufState.buf.slice(0, idx);
25
+ bufState.buf = consumeLineBreak(bufState.buf.slice(idx));
26
+ stream.write(`${prefix}${line}\n`);
27
+ }
28
+ }
29
+
30
+ function flushPrefixed(stream, prefix, bufState) {
31
+ if (!bufState.buf) return;
32
+ stream.write(`${prefix}${bufState.buf}\n`);
33
+ bufState.buf = '';
34
+ }
35
+
36
+ export function spawnProc(label, cmd, args, env, options = {}) {
37
+ const { silent = false, teeFile, teeLabel, ...spawnOptions } = options ?? {};
38
+ const child = spawn(cmd, args, {
39
+ env,
40
+ stdio: ['ignore', 'pipe', 'pipe'],
41
+ shell: false,
42
+ // Create a new process group so we can kill the whole tree reliably on shutdown.
43
+ detached: process.platform !== 'win32',
44
+ ...spawnOptions,
45
+ });
46
+
47
+ const outState = { buf: '' };
48
+ const errState = { buf: '' };
49
+ const outPrefix = `[${label}] `;
50
+ const errPrefix = `[${label}] `;
51
+
52
+ const teePath = typeof teeFile === 'string' && teeFile.trim() ? teeFile.trim() : '';
53
+ const teeStream = teePath ? createWriteStream(teePath, { flags: 'a' }) : null;
54
+ const teeOutState = { buf: '' };
55
+ const teeErrState = { buf: '' };
56
+ const teePrefix = (() => {
57
+ const t = typeof teeLabel === 'string' ? teeLabel.trim() : '';
58
+ if (t) return `[${t}] `;
59
+ return outPrefix;
60
+ })();
61
+
62
+ child.stdout?.on('data', (d) => {
63
+ if (!silent) writeWithPrefix(process.stdout, outPrefix, outState, d);
64
+ if (teeStream) writeWithPrefix(teeStream, teePrefix, teeOutState, d);
65
+ });
66
+ child.stderr?.on('data', (d) => {
67
+ if (!silent) writeWithPrefix(process.stderr, errPrefix, errState, d);
68
+ if (teeStream) writeWithPrefix(teeStream, teePrefix, teeErrState, d);
69
+ });
70
+ child.on('close', () => {
71
+ if (!silent) {
72
+ flushPrefixed(process.stdout, outPrefix, outState);
73
+ flushPrefixed(process.stderr, errPrefix, errState);
74
+ }
75
+ if (teeStream) {
76
+ flushPrefixed(teeStream, teePrefix, teeOutState);
77
+ flushPrefixed(teeStream, teePrefix, teeErrState);
78
+ try {
79
+ teeStream.end();
80
+ } catch {
81
+ // ignore
82
+ }
83
+ }
84
+ });
85
+ child.on('exit', (code, sig) => {
86
+ if (code !== 0) {
87
+ if (!silent) {
88
+ process.stderr.write(`[${label}] exited (code=${code}, sig=${sig})\n`);
89
+ }
90
+ if (teeStream) {
91
+ try {
92
+ teeStream.write(`${teePrefix.trimEnd()} exited (code=${code}, sig=${sig})\n`);
93
+ } catch {
94
+ // ignore
95
+ }
96
+ }
97
+ }
98
+ });
99
+
100
+ return child;
101
+ }
102
+
103
+ export function killProcessTree(child, signal) {
104
+ if (!child || child.exitCode != null || !child.pid) {
105
+ return;
106
+ }
107
+
108
+ try {
109
+ if (process.platform !== 'win32') {
110
+ // Kill the process group.
111
+ process.kill(-child.pid, signal);
112
+ } else {
113
+ child.kill(signal);
114
+ }
115
+ } catch {
116
+ // ignore
117
+ }
118
+ }
119
+
120
+ export async function run(cmd, args, options = {}) {
121
+ const { timeoutMs, input, ...spawnOptions } = options ?? {};
122
+ await new Promise((resolvePromise, rejectPromise) => {
123
+ const baseStdio = spawnOptions.stdio ?? 'inherit';
124
+ const stdio =
125
+ input != null
126
+ ? Array.isArray(baseStdio)
127
+ ? ['pipe', baseStdio[1] ?? 'inherit', baseStdio[2] ?? 'inherit']
128
+ : ['pipe', baseStdio, baseStdio]
129
+ : baseStdio;
130
+
131
+ const proc = spawn(cmd, args, { stdio, shell: false, ...spawnOptions });
132
+ if (input != null && proc.stdin) {
133
+ try {
134
+ proc.stdin.write(String(input));
135
+ proc.stdin.end();
136
+ } catch {
137
+ // ignore
138
+ }
139
+ }
140
+ const t =
141
+ Number.isFinite(timeoutMs) && timeoutMs > 0
142
+ ? setTimeout(() => {
143
+ try {
144
+ proc.kill('SIGKILL');
145
+ } catch {
146
+ // ignore
147
+ }
148
+ const e = new Error(`${cmd} timed out after ${timeoutMs}ms`);
149
+ e.code = 'ETIMEDOUT';
150
+ rejectPromise(e);
151
+ }, timeoutMs)
152
+ : null;
153
+ proc.on('error', rejectPromise);
154
+ proc.on('exit', (code) => (code === 0 ? resolvePromise() : rejectPromise(new Error(`${cmd} failed (code=${code})`))));
155
+ proc.on('exit', () => {
156
+ if (t) clearTimeout(t);
157
+ });
158
+ });
159
+ }
160
+
161
+ export async function runCapture(cmd, args, options = {}) {
162
+ const { timeoutMs, ...spawnOptions } = options ?? {};
163
+ return await new Promise((resolvePromise, rejectPromise) => {
164
+ const proc = spawn(cmd, args, { stdio: ['ignore', 'pipe', 'pipe'], shell: false, ...spawnOptions });
165
+ let out = '';
166
+ let err = '';
167
+ const t =
168
+ Number.isFinite(timeoutMs) && timeoutMs > 0
169
+ ? setTimeout(() => {
170
+ try {
171
+ proc.kill('SIGKILL');
172
+ } catch {
173
+ // ignore
174
+ }
175
+ const e = new Error(`${cmd} ${args.join(' ')} timed out after ${timeoutMs}ms`);
176
+ e.code = 'ETIMEDOUT';
177
+ e.out = out;
178
+ e.err = err;
179
+ rejectPromise(e);
180
+ }, timeoutMs)
181
+ : null;
182
+ proc.stdout?.on('data', (d) => (out += d.toString()));
183
+ proc.stderr?.on('data', (d) => (err += d.toString()));
184
+ proc.on('error', rejectPromise);
185
+ proc.on('exit', (code, signal) => {
186
+ if (t) clearTimeout(t);
187
+ if (code === 0) {
188
+ resolvePromise(out);
189
+ } else {
190
+ const e = new Error(
191
+ `${cmd} ${args.join(' ')} failed (code=${code ?? 'null'}, sig=${signal ?? 'null'}): ${err.trim()}`
192
+ );
193
+ e.code = 'EEXIT';
194
+ e.exitCode = code;
195
+ e.signal = signal;
196
+ e.out = out;
197
+ e.err = err;
198
+ rejectPromise(e);
199
+ }
200
+ });
201
+ });
202
+ }
203
+
204
+ export async function runCaptureResult(cmd, args, options = {}) {
205
+ const { timeoutMs, streamLabel, teeFile, teeLabel, input, heartbeatMs, ...spawnOptions } = options ?? {};
206
+ const startedAt = Date.now();
207
+ return await new Promise((resolvePromise) => {
208
+ const stdio = input != null ? ['pipe', 'pipe', 'pipe'] : ['ignore', 'pipe', 'pipe'];
209
+ const proc = spawn(cmd, args, { stdio, shell: false, ...spawnOptions });
210
+ let out = '';
211
+ let err = '';
212
+ const label = String(streamLabel ?? '').trim();
213
+ const shouldStream = Boolean(label);
214
+ const outState = { buf: '' };
215
+ const errState = { buf: '' };
216
+ const prefix = shouldStream ? `[${label}] ` : '';
217
+
218
+ const teePath = String(teeFile ?? '').trim();
219
+ const shouldTee = Boolean(teePath);
220
+ const teeOutState = { buf: '' };
221
+ const teeErrState = { buf: '' };
222
+ const teePrefix = (() => {
223
+ const t = String(teeLabel ?? '').trim();
224
+ if (t) return `[${t}] `;
225
+ if (label) return `[${label}] `;
226
+ return '';
227
+ })();
228
+ const teeStream = shouldTee ? createWriteStream(teePath, { flags: 'a' }) : null;
229
+ const keepaliveEveryMs = Number.isFinite(heartbeatMs) && heartbeatMs > 0 ? heartbeatMs : 0;
230
+
231
+ function writeKeepaliveLine(line) {
232
+ if (shouldStream) process.stdout.write(`${prefix}${line}\n`);
233
+ if (shouldTee && teeStream) teeStream.write(`${teePrefix}${line}\n`);
234
+ }
235
+
236
+ function resolveWith(res) {
237
+ if (shouldStream) {
238
+ flushPrefixed(process.stdout, prefix, outState);
239
+ flushPrefixed(process.stderr, prefix, errState);
240
+ }
241
+ if (shouldTee && teeStream) {
242
+ flushPrefixed(teeStream, teePrefix, teeOutState);
243
+ flushPrefixed(teeStream, teePrefix, teeErrState);
244
+ try {
245
+ teeStream.end();
246
+ } catch {
247
+ // ignore
248
+ }
249
+ }
250
+ resolvePromise(res);
251
+ }
252
+ const hb =
253
+ keepaliveEveryMs > 0
254
+ ? setInterval(() => {
255
+ const elapsedSec = Math.floor((Date.now() - startedAt) / 1000);
256
+ writeKeepaliveLine(`still running (elapsed ${elapsedSec}s, pid=${proc.pid})`);
257
+ }, keepaliveEveryMs)
258
+ : null;
259
+ const t =
260
+ Number.isFinite(timeoutMs) && timeoutMs > 0
261
+ ? setTimeout(() => {
262
+ try {
263
+ proc.kill('SIGKILL');
264
+ } catch {
265
+ // ignore
266
+ }
267
+ if (hb) clearInterval(hb);
268
+ resolveWith({
269
+ ok: false,
270
+ exitCode: null,
271
+ signal: null,
272
+ out,
273
+ err,
274
+ timedOut: true,
275
+ startedAt,
276
+ finishedAt: Date.now(),
277
+ durationMs: Date.now() - startedAt,
278
+ });
279
+ }, timeoutMs)
280
+ : null;
281
+ proc.stdout?.on('data', (d) => {
282
+ out += d.toString();
283
+ if (shouldStream) writeWithPrefix(process.stdout, prefix, outState, d);
284
+ if (shouldTee && teeStream) writeWithPrefix(teeStream, teePrefix, teeOutState, d);
285
+ });
286
+ proc.stderr?.on('data', (d) => {
287
+ err += d.toString();
288
+ if (shouldStream) writeWithPrefix(process.stderr, prefix, errState, d);
289
+ if (shouldTee && teeStream) writeWithPrefix(teeStream, teePrefix, teeErrState, d);
290
+ });
291
+
292
+ if (input != null && proc.stdin) {
293
+ try {
294
+ proc.stdin.write(String(input));
295
+ proc.stdin.end();
296
+ } catch {
297
+ // ignore
298
+ }
299
+ }
300
+ proc.on('error', (e) => {
301
+ if (t) clearTimeout(t);
302
+ if (hb) clearInterval(hb);
303
+ resolveWith({
304
+ ok: false,
305
+ exitCode: null,
306
+ signal: null,
307
+ out,
308
+ err: err + (err.endsWith('\n') || !err ? '' : '\n') + String(e) + '\n',
309
+ timedOut: false,
310
+ startedAt,
311
+ finishedAt: Date.now(),
312
+ durationMs: Date.now() - startedAt,
313
+ });
314
+ });
315
+ proc.on('close', (code, signal) => {
316
+ if (t) clearTimeout(t);
317
+ if (hb) clearInterval(hb);
318
+ resolveWith({
319
+ ok: code === 0,
320
+ exitCode: code,
321
+ signal: signal ?? null,
322
+ out,
323
+ err,
324
+ timedOut: false,
325
+ startedAt,
326
+ finishedAt: Date.now(),
327
+ durationMs: Date.now() - startedAt,
328
+ });
329
+ });
330
+ });
331
+ }
@@ -0,0 +1,85 @@
1
+ import test from 'node:test';
2
+ import assert from 'node:assert/strict';
3
+ import { mkdtemp, readFile, rm } from 'node:fs/promises';
4
+ import { tmpdir } from 'node:os';
5
+ import { join } from 'node:path';
6
+
7
+ import { runCaptureResult } from './proc.mjs';
8
+
9
+ async function withTempRoot(t) {
10
+ const root = await mkdtemp(join(tmpdir(), 'happy-proc-test-'));
11
+ t.after(async () => {
12
+ await rm(root, { recursive: true, force: true });
13
+ });
14
+ return root;
15
+ }
16
+
17
+ test('runCaptureResult captures stdout/stderr', async () => {
18
+ const res = await runCaptureResult(process.execPath, ['-e', 'console.log("hello"); console.error("oops")'], {
19
+ env: process.env,
20
+ });
21
+ assert.equal(res.ok, true);
22
+ assert.equal(res.exitCode, 0);
23
+ assert.match(res.out, /hello/);
24
+ assert.match(res.err, /oops/);
25
+ });
26
+
27
+ test('runCaptureResult streams output when streamLabel is set (without affecting captured output)', async (t) => {
28
+ const stdoutWrites = [];
29
+ const stderrWrites = [];
30
+ t.mock.method(process.stdout, 'write', (chunk) => {
31
+ stdoutWrites.push(String(chunk));
32
+ return true;
33
+ });
34
+ t.mock.method(process.stderr, 'write', (chunk) => {
35
+ stderrWrites.push(String(chunk));
36
+ return true;
37
+ });
38
+
39
+ const res = await runCaptureResult(process.execPath, ['-e', 'console.log("hello"); console.error("oops")'], {
40
+ env: process.env,
41
+ streamLabel: 'proc-test',
42
+ });
43
+ assert.equal(res.ok, true);
44
+ assert.equal(res.exitCode, 0);
45
+ assert.match(res.out, /hello/);
46
+ assert.match(res.err, /oops/);
47
+
48
+ const streamedOut = stdoutWrites.join('');
49
+ const streamedErr = stderrWrites.join('');
50
+ assert.match(streamedOut, /\[proc-test\] hello/);
51
+ assert.match(streamedErr, /\[proc-test\] oops/);
52
+ });
53
+
54
+ test('runCaptureResult can tee streamed output to a file', async (t) => {
55
+ const root = await withTempRoot(t);
56
+ const teeFile = join(root, 'tee.log');
57
+ const res = await runCaptureResult(process.execPath, ['-e', 'console.log("hello"); console.error("oops")'], {
58
+ env: process.env,
59
+ teeFile,
60
+ teeLabel: 'tee-test',
61
+ });
62
+ assert.equal(res.ok, true);
63
+ const raw = await readFile(teeFile, 'utf-8');
64
+ assert.match(raw, /\[tee-test\] hello/);
65
+ assert.match(raw, /\[tee-test\] oops/);
66
+ });
67
+
68
+ test('runCaptureResult emits periodic keepalive logs while process is running', async (t) => {
69
+ const root = await withTempRoot(t);
70
+ const teeFile = join(root, 'keepalive.log');
71
+ const res = await runCaptureResult(
72
+ process.execPath,
73
+ ['-e', 'setTimeout(() => { process.exit(0); }, 220);'],
74
+ {
75
+ env: process.env,
76
+ teeFile,
77
+ teeLabel: 'keepalive-test',
78
+ heartbeatMs: 50,
79
+ }
80
+ );
81
+ assert.equal(res.ok, true);
82
+ assert.equal(res.exitCode, 0);
83
+ const raw = await readFile(teeFile, 'utf-8');
84
+ assert.match(raw, /\[keepalive-test\] still running \(elapsed \d+s, pid=\d+\)/);
85
+ });
@@ -0,0 +1,69 @@
1
+ import { isPidAlive } from './pids.mjs';
2
+
3
+ function nowMs() {
4
+ return Date.now();
5
+ }
6
+
7
+ async function waitForExit(pid, timeoutMs) {
8
+ const end = nowMs() + Math.max(0, Number(timeoutMs) || 0);
9
+ while (nowMs() < end) {
10
+ if (!isTargetAlive(pid)) return true;
11
+ // eslint-disable-next-line no-await-in-loop
12
+ await new Promise((r) => setTimeout(r, 40));
13
+ }
14
+ return !isTargetAlive(pid);
15
+ }
16
+
17
+ function killGroup(pid, signal) {
18
+ if (!pid || pid <= 1) return;
19
+ try {
20
+ if (process.platform !== 'win32') process.kill(-pid, signal);
21
+ else {
22
+ // Windows doesn't implement POSIX signal semantics; process.kill(pid, SIGINT/SIGTERM)
23
+ // targets the single process and may terminate it immediately instead of graceful group shutdown.
24
+ process.kill(pid, signal);
25
+ }
26
+ } catch {
27
+ // ignore
28
+ }
29
+ }
30
+
31
+ function isTargetAlive(pid) {
32
+ if (!pid || pid <= 1) return false;
33
+ if (process.platform === 'win32') {
34
+ return isPidAlive(pid);
35
+ }
36
+ try {
37
+ process.kill(-pid, 0);
38
+ return true;
39
+ } catch (e) {
40
+ return e?.code === 'EPERM';
41
+ }
42
+ }
43
+
44
+ function normalizeStartSignal(signal) {
45
+ const s = String(signal ?? '').trim().toUpperCase();
46
+ if (s === 'SIGINT' || s === 'SIGTERM' || s === 'SIGKILL') return s;
47
+ return 'SIGINT';
48
+ }
49
+
50
+ export async function terminateProcessGroup(pid, { graceMs = 800, signal = 'SIGINT' } = {}) {
51
+ const n = Number(pid);
52
+ if (!Number.isFinite(n) || n <= 1) return { ok: false, reason: 'bad_pid' };
53
+ if (!isTargetAlive(n)) return { ok: true, alreadyExited: true };
54
+
55
+ const perSignalMs = Math.max(50, Number(graceMs) || 0);
56
+ const startSignal = normalizeStartSignal(signal);
57
+ const sequence = [startSignal, 'SIGINT', 'SIGTERM', 'SIGKILL'].filter(
58
+ (sig, index, arr) => arr.indexOf(sig) === index
59
+ );
60
+
61
+ for (const sig of sequence) {
62
+ killGroup(n, sig);
63
+ // eslint-disable-next-line no-await-in-loop
64
+ const exited = await waitForExit(n, sig === 'SIGKILL' ? Math.min(400, perSignalMs) : perSignalMs);
65
+ if (exited) return { ok: true, signal: sig };
66
+ }
67
+
68
+ return { ok: !isTargetAlive(n), signal: 'SIGKILL' };
69
+ }
@@ -0,0 +1,54 @@
1
+ import test from 'node:test';
2
+ import assert from 'node:assert/strict';
3
+ import { spawn } from 'node:child_process';
4
+
5
+ import { isPidAlive } from './pids.mjs';
6
+ import { terminateProcessGroup } from './terminate.mjs';
7
+
8
+ async function waitForPidExit(pid, timeoutMs) {
9
+ const end = Date.now() + Math.max(0, Number(timeoutMs) || 0);
10
+ while (Date.now() < end) {
11
+ if (!isPidAlive(pid)) return;
12
+ // eslint-disable-next-line no-await-in-loop
13
+ await new Promise((r) => setTimeout(r, 30));
14
+ }
15
+ throw new Error(`timed out waiting for pid ${pid} to exit`);
16
+ }
17
+
18
+ test('terminateProcessGroup escalates to SIGKILL when child ignores SIGINT/SIGTERM', async (t) => {
19
+ if (process.platform === 'win32') {
20
+ t.skip('POSIX process-group signaling semantics');
21
+ return;
22
+ }
23
+
24
+ const child = spawn(
25
+ process.execPath,
26
+ [
27
+ '-e',
28
+ [
29
+ "process.on('SIGINT', () => {});",
30
+ "process.on('SIGTERM', () => {});",
31
+ 'setInterval(() => {}, 1000);',
32
+ ].join(' '),
33
+ ],
34
+ { stdio: 'ignore', detached: true }
35
+ );
36
+ child.unref();
37
+ try {
38
+ assert.ok(child.pid && child.pid > 1, 'expected child pid');
39
+ assert.ok(isPidAlive(child.pid), 'expected child to be alive');
40
+
41
+ const res = await terminateProcessGroup(child.pid, { graceMs: 120 });
42
+ assert.equal(res.ok, true, `expected terminate ok, got ${JSON.stringify(res)}`);
43
+
44
+ await waitForPidExit(child.pid, 1200);
45
+ } finally {
46
+ if (child.pid && isPidAlive(child.pid)) {
47
+ try {
48
+ child.kill('SIGKILL');
49
+ } catch {
50
+ // best effort
51
+ }
52
+ }
53
+ }
54
+ });
@@ -0,0 +1,63 @@
1
+ import { watch } from 'node:fs';
2
+
3
+ function safeWatch(path, handler) {
4
+ try {
5
+ // Node supports recursive watching on macOS and Windows. On Linux this may throw; we fail closed by returning null.
6
+ return watch(path, { recursive: true }, handler);
7
+ } catch {
8
+ try {
9
+ return watch(path, {}, handler);
10
+ } catch {
11
+ return null;
12
+ }
13
+ }
14
+ }
15
+
16
+ /**
17
+ * Very small, dependency-free debounced watcher.
18
+ * Intended for dev ergonomics (rebuild/restart), not for correctness-critical logic.
19
+ */
20
+ export function watchDebounced({ paths, debounceMs = 500, onChange } = {}) {
21
+ const list = Array.isArray(paths) ? paths.filter(Boolean) : [];
22
+ if (!list.length) return null;
23
+ if (typeof onChange !== 'function') return null;
24
+
25
+ let closed = false;
26
+ let t = null;
27
+ const watchers = [];
28
+
29
+ const trigger = (eventType, filename) => {
30
+ if (closed) return;
31
+ if (t) clearTimeout(t);
32
+ t = setTimeout(() => {
33
+ t = null;
34
+ try {
35
+ onChange({ eventType, filename });
36
+ } catch {
37
+ // ignore
38
+ }
39
+ }, debounceMs);
40
+ };
41
+
42
+ for (const p of list) {
43
+ const w = safeWatch(p, trigger);
44
+ if (w) watchers.push(w);
45
+ }
46
+
47
+ if (!watchers.length) return null;
48
+
49
+ return {
50
+ close() {
51
+ closed = true;
52
+ if (t) clearTimeout(t);
53
+ for (const w of watchers) {
54
+ try {
55
+ w.close();
56
+ } catch {
57
+ // ignore
58
+ }
59
+ }
60
+ },
61
+ };
62
+ }
63
+
@@ -0,0 +1,105 @@
1
+ import test from 'node:test';
2
+ import assert from 'node:assert/strict';
3
+ import fs from 'node:fs';
4
+ import os from 'node:os';
5
+ import path from 'node:path';
6
+ import { spawnSync } from 'node:child_process';
7
+ import { fileURLToPath } from 'node:url';
8
+
9
+ function resolveRepoRoot() {
10
+ // This test must run from anywhere (repo root, package root, CI, etc.).
11
+ // Derive monorepo root from this file path to avoid cwd-sensitive failures.
12
+ const here = path.dirname(fileURLToPath(import.meta.url));
13
+ return path.resolve(here, '..', '..', '..', '..', '..');
14
+ }
15
+
16
+ test('review script provides a non-empty prompt to augment in normal uncommitted mode', () => {
17
+ const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'happier-review-auggie-'));
18
+ const binDir = path.join(tmp, 'bin');
19
+ fs.mkdirSync(binDir, { recursive: true });
20
+
21
+ const auggiePath = path.join(binDir, 'auggie');
22
+ fs.writeFileSync(
23
+ auggiePath,
24
+ `#!/usr/bin/env node
25
+ const args = process.argv.slice(2);
26
+ const last = args[args.length - 1] ?? '';
27
+ if (!String(last).trim()) {
28
+ console.error('missing instruction');
29
+ process.exit(2);
30
+ }
31
+ process.stdout.write('ok\\n\\n===FINDINGS_JSON===\\n[]\\n');
32
+ `,
33
+ { mode: 0o755 }
34
+ );
35
+
36
+ const repoRoot = resolveRepoRoot();
37
+ const env = {
38
+ ...process.env,
39
+ // Ensure our stub is used.
40
+ PATH: `${binDir}${path.delimiter}${process.env.PATH ?? ''}`,
41
+ // Keep Augment cache writes out of the repo.
42
+ HAPPIER_STACK_AUGMENT_CACHE_DIR: path.join(tmp, 'augment-home'),
43
+ HAPPIER_STACK_REPO_DIR: repoRoot,
44
+ };
45
+
46
+ const res = spawnSync(
47
+ process.execPath,
48
+ [
49
+ path.join(repoRoot, 'apps', 'stack', 'scripts', 'review.mjs'),
50
+ 'all',
51
+ '--reviewers=augment',
52
+ '--type=uncommitted',
53
+ '--depth=normal',
54
+ '--no-chunks',
55
+ '--no-stream',
56
+ '--run-label=test-augment-normal-uncommitted',
57
+ ],
58
+ { cwd: repoRoot, env, encoding: 'utf8' }
59
+ );
60
+
61
+ assert.equal(res.status, 0, `expected exit 0; stderr:\n${res.stderr}\nstdout:\n${res.stdout}`);
62
+ });
63
+
64
+ test('review script infers repo dir from cwd even when target positionals are provided', () => {
65
+ const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'happier-review-auggie-'));
66
+ const binDir = path.join(tmp, 'bin');
67
+ fs.mkdirSync(binDir, { recursive: true });
68
+
69
+ const auggiePath = path.join(binDir, 'auggie');
70
+ fs.writeFileSync(
71
+ auggiePath,
72
+ `#!/usr/bin/env node
73
+ process.stdout.write('ok\\n\\n===FINDINGS_JSON===\\n[]\\n');
74
+ `,
75
+ { mode: 0o755 }
76
+ );
77
+
78
+ const repoRoot = resolveRepoRoot();
79
+ const env = {
80
+ ...process.env,
81
+ PATH: `${binDir}${path.delimiter}${process.env.PATH ?? ''}`,
82
+ HAPPIER_STACK_AUGMENT_CACHE_DIR: path.join(tmp, 'augment-home'),
83
+ // Do NOT set HAPPIER_STACK_REPO_DIR here; we want it inferred from cwd.
84
+ };
85
+
86
+ const res = spawnSync(
87
+ process.execPath,
88
+ [
89
+ path.join(repoRoot, 'apps', 'stack', 'scripts', 'review.mjs'),
90
+ 'all',
91
+ '--reviewers=augment',
92
+ '--type=uncommitted',
93
+ '--depth=normal',
94
+ '--no-chunks',
95
+ '--run-label=test-augment-repo-infer-with-positionals',
96
+ ],
97
+ { cwd: repoRoot, env, encoding: 'utf8' }
98
+ );
99
+
100
+ assert.equal(res.status, 0, `expected exit 0; stderr:\n${res.stderr}\nstdout:\n${res.stdout}`);
101
+ const repoRootPattern = repoRoot
102
+ .replaceAll('\\', '\\\\')
103
+ .replace(/^\/private/, '(?:\\/private)?');
104
+ assert.match(res.stdout, new RegExp(`\\[review\\] monorepo detected at ${repoRootPattern}`));
105
+ });