scene-capability-engine 3.6.23 → 3.6.25

package/CHANGELOG.md

@@ -7,6 +7,18 @@ 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`), 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
 
 ### Added

package/README.md

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

package/README.zh.md

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

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

@@ -21,6 +21,9 @@
     },
     "registry": {
       "$ref": "#/definitions/registry"
+    },
+    "inventory": {
+      "$ref": "#/definitions/inventory"
     }
   },
   "definitions": {
@@ -654,6 +657,196 @@
         }
       },
       "additionalProperties": false
+    },
+    "inventory": {
+      "type": "object",
+      "required": [
+        "mode",
+        "generated_at",
+        "query",
+        "scene_total",
+        "scene_count",
+        "sort",
+        "scenes",
+        "summary_stats"
+      ],
+      "properties": {
+        "mode": {
+          "const": "capability-inventory"
+        },
+        "generated_at": {
+          "type": "string"
+        },
+        "query": {
+          "type": "object",
+          "required": [
+            "protocol_version",
+            "scene_id",
+            "limit",
+            "sample_limit",
+            "filters"
+          ],
+          "properties": {
+            "protocol_version": {
+              "type": "string"
+            },
+            "scene_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "limit": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "sample_limit": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "filters": {
+              "type": "object",
+              "required": [
+                "release_ready",
+                "missing_triad"
+              ],
+              "properties": {
+                "release_ready": {
+                  "type": [
+                    "boolean",
+                    "null"
+                  ]
+                },
+                "missing_triad": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                }
+              },
+              "additionalProperties": false
+            }
+          },
+          "additionalProperties": false
+        },
+        "scene_total": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "scene_count": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "sort": {
+          "type": "object",
+          "required": [
+            "strategy",
+            "triad_priority"
+          ],
+          "properties": {
+            "strategy": {
+              "type": "string"
+            },
+            "triad_priority": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          },
+          "additionalProperties": false
+        },
+        "scenes": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "scene_id",
+              "summary",
+              "source",
+              "ontology_scope",
+              "ontology_core",
+              "ontology_core_ui",
+              "release_readiness",
+              "release_readiness_ui",
+              "score_preview"
+            ],
+            "properties": {
+              "scene_id": {
+                "type": "string"
+              },
+              "summary": {
+                "type": "object"
+              },
+              "source": {
+                "type": "object"
+              },
+              "ontology_scope": {
+                "$ref": "#/definitions/ontology_scope"
+              },
+              "ontology_core": {
+                "$ref": "#/definitions/ontology_core"
+              },
+              "ontology_core_ui": {
+                "$ref": "#/definitions/ontology_core_ui"
+              },
+              "release_readiness": {
+                "type": "object"
+              },
+              "release_readiness_ui": {
+                "type": "object"
+              },
+              "score_preview": {
+                "type": "object"
+              }
+            },
+            "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
     }
   },
   "additionalProperties": false

package/docs/command-reference.md

@@ -1875,6 +1875,8 @@ sce capability inventory --json
 sce capability inventory --release-ready false --missing-triad decision_strategy --json
 ```
 
+`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:
 - entity + relation

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

@@ -177,3 +177,16 @@ sce capability register --input <template_file> --risk-level <level> --difficult
 4. `/api/capability/map`
 5. `/api/capability/register`
 
+
+## 6. Inventory 固定查询协议
+
+- `query.protocol_version`：前后端协议版本
+- `query.scene_id`：单场景盘点时使用，否则为 `null`
+- `query.limit`：场景返回上限
+- `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

@@ -199,3 +199,18 @@ sce capability register --input <template.json> --json
 - 再按 triad 缺口优先级排序：`decision_strategy` -> `business_rules` -> `entity_relation`
 - 再按 `score_preview.value_score` 降序
 - 最后按 `scene_id` 升序
+
+## 11. 首页固定查询协议
+
+- 使用 `capability-inventory` 返回的 `query` 作为首页请求回显
+- 使用 `sort` 作为排序策略展示来源
+- 首页筛选器应直接映射：`query.filters.release_ready`、`query.filters.missing_triad`
+- 首页顶部可显示：`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);
@@ -914,10 +947,23 @@ async function runCapabilityInventoryCommand(options = {}, dependencies = {}) {
   }
 
   const filteredScenes = sortCapabilityInventoryEntries(filterCapabilityInventoryEntries(scenes, options));
+  const releaseReadyFilterRaw = normalizeText(options.releaseReady || options.release_ready).toLowerCase();
   const payload = {
     mode: 'capability-inventory',
     generated_at: new Date().toISOString(),
+    query: {
+      protocol_version: '1.0',
+      scene_id: normalizeText(options.scene || options.sceneId || options.scene_id) || null,
+      limit: limit,
+      sample_limit: toPositiveInteger(options.sample_limit, 5),
+      filters: {
+        release_ready: releaseReadyFilterRaw ? ['1', 'true', 'yes', 'ready'].includes(releaseReadyFilterRaw) : null,
+        missing_triad: normalizeText(options.missingTriad || options.missing_triad) || null
+      }
+    },
+    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']
@@ -1705,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.23",
+  "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": {