soloforge 1.1.2 → 1.1.30

package/dist/engine/debugger.js

@@ -1,383 +0,0 @@
-/**
- * 调试器 — 对错误输出执行六步调试流水线分析。
- *
- * 流水线步骤：
- * 1. 错误解析（parseError）：将原始错误输出分类为编译错误、测试失败、运行时异常或未知类型
- * 2. 调用链提取（extractCallChain）：从堆栈跟踪中提取项目范围内的调用链
- * 3. 根因分析（analyzeRootCause）：基于规则引擎判定错误类型和来源阶段
- * 4. 修复建议（proposeFix）：根据错误类型提供定向修复策略
- * 5. 测试补充建议（suggestTests）：推荐与错误类型匹配的测试场景
- * 6. 结果汇总（debugError）：将以上步骤的结果组装为完整的调试会话
- */
-/**
- * 上游阶段检测模式。
- * 用于判断错误是否源自需求、设计、权限、DDL 或 API 契约阶段，
- * 这类错误通常禁止自动修复，需人工介入。
- */
-const PHASE_ORIGIN_PATTERNS = [
-    { pattern: /requirement|需求|spec/i, phase: "requirement" },
-    { pattern: /design|架构|设计|DDL|表结构|接口定义/i, phase: "design" },
-    { pattern: /permission|权限|角色|授权/i, phase: "permission" },
-    { pattern: /migration|数据库变更|schema/i, phase: "ddl" },
-    { pattern: /api.*contract|接口契约|swagger/i, phase: "api_contract" },
-];
-// ── 第一步：错误解析（分类阶段） ──
-/** 编译错误匹配模式 — 匹配 TypeScript 编译错误、类型不匹配、模块找不到等 */
-const COMPILATION_PATTERNS = [
-    /error TS\d+/,
-    /error:/,
-    /Cannot find/,
-    /Type '.*' is not assignable/,
-];
-/** 测试失败匹配模式 — 匹配测试框架输出的失败标记和断言错误 */
-const TEST_FAILURE_PATTERNS = [
-    /FAIL|✕|×|AssertionError|expect\(/,
-    /Test suite failed/,
-];
-/** 运行时异常匹配模式 — 匹配 JavaScript/TypeScript 常见的运行时错误类型 */
-const RUNTIME_PATTERNS = [
-    /Error:/,
-    /Exception:/,
-    /TypeError:/,
-    /ReferenceError:/,
-    /throw new/,
-];
-/** 源文件行号提取正则 — 从错误输出中提取 src/ 或 ./ 开头的源文件路径和行号 */
-const FILE_LINE_PATTERN = /(?:src\/[^\s:(]+|\.\/[^\s:(]+)\.(?:ts|tsx|js|jsx)[\s(]*(\d+)/;
-/**
- * 解析错误输出，将其分类为编译错误、测试失败、运行时异常或未知类型。
- * 同时提取文件路径、行号、错误消息和堆栈帧信息。
- * @param errorOutput - 原始错误输出文本
- * @returns 解析后的错误信息
- */
-function parseError(errorOutput) {
-    const lines = errorOutput.split("\n");
-    const stack_frames = [];
-    // 提取堆栈帧（格式为 "at functionName (file:line:column)"）
-    for (const line of lines) {
-        if (/^\s*at\s+/.test(line)) {
-            stack_frames.push(line.trim());
-        }
-    }
-    // 优先级 1: 编译错误（类型定义、导入路径问题等）
-    for (const pattern of COMPILATION_PATTERNS) {
-        if (pattern.test(errorOutput)) {
-            const fileLineMatch = FILE_LINE_PATTERN.exec(errorOutput);
-            const filePathMatch = /(?:src\/[^\s:(]+|\.\/[^\s:(]+)\.(?:ts|tsx|js|jsx)/.exec(errorOutput);
-            return {
-                error_type: "compilation",
-                file: filePathMatch ? filePathMatch[0] : undefined,
-                line: fileLineMatch ? parseInt(fileLineMatch[1], 10) : undefined,
-                message: extractErrorMessage(errorOutput),
-                stack_frames,
-            };
-        }
-    }
-    // 优先级 2: 测试失败（断言不通过、测试套件失败等）
-    for (const pattern of TEST_FAILURE_PATTERNS) {
-        if (pattern.test(errorOutput)) {
-            const testNameMatch = /✕\s+(.+)/.exec(errorOutput) || /FAIL\s+(.+)/.exec(errorOutput);
-            const assertionMatch = /AssertionError:\s*(.+)/.exec(errorOutput);
-            return {
-                error_type: "test_failure",
-                message: assertionMatch
-                    ? assertionMatch[1].trim()
-                    : testNameMatch
-                        ? testNameMatch[1].trim()
-                        : extractErrorMessage(errorOutput),
-                stack_frames,
-            };
-        }
-    }
-    // 优先级 3: 运行时异常（TypeError、ReferenceError 等）
-    for (const pattern of RUNTIME_PATTERNS) {
-        if (pattern.test(errorOutput)) {
-            const exceptionMatch = /(TypeError|ReferenceError|Error|Exception|RangeError|SyntaxError):\s*(.+)/.exec(errorOutput);
-            return {
-                error_type: "runtime",
-                message: exceptionMatch
-                    ? `${exceptionMatch[1]}: ${exceptionMatch[2].trim()}`
-                    : extractErrorMessage(errorOutput),
-                stack_frames,
-            };
-        }
-    }
-    // 兜底: 无法归类的未知错误
-    return {
-        error_type: "unknown",
-        message: extractErrorMessage(errorOutput),
-        stack_frames,
-    };
-}
-/**
- * 从错误输出中提取有意义的错误消息。
- * 优先提取包含 error/Error/FAIL/throw 等关键词的行，回退到第一行非空内容。
- * 截取最大 300 字符，避免过长消息。
- * @param errorOutput - 原始错误输出
- * @returns 提取到的错误消息文本
- */
-function extractErrorMessage(errorOutput) {
-    // 尝试提取包含错误关键词的行
-    const lines = errorOutput.split("\n").filter((l) => l.trim().length > 0);
-    for (const line of lines) {
-        const trimmed = line.trim();
-        if (/error|Error|FAIL|fail|throw|panic/i.test(trimmed)) {
-            // 截取合理长度，防止消息过长
-            return trimmed.length > 300 ? trimmed.substring(0, 300) + "..." : trimmed;
-        }
-    }
-    // 回退：无关键词命中时，取第一行非空内容
-    const first = lines[0]?.trim() ?? "";
-    return first.length > 300 ? first.substring(0, 300) + "..." : first;
-}
-// ── 第二步：调用链提取 ──
-/** 堆栈帧正则 — 匹配格式 "at functionName (filePath:line:column)" */
-const STACK_FRAME_PATTERN = /at\s+(.+?)\s+\((.+?):(\d+):(\d+)\)/;
-/**
- * 从错误输出中提取调用链。
- * 解析标准格式的堆栈帧，可选地过滤到项目范围内的帧。
- * @param errorOutput - 原始错误输出
- * @param projectScope - 可选的项目路径范围，仅保留路径包含这些前缀的帧
- * @returns 调用链项列表（按调用顺序排列）
- */
-function extractCallChain(errorOutput, projectScope) {
-    const chain = [];
-    const scope = projectScope ?? [];
-    const lines = errorOutput.split("\n");
-    for (const line of lines) {
-        const match = STACK_FRAME_PATTERN.exec(line.trim());
-        if (!match)
-            continue;
-        const [, funcName, filePath, lineNum] = match;
-        const lineNumber = parseInt(lineNum, 10);
-        // 如果指定了项目范围，只保留范围内的帧
-        if (scope.length > 0) {
-            const inScope = scope.some((scopePath) => filePath.includes(scopePath));
-            if (!inScope)
-                continue;
-        }
-        chain.push({
-            file: filePath,
-            function: funcName,
-            line: lineNumber,
-        });
-    }
-    return chain;
-}
-// ── 第四步：根因分析 ──
-/**
- * 基于规则引擎分析错误的根因。
- *
- * 判定规则（按优先级）：
- * 1. 上游阶段关键词匹配 → 确定性缺陷，禁止自动修复
- * 2. 编译错误 → 可修复（类型/导入问题）
- * 3. 测试失败 → 可修复（断言/数据问题）
- * 4. 同一错误重复 3 次以上 → 确定性缺陷
- * 5. 默认 → 可修复（通用错误）
- *
- * @param errorOutput - 原始错误输出
- * @param parsedError - 已解析的错误信息
- * @returns 根因分析结果（含失败类型、置信度和摘要）
- */
-function analyzeRootCause(errorOutput, parsedError) {
-    // 规则 1: 检测上游阶段关键词（需求、设计、权限、DDL、接口契约）
-    for (const { pattern, phase } of PHASE_ORIGIN_PATTERNS) {
-        if (pattern.test(errorOutput)) {
-            return {
-                failure_type: "deterministic",
-                phase_origin: phase,
-                summary: `根因追溯至 ${phase} 阶段，禁止自动修复`,
-                confidence: 0.85,
-            };
-        }
-    }
-    // 规则 2: 编译错误 → 通常可修复（类型定义或导入路径问题）
-    if (parsedError.error_type === "compilation") {
-        return {
-            failure_type: "fixable",
-            summary: "编译错误，类型定义或导入路径问题",
-            confidence: 0.7,
-        };
-    }
-    // 规则 3: 测试失败 → 通常可修复（断言条件或测试数据问题）
-    if (parsedError.error_type === "test_failure") {
-        return {
-            failure_type: "fixable",
-            summary: "测试失败，需检查断言条件或测试数据",
-            confidence: 0.6,
-        };
-    }
-    // 规则 4: 同一错误重复出现 3 次及以上 → 确定性缺陷（可能是逻辑死循环或配置错误）
-    const errorLines = errorOutput.split("\n").filter((l) => l.trim().length > 0);
-    const firstErrorLine = errorLines[0]?.trim() ?? "";
-    const repeatCount = errorLines.filter((l) => l.trim() === firstErrorLine).length;
-    if (repeatCount >= 3) {
-        return {
-            failure_type: "deterministic",
-            summary: `同一错误重复出现 ${repeatCount} 次，判定为确定性缺陷`,
-            confidence: 0.9,
-        };
-    }
-    // 规则 5: 默认兜底 — 通用可修复错误
-    return {
-        failure_type: "fixable",
-        summary: "通用可修复错误，需要进一步上下文分析",
-        confidence: 0.5,
-    };
-}
-// ── 第五步：修复建议 ──
-/**
- * 根据错误类型生成定向修复建议。
- *
- * 策略映射：
- * - compilation → 检查类型定义和导入路径（低风险）
- * - test_failure → 对比预期与实际输出（中风险）
- * - runtime → 添加空值检查和异常处理（中风险）
- * - unknown → 增加日志收集更多信息（高风险）
- *
- * @param parsedError - 已解析的错误信息
- * @param callChain - 调用链（用于定位相关文件）
- * @param _rootCause - 根因分析结果（当前版本未直接使用）
- * @returns 修复建议（包含描述、待检查文件、方法和风险等级）
- */
-function proposeFix(parsedError, callChain, _rootCause) {
-    switch (parsedError.error_type) {
-        case "compilation": {
-            // 编译错误：定位到出错文件，从顶层依赖逐步修复
-            const filesToCheck = [];
-            if (parsedError.file) {
-                filesToCheck.push(parsedError.file);
-            }
-            return {
-                description: "检查类型定义和导入路径",
-                files_to_check: filesToCheck,
-                approach: "逐步修复类型错误，从最上层的依赖开始",
-                risk: "low",
-            };
-        }
-        case "test_failure": {
-            // 测试失败：从调用链中提取涉及的文件，对比预期和实际输出
-            const filesToCheck = callChain
-                .map((item) => item.file)
-                .filter((f, i, arr) => arr.indexOf(f) === i); // 去重
-            return {
-                description: "检查断言条件和测试数据",
-                files_to_check: filesToCheck,
-                approach: "对比预期与实际输出，定位差异根因",
-                risk: "medium",
-            };
-        }
-        case "runtime": {
-            // 运行时异常：从调用链定位异常位置，添加防御性代码
-            const filesToCheck = callChain
-                .map((item) => item.file)
-                .filter((f, i, arr) => arr.indexOf(f) === i); // 去重
-            return {
-                description: "定位异常抛出位置，检查边界条件",
-                files_to_check: filesToCheck,
-                approach: "添加空值检查和异常处理",
-                risk: "medium",
-            };
-        }
-        case "unknown":
-        default: {
-            // 未知错误：建议先收集更多上下文信息
-            return {
-                description: "收集更多错误上下文信息",
-                files_to_check: [],
-                approach: "增加日志输出以获取更多诊断信息",
-                risk: "high",
-            };
-        }
-    }
-}
-// ── 第六步：测试补充建议 ──
-/**
- * 根据错误类型推荐补充测试场景。
- * 每种错误类型对应不同的测试重点：
- * - compilation → 类型安全测试、编译时边界检查
- * - test_failure → 回归测试、等价类划分
- * - runtime → 空值/边界条件测试、异常处理路径
- * - unknown → 探索性测试
- * @param errorType - 已解析的错误类型
- * @returns 测试建议列表（含场景、覆盖范围和优先级）
- */
-function suggestTests(errorType) {
-    switch (errorType) {
-        case "compilation":
-            return [
-                {
-                    scenario: "类型安全测试",
-                    covers: "确保类型定义与实际使用一致",
-                    priority: "high",
-                },
-                {
-                    scenario: "编译时边界检查",
-                    covers: "验证极端类型场景和类型转换",
-                    priority: "medium",
-                },
-            ];
-        case "test_failure":
-            return [
-                {
-                    scenario: "回归测试覆盖失败场景",
-                    covers: "防止已修复问题再次出现",
-                    priority: "high",
-                },
-                {
-                    scenario: "等价类划分测试",
-                    covers: "覆盖输入空间的典型和边界情况",
-                    priority: "medium",
-                },
-            ];
-        case "runtime":
-            return [
-                {
-                    scenario: "空值/边界条件测试",
-                    covers: "验证对 undefined、null、空数组等边界值的处理",
-                    priority: "high",
-                },
-                {
-                    scenario: "异常处理路径测试",
-                    covers: "确保异常被正确捕获和恢复",
-                    priority: "high",
-                },
-            ];
-        case "unknown":
-        default:
-            return [
-                {
-                    scenario: "探索性测试用例",
-                    covers: "通过手动和自动化手段探索潜在问题区域",
-                    priority: "medium",
-                },
-            ];
-    }
-}
-// ── 主入口：六步调试流水线 ──
-/**
- * 执行完整的六步调试流水线。
- * 依次执行错误解析、调用链提取、根因分析、修复建议和测试补充，
- * 将结果组装为完整的调试会话对象。
- * @param errorOutput - 原始错误输出文本
- * @param taskId - 关联的任务 ID
- * @param projectScope - 可选的项目路径范围（用于过滤调用链帧）
- * @returns 完整的调试会话对象
- */
-export function debugError(errorOutput, taskId, projectScope) {
-    const parsed_error = parseError(errorOutput);
-    const call_chain = extractCallChain(errorOutput, projectScope);
-    const root_cause = analyzeRootCause(errorOutput, parsed_error);
-    const fix_proposal = proposeFix(parsed_error, call_chain, root_cause);
-    const test_supplement = suggestTests(parsed_error.error_type);
-    return {
-        task_id: taskId,
-        error_output: errorOutput,
-        parsed_error,
-        call_chain,
-        root_cause,
-        fix_proposal,
-        test_supplement,
-    };
-}
-//# sourceMappingURL=debugger.js.map

package/dist/engine/debugger.js.map

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

package/dist/engine/delivery.d.ts

@@ -1,42 +0,0 @@
-import type { TaskContext, ProjectConfig, DeliveryResult, ChangelogEntry } from "../types.js";
-import type { KnowledgeIndexManager } from "../knowledge/index_manager.js";
-import type { GitOperations } from "./git_deps.js";
-/**
- * 自动交付模块 — 完成代码提交、推送、PR 创建和变更日志生成。
- * 交付行为由产品配置文件（KnowledgeIndex 中的 domain 类型条目）控制，
- * 支持按需跳过推送和 PR 步骤。
- */
-/**
- * 交付流程的输入参数。
- * @property taskContext - 当前任务的上下文
- * @property config - 项目配置
- * @property knowledgeIndex - 知识索引管理器，用于读取交付配置
- * @property projectPath - 项目根目录路径
- * @property gitOps - Git 操作封装
- * @property skipPush - 是否跳过推送步骤
- * @property skipPr - 是否跳过 PR 创建步骤
- */
-export interface DeliveryInput {
-    taskContext: TaskContext;
-    config: ProjectConfig;
-    knowledgeIndex: KnowledgeIndexManager;
-    projectPath: string;
-    gitOps: GitOperations;
-    skipPush?: boolean;
-    skipPr?: boolean;
-}
-/**
- * 执行完整的交付流程：提交代码、推送到远程、生成 PR 命令和变更日志。
- * 流程按顺序执行，每一步失败后记录错误并继续后续步骤。
- * @param input - 交付输入参数
- * @returns 交付结果，包含已执行操作、跳过操作、错误信息和 commit hash
- */
-export declare function deliver(input: DeliveryInput): Promise<DeliveryResult>;
-/**
- * 根据任务上下文生成 Conventional Commits 格式的变更日志条目。
- * 任务类型映射：feature→feat, bugfix/hotfix→fix, refactor→refactor, test→test 等。
- * @param taskContext - 当前任务的上下文
- * @returns 变更日志条目，包含类型、作用域、描述和任务 ID
- */
-export declare function generateChangelogEntry(taskContext: TaskContext): ChangelogEntry;
-//# sourceMappingURL=delivery.d.ts.map

package/dist/engine/delivery.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"delivery.d.ts","sourceRoot":"","sources":["../../src/engine/delivery.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EAEb,cAAc,EAEd,cAAc,EACf,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD;;;;GAIG;AAIH;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,cAAc,EAAE,qBAAqB,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAoJ3E;AAcD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,WAAW,GAAG,cAAc,CAmB/E"}

package/dist/engine/delivery.js

@@ -1,236 +0,0 @@
-import YAML from "yaml";
-/**
- * 执行完整的交付流程：提交代码、推送到远程、生成 PR 命令和变更日志。
- * 流程按顺序执行，每一步失败后记录错误并继续后续步骤。
- * @param input - 交付输入参数
- * @returns 交付结果，包含已执行操作、跳过操作、错误信息和 commit hash
- */
-export async function deliver(input) {
-    const { taskContext, config, knowledgeIndex, projectPath, gitOps, skipPush, skipPr, } = input;
-    const result = {
-        task_id: taskContext.task_id,
-        actions_performed: [],
-        commit_message: "",
-        branch: "",
-        skipped_actions: [],
-        errors: [],
-    };
-    // 1. 从产品配置文件加载交付行为配置
-    const deliveryConfig = resolveDeliveryConfig(knowledgeIndex, config.product_profile);
-    // 2. 获取当前分支名称（作为后续推送和 PR 的目标分支）
-    try {
-        result.branch = await gitOps.getCurrentBranch(projectPath);
-    }
-    catch (e) {
-        result.errors.push(`无法获取当前分支: ${e instanceof Error ? e.message : String(e)}`);
-        return result;
-    }
-    // 3. 根据任务信息构建变更日志条目和提交消息
-    const entry = generateChangelogEntry(taskContext);
-    result.commit_message = formatCommitMessage(entry);
-    // 4. 执行 git commit（如果配置允许自动提交）
-    if (deliveryConfig.auto_commit) {
-        try {
-            const changedFiles = taskContext.execution?.changed_files ?? [];
-            // 优先使用任务上下文中记录的变更文件列表
-            if (changedFiles.length > 0) {
-                await gitOps.add(projectPath, changedFiles);
-            }
-            else {
-                // 无明确变更记录时，暂存所有改动
-                await gitOps.add(projectPath, ["."]);
-            }
-            const commitOutput = await gitOps.commit(projectPath, result.commit_message);
-            // 从提交输出中提取 commit hash，回退到 git rev-parse
-            const hashMatch = commitOutput.match(/\[[^\s]+ ([0-9a-f]{7,})\]/);
-            if (hashMatch) {
-                result.commit_hash = hashMatch[1];
-            }
-            else {
-                try {
-                    result.commit_hash = await gitOps.getHeadCommitHash(projectPath);
-                }
-                catch {
-                    result.commit_hash = undefined;
-                }
-            }
-            result.actions_performed.push("commit");
-        }
-        catch (e) {
-            result.errors.push(`提交失败: ${e instanceof Error ? e.message : String(e)}`);
-            result.skipped_actions.push({
-                action: "commit",
-                reason: "git commit 失败",
-            });
-        }
-    }
-    else {
-        result.skipped_actions.push({
-            action: "commit",
-            reason: "DeliveryConfig.auto_commit = false",
-        });
-    }
-    // 5. 推送到远程仓库（需要配置了自动推送且用户未跳过）
-    if (deliveryConfig.auto_push && !skipPush) {
-        try {
-            const remoteUrl = await gitOps.getRemoteUrl(projectPath);
-            // 仅当存在远程仓库时才执行推送
-            if (remoteUrl) {
-                await gitOps.push(projectPath, "origin", result.branch);
-                result.actions_performed.push("push");
-            }
-            else {
-                result.skipped_actions.push({
-                    action: "push",
-                    reason: "未配置远程仓库",
-                });
-            }
-        }
-        catch (e) {
-            result.errors.push(`推送失败: ${e instanceof Error ? e.message : String(e)}`);
-            result.skipped_actions.push({
-                action: "push",
-                reason: "git push 失败",
-            });
-        }
-    }
-    else if (skipPush) {
-        result.skipped_actions.push({
-            action: "push",
-            reason: "用户跳过",
-        });
-    }
-    else {
-        result.skipped_actions.push({
-            action: "push",
-            reason: "DeliveryConfig.auto_push = false",
-        });
-    }
-    // 6. 生成 PR 创建命令（不自动执行 PR 创建，仅返回命令供用户手动执行）
-    if (deliveryConfig.auto_pr && !skipPr) {
-        const remoteUrl = await gitOps
-            .getRemoteUrl(projectPath)
-            .catch(() => null);
-        if (remoteUrl) {
-            const labels = deliveryConfig.pr_labels.length > 0
-                ? ` --label ${deliveryConfig.pr_labels.join(",")}`
-                : "";
-            result.pr_url = `gh pr create --title "${shellEscape(entry.type)}(${shellEscape(entry.scope)}): ${shellEscape(entry.description)}" --body "Task: ${taskContext.task_id}"${labels}`;
-            result.actions_performed.push("pr");
-        }
-        else {
-            result.skipped_actions.push({
-                action: "pr",
-                reason: "未配置远程仓库",
-            });
-        }
-    }
-    else {
-        result.skipped_actions.push({
-            action: "pr",
-            reason: skipPr ? "用户跳过" : "DeliveryConfig.auto_pr = false",
-        });
-    }
-    // 7. 生成变更日志
-    result.changelog = formatChangelog(entry);
-    result.actions_performed.push("changelog");
-    return result;
-}
-// ── Shell 转义辅助函数 ──
-/**
- * 对字符串进行 shell 安全转义，防止双引号内注入。
- * 转义双引号、反引号、美元符号和反斜杠。
- */
-function shellEscape(str) {
-    return str.replace(/["$`\\]/g, "\\$&");
-}
-// ── 变更日志辅助函数 ──
-/**
- * 根据任务上下文生成 Conventional Commits 格式的变更日志条目。
- * 任务类型映射：feature→feat, bugfix/hotfix→fix, refactor→refactor, test→test 等。
- * @param taskContext - 当前任务的上下文
- * @returns 变更日志条目，包含类型、作用域、描述和任务 ID
- */
-export function generateChangelogEntry(taskContext) {
-    // 任务类型到 Conventional Commits 类型的映射表
-    const typeMap = {
-        feature: "feat",
-        bugfix: "fix",
-        hotfix: "fix",
-        refactor: "refactor",
-        test: "test",
-        document: "docs",
-        scaffold: "feat",
-        optimize: "chore",
-    };
-    const taskType = taskContext.classification?.task_type ?? "feature";
-    return {
-        type: typeMap[taskType] ?? "chore",
-        scope: taskContext.classification?.affected_repos[0] ?? "core",
-        description: taskContext.intent.slice(0, 80), // 意图描述截断为 80 字符
-        task_id: taskContext.task_id,
-    };
-}
-// ── 内部辅助函数 ──
-/**
- * 将变更日志条目格式化为 Git 提交消息。
- * 格式: `type(scope): description\n\nTask: taskId`
- * @param entry - 变更日志条目
- * @returns 格式化的提交消息字符串
- */
-function formatCommitMessage(entry) {
-    return `${entry.type}(${entry.scope}): ${entry.description}\n\nTask: ${entry.task_id}`;
-}
-/**
- * 将变更日志条目格式化为 Markdown 格式的变更日志行。
- * @param entry - 变更日志条目
- * @returns Markdown 格式的变更日志字符串
- */
-function formatChangelog(entry) {
-    const date = new Date().toISOString().split("T")[0];
-    return `## [${date}]\n\n- **${entry.type}(${entry.scope})**: ${entry.description} (${entry.task_id})`;
-}
-/**
- * 从知识索引中解析交付配置。
- * 在产品配置文件（domain 类型知识条目）中查找 delivery 配置块。
- * 找到则使用配置值，否则返回默认配置（仅自动提交，不自动推送/PR）。
- * @param knowledgeIndex - 知识索引管理器
- * @param productProfile - 产品配置文件名
- * @returns 交付行为配置
- */
-function resolveDeliveryConfig(knowledgeIndex, productProfile) {
-    // 默认配置：仅自动提交，推送和 PR 需手动触发
-    const defaults = {
-        auto_commit: true,
-        auto_push: false,
-        auto_pr: false,
-        pr_labels: [],
-        require_approval: false,
-    };
-    const profileEntries = knowledgeIndex.query({
-        type: "domain",
-        products: [productProfile],
-        limit: 5,
-    });
-    for (const entry of profileEntries) {
-        if (!entry.body)
-            continue;
-        try {
-            const parsed = YAML.parse(entry.body);
-            if (parsed?.delivery) {
-                return {
-                    auto_commit: parsed.delivery.auto_commit ?? defaults.auto_commit,
-                    auto_push: parsed.delivery.auto_push ?? defaults.auto_push,
-                    auto_pr: parsed.delivery.auto_pr ?? defaults.auto_pr,
-                    pr_labels: parsed.delivery.pr_labels ?? defaults.pr_labels,
-                    require_approval: parsed.delivery.require_approval ?? defaults.require_approval,
-                };
-            }
-        }
-        catch {
-            /* ignore parse errors */
-        }
-    }
-    return defaults;
-}
-//# sourceMappingURL=delivery.js.map