scene-capability-engine 3.6.32 → 3.6.37

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.
Files changed (111) hide show
  1. package/CHANGELOG.md +109 -11
  2. package/README.md +119 -122
  3. package/README.zh.md +123 -121
  4. package/bin/scene-capability-engine.js +12 -1
  5. package/docs/331-poc-adaptation-roadmap.md +3 -3
  6. package/docs/README.md +21 -32
  7. package/docs/auto-refactor-index.md +384 -0
  8. package/docs/command-reference.md +99 -7
  9. package/docs/faq.md +1 -1
  10. package/docs/interactive-customization/331-poc-sce-integration-checklist.md +3 -3
  11. package/docs/interactive-customization/moqui-interactive-template-playbook.md +4 -4
  12. package/docs/interactive-customization/phase-acceptance-evidence.md +2 -2
  13. package/docs/magicball-adaptation-task-checklist-v1.md +385 -0
  14. package/docs/magicball-app-bundle-sqlite-and-command-draft.md +539 -0
  15. package/docs/magicball-capability-iteration-api.md +2 -0
  16. package/docs/magicball-capability-iteration-ui.md +2 -0
  17. package/docs/magicball-capability-library.md +2 -0
  18. package/docs/magicball-cli-invocation-examples.md +336 -0
  19. package/docs/magicball-frontend-state-and-command-mapping.md +244 -0
  20. package/docs/magicball-integration-doc-index.md +137 -0
  21. package/docs/magicball-integration-issue-tracker.md +218 -0
  22. package/docs/magicball-mode-home-and-ontology-empty-state-playbook.md +249 -0
  23. package/docs/magicball-sce-adaptation-guide.md +203 -0
  24. package/docs/magicball-three-mode-alignment-plan.md +551 -0
  25. package/docs/magicball-ui-surface-checklist.md +126 -0
  26. package/docs/magicball-write-auth-adaptation-guide.md +328 -0
  27. package/docs/moqui-standard-rebuild-guide.md +6 -6
  28. package/docs/moqui-template-core-library-playbook.md +1 -1
  29. package/docs/refactor-completion-roadmap.md +116 -0
  30. package/docs/release-checklist.md +50 -27
  31. package/docs/releases/README.md +1 -0
  32. package/docs/releases/v3.6.37.md +22 -0
  33. package/docs/steering-strategy-guide.md +7 -7
  34. package/docs/troubleshooting.md +1 -1
  35. package/docs/zh/README.md +27 -30
  36. package/docs/zh/refactor-completion-roadmap.md +116 -0
  37. package/docs/zh/release-checklist.md +40 -17
  38. package/docs/zh/releases/README.md +1 -0
  39. package/docs/zh/releases/v3.6.37.md +22 -0
  40. package/lib/app/registry-config.js +73 -0
  41. package/lib/app/registry-sync-service.js +228 -0
  42. package/lib/auto/archive-schema-service.js +276 -0
  43. package/lib/auto/archive-summary.js +60 -0
  44. package/lib/auto/batch-goal-input-service.js +543 -0
  45. package/lib/auto/batch-output.js +201 -0
  46. package/lib/auto/batch-summary-storage-service.js +110 -0
  47. package/lib/auto/close-loop-batch-service.js +116 -0
  48. package/lib/auto/close-loop-controller-service.js +287 -0
  49. package/lib/auto/close-loop-program-service.js +283 -0
  50. package/lib/auto/close-loop-recovery-service.js +191 -0
  51. package/lib/auto/close-loop-session-storage-service.js +50 -0
  52. package/lib/auto/controller-lock-service.js +55 -0
  53. package/lib/auto/controller-output.js +32 -0
  54. package/lib/auto/controller-queue-service.js +127 -0
  55. package/lib/auto/controller-session-storage-service.js +105 -0
  56. package/lib/auto/governance-advisory-service.js +208 -0
  57. package/lib/auto/governance-close-loop-service.js +411 -0
  58. package/lib/auto/governance-maintenance-presenter.js +162 -0
  59. package/lib/auto/governance-maintenance-service.js +112 -0
  60. package/lib/auto/governance-session-presenter.js +70 -0
  61. package/lib/auto/governance-session-storage-service.js +198 -0
  62. package/lib/auto/governance-signals.js +139 -0
  63. package/lib/auto/governance-stats-presenter.js +337 -0
  64. package/lib/auto/governance-stats-service.js +115 -0
  65. package/lib/auto/governance-summary.js +703 -0
  66. package/lib/auto/handoff-capability-matrix-service.js +281 -0
  67. package/lib/auto/handoff-evidence-review-service.js +251 -0
  68. package/lib/auto/handoff-release-evidence-service.js +190 -0
  69. package/lib/auto/handoff-release-gate-history-loaders-service.js +502 -0
  70. package/lib/auto/handoff-release-gate-history-service.js +257 -0
  71. package/lib/auto/handoff-reporting-service.js +1407 -0
  72. package/lib/auto/handoff-run-service.js +486 -0
  73. package/lib/auto/handoff-snapshots-service.js +645 -0
  74. package/lib/auto/observability-service.js +132 -0
  75. package/lib/auto/output-writer.js +34 -0
  76. package/lib/auto/program-auto-remediation-service.js +130 -0
  77. package/lib/auto/program-diagnostics.js +138 -0
  78. package/lib/auto/program-governance-helpers.js +306 -0
  79. package/lib/auto/program-governance-loop-service.js +413 -0
  80. package/lib/auto/program-output.js +106 -0
  81. package/lib/auto/program-summary.js +183 -0
  82. package/lib/auto/recovery-memory-service.js +684 -0
  83. package/lib/auto/recovery-selection-service.js +52 -0
  84. package/lib/auto/retention-policy.js +98 -0
  85. package/lib/auto/session-persistence-service.js +106 -0
  86. package/lib/auto/session-presenter.js +105 -0
  87. package/lib/auto/session-prune-service.js +190 -0
  88. package/lib/auto/session-query-service.js +249 -0
  89. package/lib/auto/spec-protection.js +141 -0
  90. package/lib/commands/adopt.js +4 -4
  91. package/lib/commands/app.js +911 -0
  92. package/lib/commands/assurance.js +212 -0
  93. package/lib/commands/auto.js +1093 -11065
  94. package/lib/commands/mode.js +321 -0
  95. package/lib/commands/ontology.js +415 -0
  96. package/lib/commands/pm.js +422 -0
  97. package/lib/ontology/seed-profiles.js +160 -0
  98. package/lib/spec/bootstrap/context-collector.js +1 -1
  99. package/lib/state/sce-state-store.js +3369 -1200
  100. package/lib/steering/adoption-config.js +2 -2
  101. package/lib/steering/compliance-cache.js +2 -2
  102. package/lib/steering/steering-manager.js +4 -4
  103. package/lib/task/task-claimer.js +1 -2
  104. package/lib/workspace/multi/workspace-context-resolver.js +3 -3
  105. package/lib/workspace/multi/workspace-state-manager.js +0 -164
  106. package/lib/workspace/sce-tracking-audit.js +1 -1
  107. package/lib/workspace/takeover-baseline.js +1 -1
  108. package/package.json +1 -1
  109. package/template/.sce/README.md +1 -1
  110. package/template/.sce/steering/CORE_PRINCIPLES.md +1 -1
  111. package/bin/kse.js +0 -3
