scene-capability-engine 3.6.49 → 3.6.51

package/CHANGELOG.md

@@ -7,6 +7,19 @@ 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
+- Switched the SCE co-work baseline to default-on: multi-agent config defaults to `enabled=true`, `init/adopt/takeover` now provision `.sce/config/multi-agent.json`, and adoption metadata defaults `multiUserMode` to true while keeping the central coordinator opt-in.
+- Added `scripts/collab-governance-gate.js` and a shared collaboration-governance gate helper so co-work governance can run as a reusable push/publish preflight instead of remaining a report-only audit.
+- Updated `sce timeline push` to fail fast on collaboration governance drift before creating a push checkpoint or executing `git push`, ensuring managed push flow respects `.gitignore` collaboration boundaries, runtime-state tracking hygiene, multi-agent config validity, legacy naming cleanup, and steering boundary rules.
+- Wired `gate:collab-governance` into `prepublishOnly` so npm publish now enforces the same co-work governance baseline as managed push.
+
 ## [3.6.49] - 2026-03-14
 
 ### Changed

package/README.md

@@ -142,6 +142,7 @@ SCE is opinionated by default.
 - When business scene/module/page/entity context is missing, SCE must route to clarification first; unknown business scope must not be turned into blanket disable.
 - `verify` and `release` enforce problem-closure and related gates when a spec is bound.
 - Autonomous program execution applies gate evaluation, fallback-chain logic, governance replay, and auto-remediation.
+- Co-work baseline is enabled by default: initialized/adopted SCE projects provision `.sce/config/multi-agent.json` with `enabled=true`, while the central coordinator stays opt-in.
 - State persistence prefers SQLite, not ad hoc local caches.
 - Oversized source files must trigger periodic refactor assessment; SCE recommends project-specific thresholds, with `2000 / 4000 / 10000` as the default source-file fallback.
 - Release validation defaults to integration test coverage via `npm run test:release` for faster publish feedback.
@@ -217,5 +218,5 @@ MIT. See [LICENSE](LICENSE).
 
 ---
 
-**Version**: 3.6.49
-**Last Updated**: 2026-03-14
+**Version**: 3.6.51
+**Last Updated**: 2026-03-15

package/README.zh.md

@@ -147,6 +147,7 @@ SCE 默认是强治理的。
 - 缺少业务场景/模块/页面/实体上下文时，SCE 必须先进入澄清，而不是把未知业务范围直接变成一刀切禁用
 - 当 spec 绑定时，`verify` 和 `release` 默认执行 problem-closure 等相关门禁
 - `close-loop-program` 默认带 gate 评估、fallback-chain、governance replay、auto-remediation
+- co-work 基线默认开启：初始化或接管后的 SCE 项目会落地 `.sce/config/multi-agent.json` 且 `enabled=true`，但中央 coordinator 仍保持按需开启
 - 状态持久化默认优先走 SQLite，而不是零散本地缓存
 - 超大源文件必须定期触发重构评估；SCE 优先建议按项目给出阈值，若项目尚未设定，则默认参考 `2000 / 4000 / 10000`
 - 发布默认验证走 integration gate：`npm run test:release`
@@ -222,5 +223,5 @@ MIT，见 [LICENSE](LICENSE)。
 
 ---
 
-**版本**：3.6.49
-**最后更新**：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.34
-**Last Updated**: 2026-03-08
+**Version**: 3.6.51
+**Last Updated**: 2026-03-15
 
 ---
 
@@ -127,7 +127,7 @@ sce timeline restore <snapshot-id> --prune --json
 # Update timeline policy
 sce timeline config --enabled true --interval 30 --max-entries 120 --json
 
