@pixelbyte-software/pixcode 1.54.6 → 1.54.8

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 (288) hide show
  1. package/CODE_OF_CONDUCT.md +41 -41
  2. package/CONTRIBUTING.md +155 -155
  3. package/LICENSE +718 -718
  4. package/README.de.md +169 -169
  5. package/README.ja.md +167 -167
  6. package/README.ko.md +167 -167
  7. package/README.md +418 -418
  8. package/README.ru.md +169 -169
  9. package/README.tr.md +298 -298
  10. package/README.zh-CN.md +167 -167
  11. package/SECURITY.md +46 -46
  12. package/dist/api-automation.html +110 -110
  13. package/dist/api-docs.html +548 -548
  14. package/dist/assets/{index-DJ_KIN2W.js → index-BU3Z3zrh.js} +186 -184
  15. package/dist/assets/index-Dz1luE0u.css +32 -0
  16. package/dist/clear-cache.html +85 -85
  17. package/dist/convert-icons.md +52 -52
  18. package/dist/docs.html +308 -308
  19. package/dist/features.html +133 -133
  20. package/dist/generate-icons.js +48 -48
  21. package/dist/humans.txt +15 -15
  22. package/dist/icons/codex-white.svg +3 -3
  23. package/dist/icons/codex.svg +3 -3
  24. package/dist/icons/cursor-white.svg +11 -11
  25. package/dist/icons/qwen-logo.svg +14 -14
  26. package/dist/index.html +59 -59
  27. package/dist/landing.html +268 -268
  28. package/dist/llms-full.txt +119 -119
  29. package/dist/llms.txt +53 -53
  30. package/dist/manifest.json +60 -60
  31. package/dist/openapi.yaml +1696 -1696
  32. package/dist/orchestration.html +125 -125
  33. package/dist/robots.txt +4 -4
  34. package/dist/site.css +692 -692
  35. package/dist/sitemap.xml +51 -51
  36. package/dist/sw.js +132 -132
  37. package/dist-server/server/cli.js +100 -100
  38. package/dist-server/server/daemon/manager.js +33 -33
  39. package/dist-server/server/daemon-manager.js +64 -64
  40. package/dist-server/server/index.js +113 -31
  41. package/dist-server/server/index.js.map +1 -1
  42. package/dist-server/server/routes/auth.js +17 -5
  43. package/dist-server/server/routes/auth.js.map +1 -1
  44. package/dist-server/server/routes/commands.js +25 -25
  45. package/dist-server/server/routes/git.js +17 -17
  46. package/dist-server/server/routes/live-view.js +46 -46
  47. package/dist-server/server/services/public-api-manifest.js +51 -51
  48. package/package.json +224 -224
  49. package/scripts/fix-node-pty.js +67 -67
  50. package/scripts/github/create-v1.38-issues.mjs +351 -351
  51. package/scripts/github/create-vscode-workbench-issues.mjs +121 -121
  52. package/scripts/smoke/backend-resource-bounds.mjs +152 -152
  53. package/scripts/smoke/changes-panel-layout.mjs +48 -48
  54. package/scripts/smoke/chat-composer-fixed-layout.mjs +55 -55
  55. package/scripts/smoke/chat-message-timeline-order.mjs +41 -41
  56. package/scripts/smoke/chat-realtime-hydration.mjs +44 -44
  57. package/scripts/smoke/chat-session-provider-pools.mjs +35 -35
  58. package/scripts/smoke/chat-session-state.mjs +19 -19
  59. package/scripts/smoke/code-editor-theme.mjs +55 -55
  60. package/scripts/smoke/code-editor-vscode-engine.mjs +91 -91
  61. package/scripts/smoke/command-center-agent-writes.mjs +79 -79
  62. package/scripts/smoke/command-center-non-git.mjs +46 -46
  63. package/scripts/smoke/context-packet.mjs +43 -43
  64. package/scripts/smoke/control-room-ux-redesign.mjs +91 -91
  65. package/scripts/smoke/daemon-entrypoint.mjs +20 -20
  66. package/scripts/smoke/default-landing-routing.mjs +33 -33
  67. package/scripts/smoke/desktop-native-notifications.mjs +30 -30
  68. package/scripts/smoke/desktop-tray-icon.mjs +33 -33
  69. package/scripts/smoke/discord-release-workflow.mjs +24 -24
  70. package/scripts/smoke/git-install-update.mjs +255 -255
  71. package/scripts/smoke/handoff-artifact-protocol.mjs +50 -50
  72. package/scripts/smoke/live-view-diagnostics.mjs +53 -53
  73. package/scripts/smoke/live-view-environment.mjs +92 -92
  74. package/scripts/smoke/live-view-integration.mjs +450 -450
  75. package/scripts/smoke/mac-desktop-runtime.mjs +37 -37
  76. package/scripts/smoke/mobile-tunnel-guidance.mjs +29 -29
  77. package/scripts/smoke/mobile-ux.mjs +76 -76
  78. package/scripts/smoke/model-registry.mjs +36 -36
  79. package/scripts/smoke/multi-project-ui.mjs +45 -45
  80. package/scripts/smoke/multi-worker-slots.mjs +42 -42
  81. package/scripts/smoke/notification-center.mjs +87 -87
  82. package/scripts/smoke/notification-inapp-preference.mjs +23 -23
  83. package/scripts/smoke/notification-taxonomy.mjs +58 -58
  84. package/scripts/smoke/orchestration-api.mjs +172 -172
  85. package/scripts/smoke/orchestration-execution-dashboard.mjs +33 -33
  86. package/scripts/smoke/orchestration-live-run.mjs +176 -176
  87. package/scripts/smoke/orchestration-mobile-scroll.mjs +29 -29
  88. package/scripts/smoke/orchestration-model-sync.mjs +30 -30
  89. package/scripts/smoke/orchestration-permission-fallback.mjs +34 -34
  90. package/scripts/smoke/orchestration-runtime-guards.mjs +48 -48
  91. package/scripts/smoke/orchestration-user-facing-output.mjs +25 -25
  92. package/scripts/smoke/permission-policy.mjs +50 -50
  93. package/scripts/smoke/pixcode-workbench-1-48.mjs +167 -167
  94. package/scripts/smoke/provider-models-opencode-live.mjs +66 -66
  95. package/scripts/smoke/provider-rest-api.mjs +124 -124
  96. package/scripts/smoke/provider-selection-status.mjs +52 -52
  97. package/scripts/smoke/run-state-refresh.mjs +52 -52
  98. package/scripts/smoke/runtime-manager.mjs +99 -99
  99. package/scripts/smoke/shell-manual-disconnect.mjs +30 -30
  100. package/scripts/smoke/side-panel-editor-layout.mjs +34 -34
  101. package/scripts/smoke/static-root-routing.mjs +21 -21
  102. package/scripts/smoke/strict-handoff-compact.mjs +60 -60
  103. package/scripts/smoke/taskmaster-config.mjs +24 -24
  104. package/scripts/smoke/taskmaster-execution-telegram.mjs +3 -3
  105. package/scripts/smoke/taskmaster-onboarding.mjs +3 -3
  106. package/scripts/smoke/taskmaster-run-graph.mjs +3 -3
  107. package/scripts/smoke/telegram-control.mjs +331 -331
  108. package/scripts/smoke/tunnel-persistence.mjs +56 -56
  109. package/scripts/smoke/update-issue-progress.mjs +69 -69
  110. package/scripts/smoke/update-ux.mjs +55 -55
  111. package/scripts/smoke/v138-completion.mjs +132 -132
  112. package/scripts/smoke/v138-desktop-release-hardening.mjs +69 -69
  113. package/scripts/smoke/v138-diagnostics.mjs +63 -63
  114. package/scripts/smoke/v138-issue-planner.mjs +33 -33
  115. package/scripts/smoke/v143-remote-control.mjs +76 -76
  116. package/scripts/smoke/v144-production-loop.mjs +47 -47
  117. package/scripts/smoke/v145-platformization.mjs +46 -46
  118. package/scripts/smoke/v146-control-room-ui.mjs +150 -150
  119. package/scripts/smoke/version-modal-autoshow.mjs +29 -29
  120. package/scripts/smoke/vscode-workbench-layout.mjs +63 -63
  121. package/scripts/smoke/vscode-workbench-polish.mjs +461 -461
  122. package/scripts/smoke/workflow-fallback-replay.mjs +56 -56
  123. package/scripts/smoke/workflow-templates.mjs +43 -43
  124. package/scripts/smoke/workflow-trace-timeline.mjs +46 -46
  125. package/scripts/update-git-install.mjs +298 -298
  126. package/server/claude-sdk.js +927 -927
  127. package/server/cli.js +1106 -1106
  128. package/server/constants/config.js +4 -4
  129. package/server/cursor-cli.js +344 -344
  130. package/server/daemon/manager.js +563 -563
  131. package/server/daemon-manager.js +964 -964
  132. package/server/database/db.js +988 -988
  133. package/server/database/json-store.js +197 -197
  134. package/server/gemini-cli.js +550 -550
  135. package/server/gemini-response-handler.js +79 -79
  136. package/server/index.js +5620 -5544
  137. package/server/load-env.js +35 -35
  138. package/server/middleware/account-lockout.js +112 -112
  139. package/server/middleware/auth.js +277 -277
  140. package/server/middleware/rate-limiter.js +87 -87
  141. package/server/modules/orchestration/a2a/adapter-registry.ts +108 -108
  142. package/server/modules/orchestration/a2a/adapters/abstract-a2a.adapter.ts +63 -63
  143. package/server/modules/orchestration/a2a/adapters/claude-code.adapter.ts +286 -286
  144. package/server/modules/orchestration/a2a/adapters/codex.adapter.ts +244 -244
  145. package/server/modules/orchestration/a2a/adapters/cursor.adapter.ts +249 -249
  146. package/server/modules/orchestration/a2a/adapters/gemini.adapter.ts +248 -248
  147. package/server/modules/orchestration/a2a/adapters/json-event.adapter.test.ts +60 -60
  148. package/server/modules/orchestration/a2a/adapters/json-event.adapter.ts +101 -101
  149. package/server/modules/orchestration/a2a/adapters/opencode.adapter.ts +248 -248
  150. package/server/modules/orchestration/a2a/adapters/qwen.adapter.ts +248 -248
  151. package/server/modules/orchestration/a2a/agent-card.ts +55 -55
  152. package/server/modules/orchestration/a2a/auth.middleware.ts +29 -29
  153. package/server/modules/orchestration/a2a/bus.ts +46 -46
  154. package/server/modules/orchestration/a2a/routes.ts +586 -586
  155. package/server/modules/orchestration/a2a/task-dispatcher.ts +345 -345
  156. package/server/modules/orchestration/a2a/task-store.ts +178 -178
  157. package/server/modules/orchestration/a2a/types.ts +126 -126
  158. package/server/modules/orchestration/a2a/validator.ts +113 -113
  159. package/server/modules/orchestration/index.ts +99 -99
  160. package/server/modules/orchestration/preview/port-watcher.ts +112 -112
  161. package/server/modules/orchestration/preview/preview-proxy.ts +60 -60
  162. package/server/modules/orchestration/preview/types.ts +19 -19
  163. package/server/modules/orchestration/security/permission-policy.ts +401 -401
  164. package/server/modules/orchestration/tasks/orchestration-task-store.ts +41 -41
  165. package/server/modules/orchestration/tasks/orchestration-task.routes.ts +81 -81
  166. package/server/modules/orchestration/tasks/orchestration-task.service.ts +201 -201
  167. package/server/modules/orchestration/tasks/orchestration-task.types.ts +40 -40
  168. package/server/modules/orchestration/tasks/task-run-graph.ts +155 -155
  169. package/server/modules/orchestration/workflows/approval-queue.ts +106 -106
  170. package/server/modules/orchestration/workflows/built-in-workflows.ts +127 -127
  171. package/server/modules/orchestration/workflows/context-packet.ts +186 -186
  172. package/server/modules/orchestration/workflows/handoff-artifact.ts +175 -175
  173. package/server/modules/orchestration/workflows/workflow-fallback-policy.ts +161 -161
  174. package/server/modules/orchestration/workflows/workflow-replay.ts +254 -254
  175. package/server/modules/orchestration/workflows/workflow-runner.ts +2062 -2062
  176. package/server/modules/orchestration/workflows/workflow-store.ts +97 -97
  177. package/server/modules/orchestration/workflows/workflow-templates.ts +272 -272
  178. package/server/modules/orchestration/workflows/workflow-trace.ts +424 -424
  179. package/server/modules/orchestration/workflows/workflow.routes.ts +586 -586
  180. package/server/modules/orchestration/workflows/workflow.types.ts +111 -111
  181. package/server/modules/orchestration/workflows/workspace-target.ts +122 -122
  182. package/server/modules/orchestration/workspace/docker-workspace.ts +136 -136
  183. package/server/modules/orchestration/workspace/path-safety.ts +55 -55
  184. package/server/modules/orchestration/workspace/types.ts +52 -52
  185. package/server/modules/orchestration/workspace/workspace-manager.ts +102 -102
  186. package/server/modules/orchestration/workspace/worktree-workspace.ts +126 -126
  187. package/server/modules/providers/index.ts +2 -2
  188. package/server/modules/providers/list/claude/claude-auth.provider.ts +146 -146
  189. package/server/modules/providers/list/claude/claude-mcp.provider.ts +135 -135
  190. package/server/modules/providers/list/claude/claude-sessions.provider.ts +306 -306
  191. package/server/modules/providers/list/claude/claude.provider.ts +15 -15
  192. package/server/modules/providers/list/codex/codex-auth.provider.ts +117 -117
  193. package/server/modules/providers/list/codex/codex-mcp.provider.ts +135 -135
  194. package/server/modules/providers/list/codex/codex-sessions.provider.ts +319 -319
  195. package/server/modules/providers/list/codex/codex.provider.ts +15 -15
  196. package/server/modules/providers/list/cursor/cursor-auth.provider.ts +147 -147
  197. package/server/modules/providers/list/cursor/cursor-mcp.provider.ts +108 -108
  198. package/server/modules/providers/list/cursor/cursor-sessions.provider.ts +421 -421
  199. package/server/modules/providers/list/cursor/cursor.provider.ts +15 -15
  200. package/server/modules/providers/list/gemini/gemini-auth.provider.ts +173 -173
  201. package/server/modules/providers/list/gemini/gemini-mcp.provider.ts +110 -110
  202. package/server/modules/providers/list/gemini/gemini-sessions.provider.ts +227 -227
  203. package/server/modules/providers/list/gemini/gemini.provider.ts +15 -15
  204. package/server/modules/providers/list/opencode/opencode-auth.provider.ts +131 -131
  205. package/server/modules/providers/list/opencode/opencode-sessions.provider.ts +286 -286
  206. package/server/modules/providers/list/qwen/qwen-auth.provider.ts +146 -146
  207. package/server/modules/providers/list/qwen/qwen-sessions.provider.ts +265 -265
  208. package/server/modules/providers/provider.registry.ts +40 -40
  209. package/server/modules/providers/provider.routes.ts +982 -982
  210. package/server/modules/providers/services/mcp.service.ts +86 -86
  211. package/server/modules/providers/services/provider-auth.service.ts +26 -26
  212. package/server/modules/providers/services/sessions.service.ts +45 -45
  213. package/server/modules/providers/shared/base/abstract.provider.ts +20 -20
  214. package/server/modules/providers/shared/mcp/mcp.provider.ts +151 -151
  215. package/server/modules/providers/tests/mcp.test.ts +293 -293
  216. package/server/openai-codex.js +468 -468
  217. package/server/opencode-cli.js +491 -491
  218. package/server/opencode-response-handler.js +111 -111
  219. package/server/projects.js +3125 -3125
  220. package/server/qwen-code-cli.js +410 -410
  221. package/server/routes/agent.js +1451 -1451
  222. package/server/routes/auth.js +298 -286
  223. package/server/routes/codex.js +20 -20
  224. package/server/routes/commands.js +581 -581
  225. package/server/routes/cursor.js +61 -61
  226. package/server/routes/diagnostics.js +44 -44
  227. package/server/routes/gemini.js +25 -25
  228. package/server/routes/git.js +1822 -1822
  229. package/server/routes/live-view.js +434 -434
  230. package/server/routes/mcp-utils.js +13 -13
  231. package/server/routes/messages.js +97 -97
  232. package/server/routes/network.js +143 -143
  233. package/server/routes/platformization.js +231 -231
  234. package/server/routes/plugins.js +690 -690
  235. package/server/routes/production-agent-loop.js +90 -90
  236. package/server/routes/projects.js +918 -918
  237. package/server/routes/public-api.js +34 -34
  238. package/server/routes/qwen.js +27 -27
  239. package/server/routes/remote.js +56 -56
  240. package/server/routes/settings.js +321 -321
  241. package/server/routes/telegram.js +163 -163
  242. package/server/routes/user.js +125 -125
  243. package/server/routes/webhooks.js +63 -63
  244. package/server/services/control-room.js +102 -102
  245. package/server/services/diagnostics.js +165 -165
  246. package/server/services/external-access.js +403 -403
  247. package/server/services/install-jobs.js +715 -715
  248. package/server/services/live-view.js +956 -956
  249. package/server/services/managed-runtimes.js +493 -493
  250. package/server/services/model-registry.js +144 -144
  251. package/server/services/notification-orchestrator.js +365 -365
  252. package/server/services/notification-taxonomy.js +204 -204
  253. package/server/services/platformization.js +1052 -1052
  254. package/server/services/production-agent-loop.js +248 -248
  255. package/server/services/provider-cli-versions.js +149 -149
  256. package/server/services/provider-credentials.js +189 -189
  257. package/server/services/provider-models.js +396 -396
  258. package/server/services/public-api-manifest.js +181 -181
  259. package/server/services/qr-login.js +126 -126
  260. package/server/services/remote-connection.js +127 -127
  261. package/server/services/runtime-manager.js +323 -323
  262. package/server/services/startup-update.js +259 -259
  263. package/server/services/telegram/bot.js +393 -393
  264. package/server/services/telegram/control-center.js +2453 -2453
  265. package/server/services/telegram/telegram-gateway.js +314 -314
  266. package/server/services/telegram/telegram-http-client.js +201 -201
  267. package/server/services/telegram/translations.js +470 -470
  268. package/server/services/webhooks.js +216 -216
  269. package/server/sessionManager.js +225 -225
  270. package/server/setup-wizard.js +283 -283
  271. package/server/shared/interfaces.ts +54 -54
  272. package/server/shared/types.ts +172 -172
  273. package/server/shared/utils.ts +193 -193
  274. package/server/tsconfig.json +36 -36
  275. package/server/utils/colors.js +21 -21
  276. package/server/utils/commandParser.js +305 -305
  277. package/server/utils/frontmatter.js +18 -18
  278. package/server/utils/gitConfig.js +34 -34
  279. package/server/utils/plugin-loader.js +461 -461
  280. package/server/utils/plugin-process-manager.js +185 -185
  281. package/server/utils/port-access.js +227 -227
  282. package/server/utils/runtime-paths.js +37 -37
  283. package/server/utils/security-log.js +84 -84
  284. package/server/utils/url-detection.js +71 -71
  285. package/server/vite-daemon.js +79 -79
  286. package/shared/modelConstants.js +161 -161
  287. package/shared/networkHosts.js +22 -22
  288. package/dist/assets/index-DvudRU5X.css +0 -32
