kiro-spec-engine 1.28.0 → 1.29.0

package/CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.29.0] - 2026-02-10
+
+### Added
+- **Scene Registry Query**: List and search scene packages in local registry
+  - `kse scene list` list all packages in registry
+    - `--registry <dir>` custom registry directory
+    - `--json` structured JSON output
+  - `kse scene search --query <term>` search packages by keyword
+    - Case-insensitive substring matching on name, description, and group
+    - `--registry <dir>` custom registry directory
+    - `--json` structured JSON output
+  - Shared helpers: `buildRegistryPackageList`, `filterRegistryPackages`
+  - Follows normalize → validate → run → print pattern
+  - Implements Spec 79-00-scene-registry-query
+
 ## [1.28.0] - 2026-02-10
 
 ### Added

package/lib/commands/scene.js

@@ -517,6 +517,25 @@ function registerSceneCommands(program) {
     .action(async (options) => {
       await runSceneInstallCommand(options);
     });
+
+  sceneCmd
+    .command('list')
+    .description('List all packages in the local scene registry')
+    .option('-r, --registry <path>', 'Registry root directory', '.kiro/registry')
+    .option('--json', 'Print result as JSON')
+    .action(async (options) => {
+      await runSceneListCommand(options);
+    });
+
+  sceneCmd
+    .command('search')
+    .description('Search packages in the local scene registry')
+    .requiredOption('-q, --query <term>', 'Search term (substring match on name, description, group)')
+    .option('-r, --registry <path>', 'Registry root directory', '.kiro/registry')
+    .option('--json', 'Print result as JSON')
+    .action(async (options) => {
+      await runSceneSearchCommand(options);
+    });
 }
 
 function normalizeSourceOptions(options = {}) {
@@ -10062,6 +10081,157 @@ async function runSceneInstallCommand(rawOptions = {}, dependencies = {}) {
   }
 }
 
+// --- Scene Registry Query Helpers ---
+
+function buildRegistryPackageList(registryPackages) {
+  return Object.values(registryPackages || {})
+    .map(pkg => ({
+      name: pkg.name || '',
+      group: pkg.group || '',
+      description: pkg.description || '',
+      latest: pkg.latest || '',
+      version_count: Object.keys(pkg.versions || {}).length
+    }))
+    .sort((a, b) => a.name.localeCompare(b.name));
+}
+
+function filterRegistryPackages(packageList, query) {
+  if (!query) return packageList;
+  const lowerQuery = query.toLowerCase();
+  return packageList.filter(pkg =>
+    pkg.name.toLowerCase().includes(lowerQuery) ||
+    pkg.description.toLowerCase().includes(lowerQuery) ||
+    pkg.group.toLowerCase().includes(lowerQuery)
+  );
+}
+
+// --- Scene List Command ---
+
+function normalizeSceneListOptions(options = {}) {
+  return {
+    registry: options.registry ? String(options.registry).trim() : '.kiro/registry',
+    json: options.json === true
+  };
+}
+
+function validateSceneListOptions(options) {
+  return null;
+}
+
+async function runSceneListCommand(rawOptions = {}, dependencies = {}) {
+  const projectRoot = dependencies.projectRoot || process.cwd();
+  const fileSystem = dependencies.fileSystem || fs;
+
+  const options = normalizeSceneListOptions(rawOptions);
+  const validationError = validateSceneListOptions(options);
+
+  if (validationError) {
+    console.error(chalk.red(`Scene list 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);
+    const packages = buildRegistryPackageList(index.packages);
+    const payload = { packages, total: packages.length };
+
+    printSceneListSummary(options, payload, projectRoot);
+    return payload;
+  } catch (error) {
+    console.error(chalk.red('Scene list failed:'), error.message);
+    process.exitCode = 1;
+    return null;
+  }
+}
+
+function printSceneListSummary(options, payload, projectRoot = process.cwd()) {
+  if (options.json) {
+    console.log(JSON.stringify(payload, null, 2));
+    return;
+  }
+
+  if (payload.total === 0) {
+    console.log('No packages found');
+    return;
+  }
+
+  console.log(chalk.blue(`Scene Registry (${payload.total} package${payload.total !== 1 ? 's' : ''})`));
+  for (const pkg of payload.packages) {
+    console.log(`  ${pkg.name.padEnd(20)} ${pkg.latest.padEnd(10)} ${String(pkg.version_count).padEnd(10)} ${pkg.description}`);
+  }
+}
+
+function normalizeSceneSearchOptions(options = {}) {
+  return {
+    query: options.query ? String(options.query).trim() : '',
+    registry: options.registry ? String(options.registry).trim() : '.kiro/registry',
+    json: options.json === true
+  };
+}
+
+function validateSceneSearchOptions(options) {
+  return null; // Empty query is valid (returns all)
+}
+
+async function runSceneSearchCommand(rawOptions = {}, dependencies = {}) {
+  const projectRoot = dependencies.projectRoot || process.cwd();
+  const fileSystem = dependencies.fileSystem || fs;
+
+  const options = normalizeSceneSearchOptions(rawOptions);
+  const validationError = validateSceneSearchOptions(options);
+
+  if (validationError) {
+    console.error(chalk.red(`Scene search 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);
+    const allPackages = buildRegistryPackageList(index.packages);
+    const packages = filterRegistryPackages(allPackages, options.query);
+    const payload = { query: options.query, packages, total: packages.length };
+
+    printSceneSearchSummary(options, payload, projectRoot);
+    return payload;
+  } catch (error) {
+    console.error(chalk.red('Scene search failed:'), error.message);
+    process.exitCode = 1;
+    return null;
+  }
+}
+
+function printSceneSearchSummary(options, payload, projectRoot = process.cwd()) {
+  if (options.json) {
+    console.log(JSON.stringify(payload, null, 2));
+    return;
+  }
+
+  if (payload.total === 0) {
+    if (payload.query) {
+      console.log(`No packages matching '${payload.query}'`);
+    } else {
+      console.log('No packages found');
+    }
+    return;
+  }
+
+  const matchLabel = payload.total === 1 ? 'match' : 'matches';
+  console.log(chalk.blue(`Scene Search: "${payload.query}" (${payload.total} ${matchLabel})`));
+  for (const pkg of payload.packages) {
+    console.log(`  ${pkg.name.padEnd(20)} ${pkg.latest.padEnd(10)} ${String(pkg.version_count).padEnd(10)} ${pkg.description}`);
+  }
+}
+
 function printSceneUnpublishSummary(options, payload, projectRoot = process.cwd()) {
   if (options.json) {
     console.log(JSON.stringify(payload, null, 2));
@@ -10290,5 +10460,15 @@ module.exports = {
   normalizeSceneInstallOptions,
   printSceneInstallSummary,
   runSceneInstallCommand,
-  validateSceneInstallOptions
+  validateSceneInstallOptions,
+  buildRegistryPackageList,
+  filterRegistryPackages,
+  normalizeSceneListOptions,
+  validateSceneListOptions,
+  runSceneListCommand,
+  printSceneListSummary,
+  normalizeSceneSearchOptions,
+  validateSceneSearchOptions,
+  runSceneSearchCommand,
+  printSceneSearchSummary
 };

package/package.json

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