scene-capability-engine 3.6.28 → 3.6.29

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [3.6.29] - 2026-03-06
11
+
12
+ ### Added
13
+ - Added shared Magicball schemas for status, task feedback, and timeline view contracts.
14
+ - Command reference and Magicball integration docs now reference the shared schemas explicitly.
15
+
10
16
  ## [3.6.28] - 2026-03-06
11
17
 
12
18
  ### Added
package/README.md CHANGED
@@ -218,5 +218,5 @@ MIT. See [LICENSE](LICENSE).
218
218
 
219
219
  ---
220
220
 
221
- **Version**: 3.6.28
221
+ **Version**: 3.6.29
222
222
  **Last Updated**: 2026-03-05
package/README.zh.md CHANGED
@@ -218,5 +218,5 @@ MIT,见 [LICENSE](LICENSE)。
218
218
 
219
219
  ---
220
220
 
221
- **版本**:3.6.28
221
+ **版本**:3.6.29
222
222
  **最后更新**:2026-03-05
@@ -0,0 +1,33 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "$id": "https://scene-capability-engine.dev/contracts/magicball-status.schema.json",
4
+ "title": "Magicball Shared Status Contract",
5
+ "type": "object",
6
+ "required": [
7
+ "attention_level",
8
+ "status_tone",
9
+ "status_label",
10
+ "blocking_summary",
11
+ "recommended_action"
12
+ ],
13
+ "properties": {
14
+ "attention_level": {
15
+ "type": "string",
16
+ "enum": ["critical", "high", "medium", "low"]
17
+ },
18
+ "status_tone": {
19
+ "type": "string",
20
+ "enum": ["danger", "warning", "info", "success"]
21
+ },
22
+ "status_label": {
23
+ "type": ["string", "null"]
24
+ },
25
+ "blocking_summary": {
26
+ "type": ["string", "null"]
27
+ },
28
+ "recommended_action": {
29
+ "type": ["string", "null"]
30
+ }
31
+ },
32
+ "additionalProperties": false
33
+ }
@@ -0,0 +1,79 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "$id": "https://scene-capability-engine.dev/contracts/magicball-task-feedback.schema.json",
4
+ "title": "Magicball Task Feedback View Contract",
5
+ "type": "object",
6
+ "required": [
7
+ "version",
8
+ "problem",
9
+ "execution",
10
+ "diagnosis",
11
+ "evidence",
12
+ "next_step",
13
+ "mb_status"
14
+ ],
15
+ "properties": {
16
+ "version": {
17
+ "type": "string"
18
+ },
19
+ "problem": {
20
+ "type": "object",
21
+ "required": ["component", "action", "expected", "actual"],
22
+ "properties": {
23
+ "component": { "type": ["string", "null"] },
24
+ "action": { "type": ["string", "null"] },
25
+ "expected": { "type": ["string", "null"] },
26
+ "actual": { "type": ["string", "null"] }
27
+ },
28
+ "additionalProperties": false
29
+ },
30
+ "execution": {
31
+ "type": "object",
32
+ "required": ["stage", "status", "summary", "blocking_summary"],
33
+ "properties": {
34
+ "stage": { "type": "string" },
35
+ "status": { "type": "string" },
36
+ "summary": { "type": "array", "items": { "type": "string" } },
37
+ "blocking_summary": { "type": ["string", "null"] }
38
+ },
39
+ "additionalProperties": false
40
+ },
41
+ "diagnosis": {
42
+ "type": "object",
43
+ "required": ["hypothesis", "chain_checkpoint", "root_cause_confidence"],
44
+ "properties": {
45
+ "hypothesis": { "type": ["string", "null"] },
46
+ "chain_checkpoint": { "type": "string" },
47
+ "root_cause_confidence": { "type": "string", "enum": ["low", "medium", "high"] }
48
+ },
49
+ "additionalProperties": false
50
+ },
51
+ "evidence": {
52
+ "type": "object",
53
+ "required": ["file_count", "file_paths", "command_count", "error_count", "verification_result", "regression_scope"],
54
+ "properties": {
55
+ "file_count": { "type": "integer", "minimum": 0 },
56
+ "file_paths": { "type": "array", "items": { "type": "string" } },
57
+ "command_count": { "type": "integer", "minimum": 0 },
58
+ "error_count": { "type": "integer", "minimum": 0 },
59
+ "verification_result": { "type": "string" },
60
+ "regression_scope": { "type": "array", "items": { "type": "string" } }
61
+ },
62
+ "additionalProperties": false
63
+ },
64
+ "next_step": {
65
+ "type": "object",
66
+ "required": ["recommended_action", "next_action", "next_command"],
67
+ "properties": {
68
+ "recommended_action": { "type": ["string", "null"] },
69
+ "next_action": { "type": ["string", "null"] },
70
+ "next_command": { "type": ["string", "null"] }
71
+ },
72
+ "additionalProperties": false
73
+ },
74
+ "mb_status": {
75
+ "$ref": "./magicball-status.schema.json"
76
+ }
77
+ },
78
+ "additionalProperties": false
79
+ }
@@ -0,0 +1,51 @@
1
+ {
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "$id": "https://scene-capability-engine.dev/contracts/magicball-timeline-view.schema.json",
4
+ "title": "Magicball Timeline View Contract",
5
+ "type": "object",
6
+ "required": ["summary", "entries"],
7
+ "properties": {
8
+ "summary": {
9
+ "type": "object",
10
+ "required": ["total", "latest_snapshot_id", "latest_created_at", "dirty_snapshot_count", "scene_count", "trigger_counts"],
11
+ "properties": {
12
+ "total": { "type": "integer", "minimum": 0 },
13
+ "latest_snapshot_id": { "type": ["string", "null"] },
14
+ "latest_created_at": { "type": ["string", "null"] },
15
+ "dirty_snapshot_count": { "type": "integer", "minimum": 0 },
16
+ "scene_count": { "type": "integer", "minimum": 0 },
17
+ "trigger_counts": {
18
+ "type": "object",
19
+ "additionalProperties": { "type": "integer", "minimum": 0 }
20
+ }
21
+ },
22
+ "additionalProperties": false
23
+ },
24
+ "entries": {
25
+ "type": "array",
26
+ "items": {
27
+ "type": "object",
28
+ "required": ["snapshot_id", "title", "subtitle", "trigger", "event", "created_at", "scene_id", "session_id", "file_count", "branch", "head", "dirty_count", "attention_level", "show_command", "restore_command"],
29
+ "properties": {
30
+ "snapshot_id": { "type": ["string", "null"] },
31
+ "title": { "type": ["string", "null"] },
32
+ "subtitle": { "type": ["string", "null"] },
33
+ "trigger": { "type": ["string", "null"] },
34
+ "event": { "type": ["string", "null"] },
35
+ "created_at": { "type": ["string", "null"] },
36
+ "scene_id": { "type": ["string", "null"] },
37
+ "session_id": { "type": ["string", "null"] },
38
+ "file_count": { "type": "integer", "minimum": 0 },
39
+ "branch": { "type": ["string", "null"] },
40
+ "head": { "type": ["string", "null"] },
41
+ "dirty_count": { "type": "integer", "minimum": 0 },
42
+ "attention_level": { "type": "string", "enum": ["high", "medium", "low"] },
43
+ "show_command": { "type": ["string", "null"] },
44
+ "restore_command": { "type": ["string", "null"] }
45
+ },
46
+ "additionalProperties": false
47
+ }
48
+ }
49
+ },
50
+ "additionalProperties": false
51
+ }
@@ -1902,6 +1902,9 @@ sce capability register --input .sce/reports/capability-iteration/scene.customer
1902
1902
 
