scene-capability-engine 3.0.8 → 3.2.0

package/lib/commands/scene.js

@@ -557,6 +557,141 @@ function registerSceneCommands(program) {
       await runSceneMoquiBaselineCommand(options);
     });
 
+  sceneCmd
+    .command('interactive-loop')
+    .description('Run one-command interactive customization loop (intent->plan->gate->approval->optional low-risk apply)')
+    .option('--context <path>', 'Page context JSON file')
+    .option('--goal <text>', 'Business goal text')
+    .option('--goal-file <path>', 'Path to business goal text file')
+    .option('--user-id <id>', 'User identifier')
+    .option('--session-id <id>', 'Session identifier')
+    .option('--execution-mode <mode>', 'suggestion|apply', 'suggestion')
+    .option('--policy <path>', 'Guardrail policy override path')
+    .option('--catalog <path>', 'High-risk catalog override path')
+    .option('--dialogue-policy <path>', 'Dialogue governance policy override path')
+    .option('--dialogue-out <path>', 'Dialogue governance report output path')
+    .option('--runtime-mode <name>', 'Runtime mode (user-assist|ops-fix|feature-dev)', 'ops-fix')
+    .option('--runtime-environment <name>', 'Runtime environment (dev|staging|prod)', 'staging')
+    .option('--runtime-policy <path>', 'Runtime mode/environment policy override path')
+    .option('--runtime-out <path>', 'Runtime policy evaluation output path')
+    .option('--context-contract <path>', 'Context contract override path for interactive intent build')
+    .option('--no-strict-contract', 'Do not fail when context contract validation has issues')
+    .option('--moqui-config <path>', 'Moqui adapter runtime config path')
+    .option('--out-dir <path>', 'Loop artifact root directory')
+    .option('--out <path>', 'Loop summary output file path')
+    .option('--work-order-out <path>', 'Work-order JSON output file path')
+    .option('--work-order-markdown-out <path>', 'Work-order markdown output file path')
+    .option('--approval-actor <id>', 'Approval workflow actor')
+    .option('--approval-actor-role <name>', 'Approval workflow actor role')
+    .option('--approver-actor <id>', 'Auto-approve actor')
+    .option('--approver-actor-role <name>', 'Auto-approve actor role')
+    .option('--approval-role-policy <path>', 'Approval role policy JSON path')
+    .option('--skip-submit', 'Skip approval submit step')
+    .option('--auto-approve-low-risk', 'Auto-approve low-risk allow plans')
+    .option('--auto-execute-low-risk', 'Auto-run low-risk apply for allow+low plans')
+    .option('--allow-suggestion-apply', 'Allow applying plans generated in suggestion mode')
+    .option('--live-apply', 'Enable live apply mode')
+    .option('--no-dry-run', 'Disable dry-run simulation')
+    .option('--feedback-score <number>', 'Optional feedback score (0-5)')
+    .option('--feedback-comment <text>', 'Optional feedback comment')
+    .option('--feedback-tags <csv>', 'Optional feedback tags (comma-separated)')
+    .option('--feedback-channel <channel>', 'Feedback channel (ui|cli|api|other)', 'ui')
+    .option('--auth-password <text>', 'One-time password for protected execute action')
+    .option('--auth-password-hash <sha256>', 'Password verifier hash override')
+    .option('--auth-password-env <name>', 'Password hash environment variable name')
+    .option('--fail-on-dialogue-deny', 'Exit code 2 when dialogue decision is deny')
+    .option('--fail-on-gate-deny', 'Exit code 2 when gate decision is deny')
+    .option('--fail-on-gate-non-allow', 'Exit code 2 when gate decision is deny/review-required')
+    .option('--fail-on-runtime-non-allow', 'Exit code 2 when runtime decision is deny/review-required')
+    .option('--fail-on-execute-blocked', 'Exit code 2 when auto execute result is blocked/non-success')
+    .option('--json', 'Print payload as JSON')
+    .action(async (options) => {
+      await runSceneInteractiveLoopCommand(options);
+    });
+
+  sceneCmd
+    .command('context-bridge')
+    .description('Normalize provider payload into SCE interactive page-context contract')
+    .option('--input <path>', 'Raw provider payload JSON path')
+    .option('--provider <name>', 'Provider dialect (moqui|generic)', 'moqui')
+    .option('--out-context <path>', 'Normalized page-context output path')
+    .option('--out-report <path>', 'Bridge report output path')
+    .option('--context-contract <path>', 'Context contract override path')
+    .option('--no-strict-contract', 'Do not fail when context contract validation has issues')
+    .option('--json', 'Print payload as JSON')
+    .action(async (options) => {
+      await runSceneContextBridgeCommand(options);
+    });
+
+  sceneCmd
+    .command('interactive-flow')
+    .description('Run one-command interactive flow (context-bridge -> interactive-loop)')
+    .option('--input <path>', 'Raw provider payload JSON path')
+    .option('--provider <name>', 'Provider dialect (moqui|generic)', 'moqui')
+    .option('--goal <text>', 'Business goal text')
+    .option('--goal-file <path>', 'Path to business goal text file')
+    .option('--user-id <id>', 'User identifier')
+    .option('--session-id <id>', 'Session identifier')
+    .option('--execution-mode <mode>', 'suggestion|apply', 'suggestion')
+    .option('--policy <path>', 'Guardrail policy override path')
+    .option('--catalog <path>', 'High-risk catalog override path')
+    .option('--dialogue-policy <path>', 'Dialogue governance policy override path')
+    .option('--dialogue-out <path>', 'Dialogue governance report output path')
+    .option('--runtime-mode <name>', 'Runtime mode (user-assist|ops-fix|feature-dev)', 'ops-fix')
+    .option('--runtime-environment <name>', 'Runtime environment (dev|staging|prod)', 'staging')
+    .option('--runtime-policy <path>', 'Runtime mode/environment policy override path')
+    .option('--runtime-out <path>', 'Runtime policy evaluation output path')
+    .option('--context-contract <path>', 'Context contract override path')
+    .option('--no-strict-contract', 'Do not fail when context contract validation has issues')
+    .option('--moqui-config <path>', 'Moqui adapter runtime config path')
+    .option('--out-dir <path>', 'Flow artifact root directory')
+    .option('--bridge-out-context <path>', 'Bridge normalized context output file path')
+    .option('--bridge-out-report <path>', 'Bridge report output file path')
+    .option('--loop-out <path>', 'Interactive-loop summary output file path')
+    .option('--work-order-out <path>', 'Work-order JSON output file path')
+    .option('--work-order-markdown-out <path>', 'Work-order markdown output file path')
+    .option('--out <path>', 'Flow summary output file path')
+    .option('--approval-actor <id>', 'Approval workflow actor')
+    .option('--approval-actor-role <name>', 'Approval workflow actor role')
+    .option('--approver-actor <id>', 'Auto-approve actor')
+    .option('--approver-actor-role <name>', 'Auto-approve actor role')
+    .option('--approval-role-policy <path>', 'Approval role policy JSON path')
+    .option('--skip-submit', 'Skip approval submit step')
+    .option('--auto-approve-low-risk', 'Auto-approve low-risk allow plans')
+    .option('--auto-execute-low-risk', 'Auto-run low-risk apply for allow+low plans')
+    .option('--allow-suggestion-apply', 'Allow applying plans generated in suggestion mode')
+    .option('--live-apply', 'Enable live apply mode')
+    .option('--no-dry-run', 'Disable dry-run simulation')
+    .option('--feedback-score <number>', 'Optional feedback score (0-5)')
+    .option('--feedback-comment <text>', 'Optional feedback comment')
+    .option('--feedback-tags <csv>', 'Optional feedback tags (comma-separated)')
+    .option('--feedback-channel <channel>', 'Feedback channel (ui|cli|api|other)', 'ui')
+    .option('--auth-password <text>', 'One-time password for protected execute action')
+    .option('--auth-password-hash <sha256>', 'Password verifier hash override')
+    .option('--auth-password-env <name>', 'Password hash environment variable name')
+    .option('--fail-on-dialogue-deny', 'Exit code 2 when dialogue decision is deny')
+    .option('--fail-on-gate-deny', 'Exit code 2 when gate decision is deny')
+    .option('--fail-on-gate-non-allow', 'Exit code 2 when gate decision is deny/review-required')
+    .option('--fail-on-runtime-non-allow', 'Exit code 2 when runtime decision is deny/review-required')
+    .option('--fail-on-execute-blocked', 'Exit code 2 when auto execute result is blocked/non-success')
+    .option('--no-matrix', 'Disable matrix baseline snapshot stage')
+    .option('--matrix-template-dir <path>', 'Template library path for matrix stage')
+    .option('--matrix-match <regex>', 'Matrix selector regex')
+    .option('--matrix-include-all', 'Score all templates in matrix stage')
+    .option('--matrix-min-score <number>', 'Matrix min semantic score (0-100)')
+    .option('--matrix-min-valid-rate <number>', 'Matrix min ontology valid-rate (0-100)')
+    .option('--matrix-compare-with <path>', 'Previous matrix baseline report path')
+    .option('--matrix-out <path>', 'Matrix JSON report output path')
+    .option('--matrix-markdown-out <path>', 'Matrix markdown report output path')
+    .option('--matrix-signals <path>', 'Matrix signal JSONL append path')
+    .option('--matrix-fail-on-portfolio-fail', 'Exit non-zero when matrix portfolio baseline fails')
+    .option('--matrix-fail-on-regression', 'Exit code 2 when matrix regressions are detected')
+    .option('--matrix-fail-on-error', 'Exit non-zero when matrix stage fails unexpectedly')
+    .option('--json', 'Print payload as JSON')
+    .action(async (options) => {
+      await runSceneInteractiveFlowCommand(options);
+    });
+
   sceneCmd
     .command('instantiate')
     .description('Instantiate scene template package with full pipeline (resolve, validate, render, manifest, log, hook)')
