@adea-ai/app-framework 0.0.0-stage → 0.24.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (474) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +30 -0
  3. package/README.md +967 -2
  4. package/dist/app/application.d.ts +47 -0
  5. package/dist/app/application.js +115 -0
  6. package/dist/app/create-application.d.ts +13 -0
  7. package/dist/app/create-application.js +178 -0
  8. package/dist/app/service-registry.d.ts +44 -0
  9. package/dist/app/service-registry.js +116 -0
  10. package/dist/appearance/appearance-host.d.ts +62 -0
  11. package/dist/appearance/appearance-host.js +115 -0
  12. package/dist/appearance/appearance-preferences.d.ts +106 -0
  13. package/dist/appearance/appearance-preferences.js +175 -0
  14. package/dist/appearance/composition.d.ts +11 -0
  15. package/dist/appearance/composition.js +16 -0
  16. package/dist/appearance/custom-theme-import.d.ts +14 -0
  17. package/dist/appearance/custom-theme-import.js +315 -0
  18. package/dist/appearance/custom-theme-library.d.ts +146 -0
  19. package/dist/appearance/custom-theme-library.js +378 -0
  20. package/dist/appearance/editor.d.ts +20 -0
  21. package/dist/appearance/editor.js +47 -0
  22. package/dist/appearance/theme-file-importer.d.ts +23 -0
  23. package/dist/appearance/theme-file-importer.js +66 -0
  24. package/dist/appearance/theme-record-adapter.d.ts +26 -0
  25. package/dist/appearance/theme-record-adapter.js +64 -0
  26. package/dist/appearance/theme-registry.d.ts +10 -0
  27. package/dist/appearance/theme-registry.js +16 -0
  28. package/dist/appearance/window-surface.d.ts +5 -0
  29. package/dist/appearance/window-surface.js +9 -0
  30. package/dist/ci/toolchain-identity.d.ts +39 -0
  31. package/dist/ci/toolchain-identity.js +196 -0
  32. package/dist/cli/cef-helper-cli.d.ts +2 -0
  33. package/dist/cli/cef-helper-cli.js +18 -0
  34. package/dist/cli/cli-runner.d.ts +8 -0
  35. package/dist/cli/cli-runner.js +23 -0
  36. package/dist/cli/create-application-cli.d.ts +2 -0
  37. package/dist/cli/create-application-cli.js +40 -0
  38. package/dist/cli/electrobun-shortcut-patch-cli.d.ts +2 -0
  39. package/dist/cli/electrobun-shortcut-patch-cli.js +17 -0
  40. package/dist/cli/framework-update-cli.d.ts +2 -0
  41. package/dist/cli/framework-update-cli.js +40 -0
  42. package/dist/cli/release-assets-plan-cli.d.ts +2 -0
  43. package/dist/cli/release-assets-plan-cli.js +14 -0
  44. package/dist/cli/release-cut-cli.d.ts +2 -0
  45. package/dist/cli/release-cut-cli.js +27 -0
  46. package/dist/cli/release-descriptor-staging-cli.d.ts +2 -0
  47. package/dist/cli/release-descriptor-staging-cli.js +45 -0
  48. package/dist/cli/release-finalize-cli.d.ts +1 -0
  49. package/dist/cli/release-finalize-cli.js +30 -0
  50. package/dist/cli/release-promote-cli.d.ts +2 -0
  51. package/dist/cli/release-promote-cli.js +32 -0
  52. package/dist/cli/release-publish-cli.d.ts +2 -0
  53. package/dist/cli/release-publish-cli.js +48 -0
  54. package/dist/cli/release-sign-cli.d.ts +2 -0
  55. package/dist/cli/release-sign-cli.js +13 -0
  56. package/dist/cli/release-step-cli.d.ts +2 -0
  57. package/dist/cli/release-step-cli.js +44 -0
  58. package/dist/cli/toolchain-identity-cli.d.ts +2 -0
  59. package/dist/cli/toolchain-identity-cli.js +10 -0
  60. package/dist/cli/update-helper-cli.d.ts +1 -0
  61. package/dist/cli/update-helper-cli.js +10 -0
  62. package/dist/cli/windows-runtime-patch-cli.d.ts +2 -0
  63. package/dist/cli/windows-runtime-patch-cli.js +17 -0
  64. package/dist/desktop/application-command-client.d.ts +15 -0
  65. package/dist/desktop/application-command-client.js +21 -0
  66. package/dist/desktop/channel-handshake.d.ts +32 -0
  67. package/dist/desktop/channel-handshake.js +111 -0
  68. package/dist/desktop/channel-proof.d.ts +43 -0
  69. package/dist/desktop/channel-proof.js +85 -0
  70. package/dist/desktop/client-assets.d.ts +7 -0
  71. package/dist/desktop/client-assets.js +59 -0
  72. package/dist/desktop/desktop-client.d.ts +23 -0
  73. package/dist/desktop/desktop-client.js +231 -0
  74. package/dist/desktop/desktop-gateway.d.ts +18 -0
  75. package/dist/desktop/desktop-gateway.js +146 -0
  76. package/dist/desktop/desktop-host.d.ts +48 -0
  77. package/dist/desktop/desktop-host.js +208 -0
  78. package/dist/desktop/desktop-stream.d.ts +36 -0
  79. package/dist/desktop/desktop-stream.js +231 -0
  80. package/dist/desktop/loopback-policy.d.ts +19 -0
  81. package/dist/desktop/loopback-policy.js +23 -0
  82. package/dist/desktop/open-url-channel.d.ts +15 -0
  83. package/dist/desktop/open-url-channel.js +55 -0
  84. package/dist/desktop/string-policy.d.ts +2 -0
  85. package/dist/desktop/string-policy.js +11 -0
  86. package/dist/framework-source.json +1 -0
  87. package/dist/installer/archive-entry.d.ts +6 -0
  88. package/dist/installer/archive-entry.js +14 -0
  89. package/dist/installer/command-artifact.d.ts +47 -0
  90. package/dist/installer/command-artifact.js +261 -0
  91. package/dist/installer/command-qualification-command.d.ts +12 -0
  92. package/dist/installer/command-qualification-command.js +71 -0
  93. package/dist/installer/hosted-runner.d.ts +4 -0
  94. package/dist/installer/hosted-runner.js +10 -0
  95. package/dist/installer/installed-payload.d.ts +29 -0
  96. package/dist/installer/installed-payload.js +312 -0
  97. package/dist/installer/installer-ci-bootstrap.d.ts +26 -0
  98. package/dist/installer/installer-ci-bootstrap.js +160 -0
  99. package/dist/installer/installer-ci-preflight.d.ts +1 -0
  100. package/dist/installer/installer-ci-preflight.js +49 -0
  101. package/dist/installer/installer-ci-worker.d.ts +1 -0
  102. package/dist/installer/installer-ci-worker.js +105 -0
  103. package/dist/installer/installer-extraction.d.ts +14 -0
  104. package/dist/installer/installer-extraction.js +289 -0
  105. package/dist/installer/installer-fetch-guard.d.ts +15 -0
  106. package/dist/installer/installer-fetch-guard.js +50 -0
  107. package/dist/installer/installer-identity.d.ts +23 -0
  108. package/dist/installer/installer-identity.js +286 -0
  109. package/dist/installer/installer-layout.d.ts +21 -0
  110. package/dist/installer/installer-layout.js +89 -0
  111. package/dist/installer/installer-observation.d.ts +64 -0
  112. package/dist/installer/installer-observation.js +473 -0
  113. package/dist/installer/installer-process-cleanup.d.ts +18 -0
  114. package/dist/installer/installer-process-cleanup.js +158 -0
  115. package/dist/installer/installer-qualification-command.d.ts +11 -0
  116. package/dist/installer/installer-qualification-command.js +71 -0
  117. package/dist/installer/installer-renderer-evidence.d.ts +43 -0
  118. package/dist/installer/installer-renderer-evidence.js +136 -0
  119. package/dist/installer/installer-upgrade-command.d.ts +37 -0
  120. package/dist/installer/installer-upgrade-command.js +172 -0
  121. package/dist/installer/installer-worker-guard.d.ts +21 -0
  122. package/dist/installer/installer-worker-guard.js +72 -0
  123. package/dist/installer/native-executable.d.ts +5 -0
  124. package/dist/installer/native-executable.js +21 -0
  125. package/dist/installer/upgrade-asset-download.d.ts +13 -0
  126. package/dist/installer/upgrade-asset-download.js +41 -0
  127. package/dist/installer/write-all.d.ts +6 -0
  128. package/dist/installer/write-all.js +11 -0
  129. package/dist/native/app-bundle.d.ts +28 -0
  130. package/dist/native/app-bundle.js +60 -0
  131. package/dist/native/cef-helper.d.ts +28 -0
  132. package/dist/native/cef-helper.js +402 -0
  133. package/dist/native/desktop-build-hook.d.ts +7 -0
  134. package/dist/native/desktop-build-hook.js +20 -0
  135. package/dist/native/electrobun-source-patch.d.ts +25 -0
  136. package/dist/native/electrobun-source-patch.js +93 -0
  137. package/dist/native/linux-cef-links.d.ts +2 -0
  138. package/dist/native/linux-cef-links.js +15 -0
  139. package/dist/native/native-secret-store.d.ts +27 -0
  140. package/dist/native/native-secret-store.js +70 -0
  141. package/dist/native/native-utilities.d.ts +24 -0
  142. package/dist/native/native-utilities.js +85 -0
  143. package/dist/native/partitioned-window.d.ts +34 -0
  144. package/dist/native/partitioned-window.js +44 -0
  145. package/dist/native/renderer-profile.d.ts +53 -0
  146. package/dist/native/renderer-profile.js +30 -0
  147. package/dist/native/secure-window.d.ts +38 -0
  148. package/dist/native/secure-window.js +77 -0
  149. package/dist/native/sidecar-services.d.ts +23 -0
  150. package/dist/native/sidecar-services.js +46 -0
  151. package/dist/native/sidecar.d.ts +81 -0
  152. package/dist/native/sidecar.js +250 -0
  153. package/dist/native/window-bootstrap.d.ts +24 -0
  154. package/dist/native/window-bootstrap.js +63 -0
  155. package/dist/native/window-options.d.ts +32 -0
  156. package/dist/native/window-options.js +23 -0
  157. package/dist/native/windows-build-hook-internal.d.ts +2 -0
  158. package/dist/native/windows-build-hook-internal.js +32 -0
  159. package/dist/native/windows-build-hook.d.ts +2 -0
  160. package/dist/native/windows-build-hook.js +12 -0
  161. package/dist/native/windows-runtime-patch-internal.d.ts +3 -0
  162. package/dist/native/windows-runtime-patch-internal.js +20 -0
  163. package/dist/native/windows-runtime-patch.d.ts +4 -0
  164. package/dist/native/windows-runtime-patch.js +12 -0
  165. package/dist/release/feed-release-cut.d.ts +23 -0
  166. package/dist/release/feed-release-cut.js +93 -0
  167. package/dist/release/feed-state.d.ts +25 -0
  168. package/dist/release/feed-state.js +81 -0
  169. package/dist/release/framework-package-publish.d.ts +21 -0
  170. package/dist/release/framework-package-publish.js +125 -0
  171. package/dist/release/framework-update.d.ts +30 -0
  172. package/dist/release/framework-update.js +139 -0
  173. package/dist/release/github-cli.d.ts +6 -0
  174. package/dist/release/github-cli.js +16 -0
  175. package/dist/release/github-release-assets.d.ts +3 -0
  176. package/dist/release/github-release-assets.js +24 -0
  177. package/dist/release/github-release-cut.d.ts +14 -0
  178. package/dist/release/github-release-cut.js +174 -0
  179. package/dist/release/github-release-lookup.d.ts +7 -0
  180. package/dist/release/github-release-lookup.js +29 -0
  181. package/dist/release/github-release-promotion.d.ts +10 -0
  182. package/dist/release/github-release-promotion.js +78 -0
  183. package/dist/release/github-release-provenance.d.ts +9 -0
  184. package/dist/release/github-release-provenance.js +27 -0
  185. package/dist/release/github-release-publisher.d.ts +9 -0
  186. package/dist/release/github-release-publisher.js +63 -0
  187. package/dist/release/github-release-qualification.d.ts +12 -0
  188. package/dist/release/github-release-qualification.js +80 -0
  189. package/dist/release/local-provenance.d.ts +24 -0
  190. package/dist/release/local-provenance.js +72 -0
  191. package/dist/release/local-release.d.ts +133 -0
  192. package/dist/release/local-release.js +387 -0
  193. package/dist/release/macos-dmg.d.ts +22 -0
  194. package/dist/release/macos-dmg.js +91 -0
  195. package/dist/release/release-artifact.d.ts +6 -0
  196. package/dist/release/release-artifact.js +38 -0
  197. package/dist/release/release-assets-plan.d.ts +14 -0
  198. package/dist/release/release-assets-plan.js +65 -0
  199. package/dist/release/release-config.d.ts +76 -0
  200. package/dist/release/release-config.js +180 -0
  201. package/dist/release/release-cut-command.d.ts +13 -0
  202. package/dist/release/release-cut-command.js +39 -0
  203. package/dist/release/release-cut.d.ts +54 -0
  204. package/dist/release/release-cut.js +76 -0
  205. package/dist/release/release-descriptor-staging.d.ts +34 -0
  206. package/dist/release/release-descriptor-staging.js +147 -0
  207. package/dist/release/release-finalize.d.ts +16 -0
  208. package/dist/release/release-finalize.js +104 -0
  209. package/dist/release/release-promotion-command.d.ts +12 -0
  210. package/dist/release/release-promotion-command.js +28 -0
  211. package/dist/release/release-promotion.d.ts +29 -0
  212. package/dist/release/release-promotion.js +57 -0
  213. package/dist/release/release-publication.d.ts +33 -0
  214. package/dist/release/release-publication.js +138 -0
  215. package/dist/release/release-publish-command.d.ts +7 -0
  216. package/dist/release/release-publish-command.js +91 -0
  217. package/dist/release/release-qualification.d.ts +106 -0
  218. package/dist/release/release-qualification.js +135 -0
  219. package/dist/release/release-staging.d.ts +9 -0
  220. package/dist/release/release-staging.js +61 -0
  221. package/dist/release/release-steps.d.ts +38 -0
  222. package/dist/release/release-steps.js +147 -0
  223. package/dist/release/retained-release-build.d.ts +19 -0
  224. package/dist/release/retained-release-build.js +122 -0
  225. package/dist/shell/app-shell.d.ts +61 -0
  226. package/dist/shell/app-shell.js +318 -0
  227. package/dist/shell/app-utilities.d.ts +122 -0
  228. package/dist/shell/app-utilities.js +334 -0
  229. package/dist/shell/application-menu-commands.d.ts +5 -0
  230. package/dist/shell/application-menu-commands.js +11 -0
  231. package/dist/shell/application-menu.d.ts +61 -0
  232. package/dist/shell/application-menu.js +208 -0
  233. package/dist/shell/help-shortcuts.d.ts +12 -0
  234. package/dist/shell/help-shortcuts.js +22 -0
  235. package/dist/shell/settings-sections.d.ts +31 -0
  236. package/dist/shell/settings-sections.js +50 -0
  237. package/dist/shell/shortcut-platform.d.ts +17 -0
  238. package/dist/shell/shortcut-platform.js +25 -0
  239. package/dist/update-helper.bundle.js +260 -0
  240. package/dist/updates/channel-update-manager.d.ts +46 -0
  241. package/dist/updates/channel-update-manager.js +114 -0
  242. package/dist/updates/desktop-updater.d.ts +104 -0
  243. package/dist/updates/desktop-updater.js +345 -0
  244. package/dist/updates/release-feed.d.ts +61 -0
  245. package/dist/updates/release-feed.js +111 -0
  246. package/dist/updates/release-location.d.ts +9 -0
  247. package/dist/updates/release-location.js +80 -0
  248. package/dist/updates/release-version.d.ts +12 -0
  249. package/dist/updates/release-version.js +43 -0
  250. package/dist/updates/signed-release.d.ts +63 -0
  251. package/dist/updates/signed-release.js +162 -0
  252. package/dist/updates/stable-file.d.ts +10 -0
  253. package/dist/updates/stable-file.js +22 -0
  254. package/dist/updates/update-adapter.d.ts +57 -0
  255. package/dist/updates/update-adapter.js +72 -0
  256. package/dist/updates/update-arm.d.ts +24 -0
  257. package/dist/updates/update-arm.js +95 -0
  258. package/dist/updates/update-channel-store.d.ts +8 -0
  259. package/dist/updates/update-channel-store.js +72 -0
  260. package/dist/updates/update-discovery.d.ts +13 -0
  261. package/dist/updates/update-discovery.js +56 -0
  262. package/dist/updates/update-download.d.ts +14 -0
  263. package/dist/updates/update-download.js +67 -0
  264. package/dist/updates/update-exclusive-rename.d.ts +2 -0
  265. package/dist/updates/update-exclusive-rename.js +52 -0
  266. package/dist/updates/update-extraction.d.ts +18 -0
  267. package/dist/updates/update-extraction.js +183 -0
  268. package/dist/updates/update-handoff-plan.d.ts +22 -0
  269. package/dist/updates/update-handoff-plan.js +28 -0
  270. package/dist/updates/update-helper.d.ts +24 -0
  271. package/dist/updates/update-helper.js +56 -0
  272. package/dist/updates/update-launch.d.ts +5 -0
  273. package/dist/updates/update-launch.js +27 -0
  274. package/dist/updates/update-manager.d.ts +40 -0
  275. package/dist/updates/update-manager.js +83 -0
  276. package/dist/updates/update-process-fence.d.ts +10 -0
  277. package/dist/updates/update-process-fence.js +114 -0
  278. package/dist/updates/update-resume.d.ts +13 -0
  279. package/dist/updates/update-resume.js +34 -0
  280. package/dist/updates/update-shutdown.d.ts +15 -0
  281. package/dist/updates/update-shutdown.js +29 -0
  282. package/dist/updates/update-state.d.ts +30 -0
  283. package/dist/updates/update-state.js +18 -0
  284. package/dist/updates/update-swap-stage.d.ts +27 -0
  285. package/dist/updates/update-swap-stage.js +58 -0
  286. package/dist/updates/update-swap.d.ts +10 -0
  287. package/dist/updates/update-swap.js +30 -0
  288. package/dist/views/app-about.d.ts +22 -0
  289. package/dist/views/app-about.js +43 -0
  290. package/dist/views/app-appearance.d.ts +11 -0
  291. package/dist/views/app-appearance.js +42 -0
  292. package/dist/views/app-help.d.ts +17 -0
  293. package/dist/views/app-help.js +42 -0
  294. package/dist/views/app-settings.d.ts +26 -0
  295. package/dist/views/app-settings.js +97 -0
  296. package/dist/views/appearance-surface.d.ts +9 -0
  297. package/dist/views/appearance-surface.js +334 -0
  298. package/dist/views/update-surface.d.ts +34 -0
  299. package/dist/views/update-surface.js +64 -0
  300. package/package.json +363 -4
  301. package/src/app/application.tsx +138 -0
  302. package/src/app/create-application.ts +245 -0
  303. package/src/app/service-registry.ts +124 -0
  304. package/src/appearance/appearance-host.tsx +205 -0
  305. package/src/appearance/appearance-preferences.ts +287 -0
  306. package/src/appearance/composition.ts +29 -0
  307. package/src/appearance/custom-theme-import.ts +424 -0
  308. package/src/appearance/custom-theme-library.ts +600 -0
  309. package/src/appearance/editor.ts +94 -0
  310. package/src/appearance/theme-file-importer.ts +103 -0
  311. package/src/appearance/theme-record-adapter.ts +106 -0
  312. package/src/appearance/theme-registry.ts +20 -0
  313. package/src/appearance/window-surface.ts +18 -0
  314. package/src/ci/toolchain-identity.ts +244 -0
  315. package/src/cli/cef-helper-cli.ts +21 -0
  316. package/src/cli/cli-runner.ts +29 -0
  317. package/src/cli/create-application-cli.ts +62 -0
  318. package/src/cli/electrobun-shortcut-patch-cli.ts +24 -0
  319. package/src/cli/framework-update-cli.ts +41 -0
  320. package/src/cli/release-assets-plan-cli.ts +14 -0
  321. package/src/cli/release-cut-cli.ts +41 -0
  322. package/src/cli/release-descriptor-staging-cli.ts +57 -0
  323. package/src/cli/release-finalize-cli.ts +34 -0
  324. package/src/cli/release-promote-cli.ts +31 -0
  325. package/src/cli/release-publish-cli.ts +46 -0
  326. package/src/cli/release-sign-cli.ts +24 -0
  327. package/src/cli/release-step-cli.ts +71 -0
  328. package/src/cli/toolchain-identity-cli.ts +12 -0
  329. package/src/cli/update-helper-cli.ts +12 -0
  330. package/src/cli/windows-runtime-patch-cli.ts +17 -0
  331. package/src/desktop/application-command-client.ts +43 -0
  332. package/src/desktop/channel-handshake.ts +136 -0
  333. package/src/desktop/channel-proof.ts +122 -0
  334. package/src/desktop/client-assets.ts +75 -0
  335. package/src/desktop/desktop-client.ts +303 -0
  336. package/src/desktop/desktop-gateway.ts +189 -0
  337. package/src/desktop/desktop-host.ts +335 -0
  338. package/src/desktop/desktop-stream.ts +324 -0
  339. package/src/desktop/loopback-policy.ts +41 -0
  340. package/src/desktop/open-url-channel.ts +79 -0
  341. package/src/desktop/string-policy.ts +9 -0
  342. package/src/installer/archive-entry.ts +32 -0
  343. package/src/installer/command-artifact.ts +307 -0
  344. package/src/installer/command-qualification-command.ts +75 -0
  345. package/src/installer/hosted-runner.ts +11 -0
  346. package/src/installer/installed-payload.ts +408 -0
  347. package/src/installer/installer-ci-bootstrap.ts +199 -0
  348. package/src/installer/installer-ci-preflight.ts +61 -0
  349. package/src/installer/installer-ci-worker.ts +105 -0
  350. package/src/installer/installer-extraction.ts +367 -0
  351. package/src/installer/installer-fetch-guard.ts +75 -0
  352. package/src/installer/installer-identity.ts +331 -0
  353. package/src/installer/installer-layout.ts +167 -0
  354. package/src/installer/installer-observation.ts +671 -0
  355. package/src/installer/installer-process-cleanup.ts +167 -0
  356. package/src/installer/installer-qualification-command.ts +81 -0
  357. package/src/installer/installer-renderer-evidence.ts +268 -0
  358. package/src/installer/installer-upgrade-command.ts +226 -0
  359. package/src/installer/installer-worker-guard.ts +112 -0
  360. package/src/installer/native-executable.ts +37 -0
  361. package/src/installer/upgrade-asset-download.ts +72 -0
  362. package/src/installer/write-all.ts +19 -0
  363. package/src/native/app-bundle.ts +86 -0
  364. package/src/native/cef-helper.ts +471 -0
  365. package/src/native/desktop-build-hook.ts +21 -0
  366. package/src/native/electrobun-cef-main-frame-bridges.patch +63 -0
  367. package/src/native/electrobun-source-patch.ts +107 -0
  368. package/src/native/electrobun-windows-shortcut-com.patch +923 -0
  369. package/src/native/linux-cef-links.ts +14 -0
  370. package/src/native/native-secret-store.ts +99 -0
  371. package/src/native/native-utilities.ts +166 -0
  372. package/src/native/partitioned-window.ts +62 -0
  373. package/src/native/renderer-profile.ts +27 -0
  374. package/src/native/secure-window.ts +115 -0
  375. package/src/native/sidecar-services.ts +71 -0
  376. package/src/native/sidecar.ts +387 -0
  377. package/src/native/window-bootstrap.ts +77 -0
  378. package/src/native/window-options.ts +24 -0
  379. package/src/native/windows-build-hook-internal.ts +49 -0
  380. package/src/native/windows-build-hook.ts +12 -0
  381. package/src/native/windows-runtime-patch-internal.ts +48 -0
  382. package/src/native/windows-runtime-patch.ts +15 -0
  383. package/src/release/feed-release-cut.ts +110 -0
  384. package/src/release/feed-state.ts +135 -0
  385. package/src/release/framework-package-publish.ts +163 -0
  386. package/src/release/framework-update.ts +196 -0
  387. package/src/release/github-cli.ts +27 -0
  388. package/src/release/github-release-assets.ts +36 -0
  389. package/src/release/github-release-cut.ts +237 -0
  390. package/src/release/github-release-lookup.ts +39 -0
  391. package/src/release/github-release-promotion.ts +112 -0
  392. package/src/release/github-release-provenance.ts +65 -0
  393. package/src/release/github-release-publisher.ts +90 -0
  394. package/src/release/github-release-qualification.ts +144 -0
  395. package/src/release/local-provenance.ts +92 -0
  396. package/src/release/local-release.ts +525 -0
  397. package/src/release/macos-dmg.ts +113 -0
  398. package/src/release/release-artifact.ts +53 -0
  399. package/src/release/release-assets-plan.ts +118 -0
  400. package/src/release/release-config.ts +420 -0
  401. package/src/release/release-cut-command.ts +80 -0
  402. package/src/release/release-cut.ts +133 -0
  403. package/src/release/release-descriptor-staging.ts +242 -0
  404. package/src/release/release-finalize.ts +191 -0
  405. package/src/release/release-promotion-command.ts +36 -0
  406. package/src/release/release-promotion.ts +132 -0
  407. package/src/release/release-publication.ts +213 -0
  408. package/src/release/release-publish-command.ts +163 -0
  409. package/src/release/release-qualification.ts +397 -0
  410. package/src/release/release-staging.ts +87 -0
  411. package/src/release/release-steps.ts +173 -0
  412. package/src/release/retained-release-build.ts +217 -0
  413. package/src/shell/app-shell.tsx +285 -0
  414. package/src/shell/app-utilities.tsx +437 -0
  415. package/src/shell/application-menu-commands.ts +6 -0
  416. package/src/shell/application-menu.ts +250 -0
  417. package/src/shell/help-shortcuts.ts +24 -0
  418. package/src/shell/settings-sections.ts +74 -0
  419. package/src/shell/shortcut-platform.ts +35 -0
  420. package/src/updates/channel-update-manager.ts +127 -0
  421. package/src/updates/desktop-updater.ts +440 -0
  422. package/src/updates/release-feed.ts +187 -0
  423. package/src/updates/release-location.ts +101 -0
  424. package/src/updates/release-version.ts +57 -0
  425. package/src/updates/signed-release.ts +311 -0
  426. package/src/updates/stable-file.ts +32 -0
  427. package/src/updates/update-adapter.ts +129 -0
  428. package/src/updates/update-arm.ts +107 -0
  429. package/src/updates/update-channel-store.ts +86 -0
  430. package/src/updates/update-discovery.ts +113 -0
  431. package/src/updates/update-download.ts +82 -0
  432. package/src/updates/update-exclusive-rename.ts +58 -0
  433. package/src/updates/update-extraction.ts +261 -0
  434. package/src/updates/update-handoff-plan.ts +75 -0
  435. package/src/updates/update-helper.ts +87 -0
  436. package/src/updates/update-launch.ts +33 -0
  437. package/src/updates/update-manager.ts +130 -0
  438. package/src/updates/update-process-fence.ts +125 -0
  439. package/src/updates/update-resume.ts +34 -0
  440. package/src/updates/update-shutdown.ts +37 -0
  441. package/src/updates/update-state.ts +34 -0
  442. package/src/updates/update-swap-stage.ts +75 -0
  443. package/src/updates/update-swap.ts +30 -0
  444. package/src/views/app-about.tsx +44 -0
  445. package/src/views/app-appearance.tsx +32 -0
  446. package/src/views/app-help.tsx +43 -0
  447. package/src/views/app-settings.tsx +88 -0
  448. package/src/views/appearance-surface.tsx +427 -0
  449. package/src/views/update-surface.tsx +85 -0
  450. package/templates/application/.gitattributes +1 -0
  451. package/templates/application/.github/workflows/release-assets.yml +29 -0
  452. package/templates/application/.github/workflows/release-finalize.yml +29 -0
  453. package/templates/application/.github/workflows/release-please.yml +19 -0
  454. package/templates/application/.github/workflows/release.yml +29 -0
  455. package/templates/application/.github/workflows/validation.yml +28 -0
  456. package/templates/application/.oxfmtrc.json +6 -0
  457. package/templates/application/.oxlintrc.json +48 -0
  458. package/templates/application/.release-please-manifest.json +3 -0
  459. package/templates/application/README.md +47 -0
  460. package/templates/application/electrobun.config.ts +22 -0
  461. package/templates/application/release-please-config.json +12 -0
  462. package/templates/application/scripts/app-version.ts +9 -0
  463. package/templates/application/scripts/build-desktop.ts +34 -0
  464. package/templates/application/scripts/secure-build.ts +1 -0
  465. package/templates/application/scripts/stage-release.ts +21 -0
  466. package/templates/application/src/bun/index.ts +80 -0
  467. package/templates/application/src/electrobun.d.ts +27 -0
  468. package/templates/application/src/web/index.html +12 -0
  469. package/templates/application/src/web/main.tsx +97 -0
  470. package/templates/application/src/web/public/icon.svg +1 -0
  471. package/templates/application/src/web/style.css +3 -0
  472. package/templates/application/tests/app-config.test.ts +9 -0
  473. package/templates/application/tsconfig.json +15 -0
  474. package/templates/application/vite.config.ts +10 -0
