speccrew 0.5.7 → 0.5.9

package/.speccrew/skills/speccrew-sd-backend/SKILL.md

@@ -266,6 +266,9 @@ After completing all steps, output a structured completion report for the System
 | **Explicit Transaction Boundaries** | Transaction boundaries must be explicitly marked |
 | **Exception Code Mapping** | Exception handling must map to API Contract error codes |
 | **Follow Techs Conventions** | Naming, directory structure, patterns from techs knowledge |
+| **FORBIDDEN: TODO/FIXME Placeholders** | Design documents MUST contain complete implementation logic. Do NOT use TODO, FIXME, HACK, or any placeholder comments. Every method, validation rule, and business logic MUST be fully specified with actual pseudocode. |
+| **API Route Consistency** | All API routes in the design document MUST exactly match the routes defined in the API Contract document. Before writing any route, READ the API Contract and copy routes verbatim. Do NOT invent or modify routes. |
+| **Cross-Feature Dependency Marking** | When referencing functionality from another Feature (e.g., conflict detection from F-APPT-002), MUST explicitly mark it as `[DEPENDENCY: F-XXX-NNN]` and define a degradation strategy for when that Feature is not yet implemented. |
 
 # Mermaid Diagram Requirements
 
@@ -296,3 +299,6 @@ When generating Mermaid diagrams, follow compatibility guidelines:
 - [ ] INDEX.md generated with complete module list
 - [ ] All files written to correct paths under 03.system-design/{platform_id}/
 - [ ] All Mermaid diagrams follow compatibility guidelines
+- [ ] **No TODO/FIXME placeholders** — all methods have complete pseudocode implementation
+- [ ] **API routes match API Contract exactly** — verified route-by-route
+- [ ] **Cross-Feature dependencies explicitly marked** — all `[DEPENDENCY: F-XXX-NNN]` tags present with degradation strategy

package/.speccrew/skills/speccrew-sd-frontend/SKILL.md

@@ -263,6 +263,10 @@ After completing all steps, output a structured completion report for the System
 | **One Module Per Function Group** | Each module design document maps to one or more related Feature Spec functions |
 | **Status Markers Required** | Use [EXISTING], [MODIFIED], [NEW] markers for all components and store modules |
 | **Follow Techs Conventions** | Naming, directory structure, patterns must follow techs knowledge |
+| **FORBIDDEN: TODO/FIXME Placeholders** | Design documents MUST contain complete implementation logic. Do NOT use TODO, FIXME, HACK, or any placeholder comments. Every component, method, and interaction MUST be fully specified with actual pseudocode. |
+| **API Route Consistency** | All API routes in the design document MUST exactly match the routes defined in the API Contract document. Before writing any route, READ the API Contract and copy routes verbatim. Do NOT invent or modify routes. |
+| **Cross-Feature Dependency Marking** | When referencing functionality from another Feature (e.g., conflict detection from F-APPT-002), MUST explicitly mark it as `[DEPENDENCY: F-XXX-NNN]` and define a degradation strategy (e.g., hide button, show placeholder) for when that Feature is not yet implemented. |
+| **Mermaid for All Diagrams** | ALL component trees, interaction flows, and state management diagrams MUST use Mermaid syntax (`graph TB`, `sequenceDiagram`, `flowchart`). Plain text ASCII diagrams are FORBIDDEN for these sections. |
 
 # Checklist
 
@@ -277,3 +281,7 @@ After completing all steps, output a structured completion report for the System
 - [ ] INDEX.md generated with complete module list
 - [ ] All files written to correct paths under 03.system-design/{platform_id}/
 - [ ] Checkpoint A passed: function extraction confirmed with user
+- [ ] **No TODO/FIXME placeholders** — all components and methods have complete pseudocode
+- [ ] **API routes match API Contract exactly** — verified route-by-route
+- [ ] **Cross-Feature dependencies explicitly marked** — all `[DEPENDENCY: F-XXX-NNN]` tags present with degradation strategy
+- [ ] **Mermaid diagrams used** — no ASCII text diagrams for flows or component trees

package/.speccrew/skills/speccrew-sd-mobile/SKILL.md

@@ -253,6 +253,10 @@ After completing all steps, output a structured completion report for the System
 | **Follow Techs Conventions** | Naming, directory structure, patterns must follow techs knowledge |
 | **Platform-Specific Handling** | Properly handle iOS/Android differences, permissions, and native integrations |
 | **Offline Support** | Consider offline-first patterns where applicable |
