scene-capability-engine 3.0.1 → 3.0.3

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 (172) hide show
  1. package/CHANGELOG.md +235 -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 +31 -16
  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/images/wechat-qr.png +0 -0
  34. package/docs/integration-modes.md +60 -60
  35. package/docs/integration-philosophy.md +48 -48
  36. package/docs/knowledge-management-guide.md +21 -21
  37. package/docs/manual-workflows-guide.md +20 -20
  38. package/docs/moqui-capability-matrix.md +43 -22
  39. package/docs/moqui-template-core-library-playbook.md +49 -21
  40. package/docs/multi-agent-coordination-guide.md +19 -19
  41. package/docs/multi-repo-management-guide.md +93 -93
  42. package/docs/quick-start-with-ai-tools.md +36 -36
  43. package/docs/quick-start.md +16 -16
  44. package/docs/release-checklist.md +7 -7
  45. package/docs/releases/v1.46.2-validation.md +1 -1
  46. package/docs/releases/v1.46.2.md +10 -10
  47. package/docs/scene-runtime-guide.md +42 -42
  48. package/docs/spec-collaboration-guide.md +43 -43
  49. package/docs/spec-locking-guide.md +26 -26
  50. package/docs/spec-numbering-guide.md +6 -6
  51. package/docs/spec-workflow.md +25 -25
  52. package/docs/steering-strategy-guide.md +36 -36
  53. package/docs/team-collaboration-guide.md +23 -23
  54. package/docs/testing-strategy.md +2 -2
  55. package/docs/tools/claude-guide.md +26 -26
  56. package/docs/tools/cursor-guide.md +31 -31
  57. package/docs/tools/generic-guide.md +22 -22
  58. package/docs/tools/kiro-guide.md +43 -43
  59. package/docs/tools/vscode-guide.md +18 -18
  60. package/docs/tools/windsurf-guide.md +50 -50
  61. package/docs/troubleshooting.md +116 -116
  62. package/docs/upgrade-guide.md +49 -49
  63. package/docs/value-observability-guide.md +6 -6
  64. package/docs/zh/README.md +22 -22
  65. package/docs/zh/quick-start.md +34 -34
  66. package/docs/zh/release-checklist.md +6 -6
  67. package/docs/zh/releases/v1.46.2-validation.md +1 -1
  68. package/docs/zh/releases/v1.46.2.md +9 -9
  69. package/docs/zh/spec-numbering-guide.md +6 -6
  70. package/docs/zh/tools/claude-guide.md +14 -14
  71. package/docs/zh/tools/cursor-guide.md +18 -18
  72. package/docs/zh/tools/generic-guide.md +40 -40
  73. package/docs/zh/tools/kiro-guide.md +50 -50
  74. package/docs/zh/tools/vscode-guide.md +20 -20
  75. package/docs/zh/tools/windsurf-guide.md +49 -49
  76. package/docs/zh/value-observability-guide.md +6 -6
  77. package/docs//344/272/244/344/273/230/346/270/205/345/215/225.md +4 -4
  78. package/lib/adoption/adoption-logger.js +1 -1
  79. package/lib/adoption/adoption-strategy.js +3 -3
  80. package/lib/adoption/detection-engine.js +1 -1
  81. package/lib/adoption/error-formatter.js +17 -17
  82. package/lib/adoption/progress-reporter.js +2 -2
  83. package/lib/adoption/smart-orchestrator.js +2 -2
  84. package/lib/adoption/strategy-selector.js +2 -2
  85. package/lib/adoption/summary-generator.js +3 -3
  86. package/lib/auto/autonomous-engine.js +2 -2
  87. package/lib/auto/close-loop-runner.js +9 -9
  88. package/lib/backup/backup-system.js +2 -2
  89. package/lib/collab/collab-manager.js +2 -2
  90. package/lib/commands/adopt.js +16 -16
  91. package/lib/commands/auto.js +1148 -106
  92. package/lib/commands/collab.js +8 -8
  93. package/lib/commands/docs.js +26 -26
  94. package/lib/commands/doctor.js +2 -2
  95. package/lib/commands/env.js +14 -14
  96. package/lib/commands/knowledge.js +13 -13
  97. package/lib/commands/lock.js +6 -6
  98. package/lib/commands/ops.js +19 -19
  99. package/lib/commands/orchestrate.js +5 -5
  100. package/lib/commands/prompt.js +3 -3
  101. package/lib/commands/rollback.js +4 -4
  102. package/lib/commands/scene.js +30 -30
  103. package/lib/commands/spec-bootstrap.js +1 -1
  104. package/lib/commands/spec-gate.js +1 -1
  105. package/lib/commands/spec-pipeline.js +1 -1
  106. package/lib/commands/task.js +1 -1
  107. package/lib/commands/templates.js +27 -27
  108. package/lib/commands/upgrade.js +8 -8
  109. package/lib/commands/value.js +4 -4
  110. package/lib/commands/watch.js +9 -9
  111. package/lib/commands/workflows.js +5 -5
  112. package/lib/commands/workspace-multi.js +17 -17
  113. package/lib/commands/workspace.js +5 -5
  114. package/lib/context/context-exporter.js +1 -1
  115. package/lib/context/prompt-generator.js +1 -1
  116. package/lib/data/moqui-capability-lexicon.json +258 -2
  117. package/lib/environment/environment-manager.js +1 -1
  118. package/lib/gitignore/gitignore-detector.js +4 -4
  119. package/lib/gitignore/gitignore-integration.js +2 -2
  120. package/lib/gitignore/gitignore-transformer.js +3 -3
  121. package/lib/gitignore/layered-rules-template.js +2 -2
  122. package/lib/governance/diagnostic-engine.js +4 -4
  123. package/lib/governance/doc-reference-checker.js +1 -1
  124. package/lib/governance/hooks-manager.js +5 -5
  125. package/lib/governance/reporter.js +1 -1
  126. package/lib/knowledge/knowledge-manager.js +6 -6
  127. package/lib/orchestrator/agent-spawner.js +1 -1
  128. package/lib/orchestrator/bootstrap-prompt-builder.js +2 -2
  129. package/lib/orchestrator/orchestration-engine.js +55 -6
  130. package/lib/repo/config-manager.js +2 -2
  131. package/lib/repo/handlers/init-handler.js +3 -3
  132. package/lib/scene-runtime/audit-emitter.js +2 -2
  133. package/lib/scene-runtime/binding-plugin-loader.js +1 -1
  134. package/lib/scene-runtime/moqui-adapter.js +2 -2
  135. package/lib/scene-runtime/moqui-extractor.js +3 -3
  136. package/lib/scene-runtime/scene-loader.js +3 -3
  137. package/lib/scene-runtime/scene-template-linter.js +1 -1
  138. package/lib/scene-runtime/templates/scene-template-erp-query-v0.1.yaml +1 -1
  139. package/lib/scene-runtime/templates/scene-template-hybrid-shadow-v0.1.yaml +1 -1
  140. package/lib/spec/multi-spec-orchestrate.js +1 -1
  141. package/lib/spec-gate/rules/default-rules.js +1 -1
  142. package/lib/steering/adoption-config.js +1 -1
  143. package/lib/steering/compliance-auto-fixer.js +1 -1
  144. package/lib/steering/compliance-cache.js +3 -3
  145. package/lib/steering/compliance-error-reporter.js +1 -1
  146. package/lib/steering/index.js +1 -1
  147. package/lib/steering/steering-manager.js +7 -7
  148. package/lib/task/task-claimer.js +2 -1
  149. package/lib/templates/metadata-collector.js +6 -6
  150. package/lib/templates/template-creator.js +2 -2
  151. package/lib/templates/template-exporter.js +12 -12
  152. package/lib/upgrade/migration-engine.js +4 -4
  153. package/lib/utils/tool-detector.js +25 -25
  154. package/lib/utils/validation.js +3 -3
  155. package/lib/version/version-checker.js +13 -13
  156. package/lib/version/version-manager.js +7 -7
  157. package/lib/watch/presets.js +4 -4
  158. package/lib/workspace/multi/path-utils.js +1 -1
  159. package/lib/workspace/multi/workspace-context-resolver.js +9 -9
  160. package/lib/workspace/multi/workspace-registry.js +2 -2
  161. package/lib/workspace/multi/workspace-state-manager.js +1 -1
  162. package/lib/workspace/multi/workspace.js +1 -1
  163. package/lib/workspace/workspace-sync.js +1 -1
  164. package/locales/en.json +1 -1
  165. package/locales/zh.json +1 -1
  166. package/package.json +3 -5
  167. package/template/.kiro/README.md +40 -40
  168. package/template/.kiro/specs/SPEC_WORKFLOW_GUIDE.md +3 -3
  169. package/template/.kiro/steering/CORE_PRINCIPLES.md +3 -3
  170. package/template/.kiro/steering/ENVIRONMENT.md +2 -2
  171. package/template/README.md +3 -3
  172. /package/bin/{kiro-spec-engine.js → scene-capability-engine.js} +0 -0
