scene-capability-engine 3.0.1 → 3.0.2

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 (170) hide show
  1. package/CHANGELOG.md +233 -233
  2. package/LICENSE +2 -2
  3. package/README.md +8 -11
  4. package/README.zh.md +7 -10
  5. package/bin/kse.js +1 -1
  6. package/bin/sce.js +1 -1
  7. package/bin/sco.js +1 -1
  8. package/docs/331-poc-adaptation-roadmap.md +25 -25
  9. package/docs/331-poc-dual-track-integration-guide.md +26 -26
  10. package/docs/331-poc-weekly-delivery-checklist.md +8 -8
  11. package/docs/OFFLINE_INSTALL.md +10 -10
  12. package/docs/README.md +24 -24
  13. package/docs/adopt-migration-guide.md +51 -51
  14. package/docs/adoption-guide.md +56 -56
  15. package/docs/agent-hooks-analysis.md +52 -52
  16. package/docs/architecture.md +6 -6
  17. package/docs/articles/ai-driven-development-philosophy-and-practice-review.md +4 -4
  18. package/docs/articles/ai-driven-development-philosophy-and-practice.en.md +9 -9
  19. package/docs/articles/ai-driven-development-philosophy-and-practice.md +10 -10
  20. package/docs/autonomous-control-guide.md +89 -89
  21. package/docs/command-reference.md +11 -11
  22. package/docs/community.md +4 -4
  23. package/docs/cross-tool-guide.md +47 -47
  24. package/docs/developer-guide.md +5 -5
  25. package/docs/document-governance.md +91 -91
  26. package/docs/environment-management-guide.md +53 -53
  27. package/docs/examples/add-export-command/design.md +2 -2
  28. package/docs/examples/add-export-command/requirements.md +5 -5
  29. package/docs/examples/add-export-command/tasks.md +2 -2
  30. package/docs/faq.md +69 -69
  31. package/docs/handoffs/evidence/ontology/moqui-template-baseline-2026-02-17-232922.json +9 -9
  32. package/docs/handoffs/evidence/ontology/moqui-template-baseline-2026-02-17-232922.md +3 -3
  33. package/docs/integration-modes.md +60 -60
  34. package/docs/integration-philosophy.md +48 -48
  35. package/docs/knowledge-management-guide.md +21 -21
  36. package/docs/manual-workflows-guide.md +20 -20
  37. package/docs/moqui-capability-matrix.md +22 -22
  38. package/docs/moqui-template-core-library-playbook.md +20 -20
  39. package/docs/multi-agent-coordination-guide.md +19 -19
  40. package/docs/multi-repo-management-guide.md +93 -93
  41. package/docs/quick-start-with-ai-tools.md +36 -36
  42. package/docs/quick-start.md +16 -16
  43. package/docs/release-checklist.md +7 -7
  44. package/docs/releases/v1.46.2-validation.md +1 -1
  45. package/docs/releases/v1.46.2.md +10 -10
  46. package/docs/scene-runtime-guide.md +42 -42
  47. package/docs/spec-collaboration-guide.md +43 -43
  48. package/docs/spec-locking-guide.md +26 -26
  49. package/docs/spec-numbering-guide.md +6 -6
  50. package/docs/spec-workflow.md +25 -25
  51. package/docs/steering-strategy-guide.md +36 -36
  52. package/docs/team-collaboration-guide.md +23 -23
  53. package/docs/testing-strategy.md +2 -2
  54. package/docs/tools/claude-guide.md +26 -26
  55. package/docs/tools/cursor-guide.md +31 -31
  56. package/docs/tools/generic-guide.md +22 -22
  57. package/docs/tools/kiro-guide.md +43 -43
  58. package/docs/tools/vscode-guide.md +18 -18
  59. package/docs/tools/windsurf-guide.md +50 -50
  60. package/docs/troubleshooting.md +116 -116
  61. package/docs/upgrade-guide.md +49 -49
  62. package/docs/value-observability-guide.md +6 -6
  63. package/docs/zh/README.md +22 -22
  64. package/docs/zh/quick-start.md +34 -34
  65. package/docs/zh/release-checklist.md +6 -6
  66. package/docs/zh/releases/v1.46.2-validation.md +1 -1
  67. package/docs/zh/releases/v1.46.2.md +9 -9
  68. package/docs/zh/spec-numbering-guide.md +6 -6
  69. package/docs/zh/tools/claude-guide.md +14 -14
  70. package/docs/zh/tools/cursor-guide.md +18 -18
  71. package/docs/zh/tools/generic-guide.md +40 -40
  72. package/docs/zh/tools/kiro-guide.md +50 -50
  73. package/docs/zh/tools/vscode-guide.md +20 -20
  74. package/docs/zh/tools/windsurf-guide.md +49 -49
  75. package/docs/zh/value-observability-guide.md +6 -6
  76. package/docs//344/272/244/344/273/230/346/270/205/345/215/225.md +4 -4
  77. package/lib/adoption/adoption-logger.js +1 -1
  78. package/lib/adoption/adoption-strategy.js +3 -3
  79. package/lib/adoption/detection-engine.js +1 -1
  80. package/lib/adoption/error-formatter.js +17 -17
  81. package/lib/adoption/progress-reporter.js +2 -2
  82. package/lib/adoption/smart-orchestrator.js +2 -2
  83. package/lib/adoption/strategy-selector.js +2 -2
  84. package/lib/adoption/summary-generator.js +3 -3
  85. package/lib/auto/autonomous-engine.js +2 -2
  86. package/lib/auto/close-loop-runner.js +9 -9
  87. package/lib/backup/backup-system.js +2 -2
  88. package/lib/collab/collab-manager.js +2 -2
  89. package/lib/commands/adopt.js +16 -16
  90. package/lib/commands/auto.js +93 -93
  91. package/lib/commands/collab.js +8 -8
  92. package/lib/commands/docs.js +26 -26
  93. package/lib/commands/doctor.js +2 -2
  94. package/lib/commands/env.js +14 -14
  95. package/lib/commands/knowledge.js +13 -13
  96. package/lib/commands/lock.js +6 -6
  97. package/lib/commands/ops.js +19 -19
  98. package/lib/commands/orchestrate.js +5 -5
  99. package/lib/commands/prompt.js +3 -3
  100. package/lib/commands/rollback.js +4 -4
  101. package/lib/commands/scene.js +29 -29
  102. package/lib/commands/spec-bootstrap.js +1 -1
  103. package/lib/commands/spec-gate.js +1 -1
  104. package/lib/commands/spec-pipeline.js +1 -1
  105. package/lib/commands/task.js +1 -1
  106. package/lib/commands/templates.js +27 -27
  107. package/lib/commands/upgrade.js +8 -8
  108. package/lib/commands/value.js +4 -4
  109. package/lib/commands/watch.js +9 -9
  110. package/lib/commands/workflows.js +5 -5
  111. package/lib/commands/workspace-multi.js +17 -17
  112. package/lib/commands/workspace.js +5 -5
  113. package/lib/context/context-exporter.js +1 -1
  114. package/lib/context/prompt-generator.js +1 -1
  115. package/lib/data/moqui-capability-lexicon.json +1 -1
  116. package/lib/environment/environment-manager.js +1 -1
  117. package/lib/gitignore/gitignore-detector.js +4 -4
  118. package/lib/gitignore/gitignore-integration.js +2 -2
  119. package/lib/gitignore/gitignore-transformer.js +3 -3
  120. package/lib/gitignore/layered-rules-template.js +2 -2
  121. package/lib/governance/diagnostic-engine.js +4 -4
  122. package/lib/governance/doc-reference-checker.js +1 -1
  123. package/lib/governance/hooks-manager.js +5 -5
  124. package/lib/governance/reporter.js +1 -1
  125. package/lib/knowledge/knowledge-manager.js +6 -6
  126. package/lib/orchestrator/agent-spawner.js +1 -1
  127. package/lib/orchestrator/bootstrap-prompt-builder.js +2 -2
  128. package/lib/repo/config-manager.js +2 -2
  129. package/lib/repo/handlers/init-handler.js +3 -3
  130. package/lib/scene-runtime/audit-emitter.js +2 -2
  131. package/lib/scene-runtime/binding-plugin-loader.js +1 -1
  132. package/lib/scene-runtime/moqui-adapter.js +2 -2
  133. package/lib/scene-runtime/moqui-extractor.js +3 -3
  134. package/lib/scene-runtime/scene-loader.js +3 -3
  135. package/lib/scene-runtime/scene-template-linter.js +1 -1
  136. package/lib/scene-runtime/templates/scene-template-erp-query-v0.1.yaml +1 -1
  137. package/lib/scene-runtime/templates/scene-template-hybrid-shadow-v0.1.yaml +1 -1
  138. package/lib/spec/multi-spec-orchestrate.js +1 -1
  139. package/lib/spec-gate/rules/default-rules.js +1 -1
  140. package/lib/steering/adoption-config.js +1 -1
  141. package/lib/steering/compliance-auto-fixer.js +1 -1
  142. package/lib/steering/compliance-cache.js +3 -3
  143. package/lib/steering/compliance-error-reporter.js +1 -1
  144. package/lib/steering/index.js +1 -1
  145. package/lib/steering/steering-manager.js +7 -7
  146. package/lib/task/task-claimer.js +2 -1
  147. package/lib/templates/metadata-collector.js +6 -6
  148. package/lib/templates/template-creator.js +2 -2
  149. package/lib/templates/template-exporter.js +12 -12
  150. package/lib/upgrade/migration-engine.js +4 -4
  151. package/lib/utils/tool-detector.js +25 -25
  152. package/lib/utils/validation.js +3 -3
  153. package/lib/version/version-checker.js +13 -13
  154. package/lib/version/version-manager.js +7 -7
  155. package/lib/watch/presets.js +4 -4
  156. package/lib/workspace/multi/path-utils.js +1 -1
  157. package/lib/workspace/multi/workspace-context-resolver.js +9 -9
  158. package/lib/workspace/multi/workspace-registry.js +2 -2
  159. package/lib/workspace/multi/workspace-state-manager.js +1 -1
  160. package/lib/workspace/multi/workspace.js +1 -1
  161. package/lib/workspace/workspace-sync.js +1 -1
  162. package/locales/en.json +1 -1
  163. package/locales/zh.json +1 -1
  164. package/package.json +3 -5
  165. package/template/.kiro/README.md +40 -40
  166. package/template/.kiro/specs/SPEC_WORKFLOW_GUIDE.md +3 -3
  167. package/template/.kiro/steering/CORE_PRINCIPLES.md +3 -3
  168. package/template/.kiro/steering/ENVIRONMENT.md +2 -2
  169. package/template/README.md +3 -3
  170. /package/bin/{kiro-spec-engine.js → scene-capability-engine.js} +0 -0
