kiro-spec-engine 1.45.2 → 1.45.4

package/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.45.4] - 2026-02-13
+
+### Fixed
+- **Version upgrade path fallback**: `checkCompatibility()` and `calculateUpgradePath()` now use semver-based logic for versions not in the legacy compatibility matrix, fixing `Unknown source version: 1.45.2` error when running `kse upgrade`
+
+## [1.45.3] - 2026-02-13
+
+### Fixed
+- **Self-dependency removed**: Removed erroneous `kiro-spec-engine` self-dependency from `package.json` that caused npm to install stale old versions inside the package, resulting in `error: unknown command 'orchestrate'` and other missing commands in target projects
+
 ## [1.45.2] - 2026-02-13
 
 ### Fixed

package/lib/version/version-manager.js

@@ -175,11 +175,40 @@ class VersionManager {
       };
     }
     
-    // Check compatibility matrix
+    // Check compatibility matrix first
     const fromInfo = COMPATIBILITY_MATRIX[fromVersion];
     
-    if (!fromInfo) {
-      // Unknown version - assume incompatible
+    if (fromInfo) {
+      const isCompatible = fromInfo.compatible.includes(toVersion);
+      return {
+        compatible: isCompatible,
+        breaking: !isCompatible || fromInfo.breaking,
+        migration: !isCompatible ? 'required' : 'none'
+      };
+    }
+    
+    // Fallback: semver-based compatibility for versions not in matrix
+    try {
+      const fromMajor = semver.major(fromVersion);
+      const toMajor = semver.major(toVersion);
+      
+      if (fromMajor === toMajor) {
+        // Same major version — compatible, non-breaking
+        return {
+          compatible: true,
+          breaking: false,
+          migration: 'none'
+        };
+      }
+      
+      // Different major version — breaking change
+      return {
+        compatible: false,
+        breaking: true,
+        migration: 'required'
+      };
+    } catch (error) {
+      // Invalid semver — assume incompatible
       return {
         compatible: false,
         breaking: true,
@@ -187,14 +216,6 @@ class VersionManager {
         message: `Unknown source version: ${fromVersion}`
       };
     }
-    
-    const isCompatible = fromInfo.compatible.includes(toVersion);
-    
-    return {
-      compatible: isCompatible,
-      breaking: !isCompatible || fromInfo.breaking,
-      migration: !isCompatible ? 'required' : 'none'
-    };
   }
 
   /**
@@ -224,20 +245,39 @@ class VersionManager {
     const fromIndex = allVersions.indexOf(fromVersion);
     const toIndex = allVersions.indexOf(toVersion);
     
-    if (fromIndex === -1) {
-      throw new Error(`Unknown source version: ${fromVersion}`);
-    }
-    
-    if (toIndex === -1) {
-      throw new Error(`Unknown target version: ${toVersion}`);
+    // If both versions are in the matrix, use the matrix path
+    if (fromIndex !== -1 && toIndex !== -1) {
+      if (fromIndex > toIndex) {
+        throw new Error('Cannot downgrade versions');
+      }
+      return allVersions.slice(fromIndex, toIndex + 1);
     }
     
-    if (fromIndex > toIndex) {
-      throw new Error('Cannot downgrade versions');
+    // Fallback: semver-based direct upgrade for versions not in matrix
+    try {
+      const from = semver.valid(fromVersion);
+      const to = semver.valid(toVersion);
+      
+      if (!from) {
+        throw new Error(`Unknown source version: ${fromVersion}`);
+      }
+      if (!to) {
+        throw new Error(`Unknown target version: ${toVersion}`);
+      }
+      
+      if (semver.gt(fromVersion, toVersion)) {
+        throw new Error('Cannot downgrade versions');
+      }
+      
+      // Direct upgrade path
+      return [fromVersion, toVersion];
+    } catch (error) {
+      // Re-throw our own errors
+      if (error.message.includes('Unknown') || error.message.includes('downgrade')) {
+        throw error;
+      }
+      throw new Error(`Unknown source version: ${fromVersion}`);
     }
-    
-    // Return all versions from source to target (inclusive)
-    return allVersions.slice(fromIndex, toIndex + 1);
   }
 
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kiro-spec-engine",
-  "version": "1.45.2",
+  "version": "1.45.4",
   "description": "kiro-spec-engine (kse) - A CLI tool and npm package for spec-driven development with AI coding assistants. NOT the Kiro IDE desktop application.",
   "main": "index.js",
   "bin": {
@@ -74,7 +74,6 @@
     "fs-extra": "^10.0.0",
     "inquirer": "^8.2.0",
     "js-yaml": "^4.1.1",
-    "kiro-spec-engine": "^1.7.0",
     "minimatch": "^10.1.1",
     "path": "^0.12.7",
     "semver": "^7.5.4",