@adea-ai/app-framework 0.37.1 → 0.38.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 (91) hide show
  1. package/README.md +5 -1
  2. package/dist/app/create-application.js +1 -1
  3. package/dist/appearance/appearance-host.js +2 -2
  4. package/dist/appearance/custom-theme-import.js +2 -2
  5. package/dist/appearance/custom-theme-library.js +1 -1
  6. package/dist/cli/framework-update-cli.js +1 -1
  7. package/dist/cli/macos-signing-cli.js +1 -1
  8. package/dist/cli/release-assets-plan-cli.js +1 -1
  9. package/dist/cli/release-cut-cli.js +2 -2
  10. package/dist/cli/release-descriptor-staging-cli.js +2 -2
  11. package/dist/cli/release-promote-cli.js +2 -1
  12. package/dist/cli/release-publish-cli.js +1 -1
  13. package/dist/cli/release-sign-cli.js +1 -1
  14. package/dist/cli/release-step-cli.js +1 -1
  15. package/dist/cli/windows-installer-build-cli.js +1 -1
  16. package/dist/cli/windows-runtime-patch-cli.js +1 -1
  17. package/dist/desktop/client-assets.js +1 -1
  18. package/dist/desktop/desktop-gateway.js +2 -2
  19. package/dist/desktop/desktop-host.js +6 -6
  20. package/dist/desktop/desktop-stream.js +1 -1
  21. package/dist/framework-source.json +1 -1
  22. package/dist/installer/command-qualification-command.js +2 -2
  23. package/dist/installer/installed-payload.js +3 -3
  24. package/dist/installer/installer-archive-members.js +1 -1
  25. package/dist/installer/installer-ci-worker.js +2 -2
  26. package/dist/installer/installer-extraction.js +3 -3
  27. package/dist/installer/installer-identity.js +2 -2
  28. package/dist/installer/installer-observation.js +4 -4
  29. package/dist/installer/installer-process-cleanup.js +1 -1
  30. package/dist/installer/installer-qualification-command.js +3 -3
  31. package/dist/installer/installer-renderer-evidence.js +1 -1
  32. package/dist/installer/installer-upgrade-command.js +5 -5
  33. package/dist/installer/upgrade-asset-download.js +1 -1
  34. package/dist/native/desktop-build.js +1 -1
  35. package/dist/native/secure-window.js +1 -1
  36. package/dist/native/windows-build-hook.js +1 -1
  37. package/dist/native/windows-extractor-build.js +1 -1
  38. package/dist/release/feed-state.js +3 -3
  39. package/dist/release/github-release-cut.js +3 -3
  40. package/dist/release/github-release-promotion.js +1 -1
  41. package/dist/release/local-release.d.ts +2 -0
  42. package/dist/release/local-release.js +77 -75
  43. package/dist/release/qualification-run.js +1 -1
  44. package/dist/release/release-artifact.js +1 -1
  45. package/dist/release/release-assets-plan.js +2 -2
  46. package/dist/release/release-config.js +2 -2
  47. package/dist/release/release-cut-command.js +1 -1
  48. package/dist/release/release-descriptor-staging.js +5 -5
  49. package/dist/release/release-finalize.js +3 -3
  50. package/dist/release/release-promotion-command.d.ts +1 -0
  51. package/dist/release/release-promotion-command.js +3 -2
  52. package/dist/release/release-promotion.d.ts +11 -1
  53. package/dist/release/release-promotion.js +26 -1
  54. package/dist/release/release-publication.js +2 -2
  55. package/dist/release/release-publish-command.js +4 -4
  56. package/dist/release/release-steps.js +2 -2
  57. package/dist/release/retained-release-build.js +2 -2
  58. package/dist/shell/app-utilities.js +2 -2
  59. package/dist/updates/channel-update-manager.js +2 -2
  60. package/dist/updates/desktop-updater.js +8 -8
  61. package/dist/updates/feed/packaged-release-config.js +2 -2
  62. package/dist/updates/feed/update-discovery.js +2 -2
  63. package/dist/updates/helper/launch-gate-recovery.js +3 -3
  64. package/dist/updates/helper/resume-staging.js +3 -3
  65. package/dist/updates/helper/update-helper.js +3 -3
  66. package/dist/updates/helper/update-resume.js +3 -3
  67. package/dist/updates/install/update-arm.js +5 -5
  68. package/dist/updates/install/update-extraction.js +2 -2
  69. package/dist/updates/install/update-handoff-plan.js +2 -2
  70. package/dist/updates/install/update-swap-stage.js +3 -3
  71. package/dist/updates/install/update-swap.js +1 -1
  72. package/dist/updates/launch/packaged-update-startup.js +4 -4
  73. package/dist/updates/launch/update-launch-gate.js +3 -3
  74. package/dist/updates/launch/update-launch.js +1 -1
  75. package/dist/updates/locks/update-generation-lease.js +1 -1
  76. package/dist/updates/locks/update-inherited-launch-lease.js +1 -1
  77. package/dist/updates/locks/update-instance-lease.js +1 -1
  78. package/dist/updates/locks/update-lock.js +1 -1
  79. package/dist/updates/locks/update-process-fence.js +1 -1
  80. package/dist/updates/retained-client-assets.js +2 -2
  81. package/dist/updates/retention/retention-cleanup.js +6 -6
  82. package/dist/updates/retention/retention-prune-progress.js +3 -3
  83. package/dist/updates/retention/retirement-inventory.js +6 -6
  84. package/dist/updates/retention/retirement-records.js +2 -2
  85. package/dist/updates/retention/update-retention-sync.js +1 -1
  86. package/dist/updates/update-channel-store.js +2 -2
  87. package/dist/updates/update-manager.js +2 -2
  88. package/dist/updates/update-services.js +1 -1
  89. package/dist/updates/update-state-store.js +1 -1
  90. package/dist/views/appearance-surface.js +1 -1
  91. package/package.json +19 -19
