@specpow/framework 0.2.0

package/dist/core/migration/index.js

@@ -0,0 +1,361 @@
+/**
+ * Migration Tool — 移植自 OpenSpec migration.ts (20KB)
+ *
+ * 版本迁移工具：
+ * - 从旧版本升级到新版本
+ * - 目录结构迁移
+ * - 配置文件迁移
+ * - 支持 --dry-run 预览
+ * - 自动备份
+ */
+import { existsSync, readFileSync, writeFileSync, readdirSync, renameSync, mkdirSync, rmdirSync, copyFileSync } from 'fs';
+import { join } from 'path';
+import { parse as parseYaml } from 'yaml';
+import { GlobalConfigManager } from '../config/global-config.js';
+// ============================================================
+// 迁移注册表
+// ============================================================
+const MIGRATIONS = [
+    {
+        name: 'v0.1-to-v0.2',
+        description: '迁移扁平化技能目录结构',
+        fromVersion: '0.1.0',
+        toVersion: '0.2.0',
+        execute: async (projectRoot, dryRun = false) => {
+            // 技能目录: 嵌套 → 扁平
+            const oldSkillsDir = join(projectRoot, 'skills');
+            if (existsSync(oldSkillsDir)) {
+                const categories = readdirSync(oldSkillsDir, { withFileTypes: true })
+                    .filter(d => d.isDirectory());
+                for (const category of categories) {
+                    const categoryDir = join(oldSkillsDir, category.name);
+                    const skills = readdirSync(categoryDir, { withFileTypes: true })
+                        .filter(d => d.isDirectory());
+                    for (const skill of skills) {
+                        const oldPath = join(categoryDir, skill.name);
+                        const newName = `${category.name}-${skill.name}`;
+                        const newPath = join(oldSkillsDir, newName);
+                        if (!existsSync(newPath)) {
+                            if (dryRun) {
+                                console.log(`  [DRY-RUN] 将重命名: ${oldPath} → ${newPath}`);
+                            }
+                            else {
+                                renameSync(oldPath, newPath);
+                            }
+                        }
+                    }
+                    // 删除空的分类目录
+                    if (!dryRun) {
+                        try {
+                            rmdirSync(categoryDir);
+                        }
+                        catch (e) {
+                            // 目录非空或有其他错误，保留并记录
+                            console.warn(`Warning: could not remove category directory ${categoryDir}: ${e.message}`);
+                        }
+                    }
+                }
+            }
+        },
+    },
+    {
+        name: 'config-json-to-global',
+        description: '迁移配置文件到 .specpow/config.json',
+        fromVersion: '0.1.0',
+        toVersion: '0.2.0',
+        execute: async (projectRoot, dryRun = false) => {
+            const oldConfigPath = join(projectRoot, 'specpow.config.yaml');
+            const newConfigDir = join(projectRoot, '.specpow');
+            if (existsSync(oldConfigPath)) {
+                if (dryRun) {
+                    console.log(`  [DRY-RUN] 将迁移配置: ${oldConfigPath} → ${join(newConfigDir, 'config.json')}`);
+                    return;
+                }
+                // 读取旧 YAML 配置
+                const content = readFileSync(oldConfigPath, 'utf-8');
+                // 简单转换（YAML → JSON）
+                const config = {};
+                try {
+                    // 尝试作为 JSON 解析
+                    Object.assign(config, JSON.parse(content));
+                }
+                catch {
+                    // 使用 yaml 库解析，正确处理嵌套结构
+                    try {
+                        const parsed = parseYaml(content);
+                        if (parsed && typeof parsed === 'object') {
+                            Object.assign(config, parsed);
+                        }
+                    }
+                    catch {
+                        // yaml 解析也失败，保留空配置
+                    }
+                }
+                if (!existsSync(newConfigDir)) {
+                    mkdirSync(newConfigDir, { recursive: true });
+                }
+                writeFileSync(join(newConfigDir, 'config.json'), JSON.stringify(config, null, 2), 'utf-8');
+                // 备份旧配置
+                renameSync(oldConfigPath, oldConfigPath + '.bak');
+            }
+        },
+    },
+    {
+        name: 'add-sdd-workspace',
+        description: '添加 SDD 工作区目录结构',
+        fromVersion: '0.1.0',
+        toVersion: '0.2.0',
+        execute: async (projectRoot, dryRun = false) => {
+            const sddDir = join(projectRoot, '.specpow', 'sdd');
+            const workflowLogsDir = join(projectRoot, '.specpow', 'workflow-logs');
+            if (dryRun) {
+                if (!existsSync(sddDir)) {
+                    console.log(`  [DRY-RUN] 将创建目录: ${sddDir}`);
+                }
+                if (!existsSync(workflowLogsDir)) {
+                    console.log(`  [DRY-RUN] 将创建目录: ${workflowLogsDir}`);
+                }
+                return;
+            }
+            if (!existsSync(sddDir)) {
+                mkdirSync(sddDir, { recursive: true });
+            }
+            if (!existsSync(workflowLogsDir)) {
+                mkdirSync(workflowLogsDir, { recursive: true });
+            }
+        },
+    },
+    {
+        name: 'update-tool-config',
+        description: '更新工具配置以支持多平台',
+        fromVersion: '0.1.0',
+        toVersion: '0.2.0',
+        execute: async (projectRoot, dryRun = false) => {
+            const configMgr = new GlobalConfigManager(projectRoot);
+            const config = configMgr.load();
+            if (dryRun) {
+                if (!config.version || config.version === '0.1.0') {
+                    console.log(`  [DRY-RUN] 将更新版本: 0.1.0 → 0.2.0`);
+                }
+                if (!config.sdd) {
+                    console.log(`  [DRY-RUN] 将添加 SDD 配置`);
+                }
+                if (!config.featureFlags) {
+                    console.log(`  [DRY-RUN] 将添加 featureFlags 配置`);
+                }
+                return;
+            }
+            // 补充 0.2.0 新增的字段
+            if (!config.version || config.version === '0.1.0') {
+                config.version = '0.2.0';
+            }
+            if (!config.sdd) {
+                config.sdd = { maxFixRounds: 5, workspaceDir: '.specpow/sdd', modelTier: 'standard', reviewEnabled: true, parallelEnabled: false, gitWorktreeEnabled: false };
+            }
+            if (!config.featureFlags) {
+                config.featureFlags = { parallelAgents: false, gitWorktree: false, autoCommit: true, tddEnforcement: false, visualCompanion: false };
+            }
+            configMgr.save(config);
+        },
+    },
+];
+// ============================================================
+// Semver 比较
+// ============================================================
+/**
+ * 比较两个 semver 版本号
+ * 返回: -1 (a < b), 0 (a === b), 1 (a > b)
+ *
+ * 按数值逐段比较 major.minor.patch，避免 localeCompare 的字符串排序错误
+ * （例如 "0.10.0" localeCompare "0.2.0" 返回 -1，但数值上 0.10 > 0.2）
+ */
+function compareSemver(a, b) {
+    const pa = a.split('.').map(Number);
+    const pb = b.split('.').map(Number);
+    for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+        const na = pa[i] || 0;
+        const nb = pb[i] || 0;
+        if (na !== nb)
+            return na < nb ? -1 : 1;
+    }
+    return 0;
+}
+// ============================================================
+// Migration Runner
+// ============================================================
+export class MigrationRunner {
+    projectRoot;
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+    }
+    /**
+     * 获取当前版本
+     */
+    getCurrentVersion() {
+        const configMgr = new GlobalConfigManager(this.projectRoot);
+        const config = configMgr.load();
+        return config.version || '0.1.0';
+    }
+    /**
+     * 检查需要执行的迁移
+     *
+     * @param targetVersion - 目标版本（与 run() 保持一致），默认为最高迁移的目标版本
+     */
+    getPendingMigrations(targetVersion) {
+        const currentVersion = this.getCurrentVersion();
+        const target = targetVersion || MIGRATIONS.reduce((max, m) => compareSemver(m.toVersion, max) > 0 ? m.toVersion : max, '0.0.0');
+        return MIGRATIONS.filter(m => compareSemver(m.fromVersion, currentVersion) >= 0 &&
+            compareSemver(m.toVersion, target) <= 0);
+    }
+    /**
+     * 预览迁移（dry-run）
+     *
+     * 显示将要执行的迁移步骤，但不实际执行
+     */
+    dryRun(targetVersion = '0.2.0') {
+        const currentVersion = this.getCurrentVersion();
+        const pendingSteps = MIGRATIONS
+            .filter(m => compareSemver(m.fromVersion, currentVersion) >= 0 &&
+            compareSemver(m.toVersion, targetVersion) <= 0)
+            .map(m => ({
+            name: m.name,
+            description: m.description,
+            fromVersion: m.fromVersion,
+            toVersion: m.toVersion,
+        }));
+        return {
+            pendingSteps,
+            currentVersion,
+            targetVersion,
+        };
+    }
+    /**
+     * 创建备份
+     *
+     * 在执行迁移前备份关键配置文件
+     */
+    createBackup() {
+        const backupDir = join(this.projectRoot, '.specpow', 'backups');
+        if (!existsSync(backupDir)) {
+            mkdirSync(backupDir, { recursive: true });
+        }
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        const backupPath = join(backupDir, `backup-${timestamp}`);
+        mkdirSync(backupPath, { recursive: true });
+        // 备份配置文件
+        const configPath = join(this.projectRoot, '.specpow', 'config.json');
+        if (existsSync(configPath)) {
+            copyFileSync(configPath, join(backupPath, 'config.json'));
+        }
+        // 备份旧配置（如果存在）
+        const oldConfigPath = join(this.projectRoot, 'specpow.config.yaml');
+        if (existsSync(oldConfigPath)) {
+            copyFileSync(oldConfigPath, join(backupPath, 'specpow.config.yaml'));
+        }
+        return backupPath;
+    }
+    /**
+     * 运行所有待执行的迁移
+     */
+    async run(targetVersion = '0.2.0', options = {}) {
+        const { dryRun = false, backup = true } = options;
+        let currentVersion = this.getCurrentVersion();
+        const steps = [];
+        let backupPath;
+        console.log(`\n🔄 迁移: ${currentVersion} → ${targetVersion}${dryRun ? ' [DRY-RUN]' : ''}\n`);
+        // 如果启用了备份且不是 dry-run，创建备份
+        if (backup && !dryRun) {
+            backupPath = this.createBackup() || undefined;
+            if (backupPath) {
+                console.log(`📦 已创建备份: ${backupPath}\n`);
+            }
+        }
+        for (const migration of MIGRATIONS) {
+            if (compareSemver(migration.toVersion, targetVersion) > 0) {
+                continue; // 跳过目标版本之后的迁移
+            }
+            if (compareSemver(migration.fromVersion, currentVersion) < 0) {
+                steps.push({
+                    name: migration.name,
+                    status: 'skipped',
+                    message: `Already at version ${currentVersion}`,
+                });
+                continue;
+            }
+            try {
+                if (dryRun) {
+                    // Dry-run 模式：只预览，不执行
+                    await migration.execute(this.projectRoot, true);
+                    steps.push({
+                        name: migration.name,
+                        status: 'previewed',
+                        message: `[DRY-RUN] ${migration.description}`,
+                    });
+                    console.log(`  ○ ${migration.name}: ${migration.description} [DRY-RUN]`);
+                }
+                else {
+                    // 正常模式：执行迁移
+                    await migration.execute(this.projectRoot, false);
+                    steps.push({
+                        name: migration.name,
+                        status: 'executed',
+                        message: migration.description,
+                    });
+                    console.log(`  ✓ ${migration.name}: ${migration.description}`);
+                    // 动态更新当前版本，允许链式迁移到达后续步骤
+                    currentVersion = migration.toVersion;
+                }
+            }
+            catch (err) {
+                steps.push({
+                    name: migration.name,
+                    status: 'failed',
+                    message: err.message,
+                });
+                console.log(`  ✗ ${migration.name}: ${err.message}`);
+                return {
+                    success: false,
+                    steps,
+                    currentVersion,
+                    targetVersion,
+                    backupPath,
+                };
+            }
+        }
+        // 更新版本号（非 dry-run 模式）
+        if (!dryRun) {
+            const configMgr = new GlobalConfigManager(this.projectRoot);
+            const config = configMgr.load();
+            config.version = targetVersion;
+            configMgr.save(config);
+            console.log(`\n✓ 迁移完成: ${currentVersion} → ${targetVersion}\n`);
+        }
+        else {
+            console.log(`\n✓ Dry-run 完成: ${currentVersion} → ${targetVersion}\n`);
+        }
+        return {
+            success: true,
+            steps,
+            currentVersion,
+            targetVersion,
+            backupPath,
+        };
+    }
+    /**
+     * 运行指定迁移步骤
+     */
+    async runStep(stepName) {
+        const step = MIGRATIONS.find(m => m.name === stepName);
+        if (!step) {
+            throw new Error(`Migration step "${stepName}" not found`);
+        }
+        await step.execute(this.projectRoot);
+    }
+    /**
+     * 列出所有可用的迁移
+     */
+    listMigrations() {
+        return [...MIGRATIONS];
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/core/migration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/migration/index.ts"],"names":[],"mappings":"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"}

package/dist/core/parsers/index.d.ts

@@ -0,0 +1,95 @@
+/**
+ * 解析器模块 — 工件内容解析
+ *
+ * 职责：
+ *   1. 解析 tasks.md 提取任务列表（支持 YAML frontmatter + Markdown checkbox）
+ *   2. 解析 spec.md 提取 Delta 需求
+ *   3. 解析 proposal.md 提取元数据
+ *   4. 解析 design.md 提取架构决策
+ */
+export interface ParsedTask {
+    id: string;
+    title: string;
+    description: string;
+    files: string[];
+    dependsOn: string[];
+    verification: string;
+    estimatedEffort: 'S' | 'M' | 'L';
+    completed: boolean;
+}
+/**
+ * PlanTask 适配类型 — 兼容 SDD 控制器消费端
+ */
+export interface PlanTaskCompat {
+    number: number;
+    title: string;
+    description: string;
+    files: string[];
+}
+/**
+ * 从 tasks.md 内容解析任务列表（统一入口）
+ *
+ * 解析策略：
+ * 1. 优先检测 YAML frontmatter（--- 分隔的结构化数据块）
+ * 2. 回退到 Markdown checkbox 逐行解析
+ *
+ * YAML frontmatter 格式示例：
+ * ```yaml
+ * ---
+ * tasks:
+ *   - number: 1
+ *     title: 创建用户模型
+ *     files:
+ *       - src/models/user.ts
+ *     description: 实现用户数据模型
+ *     verification: 单元测试通过
+ *     dependsOn: []
+ *     estimatedEffort: S
+ * ---
+ * ```
+ */
+export declare function parseTasksFromContent(content: string): ParsedTask[];
+/**
+ * 将 ParsedTask[] 转换为 SDD 控制器所需的 PlanTask 格式
+ */
+export declare function toPlanTasks(tasks: ParsedTask[]): PlanTaskCompat[];
+/**
+ * 解析 tasks.md 文件，提取结构化任务列表
+ * @deprecated 使用 parseTasksFromContent() 替代，支持 YAML frontmatter
+ */
+export declare function parseTasksFile(content: string): ParsedTask[];
+export interface DeltaRequirement {
+    type: 'ADDED' | 'MODIFIED' | 'REMOVED' | 'RENAMED';
+    id: string;
+    title: string;
+    description: string;
+    acceptanceCriteria: AcceptanceCriterion[];
+}
+export interface AcceptanceCriterion {
+    given: string;
+    when: string;
+    then: string;
+}
+/**
+ * 解析 spec.md 文件，提取 Delta 需求
+ */
+export declare function parseSpecFile(content: string): DeltaRequirement[];
+export interface ParsedProposal {
+    title: string;
+    motivation: string;
+    goals: string[];
+    successCriteria: string[];
+    scope: {
+        in: string[];
+        out: string[];
+    };
+    risks: {
+        description: string;
+        mitigation: string;
+    }[];
+}
+/**
+ * 解析 proposal.md 文件
+ */
+export declare function parseProposal(content: string): ParsedProposal;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/parsers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/parsers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IACjC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,CAOnE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,cAAc,EAAE,CASjE;AAoLD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,CAE5D;AAID,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,mBAAmB,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,EAAE,CA6EjE;AAsBD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,EAAE,CAAC;QAAC,GAAG,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACvC,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACtD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAyD7D"}