kiro-spec-engine 1.33.0 → 1.34.0

package/CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.34.0] - 2026-02-10
+
+### Added
+- **Scene Package Deprecation**: Mark/unmark package versions as deprecated in local registry
+  - `kse scene deprecate --name <pkg> --message <msg>` deprecate all versions
+    - `--version <v>` target specific version
+    - `--undo` remove deprecation marker
+    - `--registry <dir>` custom registry directory
+    - `--json` structured JSON output
+  - Adds `deprecated` field to version entries in `registry-index.json`
+  - `scene install` now prints yellow warning when installing deprecated versions
+  - `scene info` now shows `[DEPRECATED]` marker with message for deprecated versions
+  - Follows normalize → validate → run → print pattern
+  - Implements Spec 84-00-scene-deprecate
+
 ## [1.33.0] - 2026-02-10
 
 ### Added

package/lib/commands/scene.js

@@ -572,6 +572,19 @@ function registerSceneCommands(program) {
     .action(async (options) => {
       await runSceneInfoCommand(options);
     });
+
+  sceneCmd
+    .command('deprecate')
+    .description('Mark or unmark a scene package version as deprecated')
+    .requiredOption('-n, --name <name>', 'Package name')
+    .option('-v, --version <version>', 'Specific version to deprecate')
+    .option('-m, --message <msg>', 'Deprecation message')
+    .option('-r, --registry <path>', 'Registry root directory', '.kiro/registry')
+    .option('--json', 'Print result as JSON')
+    .option('--undo', 'Remove deprecation marker')
+    .action(async (options) => {
+      await runSceneDeprecateCommand(options);
+    });
 }
 
 function normalizeSourceOptions(options = {}) {
@@ -10174,7 +10187,10 @@ async function runSceneInstallCommand(rawOptions = {}, dependencies = {}) {
     }
     const versionEntry = pkg.versions[version];
 
-    // 5. Read tarball from disk
+    // Deprecation warning
+    if (versionEntry.deprecated) {
+      console.log(chalk.yellow(`WARNING: ${options.name}@${version} is deprecated: ${versionEntry.deprecated}`));
+    }
     const tarballRelativePath = buildRegistryTarballPath(options.name, version);
     const tarballAbsolutePath = path.join(registryRoot, tarballRelativePath);
     const tarballBuffer = await readFile(tarballAbsolutePath);
@@ -10834,7 +10850,11 @@ function printSceneInfoSummary(options, payload, projectRoot = process.cwd()) {
   console.log('');
   console.log('  ' + 'VERSION'.padEnd(14) + 'PUBLISHED'.padEnd(26) + 'INTEGRITY');
   for (const v of payload.versions) {
-    console.log('  ' + v.version.padEnd(14) + (v.publishedAt || '').padEnd(26) + (v.integrity || ''));
+    let line = '  ' + v.version.padEnd(14) + (v.publishedAt || '').padEnd(26) + (v.integrity || '');
+    if (v.deprecated) {
+      line += ' ' + chalk.yellow(`[DEPRECATED: ${v.deprecated}]`);
+    }
+    console.log(line);
   }
 }
 
@@ -10868,7 +10888,8 @@ async function runSceneInfoCommand(rawOptions = {}, dependencies = {}) {
     const versions = sortedVersions.map(v => ({
       version: v,
       publishedAt: (pkg.versions[v] && pkg.versions[v].published_at) || '',
-      integrity: (pkg.versions[v] && pkg.versions[v].integrity) || ''
+      integrity: (pkg.versions[v] && pkg.versions[v].integrity) || '',
+      deprecated: (pkg.versions[v] && pkg.versions[v].deprecated) || undefined
     }));
 
     const payload = {
@@ -10890,6 +10911,116 @@ async function runSceneInfoCommand(rawOptions = {}, dependencies = {}) {
   }
 }
 
+function normalizeSceneDeprecateOptions(options = {}) {
+  return {
+    name: options.name ? String(options.name).trim() : undefined,
+    version: options.version ? String(options.version).trim() : undefined,
+    message: options.message ? String(options.message).trim() : undefined,
+    registry: options.registry ? String(options.registry).trim() : '.kiro/registry',
+    json: options.json === true,
+    undo: options.undo === true
+  };
+}
+
+function validateSceneDeprecateOptions(options) {
+  if (!options.name) return '--name is required';
+  if (!options.undo && !options.message) return '--message is required (unless --undo is used)';
+  return null;
+}
+
+function printSceneDeprecateSummary(options, payload) {
+  if (options.json) {
+    console.log(JSON.stringify(payload, null, 2));
+    return;
+  }
+
+  const actionLabel = payload.action === 'undeprecate'
+    ? chalk.green('un-deprecated')
+    : chalk.yellow('deprecated');
+
+  console.log(chalk.blue('Scene Package Deprecate'));
+  console.log(`  Package: ${payload.package}`);
+  console.log(`  Action:  ${actionLabel}`);
+  console.log(`  Versions affected: ${payload.versions.length}`);
+  if (payload.message) {
+    console.log(`  Message: ${payload.message}`);
+  }
+  if (payload.versions.length > 0) {
+    for (const v of payload.versions) {
+      console.log(`    - ${v}`);
+    }
+  }
+}
+
+async function runSceneDeprecateCommand(rawOptions = {}, dependencies = {}) {
+  const projectRoot = dependencies.projectRoot || process.cwd();
+  const fileSystem = dependencies.fileSystem || fs;
+
+  const options = normalizeSceneDeprecateOptions(rawOptions);
+  const validationError = validateSceneDeprecateOptions(options);
+
+  if (validationError) {
+    console.error(chalk.red(`Scene deprecate failed: ${validationError}`));
+    process.exitCode = 1;
+    return null;
+  }
+
+  try {
+    const registryRoot = path.isAbsolute(options.registry)
+      ? options.registry
+      : path.join(projectRoot, options.registry);
+
+    const index = await loadRegistryIndex(registryRoot, fileSystem);
+
+    if (!index.packages || !index.packages[options.name]) {
+      throw new Error(`package "${options.name}" not found in registry`);
+    }
+
+    const pkg = index.packages[options.name];
+    const versions = pkg.versions || {};
+    const affectedVersions = [];
+
+    if (options.version) {
+      if (!versions[options.version]) {
+        throw new Error(`version "${options.version}" not found for package "${options.name}"`);
+      }
+      if (options.undo) {
+        delete versions[options.version].deprecated;
+      } else {
+        versions[options.version].deprecated = options.message;
+      }
+      affectedVersions.push(options.version);
+    } else {
+      for (const v of Object.keys(versions)) {
+        if (options.undo) {
+          delete versions[v].deprecated;
+        } else {
+          versions[v].deprecated = options.message;
+        }
+        affectedVersions.push(v);
+      }
+    }
+
+    await saveRegistryIndex(registryRoot, index, fileSystem);
+
+    const payload = {
+      success: true,
+      action: options.undo ? 'undeprecate' : 'deprecate',
+      package: options.name,
+      versions: affectedVersions,
+      message: options.undo ? null : options.message,
+      registry: options.registry
+    };
+
+    printSceneDeprecateSummary(options, payload);
+    return payload;
+  } catch (error) {
+    console.error(chalk.red('Scene deprecate failed:'), error.message);
+    process.exitCode = 1;
+    return null;
+  }
+}
+
 module.exports = {
   RUN_MODES,
   SCAFFOLD_TYPES,
@@ -11056,5 +11187,9 @@ module.exports = {
   validateSceneInfoOptions,
   runSceneInfoCommand,
   printSceneInfoSummary,
-  validateScenePackageDirectory
+  validateScenePackageDirectory,
+  normalizeSceneDeprecateOptions,
+  validateSceneDeprecateOptions,
+  runSceneDeprecateCommand,
+  printSceneDeprecateSummary
 };

package/package.json

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