@@ -1,15 +1,15 @@
1
- import { versionLessThan } from "../updates/feed/release-version.js";
2
1
  import { errorCode, isGitSha, isRecord } from "../app/value-guards.js";
3
2
  import { renameExclusive } from "../native/native-rename.js";
4
- import { verifyReleaseDescriptor } from "../updates/feed/signed-release.js";
5
3
  import { feedAssetKey, feedChannelKey, feedIndexKey, feedReleaseKey, feedUrl, parseReleaseLedger } from "../updates/feed/release-feed.js";
6
- import { discoveryPolicies, parseReleaseConfig, platformPayloads, platformTargets } from "./release-config.js";
7
- import { cutRelease, nextDevVersion } from "./release-cut.js";
8
- import { resolveLocalProvenance } from "./local-provenance.js";
4
+ import { versionLessThan } from "../updates/feed/release-version.js";
5
+ import { verifyReleaseDescriptor } from "../updates/feed/signed-release.js";
9
6
  import { createFeedReleaseCutProvider } from "./feed-release-cut.js";
10
7
  import { ReleaseFeedSnapshotChanged, readFeedLedger, readFeedRelease, verifyFeedRelease } from "./feed-state.js";
11
- import { fileIdentity } from "./release-publication.js";
8
+ import { resolveLocalProvenance } from "./local-provenance.js";
9
+ import { discoveryPolicies, parseReleaseConfig, platformPayloads, platformTargets } from "./release-config.js";
10
+ import { cutRelease, nextDevVersion } from "./release-cut.js";
12
11
  import { configuredSigningKey, signDiscoveryDescriptors, writeDescriptors } from "./release-descriptor-staging.js";
12
+ import { fileIdentity } from "./release-publication.js";
13
13
  import { promoteDailyRelease } from "./release-promotion.js";
14
14
  import { constants, copyFile, lstat, mkdir, mkdtemp, readFile, readdir, rm, writeFile } from "node:fs/promises";
15
15
  import { dirname, join, resolve } from "node:path";