@@ -221,22 +221,22 @@ function buildDaemonServiceUnit({ appRoot, serverPort, databasePath, nodeExecPat
221
221
  nodeExecPath,
222
222
  cliEntry,
223
223
  });
224
- return `[Unit]
225
- Description=Pixcode Server
226
- After=network.target
227
-
228
- [Service]
229
- Type=simple
230
- WorkingDirectory=${appRoot}
231
- ExecStart=${execStart}
232
- Environment=HOST=0.0.0.0
233
- Environment=CI=true
234
- Environment=PIXCODE_DAEMON_MANAGED=1
235
- Restart=always
236
- RestartSec=2
237
-
238
- [Install]
239
- WantedBy=default.target
224
+ return `[Unit]
225
+ Description=Pixcode Server
226
+ After=network.target
227
+
228
+ [Service]
229
+ Type=simple
230
+ WorkingDirectory=${appRoot}
231
+ ExecStart=${execStart}
232
+ Environment=HOST=0.0.0.0
233
+ Environment=CI=true
234
+ Environment=PIXCODE_DAEMON_MANAGED=1
235
+ Restart=always
236
+ RestartSec=2
237
+
238
+ [Install]
239
+ WantedBy=default.target
240
240
  `;
241
241
  }
242
242
  function resolveFrontendDaemonEntry(appRoot, cliEntry) {
@@ -277,22 +277,22 @@ function buildFrontendDaemonServiceUnit({ appRoot, frontendPort, nodeExecPath, c
277
277
  nodeExecPath,
278
278
  cliEntry,
279
279
  });
280
- return `[Unit]
281
- Description=Pixcode Frontend (Vite Dev Server)
282
- After=network.target
283
-
284
- [Service]
285
- Type=simple
286
- WorkingDirectory=${appRoot}
287
- ExecStart=${execStart}
288
- Environment=HOST=0.0.0.0
289
- Environment=CI=true
290
- Environment=PIXCODE_DAEMON_MANAGED=1
291
- Restart=always
292
- RestartSec=2
293
-
294
- [Install]
295
- WantedBy=default.target
280
+ return `[Unit]
281
+ Description=Pixcode Frontend (Vite Dev Server)
282
+ After=network.target
283
+
284
+ [Service]
285
+ Type=simple
286
+ WorkingDirectory=${appRoot}
287
+ ExecStart=${execStart}
288
+ Environment=HOST=0.0.0.0
289
+ Environment=CI=true
290
+ Environment=PIXCODE_DAEMON_MANAGED=1
291
+ Restart=always
292
+ RestartSec=2
293
+
294
+ [Install]
295
+ WantedBy=default.target
296
296
  `;
