Skip to content

v3.1.1 — 修发布包资产 / fence 段名 / FORGE_VERSION 漂移

Choose a tag to compare

@Accelerator-mzq Accelerator-mzq released this 20 May 08:32
· 38 commits to main since this release

Fixed

  • npm 发布包补全 stage-extensions 运行时资产:package.json#files 此前仅含 dist/,导致 scripts/codex-review-helper.mjs 与 src/core/codex-review/prompts/adversarial-default.md 未进发布包,3.0.0 / 3.1.0 所有 npm 用户在 stage-extensions 5 个 stage 调 codex review / adversarial 都会因 helper 路径不存在或 prompt 模板缺失而失败。本版补齐两个资产到 files 字段;并在 release-gate 的 tarball 内容检查改用 npm pack --dry-run(跨平台),新增 helper + 模板必含断言,堵住「Windows 跳过」缺口。
  • bundled plugin tgz 同步补齐 codex 资产:scripts/build-bundled-plugin.mjs 现额外拷 scripts/codex-review-helper.mjs 与 src/core/codex-review/ 到 staging,bundled 离线分发形态也能跑 stage-extensions。
  • pause_decisions fence 与 proposal 段名对齐:src/core/archive/pause-decisions-fence.ts option=1(扩 scope)的 target_anchor 字段校验与 diff 段定位正则从 What Changes 改为 What,与 forge validate 要求的 ## What proposal 段名一致(此前 fence 死代码,marker 注释 / 模板 / fixture 仍用 OpenSpec 旧名 ## What Changes,option=1 扩 scope 路径在 forge 3.x 下无法通过 archive)。同步收尾 `commands/apply.md`、`skills/exploring/SKILL.md`、`docs/getting-started.md`、`src/core/markers/types.ts` 注释及 13 个 pause-decisions 测试 / fixture。
  • `FORGE_VERSION` 漂移污染产物(release-gate 拦下):`src/index.ts:3` 此前硬编码 `FORGE_VERSION = '1.3.0'`,自 2026-05-16 漂移 —— 不仅 `forge --version` 显示错,更关键是被写进 archive marker / legacy-bridge handoff manifest 的 `forgeVersion` 字段(`legacy-bridge.ts:954`、`archive.ts:1006/1051`),v3.0.0 / v3.1.0 所有用户 archive 产物 / handoff manifest 写的 `forgeVersion: '1.3.0'` —— 数据完整性问题。本版改为动态读包根 `package.json#version`,根治漂移,版本号同步唯一源是 `package.json`。
  • docs:`docs/codex-review.md` Quick Start 的 `codex-adversarial` 示例补 `build_prompt` + `command --prompt-file`(此前示例缺 `build_prompt`,helper `run --mode adversarial` 强制要求 `--prompt-file`,照抄示例直接报错)。
  • docs:`docs/getting-started.md` 第 2 步加「4 件套格式速查」,展示 forge 3.x 的 `## What` proposal 段名、`## Scenario:` H2 spec scenario、`- [ ] :` tasks 行三种正确格式。

完整 changelog 见 CHANGELOG.md。