scene-capability-engine 3.3.12 → 3.3.14

package/lib/templates/template-validator.js

@@ -6,6 +6,7 @@
 
 const fs = require('fs-extra');
 const path = require('path');
+const semver = require('semver');
 const { ValidationError } = require('./template-error');
 
 class TemplateValidator {
@@ -14,7 +15,8 @@ class TemplateValidator {
     this.requiredFrontmatterFields = [
       'name', 'category', 'description', 'difficulty', 
       'tags', 'applicable_scenarios', 'author', 
-      'created_at', 'updated_at', 'version'
+      'created_at', 'updated_at', 'version',
+      'template_type', 'min_sce_version'
     ];
   }
 
@@ -251,6 +253,27 @@ class TemplateValidator {
       result.errors.push(`${filename}: Invalid difficulty "${metadata.difficulty}"`);
     }
 
+    // Validate template type
+    const validTemplateTypes = ['spec-scaffold', 'capability-template', 'runtime-playbook'];
+    if (metadata.template_type && !validTemplateTypes.includes(metadata.template_type)) {
+      result.errors.push(`${filename}: Invalid template_type "${metadata.template_type}"`);
+    }
+
+    // Validate SCE compatibility semver
+    if (metadata.min_sce_version && !semver.valid(metadata.min_sce_version)) {
+      result.errors.push(`${filename}: Invalid min_sce_version "${metadata.min_sce_version}"`);
+    }
+
+    if (metadata.max_sce_version && !semver.valid(metadata.max_sce_version)) {
+      result.errors.push(`${filename}: Invalid max_sce_version "${metadata.max_sce_version}"`);
+    }
+
+    if (metadata.min_sce_version && metadata.max_sce_version &&
+      semver.valid(metadata.min_sce_version) && semver.valid(metadata.max_sce_version) &&
+      semver.gt(metadata.min_sce_version, metadata.max_sce_version)) {
+      result.errors.push(`${filename}: min_sce_version must be <= max_sce_version`);
+    }
+
     return result;
   }
 

package/lib/workspace/multi/global-config.js

