kiro-spec-engine 1.47.26 → 1.47.28

package/docs/command-reference.md

@@ -522,7 +522,7 @@ kse auto handoff plan --manifest ../331-poc/docs/handoffs/handoff-manifest.json
 kse auto handoff queue --manifest ../331-poc/docs/handoffs/handoff-manifest.json --out .kiro/auto/handoff-goals.lines --json
 kse auto handoff template-diff --manifest ../331-poc/docs/handoffs/handoff-manifest.json --json
 kse auto handoff run --manifest ../331-poc/docs/handoffs/handoff-manifest.json --json
-kse auto handoff run --manifest ../331-poc/docs/handoffs/handoff-manifest.json --require-ontology-validation --min-spec-success-rate 95 --max-risk-level medium --json
+kse auto handoff run --manifest ../331-poc/docs/handoffs/handoff-manifest.json --min-spec-success-rate 95 --max-risk-level medium --json
 kse auto handoff run --manifest ../331-poc/docs/handoffs/handoff-manifest.json --continue-from latest --continue-strategy auto --json
 kse auto handoff regression --session-id latest --json
 kse auto handoff regression --session-id latest --window 5 --json
@@ -765,15 +765,15 @@ Dual-track handoff integration:
 - `kse auto handoff plan --manifest <path> [--out <path>] [--strict] [--strict-warnings] [--json]`: parse handoff manifest (source project, specs, templates, known gaps) and generate an executable KSE integration phase plan.
 - `kse auto handoff queue --manifest <path> [--out <path>] [--append] [--no-include-known-gaps] [--dry-run] [--json]`: generate close-loop batch goal queue from handoff manifest and optionally persist line-based queue file (default `.kiro/auto/handoff-goals.lines`).
 - `kse auto handoff template-diff --manifest <path> [--json]`: compare manifest templates against local template exports/registry and report `missing_in_local` and `extra_in_local`.
-- `kse auto handoff run --manifest <path> [--out <path>] [--queue-out <path>] [--append] [--no-include-known-gaps] [--continue-from <session|latest|file>] [--continue-strategy <auto|pending|failed-only>] [--dry-run] [--strict] [--strict-warnings] [--no-dependency-batching] [--min-spec-success-rate <n>] [--max-risk-level <level>] [--require-ontology-validation] [--release-evidence-window <n>] [--json]`: execute handoff end-to-end (`plan -> queue -> close-loop-batch -> observability`) with automatic report archive to `.kiro/reports/handoff-runs/<session>.json`.
+- `kse auto handoff run --manifest <path> [--out <path>] [--queue-out <path>] [--append] [--no-include-known-gaps] [--continue-from <session|latest|file>] [--continue-strategy <auto|pending|failed-only>] [--dry-run] [--strict] [--strict-warnings] [--no-dependency-batching] [--min-spec-success-rate <n>] [--max-risk-level <level>] [--no-require-ontology-validation] [--release-evidence-window <n>] [--json]`: execute handoff end-to-end (`plan -> queue -> close-loop-batch -> observability`) with automatic report archive to `.kiro/reports/handoff-runs/<session>.json`.
   - Default mode is dependency-aware: spec integration goals are grouped into dependency batches and executed in topological order.
   - `--continue-from` resumes pending goals from an existing handoff run report (`latest`, session id, or JSON file path). For safety, KSE enforces manifest-path consistency between the previous report and current run.
   - `--continue-strategy auto|pending|failed-only` controls resumed scope. `auto` (default) derives the best strategy from prior run state (`pending` when unprocessed/planned goals exist, otherwise `failed-only` for pure failure replay).
   - Non-dry runs auto-merge release evidence into `.kiro/reports/release-evidence/handoff-runs.json` with session-level gate/ontology/regression snapshots. Merge failures are recorded as warnings without aborting the run.
   - `--release-evidence-window` controls trend snapshot window size (2-50, default `5`) used in merged release evidence (`latest_trend_window` and per-session `trend_window`).
   - Run result includes `recommendations` with executable follow-up commands (for example, auto-generated `--continue-from <session>` on failed/incomplete batches).
-  - Gate defaults: `--min-spec-success-rate` defaults to `100`, `--max-risk-level` defaults to `high`.
-  - When `--require-ontology-validation` is enabled, run fails fast at precheck if manifest ontology evidence is missing or not passed.
+  - Gate defaults: `--min-spec-success-rate` defaults to `100`, `--max-risk-level` defaults to `high`, and ontology validation requirement is enabled by default.
+  - Use `--no-require-ontology-validation` only for emergency bypass; default behavior fails fast at precheck if manifest ontology evidence is missing or not passed.
 - `kse auto handoff regression [--session-id <id|latest>] [--window <n>] [--format <json|markdown>] [--out <path>] [--json]`: compare one handoff run report with its previous run and output trend deltas (success-rate/risk/failed-goals/elapsed time).
   - `--window` (2-50, default `2`) returns multi-run `series`, `window_trend`, and `aggregates` for broader regression visibility.
   - Regression JSON now includes `risk_layers` (low/medium/high/unknown buckets with per-layer session list and quality aggregates).
