scene-capability-engine 3.6.52 → 3.6.54

package/CHANGELOG.md

@@ -7,6 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.6.54] - 2026-03-16
+
+### Added
+- Added a tracked project-shared problem projection at `.sce/knowledge/problem/project-shared-problems.json`, derived from existing spec problem artifacts and seeded by default through template/takeover baselines.
+
+### Changed
+- Managed co-work gate now refreshes the project-shared problem projection before collaboration governance audit, so another computer can recover active/stale project problem facts through normal Git sync without asking for a separate local problem-library sync step.
+- Collaboration governance auditing now treats project-shared problem projection drift as a violation alongside errorbook and multi-agent baseline drift.
+
+## [3.6.53] - 2026-03-16
+
+### Added
+- Added a tracked project-shared high-value errorbook projection at `.sce/knowledge/errorbook/project-shared-registry.json`, seeded by default in template/takeover baselines so same-project work on another computer can recover curated `verified` and `promoted` knowledge through Git without committing raw `.sce/errorbook/**`.
+
+### Changed
+- Errorbook mutation commands now auto-refresh the tracked project-shared projection, and registry-inclusive lookup can search that local file in `remote` mode without requiring an index.
+- Co-work governance auditing now treats the project-shared errorbook projection as a required closure artifact: config must stay enabled, the project-shared source must exist, the projection file must parse, and it must be Git-tracked.
+
 ## [3.6.52] - 2026-03-16
 
 ### Added

package/README.md

@@ -218,5 +218,5 @@ MIT. See [LICENSE](LICENSE).
 
 ---
 
-**Version**: 3.6.52
+**Version**: 3.6.54
 **Last Updated**: 2026-03-16

package/README.zh.md

@@ -223,5 +223,5 @@ MIT，见 [LICENSE](LICENSE)。
 
 ---
 
-**版本**：3.6.52
+**版本**：3.6.54
 **最后更新**：2026-03-16

package/docs/command-reference.md

@@ -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, missing shared `errorbook` registry baseline, invalid multi-agent config, legacy `.kiro*` references, or steering boundary drift cannot pass through managed push flow
+- `timeline push` now refreshes the tracked project-shared problem projection before governance audit, then blocks before snapshot/push when collaboration governance drifts, so tracked runtime state, missing co-work ignore rules, missing shared `errorbook` registry baseline, missing tracked project-shared errorbook/problem projections, invalid multi-agent config, legacy `.kiro*` references, or steering boundary drift cannot pass through managed push flow
 
 ### Value Metrics
 
@@ -348,7 +348,7 @@ sce workspace legacy-migrate --dry-run --json
 sce workspace tracking-audit
 sce workspace tracking-audit --json
 
-# Audit collaboration governance boundaries and legacy naming drift
+# Audit collaboration governance boundaries, shared errorbook closure, and legacy naming drift
 sce workspace collab-governance-audit
 sce workspace collab-governance-audit --json
 sce workspace collab-governance-audit --strict
@@ -638,8 +638,10 @@ Curated quality policy (`宁缺毋滥，优胜略汰`) defaults:
   - missing exit/cleanup/deadline metadata
   - expired mitigation deadline
 - `export` outputs a machine-readable registry bundle from curated local entries (recommended default: `promoted`, `quality>=75`).
+- managed same-project sharing now uses a tracked projection file at `.sce/knowledge/errorbook/project-shared-registry.json`, refreshed automatically after `record`, `promote`, `deprecate`, and `requalify`
 - `sync-registry` pulls external registry JSON into local cache (`.sce/errorbook/registry-cache.json`) for unified `find` retrieval.
 - `find --include-registry --registry-mode remote` supports direct remote query for large registries (no full local sync required).
+- registry-inclusive lookup can also search the tracked project-shared local file in `remote` mode without a shard index.
 - Recommended for large registries: maintain a remote index file (`registry/errorbook-registry.index.json`) and shard files, then provide `index_url` in registry config.
 - Since `v3.3.23`, `sce init` / `sce adopt` default baseline includes enabled central registry config in `.sce/config/errorbook-registry.json`.
 - `health-registry` validates config readability, source/index accessibility, and index-to-shard resolution before release.
