scene-capability-engine 3.3.4 → 3.3.10

package/lib/gitignore/layered-rules-template.js

@@ -1,38 +1,38 @@
 /**
  * Layered .gitignore rules template
  * 
- * This template defines the layered strategy for .kiro/ directory:
+ * This template defines the layered strategy for .sce/ directory:
  * - Commit Specs and shared content
  * - Exclude personal state and temporary files
  */
 
 const LAYERED_RULES_TEMPLATE = `# ========================================
-# .kiro/ Directory - Layered Management
+# .sce/ Directory - Layered Management
 # ========================================
 # Generated by sce - DO NOT EDIT THIS SECTION
 # See: docs/team-collaboration-guide.md
 
 # Personal state files (DO NOT commit)
-.kiro/steering/CURRENT_CONTEXT.md
-.kiro/contexts/.active
-.kiro/contexts/*/CURRENT_CONTEXT.md
+.sce/steering/CURRENT_CONTEXT.md
+.sce/contexts/.active
+.sce/contexts/*/CURRENT_CONTEXT.md
 
 # Environment configuration (DO NOT commit)
-.kiro/environments.json
-.kiro/env-backups/
+.sce/environments.json
+.sce/env-backups/
 
 # Temporary files and backups (DO NOT commit)
-.kiro/backups/
-.kiro/logs/
-.kiro/reports/
+.sce/backups/
+.sce/logs/
+.sce/reports/
 
 # Spec artifacts (COMMIT - but exclude temporary files)
-.kiro/specs/**/SESSION-*.md
-.kiro/specs/**/*-SUMMARY.md
-.kiro/specs/**/*-COMPLETE.md
-.kiro/specs/**/TEMP-*.md
-.kiro/specs/**/WIP-*.md
-.kiro/specs/**/MVP-*.md
+.sce/specs/**/SESSION-*.md
+.sce/specs/**/*-SUMMARY.md
+.sce/specs/**/*-COMPLETE.md
+.sce/specs/**/TEMP-*.md
+.sce/specs/**/WIP-*.md
+.sce/specs/**/MVP-*.md
 
 # ========================================
 # End of sce-managed section

package/lib/governance/config-manager.js

@@ -10,7 +10,7 @@ const path = require('path');
 class ConfigManager {
   constructor(projectPath) {
     this.projectPath = projectPath;
-    this.configPath = path.join(projectPath, '.kiro/config/docs.json');
+    this.configPath = path.join(projectPath, '.sce/config/docs.json');
     this.config = null;
   }
   

package/lib/governance/doc-reference-checker.js

@@ -30,10 +30,10 @@ class DocReferenceChecker {
     
     // Files to check
     this.filesToCheck = [
-      '.kiro/specs/SPEC_WORKFLOW_GUIDE.md',
-      '.kiro/steering/ENVIRONMENT.md',
-      '.kiro/steering/CURRENT_CONTEXT.md',
-      '.kiro/README.md',
+      '.sce/specs/SPEC_WORKFLOW_GUIDE.md',
+      '.sce/steering/ENVIRONMENT.md',
+      '.sce/steering/CURRENT_CONTEXT.md',
+      '.sce/README.md',
       'README.md',
       'package.json'
     ];

package/lib/governance/execution-logger.js

@@ -10,7 +10,7 @@ const path = require('path');
 class ExecutionLogger {
   constructor(projectPath) {
     this.projectPath = projectPath;
-    this.logDir = path.join(projectPath, '.kiro', 'logs');
+    this.logDir = path.join(projectPath, '.sce', 'logs');
     this.logFile = path.join(this.logDir, 'governance-history.json');
     this.maxLogSize = 10 * 1024 * 1024; // 10MB
     this.maxRotatedLogs = 5;

package/lib/governance/file-scanner.js

@@ -134,7 +134,7 @@ class FileScanner {
    * @returns {Promise<string[]>} - Array of Spec directory paths
    */
   async findSpecDirectories() {
-    const specsPath = path.join(this.projectPath, '.kiro/specs');
+    const specsPath = path.join(this.projectPath, '.sce/specs');
     
     try {
       const entries = await fs.readdir(specsPath, { withFileTypes: true });
@@ -148,7 +148,7 @@ class FileScanner {
       
       return specDirs;
     } catch (error) {
-      // If .kiro/specs doesn't exist, return empty array
+      // If .sce/specs doesn't exist, return empty array
       return [];
     }
   }
@@ -160,7 +160,7 @@ class FileScanner {
    * @returns {string} - Spec directory path
    */
   getSpecDirectory(specName) {
-    return path.join(this.projectPath, '.kiro/specs', specName);
+    return path.join(this.projectPath, '.sce/specs', specName);
   }
   
   /**

package/lib/interactive-customization/moqui-interactive-adapter.js

@@ -13,8 +13,8 @@ const {
 const ADAPTER_TYPE = 'moqui-interactive-adapter';
 const ADAPTER_VERSION = '1.0.0';
 
-const DEFAULT_EXECUTION_RECORD_OUT = '.kiro/reports/interactive-execution-record.latest.json';
-const DEFAULT_EXECUTION_LEDGER_OUT = '.kiro/reports/interactive-execution-ledger.jsonl';
+const DEFAULT_EXECUTION_RECORD_OUT = '.sce/reports/interactive-execution-record.latest.json';
+const DEFAULT_EXECUTION_LEDGER_OUT = '.sce/reports/interactive-execution-ledger.jsonl';
 
 const SUPPORTED_ACTION_TYPES = [
   'analysis_only',

package/lib/knowledge/knowledge-manager.js

@@ -12,7 +12,7 @@ const TemplateManager = require('./template-manager');
 class KnowledgeManager {
   constructor(projectRoot) {
     this.projectRoot = projectRoot;
-    this.knowledgePath = path.join(projectRoot, '.kiro', 'knowledge');
+    this.knowledgePath = path.join(projectRoot, '.sce', 'knowledge');
     
     this.entryManager = new EntryManager(this.knowledgePath);
     this.indexManager = new IndexManager(this.knowledgePath);

package/lib/lock/lock-manager.js

@@ -19,8 +19,8 @@ class LockManager {
    */
   constructor(workspaceRoot, machineIdentifier = null) {
     this.workspaceRoot = workspaceRoot;
-    this.specsDir = path.join(workspaceRoot, '.kiro', 'specs');
-    this.configDir = path.join(workspaceRoot, '.kiro', 'config');
+    this.specsDir = path.join(workspaceRoot, '.sce', 'specs');
+    this.configDir = path.join(workspaceRoot, '.sce', 'config');
     this.lockFile = new LockFile(this.specsDir);
     this.machineIdentifier = machineIdentifier || new MachineIdentifier(this.configDir);
   }

package/lib/lock/steering-file-lock.js

@@ -2,11 +2,11 @@
  * SteeringFileLock - Protects concurrent writes to Steering files
  *
  * Uses file-level locks with exclusive create (`wx`) to serialize writes
- * to `.kiro/steering/` files. When lock acquisition fails after retries,
+ * to `.sce/steering/` files. When lock acquisition fails after retries,
  * falls back to writing a pending file for later merge.
  *
- * Lock file path: `.kiro/steering/{filename}.lock`
- * Pending file path: `.kiro/steering/{filename}.pending.{agentId}`
+ * Lock file path: `.sce/steering/{filename}.lock`
+ * Pending file path: `.sce/steering/{filename}.pending.{agentId}`
  *
  * Requirements: 5.1, 5.2, 5.3, 5.4
  */
@@ -26,7 +26,7 @@ class SteeringFileLock {
    */
   constructor(workspaceRoot) {
     this._workspaceRoot = workspaceRoot;
-    this._steeringDir = path.join(workspaceRoot, '.kiro', 'steering');
+    this._steeringDir = path.join(workspaceRoot, '.sce', 'steering');
   }
 
   /**
@@ -139,7 +139,7 @@ class SteeringFileLock {
 
   /**
    * Write content to a pending file as a fallback when lock acquisition fails.
-   * Pending file path: `.kiro/steering/{filename}.pending.{agentId}`
+   * Pending file path: `.sce/steering/{filename}.pending.{agentId}`
    * Uses atomic write for file integrity (Req 5.3, 5.4).
    *
    * @param {string} filename - Steering filename

package/lib/lock/task-lock-manager.js

@@ -4,7 +4,7 @@
  * Provides per-task locking instead of per-Spec locking, allowing multiple
  * Agents to work on different tasks within the same Spec concurrently.
  *
- * Lock file path: `.kiro/specs/{specName}/locks/{taskId}.lock`
+ * Lock file path: `.sce/specs/{specName}/locks/{taskId}.lock`
  * (dots in taskId replaced with dashes for filesystem safety)
  *
  * In single-Agent mode, delegates to the existing LockManager (Spec-level lock).
@@ -27,7 +27,7 @@ class TaskLockManager {
   constructor(workspaceRoot, machineIdentifier) {
     this._workspaceRoot = workspaceRoot;
     this._machineIdentifier = machineIdentifier;
-    this._specsDir = path.join(workspaceRoot, '.kiro', 'specs');
+    this._specsDir = path.join(workspaceRoot, '.sce', 'specs');
     this._multiAgentConfig = new MultiAgentConfig(workspaceRoot);
     this._lockManager = new LockManager(workspaceRoot, machineIdentifier);
     this._taskClaimer = new TaskClaimer();
@@ -76,7 +76,7 @@ class TaskLockManager {
   /**
    * Acquire a task-level lock.
    *
-   * In multi-Agent mode: creates `.kiro/specs/{specName}/locks/{taskId}.lock`
+   * In multi-Agent mode: creates `.sce/specs/{specName}/locks/{taskId}.lock`
    * In single-Agent mode: delegates to LockManager.acquireLock(specName)
    *
    * @param {string} specName

package/lib/operations/audit-logger.js

@@ -11,7 +11,7 @@ const crypto = require('crypto');
 class AuditLogger {
   constructor(projectRoot = process.cwd()) {
     this.projectRoot = projectRoot;
-    this.auditPath = path.join(projectRoot, '.kiro/audit');
+    this.auditPath = path.join(projectRoot, '.sce/audit');
   }
   
   /**

package/lib/operations/feedback-manager.js

@@ -34,7 +34,7 @@ function generateUUID() {
 class FeedbackManager {
   constructor(projectPath) {
     this.projectPath = projectPath;
-    this.feedbackDir = path.join(projectPath, '.kiro/feedback');
+    this.feedbackDir = path.join(projectPath, '.sce/feedback');
     this.feedbackFile = path.join(this.feedbackDir, 'feedback.json');
   }
 

package/lib/operations/operations-manager.js

@@ -28,7 +28,7 @@ class OperationsManager {
   async createOperationsSpec(projectName, version = '1.0.0', templateName = 'default') {
     const operationsPath = path.join(
       this.projectRoot,
-      '.kiro/specs',
+      '.sce/specs',
       projectName,
       'operations'
     );
@@ -77,7 +77,7 @@ class OperationsManager {
   async loadOperationsSpec(projectName) {
     const operationsPath = path.join(
       this.projectRoot,
-      '.kiro/specs',
+      '.sce/specs',
       projectName,
       'operations'
     );
@@ -125,7 +125,7 @@ class OperationsManager {
    * @returns {Promise<string[]>} Array of project names with operations specs
    */
   async listOperationsSpecs() {
-    const specsPath = path.join(this.projectRoot, '.kiro/specs');
+    const specsPath = path.join(this.projectRoot, '.sce/specs');
     
     const exists = await fs.pathExists(specsPath);
     if (!exists) {

package/lib/operations/permission-manager.js

@@ -132,7 +132,7 @@ class PermissionManager {
   async loadPermissionConfig(project) {
     const configPath = path.join(
       this.projectRoot,
-      '.kiro/specs',
+      '.sce/specs',
       project,
       'operations/permissions.json'
     );
@@ -158,7 +158,7 @@ class PermissionManager {
   async savePermissionConfig(project, config) {
     const configPath = path.join(
       this.projectRoot,
-      '.kiro/specs',
+      '.sce/specs',
       project,
       'operations/permissions.json'
     );

package/lib/operations/template-loader.js

@@ -11,7 +11,7 @@ const { DocumentType } = require('./models');
 class TemplateLoader {
   constructor(templateBasePath = null) {
     // Default to package template directory
-    this.templateBasePath = templateBasePath || path.join(__dirname, '../../template/.kiro/templates/operations');
+    this.templateBasePath = templateBasePath || path.join(__dirname, '../../template/.sce/templates/operations');
   }
   
   /**

package/lib/orchestrator/agent-spawner.js

@@ -17,6 +17,8 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 
+const DEFAULT_CODEX_PERMISSION_ARGS = Object.freeze(['--ask-for-approval', 'never']);
+
 class AgentSpawner extends EventEmitter {
   /**
    * @param {string} workspaceRoot - Absolute path to the project root
@@ -40,7 +42,7 @@ class AgentSpawner extends EventEmitter {
    *
    * 1. Builds the bootstrap prompt via BootstrapPromptBuilder
    * 2. Registers the agent in AgentRegistry
-   * 3. Spawns `codex exec --full-auto --json --sandbox danger-full-access "<prompt>"`
+   * 3. Spawns `codex exec --full-auto --json --sandbox danger-full-access --ask-for-approval never "<prompt>"`
    * 4. Sets up stdout/stderr/close handlers and timeout timer
    *
    * @param {string} specName - Spec to execute (e.g. "96-00-agent-orchestrator")
@@ -72,12 +74,13 @@ class AgentSpawner extends EventEmitter {
     });
 
     // Assemble command arguments (Req 1.1, 1.3)
+    const codexArgs = this._mergeDefaultCodexPermissionArgs(config.codexArgs);
     const args = [
       'exec',
       '--full-auto',
       '--json',
       '--sandbox', 'danger-full-access',
-      ...(config.codexArgs || []),
+      ...codexArgs,
       prompt,
     ];
 
@@ -248,10 +251,163 @@ class AgentSpawner extends EventEmitter {
     return new Map(this._agents);
   }
 
+  /**
+   * Resolve a structured result summary emitted by a sub-agent.
+   * The summary is extracted from captured JSON events and used by
+   * orchestration merge-governance checks.
+   *
+   * @param {string} agentId
+   * @returns {object|null}
+   */
+  getResultSummary(agentId) {
+    const agent = this._agents.get(agentId);
+    if (!agent || !Array.isArray(agent.events)) {
+      return null;
+    }
+    return this._extractResultSummaryFromEvents(agent.events);
+  }
+
   // ---------------------------------------------------------------------------
   // Private helpers
   // ---------------------------------------------------------------------------
 
+  /**
+   * Parse known summary carriers from agent JSON events.
+   * Prefers the candidate with the most contract fields.
+   *
+   * @param {object[]} events
+   * @returns {object|null}
+   * @private
+   */
+  _extractResultSummaryFromEvents(events) {
+    const candidates = [];
+    const collect = (value) => {
+      if (!value || typeof value !== 'object') {
+        return;
+      }
+      if (this._summaryCandidateFieldCount(value) > 0) {
+        candidates.push(value);
+      }
+    };
+
+    for (const event of events) {
+      if (!event || typeof event !== 'object') {
+        continue;
+      }
+      collect(event.result_summary);
+      collect(event.summary);
+      collect(event.payload && event.payload.result_summary);
+      collect(event.payload && event.payload.summary);
+      collect(event.result && event.result.summary);
+      collect(event.data && event.data.result_summary);
+      collect(event.item && event.item.result_summary);
+
+      collect(this._tryParseSummaryFromText(event.message));
+      collect(this._tryParseSummaryFromText(event.output_text));
+      collect(this._tryParseSummaryFromText(event.text));
+      collect(this._tryParseSummaryFromText(event.item && event.item.text));
+
+      const itemContent = event.item && event.item.content;
+      if (Array.isArray(itemContent)) {
+        for (const entry of itemContent) {
+          if (typeof entry === 'string') {
+            collect(this._tryParseSummaryFromText(entry));
+          } else if (entry && typeof entry === 'object') {
+            collect(entry.result_summary);
+            collect(entry.summary);
+            collect(this._tryParseSummaryFromText(entry.text));
+          }
+        }
+      }
+    }
+
+    if (candidates.length === 0) {
+      return null;
+    }
+
+    candidates.sort((left, right) =>
+      this._summaryCandidateFieldCount(right) - this._summaryCandidateFieldCount(left));
+    return { ...candidates[0] };
+  }
+
+  /**
+   * @param {object} candidate
+   * @returns {number}
+   * @private
+   */
+  _summaryCandidateFieldCount(candidate) {
+    if (!candidate || typeof candidate !== 'object') {
+      return 0;
+    }
+    const fields = [
+      'spec_id',
+      'changed_files',
+      'tests_run',
+      'tests_passed',
+      'risk_level',
+      'open_issues'
+    ];
+    let count = 0;
+    for (const field of fields) {
+      if (Object.prototype.hasOwnProperty.call(candidate, field)) {
+        count += 1;
+      }
+    }
+    return count;
+  }
+
+  /**
+   * Attempt to parse a JSON summary object from free-form text.
+   *
+   * @param {string} text
+   * @returns {object|null}
+   * @private
+   */
+  _tryParseSummaryFromText(text) {
+    if (typeof text !== 'string') {
+      return null;
+    }
+    const trimmed = text.trim();
+    if (!trimmed || !trimmed.includes('spec_id')) {
+      return null;
+    }
+
+    const candidates = [trimmed];
+    const fenced = /```json\s*([\s\S]*?)```/gi;
+    let match;
+    while ((match = fenced.exec(trimmed)) !== null) {
+      if (match[1]) {
+        candidates.push(match[1].trim());
+      }
+    }
+
+    const firstBrace = trimmed.indexOf('{');
+    const lastBrace = trimmed.lastIndexOf('}');
+    if (firstBrace >= 0 && lastBrace > firstBrace) {
+      candidates.push(trimmed.slice(firstBrace, lastBrace + 1));
+    }
+
+    for (const candidate of candidates) {
+      if (!candidate || typeof candidate !== 'string') {
+        continue;
+      }
+      try {
+        const parsed = JSON.parse(candidate);
+        if (parsed && typeof parsed === 'object') {
+          if (parsed.result_summary && typeof parsed.result_summary === 'object') {
+            return parsed.result_summary;
+          }
+          if (this._summaryCandidateFieldCount(parsed) > 0) {
+            return parsed;
+          }
+        }
+      } catch (_err) {
+        // Ignore parse failures and continue.
+      }
+    }
+    return null;
+  }
+
   /**
    * Ensure bootstrap prompt is a non-empty string before using it in spawn args.
    * @param {unknown} prompt
@@ -624,6 +780,28 @@ class AgentSpawner extends EventEmitter {
       return false;
     }
   }
+
+  /**
+   * Merge default Codex permission flags into configured codex args.
+   * If user explicitly sets ask-for-approval mode, keep user value.
+   *
+   * @param {string[]|undefined|null} codexArgs
+   * @returns {string[]}
+   * @private
+   */
+  _mergeDefaultCodexPermissionArgs(codexArgs) {
+    const args = Array.isArray(codexArgs)
+      ? codexArgs.map(value => `${value}`)
+      : [];
+    const hasAskForApproval = args.some((token) =>
+      token === '--ask-for-approval'
+      || token === '-a'
+      || token.startsWith('--ask-for-approval='));
+    if (!hasAskForApproval) {
+      return [...args, ...DEFAULT_CODEX_PERMISSION_ARGS];
+    }
+    return args;
+  }
 }
 
 module.exports = { AgentSpawner };

package/lib/orchestrator/bootstrap-prompt-builder.js

@@ -19,6 +19,7 @@ const STEERING_FILES = [
   'CURRENT_CONTEXT.md',
   'RULES_GUIDE.md',
 ];
+const STEERING_DIR = '.sce/steering';
 
 class BootstrapPromptBuilder {
   /**
@@ -46,7 +47,7 @@ class BootstrapPromptBuilder {
    * @returns {Promise<string>} The assembled prompt
    */
   async buildPrompt(specName) {
-    const specPath = `.kiro/specs/${specName}/`;
+    const specPath = `.sce/specs/${specName}/`;
     const steeringContext = await this._loadSteeringContext();
     const taskInstructions = this._buildTaskInstructions(specName, specPath);
     const readmeSummary = await this._loadReadmeSummary();
@@ -78,17 +79,16 @@ class BootstrapPromptBuilder {
   // ---------------------------------------------------------------------------
 
   /**
-   * Load and concatenate all steering files from `.kiro/steering/`.
+   * Load and concatenate all steering files from `.sce/steering/`.
    * Missing files are silently skipped.
    * @returns {Promise<string>}
    * @private
    */
   async _loadSteeringContext() {
-    const steeringDir = path.join(this._workspaceRoot, '.kiro', 'steering');
     const sections = [];
 
     for (const filename of STEERING_FILES) {
-      const filePath = path.join(steeringDir, filename);
+      const filePath = path.join(this._workspaceRoot, STEERING_DIR, filename);
       try {
         const content = await fs.readFile(filePath, 'utf8');
         sections.push(`### ${filename}\n\n${content.trim()}`);
