scene-capability-engine 3.3.5 → 3.3.10
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 +130 -78
- package/README.md +6 -6
- package/README.zh.md +6 -6
- package/bin/scene-capability-engine.js +129 -7
- package/docs/331-poc-adaptation-roadmap.md +3 -3
- package/docs/331-poc-dual-track-integration-guide.md +8 -8
- package/docs/331-poc-weekly-delivery-checklist.md +6 -6
- package/docs/README.md +4 -0
- package/docs/adopt-migration-guide.md +13 -13
- package/docs/adoption-guide.md +28 -28
- package/docs/agent-hooks-analysis.md +10 -10
- package/docs/architecture.md +13 -13
- package/docs/articles/ai-driven-development-philosophy-and-practice.en.md +3 -3
- package/docs/articles/ai-driven-development-philosophy-and-practice.md +3 -3
- package/docs/autonomous-control-guide.md +35 -35
- package/docs/command-reference.md +192 -153
- package/docs/cross-tool-guide.md +7 -7
- package/docs/developer-guide.md +8 -8
- package/docs/document-governance.md +15 -15
- package/docs/environment-management-guide.md +6 -6
- package/docs/examples/add-export-command/design.md +1 -1
- package/docs/faq.md +13 -13
- package/docs/handoff-profile-integration-guide.md +3 -3
- package/docs/handoffs/evidence/ontology/moqui-template-baseline-2026-02-17-232922.json +7 -7
- package/docs/handoffs/evidence/ontology/moqui-template-baseline-2026-02-17-232922.md +1 -1
- package/docs/integration-modes.md +12 -12
- package/docs/integration-philosophy.md +11 -11
- package/docs/interactive-customization/331-poc-sce-integration-checklist.md +24 -24
- package/docs/interactive-customization/README.md +43 -43
- package/docs/interactive-customization/business-mode-policy-baseline.json +33 -0
- package/docs/interactive-customization/dual-ui-mode-integration-guide.md +1 -1
- package/docs/interactive-customization/moqui-adapter-interface.md +2 -2
- package/docs/interactive-customization/moqui-copilot-integration-guide.md +1 -1
- package/docs/interactive-customization/moqui-interactive-template-playbook.md +4 -4
- package/docs/interactive-customization/phase-acceptance-evidence.md +2 -2
- package/docs/knowledge-management-guide.md +6 -6
- package/docs/manual-workflows-guide.md +4 -4
- package/docs/moqui-capability-matrix.md +3 -3
- package/docs/moqui-standard-rebuild-guide.md +8 -8
- package/docs/moqui-template-core-library-playbook.md +27 -27
- package/docs/multi-agent-coordination-guide.md +19 -19
- package/docs/multi-repo-management-guide.md +17 -17
- package/docs/quick-start-with-ai-tools.md +7 -7
- package/docs/quick-start.md +2 -2
- package/docs/release-checklist.md +4 -4
- package/docs/sce-business-mode-map.md +103 -0
- package/docs/security-governance-default-baseline.md +12 -12
- package/docs/spec-collaboration-guide.md +3 -3
- package/docs/spec-locking-guide.md +2 -2
- package/docs/spec-workflow.md +3 -3
- package/docs/starter-kit/README.md +4 -4
- package/docs/starter-kit/handoff-manifest.starter.json +2 -2
- package/docs/starter-kit/release.workflow.sample.yml +1 -1
- package/docs/steering-strategy-guide.md +15 -15
- package/docs/team-collaboration-guide.md +69 -69
- package/docs/testing-strategy.md +2 -2
- package/docs/tools/claude-guide.md +14 -4
- package/docs/tools/cursor-guide.md +14 -14
- package/docs/tools/generic-guide.md +9 -9
- package/docs/tools/kiro-guide.md +4 -4
- package/docs/tools/vscode-guide.md +13 -13
- package/docs/tools/windsurf-guide.md +6 -6
- package/docs/troubleshooting.md +22 -22
- package/docs/upgrade-guide.md +8 -8
- package/docs/value-observability-guide.md +3 -3
- package/docs/zh/README.md +6 -0
- package/docs/zh/quick-start.md +15 -15
- package/docs/zh/release-checklist.md +3 -3
- package/docs/zh/tools/claude-guide.md +16 -6
- package/docs/zh/tools/cursor-guide.md +11 -11
- package/docs/zh/tools/generic-guide.md +13 -13
- package/docs/zh/tools/kiro-guide.md +2 -2
- package/docs/zh/tools/vscode-guide.md +11 -11
- package/docs/zh/tools/windsurf-guide.md +11 -11
- package/docs/zh/value-observability-guide.md +3 -3
- package/lib/adoption/adoption-logger.js +1 -1
- package/lib/adoption/adoption-strategy.js +28 -28
- package/lib/adoption/backup-manager.js +3 -3
- package/lib/adoption/conflict-resolver.js +2 -2
- package/lib/adoption/detection-engine.js +8 -8
- package/lib/adoption/error-formatter.js +4 -4
- package/lib/adoption/file-classifier.js +6 -6
- package/lib/adoption/progress-reporter.js +1 -1
- package/lib/adoption/smart-orchestrator.js +10 -10
- package/lib/adoption/strategy-selector.js +6 -6
- package/lib/adoption/summary-generator.js +1 -1
- package/lib/adoption/template-sync.js +8 -8
- package/lib/auto/autonomous-engine.js +7 -7
- package/lib/auto/checkpoint-manager.js +1 -1
- package/lib/auto/close-loop-runner.js +12 -12
- package/lib/auto/error-recovery-manager.js +1 -1
- package/lib/auto/goal-decomposer.js +1 -1
- package/lib/auto/moqui-recovery-sequence.js +2 -2
- package/lib/auto/progress-tracker.js +1 -1
- package/lib/auto/state-manager.js +1 -1
- package/lib/backup/backup-system.js +10 -10
- package/lib/backup/selective-backup.js +4 -4
- package/lib/collab/agent-registry.js +2 -2
- package/lib/collab/contract-manager.js +1 -1
- package/lib/collab/coordinator.js +2 -2
- package/lib/collab/dependency-manager.js +1 -1
- package/lib/collab/integration-manager.js +1 -1
- package/lib/collab/metadata-manager.js +1 -1
- package/lib/collab/multi-agent-config.js +2 -2
- package/lib/collab/spec-lifecycle-manager.js +2 -2
- package/lib/collab/visualizer.js +1 -1
- package/lib/commands/adopt.js +6 -6
- package/lib/commands/auto.js +56 -56
- package/lib/commands/collab.js +2 -2
- package/lib/commands/docs.js +3 -3
- package/lib/commands/doctor.js +1 -1
- package/lib/commands/knowledge.js +2 -2
- package/lib/commands/lock.js +1 -1
- package/lib/commands/ops.js +1 -1
- package/lib/commands/orchestrate.js +3 -3
- package/lib/commands/rollback.js +1 -1
- package/lib/commands/scene.js +135 -93
- package/lib/commands/session.js +139 -0
- package/lib/commands/spec-bootstrap.js +1 -1
- package/lib/commands/spec-gate.js +2 -2
- package/lib/commands/spec-pipeline.js +1 -1
- package/lib/commands/status.js +4 -4
- package/lib/commands/steering.js +119 -0
- package/lib/commands/value.js +1 -1
- package/lib/commands/watch.js +9 -9
- package/lib/commands/workspace-multi.js +1 -1
- package/lib/context/context-exporter.js +5 -7
- package/lib/context/prompt-generator.js +2 -2
- package/lib/environment/backup-system.js +1 -1
- package/lib/environment/environment-manager.js +2 -2
- package/lib/gitignore/gitignore-backup.js +3 -3
- package/lib/gitignore/gitignore-detector.js +13 -13
- package/lib/gitignore/gitignore-integration.js +3 -3
- package/lib/gitignore/gitignore-transformer.js +4 -4
- package/lib/gitignore/layered-rules-template.js +16 -16
- package/lib/governance/config-manager.js +1 -1
- package/lib/governance/doc-reference-checker.js +4 -4
- package/lib/governance/execution-logger.js +1 -1
- package/lib/governance/file-scanner.js +3 -3
- package/lib/interactive-customization/moqui-interactive-adapter.js +2 -2
- package/lib/knowledge/knowledge-manager.js +1 -1
- package/lib/lock/lock-manager.js +2 -2
- package/lib/lock/steering-file-lock.js +5 -5
- package/lib/lock/task-lock-manager.js +3 -3
- package/lib/operations/audit-logger.js +1 -1
- package/lib/operations/feedback-manager.js +1 -1
- package/lib/operations/operations-manager.js +3 -3
- package/lib/operations/permission-manager.js +2 -2
- package/lib/operations/template-loader.js +1 -1
- package/lib/orchestrator/agent-spawner.js +27 -2
- package/lib/orchestrator/bootstrap-prompt-builder.js +6 -6
- package/lib/orchestrator/orchestration-engine.js +1 -1
- package/lib/orchestrator/orchestrator-config.js +2 -2
- package/lib/repo/config-manager.js +3 -3
- package/lib/repo/handlers/init-handler.js +1 -1
- package/lib/repo/repo-manager.js +2 -2
- package/lib/runtime/business-mode-resolver.js +240 -0
- package/lib/runtime/session-store.js +207 -0
- package/lib/runtime/steering-contract.js +338 -0
- package/lib/scene-runtime/audit-emitter.js +1 -1
- package/lib/scene-runtime/binding-plugin-loader.js +3 -3
- package/lib/scene-runtime/eval-bridge.js +1 -1
- package/lib/scene-runtime/index.js +1 -1
- package/lib/scene-runtime/moqui-extractor.js +1 -1
- package/lib/scene-runtime/plan-compiler.js +1 -1
- package/lib/scene-runtime/policy-gate.js +1 -1
- package/lib/scene-runtime/runtime-executor.js +1 -1
- package/lib/scene-runtime/scene-loader.js +1 -1
- package/lib/spec/bootstrap/context-collector.js +1 -1
- package/lib/spec/pipeline/stage-adapters.js +3 -3
- package/lib/spec/pipeline/state-store.js +1 -1
- package/lib/spec-gate/policy/policy-loader.js +1 -1
- package/lib/spec-gate/rules/default-rules.js +6 -6
- package/lib/steering/adoption-config.js +1 -1
- package/lib/steering/compliance-error-reporter.js +3 -3
- package/lib/steering/context-sync-manager.js +2 -2
- package/lib/steering/index.js +1 -1
- package/lib/steering/spec-steering.js +2 -2
- package/lib/steering/steering-compliance-checker.js +1 -1
- package/lib/steering/steering-loader.js +4 -5
- package/lib/steering/steering-manager.js +4 -4
- package/lib/task/task-claimer.js +5 -5
- package/lib/task/task-status-store.js +2 -2
- package/lib/templates/content-generalizer.js +1 -1
- package/lib/templates/spec-reader.js +2 -2
- package/lib/templates/template-creator.js +1 -1
- package/lib/templates/template-exporter.js +3 -3
- package/lib/templates/template-manager.js +1 -1
- package/lib/upgrade/migration-engine.js +3 -3
- package/lib/upgrade/migrations/1.0.0-to-1.1.0.js +1 -1
- package/lib/utils/file-diff.js +6 -6
- package/lib/utils/tool-detector.js +10 -10
- package/lib/utils/validation.js +5 -5
- package/lib/value/metric-contract-loader.js +1 -1
- package/lib/version/version-manager.js +1 -1
- package/lib/watch/execution-logger.js +1 -1
- package/lib/watch/presets.js +8 -8
- package/lib/watch/watch-manager.js +2 -2
- package/lib/workspace/legacy-kiro-migrator.js +275 -0
- package/lib/workspace/multi/workspace-context-resolver.js +2 -2
- package/lib/workspace/multi/workspace-registry.js +2 -2
- package/lib/workspace/multi/workspace-state-manager.js +3 -3
- package/lib/workspace/workspace-manager.js +1 -1
- package/lib/workspace/workspace-sync.js +2 -2
- package/locales/en.json +4 -4
- package/locales/zh.json +4 -4
- package/package.json +9 -9
- package/template/{.kiro → .sce}/README.md +15 -15
- package/template/{.kiro → .sce}/hooks/check-spec-on-create.kiro.hook +2 -2
- package/template/{.kiro → .sce}/steering/CORE_PRINCIPLES.md +4 -4
- package/template/{.kiro → .sce}/steering/CURRENT_CONTEXT.md +1 -1
- package/template/{.kiro → .sce}/steering/ENVIRONMENT.md +3 -3
- package/template/{.kiro → .sce}/tools/backup_manager.py +3 -3
- package/template/{.kiro → .sce}/tools/configuration_manager.py +1 -1
- package/template/README.md +12 -12
- /package/template/{.kiro → .sce}/hooks/run-tests-on-save.kiro.hook +0 -0
- /package/template/{.kiro → .sce}/hooks/sync-tasks-on-edit.kiro.hook +0 -0
- /package/template/{.kiro → .sce}/specs/SPEC_WORKFLOW_GUIDE.md +0 -0
- /package/template/{.kiro → .sce}/steering/RULES_GUIDE.md +0 -0
- /package/template/{.kiro → .sce}/templates/operations/default/change-impact.md +0 -0
- /package/template/{.kiro → .sce}/templates/operations/default/deployment.md +0 -0
- /package/template/{.kiro → .sce}/templates/operations/default/feedback-response.md +0 -0
- /package/template/{.kiro → .sce}/templates/operations/default/migration-plan.md +0 -0
- /package/template/{.kiro → .sce}/templates/operations/default/monitoring.md +0 -0
- /package/template/{.kiro → .sce}/templates/operations/default/operations.md +0 -0
- /package/template/{.kiro → .sce}/templates/operations/default/rollback.md +0 -0
- /package/template/{.kiro → .sce}/templates/operations/default/tools.yaml +0 -0
- /package/template/{.kiro → .sce}/templates/operations/default/troubleshooting.md +0 -0
- /package/template/{.kiro → .sce}/tools/document_evaluator.py +0 -0
- /package/template/{.kiro → .sce}/tools/enhancement_logger.py +0 -0
- /package/template/{.kiro → .sce}/tools/error_handler.py +0 -0
- /package/template/{.kiro → .sce}/tools/improvement_identifier.py +0 -0
- /package/template/{.kiro → .sce}/tools/modification_applicator.py +0 -0
- /package/template/{.kiro → .sce}/tools/quality_gate_enforcer.py +0 -0
- /package/template/{.kiro → .sce}/tools/quality_scorer.py +0 -0
- /package/template/{.kiro → .sce}/tools/report_generator.py +0 -0
- /package/template/{.kiro → .sce}/tools/ultrawork_enhancer.py +0 -0
- /package/template/{.kiro → .sce}/tools/ultrawork_enhancer_refactored.py +0 -0
- /package/template/{.kiro → .sce}/tools/ultrawork_enhancer_v2.py +0 -0
- /package/template/{.kiro → .sce}/tools/ultrawork_enhancer_v3.py +0 -0
- /package/template/{.kiro → .sce}/tools/workflow_quality_gate.py +0 -0
package/docs/adoption-guide.md
CHANGED
|
@@ -65,10 +65,10 @@ Adoption Plan:
|
|
|
65
65
|
📦 Creating backup... ✅ backup-20260128-143022
|
|
66
66
|
✓ Validating backup... ✅ 5 files verified
|
|
67
67
|
📝 Updating files...
|
|
68
|
-
✅ .
|
|
69
|
-
✅ .
|
|
70
|
-
✅ .
|
|
71
|
-
⏭️ .
|
|
68
|
+
✅ .sce/steering/CORE_PRINCIPLES.md
|
|
69
|
+
✅ .sce/steering/ENVIRONMENT.md
|
|
70
|
+
✅ .sce/tools/ultrawork_enhancer.py
|
|
71
|
+
⏭️ .sce/specs/ (preserved)
|
|
72
72
|
✅ Adoption completed successfully!
|
|
73
73
|
|
|
74
74
|
📊 Summary:
|
|
@@ -94,7 +94,7 @@ sce adopt --dry-run
|
|
|
94
94
|
### Automatic Detection
|
|
95
95
|
|
|
96
96
|
The system automatically detects your project state:
|
|
97
|
-
- Checks for existing `.
|
|
97
|
+
- Checks for existing `.sce/` directory
|
|
98
98
|
- Reads version information
|
|
99
99
|
- Identifies user content (specs, custom files)
|
|
100
100
|
- Detects potential conflicts
|
|
@@ -105,11 +105,11 @@ Based on detection, it chooses the optimal mode:
|
|
|
105
105
|
|
|
106
106
|
| Project State | Selected Mode | What Happens |
|
|
107
107
|
|--------------|---------------|--------------|
|
|
108
|
-
| No `.
|
|
109
|
-
| `.
|
|
110
|
-
| `.
|
|
111
|
-
| `.
|
|
112
|
-
| `.
|
|
108
|
+
| No `.sce/` | **Fresh** | Creates complete structure |
|
|
109
|
+
| `.sce/` + same version | **Skip** | Already up-to-date |
|
|
110
|
+
| `.sce/` + older version | **Smart Update** | Updates templates only |
|
|
111
|
+
| `.sce/` + newer version | **Warning** | Version mismatch alert |
|
|
112
|
+
| `.sce/` + no version | **Smart Adopt** | Full adoption with backup |
|
|
113
113
|
|
|
114
114
|
### Automatic Conflict Resolution
|
|
115
115
|
|
|
@@ -136,10 +136,10 @@ Before any modifications:
|
|
|
136
136
|
|
|
137
137
|
### 1. Fresh Adoption
|
|
138
138
|
|
|
139
|
-
**When**: No `.
|
|
139
|
+
**When**: No `.sce/` directory exists
|
|
140
140
|
|
|
141
141
|
**Actions**:
|
|
142
|
-
- Creates complete `.
|
|
142
|
+
- Creates complete `.sce/` structure
|
|
143
143
|
- Copies all template files
|
|
144
144
|
- Creates `version.json`
|
|
145
145
|
- No conflicts, no backup needed
|
|
@@ -150,7 +150,7 @@ $ sce adopt
|
|
|
150
150
|
|
|
151
151
|
Mode: Fresh
|
|
152
152
|
Actions:
|
|
153
|
-
- Create .
|
|
153
|
+
- Create .sce/ directory structure
|
|
154
154
|
- Copy template files
|
|
155
155
|
- Create version.json
|
|
156
156
|
|
|
@@ -180,7 +180,7 @@ No changes needed.
|
|
|
180
180
|
|
|
181
181
|
### 3. Smart Update
|
|
182
182
|
|
|
183
|
-
**When**: Existing `.
|
|
183
|
+
**When**: Existing `.sce/` with older version
|
|
184
184
|
|
|
185
185
|
**Actions**:
|
|
186
186
|
- Backs up files that will change
|
|
@@ -202,10 +202,10 @@ Preserved: 3 specs, CURRENT_CONTEXT.md
|
|
|
202
202
|
|
|
203
203
|
### 4. Smart Adopt
|
|
204
204
|
|
|
205
|
-
**When**: `.
|
|
205
|
+
**When**: `.sce/` exists but no version info
|
|
206
206
|
|
|
207
207
|
**Actions**:
|
|
208
|
-
- Backs up entire `.
|
|
208
|
+
- Backs up entire `.sce/` directory
|
|
209
209
|
- Adopts with full structure
|
|
210
210
|
- Preserves user content
|
|
211
211
|
- Creates version.json
|
|
@@ -392,13 +392,13 @@ Problem: Unable to create backup of existing files
|
|
|
392
392
|
|
|
393
393
|
Possible causes:
|
|
394
394
|
- Insufficient disk space
|
|
395
|
-
- Permission denied for .
|
|
395
|
+
- Permission denied for .sce/backups/
|
|
396
396
|
- File system error
|
|
397
397
|
```
|
|
398
398
|
|
|
399
399
|
**Solutions**:
|
|
400
400
|
1. Free up disk space (need ~50MB)
|
|
401
|
-
2. Check file permissions: `ls -la .
|
|
401
|
+
2. Check file permissions: `ls -la .sce/`
|
|
402
402
|
3. Try running with elevated permissions (if appropriate)
|
|
403
403
|
|
|
404
404
|
---
|
|
@@ -409,18 +409,18 @@ Possible causes:
|
|
|
409
409
|
```
|
|
410
410
|
❌ Error: Permission Denied
|
|
411
411
|
|
|
412
|
-
Problem: Cannot write to .
|
|
412
|
+
Problem: Cannot write to .sce/ directory
|
|
413
413
|
```
|
|
414
414
|
|
|
415
415
|
**Solutions**:
|
|
416
416
|
```bash
|
|
417
417
|
# Check permissions
|
|
418
|
-
ls -la .
|
|
418
|
+
ls -la .sce/
|
|
419
419
|
|
|
420
420
|
# Fix permissions (Unix/Mac)
|
|
421
|
-
chmod -R u+w .
|
|
421
|
+
chmod -R u+w .sce/
|
|
422
422
|
|
|
423
|
-
# Windows: Right-click .
|
|
423
|
+
# Windows: Right-click .sce/ → Properties → Security → Edit
|
|
424
424
|
```
|
|
425
425
|
|
|
426
426
|
---
|
|
@@ -535,8 +535,8 @@ sce version-info
|
|
|
535
535
|
|
|
536
536
|
Don't delete automatic backups immediately:
|
|
537
537
|
```bash
|
|
538
|
-
# Backups are in .
|
|
539
|
-
ls .
|
|
538
|
+
# Backups are in .sce/backups/
|
|
539
|
+
ls .sce/backups/
|
|
540
540
|
```
|
|
541
541
|
|
|
542
542
|
### 5. Use Verbose for Debugging
|
|
@@ -554,7 +554,7 @@ After adoption, your project will have:
|
|
|
554
554
|
|
|
555
555
|
```
|
|
556
556
|
your-project/
|
|
557
|
-
├── .
|
|
557
|
+
├── .sce/ # sce core directory
|
|
558
558
|
│ ├── version.json # Version tracking
|
|
559
559
|
│ ├── specs/ # Spec storage
|
|
560
560
|
│ ├── steering/ # AI behavior rules
|
|
@@ -594,18 +594,18 @@ After successful adoption:
|
|
|
594
594
|
```
|
|
595
595
|
|
|
596
596
|
4. **Read the spec workflow guide**:
|
|
597
|
-
- See `.
|
|
597
|
+
- See `.sce/specs/SPEC_WORKFLOW_GUIDE.md`
|
|
598
598
|
|
|
599
599
|
5. **Explore Ultrawork**:
|
|
600
600
|
```bash
|
|
601
|
-
sce enhance requirements .
|
|
601
|
+
sce enhance requirements .sce/specs/01-00-my-feature/requirements.md
|
|
602
602
|
```
|
|
603
603
|
|
|
604
604
|
---
|
|
605
605
|
|
|
606
606
|
## Getting Help
|
|
607
607
|
|
|
608
|
-
- **Documentation**: Check README.md in your `.
|
|
608
|
+
- **Documentation**: Check README.md in your `.sce/` directory
|
|
609
609
|
- **System Check**: `sce doctor`
|
|
610
610
|
- **Version Info**: `sce version-info`
|
|
611
611
|
- **Issues**: https://github.com/heguangyong/scene-capability-engine/issues
|
|
@@ -137,7 +137,7 @@ Hooks can perform two types of actions:
|
|
|
137
137
|
"name": "Auto-generate prompts",
|
|
138
138
|
"when": {
|
|
139
139
|
"type": "fileEdited",
|
|
140
|
-
"patterns": ["**/.
|
|
140
|
+
"patterns": ["**/.sce/specs/*/requirements.md", "**/.sce/specs/*/design.md"]
|
|
141
141
|
},
|
|
142
142
|
"then": {
|
|
143
143
|
"type": "askAgent",
|
|
@@ -306,7 +306,7 @@ Hooks can perform two types of actions:
|
|
|
306
306
|
**Goal**: Basic hook support in sce
|
|
307
307
|
|
|
308
308
|
**Tasks**:
|
|
309
|
-
1. Add hook configuration to `.
|
|
309
|
+
1. Add hook configuration to `.sce/hooks/` directory
|
|
310
310
|
2. Create hook templates for common use cases
|
|
311
311
|
3. Add `sce hooks` command group:
|
|
312
312
|
- `sce hooks list` - List all hooks
|
|
@@ -400,7 +400,7 @@ Hooks can perform two types of actions:
|
|
|
400
400
|
### Hook Storage
|
|
401
401
|
|
|
402
402
|
```
|
|
403
|
-
.
|
|
403
|
+
.sce/
|
|
404
404
|
├── hooks/
|
|
405
405
|
│ ├── auto-sync.json
|
|
406
406
|
│ ├── quality-gate.json
|
|
@@ -555,7 +555,7 @@ Watch mode provides automation for developers not using AI IDE. It monitors file
|
|
|
555
555
|
▼
|
|
556
556
|
┌─────────────────────────────────────┐
|
|
557
557
|
│ Execution Logger │
|
|
558
|
-
│ (.
|
|
558
|
+
│ (.sce/watch/execution.log) │
|
|
559
559
|
└─────────────────────────────────────┘
|
|
560
560
|
```
|
|
561
561
|
|
|
@@ -580,15 +580,15 @@ sce watch stop
|
|
|
580
580
|
|
|
581
581
|
### Configuration
|
|
582
582
|
|
|
583
|
-
Watch mode uses `.
|
|
583
|
+
Watch mode uses `.sce/watch-config.json`:
|
|
584
584
|
|
|
585
585
|
```json
|
|
586
586
|
{
|
|
587
587
|
"enabled": true,
|
|
588
588
|
"patterns": [
|
|
589
589
|
"**/tasks.md",
|
|
590
|
-
"**/.
|
|
591
|
-
"**/.
|
|
590
|
+
"**/.sce/specs/*/requirements.md",
|
|
591
|
+
"**/.sce/specs/*/design.md"
|
|
592
592
|
],
|
|
593
593
|
"actions": {
|
|
594
594
|
"**/tasks.md": {
|
|
@@ -639,7 +639,7 @@ Watch mode uses `.kiro/watch-config.json`:
|
|
|
639
639
|
**Without Automation**:
|
|
640
640
|
```bash
|
|
641
641
|
# 1. Edit tasks.md
|
|
642
|
-
vim .
|
|
642
|
+
vim .sce/specs/my-spec/tasks.md
|
|
643
643
|
|
|
644
644
|
# 2. Save file
|
|
645
645
|
|
|
@@ -662,7 +662,7 @@ sce workspace sync
|
|
|
662
662
|
sce context export my-spec
|
|
663
663
|
|
|
664
664
|
# 3. Copy to other tool
|
|
665
|
-
cat .
|
|
665
|
+
cat .sce/specs/my-spec/context-export.md
|
|
666
666
|
```
|
|
667
667
|
|
|
668
668
|
**Time**: ~1 minute per export
|
|
@@ -762,7 +762,7 @@ Start with Phase 1 (foundation) to validate the approach, then expand to Phase 2
|
|
|
762
762
|
"enabled": true,
|
|
763
763
|
"when": {
|
|
764
764
|
"type": "fileEdited",
|
|
765
|
-
"patterns": ["**/.
|
|
765
|
+
"patterns": ["**/.sce/specs/*/tasks.md"]
|
|
766
766
|
},
|
|
767
767
|
"then": {
|
|
768
768
|
"type": "askAgent",
|
package/docs/architecture.md
CHANGED
|
@@ -93,7 +93,7 @@ This document provides detailed architecture diagrams and explanations for Scene
|
|
|
93
93
|
▼
|
|
94
94
|
┌─────────────────────────────────────────────────────────────────────┐
|
|
95
95
|
│ File System │
|
|
96
|
-
│ (.
|
|
96
|
+
│ (.sce/, backups/, etc.) │
|
|
97
97
|
└─────────────────────────────────────────────────────────────────────┘
|
|
98
98
|
```
|
|
99
99
|
|
|
@@ -264,7 +264,7 @@ This document provides detailed architecture diagrams and explanations for Scene
|
|
|
264
264
|
|
|
265
265
|
```
|
|
266
266
|
┌─────────────────────────────────────────────────────────────┐
|
|
267
|
-
│ Project .
|
|
267
|
+
│ Project .sce/ │
|
|
268
268
|
│ ├── specs/ │
|
|
269
269
|
│ ├── steering/ │
|
|
270
270
|
│ ├── tools/ │
|
|
@@ -284,7 +284,7 @@ This document provides detailed architecture diagrams and explanations for Scene
|
|
|
284
284
|
│
|
|
285
285
|
▼
|
|
286
286
|
┌─────────────────────────────────────────────────────────────┐
|
|
287
|
-
│ .
|
|
287
|
+
│ .sce/backups/backup-{timestamp}/ │
|
|
288
288
|
│ ├── specs/ │
|
|
289
289
|
│ ├── steering/ │
|
|
290
290
|
│ ├── tools/ │
|
|
@@ -310,7 +310,7 @@ This document provides detailed architecture diagrams and explanations for Scene
|
|
|
310
310
|
│
|
|
311
311
|
▼
|
|
312
312
|
┌─────────────────────────────────────────────────────────────┐
|
|
313
|
-
│ Project .
|
|
313
|
+
│ Project .sce/ │
|
|
314
314
|
│ (Restored to backup state) │
|
|
315
315
|
└─────────────────────────────────────────────────────────────┘
|
|
316
316
|
```
|
|
@@ -326,13 +326,13 @@ START
|
|
|
326
326
|
│
|
|
327
327
|
▼
|
|
328
328
|
┌─────────────────────┐
|
|
329
|
-
│ Detect: No .
|
|
329
|
+
│ Detect: No .sce/ │
|
|
330
330
|
│ Mode: Fresh │
|
|
331
331
|
└──────┬──────────────┘
|
|
332
332
|
│
|
|
333
333
|
▼
|
|
334
334
|
┌─────────────────────┐
|
|
335
|
-
│ Create .
|
|
335
|
+
│ Create .sce/ │
|
|
336
336
|
│ directory structure │
|
|
337
337
|
└──────┬──────────────┘
|
|
338
338
|
│
|
|
@@ -368,7 +368,7 @@ START
|
|
|
368
368
|
▼
|
|
369
369
|
┌─────────────────────┐
|
|
370
370
|
│ Detect: Partial │
|
|
371
|
-
│ .
|
|
371
|
+
│ .sce/ exists but │
|
|
372
372
|
│ incomplete │
|
|
373
373
|
└──────┬──────────────┘
|
|
374
374
|
│
|
|
@@ -416,7 +416,7 @@ START
|
|
|
416
416
|
▼
|
|
417
417
|
┌─────────────────────┐
|
|
418
418
|
│ Detect: Full │
|
|
419
|
-
│ .
|
|
419
|
+
│ .sce/ complete but │
|
|
420
420
|
│ old version │
|
|
421
421
|
└──────┬──────────────┘
|
|
422
422
|
│
|
|
@@ -593,7 +593,7 @@ START
|
|
|
593
593
|
▼
|
|
594
594
|
┌─────────────────────┐
|
|
595
595
|
│ Validate source │
|
|
596
|
-
│ .
|
|
596
|
+
│ .sce/ exists │
|
|
597
597
|
└──────┬──────────────┘
|
|
598
598
|
│
|
|
599
599
|
▼
|
|
@@ -605,12 +605,12 @@ START
|
|
|
605
605
|
▼
|
|
606
606
|
┌─────────────────────┐
|
|
607
607
|
│ Create backup dir │
|
|
608
|
-
│ .
|
|
608
|
+
│ .sce/backups/... │
|
|
609
609
|
└──────┬──────────────┘
|
|
610
610
|
│
|
|
611
611
|
▼
|
|
612
612
|
┌─────────────────────┐
|
|
613
|
-
│ Copy .
|
|
613
|
+
│ Copy .sce/ content │
|
|
614
614
|
│ recursively │
|
|
615
615
|
└──────┬──────────────┘
|
|
616
616
|
│
|
|
@@ -668,13 +668,13 @@ START
|
|
|
668
668
|
▼
|
|
669
669
|
┌─────────────────────┐
|
|
670
670
|
│ Clear current │
|
|
671
|
-
│ .
|
|
671
|
+
│ .sce/ content │
|
|
672
672
|
└──────┬──────────────┘
|
|
673
673
|
│
|
|
674
674
|
▼
|
|
675
675
|
┌─────────────────────┐
|
|
676
676
|
│ Copy backup content │
|
|
677
|
-
│ to .
|
|
677
|
+
│ to .sce/ │
|
|
678
678
|
└──────┬──────────────┘
|
|
679
679
|
│
|
|
680
680
|
▼
|
|
@@ -325,11 +325,11 @@ Completely transforming waterfall documents from "human high-cost burden" to "AI
|
|
|
325
325
|
|
|
326
326
|
#### Natural Implementation of High Cohesion, Low Coupling
|
|
327
327
|
|
|
328
|
-
Each feature has an independent `.
|
|
328
|
+
Each feature has an independent `.sce/specs/<name>/` folder, with the three-piece set isolated very cleanly, with coupling forcibly reduced to the minimum by design principles.
|
|
329
329
|
|
|
330
330
|
#### Leverage Point for Principle-Driven Agents
|
|
331
331
|
|
|
332
|
-
The `.
|
|
332
|
+
The `.sce/steering/` directory + steering rules are exactly what you called the "**use experience to set principles to drive agents**" implementation. AI is no longer free-wheeling but guided by rules, much more robust than simple prompt engineering.
|
|
333
333
|
|
|
334
334
|
#### Ultrawork Spirit + Sisyphus Metaphor
|
|
335
335
|
|
|
@@ -380,7 +380,7 @@ Thank you for Guangyong's generous sharing! Haha, regarding "plagiarism"—I pre
|
|
|
380
380
|
|
|
381
381
|
#### Response and Expansion on Steering Rules
|
|
382
382
|
|
|
383
|
-
Your description is very precise: steering constructs a set of "regions," isolating and storing core principles, project environment, and context separately, driving operations through unified indexing. This highly aligns with the project's actual structure—from my analysis of the repository (based on the latest README and directory layout), `.
|
|
383
|
+
Your description is very precise: steering constructs a set of "regions," isolating and storing core principles, project environment, and context separately, driving operations through unified indexing. This highly aligns with the project's actual structure—from my analysis of the repository (based on the latest README and directory layout), `.sce/steering/` is precisely this "principle level" core container, optional but powerful, used to store development rules (like coding conventions, standards, and workflow enforcement), guiding AI Agent behavioral consistency.
|
|
384
384
|
|
|
385
385
|
**Regional Division and Timeliness**: This embodies the philosophical beauty of cyclical properties.
|
|
386
386
|
|
|
@@ -331,11 +331,11 @@ MCP 是提供给 AI 的 Model Context Protocol(模型上下文协议)。
|
|
|
331
331
|
|
|
332
332
|
#### 高内聚、低耦合的天然实现
|
|
333
333
|
|
|
334
|
-
每个 feature 一个独立的 `.
|
|
334
|
+
每个 feature 一个独立的 `.sce/specs/<name>/` 文件夹,三件套隔离得非常干净,耦合度被设计原则强行压到最低。
|
|
335
335
|
|
|
336
336
|
#### 原则驱动 Agent 的着力点
|
|
337
337
|
|
|
338
|
-
`.
|
|
338
|
+
`.sce/steering/` 目录 + steering rules,正是您说的"**用经验设定原则来驱动 agent**"的落地形态。AI 不再是自由发挥,而是被规则引导,这比单纯 prompt engineering 稳健得多。
|
|
339
339
|
|
|
340
340
|
#### Ultrawork spirit + Sisyphus 隐喻
|
|
341
341
|
|
|
@@ -386,7 +386,7 @@ Spec 本身就是**边界 + 愿力**的具现:
|
|
|
386
386
|
|
|
387
387
|
#### 对 steering 规则的回应与扩展
|
|
388
388
|
|
|
389
|
-
您的描述非常精准:steering 构建一套"区域"(regions),将核心原则、项目环境和上下文分别隔离存放,通过统一索引推动运作。这与项目实际结构高度契合——从我对仓库的分析看(基于最新 README 和目录布局),`.
|
|
389
|
+
您的描述非常精准:steering 构建一套"区域"(regions),将核心原则、项目环境和上下文分别隔离存放,通过统一索引推动运作。这与项目实际结构高度契合——从我对仓库的分析看(基于最新 README 和目录布局),`.sce/steering/` 正是这个"原则层面"的核心容器,可选但强大,用于存储开发规则(如编码约定、标准和工作流强制),指导 AI Agent 的行为一致性。
|
|
390
390
|
|
|
391
391
|
**区域划分与时效性**:这体现了周期属性的哲学美感。
|
|
392
392
|
|
|
@@ -40,7 +40,7 @@ sce auto close-loop "build autonomous close-loop and master/sub multi-spec execu
|
|
|
40
40
|
|
|
41
41
|
# Persist DoD evidence into a custom report file
|
|
42
42
|
sce auto close-loop "build autonomous close-loop and master/sub multi-spec execution for sce" \
|
|
43
|
-
--dod-report ".
|
|
43
|
+
--dod-report ".sce/reports/close-loop-dod.json"
|
|
44
44
|
|
|
45
45
|
# Resume interrupted close-loop from latest session
|
|
46
46
|
sce auto close-loop --resume latest
|
|
@@ -58,7 +58,7 @@ sce auto close-loop "build autonomous close-loop and master/sub multi-spec execu
|
|
|
58
58
|
--replan-strategy fixed
|
|
59
59
|
|
|
60
60
|
# Batch mode: run multiple goals autonomously (each goal gets its own master/sub portfolio)
|
|
61
|
-
sce auto close-loop-batch .
|
|
61
|
+
sce auto close-loop-batch .sce/goals.json --json
|
|
62
62
|
|
|
63
63
|
# Program mode: decompose one broad goal into multiple batch goals automatically
|
|
64
64
|
sce auto close-loop-batch \
|
|
@@ -83,20 +83,20 @@ sce auto close-loop-program \
|
|
|
83
83
|
--program-max-elapsed-minutes 60 \
|
|
84
84
|
--program-max-agent-budget 12 \
|
|
85
85
|
--program-max-total-sub-specs 80 \
|
|
86
|
-
--program-kpi-out .
|
|
87
|
-
--program-audit-out .
|
|
86
|
+
--program-kpi-out .sce/reports/close-loop-program-kpi.json \
|
|
87
|
+
--program-audit-out .sce/reports/close-loop-program-audit.json \
|
|
88
88
|
--json
|
|
89
89
|
|
|
90
90
|
# Controller command: drain queue goals with autonomous close-loop-program runtime
|
|
91
|
-
sce auto close-loop-controller .
|
|
91
|
+
sce auto close-loop-controller .sce/auto/program-queue.lines \
|
|
92
92
|
--dequeue-limit 2 \
|
|
93
93
|
--max-cycles 20 \
|
|
94
|
-
--controller-done-file .
|
|
95
|
-
--controller-failed-file .
|
|
94
|
+
--controller-done-file .sce/auto/program-done.lines \
|
|
95
|
+
--controller-failed-file .sce/auto/program-failed.lines \
|
|
96
96
|
--json
|
|
97
97
|
|
|
98
98
|
# Persistent controller mode: keep polling queue and execute new goals automatically
|
|
99
|
-
sce auto close-loop-controller .
|
|
99
|
+
sce auto close-loop-controller .sce/auto/program-queue.lines \
|
|
100
100
|
--wait-on-empty \
|
|
101
101
|
--poll-seconds 30 \
|
|
102
102
|
--max-cycles 1000 \
|
|
@@ -107,63 +107,63 @@ sce auto close-loop-controller --controller-resume latest --json
|
|
|
107
107
|
|
|
108
108
|
# Recovery command: consume diagnostics and auto-recover unresolved goals
|
|
109
109
|
sce auto close-loop-recover latest --json
|
|
110
|
-
sce auto close-loop-recover .
|
|
110
|
+
sce auto close-loop-recover .sce/auto/close-loop-batch-summaries/batch-20260215090000.json \
|
|
111
111
|
--use-action 2 \
|
|
112
112
|
--recover-until-complete \
|
|
113
113
|
--recover-max-rounds 3 \
|
|
114
114
|
--recover-max-minutes 20 \
|
|
115
115
|
--recovery-memory-ttl-days 30 \
|
|
116
116
|
--recovery-memory-scope release-main \
|
|
117
|
-
--program-audit-out .
|
|
117
|
+
--program-audit-out .sce/reports/close-loop-recover-audit.json \
|
|
118
118
|
--dry-run --json
|
|
119
119
|
|
|
120
120
|
# Default autonomous batch run (continue-on-error + adaptive scheduling + retry-until-complete)
|
|
121
|
-
sce auto close-loop-batch .
|
|
121
|
+
sce auto close-loop-batch .sce/goals.json --json
|
|
122
122
|
|
|
123
123
|
# Batch parallel mode: run multiple goals concurrently
|
|
124
|
-
sce auto close-loop-batch .
|
|
124
|
+
sce auto close-loop-batch .sce/goals.json --batch-parallel 3 --json
|
|
125
125
|
|
|
126
126
|
# Batch with global agent budget (automatic per-goal maxParallel throttling)
|
|
127
|
-
sce auto close-loop-batch .
|
|
127
|
+
sce auto close-loop-batch .sce/goals.json \
|
|
128
128
|
--batch-parallel 3 \
|
|
129
129
|
--batch-agent-budget 6 \
|
|
130
130
|
--json
|
|
131
131
|
|
|
132
132
|
# Batch priority scheduling with aging (favor complex goals, prevent starvation)
|
|
133
|
-
sce auto close-loop-batch .
|
|
133
|
+
sce auto close-loop-batch .sce/goals.json \
|
|
134
134
|
--batch-priority critical-first \
|
|
135
135
|
--batch-aging-factor 3 \
|
|
136
136
|
--json
|
|
137
137
|
|
|
138
138
|
# Auto-retry failed/stopped goals in the same batch run
|
|
139
|
-
sce auto close-loop-batch .
|
|
139
|
+
sce auto close-loop-batch .sce/goals.json \
|
|
140
140
|
--batch-retry-rounds 1 \
|
|
141
141
|
--batch-retry-strategy adaptive \
|
|
142
142
|
--json
|
|
143
143
|
|
|
144
144
|
# Keep retrying until all goals complete (bounded)
|
|
145
|
-
sce auto close-loop-batch .
|
|
145
|
+
sce auto close-loop-batch .sce/goals.json \
|
|
146
146
|
--batch-retry-until-complete \
|
|
147
147
|
--batch-retry-max-rounds 10 \
|
|
148
148
|
--json
|
|
149
149
|
|
|
150
150
|
# Disable autonomous closed-loop batch policy (only when you need legacy/manual tuning)
|
|
151
|
-
sce auto close-loop-batch .
|
|
151
|
+
sce auto close-loop-batch .sce/goals.json \
|
|
152
152
|
--no-batch-autonomous \
|
|
153
153
|
--json
|
|
154
154
|
|
|
155
155
|
# Resume a stopped/failed batch from previous summary output
|
|
156
|
-
sce auto close-loop-batch --resume-from-summary .
|
|
156
|
+
sce auto close-loop-batch --resume-from-summary .sce/reports/close-loop-batch.json --json
|
|
157
157
|
|
|
158
158
|
# Resume from latest persisted batch summary session
|
|
159
159
|
sce auto close-loop-batch --resume-from-summary latest --json
|
|
160
160
|
|
|
161
161
|
# Resume only failed/error goals from summary
|
|
162
|
-
sce auto close-loop-batch --resume-from-summary .
|
|
162
|
+
sce auto close-loop-batch --resume-from-summary .sce/reports/close-loop-batch.json \
|
|
163
163
|
--resume-strategy failed-only --json
|
|
164
164
|
|
|
165
165
|
# Batch dry-run for portfolio planning only
|
|
166
|
-
sce auto close-loop-batch .
|
|
166
|
+
sce auto close-loop-batch .sce/goals.txt --format lines --dry-run --json
|
|
167
167
|
```
|
|
168
168
|
|
|
169
169
|
Default DoD gates:
|
|
@@ -177,12 +177,12 @@ Optional DoD gates:
|
|
|
177
177
|
- `--dod-tasks-closed`: enforce closed checklist items in `tasks.md`
|
|
178
178
|
|
|
179
179
|
DoD evidence archive:
|
|
180
|
-
- Default output: `.
|
|
180
|
+
- Default output: `.sce/specs/<master-spec>/custom/dod-report.json`
|
|
181
181
|
- `--dod-report <path>`: override report path
|
|
182
182
|
- `--no-dod-report`: disable report generation
|
|
183
183
|
|
|
184
184
|
Session persistence and resume:
|
|
185
|
-
- Default session archive: `.
|
|
185
|
+
- Default session archive: `.sce/auto/close-loop-sessions/*.json`
|
|
186
186
|
- `--session-id <id>`: override generated session id
|
|
187
187
|
- `--resume <session-or-file>`: continue from prior session (supports `latest`)
|
|
188
188
|
- `--no-session`: disable session snapshot persistence
|
|
@@ -195,13 +195,13 @@ Session persistence and resume:
|
|
|
195
195
|
- Stats JSON output includes `criteria`, completion/failure rates, `sub_spec_count_sum`, `master_spec_counts`, and `latest_sessions`.
|
|
196
196
|
|
|
197
197
|
Spec directory maintenance:
|
|
198
|
-
- `sce auto spec-session list [--limit <n>] [--json]`: inspect spec directory inventory under `.
|
|
198
|
+
- `sce auto spec-session list [--limit <n>] [--json]`: inspect spec directory inventory under `.sce/specs`
|
|
199
199
|
- `sce auto spec-session prune --keep <n> [--older-than-days <n>] [--no-protect-active] [--protect-window-days <n>] [--show-protection-reasons] [--dry-run] [--json]`: prune old spec directories by retention policy (default protects active/recent specs)
|
|
200
200
|
- Protection sources include collaboration state, close-loop sessions, batch summaries, and controller sessions (via nested batch summary references).
|
|
201
201
|
- JSON output always includes `protection_ranking_top`; enable `--show-protection-reasons` for full `protection_ranking` and per-spec reason payload.
|
|
202
202
|
|
|
203
203
|
Batch summary session persistence and maintenance:
|
|
204
|
-
- Default batch summary archive: `.
|
|
204
|
+
- Default batch summary archive: `.sce/auto/close-loop-batch-summaries/*.json`
|
|
205
205
|
- `--batch-session-id <id>`: override generated batch summary session id
|
|
206
206
|
- `--batch-session-keep <n>`: auto-prune archive and keep newest `n` summaries after each batch run
|
|
207
207
|
- `--batch-session-older-than-days <n>`: when pruning, only delete summaries older than `n` days
|
|
@@ -213,7 +213,7 @@ Batch summary session persistence and maintenance:
|
|
|
213
213
|
- Stats JSON output includes `criteria`, completion/failure rates, goal-volume sums, processed ratio, and `latest_sessions`.
|
|
214
214
|
|
|
215
215
|
Controller summary session persistence and maintenance:
|
|
216
|
-
- Default controller summary archive: `.
|
|
216
|
+
- Default controller summary archive: `.sce/auto/close-loop-controller-sessions/*.json`
|
|
217
217
|
- `--controller-session-id <id>`: override generated controller session id
|
|
218
218
|
- `--controller-session-keep <n>`: auto-prune archive and keep newest `n` summaries after each controller run
|
|
219
219
|
- `--controller-session-older-than-days <n>`: when pruning, only delete summaries older than `n` days
|
|
@@ -233,7 +233,7 @@ Cross-archive governance snapshot:
|
|
|
233
233
|
- `--dry-run` can be combined with `--apply` to validate maintenance impact before deletion.
|
|
234
234
|
- `sce auto governance close-loop [--max-rounds <n>] [--target-risk <low|medium|high>] [--governance-resume <session|latest|file>] [--governance-resume-allow-drift] [--governance-session-id <id>] [--no-governance-session] [--governance-session-keep <n>] [--governance-session-older-than-days <n>] [--execute-advisory] [--advisory-recover-max-rounds <n>] [--advisory-controller-max-cycles <n>] [--plan-only] [--dry-run] [--json]`: governance round-loop runner.
|
|
235
235
|
- Orchestrates repeated `governance maintain` rounds until target risk or stop condition is reached.
|
|
236
|
-
- Governance close-loop sessions persist by default at `.
|
|
236
|
+
- Governance close-loop sessions persist by default at `.sce/auto/governance-close-loop-sessions`; use `--governance-resume` to continue interrupted governance loops.
|
|
237
237
|
- Resume defaults inherit persisted governance policy (`target_risk`, `execute_advisory`, `advisory_policy`) to avoid accidental configuration drift; explicit drift is blocked unless `--governance-resume-allow-drift` is set.
|
|
238
238
|
- `--governance-session-keep` enables automatic post-run governance session pruning (optional age window via `--governance-session-older-than-days`) while preserving the current run session file.
|
|
239
239
|
- `--execute-advisory` enables automatic advisory action execution when detected (`recover-latest`, `controller-resume-latest`), with autonomous source selection (latest recoverable summary / latest pending controller session) and `skipped` telemetry when no actionable source exists.
|
|
@@ -243,7 +243,7 @@ Cross-archive governance snapshot:
|
|
|
243
243
|
- `sce auto governance session prune [--keep <n>] [--older-than-days <n>] [--dry-run] [--json]`: enforce governance session retention policy.
|
|
244
244
|
|
|
245
245
|
Recovery memory maintenance:
|
|
246
|
-
- Default recovery memory file: `.
|
|
246
|
+
- Default recovery memory file: `.sce/auto/close-loop-recovery-memory.json`
|
|
247
247
|
- `sce auto recovery-memory show [--scope <scope>] [--json]`: inspect learned failure signatures and action stats (optionally by scope)
|
|
248
248
|
- `sce auto recovery-memory scopes [--json]`: inspect aggregated recovery-memory metrics grouped by scope
|
|
249
249
|
- `sce auto recovery-memory prune [--older-than-days <n>] [--scope <scope>] [--dry-run] [--json]`: prune stale memory entries (optionally by scope)
|
|
@@ -284,11 +284,11 @@ Batch multi-goal autonomous execution:
|
|
|
284
284
|
- `--batch-session-id <id>`: set explicit id for persisted batch summary session
|
|
285
285
|
- `--batch-session-keep <n>`: keep newest `n` persisted batch summary sessions (`0-1000`)
|
|
286
286
|
- `--batch-session-older-than-days <n>`: when pruning persisted batch summaries, only delete sessions older than `n` days (`0-36500`)
|
|
287
|
-
- `--spec-session-keep <n>`: keep newest `n` spec directories under `.
|
|
287
|
+
- `--spec-session-keep <n>`: keep newest `n` spec directories under `.sce/specs` after run (`0-5000`)
|
|
288
288
|
- `--spec-session-older-than-days <n>`: when pruning specs, only delete directories older than `n` days (`0-36500`)
|
|
289
289
|
- `--no-spec-session-protect-active`: allow pruning active/recently referenced spec directories
|
|
290
290
|
- `--spec-session-protect-window-days <n>`: protection window (days) for recent session references during spec pruning (`0-36500`, default `7`)
|
|
291
|
-
- `--spec-session-max-total <n>`: spec directory budget ceiling under `.
|
|
291
|
+
- `--spec-session-max-total <n>`: spec directory budget ceiling under `.sce/specs` (`1-500000`)
|
|
292
292
|
- `--spec-session-max-created <n>`: spec growth guard for maximum estimated created directories per run (`0-500000`)
|
|
293
293
|
- `--spec-session-max-created-per-goal <n>`: spec growth guard for estimated created directories per processed goal (`0-1000`)
|
|
294
294
|
- `--spec-session-max-duplicate-goals <n>`: goal-input duplicate guard for batch inputs (`0-500000`)
|
|
@@ -341,7 +341,7 @@ Close-loop program command:
|
|
|
341
341
|
Close-loop controller command:
|
|
342
342
|
- Command: `sce auto close-loop-controller [queue-file]`
|
|
343
343
|
- Runs a queue-driven autonomous loop: dequeue broad goals, execute each by `close-loop-program`, persist remaining queue, and continue until stop condition.
|
|
344
|
-
- Queue file defaults to `.
|
|
344
|
+
- Queue file defaults to `.sce/auto/close-loop-controller-goals.lines`; supports `auto|json|lines` parsing via `--queue-format`.
|
|
345
345
|
- `--controller-resume <session-or-file>` resumes queue/controller context from persisted controller session (`latest`, session id, or file path).
|
|
346
346
|
- Duplicate broad goals are deduped by default; use `--no-controller-dedupe` to preserve raw queue duplicates.
|
|
347
347
|
- `--dequeue-limit <n>` controls how many queued goals are consumed in one cycle (`1-100`, default: all pending goals).
|
|
@@ -350,7 +350,7 @@ Close-loop controller command:
|
|
|
350
350
|
- Controller lease lock is enabled by default to prevent concurrent queue corruption (`--controller-lock-file`, `--controller-lock-ttl-seconds`, `--no-controller-lock`).
|
|
351
351
|
- `--stop-on-goal-failure` stops controller immediately on the first failed dequeued goal.
|
|
352
352
|
- `--controller-done-file` / `--controller-failed-file` append per-goal archive lines for downstream ops and replay.
|
|
353
|
-
- Controller summaries are persisted by default (`.
|
|
353
|
+
- Controller summaries are persisted by default (`.sce/auto/close-loop-controller-sessions`); use `--controller-session-id`, `--controller-session-keep`, `--controller-session-older-than-days`, `--no-controller-session` as needed.
|
|
354
354
|
- `--controller-print-program-summary` prints each nested program summary in realtime during controller execution.
|
|
355
355
|
- Supports full program governance/gate/recovery policy controls (`--program-*`, `--batch-*`, `--continue-on-error`, `--recovery-memory-scope`, `--dry-run`, `--json`).
|
|
356
356
|
- Output summary includes `history`, `results`, final `pending_goals`, `stop_reason`, `exhausted`, dedupe/lock/session, and resume-source telemetry.
|
|
@@ -506,7 +506,7 @@ sce auto stop
|
|
|
506
506
|
|
|
507
507
|
### Global Configuration
|
|
508
508
|
|
|
509
|
-
Location: `.
|
|
509
|
+
Location: `.sce/auto/config.json`
|
|
510
510
|
|
|
511
511
|
```json
|
|
512
512
|
{
|
|
@@ -543,7 +543,7 @@ Location: `.kiro/auto/config.json`
|
|
|
543
543
|
|
|
544
544
|
### Per-Spec Configuration
|
|
545
545
|
|
|
546
|
-
Location: `.
|
|
546
|
+
Location: `.sce/specs/{spec-name}/auto-config.json`
|
|
547
547
|
|
|
548
548
|
Per-spec configuration overrides global settings.
|
|
549
549
|
|
|
@@ -773,7 +773,7 @@ sce auto resume
|
|
|
773
773
|
### Custom Recovery Strategies
|
|
774
774
|
|
|
775
775
|
```javascript
|
|
776
|
-
// In your project's .
|
|
776
|
+
// In your project's .sce/auto/custom-strategies.js
|
|
777
777
|
module.exports = {
|
|
778
778
|
'custom-fix': async (error, context) => {
|
|
779
779
|
// Your custom recovery logic
|
|
@@ -847,5 +847,5 @@ A: Simply don't use `sce auto` commands. Use regular `sce` commands for interact
|
|
|
847
847
|
|
|
848
848
|
- [Spec Workflow Guide](./spec-workflow.md)
|
|
849
849
|
- [Testing Strategy](./testing-strategy.md)
|
|
850
|
-
- [CORE_PRINCIPLES](./.
|
|
850
|
+
- [CORE_PRINCIPLES](./.sce/steering/CORE_PRINCIPLES.md)
|
|
851
851
|
- [Command Reference](./command-reference.md)
|