package/LICENSE CHANGED
@@ -1,6 +1,6 @@
1
1
  MIT License
2
2
 
3
- Copyright (c) 2026 Kiro Ultrawork
3
+ Copyright (c) 2026 heguangyong
4
4
 
5
5
  Permission is hereby granted, free of charge, to any person obtaining a copy
6
6
  of this software and associated documentation files (the "Software"), to deal
@@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
18
  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
19
  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
20
  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
21
+ SOFTWARE.
package/README.md CHANGED
@@ -4,8 +4,7 @@
4
4
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
5
5
 
6
6
  > **⚠️ Important Clarification**: `scene-capability-engine` (`sce`) is an **npm package and CLI tool** for spec-driven development.
7
- > It is **NOT** the Kiro IDE desktop application. If you're looking for Kiro IDE, visit https://kiro.dev
8
- > Legacy/compatibility commands `sco`, `kse`, and `kiro-spec-engine` remain available.
7
+ > Primary command is `sce`. Compatibility aliases are preserved for migration.
9
8
 
10
9
  **A context provider for AI coding tools** - Structure your project requirements, design, and tasks so AI assistants can help you build better software.
11
10
 
@@ -61,7 +60,7 @@ graph LR
61
60
  | Queue-driven autonomous runtime | `auto close-loop-controller` persistent queue drain | Program-scale backlogs continue without manual re-triggering |
62
61
  | Autonomous convergence governance | Program gate (`min-success-rate` + `max-risk-level`) + audit JSON output | Program completion is policy-verified and traceable |
63
62
  | Measurable outcomes | KPI automation (`value metrics snapshot/baseline/trend`) | Delivery quality can be tracked week-over-week |
