soloforge 1.1.2 → 1.1.31

package/dist/engine/pipeline/task_planner.js

@@ -0,0 +1,324 @@
+import { debug } from "../core/logger.js";
+/**
+ * 对任务进行拆解规划，生成子任务序列和执行顺序。
+ * 不满足拆解条件时返回空计划。
+ * @param input - 规划输入，包含意图、分类结果、项目配置和知识索引
+ * @returns 计划结果，包含子任务列表、执行顺序和并行分组
+ */
+export function planTask(input) {
+    debug("任务规划", "planTask() 开始, intent=${intent.substring(0, 60)}");
+    const { intent, classification, config, knowledgeIndex } = input;
+    if (!shouldPlan(classification)) {
+        debug("任务规划", "不满足拆解条件, complexity=${classification.complexity}, strategy=${classification.strategy}");
+        return {
+            task_id: "",
+            original_intent: intent,
+            sub_tasks: [],
+            execution_order: [],
+            parallel_groups: [],
+            summary: `不拆解: ${classification.complexity === "high" ? "非全流程策略" : "复杂度不足以触发拆解"}`,
+            skipped_reason: `触发条件不满足（complexity=${classification.complexity}, strategy=${classification.strategy}）`,
+            current_step_index: 0,
+        };
+    }
+    // 查询 pipeline_procedure 知识（流程指引）
+    const pipelineProcedures = knowledgeIndex.query({
+        scope: classification.affected_repos,
+        products: [config.product_profile],
+        type: "pipeline_procedure",
+        keywords: extractKeywords(intent),
+    });
+    // 查询普通 procedure 知识（流程补充）
+    const procedures = knowledgeIndex.query({
+        scope: classification.affected_repos,
+        products: [config.product_profile],
+        type: "procedure",
+        keywords: extractKeywords(intent),
+    });
+    // 查询可用的 acceptance_template（输出格式模板）
+    const templates = knowledgeIndex.query({
+        scope: classification.affected_repos,
+        products: [config.product_profile],
+        type: "acceptance_template",
+        keywords: [],
+    });
+    // 根据知识情况选择拆分策略
+    if (pipelineProcedures.length > 0) {
+        debug("任务规划", "发现 ${pipelineProcedures.length} 个 pipeline_procedure 知识，走知识驱动拆解");
+        // 有 pipeline_procedure → 知识驱动的多阶段计划
+        return buildKnowledgeDrivenPlan(intent, classification, config, pipelineProcedures, templates);
+    }
+    // 无 pipeline_procedure → 按仓库边界拆分（原有逻辑）
+    debug("任务规划", "无 pipeline_procedure，按仓库边界拆解");
+    const subTasks = splitByRepoBoundary(intent, classification, config);
+    if (procedures.length > 0) {
+        mergeProcedureHints(subTasks, procedures.map((p) => p.name));
+    }
+    debug("任务规划", "拆解结果 subTasks.length=${subTasks.length}");
+    if (subTasks.length <= 1) {
+        const single = subTasks[0] ?? {
+            id: "st-1",
+            title: intent,
+            description: "无法自动拆解，建议人工细化",
+            intent,
+            depends_on: [],
+            affected_repos: classification.affected_repos,
+            estimated_complexity: "medium",
+        };
+        return {
+            task_id: "",
+            original_intent: intent,
+            sub_tasks: [single],
+            execution_order: [single.id],
+            parallel_groups: [[single.id]],
+            summary: `无法自动拆解，建议人工细化子任务`,
+            current_step_index: 0,
+        };
+    }
+    const { order, parallelGroups } = buildExecutionOrder(subTasks, classification.affected_repos);
+    return {
+        task_id: "",
+        original_intent: intent,
+        sub_tasks: subTasks,
+        execution_order: order,
+        parallel_groups: parallelGroups,
+        summary: `拆解为 ${subTasks.length} 个子任务，${parallelGroups.length} 个执行阶段`,
+        current_step_index: 0,
+    };
+}
+/**
+ * 基于知识驱动的多阶段计划生成。
+ * 读取 pipeline_procedure 知识条目的步骤定义，结合可用模板，生成带模板绑定的子任务。
+ */
+function buildKnowledgeDrivenPlan(intent, classification, _config, pipelineProcedures, _templates) {
+    const procedure = pipelineProcedures[0];
+    // 从 pipeline_procedure body 中提取步骤
+    const steps = parsePipelineSteps(procedure.body || procedure.when);
+    const subTasks = steps.map((step, idx) => {
+        return {
+            id: `st-${idx + 1}`,
+            title: step.title,
+            description: step.description,
+            intent: step.title,
+            depends_on: idx > 0 ? [`st-${idx}`] : [],
+            affected_repos: classification.affected_repos,
+            estimated_complexity: inferComplexity(intent),
+            output_template: step.template_name || undefined,
+            output_path: step.output_path || `.soloforge/output/${String(idx + 1).padStart(2, "0")}-${step.title}.md`,
+            suggested_tools: step.tools || undefined,
+        };
+    });
+    const { order, parallelGroups } = buildExecutionOrder(subTasks, classification.affected_repos);
+    return {
+        task_id: "",
+        original_intent: intent,
+        sub_tasks: subTasks,
+        execution_order: order,
+        parallel_groups: parallelGroups,
+        summary: `按 "${procedure.name}" 流程拆解为 ${subTasks.length} 个阶段`,
+        current_step_index: 0,
+    };
+}
+/**
+ * 从 pipeline_procedure 知识条目的 Markdown body 中提取步骤定义。
+ * 识别 "### 第X步" 或 "### 步骤X" 格式的标题，提取：
+ * - 标题
+ * - 描述（标题下的文字）
+ * - 模板引用（"模板：XXX" 或 "template: XXX"）
+ * - 输出路径（"产出保存到：XXX" 或 "output: XXX"）
+ * - 工具建议（"使用 XXX 工具" 或 "tools: XXX"）
+ */
+function parsePipelineSteps(body) {
+    const steps = [];
+    const sections = body.split(/^### /m).slice(1);
+    for (const section of sections) {
+        const lines = section.split("\n");
+        const title = lines[0].replace(/^第\d+[步阶段][:：]\s*/, "").replace(/^步骤\d+[:：]\s*/, "").trim();
+        if (!title)
+            continue;
+        const description = [];
+        let templateName;
+        let outputPath;
+        const tools = [];
+        for (const line of lines.slice(1)) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith("#"))
+                continue;
+            // 匹配模板引用
+            const templateMatch = trimmed.match(/(?:模板|template)[：:]\s*(.+)/i);
+            if (templateMatch) {
+                templateName = templateMatch[1].trim();
+                continue;
+            }
+            // 匹配输出路径
+            const outputMatch = trimmed.match(/(?:产出保存到|输出到|output)[：:]\s*(.+)/i);
+            if (outputMatch) {
+                outputPath = outputMatch[1].trim();
+                continue;
+            }
+            // 匹配工具建议
+            const toolsMatch = trimmed.match(/(?:使用|工具|tools)[：:]\s*(.+)/i);
+            if (toolsMatch) {
+                tools.push(...toolsMatch[1].split(/[,，、]/).map((t) => t.trim()).filter(Boolean));
+                continue;
+            }
+            description.push(trimmed);
+        }
+        steps.push({
+            title,
+            description: description.join("\n"),
+            template_name: templateName,
+            output_path: outputPath,
+            tools: tools.length > 0 ? tools : undefined,
+        });
+    }
+    return steps;
+}
+/**
+ * 判断是否需要拆解任务。
+ * 新逻辑: route_decision.execution_shape === "multi_stage_plan" 时才允许生成完整多阶段计划。
+ * 兼容: 无 route_decision 时回退到旧 complexity + strategy 判断。
+ * single_artifact 即使命中 pipeline_procedure 也只作为阶段模板/知识注入。
+ */
+function shouldPlan(classification) {
+    const routeDecision = classification.route_decision;
+    if (routeDecision?.execution_shape) {
+        return routeDecision.execution_shape === "multi_stage_plan";
+    }
+    return classification.complexity === "high" && classification.strategy === "full_pipeline";
+}
+/**
+ * 按仓库边界拆分任务: 每个受影响仓库生成一个子任务。
+ * 前端依赖后端时自动添加 depends_on 关系。
+ * @param intent - 用户意图
+ * @param classification - 分类结果
+ * @param config - 项目配置
+ * @returns 子任务数组，单仓库时返回空数组
+ */
+function splitByRepoBoundary(intent, classification, _config) {
+    const repos = classification.affected_repos;
+    if (repos.length <= 1)
+        return [];
+    const tasks = [];
+    let idx = 1;
+    for (const repo of repos) {
+        const repoLabel = repo === "backend" ? "后端" : repo === "frontend" ? "前端" : repo;
+        const repoIntent = buildRepoIntent(intent, repo, repos);
+        tasks.push({
+            id: `st-${idx++}`,
+            title: `${repoLabel}: ${repoIntent}`,
+            description: `${intent} 的 ${repoLabel} 部分`,
+            intent: repoIntent,
+            depends_on: repo === "frontend" && repos.includes("backend") ? ["st-1"] : [],
+            affected_repos: [repo],
+            estimated_complexity: inferComplexity(repoIntent),
+        });
+    }
+    return tasks;
+}
+/**
+ * 为特定仓库生成意图描述: 将"前后端/联调/全链路"等跨域词替换为仓库视角的描述。
+ * @param intent - 原始意图
+ * @param repo - 目标仓库名称
+ * @param allRepos - 所有受影响的仓库
+ * @returns 仓库视角的意图描述
+ */
+function buildRepoIntent(intent, repo, allRepos) {
+    if (repo === "backend" && allRepos.includes("frontend")) {
+        return intent.replace(/前后端|联调|全链路/g, "后端接口");
+    }
+    if (repo === "frontend" && allRepos.includes("backend")) {
+        return intent.replace(/前后端|联调|全链路/g, "前端对接");
+    }
+    return intent;
+}
+/**
+ * 将 procedure 知识名称作为参考提示合并到子任务描述中。
+ * @param tasks - 子任务列表（原地修改）
+ * @param procedureNames - procedure 知识名称列表
+ */
+function mergeProcedureHints(tasks, procedureNames) {
+    if (tasks.length === 0)
+        return;
+    const hint = `参考流程: ${procedureNames.join(", ")}`;
+    for (const task of tasks) {
+        task.description += `\n${hint}`;
+    }
+}
+/**
+ * 基于依赖关系构建执行顺序和并行分组。
+ * 使用拓扑排序确定执行顺序，无依赖或依赖已满足的任务归入同一并行组。
+ * @param subTasks - 子任务列表
+ * @param _affectedRepos - 受影响仓库（预留参数）
+ * @returns 拓扑排序后的执行顺序和并行分组
+ */
+function buildExecutionOrder(subTasks, _affectedRepos) {
+    const visited = new Set();
+    const visiting = new Set();
+    const order = [];
+    const taskMap = new Map(subTasks.map((t) => [t.id, t]));
+    function visit(id) {
+        if (visited.has(id))
+            return;
+        if (visiting.has(id))
+            return; // 检测到循环依赖 — 跳过该边避免死循环
+        visiting.add(id);
+        const task = taskMap.get(id);
+        if (task) {
+            for (const dep of task.depends_on)
+                visit(dep);
+        }
+        visiting.delete(id);
+        visited.add(id);
+        order.push(id);
+    }
+    for (const task of subTasks)
+        visit(task.id);
+    const parallelGroups = [];
+    const scheduled = new Set();
+    for (const id of order) {
+        const task = taskMap.get(id);
+        if (!task)
+            continue;
+        const depsReady = task.depends_on.every((d) => scheduled.has(d));
+        if (depsReady) {
+            const lastGroup = parallelGroups[parallelGroups.length - 1];
+            // 任务可加入最后一个并行组的条件: 无依赖 或 所有依赖均不在最后一个并行组中
+            // （即依赖已在更早阶段完成）。这使得 B(依赖A) 和 C(依赖A) 可在 A 完成后并行执行。
+            const hasNoDeps = task.depends_on.length === 0;
+            const noDepsInLastGroup = lastGroup ? !task.depends_on.some((d) => lastGroup.includes(d)) : true;
+            const canParallel = lastGroup && (hasNoDeps || noDepsInLastGroup);
+            if (canParallel) {
+                lastGroup.push(id);
+            }
+            else {
+                parallelGroups.push([id]);
+            }
+            scheduled.add(id);
+        }
+    }
+    return { order, parallelGroups };
+}
+/**
+ * 从意图文本中提取关键词，用于知识库查询。
+ * @param intent - 意图文本
+ * @returns 关键词数组（过滤长度不足 2 的词）
+ */
+function extractKeywords(intent) {
+    return intent
+        .split(/[\s,，、：:]+/)
+        .filter((w) => w.length >= 2);
+}
+/**
+ * 基于意图关键词推断子任务复杂度。
+ * @param intent - 意图文本
+ * @returns 复杂度: "low" / "medium" / "high"
+ */
+function inferComplexity(intent) {
+    if (/加.*查询|改.*名称|修.*typo/.test(intent))
+        return "low";
+    if (/多个|批量|跨|联调|前后端|全链路/.test(intent))
+        return "high";
+    return "medium";
+}
+//# sourceMappingURL=task_planner.js.map