@@ -789,6 +791,11 @@ Studio gate execution defaults:
 Problem closure gate (default policy):
 - Script: `node scripts/problem-closure-gate.js`
 - Policy file: `.sce/config/problem-closure-policy.json` (auto-provisioned by `init/adopt/takeover`)
+- Shared problem projection:
+  - config field: `project_shared_projection`
+  - tracked file: `.sce/knowledge/problem/project-shared-problems.json`
+  - default scope: `non_completed`
+  - managed co-work gate refreshes this file automatically before governance audit/push/publish
 - Checks:
   - verify stage: `problem-contract` + spec domain validation + domain coverage
   - release stage: verify checks + verify report pass signal + governance high-alert block (configurable)

package/docs/errorbook-registry.md

@@ -72,12 +72,23 @@ Create `.sce/config/errorbook-registry.json`:
   "enabled": true,
   "search_mode": "remote",
   "cache_file": ".sce/errorbook/registry-cache.json",
+  "project_shared_projection": {
+    "enabled": true,
+    "file": ".sce/knowledge/errorbook/project-shared-registry.json",
+    "statuses": ["verified", "promoted"],
+    "min_quality": 75
+  },
   "sources": [
     {
       "name": "central",
       "enabled": true,
       "url": "https://raw.githubusercontent.com/heguangyong/sce-errorbook-registry/main/registry/errorbook-registry.json",
       "index_url": "https://raw.githubusercontent.com/heguangyong/sce-errorbook-registry/main/registry/errorbook-registry.index.json"
+    },
+    {
+      "name": "project-shared",
+      "enabled": true,
+      "file": ".sce/knowledge/errorbook/project-shared-registry.json"
     }
   ]
 }
@@ -87,23 +98,30 @@ Notes:
 - `url` must be a raw JSON URL (`raw.githubusercontent.com`) or use a local file path.
 - `search_mode` supports `cache|remote|hybrid` (recommended: `remote` for very large registries).
 - Local cache file is used by cache/hybrid mode.
-- Since `v3.3.23`, `sce init` / `sce adopt` template baselines include this config by default (central source enabled).
+- `project_shared_projection` is the Git-tracked same-project sharing path used for cross-computer co-work continuity.
+- Since `v3.3.23`, `sce init` / `sce adopt` template baselines include registry config by default; current baseline also seeds the tracked project-shared projection file.
 
 ## 4) Daily Workflow
 
-1. Export curated local entries:
+1. Keep project-shared same-project knowledge current:
+```bash
+# SCE refreshes this automatically after record/promote/deprecate/requalify
+.sce/knowledge/errorbook/project-shared-registry.json
+```
+
+2. Export curated local entries for central cross-project publication:
 ```bash
 sce errorbook export --status promoted --min-quality 75 --out .sce/errorbook/exports/registry.json --json
 ```
 
-2. Merge approved entries into central repo `registry/errorbook-registry.json`.
+3. Merge approved entries into central repo `registry/errorbook-registry.json`.
 
-3. Sync central registry into local cache:
+4. Sync central registry into local cache:
 ```bash
 sce errorbook sync-registry --source https://raw.githubusercontent.com/heguangyong/sce-errorbook-registry/main/registry/errorbook-registry.json --json
 ```
 
