Repository navigation
v3.1.1 — 修发布包资产 / fence 段名 / FORGE_VERSION 漂移
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.tsoption=1(扩 scope)的target_anchor字段校验与 diff 段定位正则从What Changes改为What,与forge validate要求的## Whatproposal 段名一致(此前 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。