@@ -2,14 +2,14 @@
2
2
 
3
3
  ## Overview
4
4
 
5
- The Knowledge Management system allows you to build and maintain a personal knowledge base within your kse projects. Capture experiences, patterns, best practices, and lessons learned as you work.
5
+ The Knowledge Management system allows you to build and maintain a personal knowledge base within your sce projects. Capture experiences, patterns, best practices, and lessons learned as you work.
6
6
 
7
7
  ## Quick Start
8
8
 
9
9
  ### Initialize Knowledge Base
10
10
 
11
11
  ```bash
12
- kse knowledge init
12
+ sce knowledge init
13
13
  ```
14
14
 
15
15
  This creates `.kiro/knowledge/` directory with:
@@ -23,12 +23,12 @@ This creates `.kiro/knowledge/` directory with:
23
23
 
24
24
  ```bash
25
25
  # Add a design pattern
26
- kse knowledge add pattern "Repository Pattern Best Practices" \
26
+ sce knowledge add pattern "Repository Pattern Best Practices" \
27
27
  --tags "design-pattern,database" \
28
28
  --category backend
29
29
 
30
30
  # Add a lesson learned
31
- kse knowledge add lesson "Avoid N+1 Queries" \
31
+ sce knowledge add lesson "Avoid N+1 Queries" \
32
32
  --tags "performance,database" \
33
33
  --category optimization
34
34
  ```
