scene-capability-engine 3.6.50 → 3.6.52

package/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.6.52] - 2026-03-16
+
+### Added
+- Added `sce app runtime uninstall` with active-release protection, explicit installed-vs-active runtime projection fields, and MagicBall-facing runtime uninstall/auth documentation.
+- Extended co-work governance auditing so shared `errorbook` registry baseline and managed `errorbook_convergence` defaults are now checked alongside multi-agent/runtime-state drift.
+
+## [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

@@ -165,7 +165,7 @@ MagicBall-specific integration surfaces now also include:
 
 - `sce app bundle list|show|register`
 - `sce app registry status|configure|sync*`
-- `sce app runtime show|releases|install|activate`
+- `sce app runtime show|releases|install|activate|uninstall`
 - `sce app engineering show|attach|hydrate|activate`
 - `sce mode application|ontology|engineering home`
 - `sce pm requirement|tracking|planning|change|issue ... --json`
@@ -218,5 +218,5 @@ MIT. See [LICENSE](LICENSE).
 
 ---
 
-**Version**: 3.6.50
-**Last Updated**: 2026-03-14
+**Version**: 3.6.52
+**Last Updated**: 2026-03-16

package/README.zh.md

@@ -170,7 +170,7 @@ SCE 默认是强治理的。
 
 - `sce app bundle list|show|register`
 - `sce app registry status|configure|sync*`
-- `sce app runtime show|releases|install|activate`
+- `sce app runtime show|releases|install|activate|uninstall`
 - `sce app engineering show|attach|hydrate|activate`
 - `sce mode application|ontology|engineering home`
 - `sce pm requirement|tracking|planning|change|issue ... --json`
@@ -223,5 +223,5 @@ MIT，见 [LICENSE](LICENSE)。
 
 ---
 
-**版本**：3.6.50
-**最后更新**：2026-03-14
+**版本**：3.6.52
+**最后更新**：2026-03-16

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.52
+**Last Updated**: 2026-03-16
 
 ---
 
@@ -135,7 +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
+- `timeline push` now blocks before snapshot/push when collaboration governance drifts, so tracked runtime state, missing co-work ignore rules, missing shared `errorbook` registry baseline, invalid multi-agent config, legacy `.kiro*` references, or steering boundary drift cannot pass through managed push flow
 
 ### Value Metrics
 
@@ -393,6 +393,7 @@ sce app runtime show --app customer-order-demo --json
 sce app runtime releases --app customer-order-demo --json
 sce app runtime install --app customer-order-demo --release <release-id> --json
 sce app runtime activate --app customer-order-demo --release <release-id> --json
+sce app runtime uninstall --app customer-order-demo --release <release-id> --json
 
 # Engineering projection
 sce app engineering show --app customer-order-demo --json

package/docs/magicball-adaptation-task-checklist-v1.md

@@ -70,6 +70,8 @@ Important fields:
 - `summary.app_name`
 - `summary.runtime_version`
 - `summary.install_status`
+- `summary.installed_release_id`
+- `summary.active_release_id`
 - `summary.release_count`
 - `view_model.current_release`
 - `view_model.entrypoint`
@@ -84,6 +86,7 @@ sce app runtime releases --app customer-order-demo --json
 Expected UI:
 - release table/list
 - active/default release marker
+- installed marker
 - runtime version
 - release status
 - entrypoint
@@ -113,6 +116,19 @@ Done when:
 - active release changes in UI
 - `mode application home` reflects the new active release after refresh
 
+### Task 2.5
+Wire uninstall action for installed-but-not-active release.
+
+Command:
+```bash
+sce app runtime uninstall --app customer-order-demo --release <release-id> --json
+```
+
+Done when:
+- uninstall button is shown only for installed and non-active release
+- uninstall removes local installed state after refresh
+- the same release can be installed again through existing install flow
+
 ## Phase 3: Ontology Mode
 
 ### Task 3.1
@@ -288,6 +304,7 @@ Commands that matter now:
 - `sce app engineering activate`
 - `sce app runtime install`
 - `sce app runtime activate`
+- `sce app runtime uninstall`
 - `sce pm * upsert`
 - `sce ontology * upsert`
 
@@ -371,7 +388,7 @@ MagicBall can be considered adapted to the current SCE version when:
 4. Ontology Mode reads `sce ontology *`
 5. Assurance tabs read `sce assurance *`
 6. write actions pass `--auth-lease`
-7. install / activate / attach / hydrate actions work from the UI
+7. install / activate / uninstall / attach / hydrate actions work from the UI
 
 ## Practical Conclusion
 

