scene-capability-engine 3.6.47 → 3.6.48

package/CHANGELOG.md

@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.6.48] - 2026-03-14
+
+### Changed
+- Added `governance.duplicate_detection_scope` to studio spec governance policy with supported values `all`, `non_completed`, and `active_only`.
+- Changed the default duplicate governance scope to `non_completed`, so duplicate detection compares active and stale specs but no longer treats completed historical specs as duplicate noise.
+- Updated studio intake normalization and scene governance reporting to filter duplicate candidate sets by the configured scope before generating duplicate alerts.
+- Synced the new duplicate governance scope into takeover baseline defaults so adopted and upgraded projects inherit the same non-completed duplicate detection behavior by default.
+- Added regression coverage proving completed history specs do not trigger duplicate governance alerts under the new default scope.
+
 ## [3.6.47] - 2026-03-14
 
 ### Changed

package/docs/releases/README.md

@@ -9,6 +9,7 @@ This directory stores release-facing documents:
 ## Archived Versions
 
 - [Release checklist](../release-checklist.md)
+- [v3.6.48 release notes](./v3.6.48.md)
 - [v3.6.47 release notes](./v3.6.47.md)
 - [v3.6.46 release notes](./v3.6.46.md)
 - [v3.6.45 release notes](./v3.6.45.md)

package/docs/releases/v3.6.48.md

@@ -0,0 +1,19 @@
+# v3.6.48 Release Notes
+
+Release date: 2026-03-14
+
+## Highlights
+
+- Added `governance.duplicate_detection_scope` to studio spec governance with three supported values: `all`, `non_completed`, and `active_only`.
+- Changed the default duplicate governance scope to `non_completed`, so duplicate checks now compare active and stale specs while excluding completed historical specs from duplicate pair detection.
+- Synced the same default into takeover baseline, so adopted and upgraded projects inherit the lower-noise duplicate governance behavior automatically.
+
+## Validation
+
+- `npx jest tests/unit/studio/spec-intake-governor.test.js --runInBand`
+- `npm run prepublishOnly`
+
+## Release Notes
+
+- This patch reduces governance noise in repositories with many completed template-style specs, where historical completed work previously flooded duplicate alerts and hid active governance problems.
+- The default keeps duplicate sensitivity on unclosed work (`active` + `stale`) without requiring every upgraded project to hand-tune its own studio intake policy.

package/docs/zh/releases/README.md

@@ -9,6 +9,7 @@
 ## 历史版本归档
 
 - [发布检查清单](../release-checklist.md)
+- [v3.6.48 发布说明](./v3.6.48.md)
 - [v3.6.47 发布说明](./v3.6.47.md)
 - [v3.6.46 发布说明](./v3.6.46.md)
 - [v3.6.45 发布说明](./v3.6.45.md)

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

@@ -0,0 +1,19 @@
+# v3.6.48 发布说明
+
+发布日期：2026-03-14
+
+## 重点变化
+
+- 为 studio spec governance 增加 `governance.duplicate_detection_scope`，支持 `all`、`non_completed`、`active_only` 三种取值。
+- 将默认 duplicate 检测策略调整为 `non_completed`：只比较 `active` 与 `stale` spec，不再把 `completed` 历史 spec 纳入 duplicate 对比。
+- 将同样的默认值同步到 takeover baseline，确保 adopt / upgrade 后的项目自动继承这套降噪后的治理行为。
+
+## 验证
+
+- `npx jest tests/unit/studio/spec-intake-governor.test.js --runInBand`
+- `npm run prepublishOnly`
+
+## 发布说明
+
+- 这个补丁版主要解决“历史 completed spec 太多时 duplicate 告警淹没真实 active 治理问题”的噪音问题。
+- 新默认值仍保留对未收口 spec 的治理敏感度，但不再让历史归档 spec 持续制造无效 duplicate 告警。

package/lib/studio/spec-intake-governor.js