1903
1903
  Schema references:
1904
1904
  - UI contract: `docs/agent-runtime/capability-iteration-ui.schema.json`
1905
+ - Magicball shared status: `docs/agent-runtime/magicball-status.schema.json`
1906
+ - Magicball task feedback: `docs/agent-runtime/magicball-task-feedback.schema.json`
1907
+ - Magicball timeline view: `docs/agent-runtime/magicball-timeline-view.schema.json`
1905
1908
  - Ontology mapping: `docs/ontology/capability-mapping.schema.json`
1906
1909
 
1907
1910
  ### Capability Library Reuse (query -> match -> use)
@@ -145,6 +145,7 @@ sce capability register --input <template.json> --json
145
145
  ## 5. 数据契约(前端对接)
146
146
 
147
147
  - UI 契约:`docs/agent-runtime/capability-iteration-ui.schema.json`
148
+ - 统一状态语言:`docs/agent-runtime/magicball-status.schema.json`
148
149
  - 本体映射 schema:`docs/ontology/capability-mapping.schema.json`
149
150
 
150
151
  ---
@@ -2,6 +2,8 @@
2
2
 
3
3
  > 目标:在 Magicball UI 中提供“能力库检索/匹配/使用”闭环,加速场景能力落地。
4
4
 
5
+ Schema reference: `docs/agent-runtime/magicball-status.schema.json`
6
+
5
7
  ## 1. 能力库复用流程
6
8
 
7
9
  能力模板进入能力库前,默认要求补齐本体三项核心能力:
@@ -4,6 +4,12 @@
4
4
 
5
5
  ## 1. 任务反馈模型(来源:`sce studio events --json`)
6
6
 
7
+ Schema references:
8
+ - `docs/agent-runtime/magicball-status.schema.json`
9
+ - `docs/agent-runtime/magicball-task-feedback.schema.json`
10
+ - `docs/agent-runtime/magicball-timeline-view.schema.json`
11
+
12
+
7
13
  SCE 现在在 `task` 下增加:
8
14
  - `feedback_model.version`
9
15
  - `feedback_model.problem`
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "scene-capability-engine",
3
- "version": "3.6.28",
3
+ "version": "3.6.29",
4
4
  "description": "SCE (Scene Capability Engine) - A CLI tool and npm package for spec-driven development with AI coding assistants.",
5
5
  "main": "index.js",
6
6
  "bin": {