64
- | Tool-agnostic adoption | Works across Claude/Cursor/Windsurf/Copilot/Kiro | No lock-in to a single AI IDE |
63
+ | Tool-agnostic adoption | Works across Claude/Cursor/Windsurf/Copilot | No lock-in to a single AI IDE |
65
64
  | Built-in governance | Docs governance, lock management, audit, env/workspace controls | Team collaboration stays auditable and stable |
66
65
 
67
66
  ### 90-Second Value Proof
@@ -134,7 +133,7 @@ This creates a `.kiro/` directory with:
134
133
 
135
134
  #### Step 3: Tell Your AI About the Methodology (30 seconds)
136
135
 
137
- **In your AI tool (Cursor, Claude, Windsurf, Kiro, etc.), say:**
136
+ **In your AI tool (Cursor, Claude, Windsurf, etc.), say:**
138
137
 
139
138
  ```
140
139
  Please read .kiro/README.md to understand how this project works.
@@ -201,7 +200,7 @@ A **Spec** is a structured description of a feature or project component. Each S
201
200
 
202
201
  sce supports three ways to work with AI tools:
203
202
 
204
- 1. **Native Integration** - AI tool directly accesses sce (Kiro IDE)
203
+ 1. **Direct Workspace Integration** - AI tool directly accesses sce in your workspace
205
204
  2. **Manual Export** - You export and paste context (Claude, ChatGPT, Cursor)
206
205
  3. **Watch Mode** - Automatic context updates on file changes (all tools)
207
206
 
@@ -218,7 +217,6 @@ sce works with any AI coding assistant. Choose your tool for specific guidance:
218
217
  - **[Cursor](docs/tools/cursor-guide.md)** - IDE with AI pair programming
219
218
  - **[Claude Code](docs/tools/claude-guide.md)** - Anthropic's coding assistant
220
219
  - **[Windsurf](docs/tools/windsurf-guide.md)** - AI agent with command execution
221
- - **[Kiro](docs/tools/kiro-guide.md)** - Native integration, no manual export needed
222
220
  - **[VS Code + Copilot](docs/tools/vscode-guide.md)** - GitHub Copilot integration
223
221
  - **[Generic AI Tools](docs/tools/generic-guide.md)** - Works with any AI assistant
224
222
 
@@ -264,7 +262,6 @@ sequenceDiagram
264
262
  - [Cursor Integration](docs/tools/cursor-guide.md)
265
263
  - [Claude Code Integration](docs/tools/claude-guide.md)
266
264
  - [Windsurf Integration](docs/tools/windsurf-guide.md)
267
- - [Kiro Integration](docs/tools/kiro-guide.md)
268
265
  - [VS Code + Copilot Integration](docs/tools/vscode-guide.md)
269
266
  - [Generic AI Tools](docs/tools/generic-guide.md)
270
267
 
@@ -364,7 +361,7 @@ Structure your work with Requirements → Design → Tasks workflow
364
361
  - **Smart Exclusions**: Automatically skip common non-repository directories (node_modules, build, etc.)
365
362
 
366
363
  ### Moqui ERP Integration 🚀 NEW in v1.39.0
367
- - **Moqui ERP Adapter**: Connect KSE scene runtime to live Moqui ERP instances
364
+ - **Moqui ERP Adapter**: Connect sce scene runtime to live Moqui ERP instances
368
365
  - `MoquiClient` — HTTP client with JWT auth lifecycle (login, refresh, re-login, logout) and retry logic
369
366
  - `MoquiAdapter` — Binding handler for `spec.erp.*` and `moqui.*` refs, entity CRUD, service invocation, screen discovery
370
367
  - **Scene Template Extractor** (v1.40.0): Analyze Moqui resources, identify business patterns, generate reusable scene templates
@@ -601,7 +598,7 @@ sce repo exec "<command>" # Execute command in all repositories
601
598
  # Spec-level collaboration (NEW in v1.22.0)
602
599
  sce collab init <master> [options] # Initialize Master Spec with Sub-Specs
603
600
  sce collab status [spec] [--graph] # Display collaboration status
604
- sce collab assign <spec> <kiro> # Assign Spec to Kiro instance
601
+ sce collab assign <spec> <assignee> # Assign Spec to an assignee
605
602
  sce collab verify <spec> # Verify interface contracts
606
603
  sce collab integrate <specs...> # Run integration tests
607
604
  sce collab migrate <spec> # Convert standalone Spec to collaborative
@@ -697,7 +694,7 @@ We welcome contributions! See our [Contributing Guide](CONTRIBUTING.md) for:
697
694
 
698
695
  ```bash
699
696
  git clone https://github.com/heguangyong/scene-capability-engine.git
700
- cd kiro-spec-engine
697
+ cd scene-capability-engine
701
698
  npm install
702
699
  npm link # For local development
703
700
  npm test # Run tests
@@ -714,7 +711,7 @@ MIT License - see [LICENSE](LICENSE) file for details.
714
711
  ## Acknowledgments
715
712
 
716
713
  - Inspired by the **Sisyphus** myth and the concept of noble struggle
717
- - Built on the foundation of **Kiro** spec-driven development
714
+ - Built on practical **Spec-driven development** methodology
718
715
  - Influenced by **oh-my-opencode** and the Ultrawork Manifesto
719
716
 
720
717
  ---
package/README.zh.md CHANGED
@@ -4,8 +4,7 @@
4
4
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
5
5
 
6
6
  > **⚠️ 重要说明**: `scene-capability-engine`(`sce`)是一个 **npm 包和 CLI 工具**,用于 Spec 驱动开发。
7
- > 它**不是** Kiro IDE 桌面应用程序。如果你在寻找 Kiro IDE,请访问 https://kiro.dev
8
- > 兼容保留命令:`sco`、`kse` 与 `kiro-spec-engine`。
7
+ > 主命令为 `sce`,兼容别名保留用于迁移。
9
8
 
10
9
  **AI 编码工具的上下文提供者** - 结构化你的项目需求、设计和任务,让 AI 助手帮你构建更好的软件。
11
10
 
@@ -59,7 +58,7 @@ graph LR
59
58
  | 队列驱动自治执行 | `auto close-loop-controller` 持续消费目标队列 | 程序级积压目标无需人工反复触发 |
