kiro-spec-engine 1.29.0 → 1.30.0

package/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.30.0] - 2026-02-10
+
+### Added
+- **Scene Version Bump**: Bump version in scene-package.json following semver
+  - `kse scene version --bump <major|minor|patch|x.y.z>` bump scene package version
+    - `--package <dir>` scene package directory (default: current directory)
+    - `--dry-run` preview without writing
+    - `--json` structured JSON output
+  - Supports major, minor, patch increments and explicit semver strings
+  - Validates explicit version is greater than current version
+  - Follows normalize → validate → run → print pattern
+  - Implements Spec 80-00-scene-version-bump
+
 ## [1.29.0] - 2026-02-10
 
 ### Added

package/lib/commands/scene.js

@@ -536,6 +536,17 @@ function registerSceneCommands(program) {
     .action(async (options) => {
       await runSceneSearchCommand(options);
     });
+
+  sceneCmd
+    .command('version')
+    .description('Bump the version in a scene-package.json file')
+    .option('-p, --package <dir>', 'Scene package directory', '.')
+    .requiredOption('-b, --bump <type>', 'Bump type: major, minor, patch, or explicit semver')
+    .option('--json', 'Print result as JSON')
+    .option('--dry-run', 'Show what would change without writing')
+    .action(async (options) => {
+      await runSceneVersionCommand(options);
+    });
 }
 
 function normalizeSourceOptions(options = {}) {
@@ -10318,6 +10329,112 @@ async function runSceneUnpublishCommand(rawOptions = {}, dependencies = {}) {
   }
 }
 
+function normalizeSceneVersionOptions(options = {}) {
+  return {
+    package: options.package ? String(options.package).trim() : '.',
+    bump: options.bump ? String(options.bump).trim().toLowerCase() : undefined,
+    dryRun: options.dryRun === true,
+    json: options.json === true
+  };
+}
+
+function validateSceneVersionOptions(options) {
+  if (!options.bump) {
+    return '--bump is required (major, minor, patch, or explicit semver)';
+  }
+  const validTypes = ['major', 'minor', 'patch'];
+  if (!validTypes.includes(options.bump) && !semver.valid(options.bump)) {
+    return `--bump "${options.bump}" is not a valid bump type or semver version`;
+  }
+  return null;
+}
+
+function printSceneVersionSummary(options, payload, projectRoot = process.cwd()) {
+  if (options.json) {
+    console.log(JSON.stringify(payload, null, 2));
+    return;
+  }
+  const dryRunLabel = payload.dryRun ? chalk.yellow(' [dry-run]') : '';
+  console.log(chalk.blue('Scene Version Bump') + dryRunLabel);
+  console.log(`  Package: ${payload.name}`);
+  console.log(`  Version: ${payload.oldVersion} → ${payload.newVersion}`);
+  console.log(`  Directory: ${chalk.gray(payload.packageDir)}`);
+}
+
+async function runSceneVersionCommand(rawOptions = {}, dependencies = {}) {
+  const projectRoot = dependencies.projectRoot || process.cwd();
+  const fileSystem = dependencies.fileSystem || fs;
+
+  const options = normalizeSceneVersionOptions(rawOptions);
+  const validationError = validateSceneVersionOptions(options);
+  if (validationError) {
+    console.error(chalk.red(`Scene version bump failed: ${validationError}`));
+    process.exitCode = 1;
+    return null;
+  }
+
+  try {
+    const packageDir = path.isAbsolute(options.package)
+      ? options.package
+      : path.join(projectRoot, options.package);
+
+    const packageJsonPath = path.join(packageDir, 'scene-package.json');
+    const readJson = typeof fileSystem.readJson === 'function'
+      ? fileSystem.readJson.bind(fileSystem) : fs.readJson.bind(fs);
+
+    let packageData;
+    try {
+      packageData = await readJson(packageJsonPath);
+    } catch (err) {
+      throw new Error(`failed to read scene-package.json: ${err.message}`);
+    }
+
+    const metadata = packageData && typeof packageData.metadata === 'object'
+      ? packageData.metadata : null;
+    const currentVersion = metadata ? String(metadata.version || '').trim() : '';
+    if (!currentVersion || !semver.valid(currentVersion)) {
+      throw new Error(`invalid or missing metadata.version: "${currentVersion}"`);
+    }
+
+    const validTypes = ['major', 'minor', 'patch'];
+    let newVersion;
+    if (validTypes.includes(options.bump)) {
+      newVersion = semver.inc(currentVersion, options.bump);
+    } else {
+      if (!semver.gt(options.bump, currentVersion)) {
+        throw new Error(
+          `explicit version "${options.bump}" must be greater than current "${currentVersion}"`
+        );
+      }
+      newVersion = options.bump;
+    }
+
+    if (!options.dryRun) {
+      const writeJson = typeof fileSystem.writeJson === 'function'
+        ? fileSystem.writeJson.bind(fileSystem) : fs.writeJson.bind(fs);
+      packageData.metadata.version = newVersion;
+      await writeJson(packageJsonPath, packageData, { spaces: 2 });
+    }
+
+    const name = (metadata && metadata.name) || '';
+    const payload = {
+      success: true,
+      name,
+      oldVersion: currentVersion,
+      newVersion,
+      packageDir: formatScenePackagePath(projectRoot, packageDir),
+      dryRun: options.dryRun
+    };
+
+    printSceneVersionSummary(options, payload, projectRoot);
+    return payload;
+  } catch (error) {
+    console.error(chalk.red('Scene version bump failed:'), error.message);
+    process.exitCode = 1;
+    return null;
+  }
+}
+
 module.exports = {
   RUN_MODES,
   SCAFFOLD_TYPES,
@@ -10470,5 +10587,9 @@ module.exports = {
   normalizeSceneSearchOptions,
   validateSceneSearchOptions,
   runSceneSearchCommand,
-  printSceneSearchSummary
+  printSceneSearchSummary,
+  normalizeSceneVersionOptions,
+  validateSceneVersionOptions,
+  runSceneVersionCommand,
+  printSceneVersionSummary
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kiro-spec-engine",
-  "version": "1.29.0",
+  "version": "1.30.0",
   "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": {