soloforge 1.1.38 → 1.1.42

package/CHANGELOG.md

@@ -1,12 +1,12 @@
-# Changelog
+# 变更日志
 
-All notable changes to SoloForge will be documented in this file.
+本文件记录 SoloForge 的所有重要变更。
 
-The format is based on [Keep a Changelog](https://keepachangelog.com/), and this project adheres to [Semantic Versioning](https://semver.org/).
+格式基于 [Keep a Changelog](https://keepachangelog.com/)，版本遵循[语义化版本](https://semver.org/)。
 
-## [Unreleased]
+## [未发布]
 
-### Added
+### 新增
 - **产物契约三分离架构**：Schema + ProcessRules + Validator 三分离框架，覆盖全部 19 种 ArtifactKind
   - `artifact_schema_registry.ts`：集中注册 19 种产物类型的结构定义（必填章节、表格、字段）
   - `artifact_process_rules.ts`：按 extract/review/fix/iterate 四操作类型区分的过程规则
@@ -16,25 +16,25 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
   - TemplateData→prompt 完整传递链：artifact_schema/process_rules 字段贯穿 11 个 Handlebars 模板
   - consumable_asset_registry 新增 artifact_schema_ref 字段，关联模板资产与 Schema
   - 能力登记：CAP-026~CAP-029 四项新能力注册
-- Monolith split: engine/ sub-directory reorganization into 9 functional modules (207 files)
-- MCP Server extracted from adapters/ to dedicated server/ directory
-- E2E test suite and CI/CD pipeline
-- Plan archive files moved to ~/.claude/plans/
-- `sideEffects: false` in package.json for tree-shaking
-- `lint:full` script: 全项目（含 tests/）零警告 ESLint 检查
-- `noFallthroughCasesInSwitch` tsconfig 严格模式
-- `noUnusedLocals` + `noUnusedParameters` tsconfig 严格模式
+- 单体拆分：engine/ 子目录重组为 9 个功能模块（207 个文件）
+- MCP Server 从 adapters/ 提取为独立 server/ 目录
+- E2E 测试套件与 CI/CD 流水线
+- 计划归档文件迁移至 ~/.claude/plans/
+- package.json 添加 `sideEffects: false` 以支持 tree-shaking
+- `lint:full` 脚本：全项目（含 tests/）零警告 ESLint 检查
+- tsconfig 启用 `noFallthroughCasesInSwitch` 严格模式
+- tsconfig 启用 `noUnusedLocals` + `noUnusedParameters` 严格模式
 - `safeJsonParse` / `safeJsonStringify` 安全 JSON 工具函数
 - CLI 子命令注册：`validate-knowledge`、`validate-foundation`
 
-### Fixed
-- Pipeline state machine fixes and multi-domain chain completion (11 high-severity vulnerability fixes)
-- Plan 003 missing paths and plan 001 intent tests expanded to 53 cases
+### 修复
+- 管线状态机修复与多领域链路闭环（11 项高严重性安全漏洞修复）
+- 计划 003 路径缺失与计划 001 意图测试扩展至 53 个用例
 - prepublishOnly 缺少 build 步骤
 - hooks.ts JSON 解析失败会清空用户 settings.json 的问题
 - ESM 项目中 require() 导致的运行时崩溃
 - 知识索引 build/watch 并发竞态条件
-- Trae 配置默认值 bug
+- Trae 配置默认值缺陷
 - 空数组 [0] 越界保护（6 处）
 - 不安全 JSON.parse 缺少运行时验证（66 处 → 全部替换为 safeJsonParse）
 - 非空断言消除（31 处 → 0，14 个文件）
@@ -47,12 +47,12 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 - 657 项测试 ESLint 问题清零（no-explicit-any, no-unused-vars 等）
 - project_stage_detector 旧/新数据格式兼容性修复
 
-### Changed
-- Link audit optimization: 14 modules re-registered, adapter enhancements, trae host_type fix
-- Comprehensive optimization: architecture violation fixes, type safety, types split, async fs, test performance
-- Test overhaul: fragment consolidation, failure fixes, boundary coverage enhancement, release gate zeroing
-- Cleaned up batch legacy files, deprecated modules, and configuration updates
-- Removed gitignored docs files from git tracking
+### 变更
+- 链接审计优化：14 个模块重新注册，适配器增强，trae host_type 修复
+- 综合优化：架构违规修复，类型安全，类型拆分，异步 fs，测试性能
+- 测试重构：碎片整合，失败修复，边界覆盖增强，发布门槛清零
+- 批量遗留文件清理，废弃模块移除，配置更新
+- 从 git 追踪中移除 gitignore 的文档文件
 - 11 个 as any 类型绕过 → 具体类型或 unknown 断言
 - 11 个循环依赖修复（类型提取 + 模块拆分 + import 重定向）
 - 删除废弃模块：policy_drift_detector, audit_verifier, extension_scenario deprecated 函数
@@ -61,219 +61,219 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 
 ## [1.4.16] - 2026-05-28
 
-### Added
-- `confirm` and `authorized` fields to Learn/Deliver tool schemas
+### 新增
+- Learn/Deliver 工具 schema 新增 `confirm` 和 `authorized` 字段
 
 ## [1.4.15] - 2026-05-28
 
-### Added
-- Plan proposal gate lightweight path with `local_acceptance` type auto-pass
+### 新增
+- 计划提案门禁轻量路径：`local_acceptance` 类型自动通过
 
 ## [1.4.14] - 2026-05-28
 
-### Changed
-- Unified persistence refactor: single-load shared context to eliminate write overwrite; `setExpansion`/`setArtifact`/`setPlanProposalGate` support `existingCtx` passthrough
+### 变更
+- 统一持久化重构：单次加载共享上下文消除写入覆盖；`setExpansion`/`setArtifact`/`setPlanProposalGate` 支持 `existingCtx` 透传
 
 ## [1.4.13] - 2026-05-28
 
-### Fixed
-- Lightweight path S4 gate skip; plan proposal gate write timing fix; `updateStatus` duplicate load prevention
+### 修复
+- 轻量路径 S4 门禁跳过；计划提案门禁写入时机修复；`updateStatus` 重复加载防护
 
 ## [1.4.12] - 2026-05-28
 
-### Added
-- Contract JSON parse error enhancement, brainstorming session passthrough, plan gate auto-setup, lightweight path auto-pass
+### 新增
+- 契约 JSON 解析错误增强，头脑风暴会话透传，计划门禁自动设置，轻量路径自动通过
 
 ## [1.4.11] - 2026-05-28
 
-### Added
-- Gate `expected_schema` passthrough, source code matcher, expansion pipeline stage split, E2E test coverage
+### 新增
+- 门禁 `expected_schema` 透传，源码匹配器，扩展管线阶段拆分，E2E 测试覆盖
 
 ## [1.4.10] - 2026-05-28
 
-### Added
-- Acceptance routing for intent router, contract parse loop refactor, expansion pipeline strategy, validation self-correction assistant
+### 新增
+- 意图路由验收路由，契约解析循环重构，扩展管线策略，验证自纠辅助
 
 ## [1.4.9] - 2026-05-28
 
-### Fixed
-- MCP index JSON decoding, schema type fixes, release gate adaptation, unit test coverage
+### 修复
+- MCP 索引 JSON 解码，schema 类型修复，发布门槛适配，单元测试覆盖
 
 ## [1.4.8] - 2026-05-28
 
-### Changed
-- Scope parser refactor, workspace lease enhancement, impact analyzer streamlining, tool call chain extension
+### 变更
+- 作用域解析器重构，工作空间租约增强，影响分析器精简，工具调用链扩展
 
 ## [1.4.7] - 2026-05-28
 
-### Added
-- Extension platform contract enhancement, release gate supplement, tool call chain test coverage, CLAUDE.md hard rules annotation
+### 新增
+- 扩展平台契约增强，发布门槛补充，工具调用链测试覆盖，CLAUDE.md 硬规则标注
 
 ## [1.4.6] - 2026-05-28
 
-### Changed
-- `next_action_planner` refactor, project knowledge contract strengthening, conflict detector fix, workflow navigation test coverage
+### 变更
+- `next_action_planner` 重构，项目知识契约强化，冲突检测器修复，工作流导航测试覆盖
 
 ## [1.4.5] - 2026-05-28
 
-### Added
-- Knowledge consumption boundary governance, design lifecycle contract, conflict detector enhancement, release gate hardening
+### 新增
+- 知识消费边界治理，设计生命周期契约，冲突检测器增强，发布门槛加固
 
 ## [1.4.4] - 2026-05-28
 
-### Added
-- `next_action` enhancement, asset registry extension, traceability supplement, workflow navigation upgrade
+### 新增
+- `next_action` 增强，资产注册扩展，可追溯性补充，工作流导航升级
 
 ## [1.4.3] - 2026-05-28
 
-### Added
-- Traceability enhancement, decision workshop extension, release gate hardening, tool call chain coverage
+### 新增
+- 可追溯性增强，决策研讨扩展，发布门槛加固，工具调用链覆盖
 
 ## [1.4.0] - 2026-05-27
 
-### Added
-- Control plane contract, release gate enhancement, tool invocation contract strengthening
+### 新增
+- 控制面契约，发布门槛增强，工具调用契约强化
 
 ## [1.3.10] - 2026-05-27
 
-### Added
-- Config auto-repair, release readiness gate enhancement, documentation updates
+### 新增
+- 配置自动修复，发布就绪门禁增强，文档更新
 
 ## [1.3.8] - 2026-05-27
 
-### Added
-- Confirmation tiering mechanism, next navigation enhancement, empty project onboarding
+### 新增
+- 确认分级机制，下一步导航增强，空项目引导
 
 ## [1.3.5] - 2026-05-27
 
-### Fixed
-- Step 2-3 acceptance credibility fix, system capability loop activation
+### 修复
+- 步骤 2-3 验收可信度修复，系统能力循环激活
 
 ## [1.3.4] - 2026-05-26
 
-### Added
-- Centralized diagnostic codes, mechanism self-governance, knowledge governance, config boundaries, log governance, health check
-- Code maintainability and observability contract
+### 新增
+- 集中化诊断码，机制自治，知识治理，配置边界，日志治理，健康检查
+- 代码可维护性与可观测性契约
 
 ## [1.3.3] - 2026-05-26
 
-### Added
-- Workflow navigation, backend implementation contract, OOD/SOLID design rules
+### 新增
+- 工作流导航，后端实现契约，OOD/SOLID 设计规则
 
 ## [1.3.2] - 2026-05-26
 
-### Added
-- Standard asset contract, decision workshop, template visibility governance
+### 新增
+- 标准资产契约，决策研讨，模板可见性治理
 
 ## [1.3.1] - 2026-05-26
 
-### Fixed
-- Release fix, dependency vulnerability scanning
+### 修复
+- 发布修复，依赖漏洞扫描
 
 ## [1.3.0] - 2026-05-24
 
-### Added
-- Construction instruction contract, log governance, evidence-driven anti-hallucination mechanism
-- Log governance (problem 59), release operations manual, repository hygiene archival
-- Release package freeze revalidation: stale dist cleanup, RC acceptance pass
-- Release Candidate Steps 2-7: post-batch cleanup, knowledge asset standardization, corpus regression, init/sync acceptance, E2E smoke test, migration dry-run
-- Batch 5 real main-path loop closure and documentation convergence
-- Batch 4 contract governance: workflow template package, decision sovereignty, local acceptance, evolution regression
-- Batch 3 CLI real-data loop: user modification protection, migrate safe state fix
-- Batch 2 Verification/Delivery Contract full-chain loop closure
-- Chinese localization of all English comments and logs with `check:comments` regression guard
+### 新增
+- 构建指令契约，日志治理，证据驱动反幻觉机制
+- 日志治理（问题 59），发布操作手册，仓库整洁归档
+- 发布包冻结复验：陈旧 dist 清理，RC 验收通过
+- 发布候选步骤 2-7：批处理后清理，知识资产标准化，语料回归，init/sync 验收，E2E 冒烟测试，迁移演练
+- 批次 5 真实主路径闭环与文档收敛
+- 批次 4 契约治理：工作流模板包，决策主权，本地验收，演进回归
+- 批次 3 CLI 真实数据闭环：用户修改保护，迁移安全状态修复
+- 批次 2 验证/交付契约全链路闭环
+- 全部英文注释和日志中文化，`check:comments` 防回归
 
-### Fixed
-- MCP connection timeout, hook input parsing, hot-path log noise reduction
+### 修复
+- MCP 连接超时，hook 输入解析，热路径日志噪音降低
 
-## [1.2.17] - 2026-05-21
+## [1.2.18] - 2026-05-21
 
-### Added
-- Task status auto-termination: executing/verifying/learning auto-fail after 30 minutes
-- User prompt submit hook with auto-injected `sf_classify` reminder
-- Entry routing modular split: signal-driven routing + suffix-driven material extraction + structured logging
-- Full runtime logging, Chinese JSDoc annotations, and comment standards
-- Contract Registry system: Workflow, Tool Invocation, Input Material, Artifact, Configuration Precedence, Privacy/Secret/Data Sovereignty
-- Mechanism Contract Registry with fact pre-validation and terminal pointer cleanup
-- Consumable Asset Registry covering 161 built-in assets
-- Intent Router replacing task_type-to-strategy routing
-- Diff Ownership phases 1 and 2: state model, CAS verification, task lifecycle integration, advisory conflict reports
-- Governance phases P1-P2: Capability Registry, Policy ID drift detection, persistent audit pool, risk-weighted sampling, escape report, capability action advisor, governance health report, audit sampling, MCP tool expansion (31 tools)
-- Phases 1-14: consistency closure, knowledge template completion, scope lease, conflict merge gate, resume workspace, semantic delivery evidence, mutation audit, knowledge sovereignty, developer sovereignty, long-running jobs with context replay, zero-config init, Java quality guard, runtime safety package, real-project regression
-
-### Changed
-- Removed dynamic fact pollution; project facts declared not hardcoded
-
-### Fixed
-- Release Gate false-green elimination: 35 rules fully covered
-- UserPromptSubmit hook event name, stdin input, and JSON output format
-- Security hardening: 23 audit fixes covering hash/injection/race-condition/sandbox
-- Scenario A source hash and artifact_ready with real reference and snapshot hash evidence
-- Test TS type errors, AssetKind union type build break
-- `sf_capability_update` empty evidence_ids rejection
-- P0 handler lifecycle fix and tool registration strategy
-- Diff Ownership phase 2 scope directory expansion and three preWriteCheck fixes
-- CAS check deletion boundary and reverse traversal fixes
-- Audit pool test isolation from process.cwd()
-
-### Removed
-- Legacy `setup.sh` (replaced by regression test)
-- Obsolete `verify-test-counts` gate
+### 修复
+- npm bin 缺少可执行权限：添加 prepublishOnly chmod +x
 
-## [1.2.18] - 2026-05-21
+## [1.2.17] - 2026-05-21
 
-### Fixed
-- npm bin missing executable permission: added prepublishOnly chmod +x
+### 新增
+- 任务状态自动终止：executing/verifying/learning 30 分钟后自动失败
+- 用户提示提交 hook，自动注入 `sf_classify` 提醒
+- 入口路由模块拆分：信号驱动路由 + 后缀驱动素材提取 + 结构化日志
+- 全量运行时日志，中文 JSDoc 注释和注释标准
+- 契约注册系统：工作流、工具调用、输入素材、产物、配置优先级、隐私/密钥/数据主权
+- 机制契约注册表，含事实预校验和终端指针清理
+- 可消费资产注册表，覆盖 161 个内置资产
+- 意图路由器替代 task_type-to-strategy 路由
+- Diff Ownership 阶段 1 和 2：状态模型，CAS 验证，任务生命周期集成，建议性冲突报告
+- 治理阶段 P1-P2：能力注册表，策略 ID 漂移检测，持久化审计池，风险加权采样，逃逸报告，能力行动顾问，治理健康报告，审计采样，MCP 工具扩展（31 个工具）
+- 阶段 1-14：一致性闭环，知识模板完成，作用域租约，冲突合并门禁，恢复工作空间，语义交付证据，变更审计，知识主权，开发者主权，长时运行任务上下文回放，零配置初始化，Java 质量守卫，运行时安全包，真实项目回归
+
+### 变更
+- 移除动态事实污染；项目事实声明式而非硬编码
+
+### 修复
+- 发布门禁假绿消除：35 条规则全覆盖
+- UserPromptSubmit hook 事件名，stdin 输入和 JSON 输出格式
+- 安全加固：23 项审计修复，覆盖哈希/注入/竞态条件/沙箱
+- 场景 A 源码哈希和 artifact_ready 含真实引用与快照哈希证据
+- 测试 TS 类型错误，AssetKind 联合类型构建中断
+- `sf_capability_update` 空 evidence_ids 拒绝
+- P0 处理器生命周期修复和工具注册策略
+- Diff Ownership 阶段 2 scope 目录扩展和三个 preWriteCheck 修复
+- CAS 检查删除边界和反向遍历修复
+- 审计池测试与 process.cwd() 隔离
+
+### 移除
+- 遗留 `setup.sh`（已由回归测试替代）
+- 废弃的 `verify-test-counts` 门槛
 
 ## [1.2.1] - 2026-05-17
 
-### Fixed
-- `init` supports `--project-path`; eight-dimension knowledge files deployed to templates/
+### 修复
+- `init` 支持 `--project-path`；八维知识文件部署到 templates/
 
 ## [1.2.0] - 2026-05-17
 
-### Added
-- Eight-dimension closed-loop defense and knowledge layer alignment (602 tests, 51 files)
+### 新增
+- 八维闭环防御与知识层对齐（602 个测试，51 个文件）
 
 ## [1.1.2] - 2026-05-17
 
-### Changed
-- Appendix restructure: A/B/C appendices with 100% coverage matrix
+### 变更
+- 附录重构：A/B/C 附录，100% 覆盖矩阵
 
 ## [1.1.1] - 2026-05-17
 
-### Added
-- `version` command (`soloforge version` / `-v` / `--version`)
+### 新增
+- `version` 命令（`soloforge version` / `-v` / `--version`）
 
 ## [1.1.0] - 2026-05-17
 
-### Added
-- Five engineering mechanisms and `sf_explore` autonomous tech selection engine
-- Knowledge layer sync: five mechanisms + sf_explore knowledge entries
-- Codex `AGENTS.md` generation, shared workflow templates, adapter cleanup
-- Chinese JSDoc comments, scaffolding template annotation standards, classifier keyword expansion
+### 新增
+- 五大工程机制与 `sf_explore` 自主技术选型引擎
+- 知识层同步：五大机制 + sf_explore 知识条目
+- Codex `AGENTS.md` 生成，共享工作流模板，适配器清理
+- 中文 JSDoc 注释，脚手架模板注释标准，分类器关键词扩展
 
-### Fixed
-- Full security audit: command injection prevention, gitleaks cache TTL, watcher leak fix, parallel IO optimization, enable/disable fallback
-- 27 audit issue fixes: Codex hooks format, environment detection, deep copy, merge write, security hardening
-- Audit completion: 3 unit test groups, design doc data correction, sf_brainstorm clarification
+### 修复
+- 全量安全审计：命令注入防护，gitleaks 缓存 TTL，watcher 泄漏修复，并行 IO 优化，启用/禁用回退
+- 27 项审计问题修复：Codex hooks 格式，环境检测，深拷贝，合并写入，安全加固
+- 审计完成：3 组单元测试，设计文档数据修正，sf_brainstorm 澄清
 
 ## [1.0.0] - 2026-05-15
 
-### Added
-- SoloForge Phase 1/2/2.5 complete: MCP server with 9 tools, 48 knowledge entries, 172 tests
-- Phase 3 team collaboration: 5 engine modules + 5 MCP tools (284 tests)
-- Phase 3b Trae IDE adapter: multi-IDE support (305 tests)
-- Phase 2.6 knowledge-driven planning + architecture governance principles (312 tests)
-- `sf_plan_advance` tool for multi-stage plan step progression
-- Figma-to-delivery pipeline template and prototype description template
-- Phase 2.7 knowledge-driven system expansion: 108 knowledge entries + 18 MCP tools
-- Phase 3b: template renaming, prototype template upgrade, self-maintenance tool isolation
-- Knowledge entry format specification with regression prevention
-- Template content industry-grade optimization and `auto_enrich` mechanism
-- Phase 4 continuous optimization, E2E verification, and release preparation
-
-### Fixed
-- Full review fix: 30 logic bugs + 13 review issues + 4 informational issues
-- Unified all template file formats
-- `sf_plan_advance` output format aligned with design doc
+### 新增
+- SoloForge 阶段 1/2/2.5 完成：MCP 服务器含 9 个工具，48 个知识条目，172 个测试
+- 阶段 3 团队协作：5 个引擎模块 + 5 个 MCP 工具（284 个测试）
+- 阶段 3b Trae IDE 适配器：多 IDE 支持（305 个测试）
+- 阶段 2.6 知识驱动规划 + 架构治理原则（312 个测试）
+- `sf_plan_advance` 工具支持多阶段计划步骤推进
+- Figma 到交付管线模板和原型描述模板
+- 阶段 2.7 知识驱动系统扩展：108 个知识条目 + 18 个 MCP 工具
+- 阶段 3b：模板重命名，原型模板升级，自维护工具隔离
+- 知识条目格式规范与防回归机制
+- 模板内容工业化优化与 `auto_enrich` 机制
+- 阶段 4 持续优化，E2E 验证与发布准备
+
+### 修复
+- 全面评审修复：30 个逻辑缺陷 + 13 个评审问题 + 4 个信息性问题
+- 统一所有模板文件格式
+- `sf_plan_advance` 输出格式与设计文档对齐