scene-capability-engine 3.6.24 → 3.6.26

package/CHANGELOG.md

@@ -7,10 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.6.26] - 2026-03-06
+
+### Added
+- Capability inventory now exposes scene-level advice fields, homepage summary recommendations, and quick filters for Magicball dashboards.
+- Capability iteration schema and Magicball docs now define the homepage recommendation contract.
+
+## [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`), summary recommendations, quick filters, 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.26  
 **Last Updated**: 2026-03-05

package/README.zh.md

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

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

@@ -667,7 +667,10 @@
         "scene_total",
         "scene_count",
         "sort",
-        "scenes"
+        "scenes",
+        "summary_stats",
+        "summary_recommendations",
+        "quick_filters"
       ],
       "properties": {
         "mode": {
@@ -768,7 +771,12 @@
               "ontology_core_ui",
               "release_readiness",
               "release_readiness_ui",
-              "score_preview"
+              "score_preview",
+              "attention_level",
+              "recommended_action",
+              "blocking_summary",
+              "next_action",
+              "next_command"
             ],
             "properties": {
               "scene_id": {
@@ -797,6 +805,111 @@
               },
               "score_preview": {
                 "type": "object"
+              },
+              "attention_level": {
+                "type": "string"
+              },
+              "recommended_action": {
+                "type": "string"
+              },
+              "blocking_summary": {
+                "type": "string"
+              },
+              "next_action": {
+                "type": "string"
+              },
+              "next_command": {
+                "type": "string"
+              }
+            },
+            "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
+        },
+        "summary_recommendations": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "quick_filters": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "id",
+              "label",
+              "query"
+            ],
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "label": {
+                "type": "string"
+              },
+              "query": {
+                "type": "object",
+                "required": [
+                  "release_ready",
+                  "missing_triad"
+                ],
+                "properties": {
+                  "release_ready": {
+                    "type": [
+                      "boolean",
+                      "null"
+                    ]
+                  },
+                  "missing_triad": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  }
+                },
+                "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`, top recommendations in `summary_recommendations`, quick filters in `quick_filters`, 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,9 @@ 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 缺口计数卡
+- `summary_recommendations[]`：首页总览建议
+- `quick_filters[]`：首页快捷筛选配置
 - `sort.strategy`：默认排序策略说明
 - `sort.triad_priority`：triad 优先级数组

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

