speccore 5.15.1 → 5.19.0

package/dist/core/spec-annotations.js

@@ -0,0 +1,203 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractAnnotations = extractAnnotations;
+exports.buildModuleGroups = buildModuleGroups;
+exports.matchModule = matchModule;
+exports.discoverProjectRoots = discoverProjectRoots;
+exports.generateModuleReport = generateModuleReport;
+/**
+ * spec-annotations — 代码注释标记系统
+ *
+ * 开发者在代码中加注释标记，SpecCore 识别后精准定位模块边界和接口归属。
+ *
+ * 支持的注释格式:
+ *   Java:   @spec-module 订单管理  |  @spec-api POST /api/orders |  @spec-entity Order
+ *   TS/JS:  [at]spec-module 订单管理 | [at]spec-api GET /api/users
+ *   Python: # @spec-module 订单管理 | # @spec-api POST /api/orders
+ *   Go:     // @spec-module 订单管理 | // @spec-api GET /api/users
+ */
+const fs_extra_1 = require("fs-extra");
+const path_1 = require("path");
+const ANNOTATION_PATTERNS = [
+    // Java: @spec-module 订单管理
+    { comment: '//', regex: /@spec-(module|api|entity|dependency|scope)\s+(.+)/ },
+    // Java doc: * @spec-module 订单管理
+    { comment: '*', regex: /@spec-(module|api|entity|dependency|scope)\s+(.+)/ },
+    // TS/JS block: /** @spec-module 订单管理 */
+    { comment: '/**', regex: /@spec-(module|api|entity|dependency|scope)\s+(.+)/ },
+    // Python: # @spec-module 订单管理
+    { comment: '#', regex: /@spec-(module|api|entity|dependency|scope)\s+(.+)/ },
+    // Go: // @spec-module 订单管理
+    { comment: '//', regex: /@spec-(module|api|entity|dependency|scope)\s+(.+)/ },
+    // YAML: # @spec-module 订单管理
+    { comment: '#', regex: /@spec-(module|api|entity|dependency|scope)\s+(.+)/ },
+];
+/**
+ * 扫描单个文件的 Spec 注释标记
+ */
+async function extractAnnotations(filePath) {
+    if (!(await (0, fs_extra_1.pathExists)(filePath)))
+        return [];
+    const content = await (0, fs_extra_1.readFile)(filePath, 'utf-8');
+    const lines = content.split('\n');
+    const annotations = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i].trim();
+        for (const { regex } of ANNOTATION_PATTERNS) {
+            const match = line.match(regex);
+            if (match) {
+                annotations.push({
+                    type: match[1],
+                    value: match[2].trim(),
+                    file: filePath,
+                    line: i + 1,
+                });
+                break;
+            }
+        }
+    }
+    return annotations;
+}
+/**
+ * 从注释标记构建模块分组
+ */
+function buildModuleGroups(annotations) {
+    const moduleMap = new Map();
+    const scopeFiles = new Set();
+    // 收集 scope 标记
+    for (const a of annotations) {
+        if (a.type === 'scope') {
+            scopeFiles.add(a.file);
+        }
+    }
+    // 构建模块
+    for (const a of annotations) {
+        if (a.type !== 'module')
+            continue;
+        const dir = a.file.substring(0, a.file.lastIndexOf('/'));
+        const key = `${a.value}@${dir}`;
+        if (!moduleMap.has(key)) {
+            moduleMap.set(key, {
+                name: a.value,
+                directory: dir,
+                files: [a.file],
+                apis: [],
+                entities: [],
+                dependencies: [],
+            });
+        }
+    }
+    // 补充 API、Entity、依赖
+    for (const a of annotations) {
+        if (a.type === 'module')
+            continue;
+        const dir = a.file.substring(0, a.file.lastIndexOf('/'));
+        // 找到同目录的模块
+        for (const [key, group] of moduleMap) {
+            if (a.file.startsWith(group.directory) || dir === group.directory) {
+                switch (a.type) {
+                    case 'api':
+                        group.apis.push(a.value);
+                        break;
+                    case 'entity':
+                        group.entities.push(a.value);
+                        break;
+                    case 'dependency':
+                        group.dependencies.push(a.value);
+                        break;
+                }
+                if (!group.files.includes(a.file))
+                    group.files.push(a.file);
+                break;
+            }
+        }
+    }
+    return [...moduleMap.values()];
+}
+/**
+ * 根据需求描述查找对应模块（用于精准读取）
+ */
+function matchModule(requirement, modules) {
+    let best = null;
+    let bestScore = 0;
+    for (const mod of modules) {
+        let score = 0;
+        if (requirement.includes(mod.name))
+            score += 30;
+        for (const api of mod.apis) {
+            if (requirement.includes(api))
+                score += 20;
+        }
+        for (const entity of mod.entities) {
+            if (requirement.toLowerCase().includes(entity.toLowerCase()))
+                score += 15;
+        }
+        if (score > bestScore) {
+            bestScore = score;
+            best = mod;
+        }
+    }
+    return bestScore >= 20 ? best : null;
+}
+/**
+ * 自动发现项目根目录（多工程场景）
+ */
+async function discoverProjectRoots(cwd) {
+    const roots = [];
+    const { readdirSync } = require('fs');
+    const { existsSync } = require('fs');
+    const projectFiles = [
+        'package.json', 'pom.xml', 'go.mod', 'Cargo.toml',
+        'requirements.txt', 'setup.py', 'build.gradle', 'Makefile'
+    ];
+    // 当前目录
+    for (const pf of projectFiles) {
+        if (existsSync((0, path_1.join)(cwd, pf))) {
+            roots.push(cwd);
+            break;
+        }
+    }
+    // 子目录（monorepo 场景）
+    try {
+        const entries = readdirSync(cwd, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            if (entry.name.startsWith('.') || entry.name === 'node_modules')
+                continue;
+            const subPath = (0, path_1.join)(cwd, entry.name);
+            for (const pf of projectFiles) {
+                if (existsSync((0, path_1.join)(subPath, pf))) {
+                    if (!roots.includes(subPath))
+                        roots.push(subPath);
+                    break;
+                }
+            }
+        }
+    }
+    catch { }
+    return roots.length > 0 ? roots : [cwd];
+}
+/**
+ * 生成模块清单报告
+ */
+function generateModuleReport(modules) {
+    if (modules.length === 0)
+        return '# 暂无模块标记\n\n在代码中添加 `@spec-module 模块名` 注释来建立模块索引。';
+    let report = '# 代码模块清单\n\n';
+    report += `> 通过 @spec-* 注释自动识别 | ${new Date().toISOString().split('T')[0]}\n\n`;
+    for (const mod of modules) {
+        report += `## ${mod.name}\n\n`;
+        report += `- **目录**: \`${mod.directory}\`\n`;
+        report += `- **文件数**: ${mod.files.length}\n`;
+        if (mod.apis.length > 0)
+            report += `- **API**: ${mod.apis.join(', ')}\n`;
+        if (mod.entities.length > 0)
+            report += `- **实体**: ${mod.entities.join(', ')}\n`;
+        if (mod.dependencies.length > 0)
+            report += `- **依赖**: ${mod.dependencies.join(', ')}\n`;
+        report += '\n';
+    }
+    return report;
+}
+//# sourceMappingURL=spec-annotations.js.map

