scene-capability-engine 3.3.4 → 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 +151 -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 +6 -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/agent-runtime/agent-result-summary-contract.schema.json +50 -0
- package/docs/agent-runtime/agent-result-summary.sample.json +11 -0
- package/docs/agent-runtime/capability-mapping-report.sample.json +42 -0
- package/docs/agent-runtime/capability-mapping-report.schema.json +136 -0
- package/docs/agent-runtime/failure-taxonomy-baseline.json +99 -0
- package/docs/agent-runtime/multi-agent-coordination-policy-baseline.json +38 -0
- package/docs/agent-runtime/strategy-routing-policy-baseline.json +24 -0
- package/docs/agent-runtime/symbol-evidence.sample.json +34 -0
- package/docs/agent-runtime/symbol-evidence.schema.json +128 -0
- 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 +254 -151
- 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/sce-capability-matrix-e2e-example.md +94 -0
- package/docs/sce-capability-matrix-roadmap.md +48 -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 +15 -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 +180 -2
- package/lib/orchestrator/bootstrap-prompt-builder.js +9 -6
- package/lib/orchestrator/orchestration-engine.js +346 -2
- 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 +12 -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
|
@@ -66,8 +66,8 @@ node scripts/interactive-context-bridge.js \
|
|
|
66
66
|
|
|
67
67
|
Bridge output defaults:
|
|
68
68
|
|
|
69
|
-
- Normalized page-context: `.
|
|
70
|
-
- Bridge report: `.
|
|
69
|
+
- Normalized page-context: `.sce/reports/interactive-page-context.normalized.json`
|
|
70
|
+
- Bridge report: `.sce/reports/interactive-context-bridge.json`
|
|
71
71
|
|
|
72
72
|
Run one-command full flow (bridge -> loop):
|
|
73
73
|
|
|
@@ -107,20 +107,20 @@ Common matrix flags:
|
|
|
107
107
|
|
|
108
108
|
Flow output defaults:
|
|
109
109
|
|
|
110
|
-
- Flow summary: `.
|
|
111
|
-
- Bridge context: `.
|
|
112
|
-
- Loop summary: `.
|
|
113
|
-
- Dialogue governance report: `.
|
|
110
|
+
- Flow summary: `.sce/reports/interactive-flow/<session-id>/interactive-flow.summary.json`
|
|
111
|
+
- Bridge context: `.sce/reports/interactive-flow/<session-id>/interactive-page-context.normalized.json`
|
|
112
|
+
- Loop summary: `.sce/reports/interactive-flow/<session-id>/interactive-customization-loop.summary.json`
|
|
113
|
+
- Dialogue governance report: `.sce/reports/interactive-flow/<session-id>/interactive-dialogue-governance.json`
|
|
114
114
|
- Dialogue authorization signal stream:
|
|
115
|
-
- Session: `.
|
|
116
|
-
- Global: `.
|
|
117
|
-
- Authorization tier report: `.
|
|
115
|
+
- Session: `.sce/reports/interactive-flow/<session-id>/interactive-dialogue-authorization-signals.jsonl`
|
|
116
|
+
- Global: `.sce/reports/interactive-dialogue-authorization-signals.jsonl`
|
|
117
|
+
- Authorization tier report: `.sce/reports/interactive-flow/<session-id>/interactive-authorization-tier.json`
|
|
118
118
|
- Authorization tier signal stream:
|
|
119
|
-
- Session: `.
|
|
120
|
-
- Global: `.
|
|
121
|
-
- Matrix summary JSON: `.
|
|
122
|
-
- Matrix summary Markdown: `.
|
|
123
|
-
- Matrix signal stream: `.
|
|
119
|
+
- Session: `.sce/reports/interactive-flow/<session-id>/interactive-authorization-tier-signals.jsonl`
|
|
120
|
+
- Global: `.sce/reports/interactive-authorization-tier-signals.jsonl`
|
|
121
|
+
- Matrix summary JSON: `.sce/reports/interactive-flow/<session-id>/moqui-template-baseline.json`
|
|
122
|
+
- Matrix summary Markdown: `.sce/reports/interactive-flow/<session-id>/moqui-template-baseline.md`
|
|
123
|
+
- Matrix signal stream: `.sce/reports/interactive-matrix-signals.jsonl`
|
|
124
124
|
- Loop/flow summaries now include execution block diagnostics:
|
|
125
125
|
- `summary.dialogue_authorization_decision` (`allow|review-required|deny`)
|
|
126
126
|
- `summary.execution_block_reason_category` (`password-authorization|role-policy|authorization-tier|runtime-policy|approval-policy|unknown`)
|
|
@@ -142,7 +142,7 @@ Generate a change plan from intent (suggestion stage):
|
|
|
142
142
|
|
|
143
143
|
```bash
|
|
144
144
|
node scripts/interactive-plan-build.js \
|
|
145
|
-
--intent .
|
|
145
|
+
--intent .sce/reports/interactive-change-intent.json \
|
|
146
146
|
--context docs/interactive-customization/page-context.sample.json \
|
|
147
147
|
--json
|
|
148
148
|
```
|
|
@@ -212,8 +212,8 @@ sce scene interactive-loop \
|
|
|
212
212
|
```
|
|
213
213
|
|
|
214
214
|
`--feedback-score` writes feedback into both:
|
|
215
|
-
- Session artifact: `.
|
|
216
|
-
- Governance global stream: `.
|
|
215
|
+
- Session artifact: `.sce/reports/interactive-loop/<session-id>/interactive-user-feedback.jsonl`
|
|
216
|
+
- Governance global stream: `.sce/reports/interactive-user-feedback.jsonl`
|
|
217
217
|
- `--dialogue-profile` defaults to `business-user`; use `system-maintainer` for operations/maintenance sessions that must surface ticket + rollback requirements before execution.
|
|
218
218
|
- `--ui-mode user-app|ops-console` binds interaction surface semantics (user app vs management console) and participates in authorization dialogue decisioning.
|
|
219
219
|
- In default authorization tier, `business-user` only allows `suggestion` mode; apply path requires `system-maintainer` profile plus environment-specific step-up requirements.
|
|
@@ -226,7 +226,7 @@ Run runtime mode/environment policy evaluation directly:
|
|
|
226
226
|
|
|
227
227
|
```bash
|
|
228
228
|
node scripts/interactive-runtime-policy-evaluate.js \
|
|
229
|
-
--plan .
|
|
229
|
+
--plan .sce/reports/interactive-change-plan.generated.json \
|
|
230
230
|
--ui-mode ops-console \
|
|
231
231
|
--runtime-mode ops-fix \
|
|
232
232
|
--runtime-environment staging \
|
|
@@ -250,12 +250,12 @@ Build interactive work-order artifacts directly:
|
|
|
250
250
|
|
|
251
251
|
```bash
|
|
252
252
|
node scripts/interactive-work-order-build.js \
|
|
253
|
-
--plan .
|
|
254
|
-
--dialogue .
|
|
255
|
-
--gate .
|
|
256
|
-
--runtime .
|
|
257
|
-
--authorization-tier .
|
|
258
|
-
--approval-state .
|
|
253
|
+
--plan .sce/reports/interactive-change-plan.generated.json \
|
|
254
|
+
--dialogue .sce/reports/interactive-dialogue-governance.json \
|
|
255
|
+
--gate .sce/reports/interactive-change-plan-gate.json \
|
|
256
|
+
--runtime .sce/reports/interactive-runtime-policy.json \
|
|
257
|
+
--authorization-tier .sce/reports/interactive-authorization-tier.json \
|
|
258
|
+
--approval-state .sce/reports/interactive-approval-state.json \
|
|
259
259
|
--execution-attempted \
|
|
260
260
|
--execution-result success \
|
|
261
261
|
--execution-id exec-xxxx \
|
|
@@ -268,7 +268,7 @@ Run approval workflow state machine:
|
|
|
268
268
|
# init from generated plan
|
|
269
269
|
node scripts/interactive-approval-workflow.js \
|
|
270
270
|
--action init \
|
|
271
|
-
--plan .
|
|
271
|
+
--plan .sce/reports/interactive-change-plan.generated.json \
|
|
272
272
|
--actor product-owner \
|
|
273
273
|
--json
|
|
274
274
|
|
|
@@ -294,24 +294,24 @@ node scripts/interactive-moqui-adapter.js \
|
|
|
294
294
|
# build plan from intent through adapter contract
|
|
295
295
|
node scripts/interactive-moqui-adapter.js \
|
|
296
296
|
--action plan \
|
|
297
|
-
--intent .
|
|
297
|
+
--intent .sce/reports/interactive-change-intent.json \
|
|
298
298
|
--execution-mode suggestion \
|
|
299
299
|
--json
|
|
300
300
|
|
|
301
301
|
# validate/apply with policy gate and execution record output
|
|
302
302
|
node scripts/interactive-moqui-adapter.js \
|
|
303
303
|
--action validate \
|
|
304
|
-
--plan .
|
|
304
|
+
--plan .sce/reports/interactive-change-plan.adapter.json \
|
|
305
305
|
--json
|
|
306
306
|
node scripts/interactive-moqui-adapter.js \
|
|
307
307
|
--action apply \
|
|
308
|
-
--plan .
|
|
308
|
+
--plan .sce/reports/interactive-change-plan.adapter.json \
|
|
309
309
|
--json
|
|
310
310
|
|
|
311
311
|
# one-click path: only accepts low-risk + allow decision
|
|
312
312
|
node scripts/interactive-moqui-adapter.js \
|
|
313
313
|
--action low-risk-apply \
|
|
314
|
-
--plan .
|
|
314
|
+
--plan .sce/reports/interactive-change-plan.adapter.json \
|
|
315
315
|
--json
|
|
316
316
|
|
|
317
317
|
# rollback by execution id from execution ledger
|
|
@@ -323,8 +323,8 @@ node scripts/interactive-moqui-adapter.js \
|
|
|
323
323
|
|
|
324
324
|
Execution artifacts:
|
|
325
325
|
|
|
326
|
-
- Latest execution record: `.
|
|
327
|
-
- Append-only execution ledger: `.
|
|
326
|
+
- Latest execution record: `.sce/reports/interactive-execution-record.latest.json`
|
|
327
|
+
- Append-only execution ledger: `.sce/reports/interactive-execution-ledger.jsonl`
|
|
328
328
|
- Execution records include diff summary, gate decision, validation snapshot, and rollback reference.
|
|
329
329
|
|
|
330
330
|
Append business-user feedback for governance scoring:
|
|
@@ -354,29 +354,29 @@ node scripts/interactive-governance-report.js \
|
|
|
354
354
|
--json
|
|
355
355
|
```
|
|
356
356
|
|
|
357
|
-
The governance report consumes feedback events from `.
|
|
358
|
-
The governance report also consumes matrix signals from `.
|
|
359
|
-
The governance report consumes dialogue-authorization signals from `.
|
|
360
|
-
The governance report consumes runtime policy signals from `.
|
|
361
|
-
The governance report consumes authorization-tier signals from `.
|
|
357
|
+
The governance report consumes feedback events from `.sce/reports/interactive-user-feedback.jsonl` by default.
|
|
358
|
+
The governance report also consumes matrix signals from `.sce/reports/interactive-matrix-signals.jsonl` by default.
|
|
359
|
+
The governance report consumes dialogue-authorization signals from `.sce/reports/interactive-dialogue-authorization-signals.jsonl` by default.
|
|
360
|
+
The governance report consumes runtime policy signals from `.sce/reports/interactive-runtime-signals.jsonl` by default.
|
|
361
|
+
The governance report consumes authorization-tier signals from `.sce/reports/interactive-authorization-tier-signals.jsonl` by default.
|
|
362
362
|
When `intent_total` is below `min_intent_samples` (default `5`), adoption emits a low-severity sample warning instead of a breach.
|
|
363
363
|
|
|
364
364
|
Export matrix regression remediation queue lines (for close-loop-batch):
|
|
365
365
|
|
|
366
366
|
```bash
|
|
367
367
|
node scripts/moqui-matrix-remediation-queue.js \
|
|
368
|
-
--baseline .
|
|
368
|
+
--baseline .sce/reports/release-evidence/moqui-template-baseline.json \
|
|
369
369
|
--top-templates 5 \
|
|
370
|
-
--lines-out .
|
|
371
|
-
--batch-json-out .
|
|
372
|
-
--commands-out .
|
|
370
|
+
--lines-out .sce/auto/matrix-remediation.lines \
|
|
371
|
+
--batch-json-out .sce/auto/matrix-remediation.goals.json \
|
|
372
|
+
--commands-out .sce/reports/release-evidence/matrix-remediation-commands.md \
|
|
373
373
|
--json
|
|
374
374
|
```
|
|
375
375
|
|
|
376
376
|
Recommended anti-429 phased execution (default outputs):
|
|
377
377
|
|
|
378
378
|
```bash
|
|
379
|
-
sce auto close-loop-batch .
|
|
379
|
+
sce auto close-loop-batch .sce/auto/matrix-remediation.goals.high.json \
|
|
380
380
|
--format json \
|
|
381
381
|
--batch-parallel 1 \
|
|
382
382
|
--batch-agent-budget 2 \
|
|
@@ -386,7 +386,7 @@ sce auto close-loop-batch .kiro/auto/matrix-remediation.goals.high.json \
|
|
|
386
386
|
|
|
387
387
|
sleep 30
|
|
388
388
|
|
|
389
|
-
sce auto close-loop-batch .
|
|
389
|
+
sce auto close-loop-batch .sce/auto/matrix-remediation.goals.medium.json \
|
|
390
390
|
--format json \
|
|
391
391
|
--batch-parallel 1 \
|
|
392
392
|
--batch-agent-budget 2 \
|
|
@@ -405,7 +405,7 @@ Zero-prep one-shot (prepare from baseline + run phased):
|
|
|
405
405
|
|
|
406
406
|
```bash
|
|
407
407
|
node scripts/moqui-matrix-remediation-phased-runner.js \
|
|
408
|
-
--baseline .
|
|
408
|
+
--baseline .sce/reports/release-evidence/moqui-template-baseline.json \
|
|
409
409
|
--json
|
|
410
410
|
|
|
411
411
|
npm run run:matrix-remediation-from-baseline -- --json
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": "1.0.0",
|
|
3
|
+
"defaults": {
|
|
4
|
+
"mode": null,
|
|
5
|
+
"enforce_alignment": true
|
|
6
|
+
},
|
|
7
|
+
"modes": {
|
|
8
|
+
"user-mode": {
|
|
9
|
+
"execution_mode": "suggestion",
|
|
10
|
+
"dialogue_profile": "business-user",
|
|
11
|
+
"ui_mode": "user-app",
|
|
12
|
+
"runtime_mode": "user-assist",
|
|
13
|
+
"runtime_environment": "staging",
|
|
14
|
+
"auto_execute_low_risk": false
|
|
15
|
+
},
|
|
16
|
+
"ops-mode": {
|
|
17
|
+
"execution_mode": "apply",
|
|
18
|
+
"dialogue_profile": "system-maintainer",
|
|
19
|
+
"ui_mode": "ops-console",
|
|
20
|
+
"runtime_mode": "ops-fix",
|
|
21
|
+
"runtime_environment": "staging",
|
|
22
|
+
"auto_execute_low_risk": false
|
|
23
|
+
},
|
|
24
|
+
"dev-mode": {
|
|
25
|
+
"execution_mode": "apply",
|
|
26
|
+
"dialogue_profile": "system-maintainer",
|
|
27
|
+
"ui_mode": "ops-console",
|
|
28
|
+
"runtime_mode": "feature-dev",
|
|
29
|
+
"runtime_environment": "dev",
|
|
30
|
+
"auto_execute_low_risk": false
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
}
|
|
@@ -75,7 +75,7 @@ When evaluating runtime policy directly, pass `--ui-mode`:
|
|
|
75
75
|
|
|
76
76
|
```bash
|
|
77
77
|
node scripts/interactive-runtime-policy-evaluate.js \
|
|
78
|
-
--plan .
|
|
78
|
+
--plan .sce/reports/interactive-change-plan.generated.json \
|
|
79
79
|
--ui-mode user-app \
|
|
80
80
|
--runtime-mode ops-fix \
|
|
81
81
|
--runtime-environment staging \
|
|
@@ -36,5 +36,5 @@ This document defines the minimal adapter contract used by interactive customiza
|
|
|
36
36
|
|
|
37
37
|
## Artifacts
|
|
38
38
|
|
|
39
|
-
- Latest execution record: `.
|
|
40
|
-
- Execution ledger (JSONL): `.
|
|
39
|
+
- Latest execution record: `.sce/reports/interactive-execution-record.latest.json`
|
|
40
|
+
- Execution ledger (JSONL): `.sce/reports/interactive-execution-ledger.jsonl`
|
|
@@ -97,4 +97,4 @@ node scripts/interactive-intent-build.js \
|
|
|
97
97
|
2. Context contract gate passes (required fields + payload size + forbidden keys).
|
|
98
98
|
3. Sensitive keys are masked or removed.
|
|
99
99
|
4. Copilot outputs contain `readonly=true`.
|
|
100
|
-
5. Audit event is appended to `.
|
|
100
|
+
5. Audit event is appended to `.sce/reports/interactive-copilot-audit.jsonl`.
|
|
@@ -20,10 +20,10 @@ This playbook defines how to turn validated Moqui interactive customization flow
|
|
|
20
20
|
|
|
21
21
|
Primary package for the interactive loop:
|
|
22
22
|
|
|
23
|
-
- `.
|
|
24
|
-
- `.
|
|
25
|
-
- `.
|
|
26
|
-
- `.
|
|
23
|
+
- `.sce/templates/scene-packages/kse.scene--moqui-interactive-customization-loop--0.1.0/scene-package.json`
|
|
24
|
+
- `.sce/templates/scene-packages/kse.scene--moqui-interactive-customization-loop--0.1.0/scene.template.yaml`
|
|
25
|
+
- `.sce/templates/scene-packages/kse.scene--moqui-interactive-customization-loop--0.1.0/custom/scene.yaml`
|
|
26
|
+
- `.sce/templates/scene-packages/kse.scene--moqui-interactive-customization-loop--0.1.0/template.manifest.json`
|
|
27
27
|
|
|
28
28
|
## Capability Matrix Mapping
|
|
29
29
|
|
|
@@ -90,8 +90,8 @@ Scope:
|
|
|
90
90
|
|
|
91
91
|
Evidence:
|
|
92
92
|
|
|
93
|
-
- `.
|
|
94
|
-
- `.
|
|
93
|
+
- `.sce/templates/scene-packages/kse.scene--moqui-interactive-customization-loop--0.1.0/scene-package.json`
|
|
94
|
+
- `.sce/templates/scene-packages/kse.scene--moqui-interactive-customization-loop--0.1.0/scene.template.yaml`
|
|
95
95
|
- `docs/interactive-customization/moqui-interactive-template-playbook.md`
|
|
96
96
|
- `docs/interactive-customization/adapter-extension-contract.schema.json`
|
|
97
97
|
- `docs/interactive-customization/domain-pack-extension-flow.md`
|
|
@@ -12,7 +12,7 @@ The Knowledge Management system allows you to build and maintain a personal know
|
|
|
12
12
|
sce knowledge init
|
|
13
13
|
```
|
|
14
14
|
|
|
15
|
-
This creates `.
|
|
15
|
+
This creates `.sce/knowledge/` directory with:
|
|
16
16
|
- `patterns/` - Design patterns and solutions
|
|
17
17
|
- `lessons/` - Lessons learned
|
|
18
18
|
- `workflows/` - Custom workflows
|
|
@@ -168,7 +168,7 @@ Use consistent, descriptive tags:
|
|
|
168
168
|
|
|
169
169
|
### Custom Templates
|
|
170
170
|
|
|
171
|
-
Create custom templates in `.
|
|
171
|
+
Create custom templates in `.sce/knowledge/.templates/`:
|
|
172
172
|
|
|
173
173
|
```markdown
|
|
174
174
|
---
|
|
@@ -233,7 +233,7 @@ Error: Failed to load index
|
|
|
233
233
|
**Solution**: Rebuild index:
|
|
234
234
|
```bash
|
|
235
235
|
# Delete index.json
|
|
236
|
-
rm .
|
|
236
|
+
rm .sce/knowledge/index.json
|
|
237
237
|
|
|
238
238
|
# Reinitialize
|
|
239
239
|
sce knowledge init
|
|
@@ -242,16 +242,16 @@ sce knowledge init
|
|
|
242
242
|
## FAQ
|
|
243
243
|
|
|
244
244
|
**Q: Where is knowledge stored?**
|
|
245
|
-
A: In `.
|
|
245
|
+
A: In `.sce/knowledge/` directory, organized by type.
|
|
246
246
|
|
|
247
247
|
**Q: Can I edit entries manually?**
|
|
248
248
|
A: Yes, they're just Markdown files with YAML frontmatter.
|
|
249
249
|
|
|
250
250
|
**Q: How do I share knowledge with team?**
|
|
251
|
-
A: Commit `.
|
|
251
|
+
A: Commit `.sce/knowledge/` to git (except `.backups/`).
|
|
252
252
|
|
|
253
253
|
**Q: Can I use custom entry types?**
|
|
254
|
-
A: Yes, create custom templates in `.
|
|
254
|
+
A: Yes, create custom templates in `.sce/knowledge/.templates/`.
|
|
255
255
|
|
|
256
256
|
**Q: How do I backup my knowledge?**
|
|
257
257
|
A: Use `sce knowledge export` or commit to git.
|
|
@@ -37,7 +37,7 @@ Keep your workspace synchronized with task progress across multiple users or too
|
|
|
37
37
|
### Prerequisites
|
|
38
38
|
- Project adopted with scene-capability-engine
|
|
39
39
|
- Active spec with tasks.md file
|
|
40
|
-
- Write access to .
|
|
40
|
+
- Write access to .sce/specs/ directory
|
|
41
41
|
|
|
42
42
|
### Step-by-Step Instructions
|
|
43
43
|
|
|
@@ -169,7 +169,7 @@ sce context export my-feature --include-steering --steering-files CORE_PRINCIPLE
|
|
|
169
169
|
#### 3. Locate Export File
|
|
170
170
|
The export is saved to:
|
|
171
171
|
```
|
|
172
|
-
.
|
|
172
|
+
.sce/specs/<spec-name>/context-export.md
|
|
173
173
|
```
|
|
174
174
|
|
|
175
175
|
**Time:** ~5 seconds
|
|
@@ -227,7 +227,7 @@ Generate AI prompts for specific tasks with relevant context.
|
|
|
227
227
|
#### 1. Identify Task
|
|
228
228
|
Review tasks.md and note the task ID:
|
|
229
229
|
```bash
|
|
230
|
-
cat .
|
|
230
|
+
cat .sce/specs/<spec-name>/tasks.md
|
|
231
231
|
```
|
|
232
232
|
|
|
233
233
|
**Example task ID:** `1.2` or `3.1.1`
|
|
@@ -257,7 +257,7 @@ sce prompt generate my-feature 1.2 --target vscode
|
|
|
257
257
|
#### 3. Locate Generated Prompt
|
|
258
258
|
The prompt is saved to:
|
|
259
259
|
```
|
|
260
|
-
.
|
|
260
|
+
.sce/specs/<spec-name>/prompts/task-<task-id>.md
|
|
261
261
|
```
|
|
262
262
|
|
|
263
263
|
**Time:** ~5 seconds
|
|
@@ -70,17 +70,17 @@ Use this command during template iteration before full handoff execution:
|
|
|
70
70
|
sce auto handoff capability-matrix \
|
|
71
71
|
--manifest docs/handoffs/handoff-manifest.json \
|
|
72
72
|
--format markdown \
|
|
73
|
-
--out .
|
|
73
|
+
--out .sce/reports/handoff-capability-matrix.md \
|
|
74
74
|
--fail-on-gap \
|
|
75
75
|
--json
|
|
76
76
|
```
|
|
77
77
|
|
|
78
78
|
`capability-matrix` now checks both capability coverage and semantic completeness (ontology entities/relations + governance business rules/decision logic) by default.
|
|
79
79
|
|
|
80
|
-
When gaps exist, sce writes remediation queue lines (default `.
|
|
80
|
+
When gaps exist, sce writes remediation queue lines (default `.sce/auto/moqui-remediation.lines`) that can be fed directly into:
|
|
81
81
|
|
|
82
82
|
```bash
|
|
83
|
-
sce auto close-loop-batch .
|
|
83
|
+
sce auto close-loop-batch .sce/auto/moqui-remediation.lines --format lines --json
|
|
84
84
|
```
|
|
85
85
|
|
|
86
86
|
## Definition Of Done
|
|
@@ -41,20 +41,20 @@ node scripts/moqui-metadata-extract.js \
|
|
|
41
41
|
|
|
42
42
|
`moqui-metadata-extract` now performs multi-source catalog extraction by default:
|
|
43
43
|
- Moqui XML (`entity/service/screen/form/rule/decision`)
|
|
44
|
-
- `scene-package.json` contracts in `.
|
|
44
|
+
- `scene-package.json` contracts in `.sce/specs/**/docs/`
|
|
45
45
|
- `docs/handoffs/handoff-manifest.json`
|
|
46
46
|
- `docs/handoffs/capability-matrix.md`
|
|
47
47
|
- `docs/handoffs/evidence/**/*.json`
|
|
48
|
-
- `.
|
|
48
|
+
- `.sce/recovery/salvage/**/*.json` (if present)
|
|
49
49
|
|
|
50
50
|
## Step 2: Build Rebuild Bundle
|
|
51
51
|
|
|
52
52
|
```bash
|
|
53
53
|
node scripts/moqui-standard-rebuild.js \
|
|
54
54
|
--metadata docs/moqui/metadata-catalog.json \
|
|
55
|
-
--out .
|
|
56
|
-
--markdown-out .
|
|
57
|
-
--bundle-out .
|
|
55
|
+
--out .sce/reports/recovery/moqui-standard-rebuild.json \
|
|
56
|
+
--markdown-out .sce/reports/recovery/moqui-standard-rebuild.md \
|
|
57
|
+
--bundle-out .sce/reports/recovery/moqui-standard-bundle \
|
|
58
58
|
--json
|
|
59
59
|
```
|
|
60
60
|
|
|
@@ -63,9 +63,9 @@ node scripts/moqui-standard-rebuild.js \
|
|
|
63
63
|
```bash
|
|
64
64
|
node scripts/moqui-rebuild-gate.js \
|
|
65
65
|
--metadata docs/moqui/metadata-catalog.json \
|
|
66
|
-
--out .
|
|
67
|
-
--markdown-out .
|
|
68
|
-
--bundle-out .
|
|
66
|
+
--out .sce/reports/recovery/moqui-standard-rebuild.json \
|
|
67
|
+
--markdown-out .sce/reports/recovery/moqui-standard-rebuild.md \
|
|
68
|
+
--bundle-out .sce/reports/recovery/moqui-standard-bundle
|
|
69
69
|
```
|
|
70
70
|
|
|
71
71
|
Defaults: `ready>=6`, `partial<=0`, `gap<=0`.
|
|
@@ -46,7 +46,7 @@ Default onboarding and safety baselines:
|
|
|
46
46
|
|
|
47
47
|
## Template Capability Matrix Contract
|
|
48
48
|
|
|
49
|
-
Use the baseline report as the canonical matrix contract (`.
|
|
49
|
+
Use the baseline report as the canonical matrix contract (`.sce/reports/moqui-template-baseline.json`):
|
|
50
50
|
|
|
51
51
|
| Matrix Dimension | Meaning | Default Gate Target |
|
|
52
52
|
| --- | --- | --- |
|
|
@@ -88,7 +88,7 @@ sce scene moqui-baseline --json
|
|
|
88
88
|
|
|
89
89
|
# 0.1) CI/release mode: compare against previous baseline and enforce portfolio gate
|
|
90
90
|
sce scene moqui-baseline \
|
|
91
|
-
--compare-with .
|
|
91
|
+
--compare-with .sce/reports/release-evidence/moqui-template-baseline-prev.json \
|
|
92
92
|
--fail-on-portfolio-fail \
|
|
93
93
|
--json
|
|
94
94
|
|
|
@@ -96,14 +96,14 @@ sce scene moqui-baseline \
|
|
|
96
96
|
sce auto handoff capability-matrix \
|
|
97
97
|
--manifest docs/handoffs/handoff-manifest.json \
|
|
98
98
|
--format markdown \
|
|
99
|
-
--out .
|
|
99
|
+
--out .sce/reports/handoff-capability-matrix.md \
|
|
100
100
|
--fail-on-gap \
|
|
101
101
|
--json
|
|
102
102
|
|
|
103
103
|
# 0.3) Capability lexicon audit (expected/provided canonical alignment)
|
|
104
104
|
node scripts/moqui-lexicon-audit.js \
|
|
105
105
|
--manifest docs/handoffs/handoff-manifest.json \
|
|
106
|
-
--template-dir .
|
|
106
|
+
--template-dir .sce/templates/scene-packages \
|
|
107
107
|
--fail-on-gap \
|
|
108
108
|
--json
|
|
109
109
|
|
|
@@ -133,36 +133,36 @@ sce scene package-publish-batch \
|
|
|
133
133
|
sce scene package-publish-batch \
|
|
134
134
|
--manifest docs/handoffs/handoff-manifest.json \
|
|
135
135
|
--dry-run \
|
|
136
|
-
--ontology-report-out .
|
|
136
|
+
--ontology-report-out .sce/reports/scene-package-ontology-batch.json \
|
|
137
137
|
--json
|
|
138
138
|
|
|
139
139
|
# 4) Validate registry + package gate
|
|
140
|
-
sce scene package-registry --template-dir .
|
|
141
|
-
sce scene package-gate-template --out .
|
|
142
|
-
sce scene package-gate --registry .
|
|
140
|
+
sce scene package-registry --template-dir .sce/templates/scene-packages --strict --json
|
|
141
|
+
sce scene package-gate-template --out .sce/templates/scene-package-gate-policy.json --profile three-layer --force --json
|
|
142
|
+
sce scene package-gate --registry .sce/templates/scene-packages/registry.json --policy .sce/templates/scene-package-gate-policy.json --strict --json
|
|
143
143
|
```
|
|
144
144
|
|
|
145
145
|
## Evidence Contract
|
|
146
146
|
|
|
147
147
|
Required artifacts for each intake batch:
|
|
148
148
|
|
|
149
|
-
- `.
|
|
150
|
-
- `.
|
|
151
|
-
- `.
|
|
152
|
-
- `.
|
|
153
|
-
- `.
|
|
154
|
-
- `.
|
|
155
|
-
- `.
|
|
156
|
-
- `.
|
|
157
|
-
- `.
|
|
158
|
-
- `.
|
|
159
|
-
- `.
|
|
160
|
-
- `.
|
|
161
|
-
- `.
|
|
162
|
-
- `.
|
|
163
|
-
- `.
|
|
164
|
-
- `.
|
|
165
|
-
- `.
|
|
149
|
+
- `.sce/reports/moqui-template-baseline.json`
|
|
150
|
+
- `.sce/reports/moqui-template-baseline.md`
|
|
151
|
+
- `.sce/reports/release-evidence/moqui-template-baseline.json`
|
|
152
|
+
- `.sce/reports/release-evidence/moqui-template-baseline.md`
|
|
153
|
+
- `.sce/reports/release-evidence/moqui-capability-coverage.json`
|
|
154
|
+
- `.sce/reports/release-evidence/moqui-capability-coverage.md`
|
|
155
|
+
- `.sce/reports/release-evidence/moqui-lexicon-audit.json`
|
|
156
|
+
- `.sce/reports/release-evidence/moqui-lexicon-audit.md`
|
|
157
|
+
- `.sce/reports/release-evidence/moqui-release-summary.json`
|
|
158
|
+
- `.sce/reports/release-evidence/moqui-release-summary.md`
|
|
159
|
+
- `.sce/reports/release-evidence/weekly-ops-summary.json`
|
|
160
|
+
- `.sce/reports/release-evidence/weekly-ops-summary.md`
|
|
161
|
+
- `.sce/reports/handoff-capability-matrix.md` (or JSON equivalent from `sce auto handoff capability-matrix`)
|
|
162
|
+
- `.sce/reports/handoff-runs/<session>.json`
|
|
163
|
+
- `.sce/reports/scene-package-ontology-batch.json`
|
|
164
|
+
- `.sce/auto/moqui-remediation.lines` (when baseline/coverage gaps exist)
|
|
165
|
+
- `.sce/templates/scene-packages/registry.json`
|
|
166
166
|
- gate output/evidence linked from release notes or handoff summary
|
|
167
167
|
|
|
168
168
|
`moqui-template-baseline.json` summary should be consumed as a matrix gate:
|
|
@@ -191,10 +191,10 @@ If any area is weak, export remediation queue lines and feed back to close-loop:
|
|
|
191
191
|
sce scene package-publish-batch \
|
|
192
192
|
--manifest docs/handoffs/handoff-manifest.json \
|
|
193
193
|
--dry-run \
|
|
194
|
-
--ontology-task-queue-out .
|
|
194
|
+
--ontology-task-queue-out .sce/auto/ontology-remediation.lines \
|
|
195
195
|
--json
|
|
196
196
|
|
|
197
|
-
sce auto close-loop-batch .
|
|
197
|
+
sce auto close-loop-batch .sce/auto/ontology-remediation.lines --format lines --json
|
|
198
198
|
```
|
|
199
199
|
|
|
200
200
|
## Interactive Customization Template Baseline
|
|
@@ -33,7 +33,7 @@ All components are **zero overhead in single-agent mode** — they become no-ops
|
|
|
33
33
|
|
|
34
34
|
### 1. Enable Multi-Agent Mode
|
|
35
35
|
|
|
36
|
-
Create the configuration file `.
|
|
36
|
+
Create the configuration file `.sce/config/multi-agent.json`:
|
|
37
37
|
|
|
38
38
|
```json
|
|
39
39
|
{
|
|
@@ -104,7 +104,7 @@ await registry.deregister(agentId);
|
|
|
104
104
|
│ │ Manager │ Store │ │ │
|
|
105
105
|
├──────────┴──────────┴──────────┴────────────┴────────┤
|
|
106
106
|
│ MultiAgentConfig │
|
|
107
|
-
│ .
|
|
107
|
+
│ .sce/config/multi-agent.json │
|
|
108
108
|
├──────────────────────────────────────────────────────┤
|
|
109
109
|
│ v1.44.0: Spec-Level Steering & Context Sync │
|
|
110
110
|
│ SpecSteering │ SteeringLoader │ ContextSyncManager │
|
|
@@ -121,7 +121,7 @@ await registry.deregister(agentId);
|
|
|
121
121
|
Manages agent lifecycle with heartbeat-based health monitoring.
|
|
122
122
|
|
|
123
123
|
**File**: `lib/collab/agent-registry.js`
|
|
124
|
-
**Storage**: `.
|
|
124
|
+
**Storage**: `.sce/config/agent-registry.json`
|
|
125
125
|
|
|
126
126
|
```javascript
|
|
127
127
|
const { AgentRegistry } = require('scene-capability-engine/lib/collab');
|
|
@@ -154,7 +154,7 @@ await registry.deregister(agentId);
|
|
|
154
154
|
File-based mutual exclusion for task ownership.
|
|
155
155
|
|
|
156
156
|
**File**: `lib/lock/task-lock-manager.js`
|
|
157
|
-
**Lock files**: `.
|
|
157
|
+
**Lock files**: `.sce/specs/{specName}/locks/{taskId}.lock`
|
|
158
158
|
|
|
159
159
|
```javascript
|
|
160
160
|
const { TaskLockManager } = require('scene-capability-engine/lib/lock');
|
|
@@ -218,7 +218,7 @@ await store.unclaimTask(specName, taskId, agentId, username);
|
|
|
218
218
|
|
|
219
219
|
### Steering File Lock
|
|
220
220
|
|
|
221
|
-
Write serialization for steering files (`.
|
|
221
|
+
Write serialization for steering files (`.sce/steering/*.md`).
|
|
222
222
|
|
|
223
223
|
**File**: `lib/lock/steering-file-lock.js`
|
|
224
224
|
|
|
@@ -239,7 +239,7 @@ await steeringLock.releaseLock('CURRENT_CONTEXT.md', lockId);
|
|
|
239
239
|
|
|
240
240
|
// Degraded write (when lock cannot be acquired)
|
|
241
241
|
await steeringLock.writePending('CURRENT_CONTEXT.md', content, agentId);
|
|
242
|
-
// Creates: .
|
|
242
|
+
// Creates: .sce/steering/CURRENT_CONTEXT.md.pending.{agentId}
|
|
243
243
|
```
|
|
244
244
|
|
|
245
245
|
### Merge Coordinator
|
|
@@ -274,7 +274,7 @@ await merger.cleanupBranch(branchName);
|
|
|
274
274
|
When `coordinator: true` in config, provides intelligent task assignment based on dependency analysis.
|
|
275
275
|
|
|
276
276
|
**File**: `lib/collab/coordinator.js`
|
|
277
|
-
**Log**: `.
|
|
277
|
+
**Log**: `.sce/config/coordination-log.json`
|
|
278
278
|
|
|
279
279
|
```javascript
|
|
280
280
|
const { Coordinator } = require('scene-capability-engine/lib/collab');
|
|
@@ -300,7 +300,7 @@ const { specs, agents } = await coordinator.getProgress();
|
|
|
300
300
|
Per-Spec `steering.md` providing independent constraints, notes, and decisions for each Spec. Eliminates cross-agent write conflicts on global steering files.
|
|
301
301
|
|
|
302
302
|
**File**: `lib/steering/spec-steering.js`
|
|
303
|
-
**Storage**: `.
|
|
303
|
+
**Storage**: `.sce/specs/{spec-name}/steering.md`
|
|
304
304
|
|
|
305
305
|
```javascript
|
|
306
306
|
const { SpecSteering } = require('scene-capability-engine/lib/steering');
|
|
@@ -377,7 +377,7 @@ await syncManager.writeContext(newContext);
|
|
|
377
377
|
State machine managing Spec lifecycle transitions with auto-completion detection.
|
|
378
378
|
|
|
379
379
|
**File**: `lib/collab/spec-lifecycle-manager.js`
|
|
380
|
-
**Storage**: `.
|
|
380
|
+
**Storage**: `.sce/specs/{spec-name}/lifecycle.json`
|
|
381
381
|
|
|
382
382
|
Valid transitions: `planned → assigned → in-progress → completed → released`
|
|
383
383
|
|
|
@@ -499,7 +499,7 @@ All components check `MultiAgentConfig.isEnabled()` before doing anything:
|
|
|
499
499
|
|
|
500
500
|
## Configuration Reference
|
|
501
501
|
|
|
502
|
-
### `.
|
|
502
|
+
### `.sce/config/multi-agent.json`
|
|
503
503
|
|
|
504
504
|
```json
|
|
505
505
|
{
|
|
@@ -514,15 +514,15 @@ All components check `MultiAgentConfig.isEnabled()` before doing anything:
|
|
|
514
514
|
|
|
515
515
|
| File | Purpose |
|
|
516
516
|
|------|---------|
|
|
517
|
-
| `.
|
|
518
|
-
| `.
|
|
519
|
-
| `.
|
|
520
|
-
| `.
|
|
521
|
-
| `.
|
|
522
|
-
| `.
|
|
523
|
-
| `.
|
|
524
|
-
| `.
|
|
525
|
-
| `.
|
|
517
|
+
| `.sce/config/multi-agent.json` | Multi-agent configuration |
|
|
518
|
+
| `.sce/config/agent-registry.json` | Active agent registry |
|
|
519
|
+
| `.sce/config/coordination-log.json` | Coordinator assignment log |
|
|
520
|
+
| `.sce/specs/{spec}/locks/{taskId}.lock` | Task lock files |
|
|
521
|
+
| `.sce/specs/{spec}/tasks.md.lock` | tasks.md file lock |
|
|
522
|
+
| `.sce/specs/{spec}/steering.md` | Spec-level steering (L4) |
|
|
523
|
+
| `.sce/specs/{spec}/lifecycle.json` | Spec lifecycle state |
|
|
524
|
+
| `.sce/steering/{file}.lock` | Steering file locks |
|
|
525
|
+
| `.sce/steering/{file}.pending.{agentId}` | Pending steering writes |
|
|
526
526
|
|
|
527
527
|
---
|
|
528
528
|
|