@@ -205,4 +205,25 @@ 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`：缺实体关系数量
+
+## 13. Scene 卡片建议字段
+
+- `attention_level`：critical/high/medium/low
+- `recommended_action`：卡片主建议
+- `blocking_summary`：一行摘要
+- `next_action`：前端动作 key
+- `next_command`：默认 CLI 建议
+
+## 14. 首页总览建议字段
+
+- `summary_recommendations[]`：顶部全局建议
+- `quick_filters[]`：推荐快捷筛选

package/lib/commands/capability.js

@@ -836,6 +836,134 @@ function resolveCapabilityTriadPriority(entry) {
   return 3;
 }
 
+function buildCapabilityInventorySceneAdvice(entry) {
+  const sceneId = String(entry && entry.scene_id || 'scene.unknown');
+  const releaseUi = entry && entry.release_readiness_ui ? entry.release_readiness_ui : { publish_ready: true, blocking_missing: [] };
+  const missing = Array.isArray(releaseUi.blocking_missing) ? releaseUi.blocking_missing : [];
+  const valueScore = Number(entry && entry.score_preview && entry.score_preview.value_score || 0);
+
+  let attentionLevel = 'low';
+  let recommendedAction = '可直接发布';
+  let blockingSummary = '已满足发布前置条件';
+  let nextAction = 'publish';
+
+  if (!releaseUi.publish_ready) {
+    if (missing.includes('decision_strategy')) {
+      attentionLevel = 'critical';
+      recommendedAction = '补齐决策策略';
+      blockingSummary = '缺决策策略，暂不可发布';
+      nextAction = 'fill_decision_strategy';
+    } else if (missing.includes('business_rules')) {
+      attentionLevel = 'high';
+      recommendedAction = '补齐业务规则';
+      blockingSummary = '缺业务规则，暂不可发布';
+      nextAction = 'fill_business_rules';
+    } else if (missing.includes('entity_relation')) {
+      attentionLevel = 'medium';
+      recommendedAction = '补齐实体关系';
+      blockingSummary = '缺实体关系，暂不可发布';
+      nextAction = 'fill_entity_relation';
+    } else {
+      attentionLevel = 'medium';
+      recommendedAction = '补齐本体能力';
+      blockingSummary = '本体能力不完整，暂不可发布';
+      nextAction = 'repair_ontology_core';
+    }
+  } else if (valueScore >= 70) {
+    attentionLevel = 'low';
+    recommendedAction = '进入模板构建';
+    blockingSummary = '能力成熟度较高，可进入模板构建/发布';
+    nextAction = 'build_template';
+  } else {
+    attentionLevel = 'medium';
+    recommendedAction = '继续补充任务证据';
+    blockingSummary = '已可发布，但建议先补强任务与验证证据';
+    nextAction = 'strengthen_evidence';
+  }
+
+  return {
+    attention_level: attentionLevel,
+    recommended_action: recommendedAction,
+    blocking_summary: blockingSummary,
+    next_action: nextAction,
+    next_command: 'sce capability extract --scene ' + sceneId + ' --json'
+  };
+}
+
+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 buildCapabilityInventorySummaryRecommendations(entries) {
+  const items = Array.isArray(entries) ? entries : [];
+  const recommendations = [];
+  const blocked = items.filter((item) => !(item && item.release_readiness_ui && item.release_readiness_ui.publish_ready));
+  const missingDecision = blocked.filter((item) => Array.isArray(item.release_readiness_ui && item.release_readiness_ui.blocking_missing) && item.release_readiness_ui.blocking_missing.includes('decision_strategy'));
+  const missingRules = blocked.filter((item) => Array.isArray(item.release_readiness_ui && item.release_readiness_ui.blocking_missing) && item.release_readiness_ui.blocking_missing.includes('business_rules'));
+  const readyScenes = items.filter((item) => item && item.release_readiness_ui && item.release_readiness_ui.publish_ready);
+
+  if (missingDecision.length > 0) {
+    recommendations.push('优先处理缺决策策略的 scene（' + missingDecision.length + '）');
+  }
+  if (missingRules.length > 0) {
+    recommendations.push('其次处理缺业务规则的 scene（' + missingRules.length + '）');
+  }
+  if (readyScenes.length > 0) {
+    recommendations.push('可优先推进可发布 scene 进入模板构建（' + readyScenes.length + '）');
+  }
+  if (blocked.length === 0 && readyScenes.length === 0 && items.length > 0) {
+    recommendations.push('当前 scene 已基本稳定，可继续补强验证证据');
+  }
+
+  return recommendations;
+}
+
+function buildCapabilityInventoryQuickFilters(summaryStats) {
+  const stats = summaryStats || { blocked_count: 0, missing_triads: {} };
+  const filters = [];
+  if (Number(stats.blocked_count || 0) > 0) {
+    filters.push({ id: 'blocked', label: '不可发布', query: { release_ready: false, missing_triad: null } });
+  }
+  for (const triad of ['decision_strategy', 'business_rules', 'entity_relation']) {
+    if (Number(stats.missing_triads && stats.missing_triads[triad] || 0) > 0) {
+      filters.push({ id: 'missing_' + triad, label: '缺' + triad, query: { release_ready: false, missing_triad: triad } });
+    }
+  }
+  if (Number(stats.publish_ready_count || 0) > 0) {
+    filters.push({ id: 'ready', label: '可发布', query: { release_ready: true, missing_triad: null } });
+  }
+  return filters;
+}
+
 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);
@@ -900,7 +1028,7 @@ async function runCapabilityInventoryCommand(options = {}, dependencies = {}) {
       ontology_scope: candidate.ontology_scope,
       ontology_core: candidate.ontology_core
     });
-    scenes.push({
+    const sceneEntry = {
       scene_id: sceneId,
       summary: candidate.summary,
       source: candidate.source,
@@ -910,10 +1038,15 @@ async function runCapabilityInventoryCommand(options = {}, dependencies = {}) {
       release_readiness: releaseReadiness,
       release_readiness_ui: buildCapabilityReleaseReadinessUi(releaseReadiness),
       score_preview: score
+    };
+    scenes.push({
+      ...sceneEntry,
+      ...buildCapabilityInventorySceneAdvice(sceneEntry)
     });
   }
 
   const filteredScenes = sortCapabilityInventoryEntries(filterCapabilityInventoryEntries(scenes, options));
+  const summaryStats = buildCapabilityInventorySummaryStats(filteredScenes);
   const releaseReadyFilterRaw = normalizeText(options.releaseReady || options.release_ready).toLowerCase();
   const payload = {
     mode: 'capability-inventory',
@@ -930,6 +1063,9 @@ async function runCapabilityInventoryCommand(options = {}, dependencies = {}) {
     },
     scene_total: scenes.length,
     scene_count: filteredScenes.length,
+    summary_stats: summaryStats,
+    summary_recommendations: buildCapabilityInventorySummaryRecommendations(filteredScenes),
+    quick_filters: buildCapabilityInventoryQuickFilters(summaryStats),
     sort: {
       strategy: 'publish_ready -> missing_triad_priority -> value_score_desc -> scene_id',
       triad_priority: ['decision_strategy', 'business_rules', 'entity_relation']
@@ -1717,5 +1853,9 @@ module.exports = {
   buildCapabilityReleaseReadinessUi,
   filterCapabilityCatalogEntries,
   filterCapabilityInventoryEntries,
-  sortCapabilityInventoryEntries
+  sortCapabilityInventoryEntries,
+  buildCapabilityInventorySceneAdvice,
+  buildCapabilityInventorySummaryStats,
+  buildCapabilityInventorySummaryRecommendations,
+  buildCapabilityInventoryQuickFilters
 };

package/package.json

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