scene-capability-engine 3.0.6 → 3.0.7

package/README.md

@@ -253,6 +253,7 @@ sequenceDiagram
 - 🌍 **[Environment Management](docs/environment-management-guide.md)** - Multi-environment configuration
 - 📦 **[Multi-Repository Management](docs/multi-repo-management-guide.md)** - Manage multiple Git repositories
 - 🎭 **[Scene Runtime](docs/scene-runtime-guide.md)** - Template engine, quality pipeline, ontology, Moqui ERP
+- ♻️ **[Moqui Standard Rebuild](docs/moqui-standard-rebuild-guide.md)** - Rebuild bootstrap bundle + page-copilot contract from metadata
 - 🤖 **[Multi-Agent Coordination](docs/multi-agent-coordination-guide.md)** - Parallel agent coordination
 - 📈 **[Value Observability](docs/value-observability-guide.md)** - KPI snapshot, baseline, trend, gate-ready evidence
 - 🔌 **[Integration Modes](docs/integration-modes.md)** - Three ways to integrate sce

package/docs/command-reference.md

@@ -833,6 +833,23 @@ Moqui template library lexicon audit (script-level governance helper):
   - By default, template capability auditing is scoped to `manifest.templates` (when matched), reducing noise from unrelated templates.
   - Template scope matching normalizes `sce.scene--*` / `kse.scene--*` prefixes, so renamed template namespaces still map correctly.
 
