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.
Files changed (121) hide show
  1. package/CHANGELOG.md +16 -0
  2. package/README.md +17 -6
  3. package/README.zh.md +18 -6
  4. package/bin/scene-capability-engine.js +4 -0
  5. package/docs/README.md +2 -2
  6. package/docs/command-reference.md +382 -6
  7. package/docs/document-governance.md +3 -2
  8. package/docs/integration-modes.md +62 -478
  9. package/docs/integration-philosophy.md +56 -263
  10. package/docs/magicball-project-portfolio-contract.md +114 -2
  11. package/docs/project-management/README.md +14 -0
  12. package/docs/project-management/assurance/backup.md +3 -0
  13. package/docs/project-management/assurance/config.md +3 -0
  14. package/docs/project-management/assurance/evidence/README.md +3 -0
  15. package/docs/project-management/assurance/incidents/README.md +3 -0
  16. package/docs/project-management/assurance/logs.md +3 -0
  17. package/docs/project-management/assurance/overview.md +3 -0
  18. package/docs/project-management/assurance/recovery/README.md +3 -0
  19. package/docs/project-management/assurance/resource.md +3 -0
  20. package/docs/project-management/assurance/runbooks/README.md +3 -0
  21. package/docs/project-management/delivery/acceptance/README.md +3 -0
  22. package/docs/project-management/delivery/acceptance/evidence/README.md +3 -0
  23. package/docs/project-management/delivery/acceptance/exceptions/README.md +3 -0
  24. package/docs/project-management/delivery/acceptance/reports/README.md +3 -0
  25. package/docs/project-management/delivery/documents/changes.md +3 -0
  26. package/docs/project-management/delivery/documents/issues.md +3 -0
  27. package/docs/project-management/delivery/documents/overview.md +3 -0
  28. package/docs/project-management/delivery/documents/planning.md +3 -0
  29. package/docs/project-management/delivery/documents/requirements.md +3 -0
  30. package/docs/project-management/delivery/documents/tracking.md +3 -0
  31. package/docs/project-management/delivery/handoffs/README.md +3 -0
  32. package/docs/project-management/delivery/handoffs/evidence/README.md +3 -0
  33. package/docs/project-management/delivery/handoffs/records/README.md +3 -0
  34. package/docs/project-management/delivery/overview.md +10 -0
  35. package/docs/project-management/delivery/releases/README.md +3 -0
  36. package/docs/project-management/delivery/releases/baselines/README.md +3 -0
  37. package/docs/project-management/delivery/releases/evidence/README.md +3 -0
  38. package/docs/project-management/delivery/tables/changes.md +3 -0
  39. package/docs/project-management/delivery/tables/issues.md +3 -0
  40. package/docs/project-management/delivery/tables/planning.md +3 -0
  41. package/docs/project-management/delivery/tables/requirements.md +3 -0
  42. package/docs/project-management/delivery/tables/tracking.md +3 -0
  43. package/docs/project-management/environment/agent-discovery.md +3 -0
  44. package/docs/project-management/environment/development.md +3 -0
  45. package/docs/project-management/environment/overview.md +10 -0
  46. package/docs/project-management/environment/testing.md +3 -0
  47. package/docs/project-management/environment/version-alignment.md +3 -0
  48. package/docs/quick-start-with-ai-tools.md +68 -308
  49. package/docs/releases/README.md +2 -0
  50. package/docs/releases/v3.6.66.md +23 -0
  51. package/docs/releases/v3.6.67.md +23 -0
  52. package/docs/steering-governance.md +64 -2
  53. package/docs/zh/README.md +2 -2
  54. package/docs/zh/releases/README.md +2 -0
  55. package/docs/zh/releases/v3.6.66.md +23 -0
  56. package/docs/zh/releases/v3.6.67.md +23 -0
  57. package/lib/commands/adopt.js +24 -0
  58. package/lib/commands/native.js +158 -0
  59. package/lib/commands/project.js +95 -0
  60. package/lib/commands/semantic.js +1459 -0
  61. package/lib/commands/session.js +74 -3
  62. package/lib/commands/spec-bootstrap.js +10 -1
  63. package/lib/commands/spec-gate.js +10 -1
  64. package/lib/commands/spec-pipeline.js +10 -1
  65. package/lib/commands/studio.js +405 -30
  66. package/lib/commands/task.js +141 -7
  67. package/lib/governance/supreme-principles.js +530 -0
  68. package/lib/problem/problem-evaluator.js +4 -0
  69. package/lib/project/candidate-inspection-service.js +24 -1
  70. package/lib/project/portfolio-projection-service.js +315 -5
  71. package/lib/project/project-channel-output.js +94 -0
  72. package/lib/project/project-channel-projection.js +181 -0
  73. package/lib/project/root-onboarding-service.js +60 -8
  74. package/lib/project/semantic-shared-source-projection.js +150 -0
  75. package/lib/project/supervision-action-model.js +277 -0
  76. package/lib/project/supervision-projection-service.js +305 -5
  77. package/lib/project/target-resolution-service.js +70 -5
  78. package/lib/project/visibility-policy.js +93 -0
  79. package/lib/runtime/multi-spec-scene-session.js +8 -1
  80. package/lib/runtime/project-channel-context-store.js +387 -0
  81. package/lib/runtime/project-channel-context.js +406 -0
  82. package/lib/runtime/scene-session-binding.js +46 -0
  83. package/lib/runtime/session-store.js +186 -0
  84. package/lib/runtime/steering-contract.js +7 -1
  85. package/lib/semantic/archive-report.js +283 -0
  86. package/lib/semantic/archive-routing.js +67 -0
  87. package/lib/semantic/backflow-report.js +245 -0
  88. package/lib/semantic/capability-contract.js +30 -0
  89. package/lib/semantic/delta-export.js +145 -0
  90. package/lib/semantic/interaction-observer.js +254 -0
  91. package/lib/semantic/kernel-loader.js +881 -0
  92. package/lib/semantic/native-runtime.js +359 -0
  93. package/lib/semantic/progress-ledger.js +433 -0
  94. package/lib/semantic/replay-evaluator.js +382 -0
  95. package/lib/semantic/shared-publication.js +592 -0
  96. package/lib/semantic/shared-source-config.js +183 -0
  97. package/lib/semantic/shared-source-connect.js +139 -0
  98. package/lib/semantic/shared-source-discovery.js +98 -0
  99. package/lib/semantic/shared-sync-export.js +413 -0
  100. package/lib/semantic/shared-sync-intake.js +592 -0
  101. package/lib/semantic/shared-sync-merge.js +547 -0
  102. package/lib/semantic/shared-sync-release.js +463 -0
  103. package/lib/semantic/supreme-intent-report.js +300 -0
  104. package/lib/state/sce-state-store.js +1360 -0
  105. package/lib/steering/context-sync-manager.js +276 -25
  106. package/lib/studio/spec-intake-governor.js +39 -3
  107. package/lib/studio/task-envelope.js +35 -2
  108. package/lib/workspace/takeover-baseline.js +342 -83
  109. package/package.json +7 -2
  110. package/scripts/agent-governance-baseline-audit.js +395 -0
  111. package/scripts/clarification-first-audit.js +9 -9
  112. package/scripts/deprecated-entry-audit.js +240 -0
  113. package/scripts/release-posture-report.js +262 -0
  114. package/template/.sce/README.md +62 -228
  115. package/template/.sce/config/semantic-shared-sources.json +5 -0
  116. package/template/.sce/config/supreme-principles-policy.json +105 -0
  117. package/template/.sce/config/takeover-baseline.json +7 -0
  118. package/template/.sce/steering/CORE_PRINCIPLES.md +23 -63
  119. package/template/.sce/steering/CURRENT_CONTEXT.md +4 -0
  120. package/template/.sce/steering/RULES_GUIDE.md +17 -9
  121. 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`: one primary session per scene, many specs per scene, many tasks per spec.
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 hierarchy:
29
+ SCE organizes agent work using one stable semantic/collaboration model:
30
30
 
31
- - `session -> scene -> spec -> task -> event`
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
- - Task refs (`SS.PP.TT`) for lookup and rerun
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.65
234
- **Last Updated**: 2026-03-22
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 主导上下文`:一个 scene 对应一个主会话,多个 spec 挂在 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 用一条稳定层级来管理 Agent 工作:
34
+ SCE 用一条稳定的“语义链 + 协作链”来管理 Agent 工作:
35
35
 
36
- - `session -> scene -> spec -> task -> event`
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
- - 任务引用 `SS.PP.TT`,支持查询和重跑
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.65
239
- **最后更新**:2026-03-22
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');
package/docs/README.md CHANGED
@@ -72,7 +72,7 @@ This hub keeps only the high-value entry points for adopting, integrating, and s
72
72
 
73
73
  ---
74
74
 
75
- **Version**: 3.6.65
76
- **Last Updated**: 2026-03-22
75
+ **Version**: 3.6.67
76
+ **Last Updated**: 2026-03-29
77
77
 
78
78