scene-capability-engine 3.0.0 → 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.
- package/CHANGELOG.md +234 -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 +11 -11
- 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/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 +22 -22
- package/docs/moqui-template-core-library-playbook.md +20 -20
- 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 +93 -93
- 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 +29 -29
- 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 +1 -1
- 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/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 +5 -6
- 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
package/docs/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
#
|
|
1
|
+
# sce Documentation Index
|
|
2
2
|
|
|
3
|
-
> Complete guide to
|
|
3
|
+
> Complete guide to sce (Scene Capability Engine)
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -11,30 +11,30 @@
|
|
|
11
11
|
|
|
12
12
|
## 🚀 Getting Started
|
|
13
13
|
|
|
14
|
-
**New to
|
|
14
|
+
**New to sce?** Start here:
|
|
15
15
|
|
|
16
16
|
- **[Quick Start Guide](quick-start.md)** - Get up and running in 5 minutes
|
|
17
17
|
- **[FAQ](faq.md)** - Frequently asked questions
|
|
18
18
|
- **[Troubleshooting](troubleshooting.md)** - Common issues and solutions
|
|
19
19
|
|
|
20
|
-
## ⭐ Why Teams Choose
|
|
20
|
+
## ⭐ Why Teams Choose sce
|
|
21
21
|
|
|
22
22
|
- **Structured AI delivery**: Specs enforce Requirements → Design → Tasks before implementation.
|
|
23
23
|
- **Parallel execution at scale**: Orchestrate multiple Specs with dependency-aware scheduling.
|
|
24
|
-
- **Dual-track handoff closure**: `
|
|
24
|
+
- **Dual-track handoff closure**: `sce auto handoff run` executes plan/queue/batch/observability in one closed loop, supports `--continue-from` resume, and emits executable follow-up recommendations.
|
|
25
25
|
- **Measurable outcomes**: KPI snapshot/baseline/trend commands make delivery quality auditable.
|
|
26
|
-
- **Tool-agnostic workflow**: Works across Claude, Cursor, Windsurf, Copilot, and
|
|
26
|
+
- **Tool-agnostic workflow**: Works across Claude, Cursor, Windsurf, Copilot, and SCE.
|
|
27
27
|
- **Built-in governance**: Locks, document governance, environment/workspace controls, and audit trails.
|
|
28
28
|
|
|
29
29
|
---
|
|
30
30
|
|
|
31
31
|
## 📖 Core Concepts
|
|
32
32
|
|
|
33
|
-
Understand how
|
|
33
|
+
Understand how sce works:
|
|
34
34
|
|
|
35
35
|
- **[Spec Workflow](spec-workflow.md)** - Understanding the Spec-driven development process
|
|
36
|
-
- **[Integration Modes](integration-modes.md)** - Three ways to integrate
|
|
37
|
-
- **[Command Reference](command-reference.md)** - Complete list of all
|
|
36
|
+
- **[Integration Modes](integration-modes.md)** - Three ways to integrate sce with AI tools
|
|
37
|
+
- **[Command Reference](command-reference.md)** - Complete list of all sce commands
|
|
38
38
|
|
|
39
39
|
---
|
|
40
40
|
|
|
@@ -43,18 +43,18 @@ Understand how kse works:
|
|
|
43
43
|
Choose your AI tool and learn how to integrate:
|
|
44
44
|
|
|
45
45
|
### Native Integration
|
|
46
|
-
- **[
|
|
46
|
+
- **[AI IDE Guide](tools/SCE-guide.md)** - Fully automatic integration
|
|
47
47
|
|
|
48
48
|
### Manual Export Integration
|
|
49
|
-
- **[Cursor Guide](tools/cursor-guide.md)** - Using
|
|
50
|
-
- **[Claude Code Guide](tools/claude-guide.md)** - Using
|
|
51
|
-
- **[VS Code + Copilot Guide](tools/vscode-guide.md)** - Using
|
|
49
|
+
- **[Cursor Guide](tools/cursor-guide.md)** - Using sce with Cursor IDE
|
|
50
|
+
- **[Claude Code Guide](tools/claude-guide.md)** - Using sce with Claude Code
|
|
51
|
+
- **[VS Code + Copilot Guide](tools/vscode-guide.md)** - Using sce with VS Code and GitHub Copilot
|
|
52
52
|
|
|
53
53
|
### Watch Mode Integration
|
|
54
|
-
- **[Windsurf Guide](tools/windsurf-guide.md)** - Using
|
|
54
|
+
- **[Windsurf Guide](tools/windsurf-guide.md)** - Using sce with Windsurf (supports watch mode)
|
|
55
55
|
|
|
56
56
|
### Universal Integration
|
|
57
|
-
- **[Generic AI Tools Guide](tools/generic-guide.md)** - Using
|
|
57
|
+
- **[Generic AI Tools Guide](tools/generic-guide.md)** - Using sce with any AI tool
|
|
58
58
|
|
|
59
59
|
---
|
|
60
60
|
|
|
@@ -86,14 +86,14 @@ Learn by example with complete Spec demonstrations:
|
|
|
86
86
|
|
|
87
87
|
Detailed technical documentation:
|
|
88
88
|
|
|
89
|
-
- **[Command Reference](command-reference.md)** - All
|
|
89
|
+
- **[Command Reference](command-reference.md)** - All sce commands with examples
|
|
90
90
|
- **[Environment Management Guide](environment-management-guide.md)** - Multi-environment configuration management
|
|
91
91
|
- **[Multi-Repository Management Guide](multi-repo-management-guide.md)** - Managing multiple Git repositories
|
|
92
92
|
- **[Value Observability Guide](value-observability-guide.md)** - KPI snapshot, baseline, trend, and gate evidence workflow
|
|
93
93
|
- **[Scene Runtime Guide](scene-runtime-guide.md)** - Scene template engine, quality pipeline, ontology, and Moqui ERP integration
|
|
94
|
-
- **[Moqui Template Core Library Playbook](moqui-template-core-library-playbook.md)** - Default-gated intake flow for absorbing Moqui capabilities into
|
|
95
|
-
- **[331-poc Dual-Track Integration Guide](331-poc-dual-track-integration-guide.md)** - Handoff contract and integration playbook between 331-poc and
|
|
96
|
-
- **[331-poc Adaptation Roadmap](331-poc-adaptation-roadmap.md)** - Ongoing
|
|
94
|
+
- **[Moqui Template Core Library Playbook](moqui-template-core-library-playbook.md)** - Default-gated intake flow for absorbing Moqui capabilities into sce templates
|
|
95
|
+
- **[331-poc Dual-Track Integration Guide](331-poc-dual-track-integration-guide.md)** - Handoff contract and integration playbook between 331-poc and sce
|
|
96
|
+
- **[331-poc Adaptation Roadmap](331-poc-adaptation-roadmap.md)** - Ongoing sce-side adaptation backlog and rollout phases
|
|
97
97
|
- **[Multi-Agent Coordination Guide](multi-agent-coordination-guide.md)** - Multi-agent parallel coordination for concurrent development
|
|
98
98
|
- **[Troubleshooting](troubleshooting.md)** - Solutions to common problems
|
|
99
99
|
- **[FAQ](faq.md)** - Answers to frequently asked questions
|
|
@@ -102,8 +102,8 @@ Detailed technical documentation:
|
|
|
102
102
|
|
|
103
103
|
## 📋 Additional Guides
|
|
104
104
|
|
|
105
|
-
- **[Adoption Guide](adoption-guide.md)** - Adopting
|
|
106
|
-
- **[Upgrade Guide](upgrade-guide.md)** - Upgrading
|
|
105
|
+
- **[Adoption Guide](adoption-guide.md)** - Adopting sce in existing projects
|
|
106
|
+
- **[Upgrade Guide](upgrade-guide.md)** - Upgrading sce to newer versions
|
|
107
107
|
- **[Release Checklist](release-checklist.md)** - Repeatable pre-release verification flow
|
|
108
108
|
- **[Release Archive](releases/README.md)** - Index of release notes and validation reports
|
|
109
109
|
- **[Release Notes v1.46.2](releases/v1.46.2.md)** - Summary of value observability and onboarding improvements
|
|
@@ -112,8 +112,8 @@ Detailed technical documentation:
|
|
|
112
112
|
- **[Multi-Repository Management Guide](multi-repo-management-guide.md)** - Managing multiple Git repositories
|
|
113
113
|
- **[Scene Runtime Guide](scene-runtime-guide.md)** - Scene template engine, quality pipeline, ontology, and Moqui ERP integration
|
|
114
114
|
- **[Multi-Agent Coordination Guide](multi-agent-coordination-guide.md)** - Multi-agent parallel coordination for concurrent development
|
|
115
|
-
- **[Developer Guide](developer-guide.md)** - Contributing to
|
|
116
|
-
- **[Architecture](architecture.md)** -
|
|
115
|
+
- **[Developer Guide](developer-guide.md)** - Contributing to sce development
|
|
116
|
+
- **[Architecture](architecture.md)** - sce system architecture
|
|
117
117
|
|
|
118
118
|
---
|
|
119
119
|
|
|
@@ -139,7 +139,7 @@ Detailed technical documentation:
|
|
|
139
139
|
4. [Troubleshooting](troubleshooting.md) - Solve problems
|
|
140
140
|
|
|
141
141
|
### For Advanced Users
|
|
142
|
-
1. [Developer Guide](developer-guide.md) - Contribute to
|
|
142
|
+
1. [Developer Guide](developer-guide.md) - Contribute to sce
|
|
143
143
|
2. [Architecture](architecture.md) - Understand internals
|
|
144
144
|
3. [Manual Workflows Guide](manual-workflows-guide.md) - Advanced workflows
|
|
145
145
|
|
|
@@ -21,10 +21,10 @@ This guide helps users transition from the old interactive adoption mode to the
|
|
|
21
21
|
|
|
22
22
|
### Old Behavior (v1.8.x and earlier)
|
|
23
23
|
|
|
24
|
-
The `
|
|
24
|
+
The `sce adopt` command was **interactive** and required user input:
|
|
25
25
|
|
|
26
26
|
```bash
|
|
27
|
-
$
|
|
27
|
+
$ sce adopt
|
|
28
28
|
|
|
29
29
|
📦 Analyzing project structure...
|
|
30
30
|
|
|
@@ -51,12 +51,12 @@ $ kse adopt
|
|
|
51
51
|
|
|
52
52
|
### New Behavior (v1.9.0+)
|
|
53
53
|
|
|
54
|
-
The `
|
|
54
|
+
The `sce adopt` command is now **smart and automatic**:
|
|
55
55
|
|
|
56
56
|
```bash
|
|
57
|
-
$
|
|
57
|
+
$ sce adopt
|
|
58
58
|
|
|
59
|
-
🔥
|
|
59
|
+
🔥 Scene Capability Engine - Project Adoption
|
|
60
60
|
|
|
61
61
|
📦 Analyzing project structure... ✅
|
|
62
62
|
📋 Creating adoption plan... ✅
|
|
@@ -82,7 +82,7 @@ Adoption Plan:
|
|
|
82
82
|
Preserved: 3 specs, 2 custom files
|
|
83
83
|
|
|
84
84
|
💡 Your original files are safely backed up.
|
|
85
|
-
To restore:
|
|
85
|
+
To restore: sce rollback backup-20260128-143022
|
|
86
86
|
```
|
|
87
87
|
|
|
88
88
|
**Characteristics**:
|
|
@@ -162,15 +162,15 @@ Automatic resolution based on file type:
|
|
|
162
162
|
**Old Behavior**:
|
|
163
163
|
```bash
|
|
164
164
|
# Backup was optional
|
|
165
|
-
|
|
166
|
-
|
|
165
|
+
sce adopt # No backup
|
|
166
|
+
sce adopt --backup # With backup
|
|
167
167
|
```
|
|
168
168
|
|
|
169
169
|
**New Behavior**:
|
|
170
170
|
```bash
|
|
171
171
|
# Backup is mandatory
|
|
172
|
-
|
|
173
|
-
|
|
172
|
+
sce adopt # Always creates backup
|
|
173
|
+
sce adopt --no-backup # Requires confirmation (dangerous)
|
|
174
174
|
```
|
|
175
175
|
|
|
176
176
|
---
|
|
@@ -179,26 +179,26 @@ kse adopt --no-backup # Requires confirmation (dangerous)
|
|
|
179
179
|
|
|
180
180
|
### For Individual Users
|
|
181
181
|
|
|
182
|
-
**Step 1**: Upgrade
|
|
182
|
+
**Step 1**: Upgrade sce
|
|
183
183
|
```bash
|
|
184
|
-
npm install -g
|
|
184
|
+
npm install -g scene-capability-engine@latest
|
|
185
185
|
```
|
|
186
186
|
|
|
187
187
|
**Step 2**: Test with dry-run (optional)
|
|
188
188
|
```bash
|
|
189
189
|
cd your-project
|
|
190
|
-
|
|
190
|
+
sce adopt --dry-run
|
|
191
191
|
```
|
|
192
192
|
|
|
193
193
|
**Step 3**: Run adoption
|
|
194
194
|
```bash
|
|
195
|
-
|
|
195
|
+
sce adopt
|
|
196
196
|
```
|
|
197
197
|
|
|
198
198
|
**Step 4**: Verify results
|
|
199
199
|
```bash
|
|
200
|
-
|
|
201
|
-
|
|
200
|
+
sce status
|
|
201
|
+
sce version-info
|
|
202
202
|
```
|
|
203
203
|
|
|
204
204
|
### For Teams
|
|
@@ -211,8 +211,8 @@ kse version-info
|
|
|
211
211
|
**Step 2**: Test on non-critical project
|
|
212
212
|
```bash
|
|
213
213
|
cd test-project
|
|
214
|
-
|
|
215
|
-
|
|
214
|
+
sce adopt --dry-run
|
|
215
|
+
sce adopt
|
|
216
216
|
```
|
|
217
217
|
|
|
218
218
|
**Step 3**: Roll out gradually
|
|
@@ -232,16 +232,16 @@ kse adopt
|
|
|
232
232
|
**Old Script**:
|
|
233
233
|
```bash
|
|
234
234
|
# Old: Required --auto flag
|
|
235
|
-
|
|
235
|
+
sce adopt --auto
|
|
236
236
|
```
|
|
237
237
|
|
|
238
238
|
**New Script**:
|
|
239
239
|
```bash
|
|
240
240
|
# New: No flag needed (already automatic)
|
|
241
|
-
|
|
241
|
+
sce adopt
|
|
242
242
|
|
|
243
243
|
# Or with verbose logging
|
|
244
|
-
|
|
244
|
+
sce adopt --verbose
|
|
245
245
|
```
|
|
246
246
|
|
|
247
247
|
---
|
|
@@ -261,7 +261,7 @@ You might prefer interactive mode if:
|
|
|
261
261
|
Simply add the `--interactive` flag:
|
|
262
262
|
|
|
263
263
|
```bash
|
|
264
|
-
|
|
264
|
+
sce adopt --interactive
|
|
265
265
|
```
|
|
266
266
|
|
|
267
267
|
This enables the old behavior:
|
|
@@ -272,7 +272,7 @@ This enables the old behavior:
|
|
|
272
272
|
### Example
|
|
273
273
|
|
|
274
274
|
```bash
|
|
275
|
-
$
|
|
275
|
+
$ sce adopt --interactive
|
|
276
276
|
|
|
277
277
|
📦 Analyzing project structure...
|
|
278
278
|
|
|
@@ -301,7 +301,7 @@ $ kse adopt --interactive
|
|
|
301
301
|
|
|
302
302
|
**A**: Use the `--interactive` flag:
|
|
303
303
|
```bash
|
|
304
|
-
|
|
304
|
+
sce adopt --interactive
|
|
305
305
|
```
|
|
306
306
|
|
|
307
307
|
---
|
|
@@ -320,12 +320,12 @@ kse adopt --interactive
|
|
|
320
320
|
|
|
321
321
|
**A**: You can easily rollback:
|
|
322
322
|
```bash
|
|
323
|
-
|
|
323
|
+
sce rollback backup-20260128-143022
|
|
324
324
|
```
|
|
325
325
|
|
|
326
326
|
Then use interactive mode:
|
|
327
327
|
```bash
|
|
328
|
-
|
|
328
|
+
sce adopt --interactive
|
|
329
329
|
```
|
|
330
330
|
|
|
331
331
|
---
|
|
@@ -334,7 +334,7 @@ kse adopt --interactive
|
|
|
334
334
|
|
|
335
335
|
**A**: Use dry-run mode:
|
|
336
336
|
```bash
|
|
337
|
-
|
|
337
|
+
sce adopt --dry-run
|
|
338
338
|
```
|
|
339
339
|
|
|
340
340
|
---
|
|
@@ -343,7 +343,7 @@ kse adopt --dry-run
|
|
|
343
343
|
|
|
344
344
|
**A**: Yes, use the `--force` flag:
|
|
345
345
|
```bash
|
|
346
|
-
|
|
346
|
+
sce adopt --force
|
|
347
347
|
```
|
|
348
348
|
|
|
349
349
|
This will:
|
|
@@ -375,7 +375,7 @@ This will:
|
|
|
375
375
|
|
|
376
376
|
For more details, use verbose mode:
|
|
377
377
|
```bash
|
|
378
|
-
|
|
378
|
+
sce adopt --verbose
|
|
379
379
|
```
|
|
380
380
|
|
|
381
381
|
---
|
|
@@ -384,7 +384,7 @@ kse adopt --verbose
|
|
|
384
384
|
|
|
385
385
|
**A**: Not recommended, but possible:
|
|
386
386
|
```bash
|
|
387
|
-
|
|
387
|
+
sce adopt --no-backup
|
|
388
388
|
```
|
|
389
389
|
|
|
390
390
|
⚠️ **Warning**: This is dangerous and requires confirmation.
|
|
@@ -403,12 +403,12 @@ kse adopt --no-backup
|
|
|
403
403
|
|
|
404
404
|
**Old**:
|
|
405
405
|
```bash
|
|
406
|
-
|
|
406
|
+
sce adopt --auto
|
|
407
407
|
```
|
|
408
408
|
|
|
409
409
|
**New**:
|
|
410
410
|
```bash
|
|
411
|
-
|
|
411
|
+
sce adopt
|
|
412
412
|
```
|
|
413
413
|
|
|
414
414
|
---
|
|
@@ -430,7 +430,7 @@ Problem: Unable to create backup
|
|
|
430
430
|
Solutions:
|
|
431
431
|
1. Free up disk space
|
|
432
432
|
2. Check permissions
|
|
433
|
-
3. Run
|
|
433
|
+
3. Run sce doctor
|
|
434
434
|
```
|
|
435
435
|
|
|
436
436
|
---
|
|
@@ -442,7 +442,7 @@ Solutions:
|
|
|
442
442
|
```bash
|
|
443
443
|
for dir in project1 project2 project3; do
|
|
444
444
|
cd $dir
|
|
445
|
-
|
|
445
|
+
sce adopt
|
|
446
446
|
cd ..
|
|
447
447
|
done
|
|
448
448
|
```
|
|
@@ -452,7 +452,7 @@ done
|
|
|
452
452
|
### Q: How do I report issues?
|
|
453
453
|
|
|
454
454
|
**A**:
|
|
455
|
-
1. Run with verbose mode: `
|
|
455
|
+
1. Run with verbose mode: `sce adopt --verbose`
|
|
456
456
|
2. Check the logs
|
|
457
457
|
3. Report at: https://github.com/heguangyong/scene-capability-engine/issues
|
|
458
458
|
|
|
@@ -464,7 +464,7 @@ done
|
|
|
464
464
|
|
|
465
465
|
**Solution**: Use interactive mode:
|
|
466
466
|
```bash
|
|
467
|
-
|
|
467
|
+
sce adopt --interactive
|
|
468
468
|
```
|
|
469
469
|
|
|
470
470
|
---
|
|
@@ -473,7 +473,7 @@ kse adopt --interactive
|
|
|
473
473
|
|
|
474
474
|
**Solution**: Use verbose mode:
|
|
475
475
|
```bash
|
|
476
|
-
|
|
476
|
+
sce adopt --verbose
|
|
477
477
|
```
|
|
478
478
|
|
|
479
479
|
---
|
|
@@ -482,7 +482,7 @@ kse adopt --verbose
|
|
|
482
482
|
|
|
483
483
|
**Solution**: Use rollback:
|
|
484
484
|
```bash
|
|
485
|
-
|
|
485
|
+
sce rollback backup-20260128-143022
|
|
486
486
|
```
|
|
487
487
|
|
|
488
488
|
---
|
|
@@ -493,7 +493,7 @@ kse rollback backup-20260128-143022
|
|
|
493
493
|
|
|
494
494
|
1. Rollback immediately:
|
|
495
495
|
```bash
|
|
496
|
-
|
|
496
|
+
sce rollback backup-20260128-143022
|
|
497
497
|
```
|
|
498
498
|
|
|
499
499
|
2. Report the issue:
|
|
@@ -510,8 +510,8 @@ kse rollback backup-20260128-143022
|
|
|
510
510
|
Always test on a non-critical project first:
|
|
511
511
|
```bash
|
|
512
512
|
cd test-project
|
|
513
|
-
|
|
514
|
-
|
|
513
|
+
sce adopt --dry-run
|
|
514
|
+
sce adopt
|
|
515
515
|
```
|
|
516
516
|
|
|
517
517
|
### 2. Use Version Control
|
|
@@ -519,8 +519,8 @@ kse adopt
|
|
|
519
519
|
Commit before adopting:
|
|
520
520
|
```bash
|
|
521
521
|
git add -A
|
|
522
|
-
git commit -m "Before
|
|
523
|
-
|
|
522
|
+
git commit -m "Before sce v1.9.0 adoption"
|
|
523
|
+
sce adopt
|
|
524
524
|
```
|
|
525
525
|
|
|
526
526
|
### 3. Keep Backups
|
|
@@ -535,8 +535,8 @@ ls .kiro/backups/
|
|
|
535
535
|
|
|
536
536
|
After adoption, verify:
|
|
537
537
|
```bash
|
|
538
|
-
|
|
539
|
-
|
|
538
|
+
sce status
|
|
539
|
+
sce version-info
|
|
540
540
|
npm test # If you have tests
|
|
541
541
|
```
|
|
542
542
|
|
|
@@ -567,22 +567,22 @@ If you customize files, document it:
|
|
|
567
567
|
For most users:
|
|
568
568
|
```bash
|
|
569
569
|
# Just run it!
|
|
570
|
-
|
|
570
|
+
sce adopt
|
|
571
571
|
```
|
|
572
572
|
|
|
573
573
|
For cautious users:
|
|
574
574
|
```bash
|
|
575
575
|
# Preview first
|
|
576
|
-
|
|
576
|
+
sce adopt --dry-run
|
|
577
577
|
|
|
578
578
|
# Then apply
|
|
579
|
-
|
|
579
|
+
sce adopt
|
|
580
580
|
```
|
|
581
581
|
|
|
582
582
|
For advanced users:
|
|
583
583
|
```bash
|
|
584
584
|
# Use interactive mode
|
|
585
|
-
|
|
585
|
+
sce adopt --interactive
|
|
586
586
|
```
|
|
587
587
|
|
|
588
588
|
---
|
|
@@ -590,8 +590,8 @@ kse adopt --interactive
|
|
|
590
590
|
## Getting Help
|
|
591
591
|
|
|
592
592
|
- **Documentation**: [Adoption Guide](adoption-guide.md)
|
|
593
|
-
- **System Check**: `
|
|
594
|
-
- **Version Info**: `
|
|
593
|
+
- **System Check**: `sce doctor`
|
|
594
|
+
- **Version Info**: `sce version-info`
|
|
595
595
|
- **Issues**: https://github.com/heguangyong/scene-capability-engine/issues
|
|
596
596
|
|
|
597
597
|
---
|