@@ -0,0 +1,384 @@
1
+ # Auto Refactor Index
2
+
3
+ ## Goal
4
+
5
+ Reduce `lib/commands/auto.js` by extracting helper, presenter, policy, service, and storage logic into stable modules before final command-layer slimming.
6
+
7
+ ## Extracted Modules
8
+
9
+ 1. `lib/auto/session-metrics.js`
10
+ - `buildStatusCounts`
11
+ - `buildQueueFormatCounts`
12
+ - `buildMasterSpecCounts`
13
+
14
+ 2. `lib/auto/archive-summary.js`
15
+ - `normalizeStatusToken`
16
+ - `isCompletedStatus`
17
+ - `isFailedStatus`
18
+ - `normalizeStatsWindowDays`
19
+ - `filterEntriesByStatus`
20
+ - `filterGovernanceEntriesByResumeMode`
21
+ - `calculatePercent`
22
+
23
+ 3. `lib/auto/retention-policy.js`
24
+ - `normalizeKeep`
25
+ - `normalizeSpecKeep`
26
+ - `normalizeOlderThanDays`
27
+ - `normalizeSpecSessionProtectWindowDays`
28
+ - `normalizeSpecSessionMaxTotal`
29
+ - `normalizeSpecSessionMaxCreated`
30
+ - `normalizeSpecSessionMaxCreatedPerGoal`
31
+ - `normalizeSpecSessionMaxDuplicateGoals`
32
+
33
+ 4. `lib/auto/spec-protection.js`
34
+ - `collectSpecNamesFromBatchSummary`
35
+ - `collectSpecNamesFromCloseLoopSessionPayload`
36
+ - `collectSpecNamesFromBatchSummaryPayload`
37
+ - `createProtectionReasonRecord`
38
+ - `ensureProtectionReasonRecord`
39
+ - `incrementProtectionReason`
40
+ - `buildProtectionRanking`
41
+ - `buildSpecProtectionReasonPayload`
42
+
43
+ 5. `lib/auto/session-presenter.js`
44
+ - `presentCloseLoopSessionList`
45
+ - `presentCloseLoopSessionStats`
46
+ - `presentControllerSessionList`
47
+
48
+ 6. `lib/auto/governance-signals.js`
49
+ - `normalizeHandoffText`
50
+ - `parseAutoHandoffGateBoolean`
51
+ - `normalizeAutoHandoffGateRiskLevel`
52
+ - `toGovernanceReleaseGateNumber`
53
+ - `normalizeGovernanceReleaseGateSnapshot`
54
+ - `normalizeGovernanceWeeklyOpsStopDetail`
55
+
56
+ 7. `lib/auto/governance-session-presenter.js`
57
+ - `presentGovernanceSessionList`
58
+
59
+ 8. `lib/auto/governance-stats-presenter.js`
60
+ - `presentGovernanceSessionStats`
61
+
62
+ 9. `lib/auto/governance-maintenance-presenter.js`
63
+ - `buildAutoGovernanceMaintenancePlan`
64
+ - `summarizeGovernanceMaintenanceExecution`
65
+
66
+ 10. `lib/auto/governance-summary.js`
67
+ - `deriveGovernanceRiskLevel`
68
+ - `buildGovernanceConcerns`
69
+ - `buildGovernanceRecommendations`
70
+
71
+ 11. `lib/auto/program-diagnostics.js`
72
+ - `buildProgramFailureClusters`
73
+ - `buildProgramRemediationActions`
74
+ - `buildProgramDiagnostics`
75
+
76
+ 12. `lib/auto/governance-maintenance-service.js`
77
+ - `runAutoGovernanceMaintenance`
78
+
79
+ 13. `lib/auto/governance-close-loop-service.js`
80
+ - `runAutoGovernanceCloseLoop`
81
+
82
+ 14. `lib/auto/governance-stats-service.js`
83
+ - `buildAutoGovernanceStats`
84
+
85
+ 15. `lib/auto/governance-advisory-service.js`
86
+ - `executeGovernanceAdvisoryRecover`
87
+ - `executeGovernanceAdvisoryControllerResume`
88
+
89
+ 16. `lib/auto/recovery-selection-service.js`
90
+ - `resolveLatestRecoverableBatchSummary`
91
+ - `resolveLatestPendingControllerSession`
92
+
93
+ 17. `lib/auto/close-loop-recovery-service.js`
94
+ - `executeCloseLoopRecoveryCycle`
95
+
96
+ 18. `lib/auto/session-query-service.js`
97
+ - `listCloseLoopSessions`
98
+ - `statsCloseLoopSessions`
99
+ - `listGovernanceCloseLoopSessions`
100
+ - `statsGovernanceCloseLoopSessions`
101
+ - `listCloseLoopControllerSessions`
102
+ - `statsCloseLoopControllerSessions`
103
+
104
+ 19. `lib/auto/session-prune-service.js`
105
+ - `pruneCloseLoopBatchSummarySessions`
106
+ - `pruneCloseLoopControllerSessions`
107
+ - `pruneCloseLoopSessions`
108
+ - `pruneCloseLoopBatchSummarySessionsCli`
109
+ - `pruneCloseLoopControllerSessionsCli`
110
+
111
+ 20. `lib/auto/session-persistence-service.js`
112
+ - `maybePersistCloseLoopControllerSummary`
113
+ - `maybePersistCloseLoopBatchSummary`
114
+
115
+ 21. `lib/auto/governance-session-storage-service.js`
116
+ - `readGovernanceCloseLoopSessionEntries`
117
+ - `loadGovernanceCloseLoopSessionPayload`
118
+ - `persistGovernanceCloseLoopSession`
119
+
120
+ 22. `lib/auto/controller-session-storage-service.js`
121
+ - `readCloseLoopControllerSessionEntries`
122
+ - `loadCloseLoopControllerSessionPayload`
123
+
124
+ 23. `lib/auto/batch-summary-storage-service.js`
125
+ - `getCloseLoopBatchSummaryDir`
126
+ - `readCloseLoopBatchSummaryEntries`
127
+ - `loadCloseLoopBatchSummaryPayload`
128
+
129
+ 24. `lib/auto/close-loop-session-storage-service.js`
130
+ - `getCloseLoopSessionDir`
131
+ - `readCloseLoopSessionEntries`
132
+
133
+ 25. `lib/auto/archive-schema-service.js`
134
+ - `normalizeSchemaScope`
135
+ - `normalizeTargetSchemaVersion`
136
+ - `getAutoArchiveSchemaTargets`
137
+ - `classifyArchiveSchemaCompatibility`
138
+ - `checkAutoArchiveSchema`
139
+ - `migrateAutoArchiveSchema`
140
+
141
+ 26. `lib/auto/controller-queue-service.js`
142
+ - `resolveControllerQueueFile`
143
+ - `resolveControllerQueueFormat`
144
+ - `dedupeControllerGoals`
145
+ - `loadControllerGoalQueue`
146
+ - `writeControllerGoalQueue`
147
+ - `appendControllerGoalArchive`
148
+
149
+ 27. `lib/auto/controller-lock-service.js`
150
+ - `buildControllerLockPayload`
151
+ - `resolveControllerLockFile`
152
+ - `readControllerLockPayload`
153
+ - `writeControllerLockPayload`
154
+ - `isControllerLockStale`
155
+
156
+ 28. `lib/auto/controller-output.js`
157
+ - `printCloseLoopControllerSummary`
158
+
159
+ 29. `lib/auto/close-loop-controller-service.js`
160
+ - `runCloseLoopController`
161
+
162
+ 30. `lib/auto/close-loop-batch-service.js`
163
+ - `executeCloseLoopBatch`
164
+
165
+ 31. `lib/auto/observability-service.js`
166
+ - `buildAutoObservabilitySnapshot`
167
+
168
+ 32. `lib/auto/close-loop-program-service.js`
169
+ - `executeCloseLoopProgramGoal`
170
+
171
+ 33. `lib/auto/program-summary.js`
172
+ - `resolveResultSourceIndex`
173
+ - `getBatchFailureStatusSet`
174
+ - `buildProgramCoordinationSnapshot`
175
+ - `mergeProgramRecoveryIntoProgramSummary`
176
+ - `buildProgramKpiSnapshot`
177
+
178
+ 34. `lib/auto/program-output.js`
179
+ - `maybeWriteProgramKpi`
180
+ - `maybeWriteProgramAudit`
181
+
182
+ 35. `lib/auto/batch-output.js`
183
+ - `printCloseLoopBatchSummary`
184
+
185
+ 36. `lib/auto/program-governance-helpers.js`
186
+ - `normalizeProgramGateFallbackProfile`
187
+ - `normalizeProgramGateFallbackChain`
188
+ - `resolveProgramGateFallbackChain`
189
+ - `resolveProgramGatePolicy`
190
+ - `evaluateProgramConvergenceGate`
191
+ - `buildProgramAnomalyGovernancePatch`
192
+ - `normalizeFailureSignatureFromError`
193
+
194
+ 37. `lib/auto/program-governance-loop-service.js`
195
+ - `hasRecoverableProgramGoals`
196
+ - `applyProgramGovernancePatch`
197
+ - `buildProgramGovernanceReplayGoalsResult`
198
+ - `runProgramGovernanceLoop`
199
+
200
+ 38. `lib/auto/program-auto-remediation-service.js`
201
+ - `applyProgramGateAutoRemediation`
202
+
203
+ 39. `lib/auto/output-writer.js`
204
+ - `maybeWriteOutput`
205
+ - `maybeWriteTextOutput`
206
+
207
+ 40. `lib/auto/handoff-capability-matrix-service.js`
208
+ - `buildAutoHandoffCapabilityMatrixPolicy`
209
+ - `buildAutoHandoffCapabilityMatrixRecommendations`
210
+ - `buildAutoHandoffCapabilityMatrix`
211
+
212
+ 41. `lib/auto/handoff-release-evidence-service.js`
213
+ - `loadAutoHandoffReleaseEvidence`
214
+ - `mergeAutoHandoffRunIntoReleaseEvidence`
215
+ - `writeAutoHandoffRunReport`
216
+
217
+ 42. `lib/auto/handoff-evidence-review-service.js`
218
+ - `buildAutoHandoffEvidenceSnapshot`
219
+ - `buildAutoHandoffEvidenceStatusCounts`
220
+ - `resolveAutoHandoffReleaseDraftContext`
221
+ - `buildAutoHandoffEvidenceReviewReport`
222
+
223
+ 43. `lib/auto/handoff-release-gate-history-service.js`
224
+ - `buildAutoHandoffReleaseGateHistoryIndex`
225
+ - `renderAutoHandoffReleaseGateHistoryMarkdown`
226
+
227
+ 44. `lib/auto/handoff-snapshots-service.js`
228
+ - `buildAutoHandoffMoquiBaselineSnapshot`
229
+ - `buildAutoHandoffScenePackageBatchSnapshot`
230
+ - `buildAutoHandoffCapabilityCoverageSnapshot`
231
+
232
+ 45. `lib/auto/handoff-release-gate-history-loaders-service.js`
233
+ - `buildAutoHandoffReleaseGateHistoryEntry`
234
+ - `loadAutoHandoffReleaseGateReports`
235
+ - `loadAutoHandoffReleaseGateHistorySeed`
236
+ - `mergeAutoHandoffReleaseGateHistoryEntries`
237
+
238
+ 46. `lib/auto/handoff-run-service.js`
239
+ - `runAutoHandoff`
240
+
241
+ 47. `lib/auto/recovery-memory-service.js`
242
+ - `getCloseLoopRecoveryMemoryFile`
243
+ - `loadCloseLoopRecoveryMemory`
244
+ - `normalizeRecoveryMemoryToken`
245
+ - `resolveRecoveryMemoryScope`
246
+ - `resolveGitBranchToken`
247
+ - `buildRecoveryMemorySignature`
248
+ - `getRecoveryActionMemoryKey`
249
+ - `selectRecoveryActionFromMemory`
250
+ - `getRecoveryMemoryEntry`
251
+ - `updateCloseLoopRecoveryMemory`
252
+ - `summarizeRecoveryMemory`
253
+ - `filterRecoveryMemoryByScope`
254
+ - `buildRecoveryMemoryScopeStats`
255
+ - `showCloseLoopRecoveryMemory`
256
+ - `showCloseLoopRecoveryMemoryScopes`
257
+ - `pruneCloseLoopRecoveryMemory`
258
+ - `clearCloseLoopRecoveryMemory`
259
+ - `resolveRecoveryActionSelection`
260
+ - `applyRecoveryActionPatch`
261
+
262
+ 48. `lib/auto/batch-goal-input-service.js`
263
+ - `loadCloseLoopBatchGoals`
264
+ - `buildCloseLoopBatchGoalsFromGoal`
265
+ - `normalizeResumeStrategy`
266
+ - `buildCloseLoopBatchGoalsFromSummaryPayload`
267
+ - `loadCloseLoopBatchGoalsFromSummary`
268
+
269
+ 49. `lib/auto/handoff-reporting-service.js`
270
+ - `buildAutoHandoffRegressionSnapshot`
271
+ - `buildAutoHandoffRegressionComparison`
272
+ - `buildAutoHandoffRegressionWindowTrend`
273
+ - `buildAutoHandoffRegressionAggregates`
274
+ - `buildAutoHandoffRegressionRiskLayers`
275
+ - `buildAutoHandoffRegressionRecommendations`
276
+ - `buildAutoHandoffMoquiCoverageRegressions`
277
+ - `renderAutoHandoffRegressionMarkdown`
278
+ - `renderAutoHandoffEvidenceReviewMarkdown`
279
+ - `renderAutoHandoffReleaseNotesDraft`
280
+ - `buildAutoHandoffRegression`
281
+ - `buildAutoHandoffRegressionReport`
282
+
283
+ ## Validation Coverage
284
+
285
+ Unit tests:
286
+ - `tests/unit/auto/archive-schema-service.test.js`
287
+ - `tests/unit/auto/archive-summary.test.js`
288
+ - `tests/unit/auto/batch-summary-storage-service.test.js`
289
+ - `tests/unit/auto/close-loop-batch-service.test.js`
290
+ - `tests/unit/auto/observability-service.test.js`
291
+ - `tests/unit/auto/close-loop-program-service.test.js`
292
+ - `tests/unit/auto/program-summary.test.js`
293
+ - `tests/unit/auto/program-output.test.js`
294
+ - `tests/unit/auto/batch-output.test.js`
295
+ - `tests/unit/auto/program-governance-helpers.test.js`
296
+ - `tests/unit/auto/program-governance-loop-service.test.js`
297
+ - `tests/unit/auto/program-auto-remediation-service.test.js`
298
+ - `tests/unit/auto/output-writer.test.js`
299
+ - `tests/unit/auto/handoff-capability-matrix-service.test.js`
300
+ - `tests/unit/auto/handoff-release-evidence-service.test.js`
301
+ - `tests/unit/auto/handoff-evidence-review-service.test.js`
302
+ - `tests/unit/auto/handoff-release-gate-history-service.test.js`
303
+ - `tests/unit/auto/handoff-release-gate-history-loaders-service.test.js`
304
+ - `tests/unit/auto/handoff-snapshots-service.test.js`
305
+ - `tests/unit/auto/handoff-run-service.test.js`
306
+ - `tests/unit/auto/close-loop-controller-service.test.js`
307
+ - `tests/unit/auto/close-loop-recovery-service.test.js`
308
+ - `tests/unit/auto/controller-lock-service.test.js`
309
+ - `tests/unit/auto/controller-output.test.js`
310
+ - `tests/unit/auto/controller-queue-service.test.js`
311
+ - `tests/unit/auto/controller-session-storage-service.test.js`
312
+ - `tests/unit/auto/batch-goal-input-service.test.js`
313
+ - `tests/unit/auto/handoff-reporting-service.test.js`
314
+ - `tests/unit/auto/governance-advisory-service.test.js`
315
+ - `tests/unit/auto/governance-close-loop-service.test.js`
316
+ - `tests/unit/auto/governance-maintenance-presenter.test.js`
317
+ - `tests/unit/auto/governance-maintenance-service.test.js`
318
+ - `tests/unit/auto/governance-session-presenter.test.js`
319
+ - `tests/unit/auto/governance-session-storage-service.test.js`
320
+ - `tests/unit/auto/governance-signals.test.js`
321
+ - `tests/unit/auto/governance-stats-presenter.test.js`
322
+ - `tests/unit/auto/governance-stats-service.test.js`
323
+ - `tests/unit/auto/governance-summary.test.js`
324
+ - `tests/unit/auto/program-diagnostics.test.js`
325
+ - `tests/unit/auto/recovery-memory-service.test.js`
326
+ - `tests/unit/auto/recovery-selection-service.test.js`
327
+ - `tests/unit/auto/retention-policy.test.js`
328
+ - `tests/unit/auto/session-metrics.test.js`
329
+ - `tests/unit/auto/session-persistence-service.test.js`
330
+ - `tests/unit/auto/session-presenter.test.js`
331
+ - `tests/unit/auto/session-prune-service.test.js`
332
+ - `tests/unit/auto/session-query-service.test.js`
333
+ - `tests/unit/auto/spec-protection.test.js`
334
+
335
+ Integration guardrails:
336
+ - `tests/integration/auto-close-loop-cli.integration.test.js`
337
+ - `tests/integration/version-cli.integration.test.js`
338
+ - `tests/integration/legacy-migration-guard-cli.integration.test.js`
339
+ - `tests/integration/takeover-baseline-cli.integration.test.js`
340
+
341
+ ## Current Status
342
+
343
+ - Mainline helper, presenter, policy, storage, and governance-service extraction is stable.
344
+ - `runCloseLoopController` now delegates to `lib/auto/close-loop-controller-service.js` through dependency injection from `lib/commands/auto.js`.
345
+ - `executeCloseLoopBatch` now delegates to `lib/auto/close-loop-batch-service.js` through dependency injection from `lib/commands/auto.js`.
346
+ - `buildAutoObservabilitySnapshot` now delegates to `lib/auto/observability-service.js` through dependency injection from `lib/commands/auto.js`.
347
+ - `executeCloseLoopProgramGoal` now delegates to `lib/auto/close-loop-program-service.js` through dependency injection from `lib/commands/auto.js`.
348
+ - Program summary helpers (`KPI`, coordination, recovery merge, failure-source indexing) now delegate to `lib/auto/program-summary.js`.
349
+ - Program KPI/audit output writers now delegate to `lib/auto/program-output.js`.
350
+ - Batch/program/recover summary console presenter now delegates to `lib/auto/batch-output.js`.
351
+ - Program gate policy/fallback evaluation, anomaly patching, and failure-signature normalization now delegate to `lib/auto/program-governance-helpers.js`.
352
+ - Program governance replay/recover orchestration now delegates to `lib/auto/program-governance-loop-service.js`.
353
+ - Program gate auto-remediation and spec-prune side effects now delegate to `lib/auto/program-auto-remediation-service.js`.
354
+ - Shared JSON/text output writers now delegate to `lib/auto/output-writer.js`.
355
+ - Handoff capability matrix policy/recommendation/build flow now delegates to `lib/auto/handoff-capability-matrix-service.js`.
356
+ - Handoff release-evidence load/merge/report flow now delegates to `lib/auto/handoff-release-evidence-service.js`.
357
+ - Handoff evidence snapshot/review-report/draft-context flow now delegates to `lib/auto/handoff-evidence-review-service.js`.
358
+ - Handoff release gate history index/markdown flow now delegates to `lib/auto/handoff-release-gate-history-service.js`.
359
+ - Handoff baseline / scene-batch / capability-coverage snapshots now delegate to `lib/auto/handoff-snapshots-service.js`.
360
+ - Handoff release-gate history entry/report/seed merge loaders now delegate to `lib/auto/handoff-release-gate-history-loaders-service.js`.
361
+ - Handoff run orchestration now delegates to `lib/auto/handoff-run-service.js`.
362
+ - Controller queue, lock, and output helpers are extracted and wired into the controller service and command wrapper.
363
+ - Dead duplicate controller queue helper definitions were removed from `lib/commands/auto.js` after cutover.
364
+ - `lib/commands/auto.js` now keeps `auto-handoff` behavior as dependency-injected command wrappers rather than owning the full orchestration body.
365
+ - Recovery-memory persistence, scope resolution, pruning, and remediation-action selection now delegate to `lib/auto/recovery-memory-service.js`.
366
+ - Batch goal file loading, semantic decomposition, and summary-resume restoration now delegate to `lib/auto/batch-goal-input-service.js`.
367
+ - Handoff regression/evidence markdown rendering and reporting now delegate to `lib/auto/handoff-reporting-service.js`.
368
+
369
+ ## Working Rules
370
+
371
+ - Move one orchestration boundary at a time.
372
+ - Keep `lib/commands/auto.js` behavior stable while extracting logic into pure modules.
373
+ - A boundary is only considered complete after:
374
+ 1. `node --check lib/commands/auto.js`
375
+ 2. targeted `tests/unit/auto/*`
376
+ 3. `tests/integration/auto-close-loop-cli.integration.test.js --runInBand`
377
+ 4. if startup or workspace gating changes, also run:
378
+ - `tests/integration/version-cli.integration.test.js`
379
+ - `tests/integration/legacy-migration-guard-cli.integration.test.js`
380
+ - `tests/integration/takeover-baseline-cli.integration.test.js`
381
+
382
+ ## Stop Condition
383
+
384
+ Do not continue a boundary extraction if it causes broad `auto-close-loop` integration failures. Revert that boundary to the last stable split, then debug from there.
@@ -2,8 +2,8 @@
2
2
 
