scene-capability-engine 3.6.19 → 3.6.20

package/CHANGELOG.md

@@ -7,10 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.6.20] - 2026-03-06
+
+### Added
+- Capability catalog entries now expose pre-publish readiness UI fields for badge rendering and sorting.
+- Magicball capability library guide now documents list-level publish readiness fields.
+
 ## [3.6.19] - 2026-03-06
 
 ### Added
 - Capability map/register payloads now expose `release_readiness` with structured blocking reasons for publish UI.
+- Capability catalog payloads now expose `release_readiness_ui` for pre-publish status badges and sorting.
 - Magicball capability docs now define release blocker rendering for capability publish pages.
 
 ## [3.6.18] - 2026-03-06

package/README.md

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

package/README.zh.md

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

package/docs/command-reference.md

@@ -1898,6 +1898,7 @@ Schema references:
 
 `catalog/list/search/show/match/use` responses now include `ontology_core` and `ontology_core_ui` so UI can render triad readiness directly.
 `capability map/register` responses now include `release_readiness` so UI can render blocking reasons before publish.
+Catalog payloads also expose `release_readiness_ui` for pre-publish sorting and status badges.
 
 ```bash
 # List capability templates

package/docs/magicball-capability-library.md

@@ -146,6 +146,17 @@ sce capability use --template <template-id> --spec <spec-id> --apply --json
 
 若需要“自动落地写入 spec 任务”的强制执行模式，可以在后续版本加 `--apply` 开关。
 
+### release_readiness_ui（列表状态）
+```json
+{
+  "publish_ready": false,
+  "blocking_count": 1,
+  "blocking_ids": ["ontology-core-triads"],
+  "blocking_reasons": ["missing required ontology triads"],
+  "blocking_missing": ["decision_strategy"]
+}
+```
+
 ### release_readiness（发布阻断原因）
 ```json
 {

package/lib/commands/capability.js

@@ -432,10 +432,27 @@ function enrichCapabilityTemplateForUi(template) {
   const ontologyCore = template && template.ontology_core
     ? template.ontology_core
     : buildCoreOntologySummary(template && template.ontology_scope ? template.ontology_scope : createEmptyOntologyScope());
+  const releaseReadiness = template && template.release_readiness
+    ? template.release_readiness
+    : {
+        ready: ontologyCore.ready === true,
+        blockers: ontologyCore.ready === true
+          ? []
+          : [{
+              id: 'ontology-core-triads',
+              severity: 'blocking',
+              reason: 'missing required ontology triads',
+              missing: Array.isArray(ontologyCore.missing) ? ontologyCore.missing : []
+            }],
+        ontology_core: ontologyCore,
+        ontology_core_ui: buildOntologyCoreUiState(ontologyCore)
+      };
   return {
     ...template,
     ontology_core: ontologyCore,
-    ontology_core_ui: buildOntologyCoreUiState(ontologyCore)
+    ontology_core_ui: buildOntologyCoreUiState(ontologyCore),
+    release_readiness: releaseReadiness,
+    release_readiness_ui: buildCapabilityReleaseReadinessUi(releaseReadiness)
   };
 }
 
@@ -464,6 +481,20 @@ function buildCapabilityReleaseReadiness(templateCandidate) {
   };
 }
 
+function buildCapabilityReleaseReadinessUi(readiness) {
+  const details = readiness && typeof readiness === 'object'
+    ? readiness
+    : { ready: true, blockers: [] };
+  const blockers = Array.isArray(details.blockers) ? details.blockers : [];
+  return {
+    publish_ready: details.ready === true,
+    blocking_count: blockers.length,
+    blocking_ids: blockers.map((item) => item && item.id).filter(Boolean),
+    blocking_reasons: blockers.map((item) => item && item.reason).filter(Boolean),
+    blocking_missing: blockers.flatMap((item) => Array.isArray(item && item.missing) ? item.missing : [])
+  };
+}
+
 async function loadSceneIndexFromFile(projectPath, fileSystem) {
   const indexPath = path.join(projectPath, '.sce', 'spec-governance', 'scene-index.json');
   if (!await fileSystem.pathExists(indexPath)) {
@@ -1462,5 +1493,12 @@ module.exports = {
   runCapabilityExtractCommand,
   runCapabilityScoreCommand,
   runCapabilityMapCommand,
-  runCapabilityRegisterCommand
+  runCapabilityRegisterCommand,
+  listCapabilityCatalog,
+  searchCapabilityCatalog,
+  showCapabilityTemplate,
+  matchCapabilityTemplates,
+  useCapabilityTemplate,
+  enrichCapabilityTemplateForUi,
+  buildCapabilityReleaseReadinessUi
 };

package/package.json

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