You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
bug: plugins built from a source checkout report version 0.1.0 instead of the release tag #511
Posted by Dong-bot, an automated agent acting on behalf of @Dong1017 (always-on-bot, model claude-opus-5-5).
Claimed for the PR pool. A coding agent (claude-opus-5-5, effort xhigh) will open a PR, or explain here why it cannot. The PR is merged only after 2 independent approvals.
Posted by an agent on behalf of @Dong1017, the issue owner.
Decision: option 2, an explicit non-release marker (owner decision, 2026-11-19). This records the version contract the body asked for and authorizes a fix PR. It replaces the body's "Decision needed", "Next action" and "Not yet granted" lines. #512 does not cover this issue: it adds listing fields and leaves "version": "0.1.0" unchanged.
Contract
Source builds (no --release-version): every plugin's own version is 0.0.0+source. This covers plugins/inferrsi/plugin.json, plugins/workswarm/inferrsi/manifest.json and plugins/inferrsi-dsh/package.json. It also covers plugin_version in each runtime/manifest.json and in --plugin-info. 0.0.0+source is valid SemVer 2.0 (build metadata), and the +source part marks the package as not a release.
runtime_version keeps reporting the runtime that was actually bundled: 0+unknown without a generated _version.py, or the generated version. So in a source build the two fields differ on purpose, and that difference is documented.
Release builds stay exactly as they are. --release-version still accepts only MAJOR.MINOR.PATCH, must match the built runtime, and is rejected before any output is written. .github/workflows/release.yml and tools/check_release.py keep their current release checks.
DSH gets no release mode. release.yml publishes only the Codex and WorkSwarm ZIPs, so DSH stays source-only and simply carries the marker.
Not in scope: making a clean tag checkout resolve to its tag version, raised by @zengchuang-hw above. That is a separate build-precondition question and can get its own issue. Version labels stay separate from content identity; content_sha256 is unchanged.
Acceptance
The template versions become 0.0.0+source, with no other metadata changes.
Regression tests cover Codex, WorkSwarm and DSH. For each, they check the top-level metadata, runtime/manifest.json and --plugin-info in these cases:
a source build without _version.py;
a source build with a generated _version.py and no --release-version;
for Codex and WorkSwarm, an explicit --release-version that matches (release values unchanged) and one that does not (rejected).
The existing protections in tests/test_codex_plugin.py stay: release mismatch, and the unknown fallback that does not import an installed runtime.
docs/codex-plugin.md (and docs/releases.md if it describes source builds) states that a source-built plugin reports 0.0.0+source and is not a release.
The PR lists any host whose published schema is known to reject SemVer build metadata. If one does, stop and report it here instead of choosing another value.
Source builds of the Codex, WorkSwarm and DSH plugins now report 0.0.0+source as the plugin version, per the owner's option-2 decision. The three template version lines changed. plugin_version in runtime/manifest.json and --plugin-info follows, and runtime_version still reports the bundled runtime. No builder code changed, and --release-version behavior is untouched. Docs (codex, workswarm, dsh, releases) and CHANGELOG.md describe the marker.
Tests: new tests/test_plugin_source_version.py passed 15/15 (all three hosts, with and without _version.py; Codex and WorkSwarm release match and mismatch). Restoring the old template values made 9 of them fail. With test_workswarm_plugin.py, test_dsh_plugin.py and test_resource_migration.py that is 40 passed, and ruff check src tests tools is clean.
Not verified: 8 failures in test_codex_plugin.py and 24 errors in test_release.py come from this sandbox lacking git (and PyYAML visible under python -I). I did not run them on a baseline, so they need a re-run where git exists. No release ZIP was built or checked with check_release.py.
Host schemas: the portable Codex schema only requires version to be a string, and npm's semver parses the value. I found no published WorkSwarm schema and ran no native-host import, so none is known to reject it but none was checked.
Left: native-host import/display check, and the out-of-scope question of resolving a clean tag checkout to its tag version.
Activity
Dong1017 commentedon Nov 19, 2026
Posted by Dong-bot, an automated agent acting on behalf of @Dong1017 (always-on-bot, model claude-sonnet-5-5).
评估: 这是个真实但低严重度的缺陷,属于版本口径不一致,不影响发布包。issue 已有 v0.2.5 Release ZIP 的对照,说明发布流程是对的。我倾向选期望行为 1(跟随运行时版本),并加下面几条约束。我没有运行任何构建,以下判断基于 issue 正文里的复现和静态阅读。
为什么倾向方案 1
0.1.0换成占位符。plugin_version和runtime_version仍是两个独立来源,issue 里第二条影响(已构建运行时但不传--release-version时两者不一致)还会存在。0.1.0。落地前需要澄清的点
_version.py由 SCM 生成,通常是 PEP 440,例如0.2.6.dev3+gabcdef。plugin.json、WorkSwarmmanifest.json和 DSH 的package.json大概率要求 semver。package.json对格式要求最严,裸的0+unknown不是合法 semver。需要确认三类消费方各自接受什么格式。如果要统一,可以用0.0.0+unknown,并规定 PEP 440 到 semver 的转换规则。tools/build_dsh_plugin.py补上与 Codex 构建一致的--release-version和回退逻辑,不要只改 Codex。否则 DSH 源码构建永远是0.0.0,口径仍然分裂。0.1.0。 即使选方案 1,模板里的硬编码值也应改成明确的占位符(如0.0.0+unknown),避免有人绕过构建脚本直接读模板时再次误认。这等于吸收了方案 2 的一部分,且不冲突。release.yml已传--release-version。可以加一步断言:发布包的plugin_version、runtime_version与 tag 相同。这样以后改动构建逻辑不会悄悄破坏发布包。_version.py时,两个字段都为0+unknown(或统一后的占位符)。--release-version时,行为与现在相同。docs/codex-plugin.md的0+unknown那一段,说明插件版本也遵循同一规则;docs/releases.md视情况同步。建议的下一步
tools/plugin_bundle.py、tools/build_dsh_plugin.py、三个模板版本字段、文档和上述测试。Dong-bot(authorized delegate):以上是首轮建议,不构成已记录的维护者决定。要把口径定下来,请在本 issue 里 @Dong1017 明确选择。
zengchuang-hw commentedon Nov 19, 2026
独立静态核对基线
9b418d7fe16f3979b67f74f290949629ef103e8f后,建议把这里拆成两个明确的版本契约问题,而不是直接把模板值替换掉。选项 1 本身不会让“干净 tag checkout 直接打插件包”得到 tag 版本。
tools/plugin_bundle.py当前只读源码_version.py,不存在时从__init__.py取0+unknown;生成该文件的是pyproject.toml的 setuptools-scm 构建配置。因而“plugin_version 跟随 runtime_version”可以消除模板/runtime 分歧,但没有生成版本文件的 v0.2.5 checkout 仍会得到 unknown。若验收目标确实是源码 tag 自动得到 0.2.5,需要另行明确构建前置步骤或源码版本解析策略;不要把两种目标混成同一个修复。我倾向于保留显式 release 模式,源码模式明确标识为非 release。 现有
--release-version仅接受三段数字且必须匹配 built runtime,失配在写输出前拒绝,这个保护应保留。源码默认值是否从 runtime 派生由维护者决定,但应先确认各宿主接受的版本格式,尤其不能未经格式验证就把 Python 开发版字符串或0+unknown原样写入所有宿主 metadata。DSH 目前确实没有 release-version 参数,应在同一决策中说明它是否支持 release 模式,而不只是改 package.json 的常量。建议补的回归矩阵很小且有针对性: 无
_version.py的源码包、有生成版本但未传 release-version、显式 release-version 匹配/失配,分别检查 Codex、WorkSwarm、DSH 的顶层 metadata、runtime manifest 和--plugin-info。现有tests/test_codex_plugin.py:429–443已覆盖 release 失配与不导入外部已安装 runtime 的 unknown fallback;保留这些保护。现有 DSH 测试检查输出彼此一致,却未约束“预期源码版本是什么”,所以模板常量也能通过。版本标签与内容身份应继续分开:manifest 已保留 content_sha256,不应把同一个 version 当作不同源码包字节相同的证明。
以上是实际实现与测试定义的静态检查,不是构建复现;未检查 CI、未执行仓库代码、未核验 Release 二进制,也未接受范围或实施修复。
Dong1017 commentedon Nov 19, 2026
@Dong1017 claim
Dong1017 commentedon Nov 19, 2026
Posted by Dong-bot, an automated agent acting on behalf of @Dong1017 (always-on-bot, model claude-opus-5-5).
Claimed for the PR pool. A coding agent (claude-opus-5-5, effort xhigh) will open a PR, or explain here why it cannot. The PR is merged only after 2 independent approvals.
Dong1017 commentedon Nov 19, 2026
Posted by Dong-bot, an automated agent acting on behalf of @Dong1017 (always-on-bot, model claude-opus-5-5).
The PR pool run stopped: fatal: 无法访问 'https://github.com/InferMatrixLab/InferRSI.git/':Failed to connect to github.com port 443 after 133369 ms: 连接超时
Dong1017 commentedon Nov 19, 2026
Posted by an agent on behalf of @Dong1017, the issue owner.
Decision: option 2, an explicit non-release marker (owner decision, 2026-11-19). This records the version contract the body asked for and authorizes a fix PR. It replaces the body's "Decision needed", "Next action" and "Not yet granted" lines. #512 does not cover this issue: it adds listing fields and leaves
"version": "0.1.0"unchanged.Contract
--release-version): every plugin's own version is0.0.0+source. This coversplugins/inferrsi/plugin.json,plugins/workswarm/inferrsi/manifest.jsonandplugins/inferrsi-dsh/package.json. It also coversplugin_versionin eachruntime/manifest.jsonand in--plugin-info.0.0.0+sourceis valid SemVer 2.0 (build metadata), and the+sourcepart marks the package as not a release.runtime_versionkeeps reporting the runtime that was actually bundled:0+unknownwithout a generated_version.py, or the generated version. So in a source build the two fields differ on purpose, and that difference is documented.--release-versionstill accepts onlyMAJOR.MINOR.PATCH, must match the built runtime, and is rejected before any output is written..github/workflows/release.ymlandtools/check_release.pykeep their current release checks.release.ymlpublishes only the Codex and WorkSwarm ZIPs, so DSH stays source-only and simply carries the marker.content_sha256is unchanged.Acceptance
0.0.0+source, with no other metadata changes.runtime/manifest.jsonand--plugin-infoin these cases:_version.py;_version.pyand no--release-version;--release-versionthat matches (release values unchanged) and one that does not (rejected).tests/test_codex_plugin.pystay: release mismatch, and the unknown fallback that does not import an installed runtime.docs/codex-plugin.md(anddocs/releases.mdif it describes source builds) states that a source-built plugin reports0.0.0+sourceand is not a release.zengchuang-hw commentedon Nov 19, 2026
PASS
版本契约增量复核,不等于实现验收。对照
tools/plugin_bundle.py和tools/build_dsh_plugin.py,插件版本和实际 runtime 版本本来就在各打包入口分别传递,源码标记可复用插件字段,不需要改变 release 的严格版本匹配或运行时回退。0.0.0+source符合 SemVer;Codex 当前打包文档引用的 portable schema 在结构上只要求 version 是字符串,这不是 native-host 导入或显示已验证。除已有三处值的回归,建议在有宿主可用时确认实际导入/显示仍有可辨别的 source 标记。同一标记会复用于不同源码包,不要用它替代
content_sha256或来源提交进行归档比对。未构建插件、导入宿主或查询 CI。Dong1017 commentedon Nov 19, 2026
Posted by Dong-bot, an automated agent acting on behalf of @Dong1017 (always-on-bot, model claude-opus-5-5).
The PR pool run stopped: the agent timed out after 60 min
Dong1017 commentedon Nov 19, 2026
Posted by Dong-bot, an automated agent acting on behalf of @Dong1017 (always-on-bot, model claude-opus-5-5).
Opened #525 for this issue.
Source builds of the Codex, WorkSwarm and DSH plugins now report
0.0.0+sourceas the plugin version, per the owner's option-2 decision. The three template version lines changed.plugin_versioninruntime/manifest.jsonand--plugin-infofollows, andruntime_versionstill reports the bundled runtime. No builder code changed, and--release-versionbehavior is untouched. Docs (codex,workswarm,dsh,releases) andCHANGELOG.mddescribe the marker.Tests: new
tests/test_plugin_source_version.pypassed 15/15 (all three hosts, with and without_version.py; Codex and WorkSwarm release match and mismatch). Restoring the old template values made 9 of them fail. Withtest_workswarm_plugin.py,test_dsh_plugin.pyandtest_resource_migration.pythat is 40 passed, andruff check src tests toolsis clean.Not verified: 8 failures in
test_codex_plugin.pyand 24 errors intest_release.pycome from this sandbox lackinggit(and PyYAML visible underpython -I). I did not run them on a baseline, so they need a re-run wheregitexists. No release ZIP was built or checked withcheck_release.py.Host schemas: the portable Codex schema only requires
versionto be a string, and npm'ssemverparses the value. I found no published WorkSwarm schema and ran no native-host import, so none is known to reject it but none was checked.Left: native-host import/display check, and the out-of-scope question of resolving a clean tag checkout to its tag version.
Merge main into bot/issue-511; keep both CHANGELOG entries
Dong1017 commentedon Nov 20, 2026
Posted by Dong-bot, an automated agent acting on behalf of @Dong1017 (always-on-bot, model claude-opus-5-5).
The PR pool run stopped: the change has 42507 changed lines, over the limit of 3000
Dong1017 commentedon Nov 20, 2026
#511 验收完成
按 Issue owner 确认的方案 2 完成验收。#525 已合入
main的0697f08e。0.0.0+source。Codex 和 WorkSwarm 正式构建继续使用显式的发版版本,DSH 维持源码构建。逐项验收记录
version,新值为0.0.0+source。_version.py两种情况均覆盖。三个插件的顶层元数据、runtime/manifest.json和--plugin-info都报告源码版本标记。实际运行时版本分别为0+unknown或生成的版本。MAJOR.MINOR.PATCH的版本时,两个构建器均在写出前拒绝。发版工作流与发版校验脚本和父提交一致。package.json版本已用 npm 使用的 SemVer 解析器 验证,保留了source构建标识。验收完成,关闭为 Completed。由 Codex 代发。