package/dist/engine/pipeline/task_planner.js.map

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

package/dist/engine/pipeline/task_stage_detector.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 任务阶段检测器 — 问题六十五。
+ *
+ * 将 TaskContext 的内部状态映射到面向用户的丰富任务阶段模型。
+ * 不只看 status 字段，综合 classification、expansion、execution、verification
+ * 等子数据的存在性和状态。
+ *
+ * 新版阶段体系（8 个中文值）：
+ *   需求分析 → 现有系统分析 → 架构设计 → 详细设计 → 任务规划 → 编码与单元测试 → 代码审查 → 联调验证
+ * 其中"现有系统分析"仅对老系统管线激活。
+ */
+import type { TaskContext } from "../../types/index.js";
+import type { TaskStage, StageExplanation } from "../workflow/workflow_navigation_contract.js";
+/**
+ * 检测任务当前所处阶段。
+ * 综合 TaskContext 的 status、子数据存在性和内容判断。
+ *
+ * 返回 8 个中文 TaskStage 值之一。
+ */
+export declare function detectTaskStage(ctx: TaskContext): TaskStage;
+/**
+ * 获取任务阶段的中文解释。
+ */
+export declare function explainTaskStage(stage: TaskStage): StageExplanation;
+//# sourceMappingURL=task_stage_detector.d.ts.map

