soloforge 1.1.2 → 1.1.30

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

@@ -0,0 +1,92 @@
+/**
+ * Diff Ownership Store — 持久化文件归属快照，绑定 stateDir。
+ * CAP-011 实验性: 只做 advisory 冲突报告，不 hard block。
+ *
+ * 存储: JSON 文件，原子写入，路径绑定 stateDir。
+ * 每个 task_id 下的快照按时间顺序追加。
+ */
+import { type FileSnapshot, type CasCheckResult, type DiffOwnership } from "./diff_ownership.js";
+export interface ConflictReport {
+    file_path: string;
+    expected_hash: string | null;
+    current_hash: string | null;
+    inferred_ownership: DiffOwnership;
+    severity: "advisory";
+    message: string;
+}
+export interface ScopeBaselineResult {
+    snapshots: FileSnapshot[];
+    advisory_summary: string | null;
+    total_files_found: number;
+    files_excluded: number;
+    files_captured: number;
+    exceeded_limit: boolean;
+}
+export interface TaskSnapshotState {
+    task_id: string;
+    baseline_captured_at: string | null;
+    snapshots: FileSnapshot[];
+}
+export declare class DiffOwnershipStore {
+    private filePath;
+    private states;
+    private loaded;
+    constructor(stateDir: string);
+    private ensureLoaded;
+    private persist;
+    /**
+     * 为任务捕获基线快照。在任务开始执行时调用一次。
+     *
+     * @param taskId - 任务 ID
+     * @param filePaths - 待捕获的文件路径列表
+     * @returns 文件快照数组
+     */
+    captureBaseline(taskId: string, filePaths: string[]): FileSnapshot[];
+    /**
+     * 从作用域路径捕获基线，将目录展开为其包含的文件。
+     * 应用排除规则和大小限制。超出限制时返回建议性摘要。
+     * 不做硬性阻止 — 调用方收到摘要后自行决定。
+     */
+    captureBaselineFromScope(taskId: string, scopePaths: string[], options?: {
+        maxFiles?: number;
+        maxTotalBytes?: number;
+    }): ScopeBaselineResult;
+    /**
+     * 记录任务对文件的写入。
+     *
+     * @param taskId - 任务 ID
+     * @param filePath - 写入的文件路径
+     * @returns 文件快照
+     */
+    recordWrite(taskId: string, filePath: string): FileSnapshot;
+    /**
+     * 写前执行 CAS 检查。检查失败时返回建议性冲突报告。
+     * 不阻止写入 — 调用方自行决定处理方式。
+     */
+    preWriteCheck(taskId: string, filePath: string): {
+        cas: CasCheckResult;
+        conflict: ConflictReport | null;
+    };
+    /**
+     * 获取任务的所有快照。
+     *
+     * @param taskId - 任务 ID
+     * @returns 文件快照数组
+     */
+    getSnapshots(taskId: string): FileSnapshot[];
+    /**
+     * 获取任务的归属摘要。
+     *
+     * @param taskId - 任务 ID
+     * @returns 按归属类型分组的文件计数
+     */
+    getOwnershipSummary(taskId: string): Record<DiffOwnership, number>;
+    /**
+     * 清理已完成/失败任务的状态。
+     *
+     * @param taskId - 任务 ID
+     */
+    clearTask(taskId: string): void;
+    clear(): void;
+}
+//# sourceMappingURL=diff_ownership_store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diff_ownership_store.d.ts","sourceRoot":"","sources":["../../../src/engine/pipeline/diff_ownership_store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAML,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,kBAAkB,EAAE,aAAa,CAAC;IAClC,QAAQ,EAAE,UAAU,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,SAAS,EAAE,YAAY,EAAE,CAAC;CAC3B;AAmCD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAA6C;IAC3D,OAAO,CAAC,MAAM,CAAS;gBAEX,QAAQ,EAAE,MAAM;IAM5B,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,OAAO;IAOf;;;;;;OAMG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE;IAcpE;;;;OAIG;IACH,wBAAwB,CACtB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GACtD,mBAAmB;IA+EtB;;;;;;OAMG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY;IAa3D;;;OAGG;IACH,aAAa,CACX,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf;QAAE,GAAG,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAA;KAAE;IA8B3D;;;;;OAKG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE;IAM5C;;;;;OAKG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC;IAIlE;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAM/B,KAAK,IAAI,IAAI;CAKd"}

package/dist/engine/pipeline/diff_ownership_store.js