3
3
  > Quick reference for all `sce` commands
4
4
 
5
- **Version**: 3.5.2
6
- **Last Updated**: 2026-03-04
5
+ **Version**: 3.6.34
6
+ **Last Updated**: 2026-03-08
7
7
 
8
8
  ---
9
9
 
@@ -367,6 +367,98 @@ sce workspace sync
367
367
  sce workspace team
368
368
  ```
369
369
 
370
+ ### App Bundle & MagicBall Mode Projection
371
+
372
+ ```bash
373
+ # List/show/register app bundles
374
+ sce app bundle list --json
375
+ sce app bundle show --app customer-order-demo --json
376
+ sce app bundle register --input bundle.json --json
377
+
378
+ # Configure and sync remote registries
379
+ sce app registry status --json
380
+ sce app registry configure --bundle-index-url <path-or-url> --service-index-url <path-or-url> --json
381
+ sce app registry sync --json
382
+
383
+ # Runtime projection
384
+ sce app runtime show --app customer-order-demo --json
385
+ sce app runtime releases --app customer-order-demo --json
386
+ sce app runtime install --app customer-order-demo --release <release-id> --json
387
+ sce app runtime activate --app customer-order-demo --release <release-id> --json
388
+
389
+ # Engineering projection
390
+ sce app engineering show --app customer-order-demo --json
391
+ sce app engineering attach --app customer-order-demo --repo <repo-url> --branch main --json
392
+ sce app engineering hydrate --app customer-order-demo --json
393
+ sce app engineering activate --app customer-order-demo --json
394
+
395
+ # Three-mode home projections
396
+ sce mode application home --app customer-order-demo --json
397
+ sce mode ontology home --app customer-order-demo --json
398
+ sce mode engineering home --app customer-order-demo --json
399
+ ```
400
+
401
+ ### PM Delivery Data Plane
402
+
403
+ ```bash
404
+ # Requirements
405
+ sce pm requirement list --json
406
+ sce pm requirement show --id REQ-001 --json
407
+ sce pm requirement upsert --input requirement.json --json
408
+
409
+ # Tracking
410
+ sce pm tracking board --json
411
+ sce pm tracking show --id TRK-001 --json
412
+ sce pm tracking upsert --input tracking.json --json
413
+
414
+ # Planning
415
+ sce pm planning board --json
416
+ sce pm planning show --id PLN-001 --json
417
+ sce pm planning upsert --input plan.json --json
418
+
419
+ # Change requests
420
+ sce pm change list --json
421
+ sce pm change show --id CR-001 --json
422
+ sce pm change upsert --input change.json --json
423
+
424
+ # Issues
425
+ sce pm issue board --json
426
+ sce pm issue show --id BUG-001 --json
427
+ sce pm issue upsert --input issue.json --json
428
+ ```
429
+
430
+ ### Ontology Data Plane
431
+
432
+ ```bash
433
+ # ER
434
+ sce ontology er list --json
435
+ sce ontology er show --id Requirement --json
436
+ sce ontology er upsert --input er.json --json
437
+
438
+ # BR
439
+ sce ontology br list --json
440
+ sce ontology br show --id BR-001 --json
441
+ sce ontology br upsert --input br.json --json
442
+
443
+ # DL
444
+ sce ontology dl list --json
445
+ sce ontology dl show --id DL-001 --json
446
+ sce ontology dl upsert --input dl.json --json
447
+
448
+ # Triad summary
449
+ sce ontology triad summary --json
450
+ ```
451
+
452
+ ### Assurance Data Plane
453
+
454
+ ```bash
455
+ # Engineering assurance summaries
456
+ sce assurance resource status --json
457
+ sce assurance logs views --json
458
+ sce assurance backup list --json
459
+ sce assurance config switches --json
460
+ ```
461
+
370
462
  ### Environment Management
371
463
 
372
464
  ```bash
