@minionry/minion 0.7.36

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 (476) hide show
  1. package/LICENSE +14 -0
  2. package/PRIVACY.md +357 -0
  3. package/README.md +57 -0
  4. package/THIRD_PARTY_NOTICES.md +245 -0
  5. package/bin/branding.js +4 -0
  6. package/bin/commands/browser-install.js +483 -0
  7. package/bin/commands/create-sandbox.js +542 -0
  8. package/bin/commands/fingerprint.js +101 -0
  9. package/bin/commands/login.js +400 -0
  10. package/bin/commands/logout.js +93 -0
  11. package/bin/commands/minions.js +211 -0
  12. package/bin/commands/sandboxes.js +309 -0
  13. package/bin/commands/status.js +298 -0
  14. package/bin/commands/whoami.js +153 -0
  15. package/bin/launch-env.js +35 -0
  16. package/bin/machine-identity.js +221 -0
  17. package/bin/machine-layout.js +200 -0
  18. package/bin/minion.js +839 -0
  19. package/bin/platform-endpoints.js +8 -0
  20. package/bin/postinstall.js +52 -0
  21. package/bin/pty-doctor.js +326 -0
  22. package/bin/pty-locator.js +110 -0
  23. package/bin/pty-provision.js +186 -0
  24. package/bin/sandbox/Dockerfile +78 -0
  25. package/bin/sandbox/entrypoint.sh +14 -0
  26. package/bin/sandbox/install-repo.sh +53 -0
  27. package/bin/sandbox/seccomp-userns.json +883 -0
  28. package/bin/sandbox-config.js +306 -0
  29. package/dist/bin/machine-identity.js +221 -0
  30. package/dist/bin/machine-layout.js +200 -0
  31. package/dist/electron-host/agent-lease.js +141 -0
  32. package/dist/electron-host/dom-driver.js +642 -0
  33. package/dist/electron-host/ipc-protocol.js +89 -0
  34. package/dist/electron-host/js-driver.js +216 -0
  35. package/dist/electron-host/view-manager.js +254 -0
  36. package/dist/server/cli/engine-resume.js +49 -0
  37. package/dist/server/cli/eta-estimator.js +278 -0
  38. package/dist/server/cli/headless/background-activity.js +109 -0
  39. package/dist/server/cli/headless/claude-invoker-process.js +614 -0
  40. package/dist/server/cli/headless/claude-invoker-stall.js +150 -0
  41. package/dist/server/cli/headless/claude-invoker-stream.js +555 -0
  42. package/dist/server/cli/headless/claude-invoker-tools.js +148 -0
  43. package/dist/server/cli/headless/claude-invoker.js +151 -0
  44. package/dist/server/cli/headless/engine-availability.js +92 -0
  45. package/dist/server/cli/headless/engine-notice.js +185 -0
  46. package/dist/server/cli/headless/haiku-assessments.js +293 -0
  47. package/dist/server/cli/headless/headless-logger.js +75 -0
  48. package/dist/server/cli/headless/index.js +9 -0
  49. package/dist/server/cli/headless/mcp-config.js +314 -0
  50. package/dist/server/cli/headless/native-timeout-detector.js +72 -0
  51. package/dist/server/cli/headless/output-utils.js +71 -0
  52. package/dist/server/cli/headless/prompt-utils.js +82 -0
  53. package/dist/server/cli/headless/resilient-runner.js +326 -0
  54. package/dist/server/cli/headless/retry-strategies.js +292 -0
  55. package/dist/server/cli/headless/runner.js +245 -0
  56. package/dist/server/cli/headless/stall-assessor.js +295 -0
  57. package/dist/server/cli/headless/tool-watchdog.js +447 -0
  58. package/dist/server/cli/headless/types.js +18 -0
  59. package/dist/server/cli/history-portability.js +85 -0
  60. package/dist/server/cli/improvisation-attachments.js +99 -0
  61. package/dist/server/cli/improvisation-history-store.js +121 -0
  62. package/dist/server/cli/improvisation-movements.js +137 -0
  63. package/dist/server/cli/improvisation-output-queue.js +34 -0
  64. package/dist/server/cli/improvisation-retry.js +8 -0
  65. package/dist/server/cli/improvisation-session-manager.js +1016 -0
  66. package/dist/server/cli/improvisation-types.js +31 -0
  67. package/dist/server/cli/plan-lifecycle.js +72 -0
  68. package/dist/server/cli/prompt-builders.js +371 -0
  69. package/dist/server/cli/retry/retry-best-result.js +28 -0
  70. package/dist/server/cli/retry/retry-context-loss.js +75 -0
  71. package/dist/server/cli/retry/retry-recovery-strategies.js +213 -0
  72. package/dist/server/cli/retry/retry-resume-strategy.js +20 -0
  73. package/dist/server/cli/retry/retry-runner-factory.js +92 -0
  74. package/dist/server/cli/retry/retry-tool-results.js +22 -0
  75. package/dist/server/cli/retry/retry-types.js +3 -0
  76. package/dist/server/engines/EngineEvent.js +57 -0
  77. package/dist/server/engines/claude/ClaudeCodeEngine.js +316 -0
  78. package/dist/server/engines/claude/claude-command.js +32 -0
  79. package/dist/server/engines/codex/CodexEngine.js +469 -0
  80. package/dist/server/engines/codex/codex-auth.js +203 -0
  81. package/dist/server/engines/codex/codex-invoker.js +205 -0
  82. package/dist/server/engines/codex/codex-provision.js +215 -0
  83. package/dist/server/engines/credentials/credential-probe.js +88 -0
  84. package/dist/server/engines/credentials/model-profiles.js +249 -0
  85. package/dist/server/engines/credentials/provider-credentials.js +146 -0
  86. package/dist/server/engines/engine-event-stream.js +52 -0
  87. package/dist/server/engines/execution/engine-session.js +380 -0
  88. package/dist/server/engines/factory.js +42 -0
  89. package/dist/server/engines/hermes/HermesEngine.js +628 -0
  90. package/dist/server/engines/hermes/hermes-auth.js +159 -0
  91. package/dist/server/engines/hermes/hermes-gateway-home.js +271 -0
  92. package/dist/server/engines/hermes/hermes-invoker.js +350 -0
  93. package/dist/server/engines/hermes/hermes-provision.js +318 -0
  94. package/dist/server/engines/read-only.js +20 -0
  95. package/dist/server/engines/types.js +27 -0
  96. package/dist/server/handlers/company-execution-registry.js +67 -0
  97. package/dist/server/handlers/company-handlers.js +514 -0
  98. package/dist/server/handlers/company-triggers.js +189 -0
  99. package/dist/server/handlers/company-types.js +3 -0
  100. package/dist/server/index.js +244 -0
  101. package/dist/server/mcp/app-tools-bridge.js +110 -0
  102. package/dist/server/mcp/app-tools-mcp-server.js +99 -0
  103. package/dist/server/mcp/bouncer-integration.js +744 -0
  104. package/dist/server/mcp/browser-mcp-server.js +915 -0
  105. package/dist/server/mcp/browser-redaction.js +103 -0
  106. package/dist/server/mcp/classifier/BouncerClassifier.js +3 -0
  107. package/dist/server/mcp/classifier/ClaudeBouncerClassifier.js +212 -0
  108. package/dist/server/mcp/classifier/factory.js +124 -0
  109. package/dist/server/mcp/classifier/health.js +54 -0
  110. package/dist/server/mcp/classifier/telemetry.js +0 -0
  111. package/dist/server/mcp/company-patterns.js +104 -0
  112. package/dist/server/mcp/department-profiles.js +133 -0
  113. package/dist/server/mcp/quality-bridge.js +153 -0
  114. package/dist/server/mcp/quality-mcp-server.js +105 -0
  115. package/dist/server/mcp/security-analysis.js +384 -0
  116. package/dist/server/mcp/security-audit.js +152 -0
  117. package/dist/server/mcp/security-patterns.js +314 -0
  118. package/dist/server/mcp/server.js +194 -0
  119. package/dist/server/mcp/test-utils/agent-simulator.js +301 -0
  120. package/dist/server/mcp/test-utils/e2e-agent.js +103 -0
  121. package/dist/server/mcp/test-utils/e2e-capture.js +92 -0
  122. package/dist/server/mcp/test-utils/e2e-client.js +116 -0
  123. package/dist/server/mcp/test-utils/e2e-fixtures.js +87 -0
  124. package/dist/server/mcp/test-utils/e2e-gating.js +8 -0
  125. package/dist/server/mcp/test-utils/e2e-harness.js +8 -0
  126. package/dist/server/mcp/test-utils/e2e-scenarios.js +105 -0
  127. package/dist/server/routes/files.js +18 -0
  128. package/dist/server/routes/improvise.js +64 -0
  129. package/dist/server/routes/index.js +7 -0
  130. package/dist/server/routes/instances.js +41 -0
  131. package/dist/server/routes/internal.js +900 -0
  132. package/dist/server/routes/notifications.js +110 -0
  133. package/dist/server/server-setup.js +282 -0
  134. package/dist/server/services/agent-push.js +148 -0
  135. package/dist/server/services/analytics.js +197 -0
  136. package/dist/server/services/apps/build.js +249 -0
  137. package/dist/server/services/apps/greenlight.js +199 -0
  138. package/dist/server/services/apps/install.js +101 -0
  139. package/dist/server/services/apps/layout.js +35 -0
  140. package/dist/server/services/apps/serve.js +665 -0
  141. package/dist/server/services/apps/space-apps.js +248 -0
  142. package/dist/server/services/auth.js +48 -0
  143. package/dist/server/services/browser/chrome-sandbox.js +245 -0
  144. package/dist/server/services/browser/chromium-launch-spec.js +51 -0
  145. package/dist/server/services/browser/claude-reasoner.js +669 -0
  146. package/dist/server/services/browser/debug-log.js +3 -0
  147. package/dist/server/services/browser/driver-state.js +546 -0
  148. package/dist/server/services/browser/electron-provision.js +256 -0
  149. package/dist/server/services/browser/host-internal.js +245 -0
  150. package/dist/server/services/browser/host-mock.js +334 -0
  151. package/dist/server/services/browser/host-types.js +3 -0
  152. package/dist/server/services/browser/host.js +1067 -0
  153. package/dist/server/services/browser/index.js +4 -0
  154. package/dist/server/services/browser/ipc-client.js +354 -0
  155. package/dist/server/services/browser/pipewire-sink.js +199 -0
  156. package/dist/server/services/browser/preflight.js +590 -0
  157. package/dist/server/services/browser/reasoning-agent.js +659 -0
  158. package/dist/server/services/browser/sandbox-policy.js +169 -0
  159. package/dist/server/services/browser/stderr-noise-filter.js +26 -0
  160. package/dist/server/services/browser/telemetry.js +107 -0
  161. package/dist/server/services/browser/xvfb-supervisor.js +139 -0
  162. package/dist/server/services/browser-frame-policy.js +56 -0
  163. package/dist/server/services/client-id.js +32 -0
  164. package/dist/server/services/collab/registry.js +408 -0
  165. package/dist/server/services/collab/session.js +489 -0
  166. package/dist/server/services/collab/text-diff.js +28 -0
  167. package/dist/server/services/collab/types.js +19 -0
  168. package/dist/server/services/e2ee-group-key.js +197 -0
  169. package/dist/server/services/e2ee-identity.js +203 -0
  170. package/dist/server/services/file-explorer-ops.js +328 -0
  171. package/dist/server/services/file-transfer-zip.js +188 -0
  172. package/dist/server/services/files.js +111 -0
  173. package/dist/server/services/git/branch-ops.js +62 -0
  174. package/dist/server/services/git/command.js +68 -0
  175. package/dist/server/services/git/commit-message.js +74 -0
  176. package/dist/server/services/git/diff-ops.js +56 -0
  177. package/dist/server/services/git/haiku.js +76 -0
  178. package/dist/server/services/git/head-watcher.js +226 -0
  179. package/dist/server/services/git/index.js +17 -0
  180. package/dist/server/services/git/log-ops.js +98 -0
  181. package/dist/server/services/git/merge-ops.js +314 -0
  182. package/dist/server/services/git/parsers.js +401 -0
  183. package/dist/server/services/git/remote-ops.js +192 -0
  184. package/dist/server/services/git/status-ops.js +105 -0
  185. package/dist/server/services/git/suggestion-ops.js +80 -0
  186. package/dist/server/services/git/tag-ops.js +36 -0
  187. package/dist/server/services/git/types.js +4 -0
  188. package/dist/server/services/git/worktree-ops.js +114 -0
  189. package/dist/server/services/instances.js +337 -0
  190. package/dist/server/services/model-catalog.js +247 -0
  191. package/dist/server/services/observability/posthog.js +153 -0
  192. package/dist/server/services/pathUtils.js +114 -0
  193. package/dist/server/services/plan/agent-loader.js +97 -0
  194. package/dist/server/services/plan/agent-manager.js +363 -0
  195. package/dist/server/services/plan/agent-resolver.js +74 -0
  196. package/dist/server/services/plan/agents/assess-stall.md +33 -0
  197. package/dist/server/services/plan/agents/browser-planner.md +53 -0
  198. package/dist/server/services/plan/agents/browser-reasoner.md +114 -0
  199. package/dist/server/services/plan/agents/check-injection.md +95 -0
  200. package/dist/server/services/plan/agents/classify-error.md +30 -0
  201. package/dist/server/services/plan/agents/code-review.md +142 -0
  202. package/dist/server/services/plan/agents/commit-message.md +28 -0
  203. package/dist/server/services/plan/agents/detect-context-loss.md +30 -0
  204. package/dist/server/services/plan/agents/execute-issue.md +58 -0
  205. package/dist/server/services/plan/agents/fix-quality.md +25 -0
  206. package/dist/server/services/plan/agents/plan-coordinator.md +72 -0
  207. package/dist/server/services/plan/agents/pr-description.md +29 -0
  208. package/dist/server/services/plan/agents/retry-task.md +27 -0
  209. package/dist/server/services/plan/agents/review-code.md +38 -0
  210. package/dist/server/services/plan/agents/review-quality.md +45 -0
  211. package/dist/server/services/plan/agents/triage-findings.md +78 -0
  212. package/dist/server/services/plan/agents/verify-review.md +57 -0
  213. package/dist/server/services/plan/approval-evaluator.js +143 -0
  214. package/dist/server/services/plan/board-archive.js +102 -0
  215. package/dist/server/services/plan/board-config.js +108 -0
  216. package/dist/server/services/plan/board-export.js +214 -0
  217. package/dist/server/services/plan/composer-prompt.js +115 -0
  218. package/dist/server/services/plan/composer.js +664 -0
  219. package/dist/server/services/plan/config-installer.js +103 -0
  220. package/dist/server/services/plan/dependency-resolver.js +137 -0
  221. package/dist/server/services/plan/executor.js +696 -0
  222. package/dist/server/services/plan/front-matter.js +43 -0
  223. package/dist/server/services/plan/issue-classification.js +10 -0
  224. package/dist/server/services/plan/issue-effort.js +182 -0
  225. package/dist/server/services/plan/issue-loader.js +35 -0
  226. package/dist/server/services/plan/issue-prompt-builder.js +152 -0
  227. package/dist/server/services/plan/issue-retry.js +42 -0
  228. package/dist/server/services/plan/issue-writer.js +102 -0
  229. package/dist/server/services/plan/metrics-collector.js +272 -0
  230. package/dist/server/services/plan/output-manager.js +77 -0
  231. package/dist/server/services/plan/parser-core.js +435 -0
  232. package/dist/server/services/plan/parser-migration.js +108 -0
  233. package/dist/server/services/plan/parser.js +258 -0
  234. package/dist/server/services/plan/plan-runner-factory.js +68 -0
  235. package/dist/server/services/plan/pm-timeline.js +320 -0
  236. package/dist/server/services/plan/progress-log.js +101 -0
  237. package/dist/server/services/plan/prompt-builder.js +142 -0
  238. package/dist/server/services/plan/quality-delta.js +274 -0
  239. package/dist/server/services/plan/readiness-planner.js +34 -0
  240. package/dist/server/services/plan/review-gate.js +409 -0
  241. package/dist/server/services/plan/review-report.js +134 -0
  242. package/dist/server/services/plan/review-verdict-stream.js +161 -0
  243. package/dist/server/services/plan/state-reconciler.js +238 -0
  244. package/dist/server/services/plan/template-diff.js +175 -0
  245. package/dist/server/services/plan/template-instantiator.js +516 -0
  246. package/dist/server/services/plan/template-manifest.js +56 -0
  247. package/dist/server/services/plan/template-types.js +3 -0
  248. package/dist/server/services/plan/trigger-evaluator.js +211 -0
  249. package/dist/server/services/plan/types.js +3 -0
  250. package/dist/server/services/plan/watcher.js +73 -0
  251. package/dist/server/services/platform-credentials.js +56 -0
  252. package/dist/server/services/platform-e2ee.js +421 -0
  253. package/dist/server/services/platform-envelope.js +102 -0
  254. package/dist/server/services/platform-heartbeat.js +88 -0
  255. package/dist/server/services/platform-reconnect.js +60 -0
  256. package/dist/server/services/platform-token-lifecycle.js +95 -0
  257. package/dist/server/services/platform-url.js +17 -0
  258. package/dist/server/services/platform.js +656 -0
  259. package/dist/server/services/runtime-info.js +9 -0
  260. package/dist/server/services/schedule/agent-schedule-store.js +232 -0
  261. package/dist/server/services/schedule/agent-scheduler.js +323 -0
  262. package/dist/server/services/schedule/daily-timing.js +105 -0
  263. package/dist/server/services/schedule/quality-schedule-launch.js +11 -0
  264. package/dist/server/services/schedule/quality-schedule-store.js +211 -0
  265. package/dist/server/services/schedule/quality-scheduler.js +215 -0
  266. package/dist/server/services/schedule/run-bootstrap.js +329 -0
  267. package/dist/server/services/schedule/schedule-store.js +238 -0
  268. package/dist/server/services/schedule/schedule-wire.js +77 -0
  269. package/dist/server/services/schedule/scheduler.js +310 -0
  270. package/dist/server/services/schedule/template-source.js +97 -0
  271. package/dist/server/services/sdk/agent-sessions.js +264 -0
  272. package/dist/server/services/sdk/agents.js +557 -0
  273. package/dist/server/services/sdk/app-endpoints.js +48 -0
  274. package/dist/server/services/sdk/app-tools.js +303 -0
  275. package/dist/server/services/sdk/audit.js +48 -0
  276. package/dist/server/services/sdk/browser-transport.js +188 -0
  277. package/dist/server/services/sdk/browser.js +605 -0
  278. package/dist/server/services/sdk/composer.js +129 -0
  279. package/dist/server/services/sdk/connect.js +273 -0
  280. package/dist/server/services/sdk/consent-cooldown.js +31 -0
  281. package/dist/server/services/sdk/endpoint-url.js +141 -0
  282. package/dist/server/services/sdk/endpoints.js +314 -0
  283. package/dist/server/services/sdk/file-change-notify.js +36 -0
  284. package/dist/server/services/sdk/files-app.js +163 -0
  285. package/dist/server/services/sdk/files-search.js +131 -0
  286. package/dist/server/services/sdk/files-transfer.js +279 -0
  287. package/dist/server/services/sdk/files-workspace.js +233 -0
  288. package/dist/server/services/sdk/git.js +520 -0
  289. package/dist/server/services/sdk/grant-store.js +318 -0
  290. package/dist/server/services/sdk/host-ops.js +84 -0
  291. package/dist/server/services/sdk/inference-claude.js +214 -0
  292. package/dist/server/services/sdk/inference.js +247 -0
  293. package/dist/server/services/sdk/live-registry.js +42 -0
  294. package/dist/server/services/sdk/local-app-bindings.js +71 -0
  295. package/dist/server/services/sdk/pipeline.js +190 -0
  296. package/dist/server/services/sdk/pm-execute.js +228 -0
  297. package/dist/server/services/sdk/pm-planning-tap.js +29 -0
  298. package/dist/server/services/sdk/pm-schedule.js +165 -0
  299. package/dist/server/services/sdk/pm.js +634 -0
  300. package/dist/server/services/sdk/quality-change-notify.js +20 -0
  301. package/dist/server/services/sdk/quality-schedule.js +165 -0
  302. package/dist/server/services/sdk/quality.js +602 -0
  303. package/dist/server/services/sdk/rate-limits.js +198 -0
  304. package/dist/server/services/sdk/registry.js +597 -0
  305. package/dist/server/services/sdk/revoke.js +86 -0
  306. package/dist/server/services/sdk/run-profile.js +41 -0
  307. package/dist/server/services/sdk/sandbox.js +89 -0
  308. package/dist/server/services/sdk/storage.js +110 -0
  309. package/dist/server/services/sdk/streams.js +147 -0
  310. package/dist/server/services/sdk/terminal.js +201 -0
  311. package/dist/server/services/sdk/test-utils/workshop-browser-app.js +466 -0
  312. package/dist/server/services/sentry.js +99 -0
  313. package/dist/server/services/settings.js +374 -0
  314. package/dist/server/services/snippets/expander.js +87 -0
  315. package/dist/server/services/snippets/index.js +6 -0
  316. package/dist/server/services/snippets/loader.js +119 -0
  317. package/dist/server/services/snippets/parser.js +52 -0
  318. package/dist/server/services/snippets/types.js +3 -0
  319. package/dist/server/services/snippets/watcher.js +60 -0
  320. package/dist/server/services/space-layout.js +80 -0
  321. package/dist/server/services/system-prompts.js +219 -0
  322. package/dist/server/services/terminal/pty-manager.js +206 -0
  323. package/dist/server/services/terminal/pty-utils.js +150 -0
  324. package/dist/server/services/timeline/assembler.js +890 -0
  325. package/dist/server/services/timeline/contract.js +196 -0
  326. package/dist/server/services/timeline/index.js +4 -0
  327. package/dist/server/services/websocket/agent-schedule-handlers.js +217 -0
  328. package/dist/server/services/websocket/apps-handlers.js +399 -0
  329. package/dist/server/services/websocket/ask-user-question-bridge.js +112 -0
  330. package/dist/server/services/websocket/autocomplete-index.js +415 -0
  331. package/dist/server/services/websocket/autocomplete-match.js +243 -0
  332. package/dist/server/services/websocket/autocomplete.js +407 -0
  333. package/dist/server/services/websocket/browser-agent-runtime.js +208 -0
  334. package/dist/server/services/websocket/browser-device-profile.js +46 -0
  335. package/dist/server/services/websocket/browser-handlers.js +377 -0
  336. package/dist/server/services/websocket/browser-host-broadcast.js +179 -0
  337. package/dist/server/services/websocket/browser-ice-config.js +121 -0
  338. package/dist/server/services/websocket/browser-payloads.js +222 -0
  339. package/dist/server/services/websocket/browser-viewer-lifecycle.js +84 -0
  340. package/dist/server/services/websocket/browser-viewer-registry.js +118 -0
  341. package/dist/server/services/websocket/collab-broadcast.js +11 -0
  342. package/dist/server/services/websocket/collab-handlers.js +116 -0
  343. package/dist/server/services/websocket/commit-suggestion-service.js +132 -0
  344. package/dist/server/services/websocket/debug-log.js +38 -0
  345. package/dist/server/services/websocket/dispatch-util.js +10 -0
  346. package/dist/server/services/websocket/engine-auth-handlers.js +323 -0
  347. package/dist/server/services/websocket/engine-credential-watcher.js +83 -0
  348. package/dist/server/services/websocket/engine-profile-handlers.js +92 -0
  349. package/dist/server/services/websocket/file-definition-handlers.js +180 -0
  350. package/dist/server/services/websocket/file-download-handler.js +291 -0
  351. package/dist/server/services/websocket/file-explorer-handlers.js +291 -0
  352. package/dist/server/services/websocket/file-search-handlers.js +267 -0
  353. package/dist/server/services/websocket/file-share-handlers.js +328 -0
  354. package/dist/server/services/websocket/file-transfer-http.js +361 -0
  355. package/dist/server/services/websocket/file-upload-handler.js +267 -0
  356. package/dist/server/services/websocket/file-utils.js +346 -0
  357. package/dist/server/services/websocket/git-branch-handlers.js +90 -0
  358. package/dist/server/services/websocket/git-diff-handlers.js +59 -0
  359. package/dist/server/services/websocket/git-handlers.js +212 -0
  360. package/dist/server/services/websocket/git-head-watcher.js +85 -0
  361. package/dist/server/services/websocket/git-log-handlers.js +104 -0
  362. package/dist/server/services/websocket/git-pr-handlers.js +56 -0
  363. package/dist/server/services/websocket/git-tag-handlers.js +53 -0
  364. package/dist/server/services/websocket/git-utils.js +11 -0
  365. package/dist/server/services/websocket/git-worktree-handlers.js +521 -0
  366. package/dist/server/services/websocket/handler-context.js +113 -0
  367. package/dist/server/services/websocket/handler.js +1197 -0
  368. package/dist/server/services/websocket/index.js +5 -0
  369. package/dist/server/services/websocket/movement-written-files.js +26 -0
  370. package/dist/server/services/websocket/msg-id-tracker.js +48 -0
  371. package/dist/server/services/websocket/plan-board-handlers.js +410 -0
  372. package/dist/server/services/websocket/plan-execution-handlers.js +244 -0
  373. package/dist/server/services/websocket/plan-handlers.js +67 -0
  374. package/dist/server/services/websocket/plan-helpers.js +161 -0
  375. package/dist/server/services/websocket/plan-issue-handlers.js +168 -0
  376. package/dist/server/services/websocket/plan-sprint-handlers.js +190 -0
  377. package/dist/server/services/websocket/plan-transfer-handlers.js +310 -0
  378. package/dist/server/services/websocket/pm-timeline-broadcast.js +28 -0
  379. package/dist/server/services/websocket/post-session-scan.js +132 -0
  380. package/dist/server/services/websocket/prompt-queue-handlers.js +96 -0
  381. package/dist/server/services/websocket/quality-agent-cost.js +229 -0
  382. package/dist/server/services/websocket/quality-agent-notes.js +113 -0
  383. package/dist/server/services/websocket/quality-change-activity.js +187 -0
  384. package/dist/server/services/websocket/quality-complexity.js +345 -0
  385. package/dist/server/services/websocket/quality-dependencies.js +445 -0
  386. package/dist/server/services/websocket/quality-duplication.js +162 -0
  387. package/dist/server/services/websocket/quality-eta.js +65 -0
  388. package/dist/server/services/websocket/quality-fingerprint.js +104 -0
  389. package/dist/server/services/websocket/quality-grading.js +575 -0
  390. package/dist/server/services/websocket/quality-handlers.js +48 -0
  391. package/dist/server/services/websocket/quality-linting.js +270 -0
  392. package/dist/server/services/websocket/quality-operations.js +54 -0
  393. package/dist/server/services/websocket/quality-persistence.js +410 -0
  394. package/dist/server/services/websocket/quality-review-agent.js +526 -0
  395. package/dist/server/services/websocket/quality-run.js +220 -0
  396. package/dist/server/services/websocket/quality-secrets.js +0 -0
  397. package/dist/server/services/websocket/quality-service.js +775 -0
  398. package/dist/server/services/websocket/quality-tools.js +383 -0
  399. package/dist/server/services/websocket/quality-triage-agent.js +101 -0
  400. package/dist/server/services/websocket/quality-types.js +149 -0
  401. package/dist/server/services/websocket/recommended-answers.js +28 -0
  402. package/dist/server/services/websocket/schedule-handlers.js +197 -0
  403. package/dist/server/services/websocket/sdk-agent-host.js +569 -0
  404. package/dist/server/services/websocket/sdk-browser-host.js +459 -0
  405. package/dist/server/services/websocket/sdk-composer-host.js +10 -0
  406. package/dist/server/services/websocket/sdk-git-host.js +115 -0
  407. package/dist/server/services/websocket/sdk-handlers.js +242 -0
  408. package/dist/server/services/websocket/sdk-pm-execution-host.js +63 -0
  409. package/dist/server/services/websocket/sdk-pm-schedule-host.js +21 -0
  410. package/dist/server/services/websocket/sdk-quality-schedule-host.js +34 -0
  411. package/dist/server/services/websocket/sdk-terminal-host.js +140 -0
  412. package/dist/server/services/websocket/session-handlers.js +565 -0
  413. package/dist/server/services/websocket/session-history.js +335 -0
  414. package/dist/server/services/websocket/session-initialization.js +315 -0
  415. package/dist/server/services/websocket/session-registry.js +340 -0
  416. package/dist/server/services/websocket/session-role-directory.js +39 -0
  417. package/dist/server/services/websocket/settings-handlers.js +276 -0
  418. package/dist/server/services/websocket/skill-handlers.js +324 -0
  419. package/dist/server/services/websocket/skill-watcher.js +83 -0
  420. package/dist/server/services/websocket/snippet-handlers.js +261 -0
  421. package/dist/server/services/websocket/tab-broadcast.js +35 -0
  422. package/dist/server/services/websocket/tab-event-buffer.js +110 -0
  423. package/dist/server/services/websocket/tab-event-replay.js +47 -0
  424. package/dist/server/services/websocket/tab-handlers.js +211 -0
  425. package/dist/server/services/websocket/terminal-handlers.js +268 -0
  426. package/dist/server/services/websocket/types.js +96 -0
  427. package/dist/server/types/company-messages.js +102 -0
  428. package/dist/server/utils/agent-manager.js +202 -0
  429. package/dist/server/utils/console-timestamps.js +24 -0
  430. package/dist/server/utils/file-store.js +112 -0
  431. package/dist/server/utils/paths.js +28 -0
  432. package/dist/server/utils/port-manager.js +43 -0
  433. package/dist/server/utils/port.js +204 -0
  434. package/electron-host/dist/agent-lease.js +141 -0
  435. package/electron-host/dist/capture-recovery.js +77 -0
  436. package/electron-host/dist/codec-policy.js +37 -0
  437. package/electron-host/dist/controller-channel.js +60 -0
  438. package/electron-host/dist/controller-handlers.js +153 -0
  439. package/electron-host/dist/device-emulator.js +106 -0
  440. package/electron-host/dist/dom-driver.js +642 -0
  441. package/electron-host/dist/domain-registry.js +159 -0
  442. package/electron-host/dist/domain-validators.js +308 -0
  443. package/electron-host/dist/editable-focus-reporter.js +143 -0
  444. package/electron-host/dist/fake-peer.test-util.js +105 -0
  445. package/electron-host/dist/host-log.js +31 -0
  446. package/electron-host/dist/host-wire.js +11 -0
  447. package/electron-host/dist/input-router.js +421 -0
  448. package/electron-host/dist/ipc-protocol.js +89 -0
  449. package/electron-host/dist/ipc-server.js +193 -0
  450. package/electron-host/dist/js-driver.js +216 -0
  451. package/electron-host/dist/main-guards.js +70 -0
  452. package/electron-host/dist/main.js +716 -0
  453. package/electron-host/dist/roster-sync.js +87 -0
  454. package/electron-host/dist/rpc-context.js +1 -0
  455. package/electron-host/dist/rpc-tab-methods.js +138 -0
  456. package/electron-host/dist/rpc-webrtc-methods.js +121 -0
  457. package/electron-host/dist/screen-capture-cache.js +147 -0
  458. package/electron-host/dist/sdk-injector.js +166 -0
  459. package/electron-host/dist/sdp.js +102 -0
  460. package/electron-host/dist/session-surface.js +78 -0
  461. package/electron-host/dist/surface-sizing.js +59 -0
  462. package/electron-host/dist/view-manager.js +254 -0
  463. package/electron-host/dist/viewer-registry.js +46 -0
  464. package/electron-host/dist/viewer-session.js +288 -0
  465. package/electron-host/dist/webrtc-channels.js +14 -0
  466. package/electron-host/dist/webrtc-controller.js +57 -0
  467. package/electron-host/dist/webrtc-ice-filter.js +13 -0
  468. package/electron-host/dist/webrtc-peer.js +45 -0
  469. package/electron-host/package.json +12 -0
  470. package/electron-host/tsconfig.json +23 -0
  471. package/electron-host/webrtc-controller-preload.cjs +3 -0
  472. package/electron-host/webrtc-controller.html +14 -0
  473. package/package.json +85 -0
  474. package/vendor/e2ee/LICENSE +14 -0
  475. package/vendor/e2ee/package.json +14 -0
  476. package/vendor/e2ee/src/index.js +310 -0
