scene-capability-engine 3.6.50 → 3.6.51

package/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.6.51] - 2026-03-15
+
+### Changed
+- Added a new core steering baseline rule requiring rewrite-style changes to remove obsolete code, dead branches, abandoned adapters, and stale references in the same change unless an explicit temporary compatibility plan exists.
+
 ## [3.6.50] - 2026-03-14
 
 ### Changed

package/README.md

@@ -218,5 +218,5 @@ MIT. See [LICENSE](LICENSE).
 
 ---
 
-**Version**: 3.6.50
-**Last Updated**: 2026-03-14
+**Version**: 3.6.51
+**Last Updated**: 2026-03-15

package/README.zh.md

@@ -223,5 +223,5 @@ MIT，见 [LICENSE](LICENSE)。
 
 ---
 
-**版本**：3.6.50
-**最后更新**：2026-03-14
+**版本**：3.6.51
+**最后更新**：2026-03-15

package/docs/command-reference.md

@@ -2,8 +2,8 @@
 
 > Quick reference for all `sce` commands
 
-**Version**: 3.6.50
-**Last Updated**: 2026-03-14
+**Version**: 3.6.51
+**Last Updated**: 2026-03-15
 
 ---
 

package/docs/multi-agent-coordination-guide.md

@@ -2,8 +2,8 @@
 
 > Enable multiple AI agents to work on the same sce project simultaneously without conflicts.
 
-**Version**: 3.6.50  
-**Last Updated**: 2026-03-14
+**Version**: 3.6.51  
+**Last Updated**: 2026-03-15
 
 ---
 

package/docs/releases/v3.6.51.md

@@ -0,0 +1,18 @@
+# v3.6.51 Release Notes
+
+Release date: 2026-03-15
+
+## Highlights
+
+- Added a new SCE core principle that requires rewrite-style feature, UI, and module changes to remove obsolete implementations in the same change instead of leaving dead code behind.
+- Extended takeover baseline repair so adopted projects automatically regain this obsolete-code-cleanup principle if their steering baseline drifts.
+- Synced package and documentation version metadata for the new release, including runtime/template README footers and current-version guide headers.
+
+## Validation
+
+- `npx jest tests/unit/workspace/takeover-baseline.test.js --runInBand`
+
+## Release Notes
+
+- This patch tightens SCE's default governance against AI-generated garbage code by making dead-code cleanup an explicit baseline requirement rather than an optional style preference.
+- The rule applies across all SCE-managed projects and clarifies that temporary retention is allowed only when compatibility or rollback constraints are documented with a concrete cleanup plan.

package/docs/zh/releases/v3.6.51.md

@@ -0,0 +1,18 @@
+# v3.6.51 发布说明
+
+发布日期：2026-03-15
+
+## 重点变化
+
+- 新增一条 SCE 核心原则：功能、UI 或模块发生重写/替换时，失效旧实现必须在同一轮变更中清理，不能继续把废弃代码留在仓库里。
+- 扩展 takeover baseline 修复逻辑；接管项目若缺失这条“清理废弃代码”原则，SCE 会自动补齐基线。
+- 同步更新本次版本的包信息和文档版本元数据，包括运行时/模板 README 尾注以及当前版本说明文档。
+
+## 验证
+
+- `npx jest tests/unit/workspace/takeover-baseline.test.js --runInBand`
+
+## 发布说明
+
+- 这个补丁版把“禁止 AI 制造垃圾代码并把旧实现遗留在仓库里”提升为 SCE 的默认治理要求，而不再只是编码习惯建议。
+- 若确实因为兼容、灰度或回滚需要临时保留旧实现，也必须明确说明保留理由、适用边界、退出条件和后续清理计划。

package/lib/workspace/takeover-baseline.js

@@ -48,6 +48,18 @@ const BACKEND_API_PRECEDENCE_CORE_PRINCIPLE_SECTION = [
   '- 除非明确要求新建接口或修改后端接口，否则禁止为了迁就前端错误调用去随意改后端实现或契约。',
   '- 默认优先修正前端请求、映射、类型和兼容处理，使其与后端接口保持一致；若怀疑后端契约错误，应先确认再改。'
 ].join('\n');
