soloforge 1.1.2 → 1.1.31

package/dist/engine/pipeline/intent_expander/helpers.js

@@ -0,0 +1,301 @@
+/**
+ * intent_expander — small utility / helper functions shared across modules.
+ *
+ * Pure helpers with no cross-file internal dependencies (except types).
+ */
+import path from "node:path";
+import { findToolInvocationContractByName } from "../../contracts/tool_invocation_contract_registry.js";
+import { resolveTaskScope } from "../scope_resolver.js";
+// ── 产物类型映射 ──
+export function mapToArtifactKind(kind) {
+    if (kind === "unknown")
+        return "custom";
+    if (kind === "design_doc")
+        return "design_doc";
+    if (kind === "api_spec")
+        return "api_spec";
+    if (kind === "task_breakdown")
+        return "task_breakdown";
+    if (kind === "root_cause")
+        return "root_cause";
+    if (kind === "acceptance_checklist")
+        return "acceptance_checklist";
+    if (kind === "interaction_spec")
+        return "interaction_spec";
+    if (kind === "domain_model")
+        return "domain_model";
+    // 其他类型均为合法的 ArtifactKind 值
+    return kind;
+}
+/** 将 PromptInjectionPlan 渲染为 Markdown 段落（统一注入，避免模板内重复） */
+export function renderPromptInjectionPlan(plan) {
+    const sections = [];
+    if (plan.evidence_refs.length > 0) {
+        sections.push("## 材料证据引用\n" + plan.evidence_refs.map((r) => "- " + r).join("\n"));
+    }
+    if (plan.required_summary.length > 0) {
+        sections.push("## 必需材料摘要\n" + plan.required_summary.map((s) => "- " + s).join("\n"));
+    }
+    if (plan.forbidden_notes.length > 0) {
+        sections.push("## 禁止/不可用材料\n" + plan.forbidden_notes.map((n) => "- " + n).join("\n"));
+    }
+    if (plan.manual_confirm_list.length > 0) {
+        sections.push("## 人工确认项\n" + plan.manual_confirm_list.map((c) => "- " + c).join("\n"));
+    }
+    if (plan.allowed_sources.length > 0) {
+        sections.push("## 允许的材料来源\n" + plan.allowed_sources.map((s) => "- " + s).join("\n"));
+    }
+    if (plan.forbidden_sources.length > 0) {
+        sections.push("## 禁止的材料来源\n" + plan.forbidden_sources.map((s) => "- " + s).join("\n"));
+    }
+    return sections.length > 0 ? "---\n\n" + sections.join("\n\n") : "";
+}
+/**
+ * 统一构造被阻断的 ExpandResult，消除 13 个 early return 的重复代码。
+ */
+export function buildBlockedResult(prompt, safeGoal, options) {
+    return {
+        task_id: "",
+        prompt,
+        scope: { allowed_paths: [], readonly_paths: [], new_files_allowed: false },
+        acceptance: { automated: [], manual: [] },
+        matched_patterns: [],
+        matched_knowledge: [],
+        is_legacy_code: false,
+        degraded: true,
+        ...(options.sensitivityLabels?.length ? { sensitivity_labels: options.sensitivityLabels } : {}),
+        ...(options.redactionRecords?.length ? { redaction_records: options.redactionRecords } : {}),
+        ...(options.privacyFindings?.length ? { privacy_findings: options.privacyFindings } : {}),
+        ...(options.inputMaterials ? { input_materials: options.inputMaterials } : {}),
+        ...(options.ingestionEvidences ? { ingestion_evidences: options.ingestionEvidences } : {}),
+        ...(options.promptInjectionPlan ? { prompt_injection_plan: options.promptInjectionPlan } : {}),
+        ...(options.outputArtifactRecord ? { output_artifact_record: options.outputArtifactRecord } : {}),
+        ...(options.injectionReport ? { injection_report: options.injectionReport } : {}),
+        ...(options.projectKnowledge ? { project_knowledge: options.projectKnowledge } : {}),
+        ...(options.workflowTrace ? { workflow_trace: options.workflowTrace } : {}),
+        contract: {
+            goal: safeGoal,
+            scope: [],
+            constraints: options.constraints,
+            verification: [],
+            stop_conditions: options.stopConditions,
+        },
+    };
+}
+/**
+ * 解析澄清答案，将路径注入 route_decision.input_materials，
+ * 清除已解决的 missing_required_inputs。
+ * 返回新的 route_decision（不修改原对象）。
+ */
+export function resolveClarificationAnswers(decision, _intent, answers) {
+    const resolved = {
+        ...decision,
+        input_materials: decision.input_materials.map((m) => ({ ...m })),
+        missing_required_inputs: [...decision.missing_required_inputs],
+    };
+    const addedPaths = [];
+    for (const answer of answers) {
+        // 提取路径 - absolute paths starting with /
+        const absPathPattern = /(?<![^\s])\/[^\s\]]+/g;
+        for (const m of answer.matchAll(absPathPattern)) {
+            const p = m[0];
+            if (p && p.length > 1 && !addedPaths.includes(p)) {
+                addedPaths.push(p);
+            }
+        }
+        // 提取相对路径 (word/word.ext 模式)
+        const relPathPattern = /[\w][\w.-]*(?:\/[\w.-]+)+\.[\w]+/g;
+        for (const m of answer.matchAll(relPathPattern)) {
+            const p = m[0];
+            if (p && !addedPaths.includes(p) && !addedPaths.some((ap) => ap.endsWith("/" + p))) {
+                addedPaths.push(p);
+            }
+        }
+    }
+    for (const p of addedPaths) {
+        if (resolved.input_materials.some((m) => m.path === p))
+            continue;
+        let kind = "file";
+        if (/\.(zip|tar\.gz|gz|rar|7z|jar|war)$/i.test(p))
+            kind = "archive";
+        else if (/\.log$/i.test(p))
+            kind = "log";
+        else if (/\.(md|txt|doc|pdf|docx)$/i.test(p))
+            kind = "doc";
+        else if (/\.(java|py|ts|tsx|js|jsx|go|rs)$/i.test(p))
+            kind = "file";
+        resolved.input_materials.push({ kind, path: p, required: true });
+    }
+    // 仅清除路径类型的缺失输入（保留非路径问题如"哪个框架?"）
+    if (addedPaths.length > 0) {
+        resolved.missing_required_inputs = resolved.missing_required_inputs.filter((m) => !/path|路径|目录|文件|folder|directory|file/i.test(m));
+    }
+    return resolved;
+}
+/**
+ * 获取 sf_expand 契约的 next_allowed_tools 和 forbidden_tools。
+ */
+export function getExpandContractTools() {
+    const contract = findToolInvocationContractByName("sf_expand");
+    return {
+        next_allowed_tools: contract?.default_next_tools ?? [],
+        forbidden_tools: contract?.forbidden_next_tools ?? [],
+    };
+}
+export function buildCheckedItems(_contract, routeDecision) {
+    const items = [
+        "workflow_resolved",
+        "mutation_allowed_checked",
+        "prompt_template_checked",
+        "required_mechanisms_declared",
+    ];
+    if (routeDecision && !routeDecision.mutation_allowed) {
+        items.push("read_only_scope_checked");
+    }
+    return items;
+}
+export function mergeKnowledgeEntries(entries) {
+    const seen = new Set();
+    const merged = [];
+    for (const entry of entries) {
+        if (seen.has(entry.id))
+            continue;
+        seen.add(entry.id);
+        merged.push(entry);
+    }
+    return merged;
+}
+export function extractKeywords(intent) {
+    return intent
+        .replace(/[的了吗呢把被在从对和与或是]/g, " ")
+        .split(/[\s,，、；;]+/)
+        .filter((w) => w.length >= 2);
+}
+/**
+ * 读取分类结果中的受影响仓库。
+ * 旧任务上下文或外部适配器可能缺少 affected_repos；这里统一降级为空数组，避免 sf_expand 卡死。
+ */
+export function getAffectedRepos(classification) {
+    return Array.isArray(classification?.affected_repos)
+        ? classification.affected_repos.filter((repo) => typeof repo === "string" && repo.length > 0)
+        : [];
+}
+export function buildTechStackLabel(config) {
+    const parts = [];
+    if (config.tech_stack.backend.framework) {
+        parts.push(`${config.tech_stack.backend.framework} ${config.tech_stack.backend.version}`);
+    }
+    if (config.tech_stack.frontend.framework) {
+        parts.push(`${config.tech_stack.frontend.framework} ${config.tech_stack.frontend.version}`);
+    }
+    return parts.join(" + ") || "未知";
+}
+/**
+ * 按模板文件名精确匹配知识条目。
+ * 匹配 entry.name、file basename (with/without extension)。
+ */
+export function matchesTemplateByName(entry, templateName) {
+    const requested = templateName.trim();
+    const fileName = path.basename(entry.file_path);
+    const fileStem = path.basename(entry.file_path, path.extname(entry.file_path));
+    return [entry.name, fileName, fileStem].some((c) => c.trim() === requested);
+}
+export function normalizeTemplateName(name) {
+    return name.trim();
+}
+export function matchesOutputTemplate(entry, outputTemplate) {
+    const requested = normalizeTemplateName(outputTemplate);
+    const fileName = path.basename(entry.file_path);
+    const fileStem = path.basename(entry.file_path, path.extname(entry.file_path));
+    return [
+        entry.name,
+        fileName,
+        fileStem,
+    ].some((candidate) => normalizeTemplateName(candidate) === requested);
+}
+/**
+ * 当 affected_repos 为空时，从意图文本和技术栈配置推断 scope。
+ *
+ * 原则：
+ * 1. 意图中含明确前端/后端关键词 → 加入对应 scope
+ * 2. 意图含通用开发关键词 + 项目配了对应技术栈 → 加入对应 scope
+ * 3. 都推断不出来 → 返回空数组（不限制 scope，由关键词/路由/预算控制精度）
+ */
+const BACKEND_KEYWORD_RE = /后端|backend|server|api|java|spring|数据库|sql|接口实现|服务端|controller|service|mapper|repository|dao|entity|dto/i;
+const FRONTEND_KEYWORD_RE = /前端|frontend|client|react|vue|页面|组件|component|ui|css|html|浏览器|前端路由|route|store|hook|props/i;
+const GENERIC_DEV_RE = /实现|开发|编码|修复|重构|新增|添加|完成|写|修改|变更|改|功能|feature|fix|refactor|implement/i;
+export function inferScopeFromIntentAndConfig(intent, classification, config) {
+    const text = `${intent} ${classification?.task_type ?? ""}`.toLowerCase();
+    const scopes = ["shared"];
+    // 1. 显式关键词匹配
+    if (BACKEND_KEYWORD_RE.test(text)) {
+        scopes.push("backend");
+    }
+    if (FRONTEND_KEYWORD_RE.test(text)) {
+        scopes.push("frontend");
+    }
+    // 2. 隐式推断：通用开发意图 + 有技术栈配置
+    if (!scopes.includes("backend") && !scopes.includes("frontend")) {
+        const hasBackend = config.tech_stack?.backend?.framework && config.tech_stack.backend.framework !== "unknown";
+        const hasFrontend = config.tech_stack?.frontend?.framework && config.tech_stack.frontend.framework !== "unknown";
+        if (GENERIC_DEV_RE.test(text)) {
+            if (hasBackend)
+                scopes.push("backend");
+            if (hasFrontend)
+                scopes.push("frontend");
+        }
+    }
+    // 3. 只有 shared 且无技术栈 → 不限制 scope
+    if (scopes.length === 1 && scopes[0] === "shared"
+        && (!config.tech_stack?.backend?.framework || config.tech_stack.backend.framework === "unknown")
+        && (!config.tech_stack?.frontend?.framework || config.tech_stack.frontend.framework === "unknown")) {
+        return [];
+    }
+    return [...new Set(scopes)];
+}
+/**
+ * 解析 scope: 非代码任务使用简化 scope。
+ */
+export function resolveScope(config, classification, degraded, routeDecision) {
+    return resolveTaskScope({
+        projectPath: config._projectPath ?? process.cwd(),
+        config,
+        classification,
+        degraded,
+        routeDecision,
+    });
+}
+/**
+ * 缺少必需输入时返回澄清结果（不生成执行 prompt）。
+ */
+export function buildClarificationResult(_intent, routeDecision, _config, workflowContract, safeIntent, safeGoal) {
+    const clarification = routeDecision.missing_required_inputs.join("\n");
+    return {
+        task_id: "",
+        prompt: `## 澄清请求\n\n任务: ${safeIntent}\n\n缺少必需输入:\n${clarification}\n\n请补充以上信息后重新调用。`,
+        scope: { allowed_paths: [], readonly_paths: [], new_files_allowed: false },
+        acceptance: { automated: [], manual: [] },
+        matched_patterns: [],
+        matched_knowledge: [],
+        is_legacy_code: false,
+        degraded: true,
+        contract: {
+            goal: safeGoal,
+            scope: [],
+            constraints: ["缺少必需输入，等待澄清"],
+            verification: [],
+            stop_conditions: [],
+        },
+        workflow_trace: workflowContract ? {
+            workflow_id: workflowContract.id,
+            route: routeDecision.route,
+            execution_shape: routeDecision.execution_shape,
+            mutation_allowed: workflowContract.mutation_allowed,
+            required_mechanisms: workflowContract.required_mechanisms,
+            governance_findings: [],
+            degraded: true,
+            state_transition_target: "clarifying",
+        } : undefined,
+    };
+}
+//# sourceMappingURL=helpers.js.map