package/dist/engine/pipeline/task_stage_detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task_stage_detector.d.ts","sourceRoot":"","sources":["../../../src/engine/pipeline/task_stage_detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAE/F;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,SAAS,CAsE3D;AAmED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,gBAAgB,CASnE"}

package/dist/engine/pipeline/task_stage_detector.js

@@ -0,0 +1,160 @@
+/**
+ * 任务阶段检测器 — 问题六十五。
+ *
+ * 将 TaskContext 的内部状态映射到面向用户的丰富任务阶段模型。
+ * 不只看 status 字段，综合 classification、expansion、execution、verification
+ * 等子数据的存在性和状态。
+ *
+ * 新版阶段体系（8 个中文值）：
+ *   需求分析 → 现有系统分析 → 架构设计 → 详细设计 → 任务规划 → 编码与单元测试 → 代码审查 → 联调验证
+ * 其中"现有系统分析"仅对老系统管线激活。
+ */
+/**
+ * 检测任务当前所处阶段。
+ * 综合 TaskContext 的 status、子数据存在性和内容判断。
+ *
+ * 返回 8 个中文 TaskStage 值之一。
+ */
+export function detectTaskStage(ctx) {
+    const status = ctx.status;
+    // 已完成 → 联调验证（项目级交付概念已移除，任务完成即归入联调验证）
+    if (status === "done") {
+        return "联调验证";
+    }
+    // 已失败 → 按历史数据推断最近阶段
+    if (status === "failed") {
+        return detectTaskStageFromHistory(ctx);
+    }
+    // classifying → 需求分析（输入材料收集与需求明确化合并）
+    if (status === "classifying") {
+        return "需求分析";
+    }
+    // expanding / clarifying → 设计阶段细分
+    if (status === "expanding" || status === "clarifying") {
+        if (ctx.design_artifact_pack) {
+            const packStatus = ctx.design_artifact_pack.status;
+            // 设计产物包等待决策 → 现有系统分析（老系统管线）
+            if (packStatus === "awaiting_decisions") {
+                return "现有系统分析";
+            }
+            return "架构设计";
+        }
+        // 老系统管线且无设计产物包 → 现有系统分析
+        const systemType = ctx.route_decision?.system_type ?? ctx.classification?.route_decision?.system_type;
+        if (systemType === "老系统") {
+            return "现有系统分析";
+        }
+        if (ctx.classification?.route_decision?.route === "artifact_generation") {
+            return "架构设计";
+        }
+        return "需求分析";
+    }
+    // executing / retrying → 编码与单元测试
+    if (status === "executing" || status === "retrying") {
+        return "编码与单元测试";
+    }
+    // verifying → 编码与单元测试（修复重验合并到编码阶段）或联调验证
+    if (status === "verifying") {
+        if (ctx.phase_directive === "回退") {
+            return "编码与单元测试";
+        }
+        return "联调验证";
+    }
+    // reworking → 回到设计或编码阶段
+    if (status === "reworking") {
+        if (ctx.design_artifact_pack && ctx.design_artifact_pack.status !== "implementation_ready") {
+            return "架构设计";
+        }
+        return "编码与单元测试";
+    }
+    // learning → 代码审查或联调验证
+    if (status === "learning") {
+        if (ctx.code_review) {
+            return "代码审查";
+        }
+        return "联调验证";
+    }
+    // 兜底
+    return "需求分析";
+}
+/**
+ * 从历史数据推断失败任务的最近阶段。
+ * 映射到 8 个中文 TaskStage 值之一。
+ */
+function detectTaskStageFromHistory(ctx) {
+    if (ctx.code_review)
+        return "代码审查";
+    if (ctx.verification || ctx.verification_result)
+        return "联调验证";
+    if (ctx.execution?.changed_files?.length)
+        return "编码与单元测试";
+    if (ctx.design_artifact_pack)
+        return "架构设计";
+    // 老系统管线检测 → 现有系统分析
+    const systemType = ctx.route_decision?.system_type ?? ctx.classification?.route_decision?.system_type;
+    if (systemType === "老系统" && ctx.expansion)
+        return "现有系统分析";
+    if (ctx.expansion)
+        return "需求分析";
+    if (ctx.classification)
+        return "需求分析";
+    return "需求分析";
+}
+/** 任务阶段中文标签（8 个新版阶段） */
+const TASK_STAGE_LABELS = {
+    "需求分析": "需求分析",
+    "现有系统分析": "现有系统分析",
+    "架构设计": "架构设计",
+    "详细设计": "详细设计",
+    "任务规划": "任务规划",
+    "编码与单元测试": "编码与单元测试",
+    "代码审查": "代码审查",
+    "联调验证": "联调验证",
+};
+/** 任务阶段中文描述（8 个新版阶段） */
+const TASK_STAGE_DESCRIPTIONS = {
+    "需求分析": "正在收集输入材料、明确需求和意图",
+    "现有系统分析": "正在分析现有系统架构与代码，为后续设计提供依据",
+    "架构设计": "正在进行架构设计",
+    "详细设计": "正在进行详细设计",
+    "任务规划": "正在制定开发任务规划",
+    "编码与单元测试": "正在编码实现和单元测试",
+    "代码审查": "正在进行代码审查",
+    "联调验证": "正在进行联调验证",
+};
+/** 任务阶段必要证据（8 个新版阶段） */
+const TASK_STAGE_EVIDENCE = {
+    "需求分析": ["TaskContext.status=classifying 或 classification/expansion 存在"],
+    "现有系统分析": ["existing_system_analysis 存在 或 design_artifact_pack.status=awaiting_decisions"],
+    "架构设计": ["design_artifact_pack 存在 且非 awaiting_decisions"],
+    "详细设计": ["expansion.scope 详细设计完成"],
+    "任务规划": ["planning 存在"],
+    "编码与单元测试": ["TaskContext.status=executing/retrying/verifying(回退)"],
+    "代码审查": ["code_review 存在"],
+    "联调验证": ["TaskContext.status=verifying 或 status=done"],
+};
+/** 任务阶段可能的下一阶段（8 个新版阶段） */
+const TASK_STAGE_NEXT = {
+    "需求分析": ["现有系统分析", "架构设计"],
+    "现有系统分析": ["架构设计"],
+    "架构设计": ["详细设计"],
+    "详细设计": ["任务规划"],
+    "任务规划": ["编码与单元测试"],
+    "编码与单元测试": ["代码审查", "联调验证"],
+    "代码审查": ["编码与单元测试", "联调验证"],
+    "联调验证": [],
+};
+/**
+ * 获取任务阶段的中文解释。
+ */
+export function explainTaskStage(stage) {
+    return {
+        stage,
+        level: "task",
+        label_zh: TASK_STAGE_LABELS[stage],
+        description_zh: TASK_STAGE_DESCRIPTIONS[stage],
+        required_evidence: TASK_STAGE_EVIDENCE[stage],
+        next_possible_stages: TASK_STAGE_NEXT[stage],
+    };
+}
+//# sourceMappingURL=task_stage_detector.js.map

