speccore 7.1.0 → 7.2.0

package/dist/core/semantic-locator.js

@@ -0,0 +1,290 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.locateFeatureInDoc = locateFeatureInDoc;
+exports.locateFeatureInRequirements = locateFeatureInRequirements;
+exports.locateFeatureInCode = locateFeatureInCode;
+exports.locateFeatureInGlobal = locateFeatureInGlobal;
+exports.buildFeatureContext = buildFeatureContext;
+exports.buildFeatureContextPrompt = buildFeatureContextPrompt;
+/**
+ * semantic-locator — 语义定位引擎
+ * v7.2.0+
+ *
+ * 基于功能名称在文档、代码、全局分析产出中定位相关内容，
+ * 为细粒度分析提供精确的上下文关联。
+ */
+const fs_extra_1 = require("fs-extra");
+const path_1 = require("path");
+const logger_1 = require("../utils/logger");
+// 功能关键词同义词扩展
+const FEATURE_ALIASES = {
+    '订单': ['order', '下单', '订单管理', '订单详情', '订单列表', '订单状态'],
+    '认证': ['auth', '登录', '登出', '注册', 'token', 'jwt', 'oauth', 'sso', '权限'],
+    '支付': ['payment', '收银', '付款', '充值', '退款', '结算', '账单'],
+    '用户': ['user', '会员', '客户', 'account', 'profile', '个人信息'],
+    '消息': ['message', '通知', '推送', '私信', '公告', '站内信', 'im'],
+    '文件': ['file', '上传', '下载', 'oss', '存储', '附件', '图片'],
+    '搜索': ['search', '检索', '查询', '筛选', '过滤', '排序', 'es'],
+};
+function expandKeywords(featureName) {
+    const keywords = [featureName];
+    const lower = featureName.toLowerCase();
+    for (const [key, aliases] of Object.entries(FEATURE_ALIASES)) {
+        if (featureName.includes(key) || aliases.some(a => lower.includes(a.toLowerCase()))) {
+            keywords.push(key, ...aliases);
+        }
+    }
+    return [...new Set(keywords)];
+}
+function calcRelevance(content, keywords) {
+    const lowerContent = content.toLowerCase();
+    let score = 0;
+    for (const kw of keywords) {
+        const lowerKw = kw.toLowerCase();
+        const count = (lowerContent.match(new RegExp(lowerKw, 'g')) || []).length;
+        score += count * 10;
+        // 标题匹配加分
+        if (/^#{1,3}\s/.test(content) && lowerContent.includes(lowerKw)) {
+            score += 30;
+        }
+    }
+    return Math.min(100, score);
+}
+/**
+ * 在指定文档中定位功能章节
+ */
+async function locateFeatureInDoc(docPath, featureName) {
+    if (!(await (0, fs_extra_1.pathExists)(docPath)))
+        return null;
+    const content = await (0, fs_extra_1.readFile)(docPath, 'utf-8');
+    const keywords = expandKeywords(featureName);
+    // 按 Markdown 标题分块
+    const sections = content.split(/\n(?=#{1,4}\s)/);
+    let bestSection = '';
+    let bestScore = 0;
+    let bestLineStart = 0;
+    let bestTitle = '';
+    let lineNum = 0;
+    for (const section of sections) {
+        const score = calcRelevance(section, keywords);
+        if (score > bestScore) {
+            bestScore = score;
+            bestSection = section;
+            bestLineStart = lineNum;
+            const titleMatch = section.match(/^#{1,4}\s+(.+)/m);
+            bestTitle = titleMatch ? titleMatch[1].trim() : '';
+        }
+        lineNum += section.split('\n').length;
+    }
+    if (bestScore < 20)
+        return null;
+    return {
+        source: 'doc',
+        path: docPath,
+        title: bestTitle,
+        content: bestSection.slice(0, 3000), // 限制长度
+        relevance: bestScore,
+        lineStart: bestLineStart,
+        lineEnd: bestLineStart + bestSection.split('\n').length,
+    };
+}
+/**
+ * 在需求文档中定位功能
+ */
+async function locateFeatureInRequirements(iterDir, featureName) {
+    const reqDir = (0, path_1.join)(iterDir, '010-requirements');
+    if (!(await (0, fs_extra_1.pathExists)(reqDir)))
+        return [];
+    const locations = [];
+    const keywords = expandKeywords(featureName);
+    // 扫描 features/ 目录
+    const featuresDir = (0, path_1.join)(reqDir, 'features');
+    if (await (0, fs_extra_1.pathExists)(featuresDir)) {
+        const entries = await (0, fs_extra_1.readdir)(featuresDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                const readmePath = (0, path_1.join)(featuresDir, entry.name, 'README.md');
+                if (await (0, fs_extra_1.pathExists)(readmePath)) {
+                    const loc = await locateFeatureInDoc(readmePath, featureName);
+                    if (loc)
+                        locations.push(loc);
+                }
+            }
+        }
+    }
+    // 扫描 converted/ 和 sources/
+    for (const sub of ['converted', 'sources']) {
+        const subDir = (0, path_1.join)(reqDir, sub);
+        if (!(await (0, fs_extra_1.pathExists)(subDir)))
+            continue;
+        const files = await (0, fs_extra_1.readdir)(subDir);
+        for (const f of files.filter(f => f.endsWith('.md'))) {
+            const loc = await locateFeatureInDoc((0, path_1.join)(subDir, f), featureName);
+            if (loc)
+                locations.push(loc);
+        }
+    }
+    // 按相关度排序
+    return locations.sort((a, b) => b.relevance - a.relevance);
+}
+/**
+ * 在代码中定位相关文件（基于 structured-data.json 或源码扫描）
+ */
+async function locateFeatureInCode(projectRoot, featureName) {
+    const structuredDataPath = (0, path_1.join)(projectRoot, '.speccore', 'cache', 'structured-data.json');
+    const keywords = expandKeywords(featureName);
+    const locations = [];
+    // 如果有结构化数据，优先使用
+    if (await (0, fs_extra_1.pathExists)(structuredDataPath)) {
+        try {
+            const data = await (0, fs_extra_1.readFile)(structuredDataPath, 'utf-8');
+            const structured = JSON.parse(data);
+            for (const [platform, info] of Object.entries(structured.endpoints || {})) {
+                const pInfo = info;
+                // 匹配 API
+                for (const api of pInfo.apis || []) {
+                    const apiText = `${api.path} ${api.handler} ${api.description || ''}`;
+                    if (keywords.some(kw => apiText.toLowerCase().includes(kw.toLowerCase()))) {
+                        locations.push({
+                            source: 'code',
+                            path: api.filePath,
+                            title: `${api.method} ${api.path}`,
+                            content: `API: ${api.method} ${api.path}\nHandler: ${api.handler}\nFile: ${api.filePath}:${api.line}`,
+                            relevance: 80,
+                        });
+                    }
+                }
+                // 匹配 Entity
+                for (const entity of pInfo.entities || []) {
+                    if (keywords.some(kw => entity.name.toLowerCase().includes(kw.toLowerCase()))) {
+                        locations.push({
+                            source: 'code',
+                            path: entity.filePath,
+                            title: `Entity: ${entity.name}`,
+                            content: `Entity: ${entity.name}\nTable: ${entity.tableName || 'N/A'}\nFile: ${entity.filePath}:${entity.line}`,
+                            relevance: 75,
+                        });
+                    }
+                }
+                // 匹配 Component
+                for (const comp of pInfo.components || []) {
+                    if (keywords.some(kw => comp.name.toLowerCase().includes(kw.toLowerCase()))) {
+                        locations.push({
+                            source: 'code',
+                            path: comp.filePath,
+                            title: `Component: ${comp.name}`,
+                            content: `Component: ${comp.name}\nFile: ${comp.filePath}:${comp.line}`,
+                            relevance: 70,
+                        });
+                    }
+                }
+            }
+        }
+        catch { /* ignore */ }
+    }
+    return locations.sort((a, b) => b.relevance - a.relevance).slice(0, 10);
+}
+/**
+ * 在全局分析产出中定位相关内容
+ */
+async function locateFeatureInGlobal(projectRoot, featureName) {
+    const globalDir = (0, path_1.join)(projectRoot, '.speccore', 'GLOBAL');
+    if (!(await (0, fs_extra_1.pathExists)(globalDir)))
+        return [];
+    const locations = [];
+    const keywords = expandKeywords(featureName);
+    // 扫描 overview/ 和 platforms/
+    const scanDir = async (dir) => {
+        if (!(await (0, fs_extra_1.pathExists)(dir)))
+            return;
+        const entries = await (0, fs_extra_1.readdir)(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = (0, path_1.join)(dir, entry.name);
+            if (entry.isDirectory()) {
+                await scanDir(fullPath);
+            }
+            else if (entry.name.endsWith('.md')) {
+                const loc = await locateFeatureInDoc(fullPath, featureName);
+                if (loc)
+                    locations.push({ ...loc, source: 'global' });
+            }
+        }
+    };
+    await scanDir((0, path_1.join)(globalDir, 'overview'));
+    await scanDir((0, path_1.join)(globalDir, 'platforms'));
+    return locations.sort((a, b) => b.relevance - a.relevance).slice(0, 5);
+}
+/**
+ * 构建功能单元的完整上下文
+ */
+async function buildFeatureContext(projectRoot, iterDir, featureName, docName) {
+    const ctx = {
+        featureName,
+        docLocations: [],
+        reqLocations: [],
+        codeLocations: [],
+        globalLocations: [],
+        summary: '',
+    };
+    // 1. 在指定文档中定位
+    if (docName) {
+        const docPath = docName.startsWith('/') ? docName : (0, path_1.join)(iterDir, '020-specs', docName);
+        const loc = await locateFeatureInDoc(docPath, featureName);
+        if (loc)
+            ctx.docLocations.push(loc);
+    }
+    // 2. 在需求文档中定位
+    ctx.reqLocations = await locateFeatureInRequirements(iterDir, featureName);
+    // 3. 在代码中定位
+    ctx.codeLocations = await locateFeatureInCode(projectRoot, featureName);
+    // 4. 在全局分析中定位
+    ctx.globalLocations = await locateFeatureInGlobal(projectRoot, featureName);
+    // 生成摘要
+    const parts = [];
+    if (ctx.docLocations.length > 0)
+        parts.push(`文档命中: ${ctx.docLocations.length} 处`);
+    if (ctx.reqLocations.length > 0)
+        parts.push(`需求命中: ${ctx.reqLocations.length} 处`);
+    if (ctx.codeLocations.length > 0)
+        parts.push(`代码命中: ${ctx.codeLocations.length} 处`);
+    if (ctx.globalLocations.length > 0)
+        parts.push(`全局分析命中: ${ctx.globalLocations.length} 处`);
+    ctx.summary = parts.join(' | ');
+    logger_1.logger.info(`🔍 语义定位: "${featureName}" → ${ctx.summary || '未找到匹配内容'}`);
+    return ctx;
+}
+/**
+ * 生成功能分析用的 Prompt 上下文注入文本
+ */
+function buildFeatureContextPrompt(ctx) {
+    let prompt = `\n## 🔍 关联上下文（自动定位）\n\n`;
+    prompt += `> 正在分析功能: **${ctx.featureName}**\n`;
+    prompt += `> ${ctx.summary || '未找到关联内容'}\n\n`;
+    if (ctx.reqLocations.length > 0) {
+        prompt += `### 需求文档（${ctx.reqLocations.length} 处）\n\n`;
+        for (const loc of ctx.reqLocations.slice(0, 2)) {
+            prompt += `**${loc.title || loc.path.split('/').pop()}** (相关度: ${loc.relevance})\n`;
+            prompt += `\`\`\`
+${loc.content.slice(0, 800)}
+\`\`\`
+
+`;
+        }
+    }
+    if (ctx.codeLocations.length > 0) {
+        prompt += `### 关联代码（${ctx.codeLocations.length} 处）\n\n`;
+        for (const loc of ctx.codeLocations.slice(0, 3)) {
+            prompt += `- **${loc.title}**: \`${loc.path}\`\n`;
+        }
+        prompt += `\n> 分析技术方案时，请 Read 上述代码文件获取真实实现细节\n\n`;
+    }
+    if (ctx.globalLocations.length > 0) {
+        prompt += `### 全局架构（${ctx.globalLocations.length} 处）\n\n`;
+        for (const loc of ctx.globalLocations.slice(0, 2)) {
+            prompt += `- **${loc.title || loc.path.split('/').pop()}**: ${loc.path}\n`;
+        }
+        prompt += `\n`;
+    }
+    return prompt;
+}
+//# sourceMappingURL=semantic-locator.js.map

package/dist/core/semantic-locator.js.map

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

package/dist/core/structured-extractor.d.ts

@@ -0,0 +1,89 @@
+export interface ApiEndpoint {
+    path: string;
+    method: string;
+    handler: string;
+    filePath: string;
+    line: number;
+    parameters?: string[];
+    responseType?: string;
+    decorators?: string[];
+    description?: string;
+}
+export interface EntityField {
+    name: string;
+    type: string;
+    nullable: boolean;
+    defaultValue?: string;
+    isPrimaryKey?: boolean;
+    isForeignKey?: boolean;
+    description?: string;
+}
+export interface EntityDefinition {
+    name: string;
+    tableName?: string;
+    filePath: string;
+    line: number;
+    fields: EntityField[];
+    relations?: {
+        target: string;
+        type: string;
+        field: string;
+    }[];
+    description?: string;
+}
+export interface RouteConfig {
+    path: string;
+    component?: string;
+    layout?: string;
+    lazy?: boolean;
+    guards?: string[];
+    children?: RouteConfig[];
+    filePath: string;
+    line: number;
+}
+export interface ComponentInfo {
+    name: string;
+    filePath: string;
+    line: number;
+    props?: string[];
+    slots?: string[];
+    emits?: string[];
+    dependencies?: string[];
+    description?: string;
+}
+export interface DependencyEdge {
+    from: string;
+    to: string;
+    type: 'import' | 'inherit' | 'implement';
+}
+export interface StructuredData {
+    generatedAt: string;
+    projectRoot: string;
+    endpoints: {
+        [platform: string]: {
+            apis: ApiEndpoint[];
+            entities: EntityDefinition[];
+            routes: RouteConfig[];
+            components: ComponentInfo[];
+        };
+    };
+    dependencies: DependencyEdge[];
+    stats: {
+        totalApis: number;
+        totalEntities: number;
+        totalRoutes: number;
+        totalComponents: number;
+        totalFiles: number;
+    };
+}
+/**
+ * 扫描项目源码，提取结构化数据
+ * @param projectRoot 项目根目录
+ * @param sourcePaths 源码路径列表（从 CONSTITUTION.md 读取）
+ */
+export declare function extractStructuredData(projectRoot: string, sourcePaths: string[]): Promise<StructuredData>;
+/**
+ * 加载已提取的结构化数据
+ */
+export declare function loadStructuredData(): Promise<StructuredData | null>;
+//# sourceMappingURL=structured-extractor.d.ts.map

package/dist/core/structured-extractor.d.ts.map

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