package/dist/core/spec-annotations.js.map

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

package/dist/core/unified-config.d.ts

@@ -0,0 +1,44 @@
+export interface SpecConfig {
+    project: {
+        name: string;
+        description?: string;
+        version?: string;
+    };
+    tech_stack: {
+        backend?: string;
+        frontend?: string;
+        database?: string;
+        cache?: string;
+        mq?: string;
+    };
+    team: {
+        members: {
+            name: string;
+            role: string;
+            assignee?: string;
+        }[];
+    };
+    platforms: string[];
+    git: {
+        default_base: string;
+        branch_prefix: string;
+    };
+    code_scope: string[];
+    conventions: {
+        commit?: string;
+        naming?: string;
+        review?: string;
+    };
+    quality_gates: {
+        enforce_testing: boolean;
+        enforce_review: boolean;
+        require_pr: boolean;
+    };
+}
+export declare function loadConfig(): Promise<SpecConfig>;
+export declare function saveConfig(config: SpecConfig): Promise<void>;
+/**
+ * 初始化时生成 .speccore.yml
+ */
+export declare function initConfig(projectName?: string): Promise<void>;
+//# sourceMappingURL=unified-config.d.ts.map

package/dist/core/unified-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unified-config.d.ts","sourceRoot":"","sources":["../../src/core/unified-config.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,UAAU,EAAE;QACV,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,EAAE,CAAC,EAAE,MAAM,CAAC;KACb,CAAC;IACF,IAAI,EAAE;QACJ,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KAC9D,CAAC;IACF,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,EAAE;QACH,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE;QACX,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,aAAa,EAAE;QACb,eAAe,EAAE,OAAO,CAAC;QACzB,cAAc,EAAE,OAAO,CAAC;QACxB,UAAU,EAAE,OAAO,CAAC;KACrB,CAAC;CACH;AAeD,wBAAsB,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC,CAUtD;AAED,wBAAsB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKpE"}