@@ -0,0 +1,291 @@
+/**
+ * Diff Ownership Store — 持久化文件归属快照，绑定 stateDir。
+ * CAP-011 实验性: 只做 advisory 冲突报告，不 hard block。
+ *
+ * 存储: JSON 文件，原子写入，路径绑定 stateDir。
+ * 每个 task_id 下的快照按时间顺序追加。
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { debug } from "../core/logger.js";
+import { captureBaseline, recordTaskWrite, casCheck, findLatestSnapshot, summarizeOwnership, } from "./diff_ownership.js";
+const DEFAULT_MAX_FILES = 500;
+const DEFAULT_MAX_TOTAL_BYTES = 50 * 1024 * 1024; // 50MB
+const EXCLUDED_DIRS = new Set([
+    ".git", "node_modules", "dist", "build", "coverage",
+    ".next", ".nuxt", ".cache", ".turbo", "out", "target",
+    "vendor", "__pycache__", ".venv", "venv",
+]);
+const EXCLUDED_EXTENSIONS = new Set([
+    ".map", ".lock", ".woff", ".woff2", ".ttf", ".eot",
+    ".ico", ".png", ".jpg", ".jpeg", ".gif", ".webp", ".svg",
+    ".mp4", ".mp3", ".wav", ".avi", ".mov",
+    ".zip", ".tar", ".gz", ".rar", ".7z",
+    ".wasm", ".exe", ".dll", ".so", ".dylib",
+]);
+const EXCLUDED_FILES = new Set([
+    "package-lock.json", "yarn.lock", "pnpm-lock.yaml",
+    "Gemfile.lock", "composer.lock", "Cargo.lock",
+    "go.sum", "poetry.lock",
+]);
+function isExcluded(filePath) {
+    const basename = path.basename(filePath);
+    if (EXCLUDED_FILES.has(basename))
+        return true;
+    const ext = path.extname(filePath).toLowerCase();
+    if (EXCLUDED_EXTENSIONS.has(ext))
+        return true;
+    // 排除隐藏文件（点文件）
+    if (basename.startsWith("."))
+        return true;
+    return false;
+}
+export class DiffOwnershipStore {
+    filePath;
+    states = new Map();
+    loaded = false;
+    constructor(stateDir) {
+        this.filePath = path.join(stateDir, "diff-ownership.json");
+        if (!fs.existsSync(stateDir)) {
+        }
+    }
+    ensureLoaded() {
+        if (this.loaded)
+            return;
+        this.loaded = true;
+        try {
+            const data = fs.readFileSync(this.filePath, "utf-8");
+            const entries = JSON.parse(data);
+            for (const e of entries) {
+                this.states.set(e.task_id, e);
+            }
+        }
+        catch (e) {
+            debug("差异所有权存储", "加载状态文件失败(预期行为: 文件不存在) —", e);
+            this.states = new Map();
+        }
+    }
+    persist() {
+        const entries = [...this.states.values()];
+        const tmpPath = `${this.filePath}.tmp`;
+        fs.writeFileSync(tmpPath, JSON.stringify(entries, null, 2));
+        fs.renameSync(tmpPath, this.filePath);
+    }
+    /**
+     * 为任务捕获基线快照。在任务开始执行时调用一次。
+     *
+     * @param taskId - 任务 ID
+     * @param filePaths - 待捕获的文件路径列表
+     * @returns 文件快照数组
+     */
+    captureBaseline(taskId, filePaths) {
+        this.ensureLoaded();
+        const snapshots = captureBaseline(filePaths, taskId);
+        let state = this.states.get(taskId);
+        if (!state) {
+            state = { task_id: taskId, baseline_captured_at: null, snapshots: [] };
+            this.states.set(taskId, state);
+        }
+        state.baseline_captured_at = snapshots[0]?.captured_at ?? new Date().toISOString();
+        state.snapshots.push(...snapshots);
+        this.persist();
+        return snapshots;
+    }
+    /**
+     * 从作用域路径捕获基线，将目录展开为其包含的文件。
+     * 应用排除规则和大小限制。超出限制时返回建议性摘要。
+     * 不做硬性阻止 — 调用方收到摘要后自行决定。
+     */
+    captureBaselineFromScope(taskId, scopePaths, options) {
+        const maxFiles = options?.maxFiles ?? DEFAULT_MAX_FILES;
+        const maxTotalBytes = options?.maxTotalBytes ?? DEFAULT_MAX_TOTAL_BYTES;
+        const allFiles = [];
+        const excluded = [];
+        for (const p of scopePaths) {
+            const resolved = path.resolve(p);
+            let stat = null;
+            try {
+                stat = fs.statSync(resolved);
+            }
+            catch (e) {
+                debug("差异所有权存储", "文件不存在(预期行为) —", resolved);
+            }
+            if (stat?.isDirectory()) {
+                const files = listFilesRecursive(resolved);
+                allFiles.push(...files);
+            }
+            else {
+                allFiles.push(resolved);
+            }
+        }
+        // 应用排除规则
+        const eligible = [];
+        for (const f of allFiles) {
+            if (isExcluded(f)) {
+                excluded.push(f);
+            }
+            else {
+                eligible.push(f);
+            }
+        }
+        // 检查大小限制
+        let totalBytes = 0;
+        const withinLimit = [];
+        let exceededLimit = false;
+        for (const f of eligible) {
+            let fileSize = 0;
+            try {
+                fileSize = fs.statSync(f).size;
+            }
+            catch (e) {
+                debug("差异所有权存储", "文件不存在(预期行为) —", f);
+            }
+            if (withinLimit.length >= maxFiles || totalBytes + fileSize > maxTotalBytes) {
+                exceededLimit = true;
+                debug("归属存储", "基线捕获超出限制，已截断文件列表");
+                break;
+            }
+            totalBytes += fileSize;
+            withinLimit.push(f);
+        }
+        // 保留原始 scopePaths 中不存在的路径（作为新文件占位符）
+        for (const p of scopePaths) {
+            const resolved = path.resolve(p);
+            try {
+                fs.statSync(resolved);
+            }
+            catch (e) {
+                debug("差异所有权存储", "文件不存在(预期行为) —", resolved);
+                if (!withinLimit.includes(resolved)) {
+                    withinLimit.push(resolved);
+                }
+            }
+        }
+        let snapshots = [];
+        if (withinLimit.length > 0) {
+            snapshots = this.captureBaseline(taskId, withinLimit);
+        }
+        const advisorySummary = exceededLimit
+            ? `baseline scope exceeded limits: ${eligible.length} eligible files found, captured ${withinLimit.length} (${maxFiles} files / ${Math.round(maxTotalBytes / 1024 / 1024)}MB limit). ${excluded.length} files excluded by rules.`
+            : excluded.length > 0
+                ? `baseline captured ${withinLimit.length} files, ${excluded.length} excluded by rules`
+                : null;
+        return {
+            snapshots,
+            advisory_summary: advisorySummary,
+            total_files_found: allFiles.length,
+            files_excluded: excluded.length,
+            files_captured: snapshots.length,
+            exceeded_limit: exceededLimit,
+        };
+    }
+    /**
+     * 记录任务对文件的写入。
+     *
+     * @param taskId - 任务 ID
+     * @param filePath - 写入的文件路径
+     * @returns 文件快照
+     */
+    recordWrite(taskId, filePath) {
+        this.ensureLoaded();
+        let state = this.states.get(taskId);
+        if (!state) {
+            state = { task_id: taskId, baseline_captured_at: null, snapshots: [] };
+            this.states.set(taskId, state);
+        }
+        const snap = recordTaskWrite(filePath, taskId);
+        state.snapshots.push(snap);
+        this.persist();
+        return snap;
+    }
+    /**
+     * 写前执行 CAS 检查。检查失败时返回建议性冲突报告。
+     * 不阻止写入 — 调用方自行决定处理方式。
+     */
+    preWriteCheck(taskId, filePath) {
+        this.ensureLoaded();
+        const state = this.states.get(taskId);
+        const snapshots = state?.snapshots ?? [];
+        const latest = findLatestSnapshot(filePath, snapshots);
+        const expectedHash = latest?.content_hash ?? null;
+        const cas = casCheck(filePath, expectedHash, taskId, snapshots);
+        if (!cas.cas_ok) {
+            debug("归属存储", "CAS 冲突检测", filePath, "原因:", cas.conflict_reason);
+        }
+        if (cas.cas_ok) {
+            return { cas, conflict: null };
+        }
+        return {
+            cas,
+            conflict: {
+                file_path: cas.file_path,
+                expected_hash: cas.expected_hash,
+                current_hash: cas.current_hash,
+                inferred_ownership: cas.inferred_ownership,
+                severity: "advisory",
+                message: `建议性: ${cas.conflict_reason}`,
+            },
+        };
+    }
+    /**
+     * 获取任务的所有快照。
+     *
+     * @param taskId - 任务 ID
+     * @returns 文件快照数组
+     */
+    getSnapshots(taskId) {
+        this.ensureLoaded();
+        const state = this.states.get(taskId);
+        return state ? [...state.snapshots] : [];
+    }
+    /**
+     * 获取任务的归属摘要。
+     *
+     * @param taskId - 任务 ID
+     * @returns 按归属类型分组的文件计数
+     */
+    getOwnershipSummary(taskId) {
+        return summarizeOwnership(this.getSnapshots(taskId));
+    }
+    /**
+     * 清理已完成/失败任务的状态。
+     *
+     * @param taskId - 任务 ID
+     */
+    clearTask(taskId) {
+        this.ensureLoaded();
+        this.states.delete(taskId);
+        this.persist();
+    }
+    clear() {
+        this.states.clear();
+        this.loaded = true;
+        this.persist();
+    }
+}
+function listFilesRecursive(dir) {
+    const result = [];
+    function walk(d) {
+        let entries;
+        try {
+            entries = fs.readdirSync(d, { withFileTypes: true });
+        }
+        catch (e) {
+            debug("差异所有权存储", "读取目录失败(预期行为: 目录不存在) —", d);
+            return;
+        }
+        for (const e of entries) {
+            if (e.isDirectory()) {
+                if (!EXCLUDED_DIRS.has(e.name) && !e.name.startsWith(".")) {
+                    walk(path.join(d, e.name));
+                }
+            }
+            else if (e.isFile()) {
+                result.push(path.join(d, e.name));
+            }
+        }
+    }
+    walk(dir);
+    return result;
+}
+//# sourceMappingURL=diff_ownership_store.js.map

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

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

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