package/dist/engine/pipeline/task_stage_detector.js.map

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

package/dist/engine/pipeline/workspace_lease.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @deprecated [DC-3] 无运行时消费方。保留供未来工作区隔离实现。
+ *
+ * 工作区隔离 — 问题二十八 (Workspace Isolation / Concurrency Contract)。
+ *
+ * 核心规则:
+ * - 同 scope code_write 冲突必须 blocked 或 require_human
+ * - delivery 必须互斥
+ * - lease active/conflicted 不得交付
+ * - out-of-scope write 必须 blocked
+ */
+import { type DiagnosticEvent } from "../audit/diagnostic_registry.js";
+export type LeaseType = "code_write" | "delivery" | "output_artifact";
+export type LeaseStatus = "active" | "released" | "expired" | "conflicted";
+export interface WorkspaceLease {
+    lease_id: string;
+    task_id: string;
+    lease_type: LeaseType;
+    scope_paths: string[];
+    status: LeaseStatus;
+    acquired_at: string;
+    expires_at?: string;
+    diagnostic_event: DiagnosticEvent | null;
+}
+export interface WorkspaceIsolationReport {
+    report_id: string;
+    task_id: string;
+    active_leases: WorkspaceLease[];
+    conflicts: LeaseConflict[];
+    out_of_scope_writes: Array<{
+        path: string;
+        allowed_paths: string[];
+    }>;
+    delivery_blocked: boolean;
+    evaluated_at: string;
+}
+export interface LeaseConflict {
+    lease_a_id: string;
+    lease_b_id: string;
+    conflict_path: string;
+    conflict_type: "scope_overlap" | "delivery_overlap";
+    resolved: boolean;
+}
+/**
+ * 清理状态为 released 且超过 1 小时的过期条目。
+ * 在 acquireLease 时调用，保持存储清洁。
+ * @returns 清理的条目数量
+ */
+export declare function purgeExpiredLeases(): number;
+/** 获取 lease */
+export declare function getLease(leaseId: string): WorkspaceLease | undefined;
+/** 列出所有活跃 lease */
+export declare function listActiveLeases(): WorkspaceLease[];
+/**
+ * 尝试获取 lease。
+ * 如果同 scope 有冲突，返回冲突信息。
+ */
+export declare function acquireLease(taskId: string, leaseType: LeaseType, scopePaths: string[]): {
+    lease: WorkspaceLease | null;
+    conflicts: LeaseConflict[];
+    purged: number;
+};
+/** 释放 lease */
+export declare function releaseLease(leaseId: string): boolean;
+/**
+ * 检查是否超出 scope 写入。
+ */
+export declare function checkOutOfScopeWrite(_taskId: string, targetPath: string, allowedPaths: string[]): {
+    allowed: boolean;
+    reason?: string;
+};
+/**
+ * 生成工作区隔离报告。
+ */
+export declare function generateIsolationReport(taskId: string): WorkspaceIsolationReport;
+/** 重置 lease 存储（测试用） */
+export declare function resetLeaseStore(): void;
+//# sourceMappingURL=workspace_lease.d.ts.map

package/dist/engine/pipeline/workspace_lease.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace_lease.d.ts","sourceRoot":"","sources":["../../../src/engine/pipeline/workspace_lease.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAG9F,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,UAAU,GAAG,iBAAiB,CAAC;AACtE,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,CAAC;AAE3E,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,SAAS,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,eAAe,GAAG,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,cAAc,EAAE,CAAC;IAChC,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,mBAAmB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACtE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,eAAe,GAAG,kBAAkB,CAAC;IACpD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAQD;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAa3C;AAED,eAAe;AACf,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEpE;AAED,mBAAmB;AACnB,wBAAgB,gBAAgB,IAAI,cAAc,EAAE,CAEnD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,MAAM,EAAE,GACnB;IAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IAAC,SAAS,EAAE,aAAa,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAwE9E;AAED,eAAe;AACf,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAUrD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EAAE,GACrB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CASvC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,wBAAwB,CAyChF;AAED,uBAAuB;AACvB,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}