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
@@ -1,6 +1,6 @@
1
- # Using kse with Windsurf
1
+ # Using sce with Windsurf
2
2
 
3
- > Complete guide to integrating kse with Windsurf for automated AI-assisted development
3
+ > Complete guide to integrating sce with Windsurf for automated AI-assisted development
4
4
 
5
5
  ---
6
6
 
@@ -16,17 +16,17 @@
16
16
 
17
17
  **Windsurf** is an AI coding agent that can execute commands, modify files, and interact with your development environment autonomously.
18
18
 
19
- **kse integration with Windsurf** supports all three modes:
20
- - **Native-like**: Windsurf can execute kse commands directly
19
+ **sce integration with Windsurf** supports all three modes:
20
+ - **Native-like**: Windsurf can execute sce commands directly
21
21
  - **Manual Export**: Traditional export and paste workflow
22
22
  - **Watch Mode**: Automatic context updates
23
23
 
24
- ### Why Use kse with Windsurf?
24
+ ### Why Use sce with Windsurf?
25
25
 
26
- - ✅ **Fully automated** - Windsurf can run kse commands itself
26
+ - ✅ **Fully automated** - Windsurf can run sce commands itself
27
27
  - ✅ **Command execution** - No manual copy-paste needed
28
28
  - ✅ **File modification** - Windsurf updates tasks.md automatically
29
- - ✅ **Best automation** - Most seamless kse integration after Kiro
29
+ - ✅ **Best automation** - Most seamless sce integration after SCE
30
30
 
31
31
  ---
32
32
 
@@ -36,17 +36,17 @@
36
36
 
37
37
  **How it works:**
38
38
  1. You tell Windsurf what to build
39
- 2. Windsurf executes `kse context export` automatically
39
+ 2. Windsurf executes `sce context export` automatically
40
40
  3. Windsurf reads the exported context
41
41
  4. Windsurf implements the feature
42
42
  5. Windsurf updates tasks.md automatically
43
43
 
44
44
  **Example:**
45
45
  ```
46
- You: "Implement the user login feature using kse"
46
+ You: "Implement the user login feature using sce"
47
47
 
48
48
  Windsurf:
49
- [Executes] kse context export 01-00-user-login
49
+ [Executes] sce context export 01-00-user-login
50
50
  [Reads] .kiro/specs/01-00-user-login/context-export.md
51
51
  [Implements] Code according to design
52
52
  [Updates] tasks.md with completed tasks
@@ -55,7 +55,7 @@ Windsurf:
55
55
  ### Mode 2: Watch Mode + Windsurf
56
56
 
57
57
  **How it works:**
58
- 1. Start kse watch mode
58
+ 1. Start sce watch mode
59
59
  2. Edit Specs, context auto-updates
60
60
  3. Windsurf always has latest context
61
61
  4. Fully automated workflow
@@ -67,37 +67,37 @@ Windsurf:
67
67
  ### Prerequisites
68
68
 
69
69
  - **Windsurf installed** ([Download](https://windsurf.ai/))
70
- - **kse installed** globally (`npm install -g kiro-spec-engine`)
71
- - **Project adopted** by kse (`kse adopt`)
70
+ - **sce installed** globally (`npm install -g scene-capability-engine`)
71
+ - **Project adopted** by sce (`sce adopt`)
72
72
 
73
73
  ### Step 1: Configure Windsurf System Prompt
74
74
 
75
75
  Add to Windsurf's system prompt or project instructions:
76
76
 
77
77
  ```markdown
78
- # kse Integration
78
+ # sce Integration
79
79
 
80
- This project uses kse (Kiro Spec Engine) for spec-driven development.
80
+ This project uses sce (Scene Capability Engine) for spec-driven development.
81
81
 
82
82
  ## Before Implementing Features
83
83
 
84
- 1. Check if a Spec exists: `kse status`
85
- 2. Export Spec context: `kse context export <spec-name>`
84
+ 1. Check if a Spec exists: `sce status`
85
+ 2. Export Spec context: `sce context export <spec-name>`
86
86
  3. Read the exported context file
87
87
  4. Follow the design document exactly
