用途:作为 L3 Worker,构建并分析模块依赖图,以强制架构边界。支持 Python、TS/JS、C#、Java 的导入解析。
主要能力:检测成对循环(HIGH)与 DFS 传递循环(CRITICAL)及文件夹级循环;校验 forbidden、allowed、required 三类边界规则;计算 Robert C. Martin 指标(Ca、Ce、Instability)与 Lakos 聚合指标(CCD、NCCD);校验稳定依赖原则(SDP);支持基线冻结以增量适配遗留项目;架构检测采用三级优先:自定义规则 > 架构文档 > 自动探测,并支持混合风格分区应用预设。
使用方式:输入 architecture_path、codebase_root、output_dir,可选 domain_mode、current_domain、scan_path、update_baseline。domain-aware 模式下所有 Grep/Glob 限定 scan_path 并给发现打 domain 标签。优先使用 hex-graph 加速拓扑与指标分析,hex-line 读取本地代码;MCP 不可用时回退到 Read/Grep/Glob/Bash 并在报告中说明。报告写入 {output_dir}/644-dep-graph[-{domain}].md,评分按 penalty 公式计算。
适用场景:审计模块依赖结构、发现循环依赖、验证架构边界与耦合度。
限制:仅分析项目内部模块,排除标准库与第三方;不负责 I/O 隔离(ln-642)、API 契约(ln-643)、代码重复(ln-623);未检测到架构模式时仅检查循环与指标,不产生边界违规;具体阈值与模板细节需参考其 references 文件,资料未完整提供。