-# Push with pre-push snapshot
+# Push with co-work governance gate + pre-push snapshot
 sce timeline push origin main
 ```
 
@@ -135,6 +135,7 @@ Timeline policy:
 - default enabled with local retention under `.sce/timeline/snapshots/`
 - stage/key-event checkpoints are automatically captured for `studio` and `session` commands
 - interval auto-checkpoints are integrated in the same flow via timeline checkpoint capture
+- `timeline push` now blocks before snapshot/push when collaboration governance drifts, so tracked runtime state, missing co-work ignore rules, legacy `.kiro*` references, invalid multi-agent config, or steering boundary drift cannot pass through managed push flow
 
 ### Value Metrics
 

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**: 1.44.0  
-**Last Updated**: 2026-02-12
+**Version**: 3.6.51  
+**Last Updated**: 2026-03-15
 
 ---
 
@@ -25,31 +25,31 @@ The Multi-Agent Parallel Coordination system solves this with six layers of prot
 10. **Spec Lifecycle Manager** — Spec state machine and auto-completion (v1.44.0)
 11. **Sync Barrier** — Agent Spec-switch synchronization (v1.44.0)
 
-All components are **zero overhead in single-agent mode** — they become no-ops when multi-agent mode is not enabled.
+SCE provisions the co-work baseline by default. If a project explicitly sets `enabled: false`, all components fall back to single-agent no-op behavior.
 
 ---
 
 ## Quick Start
 
-### 1. Enable Multi-Agent Mode
+### 1. Review Multi-Agent Mode Baseline
 
-Create the configuration file `.sce/config/multi-agent.json`:
+SCE provisions `.sce/config/multi-agent.json` by default:
 
 ```json
 {
   "enabled": true,
-  "coordinator": false,
-  "heartbeatIntervalMs": 30000,
-  "heartbeatTimeoutMs": 120000
+  "coordinatorEnabled": false,
+  "heartbeatIntervalMs": 60000,
+  "heartbeatTimeoutMs": 180000
 }
 ```
 
 | Field | Description | Default |
 |-------|-------------|---------|
-| `enabled` | Enable multi-agent coordination | `false` |
-| `coordinator` | Enable central task assignment | `false` |
-| `heartbeatIntervalMs` | Heartbeat interval in ms | `30000` |
-| `heartbeatTimeoutMs` | Agent considered inactive after this | `120000` |
+| `enabled` | Enable multi-agent coordination | `true` |
+| `coordinatorEnabled` | Enable central task assignment | `false` |
+| `heartbeatIntervalMs` | Heartbeat interval in ms | `60000` |
+| `heartbeatTimeoutMs` | Agent considered inactive after this | `180000` |
 
 ### 2. Each Agent Registers Itself
 
@@ -504,9 +504,9 @@ All components check `MultiAgentConfig.isEnabled()` before doing anything:
 ```json
 {
   "enabled": true,
-  "coordinator": false,
-  "heartbeatIntervalMs": 30000,
-  "heartbeatTimeoutMs": 120000
+  "coordinatorEnabled": false,
+  "heartbeatIntervalMs": 60000,
+  "heartbeatTimeoutMs": 180000
 }
 ```
 

package/docs/releases/v3.6.50.md

@@ -0,0 +1,21 @@
+# v3.6.50 Release Notes
+
+Release date: 2026-03-14
+
+## Highlights
+
+- Switched the SCE co-work baseline to default-on: initialized/adopted/takeover-aligned projects now provision `.sce/config/multi-agent.json` with `enabled=true`, while the central coordinator remains opt-in.
+- Added a reusable `collab-governance-gate` and wired it into both `sce timeline push` and `prepublishOnly`, so managed push/publish flow now blocks on co-work governance drift instead of relying on report-only auditing.
+- Synced template/runtime release metadata and multi-agent guidance so shipped documentation reflects the new default co-work baseline and the current package version.
+
+## Validation
+
+- `npx jest tests/unit/scripts/collab-governance-gate.test.js tests/unit/commands/timeline.test.js --runInBand`
+- `npx jest tests/unit/collab/multi-agent-config.test.js tests/unit/workspace/takeover-baseline.test.js tests/integration/takeover-baseline-cli.integration.test.js --runInBand`
+- `node scripts/collab-governance-gate.js --json`
+- `npm run prepublishOnly`
+
+## Release Notes
+
+- This patch closes the gap where SCE had co-work governance rules and auditing, but initialized/adopted projects still defaulted to a disabled multi-agent baseline.
+- Managed push and publish now share the same co-work governance gate, which prevents collaboration boundary drift from slipping through one path while being caught by another.

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/steering-strategy-guide.md

@@ -102,7 +102,7 @@ Your steering strategy choice is saved in `.sce/adoption-config.json`:
   "adoptedAt": "2026-01-23T10:00:00.000Z",
   "steeringStrategy": "use-sce",
   "steeringBackupId": "steering-2026-01-23T10-00-00-000Z",
-  "multiUserMode": false,
+  "multiUserMode": true,
   "lastUpdated": "2026-01-23T10:00:00.000Z"
 }
 ```

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