88
88
  5. Update tasks.md when completing tasks
89
89
 
90
- ## kse Commands
90
+ ## sce Commands
91
91
 
92
- - `kse status` - Show project status and available Specs
93
- - `kse context export <spec-name>` - Export Spec context
94
- - `kse task claim <spec-name> <task-id>` - Claim a task
95
- - `kse prompt generate <spec-name> <task-id>` - Generate task prompt
92
+ - `sce status` - Show project status and available Specs
93
+ - `sce context export <spec-name>` - Export Spec context
94
+ - `sce task claim <spec-name> <task-id>` - Claim a task
95
+ - `sce prompt generate <spec-name> <task-id>` - Generate task prompt
96
96
 
97
97
  ## Workflow
98
98
 
99
99
  When user asks to implement a feature:
100
- 1. Run `kse context export <spec-name>`
100
+ 1. Run `sce context export <spec-name>`
101
101
  2. Read `.kiro/specs/<spec-name>/context-export.md`
102
102
  3. Implement according to design
103
103
  4. Update `.kiro/specs/<spec-name>/tasks.md` (change [ ] to [x])
@@ -106,7 +106,7 @@ When user asks to implement a feature:
106
106
 
107
107
  User: "Implement user login"
108
108
  You should:
109
- 1. `kse context export 01-00-user-login`
109
+ 1. `sce context export 01-00-user-login`
110
110
  2. Read context file
111
111
  3. Implement AuthController, AuthService, etc.
112
112
  4. Update tasks.md: `- [x] 1.1 Create AuthController`
@@ -115,9 +115,9 @@ You should:
115
115
  ### Step 2: Enable Watch Mode (Optional)
116
116
 
117
117
  ```bash
118
- kse watch init
119
- kse watch install context-export
120
- kse watch start
118
+ sce watch init
119
+ sce watch install context-export
120
+ sce watch start
121
121
  ```
122
122
 
123
123
  ---
@@ -128,16 +128,16 @@ kse watch start
128
128
 
129
129
  **Step 1: Tell Windsurf what to build**
130
130
  ```
131
- You: "I need to implement the user login feature. Use kse to get the Spec and implement it."
131
+ You: "I need to implement the user login feature. Use sce to get the Spec and implement it."
132
132
  ```
133
133
 
134
134
  **Step 2: Windsurf executes automatically**
135
135
  ```
136
136
  Windsurf:
137
- [Executes] kse status
137
+ [Executes] sce status
138
138
  [Output] Found Spec: 01-00-user-login
139
139
 
140
- [Executes] kse context export 01-00-user-login
140
+ [Executes] sce context export 01-00-user-login
141
141
  [Output] Context exported to context-export.md
142
142
 
143
143
  [Reads] .kiro/specs/01-00-user-login/context-export.md
@@ -166,10 +166,10 @@ Windsurf:
166
166
 
167
167
  **More control over implementation:**
168
168
  ```
169
- You: "Use kse to get the user login Spec, then implement task 1.1 only"
169
+ You: "Use sce to get the user login Spec, then implement task 1.1 only"
170
170
 
171
171
  Windsurf:
172
- [Executes] kse context export 01-00-user-login
172
+ [Executes] sce context export 01-00-user-login
173
173
  [Reads] context
174
174
  [Implements] Only task 1.1
175
175
  [Updates] tasks.md
@@ -186,7 +186,7 @@ Windsurf:
186
186
  **Setup once, use forever:**
187
187
  ```bash
188
188
  # Terminal 1: Start watch mode
189
- kse watch start
189
+ sce watch start
190
190
 
191
191
  # Terminal 2: Work with Windsurf
192
192
  # Edit Specs → Context auto-updates → Windsurf always has latest
@@ -202,7 +202,7 @@ kse watch start
202
202
 
203
203
  **1. Create Spec**
204
204
  ```bash
205
- kse spec bootstrap --name 01-00-user-login --non-interactive
205
+ sce spec bootstrap --name 01-00-user-login --non-interactive
206
206
  # Edit requirements.md, design.md, tasks.md