package/dist/core/unified-config.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+exports.saveConfig = saveConfig;
+exports.initConfig = initConfig;
+/**
+ * unified-config — .speccore.yml 统一配置入口
+ *
+ * 合并 SETTINGS.md / CONSTITUTION.md / TEAM.md 的配置到单一 YAML
+ * 向后兼容：现有项目继续用旧文件，新项目自动用 .speccore.yml
+ */
+const fs_extra_1 = require("fs-extra");
+const path_1 = require("path");
+const logger_1 = require("../utils/logger");
+const DEFAULT_CONFIG = {
+    project: { name: 'my-project' },
+    tech_stack: {},
+    team: { members: [] },
+    platforms: [],
+    git: { default_base: 'main', branch_prefix: 'feature/' },
+    code_scope: ['src/'],
+    conventions: {},
+    quality_gates: { enforce_testing: true, enforce_review: true, require_pr: true },
+};
+const CONFIG_PATH = (0, path_1.join)('.speccore.yml');
+async function loadConfig() {
+    if (await (0, fs_extra_1.pathExists)(CONFIG_PATH)) {
+        try {
+            const raw = await (0, fs_extra_1.readFile)(CONFIG_PATH, 'utf-8');
+            return { ...DEFAULT_CONFIG, ...parseYaml(raw) };
+        }
+        catch (e) {
+            logger_1.logger.warn(`⚠️ .speccore.yml 解析失败，使用默认配置`);
+        }
+    }
+    return DEFAULT_CONFIG;
+}
+async function saveConfig(config) {
+    const yaml = toYaml(config);
+    await (0, fs_extra_1.writeFile)(CONFIG_PATH, yaml, 'utf-8');
+}
+/**
+ * 初始化时生成 .speccore.yml
+ */
+async function initConfig(projectName) {
+    const config = { ...DEFAULT_CONFIG };
+    if (projectName)
+        config.project.name = projectName;
+    await saveConfig(config);
+    logger_1.logger.info(`  📄 .speccore.yml 已生成`);
+}
+/**
+ * 简易 YAML 解析器（只处理简单 key-value + list）
+ */
+function parseYaml(content) {
+    const result = {};
+    const lines = content.split('\n');
+    let currentSection = null;
+    let currentList = null;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        // Top-level section
+        if (!trimmed.startsWith('-') && trimmed.endsWith(':')) {
+            currentSection = trimmed.slice(0, -1).trim();
+            if (!result[currentSection])
+                result[currentSection] = {};
+            currentList = null;
+            continue;
+        }
+        // List item
+        if (trimmed.startsWith('- ') && currentSection) {
+            const value = trimmed.slice(2).trim();
+            if (!Array.isArray(result[currentSection])) {
+                result[currentSection] = [];
+            }
+            result[currentSection].push(value);
+            currentList = currentSection;
+            continue;
+        }
+        // Sub-section
+        if (!trimmed.startsWith('-') && trimmed.endsWith(':') && currentSection) {
+            const subSection = trimmed.slice(0, -1).trim();
+            if (typeof result[currentSection] === 'object' && !Array.isArray(result[currentSection])) {
+                result[currentSection][subSection] = result[currentSection][subSection] || {};
+            }
+            currentList = null;
+            continue;
+        }
+        // Key: value
+        if (trimmed.includes(':') && !trimmed.endsWith(':')) {
+            const [key, ...rest] = trimmed.split(':');
+            const value = rest.join(':').trim();
+            if (currentSection && typeof result[currentSection] === 'object') {
+                result[currentSection][key.trim()] = value;
+            }
+            else {
+                result[key.trim()] = value;
+            }
+        }
+    }
+    return result;
+}
+function toYaml(config) {
+    let yaml = '# SpecCore Configuration\n';
+    yaml += `# ${new Date().toISOString().split('T')[0]}\n\n`;
+    yaml += `project:\n  name: ${config.project.name}\n`;
+    if (config.project.description)
+        yaml += `  description: ${config.project.description}\n\n`;
+    else
+        yaml += '\n';
+    yaml += 'tech_stack:\n';
+    for (const [k, v] of Object.entries(config.tech_stack)) {
+        if (v)
+            yaml += `  ${k}: ${v}\n`;
+    }
+    yaml += '\n';
+    yaml += 'team:\n  members:\n';
+    for (const m of config.team.members) {
+        yaml += `    - name: ${m.name}\n      role: ${m.role}\n`;
+    }
+    yaml += '\n';
+    yaml += 'platforms:\n';
+    for (const p of config.platforms) {
+        yaml += `  - ${p}\n`;
+    }
+    yaml += '\n';
+    yaml += `git:\n  default_base: ${config.git.default_base}\n  branch_prefix: ${config.git.branch_prefix}\n\n`;
+    yaml += 'code_scope:\n';
+    for (const s of config.code_scope) {
+        yaml += `  - ${s}\n`;
+    }
+    yaml += '\n';
+    yaml += 'quality_gates:\n';
+    yaml += `  enforce_testing: ${config.quality_gates.enforce_testing}\n`;
+    yaml += `  enforce_review: ${config.quality_gates.enforce_review}\n`;
+    yaml += `  require_pr: ${config.quality_gates.require_pr}\n`;
+    return yaml;
+}
+//# sourceMappingURL=unified-config.js.map

