scene-capability-engine 3.6.9 → 3.6.11

package/CHANGELOG.md

@@ -7,6 +7,33 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.6.11] - 2026-03-05
+
+### Added
+- Task quality governance commands:
+  - `sce task draft`
+  - `sce task consolidate`
+  - `sce task score`
+  - `sce task promote`
+- Task quality policy support:
+  - `.sce/config/task-quality-policy.json`
+  - policy overrides via `--policy <path>`
+- Task promotion now emits acceptance suggestions when acceptance criteria are missing.
+
+## [3.6.10] - 2026-03-05
+
+### Added
+- Capability iteration CLI for scene/spec/task history:
+  - `sce capability extract`
+  - `sce capability score`
+  - `sce capability map`
+  - `sce capability register`
+- Extracted capability candidates now include task summaries and scene/spec provenance for UI governance workflows.
+- Added schema references for capability iteration UI contract and ontology mapping.
+- Magicball capability iteration docs:
+  - `docs/magicball-capability-iteration-ui.md`
+  - `docs/magicball-capability-iteration-api.md`
+
 ## [3.6.9] - 2026-03-05
 
 ### Added

package/README.md

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

package/README.zh.md

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

package/bin/scene-capability-engine.js

@@ -26,6 +26,7 @@ const { registerValueCommands } = require('../lib/commands/value');
 const { registerTaskCommands } = require('../lib/commands/task');
 const { registerAuthCommands } = require('../lib/commands/auth');
 const { registerStateCommands } = require('../lib/commands/state');