+Moqui standard rebuild helper (script-level recovery bootstrap):
+- `node scripts/moqui-standard-rebuild.js [--metadata <path>] [--out <path>] [--markdown-out <path>] [--bundle-out <path>] [--json]`: build a standard Moqui recovery bundle from metadata, including recommended SCE template matrix, recovery spec plan, handoff manifest seed, ontology seed, and page-copilot context contract.
+  - Output now includes `recovery.readiness_matrix`, `recovery.readiness_summary`, and `recovery.prioritized_gaps` for template capability matrix scoring and remediation planning.
+  - Bundle now includes `rebuild/matrix-remediation.lines` (gap remediation queue lines).
+  - Bundle now includes `rebuild/matrix-remediation-plan.json|.md` (gap-to-source-file remediation plan).
+  - This workflow is scoped to SCE outputs and does not mutate business project code directly.
+  - Recommended usage for rebuild target path: `E:/workspace/331-poc-rebuild` (keep `331-poc` repair stream isolated).
+
+Moqui rebuild gate helper (CI/pre-release readiness gate):
+- `node scripts/moqui-rebuild-gate.js [--metadata <path>] [--out <path>] [--markdown-out <path>] [--bundle-out <path>] [--min-ready <n>] [--max-partial <n>] [--max-gap <n>]`: run rebuild and fail when readiness gate is not met (default: ready>=6, partial<=0, gap<=0).
+- npm alias: `npm run gate:moqui-rebuild`
+
+Moqui metadata extractor helper (script-level catalog bootstrap):
+- `node scripts/moqui-metadata-extract.js [--project-dir <path>] [--out <path>] [--markdown-out <path>] [--json]`: build a normalized metadata catalog from multiple sources for rebuild automation. Default sources include Moqui XML resources (`entity/service/screen/form/rule/decision`), scene package contracts (`.kiro/specs/**/docs/scene-package.json`), handoff manifest/capability matrix, and handoff evidence JSON.
+  - Recommended first step before `moqui-standard-rebuild`.
+  - Keep extraction source read-only and run rebuild generation against SCE output directories.
+
 Recommended `.kiro/config/orchestrator.json`:
 
 ```json

package/docs/moqui-standard-rebuild-guide.md

@@ -0,0 +1,96 @@
+# Moqui Standard Rebuild Guide
+
+This guide bootstraps a standard Moqui recovery bundle using SCE templates and metadata.
+It is designed to avoid direct interference with an in-progress `331-poc` repair stream.
+
+## Goal
+
+- Rebuild baseline business capability assets from metadata.
+- Keep original Moqui technology stack unchanged.
+- Add a page-level human/AI copilot dialog contract for contextual fixes.
+
+## Recommended Workspace Strategy
+
+1. Keep SCE in `E:/workspace/kiro-spec-engine` for reusable rebuild tooling.
+2. Keep business rebuild target isolated (recommended): `E:/workspace/331-poc-rebuild`.
+3. Do not write generated recovery files into live `331-poc` unless explicitly approved.
+
+## Input Metadata (minimum)
+
+Provide a JSON file with at least one of these arrays:
+
+- `entities`
+- `services`
+- `screens`
+- `forms`
+
+Optional:
+
+- `business_rules`
+- `decisions`
+
+## Step 1: Extract Metadata (from Moqui project)
+
+```bash
+node scripts/moqui-metadata-extract.js \
+  --project-dir E:/workspace/your-moqui-project \
+  --out docs/moqui/metadata-catalog.json \
+  --markdown-out docs/moqui/metadata-catalog.md \
+  --json
+```
+
+`moqui-metadata-extract` now performs multi-source catalog extraction by default:
+- Moqui XML (`entity/service/screen/form/rule/decision`)
+- `scene-package.json` contracts in `.kiro/specs/**/docs/`
+- `docs/handoffs/handoff-manifest.json`
+- `docs/handoffs/capability-matrix.md`
+- `docs/handoffs/evidence/**/*.json`
+- `.kiro/recovery/salvage/**/*.json` (if present)
+
+## Step 2: Build Rebuild Bundle
+
+```bash
+node scripts/moqui-standard-rebuild.js \
+  --metadata docs/moqui/metadata-catalog.json \
+  --out .kiro/reports/recovery/moqui-standard-rebuild.json \
+  --markdown-out .kiro/reports/recovery/moqui-standard-rebuild.md \
+  --bundle-out .kiro/reports/recovery/moqui-standard-bundle \
+  --json
+```
+
+## Step 3: Run Rebuild Readiness Gate (recommended for CI/release)
+
+```bash
+node scripts/moqui-rebuild-gate.js \
+  --metadata docs/moqui/metadata-catalog.json \
+  --out .kiro/reports/recovery/moqui-standard-rebuild.json \
+  --markdown-out .kiro/reports/recovery/moqui-standard-rebuild.md \
+  --bundle-out .kiro/reports/recovery/moqui-standard-bundle
+```
+
+Defaults: `ready>=6`, `partial<=0`, `gap<=0`.
+
+## Generated Bundle
+
+- `handoff/handoff-manifest.json`: seed manifest for SCE handoff gates.
+- `ontology/moqui-ontology-seed.json`: initial ontology graph seed.
+- `rebuild/recovery-spec-plan.json`: ordered recovery spec list.
+- `rebuild/matrix-remediation.lines`: prioritized remediation queue lines derived from template readiness gaps.
+- `rebuild/matrix-remediation-plan.json`: gap-to-source-file remediation plan for quick 331 execution.
+- `rebuild/matrix-remediation-plan.md`: markdown view of remediation plan.
+- `copilot/page-context-contract.json`: page-context contract for copilot dialog.
+- `copilot/conversation-playbook.md`: operational playbook for human/AI page fixes.
+- rebuild report includes template readiness scoring (`recovery.readiness_matrix`) and prioritized remediation items (`recovery.prioritized_gaps`).
+
+## Default Moqui Template Matrix
+
+- `kse.scene--moqui-entity-model-core--0.1.0`
+- `kse.scene--moqui-service-contract-core--0.1.0`
+- `kse.scene--moqui-screen-flow-core--0.1.0`
+- `kse.scene--moqui-form-interaction-core--0.1.0`
+- `kse.scene--moqui-rule-decision-core--0.1.0`
+- `kse.scene--moqui-page-copilot-dialog--0.1.0`
+
+## Next Step for Business Project
+
+Use generated assets as input to a dedicated rebuild project (for example `331-poc-rebuild`) and execute normal SCE handoff + gate flows there.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scene-capability-engine",
-  "version": "3.0.6",
+  "version": "3.0.7",
   "description": "SCE (Scene Capability Engine) - A CLI tool and npm package for spec-driven development with AI coding assistants.",
   "main": "index.js",
   "bin": {
@@ -35,6 +35,9 @@
     "test:brand-consistency": "node scripts/check-branding-consistency.js",
     "test:watch": "npx jest --watch",
     "coverage": "npx jest --coverage",
+    "report:moqui-metadata": "node scripts/moqui-metadata-extract.js --json",
+    "report:moqui-rebuild": "node scripts/moqui-standard-rebuild.js --json",
+    "gate:moqui-rebuild": "node scripts/moqui-rebuild-gate.js",
     "report:moqui-baseline": "node scripts/moqui-template-baseline-report.js --json",
     "report:moqui-core-regression": "node scripts/moqui-core-regression-suite.js --json",
     "prepublishOnly": "npm run test:full && npm run test:skip-audit && npm run test:brand-consistency",