用途：按给定范围编排一次完整的渗透测试或网络漏洞扫描。WEB 模式面向 apex 域名/应用 URL，NETWORK 模式面向 IP/CIDR 列表；Setup 阶段自动判定 engagement_kind（以 IP/CIDR 为主→network，以域名/URL 为主→web）。CTF/HackTheBox 场景应改用 htb-solve。
主要能力：WEB 模式强制做 CT 日志/被动 DNS/源站发现（crt.sh、certspotter、subfinder 等）扩展攻击面；NETWORK 模式将 IP 集切片，每片一个 nmap worker 执行主机发现、端口/服务扫描、CVE 关联（nmap --script vulners、nuclei、nvd-lookup.py）。Assess 阶段用 coordinator-loop 在候选发现物化时立即由盲测代理验证，覆盖矩阵仅由 VALID/REPAIRED 发现、合理 N/A 或真实阴性判定为已覆盖。随后做攻击路径关联与风险排序，并由确定性渲染器生成报告。
使用方式：WEB 可用 Workflow('pentest-engagement', { scope_file: 'projects/pentest/<engagement>-scope.md' }) 或内联 scope 对象；NETWORK 可用 targets 数组或含 IP/CIDR 列表的 scope_file，并可选 scan_profile（light/standard/full）。共享选项含 maxConcurrent、dryRun、max_experiments、business_tier、report。凭据仅以环境变量名引用，经 python3 tools/env-reader.py 从 .env 读取。
适用场景：真实（非 CTF）授权范围内的 Web/API/云应用或大规模网络资产扫描与报告。
限制：仅作编排器，不内联运行 coordinator loop；缺少凭据不构成全局阻断，仅无任何可达资产的范围会阻断；禁止破坏性操作、DoS、暴力破解与范围外租户。确定性方面，判定层为冻结的纯 JS computeVerdict，但实时运行受 LLM 采样与目标漂移影响，仅回放冻结证据集时才能保证字节级一致。COMPLETE 为硬性 100% 覆盖率门禁，未覆盖的适用单元会标记 INCOMPLETE_coverage/BLOCKED。报告默认 transilience 格式，也可用 custom_report_cmd 自定义。token/成本统计暂未提供。