scene-capability-engine 3.6.24 → 3.6.25

package/CHANGELOG.md

@@ -7,10 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.6.25] - 2026-03-06
+
+### Added
+- Capability inventory now exposes homepage summary stats for publish readiness and triad gap cards.
+- Capability iteration schema and Magicball docs now define the homepage summary card contract.
+
 ## [3.6.24] - 2026-03-06
 
 ### Added
-- Capability inventory payload now exposes fixed homepage query metadata (`query`) and sorting metadata (`sort`).
+- Capability inventory payload now exposes fixed homepage query metadata (`query`), summary stats (`summary_stats`), and sorting metadata (`sort`).
 - Capability iteration schema and Magicball docs now define the fixed homepage inventory protocol.
 
 ## [3.6.23] - 2026-03-06

package/README.md

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

package/README.zh.md

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

package/docs/agent-runtime/capability-iteration-ui.schema.json

@@ -667,7 +667,8 @@
         "scene_total",
         "scene_count",
         "sort",
-        "scenes"
+        "scenes",
+        "summary_stats"
       ],
       "properties": {
         "mode": {
@@ -801,6 +802,48 @@
             },
             "additionalProperties": false
           }
+        },
+        "summary_stats": {
+          "type": "object",
+          "required": [
+            "publish_ready_count",
+            "blocked_count",
+            "missing_triads"
+          ],
+          "properties": {
+            "publish_ready_count": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "blocked_count": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "missing_triads": {
+              "type": "object",
+              "required": [
+                "decision_strategy",
+                "business_rules",
+                "entity_relation"
+              ],
+              "properties": {
+                "decision_strategy": {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                "business_rules": {
+                  "type": "integer",
+                  "minimum": 0
+                },
+                "entity_relation": {
+                  "type": "integer",
+                  "minimum": 0
+                }
+              },
+              "additionalProperties": false
+            }
+          },
+          "additionalProperties": false
         }
       },
       "additionalProperties": false

package/docs/command-reference.md

@@ -1875,7 +1875,7 @@ sce capability inventory --json
 sce capability inventory --release-ready false --missing-triad decision_strategy --json
 ```
 
-`capability inventory` returns fixed homepage query metadata in `query` and sorting metadata in `sort`.
+`capability inventory` returns fixed homepage query metadata in `query`, summary cards in `summary_stats`, and sorting metadata in `sort`.
 
 
 Capability candidates are now evaluated against the ontology core triad by default:

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

@@ -186,5 +186,7 @@ sce capability register --input <template_file> --risk-level <level> --difficult
 - `query.sample_limit`：每个 spec 抽样任务上限
 - `query.filters.release_ready`：发布可用性过滤
 - `query.filters.missing_triad`：triad 缺口过滤
+- `summary_stats.publish_ready_count` / `summary_stats.blocked_count`：顶部统计卡
+- `summary_stats.missing_triads.*`：triad 缺口计数卡
 - `sort.strategy`：默认排序策略说明
 - `sort.triad_priority`：triad 优先级数组

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

@@ -205,4 +205,12 @@ sce capability register --input <template.json> --json
 - 使用 `capability-inventory` 返回的 `query` 作为首页请求回显
 - 使用 `sort` 作为排序策略展示来源
 - 首页筛选器应直接映射：`query.filters.release_ready`、`query.filters.missing_triad`
-- 首页顶部可显示：`scene_total` / `scene_count`
+- 首页顶部可显示：`scene_total` / `scene_count` / `summary_stats`
+
+## 12. 顶部统计卡
+
+- `summary_stats.publish_ready_count`：可发布 scene 数
+- `summary_stats.blocked_count`：被阻断 scene 数
+- `summary_stats.missing_triads.decision_strategy`：缺决策策略数量
+- `summary_stats.missing_triads.business_rules`：缺业务规则数量
+- `summary_stats.missing_triads.entity_relation`：缺实体关系数量

package/lib/commands/capability.js

@@ -836,6 +836,39 @@ function resolveCapabilityTriadPriority(entry) {
   return 3;
 }
 
+function buildCapabilityInventorySummaryStats(entries) {
+  const items = Array.isArray(entries) ? entries : [];
+  const summary = {
+    publish_ready_count: 0,
+    blocked_count: 0,
+    missing_triads: {
+      decision_strategy: 0,
+      business_rules: 0,
+      entity_relation: 0
+    }
+  };
+
+  for (const entry of items) {
+    const ready = Boolean(entry && entry.release_readiness_ui && entry.release_readiness_ui.publish_ready);
+    if (ready) {
+      summary.publish_ready_count += 1;
+    } else {
+      summary.blocked_count += 1;
+    }
+
+    const missing = Array.isArray(entry && entry.release_readiness_ui && entry.release_readiness_ui.blocking_missing)
+      ? entry.release_readiness_ui.blocking_missing
+      : [];
+    for (const triad of Object.keys(summary.missing_triads)) {
+      if (missing.includes(triad)) {
+        summary.missing_triads[triad] += 1;
+      }
+    }
+  }
+
+  return summary;
+}
+
 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);
@@ -930,6 +963,7 @@ async function runCapabilityInventoryCommand(options = {}, dependencies = {}) {
     },
     scene_total: scenes.length,
     scene_count: filteredScenes.length,
+    summary_stats: buildCapabilityInventorySummaryStats(filteredScenes),
     sort: {
       strategy: 'publish_ready -> missing_triad_priority -> value_score_desc -> scene_id',
       triad_priority: ['decision_strategy', 'business_rules', 'entity_relation']
@@ -1717,5 +1751,6 @@ module.exports = {
   buildCapabilityReleaseReadinessUi,
   filterCapabilityCatalogEntries,
   filterCapabilityInventoryEntries,
-  sortCapabilityInventoryEntries
+  sortCapabilityInventoryEntries,
+  buildCapabilityInventorySummaryStats
 };

package/package.json

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