kiro-spec-engine 1.47.28 → 1.47.30

package/docs/331-poc-dual-track-integration-guide.md

@@ -22,11 +22,10 @@
 npx kse auto handoff run --manifest ../331-poc/docs/handoffs/handoff-manifest.json --json
 ```
 
-需要更严格门禁时：
+需要提高成功率门槛时：
 
 ```bash
 npx 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

package/docs/331-poc-weekly-delivery-checklist.md

@@ -28,7 +28,6 @@ Use this checklist before each integration batch.
 
 ```bash
 npx 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

package/docs/README.md

@@ -91,6 +91,7 @@ Detailed technical documentation:
 - **[Multi-Repository Management Guide](multi-repo-management-guide.md)** - Managing multiple Git repositories
 - **[Value Observability Guide](value-observability-guide.md)** - KPI snapshot, baseline, trend, and gate evidence workflow
 - **[Scene Runtime Guide](scene-runtime-guide.md)** - Scene template engine, quality pipeline, ontology, and Moqui ERP integration
+- **[Moqui Template Core Library Playbook](moqui-template-core-library-playbook.md)** - Default-gated intake flow for absorbing Moqui capabilities into KSE templates
 - **[331-poc Dual-Track Integration Guide](331-poc-dual-track-integration-guide.md)** - Handoff contract and integration playbook between 331-poc and kse
 - **[331-poc Adaptation Roadmap](331-poc-adaptation-roadmap.md)** - Ongoing KSE-side adaptation backlog and rollout phases
 - **[Multi-Agent Coordination Guide](multi-agent-coordination-guide.md)** - Multi-agent parallel coordination for concurrent development
@@ -187,6 +188,7 @@ Detailed technical documentation:
 
 ### Scene Runtime
 - [Scene Runtime Guide](scene-runtime-guide.md)
+- [Moqui Template Core Library Playbook](moqui-template-core-library-playbook.md)
 - [331-poc Dual-Track Integration Guide](331-poc-dual-track-integration-guide.md)
 - [331-poc Adaptation Roadmap](331-poc-adaptation-roadmap.md)
 - [Scene Template Engine](command-reference.md#scene-template-engine)

package/docs/command-reference.md

@@ -516,14 +516,14 @@ kse auto schema migrate --json                           # dry-run by default
 kse auto schema migrate --apply --json                  # apply schema_version migration
 kse auto schema migrate --only close-loop-session,batch-session --apply --json
 
-# Dual-track handoff integration (e.g., 331-poc -> kse)
-kse auto handoff plan --manifest ../331-poc/docs/handoffs/handoff-manifest.json --json
-kse auto handoff plan --manifest ../331-poc/docs/handoffs/handoff-manifest.json --strict --out .kiro/reports/handoff-plan.json --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 --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
+# Dual-track handoff integration (generic external project -> kse)
+kse auto handoff plan --manifest docs/handoffs/handoff-manifest.json --json
+kse auto handoff plan --manifest docs/handoffs/handoff-manifest.json --strict --out .kiro/reports/handoff-plan.json --json
+kse auto handoff queue --manifest docs/handoffs/handoff-manifest.json --out .kiro/auto/handoff-goals.lines --json
+kse auto handoff template-diff --manifest docs/handoffs/handoff-manifest.json --json
+kse auto handoff run --manifest docs/handoffs/handoff-manifest.json --json
+kse auto handoff run --manifest docs/handoffs/handoff-manifest.json --min-spec-success-rate 95 --max-risk-level medium --json
+kse auto handoff run --manifest 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
 kse auto handoff regression --session-id latest --format markdown --out .kiro/reports/handoff-regression.md --json
@@ -836,10 +836,11 @@ 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 + ontology validation required)
+# Publish scene package templates from a handoff manifest
+# Defaults: completed specs only + ontology validation required + ontology batch gate (avg>=70, valid-rate>=100%)
 kse scene package-publish-batch --manifest docs/handoffs/handoff-manifest.json --json
 
-# Use 331-poc preset defaults (manifest/docs paths + completed filter + ontology batch gate: avg>=70, valid-rate>=100%)
+# Optional convenience preset for 331-style path conventions (manifest/docs fallback paths)
 kse scene package-publish-batch --from-331 --json
 
 # Preview batch publish plan without writing template files
@@ -855,22 +856,22 @@ kse scene package-publish-batch --manifest docs/handoffs/handoff-manifest.json -
 kse scene package-publish-batch --manifest docs/handoffs/handoff-manifest.json --manifest-spec-path handoff.spec_items --json
 
 # Tighten per-spec ontology semantic quality threshold before publish
-kse scene package-publish-batch --from-331 --require-ontology-validation --ontology-min-score 70 --json
+kse scene package-publish-batch --manifest docs/handoffs/handoff-manifest.json --ontology-min-score 70 --json
 
 # Persist ontology/publish batch report for governance tracking
-kse scene package-publish-batch --from-331 --dry-run --ontology-report-out .kiro/reports/scene-package-ontology-batch.json --json
+kse scene package-publish-batch --manifest docs/handoffs/handoff-manifest.json --dry-run --ontology-report-out .kiro/reports/scene-package-ontology-batch.json --json
 
 # 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
+kse scene package-publish-batch --manifest docs/handoffs/handoff-manifest.json --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
+kse scene package-publish-batch --manifest docs/handoffs/handoff-manifest.json --dry-run --ontology-task-out .kiro/reports/scene-package-ontology-task-draft.md --json
 
 # Export ontology remediation queue lines (directly consumable by close-loop-batch)
-kse scene package-publish-batch --from-331 --dry-run --ontology-task-queue-out .kiro/auto/ontology-remediation.lines --json
+kse scene package-publish-batch --manifest docs/handoffs/handoff-manifest.json --dry-run --ontology-task-queue-out .kiro/auto/ontology-remediation.lines --json
 ```
 
 ### Scene Package Ontology Backfill Batch
