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.
- package/CHANGELOG.md +235 -233
- package/LICENSE +2 -2
- package/README.md +8 -11
- package/README.zh.md +7 -10
- package/bin/kse.js +1 -1
- package/bin/sce.js +1 -1
- package/bin/sco.js +1 -1
- package/docs/331-poc-adaptation-roadmap.md +25 -25
- package/docs/331-poc-dual-track-integration-guide.md +26 -26
- package/docs/331-poc-weekly-delivery-checklist.md +8 -8
- package/docs/OFFLINE_INSTALL.md +10 -10
- package/docs/README.md +24 -24
- package/docs/adopt-migration-guide.md +51 -51
- package/docs/adoption-guide.md +56 -56
- package/docs/agent-hooks-analysis.md +52 -52
- package/docs/architecture.md +6 -6
- package/docs/articles/ai-driven-development-philosophy-and-practice-review.md +4 -4
- package/docs/articles/ai-driven-development-philosophy-and-practice.en.md +9 -9
- package/docs/articles/ai-driven-development-philosophy-and-practice.md +10 -10
- package/docs/autonomous-control-guide.md +89 -89
- package/docs/command-reference.md +31 -16
- package/docs/community.md +4 -4
- package/docs/cross-tool-guide.md +47 -47
- package/docs/developer-guide.md +5 -5
- package/docs/document-governance.md +91 -91
- package/docs/environment-management-guide.md +53 -53
- package/docs/examples/add-export-command/design.md +2 -2
- package/docs/examples/add-export-command/requirements.md +5 -5
- package/docs/examples/add-export-command/tasks.md +2 -2
- package/docs/faq.md +69 -69
- package/docs/handoffs/evidence/ontology/moqui-template-baseline-2026-02-17-232922.json +9 -9
- package/docs/handoffs/evidence/ontology/moqui-template-baseline-2026-02-17-232922.md +3 -3
- package/docs/images/wechat-qr.png +0 -0
- package/docs/integration-modes.md +60 -60
- package/docs/integration-philosophy.md +48 -48
- package/docs/knowledge-management-guide.md +21 -21
- package/docs/manual-workflows-guide.md +20 -20
- package/docs/moqui-capability-matrix.md +43 -22
- package/docs/moqui-template-core-library-playbook.md +49 -21
- package/docs/multi-agent-coordination-guide.md +19 -19
- package/docs/multi-repo-management-guide.md +93 -93
- package/docs/quick-start-with-ai-tools.md +36 -36
- package/docs/quick-start.md +16 -16
- package/docs/release-checklist.md +7 -7
- package/docs/releases/v1.46.2-validation.md +1 -1
- package/docs/releases/v1.46.2.md +10 -10
- package/docs/scene-runtime-guide.md +42 -42
- package/docs/spec-collaboration-guide.md +43 -43
- package/docs/spec-locking-guide.md +26 -26
- package/docs/spec-numbering-guide.md +6 -6
- package/docs/spec-workflow.md +25 -25
- package/docs/steering-strategy-guide.md +36 -36
- package/docs/team-collaboration-guide.md +23 -23
- package/docs/testing-strategy.md +2 -2
- package/docs/tools/claude-guide.md +26 -26
- package/docs/tools/cursor-guide.md +31 -31
- package/docs/tools/generic-guide.md +22 -22
- package/docs/tools/kiro-guide.md +43 -43
- package/docs/tools/vscode-guide.md +18 -18
- package/docs/tools/windsurf-guide.md +50 -50
- package/docs/troubleshooting.md +116 -116
- package/docs/upgrade-guide.md +49 -49
- package/docs/value-observability-guide.md +6 -6
- package/docs/zh/README.md +22 -22
- package/docs/zh/quick-start.md +34 -34
- package/docs/zh/release-checklist.md +6 -6
- package/docs/zh/releases/v1.46.2-validation.md +1 -1
- package/docs/zh/releases/v1.46.2.md +9 -9
- package/docs/zh/spec-numbering-guide.md +6 -6
- package/docs/zh/tools/claude-guide.md +14 -14
- package/docs/zh/tools/cursor-guide.md +18 -18
- package/docs/zh/tools/generic-guide.md +40 -40
- package/docs/zh/tools/kiro-guide.md +50 -50
- package/docs/zh/tools/vscode-guide.md +20 -20
- package/docs/zh/tools/windsurf-guide.md +49 -49
- package/docs/zh/value-observability-guide.md +6 -6
- package/docs//344/272/244/344/273/230/346/270/205/345/215/225.md +4 -4
- package/lib/adoption/adoption-logger.js +1 -1
- package/lib/adoption/adoption-strategy.js +3 -3
- package/lib/adoption/detection-engine.js +1 -1
- package/lib/adoption/error-formatter.js +17 -17
- package/lib/adoption/progress-reporter.js +2 -2
- package/lib/adoption/smart-orchestrator.js +2 -2
- package/lib/adoption/strategy-selector.js +2 -2
- package/lib/adoption/summary-generator.js +3 -3
- package/lib/auto/autonomous-engine.js +2 -2
- package/lib/auto/close-loop-runner.js +9 -9
- package/lib/backup/backup-system.js +2 -2
- package/lib/collab/collab-manager.js +2 -2
- package/lib/commands/adopt.js +16 -16
- package/lib/commands/auto.js +1148 -106
- package/lib/commands/collab.js +8 -8
- package/lib/commands/docs.js +26 -26
- package/lib/commands/doctor.js +2 -2
- package/lib/commands/env.js +14 -14
- package/lib/commands/knowledge.js +13 -13
- package/lib/commands/lock.js +6 -6
- package/lib/commands/ops.js +19 -19
- package/lib/commands/orchestrate.js +5 -5
- package/lib/commands/prompt.js +3 -3
- package/lib/commands/rollback.js +4 -4
- package/lib/commands/scene.js +30 -30
- package/lib/commands/spec-bootstrap.js +1 -1
- package/lib/commands/spec-gate.js +1 -1
- package/lib/commands/spec-pipeline.js +1 -1
- package/lib/commands/task.js +1 -1
- package/lib/commands/templates.js +27 -27
- package/lib/commands/upgrade.js +8 -8
- package/lib/commands/value.js +4 -4
- package/lib/commands/watch.js +9 -9
- package/lib/commands/workflows.js +5 -5
- package/lib/commands/workspace-multi.js +17 -17
- package/lib/commands/workspace.js +5 -5
- package/lib/context/context-exporter.js +1 -1
- package/lib/context/prompt-generator.js +1 -1
- package/lib/data/moqui-capability-lexicon.json +258 -2
- package/lib/environment/environment-manager.js +1 -1
- package/lib/gitignore/gitignore-detector.js +4 -4
- package/lib/gitignore/gitignore-integration.js +2 -2
- package/lib/gitignore/gitignore-transformer.js +3 -3
- package/lib/gitignore/layered-rules-template.js +2 -2
- package/lib/governance/diagnostic-engine.js +4 -4
- package/lib/governance/doc-reference-checker.js +1 -1
- package/lib/governance/hooks-manager.js +5 -5
- package/lib/governance/reporter.js +1 -1
- package/lib/knowledge/knowledge-manager.js +6 -6
- package/lib/orchestrator/agent-spawner.js +1 -1
- package/lib/orchestrator/bootstrap-prompt-builder.js +2 -2
- package/lib/orchestrator/orchestration-engine.js +55 -6
- package/lib/repo/config-manager.js +2 -2
- package/lib/repo/handlers/init-handler.js +3 -3
- package/lib/scene-runtime/audit-emitter.js +2 -2
- package/lib/scene-runtime/binding-plugin-loader.js +1 -1
- package/lib/scene-runtime/moqui-adapter.js +2 -2
- package/lib/scene-runtime/moqui-extractor.js +3 -3
- package/lib/scene-runtime/scene-loader.js +3 -3
- package/lib/scene-runtime/scene-template-linter.js +1 -1
- package/lib/scene-runtime/templates/scene-template-erp-query-v0.1.yaml +1 -1
- package/lib/scene-runtime/templates/scene-template-hybrid-shadow-v0.1.yaml +1 -1
- package/lib/spec/multi-spec-orchestrate.js +1 -1
- package/lib/spec-gate/rules/default-rules.js +1 -1
- package/lib/steering/adoption-config.js +1 -1
- package/lib/steering/compliance-auto-fixer.js +1 -1
- package/lib/steering/compliance-cache.js +3 -3
- package/lib/steering/compliance-error-reporter.js +1 -1
- package/lib/steering/index.js +1 -1
- package/lib/steering/steering-manager.js +7 -7
- package/lib/task/task-claimer.js +2 -1
- package/lib/templates/metadata-collector.js +6 -6
- package/lib/templates/template-creator.js +2 -2
- package/lib/templates/template-exporter.js +12 -12
- package/lib/upgrade/migration-engine.js +4 -4
- package/lib/utils/tool-detector.js +25 -25
- package/lib/utils/validation.js +3 -3
- package/lib/version/version-checker.js +13 -13
- package/lib/version/version-manager.js +7 -7
- package/lib/watch/presets.js +4 -4
- package/lib/workspace/multi/path-utils.js +1 -1
- package/lib/workspace/multi/workspace-context-resolver.js +9 -9
- package/lib/workspace/multi/workspace-registry.js +2 -2
- package/lib/workspace/multi/workspace-state-manager.js +1 -1
- package/lib/workspace/multi/workspace.js +1 -1
- package/lib/workspace/workspace-sync.js +1 -1
- package/locales/en.json +1 -1
- package/locales/zh.json +1 -1
- package/package.json +3 -5
- package/template/.kiro/README.md +40 -40
- package/template/.kiro/specs/SPEC_WORKFLOW_GUIDE.md +3 -3
- package/template/.kiro/steering/CORE_PRINCIPLES.md +3 -3
- package/template/.kiro/steering/ENVIRONMENT.md +2 -2
- package/template/README.md +3 -3
- /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
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
40
|
+
sce knowledge list
|
|
41
41
|
|
|
42
42
|
# Filter by type
|
|
43
|
-
|
|
43
|
+
sce knowledge list --type pattern
|
|
44
44
|
|
|
45
45
|
# Filter by tag
|
|
46
|
-
|
|
46
|
+
sce knowledge list --tag database
|
|
47
47
|
|
|
48
48
|
# Sort by date
|
|
49
|
-
|
|
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
|
-
|
|
56
|
+
sce knowledge search "database"
|
|
57
57
|
|
|
58
58
|
# Full-text search in content
|
|
59
|
-
|
|
59
|
+
sce knowledge search "repository" --full-text
|
|
60
60
|
```
|
|
61
61
|
|
|
62
62
|
### View Entry
|
|
63
63
|
|
|
64
64
|
```bash
|
|
65
|
-
|
|
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
|
-
|
|
72
|
+
sce knowledge delete kb-xxx
|
|
73
73
|
|
|
74
74
|
# Skip confirmation
|
|
75
|
-
|
|
75
|
+
sce knowledge delete kb-xxx --force
|
|
76
76
|
|
|
77
77
|
# Without backup
|
|
78
|
-
|
|
78
|
+
sce knowledge delete kb-xxx --force --no-backup
|
|
79
79
|
```
|
|
80
80
|
|
|
81
81
|
### Statistics
|
|
82
82
|
|
|
83
83
|
```bash
|
|
84
|
-
|
|
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
|
-
|
|
193
|
+
sce knowledge export --output my-knowledge.zip
|
|
194
194
|
|
|
195
195
|
# Import entries
|
|
196
|
-
|
|
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 `
|
|
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 `
|
|
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
|
-
|
|
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 `
|
|
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
|
|
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
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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: `
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
241
|
+
sce prompt generate <spec-name> <task-id>
|
|
242
242
|
```
|
|
243
243
|
|
|
244
244
|
**Options:**
|
|
245
|
-
- `--target <tool>`: Target tool (
|
|
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
|
-
|
|
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
|
-
|
|
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: `
|
|
320
|
-
- [ ] Check 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: `
|
|
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: `
|
|
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
|
-
|
|
400
|
-
|
|
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 `
|
|
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
|
-
|
|
1
|
+
# Moqui Capability Matrix For sce
|
|
2
2
|
|
|
3
|
-
This document defines the execution boundary for converting Moqui capabilities into
|
|
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
|
|
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 |
|
|
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` | `
|
|
16
|
-
| P0 | Order fulfillment (reserve, payment, release) | `workflow` | `
|
|
17
|
-
| P0 | Inventory reserve + adjust | `workflow/crud hybrid` | `
|
|
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
|
-
###
|
|
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.
|
|
39
|
-
3.
|
|
40
|
-
4.
|
|
41
|
-
5.
|
|
42
|
-
6.
|
|
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
|
-
|
|
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,
|
|
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
|
-
|
|
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
|
|
88
|
+
A capability is considered absorbed by sce when all checks pass:
|
|
68
89
|
|
|
69
|
-
- `
|
|
70
|
-
- `
|
|
71
|
-
- `
|
|
72
|
-
- `
|
|
73
|
-
- `
|
|
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
|
|
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
|
-
|
|
13
|
+
sce defaults already enforce the baseline below:
|
|
14
14
|
|
|
15
|
-
- `
|
|
16
|
-
- `
|
|
17
|
-
- `
|
|
18
|
-
- `
|
|
19
|
-
- `
|
|
20
|
-
- `
|
|
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
|
|
36
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
69
|
-
|
|
70
|
-
|
|
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/
|
|
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
|
-
|
|
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
|
-
|
|
136
|
+
sce auto close-loop-batch .kiro/auto/ontology-remediation.lines --format lines --json
|
|
109
137
|
```
|