@@ -1482,7 +1574,7 @@ Moqui template library lexicon audit (script-level governance helper):
1482
1574
  - `node scripts/moqui-lexicon-audit.js [--manifest <path>] [--template-dir <path>] [--lexicon <path>] [--out <path>] [--markdown-out <path>] [--fail-on-gap] [--json]`: audit manifest/template capability names against canonical Moqui lexicon; reports unknown aliases and uncovered expected capabilities.
1483
1575
  - Expected capability scope uses `manifest.capabilities` first; when empty, it infers canonical expected capabilities from `manifest.templates` and emits `expected_scope` metadata (`source`, `inferred_*`, `unresolved_templates`).
1484
1576
  - By default, template capability auditing is scoped to `manifest.templates` (when matched), reducing noise from unrelated templates.
1485
- - Template scope matching normalizes `sce.scene--*` / `kse.scene--*` prefixes, so renamed template namespaces still map correctly.
1577
+ - Template scope matching normalizes `sce.scene--*` / `sce.scene--*` prefixes, so renamed template namespaces still map correctly.
1486
1578
 
1487
1579
  Moqui release summary helper (script-level consolidated gate view):
1488
1580
  - `node scripts/moqui-release-summary.js [--evidence <path>] [--baseline <path>] [--lexicon <path>] [--capability-matrix <path>] [--interactive-governance <path>] [--matrix-remediation-plan <path>] [--out <path>] [--markdown-out <path>] [--fail-on-gate-fail] [--json]`: merge handoff release-evidence + baseline + lexicon + capability-matrix + interactive-governance into one Moqui release gate summary (`passed | failed | incomplete`) with executable remediation recommendations.