+const DELIVERY_SYNC_CORE_PRINCIPLE_HEADING = '## 6. 测试、文档、代码必须同步闭环';
+const DELIVERY_SYNC_REQUIRED_LINES = Object.freeze([
+  '- 代码变更必须跑相关验证；发布前不得忽略失败。',
+  '- 重要功能、命令、配置变化必须同步更新 README、用户文档或发布说明。',
+  '- 功能修改、UI 重写、模块替换时，已失效的旧实现、旧样式、死分支、失效适配层和无效引用必须在同一轮变更中清理，不得继续留作“保险”。',
+  '- 若因兼容、灰度或回滚必须暂时保留旧实现，必须明确保留理由、适用边界、退出条件和后续清理计划。'
+]);
+const DELIVERY_SYNC_CORE_PRINCIPLE_SECTION = [
+  DELIVERY_SYNC_CORE_PRINCIPLE_HEADING,
+  '',
+  ...DELIVERY_SYNC_REQUIRED_LINES
+].join('\n');
 const LARGE_FILE_REFACTOR_CORE_PRINCIPLE_HEADING = '## 15. 单文件规模过大必须触发重构评估，禁止无限堆积';
 const LARGE_FILE_REFACTOR_CORE_PRINCIPLE_SECTION = [
   LARGE_FILE_REFACTOR_CORE_PRINCIPLE_HEADING,
@@ -59,6 +71,10 @@ const LARGE_FILE_REFACTOR_CORE_PRINCIPLE_SECTION = [
   '- 行数阈值只是强触发信号，不代表低于阈值就可以忽略耦合、职责混杂、测试失控和理解成本问题；若复杂度已明显失控，应提前启动重构。'
 ].join('\n');
 const REQUIRED_CORE_PRINCIPLE_SECTIONS = Object.freeze([
+  {
+    heading: DELIVERY_SYNC_CORE_PRINCIPLE_HEADING,
+    section: DELIVERY_SYNC_CORE_PRINCIPLE_SECTION
+  },
   {
     heading: CLARIFICATION_FIRST_CORE_PRINCIPLE_HEADING,
     section: CLARIFICATION_FIRST_CORE_PRINCIPLE_SECTION
@@ -658,22 +674,54 @@ async function _reconcileSteeringContract(projectPath, options = {}) {
   };
 }
 
+function _appendLinesToSection(content, heading, lines) {
+  if (!content || !heading || !Array.isArray(lines) || lines.length === 0) {
+    return content;
+  }
+
+  const startIndex = content.indexOf(heading);
+  if (startIndex === -1) {
+    return content;
+  }
+
+  const sectionBodyStart = startIndex + heading.length;
+  const nextHeadingIndex = content.indexOf('\n## ', sectionBodyStart);
+  const sectionEnd = nextHeadingIndex === -1 ? content.length : nextHeadingIndex;
+  const section = content.slice(startIndex, sectionEnd).trimEnd();
+  const missingLines = lines.filter((line) => !section.includes(line));
+
+  if (missingLines.length === 0) {
+    return content;
+  }
+
+  const updatedSection = `${section}\n${missingLines.join('\n')}`;
+  return `${content.slice(0, startIndex)}${updatedSection}${content.slice(sectionEnd)}`;
+}
+
 async function _reconcileCorePrinciplesBaseline(projectPath, options = {}) {
   const { apply, fileSystem } = options;
   const corePrinciplesPath = path.join(projectPath, SCE_STEERING_DIR, DEFAULT_LAYER_FILES.core_principles);
   const exists = await fileSystem.pathExists(corePrinciplesPath);
   const existingContent = exists ? await fileSystem.readFile(corePrinciplesPath, 'utf8') : '';
   const missingSections = REQUIRED_CORE_PRINCIPLE_SECTIONS.filter(({ heading }) => !existingContent.includes(heading));
-  const changed = missingSections.length > 0;
+  const missingDeliverySyncLines = existingContent.includes(DELIVERY_SYNC_CORE_PRINCIPLE_HEADING)
+    ? DELIVERY_SYNC_REQUIRED_LINES.filter((line) => !existingContent.includes(line))
+    : [];
+  const changed = missingSections.length > 0 || missingDeliverySyncLines.length > 0;
 
   if (apply && changed) {
-    const normalized = `${existingContent || ''}`.trimEnd();
+    let nextContent = `${existingContent || ''}`.trimEnd();
     const appendedSections = missingSections.map((item) => item.section).join('\n\n');
-    const nextContent = normalized
-      ? `${normalized}\n\n${appendedSections}\n`
-      : `${appendedSections}\n`;
+    if (appendedSections) {
+      nextContent = nextContent
+        ? `${nextContent}\n\n${appendedSections}`
+        : appendedSections;
+    }
+    if (missingDeliverySyncLines.length > 0) {
+      nextContent = _appendLinesToSection(nextContent, DELIVERY_SYNC_CORE_PRINCIPLE_HEADING, missingDeliverySyncLines);
+    }
     await fileSystem.ensureDir(path.dirname(corePrinciplesPath));
-    await fileSystem.writeFile(corePrinciplesPath, nextContent, 'utf8');
+    await fileSystem.writeFile(corePrinciplesPath, `${nextContent}\n`, 'utf8');
   }
 
   return {
@@ -684,6 +732,7 @@ async function _reconcileCorePrinciplesBaseline(projectPath, options = {}) {
     managed_by: 'takeover-baseline',
     details: {
       missing_required_headings_before: missingSections.map((item) => item.heading),
+      missing_delivery_sync_lines_before: missingDeliverySyncLines,
       required_headings: REQUIRED_CORE_PRINCIPLE_SECTIONS.map((item) => item.heading)
     }
   };
@@ -923,6 +972,8 @@ module.exports = {
   STEERING_CHANGE_EVALUATION_CORE_PRINCIPLE_SECTION,
   BACKEND_API_PRECEDENCE_CORE_PRINCIPLE_HEADING,
   BACKEND_API_PRECEDENCE_CORE_PRINCIPLE_SECTION,
+  DELIVERY_SYNC_CORE_PRINCIPLE_HEADING,
+  DELIVERY_SYNC_REQUIRED_LINES,
   LARGE_FILE_REFACTOR_CORE_PRINCIPLE_HEADING,
   LARGE_FILE_REFACTOR_CORE_PRINCIPLE_SECTION,
   REQUIRED_CORE_PRINCIPLE_SECTIONS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scene-capability-engine",
-  "version": "3.6.50",
+  "version": "3.6.51",
   "description": "SCE (Scene Capability Engine) - A CLI tool and npm package for spec-driven development with AI coding assistants.",
   "main": "index.js",
   "bin": {

package/template/.sce/README.md

@@ -243,6 +243,6 @@ A Spec is a complete feature definition with three parts:
 ---
 
 **Project Type**: Spec-driven development  
-**sce Version**: 3.6.50  
-**Last Updated**: 2026-03-14  
+**sce Version**: 3.6.51  
+**Last Updated**: 2026-03-15  
 **Purpose**: Guide AI tools to work effectively with this project

package/template/.sce/steering/CORE_PRINCIPLES.md

@@ -29,6 +29,8 @@
 
 - 禁止靠跳过测试、关闭校验、吞错回退来伪装成功。
 - 临时兜底必须附带退出条件、清理任务与截止时间。
+- 重写或替换实现时，同步删除失效旧代码、旧样式、死分支和无效引用，不要把废弃实现留在仓库里当“保险”。
+- 如果因为兼容、灰度或回滚必须临时保留旧实现，必须写明保留理由、边界、退出条件和后续清理计划。
 
 ## 6. 定期净化 steering