@@ -37,51 +37,51 @@ kse knowledge add lesson "Avoid N+1 Queries" \
37
37
 
38
38
  ```bash
39
39
  # List all entries
40
- kse knowledge list
40
+ sce knowledge list
41
41
 
42
42
  # Filter by type
43
- kse knowledge list --type pattern
43
+ sce knowledge list --type pattern
44
44
 
45
45
  # Filter by tag
46
- kse knowledge list --tag database
46
+ sce knowledge list --tag database
47
47
 
48
48
  # Sort by date
49
- kse knowledge list --sort created:desc
49
+ sce knowledge list --sort created:desc
50
50
  ```
51
51
 
52
52
  ### Search
53
53
 
54
54
  ```bash
55
55
  # Search in titles and tags
56
- kse knowledge search "database"
56
+ sce knowledge search "database"
57
57
 
58
58
  # Full-text search in content
59
- kse knowledge search "repository" --full-text
59
+ sce knowledge search "repository" --full-text
60
60
  ```
61
61
 
62
62
  ### View Entry
63
63
 
64
64
  ```bash
65
- kse knowledge show kb-1770099318706-4dmali
65
+ sce knowledge show kb-1770099318706-4dmali
66
66
  ```
67
67
 
68
68
  ### Delete Entry
69
69
 
70
70
  ```bash
71
71
  # With confirmation
72
- kse knowledge delete kb-xxx
72
+ sce knowledge delete kb-xxx
73
73
 
74
74
  # Skip confirmation
75
- kse knowledge delete kb-xxx --force
75
+ sce knowledge delete kb-xxx --force
76
76
 
77
77
  # Without backup
78
- kse knowledge delete kb-xxx --force --no-backup
78
+ sce knowledge delete kb-xxx --force --no-backup
79
79
  ```
80
80
 
81
81
  ### Statistics
82
82
 
83
83
  ```bash
84
- kse knowledge stats
84
+ sce knowledge stats
85
85
  ```
86
86
 
87
87
  ## Entry Types
@@ -190,10 +190,10 @@ Content here...
190
190
 
191
191
  ```bash
192
192
  # Export all entries
193
- kse knowledge export --output my-knowledge.zip
193
+ sce knowledge export --output my-knowledge.zip
194
194
 
195
195
  # Import entries
196
- kse knowledge import my-knowledge.zip
196
+ sce knowledge import my-knowledge.zip
197
197
  ```
198
198
 
199
199
  ### Integration with Project
@@ -214,7 +214,7 @@ See implementation in `lib/repository/user-repository.js`
214
214
  Error: Knowledge base not initialized
215
215
  ```
216
216
 
217
- **Solution**: Run `kse knowledge init`
217
+ **Solution**: Run `sce knowledge init`
218
218
 
219
219
  ### Entry Not Found
220
220
 
@@ -222,7 +222,7 @@ Error: Knowledge base not initialized
222
222
  Error: Entry not found: kb-xxx
223
223
  ```
224
224
 
225
- **Solution**: Check ID with `kse knowledge list`
225
+ **Solution**: Check ID with `sce knowledge list`
226
226
 
227
227
  ### Corrupted Index
228
228
 
@@ -236,7 +236,7 @@ Error: Failed to load index
236
236
  rm .kiro/knowledge/index.json
237
237
 
238
238
  # Reinitialize
239
- kse knowledge init
239
+ sce knowledge init
240
240
  ```
241
241
 
242
242
  ## FAQ
@@ -254,7 +254,7 @@ A: Commit `.kiro/knowledge/` to git (except `.backups/`).
254
254
  A: Yes, create custom templates in `.kiro/knowledge/.templates/`.
255
255
 
256
256
  **Q: How do I backup my knowledge?**
257
- A: Use `kse knowledge export` or commit to git.
257
+ A: Use `sce knowledge export` or commit to git.
258
258
 
259
259
  ## See Also
260
260
 
@@ -6,7 +6,7 @@
6
6
 
7
7
  ## Overview
8
8
 
9
- This guide provides step-by-step instructions for common workflows when using kiro-spec-engine without automation (watch mode or agent hooks). These workflows are designed to be efficient and easy to follow.
9
+ This guide provides step-by-step instructions for common workflows when using scene-capability-engine without automation (watch mode or agent hooks). These workflows are designed to be efficient and easy to follow.
10
10
 
11
11
  **When to use manual workflows:**
12
12
  - When automation is not set up
@@ -35,7 +35,7 @@ Keep your workspace synchronized with task progress across multiple users or too
35
35
  - Subsequent syncs: 30-60 seconds
36
36
 
37
37
  ### Prerequisites
38
- - Project adopted with kiro-spec-engine
38
+ - Project adopted with scene-capability-engine
39
39
  - Active spec with tasks.md file
40
40
  - Write access to .kiro/specs/ directory
41
41
 
@@ -43,7 +43,7 @@ Keep your workspace synchronized with task progress across multiple users or too
43
43
 
44
44
  #### 1. Check Current Status
45
45
  ```bash
