scene-capability-engine 3.0.7 → 3.1.0

package/lib/orchestrator/orchestration-engine.js

@@ -107,6 +107,8 @@ class OrchestrationEngine extends EventEmitter {
     this._launchBudgetLastHoldSignalAt = 0;
     /** @type {number} last launch-budget hold duration emitted to telemetry (ms) */
     this._launchBudgetLastHoldMs = 0;
+    /** @type {Set<{timer: NodeJS.Timeout|null, resolve: (() => void)|null}>} cancellable sleep waiters */
+    this._pendingSleeps = new Set();
     /** @type {number} fallback wait timeout to avoid indefinite hangs when lifecycle events are missing */
     this._agentWaitTimeoutMs = (DEFAULT_AGENT_WAIT_TIMEOUT_SECONDS * 1000) + AGENT_WAIT_TIMEOUT_GRACE_MS;
     /** @type {() => number} */
@@ -230,6 +232,7 @@ class OrchestrationEngine extends EventEmitter {
    */
   async stop() {
     this._stopped = true;
+    this._cancelPendingSleeps();
 
     if (this._state !== 'running') {
       return;
@@ -520,10 +523,7 @@ class OrchestrationEngine extends EventEmitter {
       this._statusMonitor.updateSpecStatus(specName, 'pending', null, resolvedError);
 
       const retryDelayMs = isRateLimitError
-        ? Math.max(
-          this._calculateRateLimitBackoffMs(retryCount),
-          this._extractRateLimitRetryAfterMs(resolvedError)
-        )
+        ? this._resolveRateLimitRetryDelayMs(resolvedError, retryCount)
         : 0;
       if (retryDelayMs > 0) {
         this._onRateLimitSignal(retryDelayMs);
@@ -1156,16 +1156,73 @@ class OrchestrationEngine extends EventEmitter {
     return Math.max(1, Math.round(cappedBaseDelay * jitterFactor));
   }
 
+  /**
+   * Resolve final retry delay for rate-limit failures.
+   * Uses larger of computed backoff and retry-after hint, then clamps to configured max.
+   *
+   * @param {string} error
+   * @param {number} retryCount
+   * @returns {number}
+   * @private
+   */
+  _resolveRateLimitRetryDelayMs(error, retryCount) {
+    const computedBackoffMs = this._calculateRateLimitBackoffMs(retryCount);
+    const hintedRetryAfterMs = this._extractRateLimitRetryAfterMs(error);
+    const candidateDelayMs = Math.max(computedBackoffMs, hintedRetryAfterMs);
+    const maxDelayMs = this._toPositiveInteger(
+      this._rateLimitBackoffMaxMs,
+      DEFAULT_RATE_LIMIT_BACKOFF_MAX_MS
+    );
+    return Math.max(1, Math.min(candidateDelayMs, maxDelayMs));
+  }
+
   /**
    * @param {number} ms
    * @returns {Promise<void>}
    * @private
    */
   _sleep(ms) {
-    if (!ms || ms <= 0) {
+    if (!ms || ms <= 0 || this._stopped) {
       return Promise.resolve();
     }
-    return new Promise((resolve) => setTimeout(resolve, ms));
+    return new Promise((resolve) => {
+      let settled = false;
+      const entry = { timer: null, resolve: null };
+      entry.resolve = () => {
+        if (settled) {
+          return;
+        }
+        settled = true;
+        if (entry.timer) {
+          clearTimeout(entry.timer);
+        }
+        this._pendingSleeps.delete(entry);
+        resolve();
+      };
+      entry.timer = setTimeout(() => {
+        if (entry.resolve) {
+          entry.resolve();
+        }
+      }, ms);
+      this._pendingSleeps.add(entry);
+    });
+  }
+
+  /**
+   * Cancel all pending sleeps so stop() does not block behind long retry waits.
+   *
+   * @private
+   */
+  _cancelPendingSleeps() {
+    if (!this._pendingSleeps || this._pendingSleeps.size === 0) {
+      return;
+    }
+    for (const entry of Array.from(this._pendingSleeps)) {
+      if (entry && typeof entry.resolve === 'function') {
+        entry.resolve();
+      }
+    }
+    this._pendingSleeps.clear();
   }
 
   /**
@@ -1300,6 +1357,7 @@ class OrchestrationEngine extends EventEmitter {
    * @private
    */
   _reset() {
+    this._cancelPendingSleeps();
     this._runningAgents.clear();
     this._retryCounts.clear();
     this._failedSpecs.clear();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scene-capability-engine",
-  "version": "3.0.7",
+  "version": "3.1.0",
   "description": "SCE (Scene Capability Engine) - A CLI tool and npm package for spec-driven development with AI coding assistants.",
   "main": "index.js",
   "bin": {
@@ -31,6 +31,8 @@
     "test:integration": "npx jest tests/integration",
     "test:properties": "npx jest tests/properties",
     "test:handles": "npx jest --config=jest.config.js --runInBand --detectOpenHandles",
+    "test:interactive-loop-smoke": "node scripts/interactive-loop-smoke.js --json",
+    "test:interactive-flow-smoke": "node scripts/interactive-flow-smoke.js --json",
     "test:skip-audit": "node scripts/check-skip-allowlist.js",
     "test:brand-consistency": "node scripts/check-branding-consistency.js",
     "test:watch": "npx jest --watch",
@@ -38,9 +40,33 @@
     "report:moqui-metadata": "node scripts/moqui-metadata-extract.js --json",
     "report:moqui-rebuild": "node scripts/moqui-standard-rebuild.js --json",
     "gate:moqui-rebuild": "node scripts/moqui-rebuild-gate.js",
+    "gate:matrix-regression": "node scripts/matrix-regression-gate.js --json",
     "report:moqui-baseline": "node scripts/moqui-template-baseline-report.js --json",
+    "report:moqui-summary": "node scripts/moqui-release-summary.js --json",
+    "report:matrix-remediation-queue": "node scripts/moqui-matrix-remediation-queue.js --json",
+    "run:matrix-remediation-phased": "node scripts/moqui-matrix-remediation-phased-runner.js",
+    "run:matrix-remediation-from-baseline": "node scripts/moqui-matrix-remediation-phased-runner.js --baseline .kiro/reports/release-evidence/moqui-template-baseline.json",
+    "run:matrix-remediation-clusters": "node bin/sce.js auto close-loop-batch .kiro/auto/matrix-remediation.capability-clusters.json --format json --batch-parallel 1 --batch-agent-budget 2 --batch-retry-until-complete --json",
+    "run:matrix-remediation-clusters-phased": "node scripts/moqui-matrix-remediation-phased-runner.js --cluster-goals .kiro/auto/matrix-remediation.capability-clusters.json",
+    "gate:interactive-plan": "node scripts/interactive-change-plan-gate.js --plan docs/interactive-customization/change-plan.sample.json --json",
+    "report:interactive-context-bridge": "node scripts/interactive-context-bridge.js --input docs/interactive-customization/moqui-context-provider.sample.json --json",
+    "report:interactive-dialogue-governance": "node scripts/interactive-dialogue-governance.js --goal \"Improve order entry speed without changing payment policy\" --context docs/interactive-customization/page-context.sample.json --json",
+    "report:interactive-intent": "node scripts/interactive-intent-build.js --context docs/interactive-customization/page-context.sample.json --goal \"Must improve order approval speed without changing payment authorization policy\" --user-id demo-user --json",
+    "report:interactive-plan": "node scripts/interactive-plan-build.js --intent .kiro/reports/interactive-change-intent.json --context docs/interactive-customization/page-context.sample.json --json",
+    "report:interactive-runtime-policy": "node scripts/interactive-runtime-policy-evaluate.js --plan docs/interactive-customization/change-plan.sample.json --json",
+    "report:interactive-work-order": "node scripts/interactive-work-order-build.js --plan docs/interactive-customization/change-plan.sample.json --json",
+    "report:interactive-approval-status": "node scripts/interactive-approval-workflow.js --action status --json",
+    "report:interactive-adapter-capabilities": "node scripts/interactive-moqui-adapter.js --action capabilities --json",
+    "run:interactive-loop": "node scripts/interactive-customization-loop.js",
+    "run:interactive-flow": "node scripts/interactive-flow.js",
+    "log:interactive-feedback": "node scripts/interactive-feedback-log.js",
+    "report:interactive-governance": "node scripts/interactive-governance-report.js --period weekly --json",
+    "report:release-ops-weekly": "node scripts/release-ops-weekly-summary.js --json",
+    "gate:release-ops-weekly": "node scripts/release-weekly-ops-gate.js",
+    "gate:release-asset-integrity": "node scripts/release-asset-integrity-check.js",
+    "report:release-risk-remediation": "node scripts/release-risk-remediation-bundle.js --json",
     "report:moqui-core-regression": "node scripts/moqui-core-regression-suite.js --json",
-    "prepublishOnly": "npm run test:full && npm run test:skip-audit && npm run test:brand-consistency",
+    "prepublishOnly": "npm run test:full && npm run test:skip-audit && npm run test:brand-consistency && npm run report:interactive-governance -- --fail-on-alert",
     "publish:manual": "npm publish --access public",
     "install-global": "npm install -g .",
     "uninstall-global": "npm uninstall -g scene-capability-engine"