297
297
  }
298
298
  function normalizeState(value) {
@@ -489,38 +489,38 @@ function showDaemonHelp(c, context = {}) {
489
489
  const statusExample = buildDaemonCliCommand({ subcommand: 'status', mode: 'system' }, context);
490
490
  const doctorExample = buildDaemonCliCommand({ subcommand: 'doctor', mode: 'auto' }, context);
491
491
  const logsExample = buildDaemonCliCommand({ subcommand: 'logs', mode: 'system' }, context);
492
- console.log(`
493
- ${c.bright('Pixcode Daemon')} - Persistent Linux service manager
494
-
495
- Usage:
496
- ${usagePrefix} daemon [subcommand] [options]
497
-
498
- Subcommands:
499
- ${c.bright('install')} Install/update unit, reload daemon, enable and start now
500
- ${c.bright('start')} Start the service
501
- ${c.bright('stop')} Stop the service (temporary; auto-start remains enabled)
502
- ${c.bright('restart')} Restart the service
503
- ${c.bright('status')} Show active/enabled state
504
- ${c.bright('logs')} Show recent service logs
505
- ${c.bright('enable')} Enable auto-start at boot
506
- ${c.bright('disable')} Disable auto-start at boot
507
- ${c.bright('uninstall')} Stop, disable, and remove the service unit
508
- ${c.bright('doctor')} Run diagnostics (bus, linger, units, state, port, logs)
509
- ${c.bright('help')} Show this help
510
-
511
- Options:
512
- -p, --port <port> Set service server port (default: 3001)
513
- --frontend-port <port> Start a separate frontend Vite service on this port (legacy/dev)
514
- --single-port, --no-frontend
515
- Serve the built UI from the backend port only (default)
516
- -m, --mode <mode> Service mode: user | system | auto (default: system)
517
- --database-path <path> Set service database path
518
-
519
- Examples:
520
- $ ${installExample}
521
- $ ${statusExample}
522
- $ ${doctorExample}
523
- $ ${logsExample}
492
+ console.log(`
493
+ ${c.bright('Pixcode Daemon')} - Persistent Linux service manager
494
+
495
+ Usage:
496
+ ${usagePrefix} daemon [subcommand] [options]
497
+
498
+ Subcommands:
499
+ ${c.bright('install')} Install/update unit, reload daemon, enable and start now
500
+ ${c.bright('start')} Start the service
501
+ ${c.bright('stop')} Stop the service (temporary; auto-start remains enabled)
502
+ ${c.bright('restart')} Restart the service
503
+ ${c.bright('status')} Show active/enabled state
504
+ ${c.bright('logs')} Show recent service logs
505
+ ${c.bright('enable')} Enable auto-start at boot
506
+ ${c.bright('disable')} Disable auto-start at boot
507
+ ${c.bright('uninstall')} Stop, disable, and remove the service unit
508
+ ${c.bright('doctor')} Run diagnostics (bus, linger, units, state, port, logs)
509
+ ${c.bright('help')} Show this help
510
+
511
+ Options:
512
+ -p, --port <port> Set service server port (default: 3001)
513
+ --frontend-port <port> Start a separate frontend Vite service on this port (legacy/dev)
514
+ --single-port, --no-frontend
515
+ Serve the built UI from the backend port only (default)
516
+ -m, --mode <mode> Service mode: user | system | auto (default: system)
517
+ --database-path <path> Set service database path
518
+
519
+ Examples:
520
+ $ ${installExample}
521
+ $ ${statusExample}
522
+ $ ${doctorExample}
523
+ $ ${logsExample}
524
524
  `);
525
525
  }
526
526
  export function hasInstalledDaemonUnit() {
@@ -453,10 +453,20 @@ async function runRuntimeDirUpdateJob(job, runtimeDir, latestVersion, tarballUrl
453
453
  });
454
454
  return latestVersion;
455
455
  }
456
+ function isNodeVersionSupported() {
457
+ const match = process.version?.match(/^v(\d+)\./);
458
+ if (!match)
459
+ return true; // can't detect, assume ok
460
+ return parseInt(match[1], 10) >= 20;
461
+ }
456
462
  async function runCommandUpdateJob(job, updateCommand, updateCwd) {
457
- appendUpdateJobLog(job, 'meta', `Running: ${updateCommand}\n`);
458
- await new Promise((resolve, reject) => {
459
- const child = spawn(updateCommand, {
463
+ if (!isNodeVersionSupported()) {
464
+ const msg = `Node.js ${process.version} is too old. Pixcode requires Node.js 20+. Please upgrade Node.js first.\n`;
465
+ appendUpdateJobLog(job, 'stderr', msg);
466
+ throw new Error(msg.trim());
467
+ }
468
+ const runCommand = (cmd) => new Promise((resolve, reject) => {
469
+ const child = spawn(cmd, {
460
470
  cwd: updateCwd,
461
471
  env: process.env,
462
472
  shell: true,
@@ -468,15 +478,43 @@ async function runCommandUpdateJob(job, updateCommand, updateCwd) {
468
478
  }
469
479
  catch { /* noop */ }
470
480
  child.stdout?.on('data', (data) => appendUpdateJobLog(job, 'stdout', data.toString()));
471
- child.stderr?.on('data', (data) => appendUpdateJobLog(job, 'stderr', data.toString()));
481
+ let stderrBuf = '';
482
+ child.stderr?.on('data', (data) => {
483
+ const chunk = data.toString();
484
+ stderrBuf += chunk;
485
+ appendUpdateJobLog(job, 'stderr', chunk);
486
+ });
472
487
  child.on('error', reject);
473
488
  child.on('close', (code) => {
474
489
  if (code === 0)
475
490
  resolve();
476
491
  else
477
- reject(new Error(`Update command exited with code ${code}`));
492
+ reject({ code, stderr: stderrBuf });
478
493
  });
479
494
  });
495
+ appendUpdateJobLog(job, 'meta', `Running: ${updateCommand}\n`);
496
+ try {
497
+ await runCommand(updateCommand);
498
+ }
499
+ catch (err) {
500
+ // On Linux/macOS, retry with sudo if the initial attempt failed with EACCES.
501
+ // npm install -g needs write access to /usr/local/lib/node_modules/,
502
+ // which the running user may not have.
503
+ if (process.platform !== 'win32' && (err.stderr?.includes('EACCES') || err.stderr?.includes('permission denied'))) {
504
+ const sudoCmd = `sudo -n ${updateCommand}`;
505
+ appendUpdateJobLog(job, 'meta', `Permission denied. Retrying with sudo...\n`);
506
+ try {
507
+ await runCommand(sudoCmd);
508
+ return;
509
+ }
510
+ catch (sudoErr) {
511
+ appendUpdateJobLog(job, 'stderr', `Sudo update also failed: ${sudoErr.stderr || sudoErr.code}\n`);
512
+ appendUpdateJobLog(job, 'meta', 'Tip: Run the update manually with: sudo npm install -g @pixelbyte-software/pixcode@latest\n');
513
+ throw new Error(`Update command exited with code ${err.code}`);
514
+ }
515
+ }
516
+ throw new Error(`Update command exited with code ${err.code}`);
517
+ }
480
518
  }
481
519
  function readCurrentPackageVersion() {
482
520
  try {
@@ -1573,32 +1611,17 @@ app.use(cors({
1573
1611
  credentials: true,
1574
1612
  exposedHeaders: ['X-Refreshed-Token'],
1575
1613
  }));
1576
- // Security headers middleware (replaces helmet which isn't installed).
1614
+ // Security headers kept lightweight for self-hosted tool compatibility.
1615
+ // CSP removed: it blocked Vite inline modulepreload, Google Fonts, and
1616
+ // IP-based WebSocket access. X-Frame-Options + nosniff are the high-value
1617
+ // headers that don't break anything.
1577
1618
  app.use((req, res, next) => {
1578
1619
  res.setHeader('X-Content-Type-Options', 'nosniff');
1579
1620
  res.setHeader('X-Frame-Options', 'SAMEORIGIN');
1580
1621
  res.setHeader('Referrer-Policy', 'strict-origin-when-cross-origin');
1581
- res.setHeader('X-XSS-Protection', '1; mode=block');
1582
- res.setHeader('Permissions-Policy', 'geolocation=(), microphone=(), camera=()');
1583
- // Strict-Transport-Security only makes sense over HTTPS; skip for plain HTTP
1584
- // so local dev doesn't pin an HSTS policy on localhost.
1585
1622
  if (req.secure || req.headers['x-forwarded-proto'] === 'https') {
1586
1623
  res.setHeader('Strict-Transport-Security', 'max-age=31536000; includeSubDomains');
1587
1624
  }
1588
- // CSP for the SPA shell — relaxed for self-hosted tool accessed from
1589
- // various IPs/hostnames. 'unsafe-inline' + 'unsafe-eval' needed for Vite.
1590
- // ws:/wss: in connect-src allows WebSocket from any origin (IP access).
1591
- res.setHeader('Content-Security-Policy', [
1592
- "default-src 'self'",
1593
- "script-src 'self' 'unsafe-inline' 'unsafe-eval'",
1594
- "style-src 'self' 'unsafe-inline'",
1595
- "img-src 'self' data: blob: https:",
1596
- "font-src 'self' data:",
1597
- "connect-src 'self' ws: wss: http: https:",
1598
- "frame-ancestors 'self'",
1599
- "base-uri 'self'",
1600
- "form-action 'self'",
1601
- ].join('; '));
1602
1625
  next();
1603
1626
  });
1604
1627
  app.use(express.json({
@@ -1621,6 +1644,7 @@ app.get('/health', (req, res) => {
1621
1644
  timestamp: new Date().toISOString(),
1622
1645
  installMode,
1623
1646
  version: SERVER_VERSION,
1647
+ nodeVersion: process.version,
1624
1648
  pendingRestart: updateState.pendingRestart,
1625
1649
  lastAppliedUpdate: updateState.lastAppliedUpdate,
1626
1650
  });
@@ -2334,6 +2358,14 @@ app.post('/api/system/update', authenticateToken, requireAdmin, requireApiScope(
2334
2358
  console.warn('[update] Registry precheck failed:', (err && err.message) || err);
2335
2359
  }
2336
2360
  }
2361
+ // Check Node.js version before starting update
2362
+ if (!isNodeVersionSupported()) {
2363
+ send('log', { stream: 'stderr', chunk: `Node.js ${process.version} is too old. Pixcode requires Node.js 20+.\n` });
2364
+ send('log', { stream: 'meta', chunk: 'Please upgrade Node.js and try again.\n' });
2365
+ send('done', { success: false, error: `Node.js ${process.version} is too old. Pixcode requires Node.js 20+. Please upgrade Node.js first.` });
2366
+ endStream();
2367
+ return;
2368
+ }
2337
2369
  send('log', { stream: 'meta', chunk: `Running: ${updateCommandLabel}\n` });
2338
2370
  // Cross-platform shell invocation. `detached: true` + `unref()` below
2339
2371
  // means the install child survives if this server process gets killed
@@ -2342,7 +2374,7 @@ app.post('/api/system/update', authenticateToken, requireAdmin, requireApiScope(
2342
2374
  // can segfault or the supervisor kills it). Without detachment, a
2343
2375
  // killed parent tears down the npm child too and users end up with
2344
2376
  // a half-installed package and no server at all.
2345
- const child = spawn(updateCommand, {
2377
+ let child = spawn(updateCommand, {
2346
2378
  cwd: updateCwd,
2347
2379
  env: process.env,
2348
2380
  shell: true,
@@ -2368,7 +2400,9 @@ app.post('/api/system/update', authenticateToken, requireAdmin, requireApiScope(
2368
2400
  child.stdout?.on('data', (data) => {
2369
2401
  send('log', { stream: 'stdout', chunk: data.toString() });
2370
2402
  });
2403
+ let stderrBuf = '';
2371
2404
  child.stderr?.on('data', (data) => {
2405
+ stderrBuf += data.toString();
2372
2406
  send('log', { stream: 'stderr', chunk: data.toString() });
2373
2407
  });
2374
2408
  child.on('error', (error) => {
@@ -2378,7 +2412,7 @@ app.post('/api/system/update', authenticateToken, requireAdmin, requireApiScope(
2378
2412
  send('done', { success: false, error: error.message });
2379
2413
  endStream();
2380
2414
  });
2381
- child.on('close', (code) => {
2415
+ child.on('close', async (code) => {
2382
2416
  if (ended)
2383
2417
  return;
2384
2418
  if (clientAborted) {
@@ -2391,13 +2425,61 @@ app.post('/api/system/update', authenticateToken, requireAdmin, requireApiScope(
2391
2425
  version: SERVER_VERSION,
2392
2426
  message: 'Update completed. Restart the server to apply changes.',
2393
2427
  });
2428
+ endStream();
2429
+ return;
2394
2430
  }
2395
- else {
2396
- send('done', {
2397
- success: false,
2398
- error: `Update command exited with code ${code}`,
2399
- });
2431
+ // On Linux/macOS, retry with sudo on EACCES (npm install -g permission error)
2432
+ if (code !== 0 && process.platform !== 'win32' && (stderrBuf.includes('EACCES') || stderrBuf.includes('permission denied'))) {
2433
+ const sudoCmd = `sudo -n ${updateCommand}`;
2434
+ send('log', { stream: 'meta', chunk: 'Permission denied. Retrying with sudo...\n' });
2435
+ try {
2436
+ await new Promise((resolveSudo, rejectSudo) => {
2437
+ let sudoEnded = false;
2438
+ const sudoChild = spawn(sudoCmd, {
2439
+ cwd: updateCwd,
2440
+ env: process.env,
2441
+ shell: true,
2442
+ detached: true,
2443
+ stdio: ['ignore', 'pipe', 'pipe'],
2444
+ });
2445
+ try {
2446
+ sudoChild.unref();
2447
+ }
2448
+ catch { /* noop */ }
2449
+ sudoChild.stdout?.on('data', (d) => send('log', { stream: 'stdout', chunk: d.toString() }));
2450
+ let sudoStderr = '';
2451
+ sudoChild.stderr?.on('data', (d) => { sudoStderr += d.toString(); send('log', { stream: 'stderr', chunk: d.toString() }); });
2452
+ sudoChild.on('error', (e) => { if (!sudoEnded) {
2453
+ sudoEnded = true;
2454
+ rejectSudo(e);
2455
+ } });
2456
+ sudoChild.on('close', (sudoCode) => {
2457
+ if (sudoEnded)
2458
+ return;
2459
+ sudoEnded = true;
2460
+ if (sudoCode === 0)
2461
+ resolveSudo();
2462
+ else
2463
+ rejectSudo(new Error(`Sudo update exited with code ${sudoCode}`));
2464
+ });
2465
+ });
2466
+ send('done', {
2467
+ success: true,
2468
+ version: SERVER_VERSION,
2469
+ message: 'Update completed (with sudo). Restart the server to apply changes.',
2470
+ });
2471
+ endStream();
2472
+ return;
2473
+ }
2474
+ catch (sudoErr) {
2475
+ send('log', { stream: 'stderr', chunk: `Sudo update failed: ${sudoErr.message}\n` });
2476
+ send('log', { stream: 'meta', chunk: 'Tip: Run the update manually with: sudo npm install -g @pixelbyte-software/pixcode@latest\n' });
2477
+ }
2400
2478
  }
2479
+ send('done', {
2480
+ success: false,
2481
+ error: `Update command exited with code ${code}`,
2482
+ });
2401
2483
  endStream();
2402
2484
  });
2403
2485
  });