scene-capability-engine 3.6.39 → 3.6.45

package/lib/adoption/detection-engine.js

@@ -31,8 +31,8 @@ class DetectionEngine {
    */
   async analyze(projectPath) {
     try {
-      const kiroPath = path.join(projectPath, this.sceDir);
-      const hasKiroDir = await pathExists(kiroPath);
+      const scePath = path.join(projectPath, this.sceDir);
+      const hasSceDir = await pathExists(scePath);
       
       let hasVersionFile = false;
       let hasSpecs = false;
@@ -41,9 +41,9 @@ class DetectionEngine {
       let existingVersion = null;
       let steeringDetection = null;
       
-      if (hasKiroDir) {
+      if (hasSceDir) {
         // Check for version.json
-        const versionPath = path.join(kiroPath, this.versionFile);
+        const versionPath = path.join(scePath, this.versionFile);
         hasVersionFile = await pathExists(versionPath);
         
         if (hasVersionFile) {
@@ -57,7 +57,7 @@ class DetectionEngine {
         }
         
         // Check for specs/
-        const specsPath = path.join(kiroPath, this.specsDir);
+        const specsPath = path.join(scePath, this.specsDir);
         hasSpecs = await pathExists(specsPath);
         
         // Check for steering/ using SteeringManager
@@ -65,7 +65,7 @@ class DetectionEngine {
         hasSteering = steeringDetection.hasExistingSteering;
         
         // Check for tools/
-        const toolsPath = path.join(kiroPath, this.toolsDir);
+        const toolsPath = path.join(scePath, this.toolsDir);
         hasTools = await pathExists(toolsPath);
       }
       
@@ -73,10 +73,11 @@ class DetectionEngine {
       const projectType = await this.detectProjectType(projectPath);
       
       // Detect conflicts (only if we're going to add template files)
-      const conflicts = hasKiroDir ? await this.detectConflicts(projectPath) : [];
+      const conflicts = hasSceDir ? await this.detectConflicts(projectPath) : [];
       
       return {
-        hasKiroDir,
+        hasSceDir,
+        hasKiroDir: hasSceDir,
         hasVersionFile,
         hasSpecs,
         hasSteering,
@@ -98,8 +99,9 @@ class DetectionEngine {
    * @returns {AdoptionMode} - 'fresh', 'partial', or 'full'
    */
   determineStrategy(result) {
+    const hasSceDir = result && result.hasSceDir !== undefined ? result.hasSceDir : result.hasKiroDir;
     // Fresh adoption: no .sce/ directory
-    if (!result.hasKiroDir) {
+    if (!hasSceDir) {
       return 'fresh';
     }
     
@@ -152,7 +154,7 @@ class DetectionEngine {
     const conflicts = [];
     
     try {
-      const kiroPath = path.join(projectPath, this.sceDir);
+      const scePath = path.join(projectPath, this.sceDir);
       
       // Define template files that might conflict
       const templateFiles = [
@@ -177,7 +179,7 @@ class DetectionEngine {
       ];
       
       for (const templateFile of templateFiles) {
-        const filePath = path.join(kiroPath, templateFile);
+        const filePath = path.join(scePath, templateFile);
         const exists = await pathExists(filePath);
         
         if (exists) {
@@ -249,12 +251,13 @@ class DetectionEngine {
    */
   getSummary(result) {
     const lines = [];
+    const hasSceDir = result && result.hasSceDir !== undefined ? result.hasSceDir : result.hasKiroDir;
     
     lines.push('Project Analysis:');
     lines.push(`  Project Type: ${result.projectType}`);
-    lines.push(`  .sce/ Directory: ${result.hasKiroDir ? 'Yes' : 'No'}`);
+    lines.push(`  .sce/ Directory: ${hasSceDir ? 'Yes' : 'No'}`);
     
-    if (result.hasKiroDir) {
+    if (hasSceDir) {
       lines.push(`  version.json: ${result.hasVersionFile ? 'Yes' : 'No'}`);
       if (result.existingVersion) {
         lines.push(`  Current Version: ${result.existingVersion}`);

package/lib/adoption/smart-orchestrator.js

@@ -317,10 +317,10 @@ class SmartOrchestrator {
 
     } else if (mode === 'smart-adopt' || mode === 'smart-update') {
       // Check which template files exist and differ
-      const kiroPath = path.join(projectPath, '.sce');
+      const scePath = path.join(projectPath, '.sce');
       
       for (const templateFile of templateFiles) {
-        const filePath = path.join(kiroPath, templateFile);
+        const filePath = path.join(scePath, templateFile);
         const fs = require('fs-extra');
         
         if (await fs.pathExists(filePath)) {
@@ -340,7 +340,7 @@ class SmartOrchestrator {
       }
 
       // Always preserve CURRENT_CONTEXT.md if it exists
-      const currentContextPath = path.join(kiroPath, 'steering/CURRENT_CONTEXT.md');
+      const currentContextPath = path.join(scePath, 'steering/CURRENT_CONTEXT.md');
       const fs = require('fs-extra');
       if (await fs.pathExists(currentContextPath)) {
         plan.filesToPreserve.push('steering/CURRENT_CONTEXT.md');

package/lib/adoption/strategy-selector.js

@@ -31,7 +31,11 @@ const AdoptionMode = {
  */
 class ProjectState {
   constructor(data = {}) {
-    this.hasKiroDir = data.hasKiroDir !== undefined ? data.hasKiroDir : false;
+    this.hasSceDir = data.hasSceDir !== undefined
+      ? data.hasSceDir
+      : (data.hasKiroDir !== undefined ? data.hasKiroDir : false);
+    // Backward-compatible alias for older callers/tests.
+    this.hasKiroDir = this.hasSceDir;
     this.hasVersionFile = data.hasVersionFile !== undefined ? data.hasVersionFile : false;
     this.currentVersion = data.currentVersion !== undefined ? data.currentVersion : null;
     this.targetVersion = data.targetVersion !== undefined ? data.targetVersion : null;
@@ -61,22 +65,22 @@ class StrategySelector {
    * @returns {Promise<ProjectState>} - Comprehensive project state
    */
   async detectProjectState(projectPath) {
-    const kiroPath = path.join(projectPath, '.sce');
-    const versionPath = path.join(kiroPath, 'version.json');
-    const specsPath = path.join(kiroPath, 'specs');
-    const steeringPath = path.join(kiroPath, 'steering');
-    const toolsPath = path.join(kiroPath, 'tools');
+    const scePath = path.join(projectPath, '.sce');
+    const versionPath = path.join(scePath, 'version.json');
+    const specsPath = path.join(scePath, 'specs');
+    const steeringPath = path.join(scePath, 'steering');
+    const toolsPath = path.join(scePath, 'tools');
 
     // Get target version from package.json
     const packageJson = require('../../package.json');
     const targetVersion = packageJson.version;
 
     // Check directory existence
-    const hasKiroDir = await this.fs.pathExists(kiroPath);
-    const hasVersionFile = hasKiroDir && await this.fs.pathExists(versionPath);
-    const hasSpecs = hasKiroDir && await this.fs.pathExists(specsPath);
-    const hasSteering = hasKiroDir && await this.fs.pathExists(steeringPath);
-    const hasTools = hasKiroDir && await this.fs.pathExists(toolsPath);
+    const hasSceDir = await this.fs.pathExists(scePath);
+    const hasVersionFile = hasSceDir && await this.fs.pathExists(versionPath);
+    const hasSpecs = hasSceDir && await this.fs.pathExists(specsPath);
+    const hasSteering = hasSceDir && await this.fs.pathExists(steeringPath);
+    const hasTools = hasSceDir && await this.fs.pathExists(toolsPath);
 
     // Read current version if available
     let currentVersion = null;
@@ -103,7 +107,7 @@ class StrategySelector {
 
     // Detect potential conflicts (files that exist and might be overwritten)
     const conflicts = [];
-    if (hasKiroDir) {
+    if (hasSceDir) {
       const templateFiles = [
         'steering/CORE_PRINCIPLES.md',
         'steering/ENVIRONMENT.md',
@@ -116,7 +120,7 @@ class StrategySelector {
       ];
 
       for (const templateFile of templateFiles) {
-        const filePath = path.join(kiroPath, templateFile);
+        const filePath = path.join(scePath, templateFile);
         if (await this.fs.pathExists(filePath)) {
           conflicts.push(templateFile);
         }
@@ -124,7 +128,7 @@ class StrategySelector {
     }
 
     return new ProjectState({
-      hasKiroDir,
+      hasSceDir,
       hasVersionFile,
       currentVersion,
       targetVersion,
@@ -144,7 +148,7 @@ class StrategySelector {
    */
   selectMode(state) {
     // No .sce/ directory - fresh adoption
-    if (!state.hasKiroDir) {
+    if (!state.hasSceDir) {
       return AdoptionMode.FRESH;
     }
 

package/lib/adoption/template-sync.js

@@ -59,7 +59,7 @@ class TemplateSync {
       errors: []        // Files that couldn't be compared
     };
 
-    const kiroPath = path.join(projectPath, '.sce');
+    const scePath = path.join(projectPath, '.sce');
 
     for (const templateFile of this.templateFiles) {
       try {
@@ -72,7 +72,7 @@ class TemplateSync {
           continue;
         }
 
-        const projectFilePath = path.join(kiroPath, templateFile);
+        const projectFilePath = path.join(scePath, templateFile);
         const templateFilePath = path.join(templatePath, templateFile);
 
         // Check if template file exists
@@ -323,7 +323,7 @@ class TemplateSync {
 
     const synced = [];
     const errors = [];
-    const kiroPath = path.join(projectPath, '.sce');
+    const scePath = path.join(projectPath, '.sce');
 
     // Sync missing files
     for (const missing of report.differences.missing) {

package/lib/auto/autonomous-engine.js

@@ -69,25 +69,25 @@ class AutonomousEngine {
     const fs = require('fs-extra');
     
     // Check for .sce directory (接管标志)
-    const kiroDir = path.join(process.cwd(), '.sce');
-    if (!await fs.pathExists(kiroDir)) {
+    const sceDir = path.join(process.cwd(), '.sce');
+    if (!await fs.pathExists(sceDir)) {
       throw new Error('CORE_PRINCIPLES violation: .sce directory not found. Project not adopted by sce.');
     }
     
     // Check for version.json
-    const versionFile = path.join(kiroDir, 'version.json');
+    const versionFile = path.join(sceDir, 'version.json');
     if (!await fs.pathExists(versionFile)) {
       console.warn('Warning: version.json not found. Consider running sce adoption.');
     }
     
     // Check for specs directory
-    const specsDir = path.join(kiroDir, 'specs');
+    const specsDir = path.join(sceDir, 'specs');
     if (!await fs.pathExists(specsDir)) {
       await fs.ensureDir(specsDir);
     }
     
     // Check for steering directory
-    const steeringDir = path.join(kiroDir, 'steering');
+    const steeringDir = path.join(sceDir, 'steering');
     if (!await fs.pathExists(steeringDir)) {
       console.warn('Warning: steering directory not found.');
     }

package/lib/auto/handoff-release-gate-history-loaders-service.js

@@ -426,7 +426,19 @@ async function loadAutoHandoffReleaseGateReports(projectPath, dirCandidate = nul
       warnings.push(`skip invalid release gate payload: ${reportFile}`);
       continue;
     }
-    entries.push(buildAutoHandoffReleaseGateHistoryEntry(payload, { projectPath, file: reportFile, tag: parseAutoHandoffReleaseGateTag(path.basename(reportFile)) }, dependencies));
+    try {
+      entries.push(buildAutoHandoffReleaseGateHistoryEntry(
+        payload,
+        {
+          projectPath,
+          file: reportFile,
+          tag: parseAutoHandoffReleaseGateTag(path.basename(reportFile))
+        },
+        dependencies
+      ));
+    } catch (error) {
+      warnings.push(`skip invalid release gate report entry: ${reportFile} (${error.message})`);
+    }
   }
 
   return {
@@ -459,13 +471,21 @@ async function loadAutoHandoffReleaseGateHistorySeed(projectPath, fileCandidate
     };
   }
   const list = Array.isArray(payload && payload.entries) ? payload.entries : [];
-  const entries = list
+  const warnings = [];
+  const entries = [];
+  list
     .filter(item => item && typeof item === 'object' && !Array.isArray(item))
-    .map(item => buildAutoHandoffReleaseGateHistoryEntry(item, { projectPath }, dependencies));
+    .forEach((item, index) => {
+      try {
+        entries.push(buildAutoHandoffReleaseGateHistoryEntry(item, { projectPath }, dependencies));
+      } catch (error) {
+        warnings.push(`skip invalid gate history entry #${index + 1}: ${error.message}`);
+      }
+    });
   return {
     file: filePath,
     entries,
-    warnings: []
+    warnings
   };
 }
 

package/lib/auto/handoff-run-service.js

@@ -13,6 +13,8 @@ async function runAutoHandoff(projectPath, options = {}, dependencies = {}) {
     loadGovernanceReleaseGateSignals,
     completeAutoHandoffRunPhase,
     evaluateAutoHandoffOntologyGateReasons,
+    auditSpecDeliverySync,
+    evaluateAutoHandoffSpecDeliveryGateReasons,
     evaluateAutoHandoffReleaseGatePreflightGateReasons,
     failAutoHandoffRunPhase,
     buildAutoHandoffMoquiBaselineSnapshot,
@@ -63,6 +65,7 @@ async function runAutoHandoff(projectPath, options = {}, dependencies = {}) {
     observability_snapshot: null,
     spec_status: null,
     ontology_validation: null,
+    spec_delivery_sync: null,
     moqui_baseline: null,
     scene_package_batch: null,
     moqui_capability_coverage: null,
@@ -92,6 +95,9 @@ async function runAutoHandoff(projectPath, options = {}, dependencies = {}) {
       result.ontology_validation = evaluateHandoffOntologyValidation(
         plan && plan.handoff ? plan.handoff.ontology_validation : null
       );
+      result.spec_delivery_sync = await auditSpecDeliverySync(projectPath, {
+        requireManifest: false
+      });
       result.template_diff = await buildAutoHandoffTemplateDiff(projectPath, { manifest: options.manifest });
       result.release_gate_preflight = buildAutoHandoffReleaseGatePreflight(
         await loadGovernanceReleaseGateSignals(projectPath)
@@ -110,6 +116,15 @@ async function runAutoHandoff(projectPath, options = {}, dependencies = {}) {
       completeAutoHandoffRunPhase(precheckPhase, {
         validation: plan.validation,
         phase_count: Array.isArray(plan.phases) ? plan.phases.length : 0,
+        spec_delivery_sync: result.spec_delivery_sync
+          ? {
+            manifest_count: result.spec_delivery_sync.summary
+              ? result.spec_delivery_sync.summary.manifest_count
+              : 0,
+            passed: result.spec_delivery_sync.passed === true,
+            reason: result.spec_delivery_sync.reason || null
+          }
+          : null,
         template_compatibility: result.template_diff.compatibility,
         release_gate_preflight: {
           available: result.release_gate_preflight.available,
@@ -139,6 +154,28 @@ async function runAutoHandoff(projectPath, options = {}, dependencies = {}) {
       if (ontologyGateReasons.length > 0) {
         throw new Error(`handoff ontology validation gate failed: ${ontologyGateReasons.join('; ')}`);
       }
+      const specDeliveryGateReasons = evaluateAutoHandoffSpecDeliveryGateReasons(
+        result.policy,
+        result.spec_delivery_sync
+      );
+      if (specDeliveryGateReasons.length > 0) {
+        throw new Error(`handoff spec delivery sync gate failed: ${specDeliveryGateReasons.join('; ')}`);
+      }
+      if (
+        result.policy.require_spec_delivery_sync !== true &&
+        result.spec_delivery_sync &&
+        result.spec_delivery_sync.reason !== 'no-manifests' &&
+        result.spec_delivery_sync.passed !== true
+      ) {
+        const advisoryReasons = Array.isArray(result.spec_delivery_sync.violations)
+          ? result.spec_delivery_sync.violations
+          : [];
+        if (advisoryReasons.length > 0) {
+          result.warnings.push(
+            `spec delivery sync advisory: ${advisoryReasons.join('; ')}`
+          );
+        }
+      }
       const releaseGatePreflightReasons = evaluateAutoHandoffReleaseGatePreflightGateReasons(
         result.policy,
         result.release_gate_preflight

package/lib/backup/backup-system.js

@@ -40,7 +40,7 @@ class BackupSystem {
    * @param {string} projectPath - Absolute path to project root
    * @returns {string} - Absolute path to .sce directory
    */
-  getKiroDir(projectPath) {
+  getSceDir(projectPath) {
     return path.join(projectPath, '.sce');
   }
 
@@ -74,11 +74,11 @@ class BackupSystem {
     const { type = 'manual' } = options;
     
     try {
-      const kiroDir = this.getKiroDir(projectPath);
+      const sceDir = this.getSceDir(projectPath);
       
       // Check if .sce/ exists
-      const kiroExists = await pathExists(kiroDir);
-      if (!kiroExists) {
+      const sceExists = await pathExists(sceDir);
+      if (!sceExists) {
         throw new Error('.sce/ directory does not exist');
       }
       
@@ -100,7 +100,7 @@ class BackupSystem {
       await ensureDirectory(backupPath);
       
       // Copy .sce/ contents to backup (excluding backups/ itself)
-      const items = await listFiles(kiroDir);
+      const items = await listFiles(sceDir);
       
       for (const item of items) {
         // Skip the backups directory itself
@@ -108,7 +108,7 @@ class BackupSystem {
           continue;
         }
         
-        const sourcePath = path.join(kiroDir, item);
+        const sourcePath = path.join(sceDir, item);
         const destPath = path.join(backupPath, item);
         
         await copyDirectory(sourcePath, destPath, { overwrite: false });
@@ -243,20 +243,20 @@ class BackupSystem {
         throw new Error(`Backup validation failed: ${backupId}`);
       }
       
-      const kiroDir = this.getKiroDir(projectPath);
+      const sceDir = this.getSceDir(projectPath);
       
       // Get list of items to restore (excluding metadata.json)
       const items = await listFiles(backupPath);
       const itemsToRestore = items.filter(item => item !== 'metadata.json');
       
       // Remove existing .sce/ contents (except backups/)
-      const existingItems = await listFiles(kiroDir);
+      const existingItems = await listFiles(sceDir);
       for (const item of existingItems) {
         if (item === this.backupDirName) {
           continue;
         }
         
-        const itemPath = path.join(kiroDir, item);
+        const itemPath = path.join(sceDir, item);
         await remove(itemPath);
       }
       
@@ -264,7 +264,7 @@ class BackupSystem {
       const restoredFiles = [];
       for (const item of itemsToRestore) {
         const sourcePath = path.join(backupPath, item);
-        const destPath = path.join(kiroDir, item);
+        const destPath = path.join(sceDir, item);
         
         await copyDirectory(sourcePath, destPath, { overwrite: true });
         restoredFiles.push(item);

package/lib/collab/collab-manager.js

@@ -125,10 +125,10 @@ class CollaborationManager {
   /**
    * Assign a spec to a SCE instance
    * @param {string} specName - Name of the spec
-   * @param {string} kiroInstance - SCE instance identifier
+   * @param {string} sceInstance - SCE instance identifier
    * @returns {Promise<Object>} Assignment result
    */
-  async assignSpec(specName, kiroInstance) {
+  async assignSpec(specName, sceInstance) {
     const metadata = await this.metadataManager.readMetadata(specName);
     
     if (!metadata) {
@@ -149,17 +149,20 @@ class CollaborationManager {
     // Update assignment
     const updated = await this.metadataManager.atomicUpdate(specName, (meta) => {
       meta.assignment = {
-        kiroInstance,
+        sceInstance,
         assignedAt: new Date().toISOString()
       };
+      if (meta.assignment && Object.prototype.hasOwnProperty.call(meta.assignment, 'kiroInstance')) {
+        delete meta.assignment.kiroInstance;
+      }
       return meta;
     });
 
     return {
       success: true,
       spec: specName,
-      kiroInstance,
-      message: `Assigned '${specName}' to '${kiroInstance}'`
+      sceInstance,
+      message: `Assigned '${specName}' to '${sceInstance}'`
     };
   }
 

package/lib/collab/dependency-manager.js

@@ -25,7 +25,7 @@ class DependencyManager {
       nodes.push({
         id: name,
         status: metadata.status?.current || 'not-started',
-        kiroInstance: metadata.assignment?.sceInstance || null,
+        sceInstance: metadata.assignment?.sceInstance || metadata.assignment?.kiroInstance || null,
         type: metadata.type
       });
 

package/lib/commands/adopt.js

@@ -220,7 +220,7 @@ async function adoptInteractive(projectPath, options) {
       console.log('    - Preserve existing specs/ and steering/');
       console.log('    - Add missing components');
       console.log('    - Create/update version.json');
-      if (detection.hasKiroDir) {
+      if (detection.hasSceDir) {
         console.log('    - Create backup before changes');
       }
     } else if (strategy === 'full') {
@@ -487,7 +487,7 @@ async function adoptInteractive(projectPath, options) {
     
     // 9. Create backup if needed (for non-conflict scenarios)
     let backupId = null;
-    if (detection.hasKiroDir && (strategy === 'partial' || strategy === 'full')) {
+    if (detection.hasSceDir && (strategy === 'partial' || strategy === 'full')) {
       console.log(chalk.blue('📦 Creating backup...'));
       const backupSystem = new BackupSystem();