60
59
  | 自治收敛治理 | Program Gate(最小成功率 + 最大风险)+ 审计 JSON 导出 | 完成结果可按策略验收且全程可追溯 |
61
60
  | 结果可量化 | KPI 自动化(`value metrics snapshot/baseline/trend`) | 周度趋势可追踪、可审计 |
62
- | 工具无锁定 | 兼容 Claude/Cursor/Windsurf/Copilot/Kiro | 团队可保留现有 AI 工具链 |
61
+ | 工具无锁定 | 兼容 Claude/Cursor/Windsurf/Copilot | 团队可保留现有 AI 工具链 |
63
62
  | 治理内建 | 文档治理、锁机制、审计、环境/工作区管理 | 协作更稳定,过程可回放 |
64
63
 
65
64
  ### 90 秒价值验证
@@ -132,7 +131,7 @@ sce adopt
132
131
 
133
132
  #### 步骤 3:告诉 AI 项目的开发方法(30 秒)
134
133
 
135
- **在你的 AI 工具中(Cursor、Claude、Windsurf、Kiro 等),说:**
134
+ **在你的 AI 工具中(Cursor、Claude、Windsurf 等),说:**
136
135
 
137
136
  ```
138
137
  请阅读 .kiro/README.md 了解项目的开发方法。
@@ -199,7 +198,7 @@ sce adopt
199
198
 
200
199
  sce 支持三种与 AI 工具协作的方式:
201
200
 
202
- 1. **原生集成** - AI 工具直接访问 sce(Kiro IDE)
201
+ 1. **工作区直连集成** - AI 工具直接在你的工作区访问 sce
203
202
  2. **手动导出** - 你导出并粘贴上下文(Claude、ChatGPT、Cursor)
204
203
  3. **Watch 模式** - 文件更改时自动更新上下文(所有工具)
205
204
 
@@ -216,7 +215,6 @@ sce 适用于任何 AI 编码助手。选择你的工具获取具体指导:
216
215
  - **[Cursor](docs/zh/tools/cursor-guide.md)** - 带 AI 结对编程的 IDE
217
216
  - **[Claude Code](docs/zh/tools/claude-guide.md)** - Anthropic 的编码助手
218
217
  - **[Windsurf](docs/zh/tools/windsurf-guide.md)** - 支持命令执行的 AI 代理
219
- - **[Kiro](docs/zh/tools/kiro-guide.md)** - 原生集成,无需手动导出
220
218
  - **[VS Code + Copilot](docs/zh/tools/vscode-guide.md)** - GitHub Copilot 集成
221
219
  - **[通用 AI 工具](docs/zh/tools/generic-guide.md)** - 适用于任何 AI 助手
222
220
 
@@ -260,7 +258,6 @@ sequenceDiagram
260
258
  - [Cursor 集成](docs/zh/tools/cursor-guide.md)
261
259
  - [Claude Code 集成](docs/zh/tools/claude-guide.md)
262
260
  - [Windsurf 集成](docs/zh/tools/windsurf-guide.md)
263
- - [Kiro 集成](docs/zh/tools/kiro-guide.md)
264
261
  - [VS Code + Copilot 集成](docs/zh/tools/vscode-guide.md)
265
262
  - [通用 AI 工具](docs/zh/tools/generic-guide.md)
266
263
 
@@ -320,7 +317,7 @@ sequenceDiagram
320
317
  - **跨平台**:在 Windows、Linux 和 macOS 上无缝工作
321
318
 
322
319
  ### Moqui ERP 集成 🚀 v1.39.0 新增
323
- - **Moqui ERP 适配器**: 将 KSE 场景运行时连接到 Moqui ERP 实例
320
+ - **Moqui ERP 适配器**: 将 sce 场景运行时连接到 Moqui ERP 实例
324
321
  - `MoquiClient` — 支持 JWT 认证生命周期(登录、刷新、重登录、登出)和重试逻辑的 HTTP 客户端
325
322
  - `MoquiAdapter` — 处理 `spec.erp.*` 和 `moqui.*` 引用的绑定处理器,支持实体 CRUD、服务调用、屏幕发现
326
323
  - **场景模板提取器**(v1.40.0): 分析 Moqui 资源,识别业务模式,生成可复用场景模板
@@ -592,7 +589,7 @@ sce workflows # 列出可用工作流
592
589
 
593
590
  ```bash
594
591
  git clone https://github.com/heguangyong/scene-capability-engine.git
595
- cd kiro-spec-engine
592
+ cd scene-capability-engine
596
593
  npm install
597
594
  npm link # 用于本地开发
598
595
  npm test # 运行测试
@@ -609,7 +606,7 @@ MIT 许可证 - 详见 [LICENSE](LICENSE) 文件。
609
606
  ## 致谢
610
607
 
611
608
  - 受 **西西弗斯** 神话和高贵奋斗概念的启发
612
- - 建立在 **Kiro** Spec 驱动开发的基础上
609
+ - 建立在务实的 **Spec 驱动开发** 方法论基础上
613
610
  - 受 **oh-my-opencode** 和 Ultrawork 宣言的影响
614
611
 
615
612
  ---
package/bin/kse.js CHANGED
@@ -1,3 +1,3 @@
1
1
  #!/usr/bin/env node
2
2
 
3
- require('./kiro-spec-engine');
3
+ require('./scene-capability-engine');
package/bin/sce.js CHANGED
@@ -1,3 +1,3 @@
1
1
  #!/usr/bin/env node
2
2
 
3
- require('./kiro-spec-engine');
3
+ require('./scene-capability-engine');
package/bin/sco.js CHANGED
@@ -1,3 +1,3 @@
1
1
  #!/usr/bin/env node
2
2
 
3
- require('./kiro-spec-engine');
3
+ require('./scene-capability-engine');
@@ -1,17 +1,17 @@
1
- # 331-poc 适配持续推进路线图(KSE 侧)
1
+ # 331-poc 适配持续推进路线图(sce 侧)
2
2
 
3
- > 范围:`kiro-spec-engine` 侧围绕 331-poc handoff 的持续适配工作,不包含 331 业务实现本身。
3
+ > 范围:`scene-capability-engine` 侧围绕 331-poc handoff 的持续适配工作,不包含 331 业务实现本身。
4
4
 
