scene-capability-engine 3.0.1 → 3.0.3

package/lib/orchestrator/bootstrap-prompt-builder.js

@@ -2,10 +2,10 @@
  * Bootstrap Prompt Builder
  *
  * Builds the initial prompt injected into each Codex CLI sub-agent so that it
- * has full context about the target Spec, kse conventions, steering rules, and
+ * has full context about the target Spec, sce conventions, steering rules, and
  * clear task-execution instructions.
  *
- * Requirements: 2.1 (Spec path), 2.2 (kse / steering context),
+ * Requirements: 2.1 (Spec path), 2.2 (sce / steering context),
  *               2.3 (task execution instructions), 2.4 (configurable template)
  */
 

package/lib/orchestrator/orchestration-engine.js

@@ -24,6 +24,8 @@ const DEFAULT_RATE_LIMIT_PARALLEL_FLOOR = 1;
 const DEFAULT_RATE_LIMIT_COOLDOWN_MS = 30000;
 const DEFAULT_RATE_LIMIT_LAUNCH_BUDGET_PER_MINUTE = 12;
 const DEFAULT_RATE_LIMIT_LAUNCH_BUDGET_WINDOW_MS = 60000;
+const DEFAULT_AGENT_WAIT_TIMEOUT_SECONDS = 600;
+const AGENT_WAIT_TIMEOUT_GRACE_MS = 30000;
 const RATE_LIMIT_BACKOFF_JITTER_RATIO = 0.5;
 const RATE_LIMIT_RETRY_AFTER_MAX_MS = 10 * 60 * 1000;
 const RATE_LIMIT_ERROR_PATTERNS = [
@@ -104,6 +106,8 @@ class OrchestrationEngine extends EventEmitter {
     this._launchBudgetLastHoldSignalAt = 0;
     /** @type {number} last launch-budget hold duration emitted to telemetry (ms) */
     this._launchBudgetLastHoldMs = 0;
+    /** @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} */
     this._random = typeof options.random === 'function' ? options.random : Math.random;
     /** @type {() => number} */
@@ -190,6 +194,7 @@ class OrchestrationEngine extends EventEmitter {
       // Get config for maxParallel and maxRetries
       const config = await this._orchestratorConfig.getConfig();
       this._applyRetryPolicyConfig(config);
+      this._agentWaitTimeoutMs = this._resolveAgentWaitTimeoutMs(config);
       const maxParallel = options.maxParallel || config.maxParallel || 3;
       const maxRetries = config.maxRetries || 2;
       this._initializeAdaptiveParallel(maxParallel);
@@ -407,29 +412,46 @@ class OrchestrationEngine extends EventEmitter {
    */
   _waitForAgent(specName, agentId) {
     return new Promise((resolve) => {
+      const fallbackTimeoutMs = this._toPositiveInteger(
+        this._agentWaitTimeoutMs,
+        (DEFAULT_AGENT_WAIT_TIMEOUT_SECONDS * 1000) + AGENT_WAIT_TIMEOUT_GRACE_MS
+      );
+      let settled = false;
+      let fallbackTimer = null;
+
+      const finalize = (payload) => {
+        if (settled) {
+          return;
+        }
+        settled = true;
+        cleanup();
+        resolve(payload);
+      };
+
       const onCompleted = (data) => {
         if (data.agentId === agentId) {
-          cleanup();
-          resolve({ status: 'completed', error: null });
+          finalize({ status: 'completed', error: null });
         }
       };
 
       const onFailed = (data) => {
         if (data.agentId === agentId) {
-          cleanup();
           const error = data.stderr || data.error || `Exit code: ${data.exitCode}`;
-          resolve({ status: 'failed', error });
+          finalize({ status: 'failed', error });
         }
       };
 
       const onTimeout = (data) => {
         if (data.agentId === agentId) {
-          cleanup();
-          resolve({ status: 'timeout', error: `Timeout after ${data.timeoutSeconds}s` });
+          finalize({ status: 'timeout', error: `Timeout after ${data.timeoutSeconds}s` });
         }
       };
 
       const cleanup = () => {
+        if (fallbackTimer) {
+          clearTimeout(fallbackTimer);
+          fallbackTimer = null;
+        }
         this._agentSpawner.removeListener('agent:completed', onCompleted);
         this._agentSpawner.removeListener('agent:failed', onFailed);
         this._agentSpawner.removeListener('agent:timeout', onTimeout);
@@ -438,6 +460,16 @@ class OrchestrationEngine extends EventEmitter {
       this._agentSpawner.on('agent:completed', onCompleted);
       this._agentSpawner.on('agent:failed', onFailed);
       this._agentSpawner.on('agent:timeout', onTimeout);
+
+      fallbackTimer = setTimeout(() => {
+        finalize({
+          status: 'timeout',
+          error: (
+            `Agent wait timeout after ${Math.ceil(fallbackTimeoutMs / 1000)}s for ` +
+            `${specName} (${agentId}) without lifecycle events`
+          ),
+        });
+      }, fallbackTimeoutMs);
     });
   }
 
@@ -689,6 +721,23 @@ class OrchestrationEngine extends EventEmitter {
     );
   }
 
+  /**
+   * Resolve a fallback wait timeout for _waitForAgent.
+   * This protects orchestration from hanging forever if lifecycle events
+   * are unexpectedly missing.
+   *
+   * @param {object} config
+   * @returns {number}
+   * @private
+   */
+  _resolveAgentWaitTimeoutMs(config) {
+    const timeoutSeconds = this._toPositiveInteger(
+      config && config.timeoutSeconds,
+      DEFAULT_AGENT_WAIT_TIMEOUT_SECONDS
+    );
+    return (timeoutSeconds * 1000) + AGENT_WAIT_TIMEOUT_GRACE_MS;
+  }
+
   /**
    * @param {number} maxParallel
    * @private

package/lib/repo/config-manager.js

@@ -58,7 +58,7 @@ class ConfigManager {
     // Check if file exists
     if (!(await this.configExists())) {
       throw new ConfigError(
-        'Configuration file not found. Run "kse repo init" to create it.',
+        'Configuration file not found. Run "sce repo init" to create it.',
         { path: configPath }
       );
     }
@@ -167,7 +167,7 @@ class ConfigManager {
     } else if (!this._isSupportedVersion(version)) {
       errors.push(
         `Unsupported configuration version: ${version}. ` +
-        'Please upgrade to the latest version of kse.'
+        'Please upgrade to the latest version of sce.'
       );
     }
 

package/lib/repo/handlers/init-handler.js

@@ -188,9 +188,9 @@ class InitHandler {
     }
 
     console.log('\nNext steps:');
-    console.log('  • Run "kse repo status" to view repository status');
-    console.log('  • Run "kse repo health" to check repository health');
-    console.log('  • Run "kse repo exec <command>" to execute commands across all repos');
+    console.log('  • Run "sce repo status" to view repository status');
+    console.log('  • Run "sce repo health" to check repository health');
+    console.log('  • Run "sce repo exec <command>" to execute commands across all repos');
   }
 }
 

package/lib/scene-runtime/audit-emitter.js

@@ -1,4 +1,4 @@
-const fs = require('fs-extra');
+const fs = require('fs-extra');
 const path = require('path');
 const crypto = require('crypto');
 
@@ -21,7 +21,7 @@ class AuditEmitter {
       scene_ref: payload.scene_ref || payload.sceneRef || null,
       scene_version: payload.scene_version || payload.sceneVersion || null,
       run_mode: payload.run_mode || payload.runMode || null,
-      actor: payload.actor || 'kse.scene-runtime',
+      actor: payload.actor || 'sce.scene-runtime',
       payload: payload.payload || payload
     };
 

package/lib/scene-runtime/binding-plugin-loader.js

@@ -1,4 +1,4 @@
-const path = require('path');
+const path = require('path');
 const fs = require('fs-extra');
 
 const DEFAULT_BINDING_PLUGIN_DIRS = [

package/lib/scene-runtime/moqui-adapter.js

@@ -246,7 +246,7 @@ function parseEntityRef(parts) {
 }
 
 /**
- * Map Moqui API response to KSE Execution_Result.
+ * Map Moqui API response to sce Execution_Result.
  * @param {Object} moquiResponse - { success, data, meta, error }
  * @param {string} handlerId - Handler identifier (e.g., 'moqui.adapter')
  * @param {string} bindingRef - Original binding ref string
@@ -559,7 +559,7 @@ function createMoquiAdapterHandler(options = {}) {
         requestOptions
       );
 
-      // Map Moqui response to KSE Execution_Result
+      // Map Moqui response to sce Execution_Result
       return mapMoquiResponseToResult(moquiResponse, HANDLER_ID, bindingRef);
     },
 

package/lib/scene-runtime/moqui-extractor.js

@@ -14,8 +14,8 @@ const HEADER_ITEM_SUFFIXES = [
   { header: 'Master', item: 'Detail' }
 ];
 
-const SCENE_API_VERSION = 'kse.scene/v0.2';
-const PACKAGE_API_VERSION = 'kse.scene.package/v0.1';
+const SCENE_API_VERSION = 'sce.scene/v0.2';
+const PACKAGE_API_VERSION = 'sce.scene.package/v0.1';
 
 // ─── YAML Serializer ──────────────────────────────────────────────
 
@@ -1636,7 +1636,7 @@ function generatePackageContract(match) {
     apiVersion: PACKAGE_API_VERSION,
     kind: 'scene-template',
     metadata: {
-      group: 'kse.scene',
+      group: 'sce.scene',
       name: packageName,
       version: '0.1.0',
       summary,

package/lib/scene-runtime/scene-loader.js

@@ -1,4 +1,4 @@
-const fs = require('fs-extra');
+const fs = require('fs-extra');
 const path = require('path');
 const yaml = require('js-yaml');
 
@@ -46,8 +46,8 @@ class SceneLoader {
       return { valid: false, errors: ['manifest must be an object'] };
     }
 
-    if (typeof manifest.apiVersion !== 'string' || !manifest.apiVersion.startsWith('kse.scene/')) {
-      errors.push('apiVersion must start with kse.scene/');
+    if (typeof manifest.apiVersion !== 'string' || !manifest.apiVersion.startsWith('sce.scene/')) {
+      errors.push('apiVersion must start with sce.scene/');
     }
 
     if (manifest.kind !== 'scene') {

package/lib/scene-runtime/scene-template-linter.js

@@ -3,7 +3,7 @@
 // ─── Constants ─────────────────────────────────────────────────────
 
 /** Known binding ref prefixes for validation */
-const KNOWN_BINDING_REF_PREFIXES = ['moqui.', 'spec.erp.', 'kse.scene.'];
+const KNOWN_BINDING_REF_PREFIXES = ['moqui.', 'spec.erp.', 'sce.scene.'];
 
 /** Valid risk levels for governance checks */
 const VALID_RISK_LEVELS = ['low', 'medium', 'high'];

package/lib/scene-runtime/templates/scene-template-erp-query-v0.1.yaml

@@ -1,4 +1,4 @@
-apiVersion: kse.scene/v0.2
+apiVersion: sce.scene/v0.2
 kind: scene
 metadata:
   obj_id: scene.template.erp-order-query

package/lib/scene-runtime/templates/scene-template-hybrid-shadow-v0.1.yaml

@@ -1,4 +1,4 @@
-apiVersion: kse.scene/v0.2
+apiVersion: sce.scene/v0.2
 kind: scene
 metadata:
   obj_id: scene.template.hybrid-pick-shadow

package/lib/spec/multi-spec-orchestrate.js

@@ -62,7 +62,7 @@ async function runMultiSpecViaOrchestrate(options = {}) {
     orchestrate_result: orchestrationResult,
     next_actions: [
       nextActionLabel,
-      'Use kse orchestrate status to inspect live orchestration state.'
+      'Use sce orchestrate status to inspect live orchestration state.'
     ]
   };
 

package/lib/spec-gate/rules/default-rules.js

@@ -77,7 +77,7 @@ function createDefaultRules(projectPath = process.cwd()) {
     },
     {
       id: 'config_consistency',
-      description: 'Verify project-level KSE config baseline exists',
+      description: 'Verify project-level sce config baseline exists',
       async execute() {
         const kiroDir = path.join(projectPath, '.kiro');
         const configDir = path.join(kiroDir, 'config');

package/lib/steering/adoption-config.js

@@ -4,7 +4,7 @@ const path = require('path');
 /**
  * AdoptionConfig - 管理 adoption-config.json 配置文件
  * 
- * 记录项目采用 kse 时的配置选择
+ * 记录项目采用 sce 时的配置选择
  */
 class AdoptionConfig {
   constructor(projectPath) {

package/lib/steering/compliance-auto-fixer.js

@@ -94,7 +94,7 @@ class ComplianceAutoFixer {
     console.log(chalk.blue('Backup location:'));
     console.log(`  ${backupPath}\n`);
     console.log(chalk.blue('To restore from backup:'));
-    console.log(`  kse rollback --backup ${path.basename(backupPath)}\n`);
+    console.log(`  sce rollback --backup ${path.basename(backupPath)}\n`);
 
     return {
       success: true,

package/lib/steering/compliance-cache.js

@@ -6,7 +6,7 @@ const os = require('os');
  * ComplianceCache - Manages version-based check caching
  * 
  * Stores the last successful compliance check version to avoid
- * repeated checks for the same kse version.
+ * repeated checks for the same sce version.
  */
 class ComplianceCache {
   /**
@@ -31,7 +31,7 @@ class ComplianceCache {
   /**
    * Check if cache is valid for current version
    * 
-   * @param {string} currentVersion - Current kse version
+   * @param {string} currentVersion - Current sce version
    * @returns {boolean} True if cache is valid
    */
   isValid(currentVersion) {
@@ -51,7 +51,7 @@ class ComplianceCache {
   /**
    * Update cache with successful check
    * 
-   * @param {string} version - kse version
+   * @param {string} version - sce version
    * @returns {boolean} True if update succeeded
    */
   update(version) {

package/lib/steering/compliance-error-reporter.js

@@ -51,7 +51,7 @@ class ComplianceErrorReporter {
     message += '  • Delete temporary files\n';
 
     message += '\n' + chalk.gray('To bypass this check (not recommended):') + '\n';
-    message += chalk.gray('  kse <command> --skip-steering-check') + '\n';
+    message += chalk.gray('  sce <command> --skip-steering-check') + '\n';
 
     return message;
   }

package/lib/steering/index.js

@@ -14,7 +14,7 @@ const { ContextSyncManager } = require('./context-sync-manager');
  * @param {boolean} options.skip - Skip the check entirely
  * @param {boolean} options.force - Force check even if cache is valid
  * @param {string} options.projectPath - Project root path (defaults to cwd)
- * @param {string} options.version - Current kse version
+ * @param {string} options.version - Current sce version
  * @returns {boolean} True if compliant or check skipped, false otherwise
  */
 async function runSteeringComplianceCheck(options = {}) {

package/lib/steering/steering-manager.js

@@ -69,7 +69,7 @@ class SteeringManager {
    */
   async promptStrategy(detection) {
     if (!detection.hasExistingSteering) {
-      // 没有现有 steering 文件，默认使用 kse
+      // 没有现有 steering 文件，默认使用 sce
       return 'use-kse';
     }
 
@@ -83,8 +83,8 @@ class SteeringManager {
     });
     
     console.log('');
-    console.log('Kiro IDE loads all files in .kiro/steering/, which means you must');
-    console.log('choose between kse steering rules OR your project\'s existing rules.');
+    console.log('AI IDE loads all files in .kiro/steering/, which means you must');
+    console.log('choose between sce steering rules OR your project\'s existing rules.');
     console.log('');
 
     const response = await inquirer.prompt([{
@@ -93,11 +93,11 @@ class SteeringManager {
       message: 'How would you like to proceed?',
       choices: [
         {
-          name: 'Use kse steering (backup existing files) - Recommended for new kse users',
+          name: 'Use sce steering (backup existing files) - Recommended for new sce users',
           value: 'use-kse'
         },
         {
-          name: 'Keep existing steering (skip kse steering) - For projects with custom steering rules',
+          name: 'Keep existing steering (skip sce steering) - For projects with custom steering rules',
           value: 'use-project'
         }
       ]
@@ -162,7 +162,7 @@ class SteeringManager {
   }
 
   /**
-   * 安装 kse steering 文件
+   * 安装 sce steering 文件
    * 
    * @param {string} projectPath - 项目根目录路径
    * @returns {Promise<Object>} 安装结果
@@ -180,7 +180,7 @@ class SteeringManager {
       if (!templateExists) {
         return {
           success: false,
-          error: 'kse steering template directory not found',
+          error: 'sce steering template directory not found',
           filesInstalled: 0
         };
       }

package/lib/task/task-claimer.js

@@ -97,7 +97,8 @@ class TaskClaimer {
       return [];
     }
 
-    const markerHeaderRegex = /^\s*##\s+KSE\s+Status\s+Markers\s*$/i;
+    // Accept both legacy and current section headers to keep existing specs readable.
+    const markerHeaderRegex = /^\s*##\s+(?:(?:sce|kse)\s+)?Status\s+Markers\s*$/i;
     const sectionHeaderRegex = /^\s*##\s+/;
 
     const markerLine = lines.findIndex((line) => markerHeaderRegex.test(String(line || '')));

package/lib/templates/metadata-collector.js

@@ -50,7 +50,7 @@ class MetadataCollector {
     // Version
     metadata.version = await this.promptVersion();
 
-    // KSE version
+    // sce version
     metadata.kse_version = await this.promptKseVersion();
 
     // Timestamps
@@ -211,8 +211,8 @@ class MetadataCollector {
   }
 
   /**
-   * Prompts for KSE version
-   * @returns {Promise<string>} KSE version
+   * Prompts for sce version
+   * @returns {Promise<string>} sce version
    */
   async promptKseVersion() {
     const currentVersion = this.getCurrentKseVersion();
@@ -220,7 +220,7 @@ class MetadataCollector {
       {
         type: 'input',
         name: 'kseVersion',
-        message: 'Minimum KSE version required:',
+        message: 'Minimum sce version required:',
         default: currentVersion
       }
     ]);
@@ -312,8 +312,8 @@ class MetadataCollector {
   }
 
   /**
-   * Gets current KSE version
-   * @returns {string} KSE version
+   * Gets current sce version
+   * @returns {string} sce version
    */
   getCurrentKseVersion() {
     try {

package/lib/templates/template-creator.js

@@ -135,7 +135,7 @@ class TemplateCreator {
       console.log('📖 Next steps:');
       console.log(`   1. Review the template in: ${exportResult.outputDir}`);
       console.log(`   2. Check REVIEW_CHECKLIST.md for items to verify`);
-      console.log(`   3. Test the template: kse spec create test --template ${metadata.name}`);
+      console.log(`   3. Test the template: sce spec create test --template ${metadata.name}`);
       console.log(`   4. Follow SUBMISSION_GUIDE.md to submit to repository`);
       console.log('');
 
@@ -181,7 +181,7 @@ class TemplateCreator {
       // Check for remaining project-specific content (high confidence patterns)
       const projectSpecificPatterns = [
         /\.kiro\/specs\/\d+-\d+-[a-z-]+/g,  // Specific spec paths
-        /kiro-spec-engine/g,  // Project name (unless it's the template itself)
+        /scene-capability-engine/g,  // Project name (unless it's the template itself)
       ];
 
       projectSpecificPatterns.forEach(pattern => {

package/lib/templates/template-exporter.js

@@ -174,7 +174,7 @@ Test your template locally before submitting:
 
 \`\`\`bash
 # Apply the template to create a new Spec
-kse spec create test-spec --template ${metadata.name}
+sce spec create test-spec --template ${metadata.name}
 
 # Verify the generated Spec is correct
 cd .kiro/specs/test-spec
@@ -238,7 +238,7 @@ If you have questions about the submission process, please:
 - Open an issue in the repository
 - Contact the maintainers
 
-Thank you for contributing to the kse template library!
+Thank you for contributing to the sce template library!
 `;
   }
 
@@ -261,7 +261,7 @@ ${metadata.description}
 - **Tags**: ${metadata.tags.join(', ')}
 - **Author**: ${metadata.author}
 - **Version**: ${metadata.version}
-- **Minimum KSE Version**: ${metadata.kse_version}
+- **Minimum SCE Version**: ${metadata.kse_version}
 
 ## Files Included
 
@@ -273,7 +273,7 @@ ${metadata.description}
 
 - [ ] Template files include valid YAML frontmatter
 - [ ] All project-specific content replaced with template variables
-- [ ] Template tested locally with \`kse spec create\`
+- [ ] Template tested locally with \`sce spec create\`
 - [ ] Template follows naming conventions (kebab-case)
 - [ ] Description is clear and concise
 - [ ] Tags are relevant and searchable
@@ -284,7 +284,7 @@ ${metadata.description}
 Tested locally by applying the template:
 
 \`\`\`bash
-kse spec create test-spec --template ${metadata.name}
+sce spec create test-spec --template ${metadata.name}
 \`\`\`
 
 ## Additional Notes
@@ -345,7 +345,7 @@ ${warnings.length > 0 ? `\n### Warnings\n\n${warnings.map(w => `- ⚠️ ${w}`).
 
 ### Testing
 
-- [ ] Template applied successfully with \`kse spec create\`
+- [ ] Template applied successfully with \`sce spec create\`
 - [ ] Variables replaced correctly in generated Spec
 - [ ] Generated Spec is usable and makes sense
 - [ ] No errors during template application
@@ -389,19 +389,19 @@ ${metadata.description}
 ### 1. List Available Templates
 
 \`\`\`bash
-kse templates list
+sce templates list
 \`\`\`
 
 ### 2. View Template Details
 
 \`\`\`bash
-kse templates show ${metadata.category}/${metadata.name}
+sce templates show ${metadata.category}/${metadata.name}
 \`\`\`
 
 ### 3. Create a New Spec from This Template
 
 \`\`\`bash
-kse spec create my-new-feature --template ${metadata.category}/${metadata.name}
+sce spec create my-new-feature --template ${metadata.category}/${metadata.name}
 \`\`\`
 
 This will create a new Spec at \`.kiro/specs/XX-00-my-new-feature/\` with:
@@ -427,7 +427,7 @@ ${metadata.description}
 
 ## Prerequisites
 
-- kse version ${metadata.kse_version} or higher
+- sce version ${metadata.kse_version} or higher
 - Basic understanding of Spec-driven development
 
 ## Tags
@@ -441,7 +441,7 @@ After applying this template, you'll have a complete Spec structure ready to cus
 ## Questions?
 
 If you have questions about using this template:
-- Check the kse documentation
+- Check the sce documentation
 - Review the generated Spec files
 - Open an issue in the scene-capability-engine-templates repository
 `;
@@ -492,7 +492,7 @@ If you have questions about using this template:
 ${validationResult?.valid ? '✅ Template validation passed' : '❌ Template validation failed'}
 
 ---
-Generated by kse templates create-from-spec
+Generated by sce templates create-from-spec
 `;
 
     await fs.writeFile(path.join(outputDir, 'creation.log'), log, 'utf-8');

package/lib/upgrade/migration-engine.js

@@ -92,9 +92,9 @@ class MigrationEngine {
       }
       
       // Verify starting version matches plan
-      if (versionInfo['kse-version'] !== plan.fromVersion) {
+      if (versionInfo['sce-version'] !== plan.fromVersion) {
         throw new Error(
-          `Version mismatch: expected ${plan.fromVersion}, found ${versionInfo['kse-version']}`
+          `Version mismatch: expected ${plan.fromVersion}, found ${versionInfo['sce-version']}`
         );
       }
       
@@ -202,12 +202,12 @@ class MigrationEngine {
           warnings.push(gitignoreResult.message);
         } else if (!gitignoreResult.success) {
           warnings.push(`⚠️  .gitignore fix failed: ${gitignoreResult.message}`);
-          warnings.push('You can fix this manually with: kse doctor --fix-gitignore');
+          warnings.push('You can fix this manually with: sce doctor --fix-gitignore');
         }
       } catch (gitignoreError) {
         // Don't block upgrade on .gitignore fix failure
         warnings.push(`⚠️  .gitignore check failed: ${gitignoreError.message}`);
-        warnings.push('You can fix this manually with: kse doctor --fix-gitignore');
+        warnings.push('You can fix this manually with: sce doctor --fix-gitignore');
       }
       
       return {