@@ -2034,10 +2126,10 @@ Release workflow default:
2034
2126
  - Runs interactive flow smoke (`npm run test:interactive-flow-smoke`) in test/release test jobs.
2035
2127
  - Runs interactive governance gate by default (`interactive-governance-report --period weekly --fail-on-alert`) in test and release pipelines.
2036
2128
  - Evaluates matrix regression gate in CI/release with configurable policy:
2037
- - `KSE_MATRIX_REGRESSION_GATE_ENFORCE` (`true|false`, default advisory/disabled)
2038
- - `KSE_MATRIX_REGRESSION_GATE_MAX` (default `0`)
2129
+ - `SCE_MATRIX_REGRESSION_GATE_ENFORCE` (`true|false`, default advisory/disabled)
2130
+ - `SCE_MATRIX_REGRESSION_GATE_MAX` (default `0`)
2039
2131
  - Optional release summary hard-gate:
2040
- - `KSE_MOQUI_RELEASE_SUMMARY_ENFORCE` (`true|false`, default advisory/disabled)
2132
+ - `SCE_MOQUI_RELEASE_SUMMARY_ENFORCE` (`true|false`, default advisory/disabled)
2041
2133
  - Publishes `moqui-template-baseline.json` + `moqui-template-baseline.md` as release assets.