package/dist/core/unified-config.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "speccore",
-  "version": "5.15.1",
+  "version": "5.19.0",
   "description": "SpecCore - Code by Spec, Not by Vibe.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -52,4 +52,4 @@
   "engines": {
     "node": ">=18.0.0"
   }
-}
+}

package/dist/commands/hooks.d.ts

@@ -1,5 +0,0 @@
-/**
- * hooks — Git Hook 安装
- */
-export declare function hooksCommand(): void;
-//# sourceMappingURL=hooks.d.ts.map

package/dist/commands/hooks.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/commands/hooks.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,wBAAgB,YAAY,IAAI,IAAI,CASnC"}

package/dist/commands/hooks.js

@@ -1,22 +0,0 @@
-"use strict";
-/**
- * hooks — Git Hook 安装
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.hooksCommand = hooksCommand;
-const logger_1 = require("../utils/logger");
-const git_integration_1 = require("../core/git-integration");
-function hooksCommand() {
-    try {
-        const result = (0, git_integration_1.installGitHooks)();
-        logger_1.logger.success('Git hooks installed:');
-        if (result.preCommit)
-            logger_1.logger.info('  ✅ .git/hooks/pre-commit  (check @spec annotations)');
-        if (result.prePush)
-            logger_1.logger.info('  ✅ .git/hooks/pre-push    (run speccore validate)');
-    }
-    catch (error) {
-        logger_1.logger.error(`Failed to install Git hooks: ${error}`);
-    }
-}
-//# sourceMappingURL=hooks.js.map

package/dist/commands/hooks.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/commands/hooks.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAKH,oCASC;AAZD,4CAAyC;AACzC,6DAA0D;AAE1D,SAAgB,YAAY;IAC1B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,iCAAe,GAAE,CAAC;QACjC,eAAM,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;QACvC,IAAI,MAAM,CAAC,SAAS;YAAE,eAAM,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;QAC1F,IAAI,MAAM,CAAC,OAAO;YAAE,eAAM,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;IACxF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,eAAM,CAAC,KAAK,CAAC,gCAAgC,KAAK,EAAE,CAAC,CAAC;IACxD,CAAC;AACH,CAAC"}

package/dist/commands/research.d.ts

@@ -1,14 +0,0 @@
-/**
- * research - 技术调研命令
- * 创建技术调研任务，评估技术方案、对比工具选项
- */
-export interface ResearchOptions {
-    name?: string;
-    desc?: string;
-    topic?: string;
-    options?: string;
-    taskId?: string;
-    iteration?: string;
-}
-export declare function researchCommand(options: ResearchOptions): Promise<void>;
-//# sourceMappingURL=research.d.ts.map

package/dist/commands/research.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"research.d.ts","sourceRoot":"","sources":["../../src/commands/research.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA0D7E"}

package/dist/commands/research.js