@@ -889,6 +890,34 @@ kse scene package-ontology-backfill-batch --from-331 --include 62-00-moqui-full-
 kse scene package-ontology-backfill-batch --from-331 --dry-run --out-report .kiro/reports/scene-package-ontology-backfill-report.json --json
 ```
 
+### Moqui Template Baseline Scorecard
+
+```bash
+# Score Moqui/ERP templates in the local template library (default filter: moqui|erp)
+npm run report:moqui-baseline
+
+# Score all scene templates instead of Moqui/ERP subset
+node scripts/moqui-template-baseline-report.js --include-all --json
+
+# Customize score thresholds and output paths
+node scripts/moqui-template-baseline-report.js \
+  --min-score 75 \
+  --min-valid-rate 100 \
+  --out .kiro/reports/moqui-template-baseline.json \
+  --markdown-out .kiro/reports/moqui-template-baseline.md \
+  --json
+
+# Compare with a previous baseline and fail CI on portfolio gate fail
+node scripts/moqui-template-baseline-report.js \
+  --compare-with .kiro/reports/release-evidence/moqui-template-baseline-prev.json \
+  --fail-on-portfolio-fail \
+  --json
+```
+
+Release workflow default:
+- Publishes `moqui-template-baseline.json` + `moqui-template-baseline.md` as release assets.
+- Enforces baseline portfolio gate by default (`KSE_MOQUI_BASELINE_ENFORCE` defaults to `true` when unset).
+
 ### Moqui ERP Integration
 
 ```bash

package/docs/handoffs/evidence/ontology/moqui-template-baseline-2026-02-17-232922.json

