用途：处理 callidescope 运行失败。先区分失败类型：深度门禁（栈超过 limits.maximumDepth）、广度门禁（直接调用数超过 limits.maximumBreadth）、陈旧报告（配置目标与最新运行不一致）、未读取自身文件（0 files）、命令行被拒、项目配置被拒。
主要能力与用法：深度失败时先读打印的栈，若各帧职责不同属真实分层，需设计决策；若多帧内容相近则为转发层，应合并。不要靠提高 maximumDepth 解决。项目深度以门禁裁决为准，不要用摘要中的 maximumDepthTraced。带 ≥ 的深度是下限。orphan-root 栈需判断死代码或缺少入口规则。广度失败应沿职责拆分可调用对象，而非内联。
陈旧报告修复：npx callidescope --write。先 lint 再生成。
限制：项目配置 callidescope.config.ts 必需，缺失或被拒则不做任何追踪；仅工作区可设的字段不能写在项目配置；--check 需取值且仅接受 breadth、depth、reports；--write 不能与 --check reports 同用；--format 仅接受 markdown、mermaid、json；depth 与 breadth 命令需 <file>#<qualified-name>。资料未提供价格、平台与效果信息。