Desktop Dual Repo Test

Desktop Dual-Repo Test

Overview

Hermes Agent CN Desktop is a two-repo product:

Always sync both repos to the intended branch before testing. Never assume a packaged app is wrong just because the UI commit looks short — compare against the desktop tag SHA. Kernel commit comes from Core, not Desktop.

Guardrails

• Managed runtime port is 9120. Do not use 9119 (user global Hermes Agent).
• Dev and packaged apps share ~/.hermes profile data but use separate runtime trees:
  • Dev (pnpm tauri:dev): …/cn.org.hermesagent.desktop/dev-runtime/
  • Packaged app: …/cn.org.hermesagent.desktop/runtime/
• If packaged tests show kernel dev-local / commit de3b while UI is current, the production current.json was polluted by an old dev session — run migration (below), not a rebuild.
• macOS: detach all stale Hermes Agent CN Desktop* DMG volumes before reading or installing a release DMG. Never trust a mounted volume unless hdiutil info shows it came from the DMG you just downloaded.

Step 0 — Sync both repositories

开始测试前确认两个仓库已同步到目标分支，并在任务专用 worktree 中工作。若状态异常，先核对差异与归属，禁止破坏性重置或覆盖其它工作区。

记录 SHA 用于报告（只读，代理可执行）：

cd /path/to/Hermes-CN-Desktop && git rev-parse --short HEAD
cd /path/to/Hermes-CN-Core && git rev-parse --short HEAD

同步后每个仓库装一次依赖：

cd /path/to/Hermes-CN-Desktop && pnpm install

Step 1 — One-time cleanup (if packaged tests were ever run on a dev-polluted machine)

Run when production runtime/current.json has "source": "local-source" or kernel footer shows dev-local / de3b in the packaged app:

cd /path/to/Hermes-CN-Desktop
node scripts/migrate-runtime-trees.mjs

After PR #211 lands, new dev sessions no longer write into production runtime/; this step is mainly for machines used before that fix.

路线 A — Dev verification (both repos, latest code)

Use before creating/publishing a desktop tag or when validating UI + gateway changes without a signed build.

cd /path/to/Hermes-CN-Desktop
pnpm tauri:dev -- --source ../Hermes-CN-Core
# optional: --force  to reinstall local kernel into dev-runtime

What this does:

1. install-local-runtime.mjs copies Hermes-CN-Core into dev-runtime/versions/dev-local-* and writes dev-runtime/current.json (source: local-source).
2. tauri dev loads WebView from http://localhost:9545, dashboard on 9120, PATH hermes disabled.

Expected dev signals

Do not use dev footer commits to judge a GHA release package. Route A only gates "merge + tag" readiness.

Pre-flight checks:

pnpm typecheck
pnpm test:unit
cargo check

路线 B — Packaged verification (GHA signed build)

Use after a desktop prerelease tag exists (e.g. v0.3.3-beta.2). Requires network for download unless --dmg is provided.

Install (macOS arm64 example)

cd /path/to/Hermes-CN-Desktop
node scripts/migrate-runtime-trees.mjs   # if machine ever ran dev on same profile
node scripts/install-release-dmg.mjs \
  --tag v0.3.3-beta.2 \
  --expected-runtime 0.16.0-cn.6
open -a "Hermes Agent CN Desktop"

Verify the installed bundle before testing UI:

defaults read "/Applications/Hermes Agent CN Desktop.app/Contents/Info.plist" CFBundleShortVersionString
cat "/Applications/Hermes Agent CN Desktop.app/Contents/Resources/bundled-runtime/README.generated.txt"

README.generated.txt must show repo=Eynzof/Hermes-CN-Core, tag=runtime-v0.16.0-cn.6 (or the tag under test), and runtimeVersion= matching --expected-runtime.

Intel Mac: asset name uses _x64.dmg. Windows: use the release .exe from the same GitHub tag page.

Packaged checks (UI only — no devtools in release)

Wait for kernel ready (dashboard 9120 returns 200), then:

1. 03 高级 → 内核 hero badge: runtime-v0.16.0-cn.6 (full release tag form), hover explains Core release tag.
2. WS 中继: 连接中（中继路径） with hover text; then one chat round-trip. If 未启用（webview 直连）, record it — still valid data.
3. Quick regression: session switch (no flash), soul page revisit, turn stats bar, approval + interrupt once.

Expected packaged signals

Report table (fill and return)

Troubleshooting

When to run which route

• PR merged, considering tag → 路线 A on both repos' latest main (or integration branch).
• Tag pushed, GHA green → 路线 B on release asset; 路线 A results do not replace B for runtime badge or macOS relay.
• Stable/formal public release → also run .codex/skills/desktop-release-sync-landing/SKILL.md for landing / latest.json.
• RC / beta / alpha / canary prerelease → do not modify the landing repository and do not point public latest.json at the prerelease; distribute and validate through GitHub Release or a dedicated internal channel.