speccrew 0.5.6 → 0.5.8

package/docs/GETTING-STARTED.tr.md

@@ -90,28 +90,11 @@ flowchart LR
 
 ---
 
-## 3. Sıfırıncı Adım: Proje Teşhisi ve Bilgi Tabanı Başlatma
+## 3. Sıfırıncı Adım: Bilgi Tabanı Başlatma
 
 Resmi mühendislik sürecini başlatmadan önce proje bilgi tabanını başlatmanız gerekir.
 
-### 3.1 Proje Teşhisi
-
-**Örnek Konuşma**:
-```
-@speccrew-team-leader projeyi teşhis et
-```
-
-**Ajan Ne Yapacak**:
-- Proje yapısını tara
-- Teknoloji yığınını tespit et
-- İş modüllerini tanımla
-
-**Çıktı**:
-```
-speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
-```
-
-### 3.2 Teknik Bilgi Tabanı Başlatma
+### 3.1 Teknik Bilgi Tabanı Başlatma
 
 **Örnek Konuşma**:
 ```
@@ -133,7 +116,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
 └── INDEX.md               # İndeks dosyası
 ```
 
-### 3.3 İş Bilgi Tabanı Başlatma
+### 3.2 İş Bilgi Tabanı Başlatma
 
 **Örnek Konuşma**:
 ```
@@ -466,11 +449,24 @@ speccrew update
 
 > **Not**: Her iki adım da gereklidir. Yalnızca `speccrew update` çalıştırmak CLI aracının kendisini güncellemez; yalnızca `npm install` çalıştırmak proje dosyalarını güncellemez.
 
-### S5: Geçmiş iterasyonları nasıl görüntülerim?
+### S5: `speccrew update` yeni sürüm gösteriyor ancak kurulumdan sonra hala eski sürüm?
+
+Genellikle npm önbelleğinden kaynaklanır. Çözüm:
+```bash
+npm cache clean --force
+npm install -g speccrew@latest
+npm list -g speccrew
+```
+Hala çalışmazsa, belirli bir sürüm yükleyin:
+```bash
+npm install -g speccrew@0.5.6
+```
+
+### S6: Geçmiş iterasyonları nasıl görüntülerim?
 
 Arşivledikten sonra `speccrew-workspace/iteration-archives/` içinde inceleyin, `{numara}-{tip}-{isim}-{tarih}/` formatında düzenlenmiştir.
 
-### S6: Bilgi tabanının düzenli olarak güncellenmesi gerekiyor mu?
+### S7: Bilgi tabanının düzenli olarak güncellenmesi gerekiyor mu?
 
 Aşağıdaki durumlarda yeniden başlatma gerekir:
 - Proje yapısında önemli değişiklikler
@@ -485,7 +481,6 @@ Aşağıdaki durumlarda yeniden başlatma gerekir:
 
 | Aşama | Ajan | Başlangıç Konuşması |
 |------|-------|-------------------|
-| Teşhis | Team Leader | `@speccrew-team-leader projeyi teşhis et` |
 | Başlatma | Team Leader | `@speccrew-team-leader teknik bilgi tabanını başlat` |
 | Gereksinim Analizi | Product Manager | `@speccrew-product-manager yeni bir gereksinimim var: [açıklama]` |
 | Özellik Tasarımı | Feature Designer | `@speccrew-feature-designer özellik tasarımına başla` |
@@ -519,5 +514,5 @@ Aşağıdaki durumlarda yeniden başlatma gerekir:
 ## Sonraki Adımlar
 
 1. Projenizi başlatmak için `speccrew init --ide qoder` çalıştırın
-2. Sıfırıncı Adımı uygulayın: Proje Teşhisi ve Bilgi Tabanı Başlatma
+2. Sıfırıncı Adımı uygulayın: Bilgi Tabanı Başlatma
 3. İş akışını takip ederek her aşamada ilerleyin, şart odaklı geliştirme deneyiminin keyfini çıkarın!

package/docs/GETTING-STARTED.uk.md

@@ -90,28 +90,11 @@ flowchart LR
 
 ---
 
-## 3. Нульовий Крок: Діагностика Проекту та Ініціалізація Бази Знань
+## 3. Нульовий Крок: Ініціалізація Бази Знань
 
 Перед початком формального інженерного процесу необхідно ініціалізувати базу знань проекту.
 
-### 3.1 Діагностика Проекту
-
-**Приклад Діалогу**:
-```
-@speccrew-team-leader діагностувати проект
-```
-
-**Що Зробить Агент**:
-- Сканування структури проекту
-- Виявлення технологічного стеку
-- Ідентифікація бізнес-модулів
-
-**Результат**:
-```
-speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
-```
-
-### 3.2 Ініціалізація Технічної Бази Знань
+### 3.1 Ініціалізація Технічної Бази Знань
 
 **Приклад Діалогу**:
 ```
