soloforge 1.0.0 → 1.1.1

package/dist/types.d.ts

@@ -1,76 +1,130 @@
+/** 风险等级: 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;
@@ -83,642 +137,1196 @@ export interface ProjectConfig {
             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