46
- kse status
46
+ sce status
47
47
  ```
48
48
 
49
49
  **What to look for:**
@@ -75,7 +75,7 @@ Open your spec's `tasks.md` file and review:
75
75
 
76
76
  #### 3. Sync Workspace
77
77
  ```bash
78
- kse workspace sync
78
+ sce workspace sync
79
79
  ```
80
80
 
81
81
  **What this does:**
@@ -90,7 +90,7 @@ kse workspace sync
90
90
 
91
91
  #### 4. Verify Sync
92
92
  ```bash
93
- kse status
93
+ sce status
94
94
  ```
95
95
 
96
96
  **Verify:**
@@ -116,7 +116,7 @@ kse status
116
116
 
117
117
  3. **Team Coordination**
118
118
  - Communicate task claims in team chat
119
- - Use task claiming feature: `kse task claim <spec> <task-id>`
119
+ - Use task claiming feature: `sce task claim <spec> <task-id>`
120
120
  - Check for claimed tasks before starting work
121
121
 
122
122
  ---
@@ -138,7 +138,7 @@ Export spec context for sharing with AI assistants or team members.
138
138
 
139
139
  #### 1. Identify Spec to Export
140
140
  ```bash
141
- kse status
141
+ sce status
142
142
  ```
143
143
 
144
144
  Note the spec name you want to export.
@@ -149,7 +149,7 @@ Note the spec name you want to export.
149
149
 
150
150
  #### 2. Export Context
151
151
  ```bash
152
- kse context export <spec-name>
152
+ sce context export <spec-name>
153
153
  ```
154
154
 
155
155
  **Options:**
@@ -159,7 +159,7 @@ kse context export <spec-name>
159
159
 
160
160
  **Example:**
161
161
  ```bash
162
- kse context export my-feature --include-steering --steering-files CORE_PRINCIPLES.md,ENVIRONMENT.md
162
+ sce context export my-feature --include-steering --steering-files CORE_PRINCIPLES.md,ENVIRONMENT.md
163
163
  ```
164
164
 
165
165
  **Time:** ~10-20 seconds
@@ -238,16 +238,16 @@ cat .kiro/specs/<spec-name>/tasks.md
238
238
 
239
239
  #### 2. Generate Prompt
240
240
  ```bash
241
- kse prompt generate <spec-name> <task-id>
241
+ sce prompt generate <spec-name> <task-id>
242
242
  ```
243
243
 
244
244
  **Options:**
245
- - `--target <tool>`: Target tool (kiro, vscode, cursor, other)
245
+ - `--target <tool>`: Target tool (SCE, vscode, cursor, other)
246
246
  - `--output <path>`: Custom output path
247
247
 
248
248
  **Example:**
249
249
  ```bash
250
- kse prompt generate my-feature 1.2 --target vscode
250
+ sce prompt generate my-feature 1.2 --target vscode
251
251
  ```
252
252
 
253
253
  **Time:** ~10-15 seconds
@@ -281,7 +281,7 @@ For multiple tasks:
281
281
  ```bash
282
282
  # Generate prompts for all incomplete tasks
283
283
  for task in 1.1 1.2 1.3; do
284
- kse prompt generate my-feature $task
284
+ sce prompt generate my-feature $task
285
285
  done
286
286
  ```
287
287
 
@@ -316,8 +316,8 @@ done
316
316
  ### Daily Workflow Checklist
317
317
 
318
318
  **Morning (Start of Work)**
319
- - [ ] Sync workspace: `kse workspace sync`
320
- - [ ] Check status: `kse status`
319
+ - [ ] Sync workspace: `sce workspace sync`
320
+ - [ ] Check status: `sce status`
321
321
  - [ ] Review task list
322
322
  - [ ] Claim tasks you'll work on
323
323
  - [ ] Export context for active tasks
@@ -331,7 +331,7 @@ done
331
331
  **End of Day**
332
332
  - [ ] Mark completed tasks
333
333
  - [ ] Update in-progress tasks
334
- - [ ] Final sync: `kse workspace sync`
334
+ - [ ] Final sync: `sce workspace sync`
335
335
  - [ ] Commit changes to version control
336
336
 
337
337
  ---
@@ -351,7 +351,7 @@ done
351
351
 
352
352
  ### Spec Creation Checklist
353
353
 
354
- - [ ] Create spec: `kse spec bootstrap --name <name> --non-interactive`
354
+ - [ ] Create spec: `sce spec bootstrap --name <name> --non-interactive`
355
355
  - [ ] Write requirements.md
356
356
  - [ ] Write design.md
357
357
  - [ ] Generate tasks.md
@@ -396,8 +396,8 @@ done
396
396
 
397
397
  1. **Set Up Automation:** Consider using watch mode for automatic workflows
398
398
  ```bash
