@pixelbyte-software/pixcode 1.51.8 → 1.51.9

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 (307) 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 +419 -419
  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--kNEhygZ.js → index-Gs7C4hZT.js} +69 -69
  15. package/dist/clear-cache.html +85 -85
  16. package/dist/convert-icons.md +52 -52
  17. package/dist/docs.html +308 -308
  18. package/dist/favicon.svg +8 -8
  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/icon-128x128.svg +9 -9
  26. package/dist/icons/icon-144x144.svg +9 -9
  27. package/dist/icons/icon-152x152.svg +9 -9
  28. package/dist/icons/icon-192x192.svg +9 -9
  29. package/dist/icons/icon-384x384.svg +9 -9
  30. package/dist/icons/icon-512x512.svg +9 -9
  31. package/dist/icons/icon-72x72.svg +9 -9
  32. package/dist/icons/icon-96x96.svg +9 -9
  33. package/dist/icons/icon-template.svg +9 -9
  34. package/dist/icons/qwen-logo.svg +14 -14
  35. package/dist/index.html +58 -58
  36. package/dist/landing.html +268 -268
  37. package/dist/llms-full.txt +119 -119
  38. package/dist/llms.txt +53 -53
  39. package/dist/logo.svg +12 -12
  40. package/dist/manifest.json +60 -60
  41. package/dist/openapi.yaml +1696 -1696
  42. package/dist/orchestration.html +125 -125
  43. package/dist/robots.txt +4 -4
  44. package/dist/site.css +692 -692
  45. package/dist/sitemap.xml +51 -51
  46. package/dist/sw.js +132 -132
  47. package/dist-server/server/cli.js +96 -96
  48. package/dist-server/server/daemon/manager.js +33 -33
  49. package/dist-server/server/daemon-manager.js +64 -64
  50. package/dist-server/server/index.js +91 -65
  51. package/dist-server/server/index.js.map +1 -1
  52. package/dist-server/server/routes/commands.js +25 -25
  53. package/dist-server/server/routes/git.js +17 -17
  54. package/dist-server/server/routes/live-view.js +46 -46
  55. package/dist-server/server/services/hermes-gateway.js +5 -5
  56. package/dist-server/server/services/public-api-manifest.js +51 -51
  57. package/package.json +222 -222
  58. package/scripts/fix-node-pty.js +67 -67
  59. package/scripts/github/create-v1.38-issues.mjs +351 -351
  60. package/scripts/github/create-vscode-workbench-issues.mjs +121 -121
  61. package/scripts/hermes/configure-pixcode-mcp.mjs +165 -165
  62. package/scripts/hermes/pixcode-mcp-server.mjs +1009 -1009
  63. package/scripts/smoke/changes-panel-layout.mjs +48 -48
  64. package/scripts/smoke/chat-composer-fixed-layout.mjs +55 -55
  65. package/scripts/smoke/chat-message-timeline-order.mjs +41 -41
  66. package/scripts/smoke/chat-realtime-hydration.mjs +44 -44
  67. package/scripts/smoke/chat-session-provider-pools.mjs +35 -35
  68. package/scripts/smoke/chat-session-state.mjs +19 -19
  69. package/scripts/smoke/code-editor-theme.mjs +55 -55
  70. package/scripts/smoke/code-editor-vscode-engine.mjs +91 -91
  71. package/scripts/smoke/command-center-agent-writes.mjs +79 -79
  72. package/scripts/smoke/command-center-non-git.mjs +46 -46
  73. package/scripts/smoke/context-packet.mjs +43 -43
  74. package/scripts/smoke/control-room-ux-redesign.mjs +91 -91
  75. package/scripts/smoke/daemon-entrypoint.mjs +20 -20
  76. package/scripts/smoke/default-landing-routing.mjs +33 -33
  77. package/scripts/smoke/desktop-native-notifications.mjs +30 -30
  78. package/scripts/smoke/desktop-tray-icon.mjs +33 -33
  79. package/scripts/smoke/discord-release-workflow.mjs +24 -24
  80. package/scripts/smoke/git-install-update.mjs +255 -255
  81. package/scripts/smoke/handoff-artifact-protocol.mjs +50 -50
  82. package/scripts/smoke/hermes-api-install.mjs +56 -56
  83. package/scripts/smoke/hermes-gateway-persistence.mjs +104 -104
  84. package/scripts/smoke/hermes-mcp-pixcode-roundtrip.mjs +426 -426
  85. package/scripts/smoke/hermes-rest-chat-api.mjs +162 -162
  86. package/scripts/smoke/hermes-rest-chat-live.mjs +45 -45
  87. package/scripts/smoke/hermes-rest-codex-launch.mjs +209 -209
  88. package/scripts/smoke/hermes-rest-gateway.mjs +79 -79
  89. package/scripts/smoke/hermes-rest-live.mjs +42 -42
  90. package/scripts/smoke/hermes-roundtrip.mjs +167 -167
  91. package/scripts/smoke/hermes-settings-commands.mjs +349 -349
  92. package/scripts/smoke/hermes-smoke-launcher-guard.mjs +34 -34
  93. package/scripts/smoke/live-view-diagnostics.mjs +53 -53
  94. package/scripts/smoke/live-view-environment.mjs +92 -92
  95. package/scripts/smoke/live-view-integration.mjs +450 -450
  96. package/scripts/smoke/mac-desktop-runtime.mjs +37 -37
  97. package/scripts/smoke/mobile-tunnel-guidance.mjs +29 -29
  98. package/scripts/smoke/model-registry.mjs +36 -36
  99. package/scripts/smoke/multi-project-ui.mjs +45 -45
  100. package/scripts/smoke/multi-worker-slots.mjs +42 -42
  101. package/scripts/smoke/notification-center.mjs +87 -87
  102. package/scripts/smoke/notification-inapp-preference.mjs +23 -23
  103. package/scripts/smoke/notification-taxonomy.mjs +58 -58
  104. package/scripts/smoke/orchestration-api.mjs +172 -172
  105. package/scripts/smoke/orchestration-execution-dashboard.mjs +33 -33
  106. package/scripts/smoke/orchestration-live-run.mjs +176 -176
  107. package/scripts/smoke/orchestration-mobile-scroll.mjs +29 -29
  108. package/scripts/smoke/orchestration-model-sync.mjs +30 -30
  109. package/scripts/smoke/orchestration-permission-fallback.mjs +34 -34
  110. package/scripts/smoke/orchestration-runtime-guards.mjs +48 -48
  111. package/scripts/smoke/orchestration-user-facing-output.mjs +25 -25
  112. package/scripts/smoke/permission-policy.mjs +50 -50
  113. package/scripts/smoke/pixcode-workbench-1-48.mjs +167 -167
  114. package/scripts/smoke/provider-models-opencode-live.mjs +66 -66
  115. package/scripts/smoke/provider-rest-api.mjs +124 -124
  116. package/scripts/smoke/provider-selection-status.mjs +52 -52
  117. package/scripts/smoke/run-state-refresh.mjs +52 -52
  118. package/scripts/smoke/runtime-manager.mjs +99 -99
  119. package/scripts/smoke/shell-manual-disconnect.mjs +30 -30
  120. package/scripts/smoke/side-panel-editor-layout.mjs +34 -34
  121. package/scripts/smoke/static-root-routing.mjs +21 -21
  122. package/scripts/smoke/strict-handoff-compact.mjs +60 -60
  123. package/scripts/smoke/taskmaster-config.mjs +24 -24
  124. package/scripts/smoke/taskmaster-execution-telegram.mjs +3 -3
  125. package/scripts/smoke/taskmaster-onboarding.mjs +3 -3
  126. package/scripts/smoke/taskmaster-run-graph.mjs +3 -3
  127. package/scripts/smoke/telegram-control.mjs +242 -242
  128. package/scripts/smoke/tunnel-persistence.mjs +56 -56
  129. package/scripts/smoke/update-issue-progress.mjs +69 -69
  130. package/scripts/smoke/update-ux.mjs +55 -55
  131. package/scripts/smoke/v138-completion.mjs +132 -132
  132. package/scripts/smoke/v138-desktop-release-hardening.mjs +69 -69
  133. package/scripts/smoke/v138-diagnostics.mjs +63 -63
  134. package/scripts/smoke/v138-issue-planner.mjs +33 -33
  135. package/scripts/smoke/v143-remote-control.mjs +76 -76
  136. package/scripts/smoke/v144-production-loop.mjs +47 -47
  137. package/scripts/smoke/v145-platformization.mjs +46 -46
  138. package/scripts/smoke/v146-control-room-ui.mjs +150 -150
  139. package/scripts/smoke/version-modal-autoshow.mjs +29 -29
  140. package/scripts/smoke/vscode-workbench-layout.mjs +63 -63
  141. package/scripts/smoke/vscode-workbench-polish.mjs +461 -461
  142. package/scripts/smoke/workflow-fallback-replay.mjs +56 -56
  143. package/scripts/smoke/workflow-templates.mjs +43 -43
  144. package/scripts/smoke/workflow-trace-timeline.mjs +46 -46
  145. package/scripts/update-git-install.mjs +283 -283
  146. package/server/claude-sdk.js +920 -920
  147. package/server/cli.js +1035 -1035
  148. package/server/constants/config.js +4 -4
  149. package/server/cursor-cli.js +344 -344
  150. package/server/daemon/manager.js +563 -563
  151. package/server/daemon-manager.js +964 -964
  152. package/server/database/db.js +895 -895
  153. package/server/database/json-store.js +197 -197
  154. package/server/gemini-cli.js +550 -550
  155. package/server/gemini-response-handler.js +79 -79
  156. package/server/index.js +111 -81
  157. package/server/load-env.js +35 -35
  158. package/server/middleware/auth.js +155 -155
  159. package/server/modules/orchestration/a2a/adapter-registry.ts +108 -108
  160. package/server/modules/orchestration/a2a/adapters/abstract-a2a.adapter.ts +63 -63
  161. package/server/modules/orchestration/a2a/adapters/claude-code.adapter.ts +286 -286
  162. package/server/modules/orchestration/a2a/adapters/codex.adapter.ts +244 -244
  163. package/server/modules/orchestration/a2a/adapters/cursor.adapter.ts +249 -249
  164. package/server/modules/orchestration/a2a/adapters/gemini.adapter.ts +248 -248
  165. package/server/modules/orchestration/a2a/adapters/json-event.adapter.ts +100 -100
  166. package/server/modules/orchestration/a2a/adapters/opencode.adapter.ts +248 -248
  167. package/server/modules/orchestration/a2a/adapters/qwen.adapter.ts +248 -248
  168. package/server/modules/orchestration/a2a/agent-card.ts +55 -55
  169. package/server/modules/orchestration/a2a/routes.ts +590 -590
  170. package/server/modules/orchestration/a2a/task-store.ts +178 -178
  171. package/server/modules/orchestration/a2a/types.ts +126 -126
  172. package/server/modules/orchestration/a2a/validator.ts +113 -113
  173. package/server/modules/orchestration/hermes/hermes.routes.ts +642 -642
  174. package/server/modules/orchestration/index.ts +101 -101
  175. package/server/modules/orchestration/preview/port-watcher.ts +112 -112
  176. package/server/modules/orchestration/preview/preview-proxy.ts +60 -60
  177. package/server/modules/orchestration/preview/types.ts +19 -19
  178. package/server/modules/orchestration/security/permission-policy.ts +401 -401
  179. package/server/modules/orchestration/tasks/orchestration-task-store.ts +41 -41
  180. package/server/modules/orchestration/tasks/orchestration-task.routes.ts +64 -64
  181. package/server/modules/orchestration/tasks/orchestration-task.service.ts +209 -209
  182. package/server/modules/orchestration/tasks/orchestration-task.types.ts +40 -40
  183. package/server/modules/orchestration/tasks/task-run-graph.ts +155 -155
  184. package/server/modules/orchestration/workflows/approval-queue.ts +106 -106
  185. package/server/modules/orchestration/workflows/built-in-workflows.ts +127 -127
  186. package/server/modules/orchestration/workflows/context-packet.ts +186 -186
  187. package/server/modules/orchestration/workflows/handoff-artifact.ts +175 -175
  188. package/server/modules/orchestration/workflows/workflow-fallback-policy.ts +161 -161
  189. package/server/modules/orchestration/workflows/workflow-replay.ts +254 -254
  190. package/server/modules/orchestration/workflows/workflow-runner.ts +2070 -2070
  191. package/server/modules/orchestration/workflows/workflow-store.ts +97 -97
  192. package/server/modules/orchestration/workflows/workflow-templates.ts +272 -272
  193. package/server/modules/orchestration/workflows/workflow-trace.ts +424 -424
  194. package/server/modules/orchestration/workflows/workflow.routes.ts +586 -586
  195. package/server/modules/orchestration/workflows/workflow.types.ts +111 -111
  196. package/server/modules/orchestration/workflows/workspace-target.ts +122 -122
  197. package/server/modules/orchestration/workspace/docker-workspace.ts +136 -136
  198. package/server/modules/orchestration/workspace/path-safety.ts +55 -55
  199. package/server/modules/orchestration/workspace/types.ts +52 -52
  200. package/server/modules/orchestration/workspace/workspace-manager.ts +102 -102
  201. package/server/modules/orchestration/workspace/worktree-workspace.ts +126 -126
  202. package/server/modules/providers/index.ts +2 -2
  203. package/server/modules/providers/list/claude/claude-auth.provider.ts +146 -146
  204. package/server/modules/providers/list/claude/claude-mcp.provider.ts +135 -135
  205. package/server/modules/providers/list/claude/claude-sessions.provider.ts +306 -306
  206. package/server/modules/providers/list/claude/claude.provider.ts +15 -15
  207. package/server/modules/providers/list/codex/codex-auth.provider.ts +117 -117
  208. package/server/modules/providers/list/codex/codex-mcp.provider.ts +135 -135
  209. package/server/modules/providers/list/codex/codex-sessions.provider.ts +319 -319
  210. package/server/modules/providers/list/codex/codex.provider.ts +15 -15
  211. package/server/modules/providers/list/cursor/cursor-auth.provider.ts +147 -147
  212. package/server/modules/providers/list/cursor/cursor-mcp.provider.ts +108 -108
  213. package/server/modules/providers/list/cursor/cursor-sessions.provider.ts +421 -421
  214. package/server/modules/providers/list/cursor/cursor.provider.ts +15 -15
  215. package/server/modules/providers/list/gemini/gemini-auth.provider.ts +173 -173
  216. package/server/modules/providers/list/gemini/gemini-mcp.provider.ts +110 -110
  217. package/server/modules/providers/list/gemini/gemini-sessions.provider.ts +227 -227
  218. package/server/modules/providers/list/gemini/gemini.provider.ts +15 -15
  219. package/server/modules/providers/list/opencode/opencode-auth.provider.ts +131 -131
  220. package/server/modules/providers/list/opencode/opencode-mcp.provider.ts +126 -126
  221. package/server/modules/providers/list/opencode/opencode-sessions.provider.ts +286 -286
  222. package/server/modules/providers/list/opencode/opencode.provider.ts +29 -29
  223. package/server/modules/providers/list/qwen/qwen-auth.provider.ts +146 -146
  224. package/server/modules/providers/list/qwen/qwen-mcp.provider.ts +114 -114
  225. package/server/modules/providers/list/qwen/qwen-sessions.provider.ts +265 -265
  226. package/server/modules/providers/list/qwen/qwen.provider.ts +21 -21
  227. package/server/modules/providers/provider.registry.ts +40 -40
  228. package/server/modules/providers/provider.routes.ts +891 -891
  229. package/server/modules/providers/services/mcp.service.ts +86 -86
  230. package/server/modules/providers/services/provider-auth.service.ts +26 -26
  231. package/server/modules/providers/services/sessions.service.ts +45 -45
  232. package/server/modules/providers/shared/base/abstract.provider.ts +20 -20
  233. package/server/modules/providers/shared/mcp/mcp.provider.ts +151 -151
  234. package/server/modules/providers/shared/provider-configs.ts +142 -142
  235. package/server/modules/providers/tests/mcp.test.ts +293 -293
  236. package/server/openai-codex.js +462 -462
  237. package/server/opencode-cli.js +491 -491
  238. package/server/opencode-response-handler.js +111 -111
  239. package/server/projects.js +3008 -3008
  240. package/server/qwen-code-cli.js +410 -410
  241. package/server/qwen-response-handler.js +73 -73
  242. package/server/routes/agent.js +1435 -1435
  243. package/server/routes/auth.js +142 -142
  244. package/server/routes/codex.js +20 -20
  245. package/server/routes/commands.js +538 -538
  246. package/server/routes/cursor.js +61 -61
  247. package/server/routes/diagnostics.js +41 -41
  248. package/server/routes/gemini.js +25 -25
  249. package/server/routes/git.js +1641 -1641
  250. package/server/routes/live-view.js +387 -387
  251. package/server/routes/mcp-utils.js +13 -13
  252. package/server/routes/messages.js +50 -50
  253. package/server/routes/network.js +117 -117
  254. package/server/routes/platformization.js +182 -182
  255. package/server/routes/plugins.js +320 -320
  256. package/server/routes/production-agent-loop.js +90 -90
  257. package/server/routes/projects.js +911 -911
  258. package/server/routes/public-api.js +34 -34
  259. package/server/routes/qwen.js +27 -27
  260. package/server/routes/remote.js +50 -50
  261. package/server/routes/settings.js +321 -321
  262. package/server/routes/telegram.js +140 -140
  263. package/server/routes/user.js +125 -125
  264. package/server/routes/webhooks.js +63 -63
  265. package/server/services/control-room.js +102 -102
  266. package/server/services/diagnostics.js +165 -165
  267. package/server/services/external-access.js +375 -375
  268. package/server/services/hermes-gateway.js +1562 -1562
  269. package/server/services/hermes-install-jobs.js +729 -729
  270. package/server/services/install-jobs.js +715 -715
  271. package/server/services/live-view.js +956 -956
  272. package/server/services/managed-runtimes.js +493 -493
  273. package/server/services/model-registry.js +144 -144
  274. package/server/services/notification-orchestrator.js +365 -365
  275. package/server/services/notification-taxonomy.js +204 -204
  276. package/server/services/platformization.js +773 -773
  277. package/server/services/production-agent-loop.js +248 -248
  278. package/server/services/provider-cli-versions.js +149 -149
  279. package/server/services/provider-credentials.js +189 -189
  280. package/server/services/provider-models.js +396 -396
  281. package/server/services/public-api-manifest.js +190 -190
  282. package/server/services/remote-connection.js +127 -127
  283. package/server/services/runtime-manager.js +323 -323
  284. package/server/services/startup-update.js +234 -234
  285. package/server/services/telegram/bot.js +331 -331
  286. package/server/services/telegram/control-center.js +979 -979
  287. package/server/services/telegram/telegram-http-client.js +151 -151
  288. package/server/services/telegram/translations.js +340 -340
  289. package/server/services/vapid-keys.js +36 -36
  290. package/server/services/webhooks.js +216 -216
  291. package/server/sessionManager.js +225 -225
  292. package/server/shared/interfaces.ts +54 -54
  293. package/server/shared/types.ts +172 -172
  294. package/server/shared/utils.ts +193 -193
  295. package/server/tsconfig.json +36 -36
  296. package/server/utils/colors.js +21 -21
  297. package/server/utils/commandParser.js +305 -305
  298. package/server/utils/frontmatter.js +18 -18
  299. package/server/utils/gitConfig.js +34 -34
  300. package/server/utils/plugin-loader.js +457 -457
  301. package/server/utils/plugin-process-manager.js +185 -185
  302. package/server/utils/port-access.js +209 -209
  303. package/server/utils/runtime-paths.js +37 -37
  304. package/server/utils/url-detection.js +71 -71
  305. package/server/vite-daemon.js +79 -79
  306. package/shared/modelConstants.js +161 -161
  307. package/shared/networkHosts.js +22 -22