+const { registerCapabilityCommands } = require('../lib/commands/capability');
 const VersionChecker = require('../lib/version/version-checker');
 const {
   findLegacyKiroDirectories,
@@ -976,6 +977,7 @@ registerValueCommands(program);
 registerTaskCommands(program);
 registerAuthCommands(program);
 registerStateCommands(program);
+registerCapabilityCommands(program);
 
 // Template management commands
 const templatesCommand = require('../lib/commands/templates');

package/docs/agent-runtime/capability-iteration-ui.schema.json

@@ -0,0 +1,226 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://scene-capability-engine.dev/contracts/capability-iteration-ui.schema.json",
+  "title": "Capability Iteration UI Contract",
+  "type": "object",
+  "required": [
+    "candidate",
+    "score",
+    "mapping",
+    "registry"
+  ],
+  "properties": {
+    "candidate": {
+      "$ref": "#/definitions/candidate"
+    },
+    "score": {
+      "$ref": "#/definitions/score"
+    },
+    "mapping": {
+      "$ref": "#/definitions/mapping"
+    },
+    "registry": {
+      "$ref": "#/definitions/registry"
+    }
+  },
+  "definitions": {
+    "candidate": {
+      "type": "object",
+      "required": [
+        "mode",
+        "scene_id",
+        "generated_at",
+        "source",
+        "specs",
+        "summary"
+      ],
+      "properties": {
+        "mode": {
+          "const": "capability-extract"
+        },
+        "scene_id": { "type": "string" },
+        "generated_at": { "type": "string" },
+        "output_file": { "type": "string" },
+        "source": {
+          "type": "object",
+          "required": ["scene_index_source", "spec_count"],
+          "properties": {
+            "scene_index_source": { "type": "string" },
+            "spec_count": { "type": "integer", "minimum": 0 }
+          },
+          "additionalProperties": false
+        },
+        "specs": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["spec_id", "tasks_path", "task_summary"],
+            "properties": {
+              "spec_id": { "type": "string" },
+              "tasks_path": { "type": "string" },
+              "task_error": { "type": "string" },
+              "task_summary": {
+                "type": "object",
+                "required": [
+                  "total",
+                  "completed",
+                  "in_progress",
+                  "queued",
+                  "not_started",
+                  "unknown"
+                ],
+                "properties": {
+                  "total": { "type": "integer", "minimum": 0 },
+                  "completed": { "type": "integer", "minimum": 0 },
+                  "in_progress": { "type": "integer", "minimum": 0 },
+                  "queued": { "type": "integer", "minimum": 0 },
+                  "not_started": { "type": "integer", "minimum": 0 },
+                  "unknown": { "type": "integer", "minimum": 0 }
+                },
+                "additionalProperties": false
+              },
+              "task_sample": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "required": ["id", "title", "status"],
+                  "properties": {
+                    "id": { "type": "string" },
+                    "title": { "type": "string" },
+                    "status": { "type": "string" }
+                  },
+                  "additionalProperties": false
+                }
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        "summary": {
+          "type": "object",
+          "required": ["spec_count", "task_total", "task_completed", "task_pending"],
+          "properties": {
+            "spec_count": { "type": "integer", "minimum": 0 },
+            "task_total": { "type": "integer", "minimum": 0 },
+            "task_completed": { "type": "integer", "minimum": 0 },
+            "task_pending": { "type": "integer", "minimum": 0 }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "score": {
+      "type": "object",
+      "required": [
+        "mode",
+        "scene_id",
+        "generated_at",
+        "input",
+        "scores"
+      ],
+      "properties": {
+        "mode": { "const": "capability-score" },
+        "scene_id": { "type": "string" },
+        "generated_at": { "type": "string" },
+        "input": { "type": "string" },
+        "output_file": { "type": "string" },
+        "scores": {
+          "type": "object",
+          "required": [
+            "completion_rate",
+            "reuse_score",
+            "stability_score",
+            "risk_score",
+            "value_score"
+          ],
+          "properties": {
+            "completion_rate": { "type": "number", "minimum": 0, "maximum": 1 },
+            "reuse_score": { "type": "integer", "minimum": 0, "maximum": 100 },
+            "stability_score": { "type": "integer", "minimum": 0, "maximum": 100 },
+            "risk_score": { "type": "integer", "minimum": 0, "maximum": 100 },
+            "value_score": { "type": "integer", "minimum": 0, "maximum": 100 }
+          },
+          "additionalProperties": false
+        },
+        "summary": { "type": ["object", "null"] }
+      },
+      "additionalProperties": false
+    },
+    "mapping": {
+      "type": "object",
+      "required": [
+        "mode",
+        "scene_id",
+        "generated_at",
+        "input",
+        "template"
+      ],
+      "properties": {
+        "mode": { "const": "capability-map" },
+        "scene_id": { "type": "string" },
+        "generated_at": { "type": "string" },
+        "input": { "type": "string" },
+        "mapping": { "type": ["string", "null"] },
+        "output_file": { "type": "string" },
+        "template": {
+          "type": "object",
+          "required": [
+            "mode",
+            "template_id",
+            "name",
+            "description",
+            "category",
+            "template_type",
+            "scene_id",
+            "ontology_scope",
+            "created_at"
+          ],
+          "properties": {
+            "mode": { "const": "capability-template" },
+            "template_id": { "type": "string" },
+            "name": { "type": "string" },
+            "description": { "type": "string" },
+            "category": { "type": "string" },
+            "template_type": { "const": "capability-template" },
+            "scene_id": { "type": "string" },
+            "tags": { "type": "array", "items": { "type": "string" } },
+            "ontology_scope": {
+              "type": "object",
+              "required": ["domains", "entities", "relations", "business_rules", "decisions"],
+              "properties": {
+                "domains": { "type": "array", "items": { "type": "string" } },
+                "entities": { "type": "array", "items": { "type": "string" } },
+                "relations": { "type": "array", "items": { "type": "string" } },
+                "business_rules": { "type": "array", "items": { "type": "string" } },
+                "decisions": { "type": "array", "items": { "type": "string" } }
+              },
+              "additionalProperties": false
+            },
+            "created_at": { "type": "string" },
+            "source_candidate": { "type": ["object", "null"] }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "registry": {
+      "type": "object",
+      "required": [
+        "mode",
+        "template_id",
+        "output_dir",
+        "files"
+      ],
+      "properties": {
+        "mode": { "const": "capability-register" },
+        "template_id": { "type": "string" },
+        "output_dir": { "type": "string" },
+        "files": { "type": "array", "items": { "type": "string" } }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/docs/command-reference.md

@@ -201,6 +201,26 @@ Task references and studio runtime events are persisted in SQLite state store:
 - In-memory fallback is restricted to `NODE_ENV=test` or `SCE_STATE_ALLOW_MEMORY_FALLBACK=1`.
 - If SQLite runtime support is unavailable outside fallback conditions, `task ref/show/rerun` and `studio events` persistence operations fail fast.
 
+#### Task Quality Governance (draft -> score -> promote)
+
+```bash
+# Create draft from dialogue
+sce task draft --scene scene.customer-order --input "Fix checkout timeout and add retry dashboard" --json
+
+# Consolidate drafts for a scene
+sce task consolidate --scene scene.customer-order --json
+
+# Score draft quality
+sce task score --draft <draft-id> --json
+
+# Promote into tasks.md (quality gate enforced unless --force)
+sce task promote --draft <draft-id> --spec 02-00-checkout-optimization --json
+```
+
+Policy file:
+- `.sce/config/task-quality-policy.json`
+- Fields: `min_quality_score`, `require_acceptance_criteria`, `allow_needs_split`, `auto_suggest_acceptance`, `max_sub_goals`
+
 ### Context & Prompts
 
 ```bash
@@ -1847,6 +1867,27 @@ sce scene template-render --package <name> --values <json-or-path> --out <dir>
 sce scene template-render --package scene-erp --values '{"entity_name":"Order"}' --out ./output --json
 ```
 
+### Capability Iteration (scene -> template -> ontology)
+
+```bash
+# 1) Extract capability candidate from scene history
+sce capability extract --scene scene.customer-order --json
+
+# 2) Score candidate value/reuse/risk
+sce capability score --input .sce/reports/capability-iteration/scene.customer-order.candidate.json --json
+
+# 3) Attach ontology mapping
+sce capability map --input .sce/reports/capability-iteration/scene.customer-order.candidate.json \
+  --mapping .sce/ontology/capability-mapping.json --json
+
+# 4) Export registry-ready capability template package
+sce capability register --input .sce/reports/capability-iteration/scene.customer-order.template.json --json
+```
+
+Schema references:
+- UI contract: `docs/agent-runtime/capability-iteration-ui.schema.json`
+- Ontology mapping: `docs/ontology/capability-mapping.schema.json`
+
 ### Scene Package Batch Publish
 
 ```bash

package/docs/magicball-capability-iteration-api.md

@@ -0,0 +1,154 @@
+# Magicball 能力迭代 API 封装建议（基于 SCE CLI）
+
+> 目标：把 SCE CLI 统一封装成 Magicball 内部 API，方便前端用标准 JSON 调用。
+
+---
+
+## 1. API 设计原则
+
+- **一处封装**：统一执行 CLI，屏蔽差异
+- **JSON 输出**：所有调用带 `--json`
+- **可回放**：每一步的输出落盘并在 UI 可复用
+- **错误可读**：将 stderr 错误结构化返回
+
+---
+
+## 2. 建议 API 列表
+
+### 2.1 Extract
+
+```
+POST /api/capability/extract
+```
+
+请求：
+```json
+{
+  "scene_id": "scene.customer-order",
+  "specs": ["01-00-order", "01-01-inventory"],
+  "sample_limit": 5
+}
+```
+
+执行 CLI：
+```bash
+sce capability extract --scene <scene_id> --specs <specs> --sample-limit <n> --json
+```
+
+响应：
+- 返回 `capability-extract` payload
+
+---
+
+### 2.2 Score
+
+```
+POST /api/capability/score
+```
+
+请求：
+```json
+{
+  "candidate_file": ".sce/reports/capability-iteration/scene.customer-order.candidate.json"
+}
+```
+
+执行 CLI：
+```bash
+sce capability score --input <candidate_file> --json
+```
+
+响应：
+- 返回 `capability-score` payload
+
+---
+
+### 2.3 Map
+
+```
+POST /api/capability/map
+```
+
+请求：
+```json
+{
+  "candidate_file": ".sce/reports/capability-iteration/scene.customer-order.candidate.json",
+  "ontology_file": ".sce/ontology/capability-mapping.json",
+  "template_id": "scene.customer-order",
+  "name": "Capability template: scene.customer-order",
+  "description": "Derived from scene.customer-order"
+}
+```
+
+执行 CLI：
+```bash
+sce capability map --input <candidate_file> --mapping <ontology_file> \
+  --template-id <template_id> --name "<name>" --description "<desc>" --json
+```
+
+响应：
+- 返回 `capability-map` payload
+
+---
+
+### 2.4 Register
+
+```
+POST /api/capability/register
+```
+
+请求：
+```json
+{
+  "template_file": ".sce/reports/capability-iteration/scene.customer-order.template.json",
+  "risk_level": "medium",
+  "difficulty": "intermediate"
+}
+```
+
+执行 CLI：
+```bash
+sce capability register --input <template_file> --risk-level <level> --difficulty <level> --json
+```
+
+响应：
+- 返回 `capability-register` payload
+
+---
+
+## 3. 通用返回结构（建议）
+
+```json
+{
+  "success": true,
+  "data": { ...sce_payload },
+  "stderr": null
+}
+```
+
+失败：
+```json
+{
+  "success": false,
+  "data": null,
+  "stderr": "error message from sce"
+}
+```
+
+---
+
+## 4. 前端调用建议
+
+- 每一步 UI 都展示对应 `data.output_file`（如有）
+- 支持“重新执行”按钮（调用同一 API）
+- 失败时提示 `stderr`，并保留上一步数据可继续
+
+---
+
+## 5. 推荐顺序
+
+1. `/api/capability/extract`
+2. `/api/capability/score`
+3. `/api/capability/map`
+4. `/api/capability/register`
+

package/docs/magicball-capability-iteration-ui.md

@@ -0,0 +1,172 @@
+# Magicball 能力迭代管理（SCE 对接说明）
+
+> 适用于：Magicball AI 助手页面新增顶部图标入口，内部用页签切换。
+> 目标：从历史 `scene/spec/task` 中提炼可复用能力模板，并完成本体映射，形成可发布的能力资产。
+
+---
+
+## 1. 目标与范围
+
+- 目标：从历史 `scene/spec/task` 中提炼能力模板，并完成 ontology 映射闭环。
+- 范围：Magicball UI 新增「能力迭代」入口（顶部图标），内部用页签完成全流程。
+
+---
+
+## 2. UI 草图（文字版）
+
+### 2.1 能力迭代首页（Scene 盘点）
+```
+┌─────────────────────────────────────────────────────────────┐
+│ 能力迭代                                                    │
+│ [筛选：时间 | 完成率 | 风险] [搜索：scene id]                │
+├─────────────────────────────────────────────────────────────┤
+│ Scene卡片：scene.customer-order                              │
+│ - spec: 3  tasks: 42  completed: 36  pending: 6             │
+│ - score: 未评估                                              │
+│ [进入评估]                                                   │
+├─────────────────────────────────────────────────────────────┤
+│ Scene卡片：scene.inventory-reconcile                          │
+│ - spec: 2  tasks: 18  completed: 18  pending: 0             │
+│ [进入评估]                                                   │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### 2.2 评估页（Spec/Task + 评分卡）
+```
+┌───────────────┬─────────────────────────────────────────────┐
+│ Spec列表      │ 评分卡                                        │
+│ - 01-00-demo  │ value: 78  reuse: 66  stability: 85  risk: 20 │
+│ - 01-01-check │ completion: 0.86                              │
+│ - 01-02-order │                                               │
+├───────────────┼─────────────────────────────────────────────┤
+│ Task摘要      │ [生成模板候选]                                │
+│ total: 42     │                                               │
+│ completed:36  │                                               │
+│ pending: 6    │                                               │
+└───────────────┴─────────────────────────────────────────────┘
+```
+
+### 2.3 模板构建页（元信息 + 本体映射）
+```
+┌─────────────────────────────────────────────────────────────┐
+│ 模板信息                                                    │
+│ name: [Capability template: scene.customer-order]            │
+│ desc: [模板描述 ...]                                         │
+│ tags: [order, customer, inventory]                           │
+├─────────────────────────────────────────────────────────────┤
+│ 本体映射                                                     │
+│ domains: [commerce]                                          │
+│ entities: [Order, Customer]                                  │
+│ relations: [Order->Customer]                                 │
+│ business_rules: [OrderApproval]                              │
+│ decisions: [RiskPolicy]                                      │
+├─────────────────────────────────────────────────────────────┤
+│ [保存映射] [进入发布]                                        │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### 2.4 发布页（模板包生成）
+```
+┌─────────────────────────────────────────────────────────────┐
+│ 发布结果                                                    │
+│ template_id: scene.customer-order                             │
+│ output_dir: .sce/templates/exports/capability-scene_customer… │
+│ files:                                                      │
+│ - capability-template.json                                  │
+│ - template-registry.json                                    │
+│ [复制路径] [推送模板库]                                     │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 3. 推荐 UI 架构（顶部图标 + 页签）
+
+顶部图标入口：`能力迭代`
+
+内部页签建议：
+1. `Scene 盘点`
+2. `评估`
+3. `模板构建`
+4. `发布`
+
+状态机建议：
+`extract -> score -> map -> register`
+
+---
+
+## 4. SCE 接口参数（CLI 可封装）
+
+### 4.1 提取候选能力
+```bash
+sce capability extract --scene <sceneId> --json
+```
+可选参数：
+- `--specs <spec-id, spec-id>`
+- `--out <path>`
+- `--sample-limit <n>`
+
+### 4.2 评分
+```bash
+sce capability score --input <candidate.json> --json
+```
+
+### 4.3 本体映射
+```bash
+sce capability map --input <candidate.json> --mapping <ontology.json> --json
+```
+可选参数：
+- `--template-id <id>`
+- `--name <name>`
+- `--description <desc>`
+- `--category <category>`
+- `--tags <tag1,tag2>`
+
+### 4.4 发布模板包
+```bash
+sce capability register --input <template.json> --json
+```
+可选参数：
+- `--out <dir>`
+- `--risk-level <low|medium|high|critical>`
+- `--difficulty <beginner|intermediate|advanced>`
+- `--tags <tag1,tag2>`
+- `--applicable-scenarios <scene1,scene2>`
+
+---
+
+## 5. 数据契约（前端对接）
+
+- UI 契约：`docs/agent-runtime/capability-iteration-ui.schema.json`
+- 本体映射 schema：`docs/ontology/capability-mapping.schema.json`
+
+---
+
+## 6. 前端适配建议
+
+### 6.1 状态管理
+- 采用步骤式状态机：`extract -> score -> map -> register`
+- 每一步输出的 JSON 都持久化，便于回放/复用
+
+### 6.2 体验优化
+- Scene 首页显示完成率、待处理数、评分卡入口
+- 评分卡统一可视化（value/reuse/stability/risk）
+- 本体映射表单应支持快速导入与默认推荐值
+
+### 6.3 错误处理
+- CLI 失败时直接展示错误原因
+- `task_error` 存在时提示 spec 任务文件缺失或解析失败
+- 保留上一步产物可继续重试
+
+### 6.4 权限与治理
+- 若涉及写入本体或发布模板，建议通过 SCE auth lease 授权
+
+---
+
+## 7. 推荐路由
+
+- `/capability` Scene 首页  
+- `/capability/scene/:sceneId` 评估页  
+- `/capability/scene/:sceneId/template` 模板构建页  
+- `/capability/scene/:sceneId/release` 发布页  
+