soloforge 1.4.15 → 1.5.0

package/dist/types.d.ts

@@ -1,1737 +0,0 @@
-/** 风险等级: low=低风险, medium=中风险, high=高风险 */
-export type Risk = "low" | "medium" | "high";
-/** 复杂度: low=低, medium=中, high=高 */
-export type Complexity = "low" | "medium" | "high";
-/** 歧义度: low=低, medium=中, high=高 */
-export type Ambiguity = "low" | "medium" | "high";
-/** 任务类型 */
-export type TaskType = "feature" | "bugfix" | "refactor" | "hotfix" | "review" | "explain" | "optimize" | "document" | "test" | "scaffold" | "debug" | "passthrough";
-/** 失败类型: deterministic=确定性错误, fixable=可修复, scope_insufficient=作用域不足 */
-export type FailureType = "deterministic" | "fixable" | "scope_insufficient";
-/** 执行层级: auto_execute=自动执行, recommended_auto=建议自动, must_confirm=必须确认, forbidden_auto=禁止自动 */
-export type ExecutionTier = "auto_execute" | "recommended_auto" | "must_confirm" | "forbidden_auto";
-/** 执行契约，定义任务的执行目标、范围、约束和验收条件 */
-export interface ExecutionContract {
-    /** 执行目标 */
-    goal: string;
-    /** 影响范围（文件/模块路径列表） */
-    scope: string[];
-    /** 约束条件 */
-    constraints: string[];
-    /** 验证手段（命令/检查项） */
-    verification: string[];
-    /** 停止条件 */
-    stop_conditions: string[];
-}
-/** 证据等级: E0=无证据, E1=命令输出, E2=文件快照, E3=端到端验证 */
-export type EvidenceLevel = "E0" | "E1" | "E2" | "E3";
-/** 证据条目 */
-export interface EvidenceItem {
-    /** 证据唯一标识 */
-    id: string;
-    /** 证据等级 */
-    level: EvidenceLevel;
-    /** 证据描述 */
-    description: string;
-    /** 证据来源 */
-    source: "command" | "file" | "runtime" | "static_analysis";
-    /** 产生证据的命令 */
-    command?: string;
-    /** 是否通过 */
-    passed: boolean;
-    /** 时间戳 */
-    timestamp?: string;
-}
-/** 覆盖率矩阵，统计 API/页面/流程的测试覆盖情况 */
-export interface CoverageMatrix {
-    /** API 覆盖率 */
-    api_coverage: {
-        total: number;
-        tested: number;
-        gaps: string[];
-    };
-    /** 页面覆盖率 */
-    page_coverage: {
-        total: number;
-        tested: number;
-        gaps: string[];
-    };
-    /** 流程覆盖率 */
-    flow_coverage: {
-        total: number;
-        tested: number;
-        gaps: string[];
-    };
-}
-/** 修复循环状态 */
-export interface RepairLoopState {
-    /** 当前尝试次数 */
-    attempt: number;
-    /** 最大尝试次数 */
-    max_attempts: number;
-    /** 发起阶段 */
-    phase_origin: string;
-    /** 是否可自动修复 */
-    auto_repairable: boolean;
-    /** 升级原因 */
-    escalation_reason?: string;
-    /** 重复出现次数 */
-    recurrence_count: number;
-}
-/** 不确定性触发器，当存在歧义或多种方案时触发 */
-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;
-}
-/** 阶段指令: continue_current=继续当前阶段, advance_next=推进下一阶段, repair_reverify=修复后重验, rework_upstream=回退上游, stop_escalate=停止并升级, completed=已完成 */
-export type PhaseDirective = "continue_current" | "advance_next" | "repair_reverify" | "rework_upstream" | "stop_escalate" | "completed";
-/** 返工历史记录 */
-export interface ReworkHistory {
-    /** 来源阶段 */
-    from_phase: string;
-    /** 目标阶段 */
-    to_phase: string;
-    /** 返工原因 */
-    reason: string;
-    /** 时间戳 */
-    timestamp: string;
-}
-/** 项目配置 */
-export interface ProjectConfig {
-    /** 配置 schema 版本 */
-    schema_version?: number;
-    /** 项目名称 */
-    name: string;
-    /** 技术栈 */
-    tech_stack: {
-        backend: {
-            lang: string;
-            framework: string;
-            version: string;
-        };
-        frontend: {
-            lang: string;
-            framework: string;
-            version: string;
-        };
-    };
-    /** 产品画像 */
-    product_profile: string;
-    /** 仓库配置列表 */
-    repos: RepoConfig[];
-    /** 构建命令 */
-    build_commands: {
-        backend: BuildCommands;
-        frontend: BuildCommands;
-    };
-    /** 作用域范围 */
-    scope: {
-        backend: string[];
-        frontend: string[];
-    };
-    /** 约定文件路径 */
-    conventions_file?: string;
-    /** 验证超时设置 */
-    verify_timeout?: {
-        /** 构建超时（秒） */
-        build: number;
-        /** 测试超时（秒） */
-        test: number;
-    };
-    /** 产品映射（功能点到模块的映射） */
-    product_mapping?: Record<string, string>;
-    /** 脚手架配置 */
-    scaffold?: {
-        /** 基础包名 */
-        base_package?: string;
-        /** 模板名称 */
-        templates?: string;
-        /** 自定义模板目录 */
-        custom_templates_dir?: string;
-        /** 自定义脚手架项目级合同（按模板集名称索引） */
-        contracts?: Record<string, CustomScaffoldContract>;
-    };
-    /** @internal resolved at runtime, not from config file */
-    _projectPath?: string;
-}
-/** 解析后的项目配置（含来源信息） */
-export interface ResolvedConfig {
-    config: ProjectConfig;
-    source: "config_file" | "inferred";
-}
-/** 构建命令配置 */
-export interface BuildCommands {
-    /** 构建命令 */
-    build: string;
-    /** 测试命令 */
-    test: string;
-    /** 全量构建（含测试）命令 */
-    full: string;
-}
-/** 仓库配置 */
-export interface RepoConfig {
-    /** 仓库名称 */
-    name: string;
-    /** 仓库路径 */
-    path: string;
-    /** 编程语言 */
-    lang: string;
-    /** 框架 */
-    framework: string;
-    /** 作用域路径列表 */
-    scope: string[];
-}
-/** 任务上下文，贯穿任务全生命周期的状态容器 */
-export interface TaskContext {
-    /** 任务唯一标识 */
-    task_id: string;
-    /** 创建时间 (ISO 8601) */
-    created_at: string;
-    /** 最近一次由 TaskContextManager 持久化更新时间 (ISO 8601) */
-    updated_at?: string;
-    /** 用户意图描述 */
-    intent: string;
-    /** 产品画像 */
-    product_profile: string;
-    /** 当前状态 */
-    status: "classifying" | "expanding" | "clarifying" | "executing" | "verifying" | "retrying" | "learning" | "reworking" | "done" | "failed";
-    /** 分类结果 */
-    classification?: ClassifyResult;
-    /** 意图路由决策（从 classify 阶段产生，贯穿整个任务生命周期） */
-    route_decision?: import("./engine/intent_router.js").IntentRouteDecision;
-    /** 扩展结果 */
-    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;
-    };
-    /** 验证结果 */
-    verification?: VerifyResult;
-    /** 显式跳过验证的原因（不允许默认空推进到 done/learning） */
-    skip_verification_reason?: string;
-    /** 规划结果 */
-    planning?: PlanResult;
-    /** 代码审查结果 */
-    code_review?: CodeReviewResult;
-    /** 交付结果 */
-    delivery?: DeliveryResult;
-    /** 当前阶段指令 */
-    phase_directive?: PhaseDirective;
-    /** 返工历史 */
-    rework_history?: ReworkHistory[];
-    /** 最后一次工具调用追踪*/
-    last_tool_trace?: import("./engine/tool_invocation_contract_registry.js").ToolTrace;
-    /** 工具调用违规记录*/
-    invocation_violations?: import("./engine/tool_invocation_contract_registry.js").ToolInvocationViolation[];
-    /** 摄取证据列表*/
-    ingestion_evidences?: import("./engine/input_material_contract_registry.js").IngestionEvidence[];
-    /** 输出产物记录*/
-    artifact_output?: import("./engine/artifact_contract_registry.js").OutputArtifact;
-    /** 敏感度标签列表（ 隐私） */
-    sensitivity_labels?: import("./engine/privacy_secret_contract.js").DataSensitivityLabel[];
-    /** 脱敏记录列表（ 隐私） */
-    redaction_records?: import("./engine/privacy_secret_contract.js").RedactionRecord[];
-    /** 验证计划（plan_only，非执行结果） */
-    verification_plan?: import("./engine/verification_contract.js").VerificationPlan;
-    /** 验证结果（真实执行产出） */
-    verification_result?: import("./engine/verification_contract.js").VerificationResult;
-    /** 失败报告（脱敏，非 raw error_output） */
-    failure_report?: import("./engine/failure_report.js").FailureReport;
-    /** 降级事件 */
-    degradation_event?: import("./engine/degradation.js").DegradationEvent;
-    /** 交付就绪报告 */
-    delivery_readiness?: import("./engine/delivery_readiness.js").DeliveryReadinessReport;
-    /** 用户确认后的本地验收证据（问题五十二/六十三：交付放行前的可审计依据） */
-    local_acceptance_evidence?: {
-        status: "passed" | "not_applicable";
-        run_mode: "manual_review" | "not_applicable";
-        confirmed_by: string;
-        confirmation_ref: string;
-        final_access: import("./engine/extension_platform_contracts.js").FinalLocalReviewAccess;
-        evidence_refs: string[];
-    };
-    /** @deprecated 使用 verification_plan — 旧 Batch2 字段，迁移兼容 */
-    batch2_verification_plan?: import("./engine/verification_contract.js").VerificationPlan;
-    /** @deprecated 使用 verification_result — 旧 Batch2 字段，迁移兼容 */
-    batch2_verification_result?: import("./engine/verification_contract.js").VerificationResult;
-    /** @deprecated 使用 failure_report — 旧 Batch2 字段，迁移兼容 */
-    batch2_failure_report?: import("./engine/failure_report.js").FailureReport;
-    /** @deprecated 使用 degradation_event — 旧 Batch2 字段，迁移兼容 */
-    batch2_degradation_event?: import("./engine/degradation.js").DegradationEvent;
-    /** @deprecated 使用 delivery_readiness — 旧 Batch2 字段，迁移兼容 */
-    batch2_delivery_readiness?: import("./engine/delivery_readiness.js").DeliveryReadinessReport;
-    /** 计划前置门证据 */
-    plan_proposal_gate?: import("./engine/plan_proposal_gate.js").PlanProposalGateResult;
-    /** 计划提案证据 */
-    plan_proposal_evidence?: import("./engine/plan_proposal_gate.js").PlanProposalEvidence;
-    /** 用户确认引用 */
-    user_confirmation_ref?: import("./engine/plan_proposal_gate.js").UserConfirmationRef;
-    /** 验证计划引用 */
-    verification_plan_ref?: import("./engine/plan_proposal_gate.js").VerificationPlanRef;
-    /** 核心体验原则评估 */
-    core_experience_evaluation?: import("./engine/core_experience_principle.js").CoreExperiencePrincipleEvaluation;
-    /** 证据矩阵（问题六十：证据驱动门禁产出） */
-    evidence_matrix?: import("./engine/evidence_grounding_contract.js").EvidenceMatrix;
-    /** 证据门禁结果（问题六十：阻断原因和诊断码） */
-    evidence_gate_result?: import("./engine/evidence_grounding_contract.js").EvidenceGateResult;
-    /** 无证据声明 ID 列表（问题六十：被门禁标记为证据不足的 claim） */
-    unsupported_claims?: string[];
-    /** 证据冲突记录（问题六十：未裁决的互相矛盾证据） */
-    conflict_resolutions?: import("./engine/evidence_grounding_contract.js").EvidenceConflict[];
-    /** 架构设计前的六域决策研讨契约（问题六十一子包） */
-    architecture_decision_workshop?: import("./engine/architecture_decision_workshop.js").ArchitectureDecisionWorkshopContract;
-    /** 通用决策研讨契约（问题六十一） — 覆盖所有高影响/不确定任务的决策前置确认 */
-    decision_workshop?: import("./engine/decision_workshop.js").DecisionWorkshopContract;
-    /** 技术决策主权契约（问题十六） */
-    technology_decision_contract?: import("./engine/extension_platform_contracts.js").TechnologyDecisionContract;
-    /** 技术决策执行记录（问题十六） */
-    technology_decision_record?: import("./engine/extension_platform_contracts.js").TechnologyDecisionRecord;
-    /** 细节纪律契约（问题二十六） */
-    detail_discipline_contract?: import("./engine/extension_platform_contracts.js").DetailDisciplineContract;
-    /** 细节纪律已提供证据（问题二十六） */
-    provided_details?: Record<string, string[]>;
-    /** 第一性原理框架（问题二十七） */
-    first_principles_frame?: import("./engine/extension_platform_contracts.js").FirstPrinciplesFrame;
-    /** 脑暴/方案探索会话（问题四十二） */
-    brainstorm_session?: import("./engine/extension_platform_contracts.js").BrainstormSession;
-    /** 模板契约修复重验指令（问题六十三） */
-    repair_reverify_directive?: {
-        contract_id: string;
-        file_path: string;
-        status: string;
-        repair_suggestion: string;
-        blocked: boolean;
-    };
-    /** 架构、数据库与 API 设计产物包状态（问题六十二） */
-    design_artifact_pack?: import("./engine/design_artifact_pack.js").DesignArtifactPackContract;
-    /** 需求/原型/设计/切片/验收追踪绑定（问题七十三） */
-    traceability_binding?: {
-        requirement_ids: string[];
-        prototype_ids: string[];
-        architecture_ids: string[];
-        detail_design_ids: string[];
-        phase_ids?: string[];
-        slice_ids: string[];
-        acceptance_ids: string[];
-        status: "bound" | "missing" | "needs_backfill";
-        findings: string[];
-    };
-    /** OOD/SOLID 编码前设计摘要（问题六十六） */
-    ood_solid_summary?: import("./engine/ood_solid_contract.js").OodDesignSummary;
-    /** OOD/SOLID 代码审查结论（问题六十六） */
-    ood_solid_findings?: import("./engine/ood_solid_contract.js").SolidReviewFinding[];
-    /** 后端实现工程工作包（问题六十七） */
-    backend_implementation_work_package?: import("./engine/backend_implementation_contract.js").BackendImplementationWorkPackage;
-    /** 后端工程审查结论（问题六十七） */
-    backend_implementation_findings?: import("./engine/backend_implementation_contract.js").BackendImplementationFinding[];
-    /** 代码可维护性与可观测性工作包（问题六十八） */
-    code_observability_work_package?: import("./engine/code_maintainability_observability_contract.js").CodeObservabilityWorkPackage;
-    /** 代码可维护性与可观测性审查结论（问题六十八） */
-    code_observability_findings?: import("./engine/code_maintainability_observability_contract.js").CodeObservabilityFinding[];
-}
-/** 失败记录 */
-export interface FailureRecord {
-    /** 尝试序号 */
-    attempt: number;
-    /** 失败类型 */
-    type: FailureType;
-    /** 失败信息 */
-    message: string;
-    /** 失败时间戳 */
-    timestamp: string;
-    /** 失败所处阶段 */
-    phase?: 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[];
-    /** 路由决策结果 */
-    route_decision?: import("./engine/intent_router.js").IntentRouteDecision;
-}
-/** 工作流追踪*/
-export interface WorkflowTrace {
-    /** 工作流契约 ID */
-    workflow_id: string;
-    /** 路由 */
-    route: string;
-    /** 执行形态 */
-    execution_shape: string;
-    /** 是否允许变更 */
-    mutation_allowed: boolean;
-    /** 必需机制列表 */
-    required_mechanisms: string[];
-    /** 治理检查结果 */
-    governance_findings: Array<{
-        severity: string;
-        rule: string;
-        message: string;
-    }>;
-    /** 是否降级 */
-    degraded: boolean;
-    /** 状态转换目标 */
-    state_transition_target: string;
-    /** 审计检查项 — 记录已执行的治理检查 */
-    checked_items?: 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: string;
-            message_zh: string;
-        }>;
-    };
-    /** 工作流追踪*/
-    workflow_trace?: WorkflowTrace;
-    /** 工具调用追踪*/
-    tool_trace?: import("./engine/tool_invocation_contract_registry.js").ToolTrace;
-    /** 下一步允许的工具列表*/
-    next_allowed_tools?: string[];
-    /** 被禁止的工具列表*/
-    forbidden_tools?: string[];
-    /** 输入材料契约列表*/
-    input_materials?: import("./engine/input_material_contract_registry.js").InputMaterial[];
-    /** 摄取证据列表*/
-    ingestion_evidences?: import("./engine/input_material_contract_registry.js").IngestionEvidence[];
-    /** Prompt 注入边界计划*/
-    prompt_injection_plan?: import("./engine/input_material_contract_registry.js").PromptInjectionPlan;
-    /** 输出产物记录*/
-    output_artifact_record?: import("./engine/artifact_contract_registry.js").OutputArtifact;
-    /** 配置优先级解析报告*/
-    config_resolution_reports?: import("./engine/config_precedence_contract.js").ConfigResolutionReport[];
-    /** 敏感度标签列表（ 隐私） */
-    sensitivity_labels?: import("./engine/privacy_secret_contract.js").DataSensitivityLabel[];
-    /** 脱敏记录列表（ 隐私） */
-    redaction_records?: import("./engine/privacy_secret_contract.js").RedactionRecord[];
-    /** 隐私治理发现（ 隐私） */
-    privacy_findings?: import("./engine/privacy_secret_contract.js").PrivacyGovernanceFinding[];
-}
-/** 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[];
-    /** 是否允许新建文件 */
-    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 ScopeCheckResult {
-    /** 是否允许通过 */
-    allowed: boolean;
-    /** 原因说明 */
-    reason?: string;
-    /** 是否包含敏感信息 */
-    has_secrets: boolean;
-    /** 敏感信息详情 */
-    secret_details?: Array<{
-        /** 文件路径 */
-        file: string;
-        /** 行号 */
-        line: number;
-        /** 敏感信息类型 */
-        type: string;
-    }>;
-    /** 严重程度: ok=正常, warning=警告, blocked=阻止 */
-    severity: "ok" | "warning" | "blocked";
-}
-/** 验证结果 */
-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?: import("./engine/mutation_audit.js").MutationAuditEvidence;
-    /** 主链路集成检查结果*/
-    main_path_integration?: {
-        /** 是否通过集成检查 */
-        passed: boolean;
-        /** 孤岛检测结果 */
-        findings: import("./engine/main_path_integration_contract.js").IntegrationFinding[];
-        /** 受检模块列表 */
-        checked_modules: string[];
-        /** 审计报告 */
-        summary: string;
-    };
-    /** 核心工程执行原则检查结果*/
-    core_principles?: import("./engine/core_engineering_principles.js").CorePrinciplesReport;
-    /** 命令契约列表*/
-    command_contracts?: import("./engine/command_execution_contract.js").CommandContract[];
-}
-/** 验证命令 */
-export interface VerifyCommand {
-    /** 要执行的命令 */
-    command: string;
-    /** 工作目录 */
-    cwd: string;
-    /** 超时提示（毫秒） */
-    timeout_hint: number;
-    /** 命令描述 */
-    description: string;
-}
-/** 验收检查结果 */
-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 type InjectionPriorityTier = "route_required" | "project_core_active" | "project_normal_active" | "product_constraints" | "global_core_active" | "global_normal_active" | "advisory_pending";
-/** 排除原因 */
-export type ExclusionReason = "status_blocked" | "scope_mismatch" | "product_mismatch" | "route_mismatch" | "conflict" | "budget_limit" | "manual_reference_only" | "deprecated";
-/** 知识引用（注入报告用） */
-export interface KnowledgeRef {
-    id: string;
-    name: string;
-    priority_tier: InjectionPriorityTier;
-    consumption_mode: string;
-    tier: string;
-    /** 警告信息（如 pending_review_not_injected） */
-    warning?: string;
-    /** 多条警告 */
-    warnings?: string[];
-}
-/** 知识冲突记录 */
-export interface KnowledgeConflict {
-    winner_id: string;
-    loser_id: string;
-    field: string;
-    reason: string;
-}
-/** 缺失的必需知识条目 */
-export interface MissingRequiredKnowledge {
-    kind?: string;
-    template?: string;
-    pipeline_hint?: string;
-    reason: string;
-}
-/** 知识注入报告 */
-export interface KnowledgeInjectionReport {
-    indexed: KnowledgeRef[];
-    injectable: KnowledgeRef[];
-    injected_required: KnowledgeRef[];
-    injected_supporting: KnowledgeRef[];
-    advisory_only: KnowledgeRef[];
-    excluded: Array<{
-        id: string;
-        name: string;
-        reason: ExclusionReason;
-    }>;
-    missing_required_knowledge: MissingRequiredKnowledge[];
-    governance_findings?: Array<{
-        severity: "hard_fail" | "advisory";
-        subject_id: string;
-        field: string;
-        message: string;
-    }>;
-    conflicts: KnowledgeConflict[];
-    budget: {
-        requested: number;
-        injected: number;
-        advisory: number;
-        dropped: number;
-    };
-    generated_at: string;
-}
-/** 知识条目 */
-export interface KnowledgeEntry {
-    /** 知识唯一标识 */
-    id: string;
-    /** 文件路径 */
-    file_path: string;
-    /** 知识名称 */
-    name: string;
-    /** 知识类型 */
-    type: "pattern" | "procedure" | "domain" | "acceptance_template" | "review_rule" | "governance_rule" | "pipeline_procedure";
-    /** 触发条件 */
-    when: string;
-    /** 知识正文 */
-    body?: string;
-    /** 适用范围 */
-    scope: string[];
-    /** 适用产品 */
-    products: string[];
-    /** 适用技术栈 */
-    tech_stack?: string;
-    /** 最后使用时间 */
-    last_used_at?: string;
-    /** 创建时间 */
-    created_at: string;
-    /** 更新时间 */
-    updated_at: string;
-    /** 使用次数 */
-    usage_count: number;
-    /** 置信度 (0-1) */
-    confidence: number;
-    /** 适用路由；未声明时不参与路由过滤，声明标准路由时必须匹配 */
-    routes?: string[];
-    /** 状态: active=活跃, staged=暂存, deprecated=已废弃, pending_review=待审查 */
-    status: "active" | "staged" | "deprecated" | "pending_review";
-}
-/** 知识索引 */
-export interface KnowledgeIndex {
-    /** 索引版本 */
-    version: number;
-    /** 构建时间 */
-    built_at: string;
-    /** 全局知识条目 */
-    global_entries: KnowledgeEntry[];
-    /** 项目级知识条目 */
-    project_entries: KnowledgeEntry[];
-}
-/** 子任务 */
-export interface SubTask {
-    /** 子任务 ID */
-    id: string;
-    /** 标题 */
-    title: string;
-    /** 详细描述 */
-    description: string;
-    /** 子任务意图 */
-    intent: string;
-    /** 依赖的子任务 ID 列表 */
-    depends_on: string[];
-    /** 受影响的仓库列表 */
-    affected_repos: string[];
-    /** 预估复杂度 */
-    estimated_complexity: Complexity;
-    /** 输出模板 */
-    output_template?: string;
-    /** 输出路径 */
-    output_path?: string;
-    /** 建议使用的工具 */
-    suggested_tools?: string[];
-}
-/** 规划结果 */
-export interface PlanResult {
-    /** 任务 ID */
-    task_id: string;
-    /** 原始意图 */
-    original_intent: string;
-    /** 子任务列表 */
-    sub_tasks: SubTask[];
-    /** 执行顺序（子任务 ID 列表） */
-    execution_order: string[];
-    /** 可并行执行的分组 */
-    parallel_groups: string[][];
-    /** 规划摘要 */
-    summary: string;
-    /** 跳过原因（当不执行拆解时） */
-    skipped_reason?: string;
-    /** 当前步骤索引 */
-    current_step_index: number;
-}
-/** 受影响的文件 */
-export interface ImpactFile {
-    /** 文件路径 */
-    path: string;
-    /** 受影响原因 */
-    reason: string;
-    /** 置信度: high=高, medium=中, low=低 */
-    confidence: "high" | "medium" | "low";
-}
-/** 影响分析结果 */
-export interface ImpactAnalysisResult {
-    /** 任务 ID */
-    task_id: string;
-    /** 任务意图 */
-    intent: string;
-    /** 受影响的文件列表 */
-    affected_files: ImpactFile[];
-    /** 已声明的范围 */
-    declared_scope: string[];
-    /** 范围外的受影响文件 */
-    out_of_scope_files: ImpactFile[];
-    /** 当前作用域是否充足 */
-    scope_sufficient: boolean;
-    /** 建议: proceed=继续, expand_scope=扩大范围, confirm=确认 */
-    recommendation: "proceed" | "expand_scope" | "confirm";
-    /** 分析摘要 */
-    summary: string;
-    /** 扩大范围的建议 */
-    expand_suggestion?: string[];
-}
-/** 审查维度: quality=质量, security=安全, performance=性能, debt=债务, architecture=架构 */
-export type ReviewDimension = "quality" | "security" | "performance" | "debt" | "architecture";
-/** 审查严重程度: info=提示, warning=警告, critical=严重 */
-export type ReviewSeverity = "info" | "warning" | "critical";
-/** 审查发现 */
-export interface ReviewFinding {
-    /** 发现 ID */
-    id: string;
-    /** 文件路径 */
-    file: string;
-    /** 行号 */
-    line?: number;
-    /** 审查维度 */
-    dimension: ReviewDimension;
-    /** 严重程度 */
-    severity: ReviewSeverity;
-    /** 标题 */
-    title: string;
-    /** 详细描述 */
-    description: string;
-    /** 修改建议 */
-    suggestion?: string;
-    /** 是否为技术债务 */
-    is_debt: boolean;
-}
-/** 代码审查结果 */
-export interface CodeReviewResult {
-    /** 任务 ID */
-    task_id: string;
-    /** 发现列表 */
-    findings: ReviewFinding[];
-    /** 摘要统计 */
-    summary: {
-        /** 发现总数 */
-        total: number;
-        /** 按维度统计 */
-        by_dimension: Record<ReviewDimension, number>;
-        /** 按严重程度统计 */
-        by_severity: Record<ReviewSeverity, number>;
-        /** 技术债务数量 */
-        debt_items: number;
-    };
-    /** 总体评估 */
-    overall_assessment: string;
-    /** 跳过审查的原因 */
-    skip_reason?: string;
-    /** 审查角色 */
-    review_role?: ReviewRole;
-    /** 置信度调整值 */
-    confidence_adjustment?: number;
-    /** 争议列表 */
-    disputes?: DisputeItem[];
-    /** 不确定性违规项 */
-    uncertainty_violations?: string[];
-    /** 是否已进行风险调整 */
-    risk_adjusted?: boolean;
-    /** 认知减负路由汇总（机制 3） */
-    trust_classification?: {
-        white_box_count: number;
-        gray_box_count: number;
-        black_box_count: number;
-        recommendation: string;
-    };
-    /** 维度5: 抽检哨兵回溯摘要流（白盒项的压缩摘要，抽检时渲染） */
-    spot_check_backtrace?: string[];
-}
-/** 技术债务条目 */
-export interface DebtItem {
-    /** 债务 ID */
-    id: string;
-    /** 关联的任务 ID */
-    task_id: string;
-    /** 文件路径 */
-    file: string;
-    /** 行号 */
-    line?: number;
-    /** 债务标题 */
-    title: string;
-    /** 详细描述 */
-    description: string;
-    /** 严重程度 */
-    severity: ReviewSeverity;
-    /** 发现时间 */
-    discovered_at: string;
-    /** 状态: open=未处理, acknowledged=已确认, resolved=已解决 */
-    status: "open" | "acknowledged" | "resolved";
-    /** 解决时间 */
-    resolved_at?: string;
-    /** 分类 */
-    category?: "complexity" | "duplication" | "missing_test" | "outdated_dep" | "security" | "performance" | "other";
-    /** 修复工作量预估 */
-    effort_estimate?: "small" | "medium" | "large";
-    /** 影响程度 */
-    impact?: "low" | "medium" | "high";
-}
-/** 自定义脚手架项目级合同 — 定义模板集级别的约束 */
-export interface CustomScaffoldContract {
-    /** 必需的模板变量名，缺失则阻断渲染 */
-    required_template_vars?: string[];
-    /** 允许的技术栈关键词（匹配 tech_stack.backend.framework 或 frontend.framework），为空则不限 */
-    tech_stack?: string[];
-    /** 输出边界约束 */
-    output_boundary?: {
-        /** 禁止出现的正则模式（如 ["System\\.exit", "Runtime\\.exec"]） */
-        forbidden_patterns?: string[];
-        /** 单文件最大字节数 */
-        max_file_size?: number;
-    };
-}
-/** 脚手架文件 */
-export interface ScaffoldFile {
-    /** 文件路径 */
-    path: string;
-    /** 文件内容 */
-    content: string;
-    /** 文件描述 */
-    description: string;
-    /** 是否为模板文件 */
-    is_template: boolean;
-    /** 模板变量 */
-    template_vars?: Record<string, string>;
-}
-/** 脚手架生成结果 */
-export interface ScaffoldResult {
-    /** 任务 ID */
-    task_id: string;
-    /** 模块名称 */
-    module_name: string;
-    /** 生成的文件列表 */
-    files: ScaffoldFile[];
-    /** 生成摘要 */
-    summary: string;
-    /** 生成文件总数 */
-    total_files: number;
-    /** 警告信息列表 */
-    warnings: string[];
-}
-/** 交付动作类型: commit=提交, push=推送, pr=创建PR, changelog=生成变更日志 */
-export type DeliveryAction = "commit" | "push" | "pr" | "changelog";
-/** 交付配置 */
-export interface DeliveryConfig {
-    /** 是否自动提交 */
-    auto_commit: boolean;
-    /** 是否自动推送 */
-    auto_push: boolean;
-    /** 是否自动创建 PR */
-    auto_pr: boolean;
-    /** PR 标签列表 */
-    pr_labels: string[];
-    /** 是否需要审批 */
-    require_approval: boolean;
-}
-/** 交付证据链（R9 语义交付证据） */
-export interface DeliveryEvidenceChain {
-    /** 需求点列表（来自 expand） */
-    requirement_points: RequirementPoint[];
-    /** 语义证据（来自 verify） */
-    semantic_evidence?: SemanticEvidence;
-    /** 变更文件到需求点的映射 */
-    file_to_requirements: Array<{
-        file_path: string;
-        requirement_point_ids: string[];
-    }>;
-    /** 证据完整性评估 */
-    completeness: {
-        all_requirements_covered: boolean;
-        uncovered_points: string[];
-        advisory: string;
-    };
-}
-/** 交付结果 */
-export interface DeliveryResult {
-    /** 任务 ID */
-    task_id: string;
-    /** 已执行的交付动作 */
-    actions_performed: DeliveryAction[];
-    /** 提交哈希 */
-    commit_hash?: string;
-    /** 提交信息 */
-    commit_message: string;
-    /** 分支名 */
-    branch: string;
-    /** PR 链接 */
-    pr_url?: string;
-    /** 变更日志 */
-    changelog?: string;
-    /** 跳过的动作及原因 */
-    skipped_actions: Array<{
-        action: DeliveryAction;
-        reason: string;
-    }>;
-    /** 错误信息列表 */
-    errors: string[];
-    /** 证据链（R9 语义交付证据） */
-    evidence_chain?: DeliveryEvidenceChain;
-    /** 运行安全包 advisory 警告（R12 命令分级 + 供应链） */
-    safety_advisories?: string[];
-    /** 交付前审查结果（R11 Developer Sovereignty，advisory 不 hard block） */
-    pre_delivery_review?: import("./engine/developer_sovereignty.js").PreDeliveryReview;
-}
-/** 变更日志条目 */
-export interface ChangelogEntry {
-    /** 变更类型: feat=新功能, fix=修复, refactor=重构, test=测试, docs=文档, chore=杂项 */
-    type: "feat" | "fix" | "refactor" | "test" | "docs" | "chore";
-    /** 影响范围 */
-    scope: string;
-    /** 变更描述 */
-    description: string;
-    /** 关联任务 ID */
-    task_id: string;
-}
-/** 冲突风险等级: none=无, low=低, medium=中, high=高 */
-export type ConflictRisk = "none" | "low" | "medium" | "high";
-/** 冲突警告 */
-export interface ConflictWarning {
-    /** 文件路径 */
-    file: string;
-    /** 冲突风险 */
-    risk: ConflictRisk;
-    /** 原因说明 */
-    reason: string;
-    /** 冲突分支 */
-    other_branch?: string;
-    /** 其他作者 */
-    other_author?: string;
-}
-/** 跨仓库关联提示 */
-export interface CrossRepoHint {
-    /** 仓库 A */
-    repo_a: string;
-    /** 仓库 B */
-    repo_b: string;
-    /** 共享契约 */
-    shared_contract: string;
-    /** 关联描述 */
-    description: string;
-}
-/** 变更协调检查结果 */
-export interface CoordinationCheckResult {
-    /** 当前分支 */
-    branch: string;
-    /** 本地变更文件列表 */
-    local_changes: string[];
-    /** 冲突警告列表 */
-    conflict_warnings: ConflictWarning[];
-    /** 跨仓库关联提示 */
-    cross_repo_hints: CrossRepoHint[];
-    /** 领先 main 的提交数 */
-    commits_ahead: number;
-    /** main 分支是否过期警告 */
-    stale_main_warning: boolean;
-    /** 检查摘要 */
-    summary: string;
-}
-/** 团队活动条目 */
-export interface TeamActivityEntry {
-    /** 作者 */
-    author: string;
-    /** 日期 */
-    date: string;
-    /** 提交信息 */
-    message: string;
-    /** 短哈希 */
-    short_hash: string;
-    /** 变更文件数 */
-    files_changed: number;
-}
-/** 团队成员工作负载 */
-export interface TeamMemberWorkload {
-    /** 作者 */
-    author: string;
-    /** 提交次数 */
-    commit_count: number;
-    /** 活跃文件列表 */
-    active_files: string[];
-    /** 最后活跃时间 */
-    last_active: string;
-}
-/** 团队状态结果 */
-export interface TeamStatusResult {
-    /** 活动动态列表 */
-    activity_feed: TeamActivityEntry[];
-    /** 成员工作负载列表 */
-    member_workloads: TeamMemberWorkload[];
-    /** 近期知识更新 */
-    recent_knowledge: Array<{
-        name: string;
-        type: string;
-        updated: string;
-    }>;
-    /** 过期分支列表 */
-    stale_branches: Array<{
-        name: string;
-        last_commit_date: string;
-    }>;
-    /** 状态摘要 */
-    summary: string;
-}
-/** 契约变更类型 */
-export type ContractChangeType = "path_added" | "path_removed" | "method_changed" | "field_added" | "field_removed" | "field_type_changed";
-/** 契约变更严重程度: breaking=破坏性, compatible=兼容 */
-export type ContractChangeSeverity = "breaking" | "compatible";
-/** 契约变更条目 */
-export interface ContractChange {
-    /** 文件路径 */
-    file: string;
-    /** 变更类型 */
-    change_type: ContractChangeType;
-    /** 严重程度 */
-    severity: ContractChangeSeverity;
-    /** 变更描述 */
-    description: string;
-    /** 变更前内容 */
-    before?: string;
-    /** 变更后内容 */
-    after?: string;
-}
-/** 契约检查结果 */
-export interface ContractCheckResult {
-    /** 变更列表 */
-    changes: ContractChange[];
-    /** 破坏性变更数量 */
-    breaking_count: number;
-    /** 兼容变更数量 */
-    compatible_count: number;
-    /** 跨服务影响 */
-    cross_service_impact: Array<{
-        service: string;
-        endpoints: string[];
-    }>;
-    /** 是否需要审查 */
-    requires_review: boolean;
-    /** 检查摘要 */
-    summary: string;
-}
-/** 引导步骤: project_overview=项目概览, code_tour=代码漫游, knowledge_review=知识复习, first_task=首个任务 */
-export type OnboardingStep = "project_overview" | "code_tour" | "knowledge_review" | "first_task";
-/** 代码漫游条目 */
-export interface CodeTourItem {
-    /** 文件路径 */
-    path: string;
-    /** 描述说明 */
-    description: string;
-}
-/** 引导结果 */
-export interface OnboardingResult {
-    /** 当前步骤 */
-    current_step: OnboardingStep;
-    /** 已完成的步骤 */
-    completed_steps: OnboardingStep[];
-    /** 项目概览 */
-    project_overview?: {
-        /** 项目名称 */
-        name: string;
-        /** 技术栈 */
-        tech_stack: string;
-        /** 仓库列表 */
-        repos: Array<{
-            name: string;
-            lang: string;
-            framework: string;
-        }>;
-        /** 编码约定 */
-        conventions: string[];
-    };
-    /** 代码漫游 */
-    code_tour?: {
-        /** 关键模块 */
-        key_modules: CodeTourItem[];
-        /** 入口文件 */
-        entry_points: string[];
-    };
-    /** 知识摘要 */
-    knowledge_summary?: {
-        /** 知识总数 */
-        total: number;
-        /** 模式数量 */
-        patterns: number;
-        /** 流程数量 */
-        procedures: number;
-        /** 关键主题 */
-        key_topics: string[];
-    };
-    /** 首个任务建议 */
-    first_task_suggestion?: {
-        /** 任务意图 */
-        intent: string;
-        /** 推荐原因 */
-        reason: string;
-        /** 难度 */
-        difficulty: Complexity;
-    };
-    /** 下一步操作提示 */
-    next_action_hint: string;
-}
-/** 可行性等级: feasible=可行, risky=有风险, infeasible=不可行 */
-export type FeasibilityLevel = "feasible" | "risky" | "infeasible";
-/** 可行性评估结果 */
-export interface FeasibilityResult {
-    /** 可行性等级 */
-    level: FeasibilityLevel;
-    /** 原因列表 */
-    reasons: string[];
-    /** 建议列表 */
-    recommendations: string[];
-    /** 是否被阻止 */
-    blocked: false;
-}
-/** 解析后的错误信息 */
-export interface ParsedError {
-    /** 错误类型: compilation=编译错误, test_failure=测试失败, runtime=运行时错误, unknown=未知 */
-    error_type: "compilation" | "test_failure" | "runtime" | "unknown";
-    /** 出错文件 */
-    file?: string;
-    /** 出错行号 */
-    line?: number;
-    /** 错误信息 */
-    message: string;
-    /** 调用栈帧 */
-    stack_frames: string[];
-}
-/** 调用链条目 */
-export interface CallChainItem {
-    /** 文件路径 */
-    file: string;
-    /** 函数名 */
-    function?: string;
-    /** 行号 */
-    line?: number;
-}
-/** 根因分析 */
-export interface RootCauseAnalysis {
-    /** 失败类型 */
-    failure_type: FailureType;
-    /** 发起阶段 */
-    phase_origin?: string;
-    /** 分析摘要 */
-    summary: string;
-    /** 置信度 (0-1) */
-    confidence: number;
-}
-/** 修复方案建议 */
-export interface FixProposal {
-    /** 修复描述 */
-    description: string;
-    /** 需检查的文件列表 */
-    files_to_check: string[];
-    /** 修复方法 */
-    approach: string;
-    /** 修复风险 */
-    risk: Risk;
-}
-/** 测试补充建议 */
-export interface TestSuggestion {
-    /** 测试场景 */
-    scenario: string;
-    /** 覆盖范围 */
-    covers: string;
-    /** 优先级 */
-    priority: "high" | "medium" | "low";
-}
-/** 调试会话 */
-export interface DebugSession {
-    /** 任务 ID */
-    task_id: string;
-    /** 脱敏后的错误输出摘要（不保留 raw 原文） */
-    error_output: string;
-    /** 原始输出稳定哈希（用于追溯，不存原文） */
-    error_output_hash?: string;
-    /** 解析后的错误 */
-    parsed_error: ParsedError;
-    /** 调用链 */
-    call_chain: CallChainItem[];
-    /** 根因分析 */
-    root_cause: RootCauseAnalysis;
-    /** 修复方案 */
-    fix_proposal: FixProposal;
-    /** 测试补充建议列表 */
-    test_supplement: TestSuggestion[];
-}
-/** 指标快照 */
-export interface MetricsSnapshot {
-    /** 采集时间戳 */
-    timestamp: string;
-    /** 任务总数 */
-    total_tasks: number;
-    /** 通过率 */
-    pass_rate: number;
-    /** 重试率 */
-    retry_rate: number;
-    /** 平均执行耗时（毫秒） */
-    avg_duration_ms: number;
-    /** 知识命中率 */
-    knowledge_hit_rate: number;
-}
-/** 告警条目 */
-export interface AlertItem {
-    /** 告警级别: warning=警告, critical=严重 */
-    level: "warning" | "critical";
-    /** 指标名称 */
-    metric: string;
-    /** 当前值 */
-    current: number;
-    /** 阈值 */
-    threshold: number;
-    /** 告警信息 */
-    message: string;
-}
-/** 可观测性报告 */
-export interface ObservabilityReport {
-    /** 报告周期 */
-    period: {
-        start: string;
-        end: string;
-    };
-    /** 当前快照 */
-    snapshot: MetricsSnapshot;
-    /** 告警列表 */
-    alerts: AlertItem[];
-    /** 趋势数据 */
-    trends: Array<{
-        metric: string;
-        values: number[];
-    }>;
-    /** 报告摘要 */
-    summary: string;
-}
-/** 追溯子任务 */
-export interface TraceSubTask {
-    /** 子任务 ID */
-    id: string;
-    /** 子任务标题 */
-    title: string;
-    /** 变更文件列表 */
-    changed_files: string[];
-    /** 测试覆盖程度: full=完整, partial=部分, none=无 */
-    test_coverage: "full" | "partial" | "none";
-    /** 审查状态: passed=通过, issues=有问题, skipped=跳过 */
-    review_status: "passed" | "issues" | "skipped";
-    /** 是否已验证 */
-    verified: boolean;
-}
-/** 需求追溯链 */
-export interface TraceabilityChain {
-    /** 任务 ID */
-    task_id: string;
-    /** 原始意图 */
-    intent: string;
-    /** 子任务追溯列表 */
-    sub_tasks: TraceSubTask[];
-    /** 覆盖情况 */
-    coverage: {
-        /** 子任务总数 */
-        total_subtasks: number;
-        /** 已覆盖数 */
-        covered: number;
-        /** 覆盖缺口 */
-        gaps: string[];
-    };
-    /** 追溯摘要 */
-    summary: string;
-}
-/** 迁移语句 */
-export interface MigrationStatement {
-    /** 行号 */
-    line: number;
-    /** 语句类型 */
-    type: string;
-    /** 涉及的表 */
-    table?: string;
-    /** 风险等级: safe=安全, warning=警告, critical=危险 */
-    risk: "safe" | "warning" | "critical";
-    /** 描述说明 */
-    description: string;
-}
-/** 迁移分析结果 */
-export interface MigrationAnalysis {
-    /** 迁移文件路径 */
-    file: string;
-    /** 整体风险等级 */
-    risk_level: "safe" | "warning" | "critical";
-    /** 语句分析列表 */
-    statements: MigrationStatement[];
-    /** 回滚建议 */
-    rollback_suggestions: string[];
-    /** 分析摘要 */
-    summary: string;
-}
-/** 测试场景 */
-export interface TestScenario {
-    /** 场景名称 */
-    name: string;
-    /** 前置条件 */
-    given: string;
-    /** 执行操作 */
-    when: string;
-    /** 预期结果 */
-    then: string;
-    /** 优先级 */
-    priority: "high" | "medium" | "low";
-}
-/** 测试生成指南 */
-export interface TestGenGuide {
-    /** 源文件路径 */
-    source_file: string;
-    /** 测试类型: unit=单元测试, integration=集成测试, e2e=端到端测试 */
-    test_type: "unit" | "integration" | "e2e";
-    /** 建议的测试文件路径 */
-    test_file_suggestion: string;
-    /** 测试场景列表 */
-    scenarios: TestScenario[];
-    /** 所需的测试夹具 */
-    fixtures_needed: string[];
-    /** 需要模拟的依赖点 */
-    mock_points: string[];
-}
-/** 测试质量检查项 */
-export interface TestQualityCheck {
-    /** 检查维度: assertion_density=断言密度, boundary_coverage=边界覆盖, naming=命名规范, duplication=重复度, scenario_coverage=场景覆盖 */
-    dimension: "assertion_density" | "boundary_coverage" | "naming" | "duplication" | "scenario_coverage";
-    /** 是否通过 */
-    passed: boolean;
-    /** 详细说明 */
-    detail: string;
-}
-/** 测试质量报告 */
-export interface TestQualityReport {
-    /** 测试文件路径 */
-    file: string;
-    /** 质量评分 (0-100) */
-    score: number;
-    /** 检查项列表 */
-    checks: TestQualityCheck[];
-    /** 改进建议 */
-    suggestions: string[];
-}
-/** 漏洞条目 */
-export interface VulnerabilityItem {
-    /** 包名 */
-    package: string;
-    /** 已安装版本 */
-    installed_version: string;
-    /** 严重程度 */
-    severity: "low" | "medium" | "high" | "critical";
-    /** 漏洞描述 */
-    issue: string;
-    /** 修复版本 */
-    fixed_in: string;
-}
-/** 依赖扫描结果 */
-export interface DependencyScanResult {
-    /** 扫描的依赖文件 */
-    file: string;
-    /** 扫描的依赖数量 */
-    dependencies_scanned: number;
-    /** 发现的漏洞列表 */
-    vulnerabilities: VulnerabilityItem[];
-    /** 未锁定版本的依赖列表 */
-    unscoped_versions: string[];
-    /** 扫描摘要 */
-    summary: string;
-}
-/** 技术债务报告 */
-export interface DebtReport {
-    /** 未解决债务总数 */
-    total_open: number;
-    /** 按分类统计 */
-    by_category: Record<string, number>;
-    /** 按严重程度统计 */
-    by_severity: Record<string, number>;
-    /** 最老债务天数 */
-    oldest_debt_days: number;
-    /** 近 30 天趋势 */
-    trend_30d: {
-        created: number;
-        resolved: number;
-        net: number;
-    };
-    /** 高优先级债务列表 */
-    top_priority: DebtItem[];
-    /** 报告摘要 */
-    summary: string;
-}
-/** 双层机制状态 */
-export type DualLayerMechanismStatus = "template_only_advisory" | "code_only_enforced" | "dual_layer_enforced" | "experimental_dual_layer" | "deprecated";
-/** 模板层宿主目标 */
-export type TemplateTargetHost = "claude_code" | "codex" | "cursor" | "trae" | "generic_mcp";
-/** 模板资产 */
-export interface MechanismTemplateAsset {
-    path: string;
-    asset_kind: string;
-    consumption_mode: string;
-}
-/** 双层机制治理发现 */
-export interface DualLayerGovernanceFinding {
-    severity: "hard_fail" | "advisory";
-    mechanism_id: string;
-    finding_type: "template_gap" | "code_gap" | "evidence_gap" | "test_gap" | "drift_gap" | "asset_unconsumed" | "orphan_enforcer" | "template_mechanism_drift" | "p0_not_dual_layer" | "entrypoint_not_found" | "not_dual_layer" | "foundation_not_dual_layer" | "empty_mechanism" | "thick_knowledge_in_shared_template" | "template_too_thick" | "unregistered_hard_rule";
-    message: string;
-}
-/** 双层机制完整契约 ( 规范) */
-export interface DualLayerMechanismContract {
-    mechanism_id: string;
-    mechanism_name: string;
-    owner_issue_id?: string;
-    priority: "P0" | "P1" | "P2" | "P3";
-    template_layer: {
-        required: boolean;
-        assets: MechanismTemplateAsset[];
-        injected_routes: string[];
-        injected_workflows: string[];
-        target_hosts: TemplateTargetHost[];
-        language_policy: "zh_first" | "en_first" | "bilingual" | "source_preserving";
-    };
-    enforcement_layer: {
-        required: boolean;
-        enforcers: string[];
-        registries: string[];
-        entrypoints: string[];
-        state_effects: string[];
-        hard_fail_conditions: string[];
-        degradation_behavior: string;
-    };
-    evidence_layer: {
-        outputs: string[];
-        reports: string[];
-        diagnostic_codes: string[];
-        task_context_facts: string[];
-    };
-    verification_layer: {
-        tests: string[];
-        runtime_checks: string[];
-        regression_cases: string[];
-        drift_checks: string[];
-    };
-    status: DualLayerMechanismStatus;
-}
-/** 机制双层映射 (操作视图，从 DualLayerMechanismContract 派生) */
-export interface MechanismLayerMap {
-    mechanism_id: string;
-    mechanism_name: string;
-    owner_issue_id?: string;
-    priority: "P0" | "P1" | "P2" | "P3";
-    template_assets: MechanismTemplateAsset[];
-    template_consumers: string[];
-    code_enforcers: string[];
-    code_entrypoints: string[];
-    registries: string[];
-    evidence_outputs: string[];
-    diagnostics: string[];
-    tests: string[];
-    status: DualLayerMechanismStatus;
-    /** Use status */
-    layer_status?: DualLayerMechanismStatus;
-    /** 模板层注入路由 */
-    injected_routes?: string[];
-    /** 模板层注入工作流 */
-    injected_workflows?: string[];
-    /** 宿主目标 */
-    target_hosts?: TemplateTargetHost[];
-    /** 语言策略 */
-    language_policy?: "zh_first" | "en_first" | "bilingual" | "source_preserving";
-    /** 强制层状态效果 */
-    state_effects?: string[];
-    /** 强制层硬失败条件 */
-    hard_fail_conditions?: string[];
-    /** 降级行为 */
-    degradation_behavior?: string;
-    /** 证据层报告 */
-    reports?: string[];
-    /** TaskContext 写入的事实 */
-    task_context_facts?: string[];
-    /** 运行时检查 */
-    runtime_checks?: string[];
-    /** 回归测试场景 */
-    regression_cases?: string[];
-    /** 漂移检测 */
-    drift_checks?: string[];
-}
-/** 成本预算 */
-export interface CostBudget {
-    /** 每日 token 限制 */
-    daily_token_limit: number;
-    /** 每周 token 限制 */
-    weekly_token_limit: number;
-    /** 每月 token 限制 */
-    monthly_token_limit: number;
-}
-/** 成本告警 */
-export interface CostAlert {
-    /** 告警级别: warning=警告, critical=严重 */
-    level: "warning" | "critical";
-    /** 统计周期: daily=每日, weekly=每周, monthly=每月 */
-    period: "daily" | "weekly" | "monthly";
-    /** 已使用量 */
-    used: number;
-    /** 限制量 */
-    limit: number;
-    /** 告警信息 */
-    message: string;
-}
-//# sourceMappingURL=types.d.ts.map