5
5
  ## 已完成(本轮)
6
6
 
7
7
  1. 新增 handoff 自动化命令:
8
- - `kse auto handoff plan`
9
- - `kse auto handoff queue`
8
+ - `sce auto handoff plan`
9
+ - `sce auto handoff queue`
10
10
  2. 将 handoff manifest 解析为可执行阶段计划(precheck/spec validation/execution/observability)。
11
11
  3. 将 handoff manifest 生成 close-loop-batch 目标队列(支持 dry-run、append、known-gaps 开关)。
12
12
  4. 补齐单测覆盖(plan/queue/dry-run 分支)。
13
13
  5. 更新命令参考与中英文文档入口。
14
- 6. 新增 `kse auto handoff run`:
14
+ 6. 新增 `sce auto handoff run`:
15
15
  - 一条命令串行执行 `plan -> queue -> close-loop-batch -> observability`。
16
16
  - 支持 `--dry-run` 与失败自动中断。
17
17
  7. 新增 handoff 结果归档:
@@ -25,12 +25,12 @@
25
25
  - 从 manifest `specs[].depends_on` 构建依赖拓扑批次。
26
26
  - `handoff run` 默认按依赖批次顺序执行 spec 集成目标。
27
27
  10. 新增模板差异检测:
28
- - `kse auto handoff template-diff` 对比 manifest 模板与本地模板库。
28
+ - `sce auto handoff template-diff` 对比 manifest 模板与本地模板库。
29
29
  11. 新增跨轮次回归分析:
30
- - `kse auto handoff regression` 对比相邻批次成功率/风险/失败目标/耗时变化。
30
+ - `sce auto handoff regression` 对比相邻批次成功率/风险/失败目标/耗时变化。
31
31
  - `handoff run` 结果中自动附加 regression 摘要。
32
32
  12. 新增断点续跑能力:
33
- - `kse auto handoff run --continue-from <session|latest|file>`。
33
+ - `sce auto handoff run --continue-from <session|latest|file>`。
34
34
  - 支持 `--continue-strategy auto|pending|failed-only`。
35
35
  13. 新增 release evidence 自动归并:
36
36
  - `handoff run` 结束后自动将批次结果合并到 `.kiro/reports/release-evidence/handoff-runs.json`。
@@ -42,10 +42,10 @@
42
42
  - `handoff run` 支持 `--release-evidence-window <n>`(默认 5)。
43
43
  - release evidence 自动写入 `latest_trend_window` 与每个 session 的 `trend_window`,支持发布包一键审阅。
44
44
  16. 新增 release evidence 快速审阅命令:
45
- - `kse auto handoff evidence` 直接聚合当前批次 gate/ontology/regression/risk-layer 概览。
45
+ - `sce auto handoff evidence` 直接聚合当前批次 gate/ontology/regression/risk-layer 概览。
46
46
  - 支持 JSON/markdown 输出与 `--window` 会话窗口聚合。
47
47
  17. 新增 release draft 自动生成:
48
- - `kse auto handoff evidence --release-draft <path>` 一次命令生成 evidence 审阅 markdown + release notes 草稿。
48
+ - `sce auto handoff evidence --release-draft <path>` 一次命令生成 evidence 审阅 markdown + release notes 草稿。
49
49
  - 草稿自动注入当前批次 gate/ontology/regression/risk-layer 摘要与证据路径。
50
50
  18. 新增 CI 发布链路集成:
51
51
  - `release.yml` 在 tag 发布时自动尝试基于 `handoff-runs.json` 生成 release notes 草稿。
@@ -63,7 +63,7 @@
63
63
  - 编排引擎在 429/RateLimit 错误重试时,支持解析 `Retry-After`/`try again in` 提示并抬升 backoff。
64
64
  - 减少服务端限流窗口内的无效重试与“卡死感”。
65
65
  23. 新增 release gate 历史索引命令:
66
- - `kse auto handoff gate-index` 聚合 `release-gate-*.json` 为跨版本历史索引。
66
+ - `sce auto handoff gate-index` 聚合 `release-gate-*.json` 为跨版本历史索引。
67
67
  - 支持与已有历史索引合并去重(按 tag/file),输出门禁通过率与风险分布聚合指标。
68
68
  24. 发布流程自动产出门禁历史索引:
69
69
  - `release.yml` 在 gate 评估后自动执行 `handoff gate-index`,生成 `release-gate-history.json` 与当次 summary。
@@ -75,7 +75,7 @@
75
75
  - `release.yml` 在发布前将 `release-gate-history` 的近 5 版趋势追加到 Release Notes。
76
76
  - 发布页可直接看到 gate pass ratio、风险分布与近期版本轨迹。
77
77
  27. 新增 gate-index Markdown 趋势卡片:
78
- - `kse auto handoff gate-index --markdown-out <path>` 直接产出可读趋势卡片。
78
+ - `sce auto handoff gate-index --markdown-out <path>` 直接产出可读趋势卡片。
79
79
  - 便于在 PR/Issue 中复用,降低历史门禁审阅成本。
80
80
  28. 发布流程附带趋势卡片资产:
81
81
  - `release.yml` 自动生成并上传 `release-gate-history-<tag>.md`。
@@ -96,34 +96,34 @@
96
96
  - `release.yml` 将 drift 评估结果回写到 `release-gate-<tag>.json` 的 `drift` 字段。
97
97
  - 单一门禁产物同时覆盖 gate 与 drift 审计口径,便于回放。
98
98
  34. gate-index 漂移趋势聚合:
99
- - `kse auto handoff gate-index` 聚合 `drift_alert_count/drift_blocked` 指标并输出 markdown 趋势。
99
+ - `sce auto handoff gate-index` 聚合 `drift_alert_count/drift_blocked` 指标并输出 markdown 趋势。
100
100
  - 发布流程在 drift 合并后自动刷新一次 gate-index,确保当次 release 资产包含 drift 最新状态。
101
101
  35. 治理默认评估接入 handoff 发布信号:
102
- - `kse auto governance stats` 默认读取 `release-gate-history.json`,将 gate/drift/scene-batch 信号纳入风险评估。
102
+ - `sce auto governance stats` 默认读取 `release-gate-history.json`,将 gate/drift/scene-batch 信号纳入风险评估。
103
103
  - 治理健康输出新增 `health.release_gate` 快照,concerns/recommendations 自动给出 release 质量回归处置建议。
