CapabilityError¶
from cascaqit import CapabilityError
目标或执行路径不支持所请求能力时使用的异常。它同时继承 ValueError 和 CASCAQitError。
默认 category=capability、code=CAPABILITY_ERROR、stage=validation，severity 为 error，retryable 为 False。调用方可传 code、stage、object_path、suggestion 等覆盖字段；完整构造参数见 CASCAQitError。
检查目标、模拟方法与程序结构。例如纯 Digital 程序请求只在 Analog 演化中定义的退相干，可能因缺少前提被拒绝。不要把能力拒绝当成后端已经执行失败。
from cascaqit import CapabilityError
error = CapabilityError("Example failure", object_path="program")
assert error.to_error_ir().category == "capability"
assert error.to_diagnostic().code == "CAPABILITY_ERROR"
排查流程见结果与诊断。
返回包含本异常类别、错误码及上下文的 ErrorIR。保留设置的 retryable 值，不触发重试。
返回供诊断列表展示的 DiagnosticsIR；完整来源、cause 和附带诊断保存在错误对象及其 ErrorIR 中。