用途:在架构层面审计 API 契约,聚焦服务边界与层级分离,检查层级泄漏、DTO 模式与错误契约一致性,返回含合规、完整、质量、实现四项诊断评分的结构化分析。
主要能力:发现服务边界(API、服务、领域层)并映射调用关系;按规则检查层级泄漏(服务/领域层接受 HTTP 类型)、缺失 DTO(4 个以上参数在 2 个以上方法重复)、实体泄漏(ORM 实体未经响应 DTO 直接返回)、错误契约不一致(同一服务混用 raise 与 return None)、冗余重载(with/and 后缀方法仅差 1-2 个参数)、架构诚实性(读命名函数含写副作用)。每项发现使用 ADD_DTO、STOP_ENTITY_LEAK 或 STANDARDIZE_ERROR_CONTRACT 动作。
使用方式:作为 L3 Worker 运行,输入 pattern、locations、adr_reference、bestPractices、output_dir,可选 domain_mode、current_domain、scan_path。先加载 references/detection_patterns.md 与 references/mcp_tool_preferences.md,优先使用 hex-line MCP 读取与搜索,符号分析用 hex-graph;MCP 不可用时回退 Read/Grep/Glob/Bash 并在报告中说明。按阶段发现边界、分析契约、计算评分、写报告。评分采用惩罚公式 penalty = (critical x 2.0) + (high x 1.0) + (medium x 0.5) + (low x 0.2),score = max(0, 10 - penalty)。报告写入 {output_dir}/643-api-contract[-{domain}].md。
适用场景:审计服务/API 边界契约,不审计代码重复、包健康、依赖拓扑或运行时操作。
限制:仅报告架构边界发现,跳过重复类发现;评分前必须阅读实际服务代码;domain-aware 模式仅扫描 scan_path 并标记领域。具体收费、平台支持与效果暂未提供。