speccrew 0.6.67 → 0.6.69

package/.speccrew/skills/speccrew-knowledge-bizs-init-features/scripts/generate-inventory.js

@@ -66,6 +66,16 @@
 const fs = require('fs');
 const path = require('path');
 
+// Platform type to tech-stack-mappings category mapping
+const PLATFORM_TYPE_TO_CATEGORY = {
+  'frontend': 'web',
+  'web': 'web',
+  'backend': 'backend',
+  'mobile': 'mobile',
+  'desktop': 'desktop',
+  'api': 'api'
+};
+
 /**
  * Parse array parameter that supports both JSON format and comma-separated format.
  * JSON format: '["vue","typescript"]'
@@ -264,12 +274,15 @@ function loadTechStackConfig(platformType, framework, projectRoot) {
   const configContent = fs.readFileSync(configPath, 'utf8');
   const config = JSON.parse(configContent);
 
+  // Map platformType to tech-stack-mappings category
+  const techCategory = PLATFORM_TYPE_TO_CATEGORY[platformType] || platformType;
+
   // Try exact match first
   let techConfig = null;
   if (config.tech_stacks &&
-      config.tech_stacks[platformType] &&
-      config.tech_stacks[platformType][framework]) {
-    techConfig = config.tech_stacks[platformType][framework];
+      config.tech_stacks[techCategory] &&
+      config.tech_stacks[techCategory][framework]) {
+    techConfig = config.tech_stacks[techCategory][framework];
   }
 
   // If not found, try normalized identifier (remove language prefix)
@@ -277,9 +290,9 @@ function loadTechStackConfig(platformType, framework, projectRoot) {
     const normalizedFramework = normalizeTechIdentifier(framework);
     if (normalizedFramework !== framework &&
         config.tech_stacks &&
-        config.tech_stacks[platformType] &&
-        config.tech_stacks[platformType][normalizedFramework]) {
-      techConfig = config.tech_stacks[platformType][normalizedFramework];
+        config.tech_stacks[techCategory] &&
+        config.tech_stacks[techCategory][normalizedFramework]) {
+      techConfig = config.tech_stacks[techCategory][normalizedFramework];
       console.log(`Using normalized tech identifier: ${framework} → ${normalizedFramework}`);
     }
   }
@@ -295,6 +308,37 @@ function loadTechStackConfig(platformType, framework, projectRoot) {
   return { extensions: [], exclude_file_suffixes: [], exclude_file_names: [] };
 }
 
+/**
+ * Validate entry-dirs JSON schema
+ * @param {object} data - Parsed entry-dirs JSON data
+ * @returns {string[]|null} Array of error messages or null if valid
+ */
+function validateEntryDirsSchema(data) {
+  const errors = [];
+  if (!data.platformId || typeof data.platformId !== 'string') {
+    errors.push('platformId must be a non-empty string');
+  } else if (!/^[a-zA-Z0-9_-]+$/.test(data.platformId)) {
+    errors.push(`platformId format invalid: "${data.platformId}" (only alphanumeric, hyphen, underscore allowed)`);
+  }
+  if (!data.sourcePath || typeof data.sourcePath !== 'string') {
+    errors.push('sourcePath must be a non-empty string');
+  }
+  if (!Array.isArray(data.modules) || data.modules.length === 0) {
+    errors.push('modules must be a non-empty array');
+  } else {
+    for (let i = 0; i < data.modules.length; i++) {
+      const mod = data.modules[i];
+      if (!mod.name || typeof mod.name !== 'string') {
+        errors.push(`modules[${i}].name must be a non-empty string`);
+      }
+      if (!Array.isArray(mod.entryDirs) || mod.entryDirs.length === 0) {
+        errors.push(`modules[${i}].entryDirs must be a non-empty array`);
+      }
+    }
+  }
+  return errors.length > 0 ? errors : null;
+}
+
 /**
  * Infer platform info from platformId
  * @param {string} platformId - Platform ID like "backend-ai", "web-vue", "mobile-uniapp"
@@ -533,7 +577,7 @@ function generateFromEntryDirs(entryDirsData, platformConfig, projectRoot, outpu
     platformName: platformConfig.platformName,
     platformType: platformType,
     sourcePath: sourcePath,
-    techStack: [framework],
+    techStack: entryDirsData.techStack || [framework],
     modules: [...new Set(moduleNames)].sort(),
     totalFiles: features.length,
     analyzedCount: 0,
@@ -667,7 +711,15 @@ function main() {
       console.error(`Found top-level keys: ${foundKeys}`);
       process.exit(1);
     }
-    
+
+    // Validate entry-dirs JSON schema
+    const schemaErrors = validateEntryDirsSchema(entryDirsData);
+    if (schemaErrors) {
+      console.error('Error: entry-dirs JSON schema validation failed:');
+      schemaErrors.forEach(err => console.error(`  - ${err}`));
+      process.exit(1);
+    }
+
     // Find project root (use current directory or entryDirsFile directory)
     const projectRoot = findProjectRoot(path.dirname(entryDirsFilePath));
         
@@ -718,7 +770,10 @@ function main() {
       outputDir = path.resolve(params.outputDir);
       console.log(`Using outputDir from parameter: ${outputDir}`);
     } else {
+      console.warn('WARNING: --outputDir not specified, falling back to default path.');
+      console.warn('  Recommended: explicitly pass --outputDir to avoid incorrect output location.');
       outputDir = path.join(projectRoot, 'speccrew-workspace', 'knowledges', 'base', 'sync-state', 'knowledge-bizs');
+      console.warn(`  Using fallback outputDir: ${outputDir}`);
     }
     
     // Generate features from entry dirs
@@ -762,25 +817,28 @@ function main() {
         const configContent = fs.readFileSync(configPath, 'utf8');
         const config = JSON.parse(configContent);
         
+        // Map platformType to tech-stack-mappings category
+        const techCategory = PLATFORM_TYPE_TO_CATEGORY[platformType] || platformType;
+
         // Load tech-stack-specific exclude_dirs
         let techExcludeDirs = [];
         let effectiveTechIdentifier = techIdentifier;
 
         // Try exact match first
         if (config.tech_stacks &&
-            config.tech_stacks[platformType] &&
-            config.tech_stacks[platformType][techIdentifier] &&
-            config.tech_stacks[platformType][techIdentifier].exclude_dirs) {
-          techExcludeDirs = config.tech_stacks[platformType][techIdentifier].exclude_dirs;
+            config.tech_stacks[techCategory] &&
+            config.tech_stacks[techCategory][techIdentifier] &&
+            config.tech_stacks[techCategory][techIdentifier].exclude_dirs) {
+          techExcludeDirs = config.tech_stacks[techCategory][techIdentifier].exclude_dirs;
         } else {
           // Try normalized identifier (remove language prefix like "python-fastapi" → "fastapi")
           const normalizedIdentifier = normalizeTechIdentifier(techIdentifier);
           if (normalizedIdentifier !== techIdentifier &&
               config.tech_stacks &&
-              config.tech_stacks[platformType] &&
-              config.tech_stacks[platformType][normalizedIdentifier] &&
-              config.tech_stacks[platformType][normalizedIdentifier].exclude_dirs) {
-            techExcludeDirs = config.tech_stacks[platformType][normalizedIdentifier].exclude_dirs;
+              config.tech_stacks[techCategory] &&
+              config.tech_stacks[techCategory][normalizedIdentifier] &&
+              config.tech_stacks[techCategory][normalizedIdentifier].exclude_dirs) {
+            techExcludeDirs = config.tech_stacks[techCategory][normalizedIdentifier].exclude_dirs;
             effectiveTechIdentifier = normalizedIdentifier;
             console.log(`Using normalized tech identifier for exclude_dirs: ${techIdentifier} → ${normalizedIdentifier}`);
           }
@@ -796,10 +854,10 @@ function main() {
 
         // Load tech-stack-specific exclude_file_suffixes
         if (config.tech_stacks &&
-            config.tech_stacks[platformType] &&
-            config.tech_stacks[platformType][effectiveTechIdentifier] &&
-            config.tech_stacks[platformType][effectiveTechIdentifier].exclude_file_suffixes) {
-          excludeFileSuffixes = config.tech_stacks[platformType][effectiveTechIdentifier].exclude_file_suffixes;
+            config.tech_stacks[techCategory] &&
+            config.tech_stacks[techCategory][effectiveTechIdentifier] &&
+            config.tech_stacks[techCategory][effectiveTechIdentifier].exclude_file_suffixes) {
+          excludeFileSuffixes = config.tech_stacks[techCategory][effectiveTechIdentifier].exclude_file_suffixes;
           if (excludeFileSuffixes.length > 0) {
             console.log(`Loaded exclude_file_suffixes from tech-stack-mappings.json: ${excludeFileSuffixes.join(', ')}`);
           }
@@ -807,10 +865,10 @@ function main() {
 
         // Load tech-stack-specific exclude_file_names
         if (config.tech_stacks &&
-            config.tech_stacks[platformType] &&
-            config.tech_stacks[platformType][effectiveTechIdentifier] &&
-            config.tech_stacks[platformType][effectiveTechIdentifier].exclude_file_names) {
-          excludeFileNames = config.tech_stacks[platformType][effectiveTechIdentifier].exclude_file_names;
+            config.tech_stacks[techCategory] &&
+            config.tech_stacks[techCategory][effectiveTechIdentifier] &&
+            config.tech_stacks[techCategory][effectiveTechIdentifier].exclude_file_names) {
+          excludeFileNames = config.tech_stacks[techCategory][effectiveTechIdentifier].exclude_file_names;
           if (excludeFileNames.length > 0) {
             console.log(`Loaded exclude_file_names from tech-stack-mappings.json: ${excludeFileNames.join(', ')}`);
           }
@@ -840,7 +898,10 @@ function main() {
     syncStateDir = path.resolve(params.outputDir);
     console.log(`Using outputDir from parameter: ${syncStateDir}`);
   } else {
+    console.warn('WARNING: --outputDir not specified, falling back to default path.');
+    console.warn('  Recommended: explicitly pass --outputDir to avoid incorrect output location.');
     syncStateDir = path.join(projectRoot, 'speccrew-workspace', 'knowledges', 'base', 'sync-state', 'knowledge-bizs');
+    console.warn(`  Using fallback outputDir: ${syncStateDir}`);
   }
   const outputPath = path.join(syncStateDir, outputFileName);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "speccrew",
-  "version": "0.6.67",
+  "version": "0.6.69",
   "description": "Spec-Driven Development toolkit for AI-powered IDEs",
   "author": "charlesmu99",
   "repository": {