scene-capability-engine 3.6.52 → 3.6.53

package/CHANGELOG.md

@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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.53
 **Last Updated**: 2026-03-16

package/README.zh.md

@@ -223,5 +223,5 @@ MIT，见 [LICENSE](LICENSE)。
 
 ---
 
-**版本**：3.6.52
+**版本**：3.6.53
 **最后更新**：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 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 projection, 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.

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/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/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
 };

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

@@ -51,6 +51,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 PROJECT_SHARED_ERRORBOOK_REGISTRY_PATH = '.sce/knowledge/errorbook/project-shared-registry.json';
+const PROJECT_SHARED_ERRORBOOK_SOURCE_NAME = 'project-shared';
 const ADOPTION_CONFIG_PATH = '.sce/adoption-config.json';
 
 const REQUIRED_GITIGNORE_RULES = Object.freeze([
@@ -396,6 +398,24 @@ function validateErrorbookRegistryConfig(payload) {
     violations.push('errorbook registry config must declare non-empty field "cache_file"');
   }
 
+  const projection = payload.project_shared_projection;
+  if (!projection || typeof projection !== 'object' || Array.isArray(projection)) {
+    violations.push('errorbook registry config must declare object field "project_shared_projection"');
+  } else {
+    if (projection.enabled !== true) {
+      violations.push('errorbook registry config must keep project_shared_projection.enabled=true under co-work baseline');
+    }
+    if (typeof projection.file !== 'string' || !projection.file.trim()) {
+      violations.push('errorbook registry config must declare non-empty project_shared_projection.file');
+    }
+    if (!Array.isArray(projection.statuses) || projection.statuses.length === 0) {
+      violations.push('errorbook registry config must declare non-empty project_shared_projection.statuses');
+    }
+    if (!Number.isFinite(Number(projection.min_quality))) {
+      violations.push('errorbook registry config must declare numeric project_shared_projection.min_quality');
+    }
+  }
+
   const sources = Array.isArray(payload.sources) ? payload.sources : [];
   if (sources.length === 0) {
     violations.push('errorbook registry config must declare at least one registry source');
@@ -407,18 +427,38 @@ function validateErrorbookRegistryConfig(payload) {
       return false;
     }
     const enabled = item.enabled !== false;
-    const url = typeof item.url === 'string' ? item.url.trim() : '';
-    return enabled && Boolean(url);
+    const source = typeof item.url === 'string' && item.url.trim()
+      ? item.url.trim()
+      : typeof item.file === 'string' && item.file.trim()
+        ? item.file.trim()
+        : typeof item.path === 'string' && item.path.trim()
+          ? item.path.trim()
+          : '';
+    return enabled && Boolean(source);
   });
 
   if (enabledSources.length === 0) {
-    violations.push('errorbook registry config must keep at least one enabled source with a non-empty "url"');
+    violations.push('errorbook registry config must keep at least one enabled source with a non-empty url/file');
+  }
+
+  if (projection && typeof projection === 'object' && !Array.isArray(projection)) {
+    const hasProjectSharedSource = enabledSources.some((item) => {
+      const name = typeof item.name === 'string' ? item.name.trim() : '';
+      const file = typeof item.file === 'string' ? item.file.trim() : '';
+      const sourcePath = typeof item.path === 'string' ? item.path.trim() : '';
+      return name === PROJECT_SHARED_ERRORBOOK_SOURCE_NAME
+        || file === projection.file
+        || sourcePath === projection.file;
+    });
+    if (!hasProjectSharedSource) {
+      violations.push('errorbook registry config must keep an enabled project-shared source aligned with project_shared_projection.file');
+    }
   }
 
   return violations;
 }
 
