scene-capability-engine 3.6.32 → 3.6.37
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 +109 -11
- package/README.md +119 -122
- package/README.zh.md +123 -121
- package/bin/scene-capability-engine.js +12 -1
- package/docs/331-poc-adaptation-roadmap.md +3 -3
- package/docs/README.md +21 -32
- package/docs/auto-refactor-index.md +384 -0
- package/docs/command-reference.md +99 -7
- package/docs/faq.md +1 -1
- package/docs/interactive-customization/331-poc-sce-integration-checklist.md +3 -3
- package/docs/interactive-customization/moqui-interactive-template-playbook.md +4 -4
- package/docs/interactive-customization/phase-acceptance-evidence.md +2 -2
- package/docs/magicball-adaptation-task-checklist-v1.md +385 -0
- package/docs/magicball-app-bundle-sqlite-and-command-draft.md +539 -0
- package/docs/magicball-capability-iteration-api.md +2 -0
- package/docs/magicball-capability-iteration-ui.md +2 -0
- package/docs/magicball-capability-library.md +2 -0
- package/docs/magicball-cli-invocation-examples.md +336 -0
- package/docs/magicball-frontend-state-and-command-mapping.md +244 -0
- package/docs/magicball-integration-doc-index.md +137 -0
- package/docs/magicball-integration-issue-tracker.md +218 -0
- package/docs/magicball-mode-home-and-ontology-empty-state-playbook.md +249 -0
- package/docs/magicball-sce-adaptation-guide.md +203 -0
- package/docs/magicball-three-mode-alignment-plan.md +551 -0
- package/docs/magicball-ui-surface-checklist.md +126 -0
- package/docs/magicball-write-auth-adaptation-guide.md +328 -0
- package/docs/moqui-standard-rebuild-guide.md +6 -6
- package/docs/moqui-template-core-library-playbook.md +1 -1
- package/docs/refactor-completion-roadmap.md +116 -0
- package/docs/release-checklist.md +50 -27
- package/docs/releases/README.md +1 -0
- package/docs/releases/v3.6.37.md +22 -0
- package/docs/steering-strategy-guide.md +7 -7
- package/docs/troubleshooting.md +1 -1
- package/docs/zh/README.md +27 -30
- package/docs/zh/refactor-completion-roadmap.md +116 -0
- package/docs/zh/release-checklist.md +40 -17
- package/docs/zh/releases/README.md +1 -0
- package/docs/zh/releases/v3.6.37.md +22 -0
- package/lib/app/registry-config.js +73 -0
- package/lib/app/registry-sync-service.js +228 -0
- package/lib/auto/archive-schema-service.js +276 -0
- package/lib/auto/archive-summary.js +60 -0
- package/lib/auto/batch-goal-input-service.js +543 -0
- package/lib/auto/batch-output.js +201 -0
- package/lib/auto/batch-summary-storage-service.js +110 -0
- package/lib/auto/close-loop-batch-service.js +116 -0
- package/lib/auto/close-loop-controller-service.js +287 -0
- package/lib/auto/close-loop-program-service.js +283 -0
- package/lib/auto/close-loop-recovery-service.js +191 -0
- package/lib/auto/close-loop-session-storage-service.js +50 -0
- package/lib/auto/controller-lock-service.js +55 -0
- package/lib/auto/controller-output.js +32 -0
- package/lib/auto/controller-queue-service.js +127 -0
- package/lib/auto/controller-session-storage-service.js +105 -0
- package/lib/auto/governance-advisory-service.js +208 -0
- package/lib/auto/governance-close-loop-service.js +411 -0
- package/lib/auto/governance-maintenance-presenter.js +162 -0
- package/lib/auto/governance-maintenance-service.js +112 -0
- package/lib/auto/governance-session-presenter.js +70 -0
- package/lib/auto/governance-session-storage-service.js +198 -0
- package/lib/auto/governance-signals.js +139 -0
- package/lib/auto/governance-stats-presenter.js +337 -0
- package/lib/auto/governance-stats-service.js +115 -0
- package/lib/auto/governance-summary.js +703 -0
- package/lib/auto/handoff-capability-matrix-service.js +281 -0
- package/lib/auto/handoff-evidence-review-service.js +251 -0
- package/lib/auto/handoff-release-evidence-service.js +190 -0
- package/lib/auto/handoff-release-gate-history-loaders-service.js +502 -0
- package/lib/auto/handoff-release-gate-history-service.js +257 -0
- package/lib/auto/handoff-reporting-service.js +1407 -0
- package/lib/auto/handoff-run-service.js +486 -0
- package/lib/auto/handoff-snapshots-service.js +645 -0
- package/lib/auto/observability-service.js +132 -0
- package/lib/auto/output-writer.js +34 -0
- package/lib/auto/program-auto-remediation-service.js +130 -0
- package/lib/auto/program-diagnostics.js +138 -0
- package/lib/auto/program-governance-helpers.js +306 -0
- package/lib/auto/program-governance-loop-service.js +413 -0
- package/lib/auto/program-output.js +106 -0
- package/lib/auto/program-summary.js +183 -0
- package/lib/auto/recovery-memory-service.js +684 -0
- package/lib/auto/recovery-selection-service.js +52 -0
- package/lib/auto/retention-policy.js +98 -0
- package/lib/auto/session-persistence-service.js +106 -0
- package/lib/auto/session-presenter.js +105 -0
- package/lib/auto/session-prune-service.js +190 -0
- package/lib/auto/session-query-service.js +249 -0
- package/lib/auto/spec-protection.js +141 -0
- package/lib/commands/adopt.js +4 -4
- package/lib/commands/app.js +911 -0
- package/lib/commands/assurance.js +212 -0
- package/lib/commands/auto.js +1093 -11065
- package/lib/commands/mode.js +321 -0
- package/lib/commands/ontology.js +415 -0
- package/lib/commands/pm.js +422 -0
- package/lib/ontology/seed-profiles.js +160 -0
- package/lib/spec/bootstrap/context-collector.js +1 -1
- package/lib/state/sce-state-store.js +3369 -1200
- package/lib/steering/adoption-config.js +2 -2
- package/lib/steering/compliance-cache.js +2 -2
- package/lib/steering/steering-manager.js +4 -4
- package/lib/task/task-claimer.js +1 -2
- package/lib/workspace/multi/workspace-context-resolver.js +3 -3
- package/lib/workspace/multi/workspace-state-manager.js +0 -164
- package/lib/workspace/sce-tracking-audit.js +1 -1
- package/lib/workspace/takeover-baseline.js +1 -1
- package/package.json +1 -1
- package/template/.sce/README.md +1 -1
- package/template/.sce/steering/CORE_PRINCIPLES.md +1 -1
- package/bin/kse.js +0 -3
package/README.zh.md
CHANGED
|
@@ -1,63 +1,109 @@
|
|
|
1
|
-
# SCE - Scene Capability Engine
|
|
1
|
+
# SCE - Scene Capability Engine
|
|
2
2
|
|
|
3
3
|
[](https://badge.fury.io/js/scene-capability-engine)
|
|
4
4
|
[](https://opensource.org/licenses/MIT)
|
|
5
5
|
|
|
6
|
-
**SCE 是面向 AI
|
|
7
|
-
|
|
6
|
+
**SCE 是面向 AI 原生软件交付的场景治理与执行引擎。**
|
|
7
|
+
它把开放式的 Agent 工作,收敛为一条可治理的路径:`goal -> scene -> spec -> task -> patch -> verify -> release`。
|
|
8
8
|
|
|
9
9
|
[English](README.md) | 简体中文
|
|
10
10
|
|
|
11
11
|
---
|
|
12
12
|
|
|
13
|
-
##
|
|
13
|
+
## SCE 解决什么问题
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
AI Agent 可以很快生成代码,但也很容易出现这些问题:
|
|
16
16
|
|
|
17
|
-
-
|
|
18
|
-
-
|
|
19
|
-
-
|
|
20
|
-
-
|
|
17
|
+
- 上下文漂移,越聊越散
|
|
18
|
+
- 需求、设计、任务混在会话里,难以治理
|
|
19
|
+
- 过程资产只存在本地会话中,没推 Git 就容易丢
|
|
20
|
+
- 自动执行虽然快,但缺少稳定门禁和发布证据
|
|
21
|
+
|
|
22
|
+
SCE 提供的就是这一层控制能力:
|
|
23
|
+
|
|
24
|
+
- `Scene 主导上下文`:一个 scene 对应一个主会话,多个 spec 挂在 scene 下持续推进
|
|
25
|
+
- `Spec 先行治理`:需求、设计、任务、门禁都绑定到 spec,而不是散落在聊天记录里
|
|
26
|
+
- `自动闭环可控`:`close-loop`、`close-loop-program`、`close-loop-controller` 都能在边界内自动收敛
|
|
27
|
+
- `本地历史可恢复`:timeline、task ref、SQLite 状态让过程资产可回看、可恢复、可重跑
|
|
28
|
+
- `发布级治理`:handoff 证据、git 管理门禁、errorbook 学习闭环,让“看起来完成”变成“可验证完成”
|
|
21
29
|
|
|
22
30
|
---
|
|
23
31
|
|
|
24
|
-
##
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
| 问题评估路由 | 分阶段风险/证据/就绪度评分 + 强制策略 | `apply/release` 可控阻断,执行路径自适应 |
|
|
36
|
-
| 本地时间线安全 | `timeline save/auto/list/show/restore/push` + 关键节点自动打点 | 本地历史可回放可恢复 |
|
|
37
|
-
| Errorbook 修复体系 | 本地 + 注册表错题库 + 发布门禁 | 定位更快、修复更稳 |
|
|
38
|
-
| 发布治理 | git 管理门禁、errorbook 门禁、handoff preflight、tag 发布链路 | 可审计、可复现发布 |
|
|
32
|
+
## 核心对象模型
|
|
33
|
+
|
|
34
|
+
SCE 用一条稳定层级来管理 Agent 工作:
|
|
35
|
+
|
|
36
|
+
- `session -> scene -> spec -> task -> event`
|
|
37
|
+
- `scene` 是业务连续性的主边界
|
|
38
|
+
- `spec` 是被治理的工作包
|
|
39
|
+
- `task` 是面向人的最小执行单元
|
|
40
|
+
- `event` 保留原始审计流,作为 task 背后的底层记录
|
|
41
|
+
|
|
42
|
+
这让长周期 Agent 执行不再依赖脆弱的聊天上下文,而是依赖可治理的结构化对象。
|
|
39
43
|
|
|
40
44
|
---
|
|
41
45
|
|
|
42
|
-
##
|
|
46
|
+
## 主要能力
|
|
47
|
+
|
|
48
|
+
### 1. Scene + Spec 治理
|
|
49
|
+
- `studio plan` 自动做目标 intake,并绑定或创建 spec
|
|
50
|
+
- scene 维度的 spec 组合治理与历史 spec 回填
|
|
51
|
+
- 场景/规格/任务契约统一落在 `.sce/` 下
|
|
52
|
+
- 支持按 scene 组织长期连续交付
|
|
53
|
+
|
|
54
|
+
### 2. Studio 执行流
|
|
55
|
+
- `studio plan -> generate -> apply -> verify -> release`
|
|
56
|
+
- 面向 IDE / 前端的结构化 task 流
|
|
57
|
+
- 任务引用 `SS.PP.TT`,支持查询和重跑
|
|
58
|
+
- 写操作支持 auth lease 保护
|
|
59
|
+
|
|
60
|
+
### 3. 自动闭环交付
|
|
61
|
+
- `sce auto close-loop`
|
|
62
|
+
- `sce auto close-loop-batch`
|
|
63
|
+
- `sce auto close-loop-program`
|
|
64
|
+
- `sce auto close-loop-controller`
|
|
65
|
+
- 内建 retry、fallback-chain、governance replay、异常感知调度
|
|
66
|
+
|
|
67
|
+
### 4. 问题闭环与 Errorbook
|
|
68
|
+
- problem-domain map / chain / contract / closure gate
|
|
69
|
+
- incident staging,先保留试错过程,再沉淀高价值错题
|
|
70
|
+
- 本地错题本 + 远程注册表联动
|
|
71
|
+
- 默认规则:重复失败后必须补充 debug 证据
|
|
72
|
+
|
|
73
|
+
### 5. 时间线与 SQLite 状态
|
|
74
|
+
- timeline save/list/show/restore/push
|
|
75
|
+
- SQLite 持久化 task/event/session 状态
|
|
76
|
+
- task ref 与 rerun 具备可追踪性和可重放性
|
|
77
|
+
- 支持文件到 SQLite 的渐进迁移与对账
|
|
78
|
+
|
|
79
|
+
### 6. 能力资产化与场景化能力
|
|
80
|
+
- scene/capability inventory 与治理视图
|
|
81
|
+
- 能力抽取、评估、发布闭环
|
|
82
|
+
- 支持 scene runtime 与 ontology 驱动执行
|
|
83
|
+
- 支持面向 Moqui 的能力校验与 handoff 基线
|
|
43
84
|
|
|
85
|
+
---
|
|
86
|
+
|
|
87
|
+
## 快速开始
|
|
88
|
+
|
|
89
|
+
### 安装
|
|
44
90
|
```bash
|
|
45
|
-
# 1) 安装
|
|
46
91
|
npm install -g scene-capability-engine
|
|
92
|
+
```
|
|
47
93
|
|
|
48
|
-
|
|
94
|
+
### 在项目中启用
|
|
95
|
+
```bash
|
|
49
96
|
sce adopt
|
|
97
|
+
```
|
|
50
98
|
|
|
51
|
-
|
|
99
|
+
### 启动一个 scene 治理流程
|
|
100
|
+
```bash
|
|
52
101
|
sce studio plan --scene scene.demo --from-chat session-demo --goal "bootstrap first feature" --json
|
|
53
|
-
|
|
54
|
-
# 4) 生成并执行一个 Spec
|
|
55
102
|
sce spec bootstrap --name 01-00-first-feature --scene scene.demo --non-interactive
|
|
56
103
|
sce spec pipeline run --spec 01-00-first-feature --scene scene.demo
|
|
57
104
|
```
|
|
58
105
|
|
|
59
|
-
|
|
60
|
-
|
|
106
|
+
### 自动闭环推进
|
|
61
107
|
```bash
|
|
62
108
|
sce auto close-loop "deliver customer + order + inventory baseline"
|
|
63
109
|
```
|
|
@@ -66,138 +112,94 @@ sce auto close-loop "deliver customer + order + inventory baseline"
|
|
|
66
112
|
|
|
67
113
|
## 推荐使用路径
|
|
68
114
|
|
|
69
|
-
###
|
|
115
|
+
### 功能交付
|
|
70
116
|
```bash
|
|
71
|
-
sce studio plan --scene scene.customer-order --from-chat session-
|
|
117
|
+
sce studio plan --scene scene.customer-order --from-chat session-20260308 --goal "optimize checkout" --json
|
|
72
118
|
sce spec bootstrap --name 02-00-checkout-optimization --scene scene.customer-order --non-interactive
|
|
73
|
-
sce spec domain coverage --spec 02-00-checkout-optimization --json
|
|
74
119
|
sce spec gate run --spec 02-00-checkout-optimization --scene scene.customer-order --json
|
|
75
120
|
```
|
|
76
121
|
|
|
77
|
-
###
|
|
122
|
+
### 程序级自动交付
|
|
78
123
|
```bash
|
|
79
124
|
sce auto close-loop-program "stabilize order lifecycle and release governance" --program-govern-until-stable --json
|
|
80
125
|
```
|
|
81
126
|
|
|
82
|
-
###
|
|
127
|
+
### 时间线保护
|
|
83
128
|
```bash
|
|
84
129
|
sce timeline save --summary "before risky refactor"
|
|
85
130
|
sce timeline list --limit 20
|
|
86
131
|
sce timeline restore <snapshot-id>
|
|
87
|
-
sce timeline push origin main
|
|
88
132
|
```
|
|
89
133
|
|
|
90
|
-
###
|
|
134
|
+
### 受保护写入
|
|
91
135
|
```bash
|
|
92
|
-
sce
|
|
93
|
-
|
|
94
|
-
git push origin vX.Y.Z
|
|
136
|
+
sce auth grant --scope studio:* --reason "apply approved patch" --auth-password <password> --json
|
|
137
|
+
sce auth status --json
|
|
95
138
|
```
|
|
96
139
|
|
|
97
140
|
---
|
|
98
141
|
|
|
99
|
-
##
|
|
142
|
+
## 默认治理行为
|
|
100
143
|
|
|
101
|
-
SCE
|
|
144
|
+
SCE 默认是强治理的。
|
|
102
145
|
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
- 同一问题指纹失败两轮后,后续尝试必须补充 debug 证据。
|
|
109
|
-
- 当 spec 绑定时,`studio verify/release` 默认执行 `problem-closure-gate`。
|
|
110
|
-
- `studio plan` 默认执行目标 intake(自动绑定已有 spec 或新建 spec),并自动写入 scene 维度的 spec 治理快照。
|
|
111
|
-
- 默认策略会阻断 `studio plan --manual-spec` 与 `--no-spec-governance`(仅在确有必要且策略显式放开时可绕过)。
|
|
112
|
-
- 历史 spec 可通过 `sce studio backfill-spec-scenes --apply` 分批回填到 scene 治理映射(写入 `.sce/spec-governance/spec-scene-overrides.json`)。
|
|
146
|
+
- `studio plan` 默认执行 intake 与 scene/spec 治理,除非策略显式允许绕过
|
|
147
|
+
- 当 spec 绑定时,`verify` 和 `release` 默认执行 problem-closure 等相关门禁
|
|
148
|
+
- `close-loop-program` 默认带 gate 评估、fallback-chain、governance replay、auto-remediation
|
|
149
|
+
- 状态持久化默认优先走 SQLite,而不是零散本地缓存
|
|
150
|
+
- 发布默认验证走 integration gate:`npm run test:release`
|
|
113
151
|
|
|
114
152
|
---
|
|
115
153
|
|
|
116
|
-
##
|
|
117
|
-
|
|
118
|
-
SCE 对工具无锁定,可接入 Codex、Claude Code、Cursor、Windsurf、VS Code Copilot 等。
|
|
119
|
-
|
|
120
|
-
- 运行时上下文统一由 `.sce/` 管理(不依赖特定 IDE 隐藏目录)。
|
|
121
|
-
- 会话治理默认场景优先:`1 scene = 1 primary session`。
|
|
122
|
-
- Spec 执行作为子会话自动归档,支持跨轮次追踪。
|
|
123
|
-
- 启动时会自动识别已接管项目并对齐接管基线默认配置。
|
|
124
|
-
- 多 Agent 抗 429 运行时新增“确定性重试错峰 + 机器可读 `rate-limit:decision` 事件”,可通过 `rateLimitRetrySpreadMs`、`rateLimitLaunchHoldPollMs`、`rateLimitDecisionEventThrottleMs` 调优。
|
|
125
|
-
- 问题评估策略默认启用(`.sce/config/problem-eval-policy.json`),Studio 各阶段都会执行评估。
|
|
126
|
-
- 问题闭环策略默认启用(`.sce/config/problem-closure-policy.json`),缺失必要问题/领域证据时会在 verify/release 阶段阻断。
|
|
127
|
-
- 错误处理默认进入完整 incident 闭环:每次记录先落到 staging 试错链路,verified/promoted 后自动收束归档。
|
|
128
|
-
- 也可显式审计/修正接管基线:
|
|
129
|
-
- `sce workspace takeover-audit --json`
|
|
130
|
-
- `sce workspace takeover-apply --json`
|
|
131
|
-
|
|
132
|
-
Studio 任务流输出契约(默认):
|
|
133
|
-
- ID 字段:`sessionId`、`sceneId`、`specId`、`taskId`、`taskRef`、`eventId`
|
|
134
|
-
- 任务主体:`task.task_ref`、`task.title_norm`、`task.raw_request`、`task.goal`、`task.sub_goals`、`task.acceptance_criteria`、`task.needs_split`、`task.confidence`、`task.status`、`task.summary`(固定三行)、`task.handoff`、`task.next_action`
|
|
135
|
-
- 文件引用:`task.file_changes[]`(`path`、`line`、`diffRef`)
|
|
136
|
-
- 命令执行:`task.commands[]`(`cmd`、`exit_code`、`stdout`、`stderr`、`log_path`)
|
|
137
|
-
- 错误复制:`task.errors[]`(`message`、`error_bundle`,可直接复制给 AI 修复)
|
|
138
|
-
- 证据引用:`task.evidence[]`
|
|
139
|
-
- 原始审计流:`event[]`(`studio events` 同时保留 `events[]` 兼容字段)
|
|
140
|
-
- OpenHands 桥接:`sce studio events --openhands-events <path>` 可将 OpenHands 原始事件映射为同一 task 契约(`source_stream=openhands`)
|
|
141
|
-
- 分层任务引用操作:
|
|
142
|
-
- `sce task ref --scene <scene-id> --spec <spec-id> --task <task-id> --json`
|
|
143
|
-
- `sce task show --ref <SS.PP.TT> --json`
|
|
144
|
-
- `sce task rerun --ref <SS.PP.TT> [--dry-run] --json`
|
|
145
|
-
- 运行时治理状态库策略:
|
|
146
|
-
- 仅支持 SQLite 后端(`.sce/state/sce-state.sqlite`)
|
|
147
|
-
- 仅在 `NODE_ENV=test` 或 `SCE_STATE_ALLOW_MEMORY_FALLBACK=1` 时允许内存回退
|
|
148
|
-
- 在上述条件之外若 SQLite 不可用,任务引用/事件持久化会快速失败
|
|
149
|
-
- 渐进式文件到 SQLite 迁移工具:
|
|
150
|
-
- `sce state plan --json`
|
|
151
|
-
- `sce state doctor --json`
|
|
152
|
-
- `sce state migrate --all --apply --json`
|
|
153
|
-
- `sce state reconcile --all --apply --json`(一键执行 doctor -> migrate -> doctor)
|
|
154
|
-
- `sce state export --out .sce/reports/state-migration/state-export.latest.json --json`
|
|
155
|
-
- 对账门禁:`npm run gate:state-migration-reconciliation`
|
|
156
|
-
- 发布工作流默认对 state reconciliation 启用 enforce,并在发布前执行 reconcile
|
|
157
|
-
- 运行时读取在存在索引数据时优先使用 SQLite(timeline/scene-session 视图)
|
|
158
|
-
- `state doctor` 新增 `summary` 与运行时诊断(`runtime.timeline`、`runtime.scene_session`),可直接读取读源与一致性状态
|
|
159
|
-
- 可迁移组件扩展到 runtime + errorbook + spec-governance + release evidence 索引(`errorbook.entry-index`、`errorbook.incident-index`、`governance.spec-scene-overrides`、`governance.scene-index`、`release.evidence-runs-index`、`release.gate-history-index`)
|
|
160
|
-
- 写入授权租约模型(SQLite 持久化):
|
|
161
|
-
- 策略文件:`.sce/config/authorization-policy.json`
|
|
162
|
-
- 申请租约:`sce auth grant --scope studio:* --reason "<原因>" --auth-password <密码> --json`
|
|
163
|
-
- 查看/撤销:`sce auth status --json` / `sce auth revoke --lease <lease-id> --json`
|
|
164
|
-
- 受保护写操作支持 `--auth-lease <lease-id>`:`studio apply/release/rollback`、`task rerun`
|
|
154
|
+
## 关键集成点
|
|
165
155
|
|
|
166
|
-
|
|
156
|
+
如果你要对接 IDE、AI 助手或前端,优先关注这些接口面:
|
|
157
|
+
|
|
158
|
+
- `sce studio plan|generate|apply|verify|release`
|
|
159
|
+
- `sce studio events --openhands-events <path>`
|
|
160
|
+
- `sce task ref|show|rerun`
|
|
161
|
+
- `sce timeline save|list|show|restore`
|
|
162
|
+
- `sce capability inventory`
|
|
163
|
+
- `sce auth grant|status|revoke`
|
|
164
|
+
- SQLite 状态库:`.sce/state/sce-state.sqlite`
|
|
165
|
+
|
|
166
|
+
面向 MagicBall 的当前关键接口还包括:
|
|
167
167
|
|
|
168
|
-
|
|
168
|
+
- `sce app bundle list|show|register`
|
|
169
|
+
- `sce app registry status|configure|sync*`
|
|
170
|
+
- `sce app runtime show|releases|install|activate`
|
|
171
|
+
- `sce app engineering show|attach|hydrate|activate`
|
|
172
|
+
- `sce mode application|ontology|engineering home`
|
|
173
|
+
- `sce pm requirement|tracking|planning|change|issue ... --json`
|
|
174
|
+
- `sce ontology er|br|dl ... --json`
|
|
175
|
+
- `sce ontology triad summary --json`
|
|
176
|
+
- `sce assurance resource|logs|backup|config ... --json`
|
|
169
177
|
|
|
170
|
-
|
|
171
|
-
- `
|
|
172
|
-
- `
|
|
173
|
-
-
|
|
174
|
-
- `3.5.0`:新增 Studio 目标自动 intake + 场景 spec 组合治理(`sce studio intake`、`sce studio portfolio`),并默认启用 intake 策略基线与治理快照产物,控制场景内 spec 无序增长。
|
|
175
|
-
- `3.4.6`:新增默认 `problem-closure-gate` + `problem-contract` 基线,并强化问题评估强制维度(`problem_contract`/`ontology_alignment`/`convergence`),提升 verify/release 收敛控制。
|
|
176
|
-
- `3.4.5`:`git-managed-gate` 在默认 CI 放宽模式下(`CI/GITHUB_ACTIONS` 且非 strict)对工作区变更改为告警,不再误阻断发布。
|
|
177
|
-
- `3.4.4`:新增 `SCE_GIT_MANAGEMENT_ALLOW_UNTRACKED=1` / `--allow-untracked`;发布工作流在 npm publish 前生成证据资产时可放行未跟踪文件。
|
|
178
|
-
- `3.4.3`:Studio 全阶段接入强制问题评估(`plan/generate/apply/verify/release`),并引入策略文件 `.sce/config/problem-eval-policy.json` 与评估报告落盘。
|
|
179
|
-
- `3.4.2`:Errorbook 升级为完整 incident staging 闭环(尝试记录、incident 查询、resolved 归档)。
|
|
180
|
-
- `3.4.1`:新增 workspace takeover baseline 自动化(`takeover-audit` / `takeover-apply`)与启动对齐能力。
|
|
178
|
+
远端示例 registry:
|
|
179
|
+
- `magicball-app-bundle-registry`
|
|
180
|
+
- `magicball-app-service-catalog`
|
|
181
|
+
- 示例 app key:`customer-order-demo`
|
|
181
182
|
|
|
182
183
|
---
|
|
183
184
|
|
|
184
|
-
##
|
|
185
|
+
## 文档入口
|
|
185
186
|
|
|
186
187
|
建议先看:
|
|
187
188
|
|
|
188
189
|
- [快速开始](docs/zh/quick-start.md)
|
|
190
|
+
- [AI 工具快速开始](docs/quick-start-with-ai-tools.md)
|
|
189
191
|
- [命令参考](docs/command-reference.md)
|
|
190
192
|
- [自动闭环指南](docs/autonomous-control-guide.md)
|
|
191
193
|
- [场景运行时指南](docs/scene-runtime-guide.md)
|
|
192
|
-
- [Value 可观测指南](docs/zh/value-observability-guide.md)
|
|
193
194
|
- [多 Agent 协同指南](docs/multi-agent-coordination-guide.md)
|
|
194
195
|
- [Errorbook 注册表指南](docs/errorbook-registry.md)
|
|
195
196
|
- [文档总览](docs/zh/README.md)
|
|
196
197
|
|
|
197
|
-
Moqui
|
|
198
|
+
Moqui 与能力矩阵相关:
|
|
198
199
|
|
|
199
200
|
- [Moqui 模板核心库 Playbook](docs/moqui-template-core-library-playbook.md)
|
|
200
201
|
- [Moqui 标准重建指南](docs/moqui-standard-rebuild-guide.md)
|
|
202
|
+
- [SCE 能力矩阵路线图](docs/sce-capability-matrix-roadmap.md)
|
|
201
203
|
|
|
202
204
|
---
|
|
203
205
|
|
|
@@ -218,5 +220,5 @@ MIT,见 [LICENSE](LICENSE)。
|
|
|
218
220
|
|
|
219
221
|
---
|
|
220
222
|
|
|
221
|
-
**版本**:3.6.
|
|
222
|
-
**最后更新**:2026-03-
|
|
223
|
+
**版本**:3.6.34
|
|
224
|
+
**最后更新**:2026-03-08
|
|
@@ -979,6 +979,17 @@ registerAuthCommands(program);
|
|
|
979
979
|
registerStateCommands(program);
|
|
980
980
|
registerCapabilityCommands(program);
|
|
981
981
|
|
|
982
|
+
const { registerAppCommands } = require('../lib/commands/app');
|
|
983
|
+
const { registerModeCommands } = require('../lib/commands/mode');
|
|
984
|
+
registerAppCommands(program);
|
|
985
|
+
registerModeCommands(program);
|
|
986
|
+
const { registerPmCommands } = require('../lib/commands/pm');
|
|
987
|
+
registerPmCommands(program);
|
|
988
|
+
const { registerOntologyCommands } = require('../lib/commands/ontology');
|
|
989
|
+
registerOntologyCommands(program);
|
|
990
|
+
const { registerAssuranceCommands } = require('../lib/commands/assurance');
|
|
991
|
+
registerAssuranceCommands(program);
|
|
992
|
+
|
|
982
993
|
// Template management commands
|
|
983
994
|
const templatesCommand = require('../lib/commands/templates');
|
|
984
995
|
|
|
@@ -1107,7 +1118,7 @@ async function updateProjectConfig(projectName) {
|
|
|
1107
1118
|
const skipAutoTakeover = isTakeoverAutoApplySkippedCommand(args);
|
|
1108
1119
|
const skipCheck = isNoMutationCommand(args) ||
|
|
1109
1120
|
args.includes('--skip-steering-check') ||
|
|
1110
|
-
process.env.
|
|
1121
|
+
process.env.SCE_SKIP_STEERING_CHECK === '1';
|
|
1111
1122
|
const forceCheck = args.includes('--force-steering-check');
|
|
1112
1123
|
|
|
1113
1124
|
if (!isLegacyAllowlistedCommand) {
|
|
@@ -54,7 +54,7 @@
|
|
|
54
54
|
- tag 发布时自动将 release notes 草稿、evidence 审阅 markdown、summary JSON 作为 GitHub Release 资产上传。
|
|
55
55
|
- 无 evidence 时至少上传 fallback notes,保证发布资产结构稳定。
|
|
56
56
|
20. 新增可配置发布门禁(workflow 级):
|
|
57
|
-
- 支持通过 `
|
|
57
|
+
- 支持通过 `SCE_RELEASE_*` 仓库变量配置 success rate/risk/ontology 阈值。
|
|
58
58
|
- 支持 advisory(默认)与 enforce(阻断发布)两种模式,且门禁在 `npm publish` 前执行。
|
|
59
59
|
21. 新增 release gate 审计产物:
|
|
60
60
|
- 每次 tag 发布生成 `release-gate-<tag>.json`,记录阈值、观测信号、违规项和判定结果。
|
|
@@ -87,10 +87,10 @@
|
|
|
87
87
|
- 自动检测连续 gate 失败、高风险占比过高、短期风险占比上升。
|
|
88
88
|
- 在 Release Notes 中显式给出 drift alerts,提前暴露质量恶化趋势。
|
|
89
89
|
31. 漂移告警阈值参数化:
|
|
90
|
-
- 支持通过 `
|
|
90
|
+
- 支持通过 `SCE_RELEASE_DRIFT_*` 仓库变量调节 fail streak/high-risk share/delta 阈值。
|
|
91
91
|
- 不同项目可按发布策略调整灵敏度,减少误报或漏报。
|
|
92
92
|
32. 漂移告警阻断模式:
|
|
93
|
-
- 新增 `
|
|
93
|
+
- 新增 `SCE_RELEASE_DRIFT_ENFORCE`,可在漂移告警触发时阻断发布。
|
|
94
94
|
- 保留默认 advisory 模式,确保历史数据不足时不误阻断。
|
|
95
95
|
33. 漂移告警审计写回 gate 报告:
|
|
96
96
|
- `release.yml` 将 drift 评估结果回写到 `release-gate-<tag>.json` 的 `drift` 字段。
|
package/docs/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# SCE Documentation Hub
|
|
2
2
|
|
|
3
|
-
This hub
|
|
3
|
+
This hub keeps only the high-value entry points for adopting, integrating, and scaling SCE.
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -14,47 +14,42 @@ This hub focuses on high-value paths for adopting and scaling SCE.
|
|
|
14
14
|
|
|
15
15
|
---
|
|
16
16
|
|
|
17
|
-
## Delivery
|
|
17
|
+
## Core Delivery Paths
|
|
18
18
|
|
|
19
19
|
- [Spec Workflow](spec-workflow.md)
|
|
20
20
|
- [Autonomous Control Guide](autonomous-control-guide.md)
|
|
21
21
|
- [Multi-Agent Coordination Guide](multi-agent-coordination-guide.md)
|
|
22
|
-
- [Spec Collaboration Guide](spec-collaboration-guide.md)
|
|
23
|
-
- [Spec Locking Guide](spec-locking-guide.md)
|
|
24
|
-
|
|
25
|
-
---
|
|
26
|
-
|
|
27
|
-
## Scene, Ontology, and Moqui
|
|
28
|
-
|
|
29
22
|
- [Scene Runtime Guide](scene-runtime-guide.md)
|
|
30
|
-
- [
|
|
31
|
-
- [
|
|
32
|
-
- [Moqui Standard Rebuild Guide](moqui-standard-rebuild-guide.md)
|
|
33
|
-
- [SCE Capability Matrix Roadmap](sce-capability-matrix-roadmap.md)
|
|
23
|
+
- [Value Observability Guide](value-observability-guide.md)
|
|
24
|
+
- [Refactor Completion And Next Roadmap](refactor-completion-roadmap.md)
|
|
34
25
|
|
|
35
26
|
---
|
|
36
27
|
|
|
37
|
-
## Governance
|
|
28
|
+
## Governance and Release
|
|
38
29
|
|
|
39
|
-
- [Document Governance](document-governance.md)
|
|
40
|
-
- [Security Governance Default Baseline](security-governance-default-baseline.md)
|
|
41
30
|
- [Errorbook Registry Guide](errorbook-registry.md)
|
|
31
|
+
- [Security Governance Default Baseline](security-governance-default-baseline.md)
|
|
32
|
+
- [Document Governance](document-governance.md)
|
|
42
33
|
- [Release Checklist](release-checklist.md)
|
|
43
34
|
- [Release Archive](releases/README.md)
|
|
44
35
|
|
|
45
36
|
---
|
|
46
37
|
|
|
47
|
-
##
|
|
38
|
+
## Scene, Capability, and Moqui
|
|
48
39
|
|
|
49
|
-
- [
|
|
50
|
-
- [
|
|
51
|
-
- [
|
|
52
|
-
- [
|
|
40
|
+
- [Moqui Template Core Library Playbook](moqui-template-core-library-playbook.md)
|
|
41
|
+
- [Moqui Capability Matrix](moqui-capability-matrix.md)
|
|
42
|
+
- [Moqui Standard Rebuild Guide](moqui-standard-rebuild-guide.md)
|
|
43
|
+
- [SCE Capability Matrix Roadmap](sce-capability-matrix-roadmap.md)
|
|
53
44
|
|
|
54
45
|
---
|
|
55
46
|
|
|
56
|
-
## Integrations
|
|
47
|
+
## Platform and Integrations
|
|
57
48
|
|
|
49
|
+
- [Environment Management Guide](environment-management-guide.md)
|
|
50
|
+
- [Multi-Repository Management Guide](multi-repo-management-guide.md)
|
|
51
|
+
- [Team Collaboration Guide](team-collaboration-guide.md)
|
|
52
|
+
- [Manual Workflows Guide](manual-workflows-guide.md)
|
|
58
53
|
- [Cursor Guide](tools/cursor-guide.md)
|
|
59
54
|
- [Claude Code Guide](tools/claude-guide.md)
|
|
60
55
|
- [Windsurf Guide](tools/windsurf-guide.md)
|
|
@@ -63,11 +58,9 @@ This hub focuses on high-value paths for adopting and scaling SCE.
|
|
|
63
58
|
|
|
64
59
|
---
|
|
65
60
|
|
|
66
|
-
##
|
|
61
|
+
## Language
|
|
67
62
|
|
|
68
|
-
- [
|
|
69
|
-
- [Architecture](architecture.md)
|
|
70
|
-
- [Developer Guide](developer-guide.md)
|
|
63
|
+
- [中文文档索引](zh/README.md)
|
|
71
64
|
|
|
72
65
|
---
|
|
73
66
|
|
|
@@ -79,11 +72,7 @@ This hub focuses on high-value paths for adopting and scaling SCE.
|
|
|
79
72
|
|
|
80
73
|
---
|
|
81
74
|
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
- [中文文档索引](zh/README.md)
|
|
75
|
+
**Version**: 3.6.34
|
|
76
|
+
**Last Updated**: 2026-03-08
|
|
85
77
|
|
|
86
|
-
---
|
|
87
78
|
|
|
88
|
-
**Version**: 3.3.26
|
|
89
|
-
**Last Updated**: 2026-03-02
|