Repository navigation
v1.2.0 — stage-extensions framework
plan-stage-extensions-framework:forge core 通用 stage-level extension runner —— 预置 codex review/adversarial 作 default entries(Tier 1 Claude Code only;generic ExtensionContract 留 v2/v3 refactor)。plan 经 9 轮 Codex 对抗性 review 收敛(累计 21 finding:3 BLOCKER + 16 MAJOR + 2 MINOR 全独立核实为真问题、全 accept);实施(Task 5-9)经 superpowers:subagent-driven-development SDD —— 每 Task fresh implementer subagent → spec compliance reviewer → code quality reviewer 三阶段。
Added
- Stage Extensions Framework:
stage_extensionsconfig 段 —— forge core 通用 stage-level extension runner(v7 CLI/AI 职责分层:CLI 纯机械单轮执行,多轮收敛 / 交互 / 派 subagent 归 AI 主代理协议)。 - CLI:
forge stage-extensions子命令组 ——run(单轮执行器:spawn codex + watch + parse + judge + retry,显式 RoundOutcome 状态机,结构化 JSON 输出)+analyze-trend(收敛趋势分析)。runner 永远 exit 0(loose,不阻塞主流程 fence)。 - Core:
src/core/stage-extensions/6 模块(severity-mapper / convergence-judge / thread-map / trend-analyzer / output-watcher / state-machine)+src/core/schema/config schema + validator +src/core/codex-review/prompts/adversarial-default.md通用模板(B-full Task 0 已 ship)。 - Commands:
commands/*.md5 处末尾段(brainstorm / propose / apply / review / verify)—— AI 主代理多轮收敛协议(反复调单轮 runner + AskUserQuestion 介入 + Task dispatch fix subagent);新 slash 命令commands/codex-adversarial.md(B-full Task 0 已 ship)。 - Helper:
scripts/codex-review-helper.mjs扩展 ——--thread-idresume / mode 多分支(code-review / adversarial / rescue);harness-agnostic。 - Docs:
docs/stage-extensions.md(framework 协议)+docs/codex-review.md(codex 预置 extension 用户指南)+docs/getting-started.md嵌入 deep-dive +README.md更新。 - Tests:全 suite 1115 tests pass / 0 fail(Task 0-4 基线 1069 + Task 5 runner +21 integration + Task 6 commands sync +25 integration)。
Notes
- forge 协议层 SKILL.md 0 改动:stage-extensions framework 不触碰 forge 协议层 skills(
skills/*/SKILL.md)—— 多轮收敛 / askUser / fix dispatch 落在 commands 末尾段(v7 CLI/AI 职责分层),协议层纯净。 - loose 语义:codex 集成任何失败(spawn 失败 / retry 耗尽 / config 非法 / markdown 解析失败)都不阻塞 forge 主流程 fence;runner 永远 exit 0。
Codex Review 收敛
plan 经 9 轮 Codex 对抗性 review 收敛,首轮(v2)7 个 finding 全 accept 修订:
- F1(BLOCKER):runner 变量作用域 + 控制流隐患 → §7 重写为显式 RoundOutcome 状态机。
- F2(MAJOR):多轮 continue 消耗 retry 配额 → 拆 attempt 与 round budget 两个独立计数器(v7 后 round budget 移 §8 AI 协议)。
- F3(MAJOR):background 异步模式决策与实施矛盾 → v1 锁定 sync,
--background留 v2。 - F4(MAJOR):generic 抽象泄漏 → v1 收窄 codex-specific scope,generic ExtensionContract 留 v2/v3。
- F5(MAJOR):
verdict=approve短路掩盖 BLOCKER → judgeConvergence 短路条件改为 approve 且 block 桶空。 - F6(MAJOR):测试 inventory 跨段不一致 → §2 单一来源表。
- F7(MINOR):DoD 不可机器验证 → §14 验收 checklist 全改真 shell 断言。
后续 v3-v9 再 7 轮收敛(F1-v2 BLOCKER normalized config 深合并 / F3-v2 timeout 状态分支 / F2-v3 thread_id 缺失保留旧值 / F1-v8 roundLimit 数据源修正 等),累计 21 finding 全独立核实为真问题(0 误报)。
Full Changelog: v1.1.0...v1.2.0