@@ -0,0 +1,121 @@
+import type { ClassifyResult, ExpandResult, ProjectConfig } from "../../types/index.js";
+import type { KnowledgeIndexManager } from "../../knowledge/index_manager.js";
+import type { IntentRouteDecision } from "./intent_router.js";
+import type { InputMaterial, IngestionEvidence, PromptInjectionPlan } from "./input_material_contract_registry.js";
+import type { OutputArtifact } from "../contracts/artifact_contract_registry.js";
+import type { DataSensitivityLabel, RedactionRecord, PrivacyGovernanceFinding } from "../audit/privacy_secret_contract.js";
+/**
+ * sf_expand pipeline — 将上帝函数拆分为可独立测试的阶段。
+ *
+ * 每个阶段接收共享上下文，返回可能修改后的上下文 + 可选的 early-stop。
+ * expand() 仍然是编排入口，但逐步迁出逻辑到独立 stage 函数中。
+ */
+export interface ExpandPipelineContext {
+    intent: string;
+    classification: ClassifyResult;
+    projectPath: string;
+    config: ProjectConfig;
+    knowledgeIndex: KnowledgeIndexManager;
+    routeDecision?: IntentRouteDecision;
+    task_id?: string;
+    safeIntent?: string;
+    safeGoal?: string;
+    phasePolicy?: ExpandRoutePhasePolicy;
+    outputArtifactRecord?: OutputArtifact;
+    inputMaterials?: InputMaterial[];
+    ingestionEvidences?: IngestionEvidence[];
+    promptInjectionPlan?: PromptInjectionPlan;
+    privacyLabels?: DataSensitivityLabel[];
+    privacyRedactions?: RedactionRecord[];
+    privacyFindings?: PrivacyGovernanceFinding[];
+    workflowContract?: any;
+    workflowGovernanceFindings?: Array<{
+        severity: string;
+        rule: string;
+        message: string;
+    }>;
+}
+export interface ExpandPipelineStageResult {
+    context: ExpandPipelineContext;
+    stop?: ExpandResult;
+}
+export interface ExpandPipelineStage {
+    name: string;
+    run(context: ExpandPipelineContext): Promise<ExpandPipelineStageResult> | ExpandPipelineStageResult;
+}
+export interface ExpandPipelineResult {
+    context: ExpandPipelineContext;
+    stopped_by?: string;
+    stop?: ExpandResult;
+}
+export interface ExpandRoutePhasePolicy {
+    route?: string;
+    execution_shape?: string;
+    mutation_allowed: boolean;
+    lightweight: boolean;
+    read_only_verification: boolean;
+    skip_workflow_contract_strict: boolean;
+    skip_input_material_hard_block: boolean;
+    skip_project_knowledge_hard_block: boolean;
+    skip_heavy_contract_gates: boolean;
+    skip_pre_implementation_gates: boolean;
+}
+export declare function createExpandPipeline(stages: ExpandPipelineStage[]): ExpandPipelineStage;
+export declare function runExpandPipeline(context: ExpandPipelineContext, stages: ExpandPipelineStage[]): Promise<ExpandPipelineResult>;
+export declare function createExpandRoutePhasePolicy(routeDecision: IntentRouteDecision | undefined): ExpandRoutePhasePolicy;
+export interface PrivacyGateOutput {
+    safeIntent: string;
+    safeGoal: string;
+    privacyLabels: DataSensitivityLabel[];
+    privacyRedactions: RedactionRecord[];
+    privacyFindings: PrivacyGovernanceFinding[];
+    hardFail: boolean;
+    blockedSources: string[];
+}
+export declare function computePrivacyGate(deps: {
+    intent: string;
+    routeDecision?: IntentRouteDecision;
+    inputMaterials?: Array<{
+        path?: string;
+    }>;
+    phasePolicy: ExpandRoutePhasePolicy;
+    evaluatePrivacyGate: (input: {
+        intent: string;
+        input_materials: Array<{
+            path_or_ref: string;
+        }>;
+    }) => {
+        labels: DataSensitivityLabel[];
+        redaction_records: RedactionRecord[];
+        findings: PrivacyGovernanceFinding[];
+        blocked_sources: string[];
+        hard_fail: boolean;
+        redacted_text?: string;
+    };
+    redactSensitiveText: (text: string, label: string) => {
+        redacted: string;
+    };
+}): PrivacyGateOutput;
+export interface InputMaterialValidationResult {
+    blocked: boolean;
+    blockReason?: string;
+    forbiddenPaths?: string[];
+    confirmationNeeded?: string[];
+    inputMaterials: InputMaterial[];
+    ingestionEvidences: IngestionEvidence[];
+    promptInjectionPlan?: PromptInjectionPlan;
+    contractNotes: string[];
+}
+export declare function validateInputMaterials(deps: {
+    routeDecision?: IntentRouteDecision;
+    skipInputMaterialHardBlock: boolean;
+    confirmations?: string[];
+    createInputMaterial: (input: {
+        path_or_ref: string;
+    }) => InputMaterial;
+    createIngestionEvidence: (m: InputMaterial) => IngestionEvidence;
+    buildPromptInjectionPlan: (materials: InputMaterial[], evidences: IngestionEvidence[]) => PromptInjectionPlan;
+    normalizePathCandidate: (p: string) => string;
+    classifyIngestionStatus: (path: string) => string;
+}): InputMaterialValidationResult;
+//# sourceMappingURL=expand_pipeline.d.ts.map

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

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