@@ -836,10 +836,10 @@ kse scene template-render --package scene-erp --values '{"entity_name":"Order"}'
 ### Scene Package Batch Publish
 
 ```bash
-# Publish scene package templates from a handoff manifest (default: completed specs only)
+# Publish scene package templates from a handoff manifest (default: completed specs only + ontology validation required)
 kse scene package-publish-batch --manifest docs/handoffs/handoff-manifest.json --json
 
-# Use 331-poc preset defaults (manifest/docs paths + completed filter)
+# Use 331-poc preset defaults (manifest/docs paths + completed filter + ontology batch gate: avg>=70, valid-rate>=100%)
 kse scene package-publish-batch --from-331 --json
 
 # Preview batch publish plan without writing template files
@@ -854,7 +854,7 @@ kse scene package-publish-batch --manifest docs/handoffs/handoff-manifest.json -
 # Read specs from non-standard manifest path
 kse scene package-publish-batch --manifest docs/handoffs/handoff-manifest.json --manifest-spec-path handoff.spec_items --json
 
-# Enforce ontology validation + semantic quality threshold before publish
+# Tighten per-spec ontology semantic quality threshold before publish
 kse scene package-publish-batch --from-331 --require-ontology-validation --ontology-min-score 70 --json
 
 # Persist ontology/publish batch report for governance tracking
@@ -863,6 +863,9 @@ kse scene package-publish-batch --from-331 --dry-run --ontology-report-out .kiro
 # Enforce batch-level ontology portfolio gate (average score + valid-rate)
 kse scene package-publish-batch --from-331 --dry-run --ontology-min-average-score 60 --ontology-min-valid-rate 90 --json
 
+# Emergency bypass (not recommended): disable ontology validation requirement
+kse scene package-publish-batch --manifest docs/handoffs/handoff-manifest.json --no-require-ontology-validation --json
+
 # Export ontology remediation task draft markdown
 kse scene package-publish-batch --from-331 --dry-run --ontology-task-out .kiro/reports/scene-package-ontology-task-draft.md --json
 

package/lib/commands/auto.js

@@ -1746,7 +1746,8 @@ function registerAutoCommands(program) {
     .option('--min-ontology-score <n>', 'Gate: minimum ontology quality score (0-100, default: 0)', parseFloat)
     .option('--max-unmapped-rules <n>', 'Gate: maximum allowed unmapped business rules (optional)', parseInt)
     .option('--max-undecided-decisions <n>', 'Gate: maximum allowed undecided decisions (optional)', parseInt)
-    .option('--require-ontology-validation', 'Gate: require manifest ontology_validation to be present and passed')
+    .option('--require-ontology-validation', 'Gate: require manifest ontology_validation to be present and passed (default: enabled)')
+    .option('--no-require-ontology-validation', 'Gate: disable manifest ontology_validation requirement (not recommended)')
     .option('--release-evidence-window <n>', 'Release evidence trend window size (2-50, default: 5)', parseInt)
     .option('--json', 'Output machine-readable JSON')
     .action(async (options) => {
@@ -9403,7 +9404,7 @@ function buildAutoHandoffRunPolicy(options = {}) {
       options.maxUndecidedDecisions,
       '--max-undecided-decisions'
     ),
-    require_ontology_validation: Boolean(options.requireOntologyValidation),
+    require_ontology_validation: options.requireOntologyValidation !== false,
     dependency_batching: options.dependencyBatching !== false,
     release_evidence_window: normalizeHandoffReleaseEvidenceWindow(options.releaseEvidenceWindow)
   };
@@ -9781,7 +9782,7 @@ function evaluateAutoHandoffRunGates(context = {}) {
     min_ontology_score: 0,
     max_unmapped_rules: null,
     max_undecided_decisions: null,
-    require_ontology_validation: false
+    require_ontology_validation: true
   };
   const dryRun = Boolean(context.dryRun);
   const specStatus = context.specStatus || {
@@ -9896,7 +9897,7 @@ function buildAutoHandoffRunRecommendations(projectPath, result) {
   ) {
     push(
       `Ensure manifest ontology_validation is present and passed, then rerun: ` +
-      `kse auto handoff run --manifest ${manifestCli} --require-ontology-validation --json`
+      `kse auto handoff run --manifest ${manifestCli} --json`
     );
     if (result.error.toLowerCase().includes('ontology_quality_score')) {
       push(`kse auto handoff run --manifest ${manifestCli} --min-ontology-score 80 --json`);

package/lib/commands/scene.js

@@ -60,6 +60,8 @@ 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_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';
 const SCENE_PACKAGE_GATE_TEMPLATE_PROFILES = new Set(['baseline', 'three-layer']);
 const SCENE_PACKAGE_KIND_LAYER_MAP = Object.freeze({
@@ -399,7 +401,8 @@ function registerSceneCommands(program) {
     .option('--scene-manifest <relative-path>', 'Scene manifest path inside source spec', 'custom/scene.yaml')
     .option('--out-dir <path>', 'Template library output root', SCENE_PACKAGE_TEMPLATE_DEFAULT_DIR)
     .option('--template-id <template-id>', 'Explicit template id (folder name)')
-    .option('--require-ontology-validation', 'Require ontology graph validation before publish')
+    .option('--require-ontology-validation', 'Require ontology graph validation before publish (default: enabled)')
+    .option('--no-require-ontology-validation', 'Allow publish when ontology graph validation fails (not recommended)')
     .option('--ontology-min-score <number>', 'Minimum ontology semantic quality score (0-100)')
     .option('--dry-run', 'Preview publish without writing files')
     .option('--force', 'Overwrite existing template directory if it already exists')
@@ -418,10 +421,11 @@ function registerSceneCommands(program) {
     .option('--include <specs>', 'Comma-separated spec IDs to include')
     .option('--fallback-spec-package <relative-path>', 'Fallback package path inside spec')
     .option('--fallback-scene-manifest <relative-path>', 'Fallback scene manifest path inside spec')
-    .option('--require-ontology-validation', 'Require ontology graph validation before publish')
+    .option('--require-ontology-validation', 'Require ontology graph validation before publish (default: enabled)')
+    .option('--no-require-ontology-validation', 'Allow publish when ontology graph validation fails (not recommended)')
     .option('--ontology-min-score <number>', 'Minimum ontology semantic quality score (0-100)')
-    .option('--ontology-min-average-score <number>', 'Minimum ontology average score for selected batch (0-100)')
-    .option('--ontology-min-valid-rate <number>', 'Minimum ontology graph-valid rate for selected batch (0-100)')
+    .option('--ontology-min-average-score <number>', `Minimum ontology average score for selected batch (0-100, default with --from-331: ${SCENE_PACKAGE_BATCH_DEFAULT_ONTOLOGY_MIN_AVERAGE_SCORE})`)
+    .option('--ontology-min-valid-rate <number>', `Minimum ontology graph-valid rate for selected batch (0-100, default with --from-331: ${SCENE_PACKAGE_BATCH_DEFAULT_ONTOLOGY_MIN_VALID_RATE})`)
     .option('--ontology-report-out <path>', 'Write ontology/publish batch report JSON to file')
     .option('--ontology-task-out <path>', 'Write ontology remediation task draft markdown to file')
     .option('--ontology-task-queue-out <path>', 'Write ontology remediation queue lines for close-loop-batch')
@@ -1190,7 +1194,7 @@ function normalizeScenePackagePublishOptions(options = {}) {
     sceneManifest: normalizeRelativePath(options.sceneManifest || 'custom/scene.yaml') || 'custom/scene.yaml',
     outDir: options.outDir ? String(options.outDir).trim() : SCENE_PACKAGE_TEMPLATE_DEFAULT_DIR,
     templateId: options.templateId ? String(options.templateId).trim() : undefined,
-    requireOntologyValidation: options.requireOntologyValidation === true,
+    requireOntologyValidation: options.requireOntologyValidation !== false,
     ontologyMinScore: options.ontologyMinScore === undefined || options.ontologyMinScore === null || options.ontologyMinScore === ''
       ? null
       : Number(options.ontologyMinScore),
@@ -1218,15 +1222,15 @@ function normalizeScenePackagePublishBatchOptions(options = {}) {
       .filter((item) => item.length > 0),
     fallbackSpecPackage: normalizeRelativePath(options.fallbackSpecPackage || fallbackSpecPackageDefault) || fallbackSpecPackageDefault,
     fallbackSceneManifest: normalizeRelativePath(options.fallbackSceneManifest || fallbackSceneManifestDefault) || fallbackSceneManifestDefault,
-    requireOntologyValidation: options.requireOntologyValidation === true,
+    requireOntologyValidation: options.requireOntologyValidation !== false,
     ontologyMinScore: options.ontologyMinScore === undefined || options.ontologyMinScore === null || options.ontologyMinScore === ''
       ? null
       : Number(options.ontologyMinScore),
     ontologyMinAverageScore: options.ontologyMinAverageScore === undefined || options.ontologyMinAverageScore === null || options.ontologyMinAverageScore === ''
-      ? null
+      ? (from331 ? SCENE_PACKAGE_BATCH_DEFAULT_ONTOLOGY_MIN_AVERAGE_SCORE : null)
       : Number(options.ontologyMinAverageScore),
     ontologyMinValidRate: options.ontologyMinValidRate === undefined || options.ontologyMinValidRate === null || options.ontologyMinValidRate === ''
-      ? null
+      ? (from331 ? SCENE_PACKAGE_BATCH_DEFAULT_ONTOLOGY_MIN_VALID_RATE : null)
       : Number(options.ontologyMinValidRate),
     ontologyReportOut: options.ontologyReportOut ? String(options.ontologyReportOut).trim() : undefined,
     ontologyTaskOut: options.ontologyTaskOut ? String(options.ontologyTaskOut).trim() : undefined,

package/package.json

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