kiro-spec-engine 1.47.30 → 1.47.31

package/docs/command-reference.md

@@ -893,14 +893,17 @@ kse scene package-ontology-backfill-batch --from-331 --dry-run --out-report .kir
 ### Moqui Template Baseline Scorecard
 
 ```bash
-# Score Moqui/ERP templates in the local template library (default filter: moqui|erp)
+# Preferred CLI entry: score Moqui/ERP templates in the local template library (default filter: moqui|erp)
+kse scene moqui-baseline --json
+
+# Script alias (same behavior)
 npm run report:moqui-baseline
 
 # Score all scene templates instead of Moqui/ERP subset
-node scripts/moqui-template-baseline-report.js --include-all --json
+kse scene moqui-baseline --include-all --json
 
 # Customize score thresholds and output paths
-node scripts/moqui-template-baseline-report.js \
+kse scene moqui-baseline \
   --min-score 75 \
   --min-valid-rate 100 \
   --out .kiro/reports/moqui-template-baseline.json \
@@ -908,7 +911,7 @@ node scripts/moqui-template-baseline-report.js \
   --json
 
 # Compare with a previous baseline and fail CI on portfolio gate fail
-node scripts/moqui-template-baseline-report.js \
+kse scene moqui-baseline \
   --compare-with .kiro/reports/release-evidence/moqui-template-baseline-prev.json \
   --fail-on-portfolio-fail \
   --json

package/docs/moqui-template-core-library-playbook.md

@@ -27,10 +27,10 @@ Emergency bypass exists but is not recommended:
 
 ```bash
 # 0) Generate template baseline scoreboard (Moqui/ERP templates by default)
-node scripts/moqui-template-baseline-report.js --json
+kse scene moqui-baseline --json
 
 # 0.1) CI/release mode: compare against previous baseline and enforce portfolio gate
-node scripts/moqui-template-baseline-report.js \
+kse scene moqui-baseline \
   --compare-with .kiro/reports/release-evidence/moqui-template-baseline-prev.json \
   --fail-on-portfolio-fail \
   --json

package/lib/commands/scene.js

@@ -1,6 +1,7 @@
 const path = require('path');
 const zlib = require('zlib');
 const crypto = require('crypto');
+const { spawnSync } = require('child_process');
 const fs = require('fs-extra');
 const chalk = require('chalk');
 const yaml = require('js-yaml');