@@ -0,0 +1,104 @@
1
+ import { githubCli } from "./github-cli.js";
2
+ import { lookupRelease } from "./github-release-lookup.js";
3
+ import { isRepositorySlug } from "../updates/signed-release.js";
4
+ import { qualifyGitHubRelease } from "./github-release-qualification.js";
5
+ import { parseReleaseConfig } from "./release-config.js";
6
+ import { createGitHubReleaseCutProvider } from "./github-release-cut.js";
7
+ // src/release/release-finalize.ts
8
+ /** Treat event payloads as hints; qualification independently checks the GitHub run. */
9
+ function parseFinalizationEvent(event, repository, eventName = "workflow_run") {
10
+ if (typeof event !== "object" || event === null || Array.isArray(event)) throw new Error("Invalid workflow event");
11
+ if (eventName === "workflow_dispatch") {
12
+ const inputs = event.inputs;
13
+ if (typeof inputs !== "object" || inputs === null || Array.isArray(inputs)) throw new Error("Invalid workflow event");
14
+ const value = inputs;
15
+ if (typeof value.tag !== "string" || value.tag.length > 65 || !/^v(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)$/.test(value.tag) || typeof value.run_id !== "string" || !/^[1-9]\d{0,19}$/.test(value.run_id) || typeof value.run_attempt !== "string" || !/^[1-9]\d{0,8}$/.test(value.run_attempt)) throw new Error("Invalid workflow event");
16
+ return {
17
+ tag: value.tag,
18
+ runId: value.run_id,
19
+ runAttempt: Number(value.run_attempt)
20
+ };
21
+ }
22
+ if (eventName !== "workflow_run") throw new Error("Invalid workflow event");
23
+ const workflow = event.workflow_run;
24
+ if (typeof workflow !== "object" || workflow === null || Array.isArray(workflow)) throw new Error("Invalid workflow event");
25
+ const value = workflow;
26
+ if (!Number.isSafeInteger(value.id) || Number(value.id) < 1 || !Number.isSafeInteger(value.run_attempt) || Number(value.run_attempt) < 1 || value.event !== "workflow_dispatch" || value.conclusion !== "success" || value.head_branch !== "main" || value.head_repository?.full_name !== repository || typeof value.display_title !== "string" || !/^framework-release-assets:v(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)$/.test(value.display_title)) throw new Error("Invalid workflow event");
27
+ return {
28
+ tag: value.display_title.slice(25),
29
+ runId: String(value.id),
30
+ runAttempt: Number(value.run_attempt)
31
+ };
32
+ }
33
+ /** Publish an opted-in Release Please draft only after its exact asset workflow completed. */
34
+ async function finalizeReleasePleaseDraft(options) {
35
+ const { env, config, tag, runId, runAttempt } = options;
36
+ const repository = env.GITHUB_REPOSITORY ?? "";
37
+ if (env.GITHUB_ACTIONS !== "true" || !["workflow_run", "workflow_dispatch"].includes(env.GITHUB_EVENT_NAME ?? "") || env.GITHUB_REF !== "refs/heads/main" || !isRepositorySlug(repository) || !/^[a-f0-9]{40}$/.test(env.GITHUB_SHA ?? "") || !/^[1-9]\d{0,19}$/.test(runId) || !Number.isSafeInteger(runAttempt) || runAttempt < 1 || !/^v(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)$/.test(tag) || tag.length > 65) throw new Error("Invalid release finalization context");
38
+ const parsed = parseReleaseConfig(config);
39
+ if (!parsed.releasePleaseManifestPath || typeof config !== "object" || config === null || typeof config.appName !== "string") throw new Error("Release Please finalization is not configured");
40
+ const run = options.run ?? githubCli();
41
+ const requirements = parsed.requirements(tag), provider = createGitHubReleaseCutProvider({
42
+ repository,
43
+ appName: config.appName,
44
+ requirements: parsed.requirements,
45
+ assetsWorkflow: parsed.releaseWorkflows.assets,
46
+ releasePleaseManifestPath: parsed.releasePleaseManifestPath,
47
+ run
48
+ });
49
+ const base = `repos/${repository}`;
50
+ const read = async (path) => JSON.parse(await run(["api", path]));
51
+ const snapshot = await lookupRelease({
52
+ tag,
53
+ base,
54
+ read,
55
+ includeDraft: true
56
+ });
57
+ if (!snapshot || !Number.isSafeInteger(snapshot.id) || Number(snapshot.id) < 1 || typeof snapshot.draft !== "boolean" || typeof snapshot.body !== "string" || typeof snapshot.prerelease !== "boolean") throw new Error("Release draft is not eligible");
58
+ const before = await provider.find(tag);
59
+ if (!before || (before.draft ? !before.stageableDraft : !before.prerelease) || !await provider.isMainAncestor(env.GITHUB_SHA)) throw new Error("Release draft is not eligible");
60
+ const qualify = () => qualifyGitHubRelease({
61
+ repository,
62
+ tag,
63
+ requirements,
64
+ assetsWorkflow: parsed.releaseWorkflows.assets,
65
+ releasePleaseManifestPath: parsed.releasePleaseManifestPath,
66
+ allowDraft: true,
67
+ run
68
+ });
69
+ const attempt = `${base}/actions/runs/${runId}/attempts/${runAttempt}`;
70
+ for (let check = 0;; check++) {
71
+ if ((await read(attempt))?.status === "completed") break;
72
+ if (check === 40) throw new Error("Release workflow attempt did not complete");
73
+ await (options.sleep ?? Bun.sleep)(15e3);
74
+ }
75
+ const receipt = await qualify();
76
+ if (receipt.runId !== runId || receipt.runAttempt !== runAttempt || receipt.sourceSha !== before.sourceSha) throw new Error("Release workflow attempt mismatch");
77
+ if (!before.draft) return;
78
+ const current = await provider.find(tag);
79
+ if (!current || !current.draft || !current.stageableDraft || current.sourceSha !== before.sourceSha) throw new Error("Release draft changed");
80
+ const verified = await qualify();
81
+ if (JSON.stringify(verified) !== JSON.stringify(receipt)) throw new Error("Release qualification changed");
82
+ const selected = await lookupRelease({
83
+ tag,
84
+ base,
85
+ read,
86
+ includeDraft: true
87
+ });
88
+ if (!selected || selected.id !== snapshot.id || selected.tag_name !== tag || selected.draft !== true || selected.body !== snapshot.body || selected.prerelease !== snapshot.prerelease) throw new Error("Release draft changed");
89
+ await run([
90
+ "api",
91
+ `${base}/releases/${selected.id}`,
92
+ "--method",
93
+ "PATCH",
94
+ "--input",
95
+ "-"
96
+ ], JSON.stringify({
97
+ draft: false,
98
+ prerelease: true,
99
+ make_latest: "false"
100
+ }));
101
+ const after = await provider.find(tag);
102
+ if (!after || after.draft || !after.prerelease || after.sourceSha !== before.sourceSha || JSON.stringify(await qualify()) !== JSON.stringify(receipt)) throw new Error("Release publication could not be verified");
103
+ }
104
+ export { finalizeReleasePleaseDraft, parseFinalizationEvent };
@@ -0,0 +1,12 @@
1
+ /** Execute promotion only from a trusted main-branch GitHub release job. */
2
+ export declare function runPromotionCommand(options: {
3
+ env: Record<string, string | undefined>;
4
+ config: unknown;
5
+ now?: string;
6
+ run?: (args: string[], input?: string) => Promise<string>;
7
+ }): Promise<{
8
+ status: 'held' | 'soaking' | 'unqualified';
9
+ } | {
10
+ status: 'stable';
11
+ tag: string;
12
+ }>;
@@ -0,0 +1,28 @@
1
+ import { parseReleaseConfig } from "./release-config.js";
2
+ import { promoteDailyRelease } from "./release-promotion.js";
3
+ import { createGitHubPromotionProvider } from "./github-release-promotion.js";
4
+ // src/release/release-promotion-command.ts
5
+ /** Execute promotion only from a trusted main-branch GitHub release job. */
6
+ async function runPromotionCommand(options) {
7
+ const { env, config } = options;
8
+ if (env.GITHUB_ACTIONS !== "true" || env.GITHUB_REF !== "refs/heads/main" || !["schedule", "workflow_dispatch"].includes(env.GITHUB_EVENT_NAME ?? "") || !env.GITHUB_REPOSITORY || ![
9
+ "true",
10
+ "false",
11
+ void 0
12
+ ].includes(env.STABLE_PROMOTION_HELD)) throw new Error("Promotion requires a trusted main release workflow");
13
+ const { requirements, soakHours, releasePleaseManifestPath, releaseWorkflows } = parseReleaseConfig(config);
14
+ const provider = createGitHubPromotionProvider({
15
+ repository: env.GITHUB_REPOSITORY,
16
+ requirements,
17
+ assetsWorkflow: releaseWorkflows.assets,
18
+ releasePleaseManifestPath,
19
+ run: options.run
20
+ });
21
+ return promoteDailyRelease({
22
+ now: options.now ?? (/* @__PURE__ */ new Date()).toISOString(),
23
+ held: env.STABLE_PROMOTION_HELD === "true",
24
+ soakHours,
25
+ provider
26
+ });
27
+ }
28
+ export { runPromotionCommand };
@@ -0,0 +1,29 @@
1
+ /** Daily-to-stable policy adapted from adea-ai/adea scripts/release-policy.mjs,
2
+ * commit 6155d18941acbb14d9099bc2a33a50ee9683a068 (Apache-2.0). */
3
+ export type PromotionRelease = {
4
+ id: number;
5
+ tag: string;
6
+ body: string;
7
+ draft: boolean;
8
+ prerelease: boolean;
9
+ publishedAt: string;
10
+ };
11
+ export type PromotionProvider = {
12
+ list(): Promise<PromotionRelease[]>;
13
+ /** Verify immutable installer receipts, payload digests and the exact successful workflow attempt. */
14
+ qualify(release: PromotionRelease): Promise<boolean>;
15
+ /** Idempotently mark the already-qualified release stable and record the supplied time. */
16
+ markStable(release: PromotionRelease, at: string): Promise<void>;
17
+ };
18
+ /** Promote only a successfully qualified daily after the configured batch soak. */
19
+ export declare function promoteDailyRelease(options: {
20
+ now: string;
21
+ held?: boolean;
22
+ soakHours?: number;
23
+ provider: PromotionProvider;
24
+ }): Promise<{
25
+ status: 'held' | 'soaking' | 'unqualified';
26
+ } | {
27
+ status: 'stable';
28
+ tag: string;
29
+ }>;
@@ -0,0 +1,57 @@
1
+ import { versionLessThan } from "../updates/release-version.js";
2
+ // src/release/release-promotion.ts
3
+ function order(a, b) {
4
+ return Date.parse(a.publishedAt) - Date.parse(b.publishedAt) || a.id - b.id;
5
+ }
6
+ function stableTime(release) {
7
+ const lines = release.body.split(/\r?\n/);
8
+ const markers = lines.filter((line) => line === `<!-- adea-stable:v1 ${release.tag} -->`);
9
+ if (!markers.length) return void 0;
10
+ if (markers.length !== 1) throw new Error("Ambiguous stable marker");
11
+ const times = lines.filter((line) => /^<!-- adea-stable-time:[^ ]+ -->$/.test(line));
12
+ if (times.length > 1) throw new Error("Ambiguous stable timestamp");
13
+ const value = times[0]?.slice(22, -4) ?? release.publishedAt;
14
+ if (!Number.isFinite(Date.parse(value))) throw new Error("Invalid stable timestamp");
15
+ return value;
16
+ }
17
+ var eligibleTag = (tag) => tag.length <= 65 && /^v(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)$/.test(tag);
18
+ /** Promote only a successfully qualified daily after the configured batch soak. */
19
+ async function promoteDailyRelease(options) {
20
+ if (options.held) return { status: "held" };
21
+ const now = Date.parse(options.now);
22
+ const hours = options.soakHours ?? 96;
23
+ if (!Number.isFinite(now) || !Number.isSafeInteger(hours) || hours < 0 || hours > 8760) throw new Error("Invalid promotion clock or soak");
24
+ const releases = await options.provider.list();
25
+ const ids = /* @__PURE__ */ new Set(), tags = /* @__PURE__ */ new Set();
26
+ for (const release of releases) {
27
+ if (!Number.isSafeInteger(release.id) || release.id < 1 || ids.has(release.id) || typeof release.tag !== "string" || tags.has(release.tag) || !Number.isFinite(Date.parse(release.publishedAt))) throw new Error("Invalid release listing");
28
+ ids.add(release.id);
29
+ tags.add(release.tag);
30
+ }
31
+ const compareVersion = (a, b) => versionLessThan(a.tag, b.tag) ? -1 : versionLessThan(b.tag, a.tag) ? 1 : order(a, b);
32
+ const dailies = releases.filter((release) => !release.draft && Date.parse(release.publishedAt) <= now && eligibleTag(release.tag) && !release.body.split(/\r?\n/).some((line) => line.startsWith("adea-channel:") || line.startsWith("Source: "))).sort(order);
33
+ const stableReleases = dailies.filter((release) => !release.prerelease && stableTime(release) !== void 0);
34
+ stableReleases.sort(compareVersion);
35
+ const stable = stableReleases.at(-1);
36
+ const observedStable = releases.filter((release) => !release.draft && !release.prerelease && Date.parse(release.publishedAt) <= now && eligibleTag(release.tag)).sort(compareVersion).at(-1);
37
+ const batch = dailies.filter((release) => release.prerelease && (!stable || order(release, stable) > 0) && (!observedStable || versionLessThan(observedStable.tag, release.tag)));
38
+ const anchor = stable && (!observedStable || stable.tag === observedStable.tag) ? stableTime(stable) : observedStable?.publishedAt ?? batch[0]?.publishedAt;
39
+ const candidates = anchor !== void 0 && now - Date.parse(anchor) >= hours * 36e5 ? [...batch].reverse() : [];
40
+ candidates.sort((a, b) => versionLessThan(a.tag, b.tag) ? 1 : versionLessThan(b.tag, a.tag) ? -1 : order(b, a));
41
+ if (stable && (!observedStable || stable.tag === observedStable.tag)) candidates.push(stable);
42
+ if (!candidates.length) return { status: "soaking" };
43
+ for (const candidate of candidates) {
44
+ let qualified = false;
45
+ try {
46
+ qualified = await options.provider.qualify(candidate) === true;
47
+ } catch {}
48
+ if (!qualified) continue;
49
+ await options.provider.markStable(candidate, options.now);
50
+ return {
51
+ status: "stable",
52
+ tag: candidate.tag
53
+ };
54
+ }
55
+ return { status: "unqualified" };
56
+ }
57
+ export { promoteDailyRelease };
@@ -0,0 +1,33 @@
1
+ import { type ReleaseTrust } from '../updates/signed-release';
2
+ import { type Artifact, type CommandReceipt, type InstallerReceipt, type Qualification, type ReleaseIdentity, type Requirements } from './release-qualification';
3
+ export type RemoteReleaseState = {
4
+ tag: string;
5
+ sourceSha: string;
6
+ sourceOnMain: boolean;
7
+ workflowOnMain: boolean;
8
+ draft: boolean;
9
+ assets: Artifact[];
10
+ };
11
+ export type ReleasePublisher = {
12
+ /** Read tag target, release status, current assets and ancestry from the trusted provider. */
13
+ inspect(identity: ReleaseIdentity): Promise<RemoteReleaseState>;
14
+ /** Upload without replacing an existing asset; reject name collisions. */
15
+ upload(path: string, artifact: Artifact): Promise<void>;
16
+ };
17
+ /** Hash one staged regular file without following links, refusing a change while reading. */
18
+ export declare function fileIdentity(path: string, name: string): Promise<Artifact>;
19
+ /** Publish a qualified attempt with immutable payloads and discovery assets last. */
20
+ export declare function publishQualifiedRelease(options: {
21
+ directory: string;
22
+ identity: ReleaseIdentity;
23
+ requirements: Requirements;
24
+ installerReceipts: InstallerReceipt[];
25
+ /** Required exactly when the requirements name command artifacts. */
26
+ commandReceipts?: CommandReceipt[];
27
+ discoveryTrust: Record<string, {
28
+ trust: ReleaseTrust;
29
+ allowedPayloads: readonly string[];
30
+ }>;
31
+ remote: ReleasePublisher;
32
+ allowDraft?: boolean;
33
+ }): Promise<Qualification>;
@@ -0,0 +1,138 @@
1
+ import { validateReleaseQualification } from "./release-qualification.js";
2
+ import { verifyReleaseDescriptor } from "../updates/signed-release.js";
3
+ import { releaseAssetNames } from "./release-config.js";
4
+ import { openUnchangedFile, sameFile } from "../updates/stable-file.js";
5
+ import { lstat, mkdtemp, open, rm, writeFile } from "node:fs/promises";
6
+ import { join, resolve } from "node:path";
7
+ import { createHash } from "node:crypto";
8
+ import { tmpdir } from "node:os";
9
+ // src/release/release-publication.ts
10
+ function same(left, right) {
11
+ return left.name === right.name && left.size === right.size && left.digest === right.digest;
12
+ }
13
+ /** Hash one staged regular file without following links, refusing a change while reading. */
14
+ async function fileIdentity(path, name) {
15
+ const info = await lstat(path);
16
+ if (!info.isFile() || info.isSymbolicLink()) throw new Error("Invalid staged artifact");
17
+ const { file, before } = await openUnchangedFile(path, info, "Invalid staged artifact");
18
+ try {
19
+ if (!Number.isSafeInteger(before.size) || before.size < 1) throw new Error("Invalid staged artifact");
20
+ const hash = createHash("sha256");
21
+ let size = 0;
22
+ for await (const chunk of file.createReadStream({ autoClose: false })) {
23
+ size += chunk.length;
24
+ if (size > before.size) throw new Error("Staged artifact changed");
25
+ hash.update(chunk);
26
+ }
27
+ const after = await file.stat();
28
+ if (size !== before.size || !sameFile(before, after)) throw new Error("Staged artifact changed");
29
+ return {
30
+ name,
31
+ size,
32
+ digest: "sha256:" + hash.digest("hex")
33
+ };
34
+ } finally {
35
+ await file.close();
36
+ }
37
+ }
38
+ /** Publish a qualified attempt with immutable payloads and discovery assets last. */
39
+ async function publishQualifiedRelease(options) {
40
+ const { identity, requirements, remote } = options;
41
+ const directory = resolve(options.directory);
42
+ const names = releaseAssetNames(requirements);
43
+ if (!names.length || new Set(names).size !== names.length || names.some((name) => !/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(name))) throw new Error("Invalid release asset names");
44
+ const discoveryAssets = Object.keys(options.discoveryTrust);
45
+ if (!discoveryAssets.length || new Set(discoveryAssets).size !== discoveryAssets.length || discoveryAssets.some((name) => !requirements.releaseAssets.includes(name))) throw new Error("Invalid discovery assets");
46
+ for (const config of Object.values(options.discoveryTrust)) if (!config.allowedPayloads.length || new Set(config.allowedPayloads).size !== config.allowedPayloads.length || config.allowedPayloads.some((name) => !names.includes(name) || discoveryAssets.includes(name))) throw new Error("Invalid discovery payload policy");
47
+ const staged = await Promise.all(names.map((name) => fileIdentity(join(directory, name), name)));
48
+ const platforms = Object.keys(requirements.platforms);
49
+ const receipt = {
50
+ schema: 2,
51
+ ...identity,
52
+ platforms,
53
+ installerTests: platforms,
54
+ installerReceipts: options.installerReceipts,
55
+ ...options.commandReceipts ? { commandReceipts: options.commandReceipts } : {},
56
+ assets: staged
57
+ };
58
+ validateReleaseQualification({
59
+ tag_name: identity.tag,
60
+ draft: false,
61
+ assets: staged
62
+ }, receipt, identity.sourceSha, requirements);
63
+ for (const name of discoveryAssets) {
64
+ const expected = staged.find((asset) => asset.name === name);
65
+ if (expected.size > 65536) throw new Error("Discovery asset is too large");
66
+ const handle = await open(join(directory, name), "r");
67
+ let bytes;
68
+ try {
69
+ const buffer = Buffer.alloc(65537);
70
+ let offset = 0;
71
+ while (offset < buffer.length) {
72
+ const result = await handle.read(buffer, offset, buffer.length - offset, offset);
73
+ if (!result.bytesRead) break;
74
+ offset += result.bytesRead;
75
+ }
76
+ bytes = buffer.subarray(0, offset);
77
+ } finally {
78
+ await handle.close();
79
+ }
80
+ if (bytes.length !== expected.size || "sha256:" + createHash("sha256").update(bytes).digest("hex") !== expected.digest) throw new Error("Discovery asset changed");
81
+ let parsed;
82
+ try {
83
+ parsed = JSON.parse(bytes.toString("utf8"));
84
+ } catch {
85
+ throw new Error("Invalid discovery asset");
86
+ }
87
+ const verified = verifyReleaseDescriptor(parsed, options.discoveryTrust[name].trust);
88
+ if (!verified.ok) throw new Error("Untrusted discovery asset");
89
+ const descriptor = verified.descriptor;
90
+ if (descriptor.tag !== identity.tag || descriptor.sourceSha !== identity.sourceSha || descriptor.workflowSha !== identity.workflowSha || descriptor.runId !== identity.runId || descriptor.runAttempt !== identity.runAttempt) throw new Error("Discovery provenance mismatch");
91
+ const payload = staged.find((asset) => asset.name === descriptor.asset.name);
92
+ if (!payload || !options.discoveryTrust[name].allowedPayloads.includes(payload.name) || payload.size !== descriptor.asset.size || payload.digest !== "sha256:" + descriptor.asset.sha256) throw new Error("Discovery payload mismatch");
93
+ }
94
+ const receiptName = `qualification-${identity.runId}-${identity.runAttempt}.json`;
95
+ if (names.includes(receiptName)) throw new Error("Qualification asset collides with payload");
96
+ const bytes = Buffer.from(JSON.stringify(receipt, null, 2) + "\n");
97
+ const receiptArtifact = {
98
+ name: receiptName,
99
+ size: bytes.length,
100
+ digest: "sha256:" + createHash("sha256").update(bytes).digest("hex")
101
+ };
102
+ const ordered = [
103
+ ...staged.filter((asset) => !discoveryAssets.includes(asset.name)),
104
+ receiptArtifact,
105
+ ...staged.filter((asset) => discoveryAssets.includes(asset.name))
106
+ ];
107
+ let expectedDraft;
108
+ const check = async () => {
109
+ const state = await remote.inspect(identity);
110
+ if (state.tag !== identity.tag || state.sourceSha !== identity.sourceSha || !state.sourceOnMain || !state.workflowOnMain || state.draft && options.allowDraft !== true || expectedDraft !== void 0 && state.draft !== expectedDraft) throw new Error("Untrusted release identity");
111
+ expectedDraft = state.draft;
112
+ for (const expected of ordered) {
113
+ const existing = state.assets.filter((asset) => asset.name === expected.name);
114
+ if (existing.length > 1 || existing.length && !same(existing[0], expected)) throw new Error(`Immutable asset conflict: ${expected.name}`);
115
+ }
116
+ return state;
117
+ };
118
+ await check();
119
+ const temp = await mkdtemp(join(tmpdir(), "framework-qualification-"));
120
+ try {
121
+ const receiptPath = join(temp, receiptName);
122
+ await writeFile(receiptPath, bytes, { flag: "wx" });
123
+ for (const artifact of ordered) {
124
+ if ((await check()).assets.some((asset) => asset.name === artifact.name)) continue;
125
+ const path = artifact.name === receiptName ? receiptPath : join(directory, artifact.name);
126
+ if (!same(await fileIdentity(path, artifact.name), artifact)) throw new Error("Staged artifact changed before upload");
127
+ await remote.upload(path, artifact);
128
+ if (!(await check()).assets.some((asset) => same(asset, artifact))) throw new Error("Published artifact differs from staging");
129
+ }
130
+ return receipt;
131
+ } finally {
132
+ await rm(temp, {
133
+ recursive: true,
134
+ force: true
135
+ });
136
+ }
137
+ }
138
+ export { fileIdentity, publishQualifiedRelease };
@@ -0,0 +1,7 @@
1
+ /** Publish only the current trusted release-assets attempt and its staged receipts. */
2
+ export declare function runReleasePublishCommand(options: {
3
+ env: Record<string, string | undefined>;
4
+ config: unknown;
5
+ directory: string;
6
+ run?: (args: string[], input?: string) => Promise<string>;
7
+ }): Promise<import("./release-qualification").Qualification>;
@@ -0,0 +1,91 @@
1
+ import { githubCli } from "./github-cli.js";
2
+ import { assertRepositorySlug } from "../updates/signed-release.js";
3
+ import { feedUrl } from "../updates/release-feed.js";
4
+ import { discoveryPolicies, parseReleaseConfig } from "./release-config.js";
5
+ import { publishQualifiedRelease } from "./release-publication.js";
6
+ import { commandReceiptName } from "../installer/command-qualification-command.js";
7
+ import { createGitHubReleasePublisher } from "./github-release-publisher.js";
8
+ import { open } from "node:fs/promises";
9
+ import { join, resolve } from "node:path";
10
+ // src/release/release-publish-command.ts
11
+ var record = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
12
+ async function boundedJson(path) {
13
+ const handle = await open(path, "r");
14
+ try {
15
+ const stat = await handle.stat();
16
+ if (!stat.isFile() || stat.size < 1 || stat.size > 262144) throw new Error("Invalid receipt");
17
+ const buffer = Buffer.alloc(stat.size + 1);
18
+ let offset = 0;
19
+ while (offset < buffer.length) {
20
+ const result = await handle.read(buffer, offset, buffer.length - offset, offset);
21
+ if (!result.bytesRead) break;
22
+ offset += result.bytesRead;
23
+ }
24
+ if (offset !== stat.size) throw new Error("Receipt changed");
25
+ return JSON.parse(buffer.subarray(0, offset).toString("utf8"));
26
+ } finally {
27
+ await handle.close();
28
+ }
29
+ }
30
+ /** Publish only the current trusted release-assets attempt and its staged receipts. */
31
+ async function runReleasePublishCommand(options) {
32
+ const { env, config } = options;
33
+ if (env.GITHUB_ACTIONS !== "true" || env.GITHUB_REF !== "refs/heads/main" || env.GITHUB_EVENT_NAME !== "workflow_dispatch" || !env.GITHUB_REPOSITORY || !/^[a-f0-9]{40}$/.test(env.GITHUB_SHA ?? "") || !/^[a-f0-9]{40}$/.test(env.SOURCE_SHA ?? "") || !/^[1-9]\d{0,19}$/.test(env.GITHUB_RUN_ID ?? "") || !/^[1-9]\d{0,8}$/.test(env.GITHUB_RUN_ATTEMPT ?? "") || !/^v\d+\.\d+\.\d+(?:-dev\.\d+)?$/.test(env.RELEASE_TAG ?? "")) throw new Error("Publication requires a trusted release-assets workflow");
34
+ assertRepositorySlug(env.GITHUB_REPOSITORY);
35
+ const { requirements, releasePleaseManifestPath, releaseWorkflows, feed } = parseReleaseConfig(config);
36
+ if (!record(config) || typeof config.appId !== "string" || !/^[a-z][a-z0-9-]*(?:\.[a-z][a-z0-9-]*)+$/.test(config.appId) || config.appId.length > 255 || !record(config.releaseSigningKeys) || !record(config.descriptors)) throw new Error("Invalid release signing configuration");
37
+ const keyEntries = Object.entries(config.releaseSigningKeys);
38
+ if (!keyEntries.length || keyEntries.length > 16) throw new Error("Missing release verification keys");
39
+ const keys = /* @__PURE__ */ new Map();
40
+ for (const [id, encoded] of keyEntries) {
41
+ if (!/^[a-z0-9][a-z0-9._-]{0,63}$/.test(id) || typeof encoded !== "string") throw new Error("Invalid release verification key");
42
+ const raw = Buffer.from(encoded, "base64");
43
+ if (raw.length !== 32 || raw.toString("base64") !== encoded) throw new Error("Invalid release verification key");
44
+ keys.set(id, encoded);
45
+ }
46
+ const tag = env.RELEASE_TAG, repository = env.GITHUB_REPOSITORY, releaseRequirements = requirements(tag);
47
+ const isDev = tag.includes("-dev.");
48
+ const discoveryTrust = {};
49
+ for (const policy of discoveryPolicies(config, tag)) discoveryTrust[policy.name] = {
50
+ trust: {
51
+ appId: policy.appId,
52
+ repository,
53
+ channel: policy.channel,
54
+ platform: policy.os,
55
+ arch: policy.arch,
56
+ feed: feedUrl(feed),
57
+ keys
58
+ },
59
+ allowedPayloads: [policy.payload]
60
+ };
61
+ const run = options.run ?? githubCli();
62
+ const workflow = JSON.parse(await run(["api", `repos/${repository}/actions/runs/${env.GITHUB_RUN_ID}/attempts/${env.GITHUB_RUN_ATTEMPT}`]));
63
+ if (String(workflow?.id) !== env.GITHUB_RUN_ID || String(workflow?.run_attempt) !== env.GITHUB_RUN_ATTEMPT || workflow?.head_sha !== env.GITHUB_SHA || workflow?.event !== "workflow_dispatch" || workflow?.path !== releaseWorkflows.assets || workflow?.repository?.full_name !== repository) throw new Error("Release-assets workflow provenance mismatch");
64
+ const directory = resolve(options.directory);
65
+ const installerReceipts = await Promise.all(Object.keys(releaseRequirements.platforms).map(async (platform) => await boundedJson(join(directory, `installer-test-${platform}.json`))));
66
+ const commandReceipts = releaseRequirements.commandArtifacts ? await Promise.all(Object.entries(releaseRequirements.commandArtifacts).flatMap(([kind, byPlatform]) => Object.keys(byPlatform).map(async (platform) => await boundedJson(join(directory, commandReceiptName(kind, platform)))))) : void 0;
67
+ const identity = {
68
+ tag,
69
+ sourceSha: env.SOURCE_SHA,
70
+ workflowSha: env.GITHUB_SHA,
71
+ runId: env.GITHUB_RUN_ID,
72
+ runAttempt: Number(env.GITHUB_RUN_ATTEMPT)
73
+ };
74
+ const remote = createGitHubReleasePublisher({
75
+ repository,
76
+ identity,
77
+ releasePleaseManifestPath,
78
+ run
79
+ });
80
+ return publishQualifiedRelease({
81
+ directory,
82
+ identity,
83
+ requirements: releaseRequirements,
84
+ installerReceipts,
85
+ ...commandReceipts ? { commandReceipts } : {},
86
+ discoveryTrust,
87
+ remote,
88
+ allowDraft: !isDev
89
+ });
90
+ }
91
+ export { runReleasePublishCommand };
@@ -0,0 +1,106 @@
1
+ /** Release qualification adapted from adea-ai/adea scripts/release-policy.mjs
2
+ * and scripts/desktop-renderer-probe.mjs, commit 6155d18941acbb14d9099bc2a33a50ee9683a068 (Apache-2.0). */
3
+ export type Artifact = {
4
+ name: string;
5
+ size: number;
6
+ digest: string;
7
+ };
8
+ export type ReleaseIdentity = {
9
+ tag: string;
10
+ sourceSha: string;
11
+ workflowSha: string;
12
+ runId: string;
13
+ runAttempt: number;
14
+ };
15
+ export type OfflinePolicy = {
16
+ kind: 'standalone';
17
+ marker: string;
18
+ } | {
19
+ kind: 'local-bootstrap';
20
+ marker: string;
21
+ path: string;
22
+ };
23
+ export type RendererEvidence = {
24
+ method: string;
25
+ origin: string;
26
+ samples: number;
27
+ guardInstalled: boolean;
28
+ bootstrapDenied: boolean;
29
+ offlineObserved: boolean;
30
+ unexpectedActivity: boolean;
31
+ elapsedMs: number;
32
+ visible: boolean;
33
+ readyState: string;
34
+ width: number;
35
+ height: number;
36
+ interactiveElements: number;
37
+ textLength: number;
38
+ markerObserved?: boolean;
39
+ browserNetworkRestricted?: boolean;
40
+ offlinePolicy?: OfflinePolicy;
41
+ };
42
+ export type InstallerReceipt = ReleaseIdentity & {
43
+ schema: number;
44
+ platform: string;
45
+ installed: boolean;
46
+ launched: boolean;
47
+ rendererReady: boolean;
48
+ rendererEvidence: RendererEvidence;
49
+ assets: Artifact[];
50
+ };
51
+ /** One command artifact extracted into a clean location and run there. */
52
+ export type CommandReceipt = ReleaseIdentity & {
53
+ schema: 1;
54
+ kind: string;
55
+ platform: string;
56
+ installed: boolean;
57
+ versionMatched: boolean;
58
+ probesPassed: boolean;
59
+ serviceStarted: boolean;
60
+ /** How the service was stopped: SIGTERM with a clean exit, or the Windows process tree. */
61
+ serviceStopped: 'sigterm' | 'process-tree';
62
+ asset: Artifact;
63
+ };
64
+ export type Qualification = ReleaseIdentity & {
65
+ schema: number;
66
+ platforms: string[];
67
+ installerTests: string[];
68
+ installerReceipts: InstallerReceipt[];
69
+ /** Present exactly when the release requires command artifacts. */
70
+ commandReceipts?: CommandReceipt[];
71
+ assets: Artifact[];
72
+ };
73
+ export type Requirements = {
74
+ platforms: Record<string, readonly string[]>;
75
+ releaseAssets: readonly string[];
76
+ offlinePolicy?: OfflinePolicy;
77
+ /** Command artifact asset names by kind, then platform; absent when the app ships none. */
78
+ commandArtifacts?: Record<string, Record<string, string>>;
79
+ };
80
+ export type Release = {
81
+ tag_name: string;
82
+ draft: boolean;
83
+ assets: Artifact[];
84
+ };
85
+ export declare function parseOfflinePolicy(value: unknown): OfflinePolicy;
86
+ /** Validate one installed-app receipt against the exact attempt and payload bytes. */
87
+ export declare function validateInstallerReceipt(identity: ReleaseIdentity, entry: InstallerReceipt, platform: string, names: readonly string[], assets: Artifact[], offlinePolicy?: OfflinePolicy): true;
88
+ /** Validate one command artifact receipt against the exact attempt and payload bytes. */
89
+ export declare function validateCommandReceipt(identity: ReleaseIdentity, entry: CommandReceipt, kind: string, platform: string, name: string, assets: Artifact[]): true;
90
+ /** Validate that every required command artifact has exactly one receipt for its bytes. */
91
+ export declare function validateCommandReceipts(identity: ReleaseIdentity, receipts: CommandReceipt[] | undefined, requirements: Requirements, assets: Artifact[]): void;
92
+ export declare function validateReleaseQualification(release: Release, receipt: Qualification, sourceSha: string, requirements: Requirements): true;
93
+ export declare function validateQualificationRun(run: {
94
+ id: number;
95
+ run_attempt: number;
96
+ conclusion: string;
97
+ path: string;
98
+ repository: {
99
+ full_name: string;
100
+ };
101
+ head_sha: string;
102
+ event: string;
103
+ }, jobs: {
104
+ name: string;
105
+ conclusion: string;
106
+ }[], receipt: Qualification, repository: string, requirements: Requirements, assetsWorkflow: string): true;