scene-capability-engine 3.6.22 → 3.6.23

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.6.23] - 2026-03-06
+
+### Added
+- Capability inventory now applies a default homepage sort: blocked scenes first, then triad-gap priority, then value score.
+- Magicball capability iteration docs now define the default scene inventory ordering contract.
+
 ## [3.6.22] - 2026-03-06
 
 ### Added
@@ -17,6 +23,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 - New `sce capability inventory` command provides scene-level triad/readiness aggregation for homepage views.
+- Capability inventory now applies default sorting: publish-ready last, then triad-gap priority, then value score.
 - Capability catalog list/search now supports `--release-ready` and `--missing-triad` filters for pre-publish triage.
 - Magicball capability library docs now show list-level triage filter examples.
 

package/README.md

@@ -218,5 +218,5 @@ MIT. See [LICENSE](LICENSE).
 
 ---
 
-**Version**: 3.6.22  
+**Version**: 3.6.23  
 **Last Updated**: 2026-03-05

package/README.zh.md

@@ -218,5 +218,5 @@ MIT，见 [LICENSE](LICENSE)。
 
 ---
 
-**版本**：3.6.22  
+**版本**：3.6.23  
 **最后更新**：2026-03-05

package/docs/magicball-capability-iteration-ui.md

@@ -192,3 +192,10 @@ sce capability register --input <template.json> --json
 - 发布页直接消费 `release_readiness.ready`
 - 若为 `false`，展示 `blockers[].reason`、`blockers[].missing`、`blockers[].remediation`
 - 默认阻断文案：`能力模板未达到发布条件`
+
+## 10. 默认排序
+
+- 先显示 `release_readiness_ui.publish_ready = false` 的 scene
+- 再按 triad 缺口优先级排序：`decision_strategy` -> `business_rules` -> `entity_relation`
+- 再按 `score_preview.value_score` 降序
+- 最后按 `scene_id` 升序

package/lib/commands/capability.js

@@ -820,6 +820,45 @@ async function listCapabilityInventorySceneIds(options = {}, dependencies = {})
   return [];
 }
 
+function resolveCapabilityTriadPriority(entry) {
+  const missing = Array.isArray(entry && entry.release_readiness_ui && entry.release_readiness_ui.blocking_missing)
+    ? entry.release_readiness_ui.blocking_missing
+    : [];
+  if (missing.includes('decision_strategy')) {
+    return 0;
+  }
+  if (missing.includes('business_rules')) {
+    return 1;
+  }
+  if (missing.includes('entity_relation')) {
+    return 2;
+  }
+  return 3;
+}
+
+function sortCapabilityInventoryEntries(entries) {
+  return [...(Array.isArray(entries) ? entries : [])].sort((left, right) => {
+    const leftReady = Boolean(left && left.release_readiness_ui && left.release_readiness_ui.publish_ready);
+    const rightReady = Boolean(right && right.release_readiness_ui && right.release_readiness_ui.publish_ready);
+    if (leftReady !== rightReady) {
+      return leftReady ? 1 : -1;
+    }
+
+    const triadDelta = resolveCapabilityTriadPriority(left) - resolveCapabilityTriadPriority(right);
+    if (triadDelta !== 0) {
+      return triadDelta;
+    }
+
+    const leftValue = Number(left && left.score_preview && left.score_preview.value_score || 0);
+    const rightValue = Number(right && right.score_preview && right.score_preview.value_score || 0);
+    if (leftValue !== rightValue) {
+      return rightValue - leftValue;
+    }
+
+    return String(left && left.scene_id || '').localeCompare(String(right && right.scene_id || ''));
+  });
+}
+
 function filterCapabilityInventoryEntries(entries, options = {}) {
   const normalizedMissingTriad = normalizeText(options.missingTriad || options.missing_triad).toLowerCase();
   const releaseReadyFilter = normalizeText(options.releaseReady || options.release_ready).toLowerCase();
@@ -874,11 +913,15 @@ async function runCapabilityInventoryCommand(options = {}, dependencies = {}) {
     });
   }
 
-  const filteredScenes = filterCapabilityInventoryEntries(scenes, options);
+  const filteredScenes = sortCapabilityInventoryEntries(filterCapabilityInventoryEntries(scenes, options));
   const payload = {
     mode: 'capability-inventory',
     generated_at: new Date().toISOString(),
     scene_count: filteredScenes.length,
+    sort: {
+      strategy: 'publish_ready -> missing_triad_priority -> value_score_desc -> scene_id',
+      triad_priority: ['decision_strategy', 'business_rules', 'entity_relation']
+    },
     scenes: filteredScenes
   };
 
@@ -1661,5 +1704,6 @@ module.exports = {
   enrichCapabilityTemplateForUi,
   buildCapabilityReleaseReadinessUi,
   filterCapabilityCatalogEntries,
-  filterCapabilityInventoryEntries
+  filterCapabilityInventoryEntries,
+  sortCapabilityInventoryEntries
 };

package/package.json

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