399
- kse watch init
400
- kse watch install auto-sync
399
+ sce watch init
400
+ sce watch install auto-sync
401
401
  ```
402
402
 
403
403
  2. **Learn More:**
@@ -406,7 +406,7 @@ done
406
406
  - [Architecture](./architecture.md)
407
407
 
408
408
  3. **Get Help:**
409
- - Run `kse --help` for command reference
409
+ - Run `sce --help` for command reference
410
410
  - Check [GitHub Issues](https://github.com/heguangyong/scene-capability-engine/issues)
411
411
  - Review [Contributing Guide](../CONTRIBUTING.md)
412
412
 
@@ -1,20 +1,41 @@
1
- # Moqui Capability Matrix For KSE
1
+ # Moqui Capability Matrix For sce
2
2
 
3
- This document defines the execution boundary for converting Moqui capabilities into KSE capabilities.
3
+ This document defines the execution boundary for converting Moqui capabilities into sce capabilities.
4
4
 
5
5
  ## Scope
6
6
 
7
- - Goal: turn Moqui ERP resources into reusable KSE scene templates.
7
+ - Goal: turn Moqui ERP resources into reusable sce scene templates.
8
8
  - Method: `extract -> normalize -> package-gate -> handoff-run -> release evidence`.
9
9
  - Output: template assets with ontology, governance, and runtime-safe bindings.
10
10
 
11
11
  ## Capability Mapping
12
12
 
13
- | Priority | Moqui Capability | KSE Scene Pattern | Template ID | Ontology Anchors | Governance/Gate Focus | Status |
13
+ | Priority | Moqui Capability | sce Scene Pattern | Template ID | Ontology Anchors | Governance/Gate Focus | Status |
14
14
  | --- | --- | --- | --- | --- | --- | --- |
15
- | P0 | Order read (`OrderHeader`, `OrderItem`, query services) | `query` | `kse.scene--erp-order-query-read--0.1.0` | `order_header`, `order_item`, `order_projection`, `customer_party` | low risk, idempotent query, lineage complete | template-ready |
16
- | P0 | Order fulfillment (reserve, payment, release) | `workflow` | `kse.scene--erp-order-fulfillment-workflow--0.1.0` | `order_header`, `order_item`, `inventory_reservation`, `payment_authorization`, `fulfillment_execution` | medium risk, approval required, compensation strategy | template-ready |
17
- | P0 | Inventory reserve + adjust | `workflow/crud hybrid` | `kse.scene--erp-inventory-reserve-adjust--0.1.0` | `inventory_item`, `inventory_reservation`, `inventory_adjustment`, `inventory_snapshot` | medium risk, approval required, non-negative stock rule | template-ready |
15
+ | P0 | Order read (`OrderHeader`, `OrderItem`, query services) | `query` | `sce.scene--erp-order-query-read--0.1.0` | `order_header`, `order_item`, `order_projection`, `customer_party` | low risk, idempotent query, lineage complete | template-ready |
16
+ | P0 | Order fulfillment (reserve, payment, release) | `workflow` | `sce.scene--erp-order-fulfillment-workflow--0.1.0` | `order_header`, `order_item`, `inventory_reservation`, `payment_authorization`, `fulfillment_execution` | medium risk, approval required, compensation strategy | template-ready |
17
+ | P0 | Inventory reserve + adjust | `workflow/crud hybrid` | `sce.scene--erp-inventory-reserve-adjust--0.1.0` | `inventory_item`, `inventory_reservation`, `inventory_adjustment`, `inventory_snapshot` | medium risk, approval required, non-negative stock rule | template-ready |
18
+ | P1 | Party master (`Party`, `PartyRole`) | `crud` | `sce.scene--erp-party-management--0.1.0` | `party`, `party_role`, `party_relationship` | medium risk, merge/dedup strategy required | matrix-intake-ready |
19
+ | P1 | Product master (`Product`, classification/pricing) | `crud` | `sce.scene--erp-product-management--0.1.0` | `product`, `product_category`, `price_rule` | medium risk, version consistency, rule closure | matrix-intake-ready |
20
+ | P1 | Procurement + supplier flow | `workflow` | `sce.scene--erp-procurement-management--0.1.0` | `purchase_order`, `supplier_party`, `receipt_line` | medium risk, approval + receipt reconciliation | matrix-intake-ready |
21
+ | P1 | Shipment execution + tracking | `workflow` | `sce.scene--erp-shipment-management--0.1.0` | `shipment`, `shipment_item`, `fulfillment_event` | medium risk, irreversible step guard | matrix-intake-ready |
22
+ | P1 | Return/RMA handling | `workflow` | `sce.scene--erp-return-rma-management--0.1.0` | `return_header`, `return_item`, `refund_decision` | medium risk, policy decision completeness | matrix-intake-ready |
23
+ | P1 | Production run + work order execution | `workflow` | `sce.scene--erp-production-run--0.1.0` | `production_run`, `work_effort`, `material_issue` | high risk, capacity/exception path required | matrix-intake-ready |
24
+ | P1 | BOM + routing maintenance | `crud/workflow hybrid` | `sce.scene--erp-bom-routing-management--0.1.0` | `bom`, `routing`, `operation_step` | medium risk, effective-date governance | matrix-intake-ready |
25
+ | P1 | Quality inspection + hold/release | `decision workflow` | `sce.scene--erp-quality-inspection--0.1.0` | `inspection_lot`, `quality_rule`, `release_decision` | high risk, decision closure mandatory | matrix-intake-ready |
26
+ | P1 | Equipment lifecycle + maintenance | `workflow` | `sce.scene--erp-equipment-management--0.1.0` | `equipment_asset`, `maintenance_order`, `downtime_event` | medium risk, safety/approval policy | matrix-intake-ready |
27
+ | P2 | Workflow approval engine | `platform service` | `sce.scene--platform-workflow-approval-engine--0.1.0` | `approval_flow`, `approval_node`, `approval_decision` | high risk, branch decision coverage | matrix-intake-ready |
28
+ | P2 | Reporting + audit operations | `platform query` | `sce.scene--platform-reporting-audit-ops--0.1.0` | `audit_event`, `report_slice`, `trace_lineage` | low risk, lineage completeness | matrix-intake-ready |
29
+ | P2 | Suite observability/parity audit | `platform query/dashboard` | `sce.scene--platform-suite-observability-parity--0.1.0` | `suite_capability`, `parity_audit`, `scene_coverage` | medium risk, regression signal quality | matrix-intake-ready |
30
+
31
+ ## 331-poc Intake Snapshot
32
+
33
+ - Source baseline: `331-poc/docs/handoffs/handoff-manifest.json` (timestamp `2026-02-18T01:08:00+08:00`).
34
+ - Newly aligned domain set in this round: party/product/order/procurement/inventory/production/quality/equipment/cost/engineering/hr/calendar + suite platform governance templates.
35
+ - Core landing contract:
36
+ - capability aliases are normalized through `lib/data/moqui-capability-lexicon.json`
37
+ - handoff run default gate keeps `max_moqui_matrix_regressions=0`
38
+ - governance stats/close-loop consumes matrix regression signals as release-block conditions
18
39
 
19
40
  ## Ownership Boundary
20
41
 
@@ -25,7 +46,7 @@ This document defines the execution boundary for converting Moqui capabilities i
25
46
  - Handoff package (`docs/handoffs/handoff-manifest.json`) and ontology evidence.
26
47
  - Real-world acceptance cases and risk context.
27
48
 
28
- ### KSE owns
49
+ ### sce owns
29
50
 
30
51
  - Template contract normalization and packaging format.
31
52
  - Ontology/gate enforcement and strict checks.
@@ -35,18 +56,18 @@ This document defines the execution boundary for converting Moqui capabilities i
35
56
  ## Batch Workflow
36
57
 
37
58
  1. 331-poc exports spec/template/handoff artifacts.
38
- 2. KSE runs `auto handoff capability-matrix` as the fast intake gate.
39
- 3. KSE runs `auto handoff run` with strict gates.
40
- 4. KSE validates template registry and ontology consistency.
41
- 5. KSE executes close-loop batch and snapshots observability.
42
- 6. KSE archives evidence and publishes release.
59
+ 2. sce runs `auto handoff capability-matrix` as the fast intake gate.
60
+ 3. sce runs `auto handoff run` with strict gates.
61
+ 4. sce validates template registry and ontology consistency.
62
+ 5. sce executes close-loop batch and snapshots observability.
63
+ 6. sce archives evidence and publishes release.
43
64
 
44
65
  ## Fast Matrix Loop
45
66
 
46
67
  Use this command during template iteration before full handoff execution:
47
68
 
48
69
  ```bash
