scene-capability-engine 3.6.14 → 3.6.16

package/CHANGELOG.md

@@ -7,6 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.6.16] - 2026-03-06
+
+### Added
+- Capability registry validation now enforces ontology core triads for all capability templates.
+- Capability catalog, match, and use payloads now expose `ontology_core` for direct UI rendering.
+- Capability extract now reports triad readiness in candidate summaries.
+
+## [3.6.15] - 2026-03-06
+
+### Added
+- Capability plan apply result now includes preview lines + skipped titles for UI feedback.
+- Capability iteration now enforces ontology core triads by default and exposes triad readiness in catalog/match/use payloads:
+  - entity + relation
+  - business rule
+  - decision strategy
+
 ## [3.6.14] - 2026-03-06
 
 ### Added

package/README.md

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

package/README.zh.md

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

package/docs/command-reference.md

@@ -1869,6 +1869,12 @@ sce scene template-render --package scene-erp --values '{"entity_name":"Order"}'
 
 ### Capability Iteration (scene -> template -> ontology)
 
+Capability candidates are now evaluated against the ontology core triad by default:
+- entity + relation
+- business rule
+- decision strategy
+
+
 ```bash
 # 1) Extract capability candidate from scene history
 sce capability extract --scene scene.customer-order --json
@@ -1890,6 +1896,8 @@ Schema references:
 
 ### Capability Library Reuse (query -> match -> use)
 
+`catalog/show/match/use` responses now include `ontology_core` so UI can render triad readiness directly.
+
 ```bash
 # List capability templates
 sce capability catalog list --json

package/docs/magicball-capability-library.md

@@ -4,6 +4,12 @@
 
 ## 1. 能力库复用流程
 
+能力模板进入能力库前，默认要求补齐本体三项核心能力：
+- 实体关系
+- 业务规则
+- 决策策略
+
+
 1. **查询**能力库（列表/搜索）
 2. **匹配**当前 spec 的问题域（基于 problem-domain-chain 里的 ontology）
 3. **使用**能力模板（生成可执行的 usage plan）
@@ -72,10 +78,10 @@ sce capability use --template <template-id> --spec <spec-id> --apply --json
 
 ### 4.2 能力库列表
 - 支持筛选：category / risk / source
-- 展示关键信息：`name` / `description` / `ontology_scope`
+- 展示关键信息：`name` / `description` / `ontology_scope` / `ontology_core`
 
 ### 4.3 匹配结果
-- 展示 `score` + `score_components`
+- 展示 `score` + `score_components` + `ontology_core.ready`
 - 支持一键生成 usage plan
 
 ### 4.4 使用计划

package/lib/commands/capability.js

