scene-capability-engine 3.6.16 → 3.6.17

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.6.17] - 2026-03-06
+
+### Added
+- Capability catalog/list/search/show/match/use payloads now expose `ontology_core_ui` for direct UI badge rendering.
+- Magicball capability library guide now documents direct triad badge fields for list and match views.
+
 ## [3.6.16] - 2026-03-06
 
 ### Added

package/README.md

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

package/README.zh.md

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

package/docs/command-reference.md

@@ -1896,7 +1896,7 @@ Schema references:
 
 ### Capability Library Reuse (query -> match -> use)
 
-`catalog/show/match/use` responses now include `ontology_core` so UI can render triad readiness directly.
+`catalog/list/search/show/match/use` responses now include `ontology_core` and `ontology_core_ui` so UI can render triad readiness directly.
 
 ```bash
 # List capability templates

package/docs/magicball-capability-library.md

@@ -90,6 +90,14 @@ sce capability use --template <template-id> --spec <spec-id> --apply --json
 
 ## 5. 输出结构（关键字段）
 
+列表、详情、匹配、使用计划里的模板对象都应直接消费：
+- `ontology_core`
+- `ontology_core_ui.ready`
+- `ontology_core_ui.coverage_percent`
+- `ontology_core_ui.missing`
+- `ontology_core_ui.triads.entity_relation|business_rules|decision_strategy`
+
+
 ### capability-match
 ```json
 {
@@ -100,6 +108,16 @@ sce capability use --template <template-id> --spec <spec-id> --apply --json
   "matches": [
     {
       "template_id": "customer-order-core",
+      "ontology_core_ui": {
+        "ready": true,
+        "coverage_percent": 100,
+        "missing": [],
+        "triads": {
+          "entity_relation": true,
+          "business_rules": true,
+          "decision_strategy": true
+        }
+      },
       "score": 82,
       "score_components": {
         "ontology": 0.72,

package/lib/commands/capability.js

@@ -407,6 +407,38 @@ function assertCoreOntologySummary(summary, contextLabel = 'capability template'
   );
 }
 
+function buildOntologyCoreUiState(summary) {
+  const details = summary || buildCoreOntologySummary(createEmptyOntologyScope());
+  const labels = {
+    entity_relation: 'entity_relation',
+    business_rules: 'business_rules',
+    decision_strategy: 'decision_strategy'
+  };
+  return {
+    ready: details.ready === true,
+    coverage_ratio: Number(details.coverage_ratio || 0),
+    coverage_percent: Math.round(Number(details.coverage_ratio || 0) * 100),
+    missing: Array.isArray(details.missing) ? details.missing : [],
+    missing_labels: (Array.isArray(details.missing) ? details.missing : []).map((key) => labels[key] || key),
+    triads: {
+      entity_relation: Boolean(details.triads && details.triads.entity_relation && details.triads.entity_relation.passed),
+      business_rules: Boolean(details.triads && details.triads.business_rules && details.triads.business_rules.passed),
+      decision_strategy: Boolean(details.triads && details.triads.decision_strategy && details.triads.decision_strategy.passed)
+    }
+  };
+}
+
+function enrichCapabilityTemplateForUi(template) {
+  const ontologyCore = template && template.ontology_core
+    ? template.ontology_core
+    : buildCoreOntologySummary(template && template.ontology_scope ? template.ontology_scope : createEmptyOntologyScope());
+  return {
+    ...template,
+    ontology_core: ontologyCore,
+    ontology_core_ui: buildOntologyCoreUiState(ontologyCore)
+  };
+}
+
 async function loadSceneIndexFromFile(projectPath, fileSystem) {
   const indexPath = path.join(projectPath, '.sce', 'spec-governance', 'scene-index.json');
   if (!await fileSystem.pathExists(indexPath)) {
@@ -912,7 +944,8 @@ function displayCapabilityCatalog(templates, options = {}) {
     }
     return;
   }
-  templates.forEach((template) => {
+  templates.forEach((rawTemplate) => {
+    const template = enrichCapabilityTemplateForUi(rawTemplate);
     const sourcePrefix = template.source && template.source !== 'official'
       ? chalk.gray(`[${template.source}] `)
       : '';
@@ -926,13 +959,13 @@ function displayCapabilityCatalog(templates, options = {}) {
 
 async function listCapabilityCatalog(options = {}) {
   const manager = new TemplateManager();
-  const templates = await manager.listTemplates({
+  const templates = (await manager.listTemplates({
     category: options.category,
     source: options.source,
     templateType: 'capability-template',
     compatibleWith: options.compatibleWith,
     riskLevel: options.risk
-  });
+  })).map((template) => enrichCapabilityTemplateForUi(template));
   if (normalizeBoolean(options.json, false)) {
     return {
       mode: 'capability-catalog-list',
@@ -945,13 +978,13 @@ async function listCapabilityCatalog(options = {}) {
 
 async function searchCapabilityCatalog(keyword, options = {}) {
   const manager = new TemplateManager();
-  const templates = await manager.searchTemplates(keyword, {
+  const templates = (await manager.searchTemplates(keyword, {
     category: options.category,
     source: options.source,
     templateType: 'capability-template',
     compatibleWith: options.compatibleWith,
     riskLevel: options.risk
-  });
+  })).map((template) => enrichCapabilityTemplateForUi(template));
   if (normalizeBoolean(options.json, false)) {
     return {
       mode: 'capability-catalog-search',
@@ -965,7 +998,7 @@ async function searchCapabilityCatalog(keyword, options = {}) {
 
 async function showCapabilityTemplate(templatePath, options = {}) {
   const manager = new TemplateManager();
-  const template = await manager.showTemplate(templatePath);
+  const template = enrichCapabilityTemplateForUi(await manager.showTemplate(templatePath));
   const { sourceName, templateId } = parseTemplatePath(templatePath);
   await manager.ensureCached(sourceName);
   const sourcePath = manager.cacheManager.getSourceCachePath(sourceName);
@@ -1038,6 +1071,7 @@ async function matchCapabilityTemplates(options = {}) {
       category: template.category,
       risk_level: template.risk_level,
       ontology_core: template.ontology_core || buildCoreOntologySummary(template.ontology_scope || {}),
+      ontology_core_ui: buildOntologyCoreUiState(template.ontology_core || buildCoreOntologySummary(template.ontology_scope || {})),
       score: Math.round(totalScore * 100),
       score_components: {
         ontology: Number(overlap.score.toFixed(3)),
@@ -1123,7 +1157,8 @@ async function useCapabilityTemplate(options = {}) {
       source: template.source,
       description: template.description,
       ontology_scope: template.ontology_scope || {},
-      ontology_core: template.ontology_core || buildCoreOntologySummary(template.ontology_scope || {})
+      ontology_core: template.ontology_core || buildCoreOntologySummary(template.ontology_scope || {}),
+      ontology_core_ui: buildOntologyCoreUiState(template.ontology_core || buildCoreOntologySummary(template.ontology_scope || {}))
     },
     spec_id: specId,
     recommended_tasks: recommendedTasks

package/package.json

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