-async function inspectErrorbookRegistry(projectRoot, options = {}, dependencies = {}) {
+async function inspectErrorbookRegistry(projectRoot, gitSnapshot, options = {}, dependencies = {}) {
   const fileSystem = dependencies.fileSystem || fs;
   const configPath = path.join(projectRoot, '.sce', 'config', 'errorbook-registry.json');
   const exists = await fileSystem.pathExists(configPath);
@@ -428,6 +468,9 @@ async function inspectErrorbookRegistry(projectRoot, options = {}, dependencies
     valid: false,
     enabled: null,
     enabled_source_count: 0,
+    project_shared_projection_file: PROJECT_SHARED_ERRORBOOK_REGISTRY_PATH,
+    project_shared_projection_exists: false,
+    project_shared_projection_tracked: null,
     warnings: [],
     violations: [],
     passed: true,
@@ -454,8 +497,23 @@ async function inspectErrorbookRegistry(projectRoot, options = {}, dependencies
   const validationErrors = validateErrorbookRegistryConfig(payload);
   report.valid = validationErrors.length === 0;
   report.enabled = typeof payload.enabled === 'boolean' ? payload.enabled : null;
+  report.project_shared_projection_file = payload
+    && payload.project_shared_projection
+    && typeof payload.project_shared_projection.file === 'string'
+    && payload.project_shared_projection.file.trim()
+    ? normalizeRelativePath(projectRoot, payload.project_shared_projection.file.trim()) || payload.project_shared_projection.file.trim()
+    : PROJECT_SHARED_ERRORBOOK_REGISTRY_PATH;
   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
+    ? payload.sources.filter((item) => {
+      if (!item || typeof item !== 'object' || Array.isArray(item) || item.enabled === false) {
+        return false;
+      }
+      return (
+        (typeof item.url === 'string' && item.url.trim())
+        || (typeof item.file === 'string' && item.file.trim())
+        || (typeof item.path === 'string' && item.path.trim())
+      );
+    }).length
     : 0;
 
   if (validationErrors.length > 0) {
@@ -465,6 +523,41 @@ async function inspectErrorbookRegistry(projectRoot, options = {}, dependencies
     return report;
   }
 
+  const projectionFile = report.project_shared_projection_file;
+  const projectionAbsolutePath = path.isAbsolute(projectionFile)
+    ? projectionFile
+    : path.join(projectRoot, projectionFile);
+  report.project_shared_projection_exists = await fileSystem.pathExists(projectionAbsolutePath);
+  if (!report.project_shared_projection_exists) {
+    report.passed = false;
+    report.reason = 'missing-project-shared-projection';
+    report.violations.push(`shared project errorbook projection file is missing: ${projectionFile}`);
+    return report;
+  }
+
+  try {
+    const projectionPayload = await fileSystem.readJson(projectionAbsolutePath);
+    if (!projectionPayload || typeof projectionPayload !== 'object' || Array.isArray(projectionPayload)) {
+      report.violations.push(`shared project errorbook projection must be a JSON object: ${projectionFile}`);
+    } else if (!Array.isArray(projectionPayload.entries)) {
+      report.violations.push(`shared project errorbook projection must declare entries[]: ${projectionFile}`);
+    }
+  } catch (error) {
+    report.violations.push(`invalid shared project errorbook projection: ${error.message}`);
+  }
+
+  if (gitSnapshot && gitSnapshot.available === true) {
+    report.project_shared_projection_tracked = gitSnapshot.tracked_files.has(projectionFile);
+    if (report.project_shared_projection_tracked !== true) {
+      report.violations.push(`shared project errorbook projection must be tracked by git: ${projectionFile}`);
+    }
+  }
+
+  if (report.violations.length > 0) {
+    report.passed = false;
+    report.reason = 'invalid-config';
+  }
+
   return report;
 }
 
@@ -652,7 +745,7 @@ 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 errorbookRegistry = await inspectErrorbookRegistry(projectRoot, gitSnapshot, options, dependencies);
   const errorbookConvergence = await inspectErrorbookConvergence(projectRoot, options, dependencies);
   const steeringBoundary = inspectSteeringBoundary(projectRoot);
 

package/lib/workspace/takeover-baseline.js

@@ -101,12 +101,23 @@ const ERRORBOOK_REGISTRY_DEFAULTS = Object.freeze({
   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'
     }
   ]
 });
@@ -501,12 +512,68 @@ function _buildTakeoverBaselineConfig(existing, sceVersion) {
 
 function _buildErrorbookRegistryConfig(existing) {
   const base = _isObject(existing) ? _clone(existing) : {};
+  const projectSharedProjection = _deepMerge(
+    _clone(ERRORBOOK_REGISTRY_DEFAULTS.project_shared_projection),
+    _isObject(base.project_shared_projection) ? base.project_shared_projection : {}
+  );
+  const existingSources = Array.isArray(base.sources) && base.sources.length > 0
+    ? _clone(base.sources)
+    : _clone(ERRORBOOK_REGISTRY_DEFAULTS.sources);
+  const hasProjectSharedSource = existingSources.some((item) => {
+    if (!_isObject(item)) {
+      return false;
+    }
+    const name = typeof item.name === 'string' ? item.name.trim() : '';
+    const file = typeof item.file === 'string' ? item.file.trim() : '';
+    const sourcePath = typeof item.path === 'string' ? item.path.trim() : '';
+    return name === 'project-shared'
+      || file === projectSharedProjection.file
+      || sourcePath === projectSharedProjection.file;
+  });
+  if (!hasProjectSharedSource) {
+    existingSources.push({
+      name: 'project-shared',
+      enabled: true,
+      file: projectSharedProjection.file
+    });
+  }
   return {
     ..._clone(ERRORBOOK_REGISTRY_DEFAULTS),
     ...base,
-    sources: Array.isArray(base.sources) && base.sources.length > 0
-      ? _clone(base.sources)
-      : _clone(ERRORBOOK_REGISTRY_DEFAULTS.sources)
+    project_shared_projection: projectSharedProjection,
+    sources: existingSources
+  };
+}
+
+function _buildProjectSharedErrorbookRegistry(existing, projectPath, nowIso, config = {}) {
+  const projection = _isObject(config.project_shared_projection)
+    ? config.project_shared_projection
+    : _clone(ERRORBOOK_REGISTRY_DEFAULTS.project_shared_projection);
+  const fallback = {
+    api_version: 'sce.errorbook.registry/v0.1',
+    generated_at: nowIso,
+    source: {
+      project: path.basename(projectPath),
+      scope: 'project-shared',
+      statuses: Array.isArray(projection.statuses) ? projection.statuses : ['verified', 'promoted'],
+      min_quality: Number.isFinite(Number(projection.min_quality)) ? Number(projection.min_quality) : 75
+    },
+    total_entries: 0,
+    entries: []
+  };
+  if (!_isObject(existing) || !Array.isArray(existing.entries)) {
+    return fallback;
+  }
+  return {
+    ...fallback,
+    ...existing,
+    source: _isObject(existing.source)
+      ? {
+        ...fallback.source,
+        ...existing.source
+      }
+      : fallback.source,
+    total_entries: Array.isArray(existing.entries) ? existing.entries.length : fallback.total_entries
   };
 }
 
@@ -838,6 +905,21 @@ async function applyTakeoverBaseline(projectPath = process.cwd(), options = {})
   const desiredAutoConfig = _buildAutoConfig(existingAuto);
   const desiredTakeover = _buildTakeoverBaselineConfig(existingTakeover, sceVersion);
   const desiredErrorbookRegistry = _buildErrorbookRegistryConfig(existingErrorbookRegistry);
+  const projectSharedRegistryRelativePath = _isObject(desiredErrorbookRegistry.project_shared_projection)
+    && typeof desiredErrorbookRegistry.project_shared_projection.file === 'string'
+    && desiredErrorbookRegistry.project_shared_projection.file.trim()
+    ? desiredErrorbookRegistry.project_shared_projection.file.trim()
+    : ERRORBOOK_REGISTRY_DEFAULTS.project_shared_projection.file;
+  const projectSharedErrorbookRegistryPath = path.isAbsolute(projectSharedRegistryRelativePath)
+    ? projectSharedRegistryRelativePath
+    : path.join(projectPath, projectSharedRegistryRelativePath);
+  const existingProjectSharedErrorbookRegistry = await _readJsonSafe(projectSharedErrorbookRegistryPath, fileSystem);
+  const desiredProjectSharedErrorbookRegistry = _buildProjectSharedErrorbookRegistry(
+    existingProjectSharedErrorbookRegistry,
+    projectPath,
+    nowIso,
+    desiredErrorbookRegistry
+  );
   const desiredMultiAgentConfig = _buildMultiAgentConfig(existingMultiAgentConfig);
   const desiredSessionGovernance = _deepMerge(existingSessionGovernance || {}, SESSION_GOVERNANCE_DEFAULTS);
   const desiredSpecDomainPolicy = _deepMerge(existingSpecDomainPolicy || {}, SPEC_DOMAIN_POLICY_DEFAULTS);
@@ -869,6 +951,11 @@ async function applyTakeoverBaseline(projectPath = process.cwd(), options = {})
     apply,
     fileSystem
   }));
+  fileResults.push(await _reconcileJsonFile(projectSharedErrorbookRegistryPath, desiredProjectSharedErrorbookRegistry, {
+    projectPath,
+    apply,
+    fileSystem
+  }));
   fileResults.push(await _reconcileJsonFile(multiAgentConfigPath, desiredMultiAgentConfig, {
     projectPath,
     apply,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scene-capability-engine",
-  "version": "3.6.52",
+  "version": "3.6.53",
   "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.52  
+**sce Version**: 3.6.53  
 **Last Updated**: 2026-03-16  
 **Purpose**: Guide AI tools to work effectively with this project

package/template/.sce/config/errorbook-registry.json

@@ -2,12 +2,26 @@
   "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"
     }
   ]
 }

package/template/.sce/knowledge/errorbook/project-shared-registry.json

@@ -0,0 +1,15 @@
+{
+  "api_version": "sce.errorbook.registry/v0.1",
+  "generated_at": "2026-03-16T00:00:00.000Z",
+  "source": {
+    "project": "template",
+    "scope": "project-shared",
+    "statuses": [
+      "verified",
+      "promoted"
+    ],
+    "min_quality": 75
+  },
+  "total_entries": 0,
+  "entries": []
+}