package/dist/engine/pipeline/expand_pipeline.js

@@ -0,0 +1,141 @@
+// ── Pipeline 编排器 ──
+export function createExpandPipeline(stages) {
+    return {
+        name: "sf_expand_pipeline",
+        async run(initialContext) {
+            let context = initialContext;
+            for (const stage of stages) {
+                const result = await stage.run(context);
+                context = result.context;
+                if (result.stop) {
+                    return { context, stop: result.stop };
+                }
+            }
+            return { context };
+        },
+    };
+}
+export function runExpandPipeline(context, stages) {
+    return (async () => {
+        let current = context;
+        for (const stage of stages) {
+            const result = await stage.run(current);
+            current = result.context;
+            if (result.stop) {
+                return { context: current, stopped_by: stage.name, stop: result.stop };
+            }
+        }
+        return { context: current };
+    })();
+}
+// ── 路由策略计算（纯函数，可独立测试）──
+export function createExpandRoutePhasePolicy(routeDecision) {
+    const route = routeDecision?.route;
+    const executionShape = routeDecision?.execution_shape;
+    const mutationAllowed = routeDecision?.mutation_allowed === true;
+    const readOnlyVerification = route === "acceptance"
+        || route === "review"
+        || (route === "analysis" && executionShape === "read_only_analysis")
+        || (route === "operation" && (executionShape === "verification_only" || executionShape === "read_only_analysis"));
+    const lightweight = !mutationAllowed
+        && (readOnlyVerification
+            || executionShape === "read_only_analysis"
+            || executionShape === "verification_only"
+            || route === "direct_answer");
+    return {
+        route,
+        execution_shape: executionShape,
+        mutation_allowed: mutationAllowed,
+        lightweight,
+        read_only_verification: readOnlyVerification,
+        skip_workflow_contract_strict: lightweight,
+        skip_input_material_hard_block: lightweight,
+        skip_project_knowledge_hard_block: lightweight,
+        skip_heavy_contract_gates: lightweight,
+        skip_pre_implementation_gates: lightweight,
+    };
+}
+export function computePrivacyGate(deps) {
+    if (deps.phasePolicy.lightweight) {
+        return {
+            safeIntent: deps.redactSensitiveText(deps.intent, "intent").redacted,
+            safeGoal: deps.redactSensitiveText(deps.intent.slice(0, 200), "intent_goal").redacted,
+            privacyLabels: [],
+            privacyRedactions: [],
+            privacyFindings: [],
+            hardFail: false,
+            blockedSources: [],
+        };
+    }
+    const gate = deps.evaluatePrivacyGate({
+        intent: deps.intent,
+        input_materials: deps.routeDecision?.input_materials?.map((m) => ({ path_or_ref: m.path ?? "" })) ?? [],
+    });
+    return {
+        safeIntent: gate.redacted_text ?? deps.redactSensitiveText(deps.intent, "intent").redacted,
+        safeGoal: deps.redactSensitiveText(deps.intent.slice(0, 200), "intent_goal").redacted,
+        privacyLabels: gate.labels,
+        privacyRedactions: gate.redaction_records,
+        privacyFindings: gate.findings,
+        hardFail: gate.hard_fail,
+        blockedSources: gate.blocked_sources,
+    };
+}
+export function validateInputMaterials(deps) {
+    const { routeDecision, skipInputMaterialHardBlock, confirmations = [] } = deps;
+    const contractNotes = [];
+    if (!routeDecision || routeDecision.input_materials.length === 0) {
+        return { blocked: false, inputMaterials: [], ingestionEvidences: [], contractNotes };
+    }
+    const pathMaterials = routeDecision.input_materials.filter((m) => m.path);
+    if (pathMaterials.length === 0) {
+        return { blocked: false, inputMaterials: [], ingestionEvidences: [], contractNotes };
+    }
+    const materials = pathMaterials.map((m) => deps.createInputMaterial({ path_or_ref: deps.normalizePathCandidate(m.path) }));
+    const evidences = materials.map((m) => deps.createIngestionEvidence(m));
+    for (const m of materials) {
+        if (m.access_mode === "forbidden") {
+            contractNotes.push(`[FORBIDDEN] ${m.path_or_ref}: 禁止读取`);
+        }
+        else if (m.trust_level === "external_unverified" || m.trust_level === "derived" || m.trust_level === "ai_generated") {
+            contractNotes.push(`[Manual Confirm] ${m.path_or_ref}: 信任等级=${m.trust_level}`);
+        }
+    }
+    const injectionPlan = deps.buildPromptInjectionPlan(materials, evidences);
+    // 禁止路径检查
+    const forbiddenMaterials = materials.filter((m) => m.access_mode === "forbidden");
+    if (!skipInputMaterialHardBlock && forbiddenMaterials.length > 0) {
+        return {
+            blocked: true,
+            blockReason: "输入材料包含禁止路径",
+            forbiddenPaths: forbiddenMaterials.map((m) => m.path_or_ref),
+            inputMaterials: materials,
+            ingestionEvidences: evidences,
+            promptInjectionPlan: injectionPlan,
+            contractNotes,
+        };
+    }
+    // 需确认路径检查
+    const needsConfirmation = materials.filter((m) => m.access_mode !== "forbidden"
+        && deps.classifyIngestionStatus(m.path_or_ref) === "requires_confirmation"
+        && !confirmations.includes(m.path_or_ref));
+    if (needsConfirmation.length > 0) {
+        return {
+            blocked: true,
+            blockReason: "输入材料需要确认",
+            confirmationNeeded: needsConfirmation.map((m) => m.path_or_ref),
+            inputMaterials: materials,
+            ingestionEvidences: evidences,
+            promptInjectionPlan: injectionPlan,
+            contractNotes,
+        };
+    }
+    return {
+        blocked: false,
+        inputMaterials: materials,
+        ingestionEvidences: evidences,
+        promptInjectionPlan: injectionPlan,
+        contractNotes,
+    };
+}
+//# sourceMappingURL=expand_pipeline.js.map