+| **FORBIDDEN: TODO/FIXME Placeholders** | Design documents MUST contain complete implementation logic. Do NOT use TODO, FIXME, HACK, or any placeholder comments. Every screen, component, and method MUST be fully specified with actual pseudocode. |
+| **API Route Consistency** | All API routes in the design document MUST exactly match the routes defined in the API Contract document. Before writing any route, READ the API Contract and copy routes verbatim. Do NOT invent or modify routes. |
+| **Cross-Feature Dependency Marking** | When referencing functionality from another Feature (e.g., conflict detection from F-APPT-002), MUST explicitly mark it as `[DEPENDENCY: F-XXX-NNN]` and define a degradation strategy (e.g., hide button, show placeholder) for when that Feature is not yet implemented. |
+| **Mermaid for All Diagrams** | ALL screen trees, navigation flows, interaction sequences, and state diagrams MUST use Mermaid syntax (`graph TB`, `sequenceDiagram`, `flowchart`). Plain text ASCII diagrams are FORBIDDEN for these sections. |
 
 # Checklist
 
@@ -269,4 +273,8 @@ After completing all steps, output a structured completion report for the System
 - [ ] App lifecycle handling documented
 - [ ] INDEX.md generated with complete module list
 - [ ] All files written to correct paths under 03.system-design/{platform_id}/
-- [ ] Checkpoint A passed: function extraction confirmed with user
+- [ ] **Checkpoint A passed**: function extraction confirmed with user
+- [ ] **No TODO/FIXME placeholders** — all screens and methods have complete pseudocode
+- [ ] **API routes match API Contract exactly** — verified route-by-route
+- [ ] **Cross-Feature dependencies explicitly marked** — all `[DEPENDENCY: F-XXX-NNN]` tags present with degradation strategy
+- [ ] **Mermaid diagrams used** — no ASCII text diagrams for flows or screen trees

package/package.json

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

package/workspace-template/scripts/update-progress.js

@@ -225,7 +225,10 @@ function parseArgs() {
         description: null,
         startedAt: null,
         completedAt: null,
-        confirmedAt: null
+        confirmedAt: null,
+        featuresDir: null,
+        platforms: null,
+        force: false
     };
 
     // 第一个参数是命令
@@ -314,6 +317,18 @@ function parseArgs() {
             case '-Overview':
                 result.overview = true;
                 break;
+            case '--features-dir':
+            case '-Features-Dir':
+                result.featuresDir = args[++i];
+                break;
+            case '--platforms':
+            case '-Platforms':
+                result.platforms = args[++i];
+                break;
+            case '--force':
+            case '-Force':
+                result.force = true;
+                break;
         }
     }
 
@@ -785,6 +800,154 @@ function cmdUpdateWorkflow(args) {
     }
 }
 