@@ -101,14 +101,14 @@ class BootstrapPromptBuilder {
   }
 
   /**
-   * Load a short summary from `.kiro/README.md`.
+   * Load a short summary from `.sce/README.md`.
    * Returns the first ~40 lines (up to the first `---` separator after the
    * opening block) to keep the prompt concise.
    * @returns {Promise<string>}
    * @private
    */
   async _loadReadmeSummary() {
-    const readmePath = path.join(this._workspaceRoot, '.kiro', 'README.md');
+    const readmePath = path.join(this._workspaceRoot, '.sce', 'README.md');
     try {
       const content = await fs.readFile(readmePath, 'utf8');
       // Take the first meaningful section (up to the capabilities list)
@@ -172,6 +172,9 @@ class BootstrapPromptBuilder {
       '5. Mark each task as completed (change `[ ]` or `[-]` to `[x]`) after finishing.',
       '6. Run relevant tests to verify your implementation before moving on.',
       '7. If a task fails after multiple attempts, document the issue and continue.',
+      '8. At completion, output a final JSON object named result_summary with fields:',
+      '   spec_id, changed_files, tests_run, tests_passed, risk_level, open_issues.',
+      '   Keep risk_level in: low | medium | high | unknown.',
       '',
       'Quality requirements:',
       '- All code must compile and pass linting.',