@@ -60,6 +61,9 @@ const SCENE_PACKAGE_KINDS = new Set([
 const SCENE_PACKAGE_RISK_LEVELS = new Set(['low', 'medium', 'high', 'critical']);
 const SCENE_PACKAGE_TEMPLATE_API_VERSION = 'kse.scene.template/v0.1';
 const SCENE_PACKAGE_TEMPLATE_DEFAULT_DIR = '.kiro/templates/scene-packages';
+const SCENE_MOQUI_BASELINE_DEFAULT_MATCH = '(moqui|erp)';
+const SCENE_MOQUI_BASELINE_DEFAULT_MIN_SCORE = 70;
+const SCENE_MOQUI_BASELINE_DEFAULT_MIN_VALID_RATE = 100;
 const SCENE_PACKAGE_BATCH_DEFAULT_ONTOLOGY_MIN_AVERAGE_SCORE = 70;
 const SCENE_PACKAGE_BATCH_DEFAULT_ONTOLOGY_MIN_VALID_RATE = 100;
 const SCENE_PACKAGE_GATE_API_VERSION = 'kse.scene.package-gate/v0.1';
@@ -536,6 +540,23 @@ function registerSceneCommands(program) {
       await runSceneTemplateRenderCommand(options);
     });
 
+  sceneCmd
+    .command('moqui-baseline')
+    .description('Generate Moqui template baseline scorecard from scene package library')
+    .option('--template-dir <path>', 'Template root directory', SCENE_PACKAGE_TEMPLATE_DEFAULT_DIR)
+    .option('--out <path>', 'JSON report output path', '.kiro/reports/moqui-template-baseline.json')
+    .option('--markdown-out <path>', 'Markdown report output path', '.kiro/reports/moqui-template-baseline.md')
+    .option('--match <regex>', 'Template selector regex', SCENE_MOQUI_BASELINE_DEFAULT_MATCH)
+    .option('--include-all', 'Disable selector filter and score all templates')
+    .option('--min-score <number>', 'Baseline minimum semantic score (0-100)', String(SCENE_MOQUI_BASELINE_DEFAULT_MIN_SCORE))
+    .option('--min-valid-rate <number>', 'Baseline minimum ontology valid-rate percent (0-100)', String(SCENE_MOQUI_BASELINE_DEFAULT_MIN_VALID_RATE))
+    .option('--compare-with <path>', 'Compare with previous baseline JSON report')
+    .option('--fail-on-portfolio-fail', 'Exit non-zero when portfolio baseline gate fails')
+    .option('--json', 'Print payload as JSON')
+    .action(async (options) => {
+      await runSceneMoquiBaselineCommand(options);
+    });
+
   sceneCmd
     .command('instantiate')
     .description('Instantiate scene template package with full pipeline (resolve, validate, render, manifest, log, hook)')
@@ -10960,6 +10981,48 @@ function validateSceneTemplateResolveOptions(options) {
   return null;
 }
 
+function normalizeSceneMoquiBaselineOptions(options = {}) {
+  const minScore = Number(options.minScore);
+  const minValidRate = Number(options.minValidRate);
+  return {
+    templateDir: options.templateDir ? String(options.templateDir).trim() : SCENE_PACKAGE_TEMPLATE_DEFAULT_DIR,
+    out: options.out ? String(options.out).trim() : '.kiro/reports/moqui-template-baseline.json',
+    markdownOut: options.markdownOut ? String(options.markdownOut).trim() : '.kiro/reports/moqui-template-baseline.md',
+    match: options.match ? String(options.match).trim() : SCENE_MOQUI_BASELINE_DEFAULT_MATCH,
+    includeAll: options.includeAll === true,
+    minScore: Number.isFinite(minScore) ? minScore : SCENE_MOQUI_BASELINE_DEFAULT_MIN_SCORE,
+    minValidRate: Number.isFinite(minValidRate) ? minValidRate : SCENE_MOQUI_BASELINE_DEFAULT_MIN_VALID_RATE,
+    compareWith: options.compareWith ? String(options.compareWith).trim() : undefined,
+    failOnPortfolioFail: options.failOnPortfolioFail === true,
+    json: options.json === true
+  };
+}
+
+function validateSceneMoquiBaselineOptions(options) {
+  if (!options.templateDir || typeof options.templateDir !== 'string' || options.templateDir.trim().length === 0) {
+    return '--template-dir is required';
+  }
+  if (!options.out || typeof options.out !== 'string' || options.out.trim().length === 0) {
+    return '--out is required';
+  }
+  if (!options.markdownOut || typeof options.markdownOut !== 'string' || options.markdownOut.trim().length === 0) {
+    return '--markdown-out is required';
+  }
+  if (!options.match || typeof options.match !== 'string' || options.match.trim().length === 0) {
+    return '--match is required';
+  }
+  if (!Number.isFinite(Number(options.minScore)) || Number(options.minScore) < 0 || Number(options.minScore) > 100) {
+    return '--min-score must be a number between 0 and 100';
+  }
+  if (!Number.isFinite(Number(options.minValidRate)) || Number(options.minValidRate) < 0 || Number(options.minValidRate) > 100) {
+    return '--min-valid-rate must be a number between 0 and 100';
+  }
+  if (options.compareWith !== undefined && (!options.compareWith || options.compareWith.length === 0)) {
+    return '--compare-with cannot be empty';
+  }
+  return null;
+}
+
 // --- Print functions for template commands ---
 
 function printSceneTemplateValidateSummary(options, payload, projectRoot = process.cwd()) {
@@ -11076,6 +11139,80 @@ function printSceneTemplateRenderSummary(options, payload, projectRoot = process
 
 // --- Command runners for template commands ---
 
+async function runSceneMoquiBaselineCommand(rawOptions = {}, dependencies = {}) {
+  const projectRoot = dependencies.projectRoot || process.cwd();
+  const fileSystem = dependencies.fileSystem || fs;
+
+  const options = normalizeSceneMoquiBaselineOptions(rawOptions);
+  const validationError = validateSceneMoquiBaselineOptions(options);
+  if (validationError) {
+    console.error(chalk.red(`Scene moqui-baseline failed: ${validationError}`));
+    process.exitCode = 1;
+    return null;
+  }
+
+  const scriptPath = path.join(projectRoot, 'scripts', 'moqui-template-baseline-report.js');
+  const scriptExists = await fileSystem.pathExists(scriptPath);
+  if (!scriptExists) {
+    console.error(chalk.red(`Scene moqui-baseline failed: script not found at ${scriptPath}`));
+    process.exitCode = 1;
+    return null;
+  }
+
+  const args = [scriptPath];
+  args.push('--template-dir', options.templateDir);
+  args.push('--out', options.out);
+  args.push('--markdown-out', options.markdownOut);
+  args.push('--match', options.match);
+  args.push('--min-score', String(options.minScore));
+  args.push('--min-valid-rate', String(options.minValidRate));
+  if (options.includeAll) {
+    args.push('--include-all');
+  }
+  if (options.compareWith) {
+    args.push('--compare-with', options.compareWith);
+  }
+  if (options.failOnPortfolioFail) {
+    args.push('--fail-on-portfolio-fail');
+  }
+  if (options.json) {
+    args.push('--json');
+  }
+
+  const result = spawnSync(process.execPath, args, {
+    cwd: projectRoot,
+    encoding: 'utf8'
+  });
+
+  if (typeof result.stdout === 'string' && result.stdout.length > 0) {
+    process.stdout.write(result.stdout);
+  }
+  if (typeof result.stderr === 'string' && result.stderr.length > 0) {
+    process.stderr.write(result.stderr);
+  }
+
+  if (result.error) {
+    console.error(chalk.red(`Scene moqui-baseline failed: ${result.error.message}`));
+    process.exitCode = 1;
+    return null;
+  }
+
+  const exitCode = Number.isInteger(result.status) ? result.status : 1;
+  if (exitCode !== 0) {
+    process.exitCode = exitCode;
+  }
+
+  if (options.json && typeof result.stdout === 'string' && result.stdout.trim().length > 0) {
+    try {
+      return JSON.parse(result.stdout);
+    } catch (_error) {
+      return null;
+    }
+  }
+
+  return null;
+}
+
 async function runSceneTemplateValidateCommand(rawOptions = {}, dependencies = {}) {
   const projectRoot = dependencies.projectRoot || process.cwd();
   const fileSystem = dependencies.fileSystem || fs;
@@ -15266,6 +15403,9 @@ module.exports = {
   validateSceneTemplateValidateOptions,
   normalizeSceneTemplateResolveOptions,
   validateSceneTemplateResolveOptions,
+  normalizeSceneMoquiBaselineOptions,
+  validateSceneMoquiBaselineOptions,
+  runSceneMoquiBaselineCommand,
   runSceneTemplateValidateCommand,
   runSceneTemplateResolveCommand,
   runSceneTemplateRenderCommand,

package/package.json

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