@@ -245,6 +245,7 @@ async function appendCapabilityPlanToSpecTasks(options, plan, fileSystem = fs) {
 
   const lines = [];
   const addedTasks = [];
+  const skippedTitles = [];
   let nextTaskId = registry.maxTaskId + 1;
   let duplicateCount = 0;
 
@@ -256,6 +257,7 @@ async function appendCapabilityPlanToSpecTasks(options, plan, fileSystem = fs) {
     const titleKey = title.toLowerCase();
     if (registry.existingTitles.has(titleKey)) {
       duplicateCount += 1;
+      skippedTitles.push(title);
       continue;
     }
     registry.existingTitles.add(titleKey);
@@ -276,8 +278,11 @@ async function appendCapabilityPlanToSpecTasks(options, plan, fileSystem = fs) {
   if (addedTasks.length === 0) {
     return {
       tasks_path: tasksPath,
+      section_title: sectionTitle,
       added_count: 0,
       skipped_duplicates: duplicateCount,
+      skipped_titles: skippedTitles,
+      preview_lines: [],
       skipped_reason: recommended.length === 0
         ? 'no recommended tasks'
         : 'all recommended tasks already exist in tasks.md',
@@ -300,8 +305,11 @@ async function appendCapabilityPlanToSpecTasks(options, plan, fileSystem = fs) {
 
   return {
     tasks_path: tasksPath,
+    section_title: sectionTitle,
     added_count: addedTasks.length,
     skipped_duplicates: duplicateCount,
+    skipped_titles: skippedTitles,
+    preview_lines: lines,
     first_task_id: addedTasks[0].task_id,
     last_task_id: addedTasks[addedTasks.length - 1].task_id,
     added_tasks: addedTasks
@@ -322,6 +330,83 @@ async function loadSpecDomainChain(projectPath, specId, fileSystem) {
   }
 }
 
+function createEmptyOntologyScope() {
+  return {
+    domains: [],
+    entities: [],
+    relations: [],
+    business_rules: [],
+    decisions: []
+  };
+}
+
+function normalizeOntologyScope(scope) {
+  const candidate = scope && typeof scope === 'object' ? scope : {};
+  return {
+    domains: normalizeStringArray(candidate.domains),
+    entities: normalizeStringArray(candidate.entities),
+    relations: normalizeStringArray(candidate.relations),
+    business_rules: normalizeStringArray(candidate.business_rules),
+    decisions: normalizeStringArray(candidate.decisions)
+  };
+}
+
+function mergeOntologyScopes(scopes) {
+  const merged = createEmptyOntologyScope();
+  for (const scope of Array.isArray(scopes) ? scopes : []) {
+    const normalized = normalizeOntologyScope(scope);
+    for (const field of Object.keys(merged)) {
+      const combined = new Set([...(merged[field] || []), ...(normalized[field] || [])]);
+      merged[field] = Array.from(combined);
+    }
+  }
+  return merged;
+}
+
+function buildCoreOntologySummary(scope) {
+  const normalized = normalizeOntologyScope(scope);
+  const triads = {
+    entity_relation: {
+      required_fields: ['entities', 'relations'],
+      entity_count: normalized.entities.length,
+      relation_count: normalized.relations.length,
+      passed: normalized.entities.length > 0 && normalized.relations.length > 0
+    },
+    business_rules: {
+      required_fields: ['business_rules'],
+      count: normalized.business_rules.length,
+      passed: normalized.business_rules.length > 0
+    },
+    decision_strategy: {
+      required_fields: ['decisions'],
+      count: normalized.decisions.length,
+      passed: normalized.decisions.length > 0
+    }
+  };
+  const passedCount = Object.values(triads).filter((item) => item.passed).length;
+  return {
+    ontology_scope: normalized,
+    triads,
+    passed_count: passedCount,
+    total_count: 3,
+    coverage_ratio: Number((passedCount / 3).toFixed(3)),
+    ready: passedCount === 3,
+    missing: Object.entries(triads)
+      .filter(([, value]) => !value.passed)
+      .map(([key]) => key)
+  };
+}
+
+function assertCoreOntologySummary(summary, contextLabel = 'capability template') {
+  const details = summary || buildCoreOntologySummary(createEmptyOntologyScope());
+  if (details.ready) {
+    return details;
+  }
+  throw new Error(
+    `${contextLabel} missing required ontology triads: ${details.missing.join(', ')}`
+  );
+}
+
 async function loadSceneIndexFromFile(projectPath, fileSystem) {
   const indexPath = path.join(projectPath, '.sce', 'spec-governance', 'scene-index.json');
   if (!await fileSystem.pathExists(indexPath)) {
@@ -496,13 +581,22 @@ function buildScoreFromCandidate(candidate) {
   const reuseScore = Math.min(100, Math.round((specCount / 3) * 100));
   const stabilityScore = Math.round(completionRate * 100);
   const riskScore = Math.min(100, Math.round((1 - completionRate) * 100));
-  const valueScore = Math.round((stabilityScore * 0.5) + (reuseScore * 0.3) + ((100 - riskScore) * 0.2));
+  const ontologySummary = buildCoreOntologySummary(candidate && candidate.ontology_scope);
+  const ontologyCoreScore = Math.round(ontologySummary.coverage_ratio * 100);
+  const valueScore = Math.round(
+    (stabilityScore * 0.4) +
+    (reuseScore * 0.2) +
+    ((100 - riskScore) * 0.1) +
+    (ontologyCoreScore * 0.3)
+  );
 
   return {
     completion_rate: Number(completionRate.toFixed(3)),
     reuse_score: reuseScore,
     stability_score: stabilityScore,
     risk_score: riskScore,
+    ontology_core_score: ontologyCoreScore,
+    ontology_core: ontologySummary,
     value_score: valueScore
   };
 }
@@ -518,15 +612,12 @@ function buildTemplateCandidate(candidate, mapping, options) {
     || `Capability template derived from ${sceneId}`;
   const category = normalizeText(options && options.category) || 'capability';
   const tags = normalizeStringArray(options && options.tags);
-  const ontologyScope = (mapping && mapping.ontology_scope && typeof mapping.ontology_scope === 'object')
-    ? mapping.ontology_scope
-    : {
-        domains: [],
-        entities: [],
-        relations: [],
-        business_rules: [],
-        decisions: []
-      };
+  const ontologyScope = normalizeOntologyScope(
+    (mapping && mapping.ontology_scope && typeof mapping.ontology_scope === 'object')
+      ? mapping.ontology_scope
+      : candidate && candidate.ontology_scope
+  );
+  const ontologyCore = buildCoreOntologySummary(ontologyScope);
 
   return {
     mode: 'capability-template',
@@ -538,6 +629,7 @@ function buildTemplateCandidate(candidate, mapping, options) {
     scene_id: sceneId,
     source_candidate: candidate,
     ontology_scope: ontologyScope,
+    ontology_core: ontologyCore,
     tags,
     created_at: new Date().toISOString()
   };
@@ -591,6 +683,8 @@ async function runCapabilityExtractCommand(options = {}, dependencies = {}) {
 
   const taskClaimer = new TaskClaimer();
   const specs = [];
+  const ontologyScopes = [];
+  const ontologyEvidence = [];
 
   for (const specId of specIds) {
     const tasksPath = path.join(projectPath, '.sce', 'specs', specId, 'tasks.md');
@@ -605,6 +699,16 @@ async function runCapabilityExtractCommand(options = {}, dependencies = {}) {
     } else {
       taskError = 'tasks.md missing';
     }
+    const domainChain = await loadSpecDomainChain(projectPath, specId, fileSystem);
+    const specOntologyScope = domainChain.payload ? buildOntologyScopeFromChain(domainChain.payload) : createEmptyOntologyScope();
+    if (domainChain.payload) {
+      ontologyScopes.push(specOntologyScope);
+      ontologyEvidence.push({
+        spec_id: specId,
+        source: path.relative(projectPath, domainChain.path),
+        triads: buildCoreOntologySummary(specOntologyScope)
+      });
+    }
     const taskSummary = summarizeTasks(tasks);
     specs.push({
       spec_id: specId,
@@ -615,10 +719,15 @@ async function runCapabilityExtractCommand(options = {}, dependencies = {}) {
         title: task.title,
         status: task.status
       })),
+      ontology_scope: specOntologyScope,
+      ontology_source: domainChain.exists ? path.relative(projectPath, domainChain.path) : null,
+      ontology_error: domainChain.error || null,
       task_error: taskError
     });
   }
 
+  const ontologyScope = mergeOntologyScopes(ontologyScopes);
+  const ontologyCore = buildCoreOntologySummary(ontologyScope);
   const payload = {
     mode: 'capability-extract',
     scene_id: sceneId,
@@ -628,7 +737,15 @@ async function runCapabilityExtractCommand(options = {}, dependencies = {}) {
       spec_count: specIds.length
     },
     specs,
-    summary: buildCandidateSummary(specs)
+    ontology_scope: ontologyScope,
+    ontology_core: ontologyCore,
+    ontology_evidence: ontologyEvidence,
+    summary: {
+      ...buildCandidateSummary(specs),
+      ontology_triads_ready: ontologyCore.ready,
+      ontology_triads_coverage_ratio: ontologyCore.coverage_ratio,
+      ontology_missing_triads: ontologyCore.missing
+    }
   };
 
   const outputPath = normalizeText(options.out) || buildDefaultCandidatePath(sceneId);
@@ -746,6 +863,11 @@ async function runCapabilityRegisterCommand(options = {}, dependencies = {}) {
   if (!templateCandidate || !templateCandidate.template_id) {
     throw new Error('template_id missing in capability template candidate');
   }
+  const ontologySummary = assertCoreOntologySummary(
+    buildCoreOntologySummary(templateCandidate.ontology_scope),
+    'capability template'
+  );
+  templateCandidate.ontology_scope = ontologySummary.ontology_scope;
 
   const exportDir = normalizeText(options.out) || buildDefaultExportDir(templateCandidate.template_id);
   const outputDirAbs = path.join(projectPath, exportDir);
@@ -764,6 +886,7 @@ async function runCapabilityRegisterCommand(options = {}, dependencies = {}) {
     mode: 'capability-register',
     template_id: templateCandidate.template_id,
     output_dir: exportDir,
+    ontology_core: ontologySummary,
     files: [
       path.join(exportDir, 'capability-template.json'),
       path.join(exportDir, 'template-registry.json')
@@ -914,6 +1037,7 @@ async function matchCapabilityTemplates(options = {}) {
       description: template.description,
       category: template.category,
       risk_level: template.risk_level,
+      ontology_core: template.ontology_core || buildCoreOntologySummary(template.ontology_scope || {}),
       score: Math.round(totalScore * 100),
       score_components: {
         ontology: Number(overlap.score.toFixed(3)),
@@ -998,7 +1122,8 @@ async function useCapabilityTemplate(options = {}) {
       name: template.name,
       source: template.source,
       description: template.description,
-      ontology_scope: template.ontology_scope || {}
+      ontology_scope: template.ontology_scope || {},
+      ontology_core: template.ontology_core || buildCoreOntologySummary(template.ontology_scope || {})
     },
     spec_id: specId,
     recommended_tasks: recommendedTasks

package/lib/templates/registry-parser.js

@@ -124,12 +124,16 @@ class RegistryParser {
    */
   normalizeTemplateEntry(template = {}) {
     const templateType = this._resolveTemplateType(template);
+    const ontologyScope = this._normalizeOntologyScope(template.ontology_scope);
     const normalized = {
       ...template,
       template_type: templateType,
       min_sce_version: template.min_sce_version ?? null,
       max_sce_version: template.max_sce_version ?? null,
-      ontology_scope: this._normalizeOntologyScope(template.ontology_scope),
+      ontology_scope: ontologyScope,
+      ontology_core: templateType === 'capability-template'
+        ? this._buildCapabilityOntologyCore(ontologyScope)
+        : null,
       risk_level: template.risk_level ?? null,
       rollback_contract: this._normalizeRollbackContract(template.rollback_contract),
       applicable_scenarios: Array.isArray(template.applicable_scenarios) ? template.applicable_scenarios : [],
@@ -235,10 +239,10 @@ class RegistryParser {
       if (!this._isPlainObject(ontologyScope)) {
         errors.push(`${prefix}: capability-template requires "ontology_scope" object`);
       } else {
-        const hasAnyScope = ['domains', 'entities', 'relations', 'business_rules', 'decisions']
-          .some((fieldName) => Array.isArray(ontologyScope[fieldName]) && ontologyScope[fieldName].length > 0);
-        if (!hasAnyScope) {
-          errors.push(`${prefix}: capability-template ontology_scope must include at least one non-empty scope array`);
+        const normalizedOntologyScope = this._normalizeOntologyScope(ontologyScope);
+        const ontologyCore = this._buildCapabilityOntologyCore(normalizedOntologyScope);
+        if (!ontologyCore.ready) {
+          errors.push(`${prefix}: capability-template missing required ontology triads: ${ontologyCore.missing.join(', ')}`);
         }
       }
     }
@@ -655,6 +659,42 @@ class RegistryParser {
     return Object.keys(normalized).length > 0 ? normalized : null;
   }
 
+  _buildCapabilityOntologyCore(ontologyScope) {
+    const normalized = this._normalizeOntologyScope(ontologyScope) || {};
+    const entities = Array.isArray(normalized.entities) ? normalized.entities : [];
+    const relations = Array.isArray(normalized.relations) ? normalized.relations : [];
+    const businessRules = Array.isArray(normalized.business_rules) ? normalized.business_rules : [];
+    const decisions = Array.isArray(normalized.decisions) ? normalized.decisions : [];
+    const triads = {
+      entity_relation: {
+        required_fields: ['entities', 'relations'],
+        entity_count: entities.length,
+        relation_count: relations.length,
+        passed: entities.length > 0 && relations.length > 0
+      },
+      business_rules: {
+        required_fields: ['business_rules'],
+        count: businessRules.length,
+        passed: businessRules.length > 0
+      },
+      decision_strategy: {
+        required_fields: ['decisions'],
+        count: decisions.length,
+        passed: decisions.length > 0
+      }
+    };
+    const missing = Object.entries(triads)
+      .filter(([, value]) => !value.passed)
+      .map(([key]) => key);
+
+    return {
+      triads,
+      ready: missing.length === 0,
+      missing,
+      coverage_ratio: Number(((3 - missing.length) / 3).toFixed(3))
+    };
+  }
+
   /**
    * Normalizes rollback contract
    *

package/package.json

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