package/dist/engine/pipeline/intent_expander/helpers.js.map

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

package/dist/engine/pipeline/intent_expander/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * intent_expander — 公共 API 重导出。
+ *
+ * 原始单体 intent_expander.ts 的所有导出
+ * 在此重导出，以便现有消费者可以从
+ * `"./intent_expander/index.js"`（或 `"./intent_expander.js"` → `"./intent_expander/index.js"`）导入。
+ */
+export { expand } from "./expand.js";
+export type { ExpandInput, PlanContext, CircuitBreakerResult, BrainstormOutput, BlockedResultOptions } from "./types.js";
+export { checkCircuitBreaker } from "./uncertainty_circuit.js";
+export { inferScopeFromIntentAndConfig } from "./helpers.js";
+export { queryKnowledgeForRoute, loadBuiltinByPipeline } from "./knowledge.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/pipeline/intent_expander/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/engine/pipeline/intent_expander/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGzH,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG/D,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAG7D,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/engine/pipeline/intent_expander/index.js

@@ -0,0 +1,16 @@
+/**
+ * intent_expander — 公共 API 重导出。
+ *
+ * 原始单体 intent_expander.ts 的所有导出
+ * 在此重导出，以便现有消费者可以从
+ * `"./intent_expander/index.js"`（或 `"./intent_expander.js"` → `"./intent_expander/index.js"`）导入。
+ */
+// ── 主函数 ──
+export { expand } from "./expand.js";
+// ── 熔断器（原始导出） ──
+export { checkCircuitBreaker } from "./uncertainty_circuit.js";
+// ── 范围推断（原始导出） ──
+export { inferScopeFromIntentAndConfig } from "./helpers.js";
+// ── 知识查询（原始导出） ──
+export { queryKnowledgeForRoute, loadBuiltinByPipeline } from "./knowledge.js";
+//# sourceMappingURL=index.js.map