@@ -133,7 +116,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
 └── INDEX.md               # Файл індексу
 ```
 
-### 3.3 Ініціалізація Бізнес-Бази Знань
+### 3.2 Ініціалізація Бізнес-Бази Знань
 
 **Приклад Діалогу**:
 ```
@@ -466,11 +449,24 @@ speccrew update
 
 > **Примітка**: Обидва етапи обов'язкові. Виконання тільки `speccrew update` не оновить сам CLI-інструмент; виконання тільки `npm install` не оновить файли проекту.
 
-### П5: Як переглянути історичні ітерації?
+### П5: `speccrew update` показує нову версію, але після встановлення все ще стара?
+
+Зазвичай це викликано кешем npm. Рішення:
+```bash
+npm cache clean --force
+npm install -g speccrew@latest
+npm list -g speccrew
+```
+Якщо все ще не працює, встановіть конкретну версію:
+```bash
+npm install -g speccrew@0.5.6
+```
+
+### П6: Як переглянути історичні ітерації?
 
 Після архівування перегляньте в `speccrew-workspace/iteration-archives/`, організовано у форматі `{номер}-{тип}-{ім'я}-{дата}/`.
 
-### П6: Чи база знань потребує регулярного оновлення?
+### П7: Чи база знань потребує регулярного оновлення?
 
 Реініціалізація потрібна в наступних ситуаціях:
 - Значні зміни структури проекту
@@ -485,7 +481,6 @@ speccrew update
 
 | Етап | Агент | Початковий Діалог |
 |------|-------|-------------------|
-| Діагностика | Team Leader | `@speccrew-team-leader діагностувати проект` |
 | Ініціалізація | Team Leader | `@speccrew-team-leader ініціалізувати технічну базу знань` |
 | Аналіз Вимог | Product Manager | `@speccrew-product-manager у мене нова вимога: [опис]` |
 | Проектування Функцій | Feature Designer | `@speccrew-feature-designer розпочати проектування функцій` |
@@ -519,5 +514,5 @@ speccrew update
 ## Наступні Кроки
 
 1. Виконайте `speccrew init --ide qoder` для ініціалізації вашого проекту
-2. Виконайте Нульовий Крок: Діагностика Проекту та Ініціалізація Бази Знань
+2. Виконайте Нульовий Крок: Ініціалізація Бази Знань
 3. Просувайтесь через кожен етап слідуючи робочому процесу, насолоджуйтесь досвідом розробки на основі специфікацій!

package/docs/GETTING-STARTED.vi.md

@@ -90,28 +90,11 @@ flowchart LR
 
 ---
 
-## 3. Bước Không: Chẩn Đoán Dự Án và Khởi Tạo Cơ Sở Kiến Thức
+## 3. Bước Không: Khởi Tạo Cơ Sở Kiến Thức
 
 Trước khi bắt đầu quy trình kỹ thuật chính thức, bạn cần khởi tạo cơ sở kiến thức của dự án.
 
-### 3.1 Chẩn Đoán Dự Án
-
-**Ví Dụ Hội Thoại**:
-```
-@speccrew-team-leader chẩn đoán dự án
-```
-
-**Agent Sẽ Làm Gì**:
-- Quét cấu trúc dự án
-- Phát hiện công nghệ stack
-- Xác định các module nghiệp vụ
-
-**Kết Quả**:
-```
-speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
-```
-
-### 3.2 Khởi Tạo Cơ Sở Kiến Thức Kỹ Thuật
+### 3.1 Khởi Tạo Cơ Sở Kiến Thức Kỹ Thuật
 
 **Ví Dụ Hội Thoại**:
 ```
@@ -133,7 +116,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
 └── INDEX.md               # Tệp chỉ mục
 ```
 
