Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Next Next commit
release: prepare v0.0.8 with native legacy Windows upgrade qualification
  • Loading branch information
SivanCola committed Nov 13, 2026
commit f8974e51e8bd9fbda264f53a278d91032689f06c
3 changes: 3 additions & 0 deletions .github/release-signing.yml
Original file line number Diff line number Diff line change
Expand Up @@ -31,4 +31,7 @@ fingerprint_files:
- scripts/verify-windows-authenticode.ps1
- scripts/test-windows-installer-startup.ps1
- scripts/test-windows-startup-recovery.ps1
- scripts/test-windows-legacy-update.ps1
- scripts/legacy-windows-update.gotest
- .github/workflows/verify-windows-auto-update.yml
- cmd/release-signing-contract/main.go
71 changes: 70 additions & 1 deletion .github/workflows/release-desktop.yml
Original file line number Diff line number Diff line change
Expand Up @@ -819,12 +819,73 @@ jobs:
overwrite: true
if-no-files-found: error
retention-days: 30
windows-legacy-upgrade:
name: verify v0.0.7 automatic handoff (${{ matrix.arch }})
needs: [resolve, windows-sign]
if: ${{ always() && !cancelled() && needs.resolve.result == 'success' && needs.windows-sign.result == 'success' }}
permissions:
contents: read
actions: read
strategy:
fail-fast: false
matrix:
include:
- runner: windows-latest
arch: amd64
- runner: windows-11-arm
arch: arm64
runs-on: ${{ matrix.runner }}
timeout-minutes: 25
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
with:
ref: ${{ github.workflow_sha }}
path: release-control
persist-credentials: false
- name: Select legacy upgrade qualification
id: policy
shell: pwsh
run: |
$mode = node ./release-control/scripts/windows-distribution.mjs mode "${{ needs.resolve.outputs.version }}"
if ($LASTEXITCODE -ne 0) { throw 'Invalid Windows distribution policy' }
"required=$($mode -eq 'installer-only')" >> $env:GITHUB_OUTPUT
- uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333
if: steps.policy.outputs.required == 'True'
with:
name: ${{ needs.resolve.outputs.artifact_prefix }}-windows-${{ matrix.arch }}
path: ${{ runner.temp }}/windows-bundle
- name: Upgrade published installed and portable clients with their own helper
if: steps.policy.outputs.required == 'True'
shell: pwsh
run: |
$installer = @(Get-ChildItem -LiteralPath "$env:RUNNER_TEMP/windows-bundle/files" -Filter '*-Setup.exe' -File)
if ($installer.Count -ne 1) { throw 'Expected one exact candidate installer' }
./release-control/scripts/test-windows-legacy-update.ps1 -InstallerPath $installer[0].FullName -Architecture "${{ matrix.arch }}" -ExpectedVersion "${{ needs.resolve.outputs.version }}" -EvidenceDirectory "$env:RUNNER_TEMP/deepzora-legacy-update"
- uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9
if: always() && steps.policy.outputs.required == 'True'
with:
name: windows-legacy-update-${{ github.run_id }}-${{ github.run_attempt }}-${{ matrix.arch }}
path: |
${{ runner.temp }}/deepzora-legacy-update/**/*.json
${{ runner.temp }}/deepzora-legacy-update/**/*.log
!${{ runner.temp }}/deepzora-legacy-update/*/installed/**
!${{ runner.temp }}/deepzora-legacy-update/**/cache/**
if-no-files-found: ignore
retention-days: 90
- uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9
if: steps.policy.outputs.required == 'True'
with:
name: ${{ needs.resolve.outputs.artifact_prefix }}-legacy-upgrade-${{ matrix.arch }}
path: ${{ runner.temp }}/deepzora-legacy-update/legacy-update.json
if-no-files-found: error
retention-days: 90
windows-runtime-acceptance:
name: verify Windows installer (${{ matrix.arch }}, ${{ needs.resolve.outputs.windows_signing }})
needs:
- resolve
- windows-sign
if: ${{ always() && !cancelled() && needs.resolve.result == 'success' && needs.windows-sign.result == 'success' }}
- windows-legacy-upgrade
if: ${{ always() && !cancelled() && needs.resolve.result == 'success' && needs.windows-sign.result == 'success' && needs.windows-legacy-upgrade.result == 'success' }}
permissions:
contents: read
actions: read
Expand Down Expand Up @@ -892,6 +953,11 @@ jobs:
!${{ runner.temp }}/deepzora-portable-acceptance/**/cache/**
if-no-files-found: ignore
retention-days: 90
- uses: actions/download-artifact@9000827ccba6bdab643e8b6fd33ac0654aef8333
if: steps.distribution.outputs.mode == 'installer-only'
with:
name: ${{ needs.resolve.outputs.artifact_prefix }}-legacy-upgrade-${{ matrix.arch }}
path: ${{ runner.temp }}/legacy-upgrade-receipt
- name: Record Windows acceptance receipt
shell: pwsh
run: |
Expand All @@ -904,6 +970,9 @@ jobs:
$archiveHash = (Get-FileHash -Algorithm SHA256 -LiteralPath $portable[0].FullName).Hash.ToLowerInvariant()
if ("${{ steps.distribution.outputs.mode }}" -eq 'installer-only') {
$receipt.schema = 3
$upgrade = Get-Content -LiteralPath "$env:RUNNER_TEMP/legacy-upgrade-receipt/legacy-update.json" -Raw | ConvertFrom-Json
if ($upgrade.targetSHA256 -ne $receipt.sha256 -or $upgrade.targetVersion -ne $receipt.version -or $upgrade.installed -ne 'passed' -or $upgrade.portable -ne 'passed') { throw 'Legacy upgrade did not qualify this installer' }
$receipt.legacyUpgrade = $upgrade
$receipt.compatibilityStatus = 'passed'
$receipt.compatibilitySha256 = $archiveHash
} else {
Expand Down
10 changes: 10 additions & 0 deletions .github/workflows/release-promote.yml
Original file line number Diff line number Diff line change
Expand Up @@ -381,6 +381,16 @@ jobs:
R2_BUCKET: ${{ secrets.R2_BUCKET }}
CLOUDFLARE_PAGES_DEPLOY_HOOK: ${{ secrets.CLOUDFLARE_PAGES_DEPLOY_HOOK }}

legacy-windows-client:
name: verify original client against public update channel
needs: [preflight, mirror]
if: ${{ needs.mirror.result == 'success' }}
permissions:
contents: read
uses: ./.github/workflows/verify-windows-auto-update.yml
with:
version: ${{ needs.preflight.outputs.version }}

metrics:
name: record publication timing
needs: [preflight, authorize, activate, cli, npm, desktop, postflight]
Expand Down
97 changes: 97 additions & 0 deletions .github/workflows/verify-windows-auto-update.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,97 @@
name: Verify published Windows automatic updates

on:
workflow_call:
inputs:
version:
required: true
type: string
workflow_dispatch:
inputs:
version:
required: true
type: string

permissions:
contents: read

jobs:
policy:
if: github.repository == 'SivanCola/deepzora' && github.ref == 'refs/heads/main' && github.ref_protected
runs-on: ubuntu-latest
outputs:
required: ${{ steps.policy.outputs.required }}
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
with:
ref: ${{ github.workflow_sha }}
persist-credentials: false
- id: policy
env:
VERSION: ${{ inputs.version }}
run: |
node --input-type=module <<'JS'
import { appendFileSync } from 'node:fs';
import { windowsInstallerOnly } from './scripts/windows-distribution.mjs';
import { shouldAdvance } from './scripts/publish-github-update-pointer.mjs';
const response = await fetch('https://downloads.deepzora.app/desktop/latest.json', {redirect:'error',signal:AbortSignal.timeout(30000)});
if (!response.ok) throw new Error('Published App update pointer is unavailable');
const latest = await response.json();
const required = windowsInstallerOnly(process.env.VERSION) && shouldAdvance(process.env.VERSION, latest.version);
appendFileSync(process.env.GITHUB_OUTPUT, `required=${required}\n`);
if (!required) console.log('Historical recovery does not move the public update channel backwards.');
JS
verify:
needs: policy
if: needs.policy.outputs.required == 'true'
strategy:
fail-fast: false
matrix:
include:
- runner: windows-latest
arch: amd64
- runner: windows-11-arm
arch: arm64
runs-on: ${{ matrix.runner }}
timeout-minutes: 25
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
with:
ref: ${{ github.workflow_sha }}
path: release-control
persist-credentials: false
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1
with:
ref: b0208b176ba43c129d228b41b770579eb050bb1f
path: legacy-client
persist-credentials: false
- uses: actions/setup-go@b7ad1dad31e06c5925ef5d2fc7ad053ef454303e
with:
go-version-file: legacy-client/desktop/go.mod
cache: false
- name: Run the original client's public update path
shell: pwsh
env:
PUBLISHED_UPDATE_VERSION: ${{ inputs.version }}
PUBLISHED_UPDATE_EVIDENCE: ${{ runner.temp }}/published-update
run: |
if ((git -C legacy-client rev-parse HEAD) -ne 'b0208b176ba43c129d228b41b770579eb050bb1f') { throw 'Old client source drifted' }
Copy-Item release-control/scripts/legacy-windows-update.gotest legacy-client/desktop/published_update_acceptance_test.go
Push-Location legacy-client/desktop
go test . -run '^TestPublishedWindowsAutoUpdate$' -count=1 -v -timeout=15m
if ($LASTEXITCODE -ne 0) { throw 'The real old client public update path failed' }
Pop-Location
$file = Join-Path $env:PUBLISHED_UPDATE_EVIDENCE 'verified-installer.exe'
$signature = Get-AuthenticodeSignature -LiteralPath $file
if ($signature.Status -ne 'Valid' -or -not $signature.TimeStamperCertificate) { throw 'Old client did not download a trusted timestamped installer' }
$report = Get-Content (Join-Path $env:PUBLISHED_UPDATE_EVIDENCE 'published-update.json') -Raw | ConvertFrom-Json
if ($report.architecture -ne '${{ matrix.arch }}') { throw 'Native updater acceptance architecture mismatch' }
$report | Add-Member -NotePropertyName authenticode -NotePropertyValue 'passed'
$report | ConvertTo-Json | Set-Content (Join-Path $env:PUBLISHED_UPDATE_EVIDENCE 'published-update.json') -Encoding utf8
- uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9
if: always()
with:
name: published-windows-update-${{ inputs.version }}-${{ matrix.arch }}-${{ github.run_attempt }}
path: ${{ runner.temp }}/published-update/*.json
if-no-files-found: error
retention-days: 90
14 changes: 11 additions & 3 deletions cmd/release-signing-contract/certum_ui_test.go
Original file line number Diff line number Diff line change
Expand Up @@ -21,9 +21,17 @@ func TestPowerShellCertumWindowReadiness(t *testing.T) {
}
found = true
t.Run(name, func(t *testing.T) {
command := exec.Command(binary, "-NoLogo", "-NoProfile", "-NonInteractive", "-File", script)
if output, err := command.CombinedOutput(); err != nil {
t.Fatalf("Certum UI regression: %v\n%s", err, output)
scripts := []string{script}
if runtime.GOOS == "windows" {
for _, name := range []string{"test-windows-installer-startup.test.ps1", "test-windows-upgrade-startup.test.ps1"} {
scripts = append(scripts, filepath.Join(filepath.Dir(script), name))
}
}
for _, file := range scripts {
command := exec.Command(binary, "-NoLogo", "-NoProfile", "-NonInteractive", "-File", file)
if output, err := command.CombinedOutput(); err != nil {
t.Fatalf("Windows signing/acceptance regression %s: %v\n%s", file, err, output)
}
}
})
}
Expand Down
6 changes: 6 additions & 0 deletions desktop/bot_team_test.go
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,12 @@ func TestBotMemberRoutingUsesSharedMemberWithoutBroadcast(t *testing.T) {
if err != nil || member.Outcome != "applied" {
t.Fatalf("member creation %s %v", member.Outcome, err)
}
// This test measures channel routing, not cold member-runtime creation.
// Prepare the shared seat before starting the adapters' bounded ready wait;
// otherwise slow Windows storage turns setup into an opaque bot timeout.
if _, err := a.prepareBotMember(t.Context(), member.TargetID); err != nil {
t.Fatalf("prepare shared member runtime: %v", err)
}
inputs := []BotConnectionInput{}
for _, id := range []string{"wechat", "feishu"} {
input := BotConnectionInput{Config: botchannels.Config{ID: id, Name: id, Provider: "weixin", Mode: "member", MemberID: member.TargetID, ChatID: "peer", SenderID: "peer"}, Secret: id + "-secret", Connect: true}
Expand Down
9 changes: 9 additions & 0 deletions docs/RELEASE_CANDIDATES.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,15 @@ Starting with v0.0.8, Windows ships installers only. Each final x64 and ARM64
installer undergoes native startup, second-launch, normal-exit, uninstall and
user-data retention acceptance. Schema 3 receipts bind its SHA-256 and the hash
of an exact text-only migration ZIP, independently checked again when sealing.
They also require native upgrades from the exact published v0.0.7 installer and
portable packages, using that release's signed update helper. Both old clients
must exit normally, the helper must activate and restart the new candidate,
and the target must pass startup, repeat launch, normal exit and retained-data
checks. After publication and R2 promotion, the immutable v0.0.7 source runs its
original manifest, installer routing, download, Minisign verification and cache
code against the real public channel on x64 and ARM64. This last check is part
of the publication workflow; recovery of a superseded version does not downgrade
the public pointer to rerun an older target.

v0.0.7 and older updaters validate all eleven downloads, including the two
`*-Portable.zip` names, before updating any platform. Their Windows update route
Expand Down
6 changes: 6 additions & 0 deletions docs/RELEASE_CANDIDATES.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,12 @@ Desktop 文件、执行最终安装包的原生验收并封存记录。`Publish
从 v0.0.8 起,Windows 只提供安装包。最终 x64、ARM64 安装包在原生 runner 上验收
启动、重复启动、正常退出、卸载及用户数据保留。schema 3 回执绑定安装包与纯文本
迁移 ZIP 的 SHA-256;封存时再次独立检查迁移 ZIP 的精确内容。
回执还要求从已发布的 v0.0.7 安装包和便携包分别执行原生升级:运行真实旧客户端,
使用它自带的已签名更新助手,正常退出、激活并重启当前候选,验证新版本启动、
重复启动、正常退出和数据保留。公开发布及 R2 推进后,固定检出的 v0.0.7 源码
还会在原生 x64、ARM64 上,用原有清单校验、安装包选择、下载、Minisign 校验和
缓存代码访问真实公开更新通道。该验收属于发布工作流;恢复已被新版替代的历史
版本时不会倒退公开更新指针来测试旧目标。

v0.0.7 及更早更新器会在任意平台更新前严格校验全部 11 个下载条目,包括两个
`*-Portable.zip` 名称;Windows 更新路线实际已经指向 `*-Setup.exe`,现有便携
Expand Down
Loading
Loading