soloforge 1.1.38 → 1.1.42

package/dist/engine/config/resolver.js.map

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

package/dist/engine/context_engine/bootstrap.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 上下文引擎引导 — 注册全部 P0 + P1 视图到 view_registry。
+ *
+ * 在 MCP Server 启动和 CLI analyze 命令路径中调用。
+ * 幂等设计：重复调用安全。
+ */
+/**
+ * 注册全部上下文引擎视图。
+ * 幂等：通过检查视图是否已注册判断，clearViews() 后可重新注册。
+ */
+export declare function bootstrapContextEngine(): void;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/engine/context_engine/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../../src/engine/context_engine/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAQ7C"}

package/dist/engine/context_engine/bootstrap.js

@@ -0,0 +1,28 @@
+/**
+ * 上下文引擎引导 — 注册全部 P0 + P1 视图到 view_registry。
+ *
+ * 在 MCP Server 启动和 CLI analyze 命令路径中调用。
+ * 幂等设计：重复调用安全。
+ */
+import { registerView, getView } from "./view_registry.js";
+import { fileImpactView } from "./views/file_impact.js";
+import { referenceTraceView } from "./views/reference_trace.js";
+import { dependencyGraphView } from "./views/dependency_graph.js";
+import { changeImpactView } from "./views/change_impact.js";
+import { coverageGapView } from "./views/coverage_gap.js";
+import { knowledgeRefView } from "./views/knowledge_ref.js";
+/**
+ * 注册全部上下文引擎视图。
+ * 幂等：通过检查视图是否已注册判断，clearViews() 后可重新注册。
+ */
+export function bootstrapContextEngine() {
+    if (getView("file_impact"))
+        return;
+    registerView(fileImpactView);
+    registerView(referenceTraceView);
+    registerView(dependencyGraphView);
+    registerView(changeImpactView);
+    registerView(coverageGapView);
+    registerView(knowledgeRefView);
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/engine/context_engine/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../../src/engine/context_engine/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;;GAGG;AACH,MAAM,UAAU,sBAAsB;IACpC,IAAI,OAAO,CAAC,aAAa,CAAC;QAAE,OAAO;IACnC,YAAY,CAAC,cAAc,CAAC,CAAC;IAC7B,YAAY,CAAC,kBAAkB,CAAC,CAAC;IACjC,YAAY,CAAC,mBAAmB,CAAC,CAAC;IAClC,YAAY,CAAC,gBAAgB,CAAC,CAAC;IAC/B,YAAY,CAAC,eAAe,CAAC,CAAC;IAC9B,YAAY,CAAC,gBAAgB,CAAC,CAAC;AACjC,CAAC"}

package/dist/engine/context_engine/companion_injector.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Companion Injector — companion_rules / companion_gates 消费侧。
+ *
+ * 读取选中模板的 frontmatter companion_rules / companion_gates 字段，
+ * 定位并加载规则/门禁内容，注入到管线 prompt。
+ *
+ * 搜索路径：项目级（.soloforge/）优先，内置兜底。
+ * operation 过滤：execute 加载全部，review 加载 :review+:check，check 只加载 :check。
+ */
+/** 规则用法 */
+export type RuleUsage = "execute" | "review" | "check";
+/** 解析后的规则引用 */
+export interface ParsedRuleRef {
+    fileName: string;
+    usage: RuleUsage;
+}
+/** 注入结果 */
+export interface CompanionInjectionResult {
+    /** 规则内容列表（已加载的文本） */
+    rules: Array<{
+        name: string;
+        usage: RuleUsage;
+        content: string;
+    }>;
+    /** 门禁内容列表（已加载的文本） */
+    gates: Array<{
+        name: string;
+        content: string;
+    }>;
+    /** 缺失的规则（文件不存在） */
+    missing_rules: string[];
+    /** 缺失的门禁（文件不存在） */
+    missing_gates: string[];
+    /** 合并后的注入文本 */
+    injection_text: string;
+}
+/**
+ * 解析 companion_rules 字段。
+ *
+ * 支持两种格式（按方案 Section 2.3 companion_rules 结构化 YAML）：
+ * 1. 结构化 YAML 对象：{name: "规则名", usage: "execute|review|check"}
+ * 2. 旧字符串格式："规则文件名:usage" 或 "规则文件名"
+ */
+export declare function parseCompanionRules(companionRules: unknown[] | undefined): ParsedRuleRef[];
+/**
+ * 注入 companion_rules 和 companion_gates。
+ * 输出格式与现有 knowledge injection boundary 的注入格式兼容。
+ *
+ * @param params.baseDir - 搜索根目录（通常为 process.cwd()）
+ * @param params.companion_rules - 规则引用列表
+ * @param params.companion_gates - 门禁引用列表
+ * @param params.operation - 操作模式，决定加载哪些规则（默认 "execute"）
+ */
+export declare function injectCompanions(params: {
+    baseDir: string;
+    companion_rules?: unknown[];
+    companion_gates?: string[];
+    operation?: "execute" | "review" | "check";
+    /** 管线类型（新系统/老系统），用于门禁条件评估上下文 */
+    systemType?: "新系统" | "老系统";
+}): CompanionInjectionResult;
+//# sourceMappingURL=companion_injector.d.ts.map

package/dist/engine/context_engine/companion_injector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"companion_injector.d.ts","sourceRoot":"","sources":["../../../src/engine/context_engine/companion_injector.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,WAAW;AACX,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEvD,eAAe;AACf,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,WAAW;AACX,MAAM,WAAW,wBAAwB;IACvC,qBAAqB;IACrB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClE,qBAAqB;IACrB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,mBAAmB;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,mBAAmB;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe;IACf,cAAc,EAAE,MAAM,CAAC;CACxB;AAiCD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,OAAO,EAAE,GAAG,SAAS,GACpC,aAAa,EAAE,CAsCjB;AA+LD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC3C,gCAAgC;IAChC,UAAU,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;CAC5B,GAAG,wBAAwB,CA4F3B"}

package/dist/engine/context_engine/companion_injector.js

@@ -0,0 +1,350 @@
+/**
+ * Companion Injector — companion_rules / companion_gates 消费侧。
+ *
+ * 读取选中模板的 frontmatter companion_rules / companion_gates 字段，
+ * 定位并加载规则/门禁内容，注入到管线 prompt。
+ *
+ * 搜索路径：项目级（.soloforge/）优先，内置兜底。
+ * operation 过滤：execute 加载全部，review 加载 :review+:check，check 只加载 :check。
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { debugLog } from "../core/logger.js";
+// ── 模板根目录 ──
+/** 内置模板根目录（soloforge 包内） */
+function getBuiltinTemplatesRoot() {
+    const thisDir = path.dirname(fileURLToPath(import.meta.url));
+    // src/engine/context_engine/ → ../../../ → 项目根 → templates
+    return path.resolve(thisDir, "..", "..", "..", "templates");
+}
+/**
+ * 构建搜索目录列表（项目级优先，baseDir 直连，内置兜底）。
+ *
+ * @param baseDir - process.cwd() 或项目根路径
+ * @param relativeDir - 相对模板目录，如 "rules/shared"
+ */
+function buildSearchDirs(baseDir, relativeDir) {
+    const parts = relativeDir.split("/");
+    return [
+        // 项目级：.soloforge/templates/{relativeDir}
+        path.join(baseDir, ".soloforge", "templates", ...parts),
+        // 项目级（旧路径兼容）：.soloforge/knowledge/{relativeDir}
+        path.join(baseDir, ".soloforge", "knowledge", ...parts),
+        // baseDir 直连：{baseDir}/templates/{relativeDir}（兼容旧调用方式和测试）
+        path.join(baseDir, "templates", ...parts),
+        // 内置：soloforge 包内 templates/{relativeDir}
+        path.join(getBuiltinTemplatesRoot(), ...parts),
+    ];
+}
+// ── 解析 ──
+/**
+ * 解析 companion_rules 字段。
+ *
+ * 支持两种格式（按方案 Section 2.3 companion_rules 结构化 YAML）：
+ * 1. 结构化 YAML 对象：{name: "规则名", usage: "execute|review|check"}
+ * 2. 旧字符串格式："规则文件名:usage" 或 "规则文件名"
+ */
+export function parseCompanionRules(companionRules) {
+    if (!companionRules || companionRules.length === 0)
+        return [];
+    return companionRules.map((ref) => {
+        // ── 格式 1：结构化 YAML 对象 ──
+        if (typeof ref === "object" && ref !== null && !Array.isArray(ref)) {
+            const obj = ref;
+            const name = typeof obj.name === "string" ? obj.name.trim() : "";
+            if (!name) {
+                debugLog(`companion_injector: 跳过无效结构化规则（缺少 name）— ${JSON.stringify(ref)}`);
+                return null;
+            }
+            let fileName = name;
+            if (fileName.endsWith(".md"))
+                fileName = fileName.slice(0, -3);
+            const rawUsage = typeof obj.usage === "string" ? obj.usage.trim() : "execute";
+            const usage = validateUsage(rawUsage, JSON.stringify(ref));
+            return { fileName, usage };
+        }
+        // ── 格式 2：旧字符串格式 ──
+        if (typeof ref === "string") {
+            const parts = ref.split(":");
+            let fileName = parts[0].trim();
+            const usage = parts[1]?.trim() || "execute";
+            // 去掉已有的 .md 扩展名 — loadRuleFile 会自动加 .md
+            if (fileName.endsWith(".md")) {
+                fileName = fileName.slice(0, -3);
+            }
+            // 校验 usage 值
+            return { fileName, usage: validateUsage(usage, ref) };
+        }
+        // ── 无法识别的格式 ──
+        debugLog(`companion_injector: 跳过无法识别的规则格式 — ${JSON.stringify(ref)}`);
+        return null;
+    }).filter((r) => r !== null);
+}
+/** 校验 usage 值，无效时降级为 execute */
+function validateUsage(raw, context) {
+    if (raw === "execute" || raw === "review" || raw === "check")
+        return raw;
+    debugLog(`companion_injector: 无效 usage "${raw}"，降级为 "execute" — ${context}`);
+    return "execute";
+}
+// ── 加载 ──
+/**
+ * 加载规则文件内容。
+ *
+ * 搜索路径（按优先级）：
+ * 1. .soloforge/templates/rules/shared/   （项目级）
+ * 2. .soloforge/knowledge/rules/shared/   （项目级旧路径）
+ * 3. templates/rules/shared/              （内置）
+ * 4. .soloforge/templates/internal/rules/ （项目级）
+ * 5. .soloforge/knowledge/internal/rules/ （项目级旧路径）
+ * 6. templates/internal/rules/            （内置）
+ * 7. .soloforge/templates/rules/          （项目级根）
+ * 8. .soloforge/knowledge/rules/          （项目级旧路径根）
+ * 9. templates/rules/                     （内置根）
+ *
+ * 每级目录先精确匹配，再递归搜索。
+ */
+function loadRuleFile(baseDir, fileName) {
+    const relativeDirs = [
+        "rules/shared",
+        "rules/existing-system",
+        "internal/rules",
+        "rules",
+    ];
+    // 构建完整搜索目录列表（项目级 + 内置，逐级展开）
+    const searchDirs = relativeDirs.flatMap((relDir) => buildSearchDirs(baseDir, relDir));
+    // 阶段 1：精确匹配
+    for (const dir of searchDirs) {
+        const candidate = path.join(dir, `${fileName}.md`);
+        if (fs.existsSync(candidate)) {
+            return fs.readFileSync(candidate, "utf-8");
+        }
+    }
+    // 阶段 2：递归搜索（在每个目录下递归查找）
+    for (const dir of searchDirs) {
+        if (!fs.existsSync(dir))
+            continue;
+        const result = findFileRecursive(dir, fileName);
+        if (result)
+            return result;
+    }
+    return null;
+}
+/**
+ * 加载门禁文件内容。
+ *
+ * 搜索路径（按优先级）：
+ * 1. .soloforge/templates/gates/   （项目级）
+ * 2. .soloforge/knowledge/gates/   （项目级旧路径）
+ * 3. templates/gates/              （内置）
+ * 4. .soloforge/templates/internal/gates/ （项目级）
+ * 5. .soloforge/knowledge/internal/gates/ （项目级旧路径）
+ * 6. templates/internal/gates/     （内置）
+ */
+function loadGateFile(baseDir, gateName) {
+    // 去掉已有的扩展名 — 后面会按 suffix 遍历拼接
+    let name = gateName;
+    for (const ext of [".yaml", ".yml", ".md"]) {
+        if (name.endsWith(ext)) {
+            name = name.slice(0, -ext.length);
+            break;
+        }
+    }
+    const relativeDirs = [
+        "gates/shared",
+        "gates/existing-system",
+        "gates",
+        "internal/gates",
+    ];
+    const searchDirs = relativeDirs.flatMap((relDir) => buildSearchDirs(baseDir, relDir));
+    // 阶段 1：精确匹配
+    for (const dir of searchDirs) {
+        for (const suffix of [".yaml", ".yml", ".md"]) {
+            const candidate = path.join(dir, `${name}${suffix}`);
+            if (fs.existsSync(candidate)) {
+                return fs.readFileSync(candidate, "utf-8");
+            }
+        }
+    }
+    // 阶段 2：递归搜索（兜底）
+    for (const dir of searchDirs) {
+        if (!fs.existsSync(dir))
+            continue;
+        const result = findFileRecursiveGate(dir, name);
+        if (result)
+            return result;
+    }
+    return null;
+}
+/** 递归查找文件（.md 格式） */
+function findFileRecursive(dir, fileName) {
+    const stack = [dir];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        let entries;
+        try {
+            entries = fs.readdirSync(current, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            const fpath = path.join(current, entry.name);
+            if (entry.isDirectory()) {
+                stack.push(fpath);
+                continue;
+            }
+            if (entry.name === `${fileName}.md`) {
+                return fs.readFileSync(fpath, "utf-8");
+            }
+        }
+    }
+    return null;
+}
+/** 递归查找文件（.yaml/.yml/.md 格式，用于门禁） */
+function findFileRecursiveGate(dir, baseName) {
+    const expectedNames = [`${baseName}.yaml`, `${baseName}.yml`, `${baseName}.md`];
+    const stack = [dir];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        let entries;
+        try {
+            entries = fs.readdirSync(current, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            const fpath = path.join(current, entry.name);
+            if (entry.isDirectory()) {
+                stack.push(fpath);
+                continue;
+            }
+            if (expectedNames.includes(entry.name)) {
+                return fs.readFileSync(fpath, "utf-8");
+            }
+        }
+    }
+    return null;
+}
+// ── operation 过滤 ──
+/**
+ * 根据 operation 过滤规则引用。
+ *
+ * - execute：加载全部规则（不过滤）
+ * - review：加载 :review + :check，跳过 :execute
+ * - check：只加载 :check
+ */
+function filterRulesByOperation(rules, operation) {
+    if (operation === "execute") {
+        // execute 模式加载全部，不过滤（向后兼容）
+        return rules;
+    }
+    if (operation === "review") {
+        // review 模式：保留 review + check
+        return rules.filter((r) => r.usage === "review" || r.usage === "check");
+    }
+    if (operation === "check") {
+        // check 模式：只保留 check
+        return rules.filter((r) => r.usage === "check");
+    }
+    return rules;
+}
+// ── 核心注入 ──
+/**
+ * 注入 companion_rules 和 companion_gates。
+ * 输出格式与现有 knowledge injection boundary 的注入格式兼容。
+ *
+ * @param params.baseDir - 搜索根目录（通常为 process.cwd()）
+ * @param params.companion_rules - 规则引用列表
+ * @param params.companion_gates - 门禁引用列表
+ * @param params.operation - 操作模式，决定加载哪些规则（默认 "execute"）
+ */
+export function injectCompanions(params) {
+    const operation = params.operation ?? "execute";
+    const rules = [];
+    const gates = [];
+    const missing_rules = [];
+    const missing_gates = [];
+    // 解析规则
+    const parsedRules = parseCompanionRules(params.companion_rules);
+    // 按 operation 过滤
+    const filteredRules = filterRulesByOperation(parsedRules, operation);
+    // 加载过滤后的规则
+    for (const ruleRef of filteredRules) {
+        const content = loadRuleFile(params.baseDir, ruleRef.fileName);
+        if (content) {
+            rules.push({ name: ruleRef.fileName, usage: ruleRef.usage, content });
+        }
+        else {
+            missing_rules.push(ruleRef.fileName);
+            debugLog(`companion_injector: 规则文件未找到 — ${ruleRef.fileName}`);
+        }
+    }
+    // 加载门禁
+    if (params.companion_gates) {
+        for (const gateName of params.companion_gates) {
+            const trimmed = gateName.trim();
+            if (!trimmed)
+                continue;
+            const content = loadGateFile(params.baseDir, trimmed);
+            if (content) {
+                gates.push({ name: trimmed, content });
+            }
+            else {
+                missing_gates.push(trimmed);
+                debugLog(`companion_injector: 门禁文件未找到 — ${trimmed}`);
+            }
+        }
+    }
+    // ── 万物执行基线（mandatory baseline）──
+    // 核心工程执行原则声明 stages: ["*"] + runtime_visibility: "injectable"，
+    // 但无代码路径将其注入 prompt。在此作为所有操作的强制基线加载。
+    const MANDATORY_BASELINE_RULES = ["核心工程执行原则"];
+    // 去重：如果 companion_rules 已包含则跳过
+    const alreadyIncluded = new Set(rules.map((r) => r.name));
+    const baselineRules = [];
+    for (const baselineName of MANDATORY_BASELINE_RULES) {
+        if (alreadyIncluded.has(baselineName))
+            continue;
+        const content = loadRuleFile(params.baseDir, baselineName);
+        if (content)
+            baselineRules.push({ name: baselineName, content });
+    }
+    // 构建注入文本 — 与 knowledge injection boundary 格式兼容
+    const sections = [];
+    // 管线类型上下文（供门禁 condition 评估）
+    if (params.systemType) {
+        sections.push(`> **当前管线类型**: ${params.systemType === "老系统" ? "existing-system (老系统/增量改造)" : "new-system (新系统/绿场)"}`);
+        sections.push(`> 门禁 \`condition: "scope == existing-system"\` 评估: ${params.systemType === "老系统" ? "**适用（须检查）**" : "**不适用（跳过）**"}`);
+        sections.push("");
+    }
+    // 基线规则（在 companion_rules 之前）
+    if (baselineRules.length > 0) {
+        sections.push("## 万物执行基线（mandatory baseline — 所有操作都必须遵守）");
+        for (const rule of baselineRules) {
+            sections.push(`\n### ${rule.name} [baseline]\n${rule.content}`);
+        }
+    }
+    if (rules.length > 0) {
+        sections.push("## 执行规则（companion_rules）");
+        for (const rule of rules) {
+            sections.push(`\n### ${rule.name} [${rule.usage}]\n${rule.content}`);
+        }
+    }
+    if (gates.length > 0) {
+        sections.push("## 质量门禁（companion_gates）");
+        for (const gate of gates) {
+            sections.push(`\n### ${gate.name}\n${gate.content}`);
+        }
+    }
+    return {
+        rules,
+        gates,
+        missing_rules,
+        missing_gates,
+        injection_text: sections.join("\n\n"),
+    };
+}
+//# sourceMappingURL=companion_injector.js.map

package/dist/engine/context_engine/companion_injector.js.map

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

package/dist/engine/context_engine/context_resolver.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Context Resolver — 上下文引擎参数解析器。
+ *
+ * 三级解析链：显式覆盖 → 阶段感知解析 → scope_resolver 兜底。
+ * 消费 scope_resolver 的结果，不重新实现其能力。
+ */
+import type { TaskStage } from "../workflow/workflow_navigation_contract.js";
+/** 参数来源 */
+export type ParamSource = "auto" | "explicit" | "slice_plan" | "scope" | "upstream";
+/** 模板 frontmatter 声明 */
+export interface ContextRequest {
+    view: string;
+    source: ParamSource;
+    params?: ViewParams;
+}
+/** 视图参数 */
+export interface ViewParams {
+    targets?: string[];
+    gitRef?: string;
+    scope?: string[];
+    extra?: Record<string, unknown>;
+}
+/** 解析结果 */
+export interface ResolvedContext {
+    view: string;
+    targets: string[];
+    scope?: string[];
+    gitRef?: string;
+    confidence: "high" | "medium" | "low";
+    source_description: string;
+}
+/** 判断阶段是否需要上下文引擎 */
+export declare function stageNeedsEngine(stage: TaskStage | undefined): boolean;
+/**
+ * 解析上下文请求 — 三级解析链。
+ *
+ * 优先级 1：显式覆盖（source=explicit）
+ * 优先级 2：阶段感知解析（source=auto）
+ * 优先级 3：scope_resolver 兜底
+ */
+export declare function resolveContext(request: ContextRequest, stage?: TaskStage, options?: {
+    sliceAffectedFiles?: string[];
+    scopeRoots?: string[];
+    gitRef?: string;
+}): ResolvedContext;
+//# sourceMappingURL=context_resolver.d.ts.map

package/dist/engine/context_engine/context_resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context_resolver.d.ts","sourceRoot":"","sources":["../../../src/engine/context_engine/context_resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6CAA6C,CAAC;AAI7E,WAAW;AACX,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,UAAU,GACV,YAAY,GACZ,OAAO,GACP,UAAU,CAAC;AAEf,wBAAwB;AACxB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,WAAW;AACX,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,WAAW;AACX,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAgBD,oBAAoB;AACpB,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAGtE;AA4ED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,cAAc,EACvB,KAAK,CAAC,EAAE,SAAS,EACjB,OAAO,CAAC,EAAE;IACR,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GACA,eAAe,CA+CjB"}