package/docs/magicball-cli-invocation-examples.md

@@ -55,6 +55,8 @@ Typical fields MagicBall cares about:
 - `summary.app_name`
 - `summary.runtime_version`
 - `summary.install_status`
+- `summary.installed_release_id`
+- `summary.active_release_id`
 - `summary.release_count`
 - `view_model.current_release`
 
@@ -73,6 +75,11 @@ sce app runtime install --app customer-order-demo --release rel-2026-03 --json
 sce app runtime activate --app customer-order-demo --release rel-2026-03 --json
 ```
 
+### 2.5 Uninstall a non-active installed release
+```bash
+sce app runtime uninstall --app customer-order-demo --release rel-2026-03 --json
+```
+
 ## 3. Ontology Mode Examples
 
 ### 3.1 Read ontology home

package/docs/magicball-integration-issue-tracker.md

@@ -22,7 +22,7 @@ SCE changes completed and now available for MagicBall:
 - `mode ontology home --app ... --json`
 - `mode engineering home --app ... --json`
 - `app registry status/configure/sync*`
-- `app runtime show/releases/install/activate`
+- `app runtime show/releases/install/activate/uninstall`
 - `app engineering show/attach/hydrate/activate`
 - `pm requirement/tracking/planning/change/issue` data plane
 - `ontology er/br/dl` + `ontology triad summary`
@@ -33,7 +33,7 @@ SCE changes completed and now available for MagicBall:
 ### Current recommended MagicBall consumption order
 1. consume `mode * home` as the top-level source for the three modes
 2. consume `pm`, `ontology`, and `assurance` table payloads
-3. wire runtime install/activate and engineering attach/hydrate/activate actions
+3. wire runtime install/activate/uninstall and engineering attach/hydrate/activate actions
 4. use demo app: `customer-order-demo`
 
 ### Related SCE docs

package/docs/magicball-sce-adaptation-guide.md

@@ -25,7 +25,7 @@ Use these documents together:
 SCE currently provides MagicBall-facing support for:
 1. `app bundle registry`
 2. `application / ontology / engineering home projections`
-3. `app runtime install / activate`
+3. `app runtime install / activate / uninstall`
 4. `app engineering attach / hydrate / activate`
 5. `pm` delivery data plane
 6. `ontology` triad data plane
@@ -100,7 +100,7 @@ Use `docs/magicball-cli-invocation-examples.md` for copy-ready commands.
 - `sce app engineering show`
 
 ### Runtime and engineering control
-- `sce app runtime show/releases/install/activate`
+- `sce app runtime show/releases/install/activate/uninstall`
 - `sce app engineering show/attach/hydrate/activate`
 - `sce app registry status/configure/sync*`
 

package/docs/magicball-write-auth-adaptation-guide.md

@@ -67,6 +67,7 @@ Current implemented write flows in SCE imply these practical action families:
 - `app:engineering:activate`
 - `app:runtime:install`
 - `app:runtime:activate`
+- `app:runtime:uninstall`
 
 ### Engineering mode PM data plane
 - `pm:requirement:upsert`
@@ -176,6 +177,7 @@ Recommended UI steps:
 | Activate engineering workspace | `sce app engineering activate` | `app:engineering:activate` |
 | Install runtime release | `sce app runtime install` | `app:runtime:install` |
 | Activate runtime release | `sce app runtime activate` | `app:runtime:activate` |
+| Uninstall runtime release | `sce app runtime uninstall` | `app:runtime:uninstall` |
 | Save requirement | `sce pm requirement upsert` | `pm:requirement:upsert` |
 | Save tracking item | `sce pm tracking upsert` | `pm:tracking:upsert` |
 | Save plan | `sce pm planning upsert` | `pm:planning:upsert` |
@@ -196,6 +198,11 @@ Recommended UI steps:
 sce auth grant --scope app:runtime:activate --reason "activate selected runtime release" --json
 ```
 
