scene-capability-engine 3.3.5 → 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,
     ];
 
@@ -777,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)

package/lib/orchestrator/orchestration-engine.js

@@ -15,7 +15,7 @@ const { EventEmitter } = require('events');
 const path = require('path');
 const fsUtils = require('../utils/fs-utils');
 
-const SPECS_DIR = '.kiro/specs';
+const SPECS_DIR = '.sce/specs';
 const DEFAULT_RATE_LIMIT_MAX_RETRIES = 8;
 const DEFAULT_RATE_LIMIT_BACKOFF_BASE_MS = 1500;
 const DEFAULT_RATE_LIMIT_BACKOFF_MAX_MS = 60000;

package/lib/orchestrator/orchestrator-config.js

@@ -1,7 +1,7 @@
 /**
  * Orchestrator Configuration Manager
  *
- * Manages `.kiro/config/orchestrator.json` for the Agent Orchestrator.
+ * Manages `.sce/config/orchestrator.json` for the Agent Orchestrator.
  * When the config file does not exist or contains invalid JSON,
  * returns a default configuration so that orchestration can proceed
  * with sensible defaults.
@@ -16,7 +16,7 @@ const fs = require('fs-extra');
 const fsUtils = require('../utils/fs-utils');
 
 const CONFIG_FILENAME = 'orchestrator.json';
-const CONFIG_DIR = '.kiro/config';
+const CONFIG_DIR = '.sce/config';
 
 /** Known configuration keys — anything else is silently ignored. */
 const KNOWN_KEYS = new Set([

package/lib/repo/config-manager.js

@@ -28,7 +28,7 @@ class ConfigManager {
    * @returns {string} Absolute path to the configuration file
    */
   getConfigPath() {
-    return path.join(this.projectRoot, '.kiro', this.configFileName);
+    return path.join(this.projectRoot, '.sce', this.configFileName);
   }
 
   /**
@@ -130,7 +130,7 @@ class ConfigManager {
     const configPath = this.getConfigPath();
 
     try {
-      // Ensure .kiro directory exists
+      // Ensure .sce directory exists
       const kiroDir = path.dirname(configPath);
       await fs.mkdir(kiroDir, { recursive: true });
 
@@ -471,7 +471,7 @@ class ConfigManager {
   _isValidRepoName(name) {
     // Allow alphanumeric, hyphens, underscores, dots, and names starting with dots (hidden directories)
     // Must not contain spaces or special characters like @, #, $, etc.
-    // Examples: "backend", ".github", ".kiro", "my-repo", "repo_name", "repo.name"
+    // Examples: "backend", ".github", ".sce", "my-repo", "repo_name", "repo.name"
     const validPattern = /^\.?[a-zA-Z0-9][a-zA-Z0-9._-]*$/;
     return validPattern.test(name);
   }

package/lib/repo/handlers/init-handler.js

@@ -31,7 +31,7 @@ class InitHandler {
    * @returns {Promise<Object>} Initialization result
    */
   async execute(options = {}) {
-    const { yes = false, maxDepth = 3, exclude = ['.kiro'], nested = true } = options;
+    const { yes = false, maxDepth = 3, exclude = ['.sce'], nested = true } = options;
 
     // Check if configuration already exists
     const configExists = await this.configManager.configExists();

package/lib/repo/repo-manager.js

@@ -29,13 +29,13 @@ class RepoManager {
    * @param {string} rootPath - Root path to scan
    * @param {Object} options - Scan options
    * @param {number} options.maxDepth - Maximum depth to scan (default: 3)
-   * @param {string[]} options.exclude - Directories to exclude (default: ['.kiro'])
+   * @param {string[]} options.exclude - Directories to exclude (default: ['.sce'])
    * @param {boolean} options.nested - Enable nested repository scanning (default: true)
    * @returns {Promise<Array<{path: string, name: string, remote: string|null, branch: string, hasRemote: boolean, parent: string|null}>>}
    */
   async discoverRepositories(rootPath, options = {}) {
     const maxDepth = options.maxDepth || 3;
-    const exclude = options.exclude || ['.kiro'];
+    const exclude = options.exclude || ['.sce'];
     const nested = options.nested !== false; // Default to true
     
     const discovered = [];