104
104
  36. 治理 close-loop 轮次遥测接入发布信号:
105
- - `kse auto governance close-loop` 每轮输出 `release_gate_before/release_gate_after`,与 `risk_before/risk_after` 对齐。
105
+ - `sce auto governance close-loop` 每轮输出 `release_gate_before/release_gate_after`,与 `risk_before/risk_after` 对齐。
106
106
  - 轮次级审计可直接追踪 release gate/drift/scene-batch 信号在治理动作前后的变化。
107
107
  37. 治理会话统计聚合 release gate 轮次趋势:
108
- - `kse auto governance session stats` 新增 `release_gate` 聚合区块,覆盖 gate fail/drift alert/blocked 与通过率均值。
108
+ - `sce auto governance session stats` 新增 `release_gate` 聚合区块,覆盖 gate fail/drift alert/blocked 与通过率均值。
109
109
  - 会话统计输出同时汇总 `round_telemetry_observed/changed`,可量化治理轮次对发布质量信号的影响。
110
110
  38. 治理 close-loop 接入 release gate 阻断语义:
111
- - `kse auto governance close-loop` 在 release gate/drift 信号异常时输出 `stop_reason=release-gate-blocked`。
111
+ - `sce auto governance close-loop` 在 release gate/drift 信号异常时输出 `stop_reason=release-gate-blocked`。
112
112
  - 结果新增 `stop_detail` 与 `recommendations`,显式给出阻断原因与处置命令。
113
113
  39. 治理 maintain 计划默认优先 release gate 修复:
114
- - `kse auto governance maintain` 在 release gate 阻断时优先产出 `release-gate-evidence-review` / `release-gate-scene-batch-remediate`。
114
+ - `sce auto governance maintain` 在 release gate 阻断时优先产出 `release-gate-evidence-review` / `release-gate-scene-batch-remediate`。
115
115
  - 发布质量阻断先处理,再执行常规会话/内存清理动作。
116
116
  40. handoff run 接入 release gate preflight 与失败摘要:
117
- - `kse auto handoff run` 默认输出 `release_gate_preflight`,在 precheck 阶段给出 release gate 阻断提示。
117
+ - `sce auto handoff run` 默认输出 `release_gate_preflight`,在 precheck 阶段给出 release gate 阻断提示。
118
118
  - 失败结果新增 `failure_summary`,统一汇总 phase/gate/release-gate 阻断原因并联动推荐命令。
119
119
  41. handoff run 增加 release gate 可选硬门禁:
120
120
  - 新增 `--require-release-gate-preflight`,可在生产场景将 release gate preflight 从 advisory 升级为 hard-fail。
121
121
  - 默认保持 advisory,避免对现有项目引入破坏性变更。
122
122
  42. release draft/evidence review 纳入 preflight 与失败摘要信号:
123
- - `kse auto handoff evidence --format markdown` 新增 `Current Release Gate Preflight` 与 `Current Failure Summary`。
123
+ - `sce auto handoff evidence --format markdown` 新增 `Current Release Gate Preflight` 与 `Current Failure Summary`。
124
124
  - release notes draft 摘要新增 preflight 可用性、阻断状态、hard-gate 模式与失败高亮。
125
125
  43. gate-index 趋势卡片纳入 preflight/hard-gate 聚合:
126
- - `kse auto handoff gate-index` 聚合 `release_gate_preflight_*` 指标并在 markdown 趋势卡片展示。
126
+ - `sce auto handoff gate-index` 聚合 `release_gate_preflight_*` 指标并在 markdown 趋势卡片展示。
127
127
  - Recent entries 行新增 `preflight-blocked` / `hard-gate` 维度,便于跨版本定位阻断模式。
128
128
  44. release workflow 漂移判定纳入 preflight/hard-gate 趋势:
129
129
  - `release.yml` 的 drift alert 增加 preflight blocked rate、hard-gate blocked streak、preflight unavailable streak 三类阈值。
@@ -142,12 +142,12 @@
142
142
  - `release.yml` 的 Evaluate drift 步骤改为直接调用脚本,消除大段内联 heredoc,降低语法错误与维护成本。
143
143
  - 新增 `tests/unit/scripts/release-drift-evaluate.test.js` 覆盖 advisory/enforce/missing history/gate report 写回四类场景。
144
144
  2. handoff 质量指标接入 governance 默认评估闭环:
145
- - `kse auto governance stats` 默认聚合 `.kiro/reports/release-evidence/handoff-runs.json`,输出 `health.handoff_quality` 快照。
145
+ - `sce auto governance stats` 默认聚合 `.kiro/reports/release-evidence/handoff-runs.json`,输出 `health.handoff_quality` 快照。
146
146
  - `risk/concerns/recommendations` 自动纳入 handoff 最新状态、gate、ontology、capability、preflight 阻断等信号。
147
- - `kse auto governance close-loop` 的阻断判断纳入 handoff 严重质量信号,统一通过 `stop_reason=release-gate-blocked` 回传处置语义。
148
- - `kse auto governance maintain` 在 handoff 质量阻断时新增 `release-gate-handoff-remediate` 建议动作。
147
+ - `sce auto governance close-loop` 的阻断判断纳入 handoff 严重质量信号,统一通过 `stop_reason=release-gate-blocked` 回传处置语义。
148
+ - `sce auto governance maintain` 在 handoff 质量阻断时新增 `release-gate-handoff-remediate` 建议动作。
149
149
  3. release evidence 与治理视图合并:
150
- - `kse auto handoff evidence` 报告新增 `governance_snapshot`(risk/concerns/recommendations + release/handoff health)。
150
+ - `sce auto handoff evidence` 报告新增 `governance_snapshot`(risk/concerns/recommendations + release/handoff health)。
151
151
  - evidence markdown 与 release draft 同步输出 `Governance Snapshot` 区块,形成可发布的一体化治理审阅材料。
152
152
 
153
153
  ## 下一阶段(新)
@@ -1,6 +1,6 @@
1
- # 331-poc 双轨协同对接手册
1
+ # 331-poc 双轨协同对接手册
2
2
 