-4. Search local + shared entries:
+5. Search local + shared entries:
 ```bash
 sce errorbook find --query "approve order timeout" --include-registry --json
 sce errorbook find --query "approve order timeout" --include-registry --registry-mode remote --json
@@ -116,6 +134,7 @@ SCE_REGISTRY_HEALTH_STRICT=1 node scripts/errorbook-registry-health-gate.js --js
 
 ## 5) Governance Rules
 
+- Same-project co-work should rely on the tracked project-shared projection instead of committing raw `.sce/errorbook/**`.
 - Publish to central registry only curated entries (recommended: `status=promoted` and `quality>=75`).
 - Do not publish sensitive tenant/customer data.
 - Temporary mitigation entries must remain bounded and governed (exit criteria, cleanup task, deadline).

package/docs/releases/v3.6.53.md

@@ -0,0 +1,19 @@
+# v3.6.53 Release Notes
+
+Release date: 2026-03-16
+
+## Highlights
+
+- Closed the co-work loop for same-project high-value `errorbook` knowledge by adding a tracked shared projection at `.sce/knowledge/errorbook/project-shared-registry.json`.
+- Baseline/template projects now seed the shared projection source by default, so another computer can recover historical specs and curated project errorbook knowledge after normal Git sync.
+- Collaboration governance now blocks managed push/publish when the shared project errorbook projection is missing, disabled, invalid, or not Git-tracked.
+
+## Validation
+
+- `npx jest tests/unit/commands/errorbook.test.js tests/unit/workspace/takeover-baseline.test.js tests/unit/workspace/collab-governance-audit.test.js tests/integration/takeover-baseline-cli.integration.test.js --runInBand`
+- `node scripts/release-doc-version-audit.js --fail-on-error`
+- `node scripts/collab-governance-gate.js --fail-on-violation --json`
+
+## Release Notes
+
+- This patch turns “shared errorbook experience” from a config-level promise into a real same-project continuity path. Historical specs stay Git-shared as before, while high-value `verified/promoted` errorbook knowledge now has a dedicated tracked projection instead of leaking raw `.sce/errorbook/**` runtime state into version control.

package/docs/releases/v3.6.54.md

@@ -0,0 +1,19 @@
+# v3.6.54 Release Notes
+
+Release date: 2026-03-16
+
+## Highlights
+
+- Added a tracked project-shared problem projection at `.sce/knowledge/problem/project-shared-problems.json`, built from existing spec `problem-contract` and `problem-domain-chain` artifacts instead of introducing a parallel local problem library.
+- Managed co-work gate now refreshes that shared problem projection automatically before governance audit, so cross-computer continuation does not depend on manual reminders to sync local problem context.
+- Collaboration governance now blocks when the shared project problem projection is missing, invalid, disabled, or not Git-tracked.
+
+## Validation
+
+- `npx jest tests/unit/problem/project-problem-projection.test.js tests/unit/scripts/collab-governance-gate.test.js tests/unit/workspace/collab-governance-audit.test.js tests/unit/workspace/takeover-baseline.test.js tests/integration/takeover-baseline-cli.integration.test.js --runInBand`
+- `node scripts/release-doc-version-audit.js --fail-on-error`
+- `node scripts/collab-governance-gate.js --fail-on-violation --json`
+
+## Release Notes
+
+- This patch completes the same-project co-work continuity line for problem knowledge. Historical specs were already shared by Git, and high-value errorbook knowledge was closed in `3.6.53`; `3.6.54` closes the remaining gap by projecting active/stale spec problem facts into a tracked shared file instead of relying on a machine-local problem library.

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

@@ -0,0 +1,19 @@
+# v3.6.53 发布说明
+
+发布日期：2026-03-16
+
+## 重点变化
+
+- 补齐了同一项目 co-work 下高价值 `errorbook` 经验的闭环，新增 Git 跟踪投影文件 `.sce/knowledge/errorbook/project-shared-registry.json`。
+- baseline / template 现在默认带上这个共享投影源，另一台电脑正常 `git pull` 后即可同时拿到历史 spec 和项目级高价值错题经验。
+- 协作治理现在会阻断缺失、禁用、损坏或未纳入 Git 跟踪的项目共享错题投影，避免“能力存在但默认不生效”。
+
+## 验证
+
+- `npx jest tests/unit/commands/errorbook.test.js tests/unit/workspace/takeover-baseline.test.js tests/unit/workspace/collab-governance-audit.test.js tests/integration/takeover-baseline-cli.integration.test.js --runInBand`
+- `node scripts/release-doc-version-audit.js --fail-on-error`
+- `node scripts/collab-governance-gate.js --fail-on-violation --json`
+
+## 发布说明
+
+- 这个补丁版把“共享错题经验”从配置层能力补成了真正可落地的同项目跨电脑延续机制。历史 spec 仍按原方式走 Git 共享，而高价值 `verified/promoted` 错题经验则通过单独的受控投影文件同步，不再把 `.sce/errorbook/**` 运行态数据直接带入版本库。

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

@@ -0,0 +1,19 @@
+# v3.6.54 发布说明
+
+发布日期：2026-03-16
+
+## 重点变化
+
+- 新增 Git 跟踪的项目共享问题投影文件 `.sce/knowledge/problem/project-shared-problems.json`，直接从现有 spec 的 `problem-contract` 和 `problem-domain-chain` 生成，而不是再新造一套本地问题库机制。
+- managed co-work gate 现在会在治理审计前自动刷新这份共享问题投影，换电脑继续项目时不再依赖手动提醒“先同步问题库”。
+- 协作治理现在会阻断缺失、禁用、损坏或未纳入 Git 跟踪的项目共享问题投影。
+
+## 验证
+
+- `npx jest tests/unit/problem/project-problem-projection.test.js tests/unit/scripts/collab-governance-gate.test.js tests/unit/workspace/collab-governance-audit.test.js tests/unit/workspace/takeover-baseline.test.js tests/integration/takeover-baseline-cli.integration.test.js --runInBand`
+- `node scripts/release-doc-version-audit.js --fail-on-error`
+- `node scripts/collab-governance-gate.js --fail-on-violation --json`
+
+## 发布说明
+
+- 这个补丁版把“项目问题知识跨电脑共享”补成了默认闭环。历史 spec 早已由 Git 共享，高价值 errorbook 在 `3.6.53` 已闭环，而 `3.6.54` 则把仍在处理中的项目问题事实也投影到受控共享文件中，不再依赖机器本地问题库。

package/lib/commands/errorbook.js

@@ -18,6 +18,15 @@ const TEMPORARY_MITIGATION_TAG = 'temporary-mitigation';
 const DEFAULT_ERRORBOOK_REGISTRY_CONFIG = '.sce/config/errorbook-registry.json';
 const DEFAULT_ERRORBOOK_REGISTRY_CACHE = '.sce/errorbook/registry-cache.json';
 const DEFAULT_ERRORBOOK_REGISTRY_EXPORT = '.sce/errorbook/exports/errorbook-registry-export.json';
+const DEFAULT_PROJECT_SHARED_ERRORBOOK_REGISTRY = '.sce/knowledge/errorbook/project-shared-registry.json';
+const DEFAULT_PROJECT_SHARED_ERRORBOOK_STATUSES = Object.freeze(['verified', 'promoted']);
+const DEFAULT_PROJECT_SHARED_ERRORBOOK_MIN_QUALITY = 75;
+const DEFAULT_PROJECT_SHARED_ERRORBOOK_PROJECTION = Object.freeze({
+  enabled: true,
+  file: DEFAULT_PROJECT_SHARED_ERRORBOOK_REGISTRY,
+  statuses: [...DEFAULT_PROJECT_SHARED_ERRORBOOK_STATUSES],
+  min_quality: DEFAULT_PROJECT_SHARED_ERRORBOOK_MIN_QUALITY
+});
 const STATUS_RANK = Object.freeze({
   deprecated: 0,
   candidate: 1,
@@ -107,6 +116,10 @@ function nowIso() {
   return new Date().toISOString();
 }
 
+function cloneJson(value) {
+  return JSON.parse(JSON.stringify(value));
+}
+
 function normalizeText(value) {
   if (typeof value !== 'string') {
     return '';
@@ -1036,6 +1049,26 @@ function normalizeStatusList(values = [], fallback = ['promoted']) {
   return unique;
 }
 
+function normalizeProjectSharedProjection(input = {}) {
+  const candidate = input && typeof input === 'object' && !Array.isArray(input)
+    ? input
+    : {};
+  const minQualityCandidate = candidate.min_quality ?? candidate.minQuality;
+  const minQuality = Number.isFinite(Number(minQualityCandidate))
+    ? Math.max(0, Math.min(100, Number(minQualityCandidate)))
+    : DEFAULT_PROJECT_SHARED_ERRORBOOK_MIN_QUALITY;
+
+  return {
+    enabled: normalizeBoolean(candidate.enabled, true),
+    file: normalizeText(candidate.file || candidate.out || candidate.path || DEFAULT_PROJECT_SHARED_ERRORBOOK_REGISTRY),
+    statuses: normalizeStatusList(
+      candidate.statuses || candidate.status || DEFAULT_PROJECT_SHARED_ERRORBOOK_STATUSES,
+      DEFAULT_PROJECT_SHARED_ERRORBOOK_STATUSES
+    ),
+    min_quality: minQuality
+  };
+}
+
 function normalizeRegistrySource(input = {}) {
   const candidate = input || {};
   const name = normalizeText(candidate.name) || 'default';
@@ -1067,7 +1100,8 @@ async function readErrorbookRegistryConfig(paths, fileSystem = fs) {
     enabled: false,
     search_mode: 'cache',
     cache_file: DEFAULT_ERRORBOOK_REGISTRY_CACHE,
-    sources: []
+    sources: [],
+    project_shared_projection: cloneJson(DEFAULT_PROJECT_SHARED_ERRORBOOK_PROJECTION)
   };
   if (!await fileSystem.pathExists(paths.configFile)) {
     return fallback;
@@ -1083,7 +1117,55 @@ async function readErrorbookRegistryConfig(paths, fileSystem = fs) {
     enabled: normalizeBoolean(payload.enabled, true),
     search_mode: normalizeRegistryMode(payload.search_mode || payload.searchMode, 'cache'),
     cache_file: normalizeText(payload.cache_file || payload.cacheFile || DEFAULT_ERRORBOOK_REGISTRY_CACHE),
-    sources
+    sources,
+    project_shared_projection: normalizeProjectSharedProjection(
+      payload.project_shared_projection || payload.projectSharedProjection
+    )
+  };
+}
+
+async function refreshProjectSharedErrorbookProjection(projectPath, fileSystem = fs, options = {}) {
+  const registryPaths = resolveErrorbookRegistryPaths(projectPath, {
+    configPath: options.config
+  });
+  const registryConfig = await readErrorbookRegistryConfig(registryPaths, fileSystem);
+  const projection = normalizeProjectSharedProjection(
+    options.projectSharedProjection || registryConfig.project_shared_projection
+  );
+  const projectionFile = resolveProjectPath(
+    projectPath,
+    projection.file,
+    DEFAULT_PROJECT_SHARED_ERRORBOOK_REGISTRY
+  );
+
+  if (projection.enabled !== true) {
+    return {
+      enabled: false,
+      refreshed: false,
+      file: projectionFile,
+      statuses: projection.statuses,
+      min_quality: projection.min_quality,
+      total_entries: 0
+    };
+  }
+
+  const exportResult = await runErrorbookExportCommand({
+    out: projection.file,
+    status: projection.statuses.join(','),
+    minQuality: projection.min_quality,
+    silent: true
+  }, {
+    projectPath,
+    fileSystem
+  });
+
+  return {
+    enabled: true,
+    refreshed: true,
+    file: exportResult.out_file,
+    statuses: exportResult.statuses,
+    min_quality: exportResult.min_quality,
+    total_entries: exportResult.total_entries
   };
 }
 
@@ -1322,6 +1404,7 @@ async function searchRegistryRemote(options = {}, dependencies = {}) {
 
   const warnings = [];
   let shardSources = [];
+  const localFileSource = !isHttpSource(source.source);
   if (source.index_url) {
     try {
       const indexPayload = await loadRegistryPayload(projectPath, source.index_url, fileSystem);
@@ -1332,7 +1415,10 @@ async function searchRegistryRemote(options = {}, dependencies = {}) {
   }
 
   if (shardSources.length === 0) {
-    if (allowRemoteFullscan) {
+    if (localFileSource) {
+      shardSources = [source.source];
+      warnings.push('local registry file source scanned directly without index');
+    } else if (allowRemoteFullscan) {
       shardSources = [source.source];
       warnings.push('remote index unavailable; fallback to full-source scan');
     } else {
@@ -1769,13 +1855,15 @@ async function runErrorbookRecordCommand(options = {}, dependencies = {}) {
   const incidentLoop = await syncIncidentLoopForRecord(paths, normalized, entry, {
     nowIso: entry.updated_at
   }, fileSystem);
+  const projectSharedProjection = await refreshProjectSharedErrorbookProjection(projectPath, fileSystem, options);
 
   const result = {
     mode: 'errorbook-record',
     created,
     deduplicated,
     entry,
-    incident_loop: incidentLoop
+    incident_loop: incidentLoop,
+    project_shared_projection: projectSharedProjection
   };
 
   if (options.json) {
@@ -2575,11 +2663,13 @@ async function runErrorbookPromoteCommand(options = {}, dependencies = {}) {
   }
   index.entries.sort((left, right) => `${right.updated_at}`.localeCompare(`${left.updated_at}`));
   await writeErrorbookIndex(paths, index, fileSystem);
+  const projectSharedProjection = await refreshProjectSharedErrorbookProjection(projectPath, fileSystem, options);
 
   const result = {
     mode: 'errorbook-promote',
     promoted: true,
-    entry
+    entry,
+    project_shared_projection: projectSharedProjection
   };
 
   if (options.json) {
@@ -2672,11 +2762,13 @@ async function runErrorbookDeprecateCommand(options = {}, dependencies = {}) {
   }
   index.entries.sort((left, right) => `${right.updated_at}`.localeCompare(`${left.updated_at}`));
   await writeErrorbookIndex(paths, index, fileSystem);
+  const projectSharedProjection = await refreshProjectSharedErrorbookProjection(projectPath, fileSystem, options);
 
   const result = {
     mode: 'errorbook-deprecate',
     deprecated: true,
-    entry
+    entry,
+    project_shared_projection: projectSharedProjection
   };
 
   if (options.json) {
@@ -2744,11 +2836,13 @@ async function runErrorbookRequalifyCommand(options = {}, dependencies = {}) {
   }
   index.entries.sort((left, right) => `${right.updated_at}`.localeCompare(`${left.updated_at}`));
   await writeErrorbookIndex(paths, index, fileSystem);
+  const projectSharedProjection = await refreshProjectSharedErrorbookProjection(projectPath, fileSystem, options);
 
   const result = {
     mode: 'errorbook-requalify',
     requalified: true,
-    entry
+    entry,
+    project_shared_projection: projectSharedProjection
   };
 
   if (options.json) {
@@ -3009,6 +3103,8 @@ module.exports = {
   DEFAULT_ERRORBOOK_REGISTRY_CONFIG,
   DEFAULT_ERRORBOOK_REGISTRY_CACHE,
   DEFAULT_ERRORBOOK_REGISTRY_EXPORT,
+  DEFAULT_PROJECT_SHARED_ERRORBOOK_REGISTRY,
+  DEFAULT_PROJECT_SHARED_ERRORBOOK_PROJECTION,
   HIGH_RISK_SIGNAL_TAGS,
   DEBUG_EVIDENCE_TAGS,
   DEFAULT_PROMOTE_MIN_QUALITY,
@@ -3035,5 +3131,6 @@ module.exports = {
   runErrorbookReleaseGateCommand,
   runErrorbookDeprecateCommand,
   runErrorbookRequalifyCommand,
+  refreshProjectSharedErrorbookProjection,
   registerErrorbookCommands
 };