+/**
+ * 命令：init-tasks - 扫描 feature-design 目录生成任务列表
+ */
+function cmdInitTasks(args) {
+    // 参数验证
+    if (!args.file || !args.stage || !args.featuresDir || !args.platforms) {
+        outputError('Usage: init-tasks --file <path> --stage <stage_name> --features-dir <dir> --platforms <comma-separated> [--force]');
+    }
+
+    const filePath = path.resolve(args.file);
+    const featuresDir = path.resolve(args.featuresDir);
+    const platforms = args.platforms.split(',').map(p => p.trim()).filter(p => p);
+    
+    // 验证 platforms 非空
+    if (platforms.length === 0) {
+        outputError('Platforms list cannot be empty');
+    }
+
+    // 验证 features-dir 存在
+    if (!fs.existsSync(featuresDir)) {
+        outputError(`Features directory not found: ${featuresDir}`);
+    }
+
+    // 扫描 .feature-spec.md 文件
+    const featureFiles = [];
+    const files = fs.readdirSync(featuresDir);
+    for (const file of files) {
+        if (file.endsWith('.feature-spec.md')) {
+            featureFiles.push(file);
+        }
+    }
+
+    if (featureFiles.length === 0) {
+        outputError(`No .feature-spec.md files found in: ${featuresDir}`);
+    }
+
+    // 从文件名提取 feature 信息
+    // 格式: F-{MODULE}-{NNN}-{feature-name}.feature-spec.md
+    const featurePattern = /^(F-([A-Z]+)-\d+)-(.+)\.feature-spec\.md$/;
+    const features = [];
+
+    for (const file of featureFiles) {
+        const match = file.match(featurePattern);
+        if (match) {
+            features.push({
+                feature_id: match[1],      // F-APPT-001
+                module: match[2],           // APPT
+                name: match[3],             // 预约信息CRUD
+                file: file
+            });
+        }
+    }
+
+    if (features.length === 0) {
+        outputError('No valid feature files found. Expected format: F-{MODULE}-{NNN}-{feature-name}.feature-spec.md');
+    }
+
+    // 按 feature ID 排序
+    features.sort((a, b) => a.feature_id.localeCompare(b.feature_id));
+
+    // 检查目标文件是否已有 tasks
+    if (fs.existsSync(filePath)) {
+        const existingData = readJsonFile(filePath);
+        if (existingData.tasks && existingData.tasks.length > 0 && !args.force) {
+            outputError(`Progress file already has ${existingData.tasks.length} tasks. Use --force to overwrite.`);
+        }
+    }
+
+    // 生成任务列表
+    const tasks = [];
+    const now = getTimestamp();
+
+    // Module 排序顺序
+    const moduleOrder = ['APPT', 'BASE', 'CUST', 'EMP', 'ITEM', 'KNW', 'REPORT', 'REV', 'SERV'];
+    const getModuleIndex = (module) => {
+        const idx = moduleOrder.indexOf(module);
+        return idx === -1 ? 999 : idx;
+    };
+
+    // 按 module 分组
+    const featuresByModule = {};
+    for (const feature of features) {
+        if (!featuresByModule[feature.module]) {
+            featuresByModule[feature.module] = [];
+        }
+        featuresByModule[feature.module].push(feature);
+    }
+
+    // 每个 module 内按 feature ID 排序
+    for (const module of Object.keys(featuresByModule)) {
+        featuresByModule[module].sort((a, b) => a.feature_id.localeCompare(b.feature_id));
+    }
+
+    // 按 module 顺序生成任务
+    const sortedModules = Object.keys(featuresByModule).sort((a, b) => getModuleIndex(a) - getModuleIndex(b));
+
+    for (const module of sortedModules) {
+        for (const feature of featuresByModule[module]) {
+            for (const platform of platforms) {
+                tasks.push({
+                    id: `sd-${platform}-${feature.feature_id}`,
+                    name: `System Design - ${platform} - ${feature.feature_id} ${feature.name}`,
+                    status: 'pending',
+                    platform: platform,
+                    feature_id: feature.feature_id,
+                    module: feature.module,
+                    created_at: now
+                });
+            }
+        }
+    }
+
+    // 创建进度文件结构
+    const progressData = {
+        stage: args.stage,
+        created_at: now,
+        updated_at: now,
+        counts: calculateCounts(tasks),
+        tasks: tasks,
+        checkpoints: {}
+    };
+
+    // 确保目录存在
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+
+    // 获取锁并写入
+    let lockPath = null;
+    try {
+        lockPath = acquireLock(filePath);
+        atomicWriteJson(filePath, progressData);
+        outputSuccess(
+            `Generated ${tasks.length} tasks from ${features.length} features × ${platforms.length} platforms`,
+            {
+                file: filePath,
+                stage: args.stage,
+                features_count: features.length,
+                platforms: platforms,
+                counts: progressData.counts
+            }
+        );
+    } finally {
+        if (lockPath) releaseLock(lockPath);
+    }
+}
+
 // ============================================================================
 // 主入口
 // ============================================================================
@@ -803,6 +966,7 @@ function main() {
         console.error('  update-counts    Recalculate task counts');
         console.error('  write-checkpoint Write or update a checkpoint');
         console.error('  update-workflow  Update a workflow stage status');
+        console.error('  init-tasks      Generate tasks from feature-spec files');
         console.error('');
         console.error('Run "node update-progress.js <command> --help" for more information.');
         process.exit(1);
@@ -829,6 +993,9 @@ function main() {
             case 'update-workflow':
                 cmdUpdateWorkflow(args);
                 break;
+            case 'init-tasks':
+                cmdInitTasks(args);
+                break;
             default:
                 outputError(`Unknown command: ${args.command}`);
         }