3
- > 目的:在 `kiro-spec-engine` 侧承接 331-poc 的深度补全成果,完成模板接入、ontology 校验、主从编排与闭环验收。
3
+ > 目的:在 `scene-capability-engine` 侧承接 331-poc 的深度补全成果,完成模板接入、ontology 校验、主从编排与闭环验收。
4
4
 
5
5
  ## 1. 输入契约(来自 331-poc)
6
6
 
@@ -10,22 +10,22 @@
10
10
  2. 模板导出目录:`.kiro/templates/exports/<template-name>/`。
11
11
  3. 交接包:`docs/handoffs/handoff-manifest.json` + 证据文档。
12
12
 
13
- 若输入不满足以上三类,KSE 侧不进入接入批次。
13
+ 若输入不满足以上三类,sce 侧不进入接入批次。
14
14
 
15
- ## 2. KSE 侧接入流程
15
+ ## 2. sce 侧接入流程
16
16
 
17
17
  ## 2.0 一键化入口(推荐)
18
18
 
19
19
  推荐直接使用一条命令闭环执行:
20
20
 
21
21
  ```bash
22
- npx kse auto handoff run --manifest ../331-poc/docs/handoffs/handoff-manifest.json --json
22
+ npx sce auto handoff run --manifest ../331-poc/docs/handoffs/handoff-manifest.json --json
23
23
  ```
24
24
 
25
25
  需要提高成功率门槛时:
26
26
 
27
27
  ```bash
28
- npx kse auto handoff run --manifest ../331-poc/docs/handoffs/handoff-manifest.json \
28
+ npx sce auto handoff run --manifest ../331-poc/docs/handoffs/handoff-manifest.json \
29
29
  --min-spec-success-rate 95 \
30
30
  --max-risk-level medium \
31
31
  --json
@@ -34,15 +34,15 @@ npx kse auto handoff run --manifest ../331-poc/docs/handoffs/handoff-manifest.js
34
34
  建议每轮执行后追加两条诊断命令:
35
35
 
36
36
  ```bash
37
- npx kse auto handoff template-diff --manifest ../331-poc/docs/handoffs/handoff-manifest.json --json
38
- npx kse auto handoff regression --session-id latest --json
37
+ npx sce auto handoff template-diff --manifest ../331-poc/docs/handoffs/handoff-manifest.json --json
38
+ npx sce auto handoff regression --session-id latest --json
39
39
  ```
40
40
 
41
41
  ## 2.1 批次 1:输入预检
42
42
 
43
43
  ```bash
44
- npx kse status --verbose
45
- npx kse doctor --docs
44
+ npx sce status --verbose
45
+ npx sce doctor --docs
46
46
  ```
47
47
 
48
48
  核对 `handoff-manifest.json`:
@@ -55,10 +55,10 @@ npx kse doctor --docs
55
55
  对每个 handoff spec 执行:
56
56
 
57
57
  ```bash
58
- npx kse scene package-validate --spec <spec-name> --spec-package custom/scene-package.json --strict --json
59
- npx kse scene ontology validate --package .kiro/specs/<spec-name>/custom --json
60
- npx kse scene ontology impact --package .kiro/specs/<spec-name>/custom --ref <ref> --max-depth 2 --json
61
- npx kse scene ontology path --package .kiro/specs/<spec-name>/custom --from <from-ref> --to <to-ref> --json
58
+ npx sce scene package-validate --spec <spec-name> --spec-package custom/scene-package.json --strict --json
59
+ npx sce scene ontology validate --package .kiro/specs/<spec-name>/custom --json
60
+ npx sce scene ontology impact --package .kiro/specs/<spec-name>/custom --ref <ref> --max-depth 2 --json
61
+ npx sce scene ontology path --package .kiro/specs/<spec-name>/custom --from <from-ref> --to <to-ref> --json
62
62
  ```
63
63
 
64
64
  ## 2.3 批次 3:模板层接入
@@ -66,10 +66,10 @@ npx kse scene ontology path --package .kiro/specs/<spec-name>/custom --from <fro
66
66
  对于 scene package 模板链路(如果本轮包含 scene-package 模板):
67
67
 
68
68
  ```bash
69
- npx kse scene package-publish --spec <spec-name> --out-dir .kiro/templates/scene-packages --json --force
70
- npx kse scene package-registry --template-dir .kiro/templates/scene-packages --strict --json
71
- npx kse scene package-gate-template --out .kiro/templates/scene-package-gate-policy.json --profile three-layer --force --json
72
- npx kse scene package-gate --registry .kiro/templates/scene-packages/registry.json --policy .kiro/templates/scene-package-gate-policy.json --strict --json
69
+ npx sce scene package-publish --spec <spec-name> --out-dir .kiro/templates/scene-packages --json --force
70
+ npx sce scene package-registry --template-dir .kiro/templates/scene-packages --strict --json
71
+ npx sce scene package-gate-template --out .kiro/templates/scene-package-gate-policy.json --profile three-layer --force --json
72
+ npx sce scene package-gate --registry .kiro/templates/scene-packages/registry.json --policy .kiro/templates/scene-package-gate-policy.json --strict --json
73
73
  ```
74
74
 
75
75
  说明:Spec 模板(`templates create-from-spec` 导出)与 scene package 模板是两条链路,可并行维护,但推荐在同一交接批次一并校验。
@@ -79,9 +79,9 @@ npx kse scene package-gate --registry .kiro/templates/scene-packages/registry.js
79
79
  基于本轮 spec 组合,执行自动闭环 dry-run/正式 run:
80
80
 
81
81
  ```bash
