scene-capability-engine 3.6.19 → 3.6.21

package/CHANGELOG.md

@@ -7,10 +7,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.6.21] - 2026-03-06
+
+### Added
+- Capability catalog list/search now supports `--release-ready` and `--missing-triad` filters for pre-publish triage.
+- Magicball capability library docs now show list-level triage filter examples.
+
+## [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.21  
 **Last Updated**: 2026-03-05

package/README.zh.md

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

package/docs/command-reference.md

@@ -1898,10 +1898,13 @@ 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
 sce capability catalog list --json
+sce capability catalog list --release-ready true --json
+sce capability catalog list --missing-triad decision_strategy --json
 
 # Search capability templates
 sce capability catalog search "customer order" --json

package/docs/magicball-capability-library.md

@@ -20,7 +20,9 @@
 
 ```bash
 sce capability catalog list --json
-sce capability catalog search "customer order" --json
+sce capability catalog list --release-ready true --json
+sce capability catalog list --missing-triad decision_strategy --json
+sce capability catalog search "customer order" --release-ready false --json
 sce capability catalog show <template-id> --json
 ```
 
@@ -146,6 +148,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)) {
@@ -970,6 +1001,34 @@ async function runCapabilityRegisterCommand(options = {}, dependencies = {}) {
   return result;
 }
 
+function filterCapabilityCatalogEntries(templates, options = {}) {
+  const entries = Array.isArray(templates) ? templates : [];
+  const normalizedMissingTriad = normalizeText(options.missingTriad || options.missing_triad).toLowerCase();
+  const releaseReadyFilter = normalizeText(options.releaseReady || options.release_ready).toLowerCase();
+
+  return entries.filter((entry) => {
+    const template = enrichCapabilityTemplateForUi(entry);
+
+    if (releaseReadyFilter) {
+      const expected = ['1', 'true', 'yes', 'ready'].includes(releaseReadyFilter);
+      if (template.release_readiness_ui.publish_ready !== expected) {
+        return false;
+      }
+    }
+
+    if (normalizedMissingTriad) {
+      const missing = Array.isArray(template.release_readiness_ui.blocking_missing)
+        ? template.release_readiness_ui.blocking_missing
+        : [];
+      if (!missing.includes(normalizedMissingTriad)) {
+        return false;
+      }
+    }
+
+    return true;
+  });
+}
+
 function displayCapabilityCatalog(templates, options = {}) {
   const total = Array.isArray(templates) ? templates.length : 0;
   console.log(chalk.red('🔥') + ' Capability Library');
@@ -995,13 +1054,13 @@ function displayCapabilityCatalog(templates, options = {}) {
 
 async function listCapabilityCatalog(options = {}) {
   const manager = new TemplateManager();
-  const templates = (await manager.listTemplates({
+  const templates = filterCapabilityCatalogEntries((await manager.listTemplates({
     category: options.category,
     source: options.source,
     templateType: 'capability-template',
     compatibleWith: options.compatibleWith,
     riskLevel: options.risk
-  })).map((template) => enrichCapabilityTemplateForUi(template));
+  })).map((template) => enrichCapabilityTemplateForUi(template)), options);
   if (normalizeBoolean(options.json, false)) {
     return {
       mode: 'capability-catalog-list',
@@ -1014,13 +1073,13 @@ async function listCapabilityCatalog(options = {}) {
 
 async function searchCapabilityCatalog(keyword, options = {}) {
   const manager = new TemplateManager();
-  const templates = (await manager.searchTemplates(keyword, {
+  const templates = filterCapabilityCatalogEntries((await manager.searchTemplates(keyword, {
     category: options.category,
     source: options.source,
     templateType: 'capability-template',
     compatibleWith: options.compatibleWith,
     riskLevel: options.risk
-  })).map((template) => enrichCapabilityTemplateForUi(template));
+  })).map((template) => enrichCapabilityTemplateForUi(template)), options);
   if (normalizeBoolean(options.json, false)) {
     return {
       mode: 'capability-catalog-search',
@@ -1330,6 +1389,8 @@ function registerCapabilityCommands(program) {
     .option('--category <name>', 'Template category filter')
     .option('--compatible-with <semver>', 'SCE version compatibility')
     .option('--risk <level>', 'Risk level filter')
+    .option('--release-ready <bool>', 'Filter by publish readiness')
+    .option('--missing-triad <name>', 'Filter by missing triad (entity_relation|business_rules|decision_strategy)')
     .option('--json', 'Output JSON to stdout')
     .action(async (options) => {
       try {
@@ -1338,6 +1399,8 @@ function registerCapabilityCommands(program) {
           category: options.category,
           compatibleWith: options.compatibleWith,
           risk: options.risk,
+          releaseReady: options.releaseReady,
+          missingTriad: options.missingTriad,
           json: options.json
         });
         if (options.json) {
@@ -1362,6 +1425,8 @@ function registerCapabilityCommands(program) {
     .option('--category <name>', 'Template category filter')
     .option('--compatible-with <semver>', 'SCE version compatibility')
     .option('--risk <level>', 'Risk level filter')
+    .option('--release-ready <bool>', 'Filter by publish readiness')
+    .option('--missing-triad <name>', 'Filter by missing triad (entity_relation|business_rules|decision_strategy)')
     .option('--json', 'Output JSON to stdout')
     .action(async (keyword, options) => {
       try {
@@ -1370,6 +1435,8 @@ function registerCapabilityCommands(program) {
           category: options.category,
           compatibleWith: options.compatibleWith,
           risk: options.risk,
+          releaseReady: options.releaseReady,
+          missingTriad: options.missingTriad,
           json: options.json
         });
         if (options.json) {
@@ -1462,5 +1529,13 @@ module.exports = {
   runCapabilityExtractCommand,
   runCapabilityScoreCommand,
   runCapabilityMapCommand,
-  runCapabilityRegisterCommand
+  runCapabilityRegisterCommand,
+  listCapabilityCatalog,
+  searchCapabilityCatalog,
+  showCapabilityTemplate,
+  matchCapabilityTemplates,
+  useCapabilityTemplate,
+  enrichCapabilityTemplateForUi,
+  buildCapabilityReleaseReadinessUi,
+  filterCapabilityCatalogEntries
 };

package/package.json

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