scene-capability-engine 3.6.27 → 3.6.28

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.6.28] - 2026-03-06
+
+### Added
+- Added shared `mb_status` language across studio task feedback and capability inventory scene advice for Magicball UI rendering.
+- Magicball docs now define the shared status-language contract for task cards and capability cards.
+
 ## [3.6.27] - 2026-03-06
 
 ### Added

package/README.md

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

package/README.zh.md

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

package/docs/command-reference.md

@@ -627,7 +627,7 @@ Studio JSON output now includes a stable UI-oriented task stream contract (in ad
 - `task.commands[]`: `cmd`, `exit_code`, `stdout`, `stderr`, `log_path`
 - `task.errors[]`: `message`, `error_bundle` (copy-ready diagnostic bundle)
 - `task.evidence[]`: structured evidence references
-- `task.feedback_model`: human-facing task feedback (`problem`, `execution`, `diagnosis`, `evidence`, `next_step`)
+- `task.feedback_model`: human-facing task feedback (`problem`, `execution`, `diagnosis`, `evidence`, `next_step`, `mb_status`)
 - `event[]`: raw audit event stream (`studio events` also keeps legacy `events[]` for compatibility)
 - `studio events --openhands-events <path>` switches `source_stream=openhands` and maps OpenHands raw events to the same task contract fields.
 - hierarchical task reference lookup/rerun:

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

@@ -227,3 +227,9 @@ sce capability register --input <template.json> --json
 
 - `summary_recommendations[]`：顶部全局建议
 - `quick_filters[]`：推荐快捷筛选
+
+## 15. Magicball 统一状态语言
+
+- Scene 卡片统一消费 `mb_status`
+- 任务卡统一消费 `task.feedback_model.mb_status`
+- 颜色建议：`danger / warning / info / success`

package/docs/magicball-capability-library.md

@@ -179,3 +179,14 @@ sce capability use --template <template-id> --spec <spec-id> --apply --json
   ]
 }
 ```
+
+### mb_status（统一状态语言）
+```json
+{
+  "attention_level": "critical",
+  "status_tone": "danger",
+  "status_label": "blocked",
+  "blocking_summary": "缺决策策略，暂不可发布",
+  "recommended_action": "补齐决策策略"
+}
+```

package/docs/magicball-task-feedback-timeline-guide.md

@@ -121,3 +121,14 @@ SCE 现在在时间线命令中增加：
 - 时间线优先展示“可恢复、可比较、可追踪”的节点信息
 - 所有字段都以 SCE 输出为准，Magicball 不自行推断
 
+
+## 6. Magicball 统一状态语言
+
+SCE 现在会在任务反馈模型中提供 `mb_status`：
+- `attention_level`
+- `status_tone`
+- `status_label`
+- `blocking_summary`
+- `recommended_action`
+
+Magicball 可直接用这组字段控制颜色、图标、提示文案。

package/lib/commands/capability.js

@@ -836,6 +836,17 @@ function resolveCapabilityTriadPriority(entry) {
   return 3;
 }
 
+function buildCapabilityMagicballStatus(input = {}) {
+  const attention = normalizeText(input.attention_level) || 'medium';
+  return {
+    attention_level: attention,
+    status_tone: attention === 'critical' ? 'danger' : (attention === 'high' ? 'warning' : (attention === 'low' ? 'success' : 'info')),
+    status_label: normalizeText(input.status_label) || null,
+    blocking_summary: normalizeText(input.blocking_summary) || null,
+    recommended_action: normalizeText(input.recommended_action) || null
+  };
+}
+
 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: [] };
@@ -886,7 +897,13 @@ function buildCapabilityInventorySceneAdvice(entry) {
     recommended_action: recommendedAction,
     blocking_summary: blockingSummary,
     next_action: nextAction,
-    next_command: 'sce capability extract --scene ' + sceneId + ' --json'
+    next_command: 'sce capability extract --scene ' + sceneId + ' --json',
+    mb_status: buildCapabilityMagicballStatus({
+      attention_level: attentionLevel,
+      status_label: releaseUi.publish_ready ? 'publish_ready' : 'blocked',
+      blocking_summary: blockingSummary,
+      recommended_action: recommendedAction
+    })
   };
 }
 
@@ -1854,6 +1871,7 @@ module.exports = {
   filterCapabilityCatalogEntries,
   filterCapabilityInventoryEntries,
   sortCapabilityInventoryEntries,
+  buildCapabilityMagicballStatus,
   buildCapabilityInventorySceneAdvice,
   buildCapabilityInventorySummaryStats,
   buildCapabilityInventorySummaryRecommendations,

package/lib/commands/studio.js

@@ -1537,6 +1537,20 @@ function buildTaskFeedbackModel(payload = {}) {
   };
 }
 
+function buildMagicballStatusLanguage(input = {}) {
+  const attention = normalizeString(input.attention_level) || 'medium';
+  const status = normalizeString(input.status) || 'unknown';
+  const blockingSummary = normalizeString(input.blocking_summary) || null;
+  const recommendedAction = normalizeString(input.recommended_action) || null;
+  return {
+    attention_level: attention,
+    status_tone: attention === 'critical' ? 'danger' : (attention === 'high' ? 'warning' : (attention === 'low' ? 'success' : 'info')),
+    status_label: status || 'unknown',
+    blocking_summary: blockingSummary,
+    recommended_action: recommendedAction
+  };
+}
+
 function attachTaskFeedbackModel(payload = {}) {
   if (!payload || typeof payload !== 'object' || !payload.task || typeof payload.task !== 'object') {
     return payload;
@@ -1545,7 +1559,7 @@ function attachTaskFeedbackModel(payload = {}) {
     ...payload,
     task: {
       ...payload.task,
-      feedback_model: buildTaskFeedbackModel(payload)
+      feedback_model: (() => { const model = buildTaskFeedbackModel(payload); return { ...model, mb_status: buildMagicballStatusLanguage({ status: model.execution.status, attention_level: model.diagnosis.root_cause_confidence === 'high' ? 'high' : (model.execution.status === 'completed' ? 'low' : 'medium'), blocking_summary: model.execution.blocking_summary, recommended_action: model.next_step.recommended_action }) }; })()
     }
   };
 }
@@ -3727,6 +3741,7 @@ module.exports = {
   runStudioReleaseCommand,
   runStudioRollbackCommand,
   runStudioEventsCommand,
+  buildMagicballStatusLanguage,
   runStudioPortfolioCommand,
   runStudioBackfillSpecScenesCommand,
   runStudioResumeCommand,

package/package.json

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