207
207
  ```
208
208
 
@@ -211,7 +211,7 @@ kse spec bootstrap --name 01-00-user-login --non-interactive
211
211
  You: "I've created a Spec for user login at .kiro/specs/01-00-user-login/
212
212
 
213
213
  Please:
214
- 1. Use kse to export the context
214
+ 1. Use sce to export the context
215
215
  2. Read the requirements and design
216
216
  3. Implement all tasks in order
217
217
  4. Update tasks.md as you complete each task
@@ -241,11 +241,11 @@ Windsurf:
241
241
 
242
242
  ## Tips & Best Practices
243
243
 
244
- ### 1. Let Windsurf Execute kse Commands
244
+ ### 1. Let Windsurf Execute sce Commands
245
245
 
246
246
  **Good:**
247
247
  ```
248
- "Use kse to get the Spec for user login and implement it"
248
+ "Use sce to get the Spec for user login and implement it"
249
249
  ```
250
250
 
251
251
  **Not as good:**
@@ -263,7 +263,7 @@ Windsurf:
263
263
  ### 3. Use Task Claiming
264
264
 
265
265
  ```
266
- "Before implementing, claim task 1.1 using: kse task claim 01-00-user-login 1.1"
266
+ "Before implementing, claim task 1.1 using: sce task claim 01-00-user-login 1.1"
267
267
  ```
268
268
 
269
269
  ### 4. Request Progress Updates
@@ -276,7 +276,7 @@ Windsurf:
276
276
 
277
277
  ```bash
278
278
  # Keep watch mode running
279
- kse watch start
279
+ sce watch start
280
280
 
281
281
  # Tell Windsurf
282
282
  "The Spec context auto-updates. Just read the latest context-export.md file"
@@ -329,9 +329,9 @@ kse watch start
329
329
 
330
330
  ## Troubleshooting
331
331
 
332
- ### Issue: Windsurf doesn't know about kse
332
+ ### Issue: Windsurf doesn't know about sce
333
333
 
334
- **Solution:** Add kse instructions to system prompt (see Setup section)
334
+ **Solution:** Add sce instructions to system prompt (see Setup section)
335
335
 
336
336
  ### Issue: Windsurf doesn't update tasks.md
337
337
 
@@ -354,34 +354,34 @@ to:
354
354
 
355
355
  ## Related Documentation
356
356
 
357
- - **[Quick Start Guide](../quick-start.md)** - Get started with kse
357
+ - **[Quick Start Guide](../quick-start.md)** - Get started with sce
358
358
  - **[Integration Modes](../integration-modes.md)** - Understanding integration modes
359
- - **[Command Reference](../command-reference.md)** - All kse commands
359
+ - **[Command Reference](../command-reference.md)** - All sce commands
360
360
 
361
361
  ---
362
362
 
363
363
  ## Summary
364
364
 
365
- **Windsurf + kse = Most Automated Workflow**
365
+ **Windsurf + sce = Most Automated Workflow**
366
366
 
367
367
  **Key advantages:**
368
- - ✅ Windsurf executes kse commands automatically
368
+ - ✅ Windsurf executes sce commands automatically
369
369
  - ✅ No manual copy-paste needed
370
370
  - ✅ Automatic task tracking
371
371
  - ✅ Full feature implementation with minimal intervention
372
372
 
373
373
  **Best practices:**
374
- - Configure system prompt with kse instructions
375
- - Let Windsurf execute kse commands
374
+ - Configure system prompt with sce instructions
375
+ - Let Windsurf execute sce commands
376
376
  - Use watch mode for auto-updates
377
377
  - Request progress updates
378
378
  - Review before approving changes
379
379
 
380
380
  **Start using:** 🚀
381
381
  ```bash
382
- kse adopt
383
- kse spec bootstrap --name 01-00-my-feature --non-interactive
384
- # Tell Windsurf: "Use kse to implement 01-00-my-feature"
382
+ sce adopt
383
+ sce spec bootstrap --name 01-00-my-feature --non-interactive
384
+ # Tell Windsurf: "Use sce to implement 01-00-my-feature"
385
385
  ```
386
386
 
387
387
  ---