49
- kse auto handoff capability-matrix \
70
+ sce auto handoff capability-matrix \
50
71
  --manifest docs/handoffs/handoff-manifest.json \
51
72
  --format markdown \
52
73
  --out .kiro/reports/handoff-capability-matrix.md \
@@ -56,18 +77,18 @@ kse auto handoff capability-matrix \
56
77
 
57
78
  `capability-matrix` now checks both capability coverage and semantic completeness (ontology entities/relations + governance business rules/decision logic) by default.
58
79
 
59
- When gaps exist, KSE writes remediation queue lines (default `.kiro/auto/moqui-remediation.lines`) that can be fed directly into:
80
+ When gaps exist, sce writes remediation queue lines (default `.kiro/auto/moqui-remediation.lines`) that can be fed directly into:
60
81
 
61
82
  ```bash
62
- kse auto close-loop-batch .kiro/auto/moqui-remediation.lines --format lines --json
83
+ sce auto close-loop-batch .kiro/auto/moqui-remediation.lines --format lines --json
63
84
  ```
64
85
 
65
86
  ## Definition Of Done
66
87
 
67
- A capability is considered absorbed by KSE when all checks pass:
88
+ A capability is considered absorbed by sce when all checks pass:
68
89
 
69
- - `kse scene package-validate --strict`
70
- - `kse scene lint --strict`
71
- - `kse scene score --threshold 85`
72
- - `kse scene ontology validate`
73
- - `kse auto handoff run`
90
+ - `sce scene package-validate --strict`
91
+ - `sce scene lint --strict`
92
+ - `sce scene score --threshold 85`
93
+ - `sce scene ontology validate`
94
+ - `sce auto handoff run`
@@ -1,6 +1,6 @@
1
1
  # Moqui Template Core Library Playbook
