From c5f3cad71839fdbe5f23165abaafc0636835ff84 Mon Sep 17 00:00:00 2001 From: LoopX Agent <337587101+loopx-agent@users.noreply.github.com> Date: Sun, 22 Nov 2026 06:09:45 +0800 Subject: [PATCH 1/2] docs(release): record v2.4.0 release baseline and Feishu guide link Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com> --- docs/product/release-readiness.md | 20 ++++++++++++++++++++ docs/product/releases/v2.4.0.md | 4 ++++ 2 files changed, 24 insertions(+) diff --git a/docs/product/release-readiness.md b/docs/product/release-readiness.md index 458e7dbbc0..228f31e47a 100644 --- a/docs/product/release-readiness.md +++ b/docs/product/release-readiness.md @@ -1056,6 +1056,26 @@ path, and canary route rather than as a user-facing release baseline. Check the installation owner and read back an existing Goal after updating. [Versioned upgrade guide](https://github.com/loopx-project/loopx/blob/v2.3.0/docs/product/releases/v2.3.0.md#upgrade). +- `v2.4.0` release at commit + `a6ffb3be6e7bdb48e02311ec58d618200fe0501c` (2026-11-22). + The Git `stable` ref, CLI archive + (`loopx-runtime-a6ffb3be6e7bdb48e02311ec58d618200fe0501c.tar.gz`) and bundled + macOS runtime match the tag with verified GitHub artifact attestations. + GitHub and PyPI carry matching Python wheel and source packages. + The signed `desktop-stable` feed serves Apple Silicon macOS + (`LoopX_2.4.0_aarch64.dmg`, `LoopX.app.zip`, and `LoopX.app.tar.gz`). + Windows stable upgrades use `LoopX_2.4.0_x64-setup.exe` or + `LoopX_2.4.0_x64_en-US.msi`. + The companion `dsh-loopx-plugin 0.1.1-beta.7` GitHub prerelease tarball + targets LoopX 2.4.0+ and DSH `0.2.2-rc.1..rc.3` (npm trusted publishing + remains pending workflow `./output/` path alignment and owner npmjs setup). + [Published release](https://github.com/loopx-project/loopx/releases/tag/v2.4.0), + [PyPI packages](https://pypi.org/project/loopx/2.4.0/#files), + [Illustrated Feishu upgrade guide](https://my.feishu.cn/docx/JXvbdWcFDoZJgvxktvScYfJwnRf). + Run `loopx authority-archive upgrade --all-known --require-current` first, + check the installation owner, and read back an existing Goal after updating. + [Versioned upgrade guide](https://github.com/loopx-project/loopx/blob/v2.4.0/docs/product/releases/v2.4.0.md#upgrade). + When a new public release is promoted, add it here only after the matching tag, release note, stable ref, update path, and focused release canary agree. diff --git a/docs/product/releases/v2.4.0.md b/docs/product/releases/v2.4.0.md index 57218f78ee..62ea8ef976 100644 --- a/docs/product/releases/v2.4.0.md +++ b/docs/product/releases/v2.4.0.md @@ -18,6 +18,8 @@ loopx --version loopx doctor ``` +[Illustrated Feishu upgrade guide](https://my.feishu.cn/docx/JXvbdWcFDoZJgvxktvScYfJwnRf) + ### Highlights - **Create a Goal from Chat and search loaded history.** Review a draft and confirm once to create the Goal and open its conversation when runtime and permissions are ready; search loaded conversations back to original messages, keep saved Research answers intact across Desktop reopenings, recover interrupted answers or pre-dispatch requests, diagnose lost workers, and preserve readable quoted Markdown. [#8676](https://github.com/loopx-project/loopx/pull/8676), [#8780](https://github.com/loopx-project/loopx/pull/8780), [#8863](https://github.com/loopx-project/loopx/pull/8863), [#8868](https://github.com/loopx-project/loopx/pull/8868), [#8880](https://github.com/loopx-project/loopx/pull/8880), [#8892](https://github.com/loopx-project/loopx/pull/8892), [#8983](https://github.com/loopx-project/loopx/pull/8983), [#9120](https://github.com/loopx-project/loopx/pull/9120), [#9125](https://github.com/loopx-project/loopx/pull/9125) @@ -426,6 +428,8 @@ loopx --version loopx doctor ``` +[飞书图文升级与验收指南](https://my.feishu.cn/docx/JXvbdWcFDoZJgvxktvScYfJwnRf) + ### 主要变化 - **一次确认创建 Goal 与对话历史检索。** 在 Chat 审核并确认一次草稿即可创建 Goal 并打开原会话;支持在已载入会话中搜索并跳回原消息,桌面重开后保留已保存研究回答、恢复中断回答及派发前请求、诊断失联 worker 与清晰引用 Markdown。 [#8676](https://github.com/loopx-project/loopx/pull/8676), [#8780](https://github.com/loopx-project/loopx/pull/8780), [#8863](https://github.com/loopx-project/loopx/pull/8863), [#8868](https://github.com/loopx-project/loopx/pull/8868), [#8880](https://github.com/loopx-project/loopx/pull/8880), [#8892](https://github.com/loopx-project/loopx/pull/8892), [#8983](https://github.com/loopx-project/loopx/pull/8983), [#9120](https://github.com/loopx-project/loopx/pull/9120), [#9125](https://github.com/loopx-project/loopx/pull/9125) From 90c3fb2cfca8094a41eff9465442b3771a238101 Mon Sep 17 00:00:00 2001 From: LoopX Agent <337587101+loopx-agent@users.noreply.github.com> Date: Sun, 22 Nov 2026 06:14:26 +0800 Subject: [PATCH 2/2] ci(dsh): fix publish artifact path and allow main dispatch for existing plugin tags Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com> --- .github/workflows/dsh-plugin-publish.yml | 6 +-- docs/product/release-readiness.md | 13 +++--- packages/dsh-loopx-plugin/README.md | 6 ++- tests/test_dsh_plugin_publish_workflow.py | 54 +++++++++++++++++++++++ 4 files changed, 68 insertions(+), 11 deletions(-) create mode 100644 tests/test_dsh_plugin_publish_workflow.py diff --git a/.github/workflows/dsh-plugin-publish.yml b/.github/workflows/dsh-plugin-publish.yml index 13401dce93..d0b662415f 100644 --- a/.github/workflows/dsh-plugin-publish.yml +++ b/.github/workflows/dsh-plugin-publish.yml @@ -17,7 +17,7 @@ concurrency: jobs: publish: - if: github.repository == 'loopx-project/loopx' && github.ref_type == 'tag' && github.ref_name == inputs.release_tag + if: github.repository == 'loopx-project/loopx' && ((github.ref_type == 'tag' && github.ref_name == inputs.release_tag) || (github.ref == 'refs/heads/main' && startsWith(inputs.release_tag, 'dsh-loopx-plugin-v'))) runs-on: ubuntu-latest timeout-minutes: 10 permissions: @@ -32,7 +32,7 @@ jobs: steps: - uses: actions/checkout@v7 with: - ref: ${{ github.sha }} + ref: refs/tags/${{ inputs.release_tag }} fetch-depth: 0 - uses: actions/setup-node@v6 with: @@ -47,7 +47,7 @@ jobs: const manifest = JSON.parse(readFileSync('package.json', 'utf8')) assert.equal(process.env.RELEASE_TAG, `dsh-loopx-plugin-v${manifest.version}`) mkdirSync('output', { recursive: true }) - appendFileSync(process.env.GITHUB_ENV, `DSH_ARTIFACT=output/${manifest.name}-${manifest.version}.tgz\n`) + appendFileSync(process.env.GITHUB_ENV, `DSH_ARTIFACT=./output/${manifest.name}-${manifest.version}.tgz\n`) NODE gh release view "$RELEASE_TAG" --repo "$GITHUB_REPOSITORY" --json tagName,isDraft > output/release.json node -e 'const r=require("./output/release.json"); require("node:assert/strict").equal(r.isDraft, false)' diff --git a/docs/product/release-readiness.md b/docs/product/release-readiness.md index 228f31e47a..e87b63c43d 100644 --- a/docs/product/release-readiness.md +++ b/docs/product/release-readiness.md @@ -1059,19 +1059,20 @@ path, and canary route rather than as a user-facing release baseline. - `v2.4.0` release at commit `a6ffb3be6e7bdb48e02311ec58d618200fe0501c` (2026-11-22). The Git `stable` ref, CLI archive - (`loopx-runtime-a6ffb3be6e7bdb48e02311ec58d618200fe0501c.tar.gz`) and bundled + (`loopx-runtime-a6ffb3be6e7bdb48e02311ec58d618200fe0501c.tar.gz`), and bundled macOS runtime match the tag with verified GitHub artifact attestations. GitHub and PyPI carry matching Python wheel and source packages. - The signed `desktop-stable` feed serves Apple Silicon macOS + The signed `desktop-stable` updater serves Apple Silicon macOS (`LoopX_2.4.0_aarch64.dmg`, `LoopX.app.zip`, and `LoopX.app.tar.gz`). Windows stable upgrades use `LoopX_2.4.0_x64-setup.exe` or `LoopX_2.4.0_x64_en-US.msi`. - The companion `dsh-loopx-plugin 0.1.1-beta.7` GitHub prerelease tarball - targets LoopX 2.4.0+ and DSH `0.2.2-rc.1..rc.3` (npm trusted publishing - remains pending workflow `./output/` path alignment and owner npmjs setup). + The companion + [DSH plugin 0.1.1-beta.7](https://github.com/loopx-project/loopx/releases/tag/dsh-loopx-plugin-v0.1.1-beta.7) + GitHub prerelease tarball targets LoopX 2.4.0+ and DSH `0.2.2-rc.1..rc.3` + (npm trusted publishing remains gated on npmjs owner setup). [Published release](https://github.com/loopx-project/loopx/releases/tag/v2.4.0), [PyPI packages](https://pypi.org/project/loopx/2.4.0/#files), - [Illustrated Feishu upgrade guide](https://my.feishu.cn/docx/JXvbdWcFDoZJgvxktvScYfJwnRf). + [Personal illustrated guide](https://my.feishu.cn/docx/JXvbdWcFDoZJgvxktvScYfJwnRf). Run `loopx authority-archive upgrade --all-known --require-current` first, check the installation owner, and read back an existing Goal after updating. [Versioned upgrade guide](https://github.com/loopx-project/loopx/blob/v2.4.0/docs/product/releases/v2.4.0.md#upgrade). diff --git a/packages/dsh-loopx-plugin/README.md b/packages/dsh-loopx-plugin/README.md index 4c30fa7443..f6815f202a 100644 --- a/packages/dsh-loopx-plugin/README.md +++ b/packages/dsh-loopx-plugin/README.md @@ -263,8 +263,10 @@ For every DSH plugin release: For token-free CI publication, configure the package's npm Trusted Publisher with organization `loopx-project`, repository `loopx`, and workflow filename `dsh-plugin-publish.yml`, permitting `npm publish`. Then dispatch **Publish - DSH Plugin to npm** on the existing published plugin tag, using that same tag - for the `release_tag` input. This keeps npm provenance on the artifact's commit. + DSH Plugin to npm** on the existing published plugin tag or on `main`, using + that same tag for the `release_tag` input. Dispatching from `main` still + checks out `refs/tags/` so the artifact commit and npm + provenance stay pinned to the immutable tag. The workflow requires a merged tag, consumes its GitHub asset without rebuilding, and verifies npm bytes and discovery. It neither creates a GitHub release nor replaces npm account ownership or the release guide gate. diff --git a/tests/test_dsh_plugin_publish_workflow.py b/tests/test_dsh_plugin_publish_workflow.py new file mode 100644 index 0000000000..976c6317c6 --- /dev/null +++ b/tests/test_dsh_plugin_publish_workflow.py @@ -0,0 +1,54 @@ +from __future__ import annotations + +import re +from pathlib import Path + +import yaml + +REPO_ROOT = Path(__file__).resolve().parents[1] +WORKFLOW_PATH = REPO_ROOT / ".github/workflows/dsh-plugin-publish.yml" +README_PATH = REPO_ROOT / "packages/dsh-loopx-plugin/README.md" + + +def test_dsh_plugin_publish_workflow_allows_tag_or_main_dispatch_with_relative_artifact_path() -> None: + raw = WORKFLOW_PATH.read_text(encoding="utf-8") + parsed = yaml.safe_load(raw) + + assert "workflow_dispatch" in parsed[True] + release_input = parsed[True]["workflow_dispatch"]["inputs"]["release_tag"] + assert release_input["required"] is True + assert release_input["type"] == "string" + + job = parsed["jobs"]["publish"] + condition = job["if"] + assert "github.repository == 'loopx-project/loopx'" in condition + assert "github.ref_type == 'tag' && github.ref_name == inputs.release_tag" in condition + assert "github.ref == 'refs/heads/main' && startsWith(inputs.release_tag, 'dsh-loopx-plugin-v')" in condition + + steps = job["steps"] + checkout = next(step for step in steps if str(step.get("uses", "")).startswith("actions/checkout@")) + assert checkout["with"]["ref"] == "refs/tags/${{ inputs.release_tag }}" + assert checkout["with"]["fetch-depth"] == 0 + + identity_run = next( + step["run"] + for step in steps + if step.get("name") == "Require a merged, published release with matching package identity" + ) + assert "git merge-base --is-ancestor HEAD origin/main" in identity_run + assert "DSH_ARTIFACT=./output/${manifest.name}-${manifest.version}.tgz" in identity_run + assert re.search(r"DSH_ARTIFACT=output/", raw) is None + + publish_step = next( + step for step in steps if step.get("name") == "Publish the same bytes with npm trusted publishing" + ) + assert 'npm publish "$DSH_ARTIFACT" --access public --tag latest --ignore-scripts --provenance' in publish_step["run"] + + verify_step = next( + step for step in steps if step.get("name") == "Read back npm bytes, latest, and marketplace repository discovery" + ) + assert 'node scripts/verify-distribution.mjs --tarball "$DSH_ARTIFACT"' in verify_step["run"] + + readme = README_PATH.read_text(encoding="utf-8") + assert "on the existing published plugin tag or on `main`" in readme + assert "refs/tags/" in readme