scene-capability-engine 3.6.65 → 3.6.67
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 +16 -0
- package/README.md +17 -6
- package/README.zh.md +18 -6
- package/bin/scene-capability-engine.js +4 -0
- package/docs/README.md +2 -2
- package/docs/command-reference.md +382 -6
- package/docs/document-governance.md +3 -2
- package/docs/integration-modes.md +62 -478
- package/docs/integration-philosophy.md +56 -263
- package/docs/magicball-project-portfolio-contract.md +114 -2
- package/docs/project-management/README.md +14 -0
- package/docs/project-management/assurance/backup.md +3 -0
- package/docs/project-management/assurance/config.md +3 -0
- package/docs/project-management/assurance/evidence/README.md +3 -0
- package/docs/project-management/assurance/incidents/README.md +3 -0
- package/docs/project-management/assurance/logs.md +3 -0
- package/docs/project-management/assurance/overview.md +3 -0
- package/docs/project-management/assurance/recovery/README.md +3 -0
- package/docs/project-management/assurance/resource.md +3 -0
- package/docs/project-management/assurance/runbooks/README.md +3 -0
- package/docs/project-management/delivery/acceptance/README.md +3 -0
- package/docs/project-management/delivery/acceptance/evidence/README.md +3 -0
- package/docs/project-management/delivery/acceptance/exceptions/README.md +3 -0
- package/docs/project-management/delivery/acceptance/reports/README.md +3 -0
- package/docs/project-management/delivery/documents/changes.md +3 -0
- package/docs/project-management/delivery/documents/issues.md +3 -0
- package/docs/project-management/delivery/documents/overview.md +3 -0
- package/docs/project-management/delivery/documents/planning.md +3 -0
- package/docs/project-management/delivery/documents/requirements.md +3 -0
- package/docs/project-management/delivery/documents/tracking.md +3 -0
- package/docs/project-management/delivery/handoffs/README.md +3 -0
- package/docs/project-management/delivery/handoffs/evidence/README.md +3 -0
- package/docs/project-management/delivery/handoffs/records/README.md +3 -0
- package/docs/project-management/delivery/overview.md +10 -0
- package/docs/project-management/delivery/releases/README.md +3 -0
- package/docs/project-management/delivery/releases/baselines/README.md +3 -0
- package/docs/project-management/delivery/releases/evidence/README.md +3 -0
- package/docs/project-management/delivery/tables/changes.md +3 -0
- package/docs/project-management/delivery/tables/issues.md +3 -0
- package/docs/project-management/delivery/tables/planning.md +3 -0
- package/docs/project-management/delivery/tables/requirements.md +3 -0
- package/docs/project-management/delivery/tables/tracking.md +3 -0
- package/docs/project-management/environment/agent-discovery.md +3 -0
- package/docs/project-management/environment/development.md +3 -0
- package/docs/project-management/environment/overview.md +10 -0
- package/docs/project-management/environment/testing.md +3 -0
- package/docs/project-management/environment/version-alignment.md +3 -0
- package/docs/quick-start-with-ai-tools.md +68 -308
- package/docs/releases/README.md +2 -0
- package/docs/releases/v3.6.66.md +23 -0
- package/docs/releases/v3.6.67.md +23 -0
- package/docs/steering-governance.md +64 -2
- package/docs/zh/README.md +2 -2
- package/docs/zh/releases/README.md +2 -0
- package/docs/zh/releases/v3.6.66.md +23 -0
- package/docs/zh/releases/v3.6.67.md +23 -0
- package/lib/commands/adopt.js +24 -0
- package/lib/commands/native.js +158 -0
- package/lib/commands/project.js +95 -0
- package/lib/commands/semantic.js +1459 -0
- package/lib/commands/session.js +74 -3
- package/lib/commands/spec-bootstrap.js +10 -1
- package/lib/commands/spec-gate.js +10 -1
- package/lib/commands/spec-pipeline.js +10 -1
- package/lib/commands/studio.js +405 -30
- package/lib/commands/task.js +141 -7
- package/lib/governance/supreme-principles.js +530 -0
- package/lib/problem/problem-evaluator.js +4 -0
- package/lib/project/candidate-inspection-service.js +24 -1
- package/lib/project/portfolio-projection-service.js +315 -5
- package/lib/project/project-channel-output.js +94 -0
- package/lib/project/project-channel-projection.js +181 -0
- package/lib/project/root-onboarding-service.js +60 -8
- package/lib/project/semantic-shared-source-projection.js +150 -0
- package/lib/project/supervision-action-model.js +277 -0
- package/lib/project/supervision-projection-service.js +305 -5
- package/lib/project/target-resolution-service.js +70 -5
- package/lib/project/visibility-policy.js +93 -0
- package/lib/runtime/multi-spec-scene-session.js +8 -1
- package/lib/runtime/project-channel-context-store.js +387 -0
- package/lib/runtime/project-channel-context.js +406 -0
- package/lib/runtime/scene-session-binding.js +46 -0
- package/lib/runtime/session-store.js +186 -0
- package/lib/runtime/steering-contract.js +7 -1
- package/lib/semantic/archive-report.js +283 -0
- package/lib/semantic/archive-routing.js +67 -0
- package/lib/semantic/backflow-report.js +245 -0
- package/lib/semantic/capability-contract.js +30 -0
- package/lib/semantic/delta-export.js +145 -0
- package/lib/semantic/interaction-observer.js +254 -0
- package/lib/semantic/kernel-loader.js +881 -0
- package/lib/semantic/native-runtime.js +359 -0
- package/lib/semantic/progress-ledger.js +433 -0
- package/lib/semantic/replay-evaluator.js +382 -0
- package/lib/semantic/shared-publication.js +592 -0
- package/lib/semantic/shared-source-config.js +183 -0
- package/lib/semantic/shared-source-connect.js +139 -0
- package/lib/semantic/shared-source-discovery.js +98 -0
- package/lib/semantic/shared-sync-export.js +413 -0
- package/lib/semantic/shared-sync-intake.js +592 -0
- package/lib/semantic/shared-sync-merge.js +547 -0
- package/lib/semantic/shared-sync-release.js +463 -0
- package/lib/semantic/supreme-intent-report.js +300 -0
- package/lib/state/sce-state-store.js +1360 -0
- package/lib/steering/context-sync-manager.js +276 -25
- package/lib/studio/spec-intake-governor.js +39 -3
- package/lib/studio/task-envelope.js +35 -2
- package/lib/workspace/takeover-baseline.js +342 -83
- package/package.json +7 -2
- package/scripts/agent-governance-baseline-audit.js +395 -0
- package/scripts/clarification-first-audit.js +9 -9
- package/scripts/deprecated-entry-audit.js +240 -0
- package/scripts/release-posture-report.js +262 -0
- package/template/.sce/README.md +62 -228
- package/template/.sce/config/semantic-shared-sources.json +5 -0
- package/template/.sce/config/supreme-principles-policy.json +105 -0
- package/template/.sce/config/takeover-baseline.json +7 -0
- package/template/.sce/steering/CORE_PRINCIPLES.md +23 -63
- package/template/.sce/steering/CURRENT_CONTEXT.md +4 -0
- package/template/.sce/steering/RULES_GUIDE.md +17 -9
- package/template/README.md +32 -96
package/CHANGELOG.md
CHANGED
|
@@ -7,6 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
7
7
|
|
|
8
8
|
## [Unreleased]
|
|
9
9
|
|
|
10
|
+
## [3.6.67] - 2026-03-29
|
|
11
|
+
|
|
12
|
+
### Fixed
|
|
13
|
+
- Relaxed `audit:agent-governance` so a clean-room checkout no longer hard-fails release validation just because the gitignored personal file `.sce/steering/CURRENT_CONTEXT.md` is absent.
|
|
14
|
+
|
|
15
|
+
## [3.6.66] - 2026-03-28
|
|
16
|
+
|
|
17
|
+
### Added
|
|
18
|
+
- Added `audit:deprecated-entry` plus `report:release-posture`/`gate:release-posture` so top-level entry docs and stable-release posture are now machine-checked instead of being left to manual interpretation.
|
|
19
|
+
- Added a dedicated `release-extended-evidence.yml` workflow so Moqui, matrix, weekly-ops, and other heavy release evidence can be generated independently from the stable publish gate.
|
|
20
|
+
|
|
21
|
+
### Changed
|
|
22
|
+
- Rebuilt `release.yml` into a stable-core release pipeline that gates publish on release tests, governance audits, deprecated-entry audit, git-managed gate, errorbook gates, and stable posture verification.
|
|
23
|
+
- Rewrote top-level integration entry docs and template entry docs so SCE now leads with the governed `project -> channel/session -> scene/spec` model, while `context export / prompt generate` stay documented only as compatibility paths.
|
|
24
|
+
- Promoted current release posture from `rc-candidate` to `stable` after separating stable-core and extended evidence, and after wiring deprecated-entry governance into CI/release baselines.
|
|
25
|
+
|
|
10
26
|
## [3.6.65] - 2026-03-22
|
|
11
27
|
|
|
12
28
|
### Added
|
package/README.md
CHANGED
|
@@ -16,7 +16,7 @@ AI agents can generate code quickly, but they also drift, over-create context, l
|
|
|
16
16
|
|
|
17
17
|
SCE provides the missing control layer:
|
|
18
18
|
|
|
19
|
-
- `Scene-governed context`:
|
|
19
|
+
- `Scene-governed context`: `scene` stays the semantic boundary, while one project can host many channels/sessions in parallel and each channel keeps its own scene + spec focus.
|
|
20
20
|
- `Spec-first execution`: requirements, design, tasks, and gates stay attached to the work, not buried in chat history.
|
|
21
21
|
- `Bounded autonomous delivery`: agents can run `close-loop`, `close-loop-program`, and `close-loop-controller` with retry, fallback, and governance policies.
|
|
22
22
|
- `Recoverable local history`: timeline snapshots, task refs, and SQLite-backed state keep work recoverable even before Git push.
|
|
@@ -26,10 +26,12 @@ SCE provides the missing control layer:
|
|
|
26
26
|
|
|
27
27
|
## Core Model
|
|
28
28
|
|
|
29
|
-
SCE organizes agent work using one stable
|
|
29
|
+
SCE organizes agent work using one stable semantic/collaboration model:
|
|
30
30
|
|
|
31
|
-
- `
|
|
31
|
+
- `project -> scene -> spec`
|
|
32
|
+
- `project -> channel/session -> (scene + spec focus) -> task -> event`
|
|
32
33
|
- `scene` is the continuity boundary
|
|
34
|
+
- `channel/session` is the collaboration thread, not the semantic domain
|
|
33
35
|
- `spec` is the governed work package
|
|
34
36
|
- `task` is the smallest user-facing execution unit
|
|
35
37
|
- `event` remains the raw audit stream behind the task view
|
|
@@ -49,7 +51,7 @@ This gives you a predictable way to manage long-running agent work without relyi
|
|
|
49
51
|
### 2. Studio Execution Flow
|
|
50
52
|
- `studio plan -> generate -> apply -> verify -> release`
|
|
51
53
|
- Structured task stream for frontend or IDE integration
|
|
52
|
-
-
|
|
54
|
+
- Hierarchical task refs (`scene.spec.task` / `SS.PP.TT`) for lookup, controlled rerun, and rerun hints aligned to the original `project + channel` focus
|
|
53
55
|
- Auth lease model for protected write operations
|
|
54
56
|
|
|
55
57
|
### 3. Autonomous Delivery
|
|
@@ -74,6 +76,11 @@ This gives you a predictable way to manage long-running agent work without relyi
|
|
|
74
76
|
### 6. Capability and Scene Assetization
|
|
75
77
|
- Scene/capability inventory and governance views
|
|
76
78
|
- Capability extraction, evaluation, and publication workflow
|
|
79
|
+
- Semantic observation, replay evaluation, local promotion, governed delta export, and native backflow rerank
|
|
80
|
+
- Shared-library mirror publication that advances qualified lessons from `publish_pending` to `published-shared`
|
|
81
|
+
- `semantic promote` now auto-publishes qualified lessons by default under the adopt-implied model
|
|
82
|
+
- Shared-sync handoff bundle export that packages the local semantic mirror into spec-scoped bundle/index/shards/receipt artifacts
|
|
83
|
+
- Shared-sync intake that lets another terminal sync governed bundle output back into its local semantic mirror
|
|
77
84
|
- Scene runtime and ontology-oriented execution support
|
|
78
85
|
- Moqui-oriented capability validation and handoff baselines
|
|
79
86
|
|
|
@@ -139,7 +146,11 @@ sce auth status --json
|
|
|
139
146
|
SCE is opinionated by default.
|
|
140
147
|
|
|
141
148
|
- `studio plan` runs intake and scene/spec governance unless policy explicitly allows bypass.
|
|
149
|
+
- `studio plan`, `studio intake`, and `native ask` pass through the Four Teachings supreme-intent gate first; off-track requests are clarified, rewritten, narrowed, or refused before execution, and existing bound Specs receive governed evidence.
|
|
142
150
|
- When business scene/module/page/entity context is missing, SCE must route to clarification first; unknown business scope must not be turned into blanket disable.
|
|
151
|
+
- `CORE_PRINCIPLES.md` keeps only `Four Teachings + Little Nine` in the supreme-principle layer; execution baselines belong in `RULES_GUIDE.md`, and reusable tactics belong in governance docs or lessons.
|
|
152
|
+
- After two failed localization rounds, record/update an `errorbook` incident and use bisection-style debug logs to keep halving the failing scope instead of continuing blind patch attempts.
|
|
153
|
+
- Agent-generated scripts, reports, debug logs, test scripts, and temporary analysis default to the active Spec subdirectories; if no explicit Spec exists yet, use a governed general Spec instead of scattering files.
|
|
143
154
|
- `spec pipeline` and `spec gate` now carry a read-only strategy advisory for single-Spec runs, so broad or clarification-heavy work is surfaced as `multi-spec-program` / `research-program` instead of being blindly forced deeper into one Spec.
|
|
144
155
|
- `verify` and `release` enforce problem-closure and related gates when a spec is bound.
|
|
145
156
|
- Autonomous program execution applies gate evaluation, fallback-chain logic, governance replay, and auto-remediation.
|
|
@@ -230,5 +241,5 @@ MIT. See [LICENSE](LICENSE).
|
|
|
230
241
|
|
|
231
242
|
---
|
|
232
243
|
|
|
233
|
-
**Version**: 3.6.
|
|
234
|
-
**Last Updated**: 2026-03-
|
|
244
|
+
**Version**: 3.6.67
|
|
245
|
+
**Last Updated**: 2026-03-29
|
package/README.zh.md
CHANGED
|
@@ -21,7 +21,7 @@ AI Agent 可以很快生成代码,但也很容易出现这些问题:
|
|
|
21
21
|
|
|
22
22
|
SCE 提供的就是这一层控制能力:
|
|
23
23
|
|
|
24
|
-
- `Scene
|
|
24
|
+
- `Scene 主导上下文`:`scene` 是稳定语义边界,一个项目可并行存在多条 `channel/session`,每条通道各自维护当前 `scene + spec` 焦点
|
|
25
25
|
- `Spec 先行治理`:需求、设计、任务、门禁都绑定到 spec,而不是散落在聊天记录里
|
|
26
26
|
- `自动闭环可控`:`close-loop`、`close-loop-program`、`close-loop-controller` 都能在边界内自动收敛
|
|
27
27
|
- `本地历史可恢复`:timeline、task ref、SQLite 状态让过程资产可回看、可恢复、可重跑
|
|
@@ -31,10 +31,12 @@ SCE 提供的就是这一层控制能力:
|
|
|
31
31
|
|
|
32
32
|
## 核心对象模型
|
|
33
33
|
|
|
34
|
-
SCE
|
|
34
|
+
SCE 用一条稳定的“语义链 + 协作链”来管理 Agent 工作:
|
|
35
35
|
|
|
36
|
-
- `
|
|
36
|
+
- `project -> scene -> spec`
|
|
37
|
+
- `project -> channel/session -> (scene + spec focus) -> task -> event`
|
|
37
38
|
- `scene` 是业务连续性的主边界
|
|
39
|
+
- `channel/session` 是协作线程,不是问题域本身
|
|
38
40
|
- `spec` 是被治理的工作包
|
|
39
41
|
- `task` 是面向人的最小执行单元
|
|
40
42
|
- `event` 保留原始审计流,作为 task 背后的底层记录
|
|
@@ -54,7 +56,7 @@ SCE 用一条稳定层级来管理 Agent 工作:
|
|
|
54
56
|
### 2. Studio 执行流
|
|
55
57
|
- `studio plan -> generate -> apply -> verify -> release`
|
|
56
58
|
- 面向 IDE / 前端的结构化 task 流
|
|
57
|
-
-
|
|
59
|
+
- 层级任务引用(`scene.spec.task` / `SS.PP.TT`),支持查询、受控重跑与按原 `project + channel` 焦点生成重跑提示
|
|
58
60
|
- 写操作支持 auth lease 保护
|
|
59
61
|
|
|
60
62
|
### 3. 自动闭环交付
|
|
@@ -79,6 +81,11 @@ SCE 用一条稳定层级来管理 Agent 工作:
|
|
|
79
81
|
### 6. 能力资产化与场景化能力
|
|
80
82
|
- scene/capability inventory 与治理视图
|
|
81
83
|
- 能力抽取、评估、发布闭环
|
|
84
|
+
- 支持语义观测、replay 评估、本地推广、共享 delta 导出与 native 回流重排
|
|
85
|
+
- 支持 shared-library mirror 发布,把合格能力从 `publish_pending` 推进到 `published-shared`
|
|
86
|
+
- `semantic promote` 默认按 adopt-implied 模型立即自动共享发布合格能力
|
|
87
|
+
- 支持 shared-sync handoff bundle 导出,把本地 semantic mirror 打包成 spec 内受治理的 bundle/index/shards/receipt
|
|
88
|
+
- 支持 shared-sync intake,把其他终端导出的受治理 bundle 同步回本地 semantic mirror
|
|
82
89
|
- 支持 scene runtime 与 ontology 驱动执行
|
|
83
90
|
- 支持面向 Moqui 的能力校验与 handoff 基线
|
|
84
91
|
|
|
@@ -145,11 +152,16 @@ SCE 默认是强治理的。
|
|
|
145
152
|
|
|
146
153
|
- `studio plan` 默认执行 intake 与 scene/spec 治理,除非策略显式允许绕过
|
|
147
154
|
- 缺少业务场景/模块/页面/实体上下文时,SCE 必须先进入澄清,而不是把未知业务范围直接变成一刀切禁用
|
|
155
|
+
- 连续两轮以上仍未成功定位问题时,SCE 默认要求先补 `errorbook` incident,再用二分式 debug 日志快速收敛范围
|
|
148
156
|
- 单 spec 的 `spec pipeline` 和 `spec gate` 现在都会附带只读策略建议;当问题已经更适合 `multi-spec-program` / `research-program` 时,SCE 会显式提示,而不是继续把复杂问题盲目压进同一个 spec
|
|
149
157
|
- 当 spec 绑定时,`verify` 和 `release` 默认执行 problem-closure 等相关门禁
|
|
150
158
|
- `close-loop-program` 默认带 gate 评估、fallback-chain、governance replay、auto-remediation
|
|
151
159
|
- co-work 基线默认开启:初始化或接管后的 SCE 项目会落地 `.sce/config/multi-agent.json` 且 `enabled=true`,但中央 coordinator 仍保持按需开启
|
|
152
160
|
- 状态持久化默认优先走 SQLite,而不是零散本地缓存
|
|
161
|
+
- `CORE_PRINCIPLES.md` 的最高原则层默认只保留“四句教 + 小九条”;四句教先判断该不该做,小九条再判断如何把正确的事做对;治理基线进入 `RULES_GUIDE.md`,执行经验与案例进入 `docs/steering-governance.md` 或 `.sce/knowledge/lessons/`
|
|
162
|
+
- `studio plan` / `studio intake` / `native ask` 默认先经过“四句教”判定闸门;对失范目标会执行 `clarify / rewrite / narrow / refuse`,并把判定结果写入 session/job/spec 证据链
|
|
163
|
+
- Agent 生成的脚本、报告、调试日志、测试脚本和临时分析默认进入当前 Spec 子目录;没有明确 Spec 时先用通用 Spec 承接
|
|
164
|
+
- 默认遵守“小九条”执行姿态:勤奋推进、先领会真实意图、先看事实、维护项目活地图、想透问题、证据足够时敢下判断、统筹 Spec/错题本/测试/现状代码/关注点、先拆解定位阻塞、持续收敛直到闭环
|
|
153
165
|
- 超大源文件必须定期触发重构评估;SCE 优先建议按项目给出阈值,若项目尚未设定,则默认参考 `2000 / 4000 / 10000`
|
|
154
166
|
- 发布默认验证走 integration gate:`npm run test:release`
|
|
155
167
|
|
|
@@ -235,5 +247,5 @@ MIT,见 [LICENSE](LICENSE)。
|
|
|
235
247
|
|
|
236
248
|
---
|
|
237
249
|
|
|
238
|
-
**版本**:3.6.
|
|
239
|
-
**最后更新**:2026-03-
|
|
250
|
+
**版本**:3.6.67
|
|
251
|
+
**最后更新**:2026-03-29
|
|
@@ -28,6 +28,8 @@ const { registerTaskCommands } = require('../lib/commands/task');
|
|
|
28
28
|
const { registerAuthCommands } = require('../lib/commands/auth');
|
|
29
29
|
const { registerStateCommands } = require('../lib/commands/state');
|
|
30
30
|
const { registerCapabilityCommands } = require('../lib/commands/capability');
|
|
31
|
+
const { registerSemanticCommands } = require('../lib/commands/semantic');
|
|
32
|
+
const { registerNativeCommands } = require('../lib/commands/native');
|
|
31
33
|
const VersionChecker = require('../lib/version/version-checker');
|
|
32
34
|
const {
|
|
33
35
|
findLegacyKiroDirectories,
|
|
@@ -1062,6 +1064,8 @@ registerTaskCommands(program);
|
|
|
1062
1064
|
registerAuthCommands(program);
|
|
1063
1065
|
registerStateCommands(program);
|
|
1064
1066
|
registerCapabilityCommands(program);
|
|
1067
|
+
registerSemanticCommands(program);
|
|
1068
|
+
registerNativeCommands(program);
|
|
1065
1069
|
|
|
1066
1070
|
const { registerAppCommands } = require('../lib/commands/app');
|
|
1067
1071
|
const { registerDeviceCommands } = require('../lib/commands/device');
|