@@ -375,80 +375,82 @@ async function runLocalPromotion(options) {
375
375
  const qualified = /* @__PURE__ */ new Map();
376
376
  const reasons = [];
377
377
  let selectionChanged = false;
378
- const result = await promoteDailyRelease({
379
- now: timestamp(options.now),
380
- held: options.held,
381
- soakHours: local.soakHours,
382
- provider: {
383
- async list() {
384
- return ledger.releases.map((entry, index) => ({
385
- id: ledger.releases.length - index,
386
- tag: entry.tag,
387
- body: entry.kind === "dev" ? `adea-channel:dev\n\nSource: ${entry.sourceSha}` : entry.kind === "stable" ? `<!-- adea-stable:v1 ${entry.tag} -->\n<!-- adea-stable-time:${entry.promotedAt} -->` : "",
388
- draft: false,
389
- prerelease: entry.kind !== "stable",
390
- publishedAt: entry.publishedAt
391
- }));
392
- },
393
- async qualify(release) {
394
- if (selectionChanged) return false;
395
- let verified;
396
- try {
397
- verified = await verifyFeedRelease({
398
- config: local.config,
399
- feed,
400
- tag: release.tag,
401
- repository: options.repository,
402
- keys: local.keys,
403
- fetch: options.fetch,
404
- channels: ["stable"],
405
- expectedLedger: ledger
406
- });
407
- } catch (error) {
408
- if (error instanceof ReleaseFeedSnapshotChanged) {
409
- selectionChanged = true;
410
- return false;
411
- }
412
- throw error;
413
- }
414
- const { release: verifiedRelease, platforms } = verified;
415
- qualified.set(release.tag, {
416
- release: verifiedRelease,
417
- platforms
378
+ const provider = {
379
+ async list() {
380
+ return ledger.releases.map((entry, index) => ({
381
+ id: ledger.releases.length - index,
382
+ tag: entry.tag,
383
+ body: entry.kind === "dev" ? `adea-channel:dev\n\nSource: ${entry.sourceSha}` : entry.kind === "stable" ? `<!-- adea-stable:v1 ${entry.tag} -->\n<!-- adea-stable-time:${entry.promotedAt} -->` : "",
384
+ draft: false,
385
+ prerelease: entry.kind !== "stable",
386
+ publishedAt: entry.publishedAt
387
+ }));
388
+ },
389
+ async qualify(release) {
390
+ if (selectionChanged) return false;
391
+ let verified;
392
+ try {
393
+ verified = await verifyFeedRelease({
394
+ config: local.config,
395
+ feed,
396
+ tag: release.tag,
397
+ repository: options.repository,
398
+ keys: local.keys,
399
+ fetch: options.fetch,
400
+ channels: ["stable"],
401
+ expectedLedger: ledger
418
402
  });
419
- const missing = required.filter((name) => !platforms.includes(name));
420
- if (missing.length) {
421
- reasons.push(`${release.tag} lacks ${missing.join(", ")}; publish them or relax stablePlatforms in release-config.json`);
403
+ } catch (error) {
404
+ if (error instanceof ReleaseFeedSnapshotChanged) {
405
+ selectionChanged = true;
422
406
  return false;
423
407
  }
424
- return true;
425
- },
426
- async markStable(selected, at) {
427
- const verification = qualified.get(selected.tag);
428
- const absent = Object.keys(platformTargets).filter((name) => !verification?.platforms.includes(name));
429
- const entry = ledger.releases.find((item) => item.tag === selected.tag);
430
- const [currentLedger, remote] = await Promise.all([readFeedLedger(feed, options.fetch), readFeedRelease(feed, selected.tag, options.fetch)]);
431
- if (!entry || !remote || !verification || entry.kind === "dev" || JSON.stringify(currentLedger) !== JSON.stringify(ledger) || JSON.stringify(remote) !== JSON.stringify(verification.release)) throw new Error("Release feed changed or is unavailable during promotion");
432
- const promoted = {
433
- tag: entry.tag,
434
- kind: "stable",
435
- version: entry.version,
436
- sourceSha: entry.sourceSha,
437
- publishedAt: entry.publishedAt,
438
- promotedAt: entry.promotedAt ?? timestamp(at)
439
- };
440
- const updated = parseReleaseLedger({
441
- schema: 1,
442
- app: feed.app,
443
- releases: ledger.releases.map((item) => item.tag === entry.tag ? promoted : item)
444
- }, feed.app);
445
- plan = await writeStagedTree(options.out, feed, [], releaseDocuments(feed, updated, {
446
- ...remote,
447
- channel: "stable",
448
- ...absent.length ? { missingPlatforms: absent } : {}
449
- }));
408
+ throw error;
450
409
  }
410
+ const { release: verifiedRelease, platforms } = verified;
411
+ qualified.set(release.tag, {
412
+ release: verifiedRelease,
413
+ platforms
414
+ });
415
+ const missing = required.filter((name) => !platforms.includes(name));
416
+ if (missing.length) {
417
+ reasons.push(`${release.tag} lacks ${missing.join(", ")}; publish them or relax stablePlatforms in release-config.json`);
418
+ return false;
419
+ }
420
+ return true;
421
+ },
422
+ async markStable(selected, at) {
423
+ const verification = qualified.get(selected.tag);
424
+ const absent = Object.keys(platformTargets).filter((name) => !verification?.platforms.includes(name));
425
+ const entry = ledger.releases.find((item) => item.tag === selected.tag);
426
+ const [currentLedger, remote] = await Promise.all([readFeedLedger(feed, options.fetch), readFeedRelease(feed, selected.tag, options.fetch)]);
427
+ if (!entry || !remote || !verification || entry.kind === "dev" || JSON.stringify(currentLedger) !== JSON.stringify(ledger) || JSON.stringify(remote) !== JSON.stringify(verification.release)) throw new Error("Release feed changed or is unavailable during promotion");
428
+ const promoted = {
429
+ tag: entry.tag,
430
+ kind: "stable",
431
+ version: entry.version,
432
+ sourceSha: entry.sourceSha,
433
+ publishedAt: entry.publishedAt,
434
+ promotedAt: entry.promotedAt ?? timestamp(at)
435
+ };
436
+ const updated = parseReleaseLedger({
437
+ schema: 1,
438
+ app: feed.app,
439
+ releases: ledger.releases.map((item) => item.tag === entry.tag ? promoted : item)
440
+ }, feed.app);
441
+ plan = await writeStagedTree(options.out, feed, [], releaseDocuments(feed, updated, {
442
+ ...remote,
443
+ channel: "stable",
444
+ ...absent.length ? { missingPlatforms: absent } : {}
445
+ }));
451
446
  }
447
+ };
448
+ const result = await promoteDailyRelease({
449
+ now: timestamp(options.now),
450
+ held: options.held,
451
+ soakHours: local.soakHours,
452
+ ...options.soakBypassTag ? { soakBypassTag: options.soakBypassTag } : {},
453
+ provider
452
454
  });
453
455
  if (selectionChanged) throw new Error("Release feed changed or is unavailable during promotion");
454
456
  return {
@@ -1,7 +1,7 @@
1
1
  import { isGitSha } from "../app/value-guards.js";
2
- import { planReleaseAssets } from "./release-assets-plan.js";
3
2
  import { gitCli } from "./local-provenance.js";
4
3
  import { localTagProvenance } from "./local-release.js";
4
+ import { planReleaseAssets } from "./release-assets-plan.js";
5
5
  // src/release/qualification-run.ts
6
6
  /**
7
7
  * Resolve the run a platform qualification job belongs to.
@@ -1,5 +1,5 @@
1
- import { signReleaseDescriptor } from "../updates/feed/signed-release.js";
2
1
  import { hashUnchangedFile } from "../updates/locks/stable-file.js";
2
+ import { signReleaseDescriptor } from "../updates/feed/signed-release.js";
3
3
  import { open } from "node:fs/promises";
4
4
  import { basename } from "node:path";
5
5
  // src/release/release-artifact.ts
@@ -1,8 +1,8 @@
1
1
  import { isGitSha } from "../app/value-guards.js";
2
2
  import { githubCli, verifyWorkflowAttempt } from "./github-cli.js";
3
- import { isRepositorySlug } from "../updates/feed/signed-release.js";
4
- import { hostedReleaseWorkflows, parseReleaseConfig } from "./release-config.js";
5
3
  import { createGitHubReleaseCutProvider } from "./github-release-cut.js";
4
+ import { hostedReleaseWorkflows, parseReleaseConfig } from "./release-config.js";
5
+ import { isRepositorySlug } from "../updates/feed/signed-release.js";
6
6
  // src/release/release-assets-plan.ts
7
7
  /** GitHub reads need credentials but must not inherit release signing keys. */
8
8
  function releasePlanGitHubEnvironment(env) {
@@ -1,7 +1,7 @@
1
1
  import { isGitSha, isRecord } from "../app/value-guards.js";
2
- import { containsAsciiControl } from "../desktop/string-policy.js";
3
- import { assertSidecarNames } from "../native/app-bundle.js";
4
2
  import { parseOfflinePolicy } from "./release-qualification.js";
3
+ import { assertSidecarNames } from "../native/app-bundle.js";
4
+ import { containsAsciiControl } from "../desktop/string-policy.js";
5
5
  import { parseReleaseFeed } from "../updates/feed/release-feed.js";
6
6
  // src/release/release-config.ts
7
7
  var strings = (value) => Array.isArray(value) && value.length > 0 && value.every((item) => typeof item === "string" && item.length <= 200 && /^[A-Za-z0-9][A-Za-z0-9._{}-]*$/.test(item) && !item.replaceAll("{tag}", "").includes("{") && !item.replaceAll("{tag}", "").includes("}")) && new Set(value).size === value.length;
@@ -1,8 +1,8 @@
1
1
  import { isGitSha } from "../app/value-guards.js";
2
2
  import { githubCli, verifyWorkflowAttempt } from "./github-cli.js";
3
- import { hostedReleaseWorkflows, parseReleaseConfig, workflowFile } from "./release-config.js";
4
3
  import { createGitHubReleaseCutProvider } from "./github-release-cut.js";
5
4
  import { cutRelease } from "./release-cut.js";
5
+ import { hostedReleaseWorkflows, parseReleaseConfig, workflowFile } from "./release-config.js";
6
6
  import { readSourceVersion } from "./local-provenance.js";
7
7
  import { execFile } from "node:child_process";
8
8
  import { promisify } from "node:util";
@@ -1,11 +1,11 @@
1
1
  import { errorCode, isRecord } from "../app/value-guards.js";
2
- import { validateCommandReceipts, validateInstallerReceipt } from "./release-qualification.js";
3
- import { signReleaseDescriptor, verifyReleaseDescriptor } from "../updates/feed/signed-release.js";
4
- import { feedUrl } from "../updates/feed/release-feed.js";
5
- import { discoveryPolicies, parseReleaseConfig, platformPayloads, platformTargets } from "./release-config.js";
6
- import { planReleaseAssets } from "./release-assets-plan.js";
7
2
  import { hashFileAt } from "../updates/locks/stable-file.js";
3
+ import { planReleaseAssets } from "./release-assets-plan.js";
8
4
  import { commandReceiptName } from "../installer/command-qualification-command.js";
5
+ import { discoveryPolicies, parseReleaseConfig, platformPayloads, platformTargets } from "./release-config.js";
6
+ import { validateCommandReceipts, validateInstallerReceipt } from "./release-qualification.js";
7
+ import { feedUrl } from "../updates/feed/release-feed.js";
8
+ import { signReleaseDescriptor, verifyReleaseDescriptor } from "../updates/feed/signed-release.js";
9
9
  import { lstat, readFile, writeFile } from "node:fs/promises";
10
10
  import { join, resolve } from "node:path";
11
11
  import { createPublicKey } from "node:crypto";
@@ -1,10 +1,10 @@
1
1
  import { isGitSha } from "../app/value-guards.js";
2
2
  import { githubCli } from "./github-cli.js";
3
- import { lookupRelease } from "./github-release-lookup.js";
4
- import { isRepositorySlug } from "../updates/feed/signed-release.js";
3
+ import { createGitHubReleaseCutProvider } from "./github-release-cut.js";
5
4
  import { qualifyGitHubRelease } from "./github-release-qualification.js";
6
5
  import { hostedReleaseWorkflows, parseReleaseConfig } from "./release-config.js";
7
- import { createGitHubReleaseCutProvider } from "./github-release-cut.js";
6
+ import { lookupRelease } from "./github-release-lookup.js";
7
+ import { isRepositorySlug } from "../updates/feed/signed-release.js";
8
8
  // src/release/release-finalize.ts
9
9
  /** Treat event payloads as hints; qualification independently checks the GitHub run. */
10
10
  function parseFinalizationEvent(event, repository, eventName = "workflow_run") {
@@ -9,4 +9,5 @@ export declare function runPromotionCommand(options: {
9
9
  } | {
10
10
  status: 'stable';
11
11
  tag: string;
12
+ soakBypassed?: true;
12
13
  }>;
@@ -1,6 +1,6 @@
1
- import { hostedReleaseWorkflows, parseReleaseConfig } from "./release-config.js";
2
- import { promoteDailyRelease } from "./release-promotion.js";
3
1
  import { createGitHubPromotionProvider } from "./github-release-promotion.js";
2
+ import { promoteDailyRelease } from "./release-promotion.js";
3
+ import { hostedReleaseWorkflows, parseReleaseConfig } from "./release-config.js";
4
4
  // src/release/release-promotion-command.ts
5
5
  /** Execute promotion only from a trusted main-branch GitHub release job. */
6
6
  async function runPromotionCommand(options) {
@@ -22,6 +22,7 @@ async function runPromotionCommand(options) {
22
22
  now: options.now ?? (/* @__PURE__ */ new Date()).toISOString(),
23
23
  held: env.STABLE_PROMOTION_HELD === "true",
24
24
  soakHours,
25
+ ...env.STABLE_SOAK_BYPASS_TAG ? { soakBypassTag: env.STABLE_SOAK_BYPASS_TAG } : {},
25
26
  provider
26
27
  });
27
28
  }
@@ -15,15 +15,25 @@ export type PromotionProvider = {
15
15
  /** Idempotently mark the already-qualified release stable and record the supplied time. */
16
16
  markStable(release: PromotionRelease, at: string): Promise<void>;
17
17
  };
18
- /** Promote only a successfully qualified daily after the configured batch soak. */
18
+ /**
19
+ * Promote only a successfully qualified daily after the configured batch soak.
20
+ *
21
+ * `soakBypassTag` replaces a bad stable without waiting for the soak: it names exactly one pending
22
+ * daily (newer than the current stable, never a downgrade), which is promoted at once if it
23
+ * qualifies. Nothing else changes: qualification is still required, a hold still wins, and a tag
24
+ * that is not a pending daily is refused rather than ignored. Callers read it from a protected
25
+ * variable (STABLE_SOAK_BYPASS_TAG) set for one release and removed after it.
26
+ */
19
27
  export declare function promoteDailyRelease(options: {
20
28
  now: string;
21
29
  held?: boolean;
22
30
  soakHours?: number;
31
+ soakBypassTag?: string;
23
32
  provider: PromotionProvider;
24
33
  }): Promise<{
25
34
  status: 'held' | 'soaking' | 'unqualified';
26
35
  } | {
27
36
  status: 'stable';
28
37
  tag: string;
38
+ soakBypassed?: true;
29
39
  }>;
@@ -15,9 +15,19 @@ function stableTime(release) {
15
15
  return value;
16
16
  }
17
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. */
18
+ /**
19
+ * Promote only a successfully qualified daily after the configured batch soak.
20
+ *
21
+ * `soakBypassTag` replaces a bad stable without waiting for the soak: it names exactly one pending
22
+ * daily (newer than the current stable, never a downgrade), which is promoted at once if it
23
+ * qualifies. Nothing else changes: qualification is still required, a hold still wins, and a tag
24
+ * that is not a pending daily is refused rather than ignored. Callers read it from a protected
25
+ * variable (STABLE_SOAK_BYPASS_TAG) set for one release and removed after it.
26
+ */
19
27
  async function promoteDailyRelease(options) {
20
28
  if (options.held) return { status: "held" };
29
+ const bypass = options.soakBypassTag;
30
+ if (bypass !== void 0 && !eligibleTag(bypass)) throw new Error("Invalid soak bypass tag");
21
31
  const now = Date.parse(options.now);
22
32
  const hours = options.soakHours ?? 96;
23
33
  if (!Number.isFinite(now) || !Number.isSafeInteger(hours) || hours < 0 || hours > 8760) throw new Error("Invalid promotion clock or soak");
@@ -36,6 +46,21 @@ async function promoteDailyRelease(options) {
36
46
  const observedStable = releases.filter((release) => !release.draft && !release.prerelease && Date.parse(release.publishedAt) <= now && eligibleTag(release.tag)).sort(compareVersion).at(-1);
37
47
  const batch = dailies.filter((release) => release.prerelease && (!stable || order(release, stable) > 0) && (!observedStable || versionLessThan(observedStable.tag, release.tag)));
38
48
  const anchor = stable && (!observedStable || stable.tag === observedStable.tag) ? stableTime(stable) : observedStable?.publishedAt ?? batch[0]?.publishedAt;
49
+ if (bypass !== void 0) {
50
+ const named = batch.find((release) => release.tag === bypass);
51
+ if (!named) throw new Error(`Soak bypass tag ${bypass} is not a pending daily`);
52
+ let qualified = false;
53
+ try {
54
+ qualified = await options.provider.qualify(named) === true;
55
+ } catch {}
56
+ if (!qualified) return { status: "unqualified" };
57
+ await options.provider.markStable(named, options.now);
58
+ return {
59
+ status: "stable",
60
+ tag: named.tag,
61
+ soakBypassed: true
62
+ };
63
+ }
39
64
  const candidates = anchor !== void 0 && now - Date.parse(anchor) >= hours * 36e5 ? [...batch].reverse() : [];
40
65
  candidates.sort((a, b) => versionLessThan(a.tag, b.tag) ? 1 : versionLessThan(b.tag, a.tag) ? -1 : order(b, a));
41
66
  if (stable && (!observedStable || stable.tag === observedStable.tag)) candidates.push(stable);
@@ -1,7 +1,7 @@
1
- import { validateReleaseQualification } from "./release-qualification.js";
1
+ import { hashUnchangedFile, openUnchangedFile } from "../updates/locks/stable-file.js";
2
2
  import { verifyReleaseDescriptor } from "../updates/feed/signed-release.js";
3
3
  import { releaseAssetNames } from "./release-config.js";
4
- import { hashUnchangedFile, openUnchangedFile } from "../updates/locks/stable-file.js";
4
+ import { validateReleaseQualification } from "./release-qualification.js";
5
5
  import { lstat, mkdtemp, open, rm, writeFile } from "node:fs/promises";
6
6
  import { join, resolve } from "node:path";
7
7
  import { createHash } from "node:crypto";
@@ -1,11 +1,11 @@
1
1
  import { isGitSha, isRecord } from "../app/value-guards.js";
2
2
  import { githubCli, verifyWorkflowAttempt } from "./github-cli.js";
3
- import { assertRepositorySlug } from "../updates/feed/signed-release.js";
4
- import { feedUrl } from "../updates/feed/release-feed.js";
5
- import { discoveryPolicies, hostedReleaseWorkflows, parseReleaseConfig } from "./release-config.js";
3
+ import { createGitHubReleasePublisher } from "./github-release-publisher.js";
6
4
  import { publishQualifiedRelease } from "./release-publication.js";
5
+ import { discoveryPolicies, hostedReleaseWorkflows, parseReleaseConfig } from "./release-config.js";
7
6
  import { commandReceiptName } from "../installer/command-qualification-command.js";
8
- import { createGitHubReleasePublisher } from "./github-release-publisher.js";
7
+ import { feedUrl } from "../updates/feed/release-feed.js";
8
+ import { assertRepositorySlug } from "../updates/feed/signed-release.js";
9
9
  import { open } from "node:fs/promises";
10
10
  import { join, resolve } from "node:path";
11
11
  // src/release/release-publish-command.ts
@@ -1,10 +1,10 @@
1
- import { assertPortableAppName } from "../installer/installer-layout.js";
2
- import { parseReleaseConfig, platformPayloads } from "./release-config.js";
3
1
  import { packCommandArtifact, readCommandArtifact } from "../installer/command-artifact.js";
4
2
  import { qualifyCommandArtifactsCommand } from "../installer/command-qualification-command.js";
5
3
  import { verifyInstallerPayload } from "../installer/installer-identity.js";
4
+ import { assertPortableAppName } from "../installer/installer-layout.js";
6
5
  import { qualifyInstallerCommand } from "../installer/installer-qualification-command.js";
7
6
  import { qualifyUpgradeCommand } from "../installer/installer-upgrade-command.js";
7
+ import { parseReleaseConfig, platformPayloads } from "./release-config.js";
8
8
  import { stagePlatformArtifacts } from "./release-staging.js";
9
9
  import { selectRetainedReleaseBuild } from "./retained-release-build.js";
10
10
  import { appendFile, mkdir, mkdtemp, readdir, rm } from "node:fs/promises";
@@ -1,9 +1,9 @@
1
1
  import { isGitSha, isRecord } from "../app/value-guards.js";
2
2
  import { githubCli } from "./github-cli.js";
3
- import { lookupRelease } from "./github-release-lookup.js";
4
- import { hostedReleaseWorkflows, parseReleaseConfig, platformPayloads, workflowFile } from "./release-config.js";
5
3
  import { createGitHubReleaseCutProvider } from "./github-release-cut.js";
4
+ import { hostedReleaseWorkflows, parseReleaseConfig, platformPayloads, workflowFile } from "./release-config.js";
6
5
  import { planReleaseAssets, releasePlanGitHubEnvironment } from "./release-assets-plan.js";
6
+ import { lookupRelease } from "./github-release-lookup.js";
7
7
  // src/release/retained-release-build.ts
8
8
  var id = (value) => {
9
9
  if (typeof value === "number" && !Number.isSafeInteger(value)) throw new Error("Invalid GitHub identity");
@@ -1,7 +1,7 @@
1
- import { hasEditableKeyboardTarget } from "./keyboard-target.js";
2
- import { detectShortcutPlatform, resolveShortcutPlatform, settingsShortcutLabel, shortcutModifierKey } from "./shortcut-platform.js";
3
1
  import { matchesSettingsKeyshortcuts, parseSettingsKeyshortcuts } from "./settings-shortcuts.js";
4
2
  import { defineSettingsSections, settingsSectionFromHash } from "./settings-sections.js";
3
+ import { detectShortcutPlatform, resolveShortcutPlatform, settingsShortcutLabel, shortcutModifierKey } from "./shortcut-platform.js";
4
+ import { hasEditableKeyboardTarget } from "./keyboard-target.js";
5
5
  import { browserUpdateAdapter } from "../updates/update-adapter.js";
6
6
  import { DEFAULT_NARROW_QUERY, createMediaQuery } from "./media-query.js";
7
7
  import { createComponent, memo, mergeProps, template } from "solid-js/web";
@@ -1,6 +1,6 @@
1
- import { isUpdateChannel } from "./feed/release-version.js";
2
- import { selectUpdateDownloadDiscard } from "./install/update-download-cleanup.js";
3
1
  import { createUpdateManager } from "./update-manager.js";
2
+ import { selectUpdateDownloadDiscard } from "./install/update-download-cleanup.js";
3
+ import { isUpdateChannel } from "./feed/release-version.js";
4
4
  import { releaseChannelForUpdate } from "./update-channel-store.js";
5
5
  // src/updates/channel-update-manager.ts
6
6
  /** Re-read the persisted channel for every check and bind an approval to that choice. */
@@ -1,17 +1,17 @@
1
1
  import { ServiceError } from "../app/service-registry.js";
2
+ import { createChannelUpdateManager } from "./channel-update-manager.js";
2
3
  import { feedUrl, parseReleaseFeed } from "./feed/release-feed.js";
3
- import { findPendingUpdateHealthAcknowledgement } from "./retention/retirement-inventory.js";
4
- import { acknowledgeRetiredUpdateHealthy } from "./retention/update-retirement.js";
5
- import { stageUpdateSwap } from "./install/update-swap-stage.js";
6
- import { downloadVerifiedRelease } from "./install/update-download.js";
7
- import { completeOwnedUpdateDownload, createOwnedUpdateDownload, initializeOwnedUpdateDownloadRoot } from "./install/update-download-cleanup.js";
8
- import { UpdatePreflightError } from "./update-preflight-error.js";
9
4
  import { createUpdateChannelStore, releaseChannelForUpdate } from "./update-channel-store.js";
10
- import { createChannelUpdateManager } from "./channel-update-manager.js";
11
- import { UpdateCleanupPendingError, findUpdateCleanupTerminalError } from "./update-cleanup-error.js";
12
5
  import { armUpdateHelper } from "./install/update-arm.js";
13
6
  import { resumeUpdate } from "./helper/update-resume.js";
7
+ import { acknowledgeRetiredUpdateHealthy } from "./retention/update-retirement.js";
8
+ import { findPendingUpdateHealthAcknowledgement } from "./retention/retirement-inventory.js";
14
9
  import { scheduleUpdateShutdown } from "./helper/update-shutdown.js";
10
+ import { UpdateCleanupPendingError, findUpdateCleanupTerminalError } from "./update-cleanup-error.js";
11
+ import { stageUpdateSwap } from "./install/update-swap-stage.js";
12
+ import { completeOwnedUpdateDownload, createOwnedUpdateDownload, initializeOwnedUpdateDownloadRoot } from "./install/update-download-cleanup.js";
13
+ import { downloadVerifiedRelease } from "./install/update-download.js";
14
+ import { UpdatePreflightError } from "./update-preflight-error.js";
15
15
  import { installTarget, updatePlatform } from "./install-target.js";
16
16
  import { acquireRetainedDesktopClientAssets, canonicalTargetForRecovery, resumeAndAcquireRetainedDesktopClientAssets } from "./retained-client-assets.js";
17
17
  import { parseUpdateChannel, parseUpdateInstall, registerUpdateServices } from "./update-services.js";
@@ -1,8 +1,8 @@
1
1
  import { isRecord } from "../../app/value-guards.js";
2
- import { isCanonicalPath } from "../../native/canonical-path.js";
3
- import { isRepositorySlug } from "./signed-release.js";
4
2
  import { parseReleaseConfig } from "../../release/release-config.js";
5
3
  import { openUnchangedFile, sameFile } from "../locks/stable-file.js";
4
+ import { isRepositorySlug } from "./signed-release.js";
5
+ import { isCanonicalPath } from "../../native/canonical-path.js";
6
6
  import { lstat } from "node:fs/promises";
7
7
  import { join } from "node:path";
8
8
  // src/updates/feed/packaged-release-config.ts
@@ -1,7 +1,7 @@
1
- import { versionLessThan } from "./release-version.js";
2
1
  import { isRepositorySlug, verifyReleaseDescriptor } from "./signed-release.js";
3
- import { parseFeedRelease, parseReleaseLedger } from "./release-feed.js";
4
2
  import { fetchReleaseLocation, readReleaseBytes, readReleaseJson } from "./release-location.js";
3
+ import { parseFeedRelease, parseReleaseLedger } from "./release-feed.js";
4
+ import { versionLessThan } from "./release-version.js";
5
5
  import { createHash } from "node:crypto";
6
6
  // src/updates/feed/update-discovery.ts
7
7
  var MAX_POINTER_BYTES = 262144;
@@ -1,12 +1,12 @@
1
1
  import { UUID_SOURCE, errorCode, isUuid } from "../../app/value-guards.js";
2
2
  import { verifyReleaseDescriptor } from "../feed/signed-release.js";
3
+ import { parseUpdateHelperRequest } from "./update-helper.js";
4
+ import { tryAcquireUpdateInstanceLease } from "../locks/update-instance-lease.js";
3
5
  import { tryAcquireUpdateLock } from "../locks/update-lock.js";
4
6
  import { readUpdateStageState, syncUpdateStageDirectory, writeUpdateStageStateDurably } from "../update-state-store.js";
5
7
  import { readUpdateTreeIdentity, readUpdateTreeVersion, sameUpdateTreeDigest, sameUpdateTreeIdentity, syncUpdateTreeParent, updateStagingFor } from "../install/update-swap.js";
6
- import { readUpdateMarker } from "../install/update-marker.js";
7
- import { tryAcquireUpdateInstanceLease } from "../locks/update-instance-lease.js";
8
8
  import { readUpdateLaunchGate, tryAcquireUpdateHelperLiveness, tryRecoverUpdateLaunchGate } from "../launch/update-launch-gate.js";
9
- import { parseUpdateHelperRequest } from "./update-helper.js";
9
+ import { readUpdateMarker } from "../install/update-marker.js";
10
10
  import { readTreeDigestForProof } from "./resume-staging.js";
11
11
  import { lstat, open, readdir, realpath, rm, unlink } from "node:fs/promises";
12
12
  import { join } from "node:path";
@@ -1,10 +1,10 @@
1
1
  import { errorCode } from "../../app/value-guards.js";
2
- import { renameExclusive } from "../../native/native-rename.js";
3
2
  import { verifyReleaseDescriptor } from "../feed/signed-release.js";
4
- import { readUpdateHelperRequestFile, writeUpdateStageState } from "../update-state-store.js";
5
- import { readUpdateTreeDigest, readUpdateTreeIdentity, readUpdateTreeVersion, sameUpdateTreeDigest, sameUpdateTreeIdentity } from "../install/update-swap.js";
3
+ import { renameExclusive } from "../../native/native-rename.js";
6
4
  import { parseUpdateHelperRequest } from "./update-helper.js";
7
5
  import { updateProcessMayBeAlive } from "../locks/update-process-liveness.js";
6
+ import { readUpdateHelperRequestFile, writeUpdateStageState } from "../update-state-store.js";
7
+ import { readUpdateTreeDigest, readUpdateTreeIdentity, readUpdateTreeVersion, sameUpdateTreeDigest, sameUpdateTreeIdentity } from "../install/update-swap.js";
8
8
  import { lstat, readdir, rm } from "node:fs/promises";
9
9
  import { join } from "node:path";
10
10
  import { randomUUID } from "node:crypto";
@@ -1,11 +1,11 @@
1
1
  import { errorCode, isUuid } from "../../app/value-guards.js";
2
- import { isCanonicalPath } from "../../native/canonical-path.js";
3
- import { acquireUpdateLock, readUpdateStageState, writeUpdateStageState, writeUpdateStageStateDurably } from "../update-state-store.js";
4
- import { readUpdateTreeDigest, readUpdateTreeIdentity, readUpdateTreeVersion, sameUpdateTreeDigest, sameUpdateTreeIdentity, swapUpdateTreeWhileLocked, syncUpdateTree, syncUpdateTreeParent, updateStagingFor } from "../install/update-swap.js";
5
2
  import { publishExclusiveUpdateMarker, publishExclusiveUpdateMarkerSync, readUpdateMarker } from "../install/update-marker.js";
6
3
  import { launchInstalledApp } from "../launch/update-launch.js";
7
4
  import { UpdateProcessFenceCancelledError, waitForUpdateProcesses } from "../locks/update-process-fence.js";
5
+ import { readUpdateTreeDigest, readUpdateTreeIdentity, readUpdateTreeVersion, sameUpdateTreeDigest, sameUpdateTreeIdentity, swapUpdateTreeWhileLocked, syncUpdateTree, syncUpdateTreeParent, updateStagingFor } from "../install/update-swap.js";
6
+ import { acquireUpdateLock, readUpdateStageState, writeUpdateStageState, writeUpdateStageStateDurably } from "../update-state-store.js";
8
7
  import { cancelUpdateLaunchGateBeforeTransition, publishUpdateLaunchGate, tryAcquireUpdateHelperLiveness, waitForUpdateLaunchGateWriter } from "../launch/update-launch-gate.js";
8
+ import { isCanonicalPath } from "../../native/canonical-path.js";
9
9
  import { lstat, open, realpath } from "node:fs/promises";
10
10
  import { join } from "node:path";
11
11
  import { constants as constants$1 } from "node:fs";
@@ -1,10 +1,10 @@
1
- import { UpdateLockBusyError, acquireUpdateLock, readUpdateStageState } from "../update-state-store.js";
2
- import { readUpdateTreeIdentity, readUpdateTreeVersion, sameUpdateTreeDigest, sameUpdateTreeIdentity, updateStagingFor } from "../install/update-swap.js";
3
- import { readUpdateLaunchGate } from "../launch/update-launch-gate.js";
4
1
  import { hasUpdateHelperArtifacts } from "./update-helper.js";
5
2
  import { updateProcessMayBeAlive } from "../locks/update-process-liveness.js";
3
+ import { UpdateLockBusyError, acquireUpdateLock, readUpdateStageState } from "../update-state-store.js";
4
+ import { readUpdateTreeIdentity, readUpdateTreeVersion, sameUpdateTreeDigest, sameUpdateTreeIdentity, updateStagingFor } from "../install/update-swap.js";
6
5
  import { acquireRetainedUpdateTrees, acquireRetainedUpdateTreesWhileLocked } from "../retention/retirement-inventory.js";
7
6
  import { reconcileRetirementCleanupMarkerWhileLocked, retireCompletedUpdateWhileLocked } from "../retention/update-retirement.js";
7
+ import { readUpdateLaunchGate } from "../launch/update-launch-gate.js";
8
8
  import { exists, readTreeDigestForProof, reconcileSwap, recoverLegacyHandoff, recoverStagedCandidate, resetToStaged } from "./resume-staging.js";
9
9
  import { recoverUpdateLaunchGate } from "./launch-gate-recovery.js";
10
10
  import { lstat, readFile, readdir, rmdir, unlink } from "node:fs/promises";
@@ -1,13 +1,13 @@
1
1
  import { isUuid } from "../../app/value-guards.js";
2
- import { isCanonicalPath } from "../../native/canonical-path.js";
3
- import { verifyReleaseDescriptor } from "../feed/signed-release.js";
4
- import { acquireUpdateLock, readUpdateHelperRequestFile, readUpdateStageState, writeUpdateStageState } from "../update-state-store.js";
5
- import { readUpdateTreeDigest, readUpdateTreeIdentity, sameUpdateTreeDigest, sameUpdateTreeIdentity, updateStagingFor } from "./update-swap.js";
6
2
  import { isUpdateHelperReadyMarker, readUpdateMarker } from "./update-marker.js";
7
3
  import { updateLauncherPath } from "../launch/update-launch.js";
8
- import { publishUpdateLaunchGateCancellationRequest, readUpdateLaunchGate } from "../launch/update-launch-gate.js";
4
+ import { readUpdateTreeDigest, readUpdateTreeIdentity, sameUpdateTreeDigest, sameUpdateTreeIdentity, updateStagingFor } from "./update-swap.js";
5
+ import { verifyReleaseDescriptor } from "../feed/signed-release.js";
6
+ import { acquireUpdateLock, readUpdateHelperRequestFile, readUpdateStageState, writeUpdateStageState } from "../update-state-store.js";
9
7
  import { hasUpdateHelperArtifacts, parseUpdateHelperRequest } from "../helper/update-helper.js";
8
+ import { publishUpdateLaunchGateCancellationRequest, readUpdateLaunchGate } from "../launch/update-launch-gate.js";
10
9
  import { UpdateCleanupPendingError, UpdateCleanupTerminalError } from "../update-cleanup-error.js";
10
+ import { isCanonicalPath } from "../../native/canonical-path.js";
11
11
  import { copyFile, lstat, mkdir, realpath, rm, writeFile } from "node:fs/promises";
12
12
  import { basename, dirname, join } from "node:path";
13
13
  import { randomUUID } from "node:crypto";
@@ -1,8 +1,8 @@
1
- import { assertSidecarNames, sidecarBundlePath } from "../../native/app-bundle.js";
2
1
  import { assertBuildMetadata, assertPayloadLayout, assertPortableAppName } from "../../installer/installer-layout.js";
3
2
  import { isVerifiedRelease, verifyReleaseStream } from "../feed/signed-release.js";
4
- import { safeArchivePath } from "../../installer/archive-entry.js";
5
3
  import { isLinuxCefLibraryLink } from "../../native/linux-cef-links.js";
4
+ import { safeArchivePath } from "../../installer/archive-entry.js";
5
+ import { assertSidecarNames, sidecarBundlePath } from "../../native/app-bundle.js";
6
6
  import { lstat, mkdir, mkdtemp, open, readFile, realpath, rm, symlink } from "node:fs/promises";
7
7
  import { isAbsolute, join } from "node:path";
8
8
  import { createHash } from "node:crypto";
@@ -1,7 +1,7 @@
1
- import { versionLessThan } from "../feed/release-version.js";
2
- import { isCanonicalPath } from "../../native/canonical-path.js";
3
1
  import { assertPortableAppName } from "../../installer/installer-layout.js";
4
2
  import { isVerifiedReleaseForTrust } from "../feed/signed-release.js";
3
+ import { versionLessThan } from "../feed/release-version.js";
4
+ import { isCanonicalPath } from "../../native/canonical-path.js";
5
5
  import { basename } from "node:path";
6
6
  // src/updates/install/update-handoff-plan.ts
7
7
  /** Validate an explicitly approved update and its intended installation. This plan does not move files or launch a helper. */
@@ -1,12 +1,12 @@
1
1
  import { errorCode } from "../../app/value-guards.js";
2
- import { renameExclusive } from "../../native/native-rename.js";
3
- import { exportVerifiedRelease } from "../feed/signed-release.js";
4
2
  import { planUpdateHandoff } from "./update-handoff-plan.js";
5
3
  import { extractVerifiedUpdate } from "./update-extraction.js";
6
- import { newUpdateStageState, readUpdateStageState, withUpdateLock, writeUpdateStageState } from "../update-state-store.js";
4
+ import { renameExclusive } from "../../native/native-rename.js";
7
5
  import { readUpdateTreeDigest, readUpdateTreeIdentity, updateStagingFor } from "./update-swap.js";
8
6
  import { assertNoUpdateRetentionPruneArtifactsWhileLocked } from "../retention/retirement-inventory.js";
9
7
  import { reconcileRetirementCleanupMarkerWhileLocked } from "../retention/update-retirement.js";
8
+ import { newUpdateStageState, readUpdateStageState, withUpdateLock, writeUpdateStageState } from "../update-state-store.js";
9
+ import { exportVerifiedRelease } from "../feed/signed-release.js";
10
10
  import { lstat, mkdtemp, readFile, realpath, rm } from "node:fs/promises";
11
11
  import { join } from "node:path";
12
12
  // src/updates/install/update-swap-stage.ts