@@ -0,0 +1,156 @@
+{
+  "mode": "moqui-template-baseline",
+  "generated_at": "2026-02-17T15:29:22.909Z",
+  "template_root": ".kiro\\templates\\scene-packages",
+  "filter": {
+    "include_all": false,
+    "match": "(moqui|erp)"
+  },
+  "baseline": {
+    "min_score": 70,
+    "min_valid_rate_percent": 100
+  },
+  "summary": {
+    "total_templates": 4,
+    "scoped_templates": 3,
+    "avg_score": 100,
+    "valid_rate_percent": 100,
+    "baseline_passed": 3,
+    "baseline_failed": 0,
+    "portfolio_passed": true
+  },
+  "templates": [
+    {
+      "template_id": "kse.scene--erp-inventory-reserve-adjust--0.1.0",
+      "template_path": ".kiro\\templates\\scene-packages\\kse.scene--erp-inventory-reserve-adjust--0.1.0",
+      "contract_path": ".kiro\\templates\\scene-packages\\kse.scene--erp-inventory-reserve-adjust--0.1.0\\scene-package.json",
+      "ontology": {
+        "valid": true,
+        "error_count": 0
+      },
+      "semantic": {
+        "score": 100,
+        "level": "high",
+        "metrics": {
+          "entity_count": 4,
+          "relation_count": 4,
+          "business_rule_total": 2,
+          "business_rule_mapped": 2,
+          "business_rule_unmapped": 0,
+          "business_rule_passed": 2,
+          "business_rule_failed": 0,
+          "business_rule_mapping_rate_percent": 100,
+          "business_rule_pass_rate_percent": 100,
+          "decision_total": 2,
+          "decision_resolved": 2,
+          "decision_pending": 0,
+          "decision_undecided": 0,
+          "decision_automated": 2,
+          "decision_resolved_rate_percent": 100
+        }
+      },
+      "baseline": {
+        "flags": {
+          "graph_valid": true,
+          "score_passed": true,
+          "entity_coverage": true,
+          "relation_coverage": true,
+          "business_rule_coverage": true,
+          "business_rule_closed": true,
+          "decision_coverage": true,
+          "decision_closed": true,
+          "baseline_passed": true
+        },
+        "gaps": []
+      }
+    },
+    {
+      "template_id": "kse.scene--erp-order-fulfillment-workflow--0.1.0",
+      "template_path": ".kiro\\templates\\scene-packages\\kse.scene--erp-order-fulfillment-workflow--0.1.0",
+      "contract_path": ".kiro\\templates\\scene-packages\\kse.scene--erp-order-fulfillment-workflow--0.1.0\\scene-package.json",
+      "ontology": {
+        "valid": true,
+        "error_count": 0
+      },
+      "semantic": {
+        "score": 100,
+        "level": "high",
+        "metrics": {
+          "entity_count": 5,
+          "relation_count": 6,
+          "business_rule_total": 2,
+          "business_rule_mapped": 2,
+          "business_rule_unmapped": 0,
+          "business_rule_passed": 2,
+          "business_rule_failed": 0,
+          "business_rule_mapping_rate_percent": 100,
+          "business_rule_pass_rate_percent": 100,
+          "decision_total": 2,
+          "decision_resolved": 2,
+          "decision_pending": 0,
+          "decision_undecided": 0,
+          "decision_automated": 2,
+          "decision_resolved_rate_percent": 100
+        }
+      },
+      "baseline": {
+        "flags": {
+          "graph_valid": true,
+          "score_passed": true,
+          "entity_coverage": true,
+          "relation_coverage": true,
+          "business_rule_coverage": true,
+          "business_rule_closed": true,
+          "decision_coverage": true,
+          "decision_closed": true,
+          "baseline_passed": true
+        },
+        "gaps": []
+      }
+    },
+    {
+      "template_id": "kse.scene--erp-order-query-read--0.1.0",
+      "template_path": ".kiro\\templates\\scene-packages\\kse.scene--erp-order-query-read--0.1.0",
+      "contract_path": ".kiro\\templates\\scene-packages\\kse.scene--erp-order-query-read--0.1.0\\scene-package.json",
+      "ontology": {
+        "valid": true,
+        "error_count": 0
+      },
+      "semantic": {
+        "score": 100,
+        "level": "high",
+        "metrics": {
+          "entity_count": 4,
+          "relation_count": 4,
+          "business_rule_total": 2,
+          "business_rule_mapped": 2,
+          "business_rule_unmapped": 0,
+          "business_rule_passed": 2,
+          "business_rule_failed": 0,
+          "business_rule_mapping_rate_percent": 100,
+          "business_rule_pass_rate_percent": 100,
+          "decision_total": 2,
+          "decision_resolved": 2,
+          "decision_pending": 0,
+          "decision_undecided": 0,
+          "decision_automated": 2,
+          "decision_resolved_rate_percent": 100
+        }
+      },
+      "baseline": {
+        "flags": {
+          "graph_valid": true,
+          "score_passed": true,
+          "entity_coverage": true,
+          "relation_coverage": true,
+          "business_rule_coverage": true,
+          "business_rule_closed": true,
+          "decision_coverage": true,
+          "decision_closed": true,
+          "baseline_passed": true
+        },
+        "gaps": []
+      }
+    }
+  ]
+}