2
2
 
3
- This playbook defines a generic (project-agnostic) path to absorb Moqui capabilities into the KSE core template library.
3
+ This playbook defines a generic (project-agnostic) path to absorb Moqui capabilities into the sce core template library.
4
4
 
5
5
  ## Objectives
6
6
 
@@ -10,14 +10,16 @@ This playbook defines a generic (project-agnostic) path to absorb Moqui capabili
10
10
 
11
11
  ## Default Gate Baseline
12
12
 
13
- KSE defaults already enforce the baseline below:
13
+ sce defaults already enforce the baseline below:
14
14
 
15
- - `kse auto handoff run`: ontology validation is required by default.
16
- - `kse auto handoff run`: generates Moqui baseline snapshot by default and appends it to release-evidence sessions.
17
- - `kse auto handoff run`: requires Moqui baseline portfolio pass by default.
18
- - `kse auto handoff run`: evaluates capability coverage matrix by default when manifest `capabilities` is declared (default minimum `100%`).
19
- - `kse auto handoff capability-matrix`: enforces both capability coverage and capability semantic completeness (default minimum `100%` for each).
20
- - `kse scene package-publish-batch`:
15
+ - `sce auto handoff run`: ontology validation is required by default.
16
+ - `sce auto handoff run`: generates Moqui baseline snapshot by default and appends it to release-evidence sessions.
17
+ - `sce auto handoff run`: requires Moqui baseline portfolio pass by default.
18
+ - `sce auto handoff run`: enforces Moqui matrix regression hard-gate by default (`max_moqui_matrix_regressions=0`).
19
+ - `sce auto handoff run`: evaluates capability coverage matrix by default when manifest `capabilities` is declared (default minimum `100%`).
20
+ - `sce auto handoff capability-matrix`: enforces both capability coverage and capability semantic completeness (default minimum `100%` for each).
21
+ - `sce auto governance stats` / `sce auto governance close-loop`: treats Moqui matrix regressions as first-class risk/block signals (including over-gate stop reasons).
22
+ - `sce scene package-publish-batch`:
21
23
  - ontology validation required by default
22
24
  - batch ontology gate defaults:
23
25
  - average ontology score `>= 70`
@@ -32,42 +34,55 @@ Emergency bypass exists but is not recommended:
32
34
  ## One-Shot Intake Flow
33
35
 
