soloforge 1.1.2 → 1.1.31

package/dist/types.d.ts

@@ -1,1332 +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;
-    };
-    /** @internal resolved at runtime, not from config file */
-    _projectPath?: string;
-}
-/** 构建命令配置 */
-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;
-    /** 用户意图描述 */
-    intent: string;
-    /** 产品画像 */
-    product_profile: string;
-    /** 当前状态 */
-    status: "classifying" | "expanding" | "executing" | "verifying" | "retrying" | "learning" | "reworking" | "done" | "failed";
-    /** 分类结果 */
-    classification?: ClassifyResult;
-    /** 扩展结果 */
-    expansion?: ExpandResult;
-    /** 执行状态 */
-    execution?: {
-        /** 已变更文件列表 */
-        changed_files: string[];
-        /** 已尝试次数 */
-        attempt_count: number;
-        /** 最大尝试次数 */
-        max_attempts: number;
-        /** 失败历史 */
-        failure_history: FailureRecord[];
-        /** 修复循环状态 */
-        repair_loop?: RepairLoopState;
-    };
-    /** 验证结果 */
-    verification?: VerifyResult;
-    /** 规划结果 */
-    planning?: PlanResult;
-    /** 代码审查结果 */
-    code_review?: CodeReviewResult;
-    /** 交付结果 */
-    delivery?: DeliveryResult;
-    /** 当前阶段指令 */
-    phase_directive?: PhaseDirective;
-    /** 返工历史 */
-    rework_history?: ReworkHistory[];
-}
-/** 失败记录 */
-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[];
-}
-/** 扩展结果，包含完整的任务执行指令 */
-export interface ExpandResult {
-    /** 任务 ID */
-    task_id: string;
-    /** 生成的 prompt */
-    prompt: string;
-    /** 作用域结果 */
-    scope: ScopeResult;
-    /** 验收条件 */
-    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;
-            }>;
-        };
-    };
-}
-/** 作用域结果 */
-export interface ScopeResult {
-    /** 允许修改的路径 */
-    allowed_paths: string[];
-    /** 只读路径 */
-    readonly_paths: string[];
-    /** 是否允许新建文件 */
-    new_files_allowed: boolean;
-    /** 新文件命名模式 */
-    new_file_patterns?: string[];
-}
-/** 验收条目 */
-export interface AcceptanceItem {
-    /** 验收项 ID */
-    id: string;
-    /** 验收描述 */
-    description: string;
-    /** 验收类型 */
-    type: "automated" | "manual";
-    /** 自动化检查命令 */
-    check_command?: 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;
-    };
-}
-/** 验证命令 */
-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 interface KnowledgeEntry {
-    /** 知识唯一标识 */
-    id: string;
-    /** 文件路径 */
-    file_path: string;
-    /** 知识名称 */
-    name: string;
-    /** 知识类型 */
-    type: "pattern" | "procedure" | "domain" | "acceptance_template" | "review_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;
-    /** 状态: 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;
-    };
-}
-/** 技术债务条目 */
-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 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;
-}
-/** 交付结果 */
-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[];
-}
-/** 变更日志条目 */
-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;
-    /** 原始错误输出 */
-    error_output: 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;
-}
-/** 降级级别: full=完整功能, partial=部分降级, minimal=最小可用 */
-export type DegradationLevel = "full" | "partial" | "minimal";
-/** 降级状态 */
-export interface DegradationStatus {
-    /** 组件名称 */
-    component: string;
-    /** 降级级别 */
-    level: DegradationLevel;
-    /** 降级原因 */
-    reason: string;
-    /** 降级起始时间 */
-    since: 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 ADRDraft {
-    /** ADR ID */
-    id: string;
-    /** 标题 */
-    title: string;
-    /** 状态（始终为 draft） */
-    status: "draft";
-    /** 背景上下文 */
-    context: string;
-    /** 决策内容 */
-    decision: string;
-    /** 决策后果 */
-    consequences: string;
-    /** 关联任务 */
-    related_task: string;
-    /** 检测到的变更 */
-    detected_changes: string[];
-    /** 创建时间 */
-    created_at: 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 interface WorkspaceProduct {
-    /** 产品名称 */
-    name: string;
-    /** 产品画像 */
-    profile: string;
-    /** 关联路径 */
-    paths: string[];
-    /** 知识作用域: isolated=隔离, shared=共享 */
-    knowledge_scope: "isolated" | "shared";
-}
-/** 工作区配置 */
-export interface WorkspaceConfig {
-    /** 产品列表 */
-    products: WorkspaceProduct[];
-    /** 共享知识列表 */
-    shared_knowledge: 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;
-}
-/** Prompt 实验配置 */
-export interface PromptExperiment {
-    /** 实验 ID */
-    id: string;
-    /** 关联的知识条目 */
-    knowledge_entry: string;
-    /** 变体 A (原始 prompt) */
-    variant_a: string;
-    /** 变体 B (优化 prompt) */
-    variant_b: string;
-    /** 评估指标列表 */
-    metrics: string[];
-    /** 实验状态: draft=草稿, running=运行中, completed=已完成 */
-    status: "draft" | "running" | "completed";
-    /** 创建时间 */
-    created_at: string;
-}
-/** 实验结果 */
-export interface ExperimentResult {
-    /** 实验 ID */
-    experiment_id: string;
-    /** 变体 A 指标 */
-    variant_a_metrics: Record<string, number>;
-    /** 变体 B 指标 */
-    variant_b_metrics: Record<string, number>;
-    /** 获胜方: a=A 胜, b=B 胜, inconclusive=无定论 */
-    winner: "a" | "b" | "inconclusive";
-    /** 置信度 (0-1) */
-    confidence: number;
-    /** 结果摘要 */
-    summary: string;
-}
-//# sourceMappingURL=types.d.ts.map