@@ -1,234 +1,234 @@
1
- import fs from 'node:fs';
2
- import path from 'node:path';
3
- import { spawn, spawnSync } from 'node:child_process';
4
- import { Readable } from 'node:stream';
5
-
6
- const packageName = '@pixelbyte-software/pixcode';
7
- const registryUrl = `https://registry.npmjs.org/${encodeURIComponent(packageName)}`;
8
- const startupUpdateAppliedEnv = 'PIXCODE_STARTUP_UPDATE_APPLIED';
9
-
10
- const isTruthyEnv = (value) => /^(1|true|yes|on)$/i.test(String(value || '').trim());
11
-
12
- export function compareVersions(left, right) {
13
- const a = String(left || '0.0.0').replace(/^v/, '').split('.').map(Number);
14
- const b = String(right || '0.0.0').replace(/^v/, '').split('.').map(Number);
15
- for (let i = 0; i < Math.max(a.length, b.length); i += 1) {
16
- const av = Number.isFinite(a[i]) ? a[i] : 0;
17
- const bv = Number.isFinite(b[i]) ? b[i] : 0;
18
- if (av !== bv) return av - bv;
19
- }
20
- return 0;
21
- }
22
-
23
- function commandName(name) {
24
- if (process.platform === 'win32') {
25
- return name === 'npm' ? 'npm.cmd' : `${name}.exe`;
26
- }
27
- return name;
28
- }
29
-
30
- function runCapture(command, args, options = {}) {
31
- const result = spawnSync(command, args, {
32
- cwd: options.cwd,
33
- env: options.env || process.env,
34
- encoding: 'utf8',
35
- shell: false,
36
- });
37
- if (result.error) throw result.error;
38
- if (result.status !== 0) {
39
- throw new Error((result.stderr || result.stdout || `${command} exited with code ${result.status}`).trim());
40
- }
41
- return result.stdout.trim();
42
- }
43
-
44
- function runInherited(command, args, options = {}) {
45
- return new Promise((resolve, reject) => {
46
- const child = spawn(command, args, {
47
- cwd: options.cwd,
48
- env: options.env || process.env,
49
- stdio: 'inherit',
50
- shell: false,
51
- windowsHide: false,
52
- });
53
- child.on('error', reject);
54
- child.on('close', (code) => {
55
- if (code === 0) {
56
- resolve();
57
- return;
58
- }
59
- reject(new Error(`${command} ${args.join(' ')} exited with code ${code}`));
60
- });
61
- });
62
- }
63
-
64
- async function readLatestPackageMetadata() {
65
- const response = await fetch(registryUrl, { headers: { accept: 'application/json' } });
66
- if (!response.ok) throw new Error(`Registry returned HTTP ${response.status}`);
67
- const metadata = await response.json();
68
- const latestVersion = metadata?.['dist-tags']?.latest;
69
- const latestEntry = latestVersion ? metadata?.versions?.[latestVersion] : null;
70
- const tarballUrl = latestEntry?.dist?.tarball;
71
- if (!latestVersion || !tarballUrl) {
72
- throw new Error('Registry response missing latest version or tarball URL.');
73
- }
74
- return { latestVersion, tarballUrl };
75
- }
76
-
77
- async function installNpmGlobal(latestVersion, color) {
78
- const npm = commandName('npm');
79
- color?.info && console.log(`${color.info('[INFO]')} Installing ${packageName}@${latestVersion} globally before opening the port...`);
80
- await runInherited(npm, ['install', '-g', `${packageName}@${latestVersion}`]);
81
- }
82
-
83
- async function updateGitCheckout(appRoot, color) {
84
- const git = commandName('git');
85
- const npm = commandName('npm');
86
- const currentBranch = runCapture(git, ['branch', '--show-current'], { cwd: appRoot });
87
- if (currentBranch !== 'main') {
88
- return { updated: false, skipped: true, reason: `git checkout is on ${currentBranch || 'detached HEAD'}, not main` };
89
- }
90
-
91
- const status = runCapture(git, ['status', '--porcelain'], { cwd: appRoot });
92
- if (status) {
93
- return { updated: false, skipped: true, reason: 'git checkout has local changes' };
94
- }
95
-
96
- color?.info && console.log(`${color.info('[INFO]')} Fetching origin/main before opening the port...`);
97
- await runInherited(git, ['fetch', 'origin', 'main'], { cwd: appRoot });
98
-
99
- const localHead = runCapture(git, ['rev-parse', 'HEAD'], { cwd: appRoot });
100
- const remoteHead = runCapture(git, ['rev-parse', 'origin/main'], { cwd: appRoot });
101
- if (localHead === remoteHead) {
102
- return { updated: false };
103
- }
104
-
105
- color?.info && console.log(`${color.info('[INFO]')} Pulling latest Pixcode from GitHub before opening the port...`);
106
- await runInherited(git, ['pull', '--ff-only', 'origin', 'main'], { cwd: appRoot });
107
-
108
- color?.info && console.log(`${color.info('[INFO]')} Reconciling dependencies after git update...`);
109
- await runInherited(npm, ['install', '--no-audit', '--no-fund'], { cwd: appRoot });
110
- return { updated: true, version: readPackageVersion(appRoot) };
111
- }
112
-
113
- function readPackageVersion(appRoot) {
114
- try {
115
- const raw = fs.readFileSync(path.join(appRoot, 'package.json'), 'utf8');
116
- return JSON.parse(raw).version || null;
117
- } catch {
118
- return null;
119
- }
120
- }
121
-
122
- async function extractRuntimeTarball({ runtimeDir, tarballUrl, latestVersion, currentVersion, color }) {
123
- color?.info && console.log(`${color.info('[INFO]')} Updating runtime ${currentVersion} -> ${latestVersion} before opening the port...`);
124
-
125
- const tarballRes = await fetch(tarballUrl);
126
- if (!tarballRes.ok || !tarballRes.body) {
127
- throw new Error(`Tarball fetch failed: HTTP ${tarballRes.status}`);
128
- }
129
-
130
- const stagingDir = path.join(runtimeDir, '.staging');
131
- const backupDir = path.join(runtimeDir, '.previous');
132
- fs.rmSync(stagingDir, { recursive: true, force: true });
133
- fs.mkdirSync(stagingDir, { recursive: true });
134
-
135
- const tarModule = await import('tar');
136
- const tarExtract = tarModule.x || tarModule.default?.x;
137
- if (!tarExtract) throw new Error('tar extractor not available');
138
-
139
- await new Promise((resolve, reject) => {
140
- const nodeStream = typeof Readable.fromWeb === 'function' && tarballRes.body?.getReader
141
- ? Readable.fromWeb(tarballRes.body)
142
- : tarballRes.body;
143
- const extractor = tarExtract({ cwd: stagingDir, strip: 1 });
144
- nodeStream.pipe(extractor);
145
- extractor.on('finish', resolve);
146
- extractor.on('error', reject);
147
- nodeStream.on('error', reject);
148
- });
149
-
150
- fs.rmSync(backupDir, { recursive: true, force: true });
151
- fs.mkdirSync(backupDir, { recursive: true });
152
- for (const entry of fs.readdirSync(stagingDir)) {
153
- const src = path.join(stagingDir, entry);
154
- const dst = path.join(runtimeDir, entry);
155
- if (fs.existsSync(dst)) {
156
- fs.renameSync(dst, path.join(backupDir, entry));
157
- }
158
- fs.renameSync(src, dst);
159
- }
160
- fs.rmSync(stagingDir, { recursive: true, force: true });
161
-
162
- const depsChanged = (() => {
163
- try {
164
- const prevPkg = JSON.parse(fs.readFileSync(path.join(backupDir, 'package.json'), 'utf8'));
165
- const nextPkg = JSON.parse(fs.readFileSync(path.join(runtimeDir, 'package.json'), 'utf8'));
166
- return JSON.stringify(prevPkg.dependencies || {}) !== JSON.stringify(nextPkg.dependencies || {});
167
- } catch {
168
- return true;
169
- }
170
- })();
171
-
172
- if (depsChanged) {
173
- color?.info && console.log(`${color.info('[INFO]')} Reconciling runtime node_modules...`);
174
- await runInherited(commandName('npm'), ['install', '--production', '--no-audit', '--no-fund', '--no-save'], { cwd: runtimeDir });
175
- }
176
- }
177
-
178
- export async function runStartupAutoUpdate({
179
- appRoot,
180
- currentVersion,
181
- installMode,
182
- color,
183
- } = {}) {
184
- if (isTruthyEnv(process.env.PIXCODE_DISABLE_STARTUP_UPDATE)) {
185
- return { updated: false, skipped: true, reason: 'disabled by PIXCODE_DISABLE_STARTUP_UPDATE' };
186
- }
187
- if (isTruthyEnv(process.env.PIXCODE_SKIP_UPDATE_CHECK)) {
188
- return { updated: false, skipped: true, reason: 'disabled by PIXCODE_SKIP_UPDATE_CHECK' };
189
- }
190
- if (process.env[startupUpdateAppliedEnv] === '1') {
191
- return { updated: false, skipped: true, reason: 'already applied in this launch chain' };
192
- }
193
- if (!appRoot || !currentVersion) {
194
- return { updated: false, skipped: true, reason: 'missing app root or current version' };
195
- }
196
-
197
- try {
198
- if (installMode === 'git') {
199
- return await updateGitCheckout(appRoot, color);
200
- }
201
-
202
- const { latestVersion, tarballUrl } = await readLatestPackageMetadata();
203
- if (compareVersions(latestVersion, currentVersion) <= 0) {
204
- return { updated: false, latestVersion };
205
- }
206
-
207
- if (process.env.PIXCODE_RUNTIME_DIR) {
208
- await extractRuntimeTarball({
209
- runtimeDir: process.env.PIXCODE_RUNTIME_DIR,
210
- tarballUrl,
211
- latestVersion,
212
- currentVersion,
213
- color,
214
- });
215
- return { updated: true, version: latestVersion, restartMode: 'exit42' };
216
- }
217
-
218
- await installNpmGlobal(latestVersion, color);
219
- return { updated: true, version: latestVersion, restartMode: 'reexec' };
220
- } catch (error) {
221
- return {
222
- updated: false,
223
- failed: true,
224
- error: error instanceof Error ? error.message : String(error),
225
- };
226
- }
227
- }
228
-
229
- export function startupUpdateReexecEnv() {
230
- return {
231
- ...process.env,
232
- [startupUpdateAppliedEnv]: '1',
233
- };
234
- }
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { spawn, spawnSync } from 'node:child_process';
4
+ import { Readable } from 'node:stream';
5
+
6
+ const packageName = '@pixelbyte-software/pixcode';
7
+ const registryUrl = `https://registry.npmjs.org/${encodeURIComponent(packageName)}`;
8
+ const startupUpdateAppliedEnv = 'PIXCODE_STARTUP_UPDATE_APPLIED';
9
+
10
+ const isTruthyEnv = (value) => /^(1|true|yes|on)$/i.test(String(value || '').trim());
11
+
12
+ export function compareVersions(left, right) {
13
+ const a = String(left || '0.0.0').replace(/^v/, '').split('.').map(Number);
14
+ const b = String(right || '0.0.0').replace(/^v/, '').split('.').map(Number);
15
+ for (let i = 0; i < Math.max(a.length, b.length); i += 1) {
16
+ const av = Number.isFinite(a[i]) ? a[i] : 0;
17
+ const bv = Number.isFinite(b[i]) ? b[i] : 0;
18
+ if (av !== bv) return av - bv;
19
+ }
20
+ return 0;
21
+ }
22
+
23
+ function commandName(name) {
24
+ if (process.platform === 'win32') {
25
+ return name === 'npm' ? 'npm.cmd' : `${name}.exe`;
26
+ }
27
+ return name;
28
+ }
29
+
30
+ function runCapture(command, args, options = {}) {
31
+ const result = spawnSync(command, args, {
32
+ cwd: options.cwd,
33
+ env: options.env || process.env,
34
+ encoding: 'utf8',
35
+ shell: false,
36
+ });
37
+ if (result.error) throw result.error;
38
+ if (result.status !== 0) {
39
+ throw new Error((result.stderr || result.stdout || `${command} exited with code ${result.status}`).trim());
40
+ }
41
+ return result.stdout.trim();
42
+ }
43
+
44
+ function runInherited(command, args, options = {}) {
45
+ return new Promise((resolve, reject) => {
46
+ const child = spawn(command, args, {
47
+ cwd: options.cwd,
48
+ env: options.env || process.env,
49
+ stdio: 'inherit',
50
+ shell: false,
51
+ windowsHide: false,
52
+ });
53
+ child.on('error', reject);
54
+ child.on('close', (code) => {
55
+ if (code === 0) {
56
+ resolve();
57
+ return;
58
+ }
59
+ reject(new Error(`${command} ${args.join(' ')} exited with code ${code}`));
60
+ });
61
+ });
62
+ }
63
+
64
+ async function readLatestPackageMetadata() {
65
+ const response = await fetch(registryUrl, { headers: { accept: 'application/json' } });
66
+ if (!response.ok) throw new Error(`Registry returned HTTP ${response.status}`);
67
+ const metadata = await response.json();
68
+ const latestVersion = metadata?.['dist-tags']?.latest;
69
+ const latestEntry = latestVersion ? metadata?.versions?.[latestVersion] : null;
70
+ const tarballUrl = latestEntry?.dist?.tarball;
71
+ if (!latestVersion || !tarballUrl) {
72
+ throw new Error('Registry response missing latest version or tarball URL.');
73
+ }
74
+ return { latestVersion, tarballUrl };
75
+ }
76
+
77
+ async function installNpmGlobal(latestVersion, color) {
78
+ const npm = commandName('npm');
79
+ color?.info && console.log(`${color.info('[INFO]')} Installing ${packageName}@${latestVersion} globally before opening the port...`);
80
+ await runInherited(npm, ['install', '-g', `${packageName}@${latestVersion}`]);
81
+ }
82
+
83
+ async function updateGitCheckout(appRoot, color) {
84
+ const git = commandName('git');
85
+ const npm = commandName('npm');
86
+ const currentBranch = runCapture(git, ['branch', '--show-current'], { cwd: appRoot });
87
+ if (currentBranch !== 'main') {
88
+ return { updated: false, skipped: true, reason: `git checkout is on ${currentBranch || 'detached HEAD'}, not main` };
89
+ }
90
+
91
+ const status = runCapture(git, ['status', '--porcelain'], { cwd: appRoot });
92
+ if (status) {
93
+ return { updated: false, skipped: true, reason: 'git checkout has local changes' };
94
+ }
95
+
96
+ color?.info && console.log(`${color.info('[INFO]')} Fetching origin/main before opening the port...`);
97
+ await runInherited(git, ['fetch', 'origin', 'main'], { cwd: appRoot });
98
+
99
+ const localHead = runCapture(git, ['rev-parse', 'HEAD'], { cwd: appRoot });
100
+ const remoteHead = runCapture(git, ['rev-parse', 'origin/main'], { cwd: appRoot });
101
+ if (localHead === remoteHead) {
102
+ return { updated: false };
103
+ }
104
+
105
+ color?.info && console.log(`${color.info('[INFO]')} Pulling latest Pixcode from GitHub before opening the port...`);
106
+ await runInherited(git, ['pull', '--ff-only', 'origin', 'main'], { cwd: appRoot });
107
+
108
+ color?.info && console.log(`${color.info('[INFO]')} Reconciling dependencies after git update...`);
109
+ await runInherited(npm, ['install', '--no-audit', '--no-fund'], { cwd: appRoot });
110
+ return { updated: true, version: readPackageVersion(appRoot) };
111
+ }
112
+
113
+ function readPackageVersion(appRoot) {
114
+ try {
115
+ const raw = fs.readFileSync(path.join(appRoot, 'package.json'), 'utf8');
116
+ return JSON.parse(raw).version || null;
117
+ } catch {
118
+ return null;
119
+ }
120
+ }
121
+
122
+ async function extractRuntimeTarball({ runtimeDir, tarballUrl, latestVersion, currentVersion, color }) {
123
+ color?.info && console.log(`${color.info('[INFO]')} Updating runtime ${currentVersion} -> ${latestVersion} before opening the port...`);
124
+
125
+ const tarballRes = await fetch(tarballUrl);
126
+ if (!tarballRes.ok || !tarballRes.body) {
127
+ throw new Error(`Tarball fetch failed: HTTP ${tarballRes.status}`);
128
+ }
129
+
130
+ const stagingDir = path.join(runtimeDir, '.staging');
131
+ const backupDir = path.join(runtimeDir, '.previous');
132
+ fs.rmSync(stagingDir, { recursive: true, force: true });
133
+ fs.mkdirSync(stagingDir, { recursive: true });
134
+
135
+ const tarModule = await import('tar');
136
+ const tarExtract = tarModule.x || tarModule.default?.x;
137
+ if (!tarExtract) throw new Error('tar extractor not available');
138
+
139
+ await new Promise((resolve, reject) => {
140
+ const nodeStream = typeof Readable.fromWeb === 'function' && tarballRes.body?.getReader
141
+ ? Readable.fromWeb(tarballRes.body)
142
+ : tarballRes.body;
143
+ const extractor = tarExtract({ cwd: stagingDir, strip: 1 });
144
+ nodeStream.pipe(extractor);
145
+ extractor.on('finish', resolve);
146
+ extractor.on('error', reject);
147
+ nodeStream.on('error', reject);
148
+ });
149
+
150
+ fs.rmSync(backupDir, { recursive: true, force: true });
151
+ fs.mkdirSync(backupDir, { recursive: true });
152
+ for (const entry of fs.readdirSync(stagingDir)) {
153
+ const src = path.join(stagingDir, entry);
154
+ const dst = path.join(runtimeDir, entry);
155
+ if (fs.existsSync(dst)) {
156
+ fs.renameSync(dst, path.join(backupDir, entry));
157
+ }
158
+ fs.renameSync(src, dst);
159
+ }
160
+ fs.rmSync(stagingDir, { recursive: true, force: true });
161
+
162
+ const depsChanged = (() => {
163
+ try {
164
+ const prevPkg = JSON.parse(fs.readFileSync(path.join(backupDir, 'package.json'), 'utf8'));
165
+ const nextPkg = JSON.parse(fs.readFileSync(path.join(runtimeDir, 'package.json'), 'utf8'));
166
+ return JSON.stringify(prevPkg.dependencies || {}) !== JSON.stringify(nextPkg.dependencies || {});
167
+ } catch {
168
+ return true;
169
+ }
170
+ })();
171
+
172
+ if (depsChanged) {
173
+ color?.info && console.log(`${color.info('[INFO]')} Reconciling runtime node_modules...`);
174
+ await runInherited(commandName('npm'), ['install', '--production', '--no-audit', '--no-fund', '--no-save'], { cwd: runtimeDir });
175
+ }
176
+ }
177
+
178
+ export async function runStartupAutoUpdate({
179
+ appRoot,
180
+ currentVersion,
181
+ installMode,
182
+ color,
183
+ } = {}) {
184
+ if (isTruthyEnv(process.env.PIXCODE_DISABLE_STARTUP_UPDATE)) {
185
+ return { updated: false, skipped: true, reason: 'disabled by PIXCODE_DISABLE_STARTUP_UPDATE' };
186
+ }
187
+ if (isTruthyEnv(process.env.PIXCODE_SKIP_UPDATE_CHECK)) {
188
+ return { updated: false, skipped: true, reason: 'disabled by PIXCODE_SKIP_UPDATE_CHECK' };
189
+ }
190
+ if (process.env[startupUpdateAppliedEnv] === '1') {
191
+ return { updated: false, skipped: true, reason: 'already applied in this launch chain' };
192
+ }
193
+ if (!appRoot || !currentVersion) {
194
+ return { updated: false, skipped: true, reason: 'missing app root or current version' };
195
+ }
196
+
197
+ try {
198
+ if (installMode === 'git') {
199
+ return await updateGitCheckout(appRoot, color);
200
+ }
201
+
202
+ const { latestVersion, tarballUrl } = await readLatestPackageMetadata();
203
+ if (compareVersions(latestVersion, currentVersion) <= 0) {
204
+ return { updated: false, latestVersion };
205
+ }
206
+
207
+ if (process.env.PIXCODE_RUNTIME_DIR) {
208
+ await extractRuntimeTarball({
209
+ runtimeDir: process.env.PIXCODE_RUNTIME_DIR,
210
+ tarballUrl,
211
+ latestVersion,
212
+ currentVersion,
213
+ color,
214
+ });
215
+ return { updated: true, version: latestVersion, restartMode: 'exit42' };
216
+ }
217
+
218
+ await installNpmGlobal(latestVersion, color);
219
+ return { updated: true, version: latestVersion, restartMode: 'reexec' };
220
+ } catch (error) {
221
+ return {
222
+ updated: false,
223
+ failed: true,
224
+ error: error instanceof Error ? error.message : String(error),
225
+ };
226
+ }
227
+ }
228
+
229
+ export function startupUpdateReexecEnv() {
230
+ return {
231
+ ...process.env,
232
+ [startupUpdateAppliedEnv]: '1',
233
+ };
234
+ }