@@ -0,0 +1,197 @@
1
+ // Copyright (c) 2025-present Minionry, Inc.
2
+ // SPDX-License-Identifier: LicenseRef-Minionry-Software
3
+ import { existsSync, readFileSync, writeFileSync } from 'node:fs';
4
+ import { arch, platform } from 'node:os';
5
+ import { PostHog } from 'posthog-node';
6
+ import { ensureMachineDir, machineFile } from '../../bin/machine-layout.js';
7
+ import { getClientId } from './client-id.js';
8
+ import { DEFAULT_PLATFORM_URL } from './platform-url.js';
9
+ function telemetryFile() {
10
+ return machineFile('telemetry');
11
+ }
12
+ function getServerUrl() {
13
+ try {
14
+ const content = readFileSync(machineFile('devEnv'), 'utf-8');
15
+ const match = content.match(/^SERVER_URL=(.+)$/m);
16
+ if (match)
17
+ return match[1].trim();
18
+ }
19
+ catch { }
20
+ return DEFAULT_PLATFORM_URL;
21
+ }
22
+ function platformUrl() {
23
+ return process.env.PLATFORM_URL || getServerUrl();
24
+ }
25
+ let client = null;
26
+ let telemetryEnabled = null;
27
+ let analyticsConfig = null;
28
+ function isTelemetryEnabled() {
29
+ if (telemetryEnabled !== null) {
30
+ return telemetryEnabled;
31
+ }
32
+ const envValue = process.env.MINIONRY_TELEMETRY;
33
+ if (envValue === '0' || envValue === 'false') {
34
+ telemetryEnabled = false;
35
+ return false;
36
+ }
37
+ const configFile = telemetryFile();
38
+ if (existsSync(configFile)) {
39
+ try {
40
+ const config = JSON.parse(readFileSync(configFile, 'utf-8'));
41
+ if (config.telemetry === false) {
42
+ telemetryEnabled = false;
43
+ return false;
44
+ }
45
+ }
46
+ catch {
47
+ }
48
+ }
49
+ telemetryEnabled = true;
50
+ return true;
51
+ }
52
+ async function fetchAnalyticsConfig() {
53
+ try {
54
+ const response = await fetch(`${platformUrl()}/api/config/client`, {
55
+ method: 'GET',
56
+ headers: { 'Content-Type': 'application/json' },
57
+ });
58
+ if (!response.ok) {
59
+ return null;
60
+ }
61
+ const data = await response.json();
62
+ return {
63
+ posthogKey: data.analytics?.posthogKey || '',
64
+ posthogHost: data.analytics?.posthogHost || 'https://eu.i.posthog.com',
65
+ };
66
+ }
67
+ catch {
68
+ return null;
69
+ }
70
+ }
71
+ export async function initAnalytics() {
72
+ if (!isTelemetryEnabled()) {
73
+ return;
74
+ }
75
+ analyticsConfig = await fetchAnalyticsConfig();
76
+ if (!analyticsConfig?.posthogKey) {
77
+ return;
78
+ }
79
+ client = new PostHog(analyticsConfig.posthogKey, {
80
+ host: `${platformUrl()}/a`,
81
+ flushAt: 20,
82
+ flushInterval: 10000,
83
+ });
84
+ client.on('error', () => { });
85
+ }
86
+ export async function shutdownAnalytics() {
87
+ if (client) {
88
+ try {
89
+ await client.shutdown();
90
+ }
91
+ catch {
92
+ }
93
+ client = null;
94
+ }
95
+ }
96
+ function getDistinctId() {
97
+ return getClientId();
98
+ }
99
+ function getCommonProperties() {
100
+ return {
101
+ os: platform(),
102
+ arch: arch(),
103
+ node_version: process.version,
104
+ minionry_version: process.env.npm_package_version || 'unknown',
105
+ source: 'client',
106
+ };
107
+ }
108
+ export function trackEvent(event, properties) {
109
+ if (!client || !isTelemetryEnabled())
110
+ return;
111
+ client.capture({
112
+ distinctId: getDistinctId(),
113
+ event,
114
+ properties: {
115
+ ...getCommonProperties(),
116
+ ...properties,
117
+ },
118
+ });
119
+ }
120
+ export function identifyUser(userId, properties) {
121
+ if (!client || !isTelemetryEnabled())
122
+ return;
123
+ client.alias({
124
+ distinctId: userId,
125
+ alias: getDistinctId(),
126
+ });
127
+ client.identify({
128
+ distinctId: userId,
129
+ properties: {
130
+ ...getCommonProperties(),
131
+ ...properties,
132
+ },
133
+ });
134
+ }
135
+ export function setTelemetryEnabled(enabled) {
136
+ let config = {};
137
+ const configFile = telemetryFile();
138
+ if (existsSync(configFile)) {
139
+ try {
140
+ config = JSON.parse(readFileSync(configFile, 'utf-8'));
141
+ }
142
+ catch {
143
+ }
144
+ }
145
+ config.telemetry = enabled;
146
+ ensureMachineDir('config');
147
+ writeFileSync(configFile, JSON.stringify(config, null, 2), { mode: 0o600 });
148
+ telemetryEnabled = enabled;
149
+ }
150
+ export function getTelemetryStatus() {
151
+ const envValue = process.env.MINIONRY_TELEMETRY;
152
+ if (envValue === '0' || envValue === 'false') {
153
+ return { enabled: false, reason: 'Disabled via MINIONRY_TELEMETRY environment variable' };
154
+ }
155
+ const configFile = telemetryFile();
156
+ if (existsSync(configFile)) {
157
+ try {
158
+ const config = JSON.parse(readFileSync(configFile, 'utf-8'));
159
+ if (config.telemetry === false) {
160
+ return { enabled: false, reason: 'Disabled via ~/.minionry/config/telemetry.json' };
161
+ }
162
+ }
163
+ catch {
164
+ }
165
+ }
166
+ if (!analyticsConfig?.posthogKey) {
167
+ return { enabled: false, reason: 'Analytics not configured on platform' };
168
+ }
169
+ return { enabled: true, reason: 'Enabled (opt-out with MINIONRY_TELEMETRY=0)' };
170
+ }
171
+ export const AnalyticsEvents = {
172
+ CLI_STARTED: 'cli_started',
173
+ CLI_COMMAND: 'cli_command',
174
+ CLI_LOGIN: 'cli_login',
175
+ CLI_LOGOUT: 'cli_logout',
176
+ CLI_ERROR: 'cli_error',
177
+ SERVER_STARTED: 'server_started',
178
+ SERVER_STOPPED: 'server_stopped',
179
+ PLATFORM_CONNECTED: 'platform_connected',
180
+ PLATFORM_DISCONNECTED: 'platform_disconnected',
181
+ WEB_CLIENT_CONNECTED: 'web_client_connected',
182
+ WEB_CLIENT_DISCONNECTED: 'web_client_disconnected',
183
+ IMPROVISE_SESSION_STARTED: 'improvise_session_started',
184
+ IMPROVISE_PROMPT_RECEIVED: 'improvise_prompt_received',
185
+ IMPROVISE_MOVEMENT_STARTED: 'improvise_movement_started',
186
+ IMPROVISE_MOVEMENT_COMPLETED: 'improvise_movement_completed',
187
+ IMPROVISE_MOVEMENT_ERROR: 'improvise_movement_error',
188
+ IMPROVISE_SESSION_ENDED: 'improvise_session_ended',
189
+ IMPROVISE_ABORTED: 'improvise_aborted',
190
+ IMPROVISE_TOOL_TIMEOUT: 'improvise_tool_timeout',
191
+ IMPROVISE_AUTO_RETRY: 'improvise_auto_retry',
192
+ TERMINAL_SESSION_CREATED: 'terminal_session_created',
193
+ TERMINAL_SESSION_CLOSED: 'terminal_session_closed',
194
+ BOUNCER_TOOL_ALLOWED: 'bouncer_tool_allowed',
195
+ BOUNCER_TOOL_DENIED: 'bouncer_tool_denied',
196
+ BOUNCER_HAIKU_REVIEW: 'bouncer_haiku_review',
197
+ };
@@ -0,0 +1,249 @@
1
+ // Copyright (c) 2025-present Minionry, Inc.
2
+ // SPDX-License-Identifier: LicenseRef-Minionry-Software
3
+ import { spawn } from 'node:child_process';
4
+ import { copyFileSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync } from 'node:fs';
5
+ import { join } from 'node:path';
6
+ import { BUILD_COMMANDS, BUILD_COMMANDS_WITH_SCRIPTS, isBuildApproved, isLifecycleScriptsApproved, } from './greenlight.js';
7
+ import { errorText, getAppStatePaths, isRealDirectory } from './layout.js';
8
+ const BUILD_STEP_TIMEOUT_MS = 15 * 60 * 1000;
9
+ const BUILD_LOG_STREAM_LIMIT = 1_000_000;
10
+ const BUILD_LOG_TAIL_CHARS = 2000;
11
+ const CONVENTIONAL_OUTPUT_DIRS = ['dist', 'build', 'out'];
12
+ const inflightBuilds = new Set();
13
+ class BuildLogSink {
14
+ onLog;
15
+ streamed = 0;
16
+ capped = false;
17
+ tail = '';
18
+ constructor(onLog) {
19
+ this.onLog = onLog;
20
+ }
21
+ write(stream, text) {
22
+ if (text === '')
23
+ return;
24
+ this.tail = (this.tail + text).slice(-BUILD_LOG_TAIL_CHARS);
25
+ if (!this.onLog)
26
+ return;
27
+ if (this.streamed >= BUILD_LOG_STREAM_LIMIT) {
28
+ if (!this.capped) {
29
+ this.capped = true;
30
+ this.onLog({ stream: 'stderr', chunk: '\n[minionry] build log stream limit reached — further output is kept for the failure tail only\n' });
31
+ }
32
+ return;
33
+ }
34
+ this.streamed += text.length;
35
+ this.onLog({ stream, chunk: text });
36
+ }
37
+ tailText() {
38
+ return this.tail.trim();
39
+ }
40
+ }
41
+ function killProcessGroup(child) {
42
+ if (child.pid === undefined)
43
+ return;
44
+ if (process.platform !== 'win32') {
45
+ try {
46
+ process.kill(-child.pid, 'SIGKILL');
47
+ }
48
+ catch { }
49
+ }
50
+ try {
51
+ child.kill('SIGKILL');
52
+ }
53
+ catch { }
54
+ }
55
+ function scrubbedBuildEnv(buildHomeDir) {
56
+ const env = {
57
+ PATH: process.env.PATH ?? '/usr/local/bin:/usr/bin:/bin',
58
+ HOME: buildHomeDir,
59
+ npm_config_update_notifier: 'false',
60
+ npm_config_audit: 'false',
61
+ npm_config_fund: 'false',
62
+ npm_config_progress: 'false',
63
+ };
64
+ for (const key of ['TMPDIR', 'LANG', 'LC_ALL', 'TZ']) {
65
+ const value = process.env[key];
66
+ if (value !== undefined)
67
+ env[key] = value;
68
+ }
69
+ return env;
70
+ }
71
+ function runBuildCommand(command, cwd, env, sink) {
72
+ return new Promise((resolve) => {
73
+ const [bin, ...args] = command.split(' ');
74
+ const child = spawn(bin, args, {
75
+ cwd,
76
+ env,
77
+ stdio: ['ignore', 'pipe', 'pipe'],
78
+ detached: process.platform !== 'win32',
79
+ });
80
+ let settled = false;
81
+ let timedOut = false;
82
+ const settle = (failure) => {
83
+ if (settled)
84
+ return;
85
+ settled = true;
86
+ clearTimeout(timer);
87
+ resolve(failure);
88
+ };
89
+ const timer = setTimeout(() => {
90
+ timedOut = true;
91
+ killProcessGroup(child);
92
+ }, BUILD_STEP_TIMEOUT_MS);
93
+ child.stdout?.on('data', (data) => sink.write('stdout', data.toString()));
94
+ child.stderr?.on('data', (data) => sink.write('stderr', data.toString()));
95
+ child.on('error', (err) => {
96
+ killProcessGroup(child);
97
+ settle(`failed to spawn \`${command}\`: ${err.message}`);
98
+ });
99
+ child.on('exit', () => killProcessGroup(child));
100
+ child.on('close', (code, signal) => {
101
+ if (timedOut) {
102
+ settle(`\`${command}\` timed out after ${BUILD_STEP_TIMEOUT_MS / 60_000} minutes and was killed`);
103
+ }
104
+ else if (code === 0) {
105
+ settle(null);
106
+ }
107
+ else {
108
+ settle(`\`${command}\` failed (${signal ? `killed by ${signal}` : `exit ${code ?? 'unknown'}`})`);
109
+ }
110
+ });
111
+ });
112
+ }
113
+ function readScriptPackages(srcDir) {
114
+ let raw;
115
+ try {
116
+ raw = readFileSync(join(srcDir, 'package-lock.json'), 'utf8');
117
+ }
118
+ catch {
119
+ return { ok: false, error: 'src/package-lock.json is missing — the listing checks (IS-020) require a committed lockfile, and `npm ci` cannot run without one' };
120
+ }
121
+ let parsed;
122
+ try {
123
+ parsed = JSON.parse(raw);
124
+ }
125
+ catch (err) {
126
+ return { ok: false, error: `src/package-lock.json is not valid JSON: ${errorText(err)}` };
127
+ }
128
+ if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
129
+ return { ok: false, error: 'src/package-lock.json is not a lockfile object' };
130
+ }
131
+ const packages = parsed.packages;
132
+ const found = new Set();
133
+ if (typeof packages === 'object' && packages !== null && !Array.isArray(packages)) {
134
+ for (const [pkgPath, entry] of Object.entries(packages)) {
135
+ const id = scriptPackageId(pkgPath, entry);
136
+ if (id)
137
+ found.add(id);
138
+ }
139
+ }
140
+ return { ok: true, scriptPackages: [...found].sort() };
141
+ }
142
+ function scriptPackageId(pkgPath, entry) {
143
+ if (pkgPath === '' || typeof entry !== 'object' || entry === null)
144
+ return null;
145
+ const record = entry;
146
+ if (record.hasInstallScript !== true)
147
+ return null;
148
+ const pathName = pkgPath.split('node_modules/').pop() || pkgPath;
149
+ const name = typeof record.name === 'string' && record.name !== '' ? record.name : pathName;
150
+ const version = typeof record.version === 'string' && record.version !== '' ? record.version : 'unknown';
151
+ return `${name}@${version}`;
152
+ }
153
+ function copyTreeRejectingSymlinks(src, dest) {
154
+ mkdirSync(dest, { recursive: true });
155
+ for (const entry of readdirSync(src, { withFileTypes: true })) {
156
+ const from = join(src, entry.name);
157
+ const to = join(dest, entry.name);
158
+ if (entry.isSymbolicLink()) {
159
+ throw new Error(`build output contains a symlink (${from}) — refusing to stage it into build/`);
160
+ }
161
+ if (entry.isDirectory()) {
162
+ copyTreeRejectingSymlinks(from, to);
163
+ }
164
+ else if (entry.isFile()) {
165
+ copyFileSync(from, to);
166
+ }
167
+ else {
168
+ throw new Error(`build output contains a non-regular file (${from}) — refusing to stage it into build/`);
169
+ }
170
+ }
171
+ }
172
+ function stageBuildOutput(paths) {
173
+ const outputDir = CONVENTIONAL_OUTPUT_DIRS.map((dir) => join(paths.srcDir, dir)).find(isRealDirectory);
174
+ if (!outputDir) {
175
+ return `the build completed but produced no output directory — expected one of ${CONVENTIONAL_OUTPUT_DIRS.map((dir) => `src/${dir}/`).join(', ')}`;
176
+ }
177
+ if (readdirSync(outputDir).length === 0) {
178
+ return `the build completed but its output directory (${outputDir}) is empty`;
179
+ }
180
+ try {
181
+ rmSync(paths.buildStagingDir, { recursive: true, force: true });
182
+ copyTreeRejectingSymlinks(outputDir, paths.buildStagingDir);
183
+ rmSync(paths.buildDir, { recursive: true, force: true });
184
+ renameSync(paths.buildStagingDir, paths.buildDir);
185
+ return null;
186
+ }
187
+ catch (err) {
188
+ rmSync(paths.buildStagingDir, { recursive: true, force: true });
189
+ return `failed to stage the build output into build/: ${errorText(err)}`;
190
+ }
191
+ }
192
+ export async function buildClonedApp(request) {
193
+ let paths;
194
+ try {
195
+ paths = getAppStatePaths(request.workingDir, request.appId);
196
+ }
197
+ catch (err) {
198
+ return { ok: false, code: 'BAD_REQUEST', error: errorText(err) };
199
+ }
200
+ if (!isRealDirectory(paths.srcDir)) {
201
+ return { ok: false, code: 'BAD_REQUEST', error: `nothing to build for '${request.appId}': no clone at src/ — the install step (IS-027) must land first` };
202
+ }
203
+ const buildTerms = { repoUrl: request.repoUrl, commitSha: request.commitSha, commands: BUILD_COMMANDS };
204
+ if (!isBuildApproved(request.workingDir, request.appId, buildTerms)) {
205
+ return { ok: false, code: 'FORBIDDEN', error: `no recorded build greenlight for '${request.appId}' at ${request.commitSha} — consent (IS-028) must approve exactly these terms before anything runs` };
206
+ }
207
+ const lock = readScriptPackages(paths.srcDir);
208
+ if (!lock.ok) {
209
+ return { ok: false, code: 'INTERNAL', error: lock.error };
210
+ }
211
+ const withScripts = lock.scriptPackages.length > 0 &&
212
+ isLifecycleScriptsApproved(request.workingDir, request.appId, {
213
+ commitSha: request.commitSha,
214
+ scriptPackages: lock.scriptPackages,
215
+ });
216
+ const commands = withScripts ? BUILD_COMMANDS_WITH_SCRIPTS : BUILD_COMMANDS;
217
+ if (inflightBuilds.has(paths.root)) {
218
+ return { ok: false, code: 'INTERNAL', error: `a build for '${request.appId}' is already in progress in this Space — wait for it to finish` };
219
+ }
220
+ inflightBuilds.add(paths.root);
221
+ const sink = new BuildLogSink(request.onLog);
222
+ try {
223
+ mkdirSync(paths.buildHomeDir, { recursive: true, mode: 0o700 });
224
+ const env = scrubbedBuildEnv(paths.buildHomeDir);
225
+ for (const command of commands) {
226
+ sink.write('stdout', `$ ${command}\n`);
227
+ const failure = await runBuildCommand(command, paths.srcDir, env, sink);
228
+ if (failure) {
229
+ return { ok: false, code: 'INTERNAL', error: withLogTail(failure, sink) };
230
+ }
231
+ }
232
+ const stagingFailure = stageBuildOutput(paths);
233
+ if (stagingFailure) {
234
+ return { ok: false, code: 'INTERNAL', error: stagingFailure };
235
+ }
236
+ return { ok: true, paths, withScripts };
237
+ }
238
+ catch (err) {
239
+ rmSync(paths.buildStagingDir, { recursive: true, force: true });
240
+ return { ok: false, code: 'INTERNAL', error: `build failed: ${errorText(err)}` };
241
+ }
242
+ finally {
243
+ inflightBuilds.delete(paths.root);
244
+ }
245
+ }
246
+ function withLogTail(failure, sink) {
247
+ const tail = sink.tailText();
248
+ return tail ? `${failure} — log tail:\n${tail}` : failure;
249
+ }
@@ -0,0 +1,199 @@
1
+ // Copyright (c) 2025-present Minionry, Inc.
2
+ // SPDX-License-Identifier: LicenseRef-Minionry-Software
3
+ import { randomUUID } from 'node:crypto';
4
+ import { readFileSync } from 'node:fs';
5
+ import { writeFileAtomic } from '../../utils/file-store.js';
6
+ import { cancelPendingQuestionsForTab, getPendingQuestionTab, registerPendingQuestion, resolvePendingQuestion, } from '../websocket/ask-user-question-bridge.js';
7
+ import { getAppStatePaths } from './layout.js';
8
+ export const BUILD_COMMANDS = ['npm ci --ignore-scripts', 'npm run build'];
9
+ export const BUILD_COMMANDS_WITH_SCRIPTS = ['npm ci', 'npm run build'];
10
+ function shortSha(sha) {
11
+ return sha.slice(0, 12);
12
+ }
13
+ function greenlightScope(appId) {
14
+ return `apps:${appId}`;
15
+ }
16
+ function readConsentFile(consentFile) {
17
+ try {
18
+ const parsed = JSON.parse(readFileSync(consentFile, 'utf8'));
19
+ if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
20
+ return {};
21
+ return parsed;
22
+ }
23
+ catch {
24
+ return {};
25
+ }
26
+ }
27
+ function writeConsentFile(consentFile, shape) {
28
+ writeFileAtomic(consentFile, `${JSON.stringify(shape, null, 2)}\n`, { mode: 0o600 });
29
+ }
30
+ function sameCommands(recorded, requested) {
31
+ return (Array.isArray(recorded) &&
32
+ recorded.length === requested.length &&
33
+ requested.every((cmd, i) => recorded[i] === cmd));
34
+ }
35
+ function consentFilePath(workingDir, appId) {
36
+ try {
37
+ return getAppStatePaths(workingDir, appId).consentFile;
38
+ }
39
+ catch {
40
+ return null;
41
+ }
42
+ }
43
+ export function isBuildApproved(workingDir, appId, terms) {
44
+ const consentFile = consentFilePath(workingDir, appId);
45
+ if (!consentFile)
46
+ return false;
47
+ const record = readConsentFile(consentFile).build;
48
+ if (!record)
49
+ return false;
50
+ return (record.repoUrl === terms.repoUrl &&
51
+ record.commitSha === terms.commitSha &&
52
+ sameCommands(record.commands, terms.commands));
53
+ }
54
+ export function isLifecycleScriptsApproved(workingDir, appId, terms) {
55
+ const consentFile = consentFilePath(workingDir, appId);
56
+ if (!consentFile)
57
+ return false;
58
+ const record = readConsentFile(consentFile).lifecycleScripts;
59
+ if (!record || record.commitSha !== terms.commitSha || !Array.isArray(record.scriptPackages)) {
60
+ return false;
61
+ }
62
+ const approved = new Set(record.scriptPackages);
63
+ return terms.scriptPackages.every((pkg) => approved.has(pkg));
64
+ }
65
+ function buildConsentStatement(terms) {
66
+ return [
67
+ `This downloads and runs code from ${terms.repoUrl} at ${shortSha(terms.commitSha)} on your machine.`,
68
+ '',
69
+ 'Commands that will run:',
70
+ ...terms.commands.map((cmd) => ` $ ${cmd}`),
71
+ ].join('\n');
72
+ }
73
+ function lifecycleConsentStatement(terms) {
74
+ return [
75
+ `This enables dependency install scripts for code from ${terms.repoUrl} at ${shortSha(terms.commitSha)} — the packages below will run their own scripts on your machine during dependency install.`,
76
+ '',
77
+ 'Packages declaring install scripts:',
78
+ ...terms.scriptPackages.map((pkg) => ` - ${pkg}`),
79
+ '',
80
+ 'Commands that will run:',
81
+ ...BUILD_COMMANDS_WITH_SCRIPTS.map((cmd) => ` $ ${cmd}`),
82
+ ].join('\n');
83
+ }
84
+ async function promptGreenlight(appId, card, statement, opts) {
85
+ const scope = greenlightScope(appId);
86
+ cancelPendingQuestionsForTab(scope);
87
+ const greenlightId = randomUUID();
88
+ const question = {
89
+ question: statement,
90
+ header: 'Greenlight',
91
+ options: [
92
+ { label: 'Approve', description: 'Run exactly the commands listed above on this machine' },
93
+ { label: 'Deny', description: 'Abort — nothing is downloaded further and nothing runs' },
94
+ ],
95
+ multiSelect: false,
96
+ };
97
+ const pending = registerPendingQuestion({
98
+ toolUseId: greenlightId,
99
+ tabId: scope,
100
+ questions: [question],
101
+ ...(opts.timeoutMs !== undefined ? { timeoutMs: opts.timeoutMs } : {}),
102
+ computeTimeoutAnswers: () => ({ approved: 'false' }),
103
+ });
104
+ opts.broadcast({ greenlightId, ...card });
105
+ try {
106
+ const resolved = await pending;
107
+ if (resolved.timedOut)
108
+ return 'timeout';
109
+ return resolved.answers.approved === 'true' ? 'approved' : 'user-denied';
110
+ }
111
+ catch {
112
+ return 'superseded';
113
+ }
114
+ }
115
+ function deniedOutcome(decision, appId, what) {
116
+ const detail = decision === 'user-denied'
117
+ ? `the user denied the ${what} greenlight for ${appId}`
118
+ : decision === 'timeout'
119
+ ? `the ${what} greenlight for ${appId} timed out without approval (consent never defaults to yes)`
120
+ : `the ${what} greenlight for ${appId} was superseded by a newer request`;
121
+ return { ok: false, code: 'FORBIDDEN', error: `${detail} — aborted; nothing was built` };
122
+ }
123
+ export async function ensureBuildGreenlight(workingDir, appId, terms, opts) {
124
+ const consentFile = consentFilePath(workingDir, appId);
125
+ if (!consentFile) {
126
+ return { ok: false, code: 'BAD_REQUEST', error: `cannot resolve app state for '${appId}' in this Space` };
127
+ }
128
+ if (terms.commands.length === 0) {
129
+ return { ok: false, code: 'BAD_REQUEST', error: 'a build greenlight needs at least one command to consent to' };
130
+ }
131
+ if (isBuildApproved(workingDir, appId, terms)) {
132
+ return { ok: true, alreadyApproved: true };
133
+ }
134
+ const decision = await promptGreenlight(appId, {
135
+ appId,
136
+ kind: 'build',
137
+ repoUrl: terms.repoUrl,
138
+ commitSha: terms.commitSha,
139
+ commands: [...terms.commands],
140
+ }, buildConsentStatement(terms), opts);
141
+ if (decision !== 'approved') {
142
+ if (decision === 'user-denied') {
143
+ const shape = readConsentFile(consentFile);
144
+ delete shape.build;
145
+ writeConsentFile(consentFile, shape);
146
+ }
147
+ return deniedOutcome(decision, appId, 'build');
148
+ }
149
+ const shape = readConsentFile(consentFile);
150
+ shape.build = {
151
+ repoUrl: terms.repoUrl,
152
+ commitSha: terms.commitSha,
153
+ commands: [...terms.commands],
154
+ approvedAt: new Date().toISOString(),
155
+ };
156
+ writeConsentFile(consentFile, shape);
157
+ return { ok: true, alreadyApproved: false };
158
+ }
159
+ export async function ensureLifecycleScriptsGreenlight(workingDir, appId, terms, opts) {
160
+ const consentFile = consentFilePath(workingDir, appId);
161
+ if (!consentFile) {
162
+ return { ok: false, code: 'BAD_REQUEST', error: `cannot resolve app state for '${appId}' in this Space` };
163
+ }
164
+ if (terms.scriptPackages.length === 0) {
165
+ return { ok: false, code: 'BAD_REQUEST', error: 'no packages declare install scripts — nothing to enable' };
166
+ }
167
+ if (isLifecycleScriptsApproved(workingDir, appId, terms)) {
168
+ return { ok: true, alreadyApproved: true };
169
+ }
170
+ const decision = await promptGreenlight(appId, {
171
+ appId,
172
+ kind: 'lifecycle-scripts',
173
+ repoUrl: terms.repoUrl,
174
+ commitSha: terms.commitSha,
175
+ commands: [...BUILD_COMMANDS_WITH_SCRIPTS],
176
+ scriptPackages: [...terms.scriptPackages],
177
+ }, lifecycleConsentStatement(terms), opts);
178
+ if (decision !== 'approved') {
179
+ if (decision === 'user-denied') {
180
+ const shape = readConsentFile(consentFile);
181
+ delete shape.lifecycleScripts;
182
+ writeConsentFile(consentFile, shape);
183
+ }
184
+ return deniedOutcome(decision, appId, 'lifecycle-scripts');
185
+ }
186
+ const shape = readConsentFile(consentFile);
187
+ shape.lifecycleScripts = {
188
+ commitSha: terms.commitSha,
189
+ scriptPackages: [...terms.scriptPackages],
190
+ approvedAt: new Date().toISOString(),
191
+ };
192
+ writeConsentFile(consentFile, shape);
193
+ return { ok: true, alreadyApproved: false };
194
+ }
195
+ export function resolveGreenlightDecision(greenlightId, appId, approved) {
196
+ if (getPendingQuestionTab(greenlightId) !== greenlightScope(appId))
197
+ return false;
198
+ return resolvePendingQuestion(greenlightId, { approved: approved ? 'true' : 'false' });
199
+ }