scene-capability-engine 3.0.1 → 3.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +233 -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 +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,15 +2,15 @@
|
|
|
2
2
|
|
|
3
3
|
## Overview
|
|
4
4
|
|
|
5
|
-
The Environment Configuration Management feature provides a lightweight solution for managing multiple environment configurations (development, staging, production, etc.) within your
|
|
5
|
+
The Environment Configuration Management feature provides a lightweight solution for managing multiple environment configurations (development, staging, production, etc.) within your sce projects.
|
|
6
6
|
|
|
7
7
|
## Quick Start
|
|
8
8
|
|
|
9
9
|
### Installation and Project Adoption
|
|
10
10
|
|
|
11
|
-
**⚠️ Important**: When you install
|
|
11
|
+
**⚠️ Important**: When you install sce in a project, it automatically adopts the project and operates in autonomous mode by default. This means:
|
|
12
12
|
|
|
13
|
-
- ✅
|
|
13
|
+
- ✅ sce takes ownership of the project structure
|
|
14
14
|
- ✅ AI assistants can make changes autonomously without frequent confirmations
|
|
15
15
|
- ✅ Faster development workflow with less interruption
|
|
16
16
|
- ✅ All changes are tracked and can be rolled back if needed
|
|
@@ -18,25 +18,25 @@ The Environment Configuration Management feature provides a lightweight solution
|
|
|
18
18
|
**Recommended Workflow**:
|
|
19
19
|
|
|
20
20
|
```bash
|
|
21
|
-
# Install
|
|
22
|
-
npm install -g
|
|
21
|
+
# Install sce globally or in your project
|
|
22
|
+
npm install -g scene-capability-engine
|
|
23
23
|
|
|
24
24
|
# Navigate to your project
|
|
25
25
|
cd your-project
|
|
26
26
|
|
|
27
27
|
# Check project status first (recommended)
|
|
28
|
-
|
|
28
|
+
sce status
|
|
29
29
|
|
|
30
30
|
# If issues are detected, run diagnostics
|
|
31
|
-
|
|
31
|
+
sce doctor
|
|
32
32
|
|
|
33
33
|
# Adopt the project (creates .kiro/ directory)
|
|
34
|
-
|
|
34
|
+
sce adopt
|
|
35
35
|
|
|
36
|
-
#
|
|
36
|
+
# sce is now managing your project autonomously
|
|
37
37
|
```
|
|
38
38
|
|
|
39
|
-
**Note**: Future versions of
|
|
39
|
+
**Note**: Future versions of sce will automatically check project status after installation/upgrade and prompt for diagnostics if needed.
|
|
40
40
|
|
|
41
41
|
### 1. Register an Environment
|
|
42
42
|
|
|
@@ -62,19 +62,19 @@ Create a configuration file (e.g., `env-local.json`):
|
|
|
62
62
|
Register the environment:
|
|
63
63
|
|
|
64
64
|
```bash
|
|
65
|
-
|
|
65
|
+
sce env register env-local.json
|
|
66
66
|
```
|
|
67
67
|
|
|
68
68
|
### 2. List Environments
|
|
69
69
|
|
|
70
70
|
```bash
|
|
71
|
-
|
|
71
|
+
sce env list
|
|
72
72
|
```
|
|
73
73
|
|
|
74
74
|
### 3. Switch Environments
|
|
75
75
|
|
|
76
76
|
```bash
|
|
77
|
-
|
|
77
|
+
sce env switch local-dev
|
|
78
78
|
```
|
|
79
79
|
|
|
80
80
|
The system automatically:
|
|
@@ -85,7 +85,7 @@ The system automatically:
|
|
|
85
85
|
### 4. View Active Environment
|
|
86
86
|
|
|
87
87
|
```bash
|
|
88
|
-
|
|
88
|
+
sce env info
|
|
89
89
|
```
|
|
90
90
|
|
|
91
91
|
### 5. Rollback
|
|
@@ -93,40 +93,40 @@ kse env info
|
|
|
93
93
|
If something goes wrong, rollback to the previous state:
|
|
94
94
|
|
|
95
95
|
```bash
|
|
96
|
-
|
|
96
|
+
sce env rollback
|
|
97
97
|
```
|
|
98
98
|
|
|
99
99
|
## Commands
|
|
100
100
|
|
|
101
|
-
### `
|
|
101
|
+
### `sce env list`
|
|
102
102
|
|
|
103
103
|
List all registered environments with their status.
|
|
104
104
|
|
|
105
|
-
### `
|
|
105
|
+
### `sce env switch <name>`
|
|
106
106
|
|
|
107
107
|
Switch to the specified environment. Creates automatic backups before switching.
|
|
108
108
|
|
|
109
|
-
### `
|
|
109
|
+
### `sce env info`
|
|
110
110
|
|
|
111
111
|
Display details about the currently active environment.
|
|
112
112
|
|
|
113
|
-
### `
|
|
113
|
+
### `sce env register <config-file>`
|
|
114
114
|
|
|
115
115
|
Register a new environment from a JSON configuration file.
|
|
116
116
|
|
|
117
|
-
### `
|
|
117
|
+
### `sce env unregister <name> --force`
|
|
118
118
|
|
|
119
119
|
Remove an environment from the registry. Requires `--force` flag for confirmation.
|
|
120
120
|
|
|
121
|
-
### `
|
|
121
|
+
### `sce env rollback`
|
|
122
122
|
|
|
123
123
|
Restore the most recent backup, reverting to the previous environment state.
|
|
124
124
|
|
|
125
|
-
### `
|
|
125
|
+
### `sce env verify`
|
|
126
126
|
|
|
127
127
|
Verify the current environment configuration by running the verification command defined in the environment. If no verification rules are configured, reports success.
|
|
128
128
|
|
|
129
|
-
### `
|
|
129
|
+
### `sce env run "<command>"`
|
|
130
130
|
|
|
131
131
|
Run a command in the context of the current environment. Ensures the active environment is set before executing the command.
|
|
132
132
|
|
|
@@ -166,7 +166,7 @@ The backup system automatically:
|
|
|
166
166
|
|
|
167
167
|
## Best Practices
|
|
168
168
|
|
|
169
|
-
1. **Adopt projects with
|
|
169
|
+
1. **Adopt projects with sce**: Run `sce adopt` to let sce manage your project autonomously, enabling faster AI-assisted development without constant confirmations
|
|
170
170
|
2. **Use descriptive names**: Choose clear, descriptive names for your environments
|
|
171
171
|
3. **Keep source files in version control**: Store all environment-specific configuration files in your repository
|
|
172
172
|
4. **Selective .kiro/ version control**: Use layered .gitignore strategy:
|
|
@@ -228,7 +228,7 @@ Ensure all source files specified in your configuration exist before registering
|
|
|
228
228
|
|
|
229
229
|
### "Environment already exists"
|
|
230
230
|
|
|
231
|
-
Each environment must have a unique name. Use `
|
|
231
|
+
Each environment must have a unique name. Use `sce env unregister <name> --force` to remove the existing environment first.
|
|
232
232
|
|
|
233
233
|
### "Cannot unregister active environment"
|
|
234
234
|
|
|
@@ -240,7 +240,7 @@ Backups are only created during environment switches. If you haven't switched en
|
|
|
240
240
|
|
|
241
241
|
## Integration with Multi-Workspace
|
|
242
242
|
|
|
243
|
-
When using
|
|
243
|
+
When using sce's multi-workspace feature, each workspace maintains its own independent environment registry. This allows different projects to have different environment configurations without interference.
|
|
244
244
|
|
|
245
245
|
## See Also
|
|
246
246
|
|
|
@@ -252,7 +252,7 @@ When using kse's multi-workspace feature, each workspace maintains its own indep
|
|
|
252
252
|
|
|
253
253
|
### Migrating from Manual Configuration Management
|
|
254
254
|
|
|
255
|
-
If you're currently managing environment configurations manually (e.g., copying files, using shell scripts), here's how to migrate to
|
|
255
|
+
If you're currently managing environment configurations manually (e.g., copying files, using shell scripts), here's how to migrate to sce environment management:
|
|
256
256
|
|
|
257
257
|
#### Step 1: Identify Your Environments
|
|
258
258
|
|
|
@@ -342,12 +342,12 @@ For each environment, create a JSON configuration file:
|
|
|
342
342
|
|
|
343
343
|
#### Step 5: Register Environments
|
|
344
344
|
|
|
345
|
-
Register each environment with
|
|
345
|
+
Register each environment with sce:
|
|
346
346
|
|
|
347
347
|
```bash
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
348
|
+
sce env register local-env.json
|
|
349
|
+
sce env register staging-env.json
|
|
350
|
+
sce env register production-env.json
|
|
351
351
|
```
|
|
352
352
|
|
|
353
353
|
#### Step 6: Verify Registration
|
|
@@ -355,7 +355,7 @@ kse env register production-env.json
|
|
|
355
355
|
List all registered environments:
|
|
356
356
|
|
|
357
357
|
```bash
|
|
358
|
-
|
|
358
|
+
sce env list
|
|
359
359
|
```
|
|
360
360
|
|
|
361
361
|
#### Step 7: Test Environment Switching
|
|
@@ -364,18 +364,18 @@ Switch to an environment and verify:
|
|
|
364
364
|
|
|
365
365
|
```bash
|
|
366
366
|
# Switch to local environment
|
|
367
|
-
|
|
367
|
+
sce env switch local
|
|
368
368
|
|
|
369
369
|
# Verify the switch
|
|
370
|
-
|
|
370
|
+
sce env info
|
|
371
371
|
|
|
372
372
|
# Verify configuration is correct
|
|
373
|
-
|
|
373
|
+
sce env verify
|
|
374
374
|
```
|
|
375
375
|
|
|
376
376
|
#### Step 8: Update Your Workflow
|
|
377
377
|
|
|
378
|
-
Replace your manual configuration management with
|
|
378
|
+
Replace your manual configuration management with sce commands:
|
|
379
379
|
|
|
380
380
|
**Before**:
|
|
381
381
|
```bash
|
|
@@ -386,8 +386,8 @@ cp config/database.local.json config/database.json
|
|
|
386
386
|
|
|
387
387
|
**After**:
|
|
388
388
|
```bash
|
|
389
|
-
#
|
|
390
|
-
|
|
389
|
+
# sce approach
|
|
390
|
+
sce env switch local
|
|
391
391
|
```
|
|
392
392
|
|
|
393
393
|
#### Step 9: Add to .gitignore
|
|
@@ -395,7 +395,7 @@ kse env switch local
|
|
|
395
395
|
Add target files to `.gitignore` to avoid committing environment-specific configurations:
|
|
396
396
|
|
|
397
397
|
```gitignore
|
|
398
|
-
# Environment target files (managed by
|
|
398
|
+
# Environment target files (managed by sce)
|
|
399
399
|
.env
|
|
400
400
|
config/database.json
|
|
401
401
|
config/app.json
|
|
@@ -414,17 +414,17 @@ config/app.json
|
|
|
414
414
|
If you're using direnv, you can migrate by:
|
|
415
415
|
|
|
416
416
|
1. Keep your `.envrc` files as source files
|
|
417
|
-
2. Create
|
|
417
|
+
2. Create sce environment configurations that copy `.envrc.local` → `.envrc`
|
|
418
418
|
3. Continue using direnv for environment variable loading
|
|
419
|
-
4. Use
|
|
419
|
+
4. Use sce for switching between environment configurations
|
|
420
420
|
|
|
421
421
|
#### From Docker Compose
|
|
422
422
|
|
|
423
423
|
If you're using Docker Compose with multiple environment files:
|
|
424
424
|
|
|
425
425
|
1. Keep your `docker-compose.yml` and environment-specific files
|
|
426
|
-
2. Create
|
|
427
|
-
3. Use
|
|
426
|
+
2. Create sce environments that switch between different compose files
|
|
427
|
+
3. Use sce to manage which compose configuration is active
|
|
428
428
|
|
|
429
429
|
**Example**:
|
|
430
430
|
```json
|
|
@@ -449,8 +449,8 @@ If you're using Docker Compose with multiple environment files:
|
|
|
449
449
|
If you're using Kubernetes ConfigMaps for configuration:
|
|
450
450
|
|
|
451
451
|
1. Export ConfigMaps to local files for development
|
|
452
|
-
2. Create
|
|
453
|
-
3. Use
|
|
452
|
+
2. Create sce environments for local development
|
|
453
|
+
3. Use sce for local environment switching
|
|
454
454
|
4. Keep ConfigMaps for production deployments
|
|
455
455
|
|
|
456
456
|
### Best Practices for Migration
|
|
@@ -475,24 +475,24 @@ If you're using Kubernetes ConfigMaps for configuration:
|
|
|
475
475
|
cp .env .env.local
|
|
476
476
|
|
|
477
477
|
# Register environment
|
|
478
|
-
|
|
478
|
+
sce env register local-env.json
|
|
479
479
|
```
|
|
480
480
|
|
|
481
481
|
#### Issue: Target Files Already Exist
|
|
482
482
|
|
|
483
483
|
**Problem**: Target files exist and you're worried about overwriting them.
|
|
484
484
|
|
|
485
|
-
**Solution**:
|
|
485
|
+
**Solution**: sce automatically creates backups before switching. You can also manually backup first.
|
|
486
486
|
|
|
487
487
|
```bash
|
|
488
|
-
# Manual backup (optional,
|
|
488
|
+
# Manual backup (optional, sce does this automatically)
|
|
489
489
|
cp .env .env.backup
|
|
490
490
|
|
|
491
491
|
# Switch environment (creates automatic backup)
|
|
492
|
-
|
|
492
|
+
sce env switch local
|
|
493
493
|
|
|
494
494
|
# If needed, rollback
|
|
495
|
-
|
|
495
|
+
sce env rollback
|
|
496
496
|
```
|
|
497
497
|
|
|
498
498
|
#### Issue: Verification Fails
|
|
@@ -503,11 +503,11 @@ kse env rollback
|
|
|
503
503
|
|
|
504
504
|
```bash
|
|
505
505
|
# Check what went wrong
|
|
506
|
-
|
|
506
|
+
sce env verify
|
|
507
507
|
|
|
508
508
|
# Update environment configuration
|
|
509
509
|
# Edit the JSON file and re-register
|
|
510
|
-
|
|
510
|
+
sce env register local-env.json
|
|
511
511
|
```
|
|
512
512
|
|
|
513
513
|
### Migration Checklist
|
|
@@ -516,7 +516,7 @@ kse env register local-env.json
|
|
|
516
516
|
- [ ] Identify all configuration files
|
|
517
517
|
- [ ] Create source files for each environment
|
|
518
518
|
- [ ] Create environment configuration JSON files
|
|
519
|
-
- [ ] Register all environments with
|
|
519
|
+
- [ ] Register all environments with sce
|
|
520
520
|
- [ ] Test switching between environments
|
|
521
521
|
- [ ] Create verification scripts (optional but recommended)
|
|
522
522
|
- [ ] Update .gitignore
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Export Command - Design
|
|
2
2
|
|
|
3
|
-
> Technical design for
|
|
3
|
+
> Technical design for sce export command
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -83,7 +83,7 @@ class ExportService {
|
|
|
83
83
|
|
|
84
84
|
## Command Registration
|
|
85
85
|
|
|
86
|
-
**File:** `bin/
|
|
86
|
+
**File:** `bin/scene-capability-engine.js`
|
|
87
87
|
|
|
88
88
|
```javascript
|
|
89
89
|
program
|
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
|
|
13
13
|
## Overview
|
|
14
14
|
|
|
15
|
-
This Spec demonstrates how to add a new CLI command to
|
|
15
|
+
This Spec demonstrates how to add a new CLI command to sce. We'll implement `sce export` command that exports Spec data in various formats (JSON, Markdown, HTML).
|
|
16
16
|
|
|
17
17
|
**Learning Points:**
|
|
18
18
|
- CLI command structure
|
|
@@ -31,7 +31,7 @@ This Spec demonstrates how to add a new CLI command to kse. We'll implement `kse
|
|
|
31
31
|
**So that** I can process it programmatically
|
|
32
32
|
|
|
33
33
|
**Acceptance Criteria:**
|
|
34
|
-
- WHEN I run `
|
|
34
|
+
- WHEN I run `sce export 01-00-feature --format json` THEN I get a JSON file
|
|
35
35
|
- WHEN export succeeds THEN I see success message with file path
|
|
36
36
|
- WHEN Spec doesn't exist THEN I see error message
|
|
37
37
|
|
|
@@ -41,7 +41,7 @@ This Spec demonstrates how to add a new CLI command to kse. We'll implement `kse
|
|
|
41
41
|
**So that** I can share it easily
|
|
42
42
|
|
|
43
43
|
**Acceptance Criteria:**
|
|
44
|
-
- WHEN I run `
|
|
44
|
+
- WHEN I run `sce export 01-00-feature --format md` THEN I get a Markdown file
|
|
45
45
|
- WHEN I don't specify format THEN Markdown is default
|
|
46
46
|
- WHEN export succeeds THEN file contains all three Spec documents
|
|
47
47
|
|
|
@@ -51,7 +51,7 @@ This Spec demonstrates how to add a new CLI command to kse. We'll implement `kse
|
|
|
51
51
|
**So that** I can view it in a browser
|
|
52
52
|
|
|
53
53
|
**Acceptance Criteria:**
|
|
54
|
-
- WHEN I run `
|
|
54
|
+
- WHEN I run `sce export 01-00-feature --format html` THEN I get an HTML file
|
|
55
55
|
- WHEN I open HTML THEN it has proper styling
|
|
56
56
|
- WHEN HTML includes code blocks THEN they have syntax highlighting
|
|
57
57
|
|
|
@@ -61,7 +61,7 @@ This Spec demonstrates how to add a new CLI command to kse. We'll implement `kse
|
|
|
61
61
|
|
|
62
62
|
### FR-1: Command Interface
|
|
63
63
|
```bash
|
|
64
|
-
|
|
64
|
+
sce export <spec-name> [options]
|
|
65
65
|
|
|
66
66
|
Options:
|
|
67
67
|
--format, -f Output format (json|md|html) [default: md]
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Export Command - Tasks
|
|
2
2
|
|
|
3
|
-
> Implementation plan for
|
|
3
|
+
> Implementation plan for sce export command
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -50,7 +50,7 @@
|
|
|
50
50
|
## Phase 3: CLI Integration
|
|
51
51
|
|
|
52
52
|
- [ ] 3.1 Register command in CLI
|
|
53
|
-
- Add command to bin/
|
|
53
|
+
- Add command to bin/scene-capability-engine.js
|
|
54
54
|
- Define options and arguments
|
|
55
55
|
- Wire up to ExportCommand
|
|
56
56
|
|