Skip to content

v4.0.0 — OpenSpec alignment (BREAKING)

Choose a tag to compare

View all tags
@Accelerator-mzq Accelerator-mzq released this 21 May 04:05
· 16 commits to main since this release
v4.0.0
c71b45d
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

forge v4.0.0 是设计哲学整体转向 —— 从反向加固协议变为 OpenSpec 简洁对齐。

完整迁移指南:docs/migration/v3-to-v4.md
完整 CHANGELOG:CHANGELOG.md [4.0.0]

BREAKING(关键)

  • 反加固协议整删:13 fence、三级 severity、ack 两步、process-evidence freeze、ack-log 完整性链、transaction 五阶段 atomic、resign-markers(净删 ~13000 行)
  • CLI 子命令整删:forge ack / forge evidence / forge pause-capture / /forge:ack-confirm slash
  • marker schema v1 → v2:VerifyMarker / ReviewMarker / archive_summary 全部 v2 极简
  • forge archive flag 改造:新增 --yes / --skip-specs(沿 OpenSpec);删 --recover / --resume-summary / --resume
  • forge upgrade 删 --resign-markers flag
  • forge monitor:archive 事件名 fence_observed → archive_summary_observed;MonitorStage 删 'ack-confirm'

v3.x → v4.0 升级 checklist

# 1) 对每个 active change 清 v3 反加固残留
rm -rf forge/changes/<id>/.evidence/pending-acks/
rm -f forge/.cache/archive-pause-<id>.json
rm -f forge/changes/<id>/.evidence/process-evidence.staging.yaml

# 2) 升级 forge
pnpm update -g @accelerator-mzq/forge   # 或 plugin marketplace 升级

# 3) 重跑 verify/review 写 v2 marker
/forge:verify --change-id <id>
/forge:review --change-id <id>
/forge:archive --change-id <id>

详见 docs/migration/v3-to-v4.md §3。

Verification

  • pnpm test:1074 pass / 0 fail / 1 skipped(测试从 192 简至 152 文件)
  • pnpm release:gate:7 步全绿(typecheck/lint/format/build/vitest/pack/dry-install + tarball-size + tarball-content + brownfield)
  • forge --version 输出含 4.0.0
  • bundled tgz 0.68 MB

Plan

完整设计 plan + 11 轮 Codex 对抗 review:docs/plans/2026-05-20-plan-v4-openspec-alignment.md

Assets

  • forge-bundled-v4.0.0.tgz — 离线分发 plugin 包(无需 npm 即可在 Claude Code 安装:/plugin install --from-tarball <path>)

🤖 Generated with Claude Code

Assets 3
Loading