scene-capability-engine 3.6.20 → 3.6.21

package/CHANGELOG.md

@@ -7,6 +7,12 @@ 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

package/README.md

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

package/README.zh.md

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

package/docs/command-reference.md

@@ -1903,6 +1903,8 @@ Catalog payloads also expose `release_readiness_ui` for pre-publish sorting and
 ```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
 ```
 

package/lib/commands/capability.js

@@ -1001,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');
@@ -1026,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',
@@ -1045,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',
@@ -1361,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 {
@@ -1369,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) {
@@ -1393,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 {
@@ -1401,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) {
@@ -1500,5 +1536,6 @@ module.exports = {
   matchCapabilityTemplates,
   useCapabilityTemplate,
   enrichCapabilityTemplateForUi,
-  buildCapabilityReleaseReadinessUi
+  buildCapabilityReleaseReadinessUi,
+  filterCapabilityCatalogEntries
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scene-capability-engine",
-  "version": "3.6.20",
+  "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": {