soloforge 1.1.42 → 1.1.44

package/dist/types/pipeline_types.d.ts

@@ -0,0 +1,925 @@
+/**
+ * Pipeline Types — 任务上下文类型定义（从 src/types/task.ts 迁移至此）。
+ *
+ * 迁移原因：TaskContext 是管线（Pipeline）的状态容器，聚合下游模型（gate/verify/context/shared）
+ * 的产物类型。将其放在游离的 types/ 目录会形成"types/ → gate/"的反向依赖，违反业务模型分块原则。
+ * TaskContext 归属 pipeline 后，跨模型 import 成为合法的编排者依赖。
+ *
+ * 职责边界：
+ * - 负责：TaskContext、DesignArtifactPack 系列、ClassifyResult 等管线状态类型
+ * - 不负责：下游模型自身的类型（如 gate 的 CertaintyGateResult、verify 的 VerificationResult）
+ *
+ * 被谁调用：pipeline 内部模块、verify/audit（语义证据读取任务上下文）
+ * 调用谁：base、execution、phase、pipeline（types/）、analysis、review、delivery、gate/verify/shared 产物契约
+ *
+ * 数据流：类型定义 → 供其他模块引用
+ * 持久化：无持久化（纯计算/内存态）
+ */
+import type { Risk, Complexity, Ambiguity, TaskType, FailureType } from "../shared/types.js";
+import type { ExecutionTier, ExecutionContract, EvidenceItem, CoverageMatrix, RepairLoopState, PlanResult, CodeReviewResult } from "../verify/types.js";
+import type { DeliveryResult } from "../gate/types.js";
+import type { KnowledgeInjectionReport } from "../context/types/knowledge.js";
+import type { PrivacyGovernanceFinding } from "../gate/privacy/index.js";
+import type { ArchitectureDesignContract } from "../shared/contracts/extension_platform_contracts.js";
+import type { IntegrationFinding } from "../verify/audit/main_path_integration_contract.js";
+import type { CorePrinciplesReport } from "../verify/audit/core_engineering_principles.js";
+import type { CommandContract } from "../gate/contracts/command_execution_contract.js";
+import type { OutputArtifact } from "../domain/contracts/artifact_contract_registry.js";
+import type { DataSensitivityLabel, RedactionRecord } from "../gate/privacy/index.js";
+import type { VerificationPlan } from "../verify/contracts/verification_contract.js";
+import type { FailureReport } from "../verify/audit/failure_report.js";
+import type { DegradationEvent } from "../verify/audit/degradation.js";
+import type { DomainName, PendingReturn, AuditEntry } from "../core/types.js";
+type MaterialKind = "project_file" | "external_file" | "archive" | "directory" | "document" | "log" | "image" | "figma" | "api_spec" | "db_schema" | "url" | "clipboard" | "user_text";
+type AccessMode = "read_only" | "read_write" | "forbidden";
+type TrustLevel = "authoritative" | "user_provided" | "project_context" | "external_unverified" | "ai_generated" | "derived";
+type ScopeRole = "input_only" | "project_scope" | "output_target" | "evidence_ref" | "manual_reference";
+type IngestionEvidenceStatus = "pending" | "metadata_read" | "read" | "failed" | "forbidden";
+interface InputMaterial {
+    id: string;
+    kind: MaterialKind;
+    path_or_ref: string;
+    access_mode: AccessMode;
+    trust_level: TrustLevel;
+    scope_role: ScopeRole;
+    hash?: string;
+    extracted_to?: string;
+    cleanup_required: boolean;
+    created_at?: string;
+    size_bytes?: number;
+}
+interface IngestionEvidence {
+    evidence_id: string;
+    material_id: string;
+    source_ref: string;
+    status: IngestionEvidenceStatus;
+    hash?: string;
+    size_bytes?: number;
+    detected_kind: string;
+    trust_level: TrustLevel;
+    access_mode: AccessMode;
+    extracted_to?: string;
+    parsed_artifacts: string[];
+    warnings: string[];
+    created_at: string;
+}
+interface PromptInjectionPlan {
+    required_summary: string[];
+    evidence_refs: string[];
+    selected_excerpts: string[];
+    forbidden_notes: string[];
+    manual_confirm_list: string[];
+    allowed_sources: string[];
+    forbidden_sources: string[];
+}
+import type { BrainstormSession, DetailDisciplineContract, FinalLocalReviewAccess, FirstPrinciplesFrame, TechnologyDecisionContract, TechnologyDecisionRecord } from "../shared/contracts/extension_platform_contracts.js";
+import type { PlanProposalEvidence, PlanProposalGateResult, UserConfirmationRef, VerificationPlanRef } from "../gate/plan_proposal_gate.js";
+import type { CoreExperiencePrincipleEvaluation } from "../verify/audit/core_experience_principle.js";
+import type { EvidenceConflict, EvidenceGateResult, EvidenceMatrix } from "../verify/contracts/evidence_grounding_contract.js";
+import type { ArchitectureDecisionWorkshopContract } from "../verify/contracts/architecture_decision_workshop.js";
+import type { DecisionWorkshopContract } from "../verify/contracts/decision_workshop.js";
+import type { OodDesignSummary, SolidReviewFinding } from "../verify/contracts/ood_solid_contract.js";
+import type { BackendImplementationFinding, BackendImplementationWorkPackage } from "../verify/contracts/backend_implementation_contract.js";
+import type { CodeObservabilityFinding, CodeObservabilityWorkPackage } from "../verify/contracts/code_maintainability_observability_contract.js";
+import type { InstructionContract } from "../verify/contracts/instruction_contract.js";
+import type { ReadinessEvaluationResult } from "../gate/contracts/coding_readiness_gate.js";
+/**
+ * 设计产物包状态。
+ * 仅保留生产端实际产出 + 消费端实际读取的值；删除三个死值（零产出零消费）：
+ *   - needs_revalidation：原"可冻字段"，派生引擎取代后无生产/消费方（凝固卡点结构性消除）
+ *   - awaiting_upgrade_confirmation：全 src/ 零消费方
+ *   - blocked（作为本枚举）：全 src/ 零消费方（"blocked" 在 resolver/decision_workshop 等属不同类型）
+ * 核实依据：生产端 design_artifact_pack.ts:47(draft)/:243(implementation_ready|verification_failed)；
+ *   消费端 task_stage_detector.ts(awaiting_decisions/implementation_ready)、project_stage_detector.ts:180(superseded)。
+ */
+export type DesignArtifactPackStatus = "draft" | "awaiting_decisions" | "verification_failed" | "confirmed" | "implementation_ready" | "superseded";
+/** 设计产物文件路径 */
+export interface DesignArtifactPaths {
+    decision_record: string;
+    architecture_document: string;
+    database_document: string;
+    api_document: string;
+    optional_detail_design_document?: string;
+    slice_plan: string;
+    consistency_report: string;
+    openapi: string;
+    sql_roots: string[];
+}
+/** 设计产物发现 */
+export interface DesignArtifactFinding {
+    code: string;
+    severity: "hard_fail" | "advisory";
+    file?: string;
+    message_zh: string;
+    recovery_zh?: string;
+    recovery_command?: string;
+    template_path?: string;
+}
+/** 设计产物包契约 */
+export interface DesignArtifactPackContract {
+    task_id: string;
+    standard_version: string;
+    status: DesignArtifactPackStatus;
+    paths: DesignArtifactPaths;
+    baseline_hashes: Record<string, string>;
+    decision_workshop_ref?: string;
+    user_confirmation_ref?: string;
+    findings: DesignArtifactFinding[];
+    verified_at?: string;
+}
+/** 设计产物包验证结果 */
+export interface DesignArtifactVerificationResult {
+    passed: boolean;
+    status: DesignArtifactPackStatus;
+    findings: DesignArtifactFinding[];
+    checked_files: string[];
+    hashes: Record<string, string>;
+}
+/** 失败记录 */
+/** 任务上下文，贯穿任务全生命周期的状态容器 */
+export interface TaskContext {
+    /** 任务唯一标识 */
+    task_id: string;
+    /**
+     * P1-B5: TaskContext 结构版本号
+     * 用于未来字段变更时的向后兼容迁移。读取时由 migrateTaskContext 按版本号分支处理。
+     * 缺失时视为版本 1（旧任务文件）。
+     */
+    schema_version?: number;
+    /** 创建时间 (ISO 8601) */
+    created_at: string;
+    /** 最近一次由 TaskContextManager 持久化更新时间 (ISO 8601) */
+    updated_at?: string;
+    /** 用户意图描述 */
+    intent: string;
+    /** 产品画像 */
+    product_profile: string;
+    /** 系统上下文：greenfield（全新）还是 brownfield（已有系统）。必填——create 总写入（默认 greenfield），生命周期不变 */
+    system_context: "greenfield" | "brownfield";
+    /** 技术栈标签（前端/后端/全栈） */
+    tech_stack?: string;
+    /** 当前聚焦域（派生辅助，非权威状态） */
+    domain_focus?: DomainName;
+    /** 补产后自动恢复点 */
+    pending_return?: PendingReturn;
+    /** 审计日志（域跳转/打转/恢复等业务事件） */
+    audit_log?: AuditEntry[];
+    /** 当前状态（含 escalated/cancelled 业务终态，治本：吸收 TaskIntent 的业务状态枚举） */
+    status: "classifying" | "expanding" | "clarifying" | "executing" | "verifying" | "retrying" | "learning" | "reworking" | "done" | "failed" | "escalated" | "cancelled";
+    /** 分类结果 */
+    classification?: ClassifyResult;
+    /** 扩展结果 */
+    expansion?: ExpandResult;
+    /** 执行状态 */
+    execution?: {
+        /** 已变更文件列表 */
+        changed_files: string[];
+        /** 已尝试次数 */
+        attempt_count: number;
+        /** 最大尝试次数 */
+        max_attempts: number;
+        /** 失败历史 */
+        failure_history: FailureRecord[];
+        /** 修复循环状态 */
+        repair_loop?: RepairLoopState;
+        /** single_artifact/source_extraction 无代码变更时显式标记 */
+        no_change_artifact?: boolean;
+    };
+    /** 显式跳过验证的原因（不允许默认空推进到 done/learning） */
+    skip_verification_reason?: string;
+    /** 规划结果 */
+    planning?: PlanResult;
+    /** 代码审查结果 */
+    code_review?: CodeReviewResult;
+    /** 交付结果 */
+    delivery?: DeliveryResult;
+    /** 当前阶段指令 */
+    phase_directive?: PhaseDirective;
+    /** 返工历史 */
+    rework_history?: ReworkHistory[];
+    /** 最后一次工具调用追踪*/
+    last_tool_trace?: ToolTrace;
+    /** 工具调用违规记录*/
+    invocation_violations?: ToolInvocationViolation[];
+    /** 摄取证据列表*/
+    ingestion_evidences?: IngestionEvidence[];
+    /** 输出产物记录*/
+    artifact_output?: OutputArtifact;
+    /** 敏感度标签列表（ 隐私） */
+    sensitivity_labels?: DataSensitivityLabel[];
+    /** 脱敏记录列表（ 隐私） */
+    redaction_records?: RedactionRecord[];
+    /** 验证计划（plan_only，非执行结果） */
+    verification_plan?: VerificationPlan;
+    /** 失败报告（脱敏，非 raw error_output） */
+    failure_report?: FailureReport;
+    /** 降级事件 */
+    degradation_event?: DegradationEvent;
+    /** 用户确认后的本地验收证据（问题五十二/六十三：交付放行前的可审计依据） */
+    local_acceptance_evidence?: {
+        status: "passed" | "not_applicable";
+        run_mode: "manual_review" | "not_applicable";
+        confirmed_by: string;
+        confirmation_ref: string;
+        final_access: FinalLocalReviewAccess;
+        evidence_refs: string[];
+    };
+    /** 计划前置门证据 */
+    plan_proposal_gate?: PlanProposalGateResult;
+    /** 计划提案证据 */
+    plan_proposal_evidence?: PlanProposalEvidence;
+    /** 用户确认引用 */
+    user_confirmation_ref?: UserConfirmationRef;
+    /** 验证计划引用 */
+    verification_plan_ref?: VerificationPlanRef;
+    /** 核心体验原则评估 */
+    core_experience_evaluation?: CoreExperiencePrincipleEvaluation;
+    /** 证据矩阵（问题六十：证据驱动门禁产出） */
+    evidence_matrix?: EvidenceMatrix;
+    /** 证据门禁结果（问题六十：阻断原因和诊断码） */
+    evidence_gate_result?: EvidenceGateResult;
+    /** 无证据声明 ID 列表（问题六十：被门禁标记为证据不足的 claim） */
+    unsupported_claims?: string[];
+    /** 证据冲突记录（问题六十：未裁决的互相矛盾证据） */
+    conflict_resolutions?: EvidenceConflict[];
+    /** 架构设计前的六域决策研讨契约（问题六十一子包） */
+    architecture_decision_workshop?: ArchitectureDecisionWorkshopContract;
+    /** 通用决策研讨契约（问题六十一） — 覆盖所有高影响/不确定任务的决策前置确认 */
+    decision_workshop?: DecisionWorkshopContract;
+    /** 技术决策主权契约（问题十六） */
+    technology_decision_contract?: TechnologyDecisionContract;
+    /** 技术决策执行记录（问题十六） */
+    technology_decision_record?: TechnologyDecisionRecord;
+    /** 细节纪律契约（问题二十六） */
+    detail_discipline_contract?: DetailDisciplineContract;
+    /** 细节纪律已提供证据（问题二十六） */
+    provided_details?: Record<string, string[]>;
+    /** 第一性原理框架（问题二十七） */
+    first_principles_frame?: FirstPrinciplesFrame;
+    /** 脑暴/方案探索会话（问题四十二） */
+    brainstorm_session?: BrainstormSession;
+    /** 模板契约修复重验指令（问题六十三） */
+    repair_reverify_directive?: {
+        contract_id: string;
+        file_path: string;
+        status: string;
+        repair_suggestion: string;
+        blocked: boolean;
+    };
+    /**
+     * P2-B1: 阶段回退指令 — phase_directive 为"回退"/"回退并标注"时由 rollback_router 解析得到。
+     * sf_work verify / sf_gate 触发回退时填充，sf_task 据此引导用户回到目标阶段。
+     */
+    rollback_directive?: {
+        from_stage: string;
+        to_stage: string;
+        kind: "rollback" | "rollback_annotate";
+        reason_zh: string;
+        directive: "回退" | "回退并标注";
+        triggered_at: string;
+    };
+    /** P2-B2: 业务源码 baseline — sf_work mutation_allowed=true 时记录变更前文件 hash，用于 sf_gate 失败回滚 */
+    file_baseline?: {
+        recorded_at: string;
+        files: Array<{
+            path: string;
+            sha256: string;
+        }>;
+    };
+    /** 架构、数据库与 API 设计产物包状态（问题六十二） */
+    design_artifact_pack?: DesignArtifactPackContract;
+    /** OOD/SOLID 编码前设计摘要（问题六十六） */
+    ood_solid_summary?: OodDesignSummary;
+    /** OOD/SOLID 代码审查结论（问题六十六） */
+    ood_solid_findings?: SolidReviewFinding[];
+    /** 后端实现工程工作包（问题六十七） */
+    backend_implementation_work_package?: BackendImplementationWorkPackage;
+    /** 后端工程审查结论（问题六十七） */
+    backend_implementation_findings?: BackendImplementationFinding[];
+    /** 代码可维护性与可观测性工作包（问题六十八） */
+    code_observability_work_package?: CodeObservabilityWorkPackage;
+    /** 代码可维护性与可观测性审查结论（问题六十八） */
+    code_observability_findings?: CodeObservabilityFinding[];
+    /** 指令契约（施工执行约束） */
+    instruction_contract?: InstructionContract;
+    /** 编码就绪契约 */
+    coding_readiness_contract?: ReadinessEvaluationResult;
+    /** 现有系统分析结果 */
+    existing_system_analysis?: Record<string, unknown>;
+    /** 需求差距分析结果 */
+    requirement_gap_analysis?: Record<string, unknown>;
+    /** 工作流追踪 */
+    workflow_trace?: WorkflowTrace;
+    /** 遗漏扫描结果（防 AI 偷懒 — sf_gate 步骤 9） */
+    omission_scan_result?: {
+        scanned_files: string[];
+        total_findings: number;
+        hard_fail_count: number;
+        summary: string;
+        adversarial_prompt?: string;
+    };
+    /** 代码质量门禁结果（防 AI 偷懒 — sf_gate 步骤 7a-7e） */
+    code_quality_result?: {
+        lazy_pattern_findings: number;
+        error_path_findings: number;
+        test_quality_hard_fails: number;
+        mutation_hard_fails: number;
+        behavior_coverage_warnings: number;
+        summary: string;
+    };
+    /** sf_gate 阶段匹配的知识提示 */
+    review_knowledge_hints?: string[];
+}
+/** 分类结果 */
+export interface ClassifyResult {
+    /** 任务类型 */
+    task_type: TaskType;
+    /** 风险等级 */
+    risk: Risk;
+    /** 复杂度 */
+    complexity: Complexity;
+    /** 歧义度 */
+    ambiguity: Ambiguity;
+    /** 受影响的仓库列表 */
+    affected_repos: string[];
+    /** 执行模式: autonomous=自主, supervised=受监督, passthrough=直通 */
+    mode: "autonomous" | "supervised" | "passthrough";
+    /** 执行策略: full_pipeline=完整流水线, quick_fix=快速修复, skip_soloForge=跳过 */
+    strategy: "full_pipeline" | "quick_fix" | "skip_soloForge";
+    /** 澄清请求 */
+    clarification?: {
+        /** 澄清摘要 */
+        summary: string;
+        /** 待确认的问题列表 */
+        questions?: string[];
+    };
+    /** 执行层级 */
+    execution_tier?: ExecutionTier;
+    /** 不确定性触发器列表 */
+    uncertainty_triggers?: UncertaintyTrigger[];
+}
+/** 不确定性触发器，当存在歧义或多种方案时触发 */
+export interface UncertaintyTrigger {
+    /** 触发类型 */
+    trigger_type: string;
+    /** 触发描述 */
+    description: string;
+    /** 可选方案及其权衡 */
+    options: Array<{
+        label: string;
+        tradeoff: string;
+    }>;
+    /** 推荐方案 */
+    recommendation: string;
+}
+/** 审查角色: self_review=自审, peer_review=同行评审, gate_review=门禁评审 */
+export type ReviewRole = "self_review" | "peer_review" | "gate_review";
+/** 争议条目，记录实现者与审查者的分歧 */
+export interface DisputeItem {
+    /** 发现 ID */
+    finding_id: string;
+    /** 实现者立场 */
+    implementer_position: string;
+    /** 审查者立场 */
+    reviewer_position: string;
+    /** 解决方案 */
+    resolution?: string;
+}
+/**
+ * 阶段指令（PhaseDirective）— 管线阶段间的流转指令。
+ *
+ * 推进下一阶段: 正常推进到下一阶段
+ * 门禁阻断: 门禁未通过，停留在当前阶段重试修复
+ * 回退: 回退到指定上游阶段（AI 自动触发）
+ * 回退并标注: 回退并标注问题等人确认（如详细设计→需求分析）
+ * 完成: 任务完成
+ * 停止升级: 停止并升级（异常兜底）
+ */
+export type PhaseDirective = "推进下一阶段" | "门禁阻断" | "回退" | "回退并标注" | "完成" | "停止升级";
+/** 返工历史记录 */
+export interface ReworkHistory {
+    /** 来源阶段 */
+    from_phase: string;
+    /** 目标阶段 */
+    to_phase: string;
+    /** 返工原因 */
+    reason: string;
+    /** 时间戳 */
+    timestamp: string;
+}
+/** 产物操作类型 — 从意图路由和动作信号推导 */
+export type OperationType = "extract" | "review" | "fix" | "iterate";
+/** 工作流意图类型 */
+export type WorkflowIntent = "requirements_analysis" | "architecture_design" | "existing_system_gap_analysis" | "detail_design" | "task_planning" | "test_first_coding" | "code_review" | "integration_verification" | "local_browser_acceptance" | "audit_design";
+/** Prompt 模板名称 */
+export type PromptTemplateName = "code_execution_prompt" | "single_artifact_prompt" | "source_extraction_prompt" | "read_only_analysis_prompt" | "acceptance_prompt" | "verification_only_prompt" | "direct_answer_prompt" | "architecture_design_prompt" | "gap_analysis_prompt" | "test_first_coding_prompt" | "local_acceptance_prompt" | "requirements_analysis_prompt" | "detail_design_prompt" | "task_planning_prompt" | "code_review_prompt" | "integration_verification_prompt" | "audit_design_prompt";
+/** 配置生命周期 */
+export type ConfigLifetime = "single_invocation" | "task" | "project_persistent" | "global";
+/** 规范化解析来源 */
+export type ConfigSource = "user_task" | "cli_flag" | "mcp_param" | "confirmed_config" | "project_policy" | "fingerprint" | "blueprint" | "product_profile" | "knowledge_default" | "global_default";
+/** 配置值证据 */
+export interface ConfigValueEvidence {
+    field_path: string;
+    value: unknown;
+    source: ConfigSource;
+    confidence: number;
+    evidence_ref?: string;
+    updated_at: string;
+}
+/** 配置冲突 */
+export interface ConfigConflict {
+    source_a: ConfigSource;
+    source_b: ConfigSource;
+    field_path: string;
+    reason: string;
+    requires_human: boolean;
+}
+/** 配置解析报告 */
+export interface ConfigResolutionReport {
+    field_path: string;
+    selected: ConfigValueEvidence;
+    candidates: ConfigValueEvidence[];
+    conflicts: ConfigConflict[];
+    overridden_by_guard?: string;
+    lifetime: ConfigLifetime;
+}
+/** 工具类别 */
+export type ToolCategory = "strict_controlled" | "read_only_bypass" | "normal_controlled";
+/** 副作用类型 */
+export type SideEffect = "none" | "task_context_write" | "file_write" | "knowledge_write" | "config_write" | "command_execution" | "git_commit" | "git_push" | "pr_create" | "external_write";
+/** 违规类型 */
+export type ViolationType = "not_allowed_next_tool" | "side_effect_exceeded" | "missing_authorization" | "guard_blocked" | "read_only_bypass_write" | "contract_state_mismatch" | "trace_missing";
+/** 违规严重程度 */
+export type ViolationSeverity = "warning" | "require_human" | "hard_fail";
+/** 工具授权 */
+export interface ToolAuthorization {
+    required: boolean;
+    granted: boolean;
+    reason?: string;
+}
+/** 工具旁路 */
+export interface ToolBypass {
+    allowed: boolean;
+    reason: "read_only" | "user_explicit" | "diagnostic";
+}
+/** 工具调用追踪 */
+export interface ToolTrace {
+    tool_name: string;
+    invocation_id: string;
+    task_id?: string;
+    workflow_id?: string;
+    contract_ids: string[];
+    capability_ids: string[];
+    guard_report_id?: string;
+    degraded: boolean;
+    warnings: string[];
+    side_effects: SideEffect[];
+    next_allowed_tools: string[];
+    forbidden_tools: string[];
+    authorization?: ToolAuthorization;
+    bypass?: ToolBypass;
+}
+/** 工具调用违规记录 */
+export interface ToolInvocationViolation {
+    invocation_id: string;
+    tool_name: string;
+    violation_type: ViolationType;
+    severity: ViolationSeverity;
+    reason: string;
+    recovery: string;
+}
+/** 工具调用契约 */
+export interface ToolInvocationContract {
+    tool_name: string;
+    category: ToolCategory;
+    side_effects: SideEffect[];
+    requires_authorization: boolean;
+    requires_workflow: boolean;
+    description: string;
+    default_next_tools: string[];
+    forbidden_next_tools: string[];
+}
+/** 适配器工作流策略规则 */
+export interface AdapterWorkflowPolicyRule {
+    id: string;
+    rule: string;
+    enforcement: "hard_fail" | "warning" | "advisory";
+    description: string;
+}
+/** 工具调用治理发现 */
+export interface ToolInvocationGovernanceFinding {
+    severity: "hard_fail" | "advisory";
+    tool_name: string;
+    rule: string;
+    message: string;
+}
+/** 变异候选点 */
+export interface MutationPoint {
+    file_path: string;
+    line_number: number;
+    original_line: string;
+    requirement_point_id?: string;
+}
+/** 变异审计条目 */
+export interface MutationAuditEntry {
+    requirement_point_id: string;
+    mutation_points: number;
+    mutants_killed: number;
+    mutants_total: number;
+    advisory: string;
+    /** 严重级别（防 AI 偷懒门禁硬化） */
+    severity?: "hard_fail" | "warning";
+}
+/** 变异审计证据（R9 需求绑定变异点 + mutant killed 证据） */
+export interface MutationAuditEvidence {
+    mutant_killed_count: number;
+    mutant_total_count: number;
+    kill_ratio: number;
+    per_requirement: MutationAuditEntry[];
+    uncovered_requirements: string[];
+    summary: string;
+    /** 门禁硬化汇总 */
+    hard_fail_count?: number;
+    warning_count?: number;
+}
+/** 工作流追踪*/
+export interface WorkflowTrace {
+    /** 工作流契约 ID */
+    workflow_id: string;
+    /** 路由 */
+    route: string;
+    /** 执行形态 */
+    execution_shape: string;
+    /** 是否允许变更 */
+    mutation_allowed: boolean;
+    /** 必需机制列表 */
+    required_mechanisms: string[];
+    /** 治理检查结果 */
+    governance_findings: Array<{
+        severity: "hard_fail" | "warning" | "advisory";
+        rule: string;
+        message: string;
+    }>;
+    /** 是否降级 */
+    degraded: boolean;
+    /** 状态转换目标 */
+    state_transition_target: string;
+    /** 审计检查项 — 记录已执行的治理检查 */
+    checked_items?: string[];
+}
+/** scope 解析证据来源 */
+export interface ScopeResolutionSource {
+    source: string;
+    confidence: "high" | "medium" | "low";
+    role?: "backend" | "frontend" | "shared" | "output" | "readonly";
+    repo_name?: string;
+    base_path?: string;
+    declared_paths: string[];
+    resolved_paths: string[];
+    evidence: string[];
+}
+/** scope 解析审计报告 */
+export interface ScopeResolutionReport {
+    status: "resolved" | "fallback" | "blocked";
+    project_root: string;
+    path_semantics: {
+        storage_format: "project_relative_posix";
+        host_platform: NodeJS.Platform;
+        case_sensitive: boolean;
+    };
+    allowed_paths: string[];
+    readonly_paths: string[];
+    new_files_allowed: boolean;
+    sources: ScopeResolutionSource[];
+    discovered_source_roots: string[];
+    warnings: string[];
+    conflicts: string[];
+    recovery_commands: string[];
+}
+/** 作用域结果 */
+export interface ScopeResult {
+    /** 允许修改的路径（空 = 不收窄，仅受内置黑名单约束） */
+    allowed_paths: string[];
+    /** 只读路径 */
+    readonly_paths: string[];
+    /** 黑名单模式标记 — true 表示仅受内置黑名单约束，不收窄 */
+    blacklist_only?: boolean;
+    /** 是否允许新建文件 */
+    new_files_allowed: boolean;
+    /** 新文件命名模式 */
+    new_file_patterns?: string[];
+    /** scope 解析审计报告 */
+    resolution?: ScopeResolutionReport;
+}
+/** 验收条目 */
+export interface AcceptanceItem {
+    /** 验收项 ID */
+    id: string;
+    /** 验收描述 */
+    description: string;
+    /** 验收类型 */
+    type: "automated" | "manual";
+    /** 自动化检查命令 */
+    check_command?: string;
+}
+/** 需求点（R9 语义交付证据） */
+export interface RequirementPoint {
+    /** 需求点 ID */
+    id: string;
+    /** 需求描述 */
+    description: string;
+    /** 关联的验收测试 ID 列表 */
+    acceptance_test_ids?: string[];
+}
+/** 语义证据（R9 验证时产出） */
+export interface SemanticEvidence {
+    /** 变更行为列表 */
+    changed_behaviors: Array<{
+        file_path: string;
+        description: string;
+        requirement_point_id?: string;
+    }>;
+    /** 未变更断言列表 */
+    unchanged_assertions: Array<{
+        file_path: string;
+        assertion_description: string;
+        still_valid: boolean;
+    }>;
+    /** 需求点覆盖状态 */
+    requirement_coverage: Array<{
+        requirement_point_id: string;
+        covered: boolean;
+        evidence: string;
+    }>;
+}
+/** 扩展结果，包含完整的任务执行指令 */
+export interface ExpandResult {
+    /** 任务 ID */
+    task_id: string;
+    /** 生成的 prompt */
+    prompt: string;
+    /** 作用域结果 */
+    scope: ScopeResult;
+    /** scope 解析审计报告 */
+    scope_resolution?: ScopeResolutionReport;
+    /** 验收条件 */
+    acceptance: {
+        /** 自动化验收项 */
+        automated: AcceptanceItem[];
+        /** 人工验收项 */
+        manual: AcceptanceItem[];
+    };
+    /** 匹配的模式列表 */
+    matched_patterns: string[];
+    /** 匹配的知识条目列表 */
+    matched_knowledge: string[];
+    /** 是否为遗留代码 */
+    is_legacy_code: boolean;
+    /** 遗留代码约定 */
+    legacy_conventions?: string[];
+    /** 是否降级执行 */
+    degraded: boolean;
+    /** 执行契约 */
+    contract?: ExecutionContract;
+    /** 不确定性触发器列表 */
+    uncertainty_triggers?: UncertaintyTrigger[];
+    /** 置信度熔断结果（机制 1） */
+    circuit_breaker?: {
+        tripped: boolean;
+        confidence: number;
+        reason?: string;
+        brainstorm?: {
+            blind_spots: string[];
+            evolution_tracks: {
+                minimal: string;
+                industrial: string;
+                radical: string;
+            };
+            decision_questions: Array<{
+                question: string;
+                option_a: string;
+                option_b: string;
+            }>;
+        };
+    };
+    /** 需求点列表（R9 语义交付证据） */
+    requirement_points?: RequirementPoint[];
+    /** 知识注入边界报告*/
+    injection_report?: KnowledgeInjectionReport;
+    /** 用户项目知识审计与本次任务选中结果*/
+    project_knowledge?: {
+        total: number;
+        hard_fail_count: number;
+        warning_count: number;
+        selected: Array<{
+            id: string;
+            name: string;
+            rel_path: string;
+            consumption: string;
+            identity: string;
+        }>;
+        selection_decisions?: Array<{
+            id: string;
+            name: string;
+            rel_path: string;
+            status: string;
+            enforcement: string;
+            reason_zh: string;
+            matched_signals: string[];
+            excluded_reasons: string[];
+            verification_command?: string;
+        }>;
+        findings: Array<{
+            rel_path: string;
+            code: string;
+            severity: "hard_fail" | "warning" | "advisory";
+            message_zh: string;
+        }>;
+    };
+    /** 工作流追踪*/
+    workflow_trace?: WorkflowTrace;
+    /** 工具调用追踪*/
+    tool_trace?: ToolTrace;
+    /** 下一步允许的工具列表*/
+    next_allowed_tools?: string[];
+    /** 被禁止的工具列表*/
+    forbidden_tools?: string[];
+    /** 输入材料契约列表*/
+    input_materials?: InputMaterial[];
+    /** 摄取证据列表*/
+    ingestion_evidences?: IngestionEvidence[];
+    /** Prompt 注入边界计划*/
+    prompt_injection_plan?: PromptInjectionPlan;
+    /** 输出产物记录*/
+    output_artifact_record?: OutputArtifact;
+    /** 配置优先级解析报告*/
+    config_resolution_reports?: ConfigResolutionReport[];
+    /** 敏感度标签列表（ 隐私） */
+    sensitivity_labels?: DataSensitivityLabel[];
+    /** 脱敏记录列表（ 隐私） */
+    redaction_records?: RedactionRecord[];
+    /** 隐私治理发现（ 隐私） */
+    privacy_findings?: PrivacyGovernanceFinding[];
+    /** 架构决策合同 */
+    architecture_contract?: ArchitectureDesignContract;
+}
+/** 验证结果 */
+export interface VerifyResult {
+    /** 任务 ID */
+    task_id: string;
+    /** 检查项分组 */
+    checks: {
+        /** 构建检查命令列表 */
+        build: VerifyCommand[];
+        /** 测试检查命令列表 */
+        tests: VerifyCommand[];
+        /** 验收检查结果 */
+        acceptance?: AcceptanceCheckResult[];
+    };
+    /** 验证摘要 */
+    summary: string;
+    /** 需人工确认的项 */
+    manual_items: string[];
+    /** 证据条目列表 */
+    evidence?: EvidenceItem[];
+    /** 覆盖率矩阵 */
+    coverage?: CoverageMatrix;
+    /** 三重否定推演结果（机制 2） */
+    triple_negation?: {
+        crash_scenarios: string[];
+        mitigation_suggestions: string[];
+        audit_declaration: string;
+        passed: boolean;
+    };
+    /** 语义证据（R9 语义交付证据） */
+    semantic_evidence?: SemanticEvidence;
+    /** 变异审计证据（R9 需求绑定变异点） */
+    mutation_evidence?: MutationAuditEvidence;
+    /** 主链路集成检查结果*/
+    main_path_integration?: {
+        /** 是否通过集成检查 */
+        passed: boolean;
+        /** 孤岛检测结果 */
+        findings: IntegrationFinding[];
+        /** 受检模块列表 */
+        checked_modules: string[];
+        /** 审计报告 */
+        summary: string;
+    };
+    /** 核心工程执行原则检查结果*/
+    core_principles?: CorePrinciplesReport;
+    /** 命令契约列表*/
+    command_contracts?: CommandContract[];
+    /** 遗漏扫描结果（防 AI 偷懒） */
+    omission_scan?: {
+        /** 扫描的文件列表 */
+        scanned_files: string[];
+        /** 发现项总数 */
+        total_findings: number;
+        /** 阻塞级发现数 */
+        hard_fail_count: number;
+        /** 摘要 */
+        summary: string;
+        /** 对抗性 AI prompt（供后续深度审计） */
+        adversarial_prompt?: string;
+    };
+    /** 代码质量门禁结果（防 AI 偷懒 — sf_gate 步骤 7a-7e） */
+    code_quality?: {
+        /** 偷懒模式 hard_fail 数（A1） */
+        lazy_pattern_findings: number;
+        /** 错误处理路径 hard_fail 数（C6） */
+        error_path_findings: number;
+        /** 测试质量 hard_fail 数（C5） */
+        test_quality_hard_fails: number;
+        /** 变异审计 hard_fail 数（C7） */
+        mutation_hard_fails: number;
+        /** 行为覆盖率 warning 数（C8） */
+        behavior_coverage_warnings: number;
+        /** 摘要 */
+        summary: string;
+    };
+}
+/** 验证命令 */
+export interface VerifyCommand {
+    /** 要执行的命令 */
+    command: string;
+    /** 工作目录 */
+    cwd: string;
+    /** 超时提示（毫秒） */
+    timeout_hint: number;
+    /** 命令描述 */
+    description: string;
+    /** 命令执行是否通过（未执行时为 undefined） */
+    passed?: boolean;
+}
+/** 验收检查结果 */
+export interface AcceptanceCheckResult {
+    /** 验收项 ID */
+    id: string;
+    /** 验收描述 */
+    description: string;
+    /** 检查命令 */
+    check_command: string;
+    /** 工作目录 */
+    cwd: string;
+}
+/** 学习结果 */
+export interface LearnResult {
+    /** 任务 ID */
+    task_id: string;
+    /** 是否产生新知识 */
+    learned: boolean;
+    /** 新知识内容 */
+    new_knowledge?: {
+        /** 知识类型 */
+        type: "pattern" | "procedure" | "rule_upgrade" | "prompt_optimization" | "acceptance_supplement";
+        /** 知识内容 */
+        content: string;
+        /** 适用范围 */
+        scope: string[];
+        /** 适用产品 */
+        products: string[];
+    };
+    /** 置信度 (0-1) */
+    confidence: number;
+    /** 状态: accepted=已接受, staged=暂存, skipped=跳过 */
+    status: "accepted" | "staged" | "skipped";
+    /** 暂存路径 */
+    staged_path?: string;
+    /** 重试提示 */
+    retry_hint?: string;
+}
+/** 失败分类结果 */
+export interface FailureClassifyResult {
+    /** 失败类型 */
+    failure_type: FailureType;
+    /** 是否与上次相同错误 */
+    is_same_error: boolean;
+    /** 剩余重试次数 */
+    retry_remaining: number;
+    /** 建议动作: retry=重试, expand_scope=扩大范围, escalate=升级 */
+    action: "retry" | "expand_scope" | "escalate";
+    /** 发起阶段 */
+    phase_origin?: string;
+    /** 是否可自动修复 */
+    auto_repairable?: boolean;
+    /** 升级原因 */
+    escalation_reason?: string;
+    /** 重复出现次数 */
+    recurrence_count?: number;
+}
+/** 失败记录 */
+export interface FailureRecord {
+    /** 尝试序号 */
+    attempt: number;
+    /** 失败类型 */
+    type: FailureType;
+    /** 失败信息 */
+    message: string;
+    /** 失败时间戳 */
+    timestamp: string;
+    /** 失败所处阶段 */
+    phase?: string;
+}
+export {};
+//# sourceMappingURL=pipeline_types.d.ts.map