soloforge 1.1.38 → 1.1.42

package/dist/engine/context_engine/views/dependency_graph.js

@@ -0,0 +1,358 @@
+/**
+ * dependency_graph 视图 — 依赖图分析。
+ *
+ * 给定目标文件列表，构建模块间依赖的有向图，
+ * 使用 DFS 检测循环依赖，并输出拓扑排序。
+ *
+ * P1 实现：基于 grep 模式解析 import/require，DFS 环检测。
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { debugLog } from "../../core/logger.js";
+// ── 辅助函数 ──
+/** 从文件路径提取模块名（不含扩展名，index 取父目录名） */
+function extractModuleName(filePath) {
+    const base = path.basename(filePath, path.extname(filePath));
+    if (base === "index") {
+        return path.basename(path.dirname(filePath));
+    }
+    return base;
+}
+/** 规范化路径为 POSIX 格式 */
+function toPosix(p) {
+    return p.replace(/\\/g, "/");
+}
+/** 解析模块说明符为文件绝对路径 */
+function resolveModulePath(moduleSpecifier, fromDir) {
+    // 跳过外部 / node_modules 模块
+    if (!moduleSpecifier.startsWith("."))
+        return null;
+    // TypeScript 编译惯例：.js 映射到 .ts
+    let normalized = moduleSpecifier;
+    if (normalized.endsWith(".js")) {
+        normalized = normalized.slice(0, -3) + ".ts";
+    }
+    else if (normalized.endsWith(".jsx")) {
+        normalized = normalized.slice(0, -4) + ".tsx";
+    }
+    const resolved = path.resolve(fromDir, normalized);
+    // 精确路径存在
+    if (fs.existsSync(resolved)) {
+        return resolved;
+    }
+    // 尝试常见扩展名和 index 文件
+    const candidates = [
+        resolved + ".ts",
+        resolved + ".tsx",
+        resolved + ".js",
+        resolved + ".jsx",
+        path.join(resolved, "index.ts"),
+        path.join(resolved, "index.js"),
+    ];
+    for (const candidate of candidates) {
+        if (fs.existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    return null;
+}
+/** 从文件内容中提取 import/require 依赖 */
+function extractDependencies(filePath) {
+    const edges = [];
+    let content;
+    try {
+        content = fs.readFileSync(filePath, "utf-8");
+    }
+    catch {
+        return edges;
+    }
+    const dir = path.dirname(filePath);
+    const lines = content.split("\n");
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith("//") || trimmed.startsWith("*"))
+            continue;
+        // 匹配 import ... from 'module' 模式
+        const importMatch = trimmed.match(/import\s+.*?\s+from\s+['"]([^'"]+)['"]/);
+        if (importMatch) {
+            const resolved = resolveModulePath(importMatch[1], dir);
+            if (resolved) {
+                edges.push({ from: filePath, to: resolved, importType: "import" });
+            }
+            continue;
+        }
+        // import 'module'（副作用导入）
+        const sideEffectMatch = trimmed.match(/^import\s+['"]([^'"]+)['"]/);
+        if (sideEffectMatch) {
+            const resolved = resolveModulePath(sideEffectMatch[1], dir);
+            if (resolved) {
+                edges.push({ from: filePath, to: resolved, importType: "import" });
+            }
+            continue;
+        }
+        // 匹配 require('module') 模式
+        const requireMatch = trimmed.match(/require\s*\(\s*['"]([^'"]+)['"]\s*\)/);
+        if (requireMatch) {
+            const resolved = resolveModulePath(requireMatch[1], dir);
+            if (resolved) {
+                edges.push({ from: filePath, to: resolved, importType: "require" });
+            }
+            continue;
+        }
+        // import('module')（动态导入）
+        const dynamicMatch = trimmed.match(/import\s*\(\s*['"]([^'"]+)['"]\s*\)/);
+        if (dynamicMatch) {
+            const resolved = resolveModulePath(dynamicMatch[1], dir);
+            if (resolved) {
+                edges.push({ from: filePath, to: resolved, importType: "dynamic" });
+            }
+        }
+    }
+    return edges;
+}
+/** 构建邻接表（有向图） */
+function buildAdjacencyList(edges) {
+    const adj = new Map();
+    for (const edge of edges) {
+        const fromP = toPosix(edge.from);
+        const toP = toPosix(edge.to);
+        if (!adj.has(fromP)) {
+            adj.set(fromP, []);
+        }
+        adj.get(fromP).push(toP);
+    }
+    return adj;
+}
+/** DFS 检测有向图中的所有环 */
+function detectCycles(adj) {
+    const cycles = [];
+    const WHITE = 0; // 未访问
+    const GRAY = 1; // 访问中（在当前递归栈中）
+    const BLACK = 2; // 已完成
+    const color = new Map();
+    const path = [];
+    // 初始化所有节点的颜色为 WHITE
+    for (const node of adj.keys()) {
+        color.set(node, WHITE);
+    }
+    /** DFS 递归访问 */
+    function dfs(node) {
+        color.set(node, GRAY);
+        path.push(node);
+        const neighbors = adj.get(node) ?? [];
+        for (const neighbor of neighbors) {
+            const neighborColor = color.get(neighbor) ?? WHITE;
+            if (neighborColor === GRAY) {
+                // 发现环：从 neighbor 到当前节点形成一个回路
+                const cycleStart = path.indexOf(neighbor);
+                if (cycleStart !== -1) {
+                    const cycle = path.slice(cycleStart);
+                    cycles.push([...cycle]);
+                }
+            }
+            else if (neighborColor === WHITE) {
+                // 确保邻居节点在 color map 中
+                if (!color.has(neighbor)) {
+                    color.set(neighbor, WHITE);
+                }
+                dfs(neighbor);
+            }
+        }
+        path.pop();
+        color.set(node, BLACK);
+    }
+    // 对所有节点执行 DFS
+    for (const node of adj.keys()) {
+        if (color.get(node) === WHITE) {
+            dfs(node);
+        }
+    }
+    // 去重：用排序后的字符串表示归一化比较
+    const seen = new Set();
+    return cycles.filter((cycle) => {
+        const key = cycle.join("->");
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+/** Kahn 算法进行拓扑排序（DAG 部分，有环节点跳过） */
+function topologicalSort(adj) {
+    // 计算所有节点的入度
+    const inDegree = new Map();
+    const allNodes = new Set();
+    for (const [from, neighbors] of adj) {
+        allNodes.add(from);
+        for (const neighbor of neighbors) {
+            allNodes.add(neighbor);
+            inDegree.set(neighbor, (inDegree.get(neighbor) ?? 0) + 1);
+        }
+    }
+    // 初始化入度为 0 的节点
+    for (const node of allNodes) {
+        if (!inDegree.has(node)) {
+            inDegree.set(node, 0);
+        }
+    }
+    // 入度为 0 的队列
+    const queue = [];
+    for (const [node, degree] of inDegree) {
+        if (degree === 0) {
+            queue.push(node);
+        }
+    }
+    const result = [];
+    while (queue.length > 0) {
+        // 按路径排序保证结果确定性
+        queue.sort();
+        const node = queue.shift();
+        result.push(node);
+        const neighbors = adj.get(node) ?? [];
+        for (const neighbor of neighbors) {
+            const newDegree = (inDegree.get(neighbor) ?? 1) - 1;
+            inDegree.set(neighbor, newDegree);
+            if (newDegree === 0) {
+                queue.push(neighbor);
+            }
+        }
+    }
+    // 如果结果节点数 < 总节点数，说明存在环
+    // 环中节点被跳过，仅返回 DAG 部分的拓扑序
+    return result;
+}
+/** 计算节点入度和出度 */
+function computeDegrees(edges) {
+    const inDegrees = new Map();
+    const outDegrees = new Map();
+    for (const edge of edges) {
+        const fromP = toPosix(edge.from);
+        const toP = toPosix(edge.to);
+        outDegrees.set(fromP, (outDegrees.get(fromP) ?? 0) + 1);
+        inDegrees.set(toP, (inDegrees.get(toP) ?? 0) + 1);
+    }
+    // 确保只有出度没有入度（或反过来）的节点也出现在两个 map 中
+    const allNodes = new Set([...inDegrees.keys(), ...outDegrees.keys()]);
+    for (const node of allNodes) {
+        if (!inDegrees.has(node))
+            inDegrees.set(node, 0);
+        if (!outDegrees.has(node))
+            outDegrees.set(node, 0);
+    }
+    return { inDegrees, outDegrees };
+}
+// ── 核心分析 ──
+/**
+ * 构建依赖图并执行环检测和拓扑排序。
+ */
+function buildDependencyGraph(root, targets) {
+    // 收集所有边的集合（去重）
+    const edgeSet = new Map();
+    const allNodes = new Set();
+    // 队列：BFS 遍历目标文件及其依赖
+    const queue = [];
+    for (const target of targets) {
+        const fullPath = path.isAbsolute(target) ? target : path.resolve(root, target);
+        if (fs.existsSync(fullPath)) {
+            queue.push(fullPath);
+            allNodes.add(toPosix(fullPath));
+        }
+    }
+    const visited = new Set();
+    while (queue.length > 0) {
+        const filePath = queue.shift();
+        const posixPath = toPosix(filePath);
+        if (visited.has(posixPath))
+            continue;
+        visited.add(posixPath);
+        const deps = extractDependencies(filePath);
+        for (const edge of deps) {
+            const edgeKey = `${toPosix(edge.from)}|${toPosix(edge.to)}`;
+            if (!edgeSet.has(edgeKey)) {
+                edgeSet.set(edgeKey, edge);
+            }
+            const toPosixPath = toPosix(edge.to);
+            if (!allNodes.has(toPosixPath)) {
+                allNodes.add(toPosixPath);
+            }
+            // 将依赖文件加入队列继续遍历
+            if (!visited.has(toPosixPath)) {
+                queue.push(edge.to);
+            }
+        }
+    }
+    const edges = Array.from(edgeSet.values());
+    // 构建节点列表
+    const { inDegrees, outDegrees } = computeDegrees(edges);
+    const nodes = [];
+    for (const nodePath of allNodes) {
+        nodes.push({
+            path: nodePath,
+            module: extractModuleName(nodePath),
+            inDegree: inDegrees.get(nodePath) ?? 0,
+            outDegree: outDegrees.get(nodePath) ?? 0,
+        });
+    }
+    // 按路径排序保证确定性
+    nodes.sort((a, b) => a.path.localeCompare(b.path));
+    // 构建邻接表
+    const adj = buildAdjacencyList(edges);
+    // 环检测
+    const cycles = detectCycles(adj);
+    // 拓扑排序
+    const topologicalOrder = topologicalSort(adj);
+    return { nodes, edges, cycles, topologicalOrder };
+}
+// ── 视图实现 ──
+/**
+ * dependency_graph 视图：构建模块依赖图，检测循环依赖并输出拓扑排序。
+ */
+export const dependencyGraphView = {
+    name: "dependency_graph",
+    capabilities: ["grep", "ast"],
+    async analyze(root, params) {
+        const targets = params.targets ?? [];
+        const evidence = [];
+        debugLog(`dependency_graph: 分析 ${targets.length} 个目标文件的依赖图`);
+        const data = buildDependencyGraph(root, targets);
+        // 证据：依赖边汇总
+        if (data.edges.length > 0) {
+            evidence.push({
+                type: "grep_match",
+                verify_command: `grep -rn "import.*from\\|require(" --include="*.ts" ${targets.join(" ")}`,
+                source: `共解析 ${data.edges.length} 条依赖边，涵盖 ${data.nodes.length} 个节点`,
+            });
+        }
+        // 证据：循环依赖警告
+        if (data.cycles.length > 0) {
+            const cyclePaths = data.cycles
+                .map((cycle, i) => `  循环${i + 1}: ${cycle.join(" -> ")}`)
+                .join("\n");
+            evidence.push({
+                type: "grep_match",
+                verify_command: `echo "发现 ${data.cycles.length} 个循环依赖"`,
+                source: `发现 ${data.cycles.length} 个循环依赖:\n${cyclePaths}`,
+            });
+        }
+        // 证据：拓扑排序完整性
+        const sortedCount = data.topologicalOrder.length;
+        const totalCount = data.nodes.length;
+        if (sortedCount < totalCount) {
+            evidence.push({
+                type: "grep_match",
+                verify_command: `echo "DAG 部分节点: ${sortedCount}/${totalCount}"`,
+                source: `拓扑排序仅覆盖 ${sortedCount}/${totalCount} 个节点（${totalCount - sortedCount} 个节点存在于环中）`,
+            });
+        }
+        return {
+            view: "dependency_graph",
+            summary: `依赖图: ${data.nodes.length} 个节点, ` +
+                `${data.edges.length} 条边, ` +
+                `${data.cycles.length} 个循环依赖, ` +
+                `拓扑排序覆盖 ${data.topologicalOrder.length}/${data.nodes.length} 个节点`,
+            data: data,
+            evidence,
+        };
+    },
+};
+//# sourceMappingURL=dependency_graph.js.map

package/dist/engine/context_engine/views/dependency_graph.js.map

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

package/dist/engine/context_engine/views/file_impact.d.ts

@@ -0,0 +1,46 @@
+/**
+ * file_impact 视图 — 文件影响分析。
+ *
+ * 给定目标文件列表，分析每个文件的依赖关系，
+ * 按四级分类（direct_refs / indirect_refs / test_refs / knowledge_refs）
+ * 生成影响范围报告。
+ *
+ * P0 实现：基于 grep 模式分析 import/require 引用链。
+ */
+import type { ContextView } from "../view_registry.js";
+/** 单个文件的引用信息 */
+export interface FileRefInfo {
+    /** 文件相对路径 */
+    path: string;
+    /** 是否存在（文件系统中可访问） */
+    exists: boolean;
+    /** 直接引用该文件的其他源文件 */
+    direct_refs: string[];
+    /** 间接引用（引用了 direct_refs 的文件） */
+    indirect_refs: string[];
+    /** 关联的测试文件 */
+    test_refs: string[];
+    /** 关联的知识资产（引用该文件路径的规则/模板） */
+    knowledge_refs: string[];
+}
+/** file_impact 视图结果数据 */
+export interface FileImpactData {
+    /** 输入的目标文件列表 */
+    targets: string[];
+    /** 每个目标文件的影响分析 */
+    files: FileRefInfo[];
+    /** 汇总统计 */
+    summary: {
+        total_targets: number;
+        total_direct_refs: number;
+        total_indirect_refs: number;
+        total_test_refs: number;
+        total_knowledge_refs: number;
+        missing_files: number;
+    };
+}
+/**
+ * file_impact 视图：分析目标文件列表的四级影响范围。
+ */
+export declare const fileImpactView: ContextView;
+//# sourceMappingURL=file_impact.d.ts.map

package/dist/engine/context_engine/views/file_impact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file_impact.d.ts","sourceRoot":"","sources":["../../../../src/engine/context_engine/views/file_impact.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAwB,MAAM,qBAAqB,CAAC;AAK7E,gBAAgB;AAChB,MAAM,WAAW,WAAW;IAC1B,aAAa;IACb,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,oBAAoB;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,gCAAgC;IAChC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc;IACd,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,6BAA6B;IAC7B,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,yBAAyB;AACzB,MAAM,WAAW,cAAc;IAC7B,gBAAgB;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kBAAkB;IAClB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,WAAW;IACX,OAAO,EAAE;QACP,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,mBAAmB,EAAE,MAAM,CAAC;QAC5B,eAAe,EAAE,MAAM,CAAC;QACxB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AA0ID;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,WAsD5B,CAAC"}

package/dist/engine/context_engine/views/file_impact.js

@@ -0,0 +1,181 @@
+/**
+ * file_impact 视图 — 文件影响分析。
+ *
+ * 给定目标文件列表，分析每个文件的依赖关系，
+ * 按四级分类（direct_refs / indirect_refs / test_refs / knowledge_refs）
+ * 生成影响范围报告。
+ *
+ * P0 实现：基于 grep 模式分析 import/require 引用链。
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { execFileSync } from "node:child_process";
+import { debugLog } from "../../core/logger.js";
+// ── 辅助函数 ──
+/** 判断文件路径是否为测试文件 */
+function isTestFile(filePath) {
+    return /(?:test|spec|__tests__)[./]/i.test(filePath);
+}
+/** 从文件路径提取模块名（不含扩展名和目录） */
+function extractModuleName(filePath) {
+    const base = path.basename(filePath, path.extname(filePath));
+    // index 文件取父目录名
+    if (base === "index") {
+        return path.basename(path.dirname(filePath));
+    }
+    return base;
+}
+/**
+ * 在项目根目录下搜索引用指定模块名的文件。
+ * 使用 grep 实现（P0），后续可替换为 AST 分析。
+ */
+function grepImporters(root, moduleName, excludePattern) {
+    try {
+        const result = execFileSync("grep", [
+            "-rl",
+            "--include=*.ts",
+            "--include=*.tsx",
+            "--include=*.js",
+            "--include=*.jsx",
+            `-e`,
+            moduleName,
+            root,
+        ], { encoding: "utf-8", timeout: 10000, maxBuffer: 10 * 1024 * 1024 });
+        return result
+            .split("\n")
+            .map((line) => line.trim())
+            .filter(Boolean)
+            .filter((f) => !f.includes(excludePattern));
+    }
+    catch {
+        // grep 返回非零表示无匹配
+        return [];
+    }
+}
+/**
+ * 在知识资产目录中搜索引用指定文件路径的资产。
+ */
+function grepKnowledgeRefs(root, filePath) {
+    const templatesDir = path.join(root, "templates");
+    if (!fs.existsSync(templatesDir))
+        return [];
+    try {
+        const result = execFileSync("grep", ["-rl", "--include=*.md", "--include=*.yaml", "--include=*.yml", "-e", filePath, templatesDir], { encoding: "utf-8", timeout: 5000, maxBuffer: 5 * 1024 * 1024 });
+        return result
+            .split("\n")
+            .map((line) => line.trim())
+            .filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+/** 规范化路径（去除 ./ 前缀，统一分隔符） */
+function normalizePath(p) {
+    return p.replace(/\\/g, "/").replace(/^\.\//, "");
+}
+// ── 核心分析 ──
+/**
+ * 分析单个目标文件的影响范围。
+ */
+function analyzeFile(root, targetPath) {
+    const normalizedTarget = normalizePath(targetPath);
+    const fullPath = path.isAbsolute(normalizedTarget)
+        ? normalizedTarget
+        : path.join(root, normalizedTarget);
+    const exists = fs.existsSync(fullPath);
+    const moduleName = extractModuleName(normalizedTarget);
+    const relPath = path.relative(root, fullPath).replace(/\\/g, "/") || normalizedTarget;
+    const directRefs = [];
+    const testRefs = [];
+    if (exists && moduleName) {
+        const allReferrers = grepImporters(root, moduleName, normalizedTarget);
+        for (const ref of allReferrers) {
+            const rel = path.relative(root, ref).replace(/\\/g, "/");
+            if (isTestFile(rel)) {
+                testRefs.push(rel);
+            }
+            else {
+                directRefs.push(rel);
+            }
+        }
+    }
+    // 间接引用：对每个 direct_ref 再搜索一次
+    const indirectRefs = [];
+    const seen = new Set([relPath, ...directRefs, ...testRefs]);
+    for (const directRef of directRefs) {
+        const refModule = extractModuleName(directRef);
+        if (!refModule)
+            continue;
+        const transitive = grepImporters(root, refModule, directRef);
+        for (const t of transitive) {
+            const rel = path.relative(root, t).replace(/\\/g, "/");
+            if (!seen.has(rel)) {
+                seen.add(rel);
+                indirectRefs.push(rel);
+            }
+        }
+    }
+    // 知识资产引用
+    const knowledgeRefs = grepKnowledgeRefs(root, normalizedTarget);
+    return {
+        path: relPath,
+        exists,
+        direct_refs: [...new Set(directRefs)],
+        indirect_refs: [...new Set(indirectRefs)],
+        test_refs: [...new Set(testRefs)],
+        knowledge_refs: [...new Set(knowledgeRefs)],
+    };
+}
+// ── 视图实现 ──
+/**
+ * file_impact 视图：分析目标文件列表的四级影响范围。
+ */
+export const fileImpactView = {
+    name: "file_impact",
+    capabilities: ["grep", "ast"],
+    async analyze(root, params) {
+        const targets = params.targets ?? [];
+        const evidence = [];
+        debugLog(`file_impact: 分析 ${targets.length} 个目标文件`);
+        const files = targets.map((target) => analyzeFile(root, target));
+        const missingFiles = files.filter((f) => !f.exists);
+        const summary = {
+            total_targets: targets.length,
+            total_direct_refs: files.reduce((sum, f) => sum + f.direct_refs.length, 0),
+            total_indirect_refs: files.reduce((sum, f) => sum + f.indirect_refs.length, 0),
+            total_test_refs: files.reduce((sum, f) => sum + f.test_refs.length, 0),
+            total_knowledge_refs: files.reduce((sum, f) => sum + f.knowledge_refs.length, 0),
+            missing_files: missingFiles.length,
+        };
+        // 证据：缺失文件警告
+        for (const missing of missingFiles) {
+            evidence.push({
+                type: "grep_match",
+                verify_command: `test -f "${missing.path}"`,
+                source: `文件不存在: ${missing.path}`,
+            });
+        }
+        // 证据：直接引用列表
+        if (summary.total_direct_refs > 0) {
+            evidence.push({
+                type: "grep_match",
+                verify_command: `grep -rl "${targets[0] ?? ""}" --include="*.ts" .`,
+                source: `共发现 ${summary.total_direct_refs} 个直接引用`,
+            });
+        }
+        const data = { targets, files, summary };
+        return {
+            view: "file_impact",
+            summary: `分析了 ${summary.total_targets} 个目标文件: ` +
+                `${summary.total_direct_refs} 直接引用, ` +
+                `${summary.total_indirect_refs} 间接引用, ` +
+                `${summary.total_test_refs} 测试引用, ` +
+                `${summary.total_knowledge_refs} 知识资产引用` +
+                (summary.missing_files > 0 ? `, ${summary.missing_files} 个文件不存在` : ""),
+            data: data,
+            evidence,
+        };
+    },
+};
+//# sourceMappingURL=file_impact.js.map

package/dist/engine/context_engine/views/file_impact.js.map

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

package/dist/engine/context_engine/views/knowledge_ref.d.ts

@@ -0,0 +1,37 @@
+/**
+ * knowledge_ref 视图 — 知识资产引用追踪。
+ *
+ * 给定目标知识资产文件列表，解析 frontmatter 中的引用关系，
+ * 追踪 companion_rules / consumes / emits / required_evidence / triggers 字段，
+ * 检测孤儿引用和未被引用的资产，生成引用图报告。
+ *
+ * P1 实现：基于正则的 YAML frontmatter 解析，不依赖 YAML 库。
+ */
+import type { ContextView } from "../view_registry.js";
+/** 单条知识引用关系 */
+export interface KnowledgeRef {
+    /** 引用方文件路径 */
+    source: string;
+    /** 被引用文件路径 */
+    target: string;
+    /** 引用类型 */
+    refType: "companion" | "consumes" | "emits" | "requires_evidence" | "triggers";
+    /** frontmatter 字段名 */
+    field: string;
+}
+/** knowledge_ref 视图结果数据 */
+export interface KnowledgeRefData {
+    /** 所有引用关系 */
+    refs: KnowledgeRef[];
+    /** 目标文件不存在的孤儿引用 */
+    orphanRefs: KnowledgeRef[];
+    /** 没有任何文件引用的资产 */
+    unreferenced: string[];
+    /** 简化的引用图（source → targets） */
+    refGraph: Record<string, string[]>;
+}
+/**
+ * knowledge_ref 视图：追踪知识资产之间的引用关系。
+ */
+export declare const knowledgeRefView: ContextView;
+//# sourceMappingURL=knowledge_ref.d.ts.map

package/dist/engine/context_engine/views/knowledge_ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge_ref.d.ts","sourceRoot":"","sources":["../../../../src/engine/context_engine/views/knowledge_ref.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAwB,MAAM,qBAAqB,CAAC;AAK7E,eAAe;AACf,MAAM,WAAW,YAAY;IAC3B,cAAc;IACd,MAAM,EAAE,MAAM,CAAC;IACf,cAAc;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW;IACX,OAAO,EAAE,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,mBAAmB,GAAG,UAAU,CAAC;IAC/E,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,2BAA2B;AAC3B,MAAM,WAAW,gBAAgB;IAC/B,aAAa;IACb,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,mBAAmB;IACnB,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,kBAAkB;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACpC;AAuMD;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,WA2E9B,CAAC"}