@@ -1,181 +0,0 @@
-"use strict";
-/**
- * research - 技术调研命令
- * 创建技术调研任务，评估技术方案、对比工具选项
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.researchCommand = researchCommand;
-const logger_1 = require("../utils/logger");
-const context_1 = require("../core/context");
-const fs_extra_1 = require("fs-extra");
-const path_1 = require("path");
-async function researchCommand(options) {
-    if (!options.name && !options.topic) {
-        logger_1.logger.error('请提供调研主题。用法: speccore research --name "<主题>" [--options "选项A,选项B"]');
-        return;
-    }
-    const spinner = new logger_1.Spinner('正在创建技术调研任务...');
-    spinner.start();
-    try {
-        const iteration = await (0, context_1.getDefaultIteration)(options.iteration);
-        if (!iteration) {
-            spinner.fail('未找到活跃期次。请先运行: speccore iteration create --name <名称>');
-            return;
-        }
-        const topic = options.name || options.topic || '技术调研';
-        const taskId = options.taskId || await generateTaskId(iteration);
-        const compareOptions = options.options
-            ? options.options.split(',').map((o) => o.trim())
-            : [];
-        // 创建调研任务目录
-        const taskDir = (0, path_1.join)(iteration, taskId);
-        await (0, fs_extra_1.ensureDir)((0, path_1.join)(taskDir, 'backend'));
-        // 创建 .task-type
-        await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '.task-type'), 'research');
-        // 生成调研 Spec
-        await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, 'backend', 'REQ.md'), generateResearchReq(topic, options.desc || '', compareOptions));
-        await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, 'backend', 'TASK.md'), generateResearchTask(topic, options.desc || ''));
-        spinner.stop(`技术调研任务已创建: ${taskId}`);
-        logger_1.logger.info('');
-        logger_1.logger.info(`🔬 调研详情:`);
-        logger_1.logger.info(`   期次: ${iteration}`);
-        logger_1.logger.info(`   任务: ${taskId} - ${topic}`);
-        if (compareOptions.length > 0) {
-            logger_1.logger.info(`   对比选项: ${compareOptions.join(', ')}`);
-        }
-        if (options.desc) {
-            logger_1.logger.info(`   描述: ${options.desc}`);
-        }
-        logger_1.logger.info('');
-        logger_1.logger.info('下一步:');
-        logger_1.logger.info(`  1. 编辑 ${taskId}/backend/REQ.md 完善调研范围`);
-        logger_1.logger.info(`  2. 运行: speccore execute --task=${taskId}`);
-    }
-    catch (error) {
-        spinner.fail(`调研任务创建失败: ${error}`);
-        throw error;
-    }
-}
-async function generateTaskId(iteration) {
-    let maxId = 0;
-    const iterationDir = (0, path_1.join)(process.cwd(), iteration);
-    if (await (0, fs_extra_1.pathExists)(iterationDir)) {
-        const { readdir } = await Promise.resolve().then(() => __importStar(require('fs-extra')));
-        const entries = await readdir(iterationDir);
-        for (const entry of entries) {
-            const match = entry.match(/^Task-(\d+)$/);
-            if (match) {
-                const id = parseInt(match[1], 10);
-                if (id > maxId)
-                    maxId = id;
-            }
-        }
-    }
-    return `Task-${String(maxId + 1).padStart(3, '0')}`;
-}
-function generateResearchReq(topic, desc, options) {
-    let optionsSection = '';
-    if (options.length > 0) {
-        optionsSection = '\n## 3. 候选方案\n\n';
-        for (const opt of options) {
-            optionsSection += `### ${opt}\n\n- 优势：\n- 劣势：\n- 适用场景：\n\n`;
-        }
-    }
-    return `# ${topic} - 技术调研需求
-
-## 1. 调研背景
-
-${desc || '请补充调研背景'}
-
-## 2. 调研目标
-
-- 
-- 
-${optionsSection}
-## ${options.length > 0 ? '4' : '3'}. 评估维度
-
-| 维度 | 权重 | 说明 |
-| :--- | :--- | :--- |
-| 性能 | 30% | |
-| 易用性 | 25% | |
-| 生态/社区 | 20% | |
-| 维护成本 | 15% | |
-| 团队熟悉度 | 10% | |
-
-## ${options.length > 0 ? '5' : '4'}. 决策标准
-
-- 
-- 
-
-## ${options.length > 0 ? '6' : '5'}. 产出物
-
-- [ ] 技术调研报告
-- [ ] Demo 代码（如适用）
-- [ ] 推荐方案及理由
-`;
-}
-function generateResearchTask(topic, desc) {
-    const now = new Date().toISOString().split('T')[0];
-    return `# ${topic} - 执行追踪
-
-> **任务类型**: research | **创建日期**: ${now} | **状态**: 🔲 待开发
-
-## 1. 变更履历
-
-| 日期 | 版本 | 变更说明 | 作者 |
-| :--- | :--- | :--- | :--- |
-| ${now} | v1.0 | 初始创建：${desc || topic} | SpecCore |
-
-## 2. 调研步骤
-
-- [ ] 信息收集
-- [ ] 对比分析
-- [ ] Demo 验证
-- [ ] 撰写报告
-- [ ] 团队评审
-
-## 3. 参考资源
-
-| 资源 | 链接 | 备注 |
-| :--- | :--- | :--- |
-| | | |
-
-## 4. 结论与建议
-
-（调研完成后填写）
-`;
-}
-//# sourceMappingURL=research.js.map