Skip to content

v1.0.0 — forge fusion completion

Choose a tag to compare

View all tags
@Accelerator-mzq Accelerator-mzq released this 14 May 05:57
· 384 commits to main since this release
v1.0.0
9987e8f

Summary

  • forge v1.0 fusion completion 落地:OpenSpec UX 哲学全恢复 + superpowers process discipline 反向覆盖修复;10 sub-plan(plan-9a~9j)单议题深做 + plan-9z release polish 9 工作单消化收尾
  • plan-9 系列 + plan-9z 累积 100+ commit chain:涵盖横切层 / out-of-scope / Fluid Pause / verify 三维 / archive 三级 fence / explore skill / process_evidence 14 不变量 / SDD 实施前置纪律 / writing-skills 协议 / marker version deprecation
  • 架构决策全部落地:三级 severity + JCS finding_hash + ack 两步协议(9a)/ 三 skill 区分指引(9b)/ Fluid Pause 三类 pause(9c)/ LLM-judge 集成(9d)/ 三级 fence + handoff_to_backlog(9e)/ forge:exploring + slash 命令(9f)/ worktree 重跑 + reporter parsing(9g)/ forge preflight branch-check + Critical Plan Review + Main Agent STOP Triggers(9h)/ forge:writing-skills 协议(9i)/ forge upgrade --resign-markers + legacy 精确豁免 + version retrograde fence(9j)
  • v1.0.0 candidate:tag v1.0.0 已打在 9987e8f(尚未 npm publish — 等 main merge 后由用户授权 manual trigger)

主要变更