@@ -10981,6 +11116,239 @@ function validateSceneTemplateResolveOptions(options) {
   return null;
 }
 
+function normalizeSceneContextBridgeOptions(options = {}) {
+  return {
+    input: options.input ? String(options.input).trim() : undefined,
+    provider: options.provider ? String(options.provider).trim().toLowerCase() : 'moqui',
+    outContext: options.outContext ? String(options.outContext).trim() : undefined,
+    outReport: options.outReport ? String(options.outReport).trim() : undefined,
+    contextContract: options.contextContract ? String(options.contextContract).trim() : undefined,
+    strictContract: options.strictContract !== false,
+    json: options.json === true
+  };
+}
+
+function validateSceneContextBridgeOptions(options) {
+  if (!options.input || typeof options.input !== 'string' || options.input.trim().length === 0) {
+    return '--input is required';
+  }
+  if (!['moqui', 'generic'].includes(String(options.provider || '').trim().toLowerCase())) {
+    return '--provider must be one of: moqui, generic';
+  }
+  if (options.contextContract !== undefined && (!options.contextContract || options.contextContract.length === 0)) {
+    return '--context-contract cannot be empty';
+  }
+  return null;
+}
+
+function normalizeSceneInteractiveFlowOptions(options = {}) {
+  const feedbackScore = options.feedbackScore !== undefined ? Number(options.feedbackScore) : null;
+  const matrixMinScore = options.matrixMinScore !== undefined ? Number(options.matrixMinScore) : null;
+  const matrixMinValidRate = options.matrixMinValidRate !== undefined ? Number(options.matrixMinValidRate) : null;
+  return {
+    input: options.input ? String(options.input).trim() : undefined,
+    provider: options.provider ? String(options.provider).trim().toLowerCase() : 'moqui',
+    goal: options.goal ? String(options.goal).trim() : undefined,
+    goalFile: options.goalFile ? String(options.goalFile).trim() : undefined,
+    userId: options.userId ? String(options.userId).trim() : undefined,
+    sessionId: options.sessionId ? String(options.sessionId).trim() : undefined,
+    executionMode: options.executionMode ? String(options.executionMode).trim() : 'suggestion',
+    policy: options.policy ? String(options.policy).trim() : undefined,
+    catalog: options.catalog ? String(options.catalog).trim() : undefined,
+    dialoguePolicy: options.dialoguePolicy ? String(options.dialoguePolicy).trim() : undefined,
+    dialogueOut: options.dialogueOut ? String(options.dialogueOut).trim() : undefined,
+    runtimeMode: options.runtimeMode ? String(options.runtimeMode).trim().toLowerCase() : 'ops-fix',
+    runtimeEnvironment: options.runtimeEnvironment ? String(options.runtimeEnvironment).trim().toLowerCase() : 'staging',
+    runtimePolicy: options.runtimePolicy ? String(options.runtimePolicy).trim() : undefined,
+    runtimeOut: options.runtimeOut ? String(options.runtimeOut).trim() : undefined,
+    contextContract: options.contextContract ? String(options.contextContract).trim() : undefined,
+    strictContract: options.strictContract !== false,
+    moquiConfig: options.moquiConfig ? String(options.moquiConfig).trim() : undefined,
+    outDir: options.outDir ? String(options.outDir).trim() : undefined,
+    out: options.out ? String(options.out).trim() : undefined,
+    loopOut: options.loopOut ? String(options.loopOut).trim() : undefined,
+    workOrderOut: options.workOrderOut ? String(options.workOrderOut).trim() : undefined,
+    workOrderMarkdownOut: options.workOrderMarkdownOut ? String(options.workOrderMarkdownOut).trim() : undefined,
+    bridgeOutContext: options.bridgeOutContext ? String(options.bridgeOutContext).trim() : undefined,
+    bridgeOutReport: options.bridgeOutReport ? String(options.bridgeOutReport).trim() : undefined,
+    approvalActor: options.approvalActor ? String(options.approvalActor).trim() : undefined,
+    approvalActorRole: options.approvalActorRole ? String(options.approvalActorRole).trim().toLowerCase() : undefined,
+    approverActor: options.approverActor ? String(options.approverActor).trim() : undefined,
+    approverActorRole: options.approverActorRole ? String(options.approverActorRole).trim().toLowerCase() : undefined,
+    approvalRolePolicy: options.approvalRolePolicy ? String(options.approvalRolePolicy).trim() : undefined,
+    skipSubmit: options.skipSubmit === true,
+    autoApproveLowRisk: options.autoApproveLowRisk === true,
+    autoExecuteLowRisk: options.autoExecuteLowRisk === true,
+    allowSuggestionApply: options.allowSuggestionApply === true,
+    liveApply: options.liveApply === true,
+    dryRun: options.dryRun !== false,
+    feedbackScore,
+    feedbackComment: options.feedbackComment ? String(options.feedbackComment).trim() : undefined,
+    feedbackTags: options.feedbackTags ? String(options.feedbackTags).trim() : undefined,
+    feedbackChannel: options.feedbackChannel ? String(options.feedbackChannel).trim().toLowerCase() : 'ui',
+    authPassword: options.authPassword != null ? String(options.authPassword) : undefined,
+    authPasswordHash: options.authPasswordHash ? String(options.authPasswordHash).trim().toLowerCase() : undefined,
+    authPasswordEnv: options.authPasswordEnv ? String(options.authPasswordEnv).trim() : undefined,
+    failOnDialogueDeny: options.failOnDialogueDeny === true,
+    failOnGateDeny: options.failOnGateDeny === true,
+    failOnGateNonAllow: options.failOnGateNonAllow === true,
+    failOnRuntimeNonAllow: options.failOnRuntimeNonAllow === true,
+    failOnExecuteBlocked: options.failOnExecuteBlocked === true,
+    matrix: options.matrix !== false,
+    matrixTemplateDir: options.matrixTemplateDir ? String(options.matrixTemplateDir).trim() : undefined,
+    matrixMatch: options.matrixMatch ? String(options.matrixMatch).trim() : undefined,
+    matrixIncludeAll: options.matrixIncludeAll === true,
+    matrixMinScore,
+    matrixMinValidRate,
+    matrixCompareWith: options.matrixCompareWith ? String(options.matrixCompareWith).trim() : undefined,
+    matrixOut: options.matrixOut ? String(options.matrixOut).trim() : undefined,
+    matrixMarkdownOut: options.matrixMarkdownOut ? String(options.matrixMarkdownOut).trim() : undefined,
+    matrixSignals: options.matrixSignals ? String(options.matrixSignals).trim() : undefined,
+    matrixFailOnPortfolioFail: options.matrixFailOnPortfolioFail === true,
+    matrixFailOnRegression: options.matrixFailOnRegression === true,
+    matrixFailOnError: options.matrixFailOnError === true,
+    json: options.json === true
+  };
+}
+
+function validateSceneInteractiveFlowOptions(options) {
+  if (!options.input || typeof options.input !== 'string' || options.input.trim().length === 0) {
+    return '--input is required';
+  }
+  if (!['moqui', 'generic'].includes(String(options.provider || '').trim().toLowerCase())) {
+    return '--provider must be one of: moqui, generic';
+  }
+  if ((!options.goal || options.goal.length === 0) && (!options.goalFile || options.goalFile.length === 0)) {
+    return 'either --goal or --goal-file is required';
+  }
+  if (!['suggestion', 'apply'].includes(String(options.executionMode || '').trim())) {
+    return '--execution-mode must be suggestion or apply';
+  }
+  if (!['user-assist', 'ops-fix', 'feature-dev'].includes(String(options.runtimeMode || '').trim().toLowerCase())) {
+    return '--runtime-mode must be one of: user-assist, ops-fix, feature-dev';
+  }
+  if (!['dev', 'staging', 'prod'].includes(String(options.runtimeEnvironment || '').trim().toLowerCase())) {
+    return '--runtime-environment must be one of: dev, staging, prod';
+  }
+  if (options.contextContract !== undefined && (!options.contextContract || options.contextContract.length === 0)) {
+    return '--context-contract cannot be empty';
+  }
+  if (options.feedbackScore !== null) {
+    if (!Number.isFinite(options.feedbackScore) || options.feedbackScore < 0 || options.feedbackScore > 5) {
+      return '--feedback-score must be a number between 0 and 5';
+    }
+  }
+  const feedbackChannel = String(options.feedbackChannel || '').trim().toLowerCase();
+  if (!['ui', 'cli', 'api', 'other'].includes(feedbackChannel)) {
+    return '--feedback-channel must be one of: ui, cli, api, other';
+  }
+  if (options.authPasswordHash !== undefined && !/^[a-f0-9]{64}$/i.test(options.authPasswordHash)) {
+    return '--auth-password-hash must be a sha256 hex string (64 chars)';
+  }
+  if (options.authPasswordEnv !== undefined && String(options.authPasswordEnv).trim().length === 0) {
+    return '--auth-password-env cannot be empty';
+  }
+  if (options.matrixMinScore != null) {
+    if (!Number.isFinite(options.matrixMinScore) || options.matrixMinScore < 0 || options.matrixMinScore > 100) {
+      return '--matrix-min-score must be a number between 0 and 100';
+    }
+  }
+  if (options.matrixMinValidRate != null) {
+    if (!Number.isFinite(options.matrixMinValidRate) || options.matrixMinValidRate < 0 || options.matrixMinValidRate > 100) {
+      return '--matrix-min-valid-rate must be a number between 0 and 100';
+    }
+  }
+  return null;
+}
+
+function normalizeSceneInteractiveLoopOptions(options = {}) {
+  const feedbackScore = options.feedbackScore !== undefined ? Number(options.feedbackScore) : null;
+  return {
+    context: options.context ? String(options.context).trim() : undefined,
+    goal: options.goal ? String(options.goal).trim() : undefined,
+    goalFile: options.goalFile ? String(options.goalFile).trim() : undefined,
+    userId: options.userId ? String(options.userId).trim() : undefined,
+    sessionId: options.sessionId ? String(options.sessionId).trim() : undefined,
+    executionMode: options.executionMode ? String(options.executionMode).trim() : 'suggestion',
+    policy: options.policy ? String(options.policy).trim() : undefined,
+    catalog: options.catalog ? String(options.catalog).trim() : undefined,
+    dialoguePolicy: options.dialoguePolicy ? String(options.dialoguePolicy).trim() : undefined,
+    dialogueOut: options.dialogueOut ? String(options.dialogueOut).trim() : undefined,
+    runtimeMode: options.runtimeMode ? String(options.runtimeMode).trim().toLowerCase() : 'ops-fix',
+    runtimeEnvironment: options.runtimeEnvironment ? String(options.runtimeEnvironment).trim().toLowerCase() : 'staging',
+    runtimePolicy: options.runtimePolicy ? String(options.runtimePolicy).trim() : undefined,
+    runtimeOut: options.runtimeOut ? String(options.runtimeOut).trim() : undefined,
+    contextContract: options.contextContract ? String(options.contextContract).trim() : undefined,
+    strictContract: options.strictContract !== false,
+    moquiConfig: options.moquiConfig ? String(options.moquiConfig).trim() : undefined,
+    outDir: options.outDir ? String(options.outDir).trim() : undefined,
+    out: options.out ? String(options.out).trim() : undefined,
+    workOrderOut: options.workOrderOut ? String(options.workOrderOut).trim() : undefined,
+    workOrderMarkdownOut: options.workOrderMarkdownOut ? String(options.workOrderMarkdownOut).trim() : undefined,
+    approvalActor: options.approvalActor ? String(options.approvalActor).trim() : undefined,
+    approvalActorRole: options.approvalActorRole ? String(options.approvalActorRole).trim().toLowerCase() : undefined,
+    approverActor: options.approverActor ? String(options.approverActor).trim() : undefined,
+    approverActorRole: options.approverActorRole ? String(options.approverActorRole).trim().toLowerCase() : undefined,
+    approvalRolePolicy: options.approvalRolePolicy ? String(options.approvalRolePolicy).trim() : undefined,
+    skipSubmit: options.skipSubmit === true,
+    autoApproveLowRisk: options.autoApproveLowRisk === true,
+    autoExecuteLowRisk: options.autoExecuteLowRisk === true,
+    allowSuggestionApply: options.allowSuggestionApply === true,
+    liveApply: options.liveApply === true,
+    dryRun: options.dryRun !== false,
+    feedbackScore,
+    feedbackComment: options.feedbackComment ? String(options.feedbackComment).trim() : undefined,
+    feedbackTags: options.feedbackTags ? String(options.feedbackTags).trim() : undefined,
+    feedbackChannel: options.feedbackChannel ? String(options.feedbackChannel).trim().toLowerCase() : 'ui',
+    authPassword: options.authPassword != null ? String(options.authPassword) : undefined,
+    authPasswordHash: options.authPasswordHash ? String(options.authPasswordHash).trim().toLowerCase() : undefined,
+    authPasswordEnv: options.authPasswordEnv ? String(options.authPasswordEnv).trim() : undefined,
+    failOnDialogueDeny: options.failOnDialogueDeny === true,
+    failOnGateDeny: options.failOnGateDeny === true,
+    failOnGateNonAllow: options.failOnGateNonAllow === true,
+    failOnRuntimeNonAllow: options.failOnRuntimeNonAllow === true,
+    failOnExecuteBlocked: options.failOnExecuteBlocked === true,
+    json: options.json === true
+  };
+}
+
+function validateSceneInteractiveLoopOptions(options) {
+  if (!options.context || typeof options.context !== 'string' || options.context.trim().length === 0) {
+    return '--context is required';
+  }
+  if ((!options.goal || options.goal.length === 0) && (!options.goalFile || options.goalFile.length === 0)) {
+    return 'either --goal or --goal-file is required';
+  }
+  if (!['suggestion', 'apply'].includes(String(options.executionMode || '').trim())) {
+    return '--execution-mode must be suggestion or apply';
+  }
+  if (!['user-assist', 'ops-fix', 'feature-dev'].includes(String(options.runtimeMode || '').trim().toLowerCase())) {
+    return '--runtime-mode must be one of: user-assist, ops-fix, feature-dev';
+  }
+  if (!['dev', 'staging', 'prod'].includes(String(options.runtimeEnvironment || '').trim().toLowerCase())) {
+    return '--runtime-environment must be one of: dev, staging, prod';
+  }
+  if (options.contextContract !== undefined && (!options.contextContract || options.contextContract.length === 0)) {
+    return '--context-contract cannot be empty';
+  }
+  if (options.feedbackScore !== null) {
+    if (!Number.isFinite(options.feedbackScore) || options.feedbackScore < 0 || options.feedbackScore > 5) {
+      return '--feedback-score must be a number between 0 and 5';
+    }
+  }
+  const feedbackChannel = String(options.feedbackChannel || '').trim().toLowerCase();
+  if (!['ui', 'cli', 'api', 'other'].includes(feedbackChannel)) {
+    return '--feedback-channel must be one of: ui, cli, api, other';
+  }
+  if (options.authPasswordHash !== undefined && !/^[a-f0-9]{64}$/i.test(options.authPasswordHash)) {
+    return '--auth-password-hash must be a sha256 hex string (64 chars)';
+  }
+  if (options.authPasswordEnv !== undefined && String(options.authPasswordEnv).trim().length === 0) {
+    return '--auth-password-env cannot be empty';
+  }
+  return null;
+}
+
 function normalizeSceneMoquiBaselineOptions(options = {}) {
   const minScore = Number(options.minScore);
   const minValidRate = Number(options.minValidRate);
@@ -11139,6 +11507,496 @@ function printSceneTemplateRenderSummary(options, payload, projectRoot = process
 
 // --- Command runners for template commands ---
 
+async function runSceneContextBridgeCommand(rawOptions = {}, dependencies = {}) {
+  const projectRoot = dependencies.projectRoot || process.cwd();
+  const fileSystem = dependencies.fileSystem || fs;
+
+  const options = normalizeSceneContextBridgeOptions(rawOptions);
+  const validationError = validateSceneContextBridgeOptions(options);
+  if (validationError) {
+    console.error(chalk.red(`Scene context-bridge failed: ${validationError}`));
+    process.exitCode = 1;
+    return null;
+  }
+
+  const scriptPath = path.join(projectRoot, 'scripts', 'interactive-context-bridge.js');
+  const scriptExists = await fileSystem.pathExists(scriptPath);
+  if (!scriptExists) {
+    console.error(chalk.red(`Scene context-bridge failed: script not found at ${scriptPath}`));
+    process.exitCode = 1;
+    return null;
+  }
+
+  const args = [scriptPath, '--input', options.input, '--provider', options.provider];
+  if (options.outContext) {
+    args.push('--out-context', options.outContext);
+  }
+  if (options.outReport) {
+    args.push('--out-report', options.outReport);
+  }
+  if (options.contextContract) {
+    args.push('--context-contract', options.contextContract);
+  }
+  if (!options.strictContract) {
+    args.push('--no-strict-contract');
+  }
+  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 context-bridge 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 runSceneInteractiveFlowCommand(rawOptions = {}, dependencies = {}) {
+  const projectRoot = dependencies.projectRoot || process.cwd();
+  const fileSystem = dependencies.fileSystem || fs;
+
+  const options = normalizeSceneInteractiveFlowOptions(rawOptions);
+  const validationError = validateSceneInteractiveFlowOptions(options);
+  if (validationError) {
+    console.error(chalk.red(`Scene interactive-flow failed: ${validationError}`));
+    process.exitCode = 1;
+    return null;
+  }
+
+  const scriptPath = path.join(projectRoot, 'scripts', 'interactive-flow.js');
+  const scriptExists = await fileSystem.pathExists(scriptPath);
+  if (!scriptExists) {
+    console.error(chalk.red(`Scene interactive-flow failed: script not found at ${scriptPath}`));
+    process.exitCode = 1;
+    return null;
+  }
+
+  const args = [scriptPath, '--input', options.input, '--provider', options.provider];
+  if (options.goal) {
+    args.push('--goal', options.goal);
+  } else if (options.goalFile) {
+    args.push('--goal-file', options.goalFile);
+  }
+  args.push('--execution-mode', options.executionMode);
+  if (options.userId) {
+    args.push('--user-id', options.userId);
+  }
+  if (options.sessionId) {
+    args.push('--session-id', options.sessionId);
+  }
+  if (options.policy) {
+    args.push('--policy', options.policy);
+  }
+  if (options.catalog) {
+    args.push('--catalog', options.catalog);
+  }
+  if (options.dialoguePolicy) {
+    args.push('--dialogue-policy', options.dialoguePolicy);
+  }
+  if (options.dialogueOut) {
+    args.push('--dialogue-out', options.dialogueOut);
+  }
+  if (options.runtimeMode) {
+    args.push('--runtime-mode', options.runtimeMode);
+  }
+  if (options.runtimeEnvironment) {
+    args.push('--runtime-environment', options.runtimeEnvironment);
+  }
+  if (options.runtimePolicy) {
+    args.push('--runtime-policy', options.runtimePolicy);
+  }
+  if (options.runtimeOut) {
+    args.push('--runtime-out', options.runtimeOut);
+  }
+  if (options.contextContract) {
+    args.push('--context-contract', options.contextContract);
+  }
+  if (!options.strictContract) {
+    args.push('--no-strict-contract');
+  }
+  if (options.moquiConfig) {
+    args.push('--moqui-config', options.moquiConfig);
+  }
+  if (options.outDir) {
+    args.push('--out-dir', options.outDir);
+  }
+  if (options.bridgeOutContext) {
+    args.push('--bridge-out-context', options.bridgeOutContext);
+  }
+  if (options.bridgeOutReport) {
+    args.push('--bridge-out-report', options.bridgeOutReport);
+  }
+  if (options.loopOut) {
+    args.push('--loop-out', options.loopOut);
+  }
+  if (options.workOrderOut) {
+    args.push('--work-order-out', options.workOrderOut);
+  }
+  if (options.workOrderMarkdownOut) {
+    args.push('--work-order-markdown-out', options.workOrderMarkdownOut);
+  }
+  if (options.out) {
+    args.push('--out', options.out);
+  }
+  if (options.approvalActor) {
+    args.push('--approval-actor', options.approvalActor);
+  }
+  if (options.approvalActorRole) {
+    args.push('--approval-actor-role', options.approvalActorRole);
+  }
+  if (options.approverActor) {
+    args.push('--approver-actor', options.approverActor);
+  }
+  if (options.approverActorRole) {
+    args.push('--approver-actor-role', options.approverActorRole);
+  }
+  if (options.approvalRolePolicy) {
+    args.push('--approval-role-policy', options.approvalRolePolicy);
+  }
+  if (options.skipSubmit) {
+    args.push('--skip-submit');
+  }
+  if (options.autoApproveLowRisk) {
+    args.push('--auto-approve-low-risk');
+  }
+  if (options.autoExecuteLowRisk) {
+    args.push('--auto-execute-low-risk');
+  }
+  if (options.allowSuggestionApply) {
+    args.push('--allow-suggestion-apply');
+  }
+  if (options.liveApply) {
+    args.push('--live-apply');
+  }
+  if (!options.dryRun) {
+    args.push('--no-dry-run');
+  }
+  if (options.feedbackScore !== null) {
+    args.push('--feedback-score', String(options.feedbackScore));
+  }
+  if (options.feedbackComment) {
+    args.push('--feedback-comment', options.feedbackComment);
+  }
+  if (options.feedbackTags) {
+    args.push('--feedback-tags', options.feedbackTags);
+  }
+  if (options.feedbackChannel) {
+    args.push('--feedback-channel', options.feedbackChannel);
+  }
+  if (options.authPassword) {
+    args.push('--auth-password', options.authPassword);
+  }
+  if (options.authPasswordHash) {
+    args.push('--auth-password-hash', options.authPasswordHash);
+  }
+  if (options.authPasswordEnv) {
+    args.push('--auth-password-env', options.authPasswordEnv);
+  }
+  if (options.failOnDialogueDeny) {
+    args.push('--fail-on-dialogue-deny');
+  }
+  if (options.failOnGateDeny) {
+    args.push('--fail-on-gate-deny');
+  }
+  if (options.failOnGateNonAllow) {
+    args.push('--fail-on-gate-non-allow');
+  }
+  if (options.failOnRuntimeNonAllow) {
+    args.push('--fail-on-runtime-non-allow');
+  }
+  if (options.failOnExecuteBlocked) {
+    args.push('--fail-on-execute-blocked');
+  }
+  if (!options.matrix) {
+    args.push('--no-matrix');
+  }
+  if (options.matrixTemplateDir) {
+    args.push('--matrix-template-dir', options.matrixTemplateDir);
+  }
+  if (options.matrixMatch) {
+    args.push('--matrix-match', options.matrixMatch);
+  }
+  if (options.matrixIncludeAll) {
+    args.push('--matrix-include-all');
+  }
+  if (options.matrixMinScore !== null) {
+    args.push('--matrix-min-score', String(options.matrixMinScore));
+  }
+  if (options.matrixMinValidRate !== null) {
+    args.push('--matrix-min-valid-rate', String(options.matrixMinValidRate));
+  }
+  if (options.matrixCompareWith) {
+    args.push('--matrix-compare-with', options.matrixCompareWith);
+  }
+  if (options.matrixOut) {
+    args.push('--matrix-out', options.matrixOut);
+  }
+  if (options.matrixMarkdownOut) {
+    args.push('--matrix-markdown-out', options.matrixMarkdownOut);
+  }
+  if (options.matrixSignals) {
+    args.push('--matrix-signals', options.matrixSignals);
+  }
+  if (options.matrixFailOnPortfolioFail) {
+    args.push('--matrix-fail-on-portfolio-fail');
+  }
+  if (options.matrixFailOnRegression) {
+    args.push('--matrix-fail-on-regression');
+  }
+  if (options.matrixFailOnError) {
+    args.push('--matrix-fail-on-error');
+  }
+  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 interactive-flow 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 runSceneInteractiveLoopCommand(rawOptions = {}, dependencies = {}) {
+  const projectRoot = dependencies.projectRoot || process.cwd();
+  const fileSystem = dependencies.fileSystem || fs;
+
+  const options = normalizeSceneInteractiveLoopOptions(rawOptions);
+  const validationError = validateSceneInteractiveLoopOptions(options);
+  if (validationError) {
+    console.error(chalk.red(`Scene interactive-loop failed: ${validationError}`));
+    process.exitCode = 1;
+    return null;
+  }
+
+  const scriptPath = path.join(projectRoot, 'scripts', 'interactive-customization-loop.js');
+  const scriptExists = await fileSystem.pathExists(scriptPath);
+  if (!scriptExists) {
+    console.error(chalk.red(`Scene interactive-loop failed: script not found at ${scriptPath}`));
+    process.exitCode = 1;
+    return null;
+  }
+
+  const args = [scriptPath];
+  args.push('--context', options.context);
+  if (options.goal) {
+    args.push('--goal', options.goal);
+  } else if (options.goalFile) {
+    args.push('--goal-file', options.goalFile);
+  }
+  args.push('--execution-mode', options.executionMode);
+  if (options.userId) {
+    args.push('--user-id', options.userId);
+  }
+  if (options.sessionId) {
+    args.push('--session-id', options.sessionId);
+  }
+  if (options.policy) {
+    args.push('--policy', options.policy);
+  }
+  if (options.catalog) {
+    args.push('--catalog', options.catalog);
+  }
+  if (options.dialoguePolicy) {
+    args.push('--dialogue-policy', options.dialoguePolicy);
+  }
+  if (options.dialogueOut) {
+    args.push('--dialogue-out', options.dialogueOut);
+  }
+  if (options.runtimeMode) {
+    args.push('--runtime-mode', options.runtimeMode);
+  }
+  if (options.runtimeEnvironment) {
+    args.push('--runtime-environment', options.runtimeEnvironment);
+  }
+  if (options.runtimePolicy) {
+    args.push('--runtime-policy', options.runtimePolicy);
+  }
+  if (options.runtimeOut) {
+    args.push('--runtime-out', options.runtimeOut);
+  }
+  if (options.contextContract) {
+    args.push('--context-contract', options.contextContract);
+  }
+  if (!options.strictContract) {
+    args.push('--no-strict-contract');
+  }
+  if (options.moquiConfig) {
+    args.push('--moqui-config', options.moquiConfig);
+  }
+  if (options.outDir) {
+    args.push('--out-dir', options.outDir);
+  }
+  if (options.out) {
+    args.push('--out', options.out);
+  }
+  if (options.workOrderOut) {
+    args.push('--work-order-out', options.workOrderOut);
+  }
+  if (options.workOrderMarkdownOut) {
+    args.push('--work-order-markdown-out', options.workOrderMarkdownOut);
+  }
+  if (options.approvalActor) {
+    args.push('--approval-actor', options.approvalActor);
+  }
+  if (options.approvalActorRole) {
+    args.push('--approval-actor-role', options.approvalActorRole);
+  }
+  if (options.approverActor) {
+    args.push('--approver-actor', options.approverActor);
+  }
+  if (options.approverActorRole) {
+    args.push('--approver-actor-role', options.approverActorRole);
+  }
+  if (options.approvalRolePolicy) {
+    args.push('--approval-role-policy', options.approvalRolePolicy);
+  }
+  if (options.skipSubmit) {
+    args.push('--skip-submit');
+  }
+  if (options.autoApproveLowRisk) {
+    args.push('--auto-approve-low-risk');
+  }
+  if (options.autoExecuteLowRisk) {
+    args.push('--auto-execute-low-risk');
+  }
+  if (options.allowSuggestionApply) {
+    args.push('--allow-suggestion-apply');
+  }
+  if (options.liveApply) {
+    args.push('--live-apply');
+  }
+  if (!options.dryRun) {
+    args.push('--no-dry-run');
+  }
+  if (options.feedbackScore !== null) {
+    args.push('--feedback-score', String(options.feedbackScore));
+  }
+  if (options.feedbackComment) {
+    args.push('--feedback-comment', options.feedbackComment);
+  }
+  if (options.feedbackTags) {
+    args.push('--feedback-tags', options.feedbackTags);
+  }
+  if (options.feedbackChannel) {
+    args.push('--feedback-channel', options.feedbackChannel);
+  }
+  if (options.authPassword) {
+    args.push('--auth-password', options.authPassword);
+  }
+  if (options.authPasswordHash) {
+    args.push('--auth-password-hash', options.authPasswordHash);
+  }
+  if (options.authPasswordEnv) {
+    args.push('--auth-password-env', options.authPasswordEnv);
+  }
+  if (options.failOnDialogueDeny) {
+    args.push('--fail-on-dialogue-deny');
+  }
+  if (options.failOnGateDeny) {
+    args.push('--fail-on-gate-deny');
+  }
+  if (options.failOnGateNonAllow) {
+    args.push('--fail-on-gate-non-allow');
+  }
+  if (options.failOnRuntimeNonAllow) {
+    args.push('--fail-on-runtime-non-allow');
+  }
+  if (options.failOnExecuteBlocked) {
+    args.push('--fail-on-execute-blocked');
+  }
+  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 interactive-loop 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 runSceneMoquiBaselineCommand(rawOptions = {}, dependencies = {}) {
   const projectRoot = dependencies.projectRoot || process.cwd();
   const fileSystem = dependencies.fileSystem || fs;
@@ -15403,8 +16261,17 @@ module.exports = {
   validateSceneTemplateValidateOptions,
   normalizeSceneTemplateResolveOptions,
   validateSceneTemplateResolveOptions,
+  normalizeSceneContextBridgeOptions,
+  validateSceneContextBridgeOptions,
+  normalizeSceneInteractiveFlowOptions,
+  validateSceneInteractiveFlowOptions,
+  normalizeSceneInteractiveLoopOptions,
+  validateSceneInteractiveLoopOptions,
   normalizeSceneMoquiBaselineOptions,
   validateSceneMoquiBaselineOptions,
+  runSceneContextBridgeCommand,
+  runSceneInteractiveFlowCommand,
+  runSceneInteractiveLoopCommand,
   runSceneMoquiBaselineCommand,
   runSceneTemplateValidateCommand,
   runSceneTemplateResolveCommand,