@@ -0,0 +1,21 @@
+# v3.6.50 发布说明
+
+发布日期：2026-03-14
+
+## 重点变化
+
+- 将 SCE 的 co-work 基线切换为默认开启：`init` / `adopt` / `takeover` 对齐后的项目现在都会落地 `.sce/config/multi-agent.json` 且 `enabled=true`，中央 coordinator 仍保持按需开启。
+- 新增可复用的 `collab-governance-gate`，并接入 `sce timeline push` 与 `prepublishOnly`，让托管 push / publish 在 co-work 治理漂移时直接阻断，而不是只做报告型审计。
+- 同步更新模板、运行时说明和版本元数据，确保发出的文档与默认 co-work 基线、当前包版本保持一致。
+
+## 验证
+
+- `npx jest tests/unit/scripts/collab-governance-gate.test.js tests/unit/commands/timeline.test.js --runInBand`
+- `npx jest tests/unit/collab/multi-agent-config.test.js tests/unit/workspace/takeover-baseline.test.js tests/integration/takeover-baseline-cli.integration.test.js --runInBand`
+- `node scripts/collab-governance-gate.js --json`
+- `npm run prepublishOnly`
+
+## 发布说明
+
+- 这个补丁版补齐了一个关键缺口：SCE 虽然已经具备 co-work 治理规则和审计能力，但此前新接入项目默认仍可能落在关闭态。
+- 现在托管 push 与 publish 共用同一条 co-work governance gate，避免一条链路能放过的协作治理漂移，在另一条链路才被发现。

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/collab/multi-agent-config.js

@@ -2,8 +2,8 @@
  * Multi-Agent Configuration Manager
  *
  * Manages `.sce/config/multi-agent.json` for multi-Agent parallel coordination.
- * When the config file does not exist or is corrupted, returns a default
- * disabled configuration so that single-Agent mode is completely unaffected.
+ * Co-work baseline is enabled by default for SCE-managed projects; a project
+ * can still opt out explicitly by setting `enabled: false`.
  *
  * Requirements: 7.1 (no extra files when disabled), 7.4 (auto-init on first enable)
  */