package/dist/engine/pipeline/intent_expander/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/engine/pipeline/intent_expander/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY;AACZ,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAKrC,kBAAkB;AAClB,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,mBAAmB;AACnB,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAE7D,mBAAmB;AACnB,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/engine/pipeline/intent_expander/knowledge.d.ts

@@ -0,0 +1,24 @@
+/**
+ * intent_expander — knowledge querying and loading helpers.
+ *
+ * Functions for querying the knowledge index, loading builtin templates,
+ * converting project knowledge assets, and matching templates by name.
+ */
+import type { ProjectConfig, KnowledgeEntry } from "../../../types/index.js";
+import type { KnowledgeIndexManager } from "../../../knowledge/index_manager.js";
+import type { IntentRouteDecision } from "../intent_router.js";
+import type { ProjectKnowledgeAsset } from "../../contracts/project_knowledge_contract.js";
+export declare function knowledgeTypeForProjectAsset(asset: ProjectKnowledgeAsset): KnowledgeEntry["type"];
+export declare function readProjectKnowledgeBody(asset: ProjectKnowledgeAsset): string;
+export declare function projectKnowledgeAssetToEntry(asset: ProjectKnowledgeAsset): KnowledgeEntry | null;
+/**
+ * 根据 pipeline_hint 名称加载内置流程模板。
+ */
+export declare function loadBuiltinByPipeline(pipelineName: string): KnowledgeEntry[];
+/**
+ * 路由驱动的知识匹配。
+ * 优先使用 pipeline_hint、output_artifact.kind、route + execution_shape，
+ * 降级为同类型通用产物 prompt，不退化成编码 prompt。
+ */
+export declare function queryKnowledgeForRoute(knowledgeIndex: KnowledgeIndexManager, intent: string, scopeFilters: string[], config: ProjectConfig, routeDecision: IntentRouteDecision | undefined, limit: number): KnowledgeEntry[];
+//# sourceMappingURL=knowledge.d.ts.map

