speccore 5.15.0 → 5.18.0

package/dist/core/risk-scorer.js

@@ -1,61 +1,190 @@
 "use strict";
-/**
- * risk-scorer — 任务风险评分 + 标签
- */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.scoreRisk = scoreRisk;
+exports.generateRiskReport = generateRiskReport;
+/**
+ * risk-scorer — 任务风险评分 + 详细报告
+ */
+const fs_extra_1 = require("fs-extra");
 /**
- * 根据任务需求内容自动评分
+ * 根据任务需求内容 + 已有源码自动评分
  */
-function scoreRisk(content, taskName) {
+async function scoreRisk(content, taskName, iterationDir) {
     let score = 0;
     const tags = [];
     const reasons = [];
+    const items = [];
     // ── 高风险: 支付/资金 ──
     if (content.match(/支付|退款|转账|提现|余额|钱包|金额|价格|账单/)) {
         score += 30;
         tags.push('💰 支付');
         reasons.push('涉及支付/资金操作');
+        items.push({
+            category: '支付安全',
+            level: '🔴',
+            description: '涉及资金交易，任何错误都可能导致资损',
+            mitigation: '必须双人审查 + 充分测试覆盖 + 添加资金操作日志',
+            source: '需求',
+        });
     }
     // ── 高风险: 权限/认证 ──
     if (content.match(/权限|角色|RBAC|认证|授权|登录|token|OAuth|JWT|鉴权/)) {
         score += 25;
         tags.push('🔐 权限');
         reasons.push('涉及权限/认证变更');
+        items.push({
+            category: '权限控制',
+            level: '🔴',
+            description: '权限变更可能造成越权访问',
+            mitigation: '逐接口检查权限注解 + 补充越权测试用例',
+            source: '需求',
+        });
+    }
+    // ── 高风险: 数据删除 ──
+    if (content.match(/DELETE\s*\|/) || content.match(/物理删除|硬删除|cascade/)) {
+        score += 20;
+        items.push({
+            category: '数据安全',
+            level: '🔴',
+            description: '物理删除操作不可逆',
+            mitigation: '建议改用软删除 + 回收站机制, 生产环境禁止物理删除',
+            source: '需求',
+        });
     }
     // ── 中风险: 批量操作 ──
     if (content.match(/批量删除|批量操作|批量导入|批量更新|全选/)) {
         score += 20;
         tags.push('📦 批量');
         reasons.push('批量操作有数据风险');
+        items.push({
+            category: '批量操作',
+            level: '🟡',
+            description: '批量操作可能影响大量数据',
+            mitigation: '添加批量限制(≤1000) + 异步处理 + 操作确认弹窗',
+            source: '需求',
+        });
     }
     // ── 中风险: 导出/报表 ──
     if (content.match(/导出|报表|Excel|CSV|下载|文件生成/)) {
         score += 15;
         tags.push('📊 导出');
         reasons.push('大数据量导出需注意性能');
+        items.push({
+            category: '性能',
+            level: '🟡',
+            description: '大数据量导出可能拖垮服务',
+            mitigation: '异步导出 + 分页查询 + 文件压缩 + 24h自动清理',
+            source: '需求',
+        });
     }
     // ── 中风险: 涉及数据库变更 ──
     if (content.match(/数据表|ALTER|建表|索引|迁移|数据迁移|DDL/)) {
         score += 15;
         tags.push('🗄️ DB');
         reasons.push('涉及数据库结构变更');
+        items.push({
+            category: '数据库变更',
+            level: '🟡',
+            description: '数据库结构变更可能影响已有功能',
+            mitigation: '先在测试环境验证 + 写好回滚脚本 + 非高峰期执行',
+            source: '需求',
+        });
     }
     // ── 中风险: 外部依赖 ──
     if (content.match(/第三方|外部API|回调|webhook|消息队列|Kafka|MQ/)) {
         score += 10;
         tags.push('🔗 外部依赖');
         reasons.push('涉及外部系统集成');
+        items.push({
+            category: '外部依赖',
+            level: '🟡',
+            description: '外部系统不可用时本功能也会受影响',
+            mitigation: '添加超时(5s) + 熔断降级 + 重试机制 + 监控告警',
+            source: '需求',
+        });
     }
     // ── 低风险标记 ──
     const crud = content.match(/\| (GET|POST|PUT|DELETE) \|/) || [];
     if (crud.length >= 2 && score < 20) {
         tags.push('📋 CRUD');
+        items.push({
+            category: '通用 CRUD',
+            level: '🟢',
+            description: '标准增删改查，风险较低',
+            mitigation: '注意输入校验 + 异常处理',
+            source: '需求',
+        });
     }
     if (score < 15) {
         tags.push('🟢 低风险');
     }
+    // ── 源码层面的风险检测 ──
+    const codeRisks = await detectCodeRisks(iterationDir, taskName);
     const level = score >= 30 ? '🔴 high' : score >= 15 ? '🟡 medium' : '🟢 low';
-    return { level, score, tags, reasons };
+    return { level, score, tags, reasons, items, codeRisks };
+}
+/**
+ * 检测源码层面的风险（从已有关联代码中分析）
+ */
+async function detectCodeRisks(iterationDir, taskName) {
+    if (!iterationDir || !taskName)
+        return [];
+    const risks = [];
+    // 检查 TECH.md 中的选型是否有已知风险
+    const techPath = `.speccore/iterations/${iterationDir}/${taskName}/backend/TECH.md`;
+    const altTechPath = `${iterationDir}/${taskName}/backend/TECH.md`;
+    let techContent = '';
+    try {
+        if (await (0, fs_extra_1.pathExists)(techPath))
+            techContent = await (0, fs_extra_1.readFile)(techPath, 'utf-8');
+        else if (await (0, fs_extra_1.pathExists)(altTechPath))
+            techContent = await (0, fs_extra_1.readFile)(altTechPath, 'utf-8');
+    }
+    catch { }
+    if (techContent) {
+        // 检测到 N+1 查询风险
+        if (techContent.match(/for\s*\(.*\)\s*\{|forEach.*\.find|循环.*查询/)) {
+            risks.push({
+                category: '性能',
+                level: '🟡',
+                description: '代码中可能存在 N+1 查询问题',
+                mitigation: '使用 JOIN 查询或批量查询代替循环中的单条查询',
+                source: '源码',
+            });
+        }
+        // 检测到未处理的异常
+        if (techContent.match(/\.catch\s*\(\s*\)|catch\s*\{\s*\}/)) {
+            risks.push({
+                category: '异常处理',
+                level: '🟡',
+                description: '存在空异常捕获，可能吞掉错误信息',
+                mitigation: '添加错误日志记录 + 统一异常处理中间件',
+                source: '源码',
+            });
+        }
+    }
+    return risks;
+}
+/**
+ * 生成详细风险报告（Markdown）
+ */
+function generateRiskReport(risk) {
+    let md = `# 风险评估\n\n`;
+    md += `- **风险等级**: ${risk.level}\n`;
+    md += `- **风险评分**: ${risk.score}/100\n`;
+    md += `- **风险标签**: ${risk.tags.join(', ') || '无'}\n\n`;
+    const allItems = [...risk.items, ...risk.codeRisks];
+    if (allItems.length === 0) {
+        md += '✅ 未检测到明显风险\n';
+        return md;
+    }
+    md += `## 风险详情 (${allItems.length} 项)\n\n`;
+    md += `| 等级 | 类别 | 描述 | 缓解建议 | 来源 |\n`;
+    md += `| :--- | :--- | :--- | :--- | :--- |\n`;
+    for (const item of allItems) {
+        md += `| ${item.level} | ${item.category} | ${item.description} | ${item.mitigation} | ${item.source} |\n`;
+    }
+    md += `\n---\n> 💡 高风险项建议在开发前 Review，中风险项开发时注意缓解措施\n`;
+    return md;
 }
 //# sourceMappingURL=risk-scorer.js.map

package/dist/core/risk-scorer.js.map

@@ -1 +1 @@
-{"version":3,"file":"risk-scorer.js","sourceRoot":"","sources":["../../src/core/risk-scorer.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAYH,8BA2DC;AA9DD;;GAEG;AACH,SAAgB,SAAS,CAAC,OAAe,EAAE,QAAgB;IACzD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,mBAAmB;IACnB,IAAI,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,EAAE,CAAC;QAChD,KAAK,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5B,CAAC;IAED,mBAAmB;IACnB,IAAI,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,EAAE,CAAC;QAC5D,KAAK,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5B,CAAC;IAED,kBAAkB;IAClB,IAAI,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,EAAE,CAAC;QAC5C,KAAK,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5B,CAAC;IAED,mBAAmB;IACnB,IAAI,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,EAAE,CAAC;QAC7C,KAAK,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC9B,CAAC;IAED,qBAAqB;IACrB,IAAI,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,EAAE,CAAC;QACjD,KAAK,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5B,CAAC;IAED,kBAAkB;IAClB,IAAI,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,EAAE,CAAC;QACxD,KAAK,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3B,CAAC;IAED,cAAc;IACd,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,IAAI,EAAE,CAAC;IAChE,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvB,CAAC;IAED,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;QACf,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtB,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC7E,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACzC,CAAC"}
+{"version":3,"file":"risk-scorer.js","sourceRoot":"","sources":["../../src/core/risk-scorer.ts"],"names":[],"mappings":"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"}

package/dist/core/spec-annotations.d.ts

@@ -0,0 +1,35 @@
+export interface SpecAnnotation {
+    type: 'module' | 'api' | 'entity' | 'dependency' | 'scope';
+    value: string;
+    file: string;
+    line: number;
+}
+export interface ModuleGroup {
+    name: string;
+    directory: string;
+    files: string[];
+    apis: string[];
+    entities: string[];
+    dependencies: string[];
+}
+/**
+ * 扫描单个文件的 Spec 注释标记
+ */
+export declare function extractAnnotations(filePath: string): Promise<SpecAnnotation[]>;
+/**
+ * 从注释标记构建模块分组
+ */
+export declare function buildModuleGroups(annotations: SpecAnnotation[]): ModuleGroup[];
+/**
+ * 根据需求描述查找对应模块（用于精准读取）
+ */
+export declare function matchModule(requirement: string, modules: ModuleGroup[]): ModuleGroup | null;
+/**
+ * 自动发现项目根目录（多工程场景）
+ */
+export declare function discoverProjectRoots(cwd: string): Promise<string[]>;
+/**
+ * 生成模块清单报告
+ */
+export declare function generateModuleReport(modules: ModuleGroup[]): string;
+//# sourceMappingURL=spec-annotations.d.ts.map

package/dist/core/spec-annotations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-annotations.d.ts","sourceRoot":"","sources":["../../src/core/spec-annotations.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAC;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAiBD;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAwBpF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,cAAc,EAAE,GAAG,WAAW,EAAE,CAkD9E;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,WAAW,EAAE,GACrB,WAAW,GAAG,IAAI,CAoBpB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAoCzE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAiBnE"}

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