@@ -16,7 +16,7 @@ const CONFIG_DIR = '.sce/config';
 
 /** @type {import('./multi-agent-config').MultiAgentConfigData} */
 const DEFAULT_CONFIG = Object.freeze({
-  enabled: false,
+  enabled: true,
   heartbeatIntervalMs: 60000,
   heartbeatTimeoutMs: 180000,
   coordinatorEnabled: false,
@@ -36,7 +36,7 @@ class MultiAgentConfig {
 
   /**
    * Read the current configuration.
-   * Returns the default (disabled) config when the file is missing or corrupted.
+   * Returns the default config when the file is missing or corrupted.
    *
    * @returns {Promise<object>} Resolved configuration
    */

package/lib/commands/timeline.js

@@ -5,6 +5,10 @@ const {
   ProjectTimelineStore,
   captureTimelineCheckpoint
 } = require('../runtime/project-timeline');
+const {
+  evaluateCollabGovernanceGate,
+  formatCollabGovernanceGateBlockMessage
+} = require('../workspace/collab-governance-gate');
 const {
   summarizeTimelineAttention,
   buildTimelineEntryViewModel,
@@ -172,8 +176,21 @@ async function runTimelineConfigCommand(options = {}, dependencies = {}) {
 
 async function runTimelinePushCommand(gitArgs = [], options = {}, dependencies = {}) {
   const projectPath = dependencies.projectPath || process.cwd();
+  const collabGovernanceGate = dependencies.evaluateCollabGovernanceGate || evaluateCollabGovernanceGate;
+  const checkpointRunner = dependencies.captureTimelineCheckpoint || captureTimelineCheckpoint;
+  const runGitPush = dependencies.spawnSync || spawnSync;
+
+  const gatePayload = await collabGovernanceGate({
+    projectPath
+  }, dependencies);
+  if (!gatePayload.passed) {
+    const error = new Error(formatCollabGovernanceGateBlockMessage(gatePayload));
+    error.exitCode = 2;
+    error.gate = gatePayload;
+    throw error;
+  }
 
-  const checkpoint = await captureTimelineCheckpoint({
+  const checkpoint = await checkpointRunner({
     trigger: 'push',
     event: 'git.push.preflight',
     summary: normalizeText(options.summary) || 'pre-push timeline checkpoint',
@@ -183,7 +200,7 @@ async function runTimelinePushCommand(gitArgs = [], options = {}, dependencies =
     fileSystem: dependencies.fileSystem
   });
 
-  const result = spawnSync('git', ['push', ...(Array.isArray(gitArgs) ? gitArgs : [])], {
+  const result = runGitPush('git', ['push', ...(Array.isArray(gitArgs) ? gitArgs : [])], {
     cwd: projectPath,
     stdio: 'inherit',
     windowsHide: true
@@ -277,7 +294,7 @@ function registerTimelineCommands(program) {
 
   timeline
     .command('push [gitArgs...]')
-    .description('Create a pre-push timeline snapshot, then run git push')
+    .description('Run collaboration governance gate, create a pre-push timeline snapshot, then run git push')
     .option('--summary <text>', 'Summary for pre-push checkpoint')
     .option('--json', 'Output as JSON')
     .action(async (gitArgs, options) => safeRun(runTimelinePushCommand, options, gitArgs));

package/lib/steering/adoption-config.js

@@ -73,7 +73,7 @@ class AdoptionConfig {
       config = {
         version: '1.0.0',
         adoptedAt: new Date().toISOString(),
-        multiUserMode: false
+        multiUserMode: true
       };
     }
 
@@ -139,7 +139,7 @@ class AdoptionConfig {
    */
   async isMultiUserMode() {
     const config = await this.read();
-    return config ? (config.multiUserMode || false) : false;
+    return config ? (typeof config.multiUserMode === 'boolean' ? config.multiUserMode : true) : true;
   }
 
   /**
@@ -153,7 +153,7 @@ class AdoptionConfig {
       version: '1.0.0',
       adoptedAt: new Date().toISOString(),
       steeringStrategy: options.steeringStrategy || 'use-sce',
-      multiUserMode: options.multiUserMode || false,
+      multiUserMode: typeof options.multiUserMode === 'boolean' ? options.multiUserMode : true,
       ...options
     };
 

package/lib/workspace/collab-governance-gate.js

@@ -0,0 +1,65 @@
+'use strict';
+
+const { auditCollabGovernance } = require('./collab-governance-audit');
+
+async function evaluateCollabGovernanceGate(options = {}, dependencies = {}) {
+  const projectPath = options.projectPath || dependencies.projectPath || process.cwd();
+  const audit = await (dependencies.auditCollabGovernance || auditCollabGovernance)(
+    projectPath,
+    options,
+    dependencies
+  );
+
+  return {
+    mode: 'collab-governance-gate',
+    project_path: projectPath,
+    passed: audit.passed === true,
+    reason: audit.reason || (audit.passed === true ? 'passed' : 'violations'),
+    summary: audit.summary || {},
+    warnings: Array.isArray(audit.warnings) ? audit.warnings : [],
+    violations: Array.isArray(audit.violations) ? audit.violations : [],
+    audit
+  };
+}
+
+function formatCollabGovernanceGateBlockMessage(payload = {}, maxViolations = 3) {
+  const violations = Array.isArray(payload.violations) ? payload.violations.filter(Boolean) : [];
+  if (violations.length === 0) {
+    return 'collaboration governance gate blocked push';
+  }
+
+  const visibleViolations = violations.slice(0, Math.max(1, maxViolations));
+  const suffix = violations.length > visibleViolations.length
+    ? ` (+${violations.length - visibleViolations.length} more)`
+    : '';
+  return `collaboration governance gate blocked push: ${visibleViolations.join('; ')}${suffix}`;
+}
+
+async function runCollabGovernanceGate(options = {}, dependencies = {}) {
+  const payload = await evaluateCollabGovernanceGate(options, dependencies);
+
+  if (options.json) {
+    process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
+  } else if (payload.passed) {
+    process.stdout.write('[collab-governance-gate] passed\n');
+    process.stdout.write(
+      `[collab-governance-gate] missing-ignore-rules=${payload.summary.missing_gitignore_rules || 0} legacy-references=${payload.summary.legacy_reference_count || 0}\n`
+    );
+  } else {
+    process.stdout.write('[collab-governance-gate] blocked\n');
+    payload.violations.forEach((item) => {
+      process.stdout.write(`[collab-governance-gate] violation=${item}\n`);
+    });
+  }
+
+  return {
+    ...payload,
+    exit_code: options.failOnViolation && !payload.passed ? 2 : 0
+  };
+}
+
+module.exports = {
+  evaluateCollabGovernanceGate,
+  formatCollabGovernanceGateBlockMessage,
+  runCollabGovernanceGate
+};

package/lib/workspace/takeover-baseline.js

@@ -10,6 +10,9 @@ const {
 const {
   cloneStateStoragePolicyDefaults
 } = require('../state/state-storage-policy');
+const {
+  DEFAULT_CONFIG: MULTI_AGENT_CONFIG_DEFAULTS
+} = require('../collab/multi-agent-config');
 
 const TAKEOVER_BASELINE_SCHEMA_VERSION = '1.0';
 const CLARIFICATION_FIRST_CORE_PRINCIPLE_HEADING = '## 11. 业务场景未知时必须先澄清，禁止直接彻底禁用';
@@ -45,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,
@@ -56,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
@@ -349,6 +368,10 @@ const TAKEOVER_DEFAULTS = Object.freeze({
     max_direct_fix_rounds_before_debug: 2,
     forbid_bypass_workarounds: true
   },
+  collaboration: {
+    multi_user_mode: true,
+    multi_agent: _clone(MULTI_AGENT_CONFIG_DEFAULTS)
+  },
   errorbook_convergence: _clone(ERRORBOOK_CONVERGENCE_DEFAULTS),
   migration_policy: {
     legacy_kiro_supported: false,
@@ -440,7 +463,7 @@ function _buildAdoptionConfig(existing, nowIso, sceVersion) {
     steeringStrategy: typeof base.steeringStrategy === 'string' && base.steeringStrategy.trim()
       ? base.steeringStrategy
       : 'use-sce',
-    multiUserMode: base.multiUserMode === true,
+    multiUserMode: typeof base.multiUserMode === 'boolean' ? base.multiUserMode : true,
     runtimePolicy: {
       agent_parity_permissions: true,
       autonomous_default: true
@@ -456,6 +479,14 @@ function _buildAdoptionConfig(existing, nowIso, sceVersion) {
   };
 }
 
+function _buildMultiAgentConfig(existing) {
+  const base = _isObject(existing) ? _clone(existing) : {};
+  return {
+    ..._clone(MULTI_AGENT_CONFIG_DEFAULTS),
+    ...base
+  };
+}
+
 function _buildTakeoverBaselineConfig(existing, sceVersion) {
   const base = _isObject(existing) ? _clone(existing) : {};
   return {
@@ -643,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 {
@@ -669,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)
     }
   };
@@ -749,6 +813,7 @@ async function applyTakeoverBaseline(projectPath = process.cwd(), options = {})
   const autoConfigPath = path.join(sceRoot, 'auto', 'config.json');
   const takeoverConfigPath = path.join(sceRoot, 'config', 'takeover-baseline.json');
   const errorbookRegistryPath = path.join(sceRoot, 'config', 'errorbook-registry.json');
+  const multiAgentConfigPath = path.join(sceRoot, 'config', 'multi-agent.json');
   const sessionGovernancePath = path.join(sceRoot, 'config', 'session-governance.json');
   const specDomainPolicyPath = path.join(sceRoot, 'config', 'spec-domain-policy.json');
   const problemEvalPolicyPath = path.join(sceRoot, 'config', 'problem-eval-policy.json');
@@ -762,6 +827,7 @@ async function applyTakeoverBaseline(projectPath = process.cwd(), options = {})
   const existingAuto = await _readJsonSafe(autoConfigPath, fileSystem);
   const existingTakeover = await _readJsonSafe(takeoverConfigPath, fileSystem);
   const existingErrorbookRegistry = await _readJsonSafe(errorbookRegistryPath, fileSystem);
+  const existingMultiAgentConfig = await _readJsonSafe(multiAgentConfigPath, fileSystem);
   const existingSessionGovernance = await _readJsonSafe(sessionGovernancePath, fileSystem);
   const existingSpecDomainPolicy = await _readJsonSafe(specDomainPolicyPath, fileSystem);
   const existingProblemEvalPolicy = await _readJsonSafe(problemEvalPolicyPath, fileSystem);
@@ -772,6 +838,7 @@ async function applyTakeoverBaseline(projectPath = process.cwd(), options = {})
   const desiredAutoConfig = _buildAutoConfig(existingAuto);
   const desiredTakeover = _buildTakeoverBaselineConfig(existingTakeover, sceVersion);
   const desiredErrorbookRegistry = _buildErrorbookRegistryConfig(existingErrorbookRegistry);
+  const desiredMultiAgentConfig = _buildMultiAgentConfig(existingMultiAgentConfig);
   const desiredSessionGovernance = _deepMerge(existingSessionGovernance || {}, SESSION_GOVERNANCE_DEFAULTS);
   const desiredSpecDomainPolicy = _deepMerge(existingSpecDomainPolicy || {}, SPEC_DOMAIN_POLICY_DEFAULTS);
   const desiredProblemEvalPolicy = _deepMerge(existingProblemEvalPolicy || {}, PROBLEM_EVAL_POLICY_DEFAULTS);
@@ -802,6 +869,11 @@ async function applyTakeoverBaseline(projectPath = process.cwd(), options = {})
     apply,
     fileSystem
   }));
+  fileResults.push(await _reconcileJsonFile(multiAgentConfigPath, desiredMultiAgentConfig, {
+    projectPath,
+    apply,
+    fileSystem
+  }));
   fileResults.push(await _reconcileJsonFile(sessionGovernancePath, desiredSessionGovernance, {
     projectPath,
     apply,
@@ -900,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.49",
+  "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": {
@@ -44,11 +44,13 @@
     "audit:refactor-trigger": "node scripts/refactor-trigger-audit.js",
     "audit:steering": "node scripts/steering-content-audit.js --fail-on-error",
     "audit:clarification-first": "node scripts/clarification-first-audit.js --fail-on-violation",
+    "gate:collab-governance": "node scripts/collab-governance-gate.js --fail-on-violation",
     "audit:state-storage": "node scripts/state-storage-tiering-audit.js",
     "report:release-docs": "node scripts/release-doc-version-audit.js --json",
     "report:refactor-trigger": "node scripts/refactor-trigger-audit.js --json",
     "report:steering-audit": "node scripts/steering-content-audit.js --json",
     "report:clarification-first-audit": "node scripts/clarification-first-audit.js --json",
+    "report:collab-governance": "node scripts/collab-governance-gate.js --json",
     "report:state-storage": "node scripts/state-storage-tiering-audit.js --json",
     "report:interactive-approval-projection": "node scripts/interactive-approval-event-projection.js --action doctor --json",
     "audit:interactive-approval-projection": "node scripts/interactive-approval-event-projection.js --action doctor --fail-on-drift --fail-on-parse-error",
@@ -90,7 +92,7 @@
     "gate:release-asset-integrity": "node scripts/release-asset-integrity-check.js",
     "report:release-risk-remediation": "node scripts/release-risk-remediation-bundle.js --json",
     "report:moqui-core-regression": "node scripts/moqui-core-regression-suite.js --json",
-    "prepublishOnly": "npm run test:release && npm run test:skip-audit && npm run test:sce-tracking && npm run gate:npm-runtime-assets && npm run test:brand-consistency && npm run audit:release-docs && npm run audit:steering && npm run audit:clarification-first && npm run gate:git-managed && npm run gate:errorbook-registry-health && npm run gate:errorbook-release && npm run report:interactive-governance -- --fail-on-alert",
+    "prepublishOnly": "npm run test:release && npm run test:skip-audit && npm run test:sce-tracking && npm run gate:npm-runtime-assets && npm run test:brand-consistency && npm run audit:release-docs && npm run audit:steering && npm run audit:clarification-first && npm run gate:collab-governance && npm run gate:git-managed && npm run gate:errorbook-registry-health && npm run gate:errorbook-release && npm run report:interactive-governance -- --fail-on-alert",
     "publish:manual": "npm publish --access public",
     "install-global": "npm install -g .",
     "uninstall-global": "npm uninstall -g scene-capability-engine"

package/scripts/collab-governance-gate.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+'use strict';
+
+const path = require('path');
+const { runCollabGovernanceGate } = require('../lib/workspace/collab-governance-gate');
+
+function parseArgs(argv = []) {
+  const options = {
+    projectPath: process.cwd(),
+    failOnViolation: false,
+    json: false,
+    help: false
+  };
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const token = argv[index];
+    const next = argv[index + 1];
+
+    if (token === '--project-path' && next) {
+      options.projectPath = path.resolve(next);
+      index += 1;
+    } else if (token === '--fail-on-violation') {
+      options.failOnViolation = true;
+    } else if (token === '--json') {
+      options.json = true;
+    } else if (token === '--help' || token === '-h') {
+      options.help = true;
+    }
+  }
+
+  return options;
+}
+
+function printHelp() {
+  const lines = [
+    'Usage: node scripts/collab-governance-gate.js [options]',
+    '',
+    'Options:',
+    '  --project-path <path>     Project path (default: cwd)',
+    '  --fail-on-violation       Exit with code 2 when violations exist',
+    '  --json                    Print JSON payload',
+    '  -h, --help                Show help'
+  ];
+  process.stdout.write(`${lines.join('\n')}\n`);
+}
+
+if (require.main === module) {
+  const options = parseArgs(process.argv.slice(2));
+  if (options.help) {
+    printHelp();
+    process.exit(0);
+  }
+
+  runCollabGovernanceGate(options)
+    .then((result) => {
+      process.exitCode = result.exit_code;
+    })
+    .catch((error) => {
+      const payload = {
+        mode: 'collab-governance-gate',
+        passed: false,
+        error: error.message
+      };
+      if (options.json) {
+        process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
+      } else {
+        process.stderr.write(`[collab-governance-gate] error=${error.message}\n`);
+      }
+      process.exitCode = 1;
+    });
+}
+
+module.exports = {
+  parseArgs,
+  runCollabGovernanceGate
+};

package/template/.sce/README.md

@@ -71,8 +71,8 @@ When multiple AI agents work on the same project simultaneously:
 - **SteeringFileLock** (`lib/lock`) — Steering file write serialization
 - **MergeCoordinator** (`lib/collab`) — Git branch isolation per agent
 - **Coordinator** (`lib/collab`) — Central task assignment (optional)
-- Config: `.sce/config/multi-agent.json` (`enabled: true` to activate)
-- All components are no-ops in single-agent mode (zero overhead)
+- Config: `.sce/config/multi-agent.json` (default `enabled: true`; set `enabled: false` to opt out)
+- If a project opts out with `enabled: false`, all components fall back to single-agent no-op behavior
 - See `docs/multi-agent-coordination-guide.md` for full API reference
 
 ### Spec-Level Steering & Context Sync
@@ -83,7 +83,7 @@ Fourth steering layer (L4) and Spec lifecycle coordination for multi-agent scena
 - **SpecLifecycleManager** (`lib/collab`) — Spec state machine (planned → assigned → in-progress → completed → released) with auto-completion detection
 - **SyncBarrier** (`lib/collab`) — Agent Spec-switch synchronization barrier (uncommitted changes check, steering reload)
 - **Coordinator Integration** — `completeTask` auto-checks Spec completion; `assignTask` runs SyncBarrier
-- All components are no-ops in single-agent mode (zero overhead)
+- If needed, a project can still opt out by setting `enabled: false`, which restores single-agent no-op behavior
 - See `docs/multi-agent-coordination-guide.md` for full API reference
 
 ### Autonomous Control
@@ -151,7 +151,7 @@ Look in .sce/specs/ directory
 
 ### When Working in Multi-Agent Mode
 
-If `.sce/config/multi-agent.json` exists with `enabled: true`:
+By default `.sce/config/multi-agent.json` is provisioned with `enabled: true`:
 1. Register with AgentRegistry before starting work
 2. Acquire task locks before modifying any task
 3. Use TaskStatusStore for concurrent-safe tasks.md updates
@@ -243,6 +243,6 @@ A Spec is a complete feature definition with three parts:
 ---
 
 **Project Type**: Spec-driven development  
-**sce Version**: 3.6.49  
-**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/config/multi-agent.json

@@ -0,0 +1,8 @@
+{
+  "enabled": true,
+  "heartbeatIntervalMs": 60000,
+  "heartbeatTimeoutMs": 180000,
+  "coordinatorEnabled": false,
+  "maxRetries": 5,
+  "retryBaseDelayMs": 100
+}

package/template/.sce/config/takeover-baseline.json

@@ -112,6 +112,17 @@
       "max_direct_fix_rounds_before_debug": 2,
       "forbid_bypass_workarounds": true
     },
+    "collaboration": {
+      "multi_user_mode": true,
+      "multi_agent": {
+        "enabled": true,
+        "heartbeatIntervalMs": 60000,
+        "heartbeatTimeoutMs": 180000,
+        "coordinatorEnabled": false,
+        "maxRetries": 5,
+        "retryBaseDelayMs": 100
+      }
+    },
     "migration_policy": {
       "legacy_kiro_supported": false,
       "require_manual_legacy_migration_confirmation": true

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

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