package/docs/handoffs/evidence/ontology/moqui-template-baseline-2026-02-17-232922.md

@@ -0,0 +1,24 @@
+# Moqui Template Baseline Report
+
+- Generated at: 2026-02-17T15:29:22.909Z
+- Template root: .kiro\templates\scene-packages
+- Filter: (moqui|erp)
+- Baseline thresholds: score>=70, valid-rate>=100%
+
+## Summary
+
+- Total templates scanned: 4
+- Templates in scope: 3
+- Avg score: 100
+- Ontology valid-rate: 100%
+- Baseline passed: 3
+- Baseline failed: 0
+- Portfolio pass: yes
+
+## Templates
+
+| Template | Score | Graph | Baseline | Gaps |
+| --- | ---: | --- | --- | --- |
+| kse.scene--erp-inventory-reserve-adjust--0.1.0 | 100 | valid | pass | none |
+| kse.scene--erp-order-fulfillment-workflow--0.1.0 | 100 | valid | pass | none |
+| kse.scene--erp-order-query-read--0.1.0 | 100 | valid | pass | none |

package/docs/moqui-capability-matrix.md

@@ -48,4 +48,4 @@ A capability is considered absorbed by KSE when all checks pass:
 - `kse scene lint --strict`
 - `kse scene score --threshold 85`
 - `kse scene ontology validate`
-- `kse auto handoff run --require-ontology-validation`
+- `kse auto handoff run`

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

@@ -0,0 +1,89 @@
+# Moqui Template Core Library Playbook
+
+This playbook defines a generic (project-agnostic) path to absorb Moqui capabilities into the KSE core template library.
+
+## Objectives
+
+- Turn Moqui business capabilities into reusable `scene-package` templates.
+- Enforce ontology quality as a default gate (no project-specific flags required).
+- Keep evidence output stable for release and regression review.
+
+## Default Gate Baseline
+
+KSE defaults already enforce the baseline below:
+
+- `kse auto handoff run`: ontology validation is required by default.
+- `kse scene package-publish-batch`:
+  - ontology validation required by default
+  - batch ontology gate defaults:
+    - average ontology score `>= 70`
+    - ontology valid-rate `>= 100%`
+
+Emergency bypass exists but is not recommended:
+
+- `--no-require-ontology-validation`
+
+## One-Shot Intake Flow
+
+```bash
+# 0) Generate template baseline scoreboard (Moqui/ERP templates by default)
+node scripts/moqui-template-baseline-report.js --json
+
+# 0.1) CI/release mode: compare against previous baseline and enforce portfolio gate
+node scripts/moqui-template-baseline-report.js \
+  --compare-with .kiro/reports/release-evidence/moqui-template-baseline-prev.json \
+  --fail-on-portfolio-fail \
+  --json
+
+# 1) Handoff close-loop
+kse auto handoff run --manifest docs/handoffs/handoff-manifest.json --json
+
+# 2) Publish templates from scene packages (with default ontology gates)
+kse scene package-publish-batch \
+  --manifest docs/handoffs/handoff-manifest.json \
+  --json
+
+# 3) Persist ontology publish evidence for governance/review
+kse scene package-publish-batch \
+  --manifest docs/handoffs/handoff-manifest.json \
+  --dry-run \
+  --ontology-report-out .kiro/reports/scene-package-ontology-batch.json \
+  --json
+
+# 4) Validate registry + package gate
+kse scene package-registry --template-dir .kiro/templates/scene-packages --strict --json
+kse scene package-gate-template --out .kiro/templates/scene-package-gate-policy.json --profile three-layer --force --json
+kse scene package-gate --registry .kiro/templates/scene-packages/registry.json --policy .kiro/templates/scene-package-gate-policy.json --strict --json
+```
+
+## Evidence Contract
+
+Required artifacts for each intake batch:
+
+- `.kiro/reports/moqui-template-baseline.json`
+- `.kiro/reports/moqui-template-baseline.md`
+- `.kiro/reports/handoff-runs/<session>.json`
+- `.kiro/reports/scene-package-ontology-batch.json`
+- `.kiro/templates/scene-packages/registry.json`
+- gate output/evidence linked from release notes or handoff summary
+
+## Minimum Semantic Coverage
+
+Each accepted template should include ontology semantics for:
+
+- entity model
+- relation graph
+- business rules
+- decision logic
+
+If any area is weak, export remediation queue lines and feed back to close-loop:
+
+```bash
+kse scene package-publish-batch \
+  --manifest docs/handoffs/handoff-manifest.json \
+  --dry-run \
+  --ontology-task-queue-out .kiro/auto/ontology-remediation.lines \
+  --json
+
+kse auto close-loop-batch .kiro/auto/ontology-remediation.lines --format lines --json
+```