新模块 / 协议(plan-9a~9j 累积)

  • 横切层(9a):src/core/schemas/severity.ts Severity + Finding + JCS finding_hash + forge ack propose/confirm/reject 三子命令
  • archive 三级 fence(9e):src/core/archive/three-level-fence.ts + handoff-to-backlog.ts
  • legacy 精确豁免(9j):src/core/archive/legacy-exemption.ts 13 不变量 + version-retrograde-fence.ts git history 检查
  • process_evidence(9g):src/core/process-evidence/* 14 不变量 + worktree 重跑 + junit reporter parser
  • marker schema(9j):created_by_tool_version? + resigned_by_tool_version? semver 字段
  • preflight schema(9h):ForgeConfig.protected_branches?: string[] + DEFAULT_PROTECTED_BRANCHES

CLI(plan-9a/9d/9h/9j)

  • forge ack 三子命令(propose/confirm/reject)+ ack-log.jsonl
  • forge verify LLM-judge 路径 + verify-findings marker
  • forge preflight branch-check [<change-id>] [--allow-protected-branch]
  • forge upgrade --resign-markers <changeId> option

Skills + Templates(plan-9f/9h/9i + plan-9z polish)

  • .claude/skills/exploring/ + /forge:explore 命令(9f)
  • skills/writing-skills/SKILL.md + forge-eval-integration.md(9i + plan-9z Pattern O/P/Q/R + P-7)
  • skills/subagent-driven-development/SKILL.md §"Main Agent STOP Triggers" 6 行(9h + plan-9z P-1)
  • .claude/skills/subagent-driven-discipline/SKILL.md §2.1.1/§3.3.1/§3.3.2(plan-9z P-5/P-6/P-8)+ §5 Case 09 plan-9z 沉淀 + frontmatter case_study_count 8→9
  • forge-eval/scenarios/subagent-driven-development.yaml merge 3 plan-9h scenario(branch-protection / critical-plan-review / stop-on-repeat-failure;plan-9z P-2 收紧 stop-on-repeat-failure regex 锚行为 Use Task tool with .*sonnet 不锚引用)

Tests + Docs

  • 100+ 新 vitest case 累积(tests/cli/preflight.test.ts / tests/cli/ack.test.ts / tests/cli/upgrade.test.ts 等)
  • tests/integration/apply-md-sync.test.ts 加 apply.md md5 sync guard
  • plan-9z polish P-3 hot-fix:tests/cli/process-evidence-fence.test.ts fence-9.2 minimal record-tdd 加 { timeout: 15000 }(Windows CI 并发 git ops 复现 5000ms timeout 触发 plan-9z §0.3 "Task 6 verify 跑若复现顺手修" 路径)
  • 10 sub-plan 文件(docs/plans/2026-05-1*-plan-9*.md + plan-9z)+ master plan(含 §3.11 DONE + §6 v1.0 修订记录)+ CHANGELOG [1.0.0] 段
  • design v3(docs/specs/2026-05-10-v1.0-fusion-completion-design.md 1892 行)
  • release-gate § v1.0 段(docs/release-gate-checklist.md 7 子段含 polish 9 工作单 verify + known-issue 段标注预存 scenario 延 v1.1)

Changed

  • src/cli/commands/init.ts:38 warning "v0.4" → "v1.2"(plan-9g 7d36c2b 顺手 + plan-9z Task 3 Pattern X 实证)
  • commands/apply.md 加步骤 0(preflight 调用,9h)+ 步骤 3.5(Critical Plan Review 4 维,9h)+ §"Fluid Pause"(9c)+ §"禁止行为(9g)"(9g)+ §"禁止行为(9h)"(9h)
  • src/core/archive/archive.ts 加 3.4 步(9j legacy + retrograde fence)+ 3.5 步(9e 三级 fence)
  • package.json version 0.4.0 → 1.0.0

plan-9z Release Highlights

plan-9z 中间路线 B 模式(Pattern V 沉淀):docs-heavy + 已知路径 + 风险低 sub-plan 跳过 implementer dispatch + 三轮 self-review,inline 实施 + Codex 外部 review 兜底;实际 P50 1.3d / cost ~$2.0,节省 35-47% vs 完整 SDD。

plan-9z 10 commit chain:

  1. f483d77 Task 0 plan-9z sub-plan v1 起草(883 行)
  2. 94ef294 Task 1 release-gate-checklist § v1.0(7 子段)
  3. 7c7c712 Task 2 CHANGELOG [1.0.0] 段(10 sub-plan 概要 37-46)
  4. f4c5f4a Task 4 polish A 组(Pattern O/P/Q/R + P-5/P-6/P-7/P-8)
  5. 8dc7622 Task 5 字面 P-1 + P-2
  6. f4599ed Task 5 baseline 重跑(plan-9z scope 3 scenario pair_pass=true)+ release-gate §5.1 修订
  7. 91fc721 Task 6 version bump 0.4.0 → 1.0.0 + master plan DONE
  8. 9987e8f Task 6 Codex review 7 finding 全采纳(字面错 4 + 不一致 2 + 漏项 1)
  9. f62cb35 Step 6.9 Retrospect Q1-Q6 + Case 09 sub-plan 沉淀
  10. 4a24ef8 plan-9z polish P-3 hot-fix(fence-9.2 timeout 5000→15000;Windows CI 复现触发)

plan-9h Task 4 DONE_WITH_CONCERNS 2 concerns 完整消化:

  • P-1(branch-protection delta 1.0 → 10.0;9.0 跳跃式提升)
  • P-2(stop-on-repeat-failure must_not_match 锚行为不锚引用;delta 5.0 → 6.0 pair_pass=true)
  • plan-9h Task 4 状态从 DONE_WITH_CONCERNS → DONE

baseline 重跑验证(pnpm eval:skill subagent-driven-development,cost $0.474):plan-9z scope 3 scenario 全 pair_pass=true。预存 3 scenario pair_pass=false 是 plan-9h Task 4 baseline 漏抓的 known-issue,延 plan-v1.1 修(release-gate §5.1 known-issue 段标注,不阻塞 v1.0 release)。

Codex 外部 review 兜底(Pattern S REINFORCE):Codex gpt-5.4-codex 找到 8 finding,7 项全采纳(字面错 4 + 不一致 2 + 漏项 1),B2 留 plan-v2 reorganize;8 finding 中 4 项是 plan-9z sub-plan v1 起草时就 stale 的 cross-file 路径错(同源审查盲点;implementer dispatch 也挡不住,Codex 外部 review 才能挡 — 中间路线 B 模式必须配 Codex review)。

plan-v1.1 scope-out 留底

  • P-3 fence-9.2 flaky timeout DONE @ commit 4a24ef8
  • P-9 src/core/git/utils.ts 抽出(YAGNI 2+ 复用点;v1.1 一并 refactor src/core/migrate/index.ts:65-72 inline 探测)
  • 预存 3 forge-eval scenarios refactor:force-dispatch-subagent(delta 0.5)+ review-subagent-output(delta -1.5,RED 7.5 > 5 触发 Pattern R)+ not-merge-without-test(delta 1.0,RED 9.0 > 5)pair_pass=true 修复
  • Pattern X 候选 4 项:plan-9z §1 文件路径前缀错(.claude/ prefix)/ master plan §3.X cross-cutting 状态回写 hook(plan-9g 顺手做 B-7 未回写 §3.11)/ plan-9z §2 6 vs 7 子段 mismatch / release-gate §5.6 plugin 形态字面错(.claude/skills/ 引用但 plugin bundled 不发 .claude/)
  • Pattern V/W 协议化:subagent-driven-discipline SKILL.md §3.X 加 "Trigger Type 7 — Release sub-plan / Polish sub-plan 中间路线 B 模式" 子段(Pattern V)+ §6 catalog 加 "release docs CHANGELOG 累计修订记录整合"(Pattern W)

Test plan

  • 全本地 verify(typecheck / lint / format:check / vitest 141 files / 1018 tests pass / build)
  • 跨 OS CI 全绿(Linux + Windows × Node 20/22)— CI run 25842955896 SUCCESS 2m59s on 4a24ef8
  • pnpm pack 验 tarball 含全部 dist/cli/commands/* + dist/core/templates/* + 16 bundled skills + 9 bundled commands(562 files)
  • forge --help 列出 plan-9 系列引入的子命令(preflight branch-check / ack / verify / upgrade --resign-markers)
  • forge-eval baseline plan-9z scope 3 scenario pair_pass=true(branch-protection delta=10.0 / critical-plan-review delta=6.0 / stop-on-repeat-failure delta=6.0)
  • Codex 外部 review 8 finding 7 项采纳
  • release-gate § v1.0 §5.1-§5.7 全勾(maintainer 发版前手动 verify;sub-plan 9z Step 6.6 dry-run 已验)
  • pnpm publish --publish-branch dev 或切 master/main 分支后 pnpm publish(用户授权 manual trigger;本 PR merge 后)

Acknowledgments

设计经 codex 累计 5+ 轮 adversarial review + Opus subagent 自检 multi-round + plan-9z 收尾 inline 实施(中间路线 B)+ Codex review 7 finding 全采纳,共修 200+ 条问题。完整修订链:

  • master plan v1 → v1.0(docs/plans/2026-05-10-plan-9-v1.0-fusion-completion-master.md §6 修订记录)
  • design v3 commit b823f6e(docs/specs/2026-05-10-v1.0-fusion-completion-design.md 1892 行)
  • 各 sub-plan 文件含独立 vN → vN+1 修订段(plan-9a v1→v4 / plan-9j v1→v9 等;详 CHANGELOG ### Fixed — codex 累计 5+ 轮 review 修订 段)
  • plan-9z release(docs/plans/2026-05-14-plan-9z-release.md)消化 plan-9f / plan-9h 累积 retrospect 9 工作单 + Case 09 沉淀(Pattern V/W + REINFORCE Pattern S/T/Q new edge)

完整 spec:docs/specs/2026-05-10-v1.0-fusion-completion-design.md
完整 plan 链:docs/plans/2026-05-10-plan-9-v1.0-fusion-completion-master.md + plan-9a..9j + plan-9z

Assets 2
Loading