34
36
  ```bash
35
- # 0) Generate template baseline scoreboard (Moqui/ERP templates by default)
36
- kse scene moqui-baseline --json
37
+ # 0) Generate template baseline scoreboard (Moqui + scene orchestration templates by default)
38
+ sce scene moqui-baseline --json
37
39
 
38
40
  # 0.1) CI/release mode: compare against previous baseline and enforce portfolio gate
39
- kse scene moqui-baseline \
41
+ sce scene moqui-baseline \
40
42
  --compare-with .kiro/reports/release-evidence/moqui-template-baseline-prev.json \
41
43
  --fail-on-portfolio-fail \
42
44
  --json
43
45
 
44
46
  # 0.2) Fast capability matrix gate (recommended before full handoff run)
45
- kse auto handoff capability-matrix \
47
+ sce auto handoff capability-matrix \
46
48
  --manifest docs/handoffs/handoff-manifest.json \
47
49
  --format markdown \
48
50
  --out .kiro/reports/handoff-capability-matrix.md \
49
51
  --fail-on-gap \
50
52
  --json
51
53
 
54
+ # 0.3) Capability lexicon audit (expected/provided canonical alignment)
55
+ node scripts/moqui-lexicon-audit.js \
56
+ --manifest docs/handoffs/handoff-manifest.json \
57
+ --template-dir .kiro/templates/scene-packages \
58
+ --fail-on-gap \
59
+ --json
60
+
52
61
  # 1) Handoff close-loop
53
- kse auto handoff run --manifest docs/handoffs/handoff-manifest.json --json
62
+ sce auto handoff run --manifest docs/handoffs/handoff-manifest.json --json
63
+
64
+ # 1.1) Explicitly keep strict matrix hard-gate (same as default, recommended in CI)
65
+ sce auto handoff run \
66
+ --manifest docs/handoffs/handoff-manifest.json \
67
+ --max-moqui-matrix-regressions 0 \
68
+ --json
54
69
 
55
70
  # 2) Publish templates from scene packages (with default ontology gates)
56
- kse scene package-publish-batch \
71
+ sce scene package-publish-batch \
57
72
  --manifest docs/handoffs/handoff-manifest.json \
58
73
  --json
59
74
 
60
75
  # 3) Persist ontology publish evidence for governance/review
61
- kse scene package-publish-batch \
76
+ sce scene package-publish-batch \
62
77
  --manifest docs/handoffs/handoff-manifest.json \
63
78
  --dry-run \
64
79
  --ontology-report-out .kiro/reports/scene-package-ontology-batch.json \
65
80
  --json
66
81
 
67
82
  # 4) Validate registry + package gate
68
- kse scene package-registry --template-dir .kiro/templates/scene-packages --strict --json
69
- kse scene package-gate-template --out .kiro/templates/scene-package-gate-policy.json --profile three-layer --force --json
70
- kse scene package-gate --registry .kiro/templates/scene-packages/registry.json --policy .kiro/templates/scene-package-gate-policy.json --strict --json
83
+ sce scene package-registry --template-dir .kiro/templates/scene-packages --strict --json
84
+ sce scene package-gate-template --out .kiro/templates/scene-package-gate-policy.json --profile three-layer --force --json
85
+ sce scene package-gate --registry .kiro/templates/scene-packages/registry.json --policy .kiro/templates/scene-package-gate-policy.json --strict --json
71
86
  ```
72
87
 
73
88
  ## Evidence Contract
@@ -80,13 +95,26 @@ Required artifacts for each intake batch:
80
95
  - `.kiro/reports/release-evidence/moqui-template-baseline.md`
81
96
  - `.kiro/reports/release-evidence/moqui-capability-coverage.json`
82
97
  - `.kiro/reports/release-evidence/moqui-capability-coverage.md`
83
- - `.kiro/reports/handoff-capability-matrix.md` (or JSON equivalent from `kse auto handoff capability-matrix`)
98
+ - `.kiro/reports/release-evidence/moqui-lexicon-audit.json`
99
+ - `.kiro/reports/release-evidence/moqui-lexicon-audit.md`
100
+ - `.kiro/reports/handoff-capability-matrix.md` (or JSON equivalent from `sce auto handoff capability-matrix`)
84
101
  - `.kiro/reports/handoff-runs/<session>.json`
85
102
  - `.kiro/reports/scene-package-ontology-batch.json`
86
103
  - `.kiro/auto/moqui-remediation.lines` (when baseline/coverage gaps exist)
87
104
  - `.kiro/templates/scene-packages/registry.json`
88
105
  - gate output/evidence linked from release notes or handoff summary
89
106
 
107
+ `moqui-template-baseline.json` summary should be consumed as a matrix gate:
108
+ - `scope_breakdown` (moqui_erp / scene_orchestration / other)
109
+ - `coverage_matrix` (entity/relation/business-rule/decision coverage and closure rates)
110
+ - `gap_frequency` (top recurring ontology gaps for remediation prioritization)
111
+ - `compare.coverage_matrix_deltas` (trend deltas used to detect matrix regression/plateau between runs)
112
+ - `compare.coverage_matrix_regressions` (negative-delta signals consumed by auto remediation/recommendation flows)
113
+ - default handoff hard-gate enforces `max_moqui_matrix_regressions=0` unless explicitly relaxed
114
+ - governance close-loop block reasons include:
115
+ - `handoff-moqui-matrix-regressions-positive:<n>`
116
+ - `handoff-moqui-matrix-regressions-over-gate:<n>/<max>`
117
+
90
118
  ## Minimum Semantic Coverage
91
119
 
92
120
  Each accepted template should include ontology semantics for:
@@ -99,11 +127,11 @@ Each accepted template should include ontology semantics for:
99
127
  If any area is weak, export remediation queue lines and feed back to close-loop:
100
128
 
101
129
  ```bash
102
- kse scene package-publish-batch \
130
+ sce scene package-publish-batch \
103
131
  --manifest docs/handoffs/handoff-manifest.json \
104
132
  --dry-run \
105
133
  --ontology-task-queue-out .kiro/auto/ontology-remediation.lines \
106
134
  --json
107
135
 
108
- kse auto close-loop-batch .kiro/auto/ontology-remediation.lines --format lines --json
136
+ sce auto close-loop-batch .kiro/auto/ontology-remediation.lines --format lines --json
109
137
  ```