@@ -26,7 +26,7 @@ class GlobalConfig {
   /**
    * Get the default configuration file path
    * 
-   * @returns {string} Path to ~/.kse/workspace-state.json
+   * @returns {string} Path to ~/.sce/workspace-state.json
    * @deprecated Use WorkspaceStateManager.getDefaultStatePath() instead
    */
   getDefaultConfigPath() {

package/lib/workspace/multi/path-utils.js

@@ -84,16 +84,16 @@ class PathUtils {
   /**
    * Get the default sce configuration directory
    * 
-   * @returns {string} Path to ~/.kse directory
+   * @returns {string} Path to ~/.sce directory
    */
   static getConfigDir() {
-    return path.join(os.homedir(), '.kse');
+    return path.join(os.homedir(), '.sce');
   }
 
   /**
    * Get the default workspace state file path
    * 
-   * @returns {string} Path to ~/.kse/workspace-state.json
+   * @returns {string} Path to ~/.sce/workspace-state.json
    */
   static getWorkspaceStatePath() {
     return path.join(this.getConfigDir(), 'workspace-state.json');

package/lib/workspace/multi/workspace-registry.js

@@ -26,7 +26,7 @@ class WorkspaceRegistry {
   /**
    * Get the default configuration file path
    * 
-   * @returns {string} Path to ~/.kse/workspace-state.json
+   * @returns {string} Path to ~/.sce/workspace-state.json
    * @deprecated Use WorkspaceStateManager.getDefaultStatePath() instead
    */
   getDefaultConfigPath() {

package/lib/workspace/multi/workspace-state-manager.js

@@ -10,7 +10,7 @@ const Workspace = require('./workspace');
  * data in a single configuration file. This ensures atomic updates and
  * eliminates data inconsistency risks.
  * 
- * Architecture: Single file (~/.kse/workspace-state.json) contains:
+ * Architecture: Single file (~/.sce/workspace-state.json) contains:
  * - All workspace entries
  * - Active workspace selection
  * - User preferences
@@ -41,13 +41,34 @@ class WorkspaceStateManager {
   /**
    * Get the default state file path
    * 
-   * @returns {string} Path to ~/.kse/workspace-state.json
+   * @returns {string} Path to ~/.sce/workspace-state.json
    */
   getDefaultStatePath() {
+    const homeDir = os.homedir();
+    return path.join(homeDir, '.sce', 'workspace-state.json');
+  }
+
+  /**
+   * Get the legacy state file path used by prior versions
+   *
+   * @returns {string} Path to ~/.kse/workspace-state.json
+   */
+  getLegacyStatePath() {
     const homeDir = os.homedir();
     return path.join(homeDir, '.kse', 'workspace-state.json');
   }
 
+  /**
+   * Whether state manager is operating on the default state path.
+   *
+   * Automatic legacy migration should only run in this mode.
+   *
+   * @returns {boolean}
+   */
+  isDefaultStatePath() {
+    return path.resolve(this.statePath) === path.resolve(this.getDefaultStatePath());
+  }
+
   /**
    * Load workspace state from disk
    * 
@@ -66,6 +87,15 @@ class WorkspaceStateManager {
         return true;
       }
 
+      // Migrate legacy single-file state from ~/.kse/workspace-state.json
+      if (await this.hasLegacyStateFile()) {
+        console.log('Migrating workspace state to new .sce directory...');
+        await this.migrateFromLegacyStateFile();
+        await this.loadNewFormat();
+        this.loaded = true;
+        return true;
+      }
+
       // Check for legacy format and migrate
       if (await this.hasLegacyFiles()) {
         console.log('Migrating workspace configuration to new format...');
@@ -137,6 +167,10 @@ class WorkspaceStateManager {
    * @returns {Promise<boolean>}
    */
   async hasLegacyFiles() {
+    if (!this.isDefaultStatePath()) {
+      return false;
+    }
+
     const homeDir = os.homedir();
     const legacyWorkspacesPath = path.join(homeDir, '.kse', 'workspaces.json');
     const legacyConfigPath = path.join(homeDir, '.kse', 'config.json');
@@ -147,6 +181,34 @@ class WorkspaceStateManager {
     return workspacesExists || configExists;
   }
 
+  /**
+   * Check whether legacy single-file state exists
+   *
+   * @private
+   * @returns {Promise<boolean>}
+   */
+  async hasLegacyStateFile() {
+    if (!this.isDefaultStatePath()) {
+      return false;
+    }
+
+    const legacyStatePath = this.getLegacyStatePath();
+    return fs.pathExists(legacyStatePath);
+  }
+
+  /**
+   * Copy legacy single-file state into the new default location.
+   *
+   * @private
+   * @returns {Promise<void>}
+   */
+  async migrateFromLegacyStateFile() {
+    const legacyStatePath = this.getLegacyStatePath();
+    const stateDir = path.dirname(this.statePath);
+    await fs.ensureDir(stateDir);
+    await fs.copy(legacyStatePath, this.statePath);
+  }
+
   /**
    * Migrate from legacy format (workspaces.json + config.json)
    * 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scene-capability-engine",
-  "version": "3.3.12",
+  "version": "3.3.14",
   "description": "SCE (Scene Capability Engine) - A CLI tool and npm package for spec-driven development with AI coding assistants.",
   "main": "index.js",
   "bin": {

package/template/.sce/steering/CORE_PRINCIPLES.md

@@ -136,6 +136,8 @@
 
 **复杂问题定位方法**: 优先使用 debug 日志与可观测信号定位（输入、输出、关键分支、异常栈、上下文参数），先还原执行路径再下结论
 
+**修复后清理要求**: 问题修复并验证通过后，必须清理临时 debug 日志、临时埋点、一次性脚本和调试开关；需要长期保留的日志必须转为可配置观测项且默认关闭
+
 **允许的临时措施**: 仅在生产止血场景可临时绕行，但必须同时给出根因修复任务、回滚条件和截止时间
 
 **验收标准**: 必须有可复现用例、修复后回归通过、明确根因记录（不是仅现象描述）
@@ -155,4 +157,4 @@
 
 ---
 
-v15.0 | 2026-02-25 | 新增根因修复原则与 Ontology 四层一链分析原则
+v16.0 | 2026-02-25 | 新增调试日志清理硬规则