scene-capability-engine 3.6.38 → 3.6.44

package/lib/commands/collab.js

@@ -90,7 +90,10 @@ function registerCollabCommands(program) {
             console.log(chalk.gray('Type:'), status.metadata.type);
             console.log(chalk.gray('Status:'), status.metadata.status.current);
             if (status.metadata.assignment) {
-              console.log(chalk.gray('Assigned to:'), status.metadata.assignment.sceInstance);
+              console.log(
+                chalk.gray('Assigned to:'),
+                status.metadata.assignment.sceInstance || status.metadata.assignment.kiroInstance
+              );
             }
             if (status.metadata.dependencies && status.metadata.dependencies.length > 0) {
               console.log(chalk.gray('Dependencies:'));
@@ -105,8 +108,11 @@ function registerCollabCommands(program) {
 
             for (const { name, metadata } of status.specs) {
               const symbol = getStatusSymbol(metadata.status.current);
+              const assignedInstance = metadata.assignment
+                ? (metadata.assignment.sceInstance || metadata.assignment.kiroInstance)
+                : null;
               const assignment = metadata.assignment 
-                ? chalk.gray(`(${metadata.assignment.sceInstance})`)
+                ? chalk.gray(`(${assignedInstance})`)
                 : chalk.gray('(unassigned)');
               console.log(`${symbol} ${name} ${assignment}`);
             }
@@ -127,12 +133,12 @@ function registerCollabCommands(program) {
   collab
     .command('assign <spec-name> <SCE-instance>')
     .description('Assign a spec to a SCE instance')
-    .action(async (specName, kiroInstance) => {
+    .action(async (specName, sceInstance) => {
       try {
         const workspaceRoot = process.cwd();
         const manager = new CollaborationManager(workspaceRoot);
 
-        const result = await manager.assignSpec(specName, kiroInstance);
+        const result = await manager.assignSpec(specName, sceInstance);
 
         if (result.success) {
           console.log(chalk.green('✓'), result.message);

package/lib/commands/docs.js

@@ -301,6 +301,12 @@ async function handleConfigDisplay(configManager, reporter) {
     console.log(`  • ${dir}`);
   });
   console.log();
+
+  console.log(chalk.bold('Spec Allowed Root Files:'));
+  (config.specAllowedRootFiles || []).forEach(file => {
+    console.log(`  • ${file}`);
+  });
+  console.log();
   
   console.log(chalk.bold('Temporary Patterns:'));
   config.temporaryPatterns.forEach(pattern => {
@@ -350,10 +356,10 @@ async function handleConfigSet(configManager, reporter, options) {
   const camelKey = key.replace(/-([a-z])/g, (g) => g[1].toUpperCase());
   
   // Validate key
-  const validKeys = ['rootAllowedFiles', 'specSubdirs', 'temporaryPatterns'];
+  const validKeys = ['rootAllowedFiles', 'specAllowedRootFiles', 'specSubdirs', 'temporaryPatterns'];
   if (!validKeys.includes(camelKey)) {
     reporter.displayError(`Invalid configuration key: ${key}`);
-    console.log(chalk.gray('Valid keys: root-allowed-files, spec-subdirs, temporary-patterns\n'));
+    console.log(chalk.gray('Valid keys: root-allowed-files, spec-allowed-root-files, spec-subdirs, temporary-patterns\n'));
     return 2;
   }
   

package/lib/commands/scene.js

@@ -158,6 +158,45 @@ function createDoctorTraceId() {
   return `doctor-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
 }
 
+function stringifyJsonForCli(value, indentSize = 2, currentIndent = 0) {
+  if (value === null) {
+    return 'null';
+  }
+
+  if (typeof value === 'number') {
+    return Object.is(value, -0) ? '-0' : JSON.stringify(value);
+  }
+
+  if (typeof value === 'string' || typeof value === 'boolean') {
+    return JSON.stringify(value);
+  }
+
+  if (Array.isArray(value)) {
+    if (value.length === 0) {
+      return '[]';
+    }
+
+    const nextIndent = currentIndent + indentSize;
+    const indent = ' '.repeat(currentIndent);
+    const childIndent = ' '.repeat(nextIndent);
+    const items = value.map((entry) => `${childIndent}${stringifyJsonForCli(entry, indentSize, nextIndent)}`);
+    return `[\n${items.join(',\n')}\n${indent}]`;
+  }
+
+  const keys = Object.keys(value);
+  if (keys.length === 0) {
+    return '{}';
+  }
+
+  const nextIndent = currentIndent + indentSize;
+  const indent = ' '.repeat(currentIndent);
+  const childIndent = ' '.repeat(nextIndent);
+  const entries = keys.map((key) => (
+    `${childIndent}${JSON.stringify(key)}: ${stringifyJsonForCli(value[key], indentSize, nextIndent)}`
+  ));
+  return `{\n${entries.join(',\n')}\n${indent}}`;
+}
+
 function registerSceneCommands(program) {
   const sceneCmd = program
     .command('scene')
@@ -4795,7 +4834,7 @@ function createSceneEvalConfigTemplateByProfile(profile = 'default') {
 }
 
 function normalizeRelativePath(targetPath = '') {
-  return String(targetPath || '').replace(/\\/g, '/').replace(/\/+/g, '/').replace(/^\.\//, '');
+  return String(targetPath || '').trim().replace(/\\/g, '/').replace(/\/+/g, '/').replace(/^\.\//, '');
 }
 
 function collectManifestDiscoveryCandidates(preferredPath = 'custom/scene.yaml') {
@@ -13639,6 +13678,35 @@ async function runSceneVersionCommand(rawOptions = {}, dependencies = {}) {
   }
 }
 
+function isBinaryContent(buffer) {
+  if (!Buffer.isBuffer(buffer)) {
+    return false;
+  }
+
+  for (let index = 0; index < buffer.length; index++) {
+    if (buffer[index] === 0) {
+      return true;
+    }
+  }
+
+  return false;
+}
+
+function countChangedLines(fromContent, toContent) {
+  const oldLines = fromContent.toString('utf8').split('\n');
+  const newLines = toContent.toString('utf8').split('\n');
+  const maxLen = Math.max(oldLines.length, newLines.length);
+  let changedLines = 0;
+
+  for (let index = 0; index < maxLen; index++) {
+    if ((oldLines[index] || '') !== (newLines[index] || '')) {
+      changedLines++;
+    }
+  }
+
+  return changedLines;
+}
+
 function buildPackageDiff(fromFiles, toFiles) {
   const fromMap = new Map();
   for (const f of (fromFiles || [])) {
@@ -13662,19 +13730,9 @@ function buildPackageDiff(fromFiles, toFiles) {
       if (Buffer.compare(content, toContent) === 0) {
         unchanged.push(filePath);
       } else {
-        let changedLines = 0;
-        try {
-          const oldLines = content.toString('utf8').split('\n');
-          const newLines = toContent.toString('utf8').split('\n');
-          const maxLen = Math.max(oldLines.length, newLines.length);
-          for (let i = 0; i < maxLen; i++) {
-            if ((oldLines[i] || '') !== (newLines[i] || '')) {
-              changedLines++;
-            }
-          }
-        } catch (_e) {
-          changedLines = -1;
-        }
+        const changedLines = isBinaryContent(content) || isBinaryContent(toContent)
+          ? -1
+          : countChangedLines(content, toContent);
         modified.push({ path: filePath, changedLines });
       }
     }
@@ -13734,7 +13792,9 @@ function printSceneDiffSummary(options, payload, projectRoot = process.cwd()) {
       console.log(chalk.red(`  - ${f}`));
     }
     for (const f of payload.files.modified) {
-      const detail = f.changedLines >= 0 ? ` (${f.changedLines} lines changed)` : ' (binary content differs)';
+      const detail = options.stat
+        ? ''
+        : (f.changedLines >= 0 ? ` (${f.changedLines} lines changed)` : ' (binary content differs)');
       console.log(chalk.yellow(`  ~ ${f.path}${detail}`));
     }
   }
@@ -15248,7 +15308,7 @@ async function runSceneLintCommand(rawOptions = {}, dependencies = {}) {
 
 function printSceneLintSummary(options, payload, projectRoot = process.cwd()) {
   if (options.json) {
-    console.log(JSON.stringify(payload, null, 2));
+    console.log(stringifyJsonForCli(payload));
     return;
   }
 
@@ -15344,7 +15404,7 @@ async function runSceneScoreCommand(rawOptions = {}, dependencies = {}) {
 
 function printSceneScoreSummary(options, payload, projectRoot = process.cwd()) {
   if (options.json) {
-    console.log(JSON.stringify(payload, null, 2));
+    console.log(stringifyJsonForCli(payload));
     return;
   }
 
@@ -15524,7 +15584,7 @@ async function runSceneContributeCommand(rawOptions = {}, dependencies = {}) {
 
 function printSceneContributeSummary(options, payload, projectRoot = process.cwd()) {
   if (options.json) {
-    console.log(JSON.stringify(payload, null, 2));
+    console.log(stringifyJsonForCli(payload));
     return;
   }
 

package/lib/commands/status.js

@@ -30,10 +30,10 @@ async function statusCommand(options = {}) {
   
   try {
     // 1. Check if .sce/ exists
-    const kiroPath = path.join(projectPath, '.sce');
-    const kiroExists = await fs.pathExists(kiroPath);
+    const scePath = path.join(projectPath, '.sce');
+    const sceExists = await fs.pathExists(scePath);
     
-    if (!kiroExists) {
+    if (!sceExists) {
       console.log(chalk.yellow('⚠️  No .sce/ directory found'));
       console.log();
       console.log('This project has not been adopted yet.');

package/lib/commands/studio.js

@@ -502,6 +502,14 @@ async function buildReleaseGateSteps(options = {}, dependencies = {}) {
     required: true
   });
 
+  steps.push({
+    id: 'spec-delivery-audit',
+    name: 'spec delivery sync audit',
+    command: 'node',
+    args: ['bin/sce.js', 'workspace', 'delivery-audit', '--json', '--strict'],
+    required: true
+  });
+
   const gitManagedGateScript = path.join(projectPath, 'scripts', 'git-managed-gate.js');
   const hasGitManagedGateScript = await fileSystem.pathExists(gitManagedGateScript);
   steps.push({

package/lib/commands/watch.js

@@ -11,6 +11,15 @@ const inquirer = require('inquirer');
 const WatchManager = require('../watch/watch-manager');
 const { listPresets, getPreset, mergePreset, validatePreset } = require('../watch/presets');
 
+function sleep(ms) {
+  return new Promise(resolve => {
+    const timer = setTimeout(resolve, ms);
+    if (typeof timer.unref === 'function') {
+      timer.unref();
+    }
+  });
+}
+
 /**
  * Start watch mode
  * 
@@ -329,7 +338,7 @@ async function followLogStream(logPath, options = {}) {
         break;
       }
 
-      await new Promise(resolve => setTimeout(resolve, pollIntervalMs));
+      await sleep(pollIntervalMs);
     }
   } finally {
     process.removeListener('SIGINT', onSigInt);

package/lib/governance/config-manager.js

@@ -52,6 +52,12 @@ class ConfigManager {
         'CHANGELOG.md',
         'CONTRIBUTING.md'
       ],
+      specAllowedRootFiles: [
+        'requirements.md',
+        'design.md',
+        'tasks.md',
+        'collaboration.json'
+      ],
       specSubdirs: [
         'reports',
         'scripts',
@@ -152,6 +158,10 @@ class ConfigManager {
     if (!config.specSubdirs || !Array.isArray(config.specSubdirs)) {
       errors.push('specSubdirs must be an array');
     }
+
+    if (!config.specAllowedRootFiles || !Array.isArray(config.specAllowedRootFiles)) {
+      errors.push('specAllowedRootFiles must be an array');
+    }
     
     if (!config.temporaryPatterns || !Array.isArray(config.temporaryPatterns)) {
       errors.push('temporaryPatterns must be an array');
@@ -169,6 +179,12 @@ class ConfigManager {
         errors.push('specSubdirs must contain only strings');
       }
     }
+
+    if (config.specAllowedRootFiles && Array.isArray(config.specAllowedRootFiles)) {
+      if (config.specAllowedRootFiles.some(f => typeof f !== 'string')) {
+        errors.push('specAllowedRootFiles must contain only strings');
+      }
+    }
     
     if (config.temporaryPatterns && Array.isArray(config.temporaryPatterns)) {
       if (config.temporaryPatterns.some(p => typeof p !== 'string')) {

package/lib/governance/diagnostic-engine.js

@@ -81,6 +81,7 @@ class DiagnosticEngine {
   async scanSpecDirectory(specPath) {
     const specName = path.basename(specPath);
     const requiredFiles = ['requirements.md', 'design.md', 'tasks.md'];
+    const allowedRootFiles = this.config.specAllowedRootFiles || requiredFiles;
     
     // Check for missing required files
     for (const requiredFile of requiredFiles) {
@@ -124,7 +125,7 @@ class DiagnosticEngine {
       const basename = path.basename(filePath);
       
       // Skip required files
-      if (requiredFiles.includes(basename)) {
+      if (allowedRootFiles.includes(basename)) {
         continue;
       }
       

package/lib/governance/validation-engine.js

@@ -84,6 +84,8 @@ class ValidationEngine {
    */
   async validateSpec(specName) {
     const specPath = this.scanner.getSpecDirectory(specName);
+    const requiredFiles = ['requirements.md', 'design.md', 'tasks.md'];
+    const allowedRootFiles = this.config.specAllowedRootFiles || requiredFiles;
     
     // Check if Spec directory exists
     if (!await this.scanner.exists(specPath)) {
@@ -97,7 +99,6 @@ class ValidationEngine {
     }
     
     // Check required files
-    const requiredFiles = ['requirements.md', 'design.md', 'tasks.md'];
     for (const file of requiredFiles) {
       const filePath = path.join(specPath, file);
       if (!await this.scanner.exists(filePath)) {
@@ -118,7 +119,7 @@ class ValidationEngine {
       const basename = path.basename(filePath);
       
       // Skip required files
-      if (requiredFiles.includes(basename)) {
+      if (allowedRootFiles.includes(basename)) {
         continue;
       }
       

package/lib/repo/config-manager.js

@@ -131,8 +131,8 @@ class ConfigManager {
 
     try {
       // Ensure .sce directory exists
-      const kiroDir = path.dirname(configPath);
-      await fs.mkdir(kiroDir, { recursive: true });
+      const sceDir = path.dirname(configPath);
+      await fs.mkdir(sceDir, { recursive: true });
 
       // Write configuration with pretty formatting
       const jsonContent = JSON.stringify(config, null, 2);

package/lib/runtime/session-store.js

@@ -568,26 +568,34 @@ class SessionStore {
 
     const fileCount = fileRecords.length;
     const sqliteCount = Array.isArray(sqliteRecords) ? sqliteRecords.length : null;
+    let readSource = 'file';
 
     let status = 'file-only';
     if (sqliteCount === null) {
       status = 'sqlite-unavailable';
     } else if (fileCount === 0 && sqliteCount === 0) {
       status = 'empty';
+      readSource = 'empty';
     } else if (fileCount === 0 && sqliteCount > 0) {
       status = 'sqlite-only';
+      readSource = 'sqlite';
     } else if (fileCount > 0 && sqliteCount === 0) {
       status = 'file-only';
+      readSource = 'file';
     } else if (fileCount === sqliteCount) {
       status = 'aligned';
+      readSource = this._preferSqliteSceneReads ? 'sqlite' : 'file';
     } else if (sqliteCount < fileCount) {
       status = 'pending-sync';
+      readSource = 'file';
     } else if (sqliteCount > fileCount) {
       status = 'sqlite-ahead';
+      readSource = 'sqlite';
     }
 
     return {
       read_preference: this._preferSqliteSceneReads ? 'sqlite' : 'file',
+      read_source: readSource,
       file_scene_count: fileCount,
       sqlite_scene_count: sqliteCount,
       status

package/lib/spec/bootstrap/context-collector.js

@@ -7,14 +7,15 @@ class ContextCollector {
   }
 
   async collect() {
-    const kiroDir = path.join(this.projectPath, '.sce');
-    const specsDir = path.join(kiroDir, 'specs');
-    const hasKiro = await fs.pathExists(kiroDir);
+    const sceDir = path.join(this.projectPath, '.sce');
+    const specsDir = path.join(sceDir, 'specs');
+    const hasSceDir = await fs.pathExists(sceDir);
     const existingSpecs = await this._listSpecs(specsDir);
 
     return {
       projectPath: this.projectPath,
-      hasKiro,
+      hasSceDir,
+      hasKiro: hasSceDir,
       specsDir,
       existingSpecs,
       totalSpecs: existingSpecs.length,

package/lib/spec-gate/rules/default-rules.js

@@ -87,25 +87,25 @@ function createDefaultRules(projectPath = process.cwd()) {
       id: 'config_consistency',
       description: 'Verify project-level sce config baseline exists',
       async execute() {
-        const kiroDir = path.join(projectPath, '.sce');
-        const configDir = path.join(kiroDir, 'config');
-        const hasKiro = await fs.pathExists(kiroDir);
+        const sceDir = path.join(projectPath, '.sce');
+        const configDir = path.join(sceDir, 'config');
+        const hasSceDir = await fs.pathExists(sceDir);
         const hasConfig = await fs.pathExists(configDir);
 
-        const ratio = hasKiro && hasConfig ? 1 : hasKiro ? 0.5 : 0;
+        const ratio = hasSceDir && hasConfig ? 1 : hasSceDir ? 0.5 : 0;
         const warnings = [];
-        if (!hasKiro) {
+        if (!hasSceDir) {
           warnings.push('.sce directory missing');
         }
-        if (hasKiro && !hasConfig) {
+        if (hasSceDir && !hasConfig) {
           warnings.push('.sce/config directory missing');
         }
 
         return {
-          passed: hasKiro,
+          passed: hasSceDir,
           ratio,
           details: {
-            hasKiro,
+            hasSceDir,
             hasConfig
           },
           warnings