82
- npx kse auto close-loop --specs "<spec-a>,<spec-b>,<spec-c>" --dry-run --json
83
- npx kse auto close-loop --specs "<spec-a>,<spec-b>,<spec-c>" --json
84
- npx kse auto observability snapshot --json
82
+ npx sce auto close-loop --specs "<spec-a>,<spec-b>,<spec-c>" --dry-run --json
83
+ npx sce auto close-loop --specs "<spec-a>,<spec-b>,<spec-c>" --json
84
+ npx sce auto observability snapshot --json
85
85
  ```
86
86
 
87
87
  判定标准:
@@ -89,7 +89,7 @@ npx kse auto observability snapshot --json
89
89
  2. 不出现高风险未处置项。
90
90
  3. observability 快照可追踪到本轮变更。
91
91
 
92
- ## 3. KSE 侧当前需持续适配的点
92
+ ## 3. sce 侧当前需持续适配的点
93
93
 
94
94
  1. 对接自动化:把 331 handoff manifest 解析为可执行批次计划。
95
95
  2. ontology 深化:将“业务规则/决策逻辑”映射为可量化 gate 指标。
@@ -99,22 +99,22 @@ npx kse auto observability snapshot --json
99
99
  ## 4. 角色划分
100
100
 
101
101
  1. 331-poc Agent:交付业务事实、完成态 Spec、模板和证据。
102
- 2. KSE Agent:执行接入验证、治理门禁、主从闭环与发布收口。
102
+ 2. sce Agent:执行接入验证、治理门禁、主从闭环与发布收口。
103
103
  3. Master Agent:维护跨仓上下文与批次节奏。
104
104
 
105
105
  ## 5. 失败处理
106
106
 
107
- 1. 输入缺失:退回 331-poc,标注缺失项,不进入 KSE 接入。
107
+ 1. 输入缺失:退回 331-poc,标注缺失项,不进入 sce 接入。
108
108
  2. ontology 校验失败:先修 ref/lineage,再跑 gate。
109
109
  3. 主从编排失败:降并发、缩批次、保留快照后重试。
110
110
 
111
111
  ## 6. 最终交付口径
112
112
 
113
- 每个接入批次结束后,KSE 侧必须输出:
113
+ 每个接入批次结束后,sce 侧必须输出:
114
114
  1. 接入批次执行记录(命令、结果、失败点)。
115
115
  2. gate 与 observability 快照。
116
116
  3. 下一批次建议(可直接执行)。
117
117
 
118
118
  ## 7. 持续推进参考
119
119
 
120
- KSE 侧后续增强计划见:`docs/331-poc-adaptation-roadmap.md`
120
+ sce 侧后续增强计划见:`docs/331-poc-adaptation-roadmap.md`
@@ -1,4 +1,4 @@
1
- # 331-poc Weekly Delivery Checklist (For KSE Integration)
1
+ # 331-poc Weekly Delivery Checklist (For sce Integration)
2
2
 
3
3
  Use this checklist before each integration batch.
4
4
 
@@ -24,24 +24,24 @@ Use this checklist before each integration batch.
24
24
  - Dependency relations (`depends_on`) are present for multi-spec batches.
25
25
  - High-risk gaps have mitigation notes.
26
26
 
27
- ## KSE Acceptance Commands
27
+ ## sce Acceptance Commands
28
28
 
29
29
  ```bash
30
- npx kse auto handoff run --manifest ../331-poc/docs/handoffs/handoff-manifest.json \\
30
+ npx sce auto handoff run --manifest ../331-poc/docs/handoffs/handoff-manifest.json \\
31
31
  --min-spec-success-rate 95 \\
32
32
  --max-risk-level medium \\
33
33
  --json
34
34
 
35
- npx kse auto handoff template-diff --manifest ../331-poc/docs/handoffs/handoff-manifest.json --json
36
- npx kse auto handoff regression --session-id latest --json
35
+ npx sce auto handoff template-diff --manifest ../331-poc/docs/handoffs/handoff-manifest.json --json
36
+ npx sce auto handoff regression --session-id latest --json
37
37
  ```
38
38
 
39
39
  ## Scene Package Gate Commands
40
40
 
41
41
  ```bash
42
- npx kse scene package-registry --template-dir .kiro/templates/scene-packages --strict --json
43
- npx kse scene package-gate-template --out .kiro/templates/scene-package-gate-policy.json --profile three-layer --force --json
44
- npx kse scene package-gate --registry .kiro/templates/scene-packages/registry.json --policy .kiro/templates/scene-package-gate-policy.json --strict --json
42
+ npx sce scene package-registry --template-dir .kiro/templates/scene-packages --strict --json
43
+ npx sce scene package-gate-template --out .kiro/templates/scene-package-gate-policy.json --profile three-layer --force --json
44
+ npx sce scene package-gate --registry .kiro/templates/scene-packages/registry.json --policy .kiro/templates/scene-package-gate-policy.json --strict --json
45
45
  ```
46
46
 
47
47
  ## Batch Exit Criteria
@@ -1,4 +1,4 @@
1
- # kse 离线安装指南
1
+ # sce 离线安装指南
2
2
 
3
3
  > 适用于无法直接访问 npm registry 的环境。
4
4
 
@@ -25,18 +25,18 @@ npm --version
25
25
 
26
26
  ## 方式 1:使用 `.tgz` 离线包安装(推荐)
27
27
 
28
- 1. 获取离线包文件(示例:`kiro-spec-engine-1.46.2.tgz`)。
28
+ 1. 获取离线包文件(示例:`scene-capability-engine-1.46.2.tgz`)。
29
29
  2. 在目标机器执行:
30
30
 
31
31
  ```bash
32
- npm install -g kiro-spec-engine-1.46.2.tgz
32
+ npm install -g scene-capability-engine-1.46.2.tgz
33
33
  ```
34
34
 
35
35
  3. 验证:
36
36
 
37
37
  ```bash
38
- kse --version
39
- kse --help
38
+ sce --version
39
+ sce --help
40
40
  ```
41
41
 
42
42
  ---
@@ -54,7 +54,7 @@ npm install -g .
54
54
  3. 验证:
55
55
 
56
56
  ```bash
57
- kse --version
57
+ sce --version
58
58
  ```
59
59
 
60
60
  ---
@@ -78,10 +78,10 @@ npm --version
78
78
 
79
79
  ```bash
80
80
  cd your-project
81
- kse adopt
82
- kse spec bootstrap --name 01-00-demo-feature --non-interactive
83
- kse value metrics sample --out ./kpi-input.json --json
84
- kse value metrics snapshot --input ./kpi-input.json --json
81
+ sce adopt
82
+ sce spec bootstrap --name 01-00-demo-feature --non-interactive
83
+ sce value metrics sample --out ./kpi-input.json --json
84
+ sce value metrics snapshot --input ./kpi-input.json --json
85
85
  ```
86
86
 
87
87
  如果最后一步成功,说明你的环境已经可以输出机器可读 KPI 结果(用于周度评审和门禁证据)。