package/dist/engine/pipeline/intent_expander/knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../../../src/engine/pipeline/intent_expander/knowledge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAI/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AAG3F,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,qBAAqB,GAAG,cAAc,CAAC,MAAM,CAAC,CAOjG;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAQ7E;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,qBAAqB,GAAG,cAAc,GAAG,IAAI,CAoBhG;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc,EAAE,CAY5E;AAoED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,qBAAqB,EACrC,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EAAE,EACtB,MAAM,EAAE,aAAa,EACrB,aAAa,EAAE,mBAAmB,GAAG,SAAS,EAC9C,KAAK,EAAE,MAAM,GACZ,cAAc,EAAE,CAoIlB"}

package/dist/engine/pipeline/intent_expander/knowledge.js

@@ -0,0 +1,274 @@
+/**
+ * intent_expander — knowledge querying and loading helpers.
+ *
+ * Functions for querying the knowledge index, loading builtin templates,
+ * converting project knowledge assets, and matching templates by name.
+ */
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import fss from "node:fs";
+import matter from "gray-matter";
+import { getContractDecision } from "../../templates/template_asset_contract_registry.js";
+import { parseFrontmatterVisibility } from "../../templates/template_asset_visibility.js";
+import { debugLog } from "../../core/logger.js";
+import { extractKeywords, matchesTemplateByName } from "./helpers.js";
+export function knowledgeTypeForProjectAsset(asset) {
+    if (asset.consumption === "acceptance_template")
+        return "acceptance_template";
+    if (asset.consumption === "review_rule")
+        return "review_rule";
+    if (asset.consumption === "hard_rule")
+        return "governance_rule";
+    if (asset.rel_path.includes("procedures/"))
+        return "procedure";
+    if (asset.rel_path.includes("domain/"))
+        return "domain";
+    return "governance_rule";
+}
+export function readProjectKnowledgeBody(asset) {
+    try {
+        const raw = fss.readFileSync(asset.abs_path, "utf-8");
+        if (/\.md$/i.test(asset.abs_path))
+            return matter(raw).content.trim();
+        return raw.trim();
+    }
+    catch {
+        return "";
+    }
+}
+export function projectKnowledgeAssetToEntry(asset) {
+    const body = readProjectKnowledgeBody(asset);
+    if (!body)
+        return null;
+    const now = new Date().toISOString();
+    return {
+        id: `project:${asset.id}`,
+        file_path: asset.abs_path,
+        name: asset.name,
+        type: knowledgeTypeForProjectAsset(asset),
+        when: [...asset.routes, ...asset.primary_triggers, ...asset.domains].join(", "),
+        body,
+        scope: ["shared"],
+        products: ["*"],
+        tech_stack: asset.tech_stack.join(","),
+        created_at: now,
+        updated_at: now,
+        usage_count: 0,
+        confidence: asset.hard_rule ? 1 : 0.85,
+        status: "active",
+    };
+}
+/**
+ * 根据 pipeline_hint 名称加载内置流程模板。
+ */
+export function loadBuiltinByPipeline(pipelineName) {
+    const entries = [];
+    // pipeline_hint 格式: source-prototype-to-delivery:step-1 → 找源码原型交付流程.md
+    const nameToTemplate = {
+        "source-prototype-to-delivery": "源码原型交付流程.md",
+    };
+    const templateFile = nameToTemplate[pipelineName];
+    if (templateFile) {
+        const entry = loadBuiltinTemplate(templateFile, "procedures");
+        if (entry)
+            entries.push(entry);
+    }
+    return entries;
+}
+/** 包内模板知识库根目录 */
+function getTemplatesRoot() {
+    const thisDir = path.dirname(fileURLToPath(import.meta.url));
+    // src/engine/pipeline/intent_expander/ → ../../../.. → 项目根 → templates
+    return path.resolve(thisDir, "..", "..", "..", "..", "templates");
+}
+/**
+ * 当知识索引中没有找到内置模板时，从 templates/ 加载为 KnowledgeEntry。
+ * 只加载指定名称的文件。
+ */
+function loadBuiltinTemplate(fileName, subDir) {
+    const templatesRoot = getTemplatesRoot();
+    const safeName = path.basename(fileName); // basename 防止路径穿越
+    const filePath = path.join(templatesRoot, subDir, safeName);
+    try {
+        if (!fss.existsSync(filePath))
+            return null;
+        // 合同门禁: getContractDecision 统一裁决
+        const relPath = `templates/${subDir}/${safeName}`;
+        const decision = getContractDecision(relPath);
+        if (decision.decision !== "allowed") {
+            debugLog("意图扩展: 内置模板被合同门禁阻断 —", relPath, decision.decision);
+            return null;
+        }
+        const raw = fss.readFileSync(filePath, "utf-8");
+        const fmVis = parseFrontmatterVisibility(raw);
+        if (fmVis === "soloforge_internal" || fmVis === "adapter_runtime_only" || fmVis === "scaffold_only") {
+            debugLog("意图扩展: 内置模板 frontmatter 可见性阻断 —", relPath, fmVis);
+            return null;
+        }
+        const { data, content: body } = matter(raw);
+        const name = data.name || path.basename(fileName, ".md");
+        const type = data.type || inferTypeFromSubDir(subDir);
+        return {
+            id: `builtin-${name}`,
+            file_path: filePath,
+            name,
+            type,
+            when: data.when || "",
+            body,
+            scope: data.scope || ["shared"],
+            products: data.products || ["*"],
+            tech_stack: data.tech_stack,
+            created_at: data.created_at || new Date().toISOString().split("T")[0],
+            updated_at: data.updated_at || new Date().toISOString().split("T")[0],
+            usage_count: 0,
+            confidence: data.confidence ?? 1.0,
+            status: "active",
+        };
+    }
+    catch (e) {
+        debugLog("意图扩展: 内置模板加载失败 —", e);
+        return null;
+    }
+}
+function inferTypeFromSubDir(subDir) {
+    if (subDir.includes("procedures"))
+        return "pipeline_procedure";
+    if (subDir.includes("acceptance_templates"))
+        return "acceptance_template";
+    if (subDir.includes("review_rules"))
+        return "review_rule";
+    if (subDir.includes("domain"))
+        return "domain";
+    return "pattern";
+}
+/**
+ * 路由驱动的知识匹配。
+ * 优先使用 pipeline_hint、output_artifact.kind、route + execution_shape，
+ * 降级为同类型通用产物 prompt，不退化成编码 prompt。
+ */
+export function queryKnowledgeForRoute(knowledgeIndex, intent, scopeFilters, config, routeDecision, limit) {
+    if (!routeDecision) {
+        // 无 route_decision 时回退到旧逻辑（不传 route，不强制路由匹配）
+        return knowledgeIndex.query({
+            scope: scopeFilters,
+            products: [config.product_profile],
+            keywords: extractKeywords(intent),
+            limit,
+        });
+    }
+    const currentRoute = routeDecision.route;
+    const seen = new Set();
+    const results = [];
+    function addEntries(entries) {
+        for (const e of entries) {
+            if (!seen.has(e.id)) {
+                seen.add(e.id);
+                results.push(e);
+            }
+        }
+    }
+    // 优先级 1: pipeline_hint 精确匹配（不提前 return）
+    if (routeDecision.pipeline_hint) {
+        const pipelineName = routeDecision.pipeline_hint.split(":")[0];
+        const pipelineResults = knowledgeIndex.query({
+            scope: scopeFilters,
+            products: [config.product_profile],
+            type: "pipeline_procedure",
+            route: currentRoute,
+            keywords: extractKeywords(pipelineName),
+            limit: 3,
+        });
+        addEntries(pipelineResults);
+        // 内置模板回退: pipeline_hint 名称未命中时从 templates/ 加载
+        if (pipelineResults.length === 0) {
+            const builtin = loadBuiltinByPipeline(pipelineName);
+            if (builtin)
+                addEntries(builtin);
+        }
+    }
+    // 优先级 2: output_artifact.kind 映射 acceptance_template（不提前 return）
+    if (routeDecision.output_artifact?.kind) {
+        // 先按 template 文件名精确匹配
+        const templateName = routeDecision.output_artifact.template;
+        if (templateName) {
+            const allTemplates = knowledgeIndex.query({
+                scope: scopeFilters,
+                products: [config.product_profile],
+                type: "acceptance_template",
+                route: currentRoute,
+                keywords: [],
+                limit: 100,
+            });
+            const exactMatch = allTemplates.find((e) => matchesTemplateByName(e, templateName));
+            if (exactMatch)
+                addEntries([exactMatch]);
+            // 内置模板回退: template 名称未命中时从 templates/artifacts/shared/ 加载
+            if (!exactMatch) {
+                const builtinTemplate = loadBuiltinTemplate(templateName, "artifacts/shared");
+                if (builtinTemplate)
+                    addEntries([builtinTemplate]);
+            }
+        }
+        // 再按 artifact kind 关键词匹配
+        const artifactKeywords = {
+            prototype_spec: ["原型", "prototype", "原型说明"],
+            api_spec: ["接口", "API", "接口设计"],
+            design_doc: ["设计", "架构", "详细设计"],
+            test_plan: ["测试", "测试计划"],
+            migration_plan: ["迁移", "迁移方案"],
+            review_report: ["审查", "review"],
+            task_breakdown: ["任务", "拆解"],
+            root_cause: ["根因", "分析"],
+            incident_review: ["故障", "复盘"],
+        };
+        const artifactKws = artifactKeywords[routeDecision.output_artifact.kind] ?? [];
+        if (artifactKws.length > 0) {
+            const templateResults = knowledgeIndex.query({
+                scope: scopeFilters,
+                products: [config.product_profile],
+                type: "acceptance_template",
+                keywords: artifactKws,
+                limit: 2,
+            });
+            addEntries(templateResults);
+        }
+    }
+    // 优先级 3: intent keywords 补充（填满 limit）
+    if (results.length < limit) {
+        const keywordResults = knowledgeIndex.query({
+            scope: scopeFilters,
+            products: [config.product_profile],
+            route: currentRoute,
+            keywords: extractKeywords(intent),
+            limit: limit,
+        });
+        addEntries(keywordResults);
+    }
+    // 合同门禁: 对 templates/ 相对路径统一裁决，过滤 denied 和 unregistered
+    const filtered = results.filter((entry) => {
+        if (!entry.file_path)
+            return true;
+        // 只对 templates/ 开头的相对路径执行合同裁决
+        const normalized = entry.file_path.replace(/\\/g, "/");
+        if (!normalized.startsWith("templates/"))
+            return true;
+        const decision = getContractDecision(normalized);
+        if (decision.decision !== "allowed")
+            return false;
+        // 技术栈过滤: 合同声明了 applicable_tech_stack 时必须匹配当前项目技术栈
+        if (decision.contract && decision.contract.applicable_tech_stack.length > 0) {
+            const currentStack = [
+                config.tech_stack?.backend?.framework,
+                config.tech_stack?.frontend?.framework,
+                config.tech_stack?.backend?.lang,
+                config.tech_stack?.frontend?.lang,
+            ].filter(Boolean);
+            const hasMatch = decision.contract.applicable_tech_stack.some((t) => currentStack.some((s) => s.toLowerCase().includes(t.toLowerCase()) || t.toLowerCase().includes(s.toLowerCase())));
+            if (!hasMatch)
+                return false;
+        }
+        return true;
+    });
+    return filtered.slice(0, limit);
+}
+//# sourceMappingURL=knowledge.js.map