-### 3.3 Khởi Tạo Cơ Sở Kiến Thức Nghiệp Vụ
+### 3.2 Khởi Tạo Cơ Sở Kiến Thức Nghiệp Vụ
 
 **Ví Dụ Hội Thoại**:
 ```
@@ -466,11 +449,24 @@ speccrew update
 
 > **Lưu ý**: Cả hai bước đều cần thiết. Chỉ chạy `speccrew update` sẽ không cập nhật chính công cụ CLI; chỉ chạy `npm install` sẽ không cập nhật các tệp dự án.
 
-### H5: Làm thế nào để xem các iteration lịch sử?
+### H5: `speccrew update` hiển thị phiên bản mới nhưng sau cài đặt vẫn là phiên bản cũ?
+
+Thường do bộ nhớ cache npm. Cách giải quyết:
+```bash
+npm cache clean --force
+npm install -g speccrew@latest
+npm list -g speccrew
+```
+Nếu vẫn không được, hãy cài đặt phiên bản cụ thể:
+```bash
+npm install -g speccrew@0.5.6
+```
+
+### H6: Làm thế nào để xem các iteration lịch sử?
 
 Sau khi lưu trữ, xem trong `speccrew-workspace/iteration-archives/`, được tổ chức theo định dạng `{số}-{loại}-{tên}-{ngày}/`.
 
-### H6: Cơ sở kiến thức có cần cập nhật thường xuyên không?
+### H7: Cơ sở kiến thức có cần cập nhật thường xuyên không?
 
 Cần khởi tạo lại trong các tình huống sau:
 - Thay đổi đáng kể về cấu trúc dự án
@@ -485,7 +481,6 @@ Cần khởi tạo lại trong các tình huống sau:
 
 | Giai Đoạn | Agent | Hội Thoại Bắt Đầu |
 |------|-------|-------------------|
-| Chẩn Đoán | Team Leader | `@speccrew-team-leader chẩn đoán dự án` |
 | Khởi Tạo | Team Leader | `@speccrew-team-leader khởi tạo cơ sở kiến thức kỹ thuật` |
 | Phân Tích Yêu Cầu | Product Manager | `@speccrew-product-manager tôi có yêu cầu mới: [mô tả]` |
 | Thiết Kế Tính Năng | Feature Designer | `@speccrew-feature-designer bắt đầu thiết kế tính năng` |
@@ -519,5 +514,5 @@ Cần khởi tạo lại trong các tình huống sau:
 ## 9. Bước Tiếp Theo
 
 1. Chạy `speccrew init --ide qoder` để khởi tạo dự án của bạn
-2. Thực hiện Bước Không: Chẩn Đoán Dự Án và Khởi Tạo Cơ Sở Kiến Thức
+2. Thực hiện Bước Không: Khởi Tạo Cơ Sở Kiến Thức
 3. Tiến bộ qua từng giai đoạn theo quy trình làm việc, tận hưởng trải nghiệm phát triển dựa trên đặc tả!

package/docs/GETTING-STARTED.zh-TW.md

@@ -89,28 +89,11 @@ flowchart LR
 
 ---
 
-## 3. 第零步：專案診斷與知識庫初始化
+## 3. 第零步：知識庫初始化
 
 在開始正式工程流程前，需要先初始化專案知識庫。
 
-### 3.1 專案診斷
-
-**對話範例**：
-```
-@speccrew-team-leader 診斷專案
-```
-
-**Agent 會做什麼**：
-- 掃描專案結構
-- 偵測技術棧
-- 識別業務模組
-
-**產出物**：
-```
-speccrew-workspace/knowledges/base/diagnosis-reports/diagnosis-report-{date}.md
-```
-
-### 3.2 技術知識庫初始化
+### 3.1 技術知識庫初始化
 
 **對話範例**：
 ```
@@ -132,7 +115,7 @@ speccrew-workspace/knowledges/techs/{platform-id}/
 └── INDEX.md               # 索引檔案
 ```
 
-### 3.3 業務知識庫初始化
+### 3.2 業務知識庫初始化
 
 **對話範例**：
 ```
@@ -465,11 +448,29 @@ speccrew update
 
 > **注意**：兩個步驟都需要執行。只執行 `speccrew update` 不會更新 CLI 工具本身；只執行 `npm install` 不會更新專案檔案。
 
-### Q5: 如何查看歷史迭代？
+### Q5: `speccrew update` 顯示有新版本可用，但 `npm install -g speccrew@latest` 仍然安裝舊版本？
+
+這通常是 npm 緩存造成的。解決方法：
+
+```bash
+# 清除 npm 緩存並重新安裝
+npm cache clean --force
+npm install -g speccrew@latest
+
+# 驗證版本
+npm list -g speccrew
+```
+
+如果仍然無效，嘗試使用特定版本號安裝：
+```bash
+npm install -g speccrew@0.5.6
+```
+
+### Q6: 如何查看歷史迭代？
 
 歸檔後在 `speccrew-workspace/iteration-archives/` 中查看，按 `{序號}-{類型}-{名稱}-{日期}/` 格式組織。
 
-### Q6: 知識庫需要定期更新嗎？
+### Q7: 知識庫需要定期更新嗎？
 
 以下情況需要重新初始化：
 - 專案結構發生重大變化
@@ -484,7 +485,6 @@ speccrew update
 
 | 階段 | Agent | 啟動對話 |
 |------|-------|----------|
-| 診斷 | Team Leader | `@speccrew-team-leader 診斷專案` |
 | 初始化 | Team Leader | `@speccrew-team-leader 初始化技術知識庫` |
 | 需求分析 | Product Manager | `@speccrew-product-manager 我有一個新需求：[描述]` |
 | 功能設計 | Feature Designer | `@speccrew-feature-designer 開始功能設計` |
@@ -518,5 +518,5 @@ speccrew update
 ## 9. 下一步
 
 1. 執行 `speccrew init --ide qoder` 初始化您的專案
-2. 執行第零步：專案診斷與知識庫初始化
+2. 執行第零步：知識庫初始化
 3. 按照工作流程逐階段推進，享受規範驅動的開發體驗！

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "speccrew",
-  "version": "0.5.6",
+  "version": "0.5.8",
   "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}`);
         }