package/docs/zh/README.md

@@ -172,6 +172,12 @@
 - Ontology 图、Action Abstraction、Data Lineage、Agent Hints
 - Moqui ERP 连接、发现、模板提取
 
+### [Moqui Template Core Library Playbook](../moqui-template-core-library-playbook.md)
+**Moqui 能力核心库化执行清单（英文）** - 默认门禁、批处理吸收链路、证据合同
+- 不依赖 331 特参的通用 intake 流程
+- Ontology 与 scene-package 默认门禁
+- remediation 队列回灌闭环
+
 ### [331-poc 双轨协同对接手册](../331-poc-dual-track-integration-guide.md)
 **331-poc 与 kse 协同执行指南** - 交接契约、接入命令链、主从闭环验收
 - 331 深化成果输入约束

package/lib/commands/scene.js

@@ -424,8 +424,8 @@ function registerSceneCommands(program) {
     .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, 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-min-average-score <number>', `Minimum ontology average score for selected batch (0-100, default: ${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: ${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')
@@ -1227,10 +1227,10 @@ function normalizeScenePackagePublishBatchOptions(options = {}) {
       ? null
       : Number(options.ontologyMinScore),
     ontologyMinAverageScore: options.ontologyMinAverageScore === undefined || options.ontologyMinAverageScore === null || options.ontologyMinAverageScore === ''
-      ? (from331 ? SCENE_PACKAGE_BATCH_DEFAULT_ONTOLOGY_MIN_AVERAGE_SCORE : null)
+      ? SCENE_PACKAGE_BATCH_DEFAULT_ONTOLOGY_MIN_AVERAGE_SCORE
       : Number(options.ontologyMinAverageScore),
     ontologyMinValidRate: options.ontologyMinValidRate === undefined || options.ontologyMinValidRate === null || options.ontologyMinValidRate === ''
-      ? (from331 ? SCENE_PACKAGE_BATCH_DEFAULT_ONTOLOGY_MIN_VALID_RATE : null)
+      ? SCENE_PACKAGE_BATCH_DEFAULT_ONTOLOGY_MIN_VALID_RATE
       : 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.28",
+  "version": "1.47.30",
   "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": {
@@ -34,6 +34,7 @@
     "test:skip-audit": "node scripts/check-skip-allowlist.js",
     "test:watch": "npx jest --watch",
     "coverage": "npx jest --coverage",
+    "report:moqui-baseline": "node scripts/moqui-template-baseline-report.js --json",
     "prepublishOnly": "npm run test:full && npm run test:skip-audit",
     "publish:manual": "npm publish --access public",
     "install-global": "npm install -g .",