@@ -82,7 +82,8 @@ const DEFAULT_STUDIO_INTAKE_POLICY = Object.freeze({
     require_auto_on_plan: true,
     max_active_specs_per_scene: 3,
     stale_days: 14,
-    duplicate_similarity_threshold: 0.66
+    duplicate_similarity_threshold: 0.66,
+    duplicate_detection_scope: 'non_completed'
   },
   backfill: {
     enabled: true,
@@ -132,6 +133,14 @@ function normalizeBoolean(value, fallback = false) {
   return fallback;
 }
 
+function normalizeDuplicateDetectionScope(value, fallback = 'non_completed') {
+  const normalized = normalizeText(value).toLowerCase();
+  if (['all', 'non_completed', 'active_only'].includes(normalized)) {
+    return normalized;
+  }
+  return fallback;
+}
+
 function normalizeTextList(value = []) {
   if (!Array.isArray(value)) {
     return [];
@@ -330,6 +339,10 @@ function normalizeStudioIntakePolicy(raw = {}) {
           governance.duplicate_similarity_threshold,
           DEFAULT_STUDIO_INTAKE_POLICY.governance.duplicate_similarity_threshold
         ))
+      ),
+      duplicate_detection_scope: normalizeDuplicateDetectionScope(
+        governance.duplicate_detection_scope,
+        DEFAULT_STUDIO_INTAKE_POLICY.governance.duplicate_detection_scope
       )
     },
     backfill: {
@@ -898,6 +911,10 @@ function buildSceneGovernanceReport(records = [], policy = DEFAULT_STUDIO_INTAKE
   const governance = policy.governance || DEFAULT_STUDIO_INTAKE_POLICY.governance;
   const threshold = normalizeNumber(governance.duplicate_similarity_threshold, 0.66);
   const maxActive = normalizeInteger(governance.max_active_specs_per_scene, 3, 1, 200);
+  const duplicateScope = normalizeDuplicateDetectionScope(
+    governance.duplicate_detection_scope,
+    DEFAULT_STUDIO_INTAKE_POLICY.governance.duplicate_detection_scope
+  );
 
   const sceneMap = new Map();
   for (const record of records) {
@@ -918,12 +935,17 @@ function buildSceneGovernanceReport(records = [], policy = DEFAULT_STUDIO_INTAKE
     const activeSpecs = sortedSpecs.filter((item) => item.lifecycle_state === 'active');
     const staleSpecs = sortedSpecs.filter((item) => item.lifecycle_state === 'stale');
     const completedSpecs = sortedSpecs.filter((item) => item.lifecycle_state === 'completed');
+    const duplicateCandidateSpecs = duplicateScope === 'active_only'
+      ? activeSpecs
+      : (duplicateScope === 'non_completed'
+          ? sortedSpecs.filter((item) => item.lifecycle_state !== 'completed')
+          : sortedSpecs);
 
     const duplicates = [];
-    for (let i = 0; i < sortedSpecs.length; i += 1) {
-      for (let j = i + 1; j < sortedSpecs.length; j += 1) {
-        const left = sortedSpecs[i];
-        const right = sortedSpecs[j];
+    for (let i = 0; i < duplicateCandidateSpecs.length; i += 1) {
+      for (let j = i + 1; j < duplicateCandidateSpecs.length; j += 1) {
+        const left = duplicateCandidateSpecs[i];
+        const right = duplicateCandidateSpecs[j];
         const similarity = computeJaccard(left.tokens, right.tokens);
         if (similarity >= threshold) {
           duplicatePairs += 1;

package/lib/workspace/takeover-baseline.js

@@ -235,7 +235,8 @@ const STUDIO_INTAKE_POLICY_DEFAULTS = Object.freeze({
     require_auto_on_plan: true,
     max_active_specs_per_scene: 3,
     stale_days: 14,
-    duplicate_similarity_threshold: 0.66
+    duplicate_similarity_threshold: 0.66,
+    duplicate_detection_scope: 'non_completed'
   },
   backfill: {
     enabled: true,
@@ -319,7 +320,8 @@ const TAKEOVER_DEFAULTS = Object.freeze({
       require_auto_on_plan: true,
       max_active_specs_per_scene: 3,
       stale_days: 14,
-      duplicate_similarity_threshold: 0.66
+      duplicate_similarity_threshold: 0.66,
+      duplicate_detection_scope: 'non_completed'
     },
     backfill: {
       enabled: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scene-capability-engine",
-  "version": "3.6.47",
+  "version": "3.6.48",
   "description": "SCE (Scene Capability Engine) - A CLI tool and npm package for spec-driven development with AI coding assistants.",
   "main": "index.js",
   "bin": {