+### Runtime uninstall lease
+```bash
+sce auth grant --scope app:runtime:uninstall --reason "remove non-active installed runtime release" --json
+```
+
 ### Multiple scopes if one workflow batches mutations
 ```bash
 sce auth grant --scope app:engineering:attach,app:engineering:hydrate,app:engineering:activate --reason "initialize engineering workspace" --json

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.52  
+**Last Updated**: 2026-03-16
 
 ---
 

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/releases/v3.6.52.md

@@ -0,0 +1,20 @@
+# v3.6.52 Release Notes
+
+Release date: 2026-03-16
+
+## Highlights
+
+- Added `sce app runtime uninstall` so MagicBall and CLI users can remove a non-active installed runtime release without editing local SCE state by hand.
+- Split runtime projection semantics so installed release and active release are exposed separately in runtime/app-home payloads.
+- Extended co-work governance auditing to enforce shared `errorbook` registry availability and managed `errorbook_convergence` defaults as part of the default collaboration baseline.
+
+## Validation
+
+- `npx jest tests/unit/commands/app-mode.test.js --runInBand`
+- `npx jest tests/unit/workspace/collab-governance-audit.test.js tests/unit/scripts/collab-governance-gate.test.js --runInBand`
+- `node scripts/collab-governance-gate.js --json`
+
+## Release Notes
+
+- This patch closes two integration gaps: MagicBall can now offer uninstall/reinstall flows cleanly, and co-work governance now treats shared failure-learning resources as a real default baseline instead of a merely available optional capability.
+- The runtime model is still a single-installation-slot design; multiple release selection is supported, but multiple local installed runtime versions per app are not introduced in this patch.

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/docs/zh/releases/v3.6.52.md

@@ -0,0 +1,20 @@
+# v3.6.52 发布说明
+
+发布日期：2026-03-16
+
+## 重点变化
+
+- 新增 `sce app runtime uninstall`，MagicBall 和 CLI 现在都可以在不手改本地状态的前提下卸载“已安装但未激活”的运行时版本。
+- 运行时投影语义已拆分为“已安装版本”和“当前激活版本”，前端不再需要自行猜测 installed / active 状态。
+- co-work 治理审计已扩展为默认检查共享 `errorbook` registry 是否可用，以及 managed 项目的 `errorbook_convergence` 基线是否漂移。
+
+## 验证
+
+- `npx jest tests/unit/commands/app-mode.test.js --runInBand`
+- `npx jest tests/unit/workspace/collab-governance-audit.test.js tests/unit/scripts/collab-governance-gate.test.js --runInBand`
+- `node scripts/collab-governance-gate.js --json`
+
+## 发布说明
+
+- 这个补丁版补上了两个真实缺口：一是 MagicBall 运行时版本管理终于具备卸载/重装闭环，二是 co-work 默认协作基线开始真正把共享错题经验资源视为必备能力，而不是“仓库里有这个功能就算支持”。
+- 当前运行时仍然是“单安装槽位”模型；本次支持多版本选择，但不引入同一 app 多个本地安装版本并存。

package/lib/commands/app.js

@@ -89,17 +89,77 @@ function buildBundleSummary(graph = {}) {
   };
 }
 
-function buildRuntimeSummary(graph = {}) {
+function getRuntimeProjectionState(graph = {}) {
   const bundle = graph.bundle || {};
   const runtimeRelease = graph.runtime_release || {};
   const metadata = bundle.metadata && typeof bundle.metadata === 'object' ? bundle.metadata : {};
   const installation = metadata.runtime_installation && typeof metadata.runtime_installation === 'object'
     ? metadata.runtime_installation
     : {};
+  const runtimeActivation = metadata.runtime_activation && typeof metadata.runtime_activation === 'object'
+    ? metadata.runtime_activation
+    : {};
   const serviceCatalog = metadata.service_catalog && typeof metadata.service_catalog === 'object'
     ? metadata.service_catalog
     : {};
   const releases = Array.isArray(serviceCatalog.releases) ? serviceCatalog.releases : [];
+  const installStatus = normalizeString(installation.status) || 'not-installed';
+  const installedReleaseId = installStatus === 'installed'
+    ? (normalizeString(installation.release_id) || null)
+    : null;
+  const activeReleaseId = normalizeString(
+    bundle.runtime_release_id
+    || runtimeRelease.release_id
+    || runtimeActivation.active_release_id
+  ) || null;
+
+  return {
+    metadata,
+    installation,
+    runtimeActivation,
+    serviceCatalog,
+    releases,
+    installStatus,
+    installedReleaseId,
+    activeReleaseId
+  };
+}
+
+function buildRuntimeReleaseItems(graph = {}) {
+  const state = getRuntimeProjectionState(graph);
+  return state.releases.map((item) => {
+    const releaseId = normalizeString(item && item.release_id) || null;
+    const installed = Boolean(releaseId && state.installedReleaseId && releaseId === state.installedReleaseId);
+    const active = Boolean(releaseId && state.activeReleaseId && releaseId === state.activeReleaseId);
+    const availableActions = [];
+
+    if (!installed) {
+      availableActions.push('install');
+    }
+    if (!active) {
+      availableActions.push('activate');
+    }
+    if (installed && !active) {
+      availableActions.push('uninstall');
+    }
+
+    return {
+      ...item,
+      installed,
+      active,
+      installation_status: installed ? state.installStatus : 'not-installed',
+      can_install: !installed,
+      can_activate: !active,
+      can_uninstall: installed && !active,
+      available_actions: availableActions
+    };
+  });
+}
+
+function buildRuntimeSummary(graph = {}) {
+  const bundle = graph.bundle || {};
+  const runtimeRelease = graph.runtime_release || {};
+  const state = getRuntimeProjectionState(graph);
   return {
     app_id: bundle.app_id || null,
     app_name: bundle.app_name || null,
@@ -107,10 +167,11 @@ function buildRuntimeSummary(graph = {}) {
     runtime_version: runtimeRelease.runtime_version || null,
     release_status: runtimeRelease.release_status || null,
     runtime_status: runtimeRelease.runtime_status || null,
-    install_status: installation.status || 'not-installed',
-    install_root: installation.install_root || null,
-    release_count: releases.length,
-    active_release_id: installation.release_id || bundle.runtime_release_id || runtimeRelease.release_id || null
+    install_status: state.installStatus,
+    install_root: state.installation.install_root || null,
+    release_count: state.releases.length,
+    installed_release_id: state.installedReleaseId,
+    active_release_id: state.activeReleaseId
   };
 }
 
@@ -564,8 +625,7 @@ async function runAppRuntimeShowCommand(options = {}, dependencies = {}) {
     throw new Error('--app is required');
   }
   const { graph } = await requireAppGraph(appRef, dependencies);
-  const metadata = graph.bundle && graph.bundle.metadata && typeof graph.bundle.metadata === 'object' ? graph.bundle.metadata : {};
-  const serviceCatalog = metadata.service_catalog && typeof metadata.service_catalog === 'object' ? metadata.service_catalog : {};
+  const state = getRuntimeProjectionState(graph);
   const payload = {
     mode: 'app-runtime-show',
     generated_at: new Date().toISOString(),
@@ -575,12 +635,14 @@ async function runAppRuntimeShowCommand(options = {}, dependencies = {}) {
     summary: buildRuntimeSummary(graph),
     bundle: graph.bundle,
     runtime_release: graph.runtime_release,
-    runtime_installation: metadata.runtime_installation || null,
+    runtime_installation: Object.keys(state.installation).length > 0 ? state.installation : null,
+    runtime_activation: Object.keys(state.runtimeActivation).length > 0 ? state.runtimeActivation : null,
     service_catalog: {
-      default_release_id: serviceCatalog.default_release_id || null,
-      release_count: Array.isArray(serviceCatalog.releases) ? serviceCatalog.releases.length : 0,
-      source: serviceCatalog.source || null
-    }
+      default_release_id: state.serviceCatalog.default_release_id || null,
+      release_count: state.releases.length,
+      source: state.serviceCatalog.source || null
+    },
+    releases: buildRuntimeReleaseItems(graph)
   };
   printPayload(payload, options, 'App Runtime Show');
   return payload;
@@ -592,9 +654,8 @@ async function runAppRuntimeReleasesCommand(options = {}, dependencies = {}) {
     throw new Error('--app is required');
   }
   const { graph } = await requireAppGraph(appRef, dependencies);
-  const metadata = graph.bundle && graph.bundle.metadata && typeof graph.bundle.metadata === 'object' ? graph.bundle.metadata : {};
-  const serviceCatalog = metadata.service_catalog && typeof metadata.service_catalog === 'object' ? metadata.service_catalog : {};
-  const releases = Array.isArray(serviceCatalog.releases) ? serviceCatalog.releases : [];
+  const state = getRuntimeProjectionState(graph);
+  const releases = buildRuntimeReleaseItems(graph);
   const payload = {
     mode: 'app-runtime-releases',
     generated_at: new Date().toISOString(),
@@ -603,12 +664,14 @@ async function runAppRuntimeReleasesCommand(options = {}, dependencies = {}) {
     },
     summary: {
       total: releases.length,
-      default_release_id: serviceCatalog.default_release_id || null
+      default_release_id: state.serviceCatalog.default_release_id || null,
+      installed_release_id: state.installedReleaseId,
+      active_release_id: state.activeReleaseId
     },
     items: releases,
     view_model: {
       type: 'table',
-      columns: ['release_id', 'runtime_version', 'release_channel', 'release_status', 'runtime_status', 'published_at']
+      columns: ['release_id', 'runtime_version', 'release_channel', 'release_status', 'runtime_status', 'installed', 'active', 'published_at']
     },
     mb_status: graph.runtime_release && graph.runtime_release.runtime_status ? graph.runtime_release.runtime_status : (graph.bundle && graph.bundle.status ? graph.bundle.status : 'unknown')
   };
@@ -704,6 +767,58 @@ async function runAppRuntimeActivateCommand(options = {}, dependencies = {}) {
   return payload;
 }
 
+async function runAppRuntimeUninstallCommand(options = {}, dependencies = {}) {
+  const appRef = normalizeString(options.app);
+  if (!appRef) {
+    throw new Error('--app is required');
+  }
+  await ensureAuthorized('app:runtime:uninstall', options, dependencies);
+  const fileSystem = dependencies.fileSystem || fs;
+  const { store, graph } = await requireAppGraph(appRef, dependencies);
+  const nextPayload = graphToRegisterPayload(graph);
+  const state = getRuntimeProjectionState(graph);
+  const installedReleaseId = state.installedReleaseId;
+  const targetReleaseId = normalizeString(options.release) || installedReleaseId;
+
+  if (!installedReleaseId) {
+    throw new Error('no installed runtime release found for this app');
+  }
+  if (!targetReleaseId || targetReleaseId !== installedReleaseId) {
+    throw new Error(`runtime release is not installed: ${targetReleaseId || '<unknown>'}`);
+  }
+  if (state.activeReleaseId && targetReleaseId === state.activeReleaseId) {
+    throw new Error(`cannot uninstall active runtime release ${targetReleaseId}; activate another release first`);
+  }
+
+  const installRoot = normalizeString(state.installation.install_root);
+  if (installRoot) {
+    await fileSystem.remove(installRoot);
+  }
+
+  nextPayload.metadata = nextPayload.metadata || {};
+  nextPayload.metadata.runtime_installation = {
+    status: 'not-installed',
+    release_id: null,
+    install_root: null,
+    uninstalled_at: new Date().toISOString(),
+    source: 'sce app runtime uninstall',
+    previous_release_id: targetReleaseId
+  };
+
+  const updated = await store.registerAppBundle(nextPayload);
+  const updatedState = getRuntimeProjectionState(updated);
+  const payload = {
+    mode: 'app-runtime-uninstall',
+    success: true,
+    summary: buildRuntimeSummary(updated),
+    uninstalled_release_id: targetReleaseId,
+    removed_install_root: installRoot || null,
+    runtime_installation: updatedState.installation
+  };
+  printPayload(payload, options, 'App Runtime Uninstall');
+  return payload;
+}
+
 function safeRun(handler, options = {}, context = 'app command') {
   Promise.resolve(handler(options))
     .catch((error) => {
@@ -839,6 +954,17 @@ function registerAppCommands(program) {
     .option('--json', 'Print machine-readable JSON output')
     .action((options) => safeRun(runAppRuntimeActivateCommand, options, 'app runtime activate'));
 
+  runtime
+    .command('uninstall')
+    .description('Uninstall runtime release for one app bundle')
+    .requiredOption('--app <app-id-or-key>', 'App id or app key')
+    .option('--release <release-id>', 'Installed runtime release id')
+    .option('--auth-lease <lease-id>', 'Write authorization lease id')
+    .option('--auth-password <password>', 'Inline auth password if policy allows')
+    .option('--actor <actor>', 'Audit actor override')
+    .option('--json', 'Print machine-readable JSON output')
+    .action((options) => safeRun(runAppRuntimeUninstallCommand, options, 'app runtime uninstall'));
+
   const engineering = app
     .command('engineering')
     .description('Manage engineering project projection for one app bundle');
@@ -903,6 +1029,7 @@ module.exports = {
   runAppRuntimeReleasesCommand,
   runAppRuntimeInstallCommand,
   runAppRuntimeActivateCommand,
+  runAppRuntimeUninstallCommand,
   runAppEngineeringShowCommand,
   runAppEngineeringAttachCommand,
   runAppEngineeringHydrateCommand,

package/lib/commands/mode.js

@@ -37,18 +37,44 @@ function isFreshProjectionCache(cacheRecord, ttlSeconds) {
   return (Date.now() - generatedAt) <= maxAgeMs;
 }
 
-async function buildApplicationHome(graph = {}, dependencies = {}) {
+function getRuntimeProjectionState(graph = {}) {
   const bundle = graph.bundle || {};
   const runtimeRelease = graph.runtime_release || {};
-  const sceneBindings = Array.isArray(graph.scene_bindings) ? graph.scene_bindings : [];
   const metadata = bundle.metadata && typeof bundle.metadata === 'object' ? bundle.metadata : {};
   const installation = metadata.runtime_installation && typeof metadata.runtime_installation === 'object'
     ? metadata.runtime_installation
     : {};
+  const runtimeActivation = metadata.runtime_activation && typeof metadata.runtime_activation === 'object'
+    ? metadata.runtime_activation
+    : {};
   const serviceCatalog = metadata.service_catalog && typeof metadata.service_catalog === 'object'
     ? metadata.service_catalog
     : {};
   const releases = Array.isArray(serviceCatalog.releases) ? serviceCatalog.releases : [];
+  const installStatus = normalizeString(installation.status) || 'not-installed';
+  const installedReleaseId = installStatus === 'installed'
+    ? (normalizeString(installation.release_id) || null)
+    : null;
+  const activeReleaseId = normalizeString(
+    bundle.runtime_release_id
+    || runtimeRelease.release_id
+    || runtimeActivation.active_release_id
+  ) || null;
+
+  return {
+    installation,
+    releases,
+    installStatus,
+    installedReleaseId,
+    activeReleaseId
+  };
+}
+
+async function buildApplicationHome(graph = {}, dependencies = {}) {
+  const bundle = graph.bundle || {};
+  const runtimeRelease = graph.runtime_release || {};
+  const sceneBindings = Array.isArray(graph.scene_bindings) ? graph.scene_bindings : [];
+  const state = getRuntimeProjectionState(graph);
   return {
     mode: 'application-home',
     query: {
@@ -60,8 +86,10 @@ async function buildApplicationHome(graph = {}, dependencies = {}) {
       environment: bundle.environment || null,
       release_status: runtimeRelease.release_status || null,
       runtime_status: runtimeRelease.runtime_status || null,
-      install_status: installation.status || 'not-installed',
-      release_count: releases.length
+      install_status: state.installStatus,
+      installed_release_id: state.installedReleaseId,
+      active_release_id: state.activeReleaseId,
+      release_count: state.releases.length
     },
     relations: {
       runtime_release_id: bundle.runtime_release_id || null,
@@ -69,20 +97,22 @@ async function buildApplicationHome(graph = {}, dependencies = {}) {
       engineering_project_id: bundle.engineering_project_id || null,
       default_scene_id: bundle.default_scene_id || null
     },
-    items: releases,
+    items: state.releases,
     view_model: {
       projection: 'application',
       app_id: bundle.app_id || null,
       app_key: bundle.app_key || null,
       app_name: bundle.app_name || null,
       entrypoint: runtimeRelease.entrypoint || null,
-      current_release: installation.release_id || runtimeRelease.release_id || null,
-      current_environment: bundle.environment || installation.current_environment || null,
-      install_root: installation.install_root || null,
+      current_release: state.activeReleaseId,
+      installed_release_id: state.installedReleaseId,
+      active_release_id: state.activeReleaseId,
+      current_environment: bundle.environment || state.installation.current_environment || null,
+      install_root: state.installation.install_root || null,
       scene_binding_count: sceneBindings.length,
-      release_count: releases.length
+      release_count: state.releases.length
     },
-    mb_status: runtimeRelease.runtime_status || installation.status || bundle.status || 'unknown'
+    mb_status: runtimeRelease.runtime_status || state.installStatus || bundle.status || 'unknown'
   };
 }
 

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

@@ -50,6 +50,8 @@ const ACTIVE_TEXT_SCAN_EXCLUDES = Object.freeze([
 
 const LEGACY_REFERENCE_REGEX = /\.kiro(?:[\\/]|-workspaces\b)/;
 const MULTI_AGENT_CONFIG_REFERENCE = '.sce/config/multi-agent.json';
+const ERRORBOOK_REGISTRY_CONFIG_PATH = '.sce/config/errorbook-registry.json';
+const ADOPTION_CONFIG_PATH = '.sce/adoption-config.json';
 
 const REQUIRED_GITIGNORE_RULES = Object.freeze([
   { rule: '.sce/steering/CURRENT_CONTEXT.md', sample: '.sce/steering/CURRENT_CONTEXT.md' },
@@ -377,6 +379,159 @@ function validateMultiAgentConfig(payload) {
   return violations;
 }
 
+function validateErrorbookRegistryConfig(payload) {
+  const violations = [];
+  if (!payload || typeof payload !== 'object' || Array.isArray(payload)) {
+    violations.push('errorbook registry config must be a JSON object');
+    return violations;
+  }
+
+  if (typeof payload.enabled !== 'boolean') {
+    violations.push('errorbook registry config must declare boolean field "enabled"');
+  } else if (payload.enabled !== true) {
+    violations.push('errorbook registry config must keep "enabled" set to true under co-work baseline');
+  }
+
+  if (typeof payload.cache_file !== 'string' || !payload.cache_file.trim()) {
+    violations.push('errorbook registry config must declare non-empty field "cache_file"');
+  }
+
+  const sources = Array.isArray(payload.sources) ? payload.sources : [];
+  if (sources.length === 0) {
+    violations.push('errorbook registry config must declare at least one registry source');
+    return violations;
+  }
+
+  const enabledSources = sources.filter((item) => {
+    if (!item || typeof item !== 'object' || Array.isArray(item)) {
+      return false;
+    }
+    const enabled = item.enabled !== false;
+    const url = typeof item.url === 'string' ? item.url.trim() : '';
+    return enabled && Boolean(url);
+  });
+
+  if (enabledSources.length === 0) {
+    violations.push('errorbook registry config must keep at least one enabled source with a non-empty "url"');
+  }
+
+  return violations;
+}
+
+async function inspectErrorbookRegistry(projectRoot, options = {}, dependencies = {}) {
+  const fileSystem = dependencies.fileSystem || fs;
+  const configPath = path.join(projectRoot, '.sce', 'config', 'errorbook-registry.json');
+  const exists = await fileSystem.pathExists(configPath);
+  const report = {
+    file: ERRORBOOK_REGISTRY_CONFIG_PATH,
+    exists,
+    valid: false,
+    enabled: null,
+    enabled_source_count: 0,
+    warnings: [],
+    violations: [],
+    passed: true,
+    reason: 'passed'
+  };
+
+  if (!exists) {
+    report.passed = false;
+    report.reason = 'missing-config';
+    report.violations.push('shared errorbook registry config is missing');
+    return report;
+  }
+
+  let payload;
+  try {
+    payload = await fileSystem.readJson(configPath);
+  } catch (error) {
+    report.passed = false;
+    report.reason = 'invalid-json';
+    report.violations.push(`invalid errorbook registry config: ${error.message}`);
+    return report;
+  }
+
+  const validationErrors = validateErrorbookRegistryConfig(payload);
+  report.valid = validationErrors.length === 0;
+  report.enabled = typeof payload.enabled === 'boolean' ? payload.enabled : null;
+  report.enabled_source_count = Array.isArray(payload.sources)
+    ? payload.sources.filter((item) => item && typeof item === 'object' && item.enabled !== false && typeof item.url === 'string' && item.url.trim()).length
+    : 0;
+
+  if (validationErrors.length > 0) {
+    report.passed = false;
+    report.reason = 'invalid-config';
+    report.violations.push(...validationErrors);
+    return report;
+  }
+
+  return report;
+}
+
+async function inspectErrorbookConvergence(projectRoot, options = {}, dependencies = {}) {
+  const fileSystem = dependencies.fileSystem || fs;
+  const configPath = path.join(projectRoot, '.sce', 'adoption-config.json');
+  const exists = await fileSystem.pathExists(configPath);
+  const report = {
+    file: ADOPTION_CONFIG_PATH,
+    exists,
+    managed_project: exists,
+    warnings: [],
+    violations: [],
+    passed: true,
+    reason: exists ? 'passed' : 'not-managed'
+  };
+
+  if (!exists) {
+    return report;
+  }
+
+  let payload;
+  try {
+    payload = await fileSystem.readJson(configPath);
+  } catch (error) {
+    report.passed = false;
+    report.reason = 'invalid-json';
+    report.violations.push(`invalid adoption config: ${error.message}`);
+    return report;
+  }
+
+  const convergence = payload
+    && payload.defaults
+    && payload.defaults.errorbook_convergence
+    && typeof payload.defaults.errorbook_convergence === 'object'
+    && !Array.isArray(payload.defaults.errorbook_convergence)
+    ? payload.defaults.errorbook_convergence
+    : null;
+
+  if (!convergence) {
+    report.passed = false;
+    report.reason = 'missing-convergence';
+    report.violations.push('managed adoption baseline is missing defaults.errorbook_convergence');
+    return report;
+  }
+
+  if (convergence.enabled !== true) {
+    report.violations.push('managed adoption baseline must keep errorbook_convergence.enabled=true');
+  }
+  if (convergence.canonical_mechanism !== 'errorbook') {
+    report.violations.push('managed adoption baseline must keep errorbook_convergence.canonical_mechanism=errorbook');
+  }
+  if (convergence.disallow_parallel_mechanisms !== true) {
+    report.violations.push('managed adoption baseline must keep errorbook_convergence.disallow_parallel_mechanisms=true');
+  }
+  if (convergence.strategy !== 'absorb_into_sce_errorbook') {
+    report.violations.push('managed adoption baseline must keep errorbook_convergence.strategy=absorb_into_sce_errorbook');
+  }
+
+  if (report.violations.length > 0) {
+    report.passed = false;
+    report.reason = 'convergence-drift';
+  }
+
+  return report;
+}
+
 async function inspectMultiAgentConfig(projectRoot, scanResult, options = {}, dependencies = {}) {
   const fileSystem = dependencies.fileSystem || fs;
   const configPath = path.join(projectRoot, '.sce', 'config', 'multi-agent.json');
@@ -497,6 +652,8 @@ async function auditCollabGovernance(projectRoot = process.cwd(), options = {},
   const runtimeTracking = inspectRuntimeTracking(gitSnapshot);
   const scanResult = await scanActiveTextReferences(projectRoot, gitSnapshot.tracked_files, options, dependencies);
   const multiAgent = await inspectMultiAgentConfig(projectRoot, scanResult, options, dependencies);
+  const errorbookRegistry = await inspectErrorbookRegistry(projectRoot, options, dependencies);
+  const errorbookConvergence = await inspectErrorbookConvergence(projectRoot, options, dependencies);
   const steeringBoundary = inspectSteeringBoundary(projectRoot);
 
   const legacyReferences = {
@@ -521,6 +678,8 @@ async function auditCollabGovernance(projectRoot = process.cwd(), options = {},
     gitignore,
     runtime_tracking: runtimeTracking,
     multi_agent: multiAgent,
+    errorbook_registry: errorbookRegistry,
+    errorbook_convergence: errorbookConvergence,
     legacy_references: legacyReferences,
     steering_boundary: steeringBoundary,
     summary: {
@@ -528,6 +687,8 @@ async function auditCollabGovernance(projectRoot = process.cwd(), options = {},
       tracked_runtime_files: runtimeTracking.tracked_runtime_files.length,
       multi_agent_warnings: multiAgent.warnings.length,
       multi_agent_violations: multiAgent.violations.length,
+      errorbook_registry_violations: errorbookRegistry.violations.length,
+      errorbook_convergence_violations: errorbookConvergence.violations.length,
       legacy_reference_count: legacyReferences.matches.length,
       steering_boundary_violations: steeringBoundary.violations.length
     },
@@ -541,12 +702,16 @@ async function auditCollabGovernance(projectRoot = process.cwd(), options = {},
   report.warnings.push(...(gitSnapshot.available === true ? gitSnapshot.warnings : []));
   report.warnings.push(...runtimeTracking.warnings);
   report.warnings.push(...multiAgent.warnings);
+  report.warnings.push(...errorbookRegistry.warnings);
+  report.warnings.push(...errorbookConvergence.warnings);
   report.warnings.push(...legacyReferences.warnings);
   report.warnings.push(...steeringBoundary.warnings);
 
   report.violations.push(...gitignore.violations);
   report.violations.push(...runtimeTracking.violations);
   report.violations.push(...multiAgent.violations);
+  report.violations.push(...errorbookRegistry.violations);
+  report.violations.push(...errorbookConvergence.violations);
   report.violations.push(...legacyReferences.violations);
   report.violations.push(
     ...steeringBoundary.violations.map((item) => `steering boundary violation: ${item.path || item.name}`)
@@ -568,8 +733,11 @@ module.exports = {
   RUNTIME_TRACKED_PATTERNS,
   auditCollabGovernance,
   inspectGitignore,
+  inspectErrorbookConvergence,
+  inspectErrorbookRegistry,
   inspectMultiAgentConfig,
   inspectRuntimeTracking,
   scanActiveTextReferences,
+  validateErrorbookRegistryConfig,
   validateMultiAgentConfig
 };

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.52",
   "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.52  
+**Last Updated**: 2026-03-16  
 **Purpose**: Guide AI tools to work effectively with this project

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

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