2042
2134
  - Publishes `moqui-release-summary.json` + `moqui-release-summary.md` as release review assets.
2043
2135
  - Publishes `interactive-governance-<tag>.json` + `interactive-governance-<tag>.md` as release evidence assets.
@@ -2046,7 +2138,7 @@ Release workflow default:
2046
2138
  - Evaluates weekly ops risk gate by default (`release-weekly-ops-gate`; default block when `risk > medium` or summary missing).
2047
2139
  - Publishes `release-risk-remediation-<tag>.json|.md|.lines` derived from unified weekly+drift gate signals.
2048
2140
  - Evaluates and publishes release asset integrity audit (`release-asset-integrity-<tag>.json|.md`) before `npm publish`.
2049
- - Enforces baseline portfolio gate by default (`KSE_MOQUI_BASELINE_ENFORCE` defaults to `true` when unset).
2141
+ - Enforces baseline portfolio gate by default (`SCE_MOQUI_BASELINE_ENFORCE` defaults to `true` when unset).
2050
2142
 
2051
2143
  ### Moqui ERP Integration
2052
2144
 
package/docs/faq.md CHANGED
@@ -682,7 +682,7 @@ sce spec bootstrap --name 03-00-ci-cd-pipeline --non-interactive
682
682
  **Ask the community:**
683
683
  - GitHub Discussions: https://github.com/heguangyong/scene-capability-engine/discussions
684
684
  - Discord: [Join our Discord](https://discord.gg/sce)
685
- - Twitter: [@kse_dev](https://twitter.com/kse_dev)
685
+ - Twitter: [@sce_dev](https://twitter.com/sce_dev)
686
686
 
687
687
  **Report issues:**
688
688
  - GitHub Issues: https://github.com/heguangyong/scene-capability-engine/issues
@@ -71,9 +71,9 @@ node scripts/matrix-regression-gate.js \
71
71
 
72
72
  Recommended GitHub Variables:
73
73
 
74
- - `KSE_MATRIX_REGRESSION_GATE_ENFORCE=true`
75
- - `KSE_MATRIX_REGRESSION_GATE_MAX=0`
76
- - `KSE_MOQUI_RELEASE_SUMMARY_ENFORCE=true` (optional hard gate for release summary `failed` state)
74
+ - `SCE_MATRIX_REGRESSION_GATE_ENFORCE=true`
75
+ - `SCE_MATRIX_REGRESSION_GATE_MAX=0`
76
+ - `SCE_MOQUI_RELEASE_SUMMARY_ENFORCE=true` (optional hard gate for release summary `failed` state)
77
77
 
78
78
  Security baseline:
79
79
 
@@ -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
- - `.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`
23
+ - `.sce/templates/scene-packages/sce.scene--moqui-interactive-customization-loop--0.1.0/scene-package.json`
24
+ - `.sce/templates/scene-packages/sce.scene--moqui-interactive-customization-loop--0.1.0/scene.template.yaml`
25
+ - `.sce/templates/scene-packages/sce.scene--moqui-interactive-customization-loop--0.1.0/custom/scene.yaml`
26
+ - `.sce/templates/scene-packages/sce.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
- - `.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`
93
+ - `.sce/templates/scene-packages/sce.scene--moqui-interactive-customization-loop--0.1.0/scene-package.json`
94
+ - `.sce/templates/scene-packages/sce.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`