scene-capability-engine 3.6.48 → 3.6.50

package/CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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
+- Added `scripts/release-doc-version-audit.js` and wired it into package scripts, CI, release, and steering-hygiene workflows so README release metadata drift now blocks publish instead of relying on manual sync.
+- Synced `README.md`, `README.zh.md`, `.sce/README.md`, and `template/.sce/README.md` release footers to the current package version/date and removed stale hardcoded capability-version headings from long-lived project guide READMEs.
+- Added a new project-calibrated refactor trigger capability via `scripts/refactor-trigger-audit.js`, plus a matching steering baseline rule: each SCE project should periodically evaluate its own file-size distribution, while `2000 / 4000 / 10000` remains the default source-file fallback when no project-specific threshold is set.
+
 ## [3.6.48] - 2026-03-14
 
 ### Changed

package/README.md

@@ -142,7 +142,9 @@ 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.
 
 ---
@@ -216,5 +218,5 @@ MIT. See [LICENSE](LICENSE).
 
 ---
 
-**Version**: 3.6.34
-**Last Updated**: 2026-03-08
+**Version**: 3.6.50
+**Last Updated**: 2026-03-14

package/README.zh.md

@@ -147,7 +147,9 @@ 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`
 
 ---
@@ -221,5 +223,5 @@ MIT，见 [LICENSE](LICENSE)。
 
 ---
 
-**版本**：3.6.34
-**最后更新**：2026-03-08
+**版本**：3.6.50
+**最后更新**：2026-03-14

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.50
+**Last Updated**: 2026-03-14
 
 ---
 
@@ -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.50  
+**Last Updated**: 2026-03-14
 
 ---
 
@@ -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/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/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,16 @@ const BACKEND_API_PRECEDENCE_CORE_PRINCIPLE_SECTION = [
   '- 除非明确要求新建接口或修改后端接口，否则禁止为了迁就前端错误调用去随意改后端实现或契约。',
   '- 默认优先修正前端请求、映射、类型和兼容处理，使其与后端接口保持一致；若怀疑后端契约错误，应先确认再改。'
 ].join('\n');
+const LARGE_FILE_REFACTOR_CORE_PRINCIPLE_HEADING = '## 15. 单文件规模过大必须触发重构评估，禁止无限堆积';
+const LARGE_FILE_REFACTOR_CORE_PRINCIPLE_SECTION = [
+  LARGE_FILE_REFACTOR_CORE_PRINCIPLE_HEADING,
+  '',
+  '- SCE 应为每个项目定期评估代码规模分布，并给出项目级的重构参考节点；禁止假设所有项目都适用同一个固定行数阈值。',
+  '- 若项目尚未建立自己的阈值，默认参考源文件 `2000 / 4000 / 10000` 行三档触发：分别对应“必须评估”“必须发起重构收敛”“进入红线区”。',
+  '- 达到项目级或默认阈值后，后续改动必须优先评估拆分模块、服务、命令面或数据职责；超过重构/红线阈值时，不得继续无计划堆积复杂度。',
+  '- 项目开始较小时，阈值应更早触发；项目进入长期演进后，也必须按周或发布前重新评估，而不是让早期设定永久失效。',
+  '- 行数阈值只是强触发信号，不代表低于阈值就可以忽略耦合、职责混杂、测试失控和理解成本问题；若复杂度已明显失控，应提前启动重构。'
+].join('\n');
 const REQUIRED_CORE_PRINCIPLE_SECTIONS = Object.freeze([
   {
     heading: CLARIFICATION_FIRST_CORE_PRINCIPLE_HEADING,
@@ -61,6 +74,10 @@ const REQUIRED_CORE_PRINCIPLE_SECTIONS = Object.freeze([
   {
     heading: BACKEND_API_PRECEDENCE_CORE_PRINCIPLE_HEADING,
     section: BACKEND_API_PRECEDENCE_CORE_PRINCIPLE_SECTION
+  },
+  {
+    heading: LARGE_FILE_REFACTOR_CORE_PRINCIPLE_HEADING,
+    section: LARGE_FILE_REFACTOR_CORE_PRINCIPLE_SECTION
   }
 ]);
 
@@ -335,6 +352,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,
@@ -426,7 +447,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
@@ -442,6 +463,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 {
@@ -735,6 +764,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');
@@ -748,6 +778,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);
@@ -758,6 +789,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);
@@ -788,6 +820,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,
@@ -886,6 +923,8 @@ module.exports = {
   STEERING_CHANGE_EVALUATION_CORE_PRINCIPLE_SECTION,
   BACKEND_API_PRECEDENCE_CORE_PRINCIPLE_HEADING,
   BACKEND_API_PRECEDENCE_CORE_PRINCIPLE_SECTION,
+  LARGE_FILE_REFACTOR_CORE_PRINCIPLE_HEADING,
+  LARGE_FILE_REFACTOR_CORE_PRINCIPLE_SECTION,
   REQUIRED_CORE_PRINCIPLE_SECTIONS,
   ERRORBOOK_REGISTRY_DEFAULTS,
   ERRORBOOK_CONVERGENCE_DEFAULTS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scene-capability-engine",
-  "version": "3.6.48",
+  "version": "3.6.50",
   "description": "SCE (Scene Capability Engine) - A CLI tool and npm package for spec-driven development with AI coding assistants.",
   "main": "index.js",
   "bin": {
@@ -40,11 +40,17 @@
     "test:sce-tracking": "node scripts/check-sce-tracking.js",
     "gate:npm-runtime-assets": "node scripts/npm-package-runtime-asset-check.js --fail-on-violation",
     "test:brand-consistency": "node scripts/check-branding-consistency.js",
+    "audit:release-docs": "node scripts/release-doc-version-audit